ai-foreman 1.0.8 → 1.0.9

package/README.md

@@ -75,6 +75,7 @@ What each part does:
 - TODOs
 - roadmap docs
 - ticket files
+- folders or globs containing planning notes
 
 ## Primary Options
 
@@ -112,6 +113,7 @@ Resume rule:
 | `-a, --agent <agent>` | `claude` / `codex` | `claude` | Builder agent. |
 | `-m, --model <model>` | `gpt-5.5` / any supported agent model | agent default | Overrides the builder model. |
 | `--effort <level>` | Claude Code: `low` / `medium` / `high` / `xhigh`<br>Codex: `low` / `medium` / `high` / `xhigh` | agent default | Reasoning level. |
+| `--sources <paths...>` | `docs/tickets.md docs/plans/**` | scans relevant docs automatically | Optional files, folders, or globs for the agent to check first. Any reasonable planning format is OK. |
 | `--fast` | flag | off | Lower latency. |
 | `-y, --yes` | flag | off | Skips confirmation before builder edits ticket files. |
 
@@ -229,10 +231,12 @@ Supported source material can include:
 - TODOs
 - roadmap docs
 - Markdown trackers
+- folders or globs containing planning notes
 
 ```bash
 # Claude Code
 ai-foreman tickets populate --project ./my-project
+ai-foreman tickets populate --project ./my-project --sources docs/tickets.md docs/plans/**
 
 # Codex
 ai-foreman tickets populate --project ./my-project --agent codex
@@ -519,5 +523,3 @@ Package output:
 
 
 
-
-

package/dist/cli/tickets.d.ts

@@ -1,3 +1,3 @@
 import { Command } from "commander";
-export declare function buildPopulateInstruction(): string;
+export declare function buildPopulateInstruction(sourceHints?: string[]): string;
 export declare function buildTicketsCommand(): Command;

package/dist/cli/tickets.js

@@ -36,14 +36,26 @@ function makeLogPath(projectDir, label) {
     const stamp = new Date().toISOString().replace(/[:.]/g, "-");
     return join(projectDir, ".foreman", `${stamp}-${label}.jsonl`);
 }
-export function buildPopulateInstruction() {
+export function buildPopulateInstruction(sourceHints) {
+    const sources = sourceHints ?? [];
+    const sourceHintBlock = sources.length > 0
+        ? `
+User-provided planning source hints:
+${sources.map((source) => `- ${source}`).join("\n")}
+
+Treat these as files, folders, or globs to check first. Any reasonable project-planning format is acceptable because you are responsible for interpreting it. If a hinted source does not exist or is ambiguous, continue scanning the repository before asking for help.
+`
+        : `
+No specific planning sources were provided. Scan the repository for relevant planning and ticketing documents.
+`;
     return `You are being run by Foreman to populate this repository's Foreman ticket tracker.
 
 Goal:
 - Convert every existing project ticket, task, backlog item, roadmap item, or implementation step into Foreman's structured ticket system.
 - Do not implement product/code changes. Only update ticket-tracker files.
+${sourceHintBlock}
 
-Read these files first:
+Before editing, read these tracker control files:
 - .tickets/config.yaml
 - .tickets/tickets.yaml
 - .tickets/tracker-rules.md
@@ -106,6 +118,7 @@ export function buildTicketsCommand() {
         .option("-a, --agent <agent>", "builder agent (claude | codex)", "claude")
         .option("-m, --model <model>", "override the builder's model")
         .option("--effort <level>", "reasoning effort level (low|medium|high|xhigh)")
+        .option("--sources <paths...>", "source hint files, folders, or globs to check first")
         .option("--fast", "fast mode - lower latency")
         .option("-y, --yes", "skip confirmation prompt before letting the builder edit tickets")
         .action(async (opts) => {
@@ -151,7 +164,7 @@ export function buildTicketsCommand() {
         console.log(`foreman tickets: project ${dir}`);
         console.log(`foreman tickets: log ${logPath}\n`);
         try {
-            const turn = await foreman.runInstruction(buildPopulateInstruction());
+            const turn = await foreman.runInstruction(buildPopulateInstruction(opts.sources));
             await builder.close();
             await viewer;
             log.write("ticket-populate", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-foreman",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "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",