@open-agent-toolkit/cli 0.1.31 → 0.1.32

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

@@ -1,10 +1,10 @@
 ---
 name: oat-project-summary
-version: 1.1.2
+version: 1.2.0
 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
-allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
+allowed-tools: Read, Write, Bash(git:*), Bash(oat config:*), Bash(oat decision:*), Glob, Grep, AskUserQuestion
 ---
 
 # Project Summary
@@ -36,22 +36,25 @@ When executing this skill, provide lightweight progress feedback so the user can
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
 - Before multi-step work, print step indicators, e.g.:
-  - `[1/4] Resolving project + reading artifacts…`
-  - `[2/4] Checking for existing summary…`
-  - `[3/4] Generating / updating summary sections…`
-  - `[4/4] Committing…`
+  - `[1/5] Resolving project + reading artifacts…`
+  - `[2/5] Checking for existing summary…`
+  - `[3/5] Generating / updating summary sections…`
+  - `[4/5] Promoting key decisions to reference/decisions/ (if PJM installed)…`
+  - `[5/5] Committing…`
 
 **BLOCKED Activities:**
 
 - ❌ No implementation work
 - ❌ No changing project artifacts (other than summary.md)
 - ❌ No creating tasks or modifying plan
+- ❌ No hand-authoring decision files or editing `reference/decisions/index.md` inside its managed markers
 
 **ALLOWED Activities:**
 
 - ✅ Reading all project artifacts
 - ✅ Creating or updating summary.md
 - ✅ Committing summary.md changes
+- ✅ Promoting the summary's Key Decisions into canonical `reference/decisions/` records via `oat decision new` (Step 7), gated on the PJM tool pack being installed
 
 **Self-Correction Protocol:**
 If you catch yourself:
@@ -193,20 +196,82 @@ oat_summary_includes_revisions: [{ list of p-revN IDs reflected }]
 ---
 ```
 
-### Step 6: Commit
+### Step 6: Promote Key Decisions to Canonical Decision Records
+
+Run this step **after** `summary.md` (including its `## Key Decisions` section) has been written/refreshed and its frontmatter updated. It promotes the project's Key Decisions out of per-project prose and into the canonical, repo-wide `reference/decisions/` log so they stop being siloed in `summary.md`. This step is **additive and non-interactive** — it never prompts.
+
+**6.1 — PJM gate (auto, no prompt).** Check whether the PJM tool pack is installed:
+
+```bash
+PJM_ENABLED=$(oat config get tools.project-management 2>/dev/null || echo "")
+```
+
+- If `PJM_ENABLED` is `true` → perform the promotion automatically. Do NOT ask the user.
+- Otherwise (any other value, empty, or unset) → **skip this entire step silently.** Do not print a warning or prompt.
+
+**6.2 — Skip if nothing to promote.** If `summary.md` has no `## Key Decisions` section, or that section has no decision content, skip the step. There is nothing to promote.
+
+**6.3 — Ensure the decisions surface exists.** The canonical decisions root is `.oat/repo/reference/decisions` (the `oat decision` default; pass `--decisions-root <path>` only for an explicit override). If its managed index is missing — i.e. `.oat/repo/reference/decisions/index.md` does not exist — initialize it first so `oat decision new` can succeed:
+
+```bash
+test -f .oat/repo/reference/decisions/index.md || oat decision init
+```
+
+`oat decision init` is idempotent; running it when the scaffold already exists is harmless.
+
+**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`.
+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:
+
+   ```bash
+   # the six '?' pin the YYMMDD date, so <slug> must match exactly (not as a suffix)
+   ls .oat/repo/reference/decisions/DR-??????-"<slug>".md 2>/dev/null
+   ```
+
+   Do **not** use a loose `DR-*-<slug>.md` glob: the greedy `*` would let a short slug (e.g. `layers`) falsely match a longer record (`DR-260623-two-layers.md`) and wrongly skip it. (Equivalently, scan the `ID` column of `reference/decisions/index.md`, strip each `DR-<6 digits>-` prefix, and compare the slug exactly.) This date-independent, exact-slug match is essential: the `DR-YYMMDD-` date prefix changes across re-runs, so a naive full-ID `DR-YYMMDD-<slug>` check would never dedup, while a loose suffix match would over-dedup.
+
+4. **Skip or create.**
+   - If a matching record already exists (same slug) → **skip it.** It was already promoted on a prior run.
+   - Otherwise → create it:
+
+     ```bash
+     oat decision new "<title>" --status accepted --context "<rationale>"
+     ```
+
+     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.
+
+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.
+
+**Status value:** use `--status accepted`. The decision template's status field (`.oat/templates/decision.md`) is free-form, and the canonical accepted/decided value in the decision vocabulary (`proposed` → `accepted` → `superseded`) is `accepted`. A Key Decision in a completed project's summary represents a decision that was made and shipped, so `accepted` is the correct status.
+
+**6.5 — Report, don't prompt.** After processing all Key Decisions, print a short informational summary, e.g.:
+
+```
+Promoted N key decision(s) to reference/decisions/:
+  - created: DR-YYMMDD-<slug> ("<title>")
+  - skipped (already promoted): <slug>
+```
+
+This is informational only. There is no interactive prompt anywhere in this step.
+
+### Step 7: Commit
 
 ```bash
 git add "$PROJECT_PATH/summary.md"
 git commit -m "docs: generate summary for {project-name}"
 ```
 
+If decision records were promoted in Step 6, also stage `.oat/repo/reference/decisions/` so the new `DR-*.md` records and the regenerated `index.md` land with the summary.
+
 If this is a re-run (incremental update):
 
 ```bash
 git commit -m "docs: update summary for {project-name}"
 ```
 
-### Step 7: Output Summary
+### Step 8: Output Summary
 
 ```
 Summary generated for {project-name}.
@@ -214,6 +279,7 @@ Summary generated for {project-name}.
 Sections: {list of non-empty sections included}
 Lines: {line count}
 Mode: {fresh | incremental update}
+Decisions promoted: {N created, M skipped as already promoted | skipped (PJM not installed)}
 
 Summary tracks: last task {task_id}, {N} revision phases
 ```
@@ -227,3 +293,5 @@ Summary tracks: last task {task_id}, {N} revision phases
 - Summary is under 200 lines for typical projects
 - Re-run after revisions updates only affected sections
 - Re-run with no changes produces no modifications
+- When the PJM tool pack is installed, each Key Decision is promoted to a canonical `reference/decisions/DR-YYMMDD-slug` record via `oat decision new` (status `accepted`), deduped on the date-independent slug so re-runs never create duplicate records
+- When the PJM tool pack is not installed, decision promotion is skipped silently with no prompt

package/assets/templates/backlog-item.md

@@ -1,5 +1,5 @@
 ---
-id: bl-{hash}
+id: BL-{YYMMDD-slug}
 title: '{title}'
 status: open # open | in_progress | closed | wont_do
 priority: medium # urgent | high | medium | low | none

package/assets/templates/current-state.md

@@ -5,9 +5,16 @@ oat_template_name: current-state
 
 # OAT Current State
 
+This file is the active operating picture and lives under `pjm/` (the
+operational layer), not `reference/`. To reduce cross-worktree conflicts, keep
+edits append-mostly and scoped to the section you own; avoid rewriting whole
+sections another branch may also touch.
+
 ## Canonical References
 
-<!-- List durable repo references, source-of-truth docs, dashboards, or processes here. -->
+<!-- List durable repo references, source-of-truth docs, dashboards, or processes here.
+Decisions live in reference/decisions/ (one file per record); link them rather than
+copying their content here. -->
 
 ## What's Implemented
 
@@ -15,4 +22,6 @@ oat_template_name: current-state
 
 ## What's Next
 
-<!-- Track near-term follow-up work, known gaps, and active handoff context here. -->
+<!-- Track near-term follow-up work, known gaps, and active handoff context here.
+Track concrete items in pjm/backlog/ and sequencing in pjm/roadmap.md; keep this
+section to a short narrative pointer. -->

package/assets/templates/decision.md

@@ -0,0 +1,18 @@
+---
+oat_template: true
+oat_template_name: decision
+---
+
+# {title}
+
+## Context
+
+{context}
+
+## Decision
+
+{decision}
+
+## Consequences
+
+{consequences}

package/assets/templates/pjm-agents.md

@@ -0,0 +1,13 @@
+---
+oat_template: true
+oat_template_name: pjm-agents
+---
+
+# PJM Guidance
+
+This directory owns active project-management state.
+
+- `current-state.md` records the present operating picture.
+- `roadmap.md` records prioritized direction and sequencing.
+- `backlog/` stores file-per-record backlog items and generated indexes.
+- Do not store durable research, brainstorms, imported plans, or decision history here.

package/assets/templates/reference-agents.md

@@ -0,0 +1,14 @@
+---
+oat_template: true
+oat_template_name: reference-agents
+---
+
+# Durable Reference Guidance
+
+This directory owns append-mostly reference material.
+
+- `decisions/` stores file-per-record decisions and the generated decision index.
+- `project-summaries/` stores archived project summaries.
+- `external-plans/` stores imported provider or external plans.
+- Create research, brainstorm, and deck folders on demand when a workflow needs them.
+- Do not put active roadmap, current-state, or backlog records directly under `reference/`.

package/assets/templates/repo-agents.md

@@ -0,0 +1,13 @@
+---
+oat_template: true
+oat_template_name: repo-agents
+---
+
+# Repo Reference Guidance
+
+Use this directory as the canonical OAT repo-reference root.
+
+- Active operational planning lives in `pjm/`.
+- Durable append-mostly references live in `reference/`.
+- Keep generated indexes inside their managed marker pairs.
+- When an index conflicts, regenerate it with the owning OAT command and stage the result.

package/assets/templates/roadmap.md

@@ -5,20 +5,25 @@ oat_template_name: roadmap
 
 # Roadmap
 
+This file records prioritized direction and lives under `pjm/` (the operational
+layer). To reduce cross-worktree conflicts, prefer adding or moving single
+bullet lines over rewriting whole sections, and reference backlog records by ID
+(`BL-YYMMDD-slug`) rather than restating their detail here.
+
 ## Now (Active / Committed)
 
 <!-- Add active work here. Format:
-- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+- **BL-YYMMDD-slug: {title}** — brief description. Project: {name} (if linked)
 -->
 
 ## Next (Planned)
 
 <!-- Add planned work here. Format:
-- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+- **BL-YYMMDD-slug: {title}** — brief description. Project: {name} (if linked)
 -->
 
 ## Later (Directional Intent)
 
 <!-- Add directional work here. Format:
-- **bl-XXXX: {title}** — brief description. Project: {name} (if linked)
+- **BL-YYMMDD-slug: {title}** — brief description. Project: {name} (if linked)
 -->

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

@@ -8,6 +8,7 @@ interface BacklogCommandDependencies {
     resolveProjectRoot: typeof resolveProjectRoot;
     initializeBacklog: typeof initializeBacklog;
     regenerateBacklogIndex: typeof regenerateBacklogIndex;
+    pathExists: (path: string) => Promise<boolean>;
 }
 export declare function createBacklogCommand(overrides?: Partial<BacklogCommandDependencies>): Command;
 export {};

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":"AAEA,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,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAkB5D,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;CACvD;AAsBD,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAoGT"}
+{"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,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAe5D,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,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAyCD,wBAAgB,oBAAoB,CAClC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAgIT"}

package/dist/commands/backlog/index.js

@@ -1,23 +1,40 @@
-import { resolve } from 'node:path';
+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 { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
 import { initializeBacklog } from './init.js';
 import { regenerateBacklogIndex } from './regenerate-index.js';
-import { generateUniqueBacklogId, readExistingBacklogIds, } from './shared/generate-id.js';
+import { generateBacklogId } from './shared/generate-id.js';
+async function pathExistsDefault(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;
+    }
+}
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveProjectRoot,
     initializeBacklog,
     regenerateBacklogIndex,
+    pathExists: pathExistsDefault,
 };
 async function resolveBacklogRoot(context, configuredRoot, dependencies = DEFAULT_DEPENDENCIES) {
     if (configuredRoot) {
         return resolve(context.cwd, configuredRoot);
     }
     const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
-    return resolve(projectRoot, '.oat', 'repo', 'reference', 'backlog');
+    return resolve(projectRoot, '.oat', 'repo', 'pjm', 'backlog');
 }
 export function createBacklogCommand(overrides = {}) {
     const dependencies = {
@@ -28,7 +45,7 @@ export function createBacklogCommand(overrides = {}) {
     cmd
         .command('init')
         .description('Scaffold the canonical backlog directory structure and starter files')
-        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/reference/backlog)')
+        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/pjm/backlog)')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         const backlogRoot = await resolveBacklogRoot(context, options.backlogRoot, dependencies);
@@ -44,7 +61,7 @@ export function createBacklogCommand(overrides = {}) {
     cmd
         .command('regenerate-index')
         .description('Regenerate the managed backlog index table')
-        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/reference/backlog)')
+        .option('--backlog-root <path>', 'Backlog root directory (defaults to .oat/repo/pjm/backlog)')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         const backlogRoot = await resolveBacklogRoot(context, options.backlogRoot, dependencies);
@@ -59,17 +76,37 @@ export function createBacklogCommand(overrides = {}) {
     });
     cmd
         .command('generate-id')
-        .description('Generate a backlog item identifier from a filename seed')
-        .argument('<filename>', 'Filename or slug seed for the backlog item')
+        .description('Generate a backlog item identifier (`BL-YYMMDD-slug`) from a title or slug')
+        .argument('<title-or-slug>', 'Title or slug seed for the backlog item')
         .option('--created-at <timestamp>', 'Creation timestamp seed for reproducible ID generation')
-        .action(async (filename, options, command) => {
+        .action(async (titleOrSlug, options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         const backlogRoot = await resolveBacklogRoot(context, undefined, dependencies);
         const createdAt = options.createdAt ?? new Date().toISOString();
-        const existingIds = await readExistingBacklogIds(backlogRoot);
-        const id = generateUniqueBacklogId(filename, createdAt, existingIds);
+        const id = generateBacklogId(titleOrSlug, createdAt);
+        const candidatePaths = [
+            join(backlogRoot, 'items', `${id}.md`),
+            join(backlogRoot, 'archived', `${id}.md`),
+        ];
+        const collides = (await Promise.all(candidatePaths.map((candidatePath) => dependencies.pathExists(candidatePath)))).some(Boolean);
+        if (collides) {
+            const message = `Backlog item ${id} already exists. Use a more specific title or slug to disambiguate.`;
+            if (context.json) {
+                context.logger.json({ status: 'error', id, message });
+            }
+            else {
+                context.logger.error(message);
+            }
+            process.exitCode = 1;
+            return;
+        }
         if (context.json) {
-            context.logger.json({ status: 'ok', id, filename, createdAt });
+            context.logger.json({
+                status: 'ok',
+                id,
+                titleOrSlug,
+                createdAt,
+            });
         }
         else {
             context.logger.info(id);

package/dist/commands/backlog/init.js

@@ -37,7 +37,7 @@ const STARTER_COMPLETED = [
     '',
     '## Entry Format',
     '',
-    '- `YYYY-MM-DD — bl-XXXX — Title — one-line outcome summary`',
+    '- `YYYY-MM-DD — BL-YYMMDD-slug — Title — one-line outcome summary`',
     '',
     '## Completed Items',
     '',

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":"AAkFA,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAmCf"}
+{"version":3,"file":"regenerate-index.d.ts","sourceRoot":"","sources":["../../../src/commands/backlog/regenerate-index.ts"],"names":[],"mappings":"AAmGA,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CA+Cf"}

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

@@ -1,6 +1,7 @@
 import { readdir, readFile, writeFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { getFrontmatterBlock } from '../shared/frontmatter.js';
+import { computeManagedIndexUpdate } from '../shared/managed-index.js';
 import YAML from 'yaml';
 const INDEX_START = '<!-- OAT BACKLOG-INDEX -->';
 const INDEX_END = '<!-- END OAT BACKLOG-INDEX -->';
@@ -36,7 +37,19 @@ function compareItems(a, b) {
     if (priorityDiff !== 0) {
         return priorityDiff;
     }
-    return a.title.localeCompare(b.title);
+    if (a.title < b.title) {
+        return -1;
+    }
+    if (a.title > b.title) {
+        return 1;
+    }
+    if (a.id < b.id) {
+        return -1;
+    }
+    if (a.id > b.id) {
+        return 1;
+    }
+    return 0;
 }
 function renderManagedSection(items) {
     const rows = items.length > 0
@@ -55,7 +68,8 @@ export async function regenerateBacklogIndex(backlogRoot) {
     const indexPath = join(backlogRoot, 'index.md');
     const entries = (await readdir(itemsDir, { withFileTypes: true }))
         .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
-        .map((entry) => entry.name);
+        .map((entry) => entry.name)
+        .sort();
     const items = [];
     for (const entry of entries) {
         const filePath = join(itemsDir, entry);
@@ -71,8 +85,13 @@ export async function regenerateBacklogIndex(backlogRoot) {
     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\`.`);
     }
-    const before = content.slice(0, startIndex);
-    const after = content.slice(endIndex + INDEX_END.length);
-    const updated = `${before}${renderManagedSection(items)}${after}`;
+    // Content-idempotent gate: when the on-disk managed block is logically equal
+    // to the freshly rendered block (cells equal after trimming, so external
+    // formatter padding is ignored), preserve the existing bytes and skip the
+    // write. Only rewrite on a genuine content change.
+    const { content: updated } = computeManagedIndexUpdate(content, startIndex, endIndex + INDEX_END.length, renderManagedSection(items));
+    if (updated === null) {
+        return;
+    }
     await writeFile(indexPath, updated, 'utf8');
 }

package/dist/commands/backlog/shared/generate-id.d.ts

@@ -1,4 +1,2 @@
-export declare function generateBacklogId(filename: string, createdAt: string, nonce?: number): string;
-export declare function generateUniqueBacklogId(filename: string, createdAt: string, existingIds: Iterable<string>): string;
-export declare function readExistingBacklogIds(backlogRoot: string): Promise<Set<string>>;
+export declare function generateBacklogId(titleOrSlug: string, createdAt: string): string;
 //# sourceMappingURL=generate-id.d.ts.map

package/dist/commands/backlog/shared/generate-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-id.d.ts","sourceRoot":"","sources":["../../../../src/commands/backlog/shared/generate-id.ts"],"names":[],"mappings":"AAeA,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,GACR,MAAM,CAQR;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC5B,MAAM,CAWR;AAED,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAgDtB"}
+{"version":3,"file":"generate-id.d.ts","sourceRoot":"","sources":["../../../../src/commands/backlog/shared/generate-id.ts"],"names":[],"mappings":"AAGA,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER"}

package/dist/commands/backlog/shared/generate-id.js

@@ -1,65 +1,5 @@
-import { createHash } from 'node:crypto';
-import { readdir, readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { getFrontmatterBlock } from '../../shared/frontmatter.js';
-import YAML from 'yaml';
-function buildBacklogHashInput(filename, createdAt, nonce) {
-    return nonce === 0 ? filename : `${filename}#${nonce}`;
-}
-export function generateBacklogId(filename, createdAt, nonce = 0) {
-    const hash = createHash('sha256')
-        .update(buildBacklogHashInput(filename, createdAt, nonce))
-        .update('\0')
-        .update(createdAt)
-        .digest('hex');
-    return `bl-${hash.slice(0, 4)}`;
-}
-export function generateUniqueBacklogId(filename, createdAt, existingIds) {
-    const ids = new Set(existingIds);
-    for (let nonce = 0; nonce < Number.MAX_SAFE_INTEGER; nonce += 1) {
-        const candidate = generateBacklogId(filename, createdAt, nonce);
-        if (!ids.has(candidate)) {
-            return candidate;
-        }
-    }
-    throw new Error('Unable to generate a unique backlog ID.');
-}
-export async function readExistingBacklogIds(backlogRoot) {
-    const ids = new Set();
-    const sourceDirs = ['items', 'archived'];
-    for (const dirName of sourceDirs) {
-        const sourceDir = join(backlogRoot, dirName);
-        try {
-            const entries = await readdir(sourceDir, { withFileTypes: true });
-            for (const entry of entries) {
-                if (!entry.isFile() || !entry.name.endsWith('.md')) {
-                    continue;
-                }
-                const content = await readFile(join(sourceDir, entry.name), 'utf8');
-                const rawFrontmatter = getFrontmatterBlock(content);
-                if (!rawFrontmatter) {
-                    continue;
-                }
-                const parsed = YAML.parse(rawFrontmatter);
-                if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
-                    continue;
-                }
-                const id = parsed.id;
-                if (typeof id === 'string' && id.length > 0) {
-                    ids.add(id);
-                }
-            }
-            continue;
-        }
-        catch (error) {
-            const code = error && typeof error === 'object' && 'code' in error
-                ? String(error.code)
-                : null;
-            if (code === 'ENOENT') {
-                continue;
-            }
-            throw error;
-        }
-    }
-    return ids;
+import { yymmdd } from '../../shared/date-id.js';
+import { slugify } from '../../shared/slug.js';
+export function generateBacklogId(titleOrSlug, createdAt) {
+    return `BL-${yymmdd(createdAt)}-${slugify(titleOrSlug)}`;
 }

package/dist/commands/cleanup/artifacts/artifacts.d.ts.map

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

package/dist/commands/cleanup/artifacts/artifacts.js

@@ -87,7 +87,10 @@ export async function discoverArtifactCandidates(repoRoot, excludedTargets = [])
 }
 async function collectReferenceContents(repoRoot) {
     const contents = [];
-    const repoReferenceFiles = await collectMarkdownFiles(join(repoRoot, '.oat/repo/reference'));
+    const repoReferenceFiles = (await Promise.all([
+        join(repoRoot, '.oat/repo/pjm'),
+        join(repoRoot, '.oat/repo/reference'),
+    ].map((root) => collectMarkdownFiles(root)))).flat();
     let activeProjectFiles = [];
     try {
         const localConfig = await readOatLocalConfig(repoRoot);

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

@@ -0,0 +1,20 @@
+import { buildCommandContext } from '../../app/command-context.js';
+import { resolveAssetsRoot } from '../../fs/assets.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { Command } from 'commander';
+import { initializeDecisionRecords } from './init.js';
+import { migrateDecisionRecords } from './migrate.js';
+import { createDecisionRecord } from './new.js';
+import { regenerateDecisionIndex } from './regenerate-index.js';
+interface DecisionCommandDependencies {
+    buildCommandContext: typeof buildCommandContext;
+    resolveProjectRoot: typeof resolveProjectRoot;
+    resolveAssetsRoot: typeof resolveAssetsRoot;
+    initializeDecisionRecords: typeof initializeDecisionRecords;
+    regenerateDecisionIndex: typeof regenerateDecisionIndex;
+    createDecisionRecord: typeof createDecisionRecord;
+    migrateDecisionRecords: typeof migrateDecisionRecords;
+}
+export declare function createDecisionCommand(overrides?: Partial<DecisionCommandDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}