@open-agent-toolkit/cli 0.0.10

package/dist/commands/init/tools/core/install-core.d.ts

@@ -0,0 +1,30 @@
+import { CORE_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { CORE_SKILLS };
+export interface InstallCoreDependencies {
+    copyDirWithVersionCheck: (source: string, destination: string, force: boolean) => Promise<{
+        status: string;
+        installedVersion?: string | null;
+        bundledVersion?: string | null;
+    }>;
+    copyDirWithStatus: (source: string, destination: string, force: boolean) => Promise<'copied' | 'updated' | 'skipped'>;
+    dirExists: (path: string) => Promise<boolean>;
+}
+export interface InstallCoreOptions {
+    assetsRoot: string;
+    targetRoot: string;
+    force?: boolean;
+    dependencies?: InstallCoreDependencies;
+}
+export interface InstallCoreResult {
+    copiedSkills: string[];
+    updatedSkills: string[];
+    skippedSkills: string[];
+    outdatedSkills: Array<{
+        name: string;
+        installed: string | null;
+        bundled: string | null;
+    }>;
+    docsStatus: 'copied' | 'updated' | 'skipped';
+}
+export declare function installCore(options: InstallCoreOptions): Promise<InstallCoreResult>;
+//# sourceMappingURL=install-core.d.ts.map

package/dist/commands/init/tools/core/install-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-core.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/core/install-core.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAGzE,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,MAAM,WAAW,uBAAuB;IACtC,uBAAuB,EAAE,CACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,KACX,OAAO,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC,CAAC;IACH,iBAAiB,EAAE,CACjB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,KACX,OAAO,CAAC,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/C,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C;AAQD,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,uBAAuB,CAAC;CACxC;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IACH,UAAU,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;CAC9C;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAkD5B"}

package/dist/commands/init/tools/core/install-core.js

@@ -0,0 +1,50 @@
+import { join } from 'node:path';
+import { copyDirWithStatus as defaultCopyDirWithStatus, copyDirWithVersionCheck as defaultCopyDirWithVersionCheck, } from '../../../init/tools/shared/copy-helpers.js';
+import { CORE_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+import { dirExists as defaultDirExists } from '../../../../fs/io.js';
+export { CORE_SKILLS };
+const defaultDependencies = {
+    copyDirWithVersionCheck: defaultCopyDirWithVersionCheck,
+    copyDirWithStatus: defaultCopyDirWithStatus,
+    dirExists: defaultDirExists,
+};
+export async function installCore(options) {
+    const force = options.force ?? false;
+    const deps = options.dependencies ?? defaultDependencies;
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+        docsStatus: 'skipped',
+    };
+    for (const skill of CORE_SKILLS) {
+        const source = join(options.assetsRoot, 'skills', skill);
+        const destination = join(options.targetRoot, '.agents', 'skills', skill);
+        const copyResult = await deps.copyDirWithVersionCheck(source, destination, force);
+        if (copyResult.status === 'copied') {
+            result.copiedSkills.push(skill);
+        }
+        else if (copyResult.status === 'updated') {
+            result.updatedSkills.push(skill);
+        }
+        else if (copyResult.status === 'outdated') {
+            result.outdatedSkills.push({
+                name: skill,
+                installed: copyResult.installedVersion ?? null,
+                bundled: copyResult.bundledVersion ?? null,
+            });
+        }
+        else {
+            result.skippedSkills.push(skill);
+        }
+    }
+    // Copy docs to ~/.oat/docs/
+    const docsSource = join(options.assetsRoot, 'docs');
+    const docsDestination = join(options.targetRoot, '.oat', 'docs');
+    const docsExist = await deps.dirExists(docsSource);
+    if (docsExist) {
+        result.docsStatus = await deps.copyDirWithStatus(docsSource, docsDestination, force);
+    }
+    return result;
+}

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

@@ -0,0 +1,17 @@
+import { type CommandContext, type GlobalOptions } from '../../../../app/command-context.js';
+import { type MultiSelectChoice, type PromptContext } from '../../../shared/shared.prompts.js';
+import { Command } from 'commander';
+import { type InstallDocsOptions, type InstallDocsResult } from './install-docs.js';
+type DocsScope = 'project' | 'user';
+interface InitToolsDocsDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveScopeRoot: (scope: DocsScope, cwd: string, home: string) => string;
+    resolveAssetsRoot: () => Promise<string>;
+    installDocs: (options: InstallDocsOptions) => Promise<InstallDocsResult>;
+    selectManyWithAbort: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[] | null>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+}
+export declare function createInitToolsDocsCommand(overrides?: Partial<InitToolsDocsDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/docs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAEnB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAMxB,KAAK,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;AAEpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1E,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzE,mBAAmB,EAAE,CAAC,CAAC,SAAS,MAAM,EACpC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAC/B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IACzB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAqID,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAeT"}

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

@@ -0,0 +1,110 @@
+import { buildCommandContext, } from '../../../../app/command-context.js';
+import { confirmAction, selectManyWithAbort, } from '../../../shared/shared.prompts.js';
+import { readGlobalOptions } from '../../../shared/shared.utils.js';
+import { resolveAssetsRoot } from '../../../../fs/assets.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../../fs/paths.js';
+import { Command } from 'commander';
+import { DOCS_SKILLS, installDocs as defaultInstallDocs, } from './install-docs.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveScopeRoot,
+    resolveAssetsRoot,
+    installDocs: defaultInstallDocs,
+    selectManyWithAbort,
+    confirmAction,
+};
+function resolveScope(context) {
+    return context.scope === 'user' ? 'user' : 'project';
+}
+function reportSuccess(context, scope, targetRoot, assetsRoot, selectedSkills, result) {
+    if (context.json) {
+        context.logger.json({
+            status: 'ok',
+            scope,
+            targetRoot,
+            assetsRoot,
+            selectedSkills,
+            result,
+        });
+        return;
+    }
+    context.logger.info('Installed docs tool pack.');
+    context.logger.info(`Scope: ${scope}`);
+    context.logger.info(`Target root: ${targetRoot}`);
+    context.logger.info(`Selected skills: ${selectedSkills.join(', ') || '(none)'}`);
+    context.logger.info(`Skills: copied=${result.copiedSkills.length}, updated=${result.updatedSkills.length}, skipped=${result.skippedSkills.length}`);
+    context.logger.info(`Scripts: copied=${result.copiedScripts.length}, updated=${result.updatedScripts.length}, skipped=${result.skippedScripts.length}`);
+    context.logger.info(`Run: oat sync --scope ${scope}`);
+}
+async function runInitToolsDocs(context, options, dependencies) {
+    try {
+        const scope = resolveScope(context);
+        const targetRoot = scope === 'project'
+            ? await dependencies.resolveProjectRoot(context.cwd)
+            : dependencies.resolveScopeRoot('user', context.cwd, context.home);
+        const selectedSkills = context.interactive
+            ? await dependencies.selectManyWithAbort('Select docs skills to install', DOCS_SKILLS.map((skill) => ({
+                label: skill,
+                value: skill,
+                checked: true,
+            })), { interactive: context.interactive })
+            : [...DOCS_SKILLS];
+        if (selectedSkills === null) {
+            if (!context.json) {
+                context.logger.info('Cancelled: no docs skills installed.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (selectedSkills.length === 0) {
+            if (!context.json) {
+                context.logger.info('No docs skills selected.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (options.force && context.interactive) {
+            const confirmed = await dependencies.confirmAction(`Force overwrite existing docs assets in ${scope} scope?`, { interactive: context.interactive });
+            if (!confirmed) {
+                if (!context.json) {
+                    context.logger.info('Cancelled: no files were overwritten.');
+                }
+                process.exitCode = 0;
+                return;
+            }
+        }
+        const assetsRoot = await dependencies.resolveAssetsRoot();
+        const result = await dependencies.installDocs({
+            assetsRoot,
+            targetRoot,
+            skills: selectedSkills,
+            force: options.force,
+        });
+        reportSuccess(context, scope, targetRoot, assetsRoot, selectedSkills, result);
+        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 = 1;
+    }
+}
+export function createInitToolsDocsCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('docs')
+        .description('Install OAT docs workflow skills')
+        .option('--force', 'Overwrite existing files where applicable')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runInitToolsDocs(context, options, dependencies);
+    });
+}

package/dist/commands/init/tools/docs/install-docs.d.ts

@@ -0,0 +1,23 @@
+import { DOCS_SCRIPTS, DOCS_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { DOCS_SCRIPTS, DOCS_SKILLS };
+export interface InstallDocsOptions {
+    assetsRoot: string;
+    targetRoot: string;
+    skills: string[];
+    force?: boolean;
+}
+export interface InstallDocsResult {
+    copiedSkills: string[];
+    updatedSkills: string[];
+    skippedSkills: string[];
+    outdatedSkills: Array<{
+        name: string;
+        installed: string | null;
+        bundled: string | null;
+    }>;
+    copiedScripts: string[];
+    updatedScripts: string[];
+    skippedScripts: string[];
+}
+export declare function installDocs(options: InstallDocsOptions): Promise<InstallDocsResult>;
+//# sourceMappingURL=install-docs.d.ts.map

package/dist/commands/init/tools/docs/install-docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-docs.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/docs/install-docs.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,YAAY,EACZ,WAAW,EACZ,MAAM,4CAA4C,CAAC;AAGpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;AAErC,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CA0D5B"}

package/dist/commands/init/tools/docs/install-docs.js

@@ -0,0 +1,58 @@
+import { join } from 'node:path';
+import { copyDirWithVersionCheck, copyFileWithStatus, } from '../../../init/tools/shared/copy-helpers.js';
+import { DOCS_SCRIPTS, DOCS_SKILLS, } from '../../../init/tools/shared/skill-manifest.js';
+import { fileExists } from '../../../../fs/io.js';
+export { DOCS_SCRIPTS, DOCS_SKILLS };
+export async function installDocs(options) {
+    const force = options.force ?? false;
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+        copiedScripts: [],
+        updatedScripts: [],
+        skippedScripts: [],
+    };
+    for (const skill of options.skills) {
+        const source = join(options.assetsRoot, 'skills', skill);
+        const destination = join(options.targetRoot, '.agents', 'skills', skill);
+        const resultWithVersion = await copyDirWithVersionCheck(source, destination, force);
+        if (resultWithVersion.status === 'copied') {
+            result.copiedSkills.push(skill);
+        }
+        else if (resultWithVersion.status === 'updated') {
+            result.updatedSkills.push(skill);
+        }
+        else if (resultWithVersion.status === 'outdated') {
+            result.outdatedSkills.push({
+                name: skill,
+                installed: resultWithVersion.installedVersion ?? null,
+                bundled: resultWithVersion.bundledVersion ?? null,
+            });
+        }
+        else {
+            result.skippedSkills.push(skill);
+        }
+    }
+    for (const script of DOCS_SCRIPTS) {
+        const source = join(options.assetsRoot, 'scripts', script);
+        const destination = join(options.targetRoot, '.oat', 'scripts', script);
+        const sourceExists = await fileExists(source);
+        if (!sourceExists) {
+            result.skippedScripts.push(script);
+            continue;
+        }
+        const copyStatus = await copyFileWithStatus(source, destination, force);
+        if (copyStatus === 'copied') {
+            result.copiedScripts.push(script);
+        }
+        else if (copyStatus === 'updated') {
+            result.updatedScripts.push(script);
+        }
+        else {
+            result.skippedScripts.push(script);
+        }
+    }
+    return result;
+}

package/dist/commands/init/tools/ideas/index.d.ts

@@ -0,0 +1,16 @@
+import { type CommandContext, type GlobalOptions } from '../../../../app/command-context.js';
+import { type PromptContext } from '../../../shared/shared.prompts.js';
+import { Command } from 'commander';
+import { type InstallIdeasOptions, type InstallIdeasResult } from './install-ideas.js';
+type InstallScope = 'project' | 'user';
+interface InitToolsIdeasDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveScopeRoot: (scope: InstallScope, cwd: string, home: string) => string;
+    resolveAssetsRoot: () => Promise<string>;
+    installIdeas: (options: InstallIdeasOptions) => Promise<InstallIdeasResult>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+}
+export declare function createInitToolsIdeasCommand(overrides?: Partial<InitToolsIdeasDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/init/tools/ideas/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/ideas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAIzC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AAMzB,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,UAAU,0BAA0B;IAClC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,gBAAgB,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7E,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,YAAY,EAAE,CAAC,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC5E,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAqGD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAeT"}

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

@@ -0,0 +1,94 @@
+import { buildCommandContext, } from '../../../../app/command-context.js';
+import { confirmAction, } from '../../../shared/shared.prompts.js';
+import { readGlobalOptions } from '../../../shared/shared.utils.js';
+import { resolveAssetsRoot } from '../../../../fs/assets.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../../fs/paths.js';
+import { Command } from 'commander';
+import { installIdeas as defaultInstallIdeas, } from './install-ideas.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveScopeRoot,
+    resolveAssetsRoot,
+    installIdeas: defaultInstallIdeas,
+    confirmAction,
+};
+function resolveInstallScope(context) {
+    return context.scope === 'user' ? 'user' : 'project';
+}
+function getCountSummary(result) {
+    return {
+        skills: `copied=${result.copiedSkills.length}, updated=${result.updatedSkills.length}, skipped=${result.skippedSkills.length}`,
+        infra: `copied=${result.copiedInfraFiles.length}, updated=${result.updatedInfraFiles.length}, skipped=${result.skippedInfraFiles.length}`,
+        templates: `copied=${result.copiedTemplates.length}, updated=${result.updatedTemplates.length}, skipped=${result.skippedTemplates.length}`,
+    };
+}
+function reportSuccess(context, scope, targetRoot, assetsRoot, result) {
+    if (context.json) {
+        context.logger.json({
+            status: 'ok',
+            scope,
+            targetRoot,
+            assetsRoot,
+            result,
+        });
+        return;
+    }
+    const counts = getCountSummary(result);
+    context.logger.info('Installed ideas tool pack.');
+    context.logger.info(`Scope: ${scope}`);
+    context.logger.info(`Target root: ${targetRoot}`);
+    context.logger.info(`Skills: ${counts.skills}`);
+    context.logger.info(`Infra files: ${counts.infra}`);
+    context.logger.info(`Runtime templates: ${counts.templates}`);
+    context.logger.info(`Run: oat sync --scope ${scope}`);
+}
+async function runInitToolsIdeas(context, options, dependencies) {
+    try {
+        const scope = resolveInstallScope(context);
+        const targetRoot = scope === 'project'
+            ? await dependencies.resolveProjectRoot(context.cwd)
+            : dependencies.resolveScopeRoot('user', context.cwd, context.home);
+        if (options.force && context.interactive) {
+            const confirmed = await dependencies.confirmAction(`Force overwrite existing ideas assets in ${scope} scope?`, { interactive: context.interactive });
+            if (!confirmed) {
+                if (!context.json) {
+                    context.logger.info('Cancelled: no files were overwritten.');
+                }
+                process.exitCode = 0;
+                return;
+            }
+        }
+        const assetsRoot = await dependencies.resolveAssetsRoot();
+        const result = await dependencies.installIdeas({
+            assetsRoot,
+            targetRoot,
+            force: options.force,
+        });
+        reportSuccess(context, scope, targetRoot, assetsRoot, result);
+        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 = 1;
+    }
+}
+export function createInitToolsIdeasCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('ideas')
+        .description('Install OAT ideas skills, templates, and idea workflow files')
+        .option('--force', 'Overwrite existing files where applicable')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runInitToolsIdeas(context, options, dependencies);
+    });
+}

package/dist/commands/init/tools/ideas/install-ideas.d.ts

@@ -0,0 +1,25 @@
+import { IDEA_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { IDEA_SKILLS };
+export interface InstallIdeasOptions {
+    assetsRoot: string;
+    targetRoot: string;
+    force?: boolean;
+}
+export interface InstallIdeasResult {
+    copiedSkills: string[];
+    updatedSkills: string[];
+    skippedSkills: string[];
+    outdatedSkills: Array<{
+        name: string;
+        installed: string | null;
+        bundled: string | null;
+    }>;
+    copiedInfraFiles: string[];
+    updatedInfraFiles: string[];
+    skippedInfraFiles: string[];
+    copiedTemplates: string[];
+    updatedTemplates: string[];
+    skippedTemplates: string[];
+}
+export declare function installIdeas(options: InstallIdeasOptions): Promise<InstallIdeasResult>;
+//# sourceMappingURL=install-ideas.d.ts.map

package/dist/commands/init/tools/ideas/install-ideas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ideas.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/ideas/install-ideas.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAEzE,OAAO,EAAE,WAAW,EAAE,CAAC;AAYvB,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,cAAc,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IACH,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,CAsE7B"}

package/dist/commands/init/tools/ideas/install-ideas.js

@@ -0,0 +1,78 @@
+import { join } from 'node:path';
+import { copyDirWithVersionCheck, copyFileWithStatus, } from '../../../init/tools/shared/copy-helpers.js';
+import { IDEA_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { IDEA_SKILLS };
+const INFRA_FILE_MAPPINGS = [
+    { src: 'ideas-backlog.md', dest: '.oat/ideas/backlog.md' },
+    { src: 'ideas-scratchpad.md', dest: '.oat/ideas/scratchpad.md' },
+];
+const RUNTIME_TEMPLATE_MAPPINGS = [
+    { src: 'idea-discovery.md', dest: '.oat/templates/ideas/idea-discovery.md' },
+    { src: 'idea-summary.md', dest: '.oat/templates/ideas/idea-summary.md' },
+];
+export async function installIdeas(options) {
+    const force = options.force ?? false;
+    const ideasTemplatesRoot = join(options.assetsRoot, 'templates', 'ideas');
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+        copiedInfraFiles: [],
+        updatedInfraFiles: [],
+        skippedInfraFiles: [],
+        copiedTemplates: [],
+        updatedTemplates: [],
+        skippedTemplates: [],
+    };
+    for (const skill of IDEA_SKILLS) {
+        const source = join(options.assetsRoot, 'skills', skill);
+        const destination = join(options.targetRoot, '.agents', 'skills', skill);
+        const copyResult = await copyDirWithVersionCheck(source, destination, force);
+        if (copyResult.status === 'copied') {
+            result.copiedSkills.push(skill);
+        }
+        else if (copyResult.status === 'updated') {
+            result.updatedSkills.push(skill);
+        }
+        else if (copyResult.status === 'outdated') {
+            result.outdatedSkills.push({
+                name: skill,
+                installed: copyResult.installedVersion ?? null,
+                bundled: copyResult.bundledVersion ?? null,
+            });
+        }
+        else {
+            result.skippedSkills.push(skill);
+        }
+    }
+    for (const mapping of INFRA_FILE_MAPPINGS) {
+        const source = join(ideasTemplatesRoot, mapping.src);
+        const destination = join(options.targetRoot, mapping.dest);
+        const copyStatus = await copyFileWithStatus(source, destination, force);
+        if (copyStatus === 'copied') {
+            result.copiedInfraFiles.push(mapping.dest);
+        }
+        else if (copyStatus === 'updated') {
+            result.updatedInfraFiles.push(mapping.dest);
+        }
+        else {
+            result.skippedInfraFiles.push(mapping.dest);
+        }
+    }
+    for (const mapping of RUNTIME_TEMPLATE_MAPPINGS) {
+        const source = join(ideasTemplatesRoot, mapping.src);
+        const destination = join(options.targetRoot, mapping.dest);
+        const copyStatus = await copyFileWithStatus(source, destination, force);
+        if (copyStatus === 'copied') {
+            result.copiedTemplates.push(mapping.dest);
+        }
+        else if (copyStatus === 'updated') {
+            result.updatedTemplates.push(mapping.dest);
+        }
+        else {
+            result.skippedTemplates.push(mapping.dest);
+        }
+    }
+    return result;
+}

package/dist/commands/init/tools/index.d.ts

@@ -0,0 +1,51 @@
+import { type CommandContext, type GlobalOptions } from '../../../app/command-context.js';
+import { type UpsertSectionResult } from '../../shared/agents-md.js';
+import { type MultiSelectChoice, type PromptContext, type SelectChoice } from '../../shared/shared.prompts.js';
+import { type OatConfig } from '../../../config/oat-config.js';
+import { Command } from 'commander';
+import { type InstallCoreOptions, type InstallCoreResult } from './core/install-core.js';
+import { type InstallDocsOptions, type InstallDocsResult } from './docs/install-docs.js';
+import { type InstallIdeasOptions, type InstallIdeasResult } from './ideas/install-ideas.js';
+import { type InstallProjectManagementOptions, type InstallProjectManagementResult } from './project-management/install-project-management.js';
+import { type InstallResearchOptions, type InstallResearchResult } from './research/install-research.js';
+import { type InstallUtilityOptions, type InstallUtilityResult } from './utility/install-utility.js';
+import { type InstallWorkflowsOptions, type InstallWorkflowsResult } from './workflows/install-workflows.js';
+type InstallScope = 'project' | 'user';
+export type ToolPack = 'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research';
+interface InitToolsDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveScopeRoot: (scope: InstallScope, cwd: string, home: string) => string;
+    resolveAssetsRoot: () => Promise<string>;
+    selectManyWithAbort: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[] | null>;
+    selectWithAbort: <T extends string>(message: string, choices: SelectChoice<T>[], ctx: PromptContext) => Promise<T | null>;
+    installCore: (options: InstallCoreOptions) => Promise<InstallCoreResult>;
+    installDocs: (options: InstallDocsOptions) => Promise<InstallDocsResult>;
+    installIdeas: (options: InstallIdeasOptions) => Promise<InstallIdeasResult>;
+    installWorkflows: (options: InstallWorkflowsOptions) => Promise<InstallWorkflowsResult>;
+    installUtility: (options: InstallUtilityOptions) => Promise<InstallUtilityResult>;
+    installProjectManagement: (options: InstallProjectManagementOptions) => Promise<InstallProjectManagementResult>;
+    installResearch: (options: InstallResearchOptions) => Promise<InstallResearchResult>;
+    copyDirWithStatus: (source: string, destination: string, force: boolean) => Promise<'copied' | 'updated' | 'skipped'>;
+    addLocalPaths: (repoRoot: string, paths: string[]) => Promise<{
+        added: string[];
+        all: string[];
+    }>;
+    applyGitignore: (repoRoot: string, localPaths: string[]) => Promise<{
+        action: string;
+    }>;
+    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    resolveLocalPaths: (config: OatConfig) => string[];
+    upsertAgentsMdSection: (repoRoot: string, key: string, body: string) => Promise<UpsertSectionResult>;
+    removeAgentsMdSection: (repoRoot: string, key: string) => Promise<boolean>;
+}
+interface PackScopeInfo {
+    pack: ToolPack;
+    scope: InstallScope;
+}
+export declare function buildToolPacksSectionBody(packs: PackScopeInfo[]): string;
+export declare function runInitTools(context: CommandContext, dependencies: InitToolsDependencies): Promise<ToolPack[]>;
+export declare function runInitToolsWithDefaults(context: CommandContext): Promise<ToolPack[]>;
+export declare function createInitToolsCommand(overrides?: Partial<InitToolsDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/init/tools/index.ts"],"names":[],"mappings":"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"}