@open-agent-toolkit/cli 0.0.10

package/dist/commands/sync/index.js

@@ -0,0 +1,225 @@
+import { join } from 'node:path';
+import { buildCommandContext } from '../../app/command-context.js';
+import { PROVIDER_CONFIG_REMEDIATION } from '../shared/messages.js';
+import { selectManyWithAbort, } from '../shared/shared.prompts.js';
+import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
+import { DEFAULT_SYNC_CONFIG, loadSyncConfig, saveSyncConfig, } from '../../config/index.js';
+import { computeSyncPlan, executeSyncPlan, scanCanonical } from '../../engine/index.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../fs/paths.js';
+import { loadManifest } from '../../manifest/index.js';
+import { claudeAdapter } from '../../providers/claude/index.js';
+import { codexAdapter } from '../../providers/codex/index.js';
+import { applyCodexProjectExtensionPlan, computeCodexProjectExtensionPlan, toCodexExtensionOperations, } from '../../providers/codex/codec/sync-extension.js';
+import { copilotAdapter } from '../../providers/copilot/index.js';
+import { cursorAdapter } from '../../providers/cursor/index.js';
+import { geminiAdapter } from '../../providers/gemini/index.js';
+import { getConfigAwareAdapters, } from '../../providers/shared/index.js';
+import { formatSyncPlan } from '../../ui/output.js';
+import { Command } from 'commander';
+import { runSyncApply } from './apply.js';
+import { runSyncDryRun } from './dry-run.js';
+function defaultDependencies() {
+    return {
+        buildCommandContext,
+        async resolveScopeRoot(scope, context) {
+            if (scope === 'project') {
+                return resolveProjectRoot(context.cwd);
+            }
+            return resolveScopeRoot(scope, context.cwd, context.home);
+        },
+        loadManifest,
+        async loadSyncConfig(configPath) {
+            const config = await loadSyncConfig(configPath, DEFAULT_SYNC_CONFIG);
+            return config;
+        },
+        saveSyncConfig,
+        scanCanonical,
+        getAdapters() {
+            return [
+                claudeAdapter,
+                cursorAdapter,
+                codexAdapter,
+                copilotAdapter,
+                geminiAdapter,
+            ];
+        },
+        getConfigAwareAdapters,
+        selectProvidersWithAbort: selectManyWithAbort,
+        computeSyncPlan,
+        executeSyncPlan,
+        computeCodexProjectExtensionPlan,
+        toCodexExtensionOperations,
+        applyCodexProjectExtensionPlan,
+        formatSyncPlan,
+    };
+}
+function hasProviderMismatches(mismatches) {
+    return (mismatches.detectedUnset.length > 0 ||
+        mismatches.detectedDisabled.length > 0);
+}
+function buildMismatchChoices(adapters, mismatches) {
+    const mismatchSet = new Set([
+        ...mismatches.detectedUnset,
+        ...mismatches.detectedDisabled,
+    ]);
+    return adapters
+        .filter((adapter) => mismatchSet.has(adapter.name))
+        .map((adapter) => {
+        const isDisabled = mismatches.detectedDisabled.includes(adapter.name);
+        return {
+            label: adapter.name,
+            value: adapter.name,
+            description: isDisabled
+                ? `${adapter.displayName} (detected, currently disabled)`
+                : `${adapter.displayName} (detected, not configured)`,
+            checked: true,
+        };
+    });
+}
+async function maybeResolveProviderMismatches(context, scope, scopeRoot, configPath, config, adapters, mismatches, dependencies) {
+    if (scope !== 'project' ||
+        !context.interactive ||
+        !hasProviderMismatches(mismatches)) {
+        return {
+            config,
+            mismatches,
+            activeAdapters: await dependencies
+                .getConfigAwareAdapters(adapters, scopeRoot, config)
+                .then((resolution) => resolution.activeAdapters),
+        };
+    }
+    const choices = buildMismatchChoices(adapters, mismatches);
+    const selected = await dependencies.selectProvidersWithAbort('Detected provider directories are not enabled in config. Select providers to enable for sync.', choices, { interactive: context.interactive });
+    if (selected === null) {
+        const resolution = await dependencies.getConfigAwareAdapters(adapters, scopeRoot, config);
+        return {
+            config,
+            mismatches,
+            activeAdapters: resolution.activeAdapters,
+        };
+    }
+    const selectedSet = new Set(selected);
+    // `detectedUnset` and `detectedDisabled` are mutually exclusive by contract.
+    const mismatchedProviders = new Set([
+        ...mismatches.detectedUnset,
+        ...mismatches.detectedDisabled,
+    ]);
+    const providers = { ...config.providers };
+    for (const providerName of mismatchedProviders) {
+        providers[providerName] = {
+            ...(providers[providerName] ?? {}),
+            enabled: selectedSet.has(providerName),
+        };
+    }
+    const savedConfig = await dependencies.saveSyncConfig(configPath, {
+        ...config,
+        providers,
+    });
+    const resolution = await dependencies.getConfigAwareAdapters(adapters, scopeRoot, savedConfig);
+    return {
+        config: savedConfig,
+        mismatches: {
+            detectedUnset: resolution.detectedUnset,
+            detectedDisabled: resolution.detectedDisabled,
+        },
+        activeAdapters: resolution.activeAdapters,
+    };
+}
+async function computePlans(context, dependencies) {
+    const scopePlans = [];
+    for (const scope of resolveConcreteScopes(context.scope)) {
+        const scopeRoot = await dependencies.resolveScopeRoot(scope, context);
+        const manifestPath = join(scopeRoot, '.oat', 'sync', 'manifest.json');
+        const configPath = join(scopeRoot, '.oat', 'sync', 'config.json');
+        const [manifest, config, canonical] = await Promise.all([
+            dependencies.loadManifest(manifestPath),
+            dependencies.loadSyncConfig(configPath),
+            dependencies.scanCanonical(scopeRoot, scope),
+        ]);
+        const adapters = dependencies.getAdapters();
+        const initialResolution = await dependencies.getConfigAwareAdapters(adapters, scopeRoot, config);
+        const resolved = await maybeResolveProviderMismatches(context, scope, scopeRoot, configPath, config, adapters, {
+            detectedUnset: initialResolution.detectedUnset,
+            detectedDisabled: initialResolution.detectedDisabled,
+        }, dependencies);
+        const plan = await dependencies.computeSyncPlan({
+            canonical,
+            adapters: resolved.activeAdapters,
+            manifest,
+            scope,
+            config: resolved.config,
+            scopeRoot,
+        });
+        let codexExtensionPlan;
+        let codexExtension;
+        const activeAdapterNames = resolved.activeAdapters.map((adapter) => adapter.name);
+        if (scope === 'project' && activeAdapterNames.includes('codex')) {
+            codexExtensionPlan = await dependencies.computeCodexProjectExtensionPlan(scopeRoot, canonical);
+            codexExtension = {
+                operations: dependencies.toCodexExtensionOperations(codexExtensionPlan),
+                managedRoles: codexExtensionPlan.managedRoles,
+                aggregateConfigHash: codexExtensionPlan.aggregateConfigHash,
+            };
+        }
+        scopePlans.push({
+            scope,
+            scopeRoot,
+            manifestPath,
+            manifest,
+            canonical,
+            activeAdapterNames,
+            plan,
+            providerMismatches: resolved.mismatches,
+            codexExtensionPlan,
+            codexExtension,
+        });
+    }
+    return scopePlans;
+}
+function logNonInteractiveMismatchGuidance(context, scopePlans) {
+    if (context.interactive) {
+        return;
+    }
+    for (const scopePlan of scopePlans) {
+        if (scopePlan.scope !== 'project' || !scopePlan.providerMismatches) {
+            continue;
+        }
+        const { detectedUnset, detectedDisabled } = scopePlan.providerMismatches;
+        if (detectedUnset.length === 0 && detectedDisabled.length === 0) {
+            continue;
+        }
+        const parts = [];
+        if (detectedUnset.length > 0) {
+            parts.push(`unset: ${detectedUnset.join(', ')}`);
+        }
+        if (detectedDisabled.length > 0) {
+            parts.push(`disabled: ${detectedDisabled.join(', ')}`);
+        }
+        context.logger.warn(`Provider config mismatch detected [project] (${parts.join('; ')}).`);
+        if (!context.json) {
+            context.logger.info(PROVIDER_CONFIG_REMEDIATION);
+        }
+    }
+}
+async function runSyncCommand(context, dependencies) {
+    const scopePlans = await computePlans(context, dependencies);
+    logNonInteractiveMismatchGuidance(context, scopePlans);
+    if (context.dryRun) {
+        runSyncDryRun(context, scopePlans, dependencies);
+        return;
+    }
+    await runSyncApply(context, scopePlans, dependencies);
+}
+export function createSyncCommand(overrides = {}) {
+    const dependencies = {
+        ...defaultDependencies(),
+        ...overrides,
+    };
+    return new Command('sync')
+        .description('Sync canonical content to provider views')
+        .option('--dry-run', 'Preview sync changes without applying')
+        .action(async (_options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runSyncCommand(context, dependencies);
+    });
+}

package/dist/commands/sync/sync.types.d.ts

@@ -0,0 +1,80 @@
+import type { CommandContext, GlobalOptions } from '../../app/command-context.js';
+import type { MultiSelectChoice, PromptContext } from '../shared/shared.prompts.js';
+import type { SyncConfig } from '../../config/index.js';
+import type { CanonicalEntry, SyncPlan, SyncResult } from '../../engine/index.js';
+import type { Manifest } from '../../manifest/index.js';
+import type { CodexExtensionApplyResult, CodexExtensionPlan } from '../../providers/codex/codec/sync-extension.js';
+import type { ConfigAwareAdaptersResult, ProviderAdapter } from '../../providers/shared/index.js';
+import type { ConcreteScope, Scope } from '../../shared/types.js';
+export interface SyncProviderMismatches {
+    detectedUnset: string[];
+    detectedDisabled: string[];
+}
+export interface ScopeSyncPlan {
+    scope: ConcreteScope;
+    scopeRoot: string;
+    manifestPath: string;
+    manifest: Manifest;
+    plan: SyncPlan;
+    canonical?: CanonicalEntry[];
+    activeAdapterNames?: string[];
+    providerMismatches?: SyncProviderMismatches;
+    codexExtensionPlan?: CodexExtensionPlan;
+    codexExtension?: CodexExtensionSummary;
+}
+export interface SyncSummary {
+    plannedOperations: number;
+    applied: number;
+    failed: number;
+    skipped: number;
+}
+export interface SyncJsonPayload {
+    scope: Scope;
+    dryRun: boolean;
+    plans: SyncPlan[];
+    summary: SyncSummary;
+    providerMismatches?: SyncProviderMismatches[];
+    codexExtensions?: CodexExtensionSummary[];
+}
+export type CodexExtensionAction = 'create' | 'update' | 'remove' | 'skip';
+export type CodexExtensionTarget = 'role' | 'config';
+export interface CodexExtensionOperation {
+    action: CodexExtensionAction;
+    target: CodexExtensionTarget;
+    path: string;
+    reason: string;
+    roleName?: string;
+}
+export interface CodexExtensionSummary {
+    operations: CodexExtensionOperation[];
+    managedRoles: string[];
+    aggregateConfigHash: string;
+    applied?: number;
+    failed?: number;
+    skipped?: number;
+}
+export interface SyncCommandDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveScopeRoot: (scope: ConcreteScope, context: CommandContext) => Promise<string>;
+    loadManifest: (manifestPath: string) => Promise<Manifest>;
+    loadSyncConfig: (configPath: string) => Promise<SyncConfig>;
+    saveSyncConfig: (configPath: string, config: SyncConfig) => Promise<SyncConfig>;
+    scanCanonical: (scopeRoot: string, scope: ConcreteScope) => Promise<CanonicalEntry[]>;
+    getAdapters: () => ProviderAdapter[];
+    getConfigAwareAdapters: (adapters: ProviderAdapter[], scopeRoot: string, config: SyncConfig) => Promise<ConfigAwareAdaptersResult>;
+    selectProvidersWithAbort: <T extends string>(message: string, choices: MultiSelectChoice<T>[], ctx: PromptContext) => Promise<T[] | null>;
+    computeSyncPlan: (args: {
+        canonical: CanonicalEntry[];
+        adapters: ProviderAdapter[];
+        manifest: Manifest;
+        scope: ConcreteScope;
+        config: SyncConfig;
+        scopeRoot: string;
+    }) => Promise<SyncPlan>;
+    executeSyncPlan: (plan: SyncPlan, manifest: Manifest, manifestPath: string) => Promise<SyncResult>;
+    computeCodexProjectExtensionPlan: (scopeRoot: string, canonicalEntries: CanonicalEntry[]) => Promise<CodexExtensionPlan>;
+    toCodexExtensionOperations: (plan: CodexExtensionPlan) => CodexExtensionOperation[];
+    applyCodexProjectExtensionPlan: (scopeRoot: string, plan: CodexExtensionPlan) => Promise<CodexExtensionApplyResult>;
+    formatSyncPlan: (plan: SyncPlan, applied: boolean) => string;
+}
+//# sourceMappingURL=sync.types.d.ts.map

package/dist/commands/sync/sync.types.d.ts.map

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

package/dist/commands/sync/sync.types.js

@@ -0,0 +1 @@
+export {};

package/dist/commands/sync/sync.utils.d.ts

@@ -0,0 +1,3 @@
+import type { ScopeSyncPlan } from './sync.types.js';
+export declare function countPlannedOperations(scopePlans: ScopeSyncPlan[]): number;
+//# sourceMappingURL=sync.utils.d.ts.map

package/dist/commands/sync/sync.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.utils.d.ts","sourceRoot":"","sources":["../../../src/commands/sync/sync.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,CAc1E"}

package/dist/commands/sync/sync.utils.js

@@ -0,0 +1,8 @@
+export function countPlannedOperations(scopePlans) {
+    return scopePlans.reduce((total, scopePlan) => {
+        const codexOperations = scopePlan.codexExtension?.operations.filter((entry) => entry.action !== 'skip').length ?? 0;
+        return (total +
+            [...scopePlan.plan.entries, ...scopePlan.plan.removals].filter((entry) => entry.operation !== 'skip').length +
+            codexOperations);
+    }, 0);
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC,wBAAgB,kBAAkB,IAAI,OAAO,CAa5C"}

package/dist/commands/tools/index.js

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import { createToolsInfoCommand } from './info/index.js';
+import { createToolsInstallCommand } from './install/index.js';
+import { createToolsListCommand } from './list/index.js';
+import { createToolsOutdatedCommand } from './outdated/index.js';
+import { createToolsRemoveCommand } from './remove/index.js';
+import { createToolsUpdateCommand } from './update/index.js';
+export function createToolsCommand() {
+    const cmd = new Command('tools').description('Manage OAT tool packs (install, update, remove, list)');
+    cmd.addCommand(createToolsListCommand());
+    cmd.addCommand(createToolsOutdatedCommand());
+    cmd.addCommand(createToolsInfoCommand());
+    cmd.addCommand(createToolsUpdateCommand());
+    cmd.addCommand(createToolsRemoveCommand());
+    cmd.addCommand(createToolsInstallCommand());
+    return cmd;
+}

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

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type InfoToolDependencies } from './info-tool.js';
+export declare function createToolsInfoCommand(dependencies?: InfoToolDependencies): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/index.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,aAAa,CAAC;AA2DrB,wBAAgB,sBAAsB,CACpC,YAAY,GAAE,oBAA0C,GACvD,OAAO,CAYT"}

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

@@ -0,0 +1,74 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { buildCommandContext } from '../../../app/command-context.js';
+import { getFrontmatterBlock, getFrontmatterField, parseFrontmatterField, } from '../../shared/frontmatter.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { scanTools } from '../../tools/shared/scan-tools.js';
+import { resolveAssetsRoot } from '../../../fs/assets.js';
+import { fileExists } from '../../../fs/io.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { runInfoTool, } from './info-tool.js';
+async function getToolDetail(tool, scopeRoot) {
+    if (tool.type === 'skill') {
+        const skillDir = join(scopeRoot, '.agents', 'skills', tool.name);
+        const skillMdPath = join(skillDir, 'SKILL.md');
+        const exists = await fileExists(skillMdPath);
+        if (!exists) {
+            return {
+                description: null,
+                argumentHint: null,
+                allowedTools: null,
+                userInvocable: false,
+            };
+        }
+        const content = await readFile(skillMdPath, 'utf8');
+        const block = getFrontmatterBlock(content);
+        if (!block) {
+            return {
+                description: null,
+                argumentHint: null,
+                allowedTools: null,
+                userInvocable: false,
+            };
+        }
+        return {
+            description: getFrontmatterField(block, 'description'),
+            argumentHint: getFrontmatterField(block, 'argument-hint'),
+            allowedTools: getFrontmatterField(block, 'allowed-tools'),
+            userInvocable: getFrontmatterField(block, 'user-invocable') === 'true',
+        };
+    }
+    // Agent
+    const agentPath = join(scopeRoot, '.agents', 'agents', `${tool.name}.md`);
+    const description = await parseFrontmatterField(agentPath, 'description');
+    return {
+        description: description || null,
+        argumentHint: null,
+        allowedTools: null,
+        userInvocable: false,
+    };
+}
+const defaultDependencies = {
+    scanTools,
+    resolveScopeRoot: async (scope, cwd, home) => {
+        if (scope === 'project')
+            return resolveProjectRoot(cwd);
+        return resolveScopeRoot(scope, cwd, home);
+    },
+    resolveAssetsRoot,
+    getToolDetail,
+};
+export function createToolsInfoCommand(dependencies = defaultDependencies) {
+    return new Command('info')
+        .description('Show details for an installed tool')
+        .argument('<name>', 'Tool name')
+        .action(async (name, _opts, command) => {
+        const globalOptions = readGlobalOptions(command);
+        const context = buildCommandContext(globalOptions);
+        const result = await runInfoTool(context, name, dependencies);
+        if (!result.found) {
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/commands/tools/info/info-tool.d.ts

@@ -0,0 +1,21 @@
+import type { CommandContext } from '../../../app/command-context.js';
+import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
+import type { ToolInfo } from '../../tools/shared/types.js';
+export interface ToolDetail extends ToolInfo {
+    description: string | null;
+    argumentHint: string | null;
+    allowedTools: string | null;
+    userInvocable: boolean;
+}
+export interface InfoToolDependencies {
+    scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
+    resolveScopeRoot: (scope: 'project' | 'user', cwd: string, home: string) => Promise<string>;
+    resolveAssetsRoot: () => Promise<string>;
+    getToolDetail: (tool: ToolInfo, scopeRoot: string) => Promise<Omit<ToolDetail, keyof ToolInfo>>;
+}
+export interface InfoToolResult {
+    found: boolean;
+    tool: ToolDetail | null;
+}
+export declare function runInfoTool(context: CommandContext, name: string, dependencies: InfoToolDependencies): Promise<InfoToolResult>;
+//# sourceMappingURL=info-tool.d.ts.map

package/dist/commands/tools/info/info-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info-tool.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/info/info-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,UAAW,SAAQ,QAAQ;IAC1C,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,aAAa,EAAE,CACb,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,QAAQ,CAAC,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,oBAAoB,GACjC,OAAO,CAAC,cAAc,CAAC,CA6DzB"}

package/dist/commands/tools/info/info-tool.js

@@ -0,0 +1,52 @@
+import { resolveConcreteScopes } from '../../shared/shared.utils.js';
+export async function runInfoTool(context, name, dependencies) {
+    const { logger } = context;
+    const scopes = resolveConcreteScopes(context.scope);
+    const assetsRoot = await dependencies.resolveAssetsRoot();
+    for (const scope of scopes) {
+        const scopeRoot = await dependencies.resolveScopeRoot(scope, context.cwd, context.home);
+        const tools = await dependencies.scanTools({
+            scope,
+            scopeRoot,
+            assetsRoot,
+        });
+        const match = tools.find((t) => t.name === name);
+        if (!match)
+            continue;
+        const detail = await dependencies.getToolDetail(match, scopeRoot);
+        const toolDetail = { ...match, ...detail };
+        if (context.json) {
+            logger.json({ tool: toolDetail });
+            return { found: true, tool: toolDetail };
+        }
+        logger.info(`${toolDetail.name}`);
+        logger.info(`  Type:        ${toolDetail.type}`);
+        logger.info(`  Version:     ${toolDetail.version ?? '-'}`);
+        logger.info(`  Pack:        ${toolDetail.pack}`);
+        logger.info(`  Scope:       ${toolDetail.scope}`);
+        logger.info(`  Status:      ${toolDetail.status}`);
+        if (toolDetail.description) {
+            logger.info(`  Description: ${toolDetail.description}`);
+        }
+        if (toolDetail.type === 'skill') {
+            logger.info(`  Invocable:   ${toolDetail.userInvocable ? 'yes' : 'no'}`);
+            if (toolDetail.argumentHint) {
+                logger.info(`  Args:        ${toolDetail.argumentHint}`);
+            }
+            if (toolDetail.allowedTools) {
+                logger.info(`  Tools:       ${toolDetail.allowedTools}`);
+            }
+        }
+        if (toolDetail.status === 'outdated') {
+            logger.warn(`  Update available: ${toolDetail.version ?? '?'} -> ${toolDetail.bundledVersion ?? '?'}`);
+        }
+        return { found: true, tool: toolDetail };
+    }
+    if (context.json) {
+        logger.json({ tool: null, error: `Tool '${name}' not found` });
+    }
+    else {
+        logger.error(`Tool '${name}' not found.`);
+    }
+    return { found: false, tool: null };
+}

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

@@ -0,0 +1,4 @@
+import { type AutoSyncDependencies } from '../../tools/shared/auto-sync.js';
+import type { Command } from 'commander';
+export declare function createToolsInstallCommand(syncDependencies?: AutoSyncDependencies): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/install/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,wBAAgB,yBAAyB,CACvC,gBAAgB,GAAE,oBAA8C,GAC/D,OAAO,CAyBT"}

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

@@ -0,0 +1,34 @@
+import { execFile } from 'node:child_process';
+import { buildCommandContext } from '../../../app/command-context.js';
+import { createInitToolsCommand } from '../../init/tools/index.js';
+import { readGlobalOptions, resolveConcreteScopes, } from '../../shared/shared.utils.js';
+import { autoSync, } from '../../tools/shared/auto-sync.js';
+const defaultSyncDependencies = {
+    runSync: async ({ scope, cwd }) => {
+        await new Promise((resolve, reject) => {
+            execFile(process.execPath, [...process.execArgv, process.argv[1], 'sync', '--scope', scope], { cwd }, (error) => {
+                if (error)
+                    reject(error);
+                else
+                    resolve();
+            });
+        });
+    },
+};
+export function createToolsInstallCommand(syncDependencies = defaultSyncDependencies) {
+    const cmd = createInitToolsCommand();
+    cmd.name('install');
+    cmd.option('--no-sync', 'Skip auto-sync after install');
+    cmd.hook('postAction', async (thisCommand, actionCommand) => {
+        if (process.exitCode !== 0 && process.exitCode !== undefined)
+            return;
+        const opts = thisCommand.opts();
+        if (opts.sync === false)
+            return;
+        const globalOptions = readGlobalOptions(actionCommand);
+        const context = buildCommandContext(globalOptions);
+        const scopes = resolveConcreteScopes(context.scope);
+        await autoSync(scopes, context.cwd, context.home, context.logger, syncDependencies);
+    });
+    return cmd;
+}

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

@@ -0,0 +1,4 @@
+import { Command } from 'commander';
+import { type ListToolsDependencies } from './list-tools.js';
+export declare function createToolsListCommand(dependencies?: ListToolsDependencies): Command;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/list/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,KAAK,qBAAqB,EAAgB,MAAM,cAAc,CAAC;AAWxE,wBAAgB,sBAAsB,CACpC,YAAY,GAAE,qBAA2C,GACxD,OAAO,CAQT"}

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

@@ -0,0 +1,25 @@
+import { buildCommandContext } from '../../../app/command-context.js';
+import { readGlobalOptions } from '../../shared/shared.utils.js';
+import { scanTools } from '../../tools/shared/scan-tools.js';
+import { resolveAssetsRoot } from '../../../fs/assets.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
+import { Command } from 'commander';
+import { runListTools } from './list-tools.js';
+const defaultDependencies = {
+    scanTools,
+    resolveScopeRoot: async (scope, cwd, home) => {
+        if (scope === 'project')
+            return resolveProjectRoot(cwd);
+        return resolveScopeRoot(scope, cwd, home);
+    },
+    resolveAssetsRoot,
+};
+export function createToolsListCommand(dependencies = defaultDependencies) {
+    return new Command('list')
+        .description('List installed tools with version and status')
+        .action(async (_opts, command) => {
+        const globalOptions = readGlobalOptions(command);
+        const context = buildCommandContext(globalOptions);
+        await runListTools(context, dependencies);
+    });
+}

package/dist/commands/tools/list/list-tools.d.ts

@@ -0,0 +1,13 @@
+import type { CommandContext } from '../../../app/command-context.js';
+import type { ScanToolsOptions } from '../../tools/shared/scan-tools.js';
+import type { ToolInfo } from '../../tools/shared/types.js';
+export interface ListToolsDependencies {
+    scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
+    resolveScopeRoot: (scope: 'project' | 'user', cwd: string, home: string) => Promise<string>;
+    resolveAssetsRoot: () => Promise<string>;
+}
+export interface ListToolsResult {
+    tools: ToolInfo[];
+}
+export declare function runListTools(context: CommandContext, dependencies: ListToolsDependencies): Promise<ListToolsResult>;
+//# sourceMappingURL=list-tools.d.ts.map

package/dist/commands/tools/list/list-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-tools.d.ts","sourceRoot":"","sources":["../../../../src/commands/tools/list/list-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,qBAAqB,GAClC,OAAO,CAAC,eAAe,CAAC,CAiE1B"}