diff --git a/README.md b/README.md index 0698800..19a0ddf 100644 --- a/README.md +++ b/README.md @@ -31,6 +31,8 @@ How one thread runs, using a real example: No orphan code, no silent scope, no untracked debt: an acceptance criterion is either verified by a test that names it, or it appears in an unchecked task; anything else fails `scripts/check-traceability.sh`. The [coverage matrix](specs/001-mvp/coverage.md) is a generated portfolio snapshot (regenerate with `--matrix` before hiring or release pushes); CI enforces integrity, not file freshness. Mechanics are documented in [traceability.md](traceability.md). +**Show the thread:** the [Thread Visualizer](docs/thread-visualizer/) is a read-only descent view over the same Gate 2 data (one requirement → `@covers` → `test_AC_*`, plus a seeded break state). Regenerate with `bash scripts/thread-visualizer-refresh.sh`. + ## Core documents | Document | Role | diff --git a/docs/thread-visualizer/README.md b/docs/thread-visualizer/README.md new file mode 100644 index 0000000..6083b6c --- /dev/null +++ b/docs/thread-visualizer/README.md @@ -0,0 +1,36 @@ +# Thread Visualizer + +Read-only projection of HomesFlow’s Gate 2 golden thread — for demo conversations. + +**Principle:** this tool formats data that already lives in the repo. It does not create, store, or duplicate requirement truth. + +## Open it + +```bash +bash scripts/thread-visualizer-refresh.sh +open docs/thread-visualizer/index.html # or any static file server +``` + +Because the page loads JSON via `fetch`, some browsers block `file://` requests. If that happens: + +```bash +cd docs/thread-visualizer && python3 -m http.server 8765 +# then visit http://127.0.0.1:8765/ +``` + +## What you should see + +1. **Descent** — one AC (default `AC-USER-04`) from PRD text → `@covers` modules → `test_AC_*` proof. +2. **Break the proof** — loads a seeded projection where that AC’s tests are stripped; status becomes `GAP` and the thread frays red. Same definition Gate 2 uses for a silent gap. +3. **Totals** — must match `bash scripts/check-traceability.sh` (registry IDs, AC count, ACs with tests). + +## Regenerate after code changes + +```bash +bash scripts/thread-visualizer-refresh.sh +``` + +Writes: + +- `data/thread.json` — live Gate 2 projection +- `data/thread-broken.json` — same data with demo break on `AC-USER-04` diff --git a/docs/thread-visualizer/SPEC.md b/docs/thread-visualizer/SPEC.md new file mode 100644 index 0000000..b013aca --- /dev/null +++ b/docs/thread-visualizer/SPEC.md @@ -0,0 +1,72 @@ +# Thread Visualizer — Build Spec for HomesFlow + +**For:** Claude in Cursor, building inside the HomesFlow repo. +**Purpose:** A read-only visualizer that renders HomesFlow's existing Gate 2 traceability chain as a showable artifact — the "golden thread" made visible for demo conversations (clients, and a collaborator named David). +**Status:** Build spec. The visual is a projection of real data; it must never become a second source of truth. + +--- + +## The one non-negotiable principle + +This tool **reads** the thread that already exists. It does not create, store, or duplicate any requirement truth. Every ID it displays must be extracted live from where that ID durably lives: + +- Registry IDs from `HomesFlow.prd.md` +- Acceptance criteria from the PRD +- `@covers` annotations in the Swift source +- `test_AC_*` test names in the test suite + +If the visualizer ever holds its own copy of an ID or a trace link, it has become a second registry and defeats its own purpose. It is a formatter over Gate 2's data, nothing more. When the code changes and regenerates, the visual changes. There is no hand-maintained diagram anywhere in this feature. + +## Why this exists + +HomesFlow's Gate 2 already enforces the chain: every acceptance criterion must be verified by a named test or explicitly tracked as debt, and silent gaps fail the build. That enforcement is currently legible only as a passing/failing script and a set of numbers. This tool makes the same chain *visible* — so someone across a table can see the trace from intent to proof, and see it break in real time. + +## What to build, in order + +### Part 1: The walker (the real artifact) + +A script (language your call — Swift, or a small Node/Python tool in the repo tooling, whatever fits HomesFlow's existing Gate 2 tooling best; reuse the Gate 2 parser if one exists rather than writing a second parser). + +It walks the repo and emits **structured data** (JSON) representing the thread. For each registry ID / acceptance criterion, it resolves the chain: + +``` +objective/requirement (PRD registry ID + AC text) + -> implementation (Swift files/symbols carrying @covers for that ID) + -> proof (test_AC_* tests naming that ID) + -> status: verified | tracked-debt | blocked | GAP +``` + +The walker's output is the deliverable everything else formats. Design its JSON so a single requirement's full descent is one addressable object. Critically, it must mark the **gaps** — an AC with no test and no tracked-debt entry is the most important thing on the screen, not the least. Reuse Gate 2's own definition of a gap so the visualizer and the build agree exactly; they must never disagree about what counts as covered. + +Verification for this part: the walker's totals must match Gate 2's own numbers (registry ID count, AC count, covered count). If the walker says 45 covered and Gate 2 says 45 covered, the walker is reading the thread correctly. If they disagree, the walker is wrong, not Gate 2. + +### Part 2: The descent view (the demo) + +A single-thread vertical rendering: pick one requirement, show its full descent top to bottom — requirement at top, implementation beneath, proof at the bottom, the ID as the through-line connecting all tiers. This is the money shot for the first conversation: "here is one intent, and here is the unbroken line to the proof it was delivered." + +Design intent (do not skip): this must look deliberate, not like a raw dependency graph. Clean vertical, the ID quiet but present at each tier, generous spacing, one confident accent color for the intact thread. If HomesFlow or dryfoos.com has an existing visual language (there is a golden-thread motif on the site), echo it. A hairball node-graph of all 79 IDs is the wrong lead artifact; one clean descent is the right one. The full graph can be a secondary "and it scales" view, shown only after the single descent lands, and only to a technical audience. + +### Part 3: The break state (the emotional beat) + +The reason this beats a static slide: it must show a **broken thread going red, live**. Demonstrate that deleting a test (or renaming an AC so its `test_AC_*` no longer matches) causes that requirement's descent to visibly fray — the proof tier goes red, the status flips to GAP, and this mirrors exactly what Gate 2 would fail the build on. Seed a deliberate broken example for the demo rather than exposing real current gaps. + +The pitch this enables: "watch — when the proof disappears, the thread shows it, and the build fails. You cannot quietly break this." That is the entire value proposition made visible. Prioritize this beat; an intact-only visualizer is worth far less than one that shows the break. + +## What NOT to do + +- Do not hand-draw or hand-place any nodes/edges. Everything renders from walker output. +- Do not create a new ID scheme or store IDs anywhere. Read from PRD / @covers / test names only. +- Do not let the visualizer's notion of "covered" drift from Gate 2's. One definition, reused. +- Do not lead with the full-graph hairball. Single descent first. +- Do not fake the break. It must reflect a real regeneration over real (or deliberately-seeded) repo state. + +## Definition of done + +1. Walker emits JSON whose totals match Gate 2's numbers exactly. +2. Descent view renders one real requirement's full chain, styled to show well. +3. Deleting/breaking a test causes that requirement to render red as a GAP on regeneration. +4. Nothing in the feature stores requirement truth; it is entirely a projection. + +## Note for Rik (not for Cursor) + +This is scoped to HomesFlow because HomesFlow's thread is real and populated (79 registry IDs, 50 ACs, 45 covered) — a compelling descent needs real data underneath it, and Spudnik's thread is still mostly empty scaffolding. The same walker pattern later ports to Spudnik's thread (objective -> policy -> skill -> test) once that repo's thread is populated, but the demo artifact should be built where the data already lives. Trace this work to STR-02 (convert experience into showable evidence) in your objectives, and note the durable-ID discipline it embodies is the same one at the center of the SpecDriven/David conversation — which makes this visualizer itself a demo asset for STR-03. diff --git a/docs/thread-visualizer/data/thread-broken.json b/docs/thread-visualizer/data/thread-broken.json new file mode 100644 index 0000000..447593c --- /dev/null +++ b/docs/thread-visualizer/data/thread-broken.json @@ -0,0 +1,2186 @@ +{ + "generatedAt": "2026-08-04T01:35:05Z", + "commit": "f1b2660", + "source": { + "gate2": "scripts/check-traceability.sh", + "prd": "HomesFlow.prd.md", + "principle": "Projection only \u2014 not a second registry" + }, + "totals": { + "registryIds": 79, + "acs": 50, + "acsWithTests": 44, + "idsWithCovers": 69, + "acsVerified": 44, + "acsTrackedDebt": 5, + "acsGap": 1, + "gate2Passed": true + }, + "defaultDescentId": "AC-USER-04", + "demoBreakId": "AC-USER-04", + "threads": [ + { + "id": "AC-A11Y-01", + "requirement": { + "id": "AC-A11Y-01", + "text": "Given the user has increased text size via iOS Settings (Dynamic Type / Accessibility sizes), when they view dashboard, home detail, or procedure screens, then primary text and controls scale, layouts reflow without clipping essential actions, and primary reading content does not require horizontal scrolling.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Home/HomeHeroCard.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_01_hero_height_grows_with_text_size", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + }, + { + "name": "test_AC_A11Y_01_scale_factor_is_monotonic_across_sizes", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-A11Y-02", + "requirement": { + "id": "AC-A11Y-02", + "text": "Given VoiceOver is enabled, when the user navigates home section tabs (horizontal on iPhone, vertical on iPad), then each tab exposes a combined accessibility label (section name + role), selected state is announced, and interactive controls have meaningful hints where non-obvious.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021b", + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_02_every_section_tab_has_meaningful_voiceover_text", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + }, + { + "name": "test_AC_A11Y_02_step_status_values_cover_all_statuses", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-A11Y-03", + "requirement": { + "id": "AC-A11Y-03", + "text": "Given Reduce Motion is enabled in iOS Settings, when the user navigates between sections or primary screens, then non-essential motion animations are omitted or reduced per system preference.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_03_reduce_motion_disables_animation", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-01", + "requirement": { + "id": "AC-GUEST-01", + "text": "Given a Guest signs in to a home, when they view info, then only fields marked for Guest visibility are shown and edit controls are disabled.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T057", + "T062", + "T065" + ], + "pendingTasks": [ + "T064" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Documents/DocumentRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_01_guest_fields_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-02", + "requirement": { + "id": "AC-GUEST-02", + "text": "Given a Guest tries to access a restricted procedure or document via deep link, when the app evaluates permissions, then access is denied and a clear message is shown explaining limitations.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T005", + "T010", + "T058", + "T063a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Models/EntityAccessState.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Guest/GuestAccessDeniedView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProceduresView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_02_restricted_deep_link_denied", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-03", + "requirement": { + "id": "AC-GUEST-03", + "text": "Given the Guest receives updated guest-visibility content while offline and another actor changes visibility before sync, when devices sync, then the most recent timestamp determines visibility and Guests see the latest allowed content.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T059", + "T063b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_03_offline_visibility_sync", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-04", + "requirement": { + "id": "AC-GUEST-04", + "text": "Given a Guest opens a guest procedure, when they view it, then they can see step descriptions and read-only status but cannot change step statuses.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047c", + "T060", + "T063c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProceduresView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_04_guest_procedure_read_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-05", + "requirement": { + "id": "AC-GUEST-05", + "text": "Given a Guest attempts to mark a guest step complete, when they submit, then the app rejects the change and logs the attempted unauthorized action for audit.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T061", + "T063" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_05_guest_cannot_update_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-01", + "requirement": { + "id": "AC-HOME-01", + "text": "Given an authenticated Owner on a connected device, when they submit valid home details and photos, then the home is created and visible in their dashboard with correct data.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T018", + "T019" + ], + "pendingTasks": [ + "T022" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_01_valid_home_passes_validation", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-02", + "requirement": { + "id": "AC-HOME-02", + "text": "Given an Owner submits incomplete/invalid home details, when they attempt to save, then validation errors are shown and the home is not created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T018", + "T023" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_02_empty_address_rejected", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + }, + { + "name": "test_AC_HOME_02_empty_name_rejected", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-03", + "requirement": { + "id": "AC-HOME-03", + "text": "Given an Owner edits home details while offline and another device edits the same home before sync, when both devices reconnect, then the version with the most recent timestamp is applied and a conflict log entry is created for audit.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T020", + "T024" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OutboxSyncPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_03_local_newer_keeps_pending_local", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + }, + { + "name": "test_AC_HOME_03_older_pending_edit_does_not_push_over_newer_server", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_HOME_03_server_newer_overwrites_pending_local", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + }, + { + "name": "test_AC_HOME_03_synced_home_applies_server", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-04", + "requirement": { + "id": "AC-HOME-04", + "text": "Given a Manager user opens the service provider directory, when they search and select a provider, then they can edit contact details and changes are saved and propagated to permitted users.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T051", + "T052", + "T055" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderFieldMerge.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_04_local_newer_edit_is_kept", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_04_provider_edit_propagates", + "path": "ios/HomesFlowTests/ProviderTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-05", + "requirement": { + "id": "AC-HOME-05", + "text": "Given a Manager user edits a provider entry that an Owner later deletes on another device before sync, when both devices sync, then the most recent timestamp between edit and delete determines final state; if delete is most recent the provider is removed and the editor receives a notification that their edit was removed due to delete.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T037", + "T053", + "T056" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_05_delete_wins_over_edit", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_05_local_only_insert_survives_pull", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_05_synced_row_removed_silently", + "path": "ios/HomesFlowTests/ProviderTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-06", + "requirement": { + "id": "AC-HOME-06", + "text": "Given an Owner or Manager user uploads a home photo, when the photo is saved to Storage, then the client uploads a display-optimized JPEG bounded to a maximum pixel dimension (not full camera resolution).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019a", + "T024a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentStorageService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoCache.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_06_invalid_image_data_rejected", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_06_small_image_not_upscaled", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_06_upload_resizes_before_storage", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-07", + "requirement": { + "id": "AC-HOME-07", + "text": "Given a user has previously loaded a home photo on this device, when they view the dashboard or home detail again, then the hero photo renders from local cache without re-downloading from Storage.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019a", + "T024b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoCache.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Home/HomeHeroCard.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_07_hero_renders_from_local_cache", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_07_removed_photo_no_longer_cached", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-08", + "requirement": { + "id": "AC-HOME-08", + "text": "Given a home record has not yet synced to the server, when an Owner or Manager user attempts to upload a photo, then the upload is blocked and the user sees actionable guidance to sync first (e.g., pull to refresh while online).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019", + "T024c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomePhotoSyncGate.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Dashboard/DashboardView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_08_blocked_errors_carry_actionable_guidance", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_connected_upload_runs_sync_then_passes_when_synced", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_offline_edit_without_photo_defers_sync", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_photo_blocked_until_home_synced", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-09", + "requirement": { + "id": "AC-HOME-09", + "text": "Given a user views home detail on iPad (regular horizontal size class), when any section is selected, then the trailing area shows section content only \u2014 no full-bleed home hero and no horizontal section tab bar at the home level (nested section list | detail splits are allowed inside the trailing area).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021a" + ], + "pendingTasks": [ + "T024d" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-10", + "requirement": { + "id": "AC-HOME-10", + "text": "Given a user opens a home on iPad, when home detail is shown, then the leading column displays a compact home hero (photo, name, address) and vertically stacked tappable section entries with icon and label for Procedures, Contacts, Files, and People; the trailing area shows the selected section using a three-panel layout (sidebar already visible + section list + section detail) for **all four** sections.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021a", + "T021c" + ], + "pendingTasks": [ + "T024e" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/PeopleSelection.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-11", + "requirement": { + "id": "AC-HOME-11", + "text": "Given a user views home detail on any device, when section navigation is shown, then section labels read Procedures, Contacts, Files, and People (Files implements the document library).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021b", + "T065" + ], + "pendingTasks": [ + "T024f" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-12", + "requirement": { + "id": "AC-HOME-12", + "text": "Given a user with permission to add content views a home section list (Contacts, Files, People), when the section is shown, then a single add action appears as the toolbar primary action using a parallel construction across sections \u2014 a plus icon with an accessible label naming the action (e.g., Add contact, Add file, Invite member) that opens the section's create sheet; users without permission see no add action.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065a", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/SectionAddAction.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_12_contacts_and_files_add_for_owner_and_manager", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_guest_has_no_section_add_actions", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_matches_repository_manage_flags", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_people_add_owner_only", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_section_add_actions_use_parallel_construction", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-13", + "requirement": { + "id": "AC-HOME-13", + "text": "Given a user opens a file's detail, when they tap **Preview**, then the system Quick Look preview opens with zoom, scroll, and playback for supported types (images, PDFs, video, audio); detail shows a file summary, metadata, Preview action, share/download, and management actions below.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065b", + "T065e", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentPreviewSupport.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/DocumentQuickLookPreview.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_13_local_file_name_falls_back_to_id_and_extension", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_local_file_name_uses_storage_path", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_non_success_download_throws", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_preview_icon_maps_by_extension", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_streams_download_to_preview_directory", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-14", + "requirement": { + "id": "AC-HOME-14", + "text": "Given an Owner or Manager adds a file, when they choose the file source, then camera capture, photo library, and file browser options are all offered, and content from any source uploads through the same metadata flow (title, category, visibility).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065c", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentPreviewSupport.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_14_apply_pick_fills_title_from_file_name", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_apply_pick_preserves_existing_title", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_camera_file_name_is_dated_jpeg", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_includes_camera_when_available", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_offers_library_and_file_browser_sources", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_upload_requires_valid_draft_and_file_data", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-01", + "requirement": { + "id": "AC-LOG-01", + "text": "Given an Owner or Manager opens the Log Book for a home, when they write and save a household-scope entry, then the entry appears in the unified log with author and timestamp.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T078", + "T084" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_01_household_entry_appears_in_log", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-02", + "requirement": { + "id": "AC-LOG-02", + "text": "Given an Owner or Manager views a procedure, when they write a procedure-scope log entry, then the entry is attached to that procedure and also appears in the unified log.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T079", + "T084" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_02_procedure_entry_attached_and_in_log", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-03", + "requirement": { + "id": "AC-LOG-03", + "text": "Given a permitted user writes a log entry while offline, when the device reconnects, then the entry syncs append-only (no conflict resolution needed) and appears for other permitted users.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T080", + "T085" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_03_offline_entry_syncs_append_only", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-04", + "requirement": { + "id": "AC-LOG-04", + "text": "Given a log entry has synced to the server, when the author attempts to edit it, then editing is allowed only within a **10-minute** grace window that starts at server receipt; after the window the entry is immutable.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T081", + "T085" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookGraceWindowPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_04_edit_only_within_grace_window", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-05", + "requirement": { + "id": "AC-LOG-05", + "text": "Given a permitted user opens the unified log view, when entries exist at both household and procedure scope, then entries are shown chronologically and can be filtered by scope.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T082", + "T086" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookScopeFilter.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_05_unified_log_chronological_and_filterable", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-06", + "requirement": { + "id": "AC-LOG-06", + "text": "Given a Guest is signed in, when they attempt to view the Log Book directly or via deep link, then access is denied with a clear message.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T077", + "T083", + "T086" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_06_guest_denied_log_access", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-01", + "requirement": { + "id": "AC-PROC-01", + "text": "Given a Manager user views a procedure, when they mark a step Complete, then the step status updates for all users with appropriate visibility, the procedure's aggregate status and progress in the procedures list update immediately, and an activity log entry is created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T042", + "T046", + "T048" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/ActivityLog/ActivityLogService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_01_complete_and_na_steps_mark_procedure_complete", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_01_completed_step_counts_toward_progress", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_01_final_step_completion_marks_procedure_complete", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-02", + "requirement": { + "id": "AC-PROC-02", + "text": "Given a Manager user attempts to update a step beyond their permission (e.g., another home's owner-only procedure or step), when they submit the change, then the app blocks the update and shows a permission error.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T010", + "T044", + "T049" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_02_guest_cannot_update_guest_visible_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + }, + { + "name": "test_AC_PROC_02_manager_cannot_update_owner_only_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-03", + "requirement": { + "id": "AC-PROC-03", + "text": "Given a Manager user updates a step while offline and another user updates the same step before sync, when both devices reconnect, then the update with the most recent timestamp is persisted and the other user receives a notification about the overwritten change with reference to the activity log.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T037", + "T045", + "T050" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_03_local_newer_keeps_pending_local", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_03_server_newer_overwrites_pending_local", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-04", + "requirement": { + "id": "AC-PROC-04", + "text": "Given an Owner or Manager user long-presses a step on a procedure they can modify, when the context menu appears, then Edit, Delete, Move Up, and Move Down are available.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047b", + "T050a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_04_manager_can_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_04_manager_cannot_manage_owner_only_procedure_steps", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_04_owner_can_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-05", + "requirement": { + "id": "AC-PROC-05", + "text": "Given an Owner or Manager user taps Add on the Steps section, when they enter a title and save, then a new step is appended at the next sort order and appears for permitted users after sync.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047b", + "T050a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_05_move_down_swaps_with_next_step", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_move_is_noop_at_list_boundaries", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_move_up_swaps_with_previous_step", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_new_step_appends_at_end", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-06", + "requirement": { + "id": "AC-PROC-06", + "text": "Given an Owner or Manager user creates, renames, reorders, or deletes a step, when the change syncs, then it persists for permitted users and an activity log entry is created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047a", + "T050b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_06_structure_changes_produce_activity_summaries", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-07", + "requirement": { + "id": "AC-PROC-07", + "text": "Given a Guest views a procedure, when they interact with steps, then step structure controls (long-press menu, Add step) are not available and step status remains read-only.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047c", + "T050c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_07_guest_cannot_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-08", + "requirement": { + "id": "AC-PROC-08", + "text": "Given a user views a step with an attached photo, when they tap **Photo attached**, then the photo opens in a modal preview; step rows show notes below the title, a tappable photo indicator when present, a pencil **Edit** control (when permitted) to the left of the status ellipsis menu, and the ellipsis menu remains rightmost.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047d", + "T050d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/StepRowPresentation.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_08_photo_indicator_and_edit_controls", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + }, + { + "name": "test_AC_PROC_08_tap_toggle_status_mapping", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + }, + { + "name": "test_AC_PROC_08_terminal_statuses_strike_through", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-01", + "requirement": { + "id": "AC-SYNC-01", + "text": "Given any user makes an update while offline, when the device reconnects, then the client syncs changes and the server resolves conflicts with most-recent timestamp wins; the client surfaces a notification when their offline change was overwritten.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T020", + "T034", + "T037", + "T038", + "T045", + "T053", + "T072" + ], + "pendingTasks": [ + "T027" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderFieldMerge.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OutboxSyncPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OverwriteNotificationPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_01_conflict_decision_is_idempotent", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_home_timestamp_wins_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_offline_overwrite_notifies_loser", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_provider_timestamp_wins_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_server_delete_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-02", + "requirement": { + "id": "AC-SYNC-02", + "text": "Given two users modify different fields of the same entity while offline, when sync occurs, then both non-conflicting changes are merged and persisted, and an audit record notes the combined update. *(Deferred to post-MVP phase \u2014 see conflict model evolution note.)*", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T072" + ], + "pendingTasks": [ + "T035", + "T039" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-SYNC-03", + "requirement": { + "id": "AC-SYNC-03", + "text": "Given a user attempts an action that depends on stale permissions cached offline, when syncing, then if the server denies the action, the client reverts the change and shows a permission error with guidance to retry.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T036", + "T040", + "T072" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/PermissionRevertPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_03_permission_denied_revert_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-04", + "requirement": { + "id": "AC-SYNC-04", + "text": "Given local changes or homes are pending sync to the server, when the user views the dashboard, then unsynced homes are visibly indicated and the user can pull to refresh to retry sync while online.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T015", + "T037", + "T040a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/SyncIndicatorPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Dashboard/DashboardView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_04_pending_state_announced_to_voiceover", + "path": "ios/HomesFlowTests/SyncIndicatorTests.swift" + }, + { + "name": "test_AC_SYNC_04_pending_sync_visible_on_dashboard", + "path": "ios/HomesFlowTests/SyncIndicatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-05", + "requirement": { + "id": "AC-SYNC-05", + "text": "Given a step is marked Complete or N/A on one device, when a concurrent offline update from another device would change that step's status, then sync never silently regresses the Complete/N/A status; the conflicting update is surfaced instead of auto-applied.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T074", + "T074a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/StepStatusConflictPolicy.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_05_terminal_status_never_silently_regressed", + "path": "ios/HomesFlowTests/StepStatusConflictPolicyTests.swift" + }, + { + "name": "test_AC_SYNC_05_terminal_step_protection_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-06", + "requirement": { + "id": "AC-SYNC-06", + "text": "Given two devices make conflicting status changes to the same step or procedure while offline, when both sync, then the server resolves automatically (most-recent timestamp, subject to AC-SYNC-05 terminal-status protection) and the user whose change lost receives a notification with an activity-log reference and guidance to re-apply their change if still needed.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T075", + "T075a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/StepStatusConflictPolicy.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_06_losing_user_notified_with_reapply_guidance", + "path": "ios/HomesFlowTests/StepStatusConflictPolicyTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-07", + "requirement": { + "id": "AC-SYNC-07", + "text": "Given a device is offline, when the user attempts a structural action (create/rename/reorder/delete steps, procedures, providers, or membership changes), then the action is disabled or blocked with clear messaging; structural actions require connectivity.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T076", + "T076a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/StructuralActionPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_07_structural_actions_blocked_offline", + "path": "ios/HomesFlowTests/StructuralActionPolicyTests.swift" + }, + { + "name": "test_AC_SYNC_07_structural_offline_gate_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-01", + "requirement": { + "id": "AC-USER-01", + "text": "Given an Owner provides an email/phone and role and sends an invite, when the invite is accepted, then the invitee is added to the home with the assigned role and receives appropriate permissions immediately.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T026", + "T030" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_01_invite_accepted_grants_role", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + }, + { + "name": "test_AC_USER_01_invite_email_validation_and_token_shape", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-02", + "requirement": { + "id": "AC-USER-02", + "text": "Given an Owner re-sends or revokes an invite before acceptance, when they revoke, then the invite token becomes invalid and the invitee cannot join with that token.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T031" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/PeopleSelection.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/PendingInviteDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_02_revoked_token_invalid", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-03", + "requirement": { + "id": "AC-USER-03", + "text": "Given an Owner invites a user while offline and the invite is processed on another device first, when sync occurs, then the most recent action (invite or revoke) by timestamp determines invite state and the Owner receives a notification of the resolved outcome.", + "source": "HomesFlow.prd.md", + "doneTasks": [], + "pendingTasks": [ + "T027", + "T033a" + ] + }, + "implementation": { + "covered": false, + "modules": [] + }, + "proof": { + "tests": [] + }, + "gateStatus": "planned", + "status": "tracked-debt" + }, + { + "id": "AC-USER-04", + "requirement": { + "id": "AC-USER-04", + "text": "Given an Owner assigns a Manager role to a user, when the user signs in, then they can create and modify procedures and service providers for that home.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T032" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "gap", + "status": "GAP" + }, + { + "id": "AC-USER-05", + "requirement": { + "id": "AC-USER-05", + "text": "Given an Owner assigns a Guest role to a user, when the guest signs in, then they see only guest-appropriate fields (e.g., WiFi, guest procedures) and cannot edit protected data.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T033" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_05_guest_role_read_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-06", + "requirement": { + "id": "AC-USER-06", + "text": "Given concurrent role changes occur on multiple devices, when devices sync, then the change with the most recent timestamp wins and an owner-visible audit entry records the prior role.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T029", + "T033b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_06_concurrent_role_change_audit", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-07", + "requirement": { + "id": "AC-USER-07", + "text": "Given an Owner creates an invite in MVP, when the invitee receives the shared invite link or token and signs in with the invited email, then they can accept the invite (paste token or open link) and join the home with the assigned role.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T026", + "T033c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/PendingInviteDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_07_paste_token_accepts_invite", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + } + ], + "demo": { + "broken": true, + "breakId": "AC-USER-04", + "note": "Seeded demo break: proof tests for this AC were removed in the projection only. Regenerated from live Gate 2 data + surgical strip." + } +} diff --git a/docs/thread-visualizer/data/thread.json b/docs/thread-visualizer/data/thread.json new file mode 100644 index 0000000..272aa64 --- /dev/null +++ b/docs/thread-visualizer/data/thread.json @@ -0,0 +1,2195 @@ +{ + "generatedAt": "2026-08-04T01:35:04Z", + "commit": "f1b2660", + "source": { + "gate2": "scripts/check-traceability.sh", + "prd": "HomesFlow.prd.md", + "principle": "Projection only \u2014 not a second registry" + }, + "totals": { + "registryIds": 79, + "acs": 50, + "acsWithTests": 45, + "idsWithCovers": 69, + "acsVerified": 45, + "acsTrackedDebt": 5, + "acsGap": 0, + "gate2Passed": true + }, + "defaultDescentId": "AC-USER-04", + "demoBreakId": "AC-USER-04", + "threads": [ + { + "id": "AC-A11Y-01", + "requirement": { + "id": "AC-A11Y-01", + "text": "Given the user has increased text size via iOS Settings (Dynamic Type / Accessibility sizes), when they view dashboard, home detail, or procedure screens, then primary text and controls scale, layouts reflow without clipping essential actions, and primary reading content does not require horizontal scrolling.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Home/HomeHeroCard.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_01_hero_height_grows_with_text_size", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + }, + { + "name": "test_AC_A11Y_01_scale_factor_is_monotonic_across_sizes", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-A11Y-02", + "requirement": { + "id": "AC-A11Y-02", + "text": "Given VoiceOver is enabled, when the user navigates home section tabs (horizontal on iPhone, vertical on iPad), then each tab exposes a combined accessibility label (section name + role), selected state is announced, and interactive controls have meaningful hints where non-obvious.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021b", + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_02_every_section_tab_has_meaningful_voiceover_text", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + }, + { + "name": "test_AC_A11Y_02_step_status_values_cover_all_statuses", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-A11Y-03", + "requirement": { + "id": "AC-A11Y-03", + "text": "Given Reduce Motion is enabled in iOS Settings, when the user navigates between sections or primary screens, then non-essential motion animations are omitted or reduced per system preference.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T066a" + ], + "pendingTasks": [ + "T069a" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/AccessibilityBaseline.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_A11Y_03_reduce_motion_disables_animation", + "path": "ios/HomesFlowTests/AccessibilityBaselineTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-01", + "requirement": { + "id": "AC-GUEST-01", + "text": "Given a Guest signs in to a home, when they view info, then only fields marked for Guest visibility are shown and edit controls are disabled.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T057", + "T062", + "T065" + ], + "pendingTasks": [ + "T064" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Documents/DocumentRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_01_guest_fields_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-02", + "requirement": { + "id": "AC-GUEST-02", + "text": "Given a Guest tries to access a restricted procedure or document via deep link, when the app evaluates permissions, then access is denied and a clear message is shown explaining limitations.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T005", + "T010", + "T058", + "T063a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Models/EntityAccessState.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Guest/GuestAccessDeniedView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProceduresView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_02_restricted_deep_link_denied", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-03", + "requirement": { + "id": "AC-GUEST-03", + "text": "Given the Guest receives updated guest-visibility content while offline and another actor changes visibility before sync, when devices sync, then the most recent timestamp determines visibility and Guests see the latest allowed content.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T059", + "T063b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_03_offline_visibility_sync", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-04", + "requirement": { + "id": "AC-GUEST-04", + "text": "Given a Guest opens a guest procedure, when they view it, then they can see step descriptions and read-only status but cannot change step statuses.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047c", + "T060", + "T063c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProceduresView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_04_guest_procedure_read_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-GUEST-05", + "requirement": { + "id": "AC-GUEST-05", + "text": "Given a Guest attempts to mark a guest step complete, when they submit, then the app rejects the change and logs the attempted unauthorized action for audit.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T061", + "T063" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_GUEST_05_guest_cannot_update_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-01", + "requirement": { + "id": "AC-HOME-01", + "text": "Given an authenticated Owner on a connected device, when they submit valid home details and photos, then the home is created and visible in their dashboard with correct data.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T018", + "T019" + ], + "pendingTasks": [ + "T022" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_01_valid_home_passes_validation", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-02", + "requirement": { + "id": "AC-HOME-02", + "text": "Given an Owner submits incomplete/invalid home details, when they attempt to save, then validation errors are shown and the home is not created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T018", + "T023" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_02_empty_address_rejected", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + }, + { + "name": "test_AC_HOME_02_empty_name_rejected", + "path": "ios/HomesFlowTests/HomeValidatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-03", + "requirement": { + "id": "AC-HOME-03", + "text": "Given an Owner edits home details while offline and another device edits the same home before sync, when both devices reconnect, then the version with the most recent timestamp is applied and a conflict log entry is created for audit.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T020", + "T024" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomeConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OutboxSyncPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeSetup/HomeSetupView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_03_local_newer_keeps_pending_local", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + }, + { + "name": "test_AC_HOME_03_older_pending_edit_does_not_push_over_newer_server", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_HOME_03_server_newer_overwrites_pending_local", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + }, + { + "name": "test_AC_HOME_03_synced_home_applies_server", + "path": "ios/HomesFlowTests/HomeConflictResolverTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-04", + "requirement": { + "id": "AC-HOME-04", + "text": "Given a Manager user opens the service provider directory, when they search and select a provider, then they can edit contact details and changes are saved and propagated to permitted users.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T051", + "T052", + "T055" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderFieldMerge.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_04_local_newer_edit_is_kept", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_04_provider_edit_propagates", + "path": "ios/HomesFlowTests/ProviderTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-05", + "requirement": { + "id": "AC-HOME-05", + "text": "Given a Manager user edits a provider entry that an Owner later deletes on another device before sync, when both devices sync, then the most recent timestamp between edit and delete determines final state; if delete is most recent the provider is removed and the editor receives a notification that their edit was removed due to delete.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T037", + "T053", + "T056" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_05_delete_wins_over_edit", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_05_local_only_insert_survives_pull", + "path": "ios/HomesFlowTests/ProviderTests.swift" + }, + { + "name": "test_AC_HOME_05_synced_row_removed_silently", + "path": "ios/HomesFlowTests/ProviderTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-06", + "requirement": { + "id": "AC-HOME-06", + "text": "Given an Owner or Manager user uploads a home photo, when the photo is saved to Storage, then the client uploads a display-optimized JPEG bounded to a maximum pixel dimension (not full camera resolution).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019a", + "T024a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentStorageService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoCache.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_06_invalid_image_data_rejected", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_06_small_image_not_upscaled", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_06_upload_resizes_before_storage", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-07", + "requirement": { + "id": "AC-HOME-07", + "text": "Given a user has previously loaded a home photo on this device, when they view the dashboard or home detail again, then the hero photo renders from local cache without re-downloading from Storage.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019a", + "T024b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoCache.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Storage/HomePhotoService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Home/HomeHeroCard.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_07_hero_renders_from_local_cache", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_07_removed_photo_no_longer_cached", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-08", + "requirement": { + "id": "AC-HOME-08", + "text": "Given a home record has not yet synced to the server, when an Owner or Manager user attempts to upload a photo, then the upload is blocked and the user sees actionable guidance to sync first (e.g., pull to refresh while online).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T019", + "T024c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Home/HomePhotoSyncGate.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Home/HomeRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Dashboard/DashboardView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_08_blocked_errors_carry_actionable_guidance", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_connected_upload_runs_sync_then_passes_when_synced", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_offline_edit_without_photo_defers_sync", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + }, + { + "name": "test_AC_HOME_08_photo_blocked_until_home_synced", + "path": "ios/HomesFlowTests/HomePhotoTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-09", + "requirement": { + "id": "AC-HOME-09", + "text": "Given a user views home detail on iPad (regular horizontal size class), when any section is selected, then the trailing area shows section content only \u2014 no full-bleed home hero and no horizontal section tab bar at the home level (nested section list | detail splits are allowed inside the trailing area).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021a" + ], + "pendingTasks": [ + "T024d" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-10", + "requirement": { + "id": "AC-HOME-10", + "text": "Given a user opens a home on iPad, when home detail is shown, then the leading column displays a compact home hero (photo, name, address) and vertically stacked tappable section entries with icon and label for Procedures, Contacts, Files, and People; the trailing area shows the selected section using a three-panel layout (sidebar already visible + section list + section detail) for **all four** sections.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021a", + "T021c" + ], + "pendingTasks": [ + "T024e" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/PeopleSelection.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-11", + "requirement": { + "id": "AC-HOME-11", + "text": "Given a user views home detail on any device, when section navigation is shown, then section labels read Procedures, Contacts, Files, and People (Files implements the document library).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T021b", + "T065" + ], + "pendingTasks": [ + "T024f" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-HOME-12", + "requirement": { + "id": "AC-HOME-12", + "text": "Given a user with permission to add content views a home section list (Contacts, Files, People), when the section is shown, then a single add action appears as the toolbar primary action using a parallel construction across sections \u2014 a plus icon with an accessible label naming the action (e.g., Add contact, Add file, Invite member) that opens the section's create sheet; users without permission see no add action.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065a", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/UI/SectionAddAction.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_12_contacts_and_files_add_for_owner_and_manager", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_guest_has_no_section_add_actions", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_matches_repository_manage_flags", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_people_add_owner_only", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_12_section_add_actions_use_parallel_construction", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-13", + "requirement": { + "id": "AC-HOME-13", + "text": "Given a user opens a file's detail, when they tap **Preview**, then the system Quick Look preview opens with zoom, scroll, and playback for supported types (images, PDFs, video, audio); detail shows a file summary, metadata, Preview action, share/download, and management actions below.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065b", + "T065e", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentPreviewSupport.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/DocumentQuickLookPreview.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_13_local_file_name_falls_back_to_id_and_extension", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_local_file_name_uses_storage_path", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_non_success_download_throws", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_preview_icon_maps_by_extension", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_13_streams_download_to_preview_directory", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-HOME-14", + "requirement": { + "id": "AC-HOME-14", + "text": "Given an Owner or Manager adds a file, when they choose the file source, then camera capture, photo library, and file browser options are all offered, and content from any source uploads through the same metadata flow (title, category, visibility).", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T065c", + "T065d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Documents/DocumentPreviewSupport.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Documents/FilesView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_HOME_14_apply_pick_fills_title_from_file_name", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_apply_pick_preserves_existing_title", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_camera_file_name_is_dated_jpeg", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_includes_camera_when_available", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_offers_library_and_file_browser_sources", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + }, + { + "name": "test_AC_HOME_14_upload_requires_valid_draft_and_file_data", + "path": "ios/HomesFlowTests/FilesFeatureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-01", + "requirement": { + "id": "AC-LOG-01", + "text": "Given an Owner or Manager opens the Log Book for a home, when they write and save a household-scope entry, then the entry appears in the unified log with author and timestamp.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T078", + "T084" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_01_household_entry_appears_in_log", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-02", + "requirement": { + "id": "AC-LOG-02", + "text": "Given an Owner or Manager views a procedure, when they write a procedure-scope log entry, then the entry is attached to that procedure and also appears in the unified log.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T079", + "T084" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_02_procedure_entry_attached_and_in_log", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-03", + "requirement": { + "id": "AC-LOG-03", + "text": "Given a permitted user writes a log entry while offline, when the device reconnects, then the entry syncs append-only (no conflict resolution needed) and appears for other permitted users.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T080", + "T085" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookEntryDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_03_offline_entry_syncs_append_only", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-04", + "requirement": { + "id": "AC-LOG-04", + "text": "Given a log entry has synced to the server, when the author attempts to edit it, then editing is allowed only within a **10-minute** grace window that starts at server receipt; after the window the entry is immutable.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T081", + "T085" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookGraceWindowPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/LogEntryEditorSheet.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_04_edit_only_within_grace_window", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-05", + "requirement": { + "id": "AC-LOG-05", + "text": "Given a permitted user opens the unified log view, when entries exist at both household and procedure scope, then entries are shown chronologically and can be filtered by scope.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T082", + "T086" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookScopeFilter.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_05_unified_log_chronological_and_filterable", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-LOG-06", + "requirement": { + "id": "AC-LOG-06", + "text": "Given a Guest is signed in, when they attempt to view the Log Book directly or via deep link, then access is denied with a clear message.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T077", + "T083", + "T086" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/LogBook/LogBookRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/LogBook/CommunicationsLogView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_LOG_06_guest_denied_log_access", + "path": "ios/HomesFlowTests/LogBookTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-01", + "requirement": { + "id": "AC-PROC-01", + "text": "Given a Manager user views a procedure, when they mark a step Complete, then the step status updates for all users with appropriate visibility, the procedure's aggregate status and progress in the procedures list update immediately, and an activity log entry is created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T042", + "T046", + "T048" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/ActivityLog/ActivityLogService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_01_complete_and_na_steps_mark_procedure_complete", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_01_completed_step_counts_toward_progress", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_01_final_step_completion_marks_procedure_complete", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-02", + "requirement": { + "id": "AC-PROC-02", + "text": "Given a Manager user attempts to update a step beyond their permission (e.g., another home's owner-only procedure or step), when they submit the change, then the app blocks the update and shows a permission error.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T010", + "T044", + "T049" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_02_guest_cannot_update_guest_visible_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + }, + { + "name": "test_AC_PROC_02_manager_cannot_update_owner_only_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-03", + "requirement": { + "id": "AC-PROC-03", + "text": "Given a Manager user updates a step while offline and another user updates the same step before sync, when both devices reconnect, then the update with the most recent timestamp is persisted and the other user receives a notification about the overwritten change with reference to the activity log.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T037", + "T045", + "T050" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_03_local_newer_keeps_pending_local", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + }, + { + "name": "test_AC_PROC_03_server_newer_overwrites_pending_local", + "path": "ios/HomesFlowTests/ProcedureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-04", + "requirement": { + "id": "AC-PROC-04", + "text": "Given an Owner or Manager user long-presses a step on a procedure they can modify, when the context menu appears, then Edit, Delete, Move Up, and Move Down are available.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047b", + "T050a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_04_manager_can_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_04_manager_cannot_manage_owner_only_procedure_steps", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_04_owner_can_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-05", + "requirement": { + "id": "AC-PROC-05", + "text": "Given an Owner or Manager user taps Add on the Steps section, when they enter a title and save, then a new step is appended at the next sort order and appears for permitted users after sync.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047b", + "T050a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_05_move_down_swaps_with_next_step", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_move_is_noop_at_list_boundaries", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_move_up_swaps_with_previous_step", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + }, + { + "name": "test_AC_PROC_05_new_step_appends_at_end", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-06", + "requirement": { + "id": "AC-PROC-06", + "text": "Given an Owner or Manager user creates, renames, reorders, or deletes a step, when the change syncs, then it persists for permitted users and an activity log entry is created.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047a", + "T050b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureDTO.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_06_structure_changes_produce_activity_summaries", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-07", + "requirement": { + "id": "AC-PROC-07", + "text": "Given a Guest views a procedure, when they interact with steps, then step structure controls (long-press menu, Add step) are not available and step status remains read-only.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047c", + "T050c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Permissions/PermissionService.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_07_guest_cannot_manage_step_structure", + "path": "ios/HomesFlowTests/StepStructureTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-PROC-08", + "requirement": { + "id": "AC-PROC-08", + "text": "Given a user views a step with an attached photo, when they tap **Photo attached**, then the photo opens in a modal preview; step rows show notes below the title, a tappable photo indicator when present, a pencil **Edit** control (when permitted) to the left of the status ellipsis menu, and the ellipsis menu remains rightmost.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T047d", + "T050d" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/StepRowPresentation.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_PROC_08_photo_indicator_and_edit_controls", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + }, + { + "name": "test_AC_PROC_08_tap_toggle_status_mapping", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + }, + { + "name": "test_AC_PROC_08_terminal_statuses_strike_through", + "path": "ios/HomesFlowTests/StepRowPresentationTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-01", + "requirement": { + "id": "AC-SYNC-01", + "text": "Given any user makes an update while offline, when the device reconnects, then the client syncs changes and the server resolves conflicts with most-recent timestamp wins; the client surfaces a notification when their offline change was overwritten.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T020", + "T034", + "T037", + "T038", + "T045", + "T053", + "T072" + ], + "pendingTasks": [ + "T027" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ProviderConflictResolver.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderFieldMerge.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OutboxSyncPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/OverwriteNotificationPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_01_conflict_decision_is_idempotent", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_home_timestamp_wins_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_offline_overwrite_notifies_loser", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_provider_timestamp_wins_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + }, + { + "name": "test_AC_SYNC_01_server_delete_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-02", + "requirement": { + "id": "AC-SYNC-02", + "text": "Given two users modify different fields of the same entity while offline, when sync occurs, then both non-conflicting changes are merged and persisted, and an audit record notes the combined update. *(Deferred to post-MVP phase \u2014 see conflict model evolution note.)*", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T072" + ], + "pendingTasks": [ + "T035", + "T039" + ] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [] + }, + "gateStatus": "implemented-test-pending", + "status": "tracked-debt" + }, + { + "id": "AC-SYNC-03", + "requirement": { + "id": "AC-SYNC-03", + "text": "Given a user attempts an action that depends on stale permissions cached offline, when syncing, then if the server denies the action, the client reverts the change and shows a permission error with guidance to retry.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T011", + "T036", + "T040", + "T072" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/PermissionRevertPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/SyncEngine.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_03_permission_denied_revert_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-04", + "requirement": { + "id": "AC-SYNC-04", + "text": "Given local changes or homes are pending sync to the server, when the user views the dashboard, then unsynced homes are visibly indicated and the user can pull to refresh to retry sync while online.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T015", + "T037", + "T040a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Sync/SyncIndicatorPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Dashboard/DashboardView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_04_pending_state_announced_to_voiceover", + "path": "ios/HomesFlowTests/SyncIndicatorTests.swift" + }, + { + "name": "test_AC_SYNC_04_pending_sync_visible_on_dashboard", + "path": "ios/HomesFlowTests/SyncIndicatorTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-05", + "requirement": { + "id": "AC-SYNC-05", + "text": "Given a step is marked Complete or N/A on one device, when a concurrent offline update from another device would change that step's status, then sync never silently regresses the Complete/N/A status; the conflicting update is surfaced instead of auto-applied.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T074", + "T074a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/StepStatusConflictPolicy.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_05_terminal_status_never_silently_regressed", + "path": "ios/HomesFlowTests/StepStatusConflictPolicyTests.swift" + }, + { + "name": "test_AC_SYNC_05_terminal_step_protection_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-06", + "requirement": { + "id": "AC-SYNC-06", + "text": "Given two devices make conflicting status changes to the same step or procedure while offline, when both sync, then the server resolves automatically (most-recent timestamp, subject to AC-SYNC-05 terminal-status protection) and the user whose change lost receives a notification with an activity-log reference and guidance to re-apply their change if still needed.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T075", + "T075a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/StepStatusConflictPolicy.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_06_losing_user_notified_with_reapply_guidance", + "path": "ios/HomesFlowTests/StepStatusConflictPolicyTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-SYNC-07", + "requirement": { + "id": "AC-SYNC-07", + "text": "Given a device is offline, when the user attempts a structural action (create/rename/reorder/delete steps, procedures, providers, or membership changes), then the action is disabled or blocked with clear messaging; structural actions require connectivity.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T076", + "T076a" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Procedures/ProcedureRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Providers/ServiceProviderRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Sync/StructuralActionPolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Procedures/ProcedureDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Providers/ContactsView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_SYNC_07_structural_actions_blocked_offline", + "path": "ios/HomesFlowTests/StructuralActionPolicyTests.swift" + }, + { + "name": "test_AC_SYNC_07_structural_offline_gate_matrix", + "path": "ios/HomesFlowTests/SyncConflictMatrixTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-01", + "requirement": { + "id": "AC-USER-01", + "text": "Given an Owner provides an email/phone and role and sends an invite, when the invite is accepted, then the invitee is added to the home with the assigned role and receives appropriate permissions immediately.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T026", + "T030" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_01_invite_accepted_grants_role", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + }, + { + "name": "test_AC_USER_01_invite_email_validation_and_token_shape", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-02", + "requirement": { + "id": "AC-USER-02", + "text": "Given an Owner re-sends or revokes an invite before acceptance, when they revoke, then the invite token becomes invalid and the invitee cannot join with that token.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T031" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/PeopleSelection.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/PendingInviteDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_02_revoked_token_invalid", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-03", + "requirement": { + "id": "AC-USER-03", + "text": "Given an Owner invites a user while offline and the invite is processed on another device first, when sync occurs, then the most recent action (invite or revoke) by timestamp determines invite state and the Owner receives a notification of the resolved outcome.", + "source": "HomesFlow.prd.md", + "doneTasks": [], + "pendingTasks": [ + "T027", + "T033a" + ] + }, + "implementation": { + "covered": false, + "modules": [] + }, + "proof": { + "tests": [] + }, + "gateStatus": "planned", + "status": "tracked-debt" + }, + { + "id": "AC-USER-04", + "requirement": { + "id": "AC-USER-04", + "text": "Given an Owner assigns a Manager role to a user, when the user signs in, then they can create and modify procedures and service providers for that home.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T032" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_04_edit_role_can_modify_procedures", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + }, + { + "name": "test_AC_USER_04_manager_can_update_step", + "path": "ios/HomesFlowTests/PermissionServiceTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-05", + "requirement": { + "id": "AC-USER-05", + "text": "Given an Owner assigns a Guest role to a user, when the guest signs in, then they see only guest-appropriate fields (e.g., WiFi, guest procedures) and cannot edit protected data.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T033" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/HomeDetail/HomeDetailView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_05_guest_role_read_only", + "path": "ios/HomesFlowTests/GuestTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-06", + "requirement": { + "id": "AC-USER-06", + "text": "Given concurrent role changes occur on multiple devices, when devices sync, then the change with the most recent timestamp wins and an owner-visible audit entry records the prior role.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T028", + "T029", + "T033b" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Core/Members/MemberRepository.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/MembersView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_06_concurrent_role_change_audit", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + }, + { + "id": "AC-USER-07", + "requirement": { + "id": "AC-USER-07", + "text": "Given an Owner creates an invite in MVP, when the invitee receives the shared invite link or token and signs in with the invited email, then they can accept the invite (paste token or open link) and join the home with the assigned role.", + "source": "HomesFlow.prd.md", + "doneTasks": [ + "T025", + "T026", + "T033c" + ], + "pendingTasks": [] + }, + "implementation": { + "covered": true, + "modules": [ + { + "path": "ios/HomesFlow/Core/Members/InvitePolicy.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/InviteMemberView.swift", + "kind": "implementation" + }, + { + "path": "ios/HomesFlow/Features/Members/PendingInviteDetailView.swift", + "kind": "implementation" + } + ] + }, + "proof": { + "tests": [ + { + "name": "test_AC_USER_07_paste_token_accepts_invite", + "path": "ios/HomesFlowTests/MemberInviteTests.swift" + } + ] + }, + "gateStatus": "verified", + "status": "verified" + } + ], + "demo": { + "broken": false, + "breakId": null, + "note": null + } +} diff --git a/docs/thread-visualizer/index.html b/docs/thread-visualizer/index.html new file mode 100644 index 0000000..daa8418 --- /dev/null +++ b/docs/thread-visualizer/index.html @@ -0,0 +1,55 @@ + + + + + + HomesFlow — Golden Thread + + + + + + + + +
+

HomesFlow

+

Golden Thread

+

+ One requirement. Implementation. Proof. The same chain Gate 2 enforces — + made visible. Projection only; not a second registry. +

+
+ +
+ +
+ +
+ + +
+
+ +
+ +
+ And it scales — all acceptance criteria +
+
+ + + + + + diff --git a/docs/thread-visualizer/visualizer.css b/docs/thread-visualizer/visualizer.css new file mode 100644 index 0000000..4d4d955 --- /dev/null +++ b/docs/thread-visualizer/visualizer.css @@ -0,0 +1,372 @@ +:root { + --ink: #1c1914; + --muted: #5c564c; + --paper: #f7f3ea; + --paper-2: #efe8d8; + --line: #d9d0bc; + --gold: #b8860b; + --gold-deep: #8a6508; + --ok: #2f6b3a; + --danger: #a33b2b; + --danger-soft: #f3ddd8; + --tracked: #9a7b2f; + --mono: "IBM Plex Mono", ui-monospace, monospace; + --sans: "IBM Plex Sans", system-ui, sans-serif; + --display: "Fraunces", Georgia, serif; +} + +* { box-sizing: border-box; } + +body { + margin: 0; + min-height: 100vh; + font-family: var(--sans); + color: var(--ink); + background: + radial-gradient(1200px 600px at 10% -10%, #fff8e6 0%, transparent 55%), + radial-gradient(900px 500px at 100% 0%, #e8efe4 0%, transparent 50%), + linear-gradient(180deg, var(--paper) 0%, var(--paper-2) 100%); + line-height: 1.45; +} + +.atmosphere { + position: fixed; + inset: 0; + pointer-events: none; + background-image: + linear-gradient(rgba(28, 25, 20, 0.03) 1px, transparent 1px), + linear-gradient(90deg, rgba(28, 25, 20, 0.03) 1px, transparent 1px); + background-size: 48px 48px; + mask-image: linear-gradient(180deg, rgba(0,0,0,0.35), transparent 70%); +} + +.top, .totals, .controls, .descent, .scale, .foot { + position: relative; + width: min(720px, calc(100% - 2.5rem)); + margin-inline: auto; +} + +.top { + padding: 3.5rem 0 1.25rem; +} + +.brand { + margin: 0 0 0.35rem; + font-family: var(--display); + font-size: clamp(2.4rem, 6vw, 3.4rem); + font-weight: 650; + letter-spacing: -0.02em; + color: var(--ink); + line-height: 1; +} + +.top h1 { + margin: 0 0 0.75rem; + font-family: var(--display); + font-weight: 500; + font-size: clamp(1.35rem, 3vw, 1.75rem); + color: var(--gold-deep); +} + +.lede { + margin: 0; + max-width: 38rem; + color: var(--muted); + font-size: 1.05rem; +} + +.totals { + display: grid; + grid-template-columns: repeat(4, 1fr); + gap: 0.75rem; + margin: 1.5rem auto 1.25rem; +} + +.stat { + padding: 0.85rem 0.9rem; + border: 1px solid var(--line); + background: rgba(255, 255, 255, 0.55); +} + +.stat .n { + display: block; + font-family: var(--mono); + font-size: 1.35rem; + font-weight: 500; +} + +.stat .l { + display: block; + margin-top: 0.15rem; + font-size: 0.78rem; + color: var(--muted); + text-transform: uppercase; + letter-spacing: 0.04em; +} + +.stat.is-ok .n { color: var(--ok); } +.stat.is-bad .n { color: var(--danger); } + +.controls { + display: flex; + flex-wrap: wrap; + gap: 1rem; + align-items: end; + justify-content: space-between; + margin-bottom: 2rem; +} + +.field { + display: flex; + flex-direction: column; + gap: 0.35rem; + flex: 1 1 16rem; +} + +.field span { + font-size: 0.75rem; + text-transform: uppercase; + letter-spacing: 0.05em; + color: var(--muted); +} + +.field select { + font: 500 0.95rem var(--mono); + padding: 0.65rem 0.75rem; + border: 1px solid var(--line); + background: #fff; + color: var(--ink); +} + +.break-toggle { + display: flex; + gap: 0.4rem; +} + +.chip { + font: 500 0.9rem var(--sans); + padding: 0.65rem 1rem; + border: 1px solid var(--line); + background: #fff; + color: var(--ink); + cursor: pointer; +} + +.chip.is-active { + border-color: var(--gold); + box-shadow: inset 0 0 0 1px var(--gold); + color: var(--gold-deep); +} + +.chip-danger.is-active { + border-color: var(--danger); + box-shadow: inset 0 0 0 1px var(--danger); + color: var(--danger); + background: var(--danger-soft); +} + +.descent { + padding-bottom: 2.5rem; +} + +.tier { + position: relative; + padding: 1.35rem 1.35rem 1.35rem 1.6rem; + border: 1px solid var(--line); + background: rgba(255, 255, 255, 0.72); + margin-left: 1.1rem; + animation: rise 0.55s ease both; +} + +.tier + .tier { margin-top: 0; } + +.tier::before { + content: ""; + position: absolute; + left: -1.1rem; + top: 0; + bottom: 0; + width: 3px; + background: var(--gold); + transition: background 0.35s ease, transform 0.35s ease, opacity 0.35s ease; +} + +.descent.is-broken .tier::before { + background: linear-gradient( + 180deg, + var(--gold) 0%, + var(--gold) 55%, + var(--danger) 70%, + var(--danger) 100% + ); +} + +.descent.is-broken .tier.proof::before { + background: var(--danger); + transform: translateX(-1px) skewY(-8deg); + opacity: 0.95; +} + +.tier .eyebrow { + margin: 0 0 0.35rem; + font-size: 0.72rem; + text-transform: uppercase; + letter-spacing: 0.08em; + color: var(--muted); +} + +.tier .id-chip { + display: inline-block; + margin-bottom: 0.55rem; + font: 500 0.82rem var(--mono); + color: var(--gold-deep); + letter-spacing: 0.02em; +} + +.tier h2 { + margin: 0 0 0.55rem; + font-family: var(--display); + font-size: 1.35rem; + font-weight: 550; + line-height: 1.25; +} + +.tier p, .tier li { + margin: 0; + color: var(--muted); + font-size: 0.95rem; +} + +.tier ul { + margin: 0.35rem 0 0; + padding-left: 1.1rem; +} + +.tier code { + font-family: var(--mono); + font-size: 0.84em; + color: var(--ink); +} + +.connector { + height: 1.35rem; + margin-left: 1.1rem; + position: relative; +} + +.connector::before { + content: ""; + position: absolute; + left: -1.1rem; + top: 0; + bottom: 0; + width: 3px; + background: var(--gold); + transition: background 0.35s ease, clip-path 0.45s ease; +} + +.descent.is-broken .connector.proof-link::before { + background: repeating-linear-gradient( + 180deg, + var(--danger) 0 6px, + transparent 6px 11px + ); + animation: fray 0.9s ease both; +} + +.status-pill { + display: inline-block; + margin-top: 0.75rem; + padding: 0.2rem 0.55rem; + font: 500 0.75rem var(--mono); + letter-spacing: 0.04em; + border: 1px solid var(--line); +} + +.status-pill.verified { color: var(--ok); border-color: #9cbc9f; } +.status-pill.tracked-debt { color: var(--tracked); border-color: #d4c48a; } +.status-pill.GAP { + color: var(--danger); + border-color: var(--danger); + background: var(--danger-soft); +} + +.tier.proof.is-gap { + border-color: #e2b4ab; + background: linear-gradient(180deg, #fff7f5, #fff); +} + +.tier.proof.is-gap h2 { color: var(--danger); } + +.pitch { + margin: 1.25rem 0 0; + padding: 1rem 1.15rem; + border-left: 3px solid var(--danger); + background: var(--danger-soft); + color: var(--ink); + font-size: 0.98rem; + animation: rise 0.4s ease 0.15s both; +} + +.scale { + margin: 0 auto 2.5rem; + border-top: 1px solid var(--line); + padding-top: 1rem; +} + +.scale summary { + cursor: pointer; + color: var(--muted); + font-size: 0.95rem; +} + +.scale-list { + margin-top: 0.85rem; + display: grid; + gap: 0.35rem; +} + +.scale-row { + display: grid; + grid-template-columns: 7.5rem 1fr auto; + gap: 0.75rem; + align-items: baseline; + padding: 0.35rem 0.2rem; + border-bottom: 1px solid rgba(217, 208, 188, 0.55); + font-size: 0.88rem; + cursor: pointer; +} + +.scale-row .sid { font-family: var(--mono); font-size: 0.8rem; } +.scale-row .stext { + color: var(--muted); + white-space: nowrap; + overflow: hidden; + text-overflow: ellipsis; +} +.scale-row .sstatus { font-family: var(--mono); font-size: 0.72rem; } + +.foot { + padding: 0 0 3rem; + color: var(--muted); + font-size: 0.85rem; +} + +.foot code { font-family: var(--mono); font-size: 0.8em; } +.meta { margin-top: 0.35rem; opacity: 0.85; } + +@keyframes rise { + from { opacity: 0; transform: translateY(10px); } + to { opacity: 1; transform: none; } +} + +@keyframes fray { + from { opacity: 0.2; transform: scaleY(0.4); transform-origin: top; } + to { opacity: 1; transform: none; } +} + +@media (max-width: 640px) { + .totals { grid-template-columns: repeat(2, 1fr); } + .scale-row { grid-template-columns: 6.5rem 1fr; } + .scale-row .sstatus { grid-column: 2; } +} diff --git a/docs/thread-visualizer/visualizer.js b/docs/thread-visualizer/visualizer.js new file mode 100644 index 0000000..b79466d --- /dev/null +++ b/docs/thread-visualizer/visualizer.js @@ -0,0 +1,233 @@ +/* Thread Visualizer — renders walker JSON only. No ID truth stored here. */ + +const state = { + intact: null, + broken: null, + mode: "intact", // intact | broken + selectedId: null, +}; + +const $ = (id) => document.getElementById(id); + +async function loadJson(path) { + const res = await fetch(path); + if (!res.ok) throw new Error(`Failed to load ${path}: ${res.status}`); + return res.json(); +} + +function currentPayload() { + return state.mode === "broken" ? state.broken : state.intact; +} + +function threadById(id) { + return currentPayload().threads.find((t) => t.id === id); +} + +function renderTotals(payload) { + const t = payload.totals; + const gateOk = t.gate2Passed && state.mode === "intact"; + $("totals").innerHTML = ` +
${t.registryIds}Registry IDs
+
${t.acs}Acceptance criteria
+
${t.acsWithTests}ACs with tests
+
${gateOk ? "PASS" : (state.mode === "broken" ? "GAP" : "FAIL")}Gate 2 lens
+ `; +} + +function fillSelect(payload) { + const select = $("threadSelect"); + const preferred = + state.selectedId || + payload.defaultDescentId || + payload.demoBreakId || + payload.threads[0]?.id; + select.innerHTML = payload.threads + .map((t) => { + const label = `${t.id} — ${t.status}`; + return ``; + }) + .join(""); + if (preferred && [...select.options].some((o) => o.value === preferred)) { + select.value = preferred; + } + state.selectedId = select.value; +} + +function moduleList(modules) { + if (!modules.length) { + return `

No @covers modules found for this ID in ios/HomesFlow.

`; + } + return ``; +} + +function proofList(tests, isGap) { + if (!tests.length) { + return isGap + ? `

No named proof. Gate 2 would fail the build on this silent gap.

` + : `

No test_AC_* yet — tracked as debt if a pending task exists.

`; + } + return ``; +} + +function renderDescent() { + const payload = currentPayload(); + const thread = threadById(state.selectedId); + const root = $("descent"); + if (!thread) { + root.innerHTML = `

Thread not found.

`; + return; + } + + const broken = thread.status === "GAP"; + root.classList.toggle("is-broken", broken); + + const reqText = + thread.requirement.text || + "(AC text not found in PRD — check HomesFlow.prd.md formatting.)"; + + root.innerHTML = ` +
+

Requirement

+ ${thread.id} +

${escapeHtml(reqText)}

+

Source: ${thread.requirement.source}

+ ${ + thread.requirement.doneTasks.length + ? `

Done tasks: ${thread.requirement.doneTasks.join(", ")}

` + : "" + } +
+ +
+

Implementation

+ @covers ${thread.id} +

${thread.implementation.covered ? "Authorized in source" : "No @covers yet"}

+ ${moduleList(thread.implementation.modules)} +
+ +
+

Proof

+ test_AC_* +

${broken ? "Thread broken" : "Named tests verify this AC"}

+ ${proofList(thread.proof.tests, broken)} + ${thread.status} +
+ ${ + broken + ? `

Watch — when the proof disappears, the thread shows it, and the build fails. You cannot quietly break this.

` + : "" + } + `; +} + +function escapeHtml(s) { + return String(s) + .replaceAll("&", "&") + .replaceAll("<", "<") + .replaceAll(">", ">") + .replaceAll('"', """); +} + +function renderScale() { + const payload = currentPayload(); + $("scaleList").innerHTML = payload.threads + .map((t) => { + const text = escapeHtml(t.requirement.text || ""); + return `
+ ${t.id} + ${text} + ${t.status} +
`; + }) + .join(""); + + $("scaleList").querySelectorAll(".scale-row").forEach((row) => { + const go = () => { + state.selectedId = row.dataset.id; + $("threadSelect").value = state.selectedId; + renderDescent(); + window.scrollTo({ top: $("descent").offsetTop - 24, behavior: "smooth" }); + }; + row.addEventListener("click", go); + row.addEventListener("keydown", (e) => { + if (e.key === "Enter" || e.key === " ") { + e.preventDefault(); + go(); + } + }); + }); +} + +function renderMeta(payload) { + const demoNote = + state.mode === "broken" && payload.demo?.note + ? ` · Demo: ${payload.demo.note}` + : ""; + $("meta").textContent = + `Generated ${payload.generatedAt} @ ${payload.commit}` + demoNote; +} + +function renderAll() { + const payload = currentPayload(); + renderTotals(payload); + fillSelect(payload); + renderDescent(); + renderScale(); + renderMeta(payload); +} + +function setMode(mode) { + state.mode = mode; + $("btnIntact").classList.toggle("is-active", mode === "intact"); + $("btnBreak").classList.toggle("is-active", mode === "broken"); + if (mode === "broken") { + state.selectedId = state.broken.demoBreakId || state.broken.defaultDescentId; + } + renderAll(); +} + +async function boot() { + try { + const [intact, broken] = await Promise.all([ + loadJson("data/thread.json"), + loadJson("data/thread-broken.json"), + ]); + state.intact = intact; + state.broken = broken; + state.selectedId = intact.defaultDescentId || intact.demoBreakId; + + // Sanity: walker totals must echo Gate 2 on the intact snapshot. + const t = intact.totals; + console.info( + `[thread-visualizer] Gate 2 lens: ${t.registryIds} IDs, ${t.acs} ACs, ${t.acsWithTests} with tests, passed=${t.gate2Passed}` + ); + + $("threadSelect").addEventListener("change", (e) => { + state.selectedId = e.target.value; + renderDescent(); + }); + $("btnIntact").addEventListener("click", () => setMode("intact")); + $("btnBreak").addEventListener("click", () => setMode("broken")); + + setMode("intact"); + } catch (err) { + document.body.insertAdjacentHTML( + "afterbegin", + `

+ Failed to load thread data. Run + bash scripts/thread-visualizer-refresh.sh + then reopen this page. (${escapeHtml(err.message)}) +

` + ); + console.error(err); + } +} + +boot(); diff --git a/scripts/thread-visualizer-refresh.sh b/scripts/thread-visualizer-refresh.sh new file mode 100755 index 0000000..8ed04f9 --- /dev/null +++ b/scripts/thread-visualizer-refresh.sh @@ -0,0 +1,13 @@ +#!/usr/bin/env bash +# Regenerate Thread Visualizer JSON from live Gate 2 data (projection only). +set -euo pipefail +cd "$(dirname "$0")/.." + +OUT=docs/thread-visualizer/data +mkdir -p "$OUT" + +python3 scripts/thread-walker.py -o "$OUT/thread.json" +python3 scripts/thread-walker.py --demo-break AC-USER-04 -o "$OUT/thread-broken.json" + +echo "Thread visualizer data refreshed under $OUT/" +echo "Open docs/thread-visualizer/index.html in a browser." diff --git a/scripts/thread-walker.py b/scripts/thread-walker.py new file mode 100755 index 0000000..c465ab2 --- /dev/null +++ b/scripts/thread-walker.py @@ -0,0 +1,350 @@ +#!/usr/bin/env python3 +"""Thread walker — projection of Gate 2's golden thread as structured JSON. + +Reads requirement truth only from where it already lives (PRD, @covers, test +names, tasks.md via Gate 2). Does not mint IDs or store a second registry. + +Status for each AC comes from `scripts/check-traceability.sh --json` so the +visualizer and Gate 2 never disagree about covered vs gap vs tracked debt. +""" + +from __future__ import annotations + +import argparse +import json +import re +import subprocess +import sys +from datetime import datetime, timezone +from pathlib import Path + +REPO = Path(__file__).resolve().parents[1] +GATE2 = REPO / "scripts" / "check-traceability.sh" +PRD = REPO / "HomesFlow.prd.md" +SRC_DIRS = [REPO / "ios" / "HomesFlow"] +TEST_DIRS = [REPO / "ios" / "HomesFlowTests", REPO / "ios" / "HomesFlowUITests"] + +ID_RE = re.compile(r"(FR|NFR|AC|US)-[A-Z][A-Z0-9]{1,5}-[0-9]{2,}[a-z]?") +AC_TEXT_RE = re.compile( + r"\*\*(AC-[A-Z][A-Z0-9]{1,5}-\d{2,}[a-z]?)\*\*\s*—\s*(.+)$" +) + +# Visualizer-facing status vocabulary (mapped from Gate 2 status strings). +VIS_VERIFIED = "verified" +VIS_TRACKED = "tracked-debt" +VIS_GAP = "GAP" +VIS_OTHER = "other" + + +def run_gate2_json() -> list[dict]: + result = subprocess.run( + ["bash", str(GATE2), "--json"], + cwd=REPO, + check=True, + capture_output=True, + text=True, + ) + return json.loads(result.stdout) + + +def run_gate2_check() -> dict: + """Run Gate 2 check; parse summary counts. Exit code 0/1 both yield stdout.""" + result = subprocess.run( + ["bash", str(GATE2)], + cwd=REPO, + capture_output=True, + text=True, + ) + text = result.stdout + result.stderr + counts = { + "registryIds": None, + "acs": None, + "acsWithTests": None, + "idsWithCovers": None, + "gate2Passed": result.returncode == 0, + } + for line in text.splitlines(): + if "Registry IDs (PRD):" in line: + counts["registryIds"] = int(line.rsplit(":", 1)[1].strip()) + elif "ACs in registry:" in line: + counts["acs"] = int(line.rsplit(":", 1)[1].strip()) + elif "ACs with tests:" in line: + counts["acsWithTests"] = int(line.rsplit(":", 1)[1].strip()) + elif "IDs with @covers in code:" in line: + counts["idsWithCovers"] = int(line.rsplit(":", 1)[1].strip()) + return counts + + +def map_status(gate_status: str) -> str: + if gate_status == "verified": + return VIS_VERIFIED + if gate_status == "gap": + return VIS_GAP + if gate_status in ( + "implemented-test-pending", + "planned", + "in-progress", + ): + return VIS_TRACKED + return VIS_OTHER + + +def load_prd_ac_text() -> dict[str, str]: + texts: dict[str, str] = {} + for line in PRD.read_text(encoding="utf-8").splitlines(): + match = AC_TEXT_RE.search(line) + if match: + texts[match.group(1)] = match.group(2).strip() + return texts + + +def expand_covers_token(token: str) -> list[str]: + """Expand `AC-USER-04…06` / `AC-USER-04...06` into inclusive ID list.""" + token = token.strip().rstrip(",") + ellipsis = re.match( + r"^((?:FR|NFR|AC|US)-[A-Z][A-Z0-9]{1,5}-)(\d{2,}[a-z]?)(?:…|\.\.\.)(\d{2,}[a-z]?)$", + token, + ) + if not ellipsis: + return [token] if ID_RE.fullmatch(token) else [] + prefix, start_s, end_s = ellipsis.group(1), ellipsis.group(2), ellipsis.group(3) + start_n, end_n = int(re.match(r"\d+", start_s).group()), int(re.match(r"\d+", end_s).group()) + width = len(re.match(r"\d+", start_s).group()) + return [f"{prefix}{n:0{width}d}" for n in range(start_n, end_n + 1)] + + +def files_covering(ac_id: str) -> list[dict]: + """Swift modules whose @covers line includes this ID (live grep, no cache).""" + hits: list[dict] = [] + seen: set[str] = set() + for root in SRC_DIRS: + if not root.is_dir(): + continue + for path in root.rglob("*.swift"): + rel = str(path.relative_to(REPO)) + try: + lines = path.read_text(encoding="utf-8").splitlines() + except OSError: + continue + for line in lines: + if "@covers" not in line: + continue + after = line.split("@covers", 1)[1] + tokens = re.split(r"[\s,]+", after.strip()) + ids: set[str] = set() + for token in tokens: + ids.update(expand_covers_token(token)) + if ac_id in ids and rel not in seen: + seen.add(rel) + hits.append({"path": rel, "kind": "implementation"}) + return hits + + +def files_for_tests(test_names: list[str]) -> list[dict]: + if not test_names: + return [] + wanted = set(test_names) + found: dict[str, str] = {} + for root in TEST_DIRS: + if not root.is_dir(): + continue + for path in root.rglob("*.swift"): + rel = str(path.relative_to(REPO)) + try: + text = path.read_text(encoding="utf-8") + except OSError: + continue + for name in list(wanted): + if re.search(rf"func\s+{re.escape(name)}\s*\(", text): + found[name] = rel + wanted.discard(name) + if not wanted: + break + return [ + {"name": name, "path": found.get(name)} + for name in test_names + ] + + +def build_threads(records: list[dict], ac_texts: dict[str, str]) -> list[dict]: + threads = [] + for record in records: + if record["type"] != "AC": + continue + ac_id = record["id"] + tests = list(record.get("tests") or []) + pending = list(record.get("pendingTasks") or []) + done = list(record.get("doneTasks") or []) + gate_status = record["status"] + threads.append( + { + "id": ac_id, + "requirement": { + "id": ac_id, + "text": ac_texts.get(ac_id, ""), + "source": "HomesFlow.prd.md", + "doneTasks": done, + "pendingTasks": pending, + }, + "implementation": { + "covered": bool(record.get("covered")), + "modules": files_covering(ac_id), + }, + "proof": { + "tests": files_for_tests(tests), + }, + "gateStatus": gate_status, + "status": map_status(gate_status), + } + ) + return threads + + +def apply_demo_break(payload: dict, break_id: str) -> dict: + """Simulate deleting all proof for one AC using Gate 2's gap rules. + + Recomputes status the same way Gate 2 would after tests vanish: + - still covered + pending task → tracked-debt (implemented-test-pending) + - still covered + no pending → GAP + - not covered + pending → tracked-debt (planned) + - otherwise → GAP + """ + out = json.loads(json.dumps(payload)) # deep copy + out["demo"] = { + "broken": True, + "breakId": break_id, + "note": ( + "Seeded demo break: proof tests for this AC were removed in the " + "projection only. Regenerated from live Gate 2 data + surgical strip." + ), + } + for thread in out["threads"]: + if thread["id"] != break_id: + continue + thread["proof"]["tests"] = [] + covered = thread["implementation"]["covered"] + pending = thread["requirement"]["pendingTasks"] + if covered and pending: + thread["gateStatus"] = "implemented-test-pending" + thread["status"] = VIS_TRACKED + elif covered and not pending: + thread["gateStatus"] = "gap" + thread["status"] = VIS_GAP + elif pending: + thread["gateStatus"] = "planned" + thread["status"] = VIS_TRACKED + else: + thread["gateStatus"] = "gap" + thread["status"] = VIS_GAP + out["totals"]["acsWithTests"] = sum( + 1 for t in out["threads"] if t["proof"]["tests"] + ) + out["totals"]["acsVerified"] = sum( + 1 for t in out["threads"] if t["status"] == VIS_VERIFIED + ) + out["totals"]["acsGap"] = sum( + 1 for t in out["threads"] if t["status"] == VIS_GAP + ) + break + else: + raise SystemExit(f"Demo break ID not found in threads: {break_id}") + return out + + +def build_payload(break_id: str | None = None) -> dict: + gate_counts = run_gate2_check() + records = run_gate2_json() + ac_texts = load_prd_ac_text() + threads = build_threads(records, ac_texts) + + verified = sum(1 for t in threads if t["status"] == VIS_VERIFIED) + gaps = sum(1 for t in threads if t["status"] == VIS_GAP) + tracked = sum(1 for t in threads if t["status"] == VIS_TRACKED) + with_tests = sum(1 for t in threads if t["proof"]["tests"]) + + # Totals must match Gate 2's own numbers. + if gate_counts["registryIds"] != len(records): + raise SystemExit( + f"Walker/Gate2 registry mismatch: walker={len(records)} " + f"gate2={gate_counts['registryIds']}" + ) + if gate_counts["acs"] != len(threads): + raise SystemExit( + f"Walker/Gate2 AC mismatch: walker={len(threads)} " + f"gate2={gate_counts['acs']}" + ) + if gate_counts["acsWithTests"] != with_tests: + raise SystemExit( + f"Walker/Gate2 ACs-with-tests mismatch: walker={with_tests} " + f"gate2={gate_counts['acsWithTests']}" + ) + + sha = subprocess.run( + ["git", "rev-parse", "--short", "HEAD"], + cwd=REPO, + capture_output=True, + text=True, + check=False, + ).stdout.strip() or "unknown" + + payload = { + "generatedAt": datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"), + "commit": sha, + "source": { + "gate2": "scripts/check-traceability.sh", + "prd": "HomesFlow.prd.md", + "principle": "Projection only — not a second registry", + }, + "totals": { + "registryIds": gate_counts["registryIds"], + "acs": gate_counts["acs"], + "acsWithTests": gate_counts["acsWithTests"], + "idsWithCovers": gate_counts["idsWithCovers"], + "acsVerified": verified, + "acsTrackedDebt": tracked, + "acsGap": gaps, + "gate2Passed": gate_counts["gate2Passed"], + }, + "defaultDescentId": "AC-USER-04", + "demoBreakId": "AC-USER-04", + "threads": threads, + "demo": {"broken": False, "breakId": None, "note": None}, + } + + if break_id: + payload = apply_demo_break(payload, break_id) + return payload + + +def main() -> int: + parser = argparse.ArgumentParser(description="Emit Gate 2 thread JSON for the visualizer") + parser.add_argument( + "-o", + "--output", + type=Path, + help="Write JSON to this path (default: stdout)", + ) + parser.add_argument( + "--demo-break", + metavar="AC-ID", + help="Seed a demo GAP by stripping proof for this AC in the projection", + ) + args = parser.parse_args() + payload = build_payload(break_id=args.demo_break) + text = json.dumps(payload, indent=2) + "\n" + if args.output: + args.output.parent.mkdir(parents=True, exist_ok=True) + args.output.write_text(text, encoding="utf-8") + print( + f"Wrote {args.output} " + f"({payload['totals']['acsWithTests']}/{payload['totals']['acs']} ACs with tests; " + f"Gate 2 {'PASSED' if payload['totals']['gate2Passed'] else 'FAILED'})", + file=sys.stderr, + ) + else: + sys.stdout.write(text) + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/specs/001-mvp/craft-conventions.md b/specs/001-mvp/craft-conventions.md index f24c450..a6ad889 100644 --- a/specs/001-mvp/craft-conventions.md +++ b/specs/001-mvp/craft-conventions.md @@ -91,6 +91,7 @@ Break-glass (emergency only): temporarily turn off “Do not allow bypassing… |------|---------|--------| | **Gate 0** | `xcodebuild build` + `xcodebuild test` (`HomesFlowTests`) | macOS | | **Gate 2** | `bash scripts/check-traceability.sh` | Linux or macOS | +| **Thread visualizer** | `bash scripts/thread-visualizer-refresh.sh` → `docs/thread-visualizer/` | Linux or macOS | | **Shell** | `shellcheck scripts/*.sh` | Linux or macOS | | **SwiftLint** | `swiftlint lint --config ios/.swiftlint.yml` | macOS | | **Sonar** | CI job `sonar` in `.github/workflows/ci.yml` (`SONAR_TOKEN`) + quality gate on **new code** | Ubuntu + SonarCloud |