@autopilot-harness/core 0.1.0

package/dist/code-edit-detector.js

@@ -0,0 +1,44 @@
+import { spawnSync } from "node:child_process";
+import { DEFAULT_AUTOPILOT_IGNORE_PATTERNS, isAutopilotIgnoredPath, loadAutopilotIgnorePatterns, toProjectRelativePath, } from "./autopilot-ignore.js";
+/**
+ * Option A: untracked + gitignored → not product.
+ * Tracked files are not reported by `git check-ignore` without `--no-index`,
+ * so they still count (unless `.autopilotignore` excludes them).
+ */
+function isUntrackedGitIgnored(projectRoot, relativePath) {
+    // Untrusted path fragment — never pass through a shell; reject NUL.
+    if (!relativePath || relativePath.includes("\0"))
+        return false;
+    try {
+        const r = spawnSync("git", ["check-ignore", "-q", "--", relativePath], {
+            cwd: projectRoot,
+            encoding: "utf8",
+            timeout: 5_000,
+            windowsHide: true,
+            shell: false,
+        });
+        return r.status === 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if the edited path counts as product code (triggers fix review).
+ * No extension allowlist — exclusions live in `.autopilotignore` (+ gitignore A).
+ */
+export function isProductCodeEdit(filePath, opts) {
+    const relative = toProjectRelativePath(filePath, opts?.projectRoot);
+    if (!relative)
+        return false;
+    const patterns = opts?.projectRoot?.trim()
+        ? loadAutopilotIgnorePatterns(opts.projectRoot)
+        : DEFAULT_AUTOPILOT_IGNORE_PATTERNS;
+    if (isAutopilotIgnoredPath(relative, patterns))
+        return false;
+    const root = opts?.projectRoot?.trim();
+    if (root && isUntrackedGitIgnored(root, relative))
+        return false;
+    return true;
+}
+//# sourceMappingURL=code-edit-detector.js.map

package/dist/code-edit-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-edit-detector.js","sourceRoot":"","sources":["../src/code-edit-detector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,uBAAuB,CAAC;AAO/B;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,WAAmB,EACnB,YAAoB;IAEpB,oEAAoE;IACpE,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,SAAS,CACjB,KAAK,EACL,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,CAAC,EAC1C;YACE,GAAG,EAAE,WAAW;YAChB,QAAQ,EAAE,MAAM;YAChB,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,IAAI;YACjB,KAAK,EAAE,KAAK;SACb,CACF,CAAC;QACF,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAAgB,EAChB,IAA6B;IAE7B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,QAAQ,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE;QACxC,CAAC,CAAC,2BAA2B,CAAC,IAAI,CAAC,WAAW,CAAC;QAC/C,CAAC,CAAC,iCAAiC,CAAC;IAEtC,IAAI,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7D,MAAM,IAAI,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,IAAI,IAAI,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAEhE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/i18n-render.d.ts

@@ -0,0 +1,3 @@
+/** Render `{placeholder}` templates. */
+export declare function renderTemplate(template: string, vars: Record<string, string | number | boolean | undefined>): string;
+//# sourceMappingURL=i18n-render.d.ts.map

package/dist/i18n-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-render.d.ts","sourceRoot":"","sources":["../src/i18n-render.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAC1D,MAAM,CAKR"}

package/dist/i18n-render.js

@@ -0,0 +1,8 @@
+/** Render `{placeholder}` templates. */
+export function renderTemplate(template, vars) {
+    return template.replace(/\{(\w+)\}/g, (_, key) => {
+        const v = vars[key];
+        return v === undefined || v === null ? "" : String(v);
+    });
+}
+//# sourceMappingURL=i18n-render.js.map

package/dist/i18n-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-render.js","sourceRoot":"","sources":["../src/i18n-render.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,IAA2D;IAE3D,OAAO,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QACpB,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { parseChecklist, parseChecklistMarkdown, MAX_CHECKLIST_BYTES, countUnchecked, firstUnchecked, secondUnchecked, uncheckedAfter, effectiveReviewingItemId, resolveAdvanceTargets, parseAdvanceNextItemId, isLastUnchecked, itemsMissingSeparatorId, slugify, type ChecklistItem, type ChecklistMd, } from "./checklist-md.js";
+export { evaluateVerifyReport, hasNoCodeCompletionEvidence, readVerifyReport, defaultVerifyReportPath, MAX_VERIFY_REPORT_BYTES, type VerifyLastReport, type VerifyCommandConfig, type VerifyCommandResult, type VerifyEvaluation, type VerifyOutcome, } from "./verify-report.js";
+export { StateStore, getLatestSchemaVersion, shortConversationId, SESSION_TITLE_MAX_LENGTH, normalizeSessionTitle, sanitizeSessionDisplayText, type SessionRow, type ReviewChainRow, type Phase, type PausedReason, } from "./state-store.js";
+export { migrate, getCurrentSchemaVersion, parseSchemaVersionValue, } from "./migrate.js";
+export { ReviewEngine, applyOff, applyOn, applyResume, applyResumeReview, type ApplyResumeResult, type FollowupAction, type FollowupKind, type ReviewEngineConfig, type StopHandlerInput, } from "./review-engine.js";
+export { loadProjectReviewConfig, normalizeProjectReviewConfig, DEFAULT_PROJECT_REVIEW_CONFIG, type ProjectReviewConfig, type ReviewScope, } from "./project-config.js";
+export { ensureAmbientReviewSession, isChecklistExecuting, sessionReviewRunnable, } from "./review-scope.js";
+export { createRenderFollowup, createResolveLens, type FollowupLocaleBundle, } from "./review-i18n.js";
+export { createConfiguredReviewEngine } from "./review-runtime.js";
+export { isSafeTrackSlug, MAX_SLUG_LEN } from "./track-slug.js";
+export { applyRun, applyReplan, applyTrackPick, type ConcurrencyMode, type PhaseActionConfig, type PhaseActionResult, type PhaseActionOk, type PhaseActionFail, } from "./phase-actions.js";
+export { CONFIRM_LENSES, getLens, lensNumberForRound, type ConfirmLens } from "./review-lenses.js";
+export { readTranscriptTail, followupInFlight, automationFollowupPresent, pendingRedeliverAllowed, userQueryText, inFlightUserQuery, harnessTipBeforeTrailingTurnEnded, isDeliveryNoiseUserQuery, inRecoverDebounceWindow, sleepSyncMs, transcriptTipIsAssistant, latestUnresolvedTurnEndedError, latestUnresolvedTurnEndedErrorIndex, transcriptHasUnresolvedTurnEndedError, PENDING_REDELIVER_COOLDOWN_MS, RECOVER_DEBOUNCE_MS, type TranscriptEvent, } from "./transcript-followup.js";
+export { isProductCodeEdit, type ProductCodeEditOptions } from "./code-edit-detector.js";
+export { DEFAULT_AUTOPILOT_IGNORE_TEXT, autopilotIgnorePath, parseAutopilotIgnore, loadAutopilotIgnorePatterns, } from "./autopilot-ignore.js";
+export { parseTrigger, firstSubstantiveLine, substantivePromptBody, isHarnessFollowupMessage, isRecoverOrStuckFollowupMessage, isRecoverFollowupMessage, isUserAbortText, USER_ABORT_MARKERS, DEFAULT_TRIGGERS, HARNESS_FOLLOWUP_PREFIXES, type TriggerEvent, type TriggerKind, type TriggerConfig, } from "./trigger-parser.js";
+export { listTracks, isRunnableTrack, canEnterExecuting, type TrackSummary, } from "./list-tracks.js";
+export { isRealpathInsideProject, isLexicallyInsideProject, normalizeProjectRoot, normalizeInProjectPlansDir, } from "./project-path.js";
+export { renderTemplate } from "./i18n-render.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,20 @@
+export { parseChecklist, parseChecklistMarkdown, MAX_CHECKLIST_BYTES, countUnchecked, firstUnchecked, secondUnchecked, uncheckedAfter, effectiveReviewingItemId, resolveAdvanceTargets, parseAdvanceNextItemId, isLastUnchecked, itemsMissingSeparatorId, slugify, } from "./checklist-md.js";
+export { evaluateVerifyReport, hasNoCodeCompletionEvidence, readVerifyReport, defaultVerifyReportPath, MAX_VERIFY_REPORT_BYTES, } from "./verify-report.js";
+export { StateStore, getLatestSchemaVersion, shortConversationId, SESSION_TITLE_MAX_LENGTH, normalizeSessionTitle, sanitizeSessionDisplayText, } from "./state-store.js";
+export { migrate, getCurrentSchemaVersion, parseSchemaVersionValue, } from "./migrate.js";
+export { ReviewEngine, applyOff, applyOn, applyResume, applyResumeReview, } from "./review-engine.js";
+export { loadProjectReviewConfig, normalizeProjectReviewConfig, DEFAULT_PROJECT_REVIEW_CONFIG, } from "./project-config.js";
+export { ensureAmbientReviewSession, isChecklistExecuting, sessionReviewRunnable, } from "./review-scope.js";
+export { createRenderFollowup, createResolveLens, } from "./review-i18n.js";
+export { createConfiguredReviewEngine } from "./review-runtime.js";
+export { isSafeTrackSlug, MAX_SLUG_LEN } from "./track-slug.js";
+export { applyRun, applyReplan, applyTrackPick, } from "./phase-actions.js";
+export { CONFIRM_LENSES, getLens, lensNumberForRound } from "./review-lenses.js";
+export { readTranscriptTail, followupInFlight, automationFollowupPresent, pendingRedeliverAllowed, userQueryText, inFlightUserQuery, harnessTipBeforeTrailingTurnEnded, isDeliveryNoiseUserQuery, inRecoverDebounceWindow, sleepSyncMs, transcriptTipIsAssistant, latestUnresolvedTurnEndedError, latestUnresolvedTurnEndedErrorIndex, transcriptHasUnresolvedTurnEndedError, PENDING_REDELIVER_COOLDOWN_MS, RECOVER_DEBOUNCE_MS, } from "./transcript-followup.js";
+export { isProductCodeEdit } from "./code-edit-detector.js";
+export { DEFAULT_AUTOPILOT_IGNORE_TEXT, autopilotIgnorePath, parseAutopilotIgnore, loadAutopilotIgnorePatterns, } from "./autopilot-ignore.js";
+export { parseTrigger, firstSubstantiveLine, substantivePromptBody, isHarnessFollowupMessage, isRecoverOrStuckFollowupMessage, isRecoverFollowupMessage, isUserAbortText, USER_ABORT_MARKERS, DEFAULT_TRIGGERS, HARNESS_FOLLOWUP_PREFIXES, } from "./trigger-parser.js";
+export { listTracks, isRunnableTrack, canEnterExecuting, } from "./list-tracks.js";
+export { isRealpathInsideProject, isLexicallyInsideProject, normalizeProjectRoot, normalizeInProjectPlansDir, } from "./project-path.js";
+export { renderTemplate } from "./i18n-render.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,eAAe,EACf,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,EACtB,eAAe,EACf,uBAAuB,EACvB,OAAO,GAGR,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,GAMxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,GAK3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,OAAO,EACP,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,WAAW,EACX,iBAAiB,GAMlB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,6BAA6B,GAG9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,oBAAoB,EACpB,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,EACL,QAAQ,EACR,WAAW,EACX,cAAc,GAMf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAoB,MAAM,oBAAoB,CAAC;AAEnG,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,iCAAiC,EACjC,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,EACX,wBAAwB,EACxB,8BAA8B,EAC9B,mCAAmC,EACnC,qCAAqC,EACrC,6BAA6B,EAC7B,mBAAmB,GAEpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,iBAAiB,EAA+B,MAAM,yBAAyB,CAAC;AAEzF,OAAO,EACL,6BAA6B,EAC7B,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,yBAAyB,GAI1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,eAAe,EACf,iBAAiB,GAElB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/list-tracks.d.ts

@@ -0,0 +1,29 @@
+import type { Phase, StateStore } from "./state-store.js";
+export { isLexicallyInsideProject, isRealpathInsideProject, normalizeInProjectPlansDir, normalizeProjectRoot, } from "./project-path.js";
+export interface TrackSummary {
+    slug: string;
+    title: string;
+    phase: Phase;
+    paused: boolean;
+    pausedReason?: "stuck" | "repeated_errors" | "human_gate";
+    checklistTotal: number;
+    checklistDone: number;
+    planPath: string;
+    updatedAt: string;
+}
+export declare function isRunnableTrack(t: TrackSummary): boolean;
+export declare function listTracks(root: string, store?: StateStore, filter?: "runnable" | "planning" | "all", plansDir?: string): TrackSummary[];
+/** RUN gate: need concrete slug, in-project checklist with ≥1 unchecked, not paused. */
+export declare function canEnterExecuting(options: {
+    slug: string | undefined;
+    checklistPath: string;
+    paused: boolean;
+    /** Required — refuse checklist paths whose realpath escapes the project. */
+    projectRoot: string;
+}): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+//# sourceMappingURL=list-tracks.d.ts.map

package/dist/list-tracks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tracks.d.ts","sourceRoot":"","sources":["../src/list-tracks.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG1D,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,GAAG,iBAAiB,GAAG,YAAY,CAAC;IAC1D,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,OAAO,CAUxD;AAmFD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,UAAU,EAClB,MAAM,GAAE,UAAU,GAAG,UAAU,GAAG,KAAa,EAC/C,QAAQ,SAAU,GACjB,YAAY,EAAE,CAoGhB;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;CACrB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8B/C"}

package/dist/list-tracks.js

@@ -0,0 +1,232 @@
+import fs from "node:fs";
+import path from "node:path";
+import { countUnchecked, parseChecklist, } from "./checklist-md.js";
+import { isRealpathInsideProject, normalizeInProjectPlansDir, normalizeProjectRoot, } from "./project-path.js";
+import { isSafeTrackSlug } from "./track-slug.js";
+export { isLexicallyInsideProject, isRealpathInsideProject, normalizeInProjectPlansDir, normalizeProjectRoot, } from "./project-path.js";
+export function isRunnableTrack(t) {
+    if (t.paused)
+        return false;
+    const unchecked = t.checklistTotal - t.checklistDone;
+    if (unchecked <= 0)
+        return false;
+    return (t.phase === "planning" ||
+        t.phase === "executing" ||
+        t.phase === "idle" ||
+        t.phase === "done");
+}
+function readPlansDir(root, plansDir = "plans") {
+    // Refuse symlink / escaped plansDir — open(path.join(root, plans, …)) follows
+    // intermediate directory symlinks and would otherwise read files outside the project.
+    // root must already be normalizeProjectRoot'd by listTracks.
+    if (typeof plansDir !== "string" ||
+        !root ||
+        root.includes("\0") ||
+        plansDir.includes("\0")) {
+        return [];
+    }
+    const dir = path.join(root, plansDir);
+    try {
+        const lst = fs.lstatSync(dir);
+        if (lst.isSymbolicLink() || !lst.isDirectory())
+            return [];
+        if (!isRealpathInsideProject(root, dir))
+            return [];
+    }
+    catch {
+        return [];
+    }
+    const names = fs
+        .readdirSync(dir, { withFileTypes: true })
+        .filter((d) => d.isDirectory() &&
+        !d.isSymbolicLink() &&
+        isSafeTrackSlug(d.name))
+        .map((d) => d.name);
+    // Re-check after readdir — TOCTOU if plans was swapped for an escaping symlink.
+    try {
+        const lst = fs.lstatSync(dir);
+        if (lst.isSymbolicLink() || !lst.isDirectory())
+            return [];
+        if (!isRealpathInsideProject(root, dir))
+            return [];
+    }
+    catch {
+        return [];
+    }
+    return names;
+}
+function titleFromPlan(planPath, slug, projectRoot) {
+    // Untrusted plans/*/plan.md — refuse symlink follow / oversized read (listing OOM).
+    if (!planPath || planPath.includes("\0"))
+        return slug;
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root)
+        return slug;
+    const maxBytes = 65_536;
+    try {
+        const nofollow = typeof fs.constants.O_NOFOLLOW === "number" ? fs.constants.O_NOFOLLOW : 0;
+        if (nofollow === 0) {
+            const lst = fs.lstatSync(planPath);
+            if (lst.isSymbolicLink() || !lst.isFile())
+                return slug;
+        }
+        const fd = fs.openSync(planPath, fs.constants.O_RDONLY | nofollow);
+        try {
+            const st = fs.fstatSync(fd);
+            if (!st.isFile() || st.size <= 0)
+                return slug;
+            // Bind fd to path identity always (not only when O_NOFOLLOW is missing).
+            const lst = fs.lstatSync(planPath);
+            if (lst.isSymbolicLink() || !lst.isFile())
+                return slug;
+            if (lst.ino !== st.ino || lst.dev !== st.dev)
+                return slug;
+            // Re-check containment after open (same intermediate-dir TOCTOU as checklist).
+            if (!isRealpathInsideProject(root, planPath))
+                return slug;
+            const len = Math.min(st.size, maxBytes);
+            const buf = Buffer.alloc(len);
+            const n = fs.readSync(fd, buf, 0, len, 0);
+            const first = buf.subarray(0, n).toString("utf8").split(/\r?\n/)[0] ?? "";
+            const m = first.match(/^#\s+(.+)/);
+            return m?.[1]?.trim() ?? slug;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    catch {
+        return slug;
+    }
+}
+export function listTracks(root, store, filter = "all", plansDir = "plans") {
+    // Trim before join/resolve — padded absolute roots become cwd-relative otherwise.
+    const normalized = normalizeProjectRoot(root);
+    if (!normalized)
+        return [];
+    root = normalized;
+    const safePlans = normalizeInProjectPlansDir(root, plansDir);
+    if (!safePlans)
+        return [];
+    plansDir = safePlans;
+    const slugs = readPlansDir(root, plansDir);
+    const tracks = [];
+    for (const slug of slugs) {
+        const trackDir = path.join(root, plansDir, slug);
+        // Slug dir must stay a real in-project directory (not swapped for a symlink).
+        try {
+            const lst = fs.lstatSync(trackDir);
+            if (lst.isSymbolicLink() || !lst.isDirectory())
+                continue;
+            if (!isRealpathInsideProject(root, trackDir))
+                continue;
+        }
+        catch {
+            continue;
+        }
+        const planPath = path.join(trackDir, "plan.md");
+        const checklistPath = path.join(trackDir, "checklist.md");
+        let checklistTotal = 0;
+        let checklistDone = 0;
+        const checklistInProject = isRealpathInsideProject(root, checklistPath);
+        const planInProject = isRealpathInsideProject(root, planPath);
+        if (checklistInProject) {
+            try {
+                const cl = parseChecklist(checklistPath, { projectRoot: root });
+                checklistTotal = cl.items.length;
+                checklistDone = cl.items.filter((i) => i.checked).length;
+            }
+            catch {
+                // Symlink / unreadable checklist — list track without item counts.
+            }
+        }
+        else if (!planInProject) {
+            continue;
+        }
+        let phase = "idle";
+        let paused = false;
+        let pausedReason;
+        let updatedAt = new Date(0).toISOString();
+        if (store) {
+            const sessions = store.db
+                .prepare(`SELECT * FROM sessions WHERE track_id = ? ORDER BY last_active_at DESC LIMIT 1`)
+                .all(slug);
+            const latest = sessions[0];
+            if (latest) {
+                phase = latest.phase;
+                paused = latest.paused === 1;
+                if (latest.paused_reason === "stuck" ||
+                    latest.paused_reason === "repeated_errors" ||
+                    latest.paused_reason === "human_gate") {
+                    pausedReason = latest.paused_reason;
+                }
+                updatedAt = latest.last_active_at;
+            }
+            else {
+                if (checklistTotal > 0 && checklistDone === checklistTotal) {
+                    phase = "done";
+                }
+                else if (checklistTotal - checklistDone > 0 && planInProject) {
+                    phase = "idle";
+                }
+            }
+        }
+        else {
+            if (checklistTotal > 0 && checklistDone === checklistTotal) {
+                phase = "done";
+            }
+            else if (checklistTotal - checklistDone > 0) {
+                phase = "idle";
+            }
+        }
+        tracks.push({
+            slug,
+            title: planInProject ? titleFromPlan(planPath, slug, root) : slug,
+            phase,
+            paused,
+            pausedReason,
+            checklistTotal,
+            checklistDone,
+            planPath,
+            updatedAt,
+        });
+    }
+    if (filter === "all")
+        return tracks;
+    if (filter === "planning") {
+        return tracks.filter((t) => t.phase === "planning");
+    }
+    return tracks.filter(isRunnableTrack);
+}
+/** RUN gate: need concrete slug, in-project checklist with ≥1 unchecked, not paused. */
+export function canEnterExecuting(options) {
+    const { slug, checklistPath, paused, projectRoot } = options;
+    if (!slug || slug === "_pending") {
+        return { ok: false, reason: "no track slug" };
+    }
+    const root = normalizeProjectRoot(projectRoot);
+    if (!root) {
+        return { ok: false, reason: "invalid project root" };
+    }
+    if (!checklistPath || !fs.existsSync(checklistPath)) {
+        return { ok: false, reason: "checklist missing" };
+    }
+    if (!isRealpathInsideProject(root, checklistPath)) {
+        return { ok: false, reason: "checklist outside project" };
+    }
+    let unchecked = 0;
+    try {
+        unchecked = countUnchecked(parseChecklist(checklistPath, { projectRoot: root }));
+    }
+    catch {
+        return { ok: false, reason: "checklist unreadable" };
+    }
+    if (unchecked < 1) {
+        return { ok: false, reason: "no unchecked items" };
+    }
+    if (paused) {
+        return { ok: false, reason: "session paused" };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=list-tracks.js.map

package/dist/list-tracks.js.map

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

package/dist/migrate.d.ts

@@ -0,0 +1,19 @@
+import type { SqlDatabase } from "./sqlite.js";
+export declare function readMigrationSql(version: number): string;
+/**
+ * Latest schema = highest contiguous version from 001 that `readMigrationSql`
+ * can resolve (not a hardcoded constant). Stops before a missing/ambiguous
+ * file so migrate never claims a ceiling it cannot apply (e.g. stray
+ * `099_*.sql` or two `003_*.sql` in one dir).
+ *
+ * Package layout: `../migrations` is git-tracked SQL next to `dist/`, so a
+ * build that includes this scanner sees new files without bumping a constant —
+ * but the scanner itself must be in the running build (cli `build` compiles
+ * core first).
+ */
+export declare function getLatestSchemaVersion(): number;
+/** Non-finite / non-integer / negative meta must not be treated as "already latest". */
+export declare function parseSchemaVersionValue(raw: unknown): number;
+export declare function getCurrentSchemaVersion(db: SqlDatabase): number;
+export declare function migrate(db: SqlDatabase): number;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../src/migrate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAa/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAiBxD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAc/C;AAED,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAQ5D;AAED,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAW/D;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,WAAW,GAAG,MAAM,CAqB/C"}

package/dist/migrate.js

@@ -0,0 +1,101 @@
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+function migrationDirs() {
+    // Package layout: packages/core/{src,dist}/../migrations
+    // Vendor layout: .autopilot/bin/vendor/migrations (beside runtime.mjs)
+    return [
+        join(__dirname, "..", "migrations"),
+        join(__dirname, "migrations"),
+    ];
+}
+export function readMigrationSql(version) {
+    const prefix = `${String(version).padStart(3, "0")}_`;
+    for (const dir of migrationDirs()) {
+        if (!existsSync(dir))
+            continue;
+        const matches = readdirSync(dir).filter((f) => f.startsWith(prefix) && f.endsWith(".sql"));
+        if (matches.length === 1) {
+            return readFileSync(join(dir, matches[0]), "utf8");
+        }
+        if (matches.length > 1) {
+            throw new Error(`Ambiguous migration SQL for version ${version}: ${matches.join(", ")}`);
+        }
+    }
+    throw new Error(`Missing migration SQL for version ${version}`);
+}
+/**
+ * Latest schema = highest contiguous version from 001 that `readMigrationSql`
+ * can resolve (not a hardcoded constant). Stops before a missing/ambiguous
+ * file so migrate never claims a ceiling it cannot apply (e.g. stray
+ * `099_*.sql` or two `003_*.sql` in one dir).
+ *
+ * Package layout: `../migrations` is git-tracked SQL next to `dist/`, so a
+ * build that includes this scanner sees new files without bumping a constant —
+ * but the scanner itself must be in the running build (cli `build` compiles
+ * core first).
+ */
+export function getLatestSchemaVersion() {
+    let latest = 0;
+    for (let v = 1; v <= 999; v++) {
+        try {
+            readMigrationSql(v);
+        }
+        catch {
+            break;
+        }
+        latest = v;
+    }
+    if (latest < 1) {
+        throw new Error("No migration SQL found (expected NNN_*.sql)");
+    }
+    return latest;
+}
+/** Non-finite / non-integer / negative meta must not be treated as "already latest". */
+export function parseSchemaVersionValue(raw) {
+    if (raw == null)
+        return 0;
+    // Require a full integer token — parseInt("2abc")/("2.9") would wrongly yield 2.
+    const s = String(raw).trim();
+    if (!/^\d+$/.test(s))
+        return 0;
+    const n = Number.parseInt(s, 10);
+    if (!Number.isFinite(n))
+        return 0;
+    return n;
+}
+export function getCurrentSchemaVersion(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS _schema_meta (
+      key TEXT PRIMARY KEY,
+      value TEXT NOT NULL
+    );
+  `);
+    const row = db
+        .prepare("SELECT value FROM _schema_meta WHERE key = 'schema_version'")
+        .get();
+    return parseSchemaVersionValue(row?.value);
+}
+export function migrate(db) {
+    const current = getCurrentSchemaVersion(db);
+    const latest = getLatestSchemaVersion();
+    if (current >= latest) {
+        return current;
+    }
+    for (let v = current + 1; v <= latest; v++) {
+        const sql = readMigrationSql(v);
+        db.exec("BEGIN");
+        try {
+            db.exec(sql);
+            db.prepare("INSERT OR REPLACE INTO _schema_meta (key, value) VALUES ('schema_version', ?)").run(String(v));
+            db.exec("COMMIT");
+        }
+        catch (err) {
+            db.exec("ROLLBACK");
+            throw err;
+        }
+    }
+    return latest;
+}
+//# sourceMappingURL=migrate.js.map

package/dist/migrate.js.map

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

package/dist/phase-actions.d.ts

@@ -0,0 +1,35 @@
+import { isRunnableTrack, type TrackSummary } from "./list-tracks.js";
+import type { SessionRow, StateStore } from "./state-store.js";
+export type ConcurrencyMode = "one_executor" | "worktree_per_session";
+export interface PhaseActionConfig {
+    concurrencyMode?: ConcurrencyMode;
+    plansDir?: string;
+}
+export type PhaseActionOk = {
+    ok: true;
+    session: SessionRow;
+};
+export type PhaseActionFail = {
+    ok: false;
+    userMessage: string;
+    needPick?: boolean;
+    candidates?: TrackSummary[];
+};
+export type PhaseActionResult = PhaseActionOk | PhaseActionFail;
+export { isSafeTrackSlug } from "./track-slug.js";
+/** Enter executing for a concrete track (RUN gate). */
+export declare function applyRun(store: StateStore, conversationId: string, projectRoot: string, opts?: {
+    slug?: string;
+    config?: PhaseActionConfig;
+}): PhaseActionResult;
+/** REPLAN: back to planning; reset review chain; keep track + checklist file. */
+export declare function applyReplan(store: StateStore, conversationId: string, projectRoot: string, opts?: {
+    slug?: string;
+    config?: PhaseActionConfig;
+}): PhaseActionResult;
+/** Resolve pending track pick (digit or slug) then apply run/replan. */
+export declare function applyTrackPick(store: StateStore, conversationId: string, projectRoot: string, pick: string, opts?: {
+    config?: PhaseActionConfig;
+}): PhaseActionResult;
+export { isRunnableTrack };
+//# sourceMappingURL=phase-actions.d.ts.map

package/dist/phase-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-actions.d.ts","sourceRoot":"","sources":["../src/phase-actions.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,eAAe,EAEf,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG/D,MAAM,MAAM,eAAe,GAAG,cAAc,GAAG,sBAAsB,CAAC;AAEtE,MAAM,WAAW,iBAAiB;IAChC,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC;AAC9D,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,KAAK,CAAC;IACV,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,eAAe,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAoOlD,uDAAuD;AACvD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IACL,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GACA,iBAAiB,CA6JnB;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACnD,iBAAiB,CAsFnB;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACpC,iBAAiB,CAqGnB;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}