mewkit 1.15.0 → 1.16.1

package/dist/visual-plan/domain/schemas.d.ts.map

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

package/dist/visual-plan/domain/schemas.js

@@ -0,0 +1,166 @@
+/**
+ * `visual-plan/v1` canonical artifact schema (shape + bounded sizes only).
+ *
+ * This module validates STRUCTURE. Cross-reference integrity (dangling refs,
+ * duplicate ids), coverage closure, HTML safety, and source-hash freshness are
+ * separate deterministic passes (`cross-refs.ts`, `coverage.ts`, the sanitizer,
+ * `hashing.ts`) so each can emit an exact JSON path and a stable code.
+ *
+ * `.passthrough()` is used on the top-level object so a future additive field
+ * survives a read→write round-trip; every nested object stays strict.
+ *
+ * Bounds (red-team: agent-native precedent caps depth/count/size) protect the
+ * validator and the Phase-4 renderer from pathological artifacts.
+ */
+import { z } from "zod";
+import { ENTITY_ID_RE } from "./ids.js";
+/** Concrete caps. Generous for real plans, hard ceilings against abuse. */
+export const CAPS = {
+    FRAMES: 200,
+    CONNECTORS: 400,
+    ANNOTATIONS: 200,
+    LANES: 40,
+    DOCUMENT_BLOCKS: 100,
+    SURFACES: 50,
+    STATES_PER_SURFACE: 100,
+    SOURCE_REFS: 500,
+    HTML_BYTES: 20_000,
+};
+const EntityId = z.string().regex(ENTITY_ID_RE, "invalid id (charset [A-Za-z0-9_-], max 128)");
+export const SURFACE_KINDS = ["browser", "desktop", "mobile", "popover", "panel", "dialog"];
+export const CHANGE_MODES = ["current", "target", "unchanged-context"];
+export const OMISSION_REASONS = [
+    "equivalent-layout",
+    "out-of-scope",
+    "unreachable-after-change",
+    "non-visual-only",
+    "requires-runtime-data",
+    "accepted-risk",
+];
+export const REVIEW_STATUSES = ["draft", "feedback-pending", "approved", "stale"];
+const SourceRefSchema = z
+    .object({
+    id: EntityId,
+    kind: z.enum(["code", "plan-requirement"]),
+    ref: z.string().min(1),
+    note: z.string().optional(),
+})
+    .strict();
+const OmissionSchema = z
+    .object({
+    reason: z.enum(OMISSION_REASONS),
+    representedBy: EntityId.optional(),
+    riskId: z.string().min(1).optional(),
+    note: z.string().optional(),
+})
+    .strict();
+const CoverageStateSchema = z
+    .object({
+    id: EntityId,
+    label: z.string().optional(),
+    frameIds: z.array(EntityId).max(CAPS.FRAMES).default([]),
+    sourceRefIds: z.array(EntityId).max(CAPS.SOURCE_REFS).default([]),
+    omitted: OmissionSchema.optional(),
+})
+    .strict();
+const CoverageSurfaceSchema = z
+    .object({
+    id: EntityId,
+    label: z.string().optional(),
+    states: z.array(CoverageStateSchema).max(CAPS.STATES_PER_SURFACE),
+})
+    .strict();
+const CoverageSummarySchema = z
+    .object({
+    total: z.number().int().nonnegative(),
+    resolved: z.number().int().nonnegative(),
+    planned: z.number().int().nonnegative(),
+    omitted: z.number().int().nonnegative(),
+    unresolved: z.number().int().nonnegative(),
+})
+    .strict();
+const UiCoverageSchema = z
+    .object({
+    surfaces: z.array(CoverageSurfaceSchema).max(CAPS.SURFACES),
+    /** Author totals are IGNORED — always recomputed from states. Optional here. */
+    summary: CoverageSummarySchema.optional(),
+})
+    .strict();
+const WireframeSchema = z
+    .object({
+    format: z.literal("semantic-html"),
+    html: z.string().max(CAPS.HTML_BYTES, `wireframe HTML exceeds ${CAPS.HTML_BYTES} bytes`),
+})
+    .strict();
+const LaneSchema = z
+    .object({ id: EntityId, label: z.string().optional(), kind: z.string().optional() })
+    .strict();
+const FrameSchema = z
+    .object({
+    id: EntityId,
+    label: z.string().min(1),
+    surface: z.enum(SURFACE_KINDS),
+    laneId: EntityId,
+    order: z.number().int(),
+    x: z.number().optional(),
+    y: z.number().optional(),
+    stateKind: z.string().optional(),
+    changeMode: z.enum(CHANGE_MODES),
+    coverageStateIds: z.array(EntityId).max(CAPS.STATES_PER_SURFACE).default([]),
+    sourceRefIds: z.array(EntityId).max(CAPS.SOURCE_REFS).default([]),
+    wireframe: WireframeSchema,
+})
+    .strict();
+const ConnectorSchema = z
+    .object({ id: EntityId, from: EntityId, to: EntityId, label: z.string().optional() })
+    .strict();
+export const AnnotationSchema = z
+    .object({
+    id: EntityId,
+    kind: z.enum(["note", "markup"]),
+    text: z.string().min(1),
+    targetId: EntityId.optional(),
+    placement: z.enum(["top", "right", "bottom", "left"]).optional(),
+    points: z.array(z.object({ x: z.number(), y: z.number() }).strict()).optional(),
+})
+    .strict();
+const CanvasSchema = z
+    .object({
+    lanes: z.array(LaneSchema).max(CAPS.LANES),
+    frames: z.array(FrameSchema).max(CAPS.FRAMES),
+    connectors: z.array(ConnectorSchema).max(CAPS.CONNECTORS),
+    annotations: z.array(AnnotationSchema).max(CAPS.ANNOTATIONS),
+})
+    .strict();
+const DocumentBlockSchema = z
+    .object({ id: EntityId, title: z.string().optional(), body: z.string() })
+    .strict();
+const SourceSchema = z
+    .object({
+    planPath: z.string().min(1),
+    planHash: z.string(),
+    phaseHashes: z.record(z.string(), z.string()),
+})
+    .strict();
+const ReviewSchema = z
+    .object({
+    status: z.enum(REVIEW_STATUSES),
+    approvedRevision: z.number().int().nonnegative().nullable().default(null),
+    approvedAt: z.string().nullable().default(null),
+    pendingFeedbackBatchIds: z.array(z.string()).default([]),
+})
+    .strict();
+export const VisualPlanSchema = z
+    .object({
+    schemaVersion: z.literal("visual-plan/v1"),
+    id: EntityId,
+    revision: z.number().int().nonnegative(),
+    source: SourceSchema,
+    uiCoverage: UiCoverageSchema,
+    canvas: CanvasSchema,
+    documentBlocks: z.array(DocumentBlockSchema).max(CAPS.DOCUMENT_BLOCKS).default([]),
+    sourceRefs: z.array(SourceRefSchema).max(CAPS.SOURCE_REFS).default([]),
+    review: ReviewSchema,
+})
+    .passthrough();
+//# sourceMappingURL=schemas.js.map

package/dist/visual-plan/domain/schemas.js.map

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

package/dist/visual-plan/domain/wireframe-theme.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Shared wireframe theme — the SINGLE source of truth for how sanitized
+ * `.wf-*` semantic HTML looks, consumed by BOTH renderers (same pattern as
+ * sanitizer-config.ts): the studio injects it at boot, `export --format html`
+ * embeds it in the exported page. One theme, two surfaces, no drift.
+ *
+ * Visual language follows the agent-native plan renderer (ISC), re-expressed
+ * for MeowKit's vocabulary: a scoped ink/paper/card/accent token palette with
+ * soft variants, hand-drawn font by DEFAULT (sketchy is the primary register;
+ * `[data-style="clean"]` swaps to the sans stack), 1.4px strokes, 9px radii,
+ * and a `[data-rough-ready]` hook that hides crisp borders once the rough.js
+ * overlay has redrawn them so outlines are never doubled.
+ *
+ * Pure data — no DOM, no imports — so the Node exporter and the Vite bundle
+ * can both consume it.
+ */
+export declare const WIREFRAME_THEME_CSS = "\n/* ---- tokens (scoped to .wf-root; light + dark) ---- */\n.wf-root {\n  --wf-ink: #222b38; --wf-ink-soft: #6b7684; --wf-line: #d3d9e0; --wf-sketch: #94a0ad;\n  --wf-paper: #ffffff; --wf-card: #f6f8fa;\n  --wf-accent: #4c6ef5; --wf-accent-fg: #ffffff; --wf-accent-soft: rgba(76, 110, 245, 0.12);\n  --wf-warn: #d64545; --wf-warn-soft: rgba(214, 69, 69, 0.12); --wf-ok: #2f9e63;\n  --wf-radius: 9px; --wf-stroke: 1.4px;\n  --wf-font-hand: \"Architects Daughter\", \"Comic Sans MS\", \"Bradley Hand\", \"Marker Felt\", cursive;\n  --wf-font-clean: ui-sans-serif, system-ui, -apple-system, \"Segoe UI\", sans-serif;\n  --wf-font: var(--wf-font-hand);\n  background: var(--wf-paper); color: var(--wf-ink);\n  font-family: var(--wf-font); font-size: 14px; line-height: 1.45;\n  padding: 14px; height: 100%; overflow: hidden; position: relative;\n}\n.wf-root, .wf-root * { box-sizing: border-box; min-width: 0; }\n[data-style=\"clean\"] .wf-root { --wf-font: var(--wf-font-clean); }\n@media (prefers-color-scheme: dark) {\n  .wf-root {\n    --wf-ink: #e9edf3; --wf-ink-soft: #93a0ae; --wf-line: #2c3646; --wf-sketch: #5d6a7a;\n    --wf-paper: #171d26; --wf-card: #1e2733;\n    --wf-accent: #7c9aff; --wf-accent-fg: #10141c; --wf-accent-soft: rgba(124, 154, 255, 0.16);\n    --wf-warn: #ef7070; --wf-warn-soft: rgba(239, 112, 112, 0.16); --wf-ok: #52c184;\n  }\n}\n\n/* ---- bare semantic elements ---- */\n.wf-root h1 { font-size: 21px; font-weight: 700; line-height: 1.15; margin: 0 0 8px; }\n.wf-root h2 { font-size: 17px; font-weight: 700; line-height: 1.2; margin: 0 0 6px; }\n.wf-root h3, .wf-root h4, .wf-root h5, .wf-root h6 { font-size: 14px; font-weight: 700; margin: 0 0 4px; }\n.wf-root p { margin: 0 0 8px; }\n.wf-root small { color: var(--wf-ink-soft); font-size: 12.5px; }\n.wf-root a { color: var(--wf-accent); text-decoration: none; }\n.wf-root hr { border: 0; border-top: var(--wf-stroke) solid var(--wf-line); margin: 10px 0; }\n.wf-root ul, .wf-root ol { margin: 0 0 8px; padding-left: 1.2em; }\n.wf-root li { margin: 2px 0; }\n.wf-root label { font-size: 12.5px; font-weight: 700; color: var(--wf-ink-soft); }\n.wf-root blockquote { margin: 0 0 8px; padding: 6px 12px; border-left: 3px solid var(--wf-line); color: var(--wf-ink-soft); }\n.wf-root code, .wf-root pre { font-family: ui-monospace, Menlo, monospace; font-size: 12.5px; background: var(--wf-card); border-radius: 5px; }\n.wf-root pre { padding: 8px 10px; overflow: auto; margin: 0 0 8px; }\n.wf-root table { width: 100%; border-collapse: collapse; margin: 0 0 8px; font-size: 13px; }\n.wf-root th { text-align: left; font-weight: 700; border-bottom: var(--wf-stroke) solid var(--wf-line); padding: 6px 8px; }\n.wf-root td { padding: 6px 8px; border-bottom: 1px solid var(--wf-line); }\n.wf-root figure { margin: 0 0 8px; }\n.wf-root figcaption { font-size: 12.5px; color: var(--wf-ink-soft); }\n\n/* ---- structure ---- */\n.wf-root .wf-screen { display: flex; flex-direction: column; gap: 10px; min-height: 100%; }\n.wf-root .wf-topbar, .wf-root header { display: flex; align-items: center; gap: 10px; border-bottom: var(--wf-stroke) solid var(--wf-line); padding-bottom: 8px; }\n.wf-root .wf-topbar :is(h1, h2, h3, p), .wf-root header :is(h1, h2, h3, p) { margin: 0; }\n.wf-root .wf-content, .wf-root main { display: flex; flex-direction: column; gap: 10px; flex: 1; min-height: 0; }\n.wf-root footer, .wf-root .wf-footer { display: flex; align-items: center; gap: 10px; border-top: var(--wf-stroke) solid var(--wf-line); padding-top: 8px; margin-top: auto; }\n.wf-root nav, .wf-root .wf-nav { display: flex; align-items: center; gap: 12px; }\n.wf-root aside, .wf-root .wf-sidebar { display: flex; flex-direction: column; gap: 8px; border-right: var(--wf-stroke) solid var(--wf-line); padding-right: 10px; }\n.wf-root .wf-row { display: flex; align-items: center; gap: 8px; }\n.wf-root .wf-col { display: flex; flex-direction: column; gap: 8px; }\n.wf-root .wf-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; }\n.wf-root .wf-spacer { flex: 1; }\n\n/* ---- surfaces & controls ---- */\n.wf-root .wf-card, .wf-root .wf-box, .wf-root .wf-panel {\n  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);\n  border-radius: var(--wf-radius); padding: 12px;\n}\n.wf-root .wf-button {\n  display: inline-flex; align-items: center; justify-content: center; gap: 6px;\n  font: inherit; font-weight: 700; color: var(--wf-ink); background: var(--wf-paper);\n  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius);\n  padding: 7px 14px; text-decoration: none; cursor: default; width: fit-content;\n}\n.wf-root .wf-button:is(.primary, .wf-primary) {\n  background: var(--wf-accent); border-color: var(--wf-accent); color: var(--wf-accent-fg);\n}\n.wf-root .wf-input, .wf-root .wf-field, .wf-root .wf-select, .wf-root .wf-textarea {\n  display: flex; align-items: center; min-height: 34px; width: 100%;\n  color: var(--wf-ink-soft); background: var(--wf-card);\n  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius); padding: 6px 10px;\n}\n.wf-root .wf-textarea { min-height: 64px; align-items: flex-start; }\n.wf-root .wf-form { display: flex; flex-direction: column; gap: 8px; }\n.wf-root .wf-checkbox, .wf-root .wf-radio {\n  display: inline-block; width: 15px; height: 15px; flex: 0 0 auto;\n  border: var(--wf-stroke) solid var(--wf-sketch); background: var(--wf-paper);\n}\n.wf-root .wf-checkbox { border-radius: 4px; }\n.wf-root .wf-radio { border-radius: 999px; }\n\n/* ---- chips, badges, status ---- */\n.wf-root :is(.wf-badge, .wf-chip, .wf-pill, .wf-tag) {\n  display: inline-flex; align-items: center; gap: 5px; width: fit-content; max-width: 100%;\n  border: var(--wf-stroke) solid var(--wf-line); border-radius: 999px;\n  padding: 2px 10px; font-size: 12.5px; background: var(--wf-paper);\n}\n.wf-root :is(.wf-badge, .wf-chip, .wf-pill, .wf-tag).accent { border-color: var(--wf-accent); color: var(--wf-accent); background: var(--wf-accent-soft); }\n.wf-root .wf-muted { color: var(--wf-ink-soft); }\n.wf-root .wf-hint { color: var(--wf-ink-soft); font-size: 12.5px; }\n.wf-root .wf-error { color: var(--wf-warn); }\n.wf-root :is(.wf-alert, .wf-banner) { background: var(--wf-warn-soft); border: var(--wf-stroke) solid var(--wf-warn); border-radius: var(--wf-radius); padding: 8px 12px; color: var(--wf-warn); }\n\n/* ---- lists ---- */\n.wf-root .wf-list { list-style: none; margin: 0 0 8px; padding: 0; display: flex; flex-direction: column; gap: 6px; }\n.wf-root .wf-list-item {\n  display: flex; align-items: center; justify-content: space-between; gap: 10px; margin: 0;\n  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);\n  border-radius: var(--wf-radius); padding: 9px 12px;\n}\n\n/* ---- media & placeholders ---- */\n.wf-root :is(.wf-image, .wf-img, .wf-media) {\n  display: block; min-height: 84px; background: var(--wf-card);\n  background-image: linear-gradient(to top right, transparent 49.55%, var(--wf-line) 49.55%, var(--wf-line) 50.45%, transparent 50.45%),\n    linear-gradient(to bottom right, transparent 49.55%, var(--wf-line) 49.55%, var(--wf-line) 50.45%, transparent 50.45%);\n  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius);\n}\n.wf-root .wf-avatar {\n  display: inline-flex; align-items: center; justify-content: center; flex: 0 0 auto;\n  width: 32px; height: 32px; border-radius: 999px; font-size: 12px; font-weight: 700;\n  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);\n}\n.wf-root .wf-loading {\n  display: block; height: 12px; width: 70%; border-radius: 999px; border: 0;\n  background: var(--wf-line);\n}\n@media (prefers-reduced-motion: no-preference) {\n  .wf-root .wf-loading { animation: wf-pulse 1.6s ease-in-out infinite; }\n}\n@keyframes wf-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.55; } }\n\n/* ---- rough handoff: once the overlay has drawn hand-drawn outlines, hide the\n   crisp borders it replaced (fills and text stay) so nothing is doubled. ---- */\n[data-rough-ready=\"true\"] .wf-root :is(\n  .wf-button, .wf-input, .wf-field, .wf-select, .wf-textarea,\n  .wf-card, .wf-box, .wf-panel, .wf-badge, .wf-chip, .wf-pill, .wf-tag,\n  .wf-list-item, .wf-avatar, .wf-image, .wf-img, .wf-media, .wf-alert, .wf-banner,\n  .wf-checkbox, .wf-radio, hr\n) { border-color: transparent !important; }\n";
+/**
+ * Class names the theme MUST style (superset of the generation contract's
+ * common vocabulary). The coverage test asserts each appears in the CSS so a
+ * generated artifact can never render a bare, unstyled block again.
+ */
+export declare const WIREFRAME_THEME_CLASSES: readonly string[];
+//# sourceMappingURL=wireframe-theme.d.ts.map

package/dist/visual-plan/domain/wireframe-theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireframe-theme.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/domain/wireframe-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,mBAAmB,2uQAwI/B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EASpD,CAAC"}

package/dist/visual-plan/domain/wireframe-theme.js

@@ -0,0 +1,169 @@
+/**
+ * Shared wireframe theme — the SINGLE source of truth for how sanitized
+ * `.wf-*` semantic HTML looks, consumed by BOTH renderers (same pattern as
+ * sanitizer-config.ts): the studio injects it at boot, `export --format html`
+ * embeds it in the exported page. One theme, two surfaces, no drift.
+ *
+ * Visual language follows the agent-native plan renderer (ISC), re-expressed
+ * for MeowKit's vocabulary: a scoped ink/paper/card/accent token palette with
+ * soft variants, hand-drawn font by DEFAULT (sketchy is the primary register;
+ * `[data-style="clean"]` swaps to the sans stack), 1.4px strokes, 9px radii,
+ * and a `[data-rough-ready]` hook that hides crisp borders once the rough.js
+ * overlay has redrawn them so outlines are never doubled.
+ *
+ * Pure data — no DOM, no imports — so the Node exporter and the Vite bundle
+ * can both consume it.
+ */
+export const WIREFRAME_THEME_CSS = `
+/* ---- tokens (scoped to .wf-root; light + dark) ---- */
+.wf-root {
+  --wf-ink: #222b38; --wf-ink-soft: #6b7684; --wf-line: #d3d9e0; --wf-sketch: #94a0ad;
+  --wf-paper: #ffffff; --wf-card: #f6f8fa;
+  --wf-accent: #4c6ef5; --wf-accent-fg: #ffffff; --wf-accent-soft: rgba(76, 110, 245, 0.12);
+  --wf-warn: #d64545; --wf-warn-soft: rgba(214, 69, 69, 0.12); --wf-ok: #2f9e63;
+  --wf-radius: 9px; --wf-stroke: 1.4px;
+  --wf-font-hand: "Architects Daughter", "Comic Sans MS", "Bradley Hand", "Marker Felt", cursive;
+  --wf-font-clean: ui-sans-serif, system-ui, -apple-system, "Segoe UI", sans-serif;
+  --wf-font: var(--wf-font-hand);
+  background: var(--wf-paper); color: var(--wf-ink);
+  font-family: var(--wf-font); font-size: 14px; line-height: 1.45;
+  padding: 14px; height: 100%; overflow: hidden; position: relative;
+}
+.wf-root, .wf-root * { box-sizing: border-box; min-width: 0; }
+[data-style="clean"] .wf-root { --wf-font: var(--wf-font-clean); }
+@media (prefers-color-scheme: dark) {
+  .wf-root {
+    --wf-ink: #e9edf3; --wf-ink-soft: #93a0ae; --wf-line: #2c3646; --wf-sketch: #5d6a7a;
+    --wf-paper: #171d26; --wf-card: #1e2733;
+    --wf-accent: #7c9aff; --wf-accent-fg: #10141c; --wf-accent-soft: rgba(124, 154, 255, 0.16);
+    --wf-warn: #ef7070; --wf-warn-soft: rgba(239, 112, 112, 0.16); --wf-ok: #52c184;
+  }
+}
+
+/* ---- bare semantic elements ---- */
+.wf-root h1 { font-size: 21px; font-weight: 700; line-height: 1.15; margin: 0 0 8px; }
+.wf-root h2 { font-size: 17px; font-weight: 700; line-height: 1.2; margin: 0 0 6px; }
+.wf-root h3, .wf-root h4, .wf-root h5, .wf-root h6 { font-size: 14px; font-weight: 700; margin: 0 0 4px; }
+.wf-root p { margin: 0 0 8px; }
+.wf-root small { color: var(--wf-ink-soft); font-size: 12.5px; }
+.wf-root a { color: var(--wf-accent); text-decoration: none; }
+.wf-root hr { border: 0; border-top: var(--wf-stroke) solid var(--wf-line); margin: 10px 0; }
+.wf-root ul, .wf-root ol { margin: 0 0 8px; padding-left: 1.2em; }
+.wf-root li { margin: 2px 0; }
+.wf-root label { font-size: 12.5px; font-weight: 700; color: var(--wf-ink-soft); }
+.wf-root blockquote { margin: 0 0 8px; padding: 6px 12px; border-left: 3px solid var(--wf-line); color: var(--wf-ink-soft); }
+.wf-root code, .wf-root pre { font-family: ui-monospace, Menlo, monospace; font-size: 12.5px; background: var(--wf-card); border-radius: 5px; }
+.wf-root pre { padding: 8px 10px; overflow: auto; margin: 0 0 8px; }
+.wf-root table { width: 100%; border-collapse: collapse; margin: 0 0 8px; font-size: 13px; }
+.wf-root th { text-align: left; font-weight: 700; border-bottom: var(--wf-stroke) solid var(--wf-line); padding: 6px 8px; }
+.wf-root td { padding: 6px 8px; border-bottom: 1px solid var(--wf-line); }
+.wf-root figure { margin: 0 0 8px; }
+.wf-root figcaption { font-size: 12.5px; color: var(--wf-ink-soft); }
+
+/* ---- structure ---- */
+.wf-root .wf-screen { display: flex; flex-direction: column; gap: 10px; min-height: 100%; }
+.wf-root .wf-topbar, .wf-root header { display: flex; align-items: center; gap: 10px; border-bottom: var(--wf-stroke) solid var(--wf-line); padding-bottom: 8px; }
+.wf-root .wf-topbar :is(h1, h2, h3, p), .wf-root header :is(h1, h2, h3, p) { margin: 0; }
+.wf-root .wf-content, .wf-root main { display: flex; flex-direction: column; gap: 10px; flex: 1; min-height: 0; }
+.wf-root footer, .wf-root .wf-footer { display: flex; align-items: center; gap: 10px; border-top: var(--wf-stroke) solid var(--wf-line); padding-top: 8px; margin-top: auto; }
+.wf-root nav, .wf-root .wf-nav { display: flex; align-items: center; gap: 12px; }
+.wf-root aside, .wf-root .wf-sidebar { display: flex; flex-direction: column; gap: 8px; border-right: var(--wf-stroke) solid var(--wf-line); padding-right: 10px; }
+.wf-root .wf-row { display: flex; align-items: center; gap: 8px; }
+.wf-root .wf-col { display: flex; flex-direction: column; gap: 8px; }
+.wf-root .wf-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; }
+.wf-root .wf-spacer { flex: 1; }
+
+/* ---- surfaces & controls ---- */
+.wf-root .wf-card, .wf-root .wf-box, .wf-root .wf-panel {
+  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);
+  border-radius: var(--wf-radius); padding: 12px;
+}
+.wf-root .wf-button {
+  display: inline-flex; align-items: center; justify-content: center; gap: 6px;
+  font: inherit; font-weight: 700; color: var(--wf-ink); background: var(--wf-paper);
+  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius);
+  padding: 7px 14px; text-decoration: none; cursor: default; width: fit-content;
+}
+.wf-root .wf-button:is(.primary, .wf-primary) {
+  background: var(--wf-accent); border-color: var(--wf-accent); color: var(--wf-accent-fg);
+}
+.wf-root .wf-input, .wf-root .wf-field, .wf-root .wf-select, .wf-root .wf-textarea {
+  display: flex; align-items: center; min-height: 34px; width: 100%;
+  color: var(--wf-ink-soft); background: var(--wf-card);
+  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius); padding: 6px 10px;
+}
+.wf-root .wf-textarea { min-height: 64px; align-items: flex-start; }
+.wf-root .wf-form { display: flex; flex-direction: column; gap: 8px; }
+.wf-root .wf-checkbox, .wf-root .wf-radio {
+  display: inline-block; width: 15px; height: 15px; flex: 0 0 auto;
+  border: var(--wf-stroke) solid var(--wf-sketch); background: var(--wf-paper);
+}
+.wf-root .wf-checkbox { border-radius: 4px; }
+.wf-root .wf-radio { border-radius: 999px; }
+
+/* ---- chips, badges, status ---- */
+.wf-root :is(.wf-badge, .wf-chip, .wf-pill, .wf-tag) {
+  display: inline-flex; align-items: center; gap: 5px; width: fit-content; max-width: 100%;
+  border: var(--wf-stroke) solid var(--wf-line); border-radius: 999px;
+  padding: 2px 10px; font-size: 12.5px; background: var(--wf-paper);
+}
+.wf-root :is(.wf-badge, .wf-chip, .wf-pill, .wf-tag).accent { border-color: var(--wf-accent); color: var(--wf-accent); background: var(--wf-accent-soft); }
+.wf-root .wf-muted { color: var(--wf-ink-soft); }
+.wf-root .wf-hint { color: var(--wf-ink-soft); font-size: 12.5px; }
+.wf-root .wf-error { color: var(--wf-warn); }
+.wf-root :is(.wf-alert, .wf-banner) { background: var(--wf-warn-soft); border: var(--wf-stroke) solid var(--wf-warn); border-radius: var(--wf-radius); padding: 8px 12px; color: var(--wf-warn); }
+
+/* ---- lists ---- */
+.wf-root .wf-list { list-style: none; margin: 0 0 8px; padding: 0; display: flex; flex-direction: column; gap: 6px; }
+.wf-root .wf-list-item {
+  display: flex; align-items: center; justify-content: space-between; gap: 10px; margin: 0;
+  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);
+  border-radius: var(--wf-radius); padding: 9px 12px;
+}
+
+/* ---- media & placeholders ---- */
+.wf-root :is(.wf-image, .wf-img, .wf-media) {
+  display: block; min-height: 84px; background: var(--wf-card);
+  background-image: linear-gradient(to top right, transparent 49.55%, var(--wf-line) 49.55%, var(--wf-line) 50.45%, transparent 50.45%),
+    linear-gradient(to bottom right, transparent 49.55%, var(--wf-line) 49.55%, var(--wf-line) 50.45%, transparent 50.45%);
+  border: var(--wf-stroke) solid var(--wf-line); border-radius: var(--wf-radius);
+}
+.wf-root .wf-avatar {
+  display: inline-flex; align-items: center; justify-content: center; flex: 0 0 auto;
+  width: 32px; height: 32px; border-radius: 999px; font-size: 12px; font-weight: 700;
+  background: var(--wf-card); border: var(--wf-stroke) solid var(--wf-line);
+}
+.wf-root .wf-loading {
+  display: block; height: 12px; width: 70%; border-radius: 999px; border: 0;
+  background: var(--wf-line);
+}
+@media (prefers-reduced-motion: no-preference) {
+  .wf-root .wf-loading { animation: wf-pulse 1.6s ease-in-out infinite; }
+}
+@keyframes wf-pulse { 0%, 100% { opacity: 1; } 50% { opacity: 0.55; } }
+
+/* ---- rough handoff: once the overlay has drawn hand-drawn outlines, hide the
+   crisp borders it replaced (fills and text stay) so nothing is doubled. ---- */
+[data-rough-ready="true"] .wf-root :is(
+  .wf-button, .wf-input, .wf-field, .wf-select, .wf-textarea,
+  .wf-card, .wf-box, .wf-panel, .wf-badge, .wf-chip, .wf-pill, .wf-tag,
+  .wf-list-item, .wf-avatar, .wf-image, .wf-img, .wf-media, .wf-alert, .wf-banner,
+  .wf-checkbox, .wf-radio, hr
+) { border-color: transparent !important; }
+`;
+/**
+ * Class names the theme MUST style (superset of the generation contract's
+ * common vocabulary). The coverage test asserts each appears in the CSS so a
+ * generated artifact can never render a bare, unstyled block again.
+ */
+export const WIREFRAME_THEME_CLASSES = [
+    "wf-screen", "wf-topbar", "wf-content", "wf-footer", "wf-nav", "wf-sidebar",
+    "wf-row", "wf-col", "wf-grid", "wf-spacer",
+    "wf-card", "wf-box", "wf-panel", "wf-button", "wf-input", "wf-field", "wf-select", "wf-textarea", "wf-form",
+    "wf-checkbox", "wf-radio",
+    "wf-badge", "wf-chip", "wf-pill", "wf-tag",
+    "wf-muted", "wf-hint", "wf-error", "wf-alert", "wf-banner",
+    "wf-list", "wf-list-item",
+    "wf-image", "wf-img", "wf-media", "wf-avatar", "wf-loading",
+];
+//# sourceMappingURL=wireframe-theme.js.map

package/dist/visual-plan/domain/wireframe-theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireframe-theme.js","sourceRoot":"","sources":["../../../src/visual-plan/domain/wireframe-theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwIlC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAsB;IACzD,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY;IAC3E,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW;IAC1C,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS;IAC3G,aAAa,EAAE,UAAU;IACzB,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ;IAC1C,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW;IAC1D,SAAS,EAAE,cAAc;IACzB,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY;CAC3D,CAAC"}

package/dist/visual-plan/infrastructure/atomic-write.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Crash-safe same-directory atomic write (Phase-1 inline copy).
+ *
+ * Same-dir tmp + renameSync (atomic on POSIX because tmp and target share a
+ * filesystem). A self-contained copy local to the visual-plan module; the
+ * shared `local-web/atomic-write.ts` is the general-purpose primitive. The tmp
+ * prefix keeps orphaned temps from ever matching the `phase-NN-*.md` glob.
+ */
+/** Write `content` to `targetPath` atomically via a same-directory temp file. */
+export declare function atomicWriteFileSync(targetPath: string, content: string): void;
+//# sourceMappingURL=atomic-write.d.ts.map

package/dist/visual-plan/infrastructure/atomic-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/infrastructure/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAyB7E"}

package/dist/visual-plan/infrastructure/atomic-write.js

@@ -0,0 +1,44 @@
+/**
+ * Crash-safe same-directory atomic write (Phase-1 inline copy).
+ *
+ * Same-dir tmp + renameSync (atomic on POSIX because tmp and target share a
+ * filesystem). A self-contained copy local to the visual-plan module; the
+ * shared `local-web/atomic-write.ts` is the general-purpose primitive. The tmp
+ * prefix keeps orphaned temps from ever matching the `phase-NN-*.md` glob.
+ */
+import * as crypto from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+const TMP_PREFIX = ".visual-plan-tmp-";
+/** Write `content` to `targetPath` atomically via a same-directory temp file. */
+export function atomicWriteFileSync(targetPath, content) {
+    const dir = path.dirname(targetPath);
+    const tmpPath = path.join(dir, `${TMP_PREFIX}${crypto.randomBytes(6).toString("hex")}`);
+    fs.writeFileSync(tmpPath, content, "utf-8");
+    try {
+        try {
+            fs.renameSync(tmpPath, targetPath);
+        }
+        catch (error) {
+            const e = error;
+            if (e.code === "EPERM") {
+                // Windows: target may be briefly locked by another process. Single retry.
+                Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 50);
+                fs.renameSync(tmpPath, targetPath);
+            }
+            else {
+                throw error;
+            }
+        }
+    }
+    catch (error) {
+        try {
+            fs.unlinkSync(tmpPath);
+        }
+        catch {
+            // best-effort cleanup; surface the original error
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=atomic-write.js.map

package/dist/visual-plan/infrastructure/atomic-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-write.js","sourceRoot":"","sources":["../../../src/visual-plan/infrastructure/atomic-write.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,UAAU,GAAG,mBAAmB,CAAC;AAEvC,iFAAiF;AACjF,MAAM,UAAU,mBAAmB,CAAC,UAAkB,EAAE,OAAe;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACxF,EAAE,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,IAAI,CAAC;QACJ,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,KAA8B,CAAC;YACzC,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACxB,0EAA0E;gBAC1E,OAAO,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBACjE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACP,MAAM,KAAK,CAAC;YACb,CAAC;QACF,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACR,kDAAkD;QACnD,CAAC;QACD,MAAM,KAAK,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/visual-plan/infrastructure/feedback-repository.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Immutable feedback-batch storage under `<plan-dir>/visual-plan/feedback/`.
+ *
+ * A batch file is write-once: `writeBatch` refuses to overwrite an existing id
+ * (immutability is the misapplication guard). The batch id is validated against
+ * the strict `feedback-<ts>-<slug>` pattern BEFORE any path join (red-team M8),
+ * so a traversal/absolute/null-byte id can never escape the feedback dir.
+ * Batches are committed to git by default (Validation Session 1) — they are
+ * review evidence, like the plan files.
+ */
+import { type FeedbackBatch } from "../domain/feedback-schemas.js";
+/** Persist a batch write-once. Returns false if a batch with this id already exists. */
+export declare function writeBatch(planDir: string, batch: FeedbackBatch): boolean;
+/** Read + validate a batch by id, or null when absent/invalid. Throws on a malformed id. */
+export declare function readBatch(planDir: string, id: string): FeedbackBatch | null;
+/** List batch ids present in the feedback dir (for `status` / orphan detection). */
+export declare function listBatchIds(planDir: string): string[];
+//# sourceMappingURL=feedback-repository.d.ts.map

package/dist/visual-plan/infrastructure/feedback-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-repository.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/infrastructure/feedback-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAWxF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,OAAO,CAMzE;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAU3E;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtD"}

package/dist/visual-plan/infrastructure/feedback-repository.js

@@ -0,0 +1,59 @@
+/**
+ * Immutable feedback-batch storage under `<plan-dir>/visual-plan/feedback/`.
+ *
+ * A batch file is write-once: `writeBatch` refuses to overwrite an existing id
+ * (immutability is the misapplication guard). The batch id is validated against
+ * the strict `feedback-<ts>-<slug>` pattern BEFORE any path join (red-team M8),
+ * so a traversal/absolute/null-byte id can never escape the feedback dir.
+ * Batches are committed to git by default (Validation Session 1) — they are
+ * review evidence, like the plan files.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { isValidFeedbackBatchId } from "../domain/ids.js";
+import { FeedbackBatchSchema } from "../domain/feedback-schemas.js";
+import { atomicWriteFileSync } from "./atomic-write.js";
+const FEEDBACK_DIR = path.join("visual-plan", "feedback");
+/** Absolute path to a batch file, validating the id BEFORE the join. Throws on a bad id. */
+function batchPath(planDir, id) {
+    if (!isValidFeedbackBatchId(id))
+        throw new Error(`invalid feedback batch id: ${JSON.stringify(id)}`);
+    return path.join(planDir, FEEDBACK_DIR, `${id}.json`);
+}
+/** Persist a batch write-once. Returns false if a batch with this id already exists. */
+export function writeBatch(planDir, batch) {
+    const file = batchPath(planDir, batch.id);
+    if (fs.existsSync(file))
+        return false; // immutable — never overwrite
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    atomicWriteFileSync(file, `${JSON.stringify(batch, null, 2)}\n`);
+    return true;
+}
+/** Read + validate a batch by id, or null when absent/invalid. Throws on a malformed id. */
+export function readBatch(planDir, id) {
+    const file = batchPath(planDir, id);
+    let text;
+    try {
+        text = fs.readFileSync(file, "utf-8");
+    }
+    catch {
+        return null;
+    }
+    const parsed = FeedbackBatchSchema.safeParse(JSON.parse(text));
+    return parsed.success ? parsed.data : null;
+}
+/** List batch ids present in the feedback dir (for `status` / orphan detection). */
+export function listBatchIds(planDir) {
+    try {
+        return fs
+            .readdirSync(path.join(planDir, FEEDBACK_DIR))
+            .filter((n) => n.endsWith(".json"))
+            .map((n) => n.slice(0, -5))
+            .filter(isValidFeedbackBatchId)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=feedback-repository.js.map

package/dist/visual-plan/infrastructure/feedback-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback-repository.js","sourceRoot":"","sources":["../../../src/visual-plan/infrastructure/feedback-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAsB,MAAM,+BAA+B,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;AAE1D,4FAA4F;AAC5F,SAAS,SAAS,CAAC,OAAe,EAAE,EAAU;IAC7C,IAAI,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACrG,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAoB;IAC/D,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,8BAA8B;IACrE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,mBAAmB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACb,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,EAAU;IACpD,MAAM,IAAI,GAAG,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACpC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACJ,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,IAAI,CAAC;QACJ,OAAO,EAAE;aACP,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;aAC7C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;aAC1B,MAAM,CAAC,sBAAsB,CAAC;aAC9B,IAAI,EAAE,CAAC;IACV,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAE,CAAC;IACX,CAAC;AACF,CAAC"}

package/dist/visual-plan/infrastructure/hashing.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Source-hash computation + stale detection for the visual artifact.
+ *
+ * The artifact pins the SHA-256 of the Markdown plan it was generated from
+ * (`source.planHash`) and of every phase file (`source.phaseHashes`). If a
+ * human edits `plan.md`/`phase-*.md` after generation, the recomputed hash
+ * diverges and validation reports STALE_SOURCE_HASH — the artifact must be
+ * regenerated or re-hashed (`rehash`) before it can be approved (red-team M1).
+ *
+ * `artifactHash` (SHA-256 of the plan.json bytes) is the pointer cached in
+ * `.plan-state.json.visual.hash`; it detects artifact drift, not source drift.
+ */
+import { type ValidationError } from "../domain/errors.js";
+import type { VisualPlan } from "../domain/schemas.js";
+/** SHA-256 of a UTF-8 string, `sha256:`-prefixed lowercase hex. */
+export declare function sha256(content: string): string;
+/** SHA-256 of a file's bytes, or `null` if it cannot be read. */
+export declare function hashFile(filePath: string): string | null;
+/** SHA-256 of the artifact's on-disk bytes (the `.plan-state.json` pointer). */
+export declare function artifactHash(planDir: string, artifactRelPath: string): string | null;
+export interface SourceHashes {
+    planHash: string;
+    phaseHashes: Record<string, string>;
+}
+/**
+ * Recompute source hashes from disk. `planPath` is resolved relative to
+ * `planDir`; phase files are discovered by the `phase-NN-*.md` convention in
+ * the plan directory. Missing plan file → empty planHash (validation catches it).
+ */
+export declare function computeSourceHashes(planDir: string, planPath: string): SourceHashes;
+/**
+ * Compare the artifact's pinned source hashes against freshly-computed ones.
+ * Any divergence (plan bytes changed, a phase added/removed/edited) is a
+ * STALE_SOURCE_HASH error with the exact JSON path.
+ */
+export declare function checkSourceFreshness(plan: VisualPlan, planDir: string): ValidationError[];
+//# sourceMappingURL=hashing.d.ts.map

package/dist/visual-plan/infrastructure/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/infrastructure/hashing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAKvD,mEAAmE;AACnE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMxD;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEpF;AAED,MAAM,WAAW,YAAY;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAiBnF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAazF"}