@dailephd/my-frontend-observer 0.9.1 → 0.10.1

package/docs/reports/v0.10-batch6-coding-agent-handoff.md

@@ -0,0 +1,85 @@
+# v0.10 Batch 6 Coding-Agent Handoff
+
+## 1. Verdict and repository
+
+PASS. Repository `C:\Users\daile\Projects\my-frontend-observer`, branch `feature/v0.10-full-visual-workflow`, starting commit `ac79b2c41e53ac36c825c4b398bbeb4856d5db0e`.
+
+## 2. Retrieval and fresh index
+
+- Resolved my-dev-kit: `1.12.4`; CLI identity and `index`, `search`, `lookup`, `slice`, `source`, `graph-diff`, and `context` were verified.
+- Install: `.my-dev-kit-workflow/tools/v0.10-batch6/mdk-1.12.4/`.
+- Index: `.my-dev-kit-context/indexes/my-frontend-observer-v0.10-batch6-20260922`.
+- Command: `node .my-dev-kit-workflow/tools/v0.10-batch6/mdk-1.12.4/node_modules/@dailephd/my-dev-kit/dist/cli.js index --root C:\Users\daile\Projects\my-frontend-observer --src src --src viewer/src --src tests --src scripts --out C:\Users\daile\Projects\my-frontend-observer\.my-dev-kit-context\indexes\my-frontend-observer-v0.10-batch6-20260922 --call-graph --json`.
+- Result: 306 files, 2,487 symbols, 4,796 edges, zero index warnings/errors. Frontend analysis was complete; data-model and classification were partial with 834 and 2,436 warnings.
+
+## 3. Contract and canonical owners
+
+`VisualChangeAgentHandoff` is a non-persisted, closed `my-frontend-observer/visual-change-agent-handoff` `1.0.0` transfer contract with deterministic canonical JSON and a terminal newline. Batch 2 readiness was extracted into `prepareActiveVisualChangeWorkflow`; canonical check recording and handoff preparation now share activation, restoration, acceptance-drift, exact-alias, and frozen-evidence checks. Existing `projectBoundedAgentContext`, `evaluateReferenceCandidateFidelity`, and `prepareReferenceCorrection` remain the projection/evaluation owners. No evidence schema changed.
+
+## 4. Actual and reference projections
+
+Actual mode carries exact workflow/request and annotation identities, baseline identity and clauses, and all per-change clauses including protected/preserved categories. Reference mode carries exact approved-reference identity and bounded requirements, explicit bindings, optional coherent contract clauses, canonical fidelity-derived context, and binding target focus IDs. A `not-evaluated` fidelity result fails closed. When v0.7 prerequisites exist, the exact `prepareReferenceCorrection` review ID is exposed; otherwise an explicit narrow `not-applicable` reason is returned without a fabricated ID.
+
+## 5. Context and external coordination
+
+Observer-generated bounded context is primary. No context file omits supplemental context; unsupported versions fail; coherent valid context is included unchanged, retaining static producer/correlation ownership. The application never invokes my-dev-kit. Optional coordination accepts only provider `my-dev-kit-orchestrator` and a bounded non-path run ID/version. It is handoff-only traceability and is never persisted to the workflow or inspected on disk.
+
+## 6. Post-edit contract and Viewer
+
+Every handoff contains `{ command: 'check', baselineAlias: <exact Batch 2 alias>, json: true }` and the Viewer renders `my-frontend-observer check <alias> --json`. The secured project-aware route is `POST /api/visual-changes/:handle/prepare-handoff`. Active, non-restored workflows expose Prepare handoff, optional coordination fields, a bounded summary, Copy handoff, and Download handoff. Copy/download share canonical serialization and the filename `visual-change-handoff-<workflowId>.json`. Preparation creates no attempt, check, review, source edit, handoff artifact, or orchestrator action.
+
+## 7. Disposable published-orchestrator compatibility proof
+
+- Published version: `1.4.1`; installed under `.my-dev-kit-workflow/tools/v0.10-batch6/orchestrator-1.4.1/`; version plus `init/start/status/export --help` passed.
+- Root: `.my-dev-kit-workflow/v0.10-batch6/orchestrator-proof/project/`.
+- A real application-owner-generated `observer-visual-change-handoff.json` was referenced by an ordinary feature request specifying external editing and the exact Observer check command.
+- Run ID: `20260922T121702-observer-handoff-proof`.
+- `status` honestly remained at request-brief with 0/10 artifacts and a blocked final report. `export` produced `orchestrator-export.txt` retaining the run identity. No run was advanced or completed.
+- SHA comparison proved handoff bytes unchanged. Observer source/evidence remained unchanged. A second generated handoff round-tripped provider, run ID, and package version without changing Observer workflow/request identity.
+- No orchestrator dependency was added and no production Observer code invokes or reads orchestrator state.
+
+## 8. Browser, security, regressions, and validation
+
+The actual-mode real-Chromium ACCEPTANCE GATE starts from a fresh project/workflow, prepares and inspects a handoff, checks the exact command, copies and downloads identical canonical JSON, verifies the filename, and proves the active workflow remains byte-identical with zero attempts and no check. Reference application tests cover exact requirements/bindings, canonical fidelity, focused context, protected/preserved projection, and both v0.7 trace states.
+
+- Typecheck: PASS.
+- Lint: PASS.
+- Unit: PASS, 99 files / 1,514 tests.
+- Browser: PASS, 30 files / 280 tests.
+- Security: PASS, 16 unit files / 168 tests plus 3 browser files / 77 tests and the hard gate.
+- PWA hard gate: PASS; `/api/` remains uncached and Batch 5 synchronization is unchanged.
+- Build: PASS.
+- Documentation check: PASS.
+- `git diff --check`: PASS (line-ending notices only).
+- Batch 1-5, bounded-context, and reference-correction regressions pass. Viewer protocol remains `1.3.0`.
+
+## 9. Frozen responsibility ledger
+
+Each line names the concrete test owner and test name (or canonical shared suite) that proves the responsibility.
+
+- TST-B6-001..004 — `visualChangeAgentHandoffService.test.ts` — `rejects inactive, restored, acceptance-drifted, and baseline-drifted workflows through the shared readiness owner` — PASS.
+- TST-B6-005..013 — `visualChangeAgentHandoffService.test.ts` — `projects exact actual scope and bounded context without checking, capturing, editing, or persisting a handoff` — PASS.
+- TST-B6-014..018, TST-B6-022..026 — `visualChangeAgentHandoffService.test.ts` — `projects canonical reference fidelity, exact requirements/bindings, focus targets, and an honest not-applicable correction trace` — PASS.
+- TST-B6-019..021 — `visualChangeAgentHandoffService.test.ts` — `reuses the canonical v0.7 reference correction identity when its exact contract preconditions apply` — PASS.
+- TST-B6-027..035 — `visualChangeAgentHandoffService.test.ts` — `includes coherent supplemental context verbatim and rejects unsupported or mismatched context` plus actual/reference projection tests — PASS.
+- TST-B6-036..043 — `visualChangeAgentHandoff.test.ts` — `accepts only bounded opaque orchestrator correlation and changes no workflow semantics`; disposable CLI proof — PASS.
+- TST-B6-044..048 — `visualChangeAgentHandoffService.test.ts` actual projection and `runtimeAnnotationContractPromotion.test.ts` ACCEPTANCE GATE — PASS.
+- TST-B6-049..057 — `visualChangeAgentHandoff.test.ts` — `uses the exact non-artifact kind/version, validates the closed bounded contract, and serializes deterministically with a newline`; unchanged canonical schema suites — PASS.
+- TST-B6-058..060 — `viewerVisualChangeAuthoring.test.ts` — `keeps every POST project-aware, token/Host/Origin/JSON guarded, closed, bounded, and no-store`; browser ACCEPTANCE GATE — PASS.
+- TST-B6-061..069 — `runtimeAnnotationContractPromotion.test.ts` — `ACCEPTANCE GATE: creates an inactive actual workflow from confirmed runtime intent and explicitly activates its immutable revision`; contract tests — PASS.
+- TST-B6-070 — `visualChangeWorkflow.test.ts` canonical Batch 1 suite — PASS.
+- TST-B6-071 — `visualChangeProjectWorkflowService.test.ts` canonical Batch 2 suite — PASS.
+- TST-B6-072 — Viewer/security canonical suites — PASS.
+- TST-B6-073 — `runtimeAnnotationContractPromotion.test.ts` actual entry flow — PASS.
+- TST-B6-074 — Batch 5 reference route/workspace/browser suites — PASS.
+- TST-B6-075 — `boundedAgentContext*.test.ts` canonical suites — PASS.
+- TST-B6-076 — `referenceCorrectionWorkflow.test.ts` canonical suite — PASS.
+- TST-B6-077 — `viewerAuthoringSecurity.test.ts` — `keeps existing read-only routes answering GET and HEAD in authoring mode` — PASS (`1.3.0`).
+
+## 10. Full-file read accounting
+
+Full source/test file reads: none. Retrieval used my-dev-kit search, lookup, slice, exact source, continuation/dependency expansion, then bounded PowerShell ranges only.
+
+## 11. Batch 7+ exclusions and handoff
+
+No source editing, agent/LLM execution, automatic check, attempt recording, correction/review/accept/abandon behavior, governance, release, or orchestrator runtime integration was implemented. Batch 7 should begin from the committed Batch 6 result and add only the separately planned review/correction behavior.

package/docs/reports/v0.10-batch7-correction-review-acceptance.md

@@ -0,0 +1,145 @@
+# v0.10 Batch 7 Correction, Review, and Acceptance
+
+## Verdict and correction history
+
+PASS. The initial result remained `NEEDS_CORRECTION` because production was green but the frozen acceptance evidence was incomplete. This continuation preserved that implementation and added the missing canonical, browser, identity, and governance proofs. No production redesign was required.
+
+- Repository: `C:\Users\daile\Projects\my-frontend-observer`
+- Starting commit: `5db4d93bc5e39812da694aedbbc4f51de152114e`
+- Branch: `feature/v0.10-full-visual-workflow`
+- Package remains `0.9.1`.
+- my-dev-kit: `1.12.4`, pinned and CLI-verified under `.my-dev-kit-workflow/tools/v0.10-batch7-correction/`.
+- Fresh correction index: `.my-dev-kit-context/indexes/my-frontend-observer-v0.10-batch7-correction-20260922`; `src viewer/src tests scripts`, call graph, 317 files, 2,559 symbols, 4,979 edges, zero top-level warnings/errors. Data-model/classification were partial (872/2,509 warnings); frontend analyzers were complete.
+
+## Result
+
+The pure cycle owner derives initial, review-required, correction-requested, accepted, and abandoned without schema persistence. Check and handoff share it. Review owns `decidedAt`, changes only the latest review in an immutable child, preserves request/attempt/candidate/check identity, uses active-scope readiness for correction and acceptance, and accepts only the latest canonical PASS. Abandon is terminal without requiring active acceptance. Restore remains separately explicit.
+
+Applicable reference checks reuse `buildReferenceCorrectionReviewIdentity` and `buildReferenceCorrectionAttemptIdentity`; `checkProject` runs once and `reviewReferenceCorrectionAttempt` is not called. Orchestrator metadata is non-authoritative.
+
+Governance records only already-persisted canonical results after acceptance. The baseline proof calls `approveAndPersistBaseline` for the exact accepted candidate before recording it. The reference proof imports a successor and calls `approveExternalReference` with the exact frozen predecessor before recording it. Both create immutable workflow children, reject mismatch/overwrite, preserve parents, and leave project configuration unchanged. Acceptance itself leaves governance absent and calls no approval or restore owner.
+
+The independent Chromium ACCEPTANCE GATE owns a mutable loopback frontend. External edit 1 passes the requested shrink but fails protected rail width, so canonical checking records FAIL and pending review blocks check/handoff/Accept. Request correction creates an immutable child. External edit 2 produces distinct candidate/attempt IDs, immediate lineage, PASS, and acceptance. The original active manifest bytes remain unchanged; governance remains absent; acceptance is not restored; continuation becomes terminal.
+
+Canonical reference precedence is proved by `Proof B: the external actor satisfies the reference but introduces a protected regression - overall FAIL`. The reference visual-workflow test then proves one check per candidate, common deterministic v0.7 review identity, distinct reference attempt identities, lineage, and PASS-only acceptance. Existing Proof C independently exercises two real canonical reference candidates.
+
+## TST-B7-001..087 responsibility ledger
+
+Abbreviations: `service` = `tests/unit/visualChangeAgentHandoffService.test.ts`; `viewer` = `tests/unit/viewerVisualChangeAuthoring.test.ts`; `actual-gate` = `tests/browser/visualChangeCorrectionAcceptance.test.ts`; `reference-proof` = `tests/browser/referenceCorrectionWorkflow.test.ts`.
+
+- TST-B7-001 — service — “derives the canonical cycle and rejects review with zero attempts” — existing-covered — no-attempt review rejected.
+- TST-B7-002 — service — “enforces terminal transitions and permits abandonment…” — existing-covered — pending FAIL to correction.
+- TST-B7-003 — service — “accepts only the latest canonical PASS…” — existing-covered — pending PASS to correction.
+- TST-B7-004 — service — “accepts only the latest canonical PASS…” — existing-covered — pending PASS accepted.
+- TST-B7-005 — service — “rejects non-PASS acceptance…” — existing-covered — FAIL rejected.
+- TST-B7-006 — service — “rejects non-PASS acceptance…” — existing-covered — BLOCKED rejected.
+- TST-B7-007 — service — “rejects non-PASS acceptance…” — existing-covered — REVIEW_REQUIRED rejected.
+- TST-B7-008 — service — “enforces terminal transitions…” — existing-covered — pending abandoned.
+- TST-B7-009 — service — “enforces terminal transitions…” — existing-covered — correction abandoned.
+- TST-B7-010 — service — “enforces terminal transitions…” — existing-covered — correction cannot accept.
+- TST-B7-011 — service — “runs the explicit FAIL -> correction -> PASS loop…” — existing-covered — accepted terminal.
+- TST-B7-012 — service — “enforces terminal transitions…” — existing-covered — abandoned terminal.
+- TST-B7-013 — service — “accepts only the latest canonical PASS…” — existing-covered — server decidedAt.
+- TST-B7-014 — service — same test — existing-covered — attempt ID unchanged.
+- TST-B7-015 — service — same test — existing-covered — candidate/check/recordedAt unchanged.
+- TST-B7-016 — service — same test — existing-covered — fresh workflow ID.
+- TST-B7-017 — service — same test — existing-covered — request ID preserved.
+- TST-B7-018 — service — same test — existing-covered — child supersedes parent.
+- TST-B7-019 — service — “runs the explicit FAIL -> correction -> PASS loop…” — existing-covered — parent bytes unchanged.
+- TST-B7-020 — actual-gate — “ACCEPTANCE GATE: external FAIL edit…” — newly-covered — first check allowed.
+- TST-B7-021 — service — “blocks check and handoff while pending…” — existing-covered — second check blocked.
+- TST-B7-022 — service — same test — existing-covered — handoff blocked.
+- TST-B7-023 — service — same test — existing-covered — correction enables handoff.
+- TST-B7-024 — actual-gate — ACCEPTANCE GATE — newly-covered — correction enables check.
+- TST-B7-025 — service — explicit loop — existing-covered — immediate prior ID.
+- TST-B7-026 — actual-gate — ACCEPTANCE GATE — newly-covered — candidate IDs differ.
+- TST-B7-027 — actual-gate — ACCEPTANCE GATE — newly-covered — attempt IDs differ.
+- TST-B7-028 — actual-gate — ACCEPTANCE GATE — newly-covered — request ID stable.
+- TST-B7-029 — service — explicit loop — existing-covered — new attempt pending.
+- TST-B7-030 — service — explicit loop — existing-covered — accepted blocks check.
+- TST-B7-031 — service — explicit loop — existing-covered — accepted blocks handoff.
+- TST-B7-032 — service — terminal-transition test — existing-covered — abandoned blocks check.
+- TST-B7-033 — service — terminal-transition test — existing-covered — abandoned blocks handoff.
+- TST-B7-034 — service — “runs the reference two-candidate correction gate…” — newly-covered — canonical review builder.
+- TST-B7-035 — service — same test — newly-covered — canonical attempt builder.
+- TST-B7-036 — viewer — “keeps every POST project-aware…closed…” — existing-covered — browser supplies no trace ID.
+- TST-B7-037 — service — reference two-candidate test — newly-covered — one check per attempt/no second evaluator.
+- TST-B7-038 — service — same test — newly-covered — distinct reference attempt IDs.
+- TST-B7-039 — service — same test — newly-covered — common review request ID.
+- TST-B7-040 — service — “projects canonical reference fidelity…not-applicable…” — existing-covered — omitted when inapplicable.
+- TST-B7-041 — actual-gate — ACCEPTANCE GATE — newly-covered — requested PASS/protected FAIL stores FAIL and blocks Accept.
+- TST-B7-042 — reference-proof — “Proof B: … protected regression - overall FAIL” plus service reference loop — newly-covered — fidelity PASS/contract FAIL/accept rejected.
+- TST-B7-043 — service — latest-PASS test — existing-covered — earlier PASS cannot authorize latest FAIL.
+- TST-B7-044 — service — latest-PASS test — existing-covered — only latest PASS accepted.
+- TST-B7-045 — service — non-PASS/orchestrator test — existing-covered — coordination cannot authorize.
+- TST-B7-046 — service — same test — existing-covered — no orchestrator invocation.
+- TST-B7-047 — actual-gate — ACCEPTANCE GATE — newly-covered — no baseline approval on accept.
+- TST-B7-048 — actual-gate — ACCEPTANCE GATE — newly-covered — no reference approval on accept.
+- TST-B7-049 — service — canonical governance tests — existing-covered — acceptance/config separation.
+- TST-B7-050 — actual-gate — ACCEPTANCE GATE — newly-covered — no automatic restore.
+- TST-B7-051 — service — governance tests — existing-covered — pre-acceptance record rejected.
+- TST-B7-052 — service — “records only a canonically approved candidate-matching baseline…” — newly-covered — approval service succeeds first.
+- TST-B7-053 — service — same test — newly-covered — matching approval recorded.
+- TST-B7-054 — service — same test — newly-covered — unrelated observation rejected.
+- TST-B7-055 — service — same test — newly-covered — baseline overwrite rejected.
+- TST-B7-056 — service — “records a canonically approved superseding reference…” — newly-covered — approval owner succeeds first.
+- TST-B7-057 — service — same test — newly-covered — exact successor recorded.
+- TST-B7-058 — service — same test — newly-covered — unrelated successor rejected.
+- TST-B7-059 — service — same test — newly-covered — reference overwrite rejected.
+- TST-B7-060 — service — same test — existing-covered — actual mode rejects reference result.
+- TST-B7-061 — service — governance tests — existing-covered — immutable child.
+- TST-B7-062 — service — governance tests — existing-covered — parent unchanged.
+- TST-B7-063 — service — governance tests — newly-covered — config unchanged.
+- TST-B7-064 — service — governance tests — newly-covered — recording performs no approval.
+- TST-B7-065 — actual-gate — ACCEPTANCE GATE — newly-covered — Request correction shown.
+- TST-B7-066 — actual-gate — ACCEPTANCE GATE — newly-covered — Abandon shown.
+- TST-B7-067 — actual-gate — ACCEPTANCE GATE — newly-covered — PASS Accept enabled.
+- TST-B7-068 — actual-gate — ACCEPTANCE GATE — newly-covered — FAIL Accept disabled.
+- TST-B7-069 — viewer — closed POST test — existing-covered — decision-only request.
+- TST-B7-070 — actual-gate — ACCEPTANCE GATE — newly-covered — exact child reselection.
+- TST-B7-071 — actual-gate — ACCEPTANCE GATE — newly-covered — correction continuation UI.
+- TST-B7-072 — actual-gate — ACCEPTANCE GATE — newly-covered — accepted terminal UI.
+- TST-B7-073 — viewer — Viewer workflow test — existing-covered — abandoned terminal UI.
+- TST-B7-074 — actual-gate — ACCEPTANCE GATE — newly-covered — no auto restore.
+- TST-B7-075 — viewer — Viewer workflow test — existing-covered — accepted governance section.
+- TST-B7-076 — viewer — closed POST test — existing-covered — exact evidence handle.
+- TST-B7-077 — viewer — Viewer workflow test — existing-covered — governance exact reselection.
+- TST-B7-078 — viewer — secured closed POST test — existing-covered — no token/path leak.
+- TST-B7-079 — `tests/unit/visualChangeWorkflow.test.ts` — workflow identity suite — shared-regression-covered.
+- TST-B7-080 — `tests/unit/visualChangeProjectWorkflowService.test.ts` — activation/check suite — shared-regression-covered.
+- TST-B7-081 — `tests/unit/viewerAuthoringSecurity.test.ts` — Viewer/security suite — shared-regression-covered.
+- TST-B7-082 — `tests/browser/visualChangeActualEntry.test.ts` — actual entry gate — shared-regression-covered.
+- TST-B7-083 — `tests/browser/visualChangeReferenceEntry.test.ts` — reference entry gate — shared-regression-covered.
+- TST-B7-084 — `tests/browser/visualChangeHandoff.test.ts` — handoff acceptance — shared-regression-covered.
+- TST-B7-085 — `tests/unit/projectBoundedAgentContext.test.ts` — bounded-context suite — shared-regression-covered.
+- TST-B7-086 — reference-proof — Proof A/B/C suite — shared-regression-covered.
+- TST-B7-087 — `tests/unit/viewerProtocol.test.ts` — protocol 1.3.0 — shared-regression-covered.
+
+Every responsibility has a named passing test; none is implementation-only coverage.
+
+## Validation
+
+- Focused actual gate: PASS, 1/1.
+- Focused canonical project/reference files: PASS, 2 files / 11 tests.
+- Focused service/review/governance/reference identity: PASS, 15/15.
+- `npm run typecheck`: PASS.
+- `npm run lint`: PASS.
+- `npm test`: PASS, 99 files / 1,524 tests.
+- `npm run test:browser`: PASS after additions, 31 files / 281 tests.
+- `npm run test:security`: PASS (168 unit security tests, 77 browser tests, nested hard gate PASS).
+- `npm run test:pwa-hard-gate`: PASS independently. The state-based active/scope/controller/precache/no-API-cache/server-down/offline/no-stale-evidence/cleanup proof remains intact.
+- `npm run build`: PASS; PWA 1.3.0, 10 precache entries.
+- `npm run check:docs`: PASS after this update.
+- `git diff --check`: PASS after this update.
+
+Visual-change and bounded-agent-context schemas remain `1.0.0`; all other governed schemas are unchanged; Viewer protocol remains `1.3.0`.
+
+## Full-file read accounting
+
+Full source/test file reads: none. Retrieval used my-dev-kit search, lookup, slices/exact source, dependency expansion, and bounded ranges.
+
+Correction-run additional full source/test file reads: none.
+
+## Batch 8 exclusion and handoff
+
+No Batch 8 integrated matrix, packaging, release reconciliation, version bump, readiness, PR, merge, tag, or publication work was performed. Exact next action is separately authorized Batch 8 execution from the committed Batch 7 result.

package/docs/reports/v0.10-batch8-integrated-acceptance.md

@@ -0,0 +1,109 @@
+# v0.10 Batch 8 Integrated Acceptance
+
+## 1. Verdict and repository
+
+`IMPLEMENTATION_COMPLETE` / PASS. This is not a release-readiness verdict.
+
+- Repository: `C:\Users\daile\Projects\my-frontend-observer`
+- Branch: `feature/v0.10-full-visual-workflow`
+- Starting commit: `325ae3eebc8f3b6f6a828615c6970c1aee0c9dd0`
+- Package version: `0.9.1`
+- v0.10 release state: unreleased
+- my-dev-kit: `1.12.4`
+- Fresh index: `.my-dev-kit-context/indexes/my-frontend-observer-v0.10-batch8-20260922`; 318 files, 2,567 symbols, 4,989 edges, zero top-level warnings/errors. Data-model/classification were partial with 872/2,517 warnings; frontend analyzers were complete.
+
+No production behavior changed. Batch 8 added integration aggregation, installed-package proof, CI wiring, and implementation documentation.
+
+## 2. Integrated scenario matrix
+
+1. Actual-frontend visual entry: PASS in `runtimeAnnotationContractPromotion.test.ts` ACCEPTANCE GATE.
+2. Reference-driven visual entry: PASS in `referenceAnnotationMaterialization.test.ts` ACCEPTANCE GATE.
+3. Measurable reference failure: PASS in `referenceCorrectionWorkflow.test.ts` Proof A/B and `projectCheckWorkflow.test.ts` fidelity mapping.
+4. Requested success plus protected regression: PASS in `visualChangeCorrectionAcceptance.test.ts`.
+5. Fidelity PASS plus contract FAIL: PASS in `referenceCorrectionWorkflow.test.ts` Proof B.
+6. Two-attempt immutable correction: PASS in `visualChangeCorrectionAcceptance.test.ts` and reference Proof C.
+7. Explicit latest-PASS acceptance: PASS in the correction ACCEPTANCE GATE.
+8. Governance separation: PASS in Batch 7 service integration and the correction ACCEPTANCE GATE.
+9. Optional orchestrator correlation: PASS in handoff service tests and the packed workflow smoke; it does not change request identity or acceptance.
+10. Standalone Viewer read-only: PASS in `visualChangeWorkspace.test.ts` and the packed smoke.
+11. v0.7-v0.9.1 regression safety: PASS through the normal unit/browser/security/PWA suites and the three legacy packed smokes.
+
+`tests/browser/v010IntegratedAcceptance.test.ts` is the single Batch 8 entrypoint. It composes the existing independently owned fresh-state gates and passed 20/20 tests.
+
+## 3. Packed pre-version-bump implementation candidate
+
+- Filename: `dailephd-my-frontend-observer-0.9.1.tgz`
+- Version: `0.9.1`
+- SHA-256: `282a240790c65344c539fb9d1650bd6d6cc4efca4e43ad6d7a6432b4da5ce9f2`
+- Location: `.my-dev-kit-workflow/v0.10-batch8/packed-candidate/`
+- Exactly one `npm pack` created the candidate. The hash was independently checked before each smoke.
+- Packed observation smoke: PASS.
+- Packed Viewer smoke: PASS.
+- Packed v0.9 annotation smoke: PASS.
+- Packed v0.10 workflow smoke: PASS.
+- Summaries: `observation-summary.json`, `viewer-summary.json`, `v09-summary.json`, and `v010-summary.json` under the generated candidate directory.
+
+The new smoke installed only the exact tarball into a clean consumer. Its programmatic imports resolve from consumer `node_modules`, not the source checkout. It exercised installed public constants/validators/readers, actual workflow creation and activation, handoff serialization, FAIL rejection, correction, a linked PASS attempt, acceptance, reference workflow creation with persisted bindings, real-Chromium Visual changes discovery, standalone read-only behavior, and parent/evidence immutability. The summary asserts absence of authoring tokens, note text, absolute project/temp paths, and orchestrator paths.
+
+## 4. CI same-candidate wiring
+
+The candidate job remains the only `npm pack` owner. `matrix-smoke` still downloads that tarball and verifies the candidate SHA before installed-package work. It now runs `runPackedV010WorkflowSmoke.mjs` after the v0.9 smoke and uploads `v010-workflow-smoke-summary.json` in the existing `smoke-summary-${{ matrix.os }}` artifact. No second candidate, artifact family, or matrix was added. Wiring exists; formal cross-platform v0.10 readiness has not been run or claimed.
+
+## 5. Published orchestrator compatibility
+
+Published `@dailephd/my-dev-kit-orchestrator@1.4.1` was resolved dynamically and CLI-verified. Disposable run `20260922T143421-batch8-proof` referenced the generated Observer handoff. Status honestly remained at request-brief with 0/10 artifacts and a blocked final report. Export retained run/request identity. Handoff bytes were unchanged. Observer imports no orchestrator runtime, reads no run directory, and grants no acceptance from orchestrator state.
+
+## 6. Documentation and release state
+
+CURRENT_STATE, ROADMAP, README, WORKFLOWS, COMMANDS, ARCHITECTURE, CONTRACTS, CI/CD, RELEASE guidance, and CHANGELOG `[Unreleased]` now distinguish implementation completion from release. The published package remains 0.9.1. v0.10 is not released. Hardened documentation/implementation-completeness reconciliation, formal cross-platform/security readiness, release preparation, version bump, tag, and publication remain pending.
+
+## 7. Validation
+
+Responsibility mapping:
+
+- TST-B8-001..018: the runtime/reference entry ACCEPTANCE GATEs, correction
+  ACCEPTANCE GATE, handoff service suite, and Batch 7 governance suite.
+- TST-B8-019..024: reference-correction Proof A/B/C, project-check fidelity
+  mapping, persisted reference-attempt identity test, and non-PASS review tests.
+- TST-B8-025..026: visual-change workspace standalone inspection tests and the
+  installed standalone Viewer proof.
+- TST-B8-027..042: `runPackedV010WorkflowSmoke.mjs`, including clean install,
+  installed exports/owners, actual/reference creation, activation, two attempts,
+  PASS-only acceptance, immutable bytes, Viewer modes, and leakage assertions.
+- TST-B8-043..052: the one recorded candidate/hash, four same-hash smoke
+  summaries, and additive same-candidate workflow wiring.
+- TST-B8-053..064: documentation reconciliation plus `check:docs` and the
+  `[Unreleased]`/package-version assertions.
+- TST-B8-065..074: normal reference-correction, Viewer, project-check,
+  annotation, isolated PWA, full Batch 1-7 suites, protocol/schema tests, and
+  installed public-contract checks.
+- TST-B8-075..079: dynamically resolved orchestrator 1.4.1, disposable run
+  `20260922T143421-batch8-proof`, status/export, dependency audit, and unchanged
+  Observer handoff identity.
+
+All TST-B8-001..079 responsibilities have passing named owners or generated
+proof evidence. No formal cross-platform readiness result is inferred from CI
+wiring.
+
+Focused integrated suite: PASS, 20/20. `npm run typecheck`, `npm run lint`,
+`npm test` (99 files, 1,524 tests), `npm run test:browser` (32 files,
+301 tests), `npm run test:security` (168 unit/security tests, 77 browser tests,
+and its isolated PWA tail), standalone `npm run test:pwa-hard-gate`, build,
+documentation check, and `git diff --check` passed. One locator capture failed
+once in the first security invocation immediately after the long browser run;
+the exact test passed alone and the complete canonical security command then
+passed, with no source change. This was classified as a transient Chromium
+lifecycle anomaly rather than a product defect.
+
+`npm pack --dry-run` passed and listed compiled v0.10 application/domain/viewer
+owners plus Viewer assets. It included no tests, generated workflow/tool state,
+consumer/profile state, smoke summaries, or nested tarball. The four
+same-candidate packed smokes and published-orchestrator compatibility passed.
+
+## 8. Full-file read accounting
+
+Authoritative documentation and historical reports were required whole-file reads. Source/test inspection used retrieval-first search, bounded source, continuation, dependency expansion, and bounded ranges. Full source/test file reads: none.
+
+## 9. Exact next action
+
+Run the separate hardened documentation and implementation-completeness reconciliation for v0.10.