Skip to content

[T3.0] Trim active API/Hub docs and source-contract owner mapping #342

Description

@DeliciousBuding

Task: T3.0 — Trim active API/Hub docs and source-contract owner mapping

Phase: 3 — Source And Test Alignment
Priority: P1 | Size: M | Lane: Prep
S.U.P.E.R Drivers: S, P, E, R
Test Expectation: Docs/source-contract cleanup; run doc SSOT, real E2E contract, project skill whitelist, OpenAPI YAML parse, and git diff check. No Playwright required unless UI source changes.
Memory/Governance Impact: Update docs/progress/MASTER.md, task breakdown, active doc verifier, and archive old longform snapshots.

Description

Finish the pre-Phase 3 governance cleanup after PR #341 by shrinking remaining active API/Hub Markdown entrypoints, routing readers to source owners and useful tests, and preventing duplicate event/deployment tables from becoming active truth sources again.

Acceptance Criteria

  • api/events.md is a concise event contract index that points to Edge/Hub/shared source owners and evidence boundaries.
  • hub-server/README.md and hub-server/deployments/README.md are concise owner docs; old longform versions are archived.
  • Hub architecture/deployment docs no longer duplicate event tables or live-infra facts.
  • scripts/verify-doc-ssot.ps1 enforces active Markdown line limits and stale active branch/status wording for the newly covered paths.
  • Passes S.U.P.E.R Quick Check for: S, P, E, R.
  • Satisfies test expectation: doc SSOT, real E2E contract, project skill whitelist, OpenAPI YAML parse, and diff check pass.

Affected Files

  • api/events.md
  • api/conventions.md
  • api/README.md
  • hub-server/README.md
  • hub-server/deployments/README.md
  • docs/architecture/01-hub-server.md
  • docs/architecture/05-deployment.md
  • docs/progress/MASTER.md
  • docs/plan/task-breakdown.md
  • scripts/verify-doc-ssot.ps1

Dependencies


Managed by Spec-Driven Develop workflow

Metadata

Metadata

Assignees

No one assigned

    Labels

    P2Medium priorityphase-3Phase 3phase-gre2e-3Spec Governance Real E2E phase 3size-MMedium effortspec-drivenSpec-Driven Develop workflow tasksspec:repo-governance-real-e2eSpec run: repo governance and real E2E closure

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions