@open-agent-toolkit/cli 0.0.31 → 0.0.33

package/dist/commands/instructions/validate/validate.js

@@ -1,9 +1,10 @@
 import { buildCommandContext } from '../../../app/command-context.js';
-import { buildInstructionsPayload, formatInstructionsReport, scanInstructionFiles, } from '../../instructions/instructions.utils.js';
+import { INSTRUCTION_SYNC_STRATEGIES, } from '../../instructions/instructions.types.js';
+import { buildInstructionsPayload, DEFAULT_INSTRUCTION_SYNC_STRATEGY, formatInstructionsReport, resolveInstructionSyncStrategy, scanInstructionFiles, } from '../../instructions/instructions.utils.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
 import { CliError } from '../../../errors/cli-error.js';
 import { resolveProjectRoot } from '../../../fs/paths.js';
-import { Command } from 'commander';
+import { Command, Option } from 'commander';
 function defaultDependencies() {
     return {
         buildCommandContext,
@@ -17,12 +18,18 @@ export function createInstructionsValidateCommand(overrides = {}) {
         ...overrides,
     };
     return new Command('validate')
-        .description('Validate AGENTS.md to CLAUDE.md pointer integrity')
-        .action(async (_options, command) => {
+        .description('Validate AGENTS.md/CLAUDE.md sync integrity for the selected strategy')
+        .addOption(new Option('--strategy <strategy>', 'Sync strategy')
+        .choices([...INSTRUCTION_SYNC_STRATEGIES])
+        .default(DEFAULT_INSTRUCTION_SYNC_STRATEGY))
+        .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const strategy = resolveInstructionSyncStrategy(options.strategy);
         try {
             const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
-            const entries = await dependencies.scanInstructionFiles(repoRoot);
+            const entries = await dependencies.scanInstructionFiles(repoRoot, {
+                strategy,
+            });
             const payload = buildInstructionsPayload({
                 mode: 'validate',
                 entries,
@@ -34,7 +41,10 @@ export function createInstructionsValidateCommand(overrides = {}) {
             else {
                 context.logger.info(formatInstructionsReport(payload, repoRoot));
                 if (payload.status === 'drift') {
-                    context.logger.info('Fix with: oat instructions sync');
+                    const fixCommand = strategy === DEFAULT_INSTRUCTION_SYNC_STRATEGY
+                        ? 'Fix with: oat instructions sync'
+                        : `Fix with: oat instructions sync --strategy ${strategy}`;
+                    context.logger.info(fixCommand);
                 }
             }
             process.exitCode = payload.status === 'ok' ? 0 : 1;

package/dist/commands/project/complete-state/index.d.ts

@@ -0,0 +1,16 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile } from 'node:fs/promises';
+import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { Command } from 'commander';
+interface ProjectCompleteStateDependencies {
+    buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    readFile: typeof defaultReadFile;
+    writeFile: typeof defaultWriteFile;
+    dirExists: typeof dirExists;
+    fileExists: typeof fileExists;
+    now: () => Date;
+}
+export declare function createProjectCompleteStateCommand(overrides?: Partial<ProjectCompleteStateDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/complete-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,IAAI,eAAe,EAC3B,SAAS,IAAI,gBAAgB,EAC9B,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,UAAU,gCAAgC;IACxC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,EAAE,OAAO,eAAe,CAAC;IACjC,SAAS,EAAE,OAAO,gBAAgB,CAAC;IACnC,SAAS,EAAE,OAAO,SAAS,CAAC;IAC5B,UAAU,EAAE,OAAO,UAAU,CAAC;IAC9B,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAsED,wBAAgB,iCAAiC,CAC/C,SAAS,GAAE,OAAO,CAAC,gCAAgC,CAAM,GACxD,OAAO,CA2BT"}

package/dist/commands/project/complete-state/index.js

@@ -0,0 +1,78 @@
+import { readFile as defaultReadFile, writeFile as defaultWriteFile, } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { buildCommandContext } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { CliError } from '../../../errors/cli-error.js';
+import { dirExists, fileExists } from '../../../fs/io.js';
+import { resolveProjectRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { renderCompletedProjectState } from './state-utils.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    readFile: defaultReadFile,
+    writeFile: defaultWriteFile,
+    dirExists,
+    fileExists,
+    now: () => new Date(),
+};
+function resolveTargetProjectPath(repoRoot, projectPath) {
+    return isAbsolute(projectPath) ? projectPath : join(repoRoot, projectPath);
+}
+async function runProjectCompleteState(projectPath, options, context, dependencies) {
+    try {
+        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const targetProjectPath = resolveTargetProjectPath(repoRoot, projectPath);
+        if (!(await dependencies.dirExists(targetProjectPath))) {
+            throw new CliError(`Project not found: ${projectPath}`, 1);
+        }
+        const statePath = join(targetProjectPath, 'state.md');
+        if (!(await dependencies.fileExists(statePath))) {
+            throw new CliError(`Project state.md not found: ${statePath}`, 1);
+        }
+        const now = dependencies.now();
+        const content = await dependencies.readFile(statePath, 'utf8');
+        const updatedContent = renderCompletedProjectState(content, {
+            archived: options.archived ?? false,
+            nowUtc: now.toISOString(),
+            today: now.toISOString().slice(0, 10),
+        });
+        await dependencies.writeFile(statePath, updatedContent, 'utf8');
+        if (context.json) {
+            context.logger.json({
+                status: 'ok',
+                projectPath,
+                statePath,
+                archived: options.archived ?? false,
+            });
+        }
+        else {
+            context.logger.info(`Updated completed project state: ${projectPath}`);
+        }
+        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 = error instanceof CliError ? error.exitCode : 1;
+    }
+}
+export function createProjectCompleteStateCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('complete-state')
+        .description('Update a project state.md to the completed lifecycle shape')
+        .argument('<project-path>', 'Project path to update')
+        .option('--archived', 'Mark the completed project as archived locally')
+        .action(async (projectPath, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runProjectCompleteState(projectPath, options, context, dependencies);
+    });
+}

package/dist/commands/project/complete-state/state-utils.d.ts

@@ -0,0 +1,7 @@
+export interface CompleteProjectStateOptions {
+    archived: boolean;
+    nowUtc: string;
+    today: string;
+}
+export declare function renderCompletedProjectState(content: string, options: CompleteProjectStateOptions): string;
+//# sourceMappingURL=state-utils.d.ts.map

package/dist/commands/project/complete-state/state-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-utils.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/complete-state/state-utils.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAoED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,2BAA2B,GACnC,MAAM,CA8DR"}

package/dist/commands/project/complete-state/state-utils.js

@@ -0,0 +1,72 @@
+import { getFrontmatterBlock, getFrontmatterField, } from '../../shared/frontmatter.js';
+import { replaceFrontmatter, upsertFrontmatterField, } from '../../shared/frontmatter-write.js';
+function replaceLine(content, pattern, nextLine) {
+    return pattern.test(content) ? content.replace(pattern, nextLine) : content;
+}
+function findSectionBounds(content, heading) {
+    const marker = `## ${heading}\n\n`;
+    const start = content.indexOf(marker);
+    if (start === -1) {
+        return null;
+    }
+    const bodyStart = start + marker.length;
+    const nextHeading = content.indexOf('\n## ', bodyStart);
+    return {
+        start,
+        bodyStart,
+        end: nextHeading === -1 ? content.length : nextHeading,
+    };
+}
+function readSectionBody(content, heading) {
+    const bounds = findSectionBounds(content, heading);
+    if (!bounds) {
+        return '';
+    }
+    return content.slice(bounds.bodyStart, bounds.end).trim();
+}
+function replaceSection(content, heading, body) {
+    const bounds = findSectionBounds(content, heading);
+    if (!bounds) {
+        return content;
+    }
+    return [
+        content.slice(0, bounds.start),
+        `## ${heading}\n\n${body.trim()}\n`,
+        content.slice(bounds.end),
+    ].join('');
+}
+function renderCompletedProgress(content) {
+    const existingLines = readSectionBody(content, 'Progress')
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line.length > 0 && line.startsWith('- ✓'));
+    if (!existingLines.includes('- ✓ Project lifecycle complete')) {
+        existingLines.push('- ✓ Project lifecycle complete');
+    }
+    return existingLines.join('\n');
+}
+export function renderCompletedProjectState(content, options) {
+    const frontmatter = getFrontmatterBlock(content);
+    if (!frontmatter) {
+        throw new Error('state.md is missing frontmatter');
+    }
+    let nextBlock = upsertFrontmatterField(frontmatter, 'oat_lifecycle', 'complete', true).nextBlock;
+    nextBlock = upsertFrontmatterField(nextBlock, 'oat_project_completed', `"${options.nowUtc}"`, true).nextBlock;
+    nextBlock = upsertFrontmatterField(nextBlock, 'oat_project_state_updated', `"${options.nowUtc}"`, true).nextBlock;
+    let nextContent = nextBlock === frontmatter
+        ? content
+        : replaceFrontmatter(content, nextBlock);
+    nextContent = replaceLine(nextContent, /^\*\*Status:\*\*.*$/m, '**Status:** Complete');
+    nextContent = replaceLine(nextContent, /^\*\*Last Updated:\*\*.*$/m, `**Last Updated:** ${options.today}`);
+    const currentPhase = options.archived
+        ? 'Lifecycle complete; archived locally'
+        : 'Lifecycle complete';
+    nextContent = replaceSection(nextContent, 'Current Phase', currentPhase);
+    nextContent = replaceSection(nextContent, 'Progress', renderCompletedProgress(nextContent));
+    nextContent = replaceSection(nextContent, 'Next Milestone', 'None. Project complete.');
+    const currentLifecycle = getFrontmatterField(nextBlock, 'oat_lifecycle');
+    if (currentLifecycle !== 'complete') {
+        throw new Error('Failed to set oat_lifecycle: complete');
+    }
+    return nextContent;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wBAAgB,oBAAoB,IAAI,OAAO,CAU9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C"}

package/dist/commands/project/index.js

@@ -1,5 +1,6 @@
 import { Command } from 'commander';
 import { createProjectArchiveCommand } from './archive/index.js';
+import { createProjectCompleteStateCommand } from './complete-state/index.js';
 import { createProjectListCommand } from './list.js';
 import { createProjectNewCommand } from './new/index.js';
 import { createProjectOpenCommand } from './open/index.js';
@@ -10,6 +11,7 @@ export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
         .addCommand(createProjectArchiveCommand())
+        .addCommand(createProjectCompleteStateCommand())
         .addCommand(createProjectListCommand())
         .addCommand(createProjectNewCommand())
         .addCommand(createProjectOpenCommand())

package/package.json

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