localptp 0.1.0

package/dist/core/taskManager.js

@@ -0,0 +1,312 @@
+/**
+ * Task Manager (HLD-SRD §3.5).
+ *
+ * Creates `/ai/tasks/YYYY-MM-DD_HHMM_slug.md` files, parses them into a typed
+ * `Task`, and rewrites ONLY the `## Subtasks` block on edit (heading-section
+ * discipline) so user content elsewhere is preserved. The model's free-form
+ * task text is stored verbatim in `## Goal`; the filename slug is sanitized to
+ * ASCII-kebab.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { ensureDir } from "../utils/fs.js";
+const SUBTASKS_HEADING = "Subtasks";
+// ---------------------------------------------------------------------------
+// Slug
+// ---------------------------------------------------------------------------
+/**
+ * Slugify free task text: drop diacritics, lower-case, keep [a-z0-9], collapse
+ * runs to single hyphens, take the first ~6 words. Empty result → `task`.
+ */
+export function slugify(text) {
+    const ascii = text
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "") // strip combining diacritics
+        .toLowerCase();
+    const words = ascii
+        .split(/[^a-z0-9]+/)
+        .filter((w) => w.length > 0)
+        .slice(0, 6);
+    const slug = words.join("-");
+    return slug.length > 0 ? slug : "task";
+}
+// ---------------------------------------------------------------------------
+// Timestamp
+// ---------------------------------------------------------------------------
+function pad(n) {
+    return String(n).padStart(2, "0");
+}
+/** `YYYY-MM-DD` */
+function dateStamp(d) {
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+/** `HHMM` */
+function timeStamp(d) {
+    return `${pad(d.getHours())}${pad(d.getMinutes())}`;
+}
+/** `YYYY-MM-DD HH:MM` for the `Created:` line. */
+function createdStamp(d) {
+    return `${dateStamp(d)} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+// ---------------------------------------------------------------------------
+// Section helpers (heading-delimited, level-aware)
+// ---------------------------------------------------------------------------
+/**
+ * Replace the body of a `## <heading>` section with `newBody`, preserving the
+ * heading line and everything outside the section. If the heading is absent,
+ * append a fresh section. Section ends at the next heading of same-or-higher
+ * level.
+ */
+function replaceSection(md, heading, newBody) {
+    const lines = md.split(/\r?\n/);
+    const headingLc = heading.toLowerCase();
+    let start = -1;
+    let level = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+(.*?)\s*$/.exec(lines[i]);
+        if (m && m[2].toLowerCase() === headingLc) {
+            start = i;
+            level = m[1].length;
+            break;
+        }
+    }
+    if (start === -1) {
+        const sep = md.length > 0 && !md.endsWith("\n") ? "\n" : "";
+        return `${md}${sep}\n${"#".repeat(2)} ${heading}\n${newBody}\n`;
+    }
+    // Find the end of the section body.
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+/.exec(lines[i]);
+        if (m && m[1].length <= level) {
+            end = i;
+            break;
+        }
+    }
+    const headingLine = lines[start];
+    const before = lines.slice(0, start);
+    const after = lines.slice(end);
+    const rebuilt = [...before, headingLine, newBody, ...after];
+    return rebuilt.join("\n");
+}
+/** Trimmed body of a `## <heading>` section, or undefined. */
+function sectionBody(md, heading) {
+    const lines = md.split(/\r?\n/);
+    const headingLc = heading.toLowerCase();
+    let start = -1;
+    let level = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+(.*?)\s*$/.exec(lines[i]);
+        if (m && m[2].toLowerCase() === headingLc) {
+            start = i + 1;
+            level = m[1].length;
+            break;
+        }
+    }
+    if (start === -1)
+        return undefined;
+    const collected = [];
+    for (let i = start; i < lines.length; i++) {
+        const m = /^(#{1,6})\s+/.exec(lines[i]);
+        if (m && m[1].length <= level)
+            break;
+        collected.push(lines[i]);
+    }
+    const body = collected.join("\n").trim();
+    return body.length > 0 ? body : undefined;
+}
+// ---------------------------------------------------------------------------
+// Subtask serialization
+// ---------------------------------------------------------------------------
+const RISK_VALUES = ["low", "medium", "high"];
+function normalizeRisk(raw) {
+    const v = (raw ?? "").trim().toLowerCase();
+    return RISK_VALUES.includes(v) ? v : "medium";
+}
+function statusToCheckbox(status) {
+    return status === "done" ? "x" : " ";
+}
+/**
+ * Render the subtasks list. Each subtask is a checkbox line carrying its id,
+ * title and risk; an optional indented `likelyFiles:` line follows. The
+ * checkbox form keeps the tolerant 0001_03 parser working.
+ */
+function renderSubtasks(subtasks) {
+    if (subtasks.length === 0)
+        return "";
+    const out = [];
+    for (const s of subtasks) {
+        const box = statusToCheckbox(s.status);
+        out.push(`- [${box}] ${s.id}: ${s.title} (risk: ${s.risk})`);
+        if (s.description.trim().length > 0) {
+            out.push(`  description: ${s.description.trim()}`);
+        }
+        if (s.likelyFiles.length > 0) {
+            out.push(`  likelyFiles: ${s.likelyFiles.join(", ")}`);
+        }
+        if (s.acceptanceCriteria && s.acceptanceCriteria.length > 0) {
+            out.push(`  acceptanceCriteria: ${s.acceptanceCriteria.join("; ")}`);
+        }
+    }
+    return out.join("\n");
+}
+function parseList(raw, sep) {
+    return raw
+        .split(sep)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+const CHECKBOX_RE = /^\s*[-*]\s+\[( |x|X)\]\s*(.*)$/;
+const ATTR_RE = /^\s+([a-zA-Z]+)\s*:\s*(.*)$/;
+/** Parse the `## Subtasks` block into typed Subtasks. */
+function parseSubtasks(md) {
+    const body = sectionBody(md, SUBTASKS_HEADING);
+    if (body === undefined)
+        return [];
+    const lines = body.split(/\r?\n/);
+    const subtasks = [];
+    let current;
+    let index = 0;
+    for (const line of lines) {
+        const cb = CHECKBOX_RE.exec(line);
+        if (cb) {
+            index += 1;
+            const done = cb[1].toLowerCase() === "x";
+            let rest = cb[2].trim();
+            // Risk: trailing `(risk: low)`.
+            let risk = "medium";
+            const riskM = /\(risk:\s*([a-zA-Z]+)\s*\)\s*$/i.exec(rest);
+            if (riskM) {
+                risk = normalizeRisk(riskM[1]);
+                rest = rest.slice(0, riskM.index).trim();
+            }
+            // Id prefix: `step-N:`.
+            let id = `step-${index}`;
+            let title = rest;
+            const idM = /^([A-Za-z][\w-]*)\s*:\s*(.*)$/.exec(rest);
+            if (idM) {
+                id = idM[1];
+                title = idM[2].trim();
+            }
+            const status = done ? "done" : "pending";
+            current = {
+                id,
+                title,
+                description: "",
+                status,
+                risk,
+                likelyFiles: [],
+            };
+            subtasks.push(current);
+            continue;
+        }
+        const attr = ATTR_RE.exec(line);
+        if (attr && current) {
+            const key = attr[1].toLowerCase();
+            const value = attr[2].trim();
+            if (key === "likelyfiles")
+                current.likelyFiles = parseList(value, ",");
+            else if (key === "acceptancecriteria")
+                current.acceptanceCriteria = parseList(value, ";");
+            else if (key === "description")
+                current.description = value;
+        }
+    }
+    return subtasks;
+}
+// ---------------------------------------------------------------------------
+// Status / title parsing
+// ---------------------------------------------------------------------------
+function parseStatus(md) {
+    const m = /^Status:\s*(active|done|blocked)\s*$/im.exec(md);
+    return m?.[1]?.toLowerCase() ?? "active";
+}
+function parseTitle(md) {
+    const m = /^#\s+Task:\s*(.*?)\s*$/m.exec(md);
+    return m?.[1] ?? "";
+}
+/** Build the §3.5 markdown for a new task. */
+function renderTaskFile(text, now) {
+    return [
+        `# Task: ${text}`,
+        "",
+        `Created: ${createdStamp(now)}`,
+        "Status: active",
+        "",
+        "## Goal",
+        text,
+        "",
+        "## Background",
+        "",
+        "## Requirements",
+        "",
+        "## Non-goals",
+        "",
+        "## Acceptance Criteria",
+        "",
+        "## Subtasks",
+        "",
+        "## Tests",
+        "- npm run typecheck",
+        "- npm test",
+        "",
+    ].join("\n");
+}
+/**
+ * Create a new task file under `tasksDir`. Never overwrites: on a filename
+ * collision (same timestamp+slug) appends `-2`, `-3`, … Returns the parsed Task.
+ */
+export async function createTask(tasksDir, text, opts = {}) {
+    const now = opts.now ?? new Date();
+    await ensureDir(tasksDir);
+    const base = `${dateStamp(now)}_${timeStamp(now)}_${slugify(text)}`;
+    const content = renderTaskFile(text, now);
+    let attempt = 0;
+    // First try the bare name, then -2, -3, … using O_EXCL to avoid races/overwrite.
+    for (;;) {
+        const name = attempt === 0 ? `${base}.md` : `${base}-${attempt + 1}.md`;
+        const full = path.join(tasksDir, name);
+        try {
+            await fs.writeFile(full, content, { encoding: "utf8", flag: "wx" });
+            return parseTaskString(full, content);
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                attempt += 1;
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+/** Parse a task markdown string into a typed Task. */
+export function parseTaskString(filePath, md) {
+    return {
+        path: filePath,
+        title: parseTitle(md),
+        status: parseStatus(md),
+        goal: sectionBody(md, "Goal") ?? "",
+        subtasks: parseSubtasks(md),
+        raw: md,
+    };
+}
+/** Read + parse a task file from disk. */
+export async function parseTask(filePath) {
+    const md = await fs.readFile(filePath, "utf8");
+    return parseTaskString(filePath, md);
+}
+/**
+ * Return a Task whose `## Subtasks` block (in `raw`) is rewritten to `subtasks`,
+ * preserving all other content. Pure: callers persist via `serializeTask`.
+ */
+export function setSubtasks(task, subtasks) {
+    const body = renderSubtasks(subtasks);
+    const sectionContent = body.length > 0 ? `\n${body}\n` : "\n";
+    const raw = replaceSection(task.raw, SUBTASKS_HEADING, sectionContent);
+    return { ...task, subtasks, raw };
+}
+/** The markdown to persist for a Task (its `raw`). */
+export function serializeTask(task) {
+    return task.raw;
+}
+//# sourceMappingURL=taskManager.js.map

package/dist/core/taskManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskManager.js","sourceRoot":"","sources":["../../src/core/taskManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,MAAM,gBAAgB,GAAG,UAAU,CAAC;AAEpC,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,KAAK,GAAG,IAAI;SACf,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,6BAA6B;SACnD,WAAW,EAAE,CAAC;IACjB,MAAM,KAAK,GAAG,KAAK;SAChB,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACf,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,mBAAmB;AACnB,SAAS,SAAS,CAAC,CAAO;IACxB,OAAO,GAAG,CAAC,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AAC3E,CAAC;AAED,aAAa;AACb,SAAS,SAAS,CAAC,CAAO;IACxB,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,kDAAkD;AAClD,SAAS,YAAY,CAAC,CAAO;IAC3B,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,8EAA8E;AAC9E,mDAAmD;AACnD,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,cAAc,CAAC,EAAU,EAAE,OAAe,EAAE,OAAe;IAClE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1C,KAAK,GAAG,CAAC,CAAC;YACV,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,OAAO,GAAG,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,OAAO,KAAK,OAAO,IAAI,CAAC;IAClE,CAAC;IACD,oCAAoC;IACpC,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK,EAAE,CAAC;YAC9B,GAAG,GAAG,CAAC,CAAC;YACR,MAAM;QACR,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5D,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,8DAA8D;AAC9D,SAAS,WAAW,CAAC,EAAU,EAAE,OAAe;IAC9C,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,GAAG,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1C,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACpB,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACnC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,KAAK;YAAE,MAAM;QACrC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5C,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,WAAW,GAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEtD,SAAS,aAAa,CAAC,GAAuB;IAC5C,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAQ,WAAwB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAE,CAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;AACxE,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAqB;IAC7C,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,QAAmB;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,CAAC,kBAAkB,IAAI,CAAC,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,SAAS,CAAC,GAAW,EAAE,GAAW;IACzC,OAAO,GAAG;SACP,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,WAAW,GAAG,gCAAgC,CAAC;AACrD,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAE9C,yDAAyD;AACzD,SAAS,aAAa,CAAC,EAAU;IAC/B,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;IAC/C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,IAAI,OAA4B,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,EAAE,EAAE,CAAC;YACP,KAAK,IAAI,CAAC,CAAC;YACX,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;YACzC,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxB,gCAAgC;YAChC,IAAI,IAAI,GAAS,QAAQ,CAAC;YAC1B,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,CAAC;YACD,wBAAwB;YACxB,IAAI,EAAE,GAAG,QAAQ,KAAK,EAAE,CAAC;YACzB,IAAI,KAAK,GAAG,IAAI,CAAC;YACjB,MAAM,GAAG,GAAG,+BAA+B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvD,IAAI,GAAG,EAAE,CAAC;gBACR,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;gBACZ,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACxB,CAAC;YACD,MAAM,MAAM,GAAkB,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YACxD,OAAO,GAAG;gBACR,EAAE;gBACF,KAAK;gBACL,WAAW,EAAE,EAAE;gBACf,MAAM;gBACN,IAAI;gBACJ,WAAW,EAAE,EAAE;aAChB,CAAC;YACF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvB,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,GAAG,KAAK,aAAa;gBAAE,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;iBAClE,IAAI,GAAG,KAAK,oBAAoB;gBACnC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;iBAChD,IAAI,GAAG,KAAK,aAAa;gBAAE,OAAO,CAAC,WAAW,GAAG,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,SAAS,WAAW,CAAC,EAAU;IAC7B,MAAM,CAAC,GAAG,wCAAwC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5D,OAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAiB,IAAI,QAAQ,CAAC;AAC3D,CAAC;AAED,SAAS,UAAU,CAAC,EAAU;IAC5B,MAAM,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAWD,8CAA8C;AAC9C,SAAS,cAAc,CAAC,IAAY,EAAE,GAAS;IAC7C,OAAO;QACL,WAAW,IAAI,EAAE;QACjB,EAAE;QACF,YAAY,YAAY,CAAC,GAAG,CAAC,EAAE;QAC/B,gBAAgB;QAChB,EAAE;QACF,SAAS;QACT,IAAI;QACJ,EAAE;QACF,eAAe;QACf,EAAE;QACF,iBAAiB;QACjB,EAAE;QACF,cAAc;QACd,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,aAAa;QACb,EAAE;QACF,UAAU;QACV,qBAAqB;QACrB,YAAY;QACZ,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAgB,EAChB,IAAY,EACZ,OAA0B,EAAE;IAE5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACpE,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE1C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,iFAAiF;IACjF,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC;QACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACpE,OAAO,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACrD,OAAO,IAAI,CAAC,CAAC;gBACb,SAAS;YACX,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,EAAU;IAC1D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QACrB,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;QACvB,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE;QACnC,QAAQ,EAAE,aAAa,CAAC,EAAE,CAAC;QAC3B,GAAG,EAAE,EAAE;KACR,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,QAAgB;IAC9C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,eAAe,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAU,EAAE,QAAmB;IACzD,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC;IACvE,OAAO,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACpC,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,aAAa,CAAC,IAAU;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC;AAClB,CAAC"}

package/dist/core/testRunner.d.ts

@@ -0,0 +1,27 @@
+import type { TestResult } from "../types/test.js";
+/** A command to run: an executable plus its argument vector. */
+export type TestCommand = [file: string, args: string[]];
+/**
+ * Split a configured command string (e.g. `npm run test`) into a `[file, args]`
+ * tuple by whitespace. This is intentionally simple (no quote handling) — the
+ * MVP config commands are plain `npm …` invocations. An empty/blank string
+ * yields undefined so the caller can skip it.
+ */
+export declare function splitCommand(command: string): TestCommand | undefined;
+export interface RunTestsOptions {
+    /**
+     * Working directory to run each command in. Defaults to the process cwd, but
+     * the `step` command passes the resolved repository ROOT so tests run against
+     * the same tree the patch was applied to (the invocation cwd may be a
+     * subdirectory of the repo root).
+     */
+    cwd?: string;
+}
+/**
+ * Run each command in order, report-only. Resolves to one `TestResult` per
+ * command (in order). A non-zero exit is captured, not thrown; a command that
+ * cannot even be spawned (ENOENT) is reported with exitCode 127.
+ */
+export declare function runTests(commands: TestCommand[], opts?: RunTestsOptions): Promise<TestResult[]>;
+/** Format a single result as a `✓`/`✗` report line. */
+export declare function formatTestResult(r: TestResult): string;

package/dist/core/testRunner.js

@@ -0,0 +1,71 @@
+/**
+ * Test Runner (HLD-SRD §3.11) — report-only.
+ *
+ * Runs each configured command via `execa` with an explicit argv ARRAY (never a
+ * shell string) so there is no shell-injection surface, captures
+ * `{command, exitCode, stdout, stderr, durationMs}`, and prints a `✓`/`✗` line.
+ * It NEVER retries and NEVER rolls back an applied patch on failure — the
+ * auto-fix loop is 0001_06.
+ *
+ * A command is given as a `[file, args]` tuple; the caller (the `step` command)
+ * splits configured command strings into tuples (config carries strings like
+ * `npm test`; the splitter is a thin helper here so commands stay arg-array).
+ */
+import { execa } from "execa";
+/**
+ * Split a configured command string (e.g. `npm run test`) into a `[file, args]`
+ * tuple by whitespace. This is intentionally simple (no quote handling) — the
+ * MVP config commands are plain `npm …` invocations. An empty/blank string
+ * yields undefined so the caller can skip it.
+ */
+export function splitCommand(command) {
+    const parts = command.trim().split(/\s+/).filter((p) => p.length > 0);
+    if (parts.length === 0)
+        return undefined;
+    return [parts[0], parts.slice(1)];
+}
+/**
+ * Run each command in order, report-only. Resolves to one `TestResult` per
+ * command (in order). A non-zero exit is captured, not thrown; a command that
+ * cannot even be spawned (ENOENT) is reported with exitCode 127.
+ */
+export async function runTests(commands, opts = {}) {
+    const results = [];
+    for (const [file, args] of commands) {
+        const display = [file, ...args].join(" ");
+        const started = Date.now();
+        try {
+            const r = await execa(file, args, {
+                reject: false,
+                all: false,
+                stripFinalNewline: false,
+                ...(opts.cwd !== undefined ? { cwd: opts.cwd } : {}),
+            });
+            results.push({
+                command: display,
+                exitCode: r.exitCode ?? 1,
+                stdout: r.stdout ?? "",
+                stderr: r.stderr ?? "",
+                durationMs: Date.now() - started,
+            });
+        }
+        catch (err) {
+            // execa with reject:false should not throw on a non-zero exit; this is a
+            // spawn failure (e.g. the executable is missing).
+            results.push({
+                command: display,
+                exitCode: 127,
+                stdout: "",
+                stderr: err instanceof Error ? err.message : String(err),
+                durationMs: Date.now() - started,
+            });
+        }
+    }
+    return results;
+}
+/** Format a single result as a `✓`/`✗` report line. */
+export function formatTestResult(r) {
+    const mark = r.exitCode === 0 ? "✓" : "✗";
+    return `${mark} ${r.command} (exit ${r.exitCode}, ${r.durationMs}ms)`;
+}
+//# sourceMappingURL=testRunner.js.map

package/dist/core/testRunner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testRunner.js","sourceRoot":"","sources":["../../src/core/testRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAM9B;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACzC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAYD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,QAAuB,EACvB,OAAwB,EAAE;IAE1B,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE;gBAChC,MAAM,EAAE,KAAK;gBACb,GAAG,EAAE,KAAK;gBACV,iBAAiB,EAAE,KAAK;gBACxB,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrD,CAAC,CAAC;YACH,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;gBACzB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;gBACtB,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE;gBACtB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,yEAAyE;YACzE,kDAAkD;YAClD,OAAO,CAAC,IAAI,CAAC;gBACX,OAAO,EAAE,OAAO;gBAChB,QAAQ,EAAE,GAAG;gBACb,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACxD,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO;aACjC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,CAAa;IAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC1C,OAAO,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,UAAU,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,UAAU,KAAK,CAAC;AACxE,CAAC"}

package/dist/prompts/coder.d.ts

@@ -0,0 +1,3 @@
+export declare const CODER_SYSTEM = "You are a careful coding assistant working inside an existing codebase.\n\nRules:\n- Work in small, safe patches.\n- Do not rewrite unrelated code.\n- Preserve existing behavior unless explicitly instructed.\n- Prefer existing project patterns.\n- If context is insufficient, request exact files instead of guessing.\n- Do not modify risky areas unless explicitly required.\n- Return machine-parseable output when requested.\n\nYou are acting as the CODER. Implement ONLY the current subtask with the\nsmallest safe change. Do not refactor unrelated code and do not touch files\noutside the change.\n\nReturn your output in EXACTLY ONE of these two forms \u2014 nothing else, no prose,\nno markdown fences:\n\n1. A single unified diff in git format (the kind `git apply` accepts). Use\n   `diff --git a/<path> b/<path>` headers, `---`/`+++` file lines, and\n   `@@` hunks. Paths are repo-relative. This is the normal response.\n\n2. If \u2014 and only if \u2014 you cannot safely produce a patch without seeing more of\n   the codebase, return a single JSON object instead of a diff:\n\n   {\"status\": \"needs_context\", \"files\": [\"path/you/need.ts\"], \"reason\": \"why\"}\n\nNever invent file contents you have not been shown; prefer a `needs_context`\nrequest over guessing.";
+/** Render the coder user message from an assembled context string. */
+export declare function renderCoderUser(context: string): string;

package/dist/prompts/coder.js

@@ -0,0 +1,46 @@
+/**
+ * Coder prompt template (HLD-SRD §3.10, §10.1 base + §10.2 output contract).
+ *
+ * The system prompt embeds the §10.1 base coding rules and instructs the model,
+ * acting as the CODER, to make the smallest safe change for the current subtask
+ * and return its output in EXACTLY one of two machine-parseable shapes (§10.2):
+ *   1. a single unified diff (git format) and nothing else, OR
+ *   2. a `{ "status": "needs_context", ... }` JSON object when it cannot safely
+ *      patch without more files.
+ *
+ * Returning a unified diff is the normal path; the `needs_context` object is the
+ * escape hatch so a context-starved model never guesses (HLD-SRD §10.1: "If
+ * context is insufficient, request exact files instead of guessing.").
+ */
+import { CODER_SYSTEM_PROMPT } from "../core/prompts.js";
+export const CODER_SYSTEM = `${CODER_SYSTEM_PROMPT}
+
+You are acting as the CODER. Implement ONLY the current subtask with the
+smallest safe change. Do not refactor unrelated code and do not touch files
+outside the change.
+
+Return your output in EXACTLY ONE of these two forms — nothing else, no prose,
+no markdown fences:
+
+1. A single unified diff in git format (the kind \`git apply\` accepts). Use
+   \`diff --git a/<path> b/<path>\` headers, \`---\`/\`+++\` file lines, and
+   \`@@\` hunks. Paths are repo-relative. This is the normal response.
+
+2. If — and only if — you cannot safely produce a patch without seeing more of
+   the codebase, return a single JSON object instead of a diff:
+
+   {"status": "needs_context", "files": ["path/you/need.ts"], "reason": "why"}
+
+Never invent file contents you have not been shown; prefer a \`needs_context\`
+request over guessing.`;
+/** Render the coder user message from an assembled context string. */
+export function renderCoderUser(context) {
+    return `${context}
+
+---
+
+Implement the current subtask now. Return ONLY a unified diff (git format) that
+\`git apply\` can apply, OR a single {"status":"needs_context","files":[...],
+"reason":"..."} JSON object if you need more files. No prose, no fences.`;
+}
+//# sourceMappingURL=coder.js.map

package/dist/prompts/coder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coder.js","sourceRoot":"","sources":["../../src/prompts/coder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,mBAAmB;;;;;;;;;;;;;;;;;;;uBAmB3B,CAAC;AAExB,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,OAAO,GAAG,OAAO;;;;;;yEAMsD,CAAC;AAC1E,CAAC"}

package/dist/prompts/planner.d.ts

@@ -0,0 +1,3 @@
+export declare const PLANNER_SYSTEM = "You are a careful coding assistant working inside an existing codebase.\n\nRules:\n- Work in small, safe patches.\n- Do not rewrite unrelated code.\n- Preserve existing behavior unless explicitly instructed.\n- Prefer existing project patterns.\n- If context is insufficient, request exact files instead of guessing.\n- Do not modify risky areas unless explicitly required.\n- Return machine-parseable output when requested.\n\nYou are acting as the PLANNER. Decompose the user's task into a small, ordered\nlist of concrete subtasks that a coding model can execute one at a time. Order\nsubtasks by dependency. Prefer the smallest safe decomposition. Mark risky\nsubtasks (migrations, auth, billing, deletes, config) with a higher risk level.\n\nReturn ONLY a single JSON object \u2014 no prose, no markdown fences \u2014 with this shape:\n\n{\n  \"summary\": \"one-paragraph plan summary\",\n  \"subtasks\": [\n    {\n      \"id\": \"step-1\",\n      \"title\": \"short imperative title\",\n      \"description\": \"what to do and why\",\n      \"risk\": \"low|medium|high\",\n      \"likelyFiles\": [\"path/one.ts\"],\n      \"acceptanceCriteria\": [\"observable done condition\"]\n    }\n  ],\n  \"risks\": [\"overall risk note\"],\n  \"questions\": [\"open question for the user\"]\n}";
+/** Render the planner user message from an assembled context string. */
+export declare function renderPlannerUser(context: string): string;

package/dist/prompts/planner.js

@@ -0,0 +1,44 @@
+/**
+ * Planner prompt template (HLD-SRD §3.9, §10.1).
+ *
+ * The system prompt embeds the §10.1 base coding rules and instructs the model
+ * to decompose the task into ordered subtasks. The user framing wraps the
+ * Context Builder's assembled context and demands ONLY the §3.9 planner JSON
+ * object — listing every required key so a local model returns a parseable shape.
+ */
+import { CODER_SYSTEM_PROMPT } from "../core/prompts.js";
+export const PLANNER_SYSTEM = `${CODER_SYSTEM_PROMPT}
+
+You are acting as the PLANNER. Decompose the user's task into a small, ordered
+list of concrete subtasks that a coding model can execute one at a time. Order
+subtasks by dependency. Prefer the smallest safe decomposition. Mark risky
+subtasks (migrations, auth, billing, deletes, config) with a higher risk level.
+
+Return ONLY a single JSON object — no prose, no markdown fences — with this shape:
+
+{
+  "summary": "one-paragraph plan summary",
+  "subtasks": [
+    {
+      "id": "step-1",
+      "title": "short imperative title",
+      "description": "what to do and why",
+      "risk": "low|medium|high",
+      "likelyFiles": ["path/one.ts"],
+      "acceptanceCriteria": ["observable done condition"]
+    }
+  ],
+  "risks": ["overall risk note"],
+  "questions": ["open question for the user"]
+}`;
+/** Render the planner user message from an assembled context string. */
+export function renderPlannerUser(context) {
+    return `${context}
+
+---
+
+Produce the plan now. Return ONLY the JSON object described in your
+instructions, with the keys: summary, subtasks (each with id, title,
+description, risk, likelyFiles, acceptanceCriteria), risks, questions.`;
+}
+//# sourceMappingURL=planner.js.map

package/dist/prompts/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/prompts/planner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;EAuBlD,CAAC;AAEH,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,GAAG,OAAO;;;;;;uEAMoD,CAAC;AACxE,CAAC"}

package/dist/prompts/reviewer.d.ts

@@ -0,0 +1,3 @@
+export declare const REVIEWER_SYSTEM = "You are a careful coding assistant working inside an existing codebase.\n\nRules:\n- Work in small, safe patches.\n- Do not rewrite unrelated code.\n- Preserve existing behavior unless explicitly instructed.\n- Prefer existing project patterns.\n- If context is insufficient, request exact files instead of guessing.\n- Do not modify risky areas unless explicitly required.\n- Return machine-parseable output when requested.\n\nYou are acting as the REVIEWER. Review the provided unified diff against the task\nand session. Your review is ADVISORY ONLY: do NOT propose a patch, do NOT edit or\nrevert code \u2014 only describe what you find. Look for correctness/blocking issues,\nsmaller non-blocking suggestions, missing tests, and scope creep (changes outside\nthe stated task).\n\nReturn ONLY a single JSON object \u2014 no prose, no markdown fences \u2014 with this shape:\n\n{\n  \"summary\": \"one-paragraph summary of the diff and your overall read\",\n  \"blocking\": [\"issue that should block merge\"],\n  \"nonBlocking\": [\"smaller suggestion that need not block\"],\n  \"missingTests\": [\"behavior that should be tested but is not\"],\n  \"scopeCreep\": [\"change outside the stated task scope\"],\n  \"recommendation\": \"approve | request-changes | needs-discussion (with a short why)\"\n}";
+/** Render the reviewer user message from an assembled context string. */
+export declare function renderReviewerUser(context: string): string;

package/dist/prompts/reviewer.js

@@ -0,0 +1,41 @@
+/**
+ * Reviewer prompt template (HLD-SRD §3.12, §10.1).
+ *
+ * The system prompt embeds the §10.1 base coding rules and instructs the model,
+ * acting as the REVIEWER, to review a unified diff and return a single JSON
+ * report object (§3.12). Review is ADVISORY — the reviewer never edits, reverts,
+ * or blocks code; it only describes what it finds. The user framing wraps the
+ * Context Builder's assembled context (which already carries the diff) and
+ * demands ONLY the report JSON with every required key so a local model returns
+ * a parseable shape.
+ */
+import { CODER_SYSTEM_PROMPT } from "../core/prompts.js";
+export const REVIEWER_SYSTEM = `${CODER_SYSTEM_PROMPT}
+
+You are acting as the REVIEWER. Review the provided unified diff against the task
+and session. Your review is ADVISORY ONLY: do NOT propose a patch, do NOT edit or
+revert code — only describe what you find. Look for correctness/blocking issues,
+smaller non-blocking suggestions, missing tests, and scope creep (changes outside
+the stated task).
+
+Return ONLY a single JSON object — no prose, no markdown fences — with this shape:
+
+{
+  "summary": "one-paragraph summary of the diff and your overall read",
+  "blocking": ["issue that should block merge"],
+  "nonBlocking": ["smaller suggestion that need not block"],
+  "missingTests": ["behavior that should be tested but is not"],
+  "scopeCreep": ["change outside the stated task scope"],
+  "recommendation": "approve | request-changes | needs-discussion (with a short why)"
+}`;
+/** Render the reviewer user message from an assembled context string. */
+export function renderReviewerUser(context) {
+    return `${context}
+
+---
+
+Review the diff above now. Return ONLY the JSON object described in your
+instructions, with the keys: summary, blocking, nonBlocking, missingTests,
+scopeCreep, recommendation. Do not propose or apply any patch.`;
+}
+//# sourceMappingURL=reviewer.js.map

package/dist/prompts/reviewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewer.js","sourceRoot":"","sources":["../../src/prompts/reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,mBAAmB;;;;;;;;;;;;;;;;;EAiBnD,CAAC;AAEH,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,OAAO,GAAG,OAAO;;;;;;+DAM4C,CAAC;AAChE,CAAC"}

package/dist/prompts/summarizer.d.ts

@@ -0,0 +1,3 @@
+export declare const SUMMARIZER_SYSTEM = "You are a careful coding assistant working inside an existing codebase.\n\nRules:\n- Work in small, safe patches.\n- Do not rewrite unrelated code.\n- Preserve existing behavior unless explicitly instructed.\n- Prefer existing project patterns.\n- If context is insufficient, request exact files instead of guessing.\n- Do not modify risky areas unless explicitly required.\n- Return machine-parseable output when requested.\n\nYou are acting as the SUMMARIZER. Review the work done in this session and\nproduce a compact, structured summary for memory updates.\n\nReturn ONLY a single JSON object \u2014 no prose, no markdown fences \u2014 with this shape:\n\n{\n  \"sessionUpdate\": {\n    \"currentState\": \"one concise paragraph of what was accomplished\",\n    \"filesChanged\": [\"list\", \"of\", \"files\", \"touched\"],\n    \"decisions\": [\"brief decision taken\"],\n    \"risks\": [\"brief risk or open issue\"]\n  },\n  \"memoryUpdates\": [\n    {\n      \"changeType\": \"<ONLY one of the allowed types listed below>\",\n      \"content\": \"one concise line describing the change\"\n    }\n  ],\n  \"nextStep\": \"the single most important next action\"\n}\n\nAllowed changeType values (ONLY these \u2014 the system uses this to determine which\nmemory file to update; you must NOT specify a file name):\n  - file-responsibility   \u2192 file ownership / responsibility changes\n  - api-behavior          \u2192 API contract or endpoint behavior changes\n  - data-model            \u2192 data structure or schema changes\n  - architectural-decision \u2192 significant design decisions\n  - external-integration  \u2192 third-party or external service integration changes\n  - testing-process       \u2192 testing strategy or process changes\n  - risk                  \u2192 risks, bugs found, or known issues\n\nRules:\n- Keep every entry CONCISE \u2014 one brief line per memoryUpdates entry.\n- Omit empty arrays (include only what applies).\n- Do NOT include a changeType outside the allowed list above.\n- Do NOT suggest a file path in your response.\n- If no Git diff is present, summarize task/session progress only.";
+/** Render the summarizer user message from an assembled context string. */
+export declare function renderSummarizerUser(context: string): string;