mewkit 1.14.1 → 1.16.0

package/dist/visual-plan/__fixtures__/valid-plan.js

@@ -0,0 +1,79 @@
+/**
+ * Canonical valid `visual-plan/v1` fixture (as a builder returning a fresh deep
+ * copy each call, so a test can mutate one failure class without touching
+ * others). Source hashes are left empty here — the test helper stamps them from
+ * the on-disk plan.md/phase files so the "valid" case passes freshness.
+ *
+ * The wireframe HTML uses only the allowed `.wf-*` structural vocabulary and no
+ * form controls, so it survives the reject-mode sanitizer unchanged.
+ */
+const SAFE_LOGIN_HTML = '<section class="wf-screen"><header class="wf-topbar"><h1>Sign in</h1></header>' +
+    '<div class="wf-form"><label>Email</label><div class="wf-input"></div>' +
+    '<label>Password</label><div class="wf-input"></div>' +
+    '<a href="#submit" class="wf-button">Continue</a></div></section>';
+const SAFE_ERROR_HTML = '<section class="wf-screen"><header class="wf-topbar"><h1>Sign in</h1></header>' +
+    '<p class="wf-error">Incorrect email or password.</p>' +
+    '<div class="wf-form"><label>Email</label><div class="wf-input"></div></div></section>';
+/** A structurally + referentially valid artifact. Deep-copied on every call. */
+export function makeValidPlan() {
+    return JSON.parse(JSON.stringify(BASE));
+}
+/** Markdown the fixture's source hashes are computed against. */
+export const FIXTURE_PLAN_MD = "# Sample Plan\n\nAuth flow.\n";
+export const FIXTURE_PHASE_MD = "---\nphase: 1\n---\n\n# Phase 1\n\nLogin screen.\n";
+const BASE = {
+    schemaVersion: "visual-plan/v1",
+    id: "sample-plan",
+    revision: 0,
+    source: { planPath: "plan.md", planHash: "", phaseHashes: {} },
+    uiCoverage: {
+        surfaces: [
+            {
+                id: "s-auth",
+                label: "Authentication",
+                states: [
+                    { id: "st-login-default", label: "Login (default)", frameIds: ["fr-login"], sourceRefIds: ["ref-login-code"] },
+                    { id: "st-login-error", label: "Login (error)", frameIds: ["fr-login-error"], sourceRefIds: [] },
+                    { id: "st-forgot", label: "Forgot password", frameIds: [], sourceRefIds: [], omitted: { reason: "out-of-scope" } },
+                    { id: "st-2fa", label: "2FA", frameIds: [], sourceRefIds: [], omitted: { reason: "equivalent-layout", representedBy: "st-login-default" } },
+                ],
+            },
+        ],
+    },
+    canvas: {
+        lanes: [{ id: "lane-primary", label: "Primary flow" }],
+        frames: [
+            {
+                id: "fr-login",
+                label: "Login",
+                surface: "browser",
+                laneId: "lane-primary",
+                order: 0,
+                changeMode: "current",
+                coverageStateIds: ["st-login-default"],
+                sourceRefIds: ["ref-login-code"],
+                wireframe: { format: "semantic-html", html: SAFE_LOGIN_HTML },
+            },
+            {
+                id: "fr-login-error",
+                label: "Login error",
+                surface: "browser",
+                laneId: "lane-primary",
+                order: 1,
+                changeMode: "target",
+                coverageStateIds: ["st-login-error"],
+                sourceRefIds: [],
+                wireframe: { format: "semantic-html", html: SAFE_ERROR_HTML },
+            },
+        ],
+        connectors: [{ id: "c-login-error", from: "fr-login", to: "fr-login-error", label: "invalid credentials" }],
+        annotations: [{ id: "an-note-1", kind: "note", text: "Primary CTA", targetId: "fr-login", placement: "top" }],
+    },
+    documentBlocks: [{ id: "db-mechanics", title: "Mechanics", body: "Session cookie set on success." }],
+    sourceRefs: [
+        { id: "ref-login-code", kind: "code", ref: "src/features/auth/login.tsx" },
+        { id: "ref-new-2fa", kind: "plan-requirement", ref: "phase-01#2fa" },
+    ],
+    review: { status: "draft", approvedRevision: null, approvedAt: null, pendingFeedbackBatchIds: [] },
+};
+//# sourceMappingURL=valid-plan.js.map

package/dist/visual-plan/__fixtures__/valid-plan.js.map

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

package/dist/visual-plan/application/apply-feedback.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Apply-feedback CLI mechanics (deterministic half of the Phase-6 loop).
+ *
+ * The AGENT (the mk:visual-plan skill) classifies + applies each operation
+ * (visual-only → CLI patch; plan-semantic → Markdown edit; implementation →
+ * deferred; ambiguous → ask). This module owns only the deterministic guards:
+ *   - `checkBatchFresh` — STOP before ANY mutation if the batch's baseRevision/
+ *     baseHash no longer match the artifact (no auto-merge onto drifted state).
+ *   - `recordResolution` — write the per-op receipt write-once (refuse a second
+ *     apply of the same batch). Receipt existence is the "resolved" marker.
+ */
+export interface FreshnessResult {
+    ok: boolean;
+    stale?: boolean;
+    reason?: string;
+}
+/** Verify the batch still applies to the CURRENT artifact (pre-apply gate). */
+export declare function checkBatchFresh(planDir: string, batchId: string): FreshnessResult;
+export interface RecordResult {
+    ok: boolean;
+    receiptPath?: string;
+    reopenCommand?: string;
+    error?: string;
+}
+/**
+ * Write the resolution receipt (agent supplies per-op outcomes). Refuses a
+ * double-apply. `resolvedAtRevision` is the artifact's CURRENT revision (after
+ * the agent applied ops). Returns the reopen command for re-review.
+ */
+export declare function recordResolution(planDir: string, batchId: string, entries: unknown): RecordResult;
+//# sourceMappingURL=apply-feedback.d.ts.map

package/dist/visual-plan/application/apply-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-feedback.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/apply-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAYH,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAcjF;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,YAAY,CAiCjG"}

package/dist/visual-plan/application/apply-feedback.js

@@ -0,0 +1,85 @@
+/**
+ * Apply-feedback CLI mechanics (deterministic half of the Phase-6 loop).
+ *
+ * The AGENT (the mk:visual-plan skill) classifies + applies each operation
+ * (visual-only → CLI patch; plan-semantic → Markdown edit; implementation →
+ * deferred; ambiguous → ask). This module owns only the deterministic guards:
+ *   - `checkBatchFresh` — STOP before ANY mutation if the batch's baseRevision/
+ *     baseHash no longer match the artifact (no auto-merge onto drifted state).
+ *   - `recordResolution` — write the per-op receipt write-once (refuse a second
+ *     apply of the same batch). Receipt existence is the "resolved" marker.
+ */
+import { readArtifactRaw, artifactPath, writeArtifact } from "../infrastructure/visual-plan-repository.js";
+import { etagFromFile } from "../../local-web/etag.js";
+import { VisualPlanSchema } from "../domain/schemas.js";
+import { ResolutionReceiptSchema } from "../domain/feedback-schemas.js";
+import { readBatch } from "../infrastructure/feedback-repository.js";
+import { receiptExists, writeReceipt } from "../infrastructure/receipt-repository.js";
+import { buildVisualBlock, writeVisualBlock } from "../infrastructure/plan-state.js";
+import { isValidFeedbackBatchId } from "../domain/ids.js";
+import { nowIso } from "./clock.js";
+/** Verify the batch still applies to the CURRENT artifact (pre-apply gate). */
+export function checkBatchFresh(planDir, batchId) {
+    if (!isValidFeedbackBatchId(batchId))
+        return { ok: false, reason: `invalid batch id: ${JSON.stringify(batchId)}` };
+    const batch = readBatch(planDir, batchId);
+    if (!batch)
+        return { ok: false, reason: `batch ${batchId} not found or invalid` };
+    if (receiptExists(planDir, batchId))
+        return { ok: false, reason: `batch ${batchId} already resolved` };
+    const read = readArtifactRaw(planDir);
+    if (read.error)
+        return { ok: false, reason: "no visual artifact" };
+    const parsed = VisualPlanSchema.safeParse(read.raw);
+    if (!parsed.success)
+        return { ok: false, reason: "artifact not schema-valid" };
+    const currentHash = etagFromFile(artifactPath(planDir));
+    if (batch.baseRevision !== parsed.data.revision || batch.baseHash !== currentHash) {
+        return { ok: false, stale: true, reason: `batch base (rev ${batch.baseRevision}) no longer matches artifact (rev ${parsed.data.revision}) — regenerate feedback` };
+    }
+    return { ok: true };
+}
+/**
+ * Write the resolution receipt (agent supplies per-op outcomes). Refuses a
+ * double-apply. `resolvedAtRevision` is the artifact's CURRENT revision (after
+ * the agent applied ops). Returns the reopen command for re-review.
+ */
+export function recordResolution(planDir, batchId, entries) {
+    if (!isValidFeedbackBatchId(batchId))
+        return { ok: false, error: `invalid batch id: ${JSON.stringify(batchId)}` };
+    const batch = readBatch(planDir, batchId);
+    if (!batch)
+        return { ok: false, error: `batch ${batchId} not found or invalid` };
+    if (receiptExists(planDir, batchId))
+        return { ok: false, error: `batch ${batchId} already resolved (receipt exists)` };
+    const read = readArtifactRaw(planDir);
+    if (read.error)
+        return { ok: false, error: "no visual artifact" };
+    const parsed = VisualPlanSchema.safeParse(read.raw);
+    if (!parsed.success)
+        return { ok: false, error: "artifact not schema-valid" };
+    const receipt = ResolutionReceiptSchema.safeParse({
+        schemaVersion: "visual-feedback-receipt/v1",
+        batchId,
+        planId: parsed.data.id,
+        baseRevision: batch.baseRevision,
+        resolvedAtRevision: parsed.data.revision,
+        resolvedAt: nowIso(),
+        entries,
+    });
+    if (!receipt.success)
+        return { ok: false, error: `invalid receipt entries: ${receipt.error.issues[0]?.message ?? "schema"}` };
+    if (!writeReceipt(planDir, receipt.data))
+        return { ok: false, error: `receipt for ${batchId} already exists` };
+    // Clear the batch from the pending list (it is now resolved). When none remain,
+    // drop review back to `draft` so the plan is eligible for re-review + approve.
+    const plan = parsed.data;
+    plan.review.pendingFeedbackBatchIds = plan.review.pendingFeedbackBatchIds.filter((x) => x !== batchId);
+    if (plan.review.pendingFeedbackBatchIds.length === 0 && plan.review.status === "feedback-pending") {
+        plan.review.status = "draft";
+    }
+    writeArtifact(planDir, plan);
+    writeVisualBlock(planDir, buildVisualBlock(plan, planDir));
+    return { ok: true, receiptPath: `visual-plan/resolutions/${batchId}.json`, reopenCommand: `mewkit visual-plan edit ${planDir}` };
+}
+//# sourceMappingURL=apply-feedback.js.map

package/dist/visual-plan/application/apply-feedback.js.map

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

package/dist/visual-plan/application/apply-patch-op.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Apply a single typed visual patch op to a parsed plan (mutates in place).
+ *
+ * Returns an error message when the op cannot apply (unknown target, duplicate
+ * append, unknown wireframe field); the orchestrator rejects the patch and never
+ * writes. Structural/coverage/safety re-validation is the orchestrator's job —
+ * this function only performs the mutation and the immediate target checks.
+ */
+import type { PatchOp } from "../domain/patches.js";
+import type { VisualPlan } from "../domain/schemas.js";
+/** Mutate `plan` by `op`. Returns null on success, or an error message. */
+export declare function applyPatchOp(plan: VisualPlan, op: PatchOp): string | null;
+//# sourceMappingURL=apply-patch-op.d.ts.map

package/dist/visual-plan/application/apply-patch-op.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-patch-op.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/apply-patch-op.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,sBAAsB,CAAC;AAGnE,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAiDzE"}

package/dist/visual-plan/application/apply-patch-op.js

@@ -0,0 +1,72 @@
+/**
+ * Apply a single typed visual patch op to a parsed plan (mutates in place).
+ *
+ * Returns an error message when the op cannot apply (unknown target, duplicate
+ * append, unknown wireframe field); the orchestrator rejects the patch and never
+ * writes. Structural/coverage/safety re-validation is the orchestrator's job —
+ * this function only performs the mutation and the immediate target checks.
+ */
+import { editWireframeField } from "../infrastructure/wireframe-sanitizer.js";
+/** Mutate `plan` by `op`. Returns null on success, or an error message. */
+export function applyPatchOp(plan, op) {
+    switch (op.type) {
+        case "move-frame-lane": {
+            const frame = plan.canvas.frames.find((f) => f.id === op.frameId);
+            if (!frame)
+                return `unknown frame "${op.frameId}"`;
+            if (!plan.canvas.lanes.some((l) => l.id === op.laneId))
+                return `unknown lane "${op.laneId}"`;
+            frame.laneId = op.laneId;
+            return null;
+        }
+        case "reorder-frame": {
+            const frame = plan.canvas.frames.find((f) => f.id === op.frameId);
+            if (!frame)
+                return `unknown frame "${op.frameId}"`;
+            frame.order = op.order;
+            return null;
+        }
+        case "update-annotation": {
+            const a = plan.canvas.annotations.find((x) => x.id === op.annotationId);
+            if (!a)
+                return `unknown annotation "${op.annotationId}"`;
+            if (op.text !== undefined)
+                a.text = op.text;
+            if (op.placement !== undefined)
+                a.placement = op.placement;
+            if (op.points !== undefined)
+                a.points = op.points;
+            return null;
+        }
+        case "append-annotation": {
+            const anno = op.annotation;
+            if (plan.canvas.annotations.some((x) => x.id === anno.id))
+                return `annotation id "${anno.id}" already exists`;
+            plan.canvas.annotations.push(anno);
+            return null;
+        }
+        case "remove-annotation": {
+            const before = plan.canvas.annotations.length;
+            plan.canvas.annotations = plan.canvas.annotations.filter((x) => x.id !== op.annotationId);
+            return plan.canvas.annotations.length === before ? `unknown annotation "${op.annotationId}"` : null;
+        }
+        case "update-connector-label": {
+            const c = plan.canvas.connectors.find((x) => x.id === op.connectorId);
+            if (!c)
+                return `unknown connector "${op.connectorId}"`;
+            c.label = op.label;
+            return null;
+        }
+        case "update-wireframe-field": {
+            const frame = plan.canvas.frames.find((f) => f.id === op.frameId);
+            if (!frame)
+                return `unknown frame "${op.frameId}"`;
+            const edited = editWireframeField(frame.wireframe.html, op.fieldId, op.text);
+            if (edited === null)
+                return `no editable field "wf-field-${op.fieldId}" in frame "${op.frameId}"`;
+            frame.wireframe.html = edited;
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=apply-patch-op.js.map

package/dist/visual-plan/application/apply-patch-op.js.map

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

package/dist/visual-plan/application/approve.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `approve` — the deterministic post-Gate-1 transition (moved here from Phase 6
+ * per red-team C1 so Gate 1 is satisfiable from the first Phase-3 release).
+ *
+ * The CLI is the SINGLE writer of `review.status`. Approval is refused unless
+ * EVERY precondition holds: the artifact fully validates (schema, cross-refs,
+ * coverage with `unresolved === 0`, safe HTML, fresh source hashes), there is
+ * no pending feedback batch, and the requested `--revision` matches the
+ * artifact's current revision (so approval is pinned to the exact reviewed
+ * state). On success it stamps `review` and refreshes the `.plan-state` pointer.
+ * No skill ever writes an interim approval.
+ */
+export interface ApproveResult {
+    ok: boolean;
+    revision: number;
+    /** Human-readable reasons approval was refused; empty on success. */
+    failedPreconditions: string[];
+}
+/**
+ * Approve the artifact at `planDir` for exactly `revision`. Returns the refused
+ * preconditions instead of throwing, so the CLI can list them and exit non-zero.
+ */
+export declare function approvePlan(planDir: string, revision: number): ApproveResult;
+//# sourceMappingURL=approve.d.ts.map

package/dist/visual-plan/application/approve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/approve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,CA+B5E"}

package/dist/visual-plan/application/approve.js

@@ -0,0 +1,53 @@
+/**
+ * `approve` — the deterministic post-Gate-1 transition (moved here from Phase 6
+ * per red-team C1 so Gate 1 is satisfiable from the first Phase-3 release).
+ *
+ * The CLI is the SINGLE writer of `review.status`. Approval is refused unless
+ * EVERY precondition holds: the artifact fully validates (schema, cross-refs,
+ * coverage with `unresolved === 0`, safe HTML, fresh source hashes), there is
+ * no pending feedback batch, and the requested `--revision` matches the
+ * artifact's current revision (so approval is pinned to the exact reviewed
+ * state). On success it stamps `review` and refreshes the `.plan-state` pointer.
+ * No skill ever writes an interim approval.
+ */
+import { validatePlan } from "./validate-plan.js";
+import { writeArtifact } from "../infrastructure/visual-plan-repository.js";
+import { buildVisualBlock, writeVisualBlock } from "../infrastructure/plan-state.js";
+import { listReceipts } from "../infrastructure/receipt-repository.js";
+import { nowIso } from "./clock.js";
+/**
+ * Approve the artifact at `planDir` for exactly `revision`. Returns the refused
+ * preconditions instead of throwing, so the CLI can list them and exit non-zero.
+ */
+export function approvePlan(planDir, revision) {
+    const failed = [];
+    const result = validatePlan(planDir);
+    if (!result.ok || !result.plan) {
+        for (const e of result.errors)
+            failed.push(`${e.path}: ${e.message} [${e.code}]`);
+        return { ok: false, revision, failedPreconditions: failed };
+    }
+    const plan = result.plan;
+    if (plan.revision !== revision) {
+        failed.push(`--revision ${revision} does not match artifact revision ${plan.revision}`);
+    }
+    if (plan.review.pendingFeedbackBatchIds.length > 0) {
+        failed.push(`cannot approve with ${plan.review.pendingFeedbackBatchIds.length} pending feedback batch(es)`);
+    }
+    // Receipt-aware refusal (Phase 6): a resolution receipt at the CURRENT revision
+    // with any unresolved semantic op means the feedback was not fully applied.
+    for (const receipt of listReceipts(planDir)) {
+        if (receipt.resolvedAtRevision === revision && receipt.entries.some((e) => e.outcome === "unresolved")) {
+            failed.push(`resolution receipt ${receipt.batchId} has unresolved operations at revision ${revision}`);
+        }
+    }
+    if (failed.length > 0)
+        return { ok: false, revision, failedPreconditions: failed };
+    plan.review.status = "approved";
+    plan.review.approvedRevision = revision;
+    plan.review.approvedAt = nowIso();
+    writeArtifact(planDir, plan);
+    writeVisualBlock(planDir, buildVisualBlock(plan, planDir));
+    return { ok: true, revision, failedPreconditions: [] };
+}
+//# sourceMappingURL=approve.js.map

package/dist/visual-plan/application/approve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"approve.js","sourceRoot":"","sources":["../../../src/visual-plan/application/approve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACrF,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AASpC;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,QAAgB;IAC5D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAErC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,IAAI,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,cAAc,QAAQ,qCAAqC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,uBAAuB,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,MAAM,6BAA6B,CAAC,CAAC;IAC7G,CAAC;IACD,gFAAgF;IAChF,4EAA4E;IAC5E,KAAK,MAAM,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7C,IAAI,OAAO,CAAC,kBAAkB,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,YAAY,CAAC,EAAE,CAAC;YACxG,MAAM,CAAC,IAAI,CAAC,sBAAsB,OAAO,CAAC,OAAO,0CAA0C,QAAQ,EAAE,CAAC,CAAC;QACxG,CAAC;IACF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAEnF,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,UAAU,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;IAClC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,mBAAmB,EAAE,EAAE,EAAE,CAAC;AACxD,CAAC"}

package/dist/visual-plan/application/clock.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Timestamp source, isolated so tests can assert format without freezing time.
+ * Kept trivial on purpose — the only reason it is a module is to give approval
+ * and rehash a single, mockable clock seam.
+ */
+/** Current time as an ISO-8601 string. */
+export declare function nowIso(): string;
+//# sourceMappingURL=clock.d.ts.map

package/dist/visual-plan/application/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/clock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0CAA0C;AAC1C,wBAAgB,MAAM,IAAI,MAAM,CAE/B"}

package/dist/visual-plan/application/clock.js

@@ -0,0 +1,10 @@
+/**
+ * Timestamp source, isolated so tests can assert format without freezing time.
+ * Kept trivial on purpose — the only reason it is a module is to give approval
+ * and rehash a single, mockable clock seam.
+ */
+/** Current time as an ISO-8601 string. */
+export function nowIso() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=clock.js.map

package/dist/visual-plan/application/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../../src/visual-plan/application/clock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0CAA0C;AAC1C,MAAM,UAAU,MAAM;IACrB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACjC,CAAC"}

package/dist/visual-plan/application/export-plan.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `export --format html` — render the CURRENT artifact into ONE self-contained,
+ * offline `plan.html`. The output carries the artifact's `review.status` in its
+ * header, so a draft export is never mistaken for final; the plan-creator flow
+ * (Step 8b) calls this only AFTER approval, making that export the canonical one.
+ *
+ * Safety: every plan-sourced string is HTML-escaped; wireframes are re-sanitized
+ * before inlining; there are no `<script>` tags and no auto-fetching elements
+ * (no `img`/`src`/`link`), so the page opens with zero network requests. A
+ * wireframe `<a href>` to a remote host is permitted but inert until clicked.
+ */
+export interface ExportResult {
+    ok: boolean;
+    html?: string;
+    error?: string;
+}
+/** Build the self-contained plan.html string from the artifact at `planDir`. */
+export declare function exportPlanHtml(planDir: string): ExportResult;
+//# sourceMappingURL=export-plan.d.ts.map

package/dist/visual-plan/application/export-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-plan.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/export-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAqCD,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,CAS5D"}

package/dist/visual-plan/application/export-plan.js

@@ -0,0 +1,59 @@
+/**
+ * `export --format html` — render the CURRENT artifact into ONE self-contained,
+ * offline `plan.html`. The output carries the artifact's `review.status` in its
+ * header, so a draft export is never mistaken for final; the plan-creator flow
+ * (Step 8b) calls this only AFTER approval, making that export the canonical one.
+ *
+ * Safety: every plan-sourced string is HTML-escaped; wireframes are re-sanitized
+ * before inlining; there are no `<script>` tags and no auto-fetching elements
+ * (no `img`/`src`/`link`), so the page opens with zero network requests. A
+ * wireframe `<a href>` to a remote host is permitted but inert until clicked.
+ */
+import { readArtifactRaw } from "../infrastructure/visual-plan-repository.js";
+import { sanitizeWireframeHtml } from "../infrastructure/wireframe-sanitizer.js";
+import { computeCoverage } from "../domain/coverage.js";
+import { VisualPlanSchema } from "../domain/schemas.js";
+/** HTML-entity-encode a plan-sourced string for safe text/attribute placement. */
+function esc(s) {
+    return s.replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" })[c]);
+}
+function coverageSection(plan) {
+    const { summary } = computeCoverage(plan);
+    const rows = plan.uiCoverage.surfaces
+        .flatMap((s) => s.states.map((st) => `<tr><td>${esc(s.label ?? s.id)}</td><td>${esc(st.label ?? st.id)}</td><td>${st.frameIds.length > 0 ? "framed" : st.omitted ? esc(st.omitted.reason) : "unresolved"}</td></tr>`))
+        .join("");
+    return `<h2>Coverage</h2><p class="vp-sum">${summary.resolved} resolved · ${summary.planned} planned · ${summary.omitted} omitted · ${summary.unresolved} unresolved</p><table><thead><tr><th>Surface</th><th>State</th><th>Closure</th></tr></thead><tbody>${rows}</tbody></table>`;
+}
+function framesSection(plan) {
+    const cards = plan.canvas.frames
+        .map((f) => `<article class="vp-frame"><header><strong>${esc(f.label)}</strong> <span class="vp-badge">${esc(f.surface)} · ${esc(f.changeMode)}</span></header><div class="wf-root">${sanitizeWireframeHtml(f.wireframe.html)}</div></article>`)
+        .join("");
+    return `<h2>Frames</h2><div class="vp-frames">${cards}</div>`;
+}
+function docsSection(plan) {
+    if (plan.documentBlocks.length === 0)
+        return "";
+    const items = plan.documentBlocks.map((b) => `<li>${b.title ? `<strong>${esc(b.title)}:</strong> ` : ""}${esc(b.body)}</li>`).join("");
+    return `<h2>Mechanics</h2><ul>${items}</ul>`;
+}
+const STYLE = `body{font:14px/1.5 system-ui,sans-serif;margin:0;padding:24px;background:#fff;color:#1c2430}
+h1{margin:0 0 4px}h2{margin:24px 0 8px;border-bottom:1px solid #d7dbe0;padding-bottom:4px}
+table{border-collapse:collapse;width:100%}th,td{border:1px solid #d7dbe0;padding:4px 8px;text-align:left;font-size:13px}
+.vp-sum{color:#64707d}.vp-frames{display:flex;flex-wrap:wrap;gap:16px}
+.vp-frame{border:1px solid #d7dbe0;border-radius:8px;overflow:hidden;width:340px}
+.vp-frame header{padding:6px 10px;border-bottom:1px solid #d7dbe0;background:#f4f5f7}
+.vp-badge{color:#64707d;font-size:12px}.wf-root{padding:10px}.wf-root .wf-button{display:inline-block;padding:6px 12px;background:#3563e9;color:#fff;border-radius:6px;text-decoration:none}
+.wf-root .wf-input{height:30px;border:1px solid #d7dbe0;border-radius:6px;background:#eef1f4}.wf-root .wf-error{color:#c0392b}`;
+/** Build the self-contained plan.html string from the artifact at `planDir`. */
+export function exportPlanHtml(planDir) {
+    const read = readArtifactRaw(planDir);
+    if (read.error)
+        return { ok: false, error: read.error.message };
+    const parsed = VisualPlanSchema.safeParse(read.raw);
+    if (!parsed.success)
+        return { ok: false, error: "artifact must be schema-valid to export" };
+    const plan = parsed.data;
+    const html = `<!doctype html><html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>${esc(plan.id)} — visual plan</title><style>${STYLE}</style></head><body><h1>${esc(plan.id)}</h1><p class="vp-sum">revision ${plan.revision} · review ${esc(plan.review.status)}</p>${coverageSection(plan)}${framesSection(plan)}${docsSection(plan)}</body></html>\n`;
+    return { ok: true, html };
+}
+//# sourceMappingURL=export-plan.js.map

package/dist/visual-plan/application/export-plan.js.map

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

package/dist/visual-plan/application/patch-plan.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Patch orchestrator — the single serialized writer behind PATCH /api/visual-plan.
+ *
+ * Flow: read → optimistic-concurrency check (If-Match ETag) → apply the typed op
+ * → bump revision + CLEAR approval → re-validate the mutated plan IN MEMORY →
+ * atomic write → return the new ETag. A stale ETag stops before any mutation
+ * (409). A patch that would make the artifact invalid/unsafe is rejected and
+ * NOT written, so the on-disk artifact is always valid. Approval is cleared on
+ * every accepted visual mutation (lane/order/annotation/connector/field) —
+ * re-review + re-approve must follow.
+ */
+import type { PatchOp } from "../domain/patches.js";
+import type { ValidationError } from "../domain/errors.js";
+export type PatchStatus = "ok" | "stale" | "missing" | "invalid-artifact" | "op-rejected" | "invalid-result";
+export interface PatchResult {
+    ok: boolean;
+    status: PatchStatus;
+    revision?: number;
+    etag?: string;
+    currentEtag?: string;
+    message?: string;
+    errors?: ValidationError[];
+}
+/** Apply `op` to the artifact at `planDir` under optimistic concurrency (`ifMatch`). */
+export declare function patchPlan(planDir: string, op: PatchOp, ifMatch?: string): PatchResult;
+//# sourceMappingURL=patch-plan.d.ts.map

package/dist/visual-plan/application/patch-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-plan.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/patch-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAIpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,MAAM,WAAW,GAAG,IAAI,GAAG,OAAO,GAAG,SAAS,GAAG,kBAAkB,GAAG,aAAa,GAAG,gBAAgB,CAAC;AAE7G,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,CA0BrF"}

package/dist/visual-plan/application/patch-plan.js

@@ -0,0 +1,48 @@
+/**
+ * Patch orchestrator — the single serialized writer behind PATCH /api/visual-plan.
+ *
+ * Flow: read → optimistic-concurrency check (If-Match ETag) → apply the typed op
+ * → bump revision + CLEAR approval → re-validate the mutated plan IN MEMORY →
+ * atomic write → return the new ETag. A stale ETag stops before any mutation
+ * (409). A patch that would make the artifact invalid/unsafe is rejected and
+ * NOT written, so the on-disk artifact is always valid. Approval is cleared on
+ * every accepted visual mutation (lane/order/annotation/connector/field) —
+ * re-review + re-approve must follow.
+ */
+import { readArtifactRaw, writeArtifact, artifactPath } from "../infrastructure/visual-plan-repository.js";
+import { etagFromFile } from "../../local-web/etag.js";
+import { VisualPlanSchema } from "../domain/schemas.js";
+import { applyPatchOp } from "./apply-patch-op.js";
+import { validateParsed } from "./validate-plan.js";
+import { buildVisualBlock, writeVisualBlock } from "../infrastructure/plan-state.js";
+/** Apply `op` to the artifact at `planDir` under optimistic concurrency (`ifMatch`). */
+export function patchPlan(planDir, op, ifMatch) {
+    const currentEtag = etagFromFile(artifactPath(planDir));
+    if (currentEtag === null)
+        return { ok: false, status: "missing" };
+    if (ifMatch !== undefined && ifMatch !== currentEtag)
+        return { ok: false, status: "stale", currentEtag };
+    const read = readArtifactRaw(planDir);
+    if (read.error)
+        return { ok: false, status: "missing" };
+    const parsed = VisualPlanSchema.safeParse(read.raw);
+    if (!parsed.success)
+        return { ok: false, status: "invalid-artifact" };
+    const plan = parsed.data;
+    const opError = applyPatchOp(plan, op);
+    if (opError)
+        return { ok: false, status: "op-rejected", message: opError };
+    // Every accepted visual mutation invalidates approval and advances the revision.
+    plan.revision += 1;
+    if (plan.review.status === "approved")
+        plan.review.status = "draft";
+    plan.review.approvedRevision = null;
+    plan.review.approvedAt = null;
+    const { errors } = validateParsed(plan, planDir);
+    if (errors.length > 0)
+        return { ok: false, status: "invalid-result", errors };
+    writeArtifact(planDir, plan);
+    writeVisualBlock(planDir, buildVisualBlock(plan, planDir));
+    return { ok: true, status: "ok", revision: plan.revision, etag: etagFromFile(artifactPath(planDir)) ?? undefined };
+}
+//# sourceMappingURL=patch-plan.js.map

package/dist/visual-plan/application/patch-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch-plan.js","sourceRoot":"","sources":["../../../src/visual-plan/application/patch-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,6CAA6C,CAAC;AAC3G,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAerF,wFAAwF;AACxF,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,EAAW,EAAE,OAAgB;IACvE,MAAM,WAAW,GAAG,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAClE,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,WAAW;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAEzG,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IAEzB,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACvC,IAAI,OAAO;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAE3E,iFAAiF;IACjF,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;IACnB,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU;QAAE,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACpC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC;IAE9B,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE9E,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC7B,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;AACpH,CAAC"}