ai-foreman 1.0.0 → 1.0.2

package/dist/tickets/stateDb.d.ts

@@ -0,0 +1,90 @@
+export type TicketStatus = "planned" | "next" | "in_progress" | "blocked" | "done" | "canceled";
+export type ValidationResult = "passed" | "failed" | "not_run" | "not_applicable";
+export interface TicketState {
+    ticket_id: string;
+    status: TicketStatus;
+    owner: string | null;
+    current_step: string | null;
+    next_action: string | null;
+    blocked_by_json: string;
+    blocker_type: string | null;
+    blocker_notes: string | null;
+    first_blocked_at: string | null;
+    last_checked_at: string | null;
+    last_worked_at: string | null;
+    completed_at: string | null;
+    attempt_count: number;
+    last_error: string | null;
+    evidence: string | null;
+    validation_result: ValidationResult | null;
+    validation_commands: string | null;
+    validation_notes: string | null;
+    updated_at: string;
+    updated_by: string | null;
+}
+export interface TicketEvent {
+    id?: number;
+    timestamp: string;
+    actor: string | null;
+    ticket_id: string | null;
+    event_type: string;
+    old_status: string | null;
+    new_status: string | null;
+    summary: string;
+    validation: string | null;
+    evidence: string | null;
+    payload_json: string;
+}
+export interface ValidationSnapshot {
+    id?: number;
+    timestamp: string;
+    scope: string;
+    result: ValidationResult;
+    commands: string | null;
+    evidence: string | null;
+    notes: string | null;
+}
+export interface FutureWorkItem {
+    id?: number;
+    discovered_at: string;
+    source_ticket: string | null;
+    proposed_ticket: string | null;
+    priority_guess: string | null;
+    area: string | null;
+    summary: string;
+    rationale: string | null;
+    needs_decision_from: string | null;
+    disposition: "triage" | "accepted" | "rejected" | "merged" | "queued";
+}
+export interface RecentCompletedContext {
+    ticket_id: string;
+    why_it_remains_here: string;
+    pinned_until: string | null;
+    updated_at: string;
+}
+export interface ArchiveIndexEntry {
+    archive_file: string;
+    scope: string;
+    last_updated: string | null;
+    notes: string | null;
+}
+export declare class StateDb {
+    private db;
+    constructor(dbPath: string);
+    close(): void;
+    getState(ticketId: string): TicketState | undefined;
+    getAllStates(): Map<string, TicketState>;
+    upsertState(ticketId: string, patch: Partial<Omit<TicketState, "ticket_id">>, now: string): void;
+    insertEvent(event: Omit<TicketEvent, "id">): void;
+    getRecentEvents(limit: number): TicketEvent[];
+    insertValidationSnapshot(snap: Omit<ValidationSnapshot, "id">): void;
+    getRecentValidationSnapshot(): ValidationSnapshot | undefined;
+    insertFutureWork(item: Omit<FutureWorkItem, "id">): number;
+    getFutureWork(): FutureWorkItem[];
+    getFutureWorkById(id: number): FutureWorkItem | undefined;
+    updateFutureWorkDisposition(id: number, disposition: string): void;
+    getRecentCompleted(): RecentCompletedContext[];
+    upsertRecentCompleted(row: RecentCompletedContext): void;
+    getArchiveIndex(): ArchiveIndexEntry[];
+    transaction<T>(fn: () => T): T;
+}

package/dist/tickets/ticketLoader.d.ts

@@ -0,0 +1,9 @@
+import { type TicketDef } from "./ticketSchema.js";
+export declare function loadTickets(ticketsPath: string): TicketDef[];
+export declare function saveTickets(ticketsPath: string, tickets: TicketDef[]): void;
+export interface ValidationError {
+    path: string;
+    message: string;
+}
+export declare function validateTicketDefs(tickets: TicketDef[]): ValidationError[];
+export declare function detectCycles(tickets: TicketDef[]): string[];

package/dist/tickets/ticketSchema.d.ts

@@ -0,0 +1,170 @@
+export type TicketPriority = "P0" | "P1" | "P2" | "P3";
+export type TicketSize = "XS" | "S" | "M" | "L" | "XL";
+export type TicketRisk = "Low" | "Medium" | "High";
+export interface TicketDef {
+    id: string;
+    order: number;
+    title: string;
+    area: string;
+    priority: TicketPriority;
+    size: TicketSize;
+    risk: TicketRisk;
+    depends_on: string[];
+    summary: string;
+    acceptance: string[];
+    required_tests: string[];
+    likely_files: string[];
+    rollback?: string | null;
+    notes?: string | null;
+}
+export declare const TICKET_JSON_SCHEMA: {
+    readonly type: "object";
+    readonly required: readonly ["id", "order", "title", "area", "priority", "size", "risk", "depends_on", "summary", "acceptance", "required_tests", "likely_files"];
+    readonly additionalProperties: true;
+    readonly properties: {
+        readonly id: {
+            readonly type: "string";
+            readonly pattern: "^[A-Za-z][A-Za-z0-9-_]*$";
+        };
+        readonly order: {
+            readonly type: "number";
+            readonly minimum: 0;
+        };
+        readonly title: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly area: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly priority: {
+            readonly type: "string";
+            readonly enum: readonly ["P0", "P1", "P2", "P3"];
+        };
+        readonly size: {
+            readonly type: "string";
+            readonly enum: readonly ["XS", "S", "M", "L", "XL"];
+        };
+        readonly risk: {
+            readonly type: "string";
+            readonly enum: readonly ["Low", "Medium", "High"];
+        };
+        readonly depends_on: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly summary: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly acceptance: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly minItems: 1;
+        };
+        readonly required_tests: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly minItems: 1;
+        };
+        readonly likely_files: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+        };
+        readonly rollback: {
+            readonly type: readonly ["string", "null"];
+        };
+        readonly notes: {
+            readonly type: readonly ["string", "null"];
+        };
+    };
+};
+export declare const TICKETS_FILE_SCHEMA: {
+    readonly type: "object";
+    readonly required: readonly ["tickets"];
+    readonly properties: {
+        readonly tickets: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["id", "order", "title", "area", "priority", "size", "risk", "depends_on", "summary", "acceptance", "required_tests", "likely_files"];
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly id: {
+                        readonly type: "string";
+                        readonly pattern: "^[A-Za-z][A-Za-z0-9-_]*$";
+                    };
+                    readonly order: {
+                        readonly type: "number";
+                        readonly minimum: 0;
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly area: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly priority: {
+                        readonly type: "string";
+                        readonly enum: readonly ["P0", "P1", "P2", "P3"];
+                    };
+                    readonly size: {
+                        readonly type: "string";
+                        readonly enum: readonly ["XS", "S", "M", "L", "XL"];
+                    };
+                    readonly risk: {
+                        readonly type: "string";
+                        readonly enum: readonly ["Low", "Medium", "High"];
+                    };
+                    readonly depends_on: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly summary: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly acceptance: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly minItems: 1;
+                    };
+                    readonly required_tests: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly minItems: 1;
+                    };
+                    readonly likely_files: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                    };
+                    readonly rollback: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly notes: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                };
+            };
+        };
+    };
+};

package/dist/tickets/validate.d.ts

@@ -0,0 +1,10 @@
+import type { TicketsConfig } from "./config.js";
+import type { TicketDef } from "./ticketSchema.js";
+import type { TicketState, StateDb } from "./stateDb.js";
+export interface ValidationIssue {
+    pass: 1 | 2 | 3 | 4;
+    severity: "error" | "warn";
+    message: string;
+}
+export declare function runAllValidation(config: TicketsConfig, projectDir: string, ticketDefs: TicketDef[], states: Map<string, TicketState>, db: StateDb): ValidationIssue[];
+export declare function formatValidationIssues(issues: ValidationIssue[]): string;

package/dist/util/asyncQueue.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A minimal async iterable backed by a push queue. Producers call `push`;
+ * consumers iterate with `for await`. Iteration ends after `close()`.
+ */
+export declare class AsyncQueue<T> implements AsyncIterable<T> {
+    private items;
+    private waiters;
+    private closed;
+    push(item: T): void;
+    close(): void;
+    [Symbol.asyncIterator](): AsyncIterator<T>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "An orchestrator that keeps Codex CLI / Claude Code builders moving through their step list unattended. Part of Rafi.",
   "type": "module",
   "repository": {
@@ -14,6 +14,24 @@
   "bin": {
     "ai-foreman": "./dist/index.js"
   },
+  "exports": {
+    "./cli/tickets.js": {
+      "types": "./dist/cli/tickets.d.ts",
+      "default": "./dist/cli/tickets.js"
+    },
+    "./cli/start.js": {
+      "types": "./dist/cli/start.d.ts",
+      "default": "./dist/cli/start.js"
+    },
+    "./cli/status.js": {
+      "types": "./dist/cli/status.d.ts",
+      "default": "./dist/cli/status.js"
+    },
+    "./cli/doctor.js": {
+      "types": "./dist/cli/doctor.d.ts",
+      "default": "./dist/cli/doctor.js"
+    }
+  },
   "files": [
     "dist",
     "README.md",
@@ -33,8 +51,10 @@
   "engines": {
     "node": ">=20"
   },
+  "optionalDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.148"
+  },
   "dependencies": {
-    "@anthropic-ai/claude-agent-sdk": "^0.3.148",
     "@clack/prompts": "^1.4.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
@@ -42,7 +62,7 @@
     "commander": "^12.1.0",
     "luxon": "^3.7.2",
     "yaml": "^2.5.1",
-    "special-agents": "0.1.0"
+    "special-agents": "0.3.0"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",