@open-agent-toolkit/cli 0.1.63 → 0.1.65

package/dist/commands/doctor/stale-invocations.js

@@ -0,0 +1,173 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { extname, join } from 'node:path';
+const KNOWN_STALE_INVOCATIONS = [
+    {
+        id: 'global-scope-sync',
+        pattern: /\boat\s+--scope(?:\s+|=)all\s+sync\b/g,
+        replacement: 'oat sync --scope all',
+    },
+];
+const SCANNED_EXTENSIONS = new Set([
+    '.bash',
+    '.cjs',
+    '.fish',
+    '.js',
+    '.json',
+    '.jsonc',
+    '.md',
+    '.mdc',
+    '.mdx',
+    '.mjs',
+    '.mts',
+    '.sh',
+    '.toml',
+    '.ts',
+    '.yaml',
+    '.yml',
+    '.zsh',
+]);
+const EXCLUDED_DIRECTORY_NAMES = new Set([
+    '.git',
+    '.next',
+    '.turbo',
+    'archived',
+    'build',
+    'coverage',
+    'dist',
+    'node_modules',
+    'out',
+]);
+const GENERATED_PROVIDER_ROOTS = new Set([
+    '.claude',
+    '.codex',
+    '.cursor',
+    '.gemini',
+]);
+const GENERATED_GITHUB_DIRECTORIES = new Set([
+    'agents',
+    'instructions',
+    'prompts',
+    'skills',
+]);
+const ALLOW_MARKER = 'oat-doctor: allow-stale-invocation';
+const MAX_FILE_BYTES = 1024 * 1024;
+const MAX_SCANNED_FILES = 10_000;
+const MAX_REPORTED_MATCHES = 50;
+function isExcludedDirectory(parts) {
+    const name = parts.at(-1);
+    if (!name || EXCLUDED_DIRECTORY_NAMES.has(name)) {
+        return true;
+    }
+    if (parts.length === 1 && name === '.worktrees') {
+        return true;
+    }
+    if (GENERATED_PROVIDER_ROOTS.has(name)) {
+        return true;
+    }
+    const parent = parts.at(-2);
+    if (parent === '.oat' && (name === 'projects' || name === 'sync')) {
+        return true;
+    }
+    return parent === '.github' && GENERATED_GITHUB_DIRECTORIES.has(name);
+}
+function isScannableFile(relativePath) {
+    const parts = relativePath.split('/');
+    const fileName = parts.at(-1) ?? '';
+    if (/\.(?:test|spec)\.[^.]+$/.test(fileName)) {
+        return false;
+    }
+    if (fileName === 'copilot-instructions.md' && parts.at(-2) === '.github') {
+        return false;
+    }
+    return SCANNED_EXTENSIONS.has(extname(fileName).toLowerCase());
+}
+async function listScannableFiles(repoRoot) {
+    const files = [];
+    async function walk(parts) {
+        if (files.length >= MAX_SCANNED_FILES) {
+            return;
+        }
+        const entries = await readdir(join(repoRoot, ...parts), {
+            withFileTypes: true,
+        });
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            if (files.length >= MAX_SCANNED_FILES) {
+                break;
+            }
+            if (entry.isSymbolicLink()) {
+                continue;
+            }
+            const childParts = [...parts, entry.name];
+            if (entry.isDirectory()) {
+                if (!isExcludedDirectory(childParts)) {
+                    await walk(childParts);
+                }
+                continue;
+            }
+            const relativePath = childParts.join('/');
+            if (entry.isFile() && isScannableFile(relativePath)) {
+                files.push(relativePath);
+            }
+        }
+    }
+    await walk([]);
+    return files;
+}
+function findMatches(relativePath, content) {
+    const matches = [];
+    const lines = content.split(/\r?\n/);
+    for (const [lineIndex, line] of lines.entries()) {
+        if (line.includes(ALLOW_MARKER)) {
+            continue;
+        }
+        for (const stale of KNOWN_STALE_INVOCATIONS) {
+            stale.pattern.lastIndex = 0;
+            for (const match of line.matchAll(stale.pattern)) {
+                matches.push({
+                    relativePath,
+                    line: lineIndex + 1,
+                    invocation: match[0],
+                    replacement: stale.replacement,
+                });
+            }
+        }
+    }
+    return matches;
+}
+export async function checkStaleInvocations(repoRoot) {
+    const matches = [];
+    for (const relativePath of await listScannableFiles(repoRoot)) {
+        const absolutePath = join(repoRoot, relativePath);
+        const metadata = await stat(absolutePath);
+        if (metadata.size > MAX_FILE_BYTES) {
+            continue;
+        }
+        matches.push(...findMatches(relativePath, await readFile(absolutePath, 'utf8')));
+        if (matches.length >= MAX_REPORTED_MATCHES) {
+            break;
+        }
+    }
+    if (matches.length === 0) {
+        return {
+            name: 'project:stale_invocations',
+            description: 'Known-stale CLI invocation grammar',
+            status: 'pass',
+            message: 'No known-stale CLI invocations found in repository scripts or documentation.',
+        };
+    }
+    const evidence = matches
+        .slice(0, MAX_REPORTED_MATCHES)
+        .map((match) => `${match.relativePath}:${match.line} (\`${match.invocation}\` → \`${match.replacement}\`)`)
+        .join(', ');
+    const replacements = [...new Set(matches.map((match) => match.replacement))];
+    return {
+        name: 'project:stale_invocations',
+        description: 'Known-stale CLI invocation grammar',
+        status: 'warn',
+        message: `Known-stale CLI invocations found: ${evidence}.`,
+        fix: `Update each invocation to the current command grammar: ${replacements
+            .map((replacement) => `\`${replacement}\``)
+            .join(', ')}.`,
+    };
+}

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

@@ -26,6 +26,7 @@ interface ProcessRunOptions {
     livenessIntervalMs?: number;
     onLiveness?: (snapshot: GateLivenessSnapshot) => void;
     purpose: 'host-detection' | 'availability' | 'execute';
+    stdin: 'ignore' | 'inherit';
     stdio: 'ignore' | 'inherit' | 'pipe';
     timeoutMs: number;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/gate/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAQL,KAAK,UAAU,EAIf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,iBAAiB,CAAC;AAWzB,OAAO,EAEL,KAAK,WAAW,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAExB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EACL,sBAAsB,EAIvB,MAAM,kBAAkB,CAAC;AAE1B,UAAU,uBAAuB;IAC/B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,CACV,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC/B,sBAAsB,EAAE,OAAO,sBAAsB,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;IAC9B,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AA6CD,UAAU,iBAAiB;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;IACtD,OAAO,EAAE,gBAAgB,GAAG,cAAc,GAAG,SAAS,CAAC;IACvD,KAAK,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,kBAAkB,GAAG,aAAa,GAAG,cAAc,GAAG,MAAM,CAAC;AAClE,KAAK,qBAAqB,GACtB,kBAAkB,GAClB,4BAA4B,GAC5B,2CAA2C,GAC3C,kBAAkB,CAAC;AAUvB,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,CAAC;IAC/B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAAC;CAC5D;AAED,UAAU,qBAAqB;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,kBAAkB,CAAC;QAC/B,UAAU,EAAE,kBAAkB,CAAC;QAC/B,MAAM,EAAE,WAAW,CAAC;QACpB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACvC,aAAa,EAAE,WAAW,EAAE,CAAC;QAC7B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC9B,sBAAsB,CAAC,EAAE,MAAM,CAAC;KACjC,CAAC;IACF,QAAQ,EAAE;QACR,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,WAAW,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2lCD,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,EAC9C,cAAc,EAAE,MAAM,EACtB,KAAK,EAAE,kBAAkB,EACzB,gBAAgB,CAAC,EAAE,oBAAoB,GACtC,kBAAkB,GAAG,IAAI,CAS3B;AAshDD,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,uBAAuB,CAAM,GAC/C,OAAO,CAwMT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/gate/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/gate/index.js

@@ -54,7 +54,10 @@ const VALID_IDENTITY_PROVENANCES = [
     'inferred',
     'unknown',
 ];
-const REVIEW_GATE_CONTEXT_NOTE = 'This review is gate-originated. If you run `oat-project-review-provide`, set `oat_review_invocation: gate` in the review artifact. Write a canonical review artifact with `### Critical`, `### Important`, `### Medium`, and `### Minor` headings in that order, using `None` for empty sections.';
+const REVIEW_GATE_CONTEXT_NOTE = [
+    'This review is gate-originated. If you run `oat-project-review-provide`, set `oat_review_invocation: gate` in the review artifact. Write a canonical review artifact with `### Critical`, `### Important`, `### Medium`, and `### Minor` headings in that order, using `None` for empty sections.',
+    "Artifact hygiene contract: Before finishing or committing, format every file you created or edited. Use the concrete write/fix formatting command supplied by the governing plan, task, or brief. If none is usable, discover the repository's documented write/fix command from applicable `AGENTS.md`/`CLAUDE.md` instructions and relevant package manifests; do not infer or hardcode a formatter. Prefer a file-scoped invocation when supported, and avoid rewriting unrelated files. If no command is discoverable, warn once with `no format command discovered in repo instructions; skipping`, then continue.",
+].join('\n\n');
 const GATE_CHECK_TIMEOUT_MS = 5_000;
 const GATE_EXEC_TIMEOUT_MS = 15 * 60 * 1_000;
 const GATE_LIVENESS_INTERVAL_MS = 30_000;
@@ -203,7 +206,9 @@ async function runChildProcess(command, args, options) {
         const child = spawn(command, args, {
             cwd: options.cwd,
             env: options.env,
-            stdio: options.stdio === 'pipe' ? ['inherit', 'pipe', 'pipe'] : options.stdio,
+            stdio: options.stdio === 'pipe'
+                ? [options.stdin, 'pipe', 'pipe']
+                : options.stdio,
         });
         const recordActivity = () => {
             lastActivityAt = Date.now();
@@ -811,6 +816,7 @@ async function checkArgv(argv, purpose, context, dependencies) {
             cwd: context.cwd,
             env: dependencies.processEnv,
             purpose,
+            stdin: 'ignore',
             stdio: 'ignore',
             timeoutMs: GATE_CHECK_TIMEOUT_MS,
         });
@@ -895,6 +901,7 @@ async function executeTarget(selected, prompt, context, dependencies) {
                 }
             },
             purpose: 'execute',
+            stdin: 'ignore',
             stdio: 'pipe',
             timeoutMs,
         });

package/dist/commands/project/new/scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,oBAAoB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA2SD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoFhC"}
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/new/scaffold.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,mBAAmB,GAAG,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAC5B,WAAW,GACX,kBAAkB,GAClB,qBAAqB,GACrB,iBAAiB,GACjB,QAAQ,CAAC;AAEb,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,mBAAmB,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,oBAAoB,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA4UD,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAoFhC"}

package/dist/commands/project/new/scaffold.js

@@ -20,6 +20,7 @@ const TEMPLATES_BY_MODE = {
     quick: ['state.md', 'discovery.md', 'plan.md', 'implementation.md'],
     import: ['state.md', 'plan.md', 'implementation.md'],
 };
+const OAT_PLACEHOLDER_PATTERN = /(?<!\{)\{\s*(OAT_[A-Z0-9_]+)\s*\}(?!\})/g;
 const STATE_TEMPLATE_BY_MODE = {
     'spec-driven': {
         hillCheckpoints: "['discovery', 'design']",
@@ -79,6 +80,17 @@ const STATE_TEMPLATE_BY_MODE = {
         nextMilestone: 'Run `oat-project-import-plan` to normalize the external plan',
     },
 };
+function replaceOatPlaceholders(template, replacements) {
+    return template.replace(OAT_PLACEHOLDER_PATTERN, (placeholder, token) => replacements[token] ?? placeholder);
+}
+function assertNoUnresolvedOatPlaceholders(rendered, templateFile) {
+    const unresolved = [
+        ...new Set([...rendered.matchAll(OAT_PLACEHOLDER_PATTERN)].map(([placeholder]) => placeholder)),
+    ];
+    if (unresolved.length > 0) {
+        throw new Error(`Cannot scaffold ${templateFile}: unresolved OAT placeholder(s): ${unresolved.join(', ')}`);
+    }
+}
 function validateProjectName(name) {
     if (name.startsWith('-')) {
         throw new Error(`Invalid project name "${name}". Project names must not start with a dash.`);
@@ -89,17 +101,19 @@ function validateProjectName(name) {
 }
 function applyTemplateReplacements(template, projectName, today, nowUtc, mode) {
     const stateContent = STATE_TEMPLATE_BY_MODE[mode];
-    return template
+    const oatReplacements = {
+        OAT_HILL_CHECKPOINTS: stateContent.hillCheckpoints,
+        OAT_WORKFLOW_MODE: mode,
+        OAT_PHASE: stateContent.phase,
+        OAT_STATUS: stateContent.status,
+        OAT_CURRENT_PHASE: stateContent.currentPhase,
+        OAT_ARTIFACTS: stateContent.artifacts.join('\n'),
+        OAT_PROGRESS: stateContent.progress.join('\n'),
+        OAT_NEXT_MILESTONE: stateContent.nextMilestone,
+    };
+    return replaceOatPlaceholders(template, oatReplacements)
         .replaceAll('{Project Name}', projectName)
         .replaceAll('YYYY-MM-DD', today)
-        .replaceAll('{OAT_HILL_CHECKPOINTS}', stateContent.hillCheckpoints)
-        .replaceAll('{OAT_WORKFLOW_MODE}', mode)
-        .replaceAll('{OAT_PHASE}', stateContent.phase)
-        .replaceAll('{OAT_STATUS}', stateContent.status)
-        .replaceAll('{OAT_CURRENT_PHASE}', stateContent.currentPhase)
-        .replaceAll('{OAT_ARTIFACTS}', stateContent.artifacts.join('\n'))
-        .replaceAll('{OAT_PROGRESS}', stateContent.progress.join('\n'))
-        .replaceAll('{OAT_NEXT_MILESTONE}', stateContent.nextMilestone)
         .replaceAll(/oat_project_created:\s*null/gi, `oat_project_created: "${nowUtc}"`)
         .replaceAll(/oat_project_state_updated:\s*null/gi, `oat_project_state_updated: "${nowUtc}"`)
         .replaceAll(/\n?oat_template:\s*true\s*\n/gi, '\n')
@@ -176,6 +190,7 @@ async function scaffoldModeTemplates(userOatRoot, repoRoot, projectPath, project
         }
         const template = await readFile(src, 'utf8');
         const rendered = applyTemplateReplacements(template, projectName, today, nowUtc, mode);
+        assertNoUnresolvedOatPlaceholders(rendered, templateFile);
         if (templateFile === 'state.md') {
             assertValidProjectStateContent(rendered, { filePath: dest });
         }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/update/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AAgBxB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GAClD,MAAM,EAAE,CAaV;AAgCD,wBAAgB,wBAAwB,CACtC,YAAY,GAAE,uBAA6C,EAC3D,gBAAgB,GAAE,oBAA8C,GAC/D,OAAO,CAoKT;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAI7E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAOT;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAMR"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/update/index.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAKvE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAE7B,MAAM,gBAAgB,CAAC;AAgBxB,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAA;CAAE,GAClD,MAAM,EAAE,CAaV;AAgCD,wBAAgB,wBAAwB,CACtC,YAAY,GAAE,uBAA6C,EAC3D,gBAAgB,GAAE,oBAA8C,GAC/D,OAAO,CAqKT;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAI7E;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,YAAY,GACnB,OAAO,CAOT;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,OAAO,GACd,MAAM,CAMR"}

package/dist/commands/tools/update/index.js

@@ -79,12 +79,13 @@ export function createToolsUpdateCommand(dependencies = defaultDependencies, syn
         const globalOptions = readGlobalOptions(command);
         const context = buildCommandContext(globalOptions);
         const { logger } = context;
-        const target = resolveTarget(name, opts.pack, opts.all);
-        if (!target) {
-            logger.error('Specify a tool name, --pack <pack>, or --all.');
+        const targetResolution = resolveTarget(name, opts.pack, opts.all);
+        if ('error' in targetResolution) {
+            logger.error(targetResolution.error);
             process.exitCode = 1;
             return;
         }
+        const target = targetResolution.target;
         const scopes = resolveConcreteScopes(context.scope);
         const dryRun = opts.dryRun ?? false;
         const result = await updateTools(target, scopes, context.cwd, context.home, dryRun, dependencies);
@@ -200,18 +201,27 @@ export function formatUpdatedToolMessage(tool, dryRun) {
 }
 function resolveTarget(name, pack, all) {
     const specified = [name, pack, all].filter(Boolean).length;
-    if (specified !== 1)
-        return null;
+    if (specified === 0) {
+        return {
+            error: 'Specify a tool name, --pack <pack>, or --all. To update all tools, run: oat tools update --all',
+        };
+    }
+    if (specified > 1) {
+        return {
+            error: 'Specify exactly one update target: a tool name, --pack <pack>, or --all.',
+        };
+    }
     if (name)
-        return { kind: 'name', name };
+        return { target: { kind: 'name', name } };
     if (pack) {
-        if (!VALID_PACKS.includes(pack))
-            return null;
-        return { kind: 'pack', pack: pack };
+        if (!VALID_PACKS.includes(pack)) {
+            return {
+                error: `Invalid pack '${pack}'. Expected one of: ${VALID_PACKS.join(', ')}.`,
+            };
+        }
+        return { target: { kind: 'pack', pack: pack } };
     }
-    if (all)
-        return { kind: 'all' };
-    return null;
+    return { target: { kind: 'all' } };
 }
 function describeTarget(target) {
     switch (target.kind) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-agent-toolkit/cli",
-  "version": "0.1.63",
+  "version": "0.1.65",
   "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.63"
+    "@open-agent-toolkit/control-plane": "0.1.65"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",