ai-foreman 1.3.0 → 1.4.0

package/dist/foreman.js

@@ -2,7 +2,7 @@ import { select, isCancel } from "@clack/prompts";
 import { MARKER_SPEC, QA_MARKER_SPEC } from "./markers.js";
 import { fireNotification } from "./notify.js";
 import { isTicketsInitialized } from "./tickets/config.js";
-import { cmdUpdate, cmdComplete, cmdBlock, cmdQueue } from "./tickets/commands.js";
+import { cmdUpdate, cmdComplete, cmdBlock, cmdImplementationQueue } from "./tickets/commands.js";
 /** Phrases that suggest the builder ended its turn by asking the human. */
 const QUESTION_HINTS = [
     "should i",
@@ -324,7 +324,7 @@ export class Foreman {
             let pendingTicketId;
             if (this.ticketsEnabled && this.projectDir) {
                 try {
-                    const queue = cmdQueue(this.projectDir);
+                    const queue = cmdImplementationQueue(this.projectDir);
                     const next = queue.find((r) => r.status === "next");
                     if (next) {
                         pendingTicketId = next.ticket;

package/dist/log.d.ts

@@ -1,7 +1,7 @@
 /** A single structured log record. */
 export interface LogRecord {
     ts: string;
-    event: "batch-start" | "batch-end" | "branch-plan" | "branch-start" | "branch-session" | "branch-resume" | "branch-issue" | "branch-complete" | "branch-push" | "github-readiness-failed" | "pr-created" | "pr-existing" | "pr-failed" | "step" | "permission" | "escalation" | "needs_input" | "preflight" | "rafi-plan" | "ticket-populate" | "qa" | "qa-fix" | "error";
+    event: "batch-start" | "batch-end" | "branch-plan" | "branch-start" | "branch-session" | "branch-resume" | "branch-issue" | "branch-complete" | "branch-push" | "github-readiness-failed" | "gitlab-readiness-failed" | "pr-created" | "pr-existing" | "pr-failed" | "pr-auto-merge-enabled" | "pr-auto-merge-failed" | "mr-created" | "mr-existing" | "mr-failed" | "mr-auto-merge-enabled" | "mr-auto-merge-failed" | "branch-auto-merge-wait" | "branch-direct-merge" | "step" | "permission" | "escalation" | "needs_input" | "preflight" | "rafi-plan" | "ticket-populate" | "qa" | "qa-fix" | "error";
     [key: string]: unknown;
 }
 /** Append-only JSONL logger. One line per record, plus an echo to the console. */

package/dist/tickets/commands.d.ts

@@ -3,6 +3,7 @@ import type { ValidationResult } from "./stateDb.js";
 import { type TicketsConfig, resolveTicketPaths } from "./config.js";
 import { StateDb } from "./stateDb.js";
 import { runAllValidation } from "./validate.js";
+import { type ReviewCommandOptions, type ReviewCommandResult } from "./recommendations.js";
 export interface TicketContext {
     config: TicketsConfig;
     projectDir: string;
@@ -14,6 +15,9 @@ export declare function openContext(projectDir: string): TicketContext;
 export interface InitOptions {
     appName?: string;
     timezone?: string;
+    implementationLimit?: number;
+    viewLimit?: number;
+    /** @deprecated Use implementationLimit. */
     queueLimit?: number;
     docsRoot?: string;
 }
@@ -85,6 +89,8 @@ export interface ValidateResult {
 }
 export declare function cmdValidate(projectDir: string): ValidateResult;
 export declare function cmdQueue(projectDir: string, limit?: number): import("./queue.js").QueueRow[];
+export declare function cmdImplementationQueue(projectDir: string): import("./queue.js").QueueRow[];
 export declare function cmdArchive(projectDir: string, _opts: {
     olderThanDays?: number;
 }): void;
+export declare function cmdReview(projectDir: string, opts?: ReviewCommandOptions): ReviewCommandResult;

package/dist/tickets/commands.js

@@ -1,13 +1,14 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { stringify } from "yaml";
-import { initDocsRoot, loadTicketsConfig, pathExistsOrSymlink, resolveTicketPaths, isTicketsInitialized, } from "./config.js";
+import { DEFAULT_TICKETS_CONFIG, initDocsRoot, loadTicketsConfig, pathExistsOrSymlink, resolveTicketPaths, isTicketsInitialized, } from "./config.js";
 import { loadTickets, saveTickets } from "./ticketLoader.js";
 import { StateDb } from "./stateDb.js";
 import { nowTimestamp, logEvent } from "./events.js";
 import { renderAndWrite, renderTrackerRules } from "./renderMarkdown.js";
 import { runAllValidation } from "./validate.js";
 import { buildNextQueue } from "./queue.js";
+import { cmdReviewRecommendations } from "./recommendations.js";
 export function openContext(projectDir) {
     const config = loadTicketsConfig(projectDir);
     const paths = resolveTicketPaths(config, projectDir);
@@ -32,6 +33,9 @@ export function cmdInit(projectDir, opts) {
     if (isTicketsInitialized(projectDir)) {
         throw new Error(".tickets/config.yaml already exists — already initialized.");
     }
+    if (opts.implementationLimit !== undefined && opts.queueLimit !== undefined) {
+        throw new Error("--implementation-limit and deprecated --queue-limit cannot both be set");
+    }
     const ticketsDir = join(projectDir, ".tickets");
     const docsRoot = initDocsRoot(projectDir, opts.docsRoot);
     const progressDoc = `${docsRoot}/ticket-progress.md`;
@@ -46,7 +50,8 @@ export function cmdInit(projectDir, opts) {
     mkdirSync(join(projectDir, docsRoot), { recursive: true });
     const config = {
         app_name: opts.appName ?? "My App",
-        queue_limit: opts.queueLimit ?? 50,
+        implementation_limit: opts.implementationLimit ?? opts.queueLimit ?? DEFAULT_TICKETS_CONFIG.implementationLimit,
+        view_limit: opts.viewLimit ?? DEFAULT_TICKETS_CONFIG.viewLimit,
         timezone: opts.timezone ?? "UTC",
         timestamp_format: "iso8601_offset",
         paths: {
@@ -74,6 +79,14 @@ export function cmdInit(projectDir, opts) {
     };
     writeFileSync(join(ticketsDir, "config.yaml"), stringify(config, { lineWidth: 80 }), "utf8");
     writeFileSync(join(ticketsDir, "tickets.yaml"), "tickets: []\n", "utf8");
+    writeFileSync(join(ticketsDir, ".gitignore"), [
+        "imports/",
+        "ticket-state.sqlite",
+        "ticket-state.sqlite-shm",
+        "ticket-state.sqlite-wal",
+        "backups/",
+        "",
+    ].join("\n"), "utf8");
     writeFileSync(join(ticketsDir, "tracker-rules.md"), renderTrackerRules(progressDoc), "utf8");
     const ticketSchema = {
         $schema: "http://json-schema.org/draft-07/schema#",
@@ -96,6 +109,20 @@ export function cmdInit(projectDir, opts) {
             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"] },
+                    },
+                },
+            },
         },
     };
     writeFileSync(join(ticketsDir, "schema", "tickets.schema.json"), JSON.stringify(ticketSchema, null, 2), "utf8");
@@ -424,7 +451,13 @@ export function cmdValidate(projectDir) {
 export function cmdQueue(projectDir, limit) {
     return withContext(projectDir, (ctx) => {
         const states = ctx.db.getAllStates();
-        return buildNextQueue(ctx.tickets, states, limit ?? ctx.config.queueLimit);
+        return buildNextQueue(ctx.tickets, states, limit ?? ctx.config.viewLimit);
+    });
+}
+export function cmdImplementationQueue(projectDir) {
+    return withContext(projectDir, (ctx) => {
+        const states = ctx.db.getAllStates();
+        return buildNextQueue(ctx.tickets, states, ctx.config.implementationLimit);
     });
 }
 // ── archive ───────────────────────────────────────────────────────────────────
@@ -443,3 +476,7 @@ export function cmdArchive(projectDir, _opts) {
         renderAfterUpdate(ctx);
     });
 }
+// ── review recommendations ──────────────────────────────────────────────────
+export function cmdReview(projectDir, opts = {}) {
+    return cmdReviewRecommendations(projectDir, opts);
+}

package/dist/tickets/config.d.ts

@@ -22,7 +22,8 @@ export interface TicketsBehavior {
 }
 export interface TicketsConfig {
     appName: string;
-    queueLimit: number;
+    implementationLimit: number;
+    viewLimit: number;
     timezone: string;
     paths: TicketsPaths;
     rendering: TicketsRendering;

package/dist/tickets/config.js

@@ -3,7 +3,8 @@ import { dirname, isAbsolute, join, normalize, relative, resolve } from "node:pa
 import { parse } from "yaml";
 export const DEFAULT_TICKETS_CONFIG = {
     appName: "My App",
-    queueLimit: 50,
+    implementationLimit: 500,
+    viewLimit: 20_000,
     timezone: "UTC",
     paths: {
         tickets: ".tickets/tickets.yaml",
@@ -126,7 +127,8 @@ export function loadTicketsConfig(projectDir) {
     assertPlainObject(raw.behavior, "behavior", configPath);
     const config = {
         appName: raw.app_name ?? DEFAULT_TICKETS_CONFIG.appName,
-        queueLimit: raw.queue_limit ?? DEFAULT_TICKETS_CONFIG.queueLimit,
+        implementationLimit: resolveImplementationLimit(raw),
+        viewLimit: raw.view_limit ?? DEFAULT_TICKETS_CONFIG.viewLimit,
         timezone: raw.timezone ?? DEFAULT_TICKETS_CONFIG.timezone,
         paths: {
             ...DEFAULT_TICKETS_CONFIG.paths,
@@ -144,6 +146,17 @@ export function loadTicketsConfig(projectDir) {
     validateTicketsConfig(config, configPath);
     return config;
 }
+function resolveImplementationLimit(raw) {
+    if (raw.implementation_limit !== undefined) {
+        return raw.implementation_limit;
+    }
+    if (raw.queue_limit !== undefined) {
+        return raw.queue_limit === 50
+            ? DEFAULT_TICKETS_CONFIG.implementationLimit
+            : raw.queue_limit;
+    }
+    return DEFAULT_TICKETS_CONFIG.implementationLimit;
+}
 function assertPlainObject(value, name, configPath) {
     if (value !== undefined && (!value || typeof value !== "object" || Array.isArray(value))) {
         throw new Error(`${configPath}: ${name} must be an object`);
@@ -153,8 +166,11 @@ function validateTicketsConfig(config, configPath) {
     if (!config.appName || typeof config.appName !== "string") {
         throw new Error(`${configPath}: app_name must be a non-empty string`);
     }
-    if (!Number.isInteger(config.queueLimit) || config.queueLimit < 1) {
-        throw new Error(`${configPath}: queue_limit must be a positive integer`);
+    if (!Number.isInteger(config.implementationLimit) || config.implementationLimit < 1) {
+        throw new Error(`${configPath}: implementation_limit must be a positive integer`);
+    }
+    if (!Number.isInteger(config.viewLimit) || config.viewLimit < 1) {
+        throw new Error(`${configPath}: view_limit must be a positive integer`);
     }
     if (!config.timezone || typeof config.timezone !== "string") {
         throw new Error(`${configPath}: timezone must be a non-empty IANA timezone string`);

package/dist/tickets/importer.d.ts

@@ -1 +1,56 @@
+import type { TicketDef } from "./ticketSchema.js";
+import type { TicketSourceConfig } from "./setupConfig.js";
 export declare function importFromMarkdown(_progressDocPath: string): never;
+export interface ImportedTicketItem {
+    provider: "linear" | "jira";
+    providerId: string;
+    key?: string | null;
+    url?: string | null;
+    title: string;
+    description?: string | null;
+    area?: string | null;
+    priority?: string | number | null;
+    size?: string | number | null;
+    status?: string | null;
+    statusCategory?: string | null;
+    labels?: string[];
+    comments?: ImportedComment[];
+    createdAt?: string | null;
+    updatedAt?: string | null;
+    raw: unknown;
+}
+export interface ImportedComment {
+    author?: string | null;
+    body: string;
+    createdAt?: string | null;
+}
+export interface ExternalImportOptions {
+    importCap: number;
+    commentLimit: number;
+    recommendSplitForXl?: boolean;
+}
+export interface ExternalImportResult {
+    provider: "linear" | "jira";
+    sourceLabel: string;
+    fetched: number;
+    created: number;
+    updated: number;
+    snapshotPath: string;
+}
+export declare function importExternalSources(projectDir: string, sources: Extract<TicketSourceConfig, {
+    type: "linear" | "jira";
+}>[], opts: ExternalImportOptions): Promise<ExternalImportResult[]>;
+export declare function validateExternalSourceAccess(source: Extract<TicketSourceConfig, {
+    type: "linear" | "jira";
+}>): Promise<void>;
+export declare function fetchLinearIssues(source: Extract<TicketSourceConfig, {
+    type: "linear";
+}>, opts: ExternalImportOptions): Promise<ImportedTicketItem[]>;
+export declare function fetchJiraIssues(source: Extract<TicketSourceConfig, {
+    type: "jira";
+}>, opts: ExternalImportOptions): Promise<ImportedTicketItem[]>;
+export declare function applyImportedItems(projectDir: string, items: ImportedTicketItem[]): {
+    created: number;
+    updated: number;
+    tickets: TicketDef[];
+};