Skip to content

docs(product-specs): Server control plane contract (SYM-20 Phase 0)#14

Merged
Swiftyos merged 1 commit into
devfrom
symphony/SYM-20
Apr 17, 2026
Merged

docs(product-specs): Server control plane contract (SYM-20 Phase 0)#14
Swiftyos merged 1 commit into
devfrom
symphony/SYM-20

Conversation

@Swiftyos

Copy link
Copy Markdown

Summary

  • Phase 0, docs-only. Turns the approved AgentProbe server design (docs/design-docs/agent-probe-server.md) into a binding product contract so Phase 1–4 PRs have a fixed behavior target.
  • Adds the Server control plane scenario group to docs/product-specs/platform.md with 9 scenarios covering default boot, exposure safety, read-only HTTP/UI history, live SSE events, run control, cancellation, presets, comparisons, and Docker persistence.
  • Mirrors every scenario into current-state.md (unchecked, grouped as planned Phase 1–4 work) and into e2e-checklist.md with a planned test owner per the exec plan.

No runtime files are modified. Postgres and /compare stay "planned" in current-state.md until Phase 3 lands.

Refs: Linear SYM-20, docs/exec-plans/active/agent-probe-server-phase-0-contract-2026-04.md.

Test plan

  • bun run docs:validate (runs scripts/check-behaviour-docs.ts) — all 24 scenarios consistent across platform.md, current-state.md, e2e-checklist.md.
  • git diff --name-only shows only the three product-spec files changed.
  • Reviewer can map each design-doc phase to ≥1 product scenario and ≥1 planned test owner (table in e2e-checklist.md).

🤖 Generated with Claude Code

…Phase 0

Turns the approved AgentProbe server design
(docs/design-docs/agent-probe-server.md) into a binding product contract
before any runtime code lands, per the Phase 0 exec plan
(docs/exec-plans/active/agent-probe-server-phase-0-contract-2026-04.md).

- platform.md: add "Server control plane" scenario group with 9 scenarios
  covering default boot, exposure safety, read-only HTTP/UI history, live
  SSE, run control, cancellation, presets, comparisons, and Docker SQLite
  persistence.
- current-state.md: mirror all 9 new scenarios as unchecked (planned) and
  refresh "Last validated against" to 2026-04-17.
- e2e-checklist.md: add a planned test-owner row per scenario covering
  tests/e2e/server-e2e.test.ts, tests/integration/server/,
  tests/unit/server/, and dashboard component tests.

scripts/check-behaviour-docs.ts reports zero drift across all 24 scenarios.
No runtime files modified; PR targets dev.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@Swiftyos Swiftyos merged commit c063242 into dev Apr 17, 2026
2 checks passed
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