mewkit 1.15.0 → 1.16.1

package/dist/visual-plan/interface/cli.js

@@ -0,0 +1,280 @@
+/**
+ * `mewkit visual-plan <subcommand>` dispatch + reporter.
+ *
+ * Subcommands: validate | status | approve | rehash | export | prepare-feedback
+ * (sync) and edit | view (long-running studio). Each resolves
+ * the plan directory, runs the matching application function, and reports in
+ * human or `--json` form. Exit codes: 0 ok, 1 contract/precondition failure,
+ * 2 usage/path error. Sets `process.exitCode` (never calls `process.exit`) so
+ * the surface stays unit-testable.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import pc from "picocolors";
+import { validatePlan } from "../application/validate-plan.js";
+import { planStatus } from "../application/status.js";
+import { approvePlan } from "../application/approve.js";
+import { rehashPlan } from "../application/rehash.js";
+import { exportPlanHtml } from "../application/export-plan.js";
+import { prepareFeedback } from "../application/prepare-feedback.js";
+import { checkBatchFresh, recordResolution } from "../application/apply-feedback.js";
+import { patchPlan } from "../application/patch-plan.js";
+import { PatchOpSchema } from "../domain/patches.js";
+import { runStudio } from "./studio.js";
+import { resolvePlanDir, PlanPathError } from "../infrastructure/visual-plan-repository.js";
+import { atomicWriteFileSync } from "../infrastructure/atomic-write.js";
+const emit = (value) => console.log(JSON.stringify(value, null, 2));
+function printErrors(errors) {
+    for (const e of errors)
+        console.error(`  ${pc.red("✗")} ${pc.bold(e.path)} — ${e.message} ${pc.dim(`[${e.code}]`)}`);
+}
+function runValidate(planDir, json) {
+    const r = validatePlan(planDir);
+    if (json) {
+        emit({ ok: r.ok, coverage: r.coverage ?? null, errors: r.errors });
+    }
+    else if (r.ok) {
+        const c = r.coverage;
+        const cov = c ? ` (coverage ${c.resolved} resolved / ${c.planned} planned / ${c.omitted} omitted / ${c.unresolved} unresolved)` : "";
+        console.log(`${pc.green("✓")} visual-plan valid${cov}`);
+    }
+    else {
+        console.error(`${pc.red("✗")} visual-plan invalid — ${r.errors.length} error(s):`);
+        printErrors(r.errors);
+    }
+    process.exitCode = r.ok ? 0 : 1;
+}
+function runStatus(planDir, json) {
+    const s = planStatus(planDir);
+    if (json) {
+        emit(s);
+    }
+    else if (!s.exists) {
+        console.log(pc.dim("no visual artifact for this plan"));
+    }
+    else {
+        const c = s.coverage;
+        console.log(`${s.valid ? pc.green("valid") : pc.red("invalid")} · rev ${s.revision} · review ${pc.bold(s.reviewStatus ?? "?")}` +
+            (c ? ` · coverage ${c.resolved}/${c.planned}/${c.omitted}/${c.unresolved} (R/P/O/U)` : "") +
+            (s.errorCount ? ` · ${s.errorCount} error(s)` : ""));
+    }
+    // Contract violation exits non-zero (phase Requirements). An absent artifact
+    // is NOT a violation — nothing to gate on — so it stays 0.
+    process.exitCode = s.exists && !s.valid ? 1 : 0;
+}
+function runApprove(planDir, revisionArg, json) {
+    const raw = String(revisionArg ?? "");
+    // Strict: reject trailing garbage / floats rather than silently coercing
+    // (e.g. "3abc" or "3.5"). Approval is pinned to an exact revision.
+    if (!/^\d+$/.test(raw)) {
+        console.error(pc.red("approve requires --revision <n> (non-negative integer)"));
+        process.exitCode = 2;
+        return;
+    }
+    const revision = parseInt(raw, 10);
+    const r = approvePlan(planDir, revision);
+    if (json) {
+        emit(r);
+    }
+    else if (r.ok) {
+        console.log(`${pc.green("✓")} approved revision ${revision}`);
+    }
+    else {
+        console.error(`${pc.red("✗")} approval refused (${r.failedPreconditions.length} precondition(s)):`);
+        for (const p of r.failedPreconditions)
+            console.error(`  ${pc.red("✗")} ${p}`);
+    }
+    process.exitCode = r.ok ? 0 : 1;
+}
+function runExport(planDir, format, json) {
+    if (format !== undefined && format !== "html") {
+        console.error(pc.red(`export --format ${format} not supported (only 'html')`));
+        process.exitCode = 2;
+        return;
+    }
+    const r = exportPlanHtml(planDir);
+    if (!r.ok || !r.html) {
+        if (json)
+            emit(r);
+        else
+            console.error(`${pc.red("✗")} export failed — ${r.error ?? "unknown"}`);
+        process.exitCode = 1;
+        return;
+    }
+    const out = path.join(planDir, "plan.html");
+    atomicWriteFileSync(out, r.html);
+    if (json)
+        emit({ ok: true, path: out });
+    else
+        console.log(`${pc.green("✓")} exported ${out}`);
+    process.exitCode = 0;
+}
+function readJsonFile(file) {
+    return JSON.parse(fs.readFileSync(file, "utf-8"));
+}
+/** `patch <dir> --op <file>` — apply one typed visual op (single-writer; no If-Match). */
+function runPatch(planDir, opFile, json) {
+    if (!opFile) {
+        console.error(pc.red("patch requires --op <op.json> (a single typed patch op)"));
+        process.exitCode = 2;
+        return;
+    }
+    let opJson;
+    try {
+        opJson = readJsonFile(opFile);
+    }
+    catch (e) {
+        console.error(pc.red(`could not read --op file: ${e instanceof Error ? e.message : String(e)}`));
+        process.exitCode = 2;
+        return;
+    }
+    const op = PatchOpSchema.safeParse(opJson);
+    if (!op.success) {
+        console.error(pc.red(`invalid patch op: ${op.error.issues[0]?.message ?? "schema"}`));
+        process.exitCode = 2;
+        return;
+    }
+    const r = patchPlan(planDir, op.data);
+    if (json)
+        emit(r);
+    else if (r.status === "ok")
+        console.log(`${pc.green("✓")} patched → revision ${r.revision}`);
+    else
+        console.error(`${pc.red("✗")} ${r.status}${r.message ? `: ${r.message}` : ""}`);
+    process.exitCode = r.status === "ok" ? 0 : 1;
+}
+/** `apply-feedback <dir> --batch <id> [--check | --receipt <file>]` — deterministic loop mechanics. */
+function runApplyFeedback(planDir, args, json) {
+    if (!args.batch) {
+        console.error(pc.red("apply-feedback requires --batch <batch-id>"));
+        process.exitCode = 2;
+        return;
+    }
+    if (args.check) {
+        const r = checkBatchFresh(planDir, args.batch);
+        if (json)
+            emit(r);
+        else if (r.ok)
+            console.log(`${pc.green("✓")} batch ${args.batch} is fresh — safe to apply`);
+        else
+            console.error(`${pc.red("✗")} ${r.stale ? "STALE" : "cannot apply"}: ${r.reason}`);
+        process.exitCode = r.ok ? 0 : 1;
+        return;
+    }
+    if (args.receipt) {
+        let entries;
+        try {
+            entries = readJsonFile(args.receipt);
+        }
+        catch (e) {
+            console.error(pc.red(`could not read --receipt file: ${e instanceof Error ? e.message : String(e)}`));
+            process.exitCode = 2;
+            return;
+        }
+        const r = recordResolution(planDir, args.batch, entries);
+        if (json)
+            emit(r);
+        else if (r.ok) {
+            console.log(`${pc.green("✓")} receipt written: ${r.receiptPath}`);
+            console.log(`  reopen: ${pc.cyan(r.reopenCommand ?? "")}`);
+        }
+        else
+            console.error(`${pc.red("✗")} ${r.error}`);
+        process.exitCode = r.ok ? 0 : 1;
+        return;
+    }
+    console.error(pc.red("apply-feedback requires --check (pre-apply gate) or --receipt <file> (record outcomes)"));
+    process.exitCode = 2;
+}
+function runPrepareFeedback(planDir, opsFile, json) {
+    if (!opsFile) {
+        console.error(pc.red("prepare-feedback requires --ops <operations.json> (a JSON array of feedback operations)"));
+        process.exitCode = 2;
+        return;
+    }
+    let operations;
+    try {
+        operations = JSON.parse(fs.readFileSync(opsFile, "utf-8"));
+    }
+    catch (e) {
+        console.error(pc.red(`could not read --ops file: ${e instanceof Error ? e.message : String(e)}`));
+        process.exitCode = 2;
+        return;
+    }
+    if (!Array.isArray(operations)) {
+        console.error(pc.red("--ops file must contain a JSON array of operations"));
+        process.exitCode = 2;
+        return;
+    }
+    const r = prepareFeedback(planDir, operations);
+    if (json) {
+        emit(r);
+    }
+    else if (r.ok) {
+        console.log(`${pc.green("✓")} feedback batch ${pc.bold(r.batchId ?? "")}`);
+        console.log(`  copy: ${pc.cyan(r.copyCommand ?? "")}`);
+    }
+    else {
+        console.error(`${pc.red("✗")} ${r.error ?? "prepare failed"}`);
+    }
+    process.exitCode = r.ok ? 0 : 1;
+}
+function runRehash(planDir, json) {
+    const r = rehashPlan(planDir);
+    if (json) {
+        emit(r);
+    }
+    else if (r.ok) {
+        console.log(`${pc.green("✓")} source hashes refreshed${r.clearedApproval ? pc.yellow(" — prior approval cleared") : ""}`);
+    }
+    else {
+        printErrors(r.errors);
+    }
+    process.exitCode = r.ok ? 0 : 1;
+}
+/** Dispatch a `visual-plan` subcommand. Returns a promise for the long-running studio commands. */
+export function visualPlanCommand(args) {
+    const sub = args.subcommand;
+    // Long-running studio commands (own their plan-dir resolution + browser lifecycle).
+    if (sub === "edit" || sub === "view") {
+        return runStudio({ mode: sub, planDir: args.planDir, open: args.open, noOpen: args.noOpen, force: args.force, port: args.port });
+    }
+    const known = new Set(["validate", "status", "approve", "rehash", "export", "prepare-feedback", "apply-feedback", "patch"]);
+    if (!sub || !known.has(sub)) {
+        console.error(pc.red(`visual-plan: expected one of validate|status|approve|rehash|export|prepare-feedback|apply-feedback|patch|edit|view (got ${sub ?? "nothing"})`));
+        process.exitCode = 2;
+        return;
+    }
+    if (!args.planDir) {
+        console.error(pc.red(`visual-plan ${sub}: missing <plan-dir>`));
+        process.exitCode = 2;
+        return;
+    }
+    let planDir;
+    try {
+        planDir = resolvePlanDir(args.planDir);
+    }
+    catch (e) {
+        console.error(pc.red(e instanceof PlanPathError ? e.message : String(e)));
+        process.exitCode = 2;
+        return;
+    }
+    const json = args.json === true;
+    if (sub === "validate")
+        runValidate(planDir, json);
+    else if (sub === "status")
+        runStatus(planDir, json);
+    else if (sub === "approve")
+        runApprove(planDir, args.revision, json);
+    else if (sub === "export")
+        runExport(planDir, args.format, json);
+    else if (sub === "prepare-feedback")
+        runPrepareFeedback(planDir, args.ops, json);
+    else if (sub === "apply-feedback")
+        runApplyFeedback(planDir, args, json);
+    else if (sub === "patch")
+        runPatch(planDir, args.op, json);
+    else
+        runRehash(planDir, json);
+}
+//# sourceMappingURL=cli.js.map

package/dist/visual-plan/interface/cli.js.map

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

package/dist/visual-plan/interface/studio.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `mewkit visual-plan edit|view <plan-dir>` — serve the compiled studio bundle
+ * over a transient 127.0.0.1 process and open the browser.
+ *
+ * `edit` acquires the single-editor lock (Phase 4a is still read-only; the lock
+ * exists so Phase 5's write mode is race-safe from day one). `view` never locks.
+ * The process serves until SIGINT/SIGTERM, then stops the server and releases the
+ * lock. No filesystem writes happen from the browser — the server is the only
+ * writer, and in 4a it only reads.
+ */
+export interface StudioArgs {
+    mode: "edit" | "view";
+    planDir?: string;
+    open?: boolean;
+    noOpen?: boolean;
+    force?: boolean;
+    port?: number;
+}
+export declare function runStudio(args: StudioArgs): Promise<void>;
+//# sourceMappingURL=studio.d.ts.map

package/dist/visual-plan/interface/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/interface/studio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAQD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD/D"}

package/dist/visual-plan/interface/studio.js

@@ -0,0 +1,74 @@
+/**
+ * `mewkit visual-plan edit|view <plan-dir>` — serve the compiled studio bundle
+ * over a transient 127.0.0.1 process and open the browser.
+ *
+ * `edit` acquires the single-editor lock (Phase 4a is still read-only; the lock
+ * exists so Phase 5's write mode is race-safe from day one). `view` never locks.
+ * The process serves until SIGINT/SIGTERM, then stops the server and releases the
+ * lock. No filesystem writes happen from the browser — the server is the only
+ * writer, and in 4a it only reads.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import pc from "picocolors";
+import { resolvePlanDir, PlanPathError, artifactExists } from "../infrastructure/visual-plan-repository.js";
+import { VisualPlanServer } from "../server/visual-plan-server.js";
+import { acquireEditLock, releaseEditLock } from "../server/edit-lock.js";
+import { openBrowser } from "../../local-web/open-browser.js";
+/** Absolute path to the compiled studio bundle (shipped under dist/). */
+function resolveBundleDir() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, "..", "..", "..", "dist", "visual-plan-web");
+}
+export async function runStudio(args) {
+    if (!args.planDir) {
+        console.error(pc.red(`visual-plan ${args.mode}: missing <plan-dir>`));
+        process.exitCode = 2;
+        return;
+    }
+    let planDir;
+    try {
+        planDir = resolvePlanDir(args.planDir);
+    }
+    catch (e) {
+        console.error(pc.red(e instanceof PlanPathError ? e.message : String(e)));
+        process.exitCode = 2;
+        return;
+    }
+    if (!artifactExists(planDir)) {
+        console.error(pc.red(`No visual artifact at ${path.join(planDir, "visual-plan", "plan.json")}. Generate one via mk:plan-creator first.`));
+        process.exitCode = 2;
+        return;
+    }
+    const server = new VisualPlanServer({ planDir, bundleDir: resolveBundleDir(), port: args.port });
+    // Bind first so the lock records the real port.
+    const url = await server.start();
+    if (args.mode === "edit") {
+        const lock = acquireEditLock(planDir, server.port, args.force === true);
+        if (!lock.ok) {
+            await server.stop();
+            console.error(pc.red(`Another edit session holds this plan (pid ${lock.heldBy?.pid}, port ${lock.heldBy?.port}). Use --force to override.`));
+            process.exitCode = 1;
+            return;
+        }
+    }
+    console.log(`${pc.bold(pc.cyan(`mewkit visual-plan ${args.mode}`))} — ${pc.cyan(url)}`);
+    if (!fs.existsSync(path.join(resolveBundleDir(), "index.html"))) {
+        console.log(pc.yellow(`Note: studio bundle not found — run \`npm run build:web:visual-plan\`.`));
+    }
+    if (!args.noOpen && args.open !== false) {
+        openBrowser(url, (err) => console.error(pc.yellow(`Could not open browser (${err.message}). Navigate to ${url}`)));
+    }
+    const shutdown = async () => {
+        await server.stop();
+        if (args.mode === "edit")
+            releaseEditLock(planDir);
+        process.exit(0);
+    };
+    process.on("SIGINT", () => void shutdown());
+    process.on("SIGTERM", () => void shutdown());
+    process.on("SIGHUP", () => void shutdown());
+}
+//# sourceMappingURL=studio.js.map

package/dist/visual-plan/interface/studio.js.map

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

package/dist/visual-plan/server/csp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Content-Security-Policy for the Visual Plan studio's served pages.
+ *
+ * Exact policy (red-team M4 — be exact, not hand-wavy). `script-src 'self'` keeps
+ * the XSS-relevant surface strict; `style-src` allows `'unsafe-inline'` only
+ * because Vite's production output injects inline styles (the accepted trade-off).
+ * `img-src ... data:` permits inlined data-URI assets; `connect-src 'self'` keeps
+ * fetches loopback-only. A server test asserts this header VERBATIM.
+ */
+export declare const STUDIO_CSP = "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'";
+/** Baseline security headers applied to every studio response. */
+export declare const SECURITY_HEADERS: Record<string, string>;
+//# sourceMappingURL=csp.d.ts.map

package/dist/visual-plan/server/csp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/server/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,UAAU,sHAC6F,CAAC;AAErH,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAInD,CAAC"}

package/dist/visual-plan/server/csp.js

@@ -0,0 +1,17 @@
+/**
+ * Content-Security-Policy for the Visual Plan studio's served pages.
+ *
+ * Exact policy (red-team M4 — be exact, not hand-wavy). `script-src 'self'` keeps
+ * the XSS-relevant surface strict; `style-src` allows `'unsafe-inline'` only
+ * because Vite's production output injects inline styles (the accepted trade-off).
+ * `img-src ... data:` permits inlined data-URI assets; `connect-src 'self'` keeps
+ * fetches loopback-only. A server test asserts this header VERBATIM.
+ */
+export const STUDIO_CSP = "default-src 'self'; script-src 'self'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; connect-src 'self'";
+/** Baseline security headers applied to every studio response. */
+export const SECURITY_HEADERS = {
+    "Content-Security-Policy": STUDIO_CSP,
+    "X-Content-Type-Options": "nosniff",
+    "Referrer-Policy": "no-referrer",
+};
+//# sourceMappingURL=csp.js.map

package/dist/visual-plan/server/csp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csp.js","sourceRoot":"","sources":["../../../src/visual-plan/server/csp.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,UAAU,GACtB,mHAAmH,CAAC;AAErH,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACvD,yBAAyB,EAAE,UAAU;IACrC,wBAAwB,EAAE,SAAS;IACnC,iBAAiB,EAAE,aAAa;CAChC,CAAC"}

package/dist/visual-plan/server/edit-lock.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Single-editor advisory lock (red-team L1).
+ *
+ * `edit` writes a lockfile (pid + port) into the plan dir; a second `edit` on the
+ * same dir warns and refuses unless `--force`. A lock whose pid is no longer alive
+ * is treated as stale and reclaimed. This is advisory UX only — the Phase-5
+ * ETag/409 path remains the correctness backstop against concurrent writes.
+ */
+export interface LockInfo {
+    pid: number;
+    port: number;
+    startedAt: string;
+}
+/** Read the current lock, or null when absent/unparseable. */
+export declare function readEditLock(planDir: string): LockInfo | null;
+export interface AcquireResult {
+    ok: boolean;
+    /** Set when refused: the live lock currently held by another process. */
+    heldBy?: LockInfo;
+}
+/**
+ * Acquire the edit lock. Reclaims a stale (dead-pid) lock automatically. When a
+ * LIVE lock is held by another process, refuses unless `force`.
+ */
+export declare function acquireEditLock(planDir: string, port: number, force: boolean): AcquireResult;
+/** Release the lock IF this process owns it (never removes another process's lock). */
+export declare function releaseEditLock(planDir: string): void;
+//# sourceMappingURL=edit-lock.d.ts.map

package/dist/visual-plan/server/edit-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-lock.d.ts","sourceRoot":"","sources":["../../../src/visual-plan/server/edit-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CAClB;AAcD,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAO7D;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,OAAO,CAAC;IACZ,yEAAyE;IACzE,MAAM,CAAC,EAAE,QAAQ,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAkB5F;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CASrD"}

package/dist/visual-plan/server/edit-lock.js

@@ -0,0 +1,71 @@
+/**
+ * Single-editor advisory lock (red-team L1).
+ *
+ * `edit` writes a lockfile (pid + port) into the plan dir; a second `edit` on the
+ * same dir warns and refuses unless `--force`. A lock whose pid is no longer alive
+ * is treated as stale and reclaimed. This is advisory UX only — the Phase-5
+ * ETag/409 path remains the correctness backstop against concurrent writes.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const LOCK_FILE = ".visual-plan-lock";
+/** True when a process with `pid` is currently alive. */
+function pidAlive(pid) {
+    try {
+        process.kill(pid, 0); // signal 0 = existence check, no signal sent
+        return true;
+    }
+    catch (e) {
+        // EPERM means the process EXISTS but is owned by another user (still alive);
+        // only ESRCH (no such process) means the pid is dead and the lock is stale.
+        return e.code === "EPERM";
+    }
+}
+/** Read the current lock, or null when absent/unparseable. */
+export function readEditLock(planDir) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(path.join(planDir, LOCK_FILE), "utf-8"));
+        return typeof parsed.pid === "number" ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Acquire the edit lock. Reclaims a stale (dead-pid) lock automatically. When a
+ * LIVE lock is held by another process, refuses unless `force`.
+ */
+export function acquireEditLock(planDir, port, force) {
+    const lockPath = path.join(planDir, LOCK_FILE);
+    const payload = `${JSON.stringify({ pid: process.pid, port, startedAt: new Date().toISOString() }, null, 2)}\n`;
+    try {
+        // Atomic create-if-absent: the first writer wins the O_EXCL race outright,
+        // so a second concurrent `edit` cannot also "acquire" in a read→write gap.
+        fs.writeFileSync(lockPath, payload, { flag: "wx" });
+        return { ok: true };
+    }
+    catch (e) {
+        if (e.code !== "EEXIST")
+            throw e;
+    }
+    // A lock already exists — refuse only a LIVE foreign lock without --force.
+    const existing = readEditLock(planDir);
+    if (existing && existing.pid !== process.pid && pidAlive(existing.pid) && !force) {
+        return { ok: false, heldBy: existing };
+    }
+    fs.writeFileSync(lockPath, payload, "utf-8"); // reclaim stale / own / forced
+    return { ok: true };
+}
+/** Release the lock IF this process owns it (never removes another process's lock). */
+export function releaseEditLock(planDir) {
+    const existing = readEditLock(planDir);
+    if (existing && existing.pid === process.pid) {
+        try {
+            fs.unlinkSync(path.join(planDir, LOCK_FILE));
+        }
+        catch {
+            // best-effort
+        }
+    }
+}
+//# sourceMappingURL=edit-lock.js.map

package/dist/visual-plan/server/edit-lock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-lock.js","sourceRoot":"","sources":["../../../src/visual-plan/server/edit-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,MAAM,SAAS,GAAG,mBAAmB,CAAC;AAQtC,yDAAyD;AACzD,SAAS,QAAQ,CAAC,GAAW;IAC5B,IAAI,CAAC;QACJ,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,6CAA6C;QACnE,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,6EAA6E;QAC7E,4EAA4E;QAC5E,OAAQ,CAA2B,CAAC,IAAI,KAAK,OAAO,CAAC;IACtD,CAAC;AACF,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,IAAI,CAAC;QACJ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,OAAO,CAAC,CAAa,CAAC;QAC/F,OAAO,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC;AAQD;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAe,EAAE,IAAY,EAAE,KAAc;IAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACnI,IAAI,CAAC;QACJ,2EAA2E;QAC3E,2EAA2E;QAC3E,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IACD,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACxC,CAAC;IACD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,+BAA+B;IAC7E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACrB,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAAC,OAAe;IAC9C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACvC,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG,EAAE,CAAC;QAC9C,IAAI,CAAC;YACJ,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACR,cAAc;QACf,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/visual-plan/server/routes/feedback.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Feedback routes:
+ *   POST /api/visual-plan/feedback       → freeze accumulated semantic ops into an
+ *                                           immutable batch; returns id + Copy Command.
+ *   GET  /api/visual-plan/feedback/:id    → read a batch (id validated before any
+ *                                           path join by the repository).
+ */
+import type { IncomingMessage, ServerResponse } from "node:http";
+export declare function handlePostFeedback(req: IncomingMessage, res: ServerResponse, planDir: string): Promise<void>;
+/** `id` is validated inside the repository (throws on a malformed id) → mapped to 400. */
+export declare function handleGetFeedback(res: ServerResponse, planDir: string, id: string): void;
+//# sourceMappingURL=feedback.d.ts.map

package/dist/visual-plan/server/routes/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../../../src/visual-plan/server/routes/feedback.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AASjE,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BlH;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAaxF"}

package/dist/visual-plan/server/routes/feedback.js

@@ -0,0 +1,63 @@
+/**
+ * Feedback routes:
+ *   POST /api/visual-plan/feedback       → freeze accumulated semantic ops into an
+ *                                           immutable batch; returns id + Copy Command.
+ *   GET  /api/visual-plan/feedback/:id    → read a batch (id validated before any
+ *                                           path join by the repository).
+ */
+import { bufferBody, BodyError } from "../../../local-web/request-body.js";
+import { prepareFeedback } from "../../application/prepare-feedback.js";
+import { readBatch } from "../../infrastructure/feedback-repository.js";
+import { writeJson } from "./get-plan.js";
+const BODY_CAP = 256 * 1024;
+const TIMEOUT_MS = 5000;
+export async function handlePostFeedback(req, res, planDir) {
+    if (!(req.headers["content-type"] ?? "").toLowerCase().includes("application/json")) {
+        writeJson(res, 415, { error: "unsupported-media-type" });
+        return;
+    }
+    let raw;
+    try {
+        raw = await bufferBody(req, BODY_CAP, TIMEOUT_MS);
+    }
+    catch (e) {
+        writeJson(res, e instanceof BodyError ? e.status : 400, { error: e instanceof BodyError ? e.tag : "body-read-error" });
+        return;
+    }
+    let body;
+    try {
+        body = JSON.parse(raw.toString("utf-8"));
+    }
+    catch {
+        writeJson(res, 400, { error: "invalid-json" });
+        return;
+    }
+    const operations = body.operations;
+    if (!Array.isArray(operations)) {
+        writeJson(res, 400, { error: "missing-operations" });
+        return;
+    }
+    const r = prepareFeedback(planDir, operations);
+    if (!r.ok) {
+        writeJson(res, 400, { error: "prepare-failed", message: r.error });
+        return;
+    }
+    writeJson(res, 201, { ok: true, id: r.batchId, copyCommand: r.copyCommand });
+}
+/** `id` is validated inside the repository (throws on a malformed id) → mapped to 400. */
+export function handleGetFeedback(res, planDir, id) {
+    let batch;
+    try {
+        batch = readBatch(planDir, id);
+    }
+    catch {
+        writeJson(res, 400, { error: "invalid-batch-id" });
+        return;
+    }
+    if (!batch) {
+        writeJson(res, 404, { error: "batch-not-found" });
+        return;
+    }
+    writeJson(res, 200, batch);
+}
+//# sourceMappingURL=feedback.js.map

package/dist/visual-plan/server/routes/feedback.js.map

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