localptp 0.1.0

package/dist/core/safetyManager.js

@@ -0,0 +1,202 @@
+/**
+ * Safety Manager — enforcement of HLD-SRD §11/§13 (pure).
+ *
+ * `evaluate(plan, config, root)` is a PURE function over a parsed `PatchPlan`
+ * plus config: no fs, no git, fully unit-testable. It returns a `SafetyVerdict`
+ * the `step` command acts on — `refuse` stops with the matching message;
+ * `allow` may carry `needsConfirm` prompts (`risky-path`, `delete`).
+ *
+ * Gate ordering (fail-fast, before any write — design.md "Safety gate ordering"):
+ *   1. binary patch                              → refuse
+ *   2. any path escaping root                    → refuse (§13)
+ *   3. any ignored/generated file                → refuse (§3.10)
+ *   4. touched files > maxChangedFilesPerStep     → refuse (§11)
+ *   5. any risky-path match (incl `.env*`)        → needsConfirm += 'risky-path' (§13)
+ *   6. any delete                                 → needsConfirm += 'delete'      (§13)
+ *
+ * The git-dependent gates (working-tree-safe, `git apply --check`) live in the
+ * command because they need the repo; `evaluate` is deliberately git-free.
+ *
+ * Path normalization (so the risky/ignore globs match regardless of diff form):
+ * strip a leading `a/`/`b/` prefix, convert `\` to `/`, drop `./` and a leading
+ * `/`. Globs are matched dotfile-aware so `.env*` hits `.env` and `.env.local`.
+ */
+import path from "node:path";
+// ---------------------------------------------------------------------------
+// Path normalization + glob matching
+// ---------------------------------------------------------------------------
+/** Repo-relative POSIX form for matching. The plan paths are ALREADY prefix-
+ * stripped by `parsePatch`, so this does NOT re-strip an `a/`/`b/` prefix (that
+ * would corrupt a real path whose first segment is literally `a`/`b`). Absolute
+ * markers are caught by the escape gate, which runs first. */
+function normalize(p) {
+    let s = p.replace(/\\/g, "/").replace(/^\.\//, "");
+    while (s.startsWith("/"))
+        s = s.slice(1);
+    return s;
+}
+/** Lexical root-escape detection (mirrors patchManager's lexical checks). */
+function escapesRootLexically(p) {
+    const raw = p.replace(/\\/g, "/");
+    if (path.isAbsolute(p) || /^[A-Za-z]:[\\/]/.test(p) || raw.startsWith("/")) {
+        return true;
+    }
+    const stripped = raw.replace(/^[ab]\//, "").replace(/^\.\//, "");
+    const normalized = path.posix.normalize(stripped);
+    return normalized === ".." || normalized.startsWith("../");
+}
+/**
+ * Convert a glob to a RegExp, dotfile-aware. Supports `**` (any path span,
+ * including across `/`), `*` (any run within a segment, including a leading
+ * dot), and `?`. A leading `**` followed by a slash may match zero leading
+ * segments so a `auth` glob matches `auth/x` as well as `src/auth/x`.
+ */
+function globToRegExp(glob) {
+    const g = glob.replace(/\\/g, "/");
+    let re = "";
+    for (let i = 0; i < g.length; i++) {
+        const c = g[i];
+        if (c === "*") {
+            if (g[i + 1] === "*") {
+                // `**` — match any characters including `/`.
+                i += 1;
+                if (g[i + 1] === "/") {
+                    // `**/` — also allow zero leading segments.
+                    i += 1;
+                    re += "(?:.*/)?";
+                }
+                else {
+                    re += ".*";
+                }
+            }
+            else {
+                // `*` — any run within a segment (no `/`).
+                re += "[^/]*";
+            }
+        }
+        else if (c === "?") {
+            re += "[^/]";
+        }
+        else if (".+^${}()|[]\\".includes(c)) {
+            re += "\\" + c;
+        }
+        else {
+            re += c;
+        }
+    }
+    return new RegExp(`^${re}$`);
+}
+/**
+ * Secret/`.env*` patterns that are ALWAYS risky (HLD-SRD §13: no secret
+ * auto-modify) regardless of `config.safety.riskyPaths`. A user who customizes
+ * `riskyPaths` and drops `.env*` must still get the secret confirmation — the
+ * guarantee is enforced here, not left to config.
+ */
+const ALWAYS_RISKY = [".env*", "**/.env*"];
+/** Does any configured (or always-risky) glob match the normalized path? */
+function isRiskyPath(rel, riskyPaths) {
+    const basename = rel.split("/").pop() ?? rel;
+    for (const glob of [...ALWAYS_RISKY, ...riskyPaths]) {
+        const re = globToRegExp(glob);
+        if (re.test(rel))
+            return true;
+        // A bare-name / basename glob (e.g. `.env*`) should also match the file's
+        // basename anywhere in the tree (e.g. `config/.env.local`).
+        if (!glob.includes("/") && re.test(basename))
+            return true;
+    }
+    return false;
+}
+/** Ignore semantics shared with the indexer / patchManager. */
+function isIgnored(rel, config) {
+    const parts = rel.split("/");
+    const basename = parts[parts.length - 1];
+    const baseline = new Set([
+        ".git",
+        "node_modules",
+        "dist",
+        "build",
+        ".next",
+        "coverage",
+        ".ai-orchestrator",
+    ]);
+    for (const seg of parts) {
+        if (baseline.has(seg))
+            return true;
+    }
+    for (const pat of config.ignore) {
+        if (rel === pat)
+            return true;
+        if (rel.startsWith(pat + "/"))
+            return true;
+        if (basename === pat)
+            return true;
+        if (parts.includes(pat))
+            return true;
+    }
+    return false;
+}
+// ---------------------------------------------------------------------------
+// evaluate
+// ---------------------------------------------------------------------------
+/**
+ * Evaluate a parsed plan against the safety config. Pure — `root` is accepted
+ * for parity with the wider seam but not dereferenced (no fs/git here).
+ */
+export function evaluate(plan, config, _root) {
+    const reasons = [];
+    // 1. Binary.
+    if (plan.isBinary) {
+        return {
+            decision: "refuse",
+            needsConfirm: [],
+            reasons: ["Binary patch not supported (§13)."],
+        };
+    }
+    // 2. Path escape (§13).
+    for (const p of plan.touchedFiles) {
+        if (escapesRootLexically(p)) {
+            return {
+                decision: "refuse",
+                needsConfirm: [],
+                reasons: [`Path escapes the repository root: ${p} (§13).`],
+            };
+        }
+    }
+    // 3. Ignored / generated (§3.10).
+    for (const p of plan.touchedFiles) {
+        const rel = normalize(p);
+        if (isIgnored(rel, config)) {
+            return {
+                decision: "refuse",
+                needsConfirm: [],
+                reasons: [`Patch touches an ignored/generated file: ${rel} (§3.10).`],
+            };
+        }
+    }
+    // 4. Changed-file cap (§11).
+    if (plan.touchedFiles.length > config.safety.maxChangedFilesPerStep) {
+        return {
+            decision: "refuse",
+            needsConfirm: [],
+            reasons: [
+                `Too many changed files: ${plan.touchedFiles.length} > ` +
+                    `maxChangedFilesPerStep (${config.safety.maxChangedFilesPerStep}) (§11).`,
+            ],
+        };
+    }
+    // 5. Risky path (§13) — second confirmation, never auto-approved.
+    const needsConfirm = [];
+    const riskyHit = plan.touchedFiles.some((p) => isRiskyPath(normalize(p), config.safety.riskyPaths));
+    if (riskyHit) {
+        needsConfirm.push("risky-path");
+        reasons.push("Patch touches a configured risky path (§13).");
+    }
+    // 6. Delete (§13) — explicit deletion confirmation.
+    if (plan.deletes.length > 0) {
+        needsConfirm.push("delete");
+        reasons.push("Patch deletes one or more files (§13).");
+    }
+    return { decision: "allow", needsConfirm, reasons };
+}
+//# sourceMappingURL=safetyManager.js.map

package/dist/core/safetyManager.js.map

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

package/dist/core/sessionManager.d.ts

@@ -0,0 +1,35 @@
+import type { Session } from "../types/session.js";
+import type { Task, TaskStatus } from "../types/task.js";
+export interface CreateSessionOptions {
+    now?: Date;
+}
+/** Build a typed Session from a markdown string. */
+export declare function parseSessionString(filePath: string, md: string): Session;
+/**
+ * Create a session file for `task` under `sessionsDir`. Never overwrites: a
+ * filename collision appends `-2`, `-3`, …
+ */
+export declare function createSession(sessionsDir: string, task: Task, opts?: CreateSessionOptions): Promise<Session>;
+export interface SessionPatch {
+    status?: TaskStatus;
+    currentState?: string;
+    nextStep?: string;
+    /** Lines written into `## Risks / Not Verified`. */
+    risks?: string[];
+    /** Lines appended to `## Decisions`. */
+    decisions?: string[];
+    objective?: string;
+}
+/**
+ * Apply a section-scoped patch to a session and persist it. `risks` overwrites
+ * the Risks section; `decisions` is appended to the Decisions section, keeping
+ * any prior decisions. The `Updated:` line is refreshed.
+ */
+export declare function updateSession(session: Session, patch: SessionPatch, opts?: CreateSessionOptions): Promise<Session>;
+/** Read + parse a session from disk. */
+export declare function loadSession(filePath: string): Promise<Session>;
+/**
+ * List sessions newest-first (by mtime; name tiebreak). Each entry is a parsed
+ * Session carrying status + Next-Step preview. A missing dir → empty array.
+ */
+export declare function listSessions(sessionsDir: string): Promise<Session[]>;

package/dist/core/sessionManager.js

@@ -0,0 +1,265 @@
+/**
+ * Session Manager (HLD-SRD §3.6).
+ *
+ * Creates `/ai/sessions/YYYY-MM-DD_HHMM_slug_session.md` files paired to a task,
+ * applies section-scoped updates (Current State / Next Step / Risks / Decisions),
+ * loads a session back into a typed `Session`, and lists sessions newest-first
+ * with a Next-Step preview. Section edits preserve content elsewhere.
+ */
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { ensureDir } from "../utils/fs.js";
+// ---------------------------------------------------------------------------
+// Timestamp helpers
+// ---------------------------------------------------------------------------
+function pad(n) {
+    return String(n).padStart(2, "0");
+}
+function dateStamp(d) {
+    return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+}
+function timeStamp(d) {
+    return `${pad(d.getHours())}${pad(d.getMinutes())}`;
+}
+function fullStamp(d) {
+    return `${dateStamp(d)} ${pad(d.getHours())}:${pad(d.getMinutes())}`;
+}
+// ---------------------------------------------------------------------------
+// Section helpers (level-aware, shared shape with taskManager)
+// ---------------------------------------------------------------------------
+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## ${heading}\n${newBody}\n`;
+    }
+    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);
+    return [...before, headingLine, newBody, ...after].join("\n");
+}
+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;
+}
+// ---------------------------------------------------------------------------
+// Field parsing
+// ---------------------------------------------------------------------------
+function parseTaskRef(md) {
+    const m = /^Task:\s*(.*?)\s*$/m.exec(md);
+    return m?.[1] ?? "";
+}
+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+Session:\s*(.*?)\s*$/m.exec(md);
+    return m?.[1] ?? "";
+}
+// ---------------------------------------------------------------------------
+// Slug from task path
+// ---------------------------------------------------------------------------
+/** Strip the `YYYY-MM-DD_HHMM_` prefix and `.md` suffix from a task basename. */
+function slugFromTaskPath(taskPath) {
+    const base = path.basename(taskPath).replace(/\.md$/i, "");
+    const m = /^\d{4}-\d{2}-\d{2}_\d{4}_(.*)$/.exec(base);
+    return m?.[1] ?? base;
+}
+function renderSessionFile(task, now) {
+    const stamp = fullStamp(now);
+    return [
+        `# Session: ${task.title}`,
+        "",
+        `Created: ${stamp}`,
+        `Updated: ${stamp}`,
+        `Task: ${task.path}`,
+        "Status: active",
+        "",
+        "## Objective",
+        task.goal,
+        "",
+        "## Current State",
+        "Not started.",
+        "",
+        "## Files Inspected",
+        "| File | Reason | Findings |",
+        "|---|---|---|",
+        "",
+        "## Changes Made",
+        "| File | Change |",
+        "|---|---|",
+        "",
+        "## Decisions",
+        "",
+        "## Risks / Not Verified",
+        "",
+        "## Tests",
+        "- Not run yet",
+        "",
+        "## Next Step",
+        "Run `localptp plan` to decompose the task.",
+        "",
+    ].join("\n");
+}
+/** Build a typed Session from a markdown string. */
+export function parseSessionString(filePath, md) {
+    return {
+        path: filePath,
+        taskPath: parseTaskRef(md),
+        status: parseStatus(md),
+        objective: sectionBody(md, "Objective") ?? "",
+        currentState: sectionBody(md, "Current State") ?? "",
+        nextStep: sectionBody(md, "Next Step") ?? "",
+        raw: md,
+    };
+}
+/**
+ * Create a session file for `task` under `sessionsDir`. Never overwrites: a
+ * filename collision appends `-2`, `-3`, …
+ */
+export async function createSession(sessionsDir, task, opts = {}) {
+    const now = opts.now ?? new Date();
+    await ensureDir(sessionsDir);
+    const slug = slugFromTaskPath(task.path);
+    const base = `${dateStamp(now)}_${timeStamp(now)}_${slug}_session`;
+    const content = renderSessionFile(task, now);
+    let attempt = 0;
+    for (;;) {
+        const name = attempt === 0 ? `${base}.md` : `${base}-${attempt + 1}.md`;
+        const full = path.join(sessionsDir, name);
+        try {
+            await fs.writeFile(full, content, { encoding: "utf8", flag: "wx" });
+            return parseSessionString(full, content);
+        }
+        catch (err) {
+            if (err.code === "EEXIST") {
+                attempt += 1;
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+function asBullets(items) {
+    return items.map((i) => `- ${i}`).join("\n");
+}
+/**
+ * Apply a section-scoped patch to a session and persist it. `risks` overwrites
+ * the Risks section; `decisions` is appended to the Decisions section, keeping
+ * any prior decisions. The `Updated:` line is refreshed.
+ */
+export async function updateSession(session, patch, opts = {}) {
+    const now = opts.now ?? new Date();
+    let raw = session.raw;
+    if (patch.objective !== undefined) {
+        raw = replaceSection(raw, "Objective", `\n${patch.objective}\n`);
+    }
+    if (patch.currentState !== undefined) {
+        raw = replaceSection(raw, "Current State", `\n${patch.currentState}\n`);
+    }
+    if (patch.nextStep !== undefined) {
+        raw = replaceSection(raw, "Next Step", `\n${patch.nextStep}\n`);
+    }
+    if (patch.risks !== undefined) {
+        const body = patch.risks.length > 0 ? `\n${asBullets(patch.risks)}\n` : "\n";
+        raw = replaceSection(raw, "Risks / Not Verified", body);
+    }
+    if (patch.decisions !== undefined && patch.decisions.length > 0) {
+        const existing = sectionBody(raw, "Decisions");
+        const merged = existing
+            ? `${existing}\n${asBullets(patch.decisions)}`
+            : asBullets(patch.decisions);
+        raw = replaceSection(raw, "Decisions", `\n${merged}\n`);
+    }
+    if (patch.status !== undefined) {
+        raw = raw.replace(/^Status:\s*.*$/m, `Status: ${patch.status}`);
+    }
+    // Refresh the Updated: line.
+    raw = raw.replace(/^Updated:\s*.*$/m, `Updated: ${fullStamp(now)}`);
+    await fs.writeFile(session.path, raw, "utf8");
+    return parseSessionString(session.path, raw);
+}
+/** Read + parse a session from disk. */
+export async function loadSession(filePath) {
+    const md = await fs.readFile(filePath, "utf8");
+    return parseSessionString(filePath, md);
+}
+/**
+ * List sessions newest-first (by mtime; name tiebreak). Each entry is a parsed
+ * Session carrying status + Next-Step preview. A missing dir → empty array.
+ */
+export async function listSessions(sessionsDir) {
+    let entries;
+    try {
+        entries = await fs.readdir(sessionsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const items = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.toLowerCase().endsWith(".md"))
+            continue;
+        const full = path.join(sessionsDir, entry.name);
+        try {
+            const stat = await fs.stat(full);
+            const md = await fs.readFile(full, "utf8");
+            items.push({
+                session: parseSessionString(full, md),
+                mtimeMs: stat.mtimeMs,
+                name: entry.name,
+            });
+        }
+        catch {
+            // Skip unreadable entries.
+        }
+    }
+    items.sort((a, b) => {
+        if (b.mtimeMs !== a.mtimeMs)
+            return b.mtimeMs - a.mtimeMs;
+        return b.name.localeCompare(a.name);
+    });
+    return items.map((i) => i.session);
+}
+//# sourceMappingURL=sessionManager.js.map

package/dist/core/sessionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionManager.js","sourceRoot":"","sources":["../../src/core/sessionManager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI3C,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,SAAS,GAAG,CAAC,CAAS;IACpB,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,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,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,SAAS,SAAS,CAAC,CAAO;IACxB,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,+DAA+D;AAC/D,8EAA8E;AAE9E,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,QAAQ,OAAO,KAAK,OAAO,IAAI,CAAC;IACpD,CAAC;IACD,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,OAAO,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,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,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,YAAY,CAAC,EAAU;IAC9B,MAAM,CAAC,GAAG,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,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,4BAA4B,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E,iFAAiF;AACjF,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxB,CAAC;AAUD,SAAS,iBAAiB,CAAC,IAAU,EAAE,GAAS;IAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,OAAO;QACL,cAAc,IAAI,CAAC,KAAK,EAAE;QAC1B,EAAE;QACF,YAAY,KAAK,EAAE;QACnB,YAAY,KAAK,EAAE;QACnB,SAAS,IAAI,CAAC,IAAI,EAAE;QACpB,gBAAgB;QAChB,EAAE;QACF,cAAc;QACd,IAAI,CAAC,IAAI;QACT,EAAE;QACF,kBAAkB;QAClB,cAAc;QACd,EAAE;QACF,oBAAoB;QACpB,8BAA8B;QAC9B,eAAe;QACf,EAAE;QACF,iBAAiB;QACjB,mBAAmB;QACnB,WAAW;QACX,EAAE;QACF,cAAc;QACd,EAAE;QACF,yBAAyB;QACzB,EAAE;QACF,UAAU;QACV,eAAe;QACf,EAAE;QACF,cAAc;QACd,4CAA4C;QAC5C,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,oDAAoD;AACpD,MAAM,UAAU,kBAAkB,CAAC,QAAgB,EAAE,EAAU;IAC7D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,YAAY,CAAC,EAAE,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC,EAAE,CAAC;QACvB,SAAS,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE;QAC7C,YAAY,EAAE,WAAW,CAAC,EAAE,EAAE,eAAe,CAAC,IAAI,EAAE;QACpD,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,IAAI,EAAE;QAC5C,GAAG,EAAE,EAAE;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,WAAmB,EACnB,IAAU,EACV,OAA6B,EAAE;IAE/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;IAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,IAAI,UAAU,CAAC;IACnE,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,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,WAAW,EAAE,IAAI,CAAC,CAAC;QAC1C,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,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC3C,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;AAaD,SAAS,SAAS,CAAC,KAAe;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAgB,EAChB,KAAmB,EACnB,OAA6B,EAAE;IAE/B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;IACnC,IAAI,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAEtB,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,KAAK,CAAC,SAAS,IAAI,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,KAAK,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrC,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACjC,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7E,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,QAAQ;YACrB,CAAC,CAAC,GAAG,QAAQ,KAAK,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;YAC9C,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/B,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,KAAK,MAAM,IAAI,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,6BAA6B;IAC7B,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,YAAY,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEpE,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,OAAO,kBAAkB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,IAAI,OAAmC,CAAC;IACxC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,KAAK,GAA0D,EAAE,CAAC;IACxE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC3E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,KAAK,CAAC,IAAI,CAAC;gBACT,OAAO,EAAE,kBAAkB,CAAC,IAAI,EAAE,EAAE,CAAC;gBACrC,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,2BAA2B;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAClB,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO;YAAE,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;QAC1D,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACrC,CAAC"}

package/dist/core/stopConditions.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Stop conditions for the `run` loop (HLD-SRD §11.2; 0001_06).
+ *
+ * `decideStop` is a PURE function over the latest `StepOutcome`, the loop state,
+ * and the config. It returns a named `StopReason` to stop, or `null` to
+ * continue. Keeping it pure makes every §11.2 condition independently
+ * unit-testable with scripted outcomes and keeps the loop driver thin.
+ *
+ * Decision order (design.md "decideStop"):
+ *   1. a stopReason bubbled up from `runStep` (safety refusal, approval denied,
+ *      unparseable, patch-invalid, repeated-failure, …) — return it verbatim;
+ *   2. no pending subtask AND nothing applied → `acceptance-met` (the MVP
+ *      acceptance heuristic: no pending subtasks remain);
+ *   3. tests still failing AND the fix-attempt budget is exhausted →
+ *      `repeated-failure` (a safety net; `runStep` normally sets this itself,
+ *      and it also covers the `maxFailedFixAttempts = 0` boundary);
+ *   4. otherwise → `null` (continue).
+ *
+ * `iteration-cap-exceeded` is produced by the loop driver on cap fall-through,
+ * not here; but if a caller ever sets it as a stopReason, branch 1 bubbles it.
+ */
+import type { AppConfig } from "../types/config.js";
+import type { LoopState, StepOutcome, StopReason } from "../types/run.js";
+export declare function decideStop(outcome: StepOutcome, _state: LoopState, config: AppConfig): StopReason | null;

package/dist/core/stopConditions.js

@@ -0,0 +1,18 @@
+function testsFailing(outcome) {
+    return outcome.testResults.some((r) => r.exitCode !== 0);
+}
+export function decideStop(outcome, _state, config) {
+    // 1. A stop reason bubbled up from the step core wins.
+    if (outcome.stopReason !== undefined)
+        return outcome.stopReason;
+    // 2. No pending subtask and nothing applied → acceptance met.
+    if (outcome.subtaskId === null && !outcome.applied)
+        return "acceptance-met";
+    // 3. Tests still failing after the fix budget is exhausted → repeated failure.
+    if (testsFailing(outcome) && outcome.fixAttempts >= config.safety.maxFailedFixAttempts) {
+        return "repeated-failure";
+    }
+    // 4. Continue.
+    return null;
+}
+//# sourceMappingURL=stopConditions.js.map

package/dist/core/stopConditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stopConditions.js","sourceRoot":"","sources":["../../src/core/stopConditions.ts"],"names":[],"mappings":"AAwBA,SAAS,YAAY,CAAC,OAAoB;IACxC,OAAO,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,UAAU,CACxB,OAAoB,EACpB,MAAiB,EACjB,MAAiB;IAEjB,uDAAuD;IACvD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,UAAU,CAAC;IAEhE,8DAA8D;IAC9D,IAAI,OAAO,CAAC,SAAS,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,gBAAgB,CAAC;IAE5E,+EAA+E;IAC/E,IAAI,YAAY,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,WAAW,IAAI,MAAM,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;QACvF,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,eAAe;IACf,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/core/taskManager.d.ts

@@ -0,0 +1,26 @@
+import type { Task, Subtask } from "../types/task.js";
+/**
+ * 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 declare function slugify(text: string): string;
+export interface CreateTaskOptions {
+    /** Injectable clock for deterministic tests. */
+    now?: Date;
+}
+/**
+ * Create a new task file under `tasksDir`. Never overwrites: on a filename
+ * collision (same timestamp+slug) appends `-2`, `-3`, … Returns the parsed Task.
+ */
+export declare function createTask(tasksDir: string, text: string, opts?: CreateTaskOptions): Promise<Task>;
+/** Parse a task markdown string into a typed Task. */
+export declare function parseTaskString(filePath: string, md: string): Task;
+/** Read + parse a task file from disk. */
+export declare function parseTask(filePath: string): Promise<Task>;
+/**
+ * Return a Task whose `## Subtasks` block (in `raw`) is rewritten to `subtasks`,
+ * preserving all other content. Pure: callers persist via `serializeTask`.
+ */
+export declare function setSubtasks(task: Task, subtasks: Subtask[]): Task;
+/** The markdown to persist for a Task (its `raw`). */
+export declare function serializeTask(task: Task): string;