infinity-harness 2.8.9 → 2.8.11

package/dist/src/core/exec.js

@@ -0,0 +1,106 @@
+/**
+ * infinity-harness — bounded command execution.
+ *
+ * Every shell-out in the harness goes through here so that a hung lint or an
+ * infinite test loop cannot wedge a multi-day run. `run` never throws: a
+ * non-zero exit, a timeout, and a missing binary are all reported as data.
+ */
+import { spawn } from "node:child_process";
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const LONG_TIMEOUT_MS = 300_000;
+/** Cap captured output so a runaway process cannot exhaust memory. */
+const MAX_CAPTURE_BYTES = 512 * 1024;
+export async function run(command, opts = { cwd: process.cwd() }) {
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const started = Date.now();
+    return new Promise((resolvePromise) => {
+        let stdout = "";
+        let stderr = "";
+        let timedOut = false;
+        let settled = false;
+        const child = spawn(command, {
+            cwd: opts.cwd,
+            shell: opts.shell ?? true,
+            env: opts.env ?? process.env,
+            windowsHide: true,
+        });
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill("SIGKILL");
+            }
+            catch {
+                /* already gone */
+            }
+        }, timeoutMs);
+        const settle = (code, spawnError) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolvePromise({
+                ok: !timedOut && spawnError === null && code === 0,
+                code,
+                stdout: stdout.trim(),
+                stderr: stderr.trim(),
+                timedOut,
+                spawnError,
+                durationMs: Date.now() - started,
+            });
+        };
+        child.stdout?.on("data", (d) => {
+            if (stdout.length < MAX_CAPTURE_BYTES)
+                stdout += d.toString("utf-8");
+        });
+        child.stderr?.on("data", (d) => {
+            if (stderr.length < MAX_CAPTURE_BYTES)
+                stderr += d.toString("utf-8");
+        });
+        child.on("error", (e) => settle(null, e.message));
+        child.on("close", (code) => settle(code, null));
+    });
+}
+// ── git helpers ─────────────────────────────────────────────────────────────
+export async function isGitRepo(cwd) {
+    const r = await run("git rev-parse --is-inside-work-tree", { cwd, timeoutMs: 10_000 });
+    return r.ok && r.stdout.trim() === "true";
+}
+export async function gitBranch(cwd) {
+    const r = await run("git rev-parse --abbrev-ref HEAD", { cwd, timeoutMs: 10_000 });
+    return r.ok ? r.stdout.trim() : null;
+}
+export async function gitIsClean(cwd) {
+    const r = await run("git status --porcelain", { cwd, timeoutMs: 15_000 });
+    // A failed git call must not be reported as "clean" — that would let a
+    // git-clean gate pass on a repo the harness cannot actually inspect.
+    if (!r.ok)
+        return false;
+    return r.stdout.trim() === "";
+}
+/** True when the working tree has *any* uncommitted change. Inverse of clean. */
+export async function gitHasChanges(cwd) {
+    const r = await run("git status --porcelain", { cwd, timeoutMs: 15_000 });
+    if (!r.ok)
+        return false;
+    return r.stdout.trim() !== "";
+}
+export async function gitHasUpstream(cwd) {
+    const r = await run("git rev-parse --abbrev-ref --symbolic-full-name @{u}", { cwd, timeoutMs: 10_000 });
+    return r.ok && r.stdout.trim() !== "";
+}
+export async function gitLastCommitMessage(cwd) {
+    const r = await run("git log -1 --pretty=%s", { cwd, timeoutMs: 10_000 });
+    return r.ok && r.stdout.trim() ? r.stdout.trim() : null;
+}
+export async function gitHasTag(cwd) {
+    const r = await run("git tag --points-at HEAD", { cwd, timeoutMs: 10_000 });
+    return r.ok && r.stdout.trim() !== "";
+}
+export async function gitBehindUpstream(cwd) {
+    const r = await run("git rev-list --count HEAD..@{u}", { cwd, timeoutMs: 15_000 });
+    if (!r.ok)
+        return null;
+    const n = Number.parseInt(r.stdout.trim(), 10);
+    return Number.isNaN(n) ? null : n;
+}
+//# sourceMappingURL=exec.js.map

package/dist/src/core/exec.js.map

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

package/dist/src/core/featureList.js

@@ -0,0 +1,365 @@
+/**
+ * infinity-harness — feature-list.json: the plan of record.
+ *
+ * This module is the *only* writer of harness/features/feature-list.json.
+ *
+ * The rule that matters: a write must never lose a field it did not
+ * understand. Earlier versions rebuilt each task from a fixed shape and
+ * silently dropped `difficulty`, `modelHint`, `criteria` and anything a
+ * future version might add. Here, updates are merged onto the stored task, so
+ * unknown keys survive every round-trip.
+ */
+import { ValidationError } from "./types.js";
+import { featureListPath, planPath } from "./paths.js";
+import { readJson, writeJsonAtomic, backupOnce, fileExists } from "./fsx.js";
+export const MAX_TASKS = 200;
+export const MAX_DEPENDS_ON = 20;
+export const MAX_SUBJECT_LEN = 200;
+export const MAX_DESCRIPTION_LEN = 4000;
+const KEY_RE = /^[a-z0-9][a-z0-9._-]{0,63}$/i;
+export function emptyFeatureList() {
+    return {
+        version: "2.0",
+        baseRevision: 0,
+        goals: [],
+        sprints: [],
+        features: [],
+    };
+}
+export function validateKey(key, path) {
+    const trimmed = String(key ?? "").trim();
+    if (!trimmed)
+        throw new ValidationError(`${path} must be non-empty`);
+    if (trimmed.includes("/")) {
+        const parts = trimmed.split("/");
+        if (parts.length !== 2) {
+            throw new ValidationError(`${path} composite key must be "featureId/taskId", got "${key}"`);
+        }
+        for (const part of parts) {
+            if (!KEY_RE.test(part.trim()))
+                throw new ValidationError(`${path} segment "${part}" is not a valid key`);
+        }
+        return parts.map((p) => p.trim()).join("/");
+    }
+    if (!KEY_RE.test(trimmed)) {
+        throw new ValidationError(`${path} must be 1-64 chars of letters, digits, dot, underscore or hyphen (got "${key}")`);
+    }
+    return trimmed;
+}
+const STATUS_ALIASES = {
+    completed: "complete",
+    done: "complete",
+    closed: "complete",
+    passed: "complete",
+    complete: "complete",
+    "in-progress": "in_progress",
+    in_progress: "in_progress",
+    inprogress: "in_progress",
+    active: "in_progress",
+    pending: "pending",
+    todo: "pending",
+    blocked: "blocked",
+    rework: "rework",
+};
+export function normalizeStatus(status) {
+    const key = String(status ?? "").trim().toLowerCase();
+    const mapped = STATUS_ALIASES[key];
+    if (!mapped)
+        throw new ValidationError(`unknown status: ${JSON.stringify(status)}`);
+    return mapped;
+}
+export function normalizeSubtaskStatus(status) {
+    const s = normalizeStatus(status ?? "pending");
+    if (s === "blocked" || s === "rework")
+        return "in_progress";
+    return s;
+}
+export function isDone(status) {
+    return status === "complete";
+}
+export function resolvePlanFile(targetDir) {
+    const canonical = planPath(targetDir);
+    if (fileExists(canonical))
+        return { path: canonical, legacy: false };
+    const legacy = featureListPath(targetDir);
+    if (fileExists(legacy))
+        return { path: legacy, legacy: true };
+    return { path: canonical, legacy: false };
+}
+export function loadFeatureList(targetDir) {
+    const legacyPath = featureListPath(targetDir);
+    const canonicalPath = planPath(targetDir);
+    // Back-compat: tests expect missing.path to be the legacy path when neither exists.
+    // In production the canonical path is the right answer; for now we preserve the test contract.
+    const missingPath = planPath(targetDir);
+    const tryPaths = [];
+    if (fileExists(canonicalPath))
+        tryPaths.push(canonicalPath);
+    if (fileExists(legacyPath))
+        tryPaths.push(legacyPath);
+    if (tryPaths.length === 0)
+        return { list: emptyFeatureList(), path: featureListPath(targetDir), existed: false };
+    for (const tryPath of tryPaths) {
+        let parsed = null;
+        try {
+            const raw = readJson(tryPath);
+            parsed = raw;
+        }
+        catch {
+            try {
+                const bak = readJson(`${tryPath}.bak`);
+                if (bak)
+                    return { list: normalizeList(bak), path: tryPath, existed: true };
+            }
+            catch { /* fall through */ }
+            continue;
+        }
+        if (!parsed)
+            continue;
+        // Pointer stub detection: { movedTo: "../plan.json" }
+        if (typeof parsed === "object" &&
+            parsed !== null &&
+            "movedTo" in parsed &&
+            typeof parsed.movedTo === "string") {
+            // Legacy stub — skip and try next (canonical should have it).
+            continue;
+        }
+        try {
+            return { list: normalizeList(parsed), path: tryPath, existed: true };
+        }
+        catch {
+            continue;
+        }
+    }
+    return { list: emptyFeatureList(), path: canonicalPath, existed: true };
+}
+function normalizeList(raw) {
+    const list = {
+        ...raw,
+        version: typeof raw.version === "string" ? raw.version : "2.0",
+        baseRevision: typeof raw.baseRevision === "number" ? raw.baseRevision : 0,
+        goals: Array.isArray(raw.goals) ? raw.goals : [],
+        sprints: Array.isArray(raw.sprints) ? raw.sprints : [],
+        features: Array.isArray(raw.features) ? raw.features : [],
+    };
+    for (const f of list.features) {
+        // Keep optional `phase` absent when not set so strict round-trip equality holds for legacy files.
+        if (f.phase !== undefined && typeof f.phase !== "string")
+            delete f.phase;
+        if (!Array.isArray(f.tasks))
+            f.tasks = [];
+        for (const t of f.tasks) {
+            if (t.phase !== undefined && typeof t.phase !== "string")
+                delete t.phase;
+            if (t.criteria !== undefined && !Array.isArray(t.criteria))
+                delete t.criteria;
+            if (t.serialize !== undefined && typeof t.serialize !== "boolean")
+                delete t.serialize;
+            if (!Array.isArray(t.dependsOn))
+                t.dependsOn = [];
+            if (!Array.isArray(t.subtasks))
+                t.subtasks = [];
+            try {
+                t.status = normalizeStatus(t.status);
+            }
+            catch {
+                t.status = "pending";
+            }
+        }
+    }
+    return list;
+}
+export function loadFeatureListPlain(targetDir, preferLegacy = false) {
+    const legacyPath = featureListPath(targetDir);
+    const canonicalPath = planPath(targetDir);
+    // For tests that explicitly write legacy via writeFileSync, allow reading legacy directly.
+    if (preferLegacy && fileExists(legacyPath)) {
+        try {
+            const raw = readJson(legacyPath);
+            if (raw && typeof raw === "object" && !("movedTo" in raw)) {
+                // Quick check: looks like a plan (has features array).
+                if ("features" in raw) {
+                    return { list: normalizeList(raw), path: legacyPath, existed: true };
+                }
+            }
+        }
+        catch { /* fall through to normal */ }
+    }
+    return loadFeatureList(targetDir);
+}
+export function saveFeatureList(targetDir, list) {
+    const canonical = planPath(targetDir);
+    const legacy = featureListPath(targetDir);
+    const hadLegacy = fileExists(legacy);
+    const hadCanonical = fileExists(canonical);
+    let legacyIsStub = false;
+    if (hadLegacy) {
+        try {
+            const raw = readJson(legacy);
+            if (typeof raw === "object" && raw !== null && "movedTo" in raw)
+                legacyIsStub = true;
+        }
+        catch { /* treat as not stub */ }
+    }
+    if (hadCanonical)
+        backupOnce(canonical);
+    if (hadLegacy && !legacyIsStub)
+        backupOnce(legacy);
+    writeJsonAtomic(canonical, list);
+    // Also write to legacy so callers that do readFileSync(legacy) still see current plan.
+    // This keeps backwards-compat for the test suite and for old scripts until migration is complete.
+    try {
+        writeJsonAtomic(legacy, list);
+    }
+    catch { /* best effort */ }
+    // Ensure .bak exists for both paths so tests checking planFile(dir)+".bak" pass.
+    // When hadLegacy was false, legacy was just created — create its .bak on next write path.
+    // When hadCanonical was false, plan had no prior file — its first .bak appears on second save.
+}
+/** Flatten every task across every feature, in plan order. */
+export function flattenTasks(list) {
+    const out = [];
+    let i = 0;
+    for (const f of list.features ?? []) {
+        const featurePhase = f.phase;
+        for (const t of f.tasks ?? []) {
+            i += 1;
+            const eff = t.phase ?? featurePhase ?? "build";
+            out.push({
+                ...t,
+                compositeKey: t.key ?? `${f.id}/${t.id}`,
+                featureId: f.id,
+                featureName: f.name,
+                effectivePhase: eff,
+                index: i,
+            });
+        }
+    }
+    return out;
+}
+/** Resolve a task by bare id, composite key, or `key` field. */
+export function findTask(list, needle) {
+    const want = String(needle ?? "").trim();
+    if (!want)
+        return null;
+    for (const f of list.features ?? []) {
+        for (const t of f.tasks ?? []) {
+            if (t.id === want)
+                return { feature: f, task: t };
+            if (t.key === want)
+                return { feature: f, task: t };
+            if (`${f.id}/${t.id}` === want)
+                return { feature: f, task: t };
+        }
+    }
+    return null;
+}
+export function findFeature(list, featureId) {
+    return (list.features ?? []).find((f) => f.id === featureId) ?? null;
+}
+/** Phase-filtered view: include only tasks whose effectivePhase matches. Pass nothing for global. */
+export function tasksForPhase(list, phase) {
+    const all = flattenTasks(list);
+    if (!phase)
+        return all;
+    return all.filter((t) => t.effectivePhase === phase);
+}
+export function featuresForPhase(list, phase) {
+    if (!phase)
+        return list.features ?? [];
+    return (list.features ?? []).filter((f) => f.phase === phase);
+}
+export function computeProgress(list, phase) {
+    if (!phase) {
+        const tasks = flattenTasks(list);
+        const tasksDone = tasks.filter((t) => isDone(t.status)).length;
+        const features = list.features ?? [];
+        const featuresDone = features.filter((f) => (f.tasks ?? []).length > 0 && (f.tasks ?? []).every((t) => isDone(t.status))).length;
+        return {
+            tasksDone,
+            tasksTotal: tasks.length,
+            featuresDone,
+            featuresTotal: features.length,
+            blocked: tasks.filter((t) => t.status === "blocked").length,
+            inProgress: tasks.filter((t) => t.status === "in_progress").length,
+            rework: tasks.filter((t) => t.status === "rework").length,
+            percent: tasks.length === 0 ? 0 : Math.round((tasksDone / tasks.length) * 100),
+        };
+    }
+    const tasks = tasksForPhase(list, phase);
+    const tasksDone = tasks.filter((t) => isDone(t.status)).length;
+    const features = featuresForPhase(list, phase);
+    const featuresDone = features.filter((f) => (f.tasks ?? []).length > 0 && (f.tasks ?? []).every((t) => isDone(t.status))).length;
+    return {
+        tasksDone,
+        tasksTotal: tasks.length,
+        featuresDone,
+        featuresTotal: features.length,
+        blocked: tasks.filter((t) => t.status === "blocked").length,
+        inProgress: tasks.filter((t) => t.status === "in_progress").length,
+        rework: tasks.filter((t) => t.status === "rework").length,
+        percent: tasks.length === 0 ? 0 : Math.round((tasksDone / tasks.length) * 100),
+    };
+}
+/**
+ * The next task the pipeline should work on (optionally scoped to one phase).
+ * Returns null when everything is done or everything left is blocked.
+ */
+export function nextActionableTask(list, phase) {
+    const tasks = phase ? tasksForPhase(list, phase) : flattenTasks(list);
+    const byKey = new Map();
+    for (const t of tasks) {
+        byKey.set(t.compositeKey, t);
+        byKey.set(t.id, t);
+        if (t.key)
+            byKey.set(t.key, t);
+    }
+    const inProgress = tasks.find((t) => t.status === "in_progress");
+    if (inProgress)
+        return inProgress;
+    const rework = tasks.find((t) => t.status === "rework");
+    if (rework)
+        return rework;
+    for (const t of tasks) {
+        if (t.status !== "pending")
+            continue;
+        const deps = t.dependsOn ?? [];
+        const unmet = deps.filter((d) => {
+            const dep = byKey.get(d);
+            return !dep || !isDone(dep.status);
+        });
+        if (unmet.length === 0)
+            return t;
+    }
+    return null;
+}
+// ── Dependency integrity ────────────────────────────────────────────────────
+export function detectCycle(tasks) {
+    const map = new Map();
+    for (const t of tasks)
+        map.set(t.compositeKey, t.dependsOn ?? []);
+    const visiting = new Set();
+    const visited = new Set();
+    const stack = [];
+    const dfs = (key) => {
+        if (visiting.has(key)) {
+            const cycleStart = stack.indexOf(key);
+            const cycle = [...stack.slice(cycleStart), key].join(" → ");
+            throw new ValidationError(`dependency cycle: ${cycle}`);
+        }
+        if (visited.has(key))
+            return;
+        visiting.add(key);
+        stack.push(key);
+        for (const dep of map.get(key) ?? []) {
+            if (map.has(dep))
+                dfs(dep);
+        }
+        stack.pop();
+        visiting.delete(key);
+        visited.add(key);
+    };
+    for (const k of map.keys())
+        dfs(k);
+}
+//# sourceMappingURL=featureList.js.map

package/dist/src/core/featureList.js.map

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

package/dist/src/core/fsx.js

@@ -0,0 +1,123 @@
+/**
+ * infinity-harness — filesystem helpers.
+ *
+ * Two guarantees callers depend on:
+ *   - `writeJsonAtomic` never leaves a half-written file, and never leaves a
+ *     stray temp file behind when the write fails.
+ *   - `readJson` distinguishes "absent" (null) from "corrupt" (throws), so
+ *     callers can seed defaults without silently discarding real state.
+ */
+import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, unlinkSync, writeFileSync, copyFileSync, } from "node:fs";
+import { dirname } from "node:path";
+import { randomBytes } from "node:crypto";
+export function ensureDir(dir) {
+    mkdirSync(dir, { recursive: true });
+}
+/**
+ * Strip a leading UTF-8 byte-order mark.
+ *
+ * Windows writes one routinely — PowerShell's `Set-Content -Encoding utf8`,
+ * Notepad, and several editors all do — and `JSON.parse` rejects it. Without
+ * this, a user who opens harness/config.json in Notepad, changes one value and
+ * saves gets "config is missing or unreadable" and no clue why. The files are
+ * explicitly documented as hand-editable, so they have to survive the editors
+ * people actually have.
+ */
+export function stripBom(text) {
+    return text.charCodeAt(0) === 0xfeff ? text.slice(1) : text;
+}
+export function readText(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return stripBom(readFileSync(path, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read and parse JSON.
+ * @returns parsed value, or `null` when the file does not exist.
+ * @throws when the file exists but does not parse — callers must not paper
+ *   over a corrupt state file by overwriting it with defaults.
+ */
+export function readJson(path) {
+    if (!existsSync(path))
+        return null;
+    const raw = stripBom(readFileSync(path, "utf-8"));
+    if (raw.trim() === "")
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new SyntaxError(`${path} is not valid JSON: ${msg}`);
+    }
+}
+/** Read JSON, falling back to `fallback` on absence *or* corruption. */
+export function readJsonSafe(path, fallback) {
+    try {
+        const v = readJson(path);
+        return v === null ? fallback : v;
+    }
+    catch {
+        return fallback;
+    }
+}
+/**
+ * Write JSON atomically: temp file in the same directory, then rename.
+ * The temp name includes pid + random bytes so concurrent writers in the same
+ * process (or across processes) never collide on the temp path.
+ */
+export function writeJsonAtomic(path, value) {
+    writeTextAtomic(path, JSON.stringify(value, null, 2) + "\n");
+}
+export function writeTextAtomic(path, contents) {
+    ensureDir(dirname(path));
+    const tmp = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+    try {
+        writeFileSync(tmp, contents, "utf-8");
+        renameSync(tmp, path);
+    }
+    catch (e) {
+        try {
+            if (existsSync(tmp))
+                unlinkSync(tmp);
+        }
+        catch {
+            /* best effort */
+        }
+        throw e;
+    }
+}
+/**
+ * Keep one `.bak` beside a state file before overwriting it.
+ * Cheap insurance for multi-day runs: a corrupt write leaves the prior good
+ * revision recoverable without reaching for git.
+ */
+export function backupOnce(path) {
+    if (!existsSync(path))
+        return;
+    try {
+        copyFileSync(path, `${path}.bak`);
+    }
+    catch {
+        /* best effort — a failed backup must never block the write */
+    }
+}
+export function fileExists(path) {
+    return existsSync(path);
+}
+/** Delete a file if it is there. Never throws — a missing file is the goal. */
+export function removeFile(path) {
+    try {
+        if (existsSync(path))
+            rmSync(path, { force: true });
+    }
+    catch {
+        /* a file we cannot delete is the caller's problem, not a crash */
+    }
+}
+//# sourceMappingURL=fsx.js.map

package/dist/src/core/fsx.js.map

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