@open-agent-toolkit/cli 0.1.17 → 0.1.18

package/README.md

@@ -31,6 +31,7 @@ Additional useful entry points:
 - `oat instructions validate --strategy pointer`
 - `oat instructions sync --dry-run --strategy symlink`
 - `oat docs init --app-name my-docs`
+- `oat pjm init` - initialize the project-management repo-reference surface after installing the pack
 - `oat config dump --json`
 - `oat project status --json`
 - `oat project list --json`

package/assets/docs/cli-utilities/config-and-local-state.md

@@ -20,6 +20,8 @@ Use the `oat backlog` group when you want direct CLI support for the file-backed
 
 Run `oat backlog init` first when the local backlog scaffold does not exist yet in a fresh repo. This command group is primarily used by the `oat-pjm-*` project-management skills, but it is also available directly when you need to inspect or repair backlog metadata by hand.
 
+For full project-management repo-reference setup, use [`oat pjm init`](tool-packs.md#install-vs-initialize). It scaffolds `current-state.md`, `roadmap.md`, `decision-record.md`, and delegates the backlog sub-surface to `oat backlog init`.
+
 ## `oat local ...`
 
 `oat local` manages local-only, gitignored paths that still need to follow you between the main repo and worktrees.

package/assets/docs/cli-utilities/tool-packs.md

@@ -20,7 +20,7 @@ This page covers CLI commands that manage bundled OAT tool packs and installed O
 - `workflows` - project lifecycle skills, wrap-up reporting, reviewer agents, and core project templates
 - `ideas` - lightweight ideation and promotion flows
 - `utility` - review and repo-maintenance helpers
-- `project-management` - file-backed backlog/reference skills plus backlog and roadmap templates
+- `project-management` - file-backed backlog/reference skills plus backlog, roadmap, current-state, and decision-record templates
 - `research` - research, analysis, comparison, and synthesis skills
 - `brainstorm` - always-on brainstorming entry point with visual companion
 
@@ -28,6 +28,35 @@ This page covers CLI commands that manage bundled OAT tool packs and installed O
 
 The `oat tools` command group provides a unified interface for managing installed tools (skills and agents) across scopes.
 
+## Install vs. initialize
+
+The `project-management` pack has two lifecycle steps:
+
+- **Install**: `oat tools install project-management` (or the legacy `oat init tools project-management`) copies project-management skills into `.agents/skills/` and template sources into `.oat/templates/`.
+- **Initialize**: `oat pjm init` instantiates the working repo-reference surface under `.oat/repo/reference/`.
+
+Installing the pack makes the skills and templates available; it does not create the repo's working project-management reference docs. Run `oat pjm init` when you want to scaffold the canonical PJM surface for a repo:
+
+```bash
+oat pjm init
+```
+
+The command creates missing files and directories for:
+
+- `.oat/repo/reference/current-state.md`
+- `.oat/repo/reference/roadmap.md`
+- `.oat/repo/reference/decision-record.md`
+- `.oat/repo/reference/backlog/`
+
+`oat pjm init` is idempotent and non-destructive. Existing reference docs are skipped and left unchanged, so curated repo state is not overwritten on repeated runs.
+
+Useful options:
+
+- `--reference-root <path>` - scaffold a different reference root instead of `.oat/repo/reference/`
+- `--json` - emit a machine-readable result with created and skipped paths
+
+Backlog scaffolding is delegated to the lower-level [`oat backlog init`](config-and-local-state.md#oat-backlog-) helper. Use `oat pjm init` for the full PJM repo-reference surface, and use `oat backlog init` directly only when you need to create or repair the backlog sub-surface by itself.
+
 ### `oat tools list`
 
 Purpose:

package/assets/docs/reference/cli-reference.md

@@ -22,17 +22,18 @@ The CLI is also a standalone value path. You can use `oat init`, `oat sync`, `oa
 
 ## Command Groups
 
-| Command group                                   | What it covers                                                                                                                          | Go deeper                                                            |
-| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- |
-| `oat init`                                      | Bootstrap canonical OAT directories, sync config, optional hooks, and guided setup.                                                     | [CLI Bootstrap](../cli-utilities/bootstrap.md)                       |
-| `oat tools ...`                                 | Install, inspect, update, and remove bundled OAT tool packs and assets.                                                                 | [Tool Packs](../cli-utilities/tool-packs.md)                         |
-| `oat backlog ...` / `oat local ...`             | File-backed backlog helpers, local path sync, and local-only operational support.                                                       | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat config ...` / `oat instructions ...`       | Config discovery, source-aware config dumps, supported mutations, and instruction-integrity helpers.                                    | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat state ...` / `oat index ...` / `internal`  | Repo dashboard refresh, repo indexing, validation helpers, and diagnostics.                                                             | [Config and Local State](../cli-utilities/config-and-local-state.md) |
-| `oat docs ...`                                  | Docs app bootstrap, migration, index generation, nav sync, and docs workflow entrypoints.                                               | [Docs Tooling Commands](../docs-tooling/commands.md)                 |
-| `oat status` / `oat sync` / `oat providers ...` | Provider sync, drift inspection, provider configuration, and adoption behavior.                                                         | [Provider Sync](../provider-sync/index.md)                           |
-| `oat project ...` / `oat cleanup ...`           | Project scaffolding, active-project status inspection, tracked-project listing, plan validation, and project/artifact cleanup commands. | [Workflow & Projects](../workflows/projects/index.md)                |
-| `oat repo ...`                                  | Repository-level analysis workflows, currently centered on PR comments.                                                                 | [Repository Analysis](../workflows/projects/repo-analysis.md)        |
+| Command group                                   | What it covers                                                                                                                          | Go deeper                                                                      |
+| ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
+| `oat init`                                      | Bootstrap canonical OAT directories, sync config, optional hooks, and guided setup.                                                     | [CLI Bootstrap](../cli-utilities/bootstrap.md)                                 |
+| `oat tools ...`                                 | Install, inspect, update, and remove bundled OAT tool packs and assets.                                                                 | [Tool Packs](../cli-utilities/tool-packs.md)                                   |
+| `oat pjm ...`                                   | Initialize the project-management repo-reference surface after installing the project-management pack.                                  | [Install vs. initialize](../cli-utilities/tool-packs.md#install-vs-initialize) |
+| `oat backlog ...` / `oat local ...`             | File-backed backlog helpers, local path sync, and local-only operational support.                                                       | [Config and Local State](../cli-utilities/config-and-local-state.md)           |
+| `oat config ...` / `oat instructions ...`       | Config discovery, source-aware config dumps, supported mutations, and instruction-integrity helpers.                                    | [Config and Local State](../cli-utilities/config-and-local-state.md)           |
+| `oat state ...` / `oat index ...` / `internal`  | Repo dashboard refresh, repo indexing, validation helpers, and diagnostics.                                                             | [Config and Local State](../cli-utilities/config-and-local-state.md)           |
+| `oat docs ...`                                  | Docs app bootstrap, migration, index generation, nav sync, and docs workflow entrypoints.                                               | [Docs Tooling Commands](../docs-tooling/commands.md)                           |
+| `oat status` / `oat sync` / `oat providers ...` | Provider sync, drift inspection, provider configuration, and adoption behavior.                                                         | [Provider Sync](../provider-sync/index.md)                                     |
+| `oat project ...` / `oat cleanup ...`           | Project scaffolding, active-project status inspection, tracked-project listing, plan validation, and project/artifact cleanup commands. | [Workflow & Projects](../workflows/projects/index.md)                          |
+| `oat repo ...`                                  | Repository-level analysis workflows, currently centered on PR comments.                                                                 | [Repository Analysis](../workflows/projects/repo-analysis.md)                  |
 
 Notable inspection commands introduced in the current CLI surface:
 

package/assets/docs/reference/oat-directory-structure.md

@@ -210,12 +210,22 @@ Not all workflow modes require every artifact:
 
 ## `.oat/repo/` structure
 
-| Path                   | Purpose                                                   |
-| ---------------------- | --------------------------------------------------------- |
-| `.oat/repo/knowledge/` | Generated codebase knowledge indexes                      |
-| `.oat/repo/reference/` | Repo-level reference docs (backlog, external plans, etc.) |
-| `.oat/repo/reviews/`   | Repo-scoped review artifacts (ad-hoc/non-project)         |
-| `.oat/repo/archive/`   | Archived repo-level artifacts                             |
+| Path                   | Purpose                                                                                                                                 |
+| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `.oat/repo/knowledge/` | Generated codebase knowledge indexes                                                                                                    |
+| `.oat/repo/reference/` | Repo-level reference docs, including the canonical PJM surface (`current-state.md`, `roadmap.md`, `decision-record.md`, and `backlog/`) |
+| `.oat/repo/reviews/`   | Repo-scoped review artifacts (ad-hoc/non-project)                                                                                       |
+| `.oat/repo/archive/`   | Archived repo-level artifacts                                                                                                           |
+
+Canonical project-management repo-reference surface:
+
+```text
+.oat/repo/reference/
+  current-state.md
+  roadmap.md
+  decision-record.md
+  backlog/
+```
 
 ## User scope (`~/.oat/`)
 

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.1.17",
-  "docs-config": "0.1.17",
-  "docs-theme": "0.1.17",
-  "docs-transforms": "0.1.17"
+  "cli": "0.1.18",
+  "docs-config": "0.1.18",
+  "docs-theme": "0.1.18",
+  "docs-transforms": "0.1.18"
 }

package/assets/templates/current-state.md

@@ -0,0 +1,18 @@
+---
+oat_template: true
+oat_template_name: current-state
+---
+
+# OAT Current State
+
+## Canonical References
+
+<!-- List durable repo references, source-of-truth docs, dashboards, or processes here. -->
+
+## What's Implemented
+
+<!-- Summarize shipped capabilities and important repo conventions here. -->
+
+## What's Next
+
+<!-- Track near-term follow-up work, known gaps, and active handoff context here. -->

package/assets/templates/decision-record.md

@@ -0,0 +1,21 @@
+---
+oat_template: true
+oat_template_name: decision-record
+---
+
+# OAT Decision Record
+
+## Decision Index
+
+| ID  | Date | Status | Decision | Context |
+| --- | ---- | ------ | -------- | ------- |
+
+<!--
+## ADR-NNN: Decision title
+
+- Date: YYYY-MM-DD
+- Status: proposed | accepted | superseded
+- Context: What problem or constraint led to this decision?
+- Decision: What choice was made?
+- Consequences: What tradeoffs, follow-ups, or migration notes matter?
+-->

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmBvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBvD"}

package/dist/commands/index.js

@@ -8,6 +8,7 @@ import { createInitCommand } from './init/index.js';
 import { createInstructionsCommand } from './instructions/index.js';
 import { createInternalCommand } from './internal/index.js';
 import { createLocalCommand } from './local/index.js';
+import { createPjmCommand } from './pjm/index.js';
 import { createProjectCommand } from './project/index.js';
 import { createProvidersCommand } from './providers/index.js';
 import { createRemoveCommand } from './remove/index.js';
@@ -31,6 +32,7 @@ export function registerCommands(program) {
     program.addCommand(createDocsCommand());
     program.addCommand(createInstructionsCommand());
     program.addCommand(createIndexCommand());
+    program.addCommand(createPjmCommand());
     program.addCommand(createProjectCommand());
     program.addCommand(createStateCommand());
     program.addCommand(createToolsCommand());

package/dist/commands/init/tools/shared/skill-manifest.d.ts

@@ -21,7 +21,7 @@ export declare const DOCS_SKILLS: readonly ["oat-agent-instructions-analyze", "o
 export declare const DOCS_SCRIPTS: readonly ["resolve-tracking.sh"];
 export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-provide-remote", "oat-review-receive", "oat-review-receive-remote"];
 export declare const PROJECT_MANAGEMENT_SKILLS: readonly ["oat-pjm-add-backlog-item", "oat-pjm-update-repo-reference", "oat-pjm-review-backlog"];
-export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md"];
+export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md", "current-state.md", "decision-record.md"];
 export declare const PROJECT_MANAGEMENT_SCRIPTS: readonly [];
 export declare const BRAINSTORM_SKILLS: readonly ["oat-brainstorm"];
 export declare const RESEARCH_SKILLS: readonly ["analyze", "compare", "deep-research", "skeptic", "synthesize"];

package/dist/commands/init/tools/shared/skill-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,6xBAgClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,6KAOjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAgBH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAKtD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,eAAO,MAAM,eAAe,6xBAgClB,CAAC;AAEX,eAAO,MAAM,eAAe,oFAIlB,CAAC;AAEX,eAAO,MAAM,kBAAkB,6GAQrB,CAAC;AAEX,eAAO,MAAM,gBAAgB,qFAInB,CAAC;AAIX,eAAO,MAAM,WAAW,2FAKd,CAAC;AAIX,eAAO,MAAM,WAAW,qCAAsC,CAAC;AAI/D,eAAO,MAAM,WAAW,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,6KAOjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,sFAK/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,iBAAiB,6BAA8B,CAAC;AAI7D,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -103,6 +103,8 @@ export const PROJECT_MANAGEMENT_SKILLS = [
 export const PROJECT_MANAGEMENT_TEMPLATES = [
     'backlog-item.md',
     'roadmap.md',
+    'current-state.md',
+    'decision-record.md',
 ];
 export const PROJECT_MANAGEMENT_SCRIPTS = [];
 // ── Brainstorm pack ───────────────────────────────────────────────

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

@@ -0,0 +1,14 @@
+import { buildCommandContext } from '../../app/command-context.js';
+import { resolveAssetsRoot } from '../../fs/assets.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { Command } from 'commander';
+import { initializeRepoReference } from './init.js';
+interface PjmCommandDependencies {
+    buildCommandContext: typeof buildCommandContext;
+    resolveProjectRoot: typeof resolveProjectRoot;
+    resolveAssetsRoot: typeof resolveAssetsRoot;
+    initializeRepoReference: typeof initializeRepoReference;
+}
+export declare function createPjmCommand(overrides?: Partial<PjmCommandDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/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,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAMjD,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;CACzD;AAqBD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CA+DT"}

package/dist/commands/pjm/index.js

@@ -0,0 +1,67 @@
+import { 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 { initializeRepoReference } from './init.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveAssetsRoot,
+    initializeRepoReference,
+};
+async function resolveReferenceRoot(context, projectRoot, configuredRoot) {
+    if (configuredRoot) {
+        return resolve(context.cwd, configuredRoot);
+    }
+    return resolve(projectRoot, '.oat', 'repo', 'reference');
+}
+export function createPjmCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    const cmd = new Command('pjm').description('Manage project-management repo reference docs');
+    cmd
+        .command('init')
+        .description('Scaffold the canonical PJM repo reference surface')
+        .option('--reference-root <path>', 'Reference root directory (defaults to .oat/repo/reference)')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+            const referenceRoot = await resolveReferenceRoot(context, projectRoot, options.referenceRoot);
+            const assetsRoot = await dependencies.resolveAssetsRoot();
+            const result = await dependencies.initializeRepoReference({
+                referenceRoot,
+                assetsRoot,
+                templatesRoot: resolve(projectRoot, '.oat', 'templates'),
+            });
+            if (context.json) {
+                context.logger.json({ status: 'ok', ...result });
+            }
+            else {
+                context.logger.info(`Initialized PJM repo reference scaffold at ${result.referenceRoot}`);
+                if (result.created.length > 0) {
+                    context.logger.info(`Created: ${result.created.join(', ')}`);
+                }
+                if (result.skipped.length > 0) {
+                    context.logger.info(`Skipped existing: ${result.skipped.join(', ')}`);
+                }
+            }
+            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;
+        }
+    });
+    return cmd;
+}

package/dist/commands/pjm/init.d.ts

@@ -0,0 +1,12 @@
+export interface InitializeRepoReferenceOptions {
+    referenceRoot: string;
+    assetsRoot: string;
+    templatesRoot?: string;
+}
+export interface RepoReferenceInitResult {
+    referenceRoot: string;
+    created: string[];
+    skipped: string[];
+}
+export declare function initializeRepoReference(options: InitializeRepoReferenceOptions): Promise<RepoReferenceInitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/pjm/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/init.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AA4GD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CA6ClC"}

package/dist/commands/pjm/init.js

@@ -0,0 +1,119 @@
+import { access, mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { initializeBacklog } from '../backlog/init.js';
+const REFERENCE_TEMPLATES = [
+    'current-state.md',
+    'roadmap.md',
+    'decision-record.md',
+];
+const BACKLOG_PATHS = [
+    'backlog/index.md',
+    'backlog/completed.md',
+    'backlog/items/.gitkeep',
+    'backlog/archived/.gitkeep',
+];
+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 readIfExists(path) {
+    try {
+        return await readFile(path, 'utf8');
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : null;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+        return null;
+    }
+}
+async function resolveTemplateContent(name, options) {
+    if (options.templatesRoot) {
+        const localTemplate = await readIfExists(join(options.templatesRoot, name));
+        if (localTemplate !== null) {
+            return localTemplate;
+        }
+    }
+    const bundledTemplate = await readIfExists(join(options.assetsRoot, 'templates', name));
+    if (bundledTemplate !== null) {
+        return bundledTemplate;
+    }
+    throw new Error(`Template ${name} was not found in repo-local templates or bundled assets.`);
+}
+function stripTemplateFrontmatter(content) {
+    if (!content.startsWith('---\n')) {
+        return content;
+    }
+    const end = content.indexOf('\n---', 4);
+    if (end === -1) {
+        return content;
+    }
+    const frontmatter = content.slice(4, end);
+    if (!/\boat_template\s*:/i.test(frontmatter) &&
+        !/\boat_template_name\s*:/i.test(frontmatter)) {
+        return content;
+    }
+    const afterFrontmatter = content.slice(end + '\n---'.length);
+    return afterFrontmatter.replace(/^\r?\n+/, '');
+}
+async function writeFileIfMissing(filePath, content) {
+    if (await pathExists(filePath)) {
+        return 'skipped';
+    }
+    await mkdir(dirname(filePath), { recursive: true });
+    await writeFile(filePath, content, 'utf8');
+    return 'created';
+}
+export async function initializeRepoReference(options) {
+    const created = [];
+    const skipped = [];
+    for (const templateName of REFERENCE_TEMPLATES) {
+        const targetPath = join(options.referenceRoot, templateName);
+        if (await pathExists(targetPath)) {
+            skipped.push(templateName);
+            continue;
+        }
+        const template = await resolveTemplateContent(templateName, options);
+        const status = await writeFileIfMissing(targetPath, stripTemplateFrontmatter(template));
+        if (status === 'created') {
+            created.push(templateName);
+        }
+        else {
+            skipped.push(templateName);
+        }
+    }
+    const existingBacklogPaths = new Set();
+    for (const relativePath of BACKLOG_PATHS) {
+        if (await pathExists(join(options.referenceRoot, relativePath))) {
+            existingBacklogPaths.add(relativePath);
+        }
+    }
+    await initializeBacklog(join(options.referenceRoot, 'backlog'));
+    for (const relativePath of BACKLOG_PATHS) {
+        if (existingBacklogPaths.has(relativePath)) {
+            skipped.push(relativePath);
+        }
+        else {
+            created.push(relativePath);
+        }
+    }
+    return {
+        referenceRoot: options.referenceRoot,
+        created,
+        skipped,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "private": false,
   "description": "Open Agent Toolkit CLI",
   "homepage": "https://github.com/voxmedia/open-agent-toolkit/tree/main/packages/cli",
@@ -34,7 +34,7 @@
     "ora": "^9.0.0",
     "yaml": "2.8.2",
     "zod": "^3.25.76",
-    "@open-agent-toolkit/control-plane": "0.1.17"
+    "@open-agent-toolkit/control-plane": "0.1.18"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",