ai-foreman 1.3.0 → 1.4.0

package/dist/tickets/stateDb.d.ts

@@ -68,6 +68,19 @@ export interface ArchiveIndexEntry {
     last_updated: string | null;
     notes: string | null;
 }
+export type ReviewRecommendationStatus = "pending" | "accepted" | "deferred" | "dismissed";
+export interface ReviewRecommendation {
+    id?: number;
+    created_at: string;
+    kind: string;
+    status: ReviewRecommendationStatus;
+    summary: string;
+    rationale: string | null;
+    ticket_ids_json: string;
+    patch_json: string;
+    source_json: string;
+    updated_at: string | null;
+}
 export declare class StateDb {
     private db;
     constructor(dbPath: string);
@@ -86,5 +99,9 @@ export declare class StateDb {
     getRecentCompleted(): RecentCompletedContext[];
     upsertRecentCompleted(row: RecentCompletedContext): void;
     getArchiveIndex(): ArchiveIndexEntry[];
+    insertReviewRecommendation(item: Omit<ReviewRecommendation, "id">): number;
+    getReviewRecommendations(status?: ReviewRecommendationStatus): ReviewRecommendation[];
+    getReviewRecommendation(id: number): ReviewRecommendation | undefined;
+    updateReviewRecommendationStatus(id: number, status: ReviewRecommendationStatus, updatedAt: string): void;
     transaction<T>(fn: () => T): T;
 }

package/dist/tickets/stateDb.js

@@ -82,11 +82,26 @@ CREATE TABLE IF NOT EXISTS archive_index (
   notes TEXT
 );
 
+CREATE TABLE IF NOT EXISTS review_recommendations (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  created_at TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'pending',
+  summary TEXT NOT NULL,
+  rationale TEXT,
+  ticket_ids_json TEXT NOT NULL DEFAULT '[]',
+  patch_json TEXT NOT NULL DEFAULT '{}',
+  source_json TEXT NOT NULL DEFAULT '{}',
+  updated_at TEXT,
+  CHECK (status IN ('pending','accepted','deferred','dismissed'))
+);
+
 CREATE INDEX IF NOT EXISTS idx_ticket_state_status ON ticket_state(status);
 CREATE INDEX IF NOT EXISTS idx_ticket_events_ticket_id ON ticket_events(ticket_id);
 CREATE INDEX IF NOT EXISTS idx_ticket_events_timestamp ON ticket_events(timestamp);
 CREATE INDEX IF NOT EXISTS idx_validation_snapshots_timestamp ON validation_snapshots(timestamp);
 CREATE INDEX IF NOT EXISTS idx_future_work_disposition ON future_work(disposition);
+CREATE INDEX IF NOT EXISTS idx_review_recommendations_status ON review_recommendations(status);
 `;
 export class StateDb {
     db;
@@ -245,6 +260,37 @@ export class StateDb {
             .prepare("SELECT * FROM archive_index ORDER BY last_updated DESC")
             .all();
     }
+    // ── review_recommendations ────────────────────────────────────────────────
+    insertReviewRecommendation(item) {
+        const r = this.db.prepare(`
+      INSERT INTO review_recommendations (
+        created_at,kind,status,summary,rationale,ticket_ids_json,patch_json,source_json,updated_at
+      ) VALUES (
+        @created_at,@kind,@status,@summary,@rationale,@ticket_ids_json,@patch_json,@source_json,@updated_at
+      )
+    `).run(item);
+        return r.lastInsertRowid;
+    }
+    getReviewRecommendations(status) {
+        if (status) {
+            return this.db
+                .prepare("SELECT * FROM review_recommendations WHERE status = ? ORDER BY id")
+                .all(status);
+        }
+        return this.db
+            .prepare("SELECT * FROM review_recommendations ORDER BY id")
+            .all();
+    }
+    getReviewRecommendation(id) {
+        return this.db
+            .prepare("SELECT * FROM review_recommendations WHERE id = ?")
+            .get(id);
+    }
+    updateReviewRecommendationStatus(id, status, updatedAt) {
+        this.db
+            .prepare("UPDATE review_recommendations SET status = ?, updated_at = ? WHERE id = ?")
+            .run(status, updatedAt, id);
+    }
     // ── transactions ──────────────────────────────────────────────────────────
     transaction(fn) {
         return this.db.transaction(fn)();

package/dist/tickets/ticketSchema.d.ts

@@ -1,6 +1,12 @@
 export type TicketPriority = "P0" | "P1" | "P2" | "P3";
 export type TicketSize = "XS" | "S" | "M" | "L" | "XL";
 export type TicketRisk = "Low" | "Medium" | "High";
+export interface TicketExternalRef {
+    provider: "linear" | "jira" | string;
+    id: string;
+    key?: string | null;
+    url?: string | null;
+}
 export interface TicketDef {
     id: string;
     order: number;
@@ -16,6 +22,7 @@ export interface TicketDef {
     likely_files: string[];
     rollback?: string | null;
     notes?: string | null;
+    external_refs?: TicketExternalRef[];
 }
 export declare const TICKET_JSON_SCHEMA: {
     readonly type: "object";
@@ -86,6 +93,30 @@ export declare const TICKET_JSON_SCHEMA: {
         readonly notes: {
             readonly type: readonly ["string", "null"];
         };
+        readonly external_refs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["provider", "id"];
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly provider: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly id: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly key: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly url: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                };
+            };
+        };
     };
 };
 export declare const TICKETS_FILE_SCHEMA: {
@@ -163,6 +194,30 @@ export declare const TICKETS_FILE_SCHEMA: {
                     readonly notes: {
                         readonly type: readonly ["string", "null"];
                     };
+                    readonly external_refs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly required: readonly ["provider", "id"];
+                            readonly additionalProperties: true;
+                            readonly properties: {
+                                readonly provider: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly id: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly key: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly url: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                            };
+                        };
+                    };
                 };
             };
         };

package/dist/tickets/ticketSchema.js

@@ -20,6 +20,20 @@ export const TICKET_JSON_SCHEMA = {
         likely_files: { type: "array", items: { type: "string" } },
         rollback: { type: ["string", "null"] },
         notes: { type: ["string", "null"] },
+        external_refs: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["provider", "id"],
+                additionalProperties: true,
+                properties: {
+                    provider: { type: "string", minLength: 1 },
+                    id: { type: "string", minLength: 1 },
+                    key: { type: ["string", "null"] },
+                    url: { type: ["string", "null"] },
+                },
+            },
+        },
     },
 };
 export const TICKETS_FILE_SCHEMA = {

package/dist/tickets/validate.js

@@ -25,12 +25,12 @@ export function runAllValidation(config, projectDir, ticketDefs, states, db) {
         }
     }
     // Pass 3: queue validation
-    const queueRows = buildNextQueue(ticketDefs, states, config.queueLimit);
+    const queueRows = buildNextQueue(ticketDefs, states, config.implementationLimit);
     const remaining = ticketDefs.filter((t) => {
         const s = states.get(t.id);
         return s?.status !== "done" && s?.status !== "canceled";
     });
-    const expectedLen = Math.min(config.queueLimit, remaining.length);
+    const expectedLen = Math.min(config.implementationLimit, remaining.length);
     if (queueRows.length !== expectedLen) {
         issues.push({ pass: 3, severity: "error", message: `[queue] expected ${expectedLen} rows, got ${queueRows.length}` });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "An orchestrator that keeps Codex CLI / Claude Code builders moving through their step list unattended. Part of Rafi.",
   "license": "Apache-2.0",
   "type": "module",
@@ -69,7 +69,7 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.148"
   },
   "dependencies": {
-    "special-agents": "0.4.0",
+    "special-agents": "0.5.0",
     "@clack/prompts": "^1.4.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",