mewkit 1.15.0 → 1.16.0

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"}

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

@@ -0,0 +1,24 @@
+/**
+ * `prepare-feedback` — freeze the accumulated semantic operations into an
+ * immutable `visual-feedback/v1` batch and return the Copy Command.
+ *
+ * The SERVER is authoritative for the base: `baseRevision` + `baseHash` are
+ * stamped from the CURRENT artifact at persist time (not trusted from the
+ * client), so a batch always pins the exact reviewed state. The batch is
+ * write-once; the Copy Command is a repo-relative `/mk:visual-plan apply-feedback`
+ * a fresh agent session can run. Timestamps use the wall clock (this is a normal
+ * CLI/server runtime, not a workflow script).
+ */
+export interface PrepareResult {
+    ok: boolean;
+    batchId?: string;
+    copyCommand?: string;
+    error?: string;
+}
+/**
+ * Build + persist an immutable feedback batch from `operations`. Returns the
+ * batch id + Copy Command, or an error (empty/invalid operations, missing
+ * artifact, id collision).
+ */
+export declare function prepareFeedback(planDir: string, operations: unknown[]): PrepareResult;
+//# sourceMappingURL=prepare-feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-feedback.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/application/prepare-feedback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAWH,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AASD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,aAAa,CAsCrF"}

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

@@ -0,0 +1,70 @@
+/**
+ * `prepare-feedback` — freeze the accumulated semantic operations into an
+ * immutable `visual-feedback/v1` batch and return the Copy Command.
+ *
+ * The SERVER is authoritative for the base: `baseRevision` + `baseHash` are
+ * stamped from the CURRENT artifact at persist time (not trusted from the
+ * client), so a batch always pins the exact reviewed state. The batch is
+ * write-once; the Copy Command is a repo-relative `/mk:visual-plan apply-feedback`
+ * a fresh agent session can run. Timestamps use the wall clock (this is a normal
+ * CLI/server runtime, not a workflow script).
+ */
+import * as crypto from "node:crypto";
+import * as path from "node:path";
+import { readArtifactRaw, writeArtifact, serializeArtifact } from "../infrastructure/visual-plan-repository.js";
+import { computeEtag } from "../../local-web/etag.js";
+import { VisualPlanSchema } from "../domain/schemas.js";
+import { FeedbackBatchSchema } from "../domain/feedback-schemas.js";
+import { writeBatch } from "../infrastructure/feedback-repository.js";
+import { buildVisualBlock, writeVisualBlock } from "../infrastructure/plan-state.js";
+/** Compact `YYYYMMDDHHMMSS` timestamp (≥8 digits, satisfies the batch-id pattern). */
+function stamp() {
+    const d = new Date();
+    const p = (n, w = 2) => String(n).padStart(w, "0");
+    return `${d.getFullYear()}${p(d.getMonth() + 1)}${p(d.getDate())}${p(d.getHours())}${p(d.getMinutes())}${p(d.getSeconds())}`;
+}
+/**
+ * Build + persist an immutable feedback batch from `operations`. Returns the
+ * batch id + Copy Command, or an error (empty/invalid operations, missing
+ * artifact, id collision).
+ */
+export function prepareFeedback(planDir, operations) {
+    const read = readArtifactRaw(planDir);
+    if (read.error)
+        return { ok: false, error: "no visual artifact to attach feedback to" };
+    const parsed = VisualPlanSchema.safeParse(read.raw);
+    if (!parsed.success)
+        return { ok: false, error: "artifact must be schema-valid before preparing feedback" };
+    const plan = parsed.data;
+    // Validate the operations BEFORE mutating the artifact (build a throwaway batch
+    // with a placeholder hash just to run the op schema).
+    const id = `feedback-${stamp()}-${crypto.randomBytes(4).toString("hex")}`;
+    const opCheck = FeedbackBatchSchema.safeParse({
+        schemaVersion: "visual-feedback/v1", id, planId: plan.id, baseRevision: plan.revision,
+        baseHash: "0".repeat(64), createdAt: new Date().toISOString(), operations, status: "open",
+    });
+    if (!opCheck.success)
+        return { ok: false, error: `invalid feedback operations: ${opCheck.error.issues[0]?.message ?? "schema"}` };
+    // Transition review → feedback-pending: outstanding feedback makes the current
+    // approval stale and BLOCKS approve (the "no pending feedback batch" gate).
+    // NOTE: this is effectively single-active-batch — baseHash covers the whole
+    // artifact incl. the pending list, so preparing/resolving another batch marks
+    // earlier open batches stale (fails safe: checkBatchFresh → STOP, never corrupt).
+    plan.review.pendingFeedbackBatchIds = [...new Set([...plan.review.pendingFeedbackBatchIds, id])];
+    plan.review.status = "feedback-pending";
+    plan.review.approvedRevision = null;
+    plan.review.approvedAt = null;
+    // Write the batch BEFORE mutating the artifact, using the EXACT bytes the
+    // artifact write will persist (byte-identical serialization). A crash between
+    // the two writes then leaves at worst an inert STALE batch (recoverable), never
+    // a stranded pending id with no batch (which would permanently block approve).
+    const bytes = serializeArtifact(plan);
+    const batch = FeedbackBatchSchema.safeParse({ ...opCheck.data, baseHash: computeEtag(bytes) });
+    if (!batch.success || !writeBatch(planDir, batch.data))
+        return { ok: false, error: `could not persist batch ${id}` };
+    writeArtifact(planDir, plan);
+    writeVisualBlock(planDir, buildVisualBlock(plan, planDir));
+    const rel = path.relative(process.cwd(), planDir) || ".";
+    return { ok: true, batchId: id, copyCommand: `/mk:visual-plan apply-feedback ${rel} --batch ${id}` };
+}
+//# sourceMappingURL=prepare-feedback.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * `rehash` — the ONLY sanctioned way to refresh pinned source hashes after an
+ * intentional Markdown edit (red-team M1).
+ *
+ * When a human deliberately edits `plan.md`/`phase-*.md`, the artifact's pinned
+ * hashes go stale and validation blocks. `rehash` recomputes them from disk and
+ * — critically — CLEARS any prior approval (an approval was tied to the old
+ * source bytes; refreshing the hash silently would let stale-reviewed content
+ * pass Gate 1). It changes nothing else. Re-review + re-`approve` must follow.
+ */
+import { type ValidationError } from "../domain/errors.js";
+export interface RehashResult {
+    ok: boolean;
+    errors: ValidationError[];
+    clearedApproval: boolean;
+}
+/** Recompute `source.planHash`/`phaseHashes` from disk and clear any approval. */
+export declare function rehashPlan(planDir: string): RehashResult;
+//# sourceMappingURL=rehash.d.ts.map