@open-agent-toolkit/cli 0.0.42 → 0.0.50

package/dist/commands/docs/init/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAIL,KAAK,uBAAuB,EAK7B,MAAM,mBAAmB,CAAC;AAa3B,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAC9E,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,WAAW,EAAE,CACX,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAiDD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAc7E;AA8GD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,OAAO,CAsCT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAGL,KAAK,aAAa,EAClB,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAC;AAE5C,OAAO,EAIL,KAAK,uBAAuB,EAK7B,MAAM,mBAAmB,CAAC;AAkB3B,UAAU,oBAAoB;IAC5B,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,eAAe,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAC9E,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,WAAW,EAAE,CACX,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,uBAAuB,EAChC,UAAU,EAAE,MAAM,KACf,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,qBAAqB,EAAE,CACrB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAClC,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAyGD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAc7E;AA+GD,wBAAgB,qBAAqB,CACnC,SAAS,GAAE,OAAO,CAAC,oBAAoB,CAAM,GAC5C,OAAO,CAuCT"}

package/dist/commands/docs/init/index.js

@@ -6,7 +6,43 @@ import { readOatConfig, writeOatConfig, } from '../../../config/oat-config.js';
 import { resolveAssetsRoot } from '../../../fs/assets.js';
 import { Command, Option } from 'commander';
 import { DEFAULT_DOCS_REPO_SHAPE_DEPENDENCIES, detectDocsRepoShape, getDefaultDocsAppName, resolveDocsInitOptions, } from './resolve-options.js';
+import { patchRootPackageJson, } from './root-package.js';
 import { scaffoldDocsApp } from './scaffold.js';
+function logRootPackagePatch(context, result) {
+    if (result.status === 'disabled') {
+        context.logger.info('Skipped root package.json patch (--no-root-patch).');
+        return;
+    }
+    if (result.diff) {
+        context.logger.info('');
+        context.logger.info('Root package.json diff:');
+        context.logger.info(result.diff);
+    }
+    if (result.status === 'applied') {
+        context.logger.info('Updated the root Turbo build scripts to exclude the docs app from the default build and added `build:docs`.');
+    }
+    else if (result.status === 'dry-run') {
+        context.logger.info('Dry run: the root Turbo build script patch was previewed but not written.');
+        context.logger.info('Run without --dry-run to apply these changes.');
+    }
+    else if (result.status === 'already-configured') {
+        context.logger.info('Root package.json already excludes the docs app from the default Turbo build and exposes `build:docs`.');
+    }
+    else if (result.status === 'skipped') {
+        for (const warning of result.warnings) {
+            context.logger.warn(warning);
+        }
+        if (result.manualSnippet) {
+            context.logger.info('');
+            context.logger.info('Recommended manual Turbo script snippet for the repo root:');
+            context.logger.info(result.manualSnippet);
+        }
+        return;
+    }
+    for (const warning of result.warnings) {
+        context.logger.warn(warning);
+    }
+}
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
     resolveAssetsRoot,
@@ -18,6 +54,12 @@ const DEFAULT_DEPENDENCIES = {
             assetsRoot,
             ...options,
         });
+        const rootPackagePatch = await patchRootPackageJson({
+            repoRoot: context.cwd,
+            appName: options.appName,
+            dryRun: context.dryRun,
+            enabled: options.rootPatch,
+        });
         const config = await readOatConfig(context.cwd);
         config.documentation = {
             ...config.documentation,
@@ -30,6 +72,7 @@ const DEFAULT_DEPENDENCIES = {
                 ...options,
                 createdFiles: result.createdFiles,
                 appRoot: result.appRoot,
+                rootPackagePatch,
             });
             return;
         }
@@ -39,6 +82,7 @@ const DEFAULT_DEPENDENCIES = {
         context.logger.info(`  App name: ${options.appName}`);
         context.logger.info(`  Lint: ${options.lint}`);
         context.logger.info(`  Format: ${options.format}`);
+        logRootPackagePatch(context, rootPackagePatch);
     },
     upsertAgentsMdSection,
     readOatConfig,
@@ -75,6 +119,7 @@ async function runDocsInitCommand(context, options, dependencies) {
             providedSiteDescription: options.description,
             providedLint: options.lint,
             providedFormat: options.format,
+            providedRootPatch: options.rootPatch,
             inputWithDefault: dependencies.inputWithDefault,
             selectWithAbort: dependencies.selectWithAbort,
         });
@@ -170,6 +215,7 @@ export function createDocsInitCommand(overrides = {}) {
         'oxfmt',
         'none',
     ]))
+        .option('--no-root-patch', 'Skip patching the consumer root package.json')
         .option('--yes', 'Accept defaults without prompting')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));

package/dist/commands/docs/init/resolve-options.d.ts

@@ -12,6 +12,7 @@ export interface DocsInitResolvedOptions {
     siteDescription: string;
     lint: DocsLintMode;
     format: DocsFormatMode;
+    rootPatch: boolean;
 }
 export interface ResolveDocsInitOptionsInput {
     repoRoot: string;
@@ -24,6 +25,7 @@ export interface ResolveDocsInitOptionsInput {
     providedSiteDescription?: string;
     providedLint?: DocsLintMode;
     providedFormat?: DocsFormatMode;
+    providedRootPatch?: boolean;
     inputWithDefault: (message: string, defaultValue: string, ctx: PromptContext) => Promise<string | null>;
     selectWithAbort: <T extends string>(message: string, choices: SelectChoice<T>[], ctx: PromptContext) => Promise<T | null>;
 }

package/dist/commands/docs/init/resolve-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-options.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/resolve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACb,MAAM,iCAAiC,CAAC;AAGzC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,mBAAmB,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAiBD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,GACvB,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAoBD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CA+EzC;AAED,eAAO,MAAM,oCAAoC,EAAE,yBAOlD,CAAC"}
+{"version":3,"file":"resolve-options.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/resolve-options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACb,MAAM,iCAAiC,CAAC;AAGzC,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,mBAAmB,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,SAAS,EAAE,aAAa,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,aAAa,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CACvE;AAiBD,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,aAAa,GACvB,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,CAMR;AAoBD,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,yBAAyB,GACtC,OAAO,CAAC,aAAa,CAAC,CAqBxB;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAE/D;AAED,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAgFzC;AAED,eAAO,MAAM,oCAAoC,EAAE,yBAOlD,CAAC"}

package/dist/commands/docs/init/resolve-options.js

@@ -109,6 +109,7 @@ export async function resolveDocsInitOptions(input) {
         siteDescription,
         lint,
         format,
+        rootPatch: input.providedRootPatch ?? true,
     };
 }
 export const DEFAULT_DOCS_REPO_SHAPE_DEPENDENCIES = {

package/dist/commands/docs/init/root-package.d.ts

@@ -0,0 +1,23 @@
+type RootPackagePatchReason = 'missing-package-json' | 'no-build-script' | 'non-turbo-build-script' | 'ambiguous-shell-build-script' | 'existing-filter-flags' | 'existing-build-docs-script' | 'disabled';
+type RootPackagePatchStatus = 'applied' | 'dry-run' | 'skipped' | 'disabled' | 'already-configured';
+export interface RootPackagePatchResult {
+    status: RootPackagePatchStatus;
+    reason?: RootPackagePatchReason;
+    packageJsonPath: string;
+    diff?: string;
+    manualSnippet?: string;
+    warnings: string[];
+}
+interface RootPackagePatchDependencies {
+    readFile: (path: string, encoding: BufferEncoding) => Promise<string>;
+    writeFile: (path: string, content: string, encoding: BufferEncoding) => Promise<void>;
+}
+interface RootPackagePatchOptions {
+    repoRoot: string;
+    appName: string;
+    dryRun: boolean;
+    enabled: boolean;
+}
+export declare function patchRootPackageJson(options: RootPackagePatchOptions, dependencies?: RootPackagePatchDependencies): Promise<RootPackagePatchResult>;
+export {};
+//# sourceMappingURL=root-package.d.ts.map

package/dist/commands/docs/init/root-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"root-package.d.ts","sourceRoot":"","sources":["../../../../src/commands/docs/init/root-package.ts"],"names":[],"mappings":"AAMA,KAAK,sBAAsB,GACvB,sBAAsB,GACtB,iBAAiB,GACjB,wBAAwB,GACxB,8BAA8B,GAC9B,uBAAuB,GACvB,4BAA4B,GAC5B,UAAU,CAAC;AAEf,KAAK,sBAAsB,GACvB,SAAS,GACT,SAAS,GACT,SAAS,GACT,UAAU,GACV,oBAAoB,CAAC;AAMzB,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,UAAU,4BAA4B;IACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtE,SAAS,EAAE,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,cAAc,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsKD,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,uBAAuB,EAChC,YAAY,GAAE,4BAAmD,GAChE,OAAO,CAAC,sBAAsB,CAAC,CA8IjC"}

package/dist/commands/docs/init/root-package.js

@@ -0,0 +1,226 @@
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+const DEFAULT_BUILD_SCRIPT = 'turbo run build';
+const ROOT_PACKAGE_PATH = 'package.json';
+const DEFAULT_DEPENDENCIES = {
+    readFile,
+    writeFile,
+};
+function runsTurboBuild(script) {
+    return /^turbo\s+(?:run\s+)?build(?:\s+.*)?$/.test(script.trim());
+}
+function hasShellComposition(script) {
+    return /&&|\|\||[;|`]|[$][(]/.test(script);
+}
+function removeFilterFlags(script) {
+    return script
+        .replace(/\s+--filter(?:=|\s+)(?:"[^"]*"|'[^']*'|\S+)/g, '')
+        .trim();
+}
+function getFilterFlags(script) {
+    return Array.from(script.matchAll(/\s+(--filter(?:=|\s+)(?:"[^"]*"|'[^']*'|\S+))/g), (match) => match[1]);
+}
+function buildExcludeFilter(appName) {
+    return `--filter='!${appName}'`;
+}
+function buildIncludeFilter(appName) {
+    return `--filter=${appName}...`;
+}
+function buildManualSnippet(appName, baseBuildScript) {
+    const buildScript = baseBuildScript?.trim() || DEFAULT_BUILD_SCRIPT;
+    return [
+        '"scripts": {',
+        `  "build": "${buildScript} ${buildExcludeFilter(appName)}",`,
+        `  "build:docs": "${buildScript} ${buildIncludeFilter(appName)}"`,
+        '}',
+    ].join('\n');
+}
+function inferIndentation(content) {
+    const match = /\n([ \t]+)"/.exec(content);
+    return match?.[1] ?? '  ';
+}
+function formatJsonWithOriginalStyle(original, value) {
+    const indentation = inferIndentation(original);
+    const trailingNewline = original.endsWith('\n') ? '\n' : '';
+    return `${JSON.stringify(value, null, indentation)}${trailingNewline}`;
+}
+function splitLines(content) {
+    const trimmed = content.endsWith('\n') ? content.slice(0, -1) : content;
+    return trimmed.length > 0 ? trimmed.split('\n') : [];
+}
+function buildDiffOperations(beforeLines, afterLines) {
+    const lengths = Array.from({ length: beforeLines.length + 1 }, () => Array(afterLines.length + 1).fill(0));
+    for (let beforeIndex = beforeLines.length - 1; beforeIndex >= 0; beforeIndex -= 1) {
+        for (let afterIndex = afterLines.length - 1; afterIndex >= 0; afterIndex -= 1) {
+            lengths[beforeIndex][afterIndex] =
+                beforeLines[beforeIndex] === afterLines[afterIndex]
+                    ? lengths[beforeIndex + 1][afterIndex + 1] + 1
+                    : Math.max(lengths[beforeIndex + 1][afterIndex], lengths[beforeIndex][afterIndex + 1]);
+        }
+    }
+    const operations = [];
+    let beforeIndex = 0;
+    let afterIndex = 0;
+    while (beforeIndex < beforeLines.length && afterIndex < afterLines.length) {
+        if (beforeLines[beforeIndex] === afterLines[afterIndex]) {
+            operations.push({ type: 'context', line: beforeLines[beforeIndex] });
+            beforeIndex += 1;
+            afterIndex += 1;
+            continue;
+        }
+        if (lengths[beforeIndex + 1][afterIndex] >=
+            lengths[beforeIndex][afterIndex + 1]) {
+            operations.push({ type: 'remove', line: beforeLines[beforeIndex] });
+            beforeIndex += 1;
+            continue;
+        }
+        operations.push({ type: 'add', line: afterLines[afterIndex] });
+        afterIndex += 1;
+    }
+    while (beforeIndex < beforeLines.length) {
+        operations.push({ type: 'remove', line: beforeLines[beforeIndex] });
+        beforeIndex += 1;
+    }
+    while (afterIndex < afterLines.length) {
+        operations.push({ type: 'add', line: afterLines[afterIndex] });
+        afterIndex += 1;
+    }
+    return operations;
+}
+function createUnifiedDiff(filePath, before, after) {
+    if (before === after) {
+        return '';
+    }
+    const beforeLines = splitLines(before);
+    const afterLines = splitLines(after);
+    const operations = buildDiffOperations(beforeLines, afterLines);
+    return [
+        `--- ${filePath}`,
+        `+++ ${filePath}`,
+        `@@ -1,${beforeLines.length} +1,${afterLines.length} @@`,
+        ...operations.map((operation) => {
+            const prefix = operation.type === 'context'
+                ? ' '
+                : operation.type === 'remove'
+                    ? '-'
+                    : '+';
+            return `${prefix}${operation.line}`;
+        }),
+    ].join('\n');
+}
+export async function patchRootPackageJson(options, dependencies = DEFAULT_DEPENDENCIES) {
+    const packageJsonPath = join(options.repoRoot, ROOT_PACKAGE_PATH);
+    if (!options.enabled) {
+        return {
+            status: 'disabled',
+            reason: 'disabled',
+            packageJsonPath,
+            warnings: [],
+        };
+    }
+    let originalContent;
+    try {
+        originalContent = await dependencies.readFile(packageJsonPath, 'utf8');
+    }
+    catch {
+        return {
+            status: 'skipped',
+            reason: 'missing-package-json',
+            packageJsonPath,
+            manualSnippet: buildManualSnippet(options.appName),
+            warnings: [
+                'Skipped root package.json patch: root package.json was not found.',
+            ],
+        };
+    }
+    const parsed = JSON.parse(originalContent);
+    const currentScripts = parsed.scripts ?? {};
+    const currentBuildScript = currentScripts.build;
+    if (!currentBuildScript) {
+        return {
+            status: 'skipped',
+            reason: 'no-build-script',
+            packageJsonPath,
+            manualSnippet: buildManualSnippet(options.appName),
+            warnings: [
+                'Skipped root package.json patch: scripts.build is missing, so there was no Turbo build command to update.',
+            ],
+        };
+    }
+    if (!runsTurboBuild(currentBuildScript)) {
+        return {
+            status: 'skipped',
+            reason: 'non-turbo-build-script',
+            packageJsonPath,
+            manualSnippet: buildManualSnippet(options.appName),
+            warnings: [
+                'Skipped root package.json patch: scripts.build does not run a Turbo build command, so OAT left it unchanged.',
+            ],
+        };
+    }
+    if (hasShellComposition(currentBuildScript)) {
+        return {
+            status: 'skipped',
+            reason: 'ambiguous-shell-build-script',
+            packageJsonPath,
+            manualSnippet: buildManualSnippet(options.appName),
+            warnings: [
+                'Skipped root package.json patch: scripts.build wraps the Turbo build in a larger shell expression, so OAT left it unchanged rather than rewriting the full command.',
+            ],
+        };
+    }
+    const excludeFilter = buildExcludeFilter(options.appName);
+    const filterFlags = getFilterFlags(currentBuildScript);
+    const hasUserAuthoredFilters = filterFlags.some((flag) => flag !== excludeFilter);
+    if (hasUserAuthoredFilters) {
+        return {
+            status: 'skipped',
+            reason: 'existing-filter-flags',
+            packageJsonPath,
+            manualSnippet: buildManualSnippet(options.appName, removeFilterFlags(currentBuildScript)),
+            warnings: [
+                'Skipped root package.json patch: scripts.build already uses `--filter`, so OAT left it unchanged rather than guessing how to merge filter semantics.',
+            ],
+        };
+    }
+    const nextScripts = { ...currentScripts };
+    const nextBuildScript = currentBuildScript.includes(excludeFilter)
+        ? currentBuildScript
+        : `${currentBuildScript.trim()} ${excludeFilter}`;
+    nextScripts.build = nextBuildScript;
+    const baseBuildScript = removeFilterFlags(currentBuildScript);
+    const desiredBuildDocsScript = `${baseBuildScript} ${buildIncludeFilter(options.appName)}`;
+    const warnings = [];
+    if (nextScripts['build:docs'] &&
+        nextScripts['build:docs'] !== desiredBuildDocsScript) {
+        warnings.push('Left scripts["build:docs"] unchanged because the root package already defines a different value.');
+    }
+    else {
+        nextScripts['build:docs'] = desiredBuildDocsScript;
+    }
+    const nextContent = formatJsonWithOriginalStyle(originalContent, {
+        ...parsed,
+        scripts: nextScripts,
+    });
+    const diff = createUnifiedDiff(ROOT_PACKAGE_PATH, originalContent, nextContent);
+    if (!diff) {
+        return {
+            status: 'already-configured',
+            packageJsonPath,
+            warnings,
+        };
+    }
+    if (!options.dryRun) {
+        await dependencies.writeFile(packageJsonPath, nextContent, 'utf8');
+    }
+    return {
+        status: options.dryRun ? 'dry-run' : 'applied',
+        reason: warnings.length > 0 ? 'existing-build-docs-script' : undefined,
+        packageJsonPath,
+        diff,
+        manualSnippet: warnings.length > 0
+            ? buildManualSnippet(options.appName, baseBuildScript)
+            : undefined,
+        warnings,
+    };
+}

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

@@ -349,7 +349,7 @@ export function buildToolPacksSectionBody(packs) {
         lines.push(`- **${pack}** — ${PACK_DESCRIPTIONS[pack]}${suffix}`);
     }
     if (hasWorkflows) {
-        lines.push('', '### Workflow Execution Continuation', '', '- This guidance applies only to OAT project lifecycle execution, such as `oat-project-implement`, `oat-project-subagent-implement`, and OAT project review/receive flows. It does not apply to non-OAT tasks or ad-hoc work outside the OAT project workflow.', '- When executing an OAT project implementation or OAT project review workflow, do not stop at task boundaries, phase boundaries, or other clean checkpoints unless the configured HiLL checkpoint has been reached, a real blocker exists, or explicit user input is required.', '- Status summaries, completed bookkeeping, and "clean boundary" pauses are not valid stop reasons. After updating tracking artifacts, continue execution until an allowed stop condition applies.');
+        lines.push('', '### Workflow Execution Continuation', '', '- This guidance applies only to OAT project lifecycle execution, such as `oat-project-implement`, and OAT project review/receive flows. It does not apply to non-OAT tasks or ad-hoc work outside the OAT project workflow.', '- When executing an OAT project implementation or OAT project review workflow, do not stop at task boundaries, phase boundaries, or other clean checkpoints unless the configured HiLL checkpoint has been reached, a real blocker exists, or explicit user input is required.', '- Status summaries, completed bookkeeping, and "clean boundary" pauses are not valid stop reasons. After updating tracking artifacts, continue execution until an allowed stop condition applies.');
     }
     return lines.join('\n');
 }

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

@@ -5,8 +5,8 @@
  * `bundle-assets.sh` maintains its own bash array — `bundle-consistency.test.ts`
  * validates that it stays in sync with these lists.
  */
-export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-subagent-implement", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
-export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-reviewer.md"];
+export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
+export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
 export declare const WORKFLOW_SCRIPTS: readonly ["generate-oat-state.sh", "generate-thin-index.sh", "resolve-tracking.sh"];
 export declare const IDEA_SKILLS: readonly ["oat-idea-new", "oat-idea-ideate", "oat-idea-summarize", "oat-idea-scratchpad"];

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;AAIH,eAAO,MAAM,eAAe,qwBA+BlB,CAAC;AAEX,eAAO,MAAM,eAAe,wDAGlB,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,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,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;AAIH,eAAO,MAAM,eAAe,muBA8BlB,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,yIAMd,CAAC;AAEX,eAAO,MAAM,YAAY,kCAAmC,CAAC;AAI7D,eAAO,MAAM,cAAc,gJAMjB,CAAC;AAIX,eAAO,MAAM,yBAAyB,kGAI5B,CAAC;AAEX,eAAO,MAAM,4BAA4B,4CAG/B,CAAC;AAEX,eAAO,MAAM,0BAA0B,aAAc,CAAC;AAItD,eAAO,MAAM,eAAe,2EAMlB,CAAC;AAEX,eAAO,MAAM,eAAe,qCAAsC,CAAC"}

package/dist/commands/init/tools/shared/skill-manifest.js

@@ -31,7 +31,6 @@ export const WORKFLOW_SKILLS = [
     'oat-project-review-receive',
     'oat-project-review-receive-remote',
     'oat-project-spec',
-    'oat-project-subagent-implement',
     'oat-project-summary',
     'oat-repo-knowledge-index',
     'oat-worktree-bootstrap',
@@ -40,6 +39,7 @@ export const WORKFLOW_SKILLS = [
 ];
 export const WORKFLOW_AGENTS = [
     'oat-codebase-mapper.md',
+    'oat-phase-implementer.md',
     'oat-reviewer.md',
 ];
 export const WORKFLOW_TEMPLATES = [

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;AAWpC,wBAAgB,oBAAoB,IAAI,OAAO,CAW9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,oBAAoB,IAAI,OAAO,CAY9C"}

package/dist/commands/project/index.js

@@ -7,6 +7,7 @@ import { createProjectOpenCommand } from './open/index.js';
 import { createProjectPauseCommand } from './pause/index.js';
 import { createProjectSetModeCommand } from './set-mode/index.js';
 import { createProjectStatusCommand } from './status.js';
+import { createProjectValidatePlanCommand } from './validate-plan/index.js';
 export function createProjectCommand() {
     return new Command('project')
         .description('Manage OAT project workflows')
@@ -17,5 +18,6 @@ export function createProjectCommand() {
         .addCommand(createProjectOpenCommand())
         .addCommand(createProjectPauseCommand())
         .addCommand(createProjectSetModeCommand())
-        .addCommand(createProjectStatusCommand());
+        .addCommand(createProjectStatusCommand())
+        .addCommand(createProjectValidatePlanCommand());
 }

package/dist/commands/project/set-mode/index.d.ts

@@ -1,13 +1,7 @@
-import { readFile as defaultReadFile, writeFile as defaultWriteFile } from 'node:fs/promises';
 import { buildCommandContext, type CommandContext } from '../../../app/command-context.js';
 import { Command } from 'commander';
-export type ExecutionMode = 'single-thread' | 'subagent-driven';
 interface SetModeDependencies {
     buildCommandContext: (options: Parameters<typeof buildCommandContext>[0]) => CommandContext;
-    resolveProjectRoot: (cwd: string) => Promise<string>;
-    readFile: typeof defaultReadFile;
-    writeFile: typeof defaultWriteFile;
-    now: () => Date;
 }
 export declare function createProjectSetModeCommand(overrides?: Partial<SetModeDependencies>): Command;
 export {};

package/dist/commands/project/set-mode/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/set-mode/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;AAYhF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,eAAe,GAAG,iBAAiB,CAAC;AAEhE,UAAU,mBAAmB;IAC3B,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,GAAG,EAAE,MAAM,IAAI,CAAC;CACjB;AAwID,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAeT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/set-mode/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEhF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,UAAU,mBAAmB;IAC3B,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;CACrB;AA+BD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAC3C,OAAO,CAeT"}

package/dist/commands/project/set-mode/index.js

@@ -1,104 +1,24 @@
-import { readFile as defaultReadFile, writeFile as defaultWriteFile, } from 'node:fs/promises';
-import { join } from 'node:path';
 import { buildCommandContext } from '../../../app/command-context.js';
-import { getFrontmatterBlock, getFrontmatterField, } from '../../shared/frontmatter.js';
-import { replaceFrontmatter, upsertFrontmatterField, } from '../../shared/frontmatter-write.js';
 import { readGlobalOptions } from '../../shared/shared.utils.js';
-import { readOatLocalConfig } from '../../../config/oat-config.js';
-import { resolveProjectRoot } from '../../../fs/paths.js';
 import { Command } from 'commander';
-const ORCHESTRATION_DEFAULTS = [
-    { field: 'oat_orchestration_merge_strategy', value: 'merge' },
-    { field: 'oat_orchestration_retry_limit', value: '2' },
-    { field: 'oat_orchestration_baseline_policy', value: 'strict' },
-    { field: 'oat_orchestration_unit_granularity', value: 'phase' },
-];
 const DEFAULT_DEPENDENCIES = {
     buildCommandContext,
-    resolveProjectRoot,
-    readFile: defaultReadFile,
-    writeFile: defaultWriteFile,
-    now: () => new Date(),
 };
-function isExecutionMode(value) {
-    return value === 'single-thread' || value === 'subagent-driven';
-}
-async function runSetMode(modeArg, context, dependencies) {
-    try {
-        if (!isExecutionMode(modeArg)) {
-            throw new Error(`Invalid mode: ${modeArg}. Expected one of: single-thread, subagent-driven.`);
-        }
-        const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
-        const localConfig = await readOatLocalConfig(repoRoot);
-        const activeProject = localConfig.activeProject?.trim();
-        if (!activeProject) {
-            throw new Error('No active project found (.oat/config.local.json has no activeProject).');
-        }
-        const activeProjectPath = join(repoRoot, activeProject);
-        const statePath = join(activeProjectPath, 'state.md');
-        let stateContent;
-        try {
-            stateContent = await dependencies.readFile(statePath, 'utf8');
-        }
-        catch {
-            throw new Error(`Active project state.md not found: ${statePath}`);
-        }
-        const frontmatterBlock = getFrontmatterBlock(stateContent);
-        if (!frontmatterBlock) {
-            throw new Error(`state.md is missing frontmatter: ${statePath}`);
-        }
-        const previousMode = getFrontmatterField(frontmatterBlock, 'oat_execution_mode');
-        let currentBlock = frontmatterBlock;
-        const modeUpdate = upsertFrontmatterField(currentBlock, 'oat_execution_mode', modeArg, true);
-        currentBlock = modeUpdate.nextBlock;
-        const defaultsAdded = [];
-        if (modeArg === 'subagent-driven') {
-            for (const entry of ORCHESTRATION_DEFAULTS) {
-                const update = upsertFrontmatterField(currentBlock, entry.field, entry.value, false);
-                currentBlock = update.nextBlock;
-                if (update.added) {
-                    defaultsAdded.push(entry.field);
-                }
-            }
-        }
-        currentBlock = upsertFrontmatterField(currentBlock, 'oat_project_state_updated', dependencies.now().toISOString(), true).nextBlock;
-        const updatedState = replaceFrontmatter(stateContent, currentBlock);
-        await dependencies.writeFile(statePath, updatedState, 'utf8');
-        if (context.json) {
-            context.logger.json({
-                status: 'ok',
-                mode: modeArg,
-                previousMode: previousMode || null,
-                statePath,
-                projectPath: activeProjectPath,
-                defaultsAdded,
-            });
-        }
-        else {
-            context.logger.info(`Set execution mode to ${modeArg}`);
-            context.logger.info(`Project: ${activeProjectPath}`);
-            context.logger.info(`State: ${statePath}`);
-            if (modeArg === 'subagent-driven') {
-                if (defaultsAdded.length > 0) {
-                    context.logger.info(`Added orchestration defaults: ${defaultsAdded.join(', ')}`);
-                }
-                else {
-                    context.logger.info('Orchestration defaults already present; no defaults added.');
-                }
-            }
-        }
+const DEPRECATION_MESSAGE = 'Execution mode is no longer user-selectable; oat-project-implement is the single execution skill. No changes were made. This command will be removed in a future release.';
+async function runSetMode(_modeArg, context) {
+    if (context.json) {
+        context.logger.json({
+            status: 'deprecated',
+            command: 'oat project set-mode',
+            message: DEPRECATION_MESSAGE,
+            noop: true,
+        });
         process.exitCode = 0;
+        return;
     }
-    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 = 1;
-    }
+    context.logger.warn("[deprecated] 'oat project set-mode' is a no-op.\n" +
+        `${DEPRECATION_MESSAGE}`);
+    process.exitCode = 0;
 }
 export function createProjectSetModeCommand(overrides = {}) {
     const dependencies = {
@@ -106,10 +26,10 @@ export function createProjectSetModeCommand(overrides = {}) {
         ...overrides,
     };
     return new Command('set-mode')
-        .description('Set project implementation execution mode')
-        .argument('<mode>', 'Execution mode: single-thread or subagent-driven')
+        .description('[deprecated] No-op. Execution mode is no longer selectable.')
+        .argument('<mode>', 'Ignored. Execution mode is no longer selectable.')
         .action(async (mode, _options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
-        await runSetMode(mode, context, dependencies);
+        await runSetMode(mode, context);
     });
 }

package/dist/commands/project/validate-plan/index.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function createProjectValidatePlanCommand(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/project/validate-plan/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/project/validate-plan/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,gCAAgC,IAAI,OAAO,CAgD1D"}