Skip to content

feat: integration story — close the systemic compose gap (unwired entry points + mock-only interfaces)#105

Merged
tzone85 merged 1 commit into
mainfrom
vxd-integration-story
Jun 25, 2026
Merged

feat: integration story — close the systemic compose gap (unwired entry points + mock-only interfaces)#105
tzone85 merged 1 commit into
mainfrom
vxd-integration-story

Conversation

@tzone85

@tzone85 tzone85 commented Jun 25, 2026

Copy link
Copy Markdown
Owner

The gap

Per-story unit tests pass against mocks, but the whole app never has to compose. shiftsync reached REQ_COMPLETED with 3 of 5 endpoints returning 404, no auth applied, and shift.Validator satisfiable only by a test mock. Green tests masked a non-functional app — the dangling-wire + interface-mismatch class.

The fix

The planner now appends a final integration story (before the scribe, depends on every code story) instructed to:

  • Wire every handler/route/command/page into the real entry point (audit for dangling wires).
  • Apply cross-cutting middleware (auth etc.) that stories couldn't wire themselves.
  • Bridge interface mismatches with adapters so the production path uses real implementations, not mocks.
  • Write an end-to-end smoke test that boots the app and asserts the documented surface responds (protected routes reject missing creds; endpoints don't 404).

The smoke test runs in QA / the pre-merge gate, so a non-functional whole fails the build instead of completing. Gated by planning.emit_integration_story (default on). Enabled by the edge-aware overlap fix (#101) — the sequenced integration story can co-edit the skeleton-owned entry point.

Test plan

go test ./... green (31 pkgs; codegraph is env-only). New TestPlanner_EmitsIntegrationStory; count-sensitive tests updated.

🤖 Generated with Claude Code

…y points, mock-only interfaces)

Per-story unit tests pass against mocks, but the whole app never has to compose:
handlers built but never registered in main, auth middleware never applied,
interfaces that only a test mock satisfies. shiftsync reached REQ_COMPLETED with
3 of 5 endpoints 404 and no auth.

Planner now appends a final 'integrate' story (before scribe, depends on all code
stories) that: wires every component into the real entry point, applies cross-
cutting middleware, bridges interface mismatches with adapters (real impls, not
mocks), and writes an end-to-end SMOKE TEST that boots the app and asserts the
documented surface responds (protected routes reject missing creds, endpoints
don't 404). The smoke test runs in QA / the pre-merge gate, so a non-functional
whole fails the build instead of 'completing'. Gated by planning.emit_integration_story
(default on). Enabled by the edge-aware overlap fix, which lets the sequenced
integration story co-edit the skeleton-owned entry point.
@tzone85 tzone85 merged commit 5ef8f7e into main Jun 25, 2026
@tzone85 tzone85 deleted the vxd-integration-story branch June 25, 2026 06:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant