@ai-dossier/sched 0.2.0 → 0.2.1

package/dist/types.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Types for the deterministic scheduler core (RFC-0001 §B/C.1/D, issue #460).
+ *
+ * The state unions below are the RFC-0001 §D state machines frozen into types.
+ * `state.ts` owns the transition tables; nothing here does I/O. The package
+ * itself never invokes an LLM: it spawns the agent process the operator
+ * configured (dispatch.ts) and reads ground truth via injectable subprocess
+ * exec (project.ts, groundtruth.ts) — never an LLM call of its own (AC7).
+ */
+/** Execution mode of a queue entry. `full` runs the unchanged full-cycle; `slot` runs as a batch member. */
+export type CycleMode = 'full' | 'slot';
+/** Model tier the entry is dispatched at (RFC-0001 role-based routing: mechanical / generation / judgment). */
+export type ModelTier = 'mechanical' | 'mid' | 'strong';
+/**
+ * Issue lifecycle per RFC-0001 §D.1:
+ *
+ * ```
+ * queued → classified{full|slot}
+ *   full:  → dispatched → (full-cycle's own phase trail) → shipped → done
+ *   slot:  → batched(b) → waiting → in-work → committed(range) → validated
+ *              → shipped-in-batch → done
+ * failure edges (any state):
+ *   in-work/committed → evicted(reason) → requeued{full}
+ *   any → blocked(dep-failed) | decision-pending | failed(escalation-cap)
+ * ```
+ */
+export type IssueStatus = 'queued' | 'classified' | 'dispatched' | 'shipped' | 'done' | 'batched' | 'waiting' | 'in-work' | 'committed' | 'validated' | 'shipped-in-batch' | 'evicted' | 'requeued' | 'blocked' | 'decision-pending' | 'failed';
+/** Issue statuses that cannot transition further. */
+export declare const TERMINAL_ISSUE_STATUSES: ReadonlySet<IssueStatus>;
+/**
+ * Statuses that mean the issue's work has merged. Dependency edges gate on
+ * these: "an issue with an unmerged dependency is never runnable" (AC5).
+ */
+export declare const SATISFIED_ISSUE_STATUSES: ReadonlySet<IssueStatus>;
+/**
+ * Batch lifecycle per RFC-0001 §D.2:
+ *
+ * ```
+ * forming → ready → executing(member i/N) ⟲ → validating → reviewing → shipping
+ *   → awaiting-merge → merged → deployed → reported → done
+ * failure edges:
+ *   validating → attributing → fixing(1 bounded attempt) → validating
+ *              → evicting(revert range) → validating
+ *   evictions > ⅓ OR revert-conflict → dissolving → members requeued
+ *   awaiting-merge: CONFLICTING | auto-merge-blocked → rebasing → re-validating → shipping
+ *                   (2nd failure → dissolved)
+ * ```
+ */
+export type BatchStatus = 'forming' | 'ready' | 'executing' | 'validating' | 'attributing' | 'fixing' | 'evicting' | 'reviewing' | 'shipping' | 'awaiting-merge' | 'rebasing' | 're-validating' | 'merged' | 'deployed' | 'reported' | 'done' | 'dissolving' | 'dissolved';
+/** Batch statuses that cannot transition further. */
+export declare const TERMINAL_BATCH_STATUSES: ReadonlySet<BatchStatus>;
+/**
+ * Batch statuses that mean the batch's PR has merged. Cross-batch dependency
+ * edges gate on these (a batch is never dispatched while a batch it depends
+ * on is unmerged — RFC-0001 §E.4 "scheduler gates on merge").
+ */
+export declare const MERGED_BATCH_STATUSES: ReadonlySet<BatchStatus>;
+/**
+ * Worker slot lifecycle per RFC-0001 §D.3:
+ *
+ * ```
+ * idle → assigned(unit) → running(pid, phase, last_progress_at)
+ *   → exited → verifying(reconcile vs GitHub/runstate) → complete → idle
+ * stall: running[30 min no progress] → recovering(redispatch tier+1, ≤2) → running | failed → idle
+ * ```
+ */
+export type SlotStatus = 'idle' | 'assigned' | 'running' | 'exited' | 'verifying' | 'complete' | 'recovering' | 'failed';
+/** Slot statuses that hold a live unit against `max_slots`. */
+export declare const LIVE_SLOT_STATUSES: ReadonlySet<SlotStatus>;
+/** One queued unit of work (RFC-0001 §C.1 "queue entries"). */
+export interface QueueEntry {
+    /** GitHub issue number. Unique among active entries. */
+    issue: number;
+    /** Execution mode for this issue. */
+    mode: CycleMode;
+    /** Batch id when `mode === 'slot'`; always null for `full`. */
+    batch: string | null;
+    /** Issue numbers this entry depends on (edges gate readiness). */
+    deps: number[];
+    /** Model tier the entry is dispatched at. */
+    tier: ModelTier;
+    /** Current D.1 state. */
+    status: IssueStatus;
+    /** Free-form reason attached to failure-edge transitions (evicted/blocked/failed). */
+    reason: string | null;
+    enqueued_at: string;
+    updated_at: string;
+}
+/** A batch of slot-mode issues sharing one lifecycle (RFC-0001 §C.4/E.4). */
+export interface BatchEntry {
+    id: string;
+    status: BatchStatus;
+    /** Member issue numbers, in dispatch order. */
+    members: number[];
+    base_branch: string;
+    /** Index of the member currently in work, when status is `executing` (1-based member pointer). */
+    executing_member: number;
+    created_at: string;
+    updated_at: string;
+}
+/** A worker slot (RFC-0001 §D.3). */
+export interface SlotEntry {
+    id: number;
+    status: SlotStatus;
+    /** Unit identifier currently held: `issue:<n>` or `batch:<id>`; null when idle. */
+    unit: string | null;
+    /** OS pid of the spawned agent process, when known (#464 dispatch). */
+    pid: number | null;
+    /**
+     * `/proc/<pid>/stat` start-time (field 22) recorded at spawn, when
+     * available (Linux). Persisted so a restarted sched can verify a state.json
+     * pid still belongs to our agent — a mismatched start time means the pid
+     * was reused by an unrelated process and must never be signalled (decision
+     * 1, option C). Null on platforms without /proc: best-effort.
+     */
+    pid_start: number | null;
+    /** Scheduler phase the unit is in, when running. */
+    phase: string | null;
+    /** Last progress signal (new milestone or pushed commit) — stall-timer anchor. */
+    last_progress_at: string | null;
+    /** Working branch of the unit, captured from the setup milestone's `branch=` key. */
+    branch: string | null;
+    /** Last seen head sha of `branch` on origin — the "new pushed commit" stall signal. */
+    last_head: string | null;
+    /** Recovery attempts for the current unit (stall ladder, cap 2 — RFC-0001 §C.1). */
+    recoveries: number;
+    updated_at: string;
+}
+/** Hot operational truth, persisted transactionally to `state.json` (RFC-0001 §D.4). */
+export interface SchedState {
+    schema_version: typeof SCHEMA_VERSION;
+    /** When true, `computeAssignments` returns no assignments (sched pause). */
+    paused: boolean;
+    entries: QueueEntry[];
+    batches: BatchEntry[];
+    slots: SlotEntry[];
+    /** Monotonic counter for stable slot ids. */
+    next_slot_id: number;
+}
+/** Durable intent, persisted separately in `config.json` (state.json is rebuildable hot truth). */
+export interface SchedConfig {
+    max_slots: number;
+    /** Stall timeout in ms — no new milestone AND no new pushed commit for this long → redispatch stronger (default 30 min). */
+    stall_timeout_ms?: number;
+    /** Reconciliation tick interval in ms (default 60 000). */
+    reconcile_interval_ms?: number;
+    /** Agent dispatch settings (#464); every field optional with engine defaults. */
+    dispatch?: DispatchConfig;
+}
+/**
+ * Agent dispatch configuration (#464). The command is a template: `{model}`
+ * and `{issue}` placeholders are substituted per dispatch; a `{model}` item
+ * whose tier has no model configured drops together with its flag.
+ */
+export interface DispatchConfig {
+    /** Command template, e.g. `['claude','-p','--output-format','json','--model','{model}']`. */
+    command?: string[];
+    /** Prompt template sent on the child's stdin; `{issue}` substituted. */
+    prompt?: string;
+    /** Tier → model id/alias mapping (defaults: haiku / sonnet / opus). */
+    tier_models?: Partial<Record<ModelTier, string>>;
+}
+/** The escalation ladder: one tier stronger, or null at the top (RFC-0001 §C.1). */
+export declare const TIER_LADDER: Readonly<Record<ModelTier, ModelTier | null>>;
+/** Cap on recovery attempts before a unit fails (RFC-0001 §C.1 "cap 2"). */
+export declare const ESCALATION_CAP = 2;
+/** Default stall timeout: 30 minutes without a milestone or pushed commit (RFC-0001 §C.1). */
+export declare const DEFAULT_STALL_TIMEOUT_MS: number;
+/** Default reconciliation tick: ~60s (RFC-0001 §C.1). */
+export declare const DEFAULT_RECONCILE_INTERVAL_MS: number;
+export declare const SCHEMA_VERSION: "1.1.0";
+/** Schema versions `validateState` accepts on load (migrated to SCHEMA_VERSION on save). */
+export declare const LEGACY_SCHEMA_VERSIONS: readonly string[];
+export declare const CONFIG_SCHEMA_VERSION: "1.1.0";
+/** Config schema versions `loadConfig` accepts (older configs carry only max_slots). */
+export declare const LEGACY_CONFIG_SCHEMA_VERSIONS: readonly string[];
+/** Config file shape (schema_version + the config itself). */
+export interface SchedConfigFile {
+    schema_version: string;
+    max_slots: number;
+    stall_timeout_ms?: number;
+    reconcile_interval_ms?: number;
+    dispatch?: DispatchConfig;
+}
+export declare const DEFAULT_MAX_SLOTS = 3;
+/** Bounds for `max_slots` when reading `config.json` (named — not magic numbers in persist.ts). */
+export declare const MIN_MAX_SLOTS = 1;
+export declare const MAX_MAX_SLOTS = 64;
+/** Thrown by every non-declared state-machine edge. */
+export declare class IllegalTransitionError extends Error {
+    readonly kind: 'issue' | 'batch' | 'slot';
+    readonly from: string;
+    readonly to: string;
+    constructor(kind: 'issue' | 'batch' | 'slot', from: string, to: string);
+}
+/** Thrown when an issue, batch, or slot id does not exist in the state. */
+export declare class SchedNotFoundError extends Error {
+    constructor(message: string);
+}
+/** Every event the engine journals to `events.jsonl` (append-only). */
+export type JournalEventName = 'assigned' | 'spawned' | 'exit-detected' | 'orphan-pid' | 'external-advance' | 'progress' | 'phase-updated' | 'verify-complete' | 'verify-incomplete' | 'stalled' | 'redispatched' | 'unit-failed' | 'dependents-blocked' | 'requeued' | 'ground-truth-unreachable' | 'tick-failed';
+/** One journaled event. `ts` is stamped by the journal, never by callers. */
+export interface JournalEvent {
+    ts: string;
+    event: JournalEventName;
+    /** Unit the event concerns (`issue:<n>` / `batch:<id>`), when applicable. */
+    unit?: string;
+    slot?: number;
+    issue?: number;
+    pid?: number;
+    tier?: ModelTier;
+    detail?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Types for the deterministic scheduler core (RFC-0001 §B/C.1/D, issue #460).
+ *
+ * The state unions below are the RFC-0001 §D state machines frozen into types.
+ * `state.ts` owns the transition tables; nothing here does I/O. The package
+ * itself never invokes an LLM: it spawns the agent process the operator
+ * configured (dispatch.ts) and reads ground truth via injectable subprocess
+ * exec (project.ts, groundtruth.ts) — never an LLM call of its own (AC7).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedNotFoundError = exports.IllegalTransitionError = exports.MAX_MAX_SLOTS = exports.MIN_MAX_SLOTS = exports.DEFAULT_MAX_SLOTS = exports.LEGACY_CONFIG_SCHEMA_VERSIONS = exports.CONFIG_SCHEMA_VERSION = exports.LEGACY_SCHEMA_VERSIONS = exports.SCHEMA_VERSION = exports.DEFAULT_RECONCILE_INTERVAL_MS = exports.DEFAULT_STALL_TIMEOUT_MS = exports.ESCALATION_CAP = exports.TIER_LADDER = exports.LIVE_SLOT_STATUSES = exports.MERGED_BATCH_STATUSES = exports.TERMINAL_BATCH_STATUSES = exports.SATISFIED_ISSUE_STATUSES = exports.TERMINAL_ISSUE_STATUSES = void 0;
+/** Issue statuses that cannot transition further. */
+exports.TERMINAL_ISSUE_STATUSES = new Set(['done', 'failed']);
+/**
+ * Statuses that mean the issue's work has merged. Dependency edges gate on
+ * these: "an issue with an unmerged dependency is never runnable" (AC5).
+ */
+exports.SATISFIED_ISSUE_STATUSES = new Set([
+    'shipped',
+    'shipped-in-batch',
+    'done',
+]);
+/** Batch statuses that cannot transition further. */
+exports.TERMINAL_BATCH_STATUSES = new Set(['done', 'dissolved']);
+/**
+ * Batch statuses that mean the batch's PR has merged. Cross-batch dependency
+ * edges gate on these (a batch is never dispatched while a batch it depends
+ * on is unmerged — RFC-0001 §E.4 "scheduler gates on merge").
+ */
+exports.MERGED_BATCH_STATUSES = new Set([
+    'merged',
+    'deployed',
+    'reported',
+    'done',
+]);
+/** Slot statuses that hold a live unit against `max_slots`. */
+exports.LIVE_SLOT_STATUSES = new Set([
+    'assigned',
+    'running',
+    'recovering',
+]);
+/** The escalation ladder: one tier stronger, or null at the top (RFC-0001 §C.1). */
+exports.TIER_LADDER = {
+    mechanical: 'mid',
+    mid: 'strong',
+    strong: null,
+};
+/** Cap on recovery attempts before a unit fails (RFC-0001 §C.1 "cap 2"). */
+exports.ESCALATION_CAP = 2;
+/** Default stall timeout: 30 minutes without a milestone or pushed commit (RFC-0001 §C.1). */
+exports.DEFAULT_STALL_TIMEOUT_MS = 30 * 60 * 1000;
+/** Default reconciliation tick: ~60s (RFC-0001 §C.1). */
+exports.DEFAULT_RECONCILE_INTERVAL_MS = 60 * 1000;
+exports.SCHEMA_VERSION = '1.1.0';
+/** Schema versions `validateState` accepts on load (migrated to SCHEMA_VERSION on save). */
+exports.LEGACY_SCHEMA_VERSIONS = ['1.0.0'];
+exports.CONFIG_SCHEMA_VERSION = '1.1.0';
+/** Config schema versions `loadConfig` accepts (older configs carry only max_slots). */
+exports.LEGACY_CONFIG_SCHEMA_VERSIONS = ['1.0.0'];
+exports.DEFAULT_MAX_SLOTS = 3;
+/** Bounds for `max_slots` when reading `config.json` (named — not magic numbers in persist.ts). */
+exports.MIN_MAX_SLOTS = 1;
+exports.MAX_MAX_SLOTS = 64;
+/** Thrown by every non-declared state-machine edge. */
+class IllegalTransitionError extends Error {
+    kind;
+    from;
+    to;
+    constructor(kind, from, to) {
+        super(`Illegal ${kind} transition: ${from} → ${to}`);
+        this.name = 'IllegalTransitionError';
+        this.kind = kind;
+        this.from = from;
+        this.to = to;
+    }
+}
+exports.IllegalTransitionError = IllegalTransitionError;
+/** Thrown when an issue, batch, or slot id does not exist in the state. */
+class SchedNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'SchedNotFoundError';
+    }
+}
+exports.SchedNotFoundError = SchedNotFoundError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA2CH,qDAAqD;AACxC,QAAA,uBAAuB,GAA6B,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7F;;;GAGG;AACU,QAAA,wBAAwB,GAA6B,IAAI,GAAG,CAAC;IACxE,SAAS;IACT,kBAAkB;IAClB,MAAM;CACP,CAAC,CAAC;AAsCH,qDAAqD;AACxC,QAAA,uBAAuB,GAA6B,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;AAEhG;;;;GAIG;AACU,QAAA,qBAAqB,GAA6B,IAAI,GAAG,CAAC;IACrE,QAAQ;IACR,UAAU;IACV,UAAU;IACV,MAAM;CACP,CAAC,CAAC;AAuBH,+DAA+D;AAClD,QAAA,kBAAkB,GAA4B,IAAI,GAAG,CAAC;IACjE,UAAU;IACV,SAAS;IACT,YAAY;CACb,CAAC,CAAC;AAuGH,oFAAoF;AACvE,QAAA,WAAW,GAAkD;IACxE,UAAU,EAAE,KAAK;IACjB,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,IAAI;CACb,CAAC;AAEF,4EAA4E;AAC/D,QAAA,cAAc,GAAG,CAAC,CAAC;AAEhC,8FAA8F;AACjF,QAAA,wBAAwB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAEvD,yDAAyD;AAC5C,QAAA,6BAA6B,GAAG,EAAE,GAAG,IAAI,CAAC;AAE1C,QAAA,cAAc,GAAG,OAAgB,CAAC;AAE/C,4FAA4F;AAC/E,QAAA,sBAAsB,GAAsB,CAAC,OAAO,CAAC,CAAC;AAEtD,QAAA,qBAAqB,GAAG,OAAgB,CAAC;AAEtD,wFAAwF;AAC3E,QAAA,6BAA6B,GAAsB,CAAC,OAAO,CAAC,CAAC;AAW7D,QAAA,iBAAiB,GAAG,CAAC,CAAC;AAEnC,mGAAmG;AACtF,QAAA,aAAa,GAAG,CAAC,CAAC;AAClB,QAAA,aAAa,GAAG,EAAE,CAAC;AAEhC,uDAAuD;AACvD,MAAa,sBAAuB,SAAQ,KAAK;IACtC,IAAI,CAA6B;IACjC,IAAI,CAAS;IACb,EAAE,CAAS;IAEpB,YAAY,IAAgC,EAAE,IAAY,EAAE,EAAU;QACpE,KAAK,CAAC,WAAW,IAAI,gBAAgB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;CACF;AAZD,wDAYC;AAED,2EAA2E;AAC3E,MAAa,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-dossier/sched",
-  "version": "0.2.0",
-  "description": "Deterministic scheduler core for dossier batch cycles \u2014 queue, slots, persistent state machine, dispatch engine with completion verification and stall/escalation ladder. The scheduler never invokes an LLM.",
+  "version": "0.2.1",
+  "description": "Deterministic scheduler core for dossier batch cycles — queue, slots, persistent state machine, dispatch engine with completion verification and stall/escalation ladder. The scheduler never invokes an LLM.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [