Spec Kitty

└─ kitty-specs
   └─ Mission Status Read API: overview from the ledger and events

Mission Run:

📚 Docs ↗

Work Packages: mission-status-read-api-overview-01M4EMSA

_Generated by finalize-tasks from wps.yaml. Do not edit directly._

Dependencies: None Requirement Refs: FR-008 Owned Files: tests/ci/test_contracts_workflows.py Subtasks: T001, T002, T003 Prompt: tasks/WP01-campsite-filter-group-test.md

Work Package WP02: Phase 1a: spike and decision record (R-2, R-7 items, each with a fallback)

Dependencies: WP01 Requirement Refs: FR-009, FR-010, FR-011, FR-014, C-001, C-007, NFR-001, NFR-005 Plan Concerns: IC-01 Owned Files: kitty-specs/mission-status-read-api-overview-01M4EMSA/research.md Subtasks: T004, T005, T006, T007, T008, T009, T010 Prompt: tasks/WP02-spike-and-decision-record.md

Work Package WP03: Phase 1b: Gradle scaffold, supply chain and skeleton service

Dependencies: WP02 Requirement Refs: FR-014, FR-011, FR-012, C-001, C-002, C-004, C-007, C-008, C-009, NFR-006, NFR-007, NFR-009 Plan Concerns: IC-01 Owned Files: services/mission-status-api/build.gradle.kts, services/mission-status-api/settings.gradle.kts, services/mission-status-api/gradle.properties, services/mission-status-api/gradlew, services/mission-status-api/gradlew.bat, services/mission-status-api/.gitignore, services/mission-status-api/gradle/, services/mission-status-api/src/main/resources/application.properties, services/mission-status-api/src/main/resources/META-INF/native-image/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/config/MissionStatusApplication, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/skeleton/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/ProjectRootCheck, services/mission-status-api/src/test/java/org/speckitty/missionstatus/build/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/skeleton/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/nativesmoke/, services/mission-status-api/src/nativeTest/, tests/ci/test_mission_status_api_build.py Subtasks: T011, T012, T013, T014, T015, T016, T017 Prompt: tasks/WP03-gradle-scaffold-supply-chain-skeleton.md

Work Package WP04: Phase 1c: path-filtered workflow, four native hello-route legs, gate helper

Dependencies: WP03 Requirement Refs: FR-015, FR-014, C-008, C-009, SC-007 Plan Concerns: IC-01 Owned Files: .github/workflows/mission-status-api.yml, .github/CODEOWNERS, scripts/ci/mission_status_gate_checks.py, tests/ci/test_mission_status_gate_checks.py, tests/ci/test_mission_status_api_build.py, scripts/ci/fleet_verdict.py, .github/workflows/ci-fleet-verdict.yml, tests/ci/test_fleet_verdict.py, tests/ci/test_fleet_main.py Subtasks: T018, T019, T020, T021, T022 Prompt: tasks/WP04-workflow-native-hello-legs-gate-helper.md

Work Package WP05: Phase 2a-1: domain core (reducer, derivations, cursors, paging)

Dependencies: WP04 Requirement Refs: FR-001, FR-002, FR-005, FR-012, NFR-003, NFR-005, NFR-006 Plan Concerns: IC-02 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/domain/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/domain/, services/mission-status-api/src/test/resources/jacoco-class-floor.properties Subtasks: T023, T024, T025, T026 Prompt: tasks/WP05-domain-core.md

Work Package WP17: Phase 2a-2: projection component and ledger line codec

Dependencies: WP05 Requirement Refs: FR-004, FR-009, FR-012, NFR-003, NFR-005, NFR-006 Plan Concerns: IC-02 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/domain/projection/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/domain/projection/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/codec/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/out/filesystem/codec/, services/mission-status-api/src/test/resources/jacoco-class-floor.properties Subtasks: T027, T028 Prompt: tasks/WP17-projection-and-ledger-codec.md

Work Package WP06: Phase 2a-3: application layer, ports, cache, change feed, in-memory source

Dependencies: WP17 Requirement Refs: FR-003, FR-004, FR-007, C-003, NFR-004, NFR-006 Plan Concerns: IC-02 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/application/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/application/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/testsupport/, services/mission-status-api/src/test/resources/jacoco-class-floor.properties, services/mission-status-api/src/main/java/org/speckitty/missionstatus/domain/model/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/domain/model/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/domain/oracle/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/codec/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/out/filesystem/codec/ Subtasks: T029, T030, T031, T032 Prompt: tasks/WP06-application-ports-cache-feed.md

Work Package WP18: Phase 2a-4: ArchUnit rule set, port-level conformance suite, interim id check and 2a exit gate

Dependencies: WP06 Requirement Refs: FR-012, FR-013, C-003, NFR-006 Plan Concerns: IC-02 Owned Files: services/mission-status-api/src/test/java/org/speckitty/missionstatus/conformance/port/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/testsupport/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/architecture/, services/mission-status-api/src/test/resources/portlevel-tests.txt, services/mission-status-api/src/test/resources/jacoco-class-floor.properties Subtasks: T033, T034, T035 Prompt**: tasks/WP18-archunit-portlevel-suite-and-2a-gate.md

Work Package WP07: Phase 2b: Python oracle, fixtures, goldens, golden-honesty test and CI routing

Dependencies: WP01 Requirement Refs: FR-008, FR-006, FR-001, FR-005, C-006, NFR-005, SC-001, SC-007 Plan Concerns: IC-03 Owned Files: tests/contract/_mission_status_conformance.py, tests/contract/test_mission_status_conformance.py, services/mission-status-api/src/test/resources/conformance/, services/mission-status-api/src/main/resources/leak-patterns.json, .github/workflows/ci-router.yml, .github/workflows/packs.yml, tests/ci/test_mission_status_routing.py, tests/ci/test_contracts_workflows.py, tests/architectural/test_ci_corpus_trigger_completeness.py, .gitattributes, tests/contract/_mission_status_payloads.py Subtasks: T036, T037, T038, T039, T040, T041 Prompt**: tasks/WP07-python-oracle-goldens-ci-routing.md

Work Package WP08: Phase 3a-1: filesystem adapter primitives (resolver, containment, allowlist, listing)

Dependencies: WP18 Requirement Refs: FR-006, FR-010, FR-016, C-005, NFR-003 Plan Concerns: IC-04 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/ReadDirResolver, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/SafeFiles, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/Allowlist, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/Listing, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/out/filesystem/ Subtasks: T042, T043, T044, T045 Prompt**: tasks/WP08-filesystem-adapter-primitives.md

Work Package WP19: Phase 3a-2: FilesystemMissionEventSource, flow-level allowlist checks and README stub

Dependencies: WP08 Requirement Refs: FR-004, FR-007, FR-010, FR-016, C-005, NFR-008, NFR-003, SC-006 Plan Concerns: IC-04 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/out/filesystem/FilesystemMissionEventSource, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/out/filesystem/, services/mission-status-api/README.md Subtasks: T046, T047 Prompt*: tasks/WP19-filesystem-event-source-and-readme-stub.md

Work Package WP09: Phase 3b: golden suite on the real adapter, second leg of the port-level subset, FR-013 floor

Dependencies: WP07, WP19 Requirement Refs: FR-008, FR-013, FR-001, FR-002, FR-005, FR-006, NFR-005, SC-001 Plan Concerns: IC-02, IC-04 Owned Files: services/mission-status-api/src/test/java/org/speckitty/missionstatus/conformance/golden/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/testsupport/ Subtasks: T048, T049, T050, T051, T052 Prompt: tasks/WP09-golden-suite-on-real-adapter.md

Work Package WP10: Phase 4a-1: HTTP controllers, Problem mapping, contract document, contract validation, wiring and bind guard

Dependencies: WP09 Requirement Refs: FR-001, FR-002, FR-004, FR-009, FR-011, C-001, C-004, NFR-003, SC-003 Plan Concerns: IC-05 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/config/, services/mission-status-api/src/main/resources/application.properties, services/mission-status-api/src/main/resources/META-INF/native-image/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/in/http/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/config/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/skeleton/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/testsupport/http/, services/mission-status-api/src/test/resources/application-test.properties, tests/ci/test_mission_status_api_build.py Subtasks: T053, T055, T056, T057 Prompt**: tasks/WP10-http-controllers-contract-wiring.md

Work Package WP20: Phase 4a-2: SSE events controller, cross-route flow checks and real native-tagged tests

Dependencies: WP10 Requirement Refs: FR-003, FR-004, FR-009, FR-010, FR-011, FR-016, NFR-003, SC-003 Plan Concerns: IC-05 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/config/, services/mission-status-api/src/main/resources/application.properties, services/mission-status-api/src/main/resources/META-INF/native-image/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/in/http/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/config/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/testsupport/http/, services/mission-status-api/src/test/resources/application-test.properties, services/mission-status-api/src/nativeTest/, tests/ci/test_mission_status_api_build.py Subtasks: T054, T085, T058, T059 Prompt**: tasks/WP20-sse-events-flow-checks-native-tagged-tests.md

Work Package WP11: Phase 4b: Host and Origin filter (403 set, closed 400 set, provisional E-7 rows)

Dependencies: WP20 Requirement Refs: FR-009, C-005, NFR-003, SC-005 Plan Concerns: IC-05 Owned Files: services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/HostOriginFilter, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/OwnPortSource, services/mission-status-api/src/main/java/org/speckitty/missionstatus/config/OwnPortHolder, services/mission-status-api/src/test/java/org/speckitty/missionstatus/adapter/in/http/hostorigin/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/HostOriginRefusal, services/mission-status-api/src/main/java/org/speckitty/missionstatus/config/HostOriginRegistration* Subtasks: T060, T061, T062, T063 Prompt: tasks/WP11-host-origin-filter.md

Work Package WP12: Phase 5a: native smoke replay (stage base), per-leg digests, gate digest comparison

Dependencies: WP20 Requirement Refs: FR-015, FR-010, FR-008, NFR-005, SC-004 Plan Concerns: IC-06 Owned Files: .github/workflows/mission-status-api.yml, tests/ci/test_mission_status_api_build.py, services/mission-status-api/src/test/java/org/speckitty/missionstatus/nativesmoke/, services/mission-status-api/src/test/resources/nativesmoke/, services/mission-status-api/src/main/java/org/speckitty/missionstatus/adapter/in/http/skeleton/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/skeleton/ Subtasks: T064, T065, T066, T067, T068 Prompt: tasks/WP12-native-smoke-replay-and-digests.md

Work Package WP13: Phase 5b: performance ratio tests (NFR-001, NFR-002, NFR-004)

Dependencies: WP12 Requirement Refs: NFR-001, NFR-002, NFR-004, NFR-005 Plan Concerns: IC-06 Owned Files: .github/workflows/mission-status-api.yml, tests/ci/test_mission_status_api_build.py, services/mission-status-api/src/test/java/org/speckitty/missionstatus/perf/, services/mission-status-api/src/test/java/org/speckitty/missionstatus/nativesmoke/ Subtasks: T069, T070, T071, T072 Prompt: tasks/WP13-performance-ratio-tests.md

Work Package WP14: Phase 5c: nightly full-corpus comparison job and script

Dependencies: WP13 Requirement Refs: FR-008, FR-015, C-006, SC-002 Plan Concerns: IC-06 Owned Files: .github/workflows/mission-status-api.yml, tests/ci/test_mission_status_api_build.py, scripts/ci/mission_status_corpus_compare.py, tests/ci/test_mission_status_corpus_compare.py Subtasks: T073, T074, T075, T076 Prompt: tasks/WP14-nightly-corpus-comparison.md

Work Package WP15: Phase 5d: tag-triggered release job (operator decision E-4)

Dependencies: WP14 Requirement Refs: FR-015, SC-004 Plan Concerns: IC-06 Owned Files: .github/workflows/mission-status-api.yml, tests/ci/test_mission_status_api_build.py Subtasks: T077, T078, T079 Prompt: tasks/WP15-tag-triggered-release-job.md

Work Package WP16: Phase 5e: Host/Origin smoke stage, README, docs and changelog close-out

Dependencies: WP11, WP15 Requirement Refs: FR-015, FR-009, NFR-008, C-010, C-011, C-012, C-013, SC-004, SC-005, SC-007, SC-008 Plan Concerns: IC-06 Owned Files: .github/workflows/mission-status-api.yml, services/mission-status-api/src/test/java/org/speckitty/missionstatus/nativesmoke/, services/mission-status-api/src/test/resources/nativesmoke/, services/mission-status-api/README.md, docs/development/reference/ci-gate-mechanics.md, docs/changelog/CHANGELOG.md Subtasks: T080, T081, T082, T083, T084 Prompt: tasks/WP16-host-origin-smoke-stage-readme-docs-changelog.md