@open-agent-toolkit/cli 0.0.10

package/dist/commands/init/tools/research/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 { installResearch as defaultInstallResearch, RESEARCH_SKILLS, } from './install-research.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveScopeRoot,
+    resolveAssetsRoot,
+    installResearch: defaultInstallResearch,
+    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 research 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(`Agents: copied=${result.copiedAgents.length}, updated=${result.updatedAgents.length}, skipped=${result.skippedAgents.length}`);
+    context.logger.info(`Run: oat sync --scope ${scope}`);
+}
+async function runInitToolsResearch(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 research skills to install', RESEARCH_SKILLS.map((skill) => ({
+                label: skill,
+                value: skill,
+                checked: true,
+            })), { interactive: context.interactive })
+            : [...RESEARCH_SKILLS];
+        if (selectedSkills === null) {
+            if (!context.json) {
+                context.logger.info('Cancelled: no research skills installed.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (selectedSkills.length === 0) {
+            if (!context.json) {
+                context.logger.info('No research skills selected.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (options.force && context.interactive) {
+            const confirmed = await dependencies.confirmAction(`Force overwrite existing research 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.installResearch({
+            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 createInitToolsResearchCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('research')
+        .description('Install OAT research skills')
+        .option('--force', 'Overwrite existing files where applicable')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runInitToolsResearch(context, options, dependencies);
+    });
+}

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

@@ -0,0 +1,23 @@
+import { RESEARCH_AGENTS, RESEARCH_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { RESEARCH_AGENTS, RESEARCH_SKILLS };
+export interface InstallResearchOptions {
+    assetsRoot: string;
+    targetRoot: string;
+    skills: string[];
+    force?: boolean;
+}
+export interface InstallResearchResult {
+    copiedSkills: string[];
+    updatedSkills: string[];
+    skippedSkills: string[];
+    outdatedSkills: Array<{
+        name: string;
+        installed: string | null;
+        bundled: string | null;
+    }>;
+    copiedAgents: string[];
+    updatedAgents: string[];
+    skippedAgents: string[];
+}
+export declare function installResearch(options: InstallResearchOptions): Promise<InstallResearchResult>;
+//# sourceMappingURL=install-research.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-research.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/research/install-research.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EACf,eAAe,EAChB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACrC,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,qBAAqB;IACpC,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,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,eAAe,CACnC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAmDhC"}

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

@@ -0,0 +1,52 @@
+import { join } from 'node:path';
+import { copyDirWithVersionCheck, copyFileWithStatus, } from '../../../init/tools/shared/copy-helpers.js';
+import { RESEARCH_AGENTS, RESEARCH_SKILLS, } from '../../../init/tools/shared/skill-manifest.js';
+export { RESEARCH_AGENTS, RESEARCH_SKILLS };
+export async function installResearch(options) {
+    const force = options.force ?? false;
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+        copiedAgents: [],
+        updatedAgents: [],
+        skippedAgents: [],
+    };
+    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 agent of RESEARCH_AGENTS) {
+        const source = join(options.assetsRoot, 'agents', agent);
+        const destination = join(options.targetRoot, '.agents', 'agents', agent);
+        const copyStatus = await copyFileWithStatus(source, destination, force);
+        if (copyStatus === 'copied') {
+            result.copiedAgents.push(agent);
+        }
+        else if (copyStatus === 'updated') {
+            result.updatedAgents.push(agent);
+        }
+        else {
+            result.skippedAgents.push(agent);
+        }
+    }
+    return result;
+}

package/dist/commands/init/tools/shared/copy-helpers.d.ts

@@ -0,0 +1,12 @@
+export type CopyStatus = 'copied' | 'updated' | 'skipped';
+export type CopyStatusExtended = CopyStatus | 'outdated';
+export interface CopyResult {
+    status: CopyStatusExtended;
+    installedVersion?: string | null;
+    bundledVersion?: string | null;
+}
+export declare function pathExists(path: string): Promise<boolean>;
+export declare function copyDirWithStatus(source: string, destination: string, force: boolean): Promise<CopyStatus>;
+export declare function copyFileWithStatus(source: string, destination: string, force: boolean): Promise<CopyStatus>;
+export declare function copyDirWithVersionCheck(source: string, destination: string, force: boolean): Promise<CopyResult>;
+//# sourceMappingURL=copy-helpers.d.ts.map

package/dist/commands/init/tools/shared/copy-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/copy-helpers.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAC1D,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,UAAU,CAAC;AAEzD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/D;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAerB;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAerB;AAED,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/commands/init/tools/shared/copy-helpers.js

@@ -0,0 +1,52 @@
+import { rm } from 'node:fs/promises';
+import { compareVersions } from '../../../init/tools/shared/version.js';
+import { getSkillVersion } from '../../../shared/frontmatter.js';
+import { copyDirectory, copySingleFile, dirExists, fileExists } from '../../../../fs/io.js';
+export async function pathExists(path) {
+    return (await fileExists(path)) || (await dirExists(path));
+}
+export async function copyDirWithStatus(source, destination, force) {
+    const exists = await pathExists(destination);
+    if (exists && !force) {
+        return 'skipped';
+    }
+    if (exists && force) {
+        await rm(destination, { recursive: true, force: true });
+        await copyDirectory(source, destination);
+        return 'updated';
+    }
+    await copyDirectory(source, destination);
+    return 'copied';
+}
+export async function copyFileWithStatus(source, destination, force) {
+    const exists = await pathExists(destination);
+    if (exists && !force) {
+        return 'skipped';
+    }
+    if (exists && force) {
+        await rm(destination, { recursive: true, force: true });
+        await copySingleFile(source, destination);
+        return 'updated';
+    }
+    await copySingleFile(source, destination);
+    return 'copied';
+}
+export async function copyDirWithVersionCheck(source, destination, force) {
+    const exists = await pathExists(destination);
+    if (!exists) {
+        await copyDirectory(source, destination);
+        return { status: 'copied' };
+    }
+    if (force) {
+        await rm(destination, { recursive: true, force: true });
+        await copyDirectory(source, destination);
+        return { status: 'updated' };
+    }
+    const bundledVersion = await getSkillVersion(source);
+    const installedVersion = await getSkillVersion(destination);
+    const versionState = compareVersions(installedVersion, bundledVersion);
+    if (versionState === 'outdated') {
+        return { status: 'outdated', installedVersion, bundledVersion };
+    }
+    return { status: 'skipped' };
+}

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

@@ -0,0 +1,22 @@
+/**
+ * Single source of truth for all bundled skill/asset lists per pack.
+ *
+ * Runtime installers and tests import from here.
+ * `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"];
+export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.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"];
+export declare const CORE_SKILLS: readonly ["oat-docs", "oat-doctor"];
+export declare const DOCS_SKILLS: readonly ["oat-agent-instructions-analyze", "oat-agent-instructions-apply", "oat-docs-analyze", "oat-docs-apply"];
+export declare const DOCS_SCRIPTS: readonly ["resolve-tracking.sh"];
+export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-repo-maintainability-review", "oat-review-provide", "oat-review-receive", "oat-review-receive-remote"];
+export declare const PROJECT_MANAGEMENT_SKILLS: readonly ["oat-pjm-add-backlog-item", "oat-pjm-update-repo-reference", "oat-pjm-review-backlog"];
+export declare const PROJECT_MANAGEMENT_TEMPLATES: readonly ["backlog-item.md", "roadmap.md"];
+export declare const PROJECT_MANAGEMENT_SCRIPTS: readonly [];
+export declare const RESEARCH_SKILLS: readonly ["analyze", "compare", "deep-research", "skeptic", "synthesize"];
+export declare const RESEARCH_AGENTS: readonly ["skeptical-evaluator.md"];
+//# sourceMappingURL=skill-manifest.d.ts.map

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

@@ -0,0 +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,svBA8BlB,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,mHAKd,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

@@ -0,0 +1,102 @@
+/**
+ * Single source of truth for all bundled skill/asset lists per pack.
+ *
+ * Runtime installers and tests import from here.
+ * `bundle-assets.sh` maintains its own bash array — `bundle-consistency.test.ts`
+ * validates that it stays in sync with these lists.
+ */
+// ── Workflow pack ──────────────────────────────────────────────────
+export const WORKFLOW_SKILLS = [
+    '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',
+];
+export const WORKFLOW_AGENTS = [
+    'oat-codebase-mapper.md',
+    'oat-reviewer.md',
+];
+export const WORKFLOW_TEMPLATES = [
+    'state.md',
+    'discovery.md',
+    'spec.md',
+    'design.md',
+    'plan.md',
+    'implementation.md',
+    'summary.md',
+];
+export const WORKFLOW_SCRIPTS = [
+    'generate-oat-state.sh',
+    'generate-thin-index.sh',
+    'resolve-tracking.sh',
+];
+// ── Ideas pack ─────────────────────────────────────────────────────
+export const IDEA_SKILLS = [
+    'oat-idea-new',
+    'oat-idea-ideate',
+    'oat-idea-summarize',
+    'oat-idea-scratchpad',
+];
+// ── Core pack (always user-level) ─────────────────────────────────
+export const CORE_SKILLS = ['oat-docs', 'oat-doctor'];
+// ── Docs pack ─────────────────────────────────────────────────────
+export const DOCS_SKILLS = [
+    'oat-agent-instructions-analyze',
+    'oat-agent-instructions-apply',
+    'oat-docs-analyze',
+    'oat-docs-apply',
+];
+export const DOCS_SCRIPTS = ['resolve-tracking.sh'];
+// ── Utility pack ───────────────────────────────────────────────────
+export const UTILITY_SKILLS = [
+    'create-agnostic-skill',
+    'oat-repo-maintainability-review',
+    'oat-review-provide',
+    'oat-review-receive',
+    'oat-review-receive-remote',
+];
+// ── Project management pack ───────────────────────────────────────
+export const PROJECT_MANAGEMENT_SKILLS = [
+    'oat-pjm-add-backlog-item',
+    'oat-pjm-update-repo-reference',
+    'oat-pjm-review-backlog',
+];
+export const PROJECT_MANAGEMENT_TEMPLATES = [
+    'backlog-item.md',
+    'roadmap.md',
+];
+export const PROJECT_MANAGEMENT_SCRIPTS = [];
+// ── Research pack ─────────────────────────────────────────────────
+export const RESEARCH_SKILLS = [
+    'analyze',
+    'compare',
+    'deep-research',
+    'skeptic',
+    'synthesize',
+];
+export const RESEARCH_AGENTS = ['skeptical-evaluator.md'];

package/dist/commands/init/tools/shared/version.d.ts

@@ -0,0 +1,3 @@
+export declare function parseVersion(version: string | null): [number, number, number];
+export declare function compareVersions(installed: string | null, bundled: string | null): 'outdated' | 'current' | 'newer';
+//# sourceMappingURL=version.d.ts.map

package/dist/commands/init/tools/shared/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/shared/version.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAgB7E;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,UAAU,GAAG,SAAS,GAAG,OAAO,CAclC"}

package/dist/commands/init/tools/shared/version.js

@@ -0,0 +1,27 @@
+export function parseVersion(version) {
+    if (!version) {
+        return [0, 0, 0];
+    }
+    const parts = version.split('.');
+    if (parts.length !== 3) {
+        return [0, 0, 0];
+    }
+    const parsed = parts.map((part) => Number.parseInt(part, 10));
+    if (parsed.some((part) => Number.isNaN(part) || part < 0)) {
+        return [0, 0, 0];
+    }
+    return [parsed[0], parsed[1], parsed[2]];
+}
+export function compareVersions(installed, bundled) {
+    const installedParts = parseVersion(installed);
+    const bundledParts = parseVersion(bundled);
+    for (let index = 0; index < 3; index += 1) {
+        if (bundledParts[index] > installedParts[index]) {
+            return 'outdated';
+        }
+        if (bundledParts[index] < installedParts[index]) {
+            return 'newer';
+        }
+    }
+    return 'current';
+}

package/dist/commands/init/tools/utility/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 InstallUtilityOptions, type InstallUtilityResult } from './install-utility.js';
+type UtilityScope = 'project' | 'user';
+interface InitToolsUtilityDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveScopeRoot: (scope: UtilityScope, cwd: string, home: string) => string;
+    resolveAssetsRoot: () => Promise<string>;
+    installUtility: (options: InstallUtilityOptions) => Promise<InstallUtilityResult>;
+    selectManyWithAbort: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[] | null>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+}
+export declare function createInitToolsUtilityCommand(overrides?: Partial<InitToolsUtilityDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/utility/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,EAEL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAE1B,MAAM,mBAAmB,CAAC;AAM3B,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,UAAU,4BAA4B;IACpC,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,cAAc,EAAE,CACd,OAAO,EAAE,qBAAqB,KAC3B,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACnC,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;AAkID,wBAAgB,6BAA6B,CAC3C,SAAS,GAAE,OAAO,CAAC,4BAA4B,CAAM,GACpD,OAAO,CAeT"}

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

@@ -0,0 +1,109 @@
+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 { installUtility as defaultInstallUtility, UTILITY_SKILLS, } from './install-utility.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveScopeRoot,
+    resolveAssetsRoot,
+    installUtility: defaultInstallUtility,
+    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 utility 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(`Run: oat sync --scope ${scope}`);
+}
+async function runInitToolsUtility(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 utility skills to install', UTILITY_SKILLS.map((skill) => ({
+                label: skill,
+                value: skill,
+                checked: true,
+            })), { interactive: context.interactive })
+            : [...UTILITY_SKILLS];
+        if (selectedSkills === null) {
+            if (!context.json) {
+                context.logger.info('Cancelled: no utility skills installed.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (selectedSkills.length === 0) {
+            if (!context.json) {
+                context.logger.info('No utility skills selected.');
+            }
+            process.exitCode = 0;
+            return;
+        }
+        if (options.force && context.interactive) {
+            const confirmed = await dependencies.confirmAction(`Force overwrite existing utility 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.installUtility({
+            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 createInitToolsUtilityCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return new Command('utility')
+        .description('Install OAT utility skills')
+        .option('--force', 'Overwrite existing files where applicable')
+        .action(async (options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runInitToolsUtility(context, options, dependencies);
+    });
+}

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

@@ -0,0 +1,20 @@
+import { UTILITY_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { UTILITY_SKILLS };
+export interface InstallUtilityOptions {
+    assetsRoot: string;
+    targetRoot: string;
+    skills: string[];
+    force?: boolean;
+}
+export interface InstallUtilityResult {
+    copiedSkills: string[];
+    updatedSkills: string[];
+    skippedSkills: string[];
+    outdatedSkills: Array<{
+        name: string;
+        installed: string | null;
+        bundled: string | null;
+    }>;
+}
+export declare function installUtility(options: InstallUtilityOptions): Promise<InstallUtilityResult>;
+//# sourceMappingURL=install-utility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-utility.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/utility/install-utility.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAE5E,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,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,oBAAoB;IACnC,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;CACJ;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,CAAC,CAkC/B"}

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

@@ -0,0 +1,35 @@
+import { join } from 'node:path';
+import { copyDirWithVersionCheck } from '../../../init/tools/shared/copy-helpers.js';
+import { UTILITY_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { UTILITY_SKILLS };
+export async function installUtility(options) {
+    const force = options.force ?? false;
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+    };
+    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);
+        }
+    }
+    return result;
+}

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

@@ -0,0 +1,14 @@
+import { type CommandContext, type GlobalOptions } from '../../../../app/command-context.js';
+import { type PromptContext } from '../../../shared/shared.prompts.js';
+import { Command } from 'commander';
+import { type InstallWorkflowsOptions, type InstallWorkflowsResult } from './install-workflows.js';
+interface InitToolsWorkflowsDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveAssetsRoot: () => Promise<string>;
+    installWorkflows: (options: InstallWorkflowsOptions) => Promise<InstallWorkflowsResult>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+}
+export declare function createInitToolsWorkflowsCommand(overrides?: Partial<InitToolsWorkflowsDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/workflows/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,uBAAuB,EAC5B,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAM7B,UAAU,8BAA8B;IACtC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,gBAAgB,EAAE,CAChB,OAAO,EAAE,uBAAuB,KAC7B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E;AAgGD,wBAAgB,+BAA+B,CAC7C,SAAS,GAAE,OAAO,CAAC,8BAA8B,CAAM,GACtD,OAAO,CAeT"}