ai-foreman 1.5.0 → 1.6.0

package/dist/tickets/ticketLoader.js

@@ -47,6 +47,24 @@ export function validateTicketDefs(tickets) {
                 errors.push({ path: `tickets[${t.id}].depends_on`, message: `references unknown ticket: ${dep}` });
             }
         }
+        for (const replacement of t.superseded_by ?? []) {
+            if (!ids.has(replacement))
+                errors.push({ path: `tickets[${t.id}].superseded_by`, message: `references unknown ticket: ${replacement}` });
+            if (replacement === t.id)
+                errors.push({ path: `tickets[${t.id}].superseded_by`, message: "ticket cannot supersede itself" });
+            const reciprocal = tickets.find((candidate) => candidate.id === replacement)?.supersedes ?? [];
+            if (ids.has(replacement) && !reciprocal.includes(t.id))
+                errors.push({ path: `tickets[${t.id}].superseded_by`, message: `${replacement} is missing reciprocal supersedes link to ${t.id}` });
+        }
+        for (const replaced of t.supersedes ?? []) {
+            if (!ids.has(replaced))
+                errors.push({ path: `tickets[${t.id}].supersedes`, message: `references unknown ticket: ${replaced}` });
+            if (replaced === t.id)
+                errors.push({ path: `tickets[${t.id}].supersedes`, message: "ticket cannot supersede itself" });
+            const reciprocal = tickets.find((candidate) => candidate.id === replaced)?.superseded_by ?? [];
+            if (!reciprocal.includes(t.id))
+                errors.push({ path: `tickets[${t.id}].supersedes`, message: `${replaced} is missing reciprocal superseded_by link to ${t.id}` });
+        }
     }
     for (const t of tickets) {
         if ((t.risk === "Medium" || t.risk === "High") && !t.rollback) {

package/dist/tickets/ticketSchema.d.ts

@@ -7,6 +7,14 @@ export interface TicketExternalRef {
     key?: string | null;
     url?: string | null;
 }
+/** General provenance reference. `external_refs` remains accepted for compatibility. */
+export interface TicketSourceRef {
+    source: string;
+    item: string;
+    url?: string | null;
+    fingerprint?: string | null;
+    note?: string | null;
+}
 export interface TicketDef {
     id: string;
     order: number;
@@ -23,6 +31,9 @@ export interface TicketDef {
     rollback?: string | null;
     notes?: string | null;
     external_refs?: TicketExternalRef[];
+    source_refs?: TicketSourceRef[];
+    superseded_by?: string[];
+    supersedes?: string[];
 }
 export declare const TICKET_JSON_SCHEMA: {
     readonly type: "object";
@@ -117,6 +128,47 @@ export declare const TICKET_JSON_SCHEMA: {
                 };
             };
         };
+        readonly source_refs: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["source", "item"];
+                readonly additionalProperties: true;
+                readonly properties: {
+                    readonly source: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly item: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                    };
+                    readonly url: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly fingerprint: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                    readonly note: {
+                        readonly type: readonly ["string", "null"];
+                    };
+                };
+            };
+        };
+        readonly superseded_by: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly uniqueItems: true;
+        };
+        readonly supersedes: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly uniqueItems: true;
+        };
     };
 };
 export declare const TICKETS_FILE_SCHEMA: {
@@ -218,6 +270,47 @@ export declare const TICKETS_FILE_SCHEMA: {
                             };
                         };
                     };
+                    readonly source_refs: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly required: readonly ["source", "item"];
+                            readonly additionalProperties: true;
+                            readonly properties: {
+                                readonly source: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly item: {
+                                    readonly type: "string";
+                                    readonly minLength: 1;
+                                };
+                                readonly url: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly fingerprint: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                                readonly note: {
+                                    readonly type: readonly ["string", "null"];
+                                };
+                            };
+                        };
+                    };
+                    readonly superseded_by: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly uniqueItems: true;
+                    };
+                    readonly supersedes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly uniqueItems: true;
+                    };
                 };
             };
         };

package/dist/tickets/ticketSchema.js

@@ -34,6 +34,23 @@ export const TICKET_JSON_SCHEMA = {
                 },
             },
         },
+        source_refs: {
+            type: "array",
+            items: {
+                type: "object",
+                required: ["source", "item"],
+                additionalProperties: true,
+                properties: {
+                    source: { type: "string", minLength: 1 },
+                    item: { type: "string", minLength: 1 },
+                    url: { type: ["string", "null"] },
+                    fingerprint: { type: ["string", "null"] },
+                    note: { type: ["string", "null"] },
+                },
+            },
+        },
+        superseded_by: { type: "array", items: { type: "string" }, uniqueItems: true },
+        supersedes: { type: "array", items: { type: "string" }, uniqueItems: true },
     },
 };
 export const TICKETS_FILE_SCHEMA = {

package/dist/tickets/validate.js

@@ -2,6 +2,7 @@ import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { validateTicketDefs, detectCycles } from "./ticketLoader.js";
 import { buildNextQueue } from "./queue.js";
+import { loadDeliveryConfig, validateDeliveryConfig } from "./delivery.js";
 export function runAllValidation(config, projectDir, ticketDefs, states, db) {
     const issues = [];
     // Pass 1: schema and source
@@ -11,6 +12,17 @@ export function runAllValidation(config, projectDir, ticketDefs, states, db) {
     for (const cycle of detectCycles(ticketDefs)) {
         issues.push({ pass: 1, severity: "error", message: `[cycle] dependency cycle: ${cycle}` });
     }
+    try {
+        const delivery = loadDeliveryConfig(projectDir);
+        if (delivery) {
+            for (const issue of validateDeliveryConfig(delivery, ticketDefs)) {
+                issues.push({ pass: 1, severity: "error", message: `[delivery] ${issue.path}: ${issue.message}` });
+            }
+        }
+    }
+    catch (err) {
+        issues.push({ pass: 1, severity: "error", message: `[delivery] ${err instanceof Error ? err.message : String(err)}` });
+    }
     // Pass 2: state validation
     const ticketIds = new Set(ticketDefs.map((t) => t.id));
     for (const [id, state] of states) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.5.0",
+  "version": "1.6.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",
@@ -25,6 +25,30 @@
       "types": "./dist/interviews.d.ts",
       "default": "./dist/interviews.js"
     },
+    "./runtime-readiness.js": {
+      "types": "./dist/runtimeReadiness.d.ts",
+      "default": "./dist/runtimeReadiness.js"
+    },
+    "./roles.js": {
+      "types": "./dist/roles.d.ts",
+      "default": "./dist/roles.js"
+    },
+    "./build-runs.js": {
+      "types": "./dist/buildRuns.d.ts",
+      "default": "./dist/buildRuns.js"
+    },
+    "./ticket-planning.js": {
+      "types": "./dist/ticketPlanning.d.ts",
+      "default": "./dist/ticketPlanning.js"
+    },
+    "./tickets/source-fetch.js": {
+      "types": "./dist/tickets/sourceFetch.d.ts",
+      "default": "./dist/tickets/sourceFetch.js"
+    },
+    "./tickets/setup-config.js": {
+      "types": "./dist/tickets/setupConfig.d.ts",
+      "default": "./dist/tickets/setupConfig.js"
+    },
     "./cli/tickets.js": {
       "types": "./dist/cli/tickets.d.ts",
       "default": "./dist/cli/tickets.js"
@@ -73,13 +97,16 @@
     "@anthropic-ai/claude-agent-sdk": "^0.3.148"
   },
   "dependencies": {
-    "special-agents": "0.6.0",
+    "special-agents": "0.7.0",
+    "rafi-spec": "0.7.0",
     "@clack/prompts": "^1.4.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",
     "better-sqlite3": "^12.10.0",
     "commander": "^12.1.0",
     "luxon": "^3.7.2",
+    "parse5": "7.2.1",
+    "pdfjs-dist": "4.10.38",
     "yaml": "^2.5.1"
   },
   "devDependencies": {