@@ -54,19 +54,25 @@ group and explanation. Run `make check-fdg-v2`; never fall back to rendering
5454schema v1.
5555
5656After each edit batch, run the narrowest relevant Make target. Before a source
57- handoff, ` make check-static ` must pass: it regenerates both clients, validates
58- strict FDG and repository contracts, checks Go formatting/modules/vet, and builds
59- the production Go binary and frontend. A source build is not business acceptance.
60- CI and standalone development must also run ` make check ` , which exercises real
61- Dex and production browser paths. A hosted authoring sandbox may not have the
62- isolated test services; report that integration evidence as pending rather than
63- pretending it passed or preventing a clean source build from reaching Preview.
64- A failed source check remains ` blocked=true ` ; fix it autonomously when possible.
57+ handoff, ` make check ` must pass. It restores pinned dependencies and runs
58+ ` make check-static ` : generate clients, validate strict FDG and contracts, check
59+ Go formatting/modules/vet, and build the production Go binary and frontend.
60+ These commands do not start test services or call providers.
61+
62+ Do not add application integration or browser test suites, mocks, fake providers,
63+ fixtures, or test-framework dependencies unless the user explicitly requests
64+ them. The template intentionally has no application test scaffold. Existing
65+ source-only applications follow the same default. A separately requested real
66+ business acceptance belongs to the host after credentials are configured.
67+ Missing Connector credentials must not block a complete, source-verified commit:
68+ report that the application is ready to configure and real execution is pending.
69+ Never claim that compilation proves a provider call. A failed source check is a
70+ source blocker and must be fixed when possible. Do not remove unrelated existing
71+ tests from an imported application without authorization.
6572
6673Stable commands are ` make bootstrap ` , ` make generate ` , ` make check-fdg-v2 ` ,
6774` make check-contracts ` , ` make check-static ` , ` make superverse-release-artifacts ` ,
68- ` make test-integration ` , ` make test-e2e ` , ` make build ` , ` make dev ` , and
69- ` make check ` .
75+ ` make build ` , ` make dev ` , and ` make check ` .
7076
7177` dex-app.yaml ` declares every application Flow source and exact connector
7278connection. Update it whenever either set changes. Never put endpoint values,
@@ -118,19 +124,10 @@ Dex Skills discovers the release and opens its own baseline pull request. Once
118124the matching Dex Skills release exists, Superverse advances both immutable
119125release pins in one pull request.
120126
121- Only integration tests that call real dependency APIs are permitted. Never add
122- unit tests, isolated component tests, or mock integration tests in any language.
123- Go tests must use the ` integration ` build tag and a real Dex Server. Playwright
124- E2E tests must drive the production application backed by real dependencies.
125- Do not use mocks, fakes, stubs, simulated providers, or intercepted/fulfilled
126- API responses to replace dependencies, including for failure or edge cases.
127- Exercise those cases through real dependency APIs or report the coverage gap.
128- An integration label or build tag alone does not qualify a test: review its
129- actual API calls. Dependency startup failures must fail verification, never
130- skip a test or fall back to a mock. Do not restore unit-test targets, frameworks,
131- fixtures, or dependencies. ` make check-contracts ` statically checks repository
132- contracts, naming, test placement, and known mocking APIs; it is not a test suite
133- and does not replace real integration or E2E evidence.
127+ If the user later requests tests, use actual dependency APIs and preserve the
128+ real-dependency policy: no unit tests, mocks, fake providers or intercepted
129+ responses. Missing required services fail that explicit test; do not skip it or
130+ report it as passed. Static contract checks remain separate from test evidence.
134131
135132When structure, commands, or required tooling changes, update this file,
136133` .superverse/template.json ` , ` README.md ` , and static contract checks together.
0 commit comments