ai-foreman 1.3.0 → 1.3.1

package/README.md

@@ -258,11 +258,15 @@ Init options:
 | `-p, --project <dir>` | `./my-project` / `../repo` | current directory | Project to initialize. |
 | `--app-name <name>` | `"My App"` | none | Application name stored in tracker config. |
 | `--timezone <tz>` | `America/Chicago` / `UTC` | `UTC` | IANA timezone. |
-| `--queue-limit <n>` | `25` / `50` / `100` | `50` | Next-queue window size. |
+| `--implementation-limit <n>` | `250` / `500` / `1000` | `500` | Implementation queue window for generated docs and Foreman selection. |
+| `--view-limit <n>` | `1000` / `20000` | `20000` | Default row limit for the display queue command. |
+| `--queue-limit <n>` | `250` / `500` / `1000` | none | Deprecated alias for `--implementation-limit`. |
 | `--docs-root <dir>` | `docs` / `docs-rafi` | `rafi-config.yaml` docs.root, then `docs` | Root for generated progress/archive docs. |
 
 `tickets init` reads `docs.root` from `rafi-config.yaml` when present. `--docs-root` overrides that value. The selected root must be a safe repo-relative directory, and init refuses to overwrite an existing selected `ticket-progress.md`.
 
+Init writes `implementation_limit` and `view_limit` to `.tickets/config.yaml`. Existing configs with `queue_limit` still load as an implementation limit, with the old default value `50` upgraded to `500`.
+
 This creates:
 
 ```txt

package/dist/cli/tickets.js

@@ -8,7 +8,7 @@ import { Log } from "../log.js";
 import { Foreman } from "../foreman.js";
 import { printEvents } from "./events.js";
 import { cmdInit, cmdUpdate, cmdComplete, cmdBlock, cmdUnblock, cmdCancel, cmdDiscover, cmdAcceptFutureWork, cmdReorder, cmdRender, cmdValidate, cmdQueue, cmdArchive, } from "../tickets/commands.js";
-import { isTicketsInitialized, loadTicketsConfig } from "../tickets/config.js";
+import { DEFAULT_TICKETS_CONFIG, isTicketsInitialized, loadTicketsConfig } from "../tickets/config.js";
 import { validateDocsRoot } from "../tickets/config.js";
 import { importFromMarkdown } from "../tickets/importer.js";
 import { formatValidationIssues } from "../tickets/validate.js";
@@ -23,6 +23,10 @@ function cwd(opts) {
 function unique(values) {
     return [...new Set(values)];
 }
+function optionWasProvided(command, name) {
+    const source = command.getOptionValueSource(name);
+    return source !== undefined && source !== "default";
+}
 const TICKET_POPULATE_ROLE = "ticket-maker";
 const RAFI_CONFIG_FILES = ["rafi-config.yaml", "project.yaml"];
 function validateEffort(effort) {
@@ -134,15 +138,24 @@ export function buildTicketsCommand() {
         .option("-p, --project <dir>", "project directory (default: cwd)")
         .option("--app-name <name>", "application name")
         .option("--timezone <tz>", "IANA timezone (e.g. America/Chicago)", "UTC")
-        .option("--queue-limit <n>", "next-queue window size", "50")
+        .option("--implementation-limit <n>", "implementation queue window size", String(DEFAULT_TICKETS_CONFIG.implementationLimit))
+        .option("--view-limit <n>", "ticket queue display limit", String(DEFAULT_TICKETS_CONFIG.viewLimit))
+        .option("--queue-limit <n>", "deprecated alias for --implementation-limit")
         .option("--docs-root <dir>", "repo-relative directory for generated ticket docs")
-        .action((opts) => {
+        .action((opts, command) => {
         const dir = cwd(opts);
         try {
+            const hasImplementationLimit = optionWasProvided(command, "implementationLimit");
+            const hasLegacyQueueLimit = optionWasProvided(command, "queueLimit");
+            if (hasImplementationLimit && hasLegacyQueueLimit) {
+                fail("--implementation-limit and deprecated --queue-limit cannot both be passed");
+            }
             cmdInit(dir, {
                 appName: opts.appName,
                 timezone: opts.timezone,
-                queueLimit: Number(opts.queueLimit),
+                implementationLimit: hasImplementationLimit ? Number(opts.implementationLimit) : undefined,
+                viewLimit: optionWasProvided(command, "viewLimit") ? Number(opts.viewLimit) : undefined,
+                queueLimit: hasLegacyQueueLimit ? Number(opts.queueLimit) : undefined,
                 docsRoot: opts.docsRoot,
             });
             console.log(`foreman tickets: initialized .tickets/ in ${dir}`);
@@ -489,12 +502,12 @@ export function buildTicketsCommand() {
     // ── queue ─────────────────────────────────────────────────────────────────────
     tickets
         .command("queue")
-        .description("Print the next-N queue to stdout.")
+        .description("Print the ticket queue to stdout.")
         .option("-p, --project <dir>", "project directory (default: cwd)")
-        .option("--limit <n>", "override queue limit")
+        .option("--limit <n>", "override view limit")
         .action((opts) => {
         try {
-            const rows = cmdQueue(cwd(opts), opts.limit ? Number(opts.limit) : undefined);
+            const rows = cmdQueue(cwd(opts), opts.limit !== undefined ? Number(opts.limit) : undefined);
             if (rows.length === 0) {
                 console.log("No remaining tickets.");
             }

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/tickets/commands.d.ts

@@ -14,6 +14,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 +88,7 @@ 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;

package/dist/tickets/commands.js

@@ -1,7 +1,7 @@
 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";
@@ -32,6 +32,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 +49,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: {
@@ -424,7 +428,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 ───────────────────────────────────────────────────────────────────

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/renderMarkdown.js

@@ -59,7 +59,7 @@ export const DEFAULT_TRACKER_RULES = renderTrackerRules();
 export function renderProgressDoc(input) {
     const { config, projectDir, ticketDefs, states, db } = input;
     const now = input.now ?? DateTime.now().setZone(config.timezone).toISO();
-    const queueRows = buildNextQueue(ticketDefs, states, config.queueLimit);
+    const queueRows = buildNextQueue(ticketDefs, states, config.implementationLimit);
     const activeRows = buildActiveStatusRows(queueRows, ticketDefs, states);
     const futureWork = db.getFutureWork();
     const recentEvents = db.getRecentEvents(config.rendering.maxWorkLogRows);
@@ -82,7 +82,8 @@ export function renderProgressDoc(input) {
     lines.push("## Tracker Metadata");
     lines.push(section("TRACKER_METADATA", table(["Field", "Value"], [
         ["App", config.appName],
-        ["Queue Limit", String(config.queueLimit)],
+        ["Implementation Limit", String(config.implementationLimit)],
+        ["View Limit", String(config.viewLimit)],
         ["Timezone", config.timezone],
         ["Generated At", now],
         ["Remaining Tickets", String(queueRows.length > 0 ? "≥" + queueRows.length : "0")],

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.3.1",
   "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",