Skip to content
This repository was archived by the owner on Oct 19, 2026. It is now read-only.

Commit b0ba9b6

Browse files
committed
Keep generated applications source-only by default
1 parent 6a30af6 commit b0ba9b6

12 files changed

Lines changed: 63 additions & 410 deletions

File tree

‎.github/workflows/ci.yml‎

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -56,16 +56,6 @@ jobs:
5656
cache-dependency-path: |
5757
web/package-lock.json
5858
upstream-dex/web/package-lock.json
59-
- name: Install Temporal CLI 1.9.1
60-
run: |
61-
curl --fail --silent --show-error --location \
62-
https://github.com/temporalio/cli/releases/download/v1.9.1/temporal_cli_1.9.1_linux_amd64.tar.gz \
63-
--output /tmp/temporal-cli.tar.gz
64-
echo "09a0326a51db84d02735e53542b9ebd8c4758daf47482a9ab0abce15844e60d5 /tmp/temporal-cli.tar.gz" | sha256sum --check
65-
mkdir -p "$HOME/.local/bin"
66-
tar -xzf /tmp/temporal-cli.tar.gz -C "$HOME/.local/bin" temporal
67-
echo "$HOME/.local/bin" >> "$GITHUB_PATH"
68-
"$HOME/.local/bin/temporal" --version
6959
- name: Build pinned Dex CLI
7060
run: |
7161
npm --prefix upstream-dex/web ci
@@ -74,9 +64,6 @@ jobs:
7464
mkdir -p "$HOME/.local/bin"
7565
GOWORK=off go build -C upstream-dex/cli -trimpath -o "$HOME/.local/bin/dexcli" ./cmd/dexcli
7666
echo "$HOME/.local/bin" >> "$GITHUB_PATH"
77-
- name: Install Playwright Chromium
78-
working-directory: web
79-
run: npx playwright install --with-deps chromium
8067
- name: Check template
8168
run: |
8269
make check-template-repository

‎.superverse/template.json‎

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"schemaVersion": 1,
33
"buildProfile": "go-react-v1",
4-
"templateVersion": "1.9.1",
4+
"templateVersion": "1.9.2",
55
"minimumSandboxImageContractRevision": 3,
66
"openapiSpec": "openapi/openapi.yaml",
77
"applicationManifest": "dex-app.yaml",
@@ -12,8 +12,6 @@
1212
"checkFdgV2": "make check-fdg-v2",
1313
"releaseArtifacts": "make superverse-release-artifacts",
1414
"checkContracts": "make check-contracts",
15-
"testIntegration": "make test-integration",
16-
"testE2E": "make test-e2e",
1715
"build": "make build",
1816
"dev": "make dev",
1917
"check": "make check",

‎AGENTS.md‎

Lines changed: 20 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -54,19 +54,25 @@ group and explanation. Run `make check-fdg-v2`; never fall back to rendering
5454
schema v1.
5555

5656
After 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

6673
Stable 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
7278
connection. 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
118124
the matching Dex Skills release exists, Superverse advances both immutable
119125
release 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

135132
When structure, commands, or required tooling changes, update this file,
136133
`.superverse/template.json`, `README.md`, and static contract checks together.

‎Makefile‎

Lines changed: 1 addition & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
SHELL := /usr/bin/env bash
22

3-
.PHONY: bootstrap generate check-fdg-v2 check-contracts check-template-repository superverse-release-artifacts test-integration test-e2e build dev check-static check
3+
.PHONY: bootstrap generate check-fdg-v2 check-contracts check-template-repository superverse-release-artifacts build dev check-static check
44
bootstrap:
55
go mod download
66
go -C tools/openapi mod download
@@ -16,10 +16,6 @@ check-contracts:
1616
go run ./tools/checkcontract
1717
check-template-repository:
1818
go run ./tools/checkcontract --repository-automation
19-
test-integration: generate check-contracts
20-
./scripts/with-dex.sh go test -count=1 -tags=integration ./...
21-
test-e2e: generate check-contracts
22-
./scripts/with-dex.sh ./scripts/run-e2e.sh
2319
build: generate
2420
npm --prefix web run build
2521
go build -o bin/basic-process ./cmd/server
@@ -33,5 +29,3 @@ check-static: generate check-fdg-v2 check-contracts
3329
go build -o bin/basic-process ./cmd/server
3430
check: bootstrap
3531
$(MAKE) check-static
36-
$(MAKE) test-integration
37-
$(MAKE) test-e2e

‎README.md‎

Lines changed: 40 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -122,27 +122,16 @@ exported without `.github/`; their `make check-contracts` and `make check-static
122122
retain all application checks without requiring template publishing automation.
123123

124124
```bash
125-
make check-contracts
126-
make check-static
127-
make test-integration
128-
make test-e2e
129125
make check
126+
# Or rerun the source gate after dependencies have been restored:
127+
make check-static
130128
```
131129

132-
Integration tests start a real Dex Server with `dexcli dev`; the Go scenarios
133-
cover approval, reminders, Worker restart and terminal reads. Playwright drives
134-
the production Hello World page and generated application-info endpoint. Every
135-
poll has a deadline. Go integration tests disable result caching so each run
136-
calls the real Dex APIs.
137-
138-
Only integration tests that call real dependency APIs are permitted, including
139-
the Playwright E2E journey against the production application. Unit tests,
140-
isolated component tests, mock integration tests, fakes, stubs, and Playwright
141-
API-response interception are prohibited, including for failure and edge cases.
142-
Exercise those cases through real dependency APIs or report the coverage gap.
143-
An integration label alone is insufficient. Missing dependencies fail the
144-
check; tests must never skip or fall back to mocks. Do not add unit-test
145-
frameworks, fixtures, or dependencies.
130+
The template contains no application integration or browser test scaffold.
131+
Do not generate tests, fixtures, mocks or test-framework dependencies by default.
132+
This keeps the application small and avoids requiring private Connector keys
133+
while authoring source. Explicitly requested tests must call real dependencies;
134+
missing dependencies are an incomplete result, never a mock-backed pass.
146135

147136
`make check-contracts` validates the template manifest, Go naming, test
148137
placement, and known mocking APIs through static source inspection. It is
@@ -158,11 +147,12 @@ accepted fallback.
158147

159148
`make check-static` is the source handoff gate. It regenerates, validates FDG and
160149
repository contracts, checks formatting/modules/vet, and builds both production
161-
artifacts without starting services or calling providers. `make check` remains
162-
the complete CI/standalone gate and adds real integration and browser scenarios.
163-
In a hosted authoring sandbox, missing isolated integration services remain an
164-
explicit acceptance gap; a successful source check permits Preview configuration
165-
and deployment, not a claim that business execution passed.
150+
artifacts without starting services or calling providers. `make check` restores
151+
pinned dependencies and runs that source gate. After source handoff, configure
152+
credentials through the host and validate actual business execution in Preview
153+
and Live. Those host-owned acceptance checks are not copied into each app. A
154+
successful source check permits configuration and deployment; it does not claim
155+
that a provider call or business journey passed.
166156

167157
The supported sandbox runtime is contract revision 3. It provides Go, Node.js,
168158
npm, Python 3, an FDG 2.0-capable `dexcli`, Ogen's cached module dependencies,
@@ -239,3 +229,30 @@ checks are independently runnable before hosted Preview acceptance.
239229

240230
This README, AGENTS.md, template manifest and static contracts describe the same
241231
source gate, configuration loader and host management boundary.
232+
233+
234+
## Source-only application baseline
235+
236+
### Dex Flow Changes
237+
238+
None. Existing Flow, Step, primitive, RPC, execution and cleanup contracts remain
239+
unchanged; this release removes test scaffolding only.
240+
241+
### Database Schema Changes
242+
243+
None. No new state owner or storage is introduced.
244+
245+
### UI/UX
246+
247+
The Hello World shell and native host management surface remain unchanged.
248+
249+
### Tests
250+
251+
Default verification is `make check` and `make check-template-repository` in
252+
Template CI. Real configured Preview/Live acceptance remains host-owned and must
253+
be reported independently; no passing integration evidence is implied.
254+
255+
### Documentation
256+
257+
The template manifest, Make commands, CI, agent guidance and this README describe
258+
the same source-only default. Go, SDK, Server and CLI baselines are unchanged.

0 commit comments

Comments
 (0)