@ai-dossier/sched 0.2.0 → 0.2.1

package/dist/enqueue.js

@@ -0,0 +1,220 @@
+"use strict";
+/**
+ * Enqueue: accept queue entries from CLI flags or a batch-prep manifest
+ * (RFC-0001 §C.1 — "queue entries (issue → mode, batch membership, deps, tier)
+ * written by batch-prep"). Pure validation + state mutation: rejects duplicate
+ * active issues, mode/batch mismatches, self-dependencies, and dependency
+ * cycles at enqueue time rather than at assignment time.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnqueueError = void 0;
+exports.parseManifest = parseManifest;
+exports.assertNoDependencyCycle = assertNoDependencyCycle;
+exports.enqueueEntries = enqueueEntries;
+const state_1 = require("./state");
+const types_1 = require("./types");
+class EnqueueError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EnqueueError';
+    }
+}
+exports.EnqueueError = EnqueueError;
+function asPositiveInt(value, label) {
+    if (!Number.isInteger(value) || value <= 0) {
+        throw new EnqueueError(`${label} must be a positive integer, got ${String(value)}`);
+    }
+    return value;
+}
+/**
+ * Parse a `--from-manifest` payload. Accepts either a bare array of entries or
+ * `{ "project": "...", "entries": [...] }` (the batch-prep output shape;
+ * `project` is accepted and ignored — the CLI resolves the project itself).
+ */
+function parseManifest(raw) {
+    const list = Array.isArray(raw)
+        ? raw
+        : raw && typeof raw === 'object' && Array.isArray(raw.entries)
+            ? raw.entries
+            : null;
+    if (list === null) {
+        throw new EnqueueError('Manifest must be a JSON array of entries or { "entries": [...] }');
+    }
+    return list.map((item, i) => {
+        if (!item || typeof item !== 'object') {
+            throw new EnqueueError(`Manifest entry [${i}] must be an object`);
+        }
+        const obj = item;
+        const input = {
+            issue: asPositiveInt(obj.issue, `Manifest entry [${i}]: issue`),
+        };
+        if (obj.mode !== undefined) {
+            if (obj.mode !== 'full' && obj.mode !== 'slot') {
+                throw new EnqueueError(`Manifest entry [${i}]: mode must be 'full' or 'slot'`);
+            }
+            input.mode = obj.mode;
+        }
+        if (obj.batch !== undefined && obj.batch !== null) {
+            if (typeof obj.batch !== 'string' || obj.batch.length === 0) {
+                throw new EnqueueError(`Manifest entry [${i}]: batch must be a non-empty string`);
+            }
+            input.batch = obj.batch;
+        }
+        if (obj.deps !== undefined) {
+            if (!Array.isArray(obj.deps)) {
+                throw new EnqueueError(`Manifest entry [${i}]: deps must be an array`);
+            }
+            input.deps = obj.deps.map((d, j) => asPositiveInt(d, `Manifest entry [${i}]: deps[${j}]`));
+        }
+        if (obj.tier !== undefined) {
+            if (obj.tier !== 'mechanical' && obj.tier !== 'mid' && obj.tier !== 'strong') {
+                throw new EnqueueError(`Manifest entry [${i}]: tier must be mechanical | mid | strong`);
+            }
+            input.tier = obj.tier;
+        }
+        if (obj.base_branch !== undefined) {
+            if (typeof obj.base_branch !== 'string' || obj.base_branch.length === 0) {
+                throw new EnqueueError(`Manifest entry [${i}]: base_branch must be a non-empty string`);
+            }
+            input.base_branch = obj.base_branch;
+        }
+        return input;
+    });
+}
+/**
+ * Dependency-cycle detection over the combined graph (existing entries +
+ * inputs). Deps pointing at issues not in the graph are allowed — they stay
+ * permanently unsatisfied and surface in `sched status`'s blocked set.
+ */
+function assertNoDependencyCycle(state, inputs) {
+    const edges = new Map();
+    for (const entry of state.entries) {
+        edges.set(entry.issue, [...entry.deps]);
+    }
+    for (const input of inputs) {
+        const existing = edges.get(input.issue) ?? [];
+        edges.set(input.issue, [...existing, ...(input.deps ?? [])]);
+    }
+    const WHITE = 0;
+    const GRAY = 1;
+    const BLACK = 2;
+    const color = new Map();
+    const visit = (node, stack) => {
+        const c = color.get(node) ?? WHITE;
+        if (c === BLACK)
+            return;
+        if (c === GRAY) {
+            const cycleStart = stack.indexOf(node);
+            const cycle = [...stack.slice(cycleStart), node].join(' → ');
+            throw new EnqueueError(`Dependency cycle detected: ${cycle}`);
+        }
+        color.set(node, GRAY);
+        for (const dep of edges.get(node) ?? []) {
+            if (edges.has(dep))
+                visit(dep, [...stack, node]);
+        }
+        color.set(node, BLACK);
+    };
+    for (const node of edges.keys()) {
+        visit(node, []);
+    }
+}
+/**
+ * Append validated entries to the queue (AC1). Returns the new state; throws
+ * `EnqueueError` on any rejection — the caller saves nothing when it throws.
+ */
+function enqueueEntries(state, inputs, now = new Date()) {
+    if (inputs.length === 0) {
+        throw new EnqueueError('No entries to enqueue');
+    }
+    const seen = new Set();
+    for (const input of inputs) {
+        asPositiveInt(input.issue, 'issue');
+        if (input.deps?.includes(input.issue)) {
+            throw new EnqueueError(`Issue ${input.issue} cannot depend on itself`);
+        }
+        if (seen.has(input.issue)) {
+            throw new EnqueueError(`Duplicate issue in enqueue input: ${input.issue}`);
+        }
+        // The persistence boundary: enqueue must only ever produce state that
+        // validateState (and therefore the next load) accepts.
+        if (input.batch !== undefined && input.batch !== null && input.batch.length === 0) {
+            throw new EnqueueError(`Issue ${input.issue}: batch must be a non-empty string`);
+        }
+        if (input.mode !== undefined && input.mode !== 'full' && input.mode !== 'slot') {
+            throw new EnqueueError(`Issue ${input.issue}: mode must be 'full' or 'slot'`);
+        }
+        if (input.tier !== undefined &&
+            input.tier !== 'mechanical' &&
+            input.tier !== 'mid' &&
+            input.tier !== 'strong') {
+            throw new EnqueueError(`Issue ${input.issue}: tier must be mechanical | mid | strong`);
+        }
+        seen.add(input.issue);
+    }
+    for (const input of inputs) {
+        const existing = state.entries.find((e) => e.issue === input.issue);
+        if (existing && !types_1.TERMINAL_ISSUE_STATUSES.has(existing.status)) {
+            throw new EnqueueError(`Issue ${input.issue} is already in the queue (status: ${existing.status})`);
+        }
+    }
+    assertNoDependencyCycle(state, inputs);
+    const timestamp = now.toISOString();
+    const entries = inputs.map((input) => {
+        const mode = input.mode ?? 'full';
+        const batch = input.batch ?? null;
+        if (mode === 'slot' && batch === null) {
+            throw new EnqueueError(`Issue ${input.issue}: slot mode requires a batch id`);
+        }
+        if (mode === 'full' && batch !== null) {
+            throw new EnqueueError(`Issue ${input.issue}: full mode cannot carry a batch id`);
+        }
+        return {
+            issue: input.issue,
+            mode,
+            batch,
+            deps: input.deps ? [...input.deps] : [],
+            tier: input.tier ?? 'mid',
+            status: 'queued',
+            reason: null,
+            enqueued_at: timestamp,
+            updated_at: timestamp,
+        };
+    });
+    // Create batches for unseen slot batch ids; reject joining a batch that has
+    // already left `forming` (composition is frozen when the batch seals). Only
+    // batches actually joined get `updated_at` bumped — a blanket rewrite would
+    // churn the audit signal on every enqueue.
+    const batches = state.batches.map((b) => ({ ...b }));
+    for (const input of inputs) {
+        const batchId = input.batch;
+        if (batchId === null || batchId === undefined)
+            continue;
+        const existing = (0, state_1.findBatch)({ ...state, batches }, batchId);
+        if (existing) {
+            if (existing.status !== 'forming') {
+                throw new EnqueueError(`Batch ${batchId} is ${existing.status} — members can only join while forming`);
+            }
+            if (input.base_branch !== undefined && input.base_branch !== existing.base_branch) {
+                throw new EnqueueError(`Batch ${batchId} was enqueued with base '${existing.base_branch}' — refusing to silently rebase it to '${input.base_branch}'`);
+            }
+            if (existing.members.includes(input.issue))
+                continue;
+            existing.members = [...existing.members, input.issue];
+            existing.updated_at = timestamp;
+        }
+        else {
+            batches.push({
+                id: batchId,
+                status: 'forming',
+                members: [input.issue],
+                base_branch: input.base_branch ?? 'main',
+                executing_member: 0,
+                created_at: timestamp,
+                updated_at: timestamp,
+            });
+        }
+    }
+    return { ...state, entries: [...state.entries, ...entries], batches };
+}
+//# sourceMappingURL=enqueue.js.map

package/dist/enqueue.js.map

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

package/dist/groundtruth.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Ground truth for completion verification (#464, AC2 — "an agent exiting is
+ * never proof of completion"). The engine never trusts the spawned agent's own
+ * exit; it reconciles the claimed state against the durable sources — the
+ * issue's runstate milestone trail (`ai-dossier runstate last`) and GitHub
+ * itself (`gh issue view`), plus `git ls-remote` for the "new pushed commit"
+ * stall signal.
+ *
+ * Everything is injectable (the `ExecFn` pattern from project.ts): tests —
+ * and any consumer — supply fake ground truth and no subprocess runs.
+ */
+import { type ExecFn } from './project';
+/** The latest runstate milestone on an issue, as `runstate last --json` reports it. */
+export interface GroundTruthMilestone {
+    phase: string;
+    status: string;
+    run: string;
+    at: string;
+    /** Every `key=value` line of the milestone, including the header's. */
+    keys: Record<string, string>;
+}
+export interface GroundTruth {
+    /**
+     * Latest runstate milestone on the issue. **Tri-state (decision 2, option
+     * A):** an object = the milestone; `null` = the issue verifiably has NO
+     * milestone (known-absent); `undefined` = the poll FAILED (unreachable —
+     * gh auth expired, `ai-dossier` missing, network down). Callers must PAUSE
+     * decisions that need truth (stall, verify-fail) while unreachable, never
+     * treat it as "no progress".
+     */
+    latestMilestone(issue: number): GroundTruthMilestone | null | undefined;
+    /**
+     * Whether the GitHub issue is CLOSED (a merged PR auto-closes it). False
+     * when unreachable — an unreachable poll can never *confirm* completion,
+     * which is the only direction this signal is used in.
+     */
+    issueClosed(issue: number): boolean;
+    /** Current head sha of `branch` on origin, or null when unknown/absent/unreachable. */
+    branchHead(branch: string): string | null;
+}
+/**
+ * Default exec for ground-truth calls: like project.ts's `defaultExec` (never
+ * throws) but with a hard timeout so a hung `gh`/`git` cannot stall a tick
+ * indefinitely (ground truth is polled outside the state lock), and a failure
+ * observer that warns on stderr — a broken ground-truth environment (gh auth
+ * expired, `ai-dossier` missing from a cron PATH) is never silent.
+ */
+export declare const groundTruthExec: ExecFn;
+/** Parse the stdout of `ai-dossier runstate last --issue N --json`. */
+export declare function parseMilestoneJson(stdout: string | null): GroundTruthMilestone | null;
+/**
+ * Ground truth backed by subprocess calls:
+ * - `ai-dossier runstate last --issue N --json` — the milestone trail
+ * - `gh issue view N --json state --jq .state` — issue closed
+ * - `git ls-remote origin <branch>` — branch head
+ *
+ * `repoDir` is the cwd for git; gh resolves the repo from cwd by default.
+ * Every failure degrades safely: a failed milestone poll reports UNREACHABLE
+ * (undefined — decision 2, option A), a failed closed-poll reports false, a
+ * failed head-poll null. Ground truth being unreachable pauses the engine's
+ * stall/verify decisions; it never crashes a tick.
+ */
+export declare function createExecGroundTruth(exec?: ExecFn, opts?: {
+    repoDir?: string;
+    runstateBin?: string;
+}): GroundTruth;
+/**
+ * Completion rule (AC2): a unit's work is verified complete when the issue's
+ * latest milestone is the final `report done` — the full-cycle trail's last
+ * phase — or when GitHub itself says the issue is closed (a merged PR
+ * auto-closes it, which is ground truth no milestone can contradict).
+ */
+export declare function isVerifiedComplete(milestone: GroundTruthMilestone | null, issueClosed: boolean): boolean;
+//# sourceMappingURL=groundtruth.d.ts.map

package/dist/groundtruth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"groundtruth.d.ts","sourceRoot":"","sources":["../src/groundtruth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AAEtD,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC;IACxE;;;;OAIG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,uFAAuF;IACvF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC3C;AAKD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,MAK5B,CAAC;AAEH,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB,GAAG,IAAI,CA2BrF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,GAAE,MAAwB,EAC9B,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GACpD,WAAW,CA+Bb;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,oBAAoB,GAAG,IAAI,EACtC,WAAW,EAAE,OAAO,GACnB,OAAO,CAGT"}

package/dist/groundtruth.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Ground truth for completion verification (#464, AC2 — "an agent exiting is
+ * never proof of completion"). The engine never trusts the spawned agent's own
+ * exit; it reconciles the claimed state against the durable sources — the
+ * issue's runstate milestone trail (`ai-dossier runstate last`) and GitHub
+ * itself (`gh issue view`), plus `git ls-remote` for the "new pushed commit"
+ * stall signal.
+ *
+ * Everything is injectable (the `ExecFn` pattern from project.ts): tests —
+ * and any consumer — supply fake ground truth and no subprocess runs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groundTruthExec = void 0;
+exports.parseMilestoneJson = parseMilestoneJson;
+exports.createExecGroundTruth = createExecGroundTruth;
+exports.isVerifiedComplete = isVerifiedComplete;
+const project_1 = require("./project");
+/** Subprocess timeout: a hung gh/git call must not stall a tick. */
+const GROUND_TRUTH_TIMEOUT_MS = 30_000;
+/**
+ * Default exec for ground-truth calls: like project.ts's `defaultExec` (never
+ * throws) but with a hard timeout so a hung `gh`/`git` cannot stall a tick
+ * indefinitely (ground truth is polled outside the state lock), and a failure
+ * observer that warns on stderr — a broken ground-truth environment (gh auth
+ * expired, `ai-dossier` missing from a cron PATH) is never silent.
+ */
+exports.groundTruthExec = (0, project_1.createExecFn)(GROUND_TRUTH_TIMEOUT_MS, {
+    onError: (file, args, err) => process.stderr.write(`⚠ sched ground truth: '${file} ${args.join(' ')}' failed: ${err.message}\n`),
+});
+/** Parse the stdout of `ai-dossier runstate last --issue N --json`. */
+function parseMilestoneJson(stdout) {
+    if (stdout === null || stdout.trim() === '' || stdout.trim() === 'null')
+        return null;
+    try {
+        const parsed = JSON.parse(stdout);
+        if (parsed === null || typeof parsed !== 'object')
+            return null;
+        const obj = parsed;
+        if (typeof obj.phase !== 'string' ||
+            typeof obj.status !== 'string' ||
+            typeof obj.at !== 'string') {
+            return null;
+        }
+        const keys = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (typeof value === 'string')
+                keys[key] = value;
+        }
+        return {
+            phase: obj.phase,
+            status: obj.status,
+            run: typeof obj.run === 'string' ? obj.run : '',
+            at: obj.at,
+            keys,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ground truth backed by subprocess calls:
+ * - `ai-dossier runstate last --issue N --json` — the milestone trail
+ * - `gh issue view N --json state --jq .state` — issue closed
+ * - `git ls-remote origin <branch>` — branch head
+ *
+ * `repoDir` is the cwd for git; gh resolves the repo from cwd by default.
+ * Every failure degrades safely: a failed milestone poll reports UNREACHABLE
+ * (undefined — decision 2, option A), a failed closed-poll reports false, a
+ * failed head-poll null. Ground truth being unreachable pauses the engine's
+ * stall/verify decisions; it never crashes a tick.
+ */
+function createExecGroundTruth(exec = exports.groundTruthExec, opts = {}) {
+    const runstateBin = opts.runstateBin ?? 'ai-dossier';
+    return {
+        latestMilestone(issue) {
+            const out = exec(runstateBin, ['runstate', 'last', '--issue', String(issue), '--json'], opts.repoDir);
+            if (out === null)
+                return undefined; // subprocess failed — unreachable, NOT known-absent
+            return parseMilestoneJson(out); // 'null' output → null (verifiably no milestone)
+        },
+        issueClosed(issue) {
+            return (exec('gh', ['issue', 'view', String(issue), '--json', 'state', '--jq', '.state']) ===
+                'CLOSED');
+        },
+        branchHead(branch) {
+            // The branch string originates from milestone output written by the
+            // spawned agent — validate it as a ref name and end git's option
+            // parsing with `--` so a crafted "branch" (e.g. `--upload-pack=…`)
+            // can never become a git option (CWE-88). A rejected ref degrades to
+            // null head: the pushed-commit progress signal just doesn't fire.
+            if (!/^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(branch))
+                return null;
+            const out = exec('git', ['ls-remote', 'origin', '--', branch], opts.repoDir);
+            if (out === null || out === '')
+                return null;
+            const sha = out.split('\t')[0]?.trim();
+            return sha && /^[0-9a-f]{40}$/i.test(sha) ? sha : null;
+        },
+    };
+}
+/**
+ * Completion rule (AC2): a unit's work is verified complete when the issue's
+ * latest milestone is the final `report done` — the full-cycle trail's last
+ * phase — or when GitHub itself says the issue is closed (a merged PR
+ * auto-closes it, which is ground truth no milestone can contradict).
+ */
+function isVerifiedComplete(milestone, issueClosed) {
+    if (issueClosed)
+        return true;
+    return milestone !== null && milestone.phase === 'report' && milestone.status === 'done';
+}
+//# sourceMappingURL=groundtruth.js.map

package/dist/groundtruth.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+export { buildAgentCommand, buildPrompt, createSpawnDeps, DEFAULT_DISPATCH_COMMAND, DEFAULT_PROMPT_TEMPLATE, DEFAULT_TIER_MODELS, escalateTier, OPENCODE_DISPATCH_COMMAND, type ResolvedDispatch, resolveDispatch, type SpawnDeps, unitLogName, } from './dispatch';
+export { type EngineDeps, runLoop, type TickResult, tick } from './engine';
+export { assertNoDependencyCycle, EnqueueError, type EnqueueInput, enqueueEntries, parseManifest, } from './enqueue';
+export { createExecGroundTruth, type GroundTruth, type GroundTruthMilestone, groundTruthExec, isVerifiedComplete, parseMilestoneJson, } from './groundtruth';
+export { issueOfUnit, JOURNAL_FILE, Journal, readJsonl, unitEvent } from './journal';
+export { CorruptStateError, LockTimeoutError, SchedStore, writeAtomic } from './persist';
+export { createExecFn, defaultExec, type ExecFn, resolveProjectSlug, sanitizeSlug, schedStateDir, } from './project';
+export { DISPATCHABLE_ISSUE_STATUSES } from './readiness';
+export { type Assignment, abandonBatch, abandonIssue, batchBlockers, computeAssignments, type DependencyBlocker, dependencyBlockers, type RunnableUnit, runnableUnits, setPaused, } from './scheduler';
+export { createEmptyState, findBatch, findEntry, TRANSITIONS, transitionBatch, transitionIssue, transitionSlot, validateState, } from './state';
+export { type BlockedItem, buildStatusReport, type StatusReport } from './status';
+export { type BatchEntry, type BatchStatus, CONFIG_SCHEMA_VERSION, type CycleMode, DEFAULT_MAX_SLOTS, DEFAULT_RECONCILE_INTERVAL_MS, DEFAULT_STALL_TIMEOUT_MS, type DispatchConfig, ESCALATION_CAP, IllegalTransitionError, type IssueStatus, type JournalEvent, type JournalEventName, LEGACY_CONFIG_SCHEMA_VERSIONS, LEGACY_SCHEMA_VERSIONS, LIVE_SLOT_STATUSES, MAX_MAX_SLOTS, MERGED_BATCH_STATUSES, MIN_MAX_SLOTS, type ModelTier, type QueueEntry, SATISFIED_ISSUE_STATUSES, SCHEMA_VERSION, type SchedConfig, type SchedConfigFile, SchedNotFoundError, type SchedState, type SlotEntry, type SlotStatus, TERMINAL_BATCH_STATUSES, TERMINAL_ISSUE_STATUSES, TIER_LADDER, } from './types';
+//# 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":"AAAA,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,SAAS,EACd,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,KAAK,UAAU,EAAE,OAAO,EAAE,KAAK,UAAU,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EACL,uBAAuB,EACvB,YAAY,EACZ,KAAK,YAAY,EACjB,cAAc,EACd,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,qBAAqB,EACrB,KAAK,WAAW,EAChB,KAAK,oBAAoB,EACzB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAErF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EACL,YAAY,EACZ,WAAW,EACX,KAAK,MAAM,EACX,kBAAkB,EAClB,YAAY,EACZ,aAAa,GACd,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,KAAK,UAAU,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,kBAAkB,EAClB,KAAK,YAAY,EACjB,aAAa,EACb,SAAS,GACV,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,WAAW,EACX,eAAe,EACf,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,KAAK,WAAW,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAClF,OAAO,EACL,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,qBAAqB,EACrB,KAAK,SAAS,EACd,iBAAiB,EACjB,6BAA6B,EAC7B,wBAAwB,EACxB,KAAK,cAAc,EACnB,cAAc,EACd,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,6BAA6B,EAC7B,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,UAAU,EACf,wBAAwB,EACxB,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,uBAAuB,EACvB,uBAAuB,EACvB,WAAW,GACZ,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateState = exports.transitionSlot = exports.transitionIssue = exports.transitionBatch = exports.TRANSITIONS = exports.findEntry = exports.findBatch = exports.createEmptyState = exports.setPaused = exports.runnableUnits = exports.dependencyBlockers = exports.computeAssignments = exports.batchBlockers = exports.abandonIssue = exports.abandonBatch = exports.DISPATCHABLE_ISSUE_STATUSES = exports.schedStateDir = exports.sanitizeSlug = exports.resolveProjectSlug = exports.defaultExec = exports.createExecFn = exports.writeAtomic = exports.SchedStore = exports.LockTimeoutError = exports.CorruptStateError = exports.unitEvent = exports.readJsonl = exports.Journal = exports.JOURNAL_FILE = exports.issueOfUnit = exports.parseMilestoneJson = exports.isVerifiedComplete = exports.groundTruthExec = exports.createExecGroundTruth = exports.parseManifest = exports.enqueueEntries = exports.EnqueueError = exports.assertNoDependencyCycle = exports.tick = exports.runLoop = exports.unitLogName = exports.resolveDispatch = exports.OPENCODE_DISPATCH_COMMAND = exports.escalateTier = exports.DEFAULT_TIER_MODELS = exports.DEFAULT_PROMPT_TEMPLATE = exports.DEFAULT_DISPATCH_COMMAND = exports.createSpawnDeps = exports.buildPrompt = exports.buildAgentCommand = void 0;
+exports.TIER_LADDER = exports.TERMINAL_ISSUE_STATUSES = exports.TERMINAL_BATCH_STATUSES = exports.SchedNotFoundError = exports.SCHEMA_VERSION = exports.SATISFIED_ISSUE_STATUSES = exports.MIN_MAX_SLOTS = exports.MERGED_BATCH_STATUSES = exports.MAX_MAX_SLOTS = exports.LIVE_SLOT_STATUSES = exports.LEGACY_SCHEMA_VERSIONS = exports.LEGACY_CONFIG_SCHEMA_VERSIONS = exports.IllegalTransitionError = exports.ESCALATION_CAP = exports.DEFAULT_STALL_TIMEOUT_MS = exports.DEFAULT_RECONCILE_INTERVAL_MS = exports.DEFAULT_MAX_SLOTS = exports.CONFIG_SCHEMA_VERSION = exports.buildStatusReport = void 0;
+var dispatch_1 = require("./dispatch");
+Object.defineProperty(exports, "buildAgentCommand", { enumerable: true, get: function () { return dispatch_1.buildAgentCommand; } });
+Object.defineProperty(exports, "buildPrompt", { enumerable: true, get: function () { return dispatch_1.buildPrompt; } });
+Object.defineProperty(exports, "createSpawnDeps", { enumerable: true, get: function () { return dispatch_1.createSpawnDeps; } });
+Object.defineProperty(exports, "DEFAULT_DISPATCH_COMMAND", { enumerable: true, get: function () { return dispatch_1.DEFAULT_DISPATCH_COMMAND; } });
+Object.defineProperty(exports, "DEFAULT_PROMPT_TEMPLATE", { enumerable: true, get: function () { return dispatch_1.DEFAULT_PROMPT_TEMPLATE; } });
+Object.defineProperty(exports, "DEFAULT_TIER_MODELS", { enumerable: true, get: function () { return dispatch_1.DEFAULT_TIER_MODELS; } });
+Object.defineProperty(exports, "escalateTier", { enumerable: true, get: function () { return dispatch_1.escalateTier; } });
+Object.defineProperty(exports, "OPENCODE_DISPATCH_COMMAND", { enumerable: true, get: function () { return dispatch_1.OPENCODE_DISPATCH_COMMAND; } });
+Object.defineProperty(exports, "resolveDispatch", { enumerable: true, get: function () { return dispatch_1.resolveDispatch; } });
+Object.defineProperty(exports, "unitLogName", { enumerable: true, get: function () { return dispatch_1.unitLogName; } });
+var engine_1 = require("./engine");
+Object.defineProperty(exports, "runLoop", { enumerable: true, get: function () { return engine_1.runLoop; } });
+Object.defineProperty(exports, "tick", { enumerable: true, get: function () { return engine_1.tick; } });
+var enqueue_1 = require("./enqueue");
+Object.defineProperty(exports, "assertNoDependencyCycle", { enumerable: true, get: function () { return enqueue_1.assertNoDependencyCycle; } });
+Object.defineProperty(exports, "EnqueueError", { enumerable: true, get: function () { return enqueue_1.EnqueueError; } });
+Object.defineProperty(exports, "enqueueEntries", { enumerable: true, get: function () { return enqueue_1.enqueueEntries; } });
+Object.defineProperty(exports, "parseManifest", { enumerable: true, get: function () { return enqueue_1.parseManifest; } });
+var groundtruth_1 = require("./groundtruth");
+Object.defineProperty(exports, "createExecGroundTruth", { enumerable: true, get: function () { return groundtruth_1.createExecGroundTruth; } });
+Object.defineProperty(exports, "groundTruthExec", { enumerable: true, get: function () { return groundtruth_1.groundTruthExec; } });
+Object.defineProperty(exports, "isVerifiedComplete", { enumerable: true, get: function () { return groundtruth_1.isVerifiedComplete; } });
+Object.defineProperty(exports, "parseMilestoneJson", { enumerable: true, get: function () { return groundtruth_1.parseMilestoneJson; } });
+var journal_1 = require("./journal");
+Object.defineProperty(exports, "issueOfUnit", { enumerable: true, get: function () { return journal_1.issueOfUnit; } });
+Object.defineProperty(exports, "JOURNAL_FILE", { enumerable: true, get: function () { return journal_1.JOURNAL_FILE; } });
+Object.defineProperty(exports, "Journal", { enumerable: true, get: function () { return journal_1.Journal; } });
+Object.defineProperty(exports, "readJsonl", { enumerable: true, get: function () { return journal_1.readJsonl; } });
+Object.defineProperty(exports, "unitEvent", { enumerable: true, get: function () { return journal_1.unitEvent; } });
+var persist_1 = require("./persist");
+Object.defineProperty(exports, "CorruptStateError", { enumerable: true, get: function () { return persist_1.CorruptStateError; } });
+Object.defineProperty(exports, "LockTimeoutError", { enumerable: true, get: function () { return persist_1.LockTimeoutError; } });
+Object.defineProperty(exports, "SchedStore", { enumerable: true, get: function () { return persist_1.SchedStore; } });
+Object.defineProperty(exports, "writeAtomic", { enumerable: true, get: function () { return persist_1.writeAtomic; } });
+var project_1 = require("./project");
+Object.defineProperty(exports, "createExecFn", { enumerable: true, get: function () { return project_1.createExecFn; } });
+Object.defineProperty(exports, "defaultExec", { enumerable: true, get: function () { return project_1.defaultExec; } });
+Object.defineProperty(exports, "resolveProjectSlug", { enumerable: true, get: function () { return project_1.resolveProjectSlug; } });
+Object.defineProperty(exports, "sanitizeSlug", { enumerable: true, get: function () { return project_1.sanitizeSlug; } });
+Object.defineProperty(exports, "schedStateDir", { enumerable: true, get: function () { return project_1.schedStateDir; } });
+var readiness_1 = require("./readiness");
+Object.defineProperty(exports, "DISPATCHABLE_ISSUE_STATUSES", { enumerable: true, get: function () { return readiness_1.DISPATCHABLE_ISSUE_STATUSES; } });
+var scheduler_1 = require("./scheduler");
+Object.defineProperty(exports, "abandonBatch", { enumerable: true, get: function () { return scheduler_1.abandonBatch; } });
+Object.defineProperty(exports, "abandonIssue", { enumerable: true, get: function () { return scheduler_1.abandonIssue; } });
+Object.defineProperty(exports, "batchBlockers", { enumerable: true, get: function () { return scheduler_1.batchBlockers; } });
+Object.defineProperty(exports, "computeAssignments", { enumerable: true, get: function () { return scheduler_1.computeAssignments; } });
+Object.defineProperty(exports, "dependencyBlockers", { enumerable: true, get: function () { return scheduler_1.dependencyBlockers; } });
+Object.defineProperty(exports, "runnableUnits", { enumerable: true, get: function () { return scheduler_1.runnableUnits; } });
+Object.defineProperty(exports, "setPaused", { enumerable: true, get: function () { return scheduler_1.setPaused; } });
+var state_1 = require("./state");
+Object.defineProperty(exports, "createEmptyState", { enumerable: true, get: function () { return state_1.createEmptyState; } });
+Object.defineProperty(exports, "findBatch", { enumerable: true, get: function () { return state_1.findBatch; } });
+Object.defineProperty(exports, "findEntry", { enumerable: true, get: function () { return state_1.findEntry; } });
+Object.defineProperty(exports, "TRANSITIONS", { enumerable: true, get: function () { return state_1.TRANSITIONS; } });
+Object.defineProperty(exports, "transitionBatch", { enumerable: true, get: function () { return state_1.transitionBatch; } });
+Object.defineProperty(exports, "transitionIssue", { enumerable: true, get: function () { return state_1.transitionIssue; } });
+Object.defineProperty(exports, "transitionSlot", { enumerable: true, get: function () { return state_1.transitionSlot; } });
+Object.defineProperty(exports, "validateState", { enumerable: true, get: function () { return state_1.validateState; } });
+var status_1 = require("./status");
+Object.defineProperty(exports, "buildStatusReport", { enumerable: true, get: function () { return status_1.buildStatusReport; } });
+var types_1 = require("./types");
+Object.defineProperty(exports, "CONFIG_SCHEMA_VERSION", { enumerable: true, get: function () { return types_1.CONFIG_SCHEMA_VERSION; } });
+Object.defineProperty(exports, "DEFAULT_MAX_SLOTS", { enumerable: true, get: function () { return types_1.DEFAULT_MAX_SLOTS; } });
+Object.defineProperty(exports, "DEFAULT_RECONCILE_INTERVAL_MS", { enumerable: true, get: function () { return types_1.DEFAULT_RECONCILE_INTERVAL_MS; } });
+Object.defineProperty(exports, "DEFAULT_STALL_TIMEOUT_MS", { enumerable: true, get: function () { return types_1.DEFAULT_STALL_TIMEOUT_MS; } });
+Object.defineProperty(exports, "ESCALATION_CAP", { enumerable: true, get: function () { return types_1.ESCALATION_CAP; } });
+Object.defineProperty(exports, "IllegalTransitionError", { enumerable: true, get: function () { return types_1.IllegalTransitionError; } });
+Object.defineProperty(exports, "LEGACY_CONFIG_SCHEMA_VERSIONS", { enumerable: true, get: function () { return types_1.LEGACY_CONFIG_SCHEMA_VERSIONS; } });
+Object.defineProperty(exports, "LEGACY_SCHEMA_VERSIONS", { enumerable: true, get: function () { return types_1.LEGACY_SCHEMA_VERSIONS; } });
+Object.defineProperty(exports, "LIVE_SLOT_STATUSES", { enumerable: true, get: function () { return types_1.LIVE_SLOT_STATUSES; } });
+Object.defineProperty(exports, "MAX_MAX_SLOTS", { enumerable: true, get: function () { return types_1.MAX_MAX_SLOTS; } });
+Object.defineProperty(exports, "MERGED_BATCH_STATUSES", { enumerable: true, get: function () { return types_1.MERGED_BATCH_STATUSES; } });
+Object.defineProperty(exports, "MIN_MAX_SLOTS", { enumerable: true, get: function () { return types_1.MIN_MAX_SLOTS; } });
+Object.defineProperty(exports, "SATISFIED_ISSUE_STATUSES", { enumerable: true, get: function () { return types_1.SATISFIED_ISSUE_STATUSES; } });
+Object.defineProperty(exports, "SCHEMA_VERSION", { enumerable: true, get: function () { return types_1.SCHEMA_VERSION; } });
+Object.defineProperty(exports, "SchedNotFoundError", { enumerable: true, get: function () { return types_1.SchedNotFoundError; } });
+Object.defineProperty(exports, "TERMINAL_BATCH_STATUSES", { enumerable: true, get: function () { return types_1.TERMINAL_BATCH_STATUSES; } });
+Object.defineProperty(exports, "TERMINAL_ISSUE_STATUSES", { enumerable: true, get: function () { return types_1.TERMINAL_ISSUE_STATUSES; } });
+Object.defineProperty(exports, "TIER_LADDER", { enumerable: true, get: function () { return types_1.TIER_LADDER; } });
+//# 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,uCAaoB;AAZlB,6GAAA,iBAAiB,OAAA;AACjB,uGAAA,WAAW,OAAA;AACX,2GAAA,eAAe,OAAA;AACf,oHAAA,wBAAwB,OAAA;AACxB,mHAAA,uBAAuB,OAAA;AACvB,+GAAA,mBAAmB,OAAA;AACnB,wGAAA,YAAY,OAAA;AACZ,qHAAA,yBAAyB,OAAA;AAEzB,2GAAA,eAAe,OAAA;AAEf,uGAAA,WAAW,OAAA;AAEb,mCAA2E;AAAjD,iGAAA,OAAO,OAAA;AAAmB,8FAAA,IAAI,OAAA;AACxD,qCAMmB;AALjB,kHAAA,uBAAuB,OAAA;AACvB,uGAAA,YAAY,OAAA;AAEZ,yGAAA,cAAc,OAAA;AACd,wGAAA,aAAa,OAAA;AAEf,6CAOuB;AANrB,oHAAA,qBAAqB,OAAA;AAGrB,8GAAA,eAAe,OAAA;AACf,iHAAA,kBAAkB,OAAA;AAClB,iHAAA,kBAAkB,OAAA;AAEpB,qCAAqF;AAA5E,sGAAA,WAAW,OAAA;AAAE,uGAAA,YAAY,OAAA;AAAE,kGAAA,OAAO,OAAA;AAAE,oGAAA,SAAS,OAAA;AAAE,oGAAA,SAAS,OAAA;AAEjE,qCAAyF;AAAhF,4GAAA,iBAAiB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,qGAAA,UAAU,OAAA;AAAE,sGAAA,WAAW,OAAA;AACrE,qCAOmB;AANjB,uGAAA,YAAY,OAAA;AACZ,sGAAA,WAAW,OAAA;AAEX,6GAAA,kBAAkB,OAAA;AAClB,uGAAA,YAAY,OAAA;AACZ,wGAAA,aAAa,OAAA;AAEf,yCAA0D;AAAjD,wHAAA,2BAA2B,OAAA;AACpC,yCAWqB;AATnB,yGAAA,YAAY,OAAA;AACZ,yGAAA,YAAY,OAAA;AACZ,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAElB,+GAAA,kBAAkB,OAAA;AAElB,0GAAA,aAAa,OAAA;AACb,sGAAA,SAAS,OAAA;AAEX,iCASiB;AARf,yGAAA,gBAAgB,OAAA;AAChB,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AACX,wGAAA,eAAe,OAAA;AACf,wGAAA,eAAe,OAAA;AACf,uGAAA,cAAc,OAAA;AACd,sGAAA,aAAa,OAAA;AAEf,mCAAkF;AAAvD,2GAAA,iBAAiB,OAAA;AAC5C,iCAiCiB;AA9Bf,8GAAA,qBAAqB,OAAA;AAErB,0GAAA,iBAAiB,OAAA;AACjB,sHAAA,6BAA6B,OAAA;AAC7B,iHAAA,wBAAwB,OAAA;AAExB,uGAAA,cAAc,OAAA;AACd,+GAAA,sBAAsB,OAAA;AAItB,sHAAA,6BAA6B,OAAA;AAC7B,+GAAA,sBAAsB,OAAA;AACtB,2GAAA,kBAAkB,OAAA;AAClB,sGAAA,aAAa,OAAA;AACb,8GAAA,qBAAqB,OAAA;AACrB,sGAAA,aAAa,OAAA;AAGb,iHAAA,wBAAwB,OAAA;AACxB,uGAAA,cAAc,OAAA;AAGd,2GAAA,kBAAkB,OAAA;AAIlB,gHAAA,uBAAuB,OAAA;AACvB,gHAAA,uBAAuB,OAAA;AACvB,oGAAA,WAAW,OAAA"}

package/dist/journal.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Append-only event journal (#464, AC6 — "all events journaled"; RFC-0001 §D.4
+ * "Audit"). Every engine decision lands here as one JSONL line in
+ * `<sched-dir>/events.jsonl`. The journal must never crash a tick: write
+ * failures are swallowed after a one-line stderr warning — state.json remains
+ * the operational truth, the journal is the operator's flight recorder.
+ */
+import type { JournalEvent, JournalEventName } from './types';
+/** The journal file name — the single source (persist.ts's journalPath uses it). */
+export declare const JOURNAL_FILE = "events.jsonl";
+export declare class Journal {
+    readonly filePath: string;
+    constructor(dir: string);
+    /** Append one event, stamping `ts` from the caller's clock. Never throws. */
+    append(event: Omit<JournalEvent, 'ts'>, now?: Date): void;
+    /** Read every event, oldest first; malformed lines are skipped. */
+    read(): JournalEvent[];
+}
+/**
+ * Read a JSONL file oldest-first, skipping malformed lines; `[]` when the
+ * file is absent or unreadable. Shared by the journal and the CLI's run log
+ * so the read-loop exists once.
+ */
+export declare function readJsonl<T>(file: string): T[];
+/** `issue:464` → 464; null for batch or malformed unit ids. */
+export declare function issueOfUnit(unit: string | null): number | null;
+/** Convenience: build the journaled event for a unit without repeating ids. */
+export declare function unitEvent(event: JournalEventName, unit: string, extra?: Omit<JournalEvent, 'ts' | 'event' | 'unit'>): Omit<JournalEvent, 'ts' | 'event' | 'unit'> & {
+    event: JournalEventName;
+    unit: string;
+};
+//# sourceMappingURL=journal.d.ts.map

package/dist/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE9D,oFAAoF;AACpF,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,qBAAa,OAAO;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,GAAG,EAAE,MAAM;IAIvB,6EAA6E;IAC7E,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,GAAG,GAAE,IAAiB,GAAG,IAAI;IAerE,mEAAmE;IACnE,IAAI,IAAI,YAAY,EAAE;CAGvB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,CAgB9C;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAI9D;AAED,+EAA+E;AAC/E,wBAAgB,SAAS,CACvB,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAM,GACtD,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC,GAAG;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAGzF"}