@dailephd/my-frontend-observer 0.8.1 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 ## [Unreleased]
 
+## 0.9.0 - 2026-09-21
+
+v0.9, Human Visual Annotation and Design-Intent Capture. Structured visual
+annotation through the existing viewer. Drawing is evidence, not meaning:
+association, confirmation, promotion, materialization, activation and approval
+each remain separate, explicit steps.
+
+- Added the `VisualAnnotationArtifact` evidence family (schema `1.0.0`) with
+  deterministic identity, an atomic writer, a canonical reader, a persistence
+  service, and a derived annotation overlay SVG. Every save is an immutable
+  revision with stale-parent conflict detection.
+- Added runtime observation annotation in runtime CSS pixels and external
+  reference annotation in reference-image pixels, with five mark kinds (point,
+  rectangle, line, arrow and note), Select and Pan modes, zoom, and keyboard
+  selection.
+- Added explicit associations in each source domain: a runtime target, a
+  runtime relationship, or a reference region. Where a mark is drawn never
+  decides what it is about.
+- Added candidate and confirmed interpretation. Changing a confirmed meaning
+  withdraws its confirmation.
+- Added runtime operations `inspect`, `move`, `resize`, `remove` and
+  `preserve`, and authored categories `requested`, `expected-dependent`,
+  `protected` and `preserved`. `unexpected` is concluded by comparison, never
+  authored.
+- Added promotion of selected confirmed runtime `move`, `resize` and
+  `preserve` intent into a canonical per-change frontend contract. Promotion
+  does not activate the contract; project activation is a separate, optional,
+  explicit choice. Confirmed `remove` intent stays non-promotable because the
+  contract vocabulary has no target-absent primitive, and `inspect` is never a
+  clause.
+- Added reference-region create and refine intent, and property, relationship
+  and measurement reference requirements.
+- Added materialization of selected confirmed reference intent into a new
+  imported external-reference revision that supersedes its source. The source
+  reference is never modified, and the new revision is not approved
+  automatically.
+- Added a project-aware local authoring boundary: a 32-byte in-memory session
+  capability, strict Host and Origin checks, JSON-only bounded request bodies,
+  and one serialized write queue. `view --root` stays read-only.
+- Added three authoring routes: `POST /api/annotations`,
+  `POST /api/annotations/:handle/promote-contract`, and
+  `POST /api/annotations/:handle/materialize-reference`. The viewer protocol
+  is now `1.3.0`.
+- Added viewer discovery of visual annotations, a source-resolving annotation
+  view route, and a verified, script-blocking overlay media role.
+- Evidence discovery now skips writer temporary `.tmp-*` directories.
+- Fixed viewer shutdown stalling while a browser or service worker held a
+  connection open. Closing the viewer now also ends active connections.
+- Added an integrated real-Chromium acceptance suite and a packed installed
+  v0.9 annotation smoke to the cross-platform pre-release readiness workflow.
+- The repository gained a deterministic demo and four tutorials under
+  `examples/v09-demo/`, proved end to end with the external tool
+  `@dailephd/my-dev-kit-lab@0.4.9`. The demo is repository material only: it is
+  not in the npm package, and my-dev-kit-lab is not an Observer dependency.
+- Final pre-release readiness passed on Windows, Linux and macOS against one
+  exact candidate package, including all four tutorials.
+
 ## 0.8.1 - 2026-09-15
 
 Project workflow release for `my-frontend-observer`.

package/README.md

@@ -1,6 +1,6 @@
 # my-frontend-observer
 
-## Common project workflow (v0.8.1)
+## Common project workflow (v0.9.0)
 
 ```powershell
 my-frontend-observer init --url http://127.0.0.1:3000 --target app=#app
@@ -17,16 +17,20 @@ my-frontend-observer view
 `1`, `2`, or `3` for `PASS`, `FAIL`, `REVIEW_REQUIRED`, or `BLOCKED`.
 Canonical hashes remain available in viewer details and persisted provenance,
 but are not normal workflow command inputs. The existing low-level commands
-remain supported. v0.8.1 is the current published release.
+remain supported. v0.9.0 is the current published release.
+
+v0.9.0 adds the structured visual annotation workflow described below.
 
 `my-frontend-observer` is the local-first rendered browser/runtime evidence
 producer in the my-dev-kit ecosystem. Its durable product purpose is defined
-in [docs/PROJECT_DESCRIPTION.md](docs/PROJECT_DESCRIPTION.md).
+in [docs/PROJECT_DESCRIPTION.md](docs/PROJECT_DESCRIPTION.md). Whole-ecosystem
+composition is documented in the [my-dev-kit ecosystem guide](https://github.com/dailephd/my-dev-kit/blob/main/docs/ECOSYSTEM_DEVELOPMENT_WORKFLOWS.md), including the [command-surface compatibility map](https://github.com/dailephd/my-dev-kit/blob/main/docs/ECOSYSTEM_DEVELOPMENT_WORKFLOWS.md#915-command-surface-compatibility-map).
 
 ## Current status
 
-`v0.8.1`, Project Workflow CLI and Human-Readable Evidence Aliases, is the
-current published release. It builds on `v0.8.0`, Interactive Local Observation
+`v0.9.0`, Human Visual Annotation and Design-Intent Capture, is the current
+published release. It builds on `v0.8.1`, Project Workflow CLI and
+Human-Readable Evidence Aliases, `v0.8.0`, Interactive Local Observation
 Viewer, and `v0.7.0`, End-to-End Coding-Agent Frontend Change
 Review, `v0.6.0`, Bounded Agent Context and Native my-dev-kit Ecosystem
 Integration, and `v0.5.0`, Executable Frontend Contracts and Explicit Change
@@ -210,6 +214,102 @@ my-frontend-observer view --root observations --port 4319 --no-open
 
 (From a source checkout, use `node dist/cli.js view ...` instead.)
 
+### Visual annotation (v0.9.0)
+
+v0.9.0 adds structured visual annotation to the project-aware viewer. The
+model rests on a few deliberate separations:
+
+- Drawing is evidence, not meaning. A mark on its own says nothing about what
+  should change.
+- Association is explicit. You choose what a mark is about.
+- Confirmation is explicit. A candidate meaning is only a proposal until you
+  confirm it.
+- Promotion and materialization are selected actions. Nothing is promoted or
+  materialized just because it was confirmed.
+- Promotion does not activate a contract, and materialization does not approve
+  a reference. Those remain separate, explicit decisions.
+
+The capabilities:
+
+- **Runtime screenshot annotation**: draw points, rectangles, lines, arrows,
+  and notes on an observation screenshot. Geometry is stored in runtime CSS
+  pixels.
+- **External-reference annotation**: draw the same marks on an imported or
+  approved design reference. Geometry is stored in reference-image pixels.
+- **Explicit association**: a mark is linked to a runtime target, a runtime
+  relationship, a reference region, or a reference relationship only when you
+  choose it. Drawing over something never creates an association.
+- **Candidate and confirmed intent**: you choose a structured intent (for
+  example "move header right" or "create region hero"), review the exact
+  candidate structure, and confirm it explicitly. Editing a confirmed item
+  withdraws the confirmation.
+- **Immutable saves**: each save writes a new `VisualAnnotationArtifact`
+  (schema `1.0.0`). A revision supersedes its parent and never rewrites it.
+- **Runtime contract promotion**: selected confirmed runtime intent can be
+  promoted into a normal per-change frontend contract. Activating that
+  contract for `check` is a separate explicit choice.
+- **Reference materialization**: selected confirmed reference regions and
+  requirements can be materialized into a new imported external-reference
+  revision that supersedes the source. The source reference is never changed,
+  and the new revision is not approved automatically.
+
+Authoring is available only in the project-aware viewer:
+
+```powershell
+# Project-aware: annotation authoring enabled for this project.
+my-frontend-observer view
+
+# Standalone: always read-only, even for annotation evidence.
+my-frontend-observer view --root .frontend-observer/evidence
+```
+
+There is no separate annotation command. Observer still never edits target
+source, never approves a baseline or reference on its own, and never adds a
+new PASS/FAIL rule for annotations. The existing contract and reference
+evaluators remain the only source of verdicts. See
+[docs/WORKFLOWS.md](docs/WORKFLOWS.md) and
+[docs/SECURITY.md](docs/SECURITY.md) for the full workflow and the local write
+boundary.
+
+## Demo and tutorials
+
+Explaining annotation, contracts, and references against a real application is
+hard, because a real application changes for reasons unrelated to the lesson.
+The repository therefore keeps a small deterministic demo application in
+[examples/v09-demo/](examples/v09-demo/README.md). Every region is named and
+every state difference is deliberate, so the same state always renders the
+same geometry at the canonical 1440x900 viewport.
+
+Four v0.9 tutorial scenarios live in `examples/v09-demo/tutorials/`. They are
+recorded by the external tool `@dailephd/my-dev-kit-lab@0.4.9`, which drives
+the real Observer viewer in Chromium against a disposable project built from
+the demo. Observer itself has no tutorial command and does not depend on the
+lab.
+
+A contributor builds Observer, generates a per-run target contract, then
+validates and runs a scenario:
+
+```powershell
+npm run build
+node examples/v09-demo/scripts/generate-tutorial-target.mjs `
+  --scenario observer-v09-annotation-basics `
+  --out .my-dev-kit-workflow/adhoc/target-contract.json
+npx --yes @dailephd/my-dev-kit-lab@0.4.9 tutorial validate `
+  --scenario examples/v09-demo/tutorials/01-annotation-basics.json `
+  --target-contract .my-dev-kit-workflow/adhoc/target-contract.json --json
+npx --yes @dailephd/my-dev-kit-lab@0.4.9 tutorial run `
+  --scenario examples/v09-demo/tutorials/01-annotation-basics.json `
+  --target-contract .my-dev-kit-workflow/adhoc/target-contract.json `
+  --out <an output directory you choose outside the repository> --json
+```
+
+A run writes a WebM video, screenshots, SRT and VTT subtitles, a Markdown
+tutorial, and a manifest into the output directory you choose. None of that is
+committed. The demo and tutorial sources are repository examples only. They
+are not included in the npm package. See
+[examples/v09-demo/README.md](examples/v09-demo/README.md) for the full
+contributor workflow.
+
 ## License
 
 MIT. See [LICENSE](LICENSE).
@@ -247,8 +347,8 @@ Planning authorities:
   intent and responsibility boundaries.
 - [Project Milestones](docs/PROJECT_MILESTONES.md): complete ordered capability
   design and cross-milestone rules.
-- [ROADMAP](docs/ROADMAP.md): version-level requirements; v0.1-v0.8 are
-  released; v0.9+ remain future.
+- [ROADMAP](docs/ROADMAP.md): version-level requirements; v0.1-v0.9.0 are
+  released; v0.10 remains future.
 - [Current State](docs/CURRENT_STATE.md): retained scaffold and release state.
 
 No sibling ecosystem repository is a runtime dependency of the retained

package/dist/application/projectWorkflowService.d.ts

@@ -38,9 +38,26 @@ export type CaptureNamedObservationResult = {
 } | WorkflowFailure;
 export declare function captureNamedObservation(input: CaptureNamedObservationInput): Promise<CaptureNamedObservationResult>;
 export declare function captureCurrentObservation(projectRoot: string): Promise<CaptureNamedObservationResult>;
-export declare function loadProjectViewerState(projectRoot: string): Promise<{
+export declare function loadProjectViewerState(projectRootInput: string): Promise<{
     ok: true;
+    projectRoot: string;
     root: string;
     aliases: Readonly<Record<string, string>>;
 } | WorkflowFailure>;
+export type ActivateProjectChangeContractResult = {
+    ok: true;
+} | {
+    ok: false;
+    code: 'not-configured' | 'project-config-invalid' | 'project-state-write-failure';
+    reason: string;
+};
+/**
+ * v0.9 Batch 5: explicitly activates an already-persisted change contract for
+ * project `check` by updating exactly `acceptance.contract.changeArtifact`.
+ * Allowed only when the project already configures `acceptance.contract`:
+ * the block is never created, the baseline artifact and every other field are
+ * carried over verbatim from the on-disk configuration, the full updated
+ * configuration is validated before writing, and the write is atomic.
+ */
+export declare function activateProjectChangeContract(projectRootInput: string, changeArtifactPath: string): Promise<ActivateProjectChangeContractResult>;
 export {};

package/dist/application/projectWorkflowService.js

@@ -77,7 +77,8 @@ async function captureObservation(input, allowReserved) {
 }
 export async function captureNamedObservation(input) { return captureObservation(input, false); }
 export async function captureCurrentObservation(projectRoot) { return captureObservation({ projectRoot, alias: 'current', replace: true }, true); }
-export async function loadProjectViewerState(projectRoot) {
+export async function loadProjectViewerState(projectRootInput) {
+    const projectRoot = path.resolve(projectRootInput);
     const config = await readProjectConfig(projectConfigPath(projectRoot));
     if (!config.ok)
         return { ok: false, code: 'project-config-invalid', message: config.reason };
@@ -87,6 +88,43 @@ export async function loadProjectViewerState(projectRoot) {
     const aliases = {};
     for (const [alias, record] of Object.entries(catalog.catalog.observations))
         aliases[record.relativeArtifactDir] = alias;
-    return { ok: true, root: projectEvidenceRoot(projectRoot), aliases };
+    return { ok: true, projectRoot, root: projectEvidenceRoot(projectRoot), aliases };
+}
+/**
+ * v0.9 Batch 5: explicitly activates an already-persisted change contract for
+ * project `check` by updating exactly `acceptance.contract.changeArtifact`.
+ * Allowed only when the project already configures `acceptance.contract`:
+ * the block is never created, the baseline artifact and every other field are
+ * carried over verbatim from the on-disk configuration, the full updated
+ * configuration is validated before writing, and the write is atomic.
+ */
+export async function activateProjectChangeContract(projectRootInput, changeArtifactPath) {
+    const projectRoot = path.resolve(projectRootInput);
+    const configPath = projectConfigPath(projectRoot);
+    let raw;
+    try {
+        raw = JSON.parse(await readFile(configPath, 'utf8'));
+    }
+    catch (error) {
+        return { ok: false, code: 'project-config-invalid', reason: `project configuration could not be read: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    const current = validateProjectConfig(raw);
+    if (!current.ok)
+        return { ok: false, code: 'project-config-invalid', reason: current.reason };
+    if (current.config.acceptance?.contract === undefined) {
+        return { ok: false, code: 'not-configured', reason: 'Project contract acceptance is not configured; the new contract was persisted but is not active for check.' };
+    }
+    const rawConfig = raw;
+    const updated = { ...rawConfig, acceptance: { ...rawConfig.acceptance, contract: { ...rawConfig.acceptance.contract, changeArtifact: changeArtifactPath } } };
+    const validated = validateProjectConfig(updated);
+    if (!validated.ok)
+        return { ok: false, code: 'project-config-invalid', reason: `updated project configuration would be invalid: ${validated.reason}` };
+    try {
+        await atomicTextWrite(configPath, `${JSON.stringify(updated, null, 2)}\n`);
+    }
+    catch (error) {
+        return { ok: false, code: 'project-state-write-failure', reason: `project configuration could not be written: ${error instanceof Error ? error.message : String(error)}` };
+    }
+    return { ok: true };
 }
 //# sourceMappingURL=projectWorkflowService.js.map

package/dist/application/projectWorkflowService.js.map

@@ -1 +1 @@
-{"version":3,"file":"projectWorkflowService.js","sourceRoot":"","sources":["../../src/application/projectWorkflowService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"projectWorkflowService.js","sourceRoot":"","sources":["../../src/application/projectWorkflowService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAClF,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AACxJ,OAAO,EAAE,4BAA4B,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvH,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAMzI,KAAK,UAAU,MAAM,CAAC,IAAY,IAAsB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAC5G,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,IAAY;IACvD,MAAM,IAAI,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;IAC5E,IAAI,CAAC;QAAC,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAAC,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAAC,MAAM,KAAK,CAAC;IAAC,CAAC;AAC/J,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,KAA6B;IACnF,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,qFAAqF,EAAE,CAAC;IACtM,MAAM,SAAS,GAAG,EAAE,aAAa,EAAE,6BAA6B,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,UAAU,EAAE,CAAC;IAC3L,MAAM,SAAS,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IACnG,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YAAE,MAAM,iBAAiB,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,4BAA4B,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1I,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,qBAAqB,CAAC,EAAE,CAAC;YACnF,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC;YAC7F,MAAM,SAAS,CAAC,UAAU,EAAE,GAAG,MAAM,uBAAuB,EAAE,MAAM,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IAAC,CAAC;AACjJ,CAAC;AAID,KAAK,UAAU,kBAAkB,CAAC,KAAmC,EAAE,aAAsB;IAC3F,MAAM,eAAe,GAAG,wBAAwB,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC7E,IAAI,CAAC,eAAe,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,eAAe,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,eAAe,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,qFAAqF,EAAE,CAAC;IACrU,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7F,MAAM,aAAa,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAClF,IAAI,CAAC,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC;IAC5G,IAAI,aAAa,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,KAAK,CAAC,KAAK,mEAAmE,EAAE,CAAC;IACnO,MAAM,UAAU,GAAG,gBAAgB,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,EAAE,yBAAyB,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAChM,IAAI,CAAC,UAAU,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACnJ,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;IAClI,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtH,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,8DAA8D,EAAE,CAAC;IAChM,MAAM,OAAO,GAAG,EAAE,GAAG,aAAa,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,GAAG,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1N,IAAI,CAAC;QAAC,MAAM,iBAAiB,CAAC,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAAC,CAAC;IAC9E,OAAO,KAAK,EAAE,CAAC;QAAC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,EAAE,OAAO,EAAE,2DAA2D,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAAC,CAAC;IAC1M,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,YAAY,EAAE,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC;AAC1N,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAmC,IAA4C,OAAO,kBAAkB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AACvK,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB,IAA4C,OAAO,kBAAkB,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;AAEnM,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,gBAAwB;IACnE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7F,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC;IACtE,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAChG,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,CAAC,MAAM,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC;IACxH,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;AACpF,CAAC;AAID;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,gBAAwB,EAAE,kBAA0B;IACtG,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAClD,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAY,CAAC;IAClE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,4CAA4C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IACrK,CAAC;IACD,MAAM,OAAO,GAAG,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAC9F,IAAI,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,4GAA4G,EAAE,CAAC;IACrK,CAAC;IAED,MAAM,SAAS,GAAG,GAAgH,CAAC;IACnI,MAAM,OAAO,GAAG,EAAE,GAAG,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE,QAAQ,EAAE,EAAE,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,EAAE,CAAC;IAC9J,MAAM,SAAS,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IACjD,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,wBAAwB,EAAE,MAAM,EAAE,mDAAmD,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC;IAEvJ,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IAC7E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,6BAA6B,EAAE,MAAM,EAAE,+CAA+C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;IAC7K,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/dist/application/visualAnnotationContractPromotionService.d.ts

@@ -0,0 +1,41 @@
+import type { ObservationArtifact } from '../domain/schema.js';
+import type { VisualAnnotationArtifact, VisualAnnotationItem } from '../domain/visualAnnotation.js';
+export interface PromoteVisualAnnotationContractOptions {
+    annotation: VisualAnnotationArtifact;
+    sourceObservation: ObservationArtifact;
+    selectedItemIds: readonly string[];
+    activeBaselineIds: readonly string[];
+    outputLocation: string;
+    cwd?: string;
+}
+export type PromoteVisualAnnotationContractFailureCode = 'invalid-annotation' | 'unsupported-source' | 'source-mismatch' | 'invalid-selection' | 'persistence-failed';
+export type PromoteVisualAnnotationContractResult = {
+    ok: true;
+    contractId: string;
+    contractRequestId: string;
+    artifactRoot: string;
+    manifestPath: string;
+    clauseCount: number;
+} | {
+    ok: false;
+    code: PromoteVisualAnnotationContractFailureCode;
+    reason: string;
+};
+/** Maximum number of selected items accepted in one promotion (the annotation itself is bounded to 100 items). */
+export declare const MAX_PROMOTION_ITEM_IDS = 100;
+/** Why one selected item cannot become a canonical contract clause, or undefined when it can. */
+export declare function contractPromotionBlockReason(item: VisualAnnotationItem): string | undefined;
+/**
+ * v0.9 Batch 5: the one canonical annotation-to-contract use case. It turns
+ * explicitly selected, confirmed, canonically promotable runtime change items
+ * of one saved visual annotation into one ordinary `PerChangeContract`,
+ * built only with the existing contract identity builders and persisted
+ * exactly once through `persistPerChangeContract`.
+ *
+ * The whole promotion is refused if any selected item is not promotable
+ * (never a partial contract). Clause order follows `selectedItemIds`.
+ * `activeBaselineIds` are supplied by the caller from explicitly configured
+ * baseline-contract evidence only. The annotation is never evaluated here -
+ * the existing contract evaluator remains the only PASS/FAIL authority.
+ */
+export declare function promoteVisualAnnotationContract(options: PromoteVisualAnnotationContractOptions): Promise<PromoteVisualAnnotationContractResult>;

package/dist/application/visualAnnotationContractPromotionService.js

@@ -0,0 +1,143 @@
+import { isValidVisualAnnotationArtifact } from '../domain/visualAnnotation.js';
+import { CONTRACT_ARTIFACT_KIND, CONTRACT_SCHEMA_VERSION, isValidContractPrimitive } from '../domain/frontendContracts.js';
+import { buildClauseIdentity, buildFrontendContractInstanceIdentity, buildFrontendContractRequestIdentity } from '../domain/frontendContractIdentity.js';
+import { persistPerChangeContract } from './frontendContractPersistenceService.js';
+/** Maximum number of selected items accepted in one promotion (the annotation itself is bounded to 100 items). */
+export const MAX_PROMOTION_ITEM_IDS = 100;
+function fail(code, reason) {
+    return { ok: false, code, reason };
+}
+const MOVE_PROPERTIES = new Set(['x', 'y']);
+const RESIZE_PROPERTIES = new Set(['width', 'height']);
+const PRESERVE_PROPERTIES = new Set(['x', 'y', 'width', 'height']);
+/**
+ * The bounded v0.9 promotion mapping check: a confirmed change primitive must
+ * be one of the first annotation mappings AND its subject must equal the
+ * item's explicit association. Anything else is refused, never coerced.
+ */
+function primitiveMatchesAssociation(operation, primitive, association) {
+    switch (operation) {
+        case 'move':
+        case 'resize': {
+            if (association.kind !== 'runtime-target')
+                return false;
+            if (primitive.kind !== 'property-increases' && primitive.kind !== 'property-decreases')
+                return false;
+            if (primitive.minimumDeltaPx !== undefined)
+                return false;
+            const allowed = operation === 'move' ? MOVE_PROPERTIES : RESIZE_PROPERTIES;
+            return primitive.target === association.target && allowed.has(primitive.property);
+        }
+        case 'preserve':
+            if (association.kind === 'runtime-target') {
+                return primitive.kind === 'property-unchanged-within-tolerance' && primitive.target === association.target && PRESERVE_PROPERTIES.has(primitive.property);
+            }
+            return (primitive.kind === 'relationship-unchanged' &&
+                primitive.relationshipKind === association.relationshipKind &&
+                primitive.subjectTarget === association.subjectTarget &&
+                primitive.relatedTarget === association.relatedTarget);
+        default:
+            return false;
+    }
+}
+/** Why one selected item cannot become a canonical contract clause, or undefined when it can. */
+export function contractPromotionBlockReason(item) {
+    const { interpretation } = item;
+    if (interpretation.state === 'uninterpreted')
+        return 'the item has no interpretation';
+    if (interpretation.state === 'candidate')
+        return 'the item interpretation is a candidate, not confirmed';
+    const intent = interpretation.intent;
+    if (intent.kind === 'inspect')
+        return 'inspect intent is informational and never a contract clause';
+    if (intent.kind !== 'change')
+        return `"${intent.kind}" intent is not runtime change intent`;
+    if (intent.operation === 'remove')
+        return 'remove is not canonically promotable: the current frontend-contract vocabulary has no target-absent primitive';
+    if (intent.contractPrimitive === undefined || !isValidContractPrimitive(intent.contractPrimitive))
+        return 'the confirmed change intent has no valid contract primitive';
+    if (item.association === undefined)
+        return 'the item has no explicit structured association';
+    if (item.association.kind !== 'runtime-target' && item.association.kind !== 'runtime-relationship')
+        return 'the item association is not runtime evidence';
+    if (!primitiveMatchesAssociation(intent.operation, intent.contractPrimitive, item.association))
+        return 'the contract primitive does not match the explicit association and operation';
+    return undefined;
+}
+function observationMatchesSource(annotation, observation) {
+    const source = annotation.source;
+    if (source.kind !== 'runtime-observation')
+        return false;
+    const screenshot = observation.screenshot;
+    return (observation.observationId === source.observationId &&
+        observation.requestId === source.requestId &&
+        observation.schemaVersion === source.observationSchemaVersion &&
+        (screenshot.state === 'available' || screenshot.state === 'partial') &&
+        screenshot.value.path === source.screenshot.path &&
+        observation.requestConfig.viewport.width === source.coordinateSpace.width &&
+        observation.requestConfig.viewport.height === source.coordinateSpace.height);
+}
+/**
+ * v0.9 Batch 5: the one canonical annotation-to-contract use case. It turns
+ * explicitly selected, confirmed, canonically promotable runtime change items
+ * of one saved visual annotation into one ordinary `PerChangeContract`,
+ * built only with the existing contract identity builders and persisted
+ * exactly once through `persistPerChangeContract`.
+ *
+ * The whole promotion is refused if any selected item is not promotable
+ * (never a partial contract). Clause order follows `selectedItemIds`.
+ * `activeBaselineIds` are supplied by the caller from explicitly configured
+ * baseline-contract evidence only. The annotation is never evaluated here -
+ * the existing contract evaluator remains the only PASS/FAIL authority.
+ */
+export async function promoteVisualAnnotationContract(options) {
+    const { annotation, sourceObservation, selectedItemIds, activeBaselineIds } = options;
+    const validation = isValidVisualAnnotationArtifact(annotation);
+    if (!validation.valid)
+        return fail('invalid-annotation', `visual annotation is invalid: ${validation.reason}`);
+    if (annotation.source.kind !== 'runtime-observation')
+        return fail('unsupported-source', 'only runtime-observation annotations can be promoted into a frontend change contract');
+    if (!observationMatchesSource(annotation, sourceObservation))
+        return fail('source-mismatch', 'the supplied observation is not the exact canonical source of this annotation');
+    if (selectedItemIds.length === 0)
+        return fail('invalid-selection', 'select at least one confirmed annotation item to promote');
+    if (selectedItemIds.length > MAX_PROMOTION_ITEM_IDS)
+        return fail('invalid-selection', `at most ${MAX_PROMOTION_ITEM_IDS} items can be promoted at once`);
+    if (new Set(selectedItemIds).size !== selectedItemIds.length)
+        return fail('invalid-selection', 'selected annotation item ids must be unique');
+    const itemsById = new Map(annotation.items.map((item) => [item.annotationItemId, item]));
+    const clauses = [];
+    for (const itemId of selectedItemIds) {
+        const item = itemsById.get(itemId);
+        if (item === undefined)
+            return fail('invalid-selection', `selected annotation item "${itemId}" does not exist in this annotation`);
+        const blocked = contractPromotionBlockReason(item);
+        if (blocked !== undefined)
+            return fail('invalid-selection', `annotation item "${itemId}" cannot be promoted: ${blocked}`);
+        const intent = item.interpretation.intent;
+        const primitive = intent.contractPrimitive;
+        clauses.push({
+            clauseId: buildClauseIdentity(primitive),
+            category: intent.category,
+            ...(intent.expectedDependentMode === undefined ? {} : { expectedDependentMode: intent.expectedDependentMode }),
+            primitive,
+            supportingEvidence: [{ path: `visualAnnotation.${annotation.annotationId}.source` }, { path: `visualAnnotation.${annotation.annotationId}.items.${item.annotationItemId}` }],
+        });
+    }
+    const contractRequestId = buildFrontendContractRequestIdentity(annotation.source.observationId, clauses.map((clause) => ({ primitive: clause.primitive })), []);
+    const contractId = buildFrontendContractInstanceIdentity(contractRequestId);
+    const contract = {
+        artifactKind: CONTRACT_ARTIFACT_KIND,
+        schemaVersion: CONTRACT_SCHEMA_VERSION,
+        contractClass: 'change',
+        contractId,
+        contractRequestId,
+        activeBaselineIds: [...activeBaselineIds],
+        clauses,
+    };
+    const persisted = await persistPerChangeContract(contract, { outputLocation: options.outputLocation, ...(options.cwd === undefined ? {} : { cwd: options.cwd }) });
+    if (!persisted.ok)
+        return fail('persistence-failed', persisted.diagnostics.map((d) => d.message).join('; '));
+    return { ok: true, contractId, contractRequestId, artifactRoot: persisted.artifactRoot, manifestPath: persisted.manifestPath, clauseCount: clauses.length };
+}
+//# sourceMappingURL=visualAnnotationContractPromotionService.js.map

package/dist/application/visualAnnotationContractPromotionService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualAnnotationContractPromotionService.js","sourceRoot":"","sources":["../../src/application/visualAnnotationContractPromotionService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,+BAA+B,EAAE,MAAM,+BAA+B,CAAC;AAEhF,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC3H,OAAO,EAAE,mBAAmB,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,MAAM,uCAAuC,CAAC;AACzJ,OAAO,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AA4BnF,kHAAkH;AAClH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,SAAS,IAAI,CAAC,IAAgD,EAAE,MAAc;IAC5E,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACrC,CAAC;AAID,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;AAC5C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AACvD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAEnE;;;;GAIG;AACH,SAAS,2BAA2B,CAAC,SAAoC,EAAE,SAA4B,EAAE,WAAyC;IAChJ,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB;gBAAE,OAAO,KAAK,CAAC;YACxD,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB,IAAI,SAAS,CAAC,IAAI,KAAK,oBAAoB;gBAAE,OAAO,KAAK,CAAC;YACrG,IAAI,SAAS,CAAC,cAAc,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;YACzD,MAAM,OAAO,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC;YAC3E,OAAO,SAAS,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpF,CAAC;QACD,KAAK,UAAU;YACb,IAAI,WAAW,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBAC1C,OAAO,SAAS,CAAC,IAAI,KAAK,qCAAqC,IAAI,SAAS,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,IAAI,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAC5J,CAAC;YACD,OAAO,CACL,SAAS,CAAC,IAAI,KAAK,wBAAwB;gBAC3C,SAAS,CAAC,gBAAgB,KAAK,WAAW,CAAC,gBAAgB;gBAC3D,SAAS,CAAC,aAAa,KAAK,WAAW,CAAC,aAAa;gBACrD,SAAS,CAAC,aAAa,KAAK,WAAW,CAAC,aAAa,CACtD,CAAC;QACJ;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,4BAA4B,CAAC,IAA0B;IACrE,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,cAAc,CAAC,KAAK,KAAK,eAAe;QAAE,OAAO,gCAAgC,CAAC;IACtF,IAAI,cAAc,CAAC,KAAK,KAAK,WAAW;QAAE,OAAO,uDAAuD,CAAC;IACzG,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC;IACrC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,6DAA6D,CAAC;IACpG,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,MAAM,CAAC,IAAI,uCAAuC,CAAC;IAC5F,IAAI,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,+GAA+G,CAAC;IAC1J,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,iBAAiB,CAAC;QAAE,OAAO,6DAA6D,CAAC;IACxK,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,OAAO,iDAAiD,CAAC;IAC7F,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,gBAAgB,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,sBAAsB;QAAE,OAAO,8CAA8C,CAAC;IAC1J,IAAI,CAAC,2BAA2B,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,8EAA8E,CAAC;IACtL,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,UAAoC,EAAE,WAAgC;IACtG,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,IAAI,MAAM,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO,KAAK,CAAC;IACxD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;IAC1C,OAAO,CACL,WAAW,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;QAClD,WAAW,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS;QAC1C,WAAW,CAAC,aAAa,KAAK,MAAM,CAAC,wBAAwB;QAC7D,CAAC,UAAU,CAAC,KAAK,KAAK,WAAW,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,CAAC;QACpE,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,UAAU,CAAC,IAAI;QAChD,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,eAAe,CAAC,KAAK;QACzE,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,eAAe,CAAC,MAAM,CAC5E,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CAAC,OAA+C;IACnG,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAEtF,MAAM,UAAU,GAAG,+BAA+B,CAAC,UAAU,CAAC,CAAC;IAC/D,IAAI,CAAC,UAAU,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC,oBAAoB,EAAE,iCAAiC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/G,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,qBAAqB;QAAE,OAAO,IAAI,CAAC,oBAAoB,EAAE,sFAAsF,CAAC,CAAC;IAChL,IAAI,CAAC,wBAAwB,CAAC,UAAU,EAAE,iBAAiB,CAAC;QAAE,OAAO,IAAI,CAAC,iBAAiB,EAAE,+EAA+E,CAAC,CAAC;IAE9K,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,mBAAmB,EAAE,0DAA0D,CAAC,CAAC;IAC/H,IAAI,eAAe,CAAC,MAAM,GAAG,sBAAsB;QAAE,OAAO,IAAI,CAAC,mBAAmB,EAAE,WAAW,sBAAsB,gCAAgC,CAAC,CAAC;IACzJ,IAAI,IAAI,GAAG,CAAC,eAAe,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,mBAAmB,EAAE,6CAA6C,CAAC,CAAC;IAE9I,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAU,CAAC,CAAC,CAAC;IAClG,MAAM,OAAO,GAAsB,EAAE,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,mBAAmB,EAAE,6BAA6B,MAAM,qCAAqC,CAAC,CAAC;QACnI,MAAM,OAAO,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,mBAAmB,EAAE,oBAAoB,MAAM,yBAAyB,OAAO,EAAE,CAAC,CAAC;QAC1H,MAAM,MAAM,GAAI,IAAI,CAAC,cAA0F,CAAC,MAAsB,CAAC;QACvI,MAAM,SAAS,GAAG,MAAM,CAAC,iBAAsC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC;YACX,QAAQ,EAAE,mBAAmB,CAAC,SAAS,CAAC;YACxC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAC9G,SAAS;YACT,kBAAkB,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,UAAU,CAAC,YAAY,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,oBAAoB,UAAU,CAAC,YAAY,UAAU,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;SAC7K,CAAC,CAAC;IACL,CAAC;IAED,MAAM,iBAAiB,GAAG,oCAAoC,CAC5D,UAAU,CAAC,MAAM,CAAC,aAAa,EAC/B,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,EAC1D,EAAE,CACH,CAAC;IACF,MAAM,UAAU,GAAG,qCAAqC,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAsB;QAClC,YAAY,EAAE,sBAAsB;QACpC,aAAa,EAAE,uBAAuB;QACtC,aAAa,EAAE,QAAQ;QACvB,UAAU;QACV,iBAAiB;QACjB,iBAAiB,EAAE,CAAC,GAAG,iBAAiB,CAAC;QACzC,OAAO;KACR,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,QAAQ,EAAE,EAAE,cAAc,EAAE,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnK,IAAI,CAAC,SAAS,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAE7G,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,CAAC,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;AAC9J,CAAC"}

package/dist/application/visualAnnotationPersistenceService.d.ts

@@ -0,0 +1,34 @@
+import type { Diagnostic } from '../domain/diagnostics.js';
+import type { VisualAnnotationItem, VisualAnnotationSource } from '../domain/visualAnnotation.js';
+import type { WriteVisualAnnotationArtifactOptions } from '../artifacts/visualAnnotationArtifactWriter.js';
+export interface PersistVisualAnnotationOptions {
+    source: VisualAnnotationSource;
+    items: VisualAnnotationItem[];
+    outputLocation: string;
+    cwd?: WriteVisualAnnotationArtifactOptions['cwd'];
+    /** Canonical annotationId of the previous artifact this save explicitly revises. Carried forward verbatim; lineage is not resolved here. */
+    supersedesAnnotationId?: string;
+}
+export type ApplicationPersistVisualAnnotationResult = {
+    ok: true;
+    annotationId: string;
+    annotationRequestId: string;
+    artifactRoot: string;
+    manifestPath: string;
+    overlayPath: string;
+} | {
+    ok: false;
+    diagnostics: Diagnostic[];
+};
+/**
+ * The one canonical Batch 1 application use case for saving a visual
+ * annotation: validates source/items through the canonical annotation domain,
+ * normalizes the portable output location, derives the deterministic request
+ * identity and a fresh instance identity, renders the deterministic overlay
+ * and its SHA-256, and persists exactly once through the canonical writer.
+ *
+ * It never reads a viewer alias, resolves another artifact, checks revision
+ * lineage, checks whether an associated target/region exists, promotes a
+ * contract, materializes a reference, or modifies project configuration.
+ */
+export declare function persistVisualAnnotation(options: PersistVisualAnnotationOptions): Promise<ApplicationPersistVisualAnnotationResult>;

package/dist/application/visualAnnotationPersistenceService.js

@@ -0,0 +1,68 @@
+import { DIAGNOSTIC_SEVERITY } from '../domain/diagnostics.js';
+import { getProducerInfo } from '../domain/schema.js';
+import { VISUAL_ANNOTATION_ARTIFACT_KIND, VISUAL_ANNOTATION_SCHEMA_VERSION, VISUAL_ANNOTATION_OVERLAY_PATH, isValidVisualAnnotationContent, renderVisualAnnotationOverlaySvg, } from '../domain/visualAnnotation.js';
+import { buildVisualAnnotationRequestIdentity, buildVisualAnnotationInstanceIdentity } from '../domain/visualAnnotationIdentity.js';
+import { normalizeOutputLocation } from '../request/paths.js';
+import { writeVisualAnnotationArtifact, computeVisualAnnotationOverlaySha256 } from '../artifacts/visualAnnotationArtifactWriter.js';
+function failure(code, message) {
+    return { ok: false, diagnostics: [{ code, severity: DIAGNOSTIC_SEVERITY[code], message }] };
+}
+/**
+ * The one canonical Batch 1 application use case for saving a visual
+ * annotation: validates source/items through the canonical annotation domain,
+ * normalizes the portable output location, derives the deterministic request
+ * identity and a fresh instance identity, renders the deterministic overlay
+ * and its SHA-256, and persists exactly once through the canonical writer.
+ *
+ * It never reads a viewer alias, resolves another artifact, checks revision
+ * lineage, checks whether an associated target/region exists, promotes a
+ * contract, materializes a reference, or modifies project configuration.
+ */
+export async function persistVisualAnnotation(options) {
+    const contentValidation = isValidVisualAnnotationContent(options.source, options.items);
+    if (!contentValidation.valid)
+        return failure('invalid-request', `invalid visual annotation: ${contentValidation.reason}`);
+    if (options.supersedesAnnotationId !== undefined && options.supersedesAnnotationId.length === 0) {
+        return failure('invalid-request', 'supersedesAnnotationId must be a non-empty string when supplied');
+    }
+    const normalizedOutput = normalizeOutputLocation(options.outputLocation);
+    if (!normalizedOutput.ok)
+        return { ok: false, diagnostics: [normalizedOutput.diagnostic] };
+    const { source, items } = options;
+    const annotationRequestId = buildVisualAnnotationRequestIdentity(source, items, options.supersedesAnnotationId);
+    const annotationId = buildVisualAnnotationInstanceIdentity(annotationRequestId);
+    const overlaySha256 = computeVisualAnnotationOverlaySha256(renderVisualAnnotationOverlaySvg(source, items));
+    const artifact = {
+        artifactKind: VISUAL_ANNOTATION_ARTIFACT_KIND,
+        schemaVersion: VISUAL_ANNOTATION_SCHEMA_VERSION,
+        annotationRequestId,
+        annotationId,
+        ...(options.supersedesAnnotationId === undefined ? {} : { supersedesAnnotationId: options.supersedesAnnotationId }),
+        producer: getProducerInfo(),
+        source,
+        items,
+        overlay: {
+            path: VISUAL_ANNOTATION_OVERLAY_PATH,
+            format: 'svg',
+            width: source.coordinateSpace.width,
+            height: source.coordinateSpace.height,
+            sha256: overlaySha256,
+        },
+        provenance: {
+            createdAt: new Date().toISOString(),
+            origin: 'viewer',
+        },
+    };
+    const persisted = await writeVisualAnnotationArtifact(artifact, normalizedOutput.value, options.cwd === undefined ? {} : { cwd: options.cwd });
+    if (!persisted.ok)
+        return { ok: false, diagnostics: persisted.diagnostics };
+    return {
+        ok: true,
+        annotationId,
+        annotationRequestId,
+        artifactRoot: persisted.artifactRoot,
+        manifestPath: persisted.manifestPath,
+        overlayPath: persisted.overlayPath,
+    };
+}
+//# sourceMappingURL=visualAnnotationPersistenceService.js.map

package/dist/application/visualAnnotationPersistenceService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"visualAnnotationPersistenceService.js","sourceRoot":"","sources":["../../src/application/visualAnnotationPersistenceService.ts"],"names":[],"mappings":"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"}