@open-agent-toolkit/cli 0.1.31 → 0.1.32

package/dist/commands/pjm/index.js

@@ -1,21 +1,83 @@
 import { resolve } from 'node:path';
 import { buildCommandContext } from '../../app/command-context.js';
 import { readGlobalOptions } from '../shared/shared.utils.js';
+import { readOatConfig } from '../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../fs/assets.js';
 import { resolveProjectRoot } from '../../fs/paths.js';
+import { formatDoctorResults } from '../../ui/output.js';
 import { Command } from 'commander';
+import { runPjmDoctorChecks } from './doctor.js';
 import { initializeRepoReference } from './init.js';
+import { migratePjmRepo, readPjmMigrationPrompt } from './migrate.js';
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveProjectRoot,
     resolveAssetsRoot,
+    readOatConfig,
     initializeRepoReference,
+    runPjmDoctorChecks,
+    migratePjmRepo,
+    readPjmMigrationPrompt,
 };
-async function resolveReferenceRoot(context, projectRoot, configuredRoot) {
+async function resolveRepoRoot(context, projectRoot, configuredRoot) {
     if (configuredRoot) {
         return resolve(context.cwd, configuredRoot);
     }
-    return resolve(projectRoot, '.oat', 'repo', 'reference');
+    return resolve(projectRoot, '.oat', 'repo');
+}
+function reportError(context, 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;
+}
+function doctorStatus(checks) {
+    if (checks.some((check) => check.status === 'fail')) {
+        return 'fail';
+    }
+    if (checks.some((check) => check.status === 'warn')) {
+        return 'warn';
+    }
+    return 'ok';
+}
+function setDoctorExitCode(checks) {
+    const status = doctorStatus(checks);
+    process.exitCode = status === 'fail' ? 2 : status === 'warn' ? 1 : 0;
+}
+function formatMigrationResult(result) {
+    const lines = [
+        `PJM migration ${result.dryRun ? 'dry run' : 'apply'} for ${result.repoRoot}`,
+        `status: ${result.status}`,
+    ];
+    if (result.reason) {
+        lines.push(`reason: ${result.reason}`);
+    }
+    if (result.actions.length > 0) {
+        lines.push('actions:');
+        for (const action of result.actions) {
+            const pathSummary = action.source && action.target
+                ? `${action.source} -> ${action.target}`
+                : (action.source ?? action.target ?? '');
+            lines.push(`- ${action.type} ${pathSummary} (${action.result}${action.reason ? `: ${action.reason}` : ''})`);
+        }
+    }
+    if (result.backlogMappings.length > 0) {
+        lines.push('backlog mappings:');
+        for (const mapping of result.backlogMappings) {
+            lines.push(`- ${mapping.legacyId} -> ${mapping.id}`);
+        }
+    }
+    if (result.decisionMappings.length > 0) {
+        lines.push('decision mappings:');
+        for (const mapping of result.decisionMappings) {
+            lines.push(`- ${mapping.legacyId} -> ${mapping.id}`);
+        }
+    }
+    return lines.join('\n');
 }
 export function createPjmCommand(overrides = {}) {
     const dependencies = {
@@ -26,15 +88,15 @@ export function createPjmCommand(overrides = {}) {
     cmd
         .command('init')
         .description('Scaffold the canonical PJM repo reference surface')
-        .option('--reference-root <path>', 'Reference root directory (defaults to .oat/repo/reference)')
+        .option('--repo-root <path>', 'PJM repo reference root directory (defaults to .oat/repo)')
         .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 repoRoot = await resolveRepoRoot(context, projectRoot, options.repoRoot);
             const assetsRoot = await dependencies.resolveAssetsRoot();
             const result = await dependencies.initializeRepoReference({
-                referenceRoot,
+                repoRoot,
                 assetsRoot,
                 templatesRoot: resolve(projectRoot, '.oat', 'templates'),
             });
@@ -42,7 +104,7 @@ export function createPjmCommand(overrides = {}) {
                 context.logger.json({ status: 'ok', ...result });
             }
             else {
-                context.logger.info(`Initialized PJM repo reference scaffold at ${result.referenceRoot}`);
+                context.logger.info(`Initialized PJM repo reference scaffold at ${result.repoRoot}`);
                 if (result.created.length > 0) {
                     context.logger.info(`Created: ${result.created.join(', ')}`);
                 }
@@ -53,14 +115,74 @@ export function createPjmCommand(overrides = {}) {
             process.exitCode = 0;
         }
         catch (error) {
-            const message = error instanceof Error ? error.message : String(error);
+            reportError(context, error);
+        }
+    });
+    cmd
+        .command('doctor')
+        .description('Run PJM repo reference diagnostics')
+        .option('--repo-root <path>', 'PJM repo reference root directory (defaults to .oat/repo)')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+            const repoRoot = await resolveRepoRoot(context, projectRoot, options.repoRoot);
+            const checks = await dependencies.runPjmDoctorChecks(repoRoot);
+            const status = doctorStatus(checks);
             if (context.json) {
-                context.logger.json({ status: 'error', message });
+                context.logger.json({ status, repoRoot, checks });
             }
             else {
-                context.logger.error(message);
+                context.logger.info(formatDoctorResults(checks));
             }
-            process.exitCode = 1;
+            setDoctorExitCode(checks);
+        }
+        catch (error) {
+            reportError(context, error);
+        }
+    });
+    cmd
+        .command('migrate')
+        .description('Migrate legacy PJM repo reference docs to the two-layer layout')
+        .option('--repo-root <path>', 'PJM repo reference root directory (defaults to .oat/repo)')
+        .option('--apply', 'Apply mechanical migration steps')
+        .option('--dry-run', 'Preview migration without applying (default)')
+        .option('--print-prompt', 'Print the bundled agent migration prompt')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        try {
+            const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+            const repoRoot = await resolveRepoRoot(context, projectRoot, options.repoRoot);
+            const assetsRoot = await dependencies.resolveAssetsRoot();
+            if (options.printPrompt) {
+                const prompt = await dependencies.readPjmMigrationPrompt(assetsRoot);
+                if (context.json) {
+                    context.logger.json({ status: 'ok', prompt });
+                }
+                else {
+                    context.logger.info(prompt.trimEnd());
+                }
+                process.exitCode = 0;
+                return;
+            }
+            const config = await dependencies.readOatConfig(projectRoot);
+            const result = await dependencies.migratePjmRepo({
+                repoRoot,
+                assetsRoot,
+                templatesRoot: resolve(projectRoot, '.oat', 'templates'),
+                projectManagementEnabled: config.tools?.['project-management'] === true,
+                apply: options.dryRun ? false : (options.apply ?? false),
+            });
+            if (context.json) {
+                context.logger.json(result);
+            }
+            else {
+                context.logger.info(formatMigrationResult(result));
+            }
+            process.exitCode = 0;
+        }
+        catch (error) {
+            reportError(context, error);
         }
     });
     return cmd;

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

@@ -1,12 +1,13 @@
 export interface InitializeRepoReferenceOptions {
-    referenceRoot: string;
+    repoRoot: string;
     assetsRoot: string;
     templatesRoot?: string;
 }
 export interface RepoReferenceInitResult {
-    referenceRoot: string;
+    repoRoot: string;
     created: string[];
     skipped: string[];
 }
+export declare const CANONICAL_REPO_REFERENCE_PATHS: readonly [...("AGENTS.md" | "pjm/AGENTS.md" | "pjm/current-state.md" | "pjm/roadmap.md" | "reference/AGENTS.md")[], "pjm/backlog/index.md", "pjm/backlog/completed.md", "pjm/backlog/items/.gitkeep", "pjm/backlog/archived/.gitkeep", "reference/decisions/index.md"];
 export declare function initializeRepoReference(options: InitializeRepoReferenceOptions): Promise<RepoReferenceInitResult>;
 //# sourceMappingURL=init.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/init.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAwBD,eAAO,MAAM,8BAA8B,wQAIjC,CAAC;AAyEX,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,uBAAuB,CAAC,CAgElC"}

package/dist/commands/pjm/init.js

@@ -1,16 +1,26 @@
 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',
+import { initializeDecisionRecords } from '../decision/init.js';
+import { stripTemplateFrontmatter } from '../shared/strip-template-frontmatter.js';
+const TEMPLATE_TARGETS = [
+    { template: 'repo-agents.md', target: 'AGENTS.md' },
+    { template: 'pjm-agents.md', target: 'pjm/AGENTS.md' },
+    { template: 'current-state.md', target: 'pjm/current-state.md' },
+    { template: 'roadmap.md', target: 'pjm/roadmap.md' },
+    { template: 'reference-agents.md', target: 'reference/AGENTS.md' },
 ];
 const BACKLOG_PATHS = [
-    'backlog/index.md',
-    'backlog/completed.md',
-    'backlog/items/.gitkeep',
-    'backlog/archived/.gitkeep',
+    'pjm/backlog/index.md',
+    'pjm/backlog/completed.md',
+    'pjm/backlog/items/.gitkeep',
+    'pjm/backlog/archived/.gitkeep',
+];
+const DECISION_PATHS = ['reference/decisions/index.md'];
+export const CANONICAL_REPO_REFERENCE_PATHS = [
+    ...TEMPLATE_TARGETS.map((target) => target.target),
+    ...BACKLOG_PATHS,
+    ...DECISION_PATHS,
 ];
 async function pathExists(path) {
     try {
@@ -54,22 +64,6 @@ async function resolveTemplateContent(name, options) {
     }
     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';
@@ -81,28 +75,28 @@ async function writeFileIfMissing(filePath, content) {
 export async function initializeRepoReference(options) {
     const created = [];
     const skipped = [];
-    for (const templateName of REFERENCE_TEMPLATES) {
-        const targetPath = join(options.referenceRoot, templateName);
+    for (const target of TEMPLATE_TARGETS) {
+        const targetPath = join(options.repoRoot, target.target);
         if (await pathExists(targetPath)) {
-            skipped.push(templateName);
+            skipped.push(target.target);
             continue;
         }
-        const template = await resolveTemplateContent(templateName, options);
+        const template = await resolveTemplateContent(target.template, options);
         const status = await writeFileIfMissing(targetPath, stripTemplateFrontmatter(template));
         if (status === 'created') {
-            created.push(templateName);
+            created.push(target.target);
         }
         else {
-            skipped.push(templateName);
+            skipped.push(target.target);
         }
     }
     const existingBacklogPaths = new Set();
     for (const relativePath of BACKLOG_PATHS) {
-        if (await pathExists(join(options.referenceRoot, relativePath))) {
+        if (await pathExists(join(options.repoRoot, relativePath))) {
             existingBacklogPaths.add(relativePath);
         }
     }
-    await initializeBacklog(join(options.referenceRoot, 'backlog'));
+    await initializeBacklog(join(options.repoRoot, 'pjm', 'backlog'));
     for (const relativePath of BACKLOG_PATHS) {
         if (existingBacklogPaths.has(relativePath)) {
             skipped.push(relativePath);
@@ -111,8 +105,23 @@ export async function initializeRepoReference(options) {
             created.push(relativePath);
         }
     }
+    const existingDecisionPaths = new Set();
+    for (const relativePath of DECISION_PATHS) {
+        if (await pathExists(join(options.repoRoot, relativePath))) {
+            existingDecisionPaths.add(relativePath);
+        }
+    }
+    await initializeDecisionRecords(join(options.repoRoot, 'reference', 'decisions'));
+    for (const relativePath of DECISION_PATHS) {
+        if (existingDecisionPaths.has(relativePath)) {
+            skipped.push(relativePath);
+        }
+        else {
+            created.push(relativePath);
+        }
+    }
     return {
-        referenceRoot: options.referenceRoot,
+        repoRoot: options.repoRoot,
         created,
         skipped,
     };

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

@@ -0,0 +1,36 @@
+import { type DecisionMigrationMapping } from '../decision/migrate.js';
+export type PjmMigrationActionType = 'move' | 'create' | 'migrate-backlog' | 'migrate-decisions' | 'propose';
+export type PjmMigrationActionResult = 'planned' | 'applied' | 'skipped';
+export interface PjmMigrationAction {
+    type: PjmMigrationActionType;
+    result: PjmMigrationActionResult;
+    source?: string;
+    target?: string;
+    reason?: string;
+}
+export interface PjmBacklogMigrationMapping {
+    legacyId: string;
+    id: string;
+    title: string;
+    filePath: string;
+}
+export interface PjmMigrationResult {
+    repoRoot: string;
+    status: 'skipped' | 'dry-run' | 'already-migrated' | 'migrated';
+    reason?: string;
+    dryRun: boolean;
+    actions: PjmMigrationAction[];
+    backlogMappings: PjmBacklogMigrationMapping[];
+    decisionMappings: DecisionMigrationMapping[];
+    written: string[];
+}
+export interface PjmMigrationOptions {
+    repoRoot: string;
+    assetsRoot: string;
+    templatesRoot?: string;
+    projectManagementEnabled: boolean;
+    apply?: boolean;
+}
+export declare function migratePjmRepo(options: PjmMigrationOptions): Promise<PjmMigrationResult>;
+export declare function readPjmMigrationPrompt(assetsRoot: string): Promise<string>;
+//# sourceMappingURL=migrate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/commands/pjm/migrate.ts"],"names":[],"mappings":"AAeA,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAMpC,MAAM,MAAM,sBAAsB,GAC9B,MAAM,GACN,QAAQ,GACR,iBAAiB,GACjB,mBAAmB,GACnB,SAAS,CAAC;AAEd,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,kBAAkB,GAAG,UAAU,CAAC;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,eAAe,EAAE,0BAA0B,EAAE,CAAC;IAC9C,gBAAgB,EAAE,wBAAwB,EAAE,CAAC;IAC7C,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,wBAAwB,EAAE,OAAO,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAoZD,wBAAsB,cAAc,CAClC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAkG7B;AAED,wBAAsB,sBAAsB,CAC1C,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAEjB"}