@open-agent-toolkit/cli 0.1.63 → 0.1.65

package/assets/skills/oat-project-review-provide/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-review-provide
-version: 1.3.15
+version: 1.3.16
 description: Use when the user explicitly asks to review an OAT project — e.g. "review project", "review the project", "run project review", or confirms a previously offered review. Do NOT auto-invoke on completed work alone. Resolves a project review scope and offers before running.
 disable-model-invocation: false
 user-invocable: true
@@ -92,6 +92,14 @@ Run the `oat-project-review-provide` skill and it will:
 2. Ask scope (task/phase/final/range)
 3. Confirm before running
 
+## Artifact Hygiene
+
+Artifact hygiene contract: Before finishing or committing, format every file you created or edited. Use the concrete write/fix formatting command supplied by the governing plan, task, or brief. If none is usable, discover the repository's documented write/fix command from applicable `AGENTS.md`/`CLAUDE.md` instructions and relevant package manifests; do not infer or hardcode a formatter. Prefer a file-scoped invocation when supported, and avoid rewriting unrelated files. If no command is discoverable, warn once with `no format command discovered in repo instructions; skipping`, then continue.
+
+After formatting, run only repository checks relevant to the files changed;
+writing prose artifacts or review bookkeeping does not imply unrelated full
+test suites.
+
 ## Process
 
 ### Step 0: Resolve Project or Explicit Review Target

package/assets/skills/oat-project-review-receive/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-review-receive
-version: 1.5.6
+version: 1.5.7
 description: Use when the user explicitly asks to receive review findings for an OAT project — e.g. "receive review", "process review", "process the project review", or confirms a previously offered review-receive step. Do NOT auto-invoke merely because a review file exists. Resolves the latest review and offers before acting.
 disable-model-invocation: false
 user-invocable: true
@@ -70,6 +70,14 @@ When executing this skill, provide lightweight progress feedback so the user can
 - Routing to oat-project-implement
 - For `artifact` reviews: updating reviewed artifact files directly after user confirmation
 
+## Artifact Hygiene
+
+Artifact hygiene contract: Before finishing or committing, format every file you created or edited. Use the concrete write/fix formatting command supplied by the governing plan, task, or brief. If none is usable, discover the repository's documented write/fix command from applicable `AGENTS.md`/`CLAUDE.md` instructions and relevant package manifests; do not infer or hardcode a formatter. Prefer a file-scoped invocation when supported, and avoid rewriting unrelated files. If no command is discoverable, warn once with `no format command discovered in repo instructions; skipping`, then continue.
+
+After formatting, run only repository checks relevant to the files changed;
+writing prose artifacts or review bookkeeping does not imply unrelated full
+test suites.
+
 ## Process
 
 ### Step 0: Resolve Active Project

package/assets/skills/oat-project-summary/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: oat-project-summary
-version: 1.3.0
+version: 1.3.2
 description: Use when the user requests or confirms summarizing an active OAT project — e.g. "summarize the project", "generate the summary", "run oat-project-summary", or confirms a previously offered summary run. Do NOT auto-invoke when implementation completes. Generates summary.md from project artifacts as institutional memory.
 disable-model-invocation: false
 user-invocable: true
@@ -69,6 +69,13 @@ If you catch yourself:
 2. Return to summary generation
 3. Keep content grounded in artifacts
 
+## Artifact Hygiene
+
+Artifact hygiene contract: Before finishing or committing, format every file you created or edited. Use the concrete write/fix formatting command supplied by the governing plan, task, or brief. If none is usable, discover the repository's documented write/fix command from applicable `AGENTS.md`/`CLAUDE.md` instructions and relevant package manifests; do not infer or hardcode a formatter. Prefer a file-scoped invocation when supported, and avoid rewriting unrelated files. If no command is discoverable, warn once with `no format command discovered in repo instructions; skipping`, then continue.
+
+After formatting, run only repository checks relevant to the files changed;
+writing prose artifacts does not imply unrelated full test suites.
+
 ## Process
 
 ### Step 0: Resolve Active Project
@@ -271,7 +278,12 @@ test -f .oat/repo/reference/decisions/index.md || oat decision init
 
 **6.4 — Idempotent, date-independent promotion (critical).** For each decision in `## Key Decisions`:
 
-1. **Derive title + rationale.** The decision's bold lead-in / first clause becomes the **title** (a short noun phrase). The remaining explanatory text becomes the **rationale**, passed verbatim as `--context`.
+1. **Derive title + complete sections.** Ground every value in the Key Decision and its project artifacts:
+   - The bold lead-in / first clause becomes the **title** (a short noun phrase).
+   - The problem, constraint, or motivating rationale becomes **context**.
+   - The choice that was made becomes the **decision**.
+   - The resulting tradeoffs, follow-on effects, or operational implications become **consequences**.
+     Each section must contain concrete grounded prose; do not pass placeholder content.
 2. **Compute the slug the CLI would use.** The CLI generates the record ID as `DR-<YYMMDD>-<slug>`, where `<slug>` is the lowercased, ASCII-folded, hyphen-collapsed form of the title, capped at 30 characters at the last whole-word boundary with trailing stop-words (`a, an, the, of, for, and, to, in, on, as, with`) trimmed (the same slug rule the CLI applies). Compute that `<slug>` for the title.
 3. **Dedup on the exact slug, ignoring only the date prefix.** A record ID is `DR-<YYMMDD>-<slug>`, where the date is exactly six digits. Check whether a record for this slug already exists by stripping that fixed `DR-<6 digits>-` prefix from existing record IDs and comparing the remaining slug for **exact equality**. Anchor the date to exactly six characters so the slug must match in full:
 
@@ -287,10 +299,10 @@ test -f .oat/repo/reference/decisions/index.md || oat decision init
    - Otherwise → create it:
 
      ```bash
-     oat decision new "<title>" --status accepted --context "<rationale>"
+     oat decision new "<title>" --status accepted --context "<context>" --decision "<decision>" --consequences "<consequences>"
      ```
 
-     The command generates the deterministic `DR-YYMMDD-slug` ID, seeds the body from `.oat/templates/decision.md`, and regenerates the managed index automatically — do not hand-edit `index.md`. Optionally pass `--created-at "<project completion date>"` when a project completion date is available, so the record's date reflects when the decision was made.
+     The command generates the deterministic `DR-YYMMDD-slug` ID, fills every decision body section, and regenerates the managed index automatically — do not hand-edit `index.md`. Optionally pass `--created-at "<project completion date>"` when a project completion date is available, so the record's date reflects when the decision was made.
 
 Because of the date-independent slug dedup, this step is **safe to run every time `summary.md` is (re)generated** — including the pr-final refresh and revision re-runs — without ever creating duplicate decision records. Already-promoted decisions are skipped; only genuinely new Key Decisions become new records.
 

package/assets/templates/plan.md

@@ -65,6 +65,8 @@ Codex effort values are preferred controls. `oat-project-implement` caps them wh
 
 ---
 
+RED/GREEN/Refactor is the recommended default where work is testable, not a validator requirement. Other task-body shapes, including non-TDD shapes, are allowed when appropriate, provided the plan preserves stable `pNN-tNN` IDs, per-task verification, and atomic commits.
+
 ## Phase 1: {Phase Name}
 
 ### Task p01-t01: {Task Name}

package/dist/commands/backlog/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/archive.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,iBAAiB,EAGvB,MAAM,sBAAsB,CAAC;AAoB9B,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAK;CAKjD;AAkID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAkHnC"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/archive.ts"],"names":[],"mappings":"AASA,OAAO,EAEL,KAAK,iBAAiB,EAGvB,MAAM,sBAAsB,CAAC;AAmB9B,mDAAmD;AACnD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;IAC5B,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,cAAc,EAAE,SAAS,GAAG,YAAY,GAAG,SAAS,CAAC;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8EAA8E;IAC9E,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ;AAED;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,CAAC,GAAG,CAAK;CAKjD;AAkID;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,GAAE,yBAA8B,GACtC,OAAO,CAAC,wBAAwB,CAAC,CAqHnC"}

package/dist/commands/backlog/archive.js

@@ -8,7 +8,6 @@ import { regenerateBacklogIndex } from './regenerate-index.js';
 import { BACKLOG_ITEM_STATUSES, extractBacklogStatus, isValidBacklogStatus, } from './shared/item-status.js';
 const execFileAsync = promisify(execFile);
 const COMPLETED_HEADING = '## Completed Items';
-const TODO_SUMMARY = 'TODO: summarize outcome';
 const STARTER_COMPLETED = [
     '# OAT Backlog Completed',
     '',
@@ -178,6 +177,10 @@ export async function archiveBacklogItem(backlogRoot, id, options = {}) {
         throw new BacklogArchiveError(`Backlog item ${itemsPath} has invalid status "${currentStatus ?? ''}". Valid statuses: ${BACKLOG_ITEM_STATUSES.join(', ')}. Fix: correct the \`status\` field manually, then re-run \`oat backlog archive ${id}\`.`);
     }
     const targetStatus = options.wontDo ? 'wont_do' : 'closed';
+    const summary = options.summary?.trim() ?? '';
+    if (targetStatus === 'closed' && summary.length === 0) {
+        throw new BacklogArchiveError(`Closing backlog item ${id} requires a non-empty outcome summary. Fix: rerun with \`--summary "<outcome>"\`.`);
+    }
     const now = options.now ?? new Date();
     const updatedIso = now.toISOString().replace(/\.\d{3}Z$/, 'Z');
     const entryDate = updatedIso.slice(0, 10);
@@ -188,11 +191,8 @@ export async function archiveBacklogItem(backlogRoot, id, options = {}) {
     // 5. completed.md entry — always for `closed`; only with a summary for
     //    `wont_do`.
     let completedEntry = 'skipped';
-    const shouldWriteEntry = targetStatus === 'closed' || Boolean(options.summary);
+    const shouldWriteEntry = targetStatus === 'closed' || summary.length > 0;
     if (shouldWriteEntry) {
-        const summary = options.summary?.trim()
-            ? options.summary.trim()
-            : TODO_SUMMARY;
         const entryLine = `- ${entryDate} — ${id} — ${title} — ${summary}`;
         const completedPath = join(backlogRoot, 'completed.md');
         let scaffoldedFile = false;

package/dist/commands/backlog/index.d.ts

@@ -1,14 +1,18 @@
 import { buildCommandContext } from '../../app/command-context.js';
+import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
 import { archiveBacklogItem } from './archive.js';
 import { initializeBacklog } from './init.js';
+import { createBacklogItem } from './new.js';
 import { regenerateBacklogIndex } from './regenerate-index.js';
 interface BacklogCommandDependencies {
     buildCommandContext: typeof buildCommandContext;
     resolveProjectRoot: typeof resolveProjectRoot;
+    resolveAssetsRoot: typeof resolveAssetsRoot;
     initializeBacklog: typeof initializeBacklog;
     regenerateBacklogIndex: typeof regenerateBacklogIndex;
+    createBacklogItem: typeof createBacklogItem;
     archiveBacklogItem: typeof archiveBacklogItem;
     pathExists: (path: string) => Promise<boolean>;
 }

package/dist/commands/backlog/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAqB5D,UAAU,0BAA0B;IAClC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AA0CD,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAiMT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAuB,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AA8B5D,UAAU,0BAA0B;IAClC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AA4CD,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAqQT"}

package/dist/commands/backlog/index.js

@@ -2,10 +2,12 @@ import { access } from 'node:fs/promises';
 import { join, resolve } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
+import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
 import { archiveBacklogItem, BacklogArchiveError } from './archive.js';
 import { initializeBacklog } from './init.js';
+import { createBacklogItem } from './new.js';
 import { regenerateBacklogIndex } from './regenerate-index.js';
 import { generateBacklogId } from './shared/generate-id.js';
 async function pathExistsDefault(path) {
@@ -26,8 +28,10 @@ async function pathExistsDefault(path) {
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveProjectRoot,
+    resolveAssetsRoot,
     initializeBacklog,
     regenerateBacklogIndex,
+    createBacklogItem,
     archiveBacklogItem,
     pathExists: pathExistsDefault,
 };
@@ -60,6 +64,57 @@ export function createBacklogCommand(overrides = {}) {
         }
         process.exitCode = 0;
     });
+    cmd
+        .command('new')
+        .description('Create a new file-backed backlog item')
+        .argument('<title>', 'Backlog item title')
+        .option('--priority <priority>', 'Item priority', 'medium')
+        .option('--scope <scope>', 'Item scope', 'task')
+        .option('--scope-estimate <size>', 'Optional scope estimate (XS|S|M|L|XL|XXL)')
+        .option('--labels <labels>', 'Comma-delimited labels', (value) => value.split(','))
+        .option('--description <text>', 'Initial description body text')
+        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/pjm/backlog)')
+        .action(async (title, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+            const backlogRoot = await resolveBacklogRoot(context, options.backlogRoot, dependencies);
+            const assetsRoot = await dependencies.resolveAssetsRoot();
+            const result = await dependencies.createBacklogItem({
+                backlogRoot,
+                assetsRoot,
+                templatesRoot: resolve(projectRoot, '.oat', 'templates'),
+                title,
+                priority: options.priority,
+                scope: options.scope,
+                scopeEstimate: options.scopeEstimate,
+                labels: options.labels,
+                description: options.description,
+            });
+            if (context.json) {
+                context.logger.json({ status: 'ok', ...result });
+            }
+            else {
+                for (const warning of result.index.warnings) {
+                    context.logger.warn(warning);
+                }
+                context.logger.info(`Created backlog item ${result.id}`);
+                context.logger.info(`Wrote ${result.filePath}`);
+                context.logger.info(`Regenerated backlog index with ${result.index.itemCount} ${result.index.itemCount === 1 ? 'item' : 'items'}.`);
+            }
+            process.exitCode = 0;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (context.json) {
+                context.logger.json({ status: 'error', message });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = 1;
+        }
+    });
     cmd
         .command('regenerate-index')
         .description('Regenerate the managed backlog index table')

package/dist/commands/backlog/new.d.ts

@@ -0,0 +1,27 @@
+import { initializeBacklog } from './init.js';
+import { regenerateBacklogIndex, type RegenerateBacklogIndexResult } from './regenerate-index.js';
+export interface CreateBacklogItemOptions {
+    backlogRoot: string;
+    assetsRoot: string;
+    templatesRoot?: string;
+    title: string;
+    priority?: string;
+    scope?: string;
+    scopeEstimate?: string;
+    labels?: string[];
+    description?: string;
+    createdAt?: string;
+}
+export interface CreateBacklogItemResult {
+    id: string;
+    backlogRoot: string;
+    filePath: string;
+    templatePath: string;
+    index: RegenerateBacklogIndexResult;
+}
+export interface CreateBacklogItemDependencies {
+    initializeBacklog: typeof initializeBacklog;
+    regenerateBacklogIndex: typeof regenerateBacklogIndex;
+}
+export declare function createBacklogItem(options: CreateBacklogItemOptions, overrides?: Partial<CreateBacklogItemDependencies>): Promise<CreateBacklogItemResult>;
+//# sourceMappingURL=new.d.ts.map

package/dist/commands/backlog/new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/new.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,KAAK,4BAA4B,EAClC,MAAM,oBAAoB,CAAC;AAS5B,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,4BAA4B,CAAC;CACrC;AAED,MAAM,WAAW,6BAA6B;IAC5C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AAuLD,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,EACjC,SAAS,GAAE,OAAO,CAAC,6BAA6B,CAAM,GACrD,OAAO,CAAC,uBAAuB,CAAC,CAqDlC"}

package/dist/commands/backlog/new.js

@@ -0,0 +1,158 @@
+import { access, readFile, rm, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { stripTemplateFrontmatter } from '../shared/strip-template-frontmatter.js';
+import YAML from 'yaml';
+import { initializeBacklog } from './init.js';
+import { regenerateBacklogIndex, } from './regenerate-index.js';
+import { generateBacklogId } from './shared/generate-id.js';
+const PRIORITIES = ['urgent', 'high', 'medium', 'low', 'none'];
+const SCOPES = ['idea', 'task', 'feature', 'initiative'];
+const SCOPE_ESTIMATES = ['XS', 'S', 'M', 'L', 'XL', 'XXL'];
+const DESCRIPTION_PLACEHOLDER = '{Describe the problem, request, or capability tracked by this backlog item.}';
+const DEFAULT_DEPENDENCIES = {
+    initializeBacklog,
+    regenerateBacklogIndex,
+};
+async function pathExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : null;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+        return false;
+    }
+}
+async function resolveBacklogTemplate(assetsRoot, templatesRoot) {
+    const candidates = [
+        ...(templatesRoot ? [join(templatesRoot, 'backlog-item.md')] : []),
+        join(assetsRoot, 'templates', 'backlog-item.md'),
+    ];
+    for (const path of candidates) {
+        try {
+            return { content: await readFile(path, 'utf8'), path };
+        }
+        catch (error) {
+            const code = error && typeof error === 'object' && 'code' in error
+                ? String(error.code)
+                : null;
+            if (code !== 'ENOENT') {
+                throw error;
+            }
+        }
+    }
+    throw new Error('Template backlog-item.md was not found in repo-local templates or bundled assets.');
+}
+function normalizeChoice(field, value, fallback, allowed, transform) {
+    const normalized = transform(value ?? fallback);
+    if (!allowed.includes(normalized)) {
+        throw new Error(`Invalid backlog ${field} "${value}". Valid values: ${allowed.join(', ')}.`);
+    }
+    return normalized;
+}
+function normalizeInputs(options) {
+    const title = options.title.trim();
+    if (!title ||
+        title.includes('\r') ||
+        title.includes('\n') ||
+        title.includes('\0')) {
+        throw new Error('Backlog title must be a non-empty single line.');
+    }
+    const date = new Date(options.createdAt ?? new Date().toISOString());
+    if (Number.isNaN(date.getTime())) {
+        throw new Error(`Invalid backlog creation timestamp: ${options.createdAt}`);
+    }
+    const priority = normalizeChoice('priority', options.priority, 'medium', PRIORITIES, (value) => value.trim().toLowerCase());
+    const scope = normalizeChoice('scope', options.scope, 'task', SCOPES, (value) => value.trim().toLowerCase());
+    const scopeEstimate = options.scopeEstimate === undefined
+        ? null
+        : normalizeChoice('scope estimate', options.scopeEstimate, '', SCOPE_ESTIMATES, (value) => value.trim().toUpperCase());
+    const labels = (options.labels ?? []).map((label) => label.trim());
+    if (labels.some((label) => !label ||
+        label.includes('\r') ||
+        label.includes('\n') ||
+        label.includes('\0'))) {
+        throw new Error('Backlog labels must be non-empty single-line values.');
+    }
+    if (options.description !== undefined &&
+        (!options.description.trim() || options.description.includes('\0'))) {
+        throw new Error('Backlog description must contain non-empty text.');
+    }
+    return {
+        title,
+        timestamp: date.toISOString(),
+        priority,
+        scope,
+        scopeEstimate,
+        labels,
+        description: options.description,
+    };
+}
+function renderBacklogItem(template, values) {
+    let body = stripTemplateFrontmatter(template).replace(/^\r?\n+/, '');
+    if (values.description !== undefined) {
+        body = body.replace(DESCRIPTION_PLACEHOLDER, () => values.description);
+    }
+    const frontmatter = YAML.stringify({
+        id: values.id,
+        title: values.title,
+        status: 'open',
+        priority: values.priority,
+        scope: values.scope,
+        scope_estimate: values.scopeEstimate,
+        labels: values.labels,
+        assignee: null,
+        created: values.timestamp,
+        updated: values.timestamp,
+        associated_issues: [],
+        external_plans: [],
+    }).trimEnd();
+    return `---\n${frontmatter}\n---\n\n${body.trimEnd()}\n`;
+}
+export async function createBacklogItem(options, overrides = {}) {
+    const dependencies = { ...DEFAULT_DEPENDENCIES, ...overrides };
+    const values = normalizeInputs(options);
+    const id = generateBacklogId(values.title, values.timestamp);
+    const filePath = join(options.backlogRoot, 'items', `${id}.md`);
+    const archivedPath = join(options.backlogRoot, 'archived', `${id}.md`);
+    if ((await pathExists(filePath)) || (await pathExists(archivedPath))) {
+        throw new Error(`Backlog item ${id} already exists. Use a more specific title to disambiguate.`);
+    }
+    const template = await resolveBacklogTemplate(options.assetsRoot, options.templatesRoot);
+    const content = renderBacklogItem(template.content, { id, ...values });
+    await dependencies.initializeBacklog(options.backlogRoot);
+    const indexPath = join(options.backlogRoot, 'index.md');
+    const originalIndex = await readFile(indexPath, 'utf8');
+    await writeFile(filePath, content, { encoding: 'utf8', flag: 'wx' });
+    let index;
+    try {
+        index = await dependencies.regenerateBacklogIndex(options.backlogRoot);
+    }
+    catch (error) {
+        const rollback = await Promise.allSettled([
+            rm(filePath),
+            writeFile(indexPath, originalIndex, 'utf8'),
+        ]);
+        const rollbackErrors = rollback
+            .filter((result) => result.status === 'rejected')
+            .map((result) => result.reason);
+        if (rollbackErrors.length > 0) {
+            const rollbackError = new AggregateError([error, ...rollbackErrors], `Backlog item ${id} creation failed and rollback was incomplete.`);
+            rollbackError.cause = error;
+            throw rollbackError;
+        }
+        throw error;
+    }
+    return {
+        id,
+        backlogRoot: options.backlogRoot,
+        filePath,
+        templatePath: template.path,
+        index,
+    };
+}

package/dist/commands/backlog/regenerate-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"regenerate-index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/regenerate-index.ts"],"names":[],"mappings":"AAwGA,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,CAAC,CAsDvC"}
+{"version":3,"file":"regenerate-index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/regenerate-index.ts"],"names":[],"mappings":"AAgJA,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,CAAC,CA6DvC"}

package/dist/commands/backlog/regenerate-index.js

@@ -52,9 +52,29 @@ function compareItems(a, b) {
     }
     return 0;
 }
+function encodeMarkdownTableCell(value) {
+    return value
+        .replaceAll('&', '&')
+        .replaceAll('\\', '\\\\')
+        .replaceAll('|', '\\|')
+        .replaceAll('<', '&lt;')
+        .replaceAll('>', '&gt;')
+        .replaceAll('\r', ' ')
+        .replaceAll('\n', ' ');
+}
 function renderManagedSection(items) {
     const rows = items.length > 0
-        ? items.map((item) => `| ${item.id} | ${item.title} | ${item.status} | ${item.priority} | ${item.scope} | ${item.scopeEstimate} |`)
+        ? items.map((item) => {
+            const cells = [
+                item.id,
+                item.title,
+                item.status,
+                item.priority,
+                item.scope,
+                item.scopeEstimate,
+            ].map(encodeMarkdownTableCell);
+            return `| ${cells.join(' | ')} |`;
+        })
         : ['| _No backlog items yet_ | - | - | - | - | - |'];
     return [
         INDEX_START,
@@ -64,6 +84,23 @@ function renderManagedSection(items) {
         INDEX_END,
     ].join('\n');
 }
+function findStandaloneMarker(content, marker, fromIndex = 0) {
+    let lineStart = 0;
+    while (lineStart <= content.length) {
+        const lineEnd = content.indexOf('\n', lineStart);
+        const contentEnd = lineEnd === -1 ? content.length : lineEnd;
+        const rawLine = content.slice(lineStart, contentEnd);
+        const line = rawLine.endsWith('\r') ? rawLine.slice(0, -1) : rawLine;
+        if (lineStart >= fromIndex && line === marker) {
+            return lineStart;
+        }
+        if (lineEnd === -1) {
+            break;
+        }
+        lineStart = lineEnd + 1;
+    }
+    return -1;
+}
 export async function regenerateBacklogIndex(backlogRoot) {
     const itemsDir = join(backlogRoot, 'items');
     const indexPath = join(backlogRoot, 'index.md');
@@ -85,8 +122,10 @@ export async function regenerateBacklogIndex(backlogRoot) {
     }
     items.sort(compareItems);
     const content = await readFile(indexPath, 'utf8');
-    const startIndex = content.indexOf(INDEX_START);
-    const endIndex = content.indexOf(INDEX_END);
+    const startIndex = findStandaloneMarker(content, INDEX_START);
+    const endIndex = startIndex === -1
+        ? -1
+        : findStandaloneMarker(content, INDEX_END, startIndex + INDEX_START.length);
     if (startIndex === -1 || endIndex === -1) {
         throw new Error(`Managed backlog index markers missing in ${indexPath}. Expected the exact marker pair:\n${INDEX_START}\n${INDEX_END}\nRun \`oat backlog init\` if the backlog scaffold is missing, or restore those exact markers in \`backlog/index.md\` before rerunning \`oat backlog regenerate-index\`.`);
     }

package/dist/commands/decision/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAuB7D,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA8CD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CA+LT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAuB,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAyB7D,UAAU,2BAA2B;IACnC,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,yBAAyB,EAAE,OAAO,yBAAyB,CAAC;IAC5D,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,oBAAoB,EAAE,OAAO,oBAAoB,CAAC;IAClD,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA8CD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACnD,OAAO,CAmMT"}

package/dist/commands/decision/index.js

@@ -102,6 +102,8 @@ export function createDecisionCommand(overrides = {}) {
         .option('--decisions-root <path>', 'Decisions root directory (defaults to .oat/repo/reference/decisions)')
         .option('--status <status>', 'Decision status', 'proposed')
         .option('--context <text>', 'Initial context body text')
+        .option('--decision <text>', 'Initial decision body text')
+        .option('--consequences <text>', 'Initial consequences body text')
         .option('--created-at <timestamp>', 'Creation timestamp seed for reproducible ID generation')
         .action(async (title, options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
@@ -116,6 +118,8 @@ export function createDecisionCommand(overrides = {}) {
                 title,
                 status: options.status,
                 context: options.context,
+                decision: options.decision,
+                consequences: options.consequences,
                 createdAt: options.createdAt,
             });
             if (context.json) {

package/dist/commands/decision/new.d.ts

@@ -5,6 +5,8 @@ export interface CreateDecisionRecordOptions {
     title: string;
     status?: string;
     context?: string;
+    decision?: string;
+    consequences?: string;
     createdAt?: string;
 }
 export interface CreateDecisionRecordResult {

package/dist/commands/decision/new.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/new.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA0HD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA8CrC"}
+{"version":3,"file":"new.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/new.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AA4HD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAgDrC"}

package/dist/commands/decision/new.js

@@ -68,8 +68,8 @@ function renderDecisionRecord(template, options) {
         date: options.date,
         status: options.status,
         context: options.context,
-        decision: 'TODO',
-        consequences: 'TODO',
+        decision: options.decision,
+        consequences: options.consequences,
     });
     const frontmatter = YAML.stringify({
         id: options.id,
@@ -95,6 +95,8 @@ export async function createDecisionRecord(options) {
         date: createdAt.date,
         status,
         context: options.context ?? 'TODO',
+        decision: options.decision ?? 'TODO',
+        consequences: options.consequences ?? 'TODO',
     });
     await assertDecisionIndexScaffold(options.decisionsRoot);
     await mkdir(dirname(filePath), { recursive: true });

package/dist/commands/doctor/index.d.ts

@@ -29,6 +29,7 @@ interface DoctorDependencies {
     processEnv: NodeJS.ProcessEnv;
     runPjmDoctorChecks: (repoRoot: string, options?: PjmDoctorOptions) => Promise<DoctorCheck[]>;
     checkSkillVersions: (scopeRoot: string, assetsRoot: string, pathExists: (path: string) => Promise<boolean>) => Promise<SkillVersionReport>;
+    checkStaleInvocations: (repoRoot: string) => Promise<DoctorCheck>;
 }
 interface OutdatedSkillVersion {
     skill: string;

package/dist/commands/doctor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/doctor/index.js

@@ -23,6 +23,7 @@ import { validateMatrixCell, } from '../../providers/identity/availability.js';
 import { createDispatchValidationPassContext, validateDispatchMatrixRefs, } from '../../providers/identity/dispatch-validation.js';
 import { formatDoctorResults } from '../../ui/output.js';
 import { Command } from 'commander';
+import { checkStaleInvocations } from './stale-invocations.js';
 async function pathExistsDefault(path) {
     try {
         await access(path);
@@ -143,6 +144,7 @@ function createDependencies() {
         // Default binding remains self-contained, but still honors the caller-
         // provided pathExists dependency from runChecksForScope when available.
         checkSkillVersions: (scopeRoot, assetsRoot, pathExists = pathExistsDefault) => checkSkillVersionsDefault(scopeRoot, assetsRoot, pathExists),
+        checkStaleInvocations,
     };
 }
 function collectDispatchMatrixCellRefs(layers) {
@@ -505,6 +507,7 @@ async function runChecksForScope(scope, scopeRoot, userConfigDir, dependencies)
     });
     checks.push(...(await runCodexChecksForScope(scope, scopeRoot, dirname(userConfigDir), dependencies)));
     if (scope === 'project') {
+        checks.push(await dependencies.checkStaleInvocations(scopeRoot));
         try {
             const assetsRoot = await dependencies.resolveAssetsRoot();
             const skillVersions = await dependencies.checkSkillVersions(scopeRoot, assetsRoot, dependencies.pathExists);

package/dist/commands/doctor/stale-invocations.d.ts

@@ -0,0 +1,3 @@
+import type { DoctorCheck } from '../../ui/output.js';
+export declare function checkStaleInvocations(repoRoot: string): Promise<DoctorCheck>;
+//# sourceMappingURL=stale-invocations.d.ts.map

package/dist/commands/doctor/stale-invocations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stale-invocations.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/stale-invocations.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAoK9C,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,WAAW,CAAC,CA6CtB"}