@open-agent-toolkit/cli 0.0.32 → 0.0.33

package/README.md

@@ -34,6 +34,7 @@ Additional useful entry points:
 - `oat config dump --json`
 - `oat project status --json`
 - `oat project list --json`
+- `oat project complete-state /path/to/project`
 - `oat project archive sync`
 - `oat doctor`
 
@@ -44,6 +45,7 @@ Use these commands when you want structured runtime/project state out of the CLI
 - `oat config dump --json` - emit merged OAT config with per-key source attribution
 - `oat project status --json` - emit the active project's full parsed control-plane state
 - `oat project list --json` - emit summary state for tracked projects under the configured projects root
+- `oat project complete-state <project-path>` - emit the canonical completed lifecycle shape into a tracked project's `state.md`
 
 ## Requirements
 

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

@@ -39,6 +39,7 @@ Notable inspection commands introduced in the current CLI surface:
 - `oat config dump --json` - merged config with source attribution
 - `oat project status --json` - full parsed state for the active tracked project
 - `oat project list --json` - summary state for tracked projects under the configured projects root
+- `oat project complete-state <project-path>` - apply the canonical completed-state mutation to a project's `state.md`; used by `oat-project-complete` during lifecycle closeout
 
 ## `oat config` surface flags
 

package/assets/public-package-versions.json

@@ -1,6 +1,6 @@
 {
-  "cli": "0.0.32",
-  "docs-config": "0.0.32",
-  "docs-theme": "0.0.32",
-  "docs-transforms": "0.0.32"
+  "cli": "0.0.33",
+  "docs-config": "0.0.33",
+  "docs-theme": "0.0.33",
+  "docs-transforms": "0.0.33"
 }

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

@@ -1,6 +1,6 @@
 ---
 name: oat-project-complete
-version: 1.4.0
+version: 1.4.1
 description: Use when all implementation work is finished and the project is ready to close. Marks the OAT project lifecycle as complete.
 disable-model-invocation: true
 user-invocable: true
@@ -254,41 +254,19 @@ Rules:
 
 ### Step 5: Set Lifecycle Complete
 
-Update `state.md` frontmatter to add/update `oat_lifecycle: complete` and set completion timestamps:
+Delegate the canonical `state.md` completion mutation to the CLI:
 
 ```bash
-STATE_FILE="${PROJECT_PATH}/state.md"
-NOW_UTC=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
-
-# Check if oat_lifecycle already exists
-if grep -q "^oat_lifecycle:" "$STATE_FILE"; then
-  # Update existing (portable approach using temp file)
-  sed 's/^oat_lifecycle:.*/oat_lifecycle: complete/' "$STATE_FILE" > "$STATE_FILE.tmp"
-  mv "$STATE_FILE.tmp" "$STATE_FILE"
-else
-  # Add after oat_phase_status line using awk (more portable for multi-line inserts)
-  awk '/^oat_phase_status:/ {print; print "oat_lifecycle: complete"; next} 1' "$STATE_FILE" > "$STATE_FILE.tmp"
-  mv "$STATE_FILE.tmp" "$STATE_FILE"
+COMPLETE_STATE_ARGS=("$PROJECT_PATH")
+if [[ "$SHOULD_ARCHIVE" == "true" && "$IS_SHARED_PROJECT" == "true" ]]; then
+  COMPLETE_STATE_ARGS+=("--archived")
 fi
 
-# Set completion and state-updated timestamps
-sed -E "s/^oat_project_completed:.*/oat_project_completed: \"$NOW_UTC\"/" "$STATE_FILE" > "$STATE_FILE.tmp"
-mv "$STATE_FILE.tmp" "$STATE_FILE"
-sed -E "s/^oat_project_state_updated:.*/oat_project_state_updated: \"$NOW_UTC\"/" "$STATE_FILE" > "$STATE_FILE.tmp"
-mv "$STATE_FILE.tmp" "$STATE_FILE"
+oat project complete-state "${COMPLETE_STATE_ARGS[@]}"
 ```
 
-Then update the markdown body in `state.md` so the completion state is explicit and does not rely on reference lookups:
-
-- Set `**Status:** Complete`
-- Set `**Last Updated:**` to the completion date in `YYYY-MM-DD`
-- In `## Current Phase`, replace the body with:
-  - `Lifecycle complete; archived locally` when the project is archived in Step 8
-  - `Lifecycle complete` when the project is completed without archive
-- In `## Progress`, preserve the existing completed workflow/review bullets and add `- ✓ Project lifecycle complete` if it is not already present
-- In `## Next Milestone`, replace the body with `None. Project complete.`
-
-Do not infer these body mutations from other archived projects. Apply them directly as part of this skill.
+The CLI command owns both the frontmatter completion fields and the canonical markdown body updates for `state.md`.
+It must set `oat_lifecycle: complete`, completion timestamps, `**Status:** Complete`, `**Last Updated:**`, the canonical `## Current Phase` body, normalized `## Progress`, and `## Next Milestone`.
 
 ### Step 6: Clear Active Project Pointer
 

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.32",
+  "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.32"
+    "@open-agent-toolkit/control-plane": "0.0.33"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",