@open-agent-toolkit/cli 0.1.31 → 0.1.33

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

@@ -0,0 +1,14 @@
+export declare const DECISION_INDEX_START = "<!-- OAT DECISION-INDEX -->";
+export declare const DECISION_INDEX_END = "<!-- END OAT DECISION-INDEX -->";
+interface DecisionIndexRecord {
+    id: string;
+    date: string;
+    status: string;
+    title: string;
+    legacyId: string;
+}
+export declare function assertDecisionIndexScaffold(decisionsRoot: string): Promise<void>;
+export declare function renderDecisionManagedSection(records: DecisionIndexRecord[]): string;
+export declare function regenerateDecisionIndex(decisionsRoot: string): Promise<void>;
+export {};
+//# sourceMappingURL=regenerate-index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate-index.d.ts","sourceRoot":"","sources":["../../../src/commands/decision/regenerate-index.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAClE,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AAEpE,UAAU,mBAAmB;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AA2GD,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAAE,GAC7B,MAAM,CAgBR;AAED,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

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

@@ -0,0 +1,122 @@
+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';
+export const DECISION_INDEX_START = '<!-- OAT DECISION-INDEX -->';
+export const DECISION_INDEX_END = '<!-- END OAT DECISION-INDEX -->';
+function parseDecisionFrontmatter(content, filePath) {
+    const rawFrontmatter = getFrontmatterBlock(content);
+    if (!rawFrontmatter) {
+        return null;
+    }
+    const parsed = YAML.parse(rawFrontmatter);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`Frontmatter in ${filePath} must be a YAML object.`);
+    }
+    const frontmatter = parsed;
+    return {
+        id: String(frontmatter.id ?? ''),
+        date: String(frontmatter.date ?? ''),
+        status: String(frontmatter.status ?? ''),
+        title: String(frontmatter.title ?? ''),
+        legacyId: frontmatter.legacy_id === null || frontmatter.legacy_id === undefined
+            ? ''
+            : String(frontmatter.legacy_id),
+    };
+}
+function compareRecords(a, b) {
+    if (a.date > b.date) {
+        return -1;
+    }
+    if (a.date < b.date) {
+        return 1;
+    }
+    if (a.id < b.id) {
+        return -1;
+    }
+    if (a.id > b.id) {
+        return 1;
+    }
+    return 0;
+}
+function formatCell(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return '-';
+    }
+    return trimmed.replace(/\r?\n/g, ' ').replace(/\|/g, '\\|');
+}
+function isMissingFileError(error) {
+    return (error !== null &&
+        typeof error === 'object' &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+async function readDecisionIndex(decisionsRoot) {
+    const indexPath = join(decisionsRoot, 'index.md');
+    try {
+        return {
+            content: await readFile(indexPath, 'utf8'),
+            indexPath,
+        };
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            throw new Error(`Decision index scaffold is missing at ${indexPath}. Run \`oat decision init\` before creating or regenerating decision records.`, { cause: error });
+        }
+        throw error;
+    }
+}
+function findManagedSectionBounds(content, indexPath) {
+    const startIndex = content.indexOf(DECISION_INDEX_START);
+    const endIndex = content.indexOf(DECISION_INDEX_END);
+    if (startIndex === -1 || endIndex === -1 || endIndex < startIndex) {
+        throw new Error(`Managed decision index markers missing in ${indexPath}. Expected the exact marker pair:\n${DECISION_INDEX_START}\n${DECISION_INDEX_END}\nRun \`oat decision init\` if the decision scaffold is missing, or restore those exact markers in \`decisions/index.md\` before rerunning \`oat decision regenerate-index\`.`);
+    }
+    return { startIndex, endIndex };
+}
+export async function assertDecisionIndexScaffold(decisionsRoot) {
+    const { content, indexPath } = await readDecisionIndex(decisionsRoot);
+    findManagedSectionBounds(content, indexPath);
+}
+export function renderDecisionManagedSection(records) {
+    const rows = records.length > 0
+        ? records.map((record) => `| ${formatCell(record.id)} | ${formatCell(record.date)} | ${formatCell(record.status)} | ${formatCell(record.title)} | ${formatCell(record.legacyId)} |`)
+        : ['| _No decisions yet_ | - | - | - | - |'];
+    return [
+        DECISION_INDEX_START,
+        '| ID | Date | Status | Title | Legacy |',
+        '| --- | --- | --- | --- | --- |',
+        ...rows,
+        DECISION_INDEX_END,
+    ].join('\n');
+}
+export async function regenerateDecisionIndex(decisionsRoot) {
+    const { content, indexPath } = await readDecisionIndex(decisionsRoot);
+    const { startIndex, endIndex } = findManagedSectionBounds(content, indexPath);
+    const entries = (await readdir(decisionsRoot, { withFileTypes: true }))
+        .filter((entry) => entry.isFile() &&
+        entry.name.endsWith('.md') &&
+        entry.name !== 'index.md')
+        .map((entry) => entry.name)
+        .sort();
+    const records = [];
+    for (const entry of entries) {
+        const filePath = join(decisionsRoot, entry);
+        const record = parseDecisionFrontmatter(await readFile(filePath, 'utf8'), filePath);
+        if (record) {
+            records.push(record);
+        }
+    }
+    records.sort(compareRecords);
+    // 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 + DECISION_INDEX_END.length, renderDecisionManagedSection(records));
+    if (updated === null) {
+        return;
+    }
+    await writeFile(indexPath, updated, 'utf8');
+}

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

@@ -0,0 +1,2 @@
+export declare function generateDecisionId(title: string, createdAt: string | Date): string;
+//# sourceMappingURL=generate-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate-id.d.ts","sourceRoot":"","sources":["../../../../src/commands/decision/shared/generate-id.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,MAAM,CAER"}

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

@@ -0,0 +1,5 @@
+import { yymmdd } from '../../shared/date-id.js';
+import { slugify } from '../../shared/slug.js';
+export function generateDecisionId(title, createdAt) {
+    return `DR-${yymmdd(createdAt)}-${slugify(title)}`;
+}

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

@@ -1,6 +1,9 @@
 import { type CommandContext, type GlobalOptions } from '../../app/command-context.js';
+import { type PjmDoctorOptions } from '../pjm/doctor.js';
+import { type OatConfig } from '../../config/oat-config.js';
 import { type Manifest } from '../../manifest/index.js';
 import type { ConcreteScope } from '../../shared/types.js';
+import { type DoctorCheck } from '../../ui/output.js';
 import { Command } from 'commander';
 interface DoctorDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
@@ -15,6 +18,8 @@ interface DoctorDependencies {
     }>>;
     readFile: (path: string) => Promise<string>;
     resolveAssetsRoot: () => Promise<string>;
+    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    runPjmDoctorChecks: (repoRoot: string, options?: PjmDoctorOptions) => Promise<DoctorCheck[]>;
     checkSkillVersions: (scopeRoot: string, assetsRoot: string, pathExists: (path: string) => Promise<boolean>) => Promise<SkillVersionReport>;
 }
 interface OutdatedSkillVersion {

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":"AAWA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAU9B,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,KACd,OAAO,CACV,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACnE,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAsaD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,OAAO,CAcT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/doctor/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAInE,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,mBAAmB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7D,cAAc,EAAE,CACd,SAAS,EAAE,MAAM,KACd,OAAO,CACV,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CACnE,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,KACvB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5B,kBAAkB,EAAE,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,KAC3C,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAClC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,kBAAkB;IAC1B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,0BAA0B,EAAE,MAAM,CAAC;IACnC,cAAc,EAAE,oBAAoB,EAAE,CAAC;CACxC;AAsbD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,kBAAkB,CAAM,GAC1C,OAAO,CAcT"}

package/dist/commands/doctor/index.js

@@ -3,8 +3,10 @@ import { tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { buildCommandContext, } from '../../app/command-context.js';
 import { compareVersions } from '../init/tools/shared/version.js';
+import { createPjmDisabledCheck, runPjmDoctorChecks, } from '../pjm/doctor.js';
 import { getSkillVersion } from '../shared/frontmatter.js';
 import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
+import { readOatConfig } from '../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../fs/paths.js';
 import TOML from '@iarna/toml';
@@ -125,6 +127,8 @@ function createDependencies() {
         checkProviders: checkProvidersDefault,
         readFile: async (path) => readFile(path, 'utf8'),
         resolveAssetsRoot,
+        readOatConfig,
+        runPjmDoctorChecks,
         // 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),
@@ -339,6 +343,17 @@ async function runChecksForScope(scope, scopeRoot, dependencies) {
                 }
             }
         }
+        const repoReferenceRoot = join(scopeRoot, '.oat', 'repo');
+        const config = await dependencies.readOatConfig(scopeRoot);
+        const projectManagementEnabled = config.tools?.['project-management'] === true;
+        if (projectManagementEnabled) {
+            checks.push(...(await dependencies.runPjmDoctorChecks(repoReferenceRoot, {
+                projectManagementEnabled: true,
+            })));
+        }
+        else if (await dependencies.pathExists(repoReferenceRoot)) {
+            checks.push(createPjmDisabledCheck());
+        }
     }
     return checks;
 }

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;AAuBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBvD"}

package/dist/commands/index.js

@@ -1,6 +1,7 @@
 import { createBacklogCommand } from './backlog/index.js';
 import { createCleanupCommand } from './cleanup/index.js';
 import { createConfigCommand } from './config/index.js';
+import { createDecisionCommand } from './decision/index.js';
 import { createDocsCommand } from './docs/index.js';
 import { createDoctorCommand } from './doctor/index.js';
 import { createIndexCommand } from './index-cmd/index.js';
@@ -20,6 +21,7 @@ import { createSyncCommand } from './sync/index.js';
 import { createToolsCommand } from './tools/index.js';
 export function registerCommands(program) {
     program.addCommand(createBacklogCommand());
+    program.addCommand(createDecisionCommand());
     program.addCommand(createInitCommand());
     program.addCommand(createStatusCommand());
     program.addCommand(createSyncCommand());

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

@@ -20,8 +20,8 @@ export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];
 export declare const DOCS_SKILLS: readonly ["authoring-docs", "oat-agent-instructions-analyze", "oat-agent-instructions-apply", "oat-docs-analyze", "oat-docs-apply", "oat-docs-authoring", "oat-docs-bootstrap"];
 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", "current-state.md", "decision-record.md"];
+export declare const PROJECT_MANAGEMENT_SKILLS: readonly ["oat-pjm-add-backlog-item", "oat-pjm-decision", "oat-pjm-update-repo-reference", "oat-pjm-review-backlog"];
+export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md", "current-state.md", "decision.md", "repo-agents.md", "pjm-agents.md", "reference-agents.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,iLAQd,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"}
+{"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,iLAQd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,6KAOjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,sHAK5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,yIAQ/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

@@ -99,6 +99,7 @@ export const UTILITY_SKILLS = [
 // ── Project management pack ───────────────────────────────────────
 export const PROJECT_MANAGEMENT_SKILLS = [
     'oat-pjm-add-backlog-item',
+    'oat-pjm-decision',
     'oat-pjm-update-repo-reference',
     'oat-pjm-review-backlog',
 ];
@@ -106,7 +107,10 @@ export const PROJECT_MANAGEMENT_TEMPLATES = [
     'backlog-item.md',
     'roadmap.md',
     'current-state.md',
-    'decision-record.md',
+    'decision.md',
+    'repo-agents.md',
+    'pjm-agents.md',
+    'reference-agents.md',
 ];
 export const PROJECT_MANAGEMENT_SCRIPTS = [];
 // ── Brainstorm pack ───────────────────────────────────────────────

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

@@ -0,0 +1,7 @@
+import type { DoctorCheck } from '../../ui/output.js';
+export interface PjmDoctorOptions {
+    projectManagementEnabled?: boolean;
+}
+export declare function createPjmDisabledCheck(): DoctorCheck;
+export declare function runPjmDoctorChecks(repoRoot: string, options?: PjmDoctorOptions): Promise<DoctorCheck[]>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AA0I9C,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC;AAED,wBAAgB,sBAAsB,IAAI,WAAW,CAQpD;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC,CAyJxB"}

package/dist/commands/pjm/doctor.js

@@ -0,0 +1,250 @@
+import { access, readdir, readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { getFrontmatterBlock } from '../shared/frontmatter.js';
+import { CANONICAL_REPO_REFERENCE_PATHS } from './init.js';
+const ALLOWED_TOP_LEVEL_DIRECTORIES = new Set([
+    'pjm',
+    'reference',
+    'knowledge',
+    'analysis',
+    'reviews',
+]);
+// A human-facing `README.md` at the repo-reference root is benign, so it is an
+// allowed top-level file alongside the canonical `AGENTS.md` (F5).
+const ALLOWED_TOP_LEVEL_FILES = new Set(['AGENTS.md', 'README.md']);
+const LEGACY_MONOLITHS = ['reference/decision-record.md'];
+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 listDirectoryNames(path) {
+    try {
+        return (await readdir(path, { withFileTypes: true }))
+            .filter((entry) => entry.isDirectory() || entry.isFile())
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : null;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+        return [];
+    }
+}
+async function listMarkdownFiles(path) {
+    try {
+        return (await readdir(path, { withFileTypes: true }))
+            .filter((entry) => entry.isFile() && entry.name.endsWith('.md'))
+            .map((entry) => entry.name)
+            .sort();
+    }
+    catch (error) {
+        const code = error && typeof error === 'object' && 'code' in error
+            ? String(error.code)
+            : null;
+        if (code !== 'ENOENT') {
+            throw error;
+        }
+        return [];
+    }
+}
+// Migrated record directories (relative to the repo-reference root) that hold
+// per-record markdown files and must not retain raw template frontmatter after
+// `oat pjm migrate`. `index.md` is the managed index, not an instantiated
+// record, so it is excluded.
+const MIGRATED_RECORD_DIRECTORIES = [
+    'pjm/backlog/items',
+    'pjm/backlog/archived',
+    'reference/decisions',
+];
+async function collectMigratedTemplateFrontmatterFiles(repoRoot) {
+    const offenders = [];
+    for (const relativeDir of MIGRATED_RECORD_DIRECTORIES) {
+        const fileNames = await listMarkdownFiles(join(repoRoot, relativeDir));
+        for (const fileName of fileNames) {
+            if (fileName === 'index.md') {
+                continue;
+            }
+            const relativePath = `${relativeDir}/${fileName}`;
+            const content = await readIfExists(join(repoRoot, relativeDir, fileName));
+            if (content && containsTemplateFrontmatter(content)) {
+                offenders.push(relativePath);
+            }
+        }
+    }
+    return offenders;
+}
+function containsTemplateFrontmatter(content) {
+    const frontmatter = getFrontmatterBlock(content);
+    return Boolean(frontmatter &&
+        (/\boat_template\s*:/i.test(frontmatter) ||
+            /\boat_template_name\s*:/i.test(frontmatter)));
+}
+function checkStatus(missing) {
+    return missing.length === 0 ? 'pass' : 'fail';
+}
+function warnStatus(items) {
+    return items.length === 0 ? 'pass' : 'warn';
+}
+export function createPjmDisabledCheck() {
+    return {
+        name: 'pjm:disabled',
+        description: 'Project-management pack enablement',
+        status: 'pass',
+        message: 'Project-management pack is disabled; PJM checks skipped.',
+        fix: 'Run `oat init tools project-management` to install and enable PJM checks.',
+    };
+}
+export async function runPjmDoctorChecks(repoRoot, options = {}) {
+    if (options.projectManagementEnabled === false) {
+        return [createPjmDisabledCheck()];
+    }
+    const checks = [];
+    const missingCanonical = [];
+    for (const relativePath of CANONICAL_REPO_REFERENCE_PATHS) {
+        if (!(await pathExists(join(repoRoot, relativePath)))) {
+            missingCanonical.push(relativePath);
+        }
+    }
+    checks.push({
+        name: 'pjm:canonical_files',
+        description: 'PJM canonical file existence',
+        status: checkStatus(missingCanonical),
+        message: missingCanonical.length === 0
+            ? 'Canonical PJM files are present.'
+            : `Missing canonical PJM files: ${missingCanonical.join(', ')}`,
+        fix: missingCanonical.length === 0
+            ? undefined
+            : 'Run `oat pjm init` to restore the canonical PJM scaffold.',
+    });
+    const templateFrontmatterFiles = [];
+    for (const relativePath of CANONICAL_REPO_REFERENCE_PATHS) {
+        if (!relativePath.endsWith('.md')) {
+            continue;
+        }
+        const content = await readIfExists(join(repoRoot, relativePath));
+        if (content && containsTemplateFrontmatter(content)) {
+            templateFrontmatterFiles.push(relativePath);
+        }
+    }
+    // Also scan migrated per-record files (backlog items/archived, decision
+    // records). Dogfooding surfaced that `oat pjm migrate` could leave raw
+    // `oat_template` frontmatter on migrated records while doctor only inspected
+    // the canonical scaffold and reported a false `pass`.
+    const migratedTemplateFiles = await collectMigratedTemplateFrontmatterFiles(repoRoot);
+    for (const relativePath of migratedTemplateFiles) {
+        if (!templateFrontmatterFiles.includes(relativePath)) {
+            templateFrontmatterFiles.push(relativePath);
+        }
+    }
+    checks.push({
+        name: 'pjm:template_frontmatter',
+        description: 'Instantiated PJM files are not raw templates',
+        status: checkStatus(templateFrontmatterFiles),
+        message: templateFrontmatterFiles.length === 0
+            ? 'No template frontmatter found in canonical PJM files.'
+            : `Template frontmatter still present in: ${templateFrontmatterFiles.join(', ')}`,
+        fix: templateFrontmatterFiles.length === 0
+            ? undefined
+            : 'Regenerate or manually remove oat_template frontmatter from instantiated files.',
+    });
+    const topLevelNames = await listDirectoryNames(repoRoot);
+    const unknownTopLevel = topLevelNames.filter((name) => !ALLOWED_TOP_LEVEL_DIRECTORIES.has(name) &&
+        !ALLOWED_TOP_LEVEL_FILES.has(name));
+    checks.push({
+        name: 'pjm:top_level_layout',
+        description: 'PJM top-level repo-reference layout',
+        status: warnStatus(unknownTopLevel),
+        message: unknownTopLevel.length === 0
+            ? 'No unknown top-level PJM folders or files found.'
+            : `Unknown top-level PJM entries: ${unknownTopLevel.join(', ')}`,
+        fix: unknownTopLevel.length === 0
+            ? undefined
+            : 'Move ad-hoc durable references under reference/ or document an allowed top-level folder.',
+    });
+    const legacyMonoliths = [];
+    for (const relativePath of LEGACY_MONOLITHS) {
+        if (await pathExists(join(repoRoot, relativePath))) {
+            legacyMonoliths.push(relativePath);
+        }
+    }
+    checks.push({
+        name: 'pjm:legacy_monoliths',
+        description: 'Legacy PJM monolith files',
+        status: warnStatus(legacyMonoliths),
+        message: legacyMonoliths.length === 0
+            ? 'No legacy PJM monolith files found.'
+            : `Legacy PJM monoliths still present: ${legacyMonoliths.join(', ')}`,
+        fix: legacyMonoliths.length === 0
+            ? undefined
+            : 'Run `oat decision migrate` or keep the file explicitly documented as legacy.',
+    });
+    const referenceEntries = await listDirectoryNames(join(repoRoot, 'reference'));
+    const looseReferenceFiles = referenceEntries
+        .filter((name) => name.endsWith('.md'))
+        .filter((name) => name !== 'AGENTS.md' &&
+        name !== 'decision-record.md' &&
+        name !== 'roadmap.md' &&
+        name !== 'current-state.md')
+        .map((name) => `reference/${name}`);
+    checks.push({
+        name: 'pjm:loose_reference_files',
+        description: 'Loose reference files outside documented destinations',
+        status: warnStatus(looseReferenceFiles),
+        message: looseReferenceFiles.length === 0
+            ? 'No loose reference files found.'
+            : `Loose reference files found: ${looseReferenceFiles.join(', ')}`,
+        fix: looseReferenceFiles.length === 0
+            ? undefined
+            : 'Move loose files into a documented reference subfolder or add a destination guide.',
+    });
+    const secondRoadmaps = [];
+    for (const relativePath of [
+        'reference/roadmap.md',
+        'reference/current-state.md',
+    ]) {
+        if (await pathExists(join(repoRoot, relativePath))) {
+            secondRoadmaps.push(relativePath);
+        }
+    }
+    checks.push({
+        name: 'pjm:second_roadmap',
+        description: 'Duplicate active PJM files under reference',
+        status: warnStatus(secondRoadmaps),
+        message: secondRoadmaps.length === 0
+            ? 'No duplicate roadmap/current-state files found under reference/.'
+            : `Duplicate active PJM files under reference/: ${secondRoadmaps.join(', ')}`,
+        fix: secondRoadmaps.length === 0
+            ? undefined
+            : 'Move active operational docs to pjm/ and leave reference/ for durable append-mostly artifacts.',
+    });
+    return checks;
+}

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

@@ -1,13 +1,20 @@
 import { buildCommandContext } from '../../app/command-context.js';
+import { readOatConfig } from '../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
 import { Command } from 'commander';
+import { runPjmDoctorChecks } from './doctor.js';
 import { initializeRepoReference } from './init.js';
+import { migratePjmRepo, readPjmMigrationPrompt } from './migrate.js';
 interface PjmCommandDependencies {
     buildCommandContext: typeof buildCommandContext;
     resolveProjectRoot: typeof resolveProjectRoot;
     resolveAssetsRoot: typeof resolveAssetsRoot;
+    readOatConfig: typeof readOatConfig;
     initializeRepoReference: typeof initializeRepoReference;
+    runPjmDoctorChecks: typeof runPjmDoctorChecks;
+    migratePjmRepo: typeof migratePjmRepo;
+    readPjmMigrationPrompt: typeof readPjmMigrationPrompt;
 }
 export declare function createPjmCommand(overrides?: Partial<PjmCommandDependencies>): Command;
 export {};

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

@@ -1 +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"}
+{"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,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAiBnE,UAAU,sBAAsB;IAC9B,mBAAmB,EAAE,OAAO,mBAAmB,CAAC;IAChD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;IAC5C,aAAa,EAAE,OAAO,aAAa,CAAC;IACpC,uBAAuB,EAAE,OAAO,uBAAuB,CAAC;IACxD,kBAAkB,EAAE,OAAO,kBAAkB,CAAC;IAC9C,cAAc,EAAE,OAAO,cAAc,CAAC;IACtC,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;CACvD;AA6FD,wBAAgB,gBAAgB,CAC9B,SAAS,GAAE,OAAO,CAAC,sBAAsB,CAAM,GAC9C,OAAO,CAsJT"}