@open-agent-toolkit/cli 0.1.33 → 0.1.35

package/dist/commands/gate/index.js

@@ -0,0 +1,500 @@
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { buildCommandContext, } from '../../app/command-context.js';
+import { readGlobalOptions } from '../shared/shared.utils.js';
+import { BUILTIN_EXEC_TARGETS, readOatConfig, readOatLocalConfig, readUserConfig, writeOatConfig, writeOatLocalConfig, writeUserConfig, } from '../../config/oat-config.js';
+import { resolveEffectiveConfig, resolveExecTargets, resolveGate, } from '../../config/resolve.js';
+import { resolveProjectRoot } from '../../fs/paths.js';
+import { Command } from 'commander';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    readOatConfig,
+    writeOatConfig,
+    readOatLocalConfig,
+    writeOatLocalConfig,
+    readUserConfig,
+    writeUserConfig,
+    resolveEffectiveConfig,
+    runProcess: runChildProcess,
+    processEnv: process.env,
+};
+const VALID_ON_FAILURE = ['block', 'prompt', 'warn'];
+const VALID_WRITE_LAYERS = [
+    'shared',
+    'local',
+    'user',
+];
+const VALID_CROSS_PROVIDER_AVOIDS = [
+    'same-runtime',
+    'none',
+];
+async function runChildProcess(command, args, options) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: options.cwd,
+            env: options.env,
+            stdio: options.stdio,
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            resolve({ exitCode: code ?? 1 });
+        });
+    });
+}
+function isGateWriteLayer(value) {
+    return VALID_WRITE_LAYERS.includes(value);
+}
+function writeError(context, 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;
+}
+function writeJsonValue(context, payload) {
+    if (context.json) {
+        context.logger.json(payload);
+        return;
+    }
+    context.logger.info(JSON.stringify(payload, null, 2));
+}
+function writeSuccess(context, payload) {
+    if (context.json) {
+        context.logger.json({ status: 'ok', ...payload });
+        return;
+    }
+    context.logger.info(JSON.stringify({ status: 'ok', ...payload }, null, 2));
+}
+function trimRequired(value, label) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`${label} must be a non-empty string.`);
+    }
+    return trimmed;
+}
+function parseLayer(value) {
+    const layer = value?.trim() || 'user';
+    if (!isGateWriteLayer(layer)) {
+        throw new Error('--layer must be one of shared | local | user; auto is not supported for gate writes.');
+    }
+    return layer;
+}
+function parseCrossProviderAvoid(value) {
+    const avoid = value?.trim() || 'same-runtime';
+    if (!VALID_CROSS_PROVIDER_AVOIDS.includes(avoid)) {
+        throw new Error('--avoid must be one of same-runtime | none.');
+    }
+    return avoid;
+}
+function parseOnFailure(value) {
+    if (!value || !VALID_ON_FAILURE.includes(value)) {
+        throw new Error('--on-failure must be one of block | prompt | warn.');
+    }
+    return value;
+}
+function parsePositiveInteger(value, flag, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new Error(`${flag} must be an integer greater than or equal to 1.`);
+    }
+    return parsed;
+}
+function parseNumericFlag(value, flag, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`${flag} must be a finite number.`);
+    }
+    return parsed;
+}
+function parseArgvJson(value, flag) {
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? `: ${error.message}` : '';
+        throw new Error(`${flag} must be valid JSON${detail}`, { cause: error });
+    }
+    if (!Array.isArray(parsed) ||
+        parsed.length === 0 ||
+        !parsed.every((item) => typeof item === 'string') ||
+        !parsed[0]?.trim()) {
+        throw new Error(`${flag} must be a non-empty JSON array of strings whose first item is not empty.`);
+    }
+    return [...parsed];
+}
+function parseOptionalArgvJson(value, flag) {
+    return value === undefined ? undefined : parseArgvJson(value, flag);
+}
+function parseGateConfig(options) {
+    if (options.disable) {
+        return null;
+    }
+    return {
+        command: trimRequired(options.command ?? '', '--command'),
+        onFailure: parseOnFailure(options.onFailure),
+        maxAttempts: parsePositiveInteger(options.maxAttempts, '--max-attempts', 2),
+        ...(options.description?.trim()
+            ? { description: options.description.trim() }
+            : {}),
+    };
+}
+function parseExecTargetConfig(options) {
+    if (options.disable) {
+        return null;
+    }
+    const baseCommandJson = options.baseCommandJson;
+    if (baseCommandJson === undefined) {
+        throw new Error('--base-command-json is required unless --disable is set.');
+    }
+    return {
+        runtime: trimRequired(options.runtime ?? '', '--runtime'),
+        baseCommand: parseArgvJson(baseCommandJson, '--base-command-json'),
+        priority: parseNumericFlag(options.priority, '--priority', 0),
+        ...(options.hostDetectionJson !== undefined
+            ? {
+                hostDetectionCommand: parseOptionalArgvJson(options.hostDetectionJson, '--host-detection-json'),
+            }
+            : {}),
+        ...(options.availabilityJson !== undefined
+            ? {
+                availabilityCommand: parseOptionalArgvJson(options.availabilityJson, '--availability-json'),
+            }
+            : {}),
+    };
+}
+function updateWorkflowGates(config, update) {
+    return {
+        ...config,
+        workflow: {
+            ...config.workflow,
+            gates: update(config.workflow?.gates ?? {}),
+        },
+    };
+}
+function setSkillGate(config, skillName, gate) {
+    return updateWorkflowGates(config, (gates) => ({
+        ...gates,
+        skills: {
+            ...gates.skills,
+            [skillName]: gate,
+        },
+    }));
+}
+function unsetSkillGate(config, skillName) {
+    return updateWorkflowGates(config, (gates) => {
+        const skills = { ...gates.skills };
+        delete skills[skillName];
+        return {
+            ...gates,
+            skills,
+        };
+    });
+}
+function setExecTarget(config, targetId, target) {
+    return updateWorkflowGates(config, (gates) => ({
+        ...gates,
+        execTargets: {
+            ...gates.execTargets,
+            [targetId]: target,
+        },
+    }));
+}
+function unsetExecTarget(config, targetId) {
+    return updateWorkflowGates(config, (gates) => {
+        const execTargets = { ...gates.execTargets };
+        delete execTargets[targetId];
+        return {
+            ...gates,
+            execTargets,
+        };
+    });
+}
+async function readEffectiveConfig(context, dependencies) {
+    const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+    const userConfigDir = join(context.home, '.oat');
+    return dependencies.resolveEffectiveConfig(repoRoot, userConfigDir, dependencies.processEnv);
+}
+function sortedExecTargetEntries(registry) {
+    return Object.entries(registry)
+        .map(([id, target]) => ({ id, target }))
+        .sort((left, right) => {
+        const priority = right.target.priority - left.target.priority;
+        return priority === 0 ? left.id.localeCompare(right.id) : priority;
+    });
+}
+function cloneExecTarget(target) {
+    return {
+        runtime: target.runtime,
+        baseCommand: [...target.baseCommand],
+        priority: target.priority,
+        ...(target.hostDetectionCommand
+            ? { hostDetectionCommand: [...target.hostDetectionCommand] }
+            : {}),
+        ...(target.availabilityCommand
+            ? { availabilityCommand: [...target.availabilityCommand] }
+            : {}),
+    };
+}
+function argvHead(argv) {
+    return [argv[0] ?? '', argv.slice(1)];
+}
+function listExecTargetCandidates(registry, currentRuntime, avoid) {
+    const shouldAvoidSameRuntime = avoid === 'same-runtime' && currentRuntime !== 'unknown';
+    return sortedExecTargetEntries(registry)
+        .filter(({ target }) => !shouldAvoidSameRuntime || target.runtime !== currentRuntime)
+        .map(({ id, target }) => ({ id, target: cloneExecTarget(target) }));
+}
+export function selectExecTarget(registry, currentRuntime, avoid) {
+    return listExecTargetCandidates(registry, currentRuntime, avoid)[0] ?? null;
+}
+async function checkArgv(argv, purpose, context, dependencies) {
+    const [command, args] = argvHead(argv);
+    if (!command) {
+        return false;
+    }
+    try {
+        const result = await dependencies.runProcess(command, args, {
+            cwd: context.cwd,
+            env: dependencies.processEnv,
+            purpose,
+            stdio: 'ignore',
+        });
+        return result.exitCode === 0;
+    }
+    catch {
+        return false;
+    }
+}
+async function resolveCurrentRuntime(currentRuntime, context, dependencies) {
+    const override = currentRuntime?.trim();
+    if (override) {
+        return override;
+    }
+    for (const { target } of sortedExecTargetEntries(BUILTIN_EXEC_TARGETS)) {
+        if (target.hostDetectionCommand &&
+            (await checkArgv(target.hostDetectionCommand, 'host-detection', context, dependencies))) {
+            return target.runtime;
+        }
+    }
+    return 'unknown';
+}
+async function selectAvailableExecTarget(registry, currentRuntime, avoid, context, dependencies) {
+    for (const candidate of listExecTargetCandidates(registry, currentRuntime, avoid)) {
+        const availabilityCommand = candidate.target.availabilityCommand;
+        if (!availabilityCommand ||
+            (await checkArgv(availabilityCommand, 'availability', context, dependencies))) {
+            return candidate;
+        }
+    }
+    return null;
+}
+async function executeTarget(selected, prompt, context, dependencies) {
+    const [command, baseArgs] = argvHead(selected.target.baseCommand);
+    if (!command) {
+        throw new Error(`Exec target "${selected.id}" has an empty base command.`);
+    }
+    try {
+        const result = await dependencies.runProcess(command, [...baseArgs, ...prompt], {
+            cwd: context.cwd,
+            env: dependencies.processEnv,
+            purpose: 'execute',
+            stdio: 'inherit',
+        });
+        return result.exitCode;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Failed to launch exec target "${selected.id}" (${command}): ${message}`, { cause: error });
+    }
+}
+function noEligibleTargetMessage(currentRuntime, avoid) {
+    return `No eligible gate exec target found for current runtime "${currentRuntime}" with --avoid ${avoid}. Install or configure an alternate runtime, rerun with --avoid none, or pin a target with --target <id>.`;
+}
+async function updateConfigLayer(context, layer, dependencies, mutate) {
+    const repoRoot = await dependencies.resolveProjectRoot(context.cwd);
+    const userConfigDir = join(context.home, '.oat');
+    if (layer === 'shared') {
+        const config = await dependencies.readOatConfig(repoRoot);
+        await dependencies.writeOatConfig(repoRoot, mutate(config));
+        return;
+    }
+    if (layer === 'local') {
+        const config = await dependencies.readOatLocalConfig(repoRoot);
+        await dependencies.writeOatLocalConfig(repoRoot, mutate(config));
+        return;
+    }
+    const config = await dependencies.readUserConfig(userConfigDir);
+    await dependencies.writeUserConfig(userConfigDir, mutate(config));
+}
+async function runResolve(skillName, context, dependencies) {
+    try {
+        const effective = await readEffectiveConfig(context, dependencies);
+        writeJsonValue(context, resolveGate(effective, skillName));
+        process.exitCode = 0;
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+async function runGateSet(skillName, options, context, dependencies) {
+    try {
+        const layer = parseLayer(options.layer);
+        const normalizedSkill = trimRequired(skillName, '<skill>');
+        const gate = parseGateConfig(options);
+        await updateConfigLayer(context, layer, dependencies, (config) => setSkillGate(config, normalizedSkill, gate));
+        writeSuccess(context, { layer, skill: normalizedSkill, gate });
+        process.exitCode = 0;
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+async function runGateUnset(skillName, options, context, dependencies) {
+    try {
+        const layer = parseLayer(options.layer);
+        const normalizedSkill = trimRequired(skillName, '<skill>');
+        await updateConfigLayer(context, layer, dependencies, (config) => unsetSkillGate(config, normalizedSkill));
+        writeSuccess(context, { layer, skill: normalizedSkill });
+        process.exitCode = 0;
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+async function runTargetSet(targetId, options, context, dependencies) {
+    try {
+        const layer = parseLayer(options.layer);
+        const normalizedTargetId = trimRequired(targetId, '<id>');
+        const target = parseExecTargetConfig(options);
+        await updateConfigLayer(context, layer, dependencies, (config) => setExecTarget(config, normalizedTargetId, target));
+        writeSuccess(context, { layer, target: normalizedTargetId, value: target });
+        process.exitCode = 0;
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+async function runTargetUnset(targetId, options, context, dependencies) {
+    try {
+        const layer = parseLayer(options.layer);
+        const normalizedTargetId = trimRequired(targetId, '<id>');
+        await updateConfigLayer(context, layer, dependencies, (config) => unsetExecTarget(config, normalizedTargetId));
+        writeSuccess(context, { layer, target: normalizedTargetId });
+        process.exitCode = 0;
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+async function runCrossProviderExec(prompt, options, context, dependencies) {
+    try {
+        const effective = await readEffectiveConfig(context, dependencies);
+        const targets = resolveExecTargets(effective);
+        const explicitTarget = options.target?.trim();
+        if (explicitTarget) {
+            const target = targets[explicitTarget];
+            if (!target) {
+                throw new Error(`Unknown exec target "${explicitTarget}".`);
+            }
+            process.exitCode = await executeTarget({ id: explicitTarget, target: cloneExecTarget(target) }, prompt, context, dependencies);
+            return;
+        }
+        const avoid = parseCrossProviderAvoid(options.avoid);
+        const currentRuntime = await resolveCurrentRuntime(options.currentRuntime, context, dependencies);
+        const selected = await selectAvailableExecTarget(targets, currentRuntime, avoid, context, dependencies);
+        if (!selected) {
+            throw new Error(noEligibleTargetMessage(currentRuntime, avoid));
+        }
+        process.exitCode = await executeTarget(selected, prompt, context, dependencies);
+    }
+    catch (error) {
+        writeError(context, error);
+    }
+}
+export function createGateCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    const cmd = new Command('gate').description('Resolve and manage workflow gate configuration');
+    cmd
+        .command('resolve')
+        .description('Print the resolved gate configuration for a skill')
+        .argument('<skill>', 'Gate-aware skill name')
+        .action(async (skillName, _options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runResolve(skillName, context, dependencies);
+    });
+    cmd
+        .command('set')
+        .description('Set a skill gate in a concrete config layer')
+        .argument('<skill>', 'Gate-aware skill name')
+        .option('--command <command>', 'Gate command to run')
+        .option('--description <description>', 'Gate purpose and follow-up notes')
+        .option('--on-failure <mode>', 'Failure behavior: block, prompt, or warn')
+        .option('--max-attempts <count>', 'Maximum block remediation attempts')
+        .option('--disable', 'Disable this skill gate in the selected layer')
+        .option('--layer <layer>', 'Config layer to write: shared, local, or user')
+        .action(async (skillName, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runGateSet(skillName, options, context, dependencies);
+    });
+    cmd
+        .command('unset')
+        .description('Remove a skill gate entry from a concrete config layer')
+        .argument('<skill>', 'Gate-aware skill name')
+        .option('--layer <layer>', 'Config layer to write: shared, local, or user')
+        .action(async (skillName, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runGateUnset(skillName, options, context, dependencies);
+    });
+    cmd
+        .command('cross-provider-exec')
+        .description('Run a prompt through an alternate configured runtime target')
+        .option('--target <id>', 'Run this exact exec target')
+        .option('--avoid <mode>', 'Avoidance mode: same-runtime or none')
+        .option('--current-runtime <runtime>', 'Override detected runtime for testing or manual routing')
+        .argument('<prompt...>', 'Prompt arguments appended to the target command')
+        .action(async (prompt, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runCrossProviderExec(prompt, options, context, dependencies);
+    });
+    const target = new Command('target').description('Manage gate execution targets');
+    target
+        .command('set')
+        .description('Set an exec target in a concrete config layer')
+        .argument('<id>', 'Exec target id')
+        .option('--runtime <runtime>', 'Logical runtime family')
+        .option('--base-command-json <json>', 'JSON argv array for the base command')
+        .option('--host-detection-json <json>', 'JSON argv array for host detection')
+        .option('--availability-json <json>', 'JSON argv array for availability')
+        .option('--priority <number>', 'Target priority, higher wins')
+        .option('--disable', 'Disable this exec target in the selected layer')
+        .option('--layer <layer>', 'Config layer to write: shared, local, or user')
+        .action(async (targetId, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runTargetSet(targetId, options, context, dependencies);
+    });
+    target
+        .command('unset')
+        .description('Remove an exec target entry from a concrete config layer')
+        .argument('<id>', 'Exec target id')
+        .option('--layer <layer>', 'Config layer to write: shared, local, or user')
+        .action(async (targetId, options, command) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        await runTargetUnset(targetId, options, context, dependencies);
+    });
+    cmd.addCommand(target);
+    return cmd;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAsBvD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyBzC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0BvD"}

package/dist/commands/index.js

@@ -1,9 +1,11 @@
+import { applyHelpConfiguration } from '../app/help-config.js';
 import { createBacklogCommand } from './backlog/index.js';
 import { createCleanupCommand } from './cleanup/index.js';
 import { createConfigCommand } from './config/index.js';
 import { createDecisionCommand } from './decision/index.js';
 import { createDocsCommand } from './docs/index.js';
 import { createDoctorCommand } from './doctor/index.js';
+import { createGateCommand } from './gate/index.js';
 import { createIndexCommand } from './index-cmd/index.js';
 import { createInitCommand } from './init/index.js';
 import { createInstructionsCommand } from './instructions/index.js';
@@ -26,6 +28,7 @@ export function registerCommands(program) {
     program.addCommand(createStatusCommand());
     program.addCommand(createSyncCommand());
     program.addCommand(createConfigCommand());
+    program.addCommand(createGateCommand());
     program.addCommand(createLocalCommand());
     program.addCommand(createProvidersCommand());
     program.addCommand(createRemoveCommand());
@@ -41,4 +44,7 @@ export function registerCommands(program) {
     program.addCommand(createStateCommand());
     program.addCommand(createToolsCommand());
     program.addCommand(createInternalCommand());
+    // Commander's .addCommand() does not inherit help config from the parent.
+    // Apply showGlobalOptions recursively after all commands are registered.
+    applyHelpConfiguration(program);
 }

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/init/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,KAAK,kBAAkB,EAExB,MAAM,0BAA0B,CAAC;AAalC,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,YAAY,EAGlB,MAAM,iCAAiC,CAAC;AAKzC,OAAO,EAGL,KAAK,UAAU,EAEhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAEL,KAAK,SAAS,EAKf,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,WAAW,EAAgB,MAAM,cAAc,CAAC;AAC9D,OAAO,EAEL,KAAK,cAAc,EAEnB,KAAK,eAAe,EAKrB,MAAM,eAAe,CAAC;AASvB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAUzD,OAAO,EACL,KAAK,yBAAyB,EAI9B,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,aAAa,EAAS,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAE5B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,KAAK,QAAQ,EAGd,MAAM,SAAS,CAAC;AAyBjB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,EAAE,YAAY,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,UAAU,gBAAgB;IACxB,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,cAAc,KACpB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,mBAAmB,EAAE,CACnB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,KACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1D,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,KACjB,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/B,aAAa,EAAE,CACb,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,cAAc,EAAE,EAClC,cAAc,CAAC,EAAE,eAAe,EAAE,KAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACnC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,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,wBAAwB,EAAE,CAAC,CAAC,SAAS,MAAM,EACzC,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,UAAU,EAAE,CACV,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAE,KACrC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvB,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,kBAAkB,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,uBAAuB,EAAE,CACvB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,WAAW,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACtD,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,EAAE,MAAM,eAAe,EAAE,CAAC;IACrC,cAAc,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D,cAAc,EAAE,CACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,eAAe,EAAE,EAC3B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACxC,qBAAqB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,iBAAiB,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,MAAM,EAAE,CAAC;IACnD,aAAa,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,KACZ,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACjD,cAAc,EAAE,CACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAAE,KACjB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjC,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,mBAAmB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAClD,kBAAkB,EAAE,CAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,sBAAsB,KACzB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,gBAAgB,EAAE,CAChB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC5B,eAAe,EAAE,CAAC,CAAC,SAAS,MAAM,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,cAAc,EAAE,CACd,OAAO,EAAE,cAAc,EACvB,YAAY,EAAE,gBAAgB,KAC3B,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,YAAY,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAwxBD,wBAAgB,iBAAiB,CAC/B,SAAS,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACxC,OAAO,CAiBT"}

package/dist/commands/init/index.js

@@ -8,6 +8,7 @@ import { addLocalPaths } from '../local/manage.js';
 import { adoptStrayToCanonical, isAdoptionConflictError, } from '../shared/adopt-stray.js';
 import { detectCodexRoleStrays, regenerateCodexAfterAdoption, } from '../shared/codex-strays.js';
 import { PROVIDER_CONFIG_REMEDIATION } from '../shared/messages.js';
+import { withScopeOption } from '../shared/scope-option.js';
 import { confirmAction, inputWithDefault, selectManyWithAbort, selectWithAbort, } from '../shared/shared.prompts.js';
 import { readGlobalOptions, resolveConcreteScopes, } from '../shared/shared.utils.js';
 import { DEFAULT_SYNC_CONFIG, loadSyncConfig, saveSyncConfig, } from '../../config/index.js';
@@ -565,7 +566,7 @@ export function createInitCommand(overrides = {}) {
         ...createDependencies(),
         ...overrides,
     };
-    return new Command('init')
+    return withScopeOption(new Command('init'))
         .description('Initialize canonical directories, manifest, and tool packs')
         .option('--hook', 'Install optional pre-commit hook')
         .option('--no-hook', 'Skip optional pre-commit hook install')

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/brainstorm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAM9B,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,UAAU,+BAA+B;IACvC,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,iBAAiB,EAAE,CACjB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AA+KD,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,OAAO,CAAC,+BAA+B,CAAM,GACvD,OAAO,CA2BT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/brainstorm/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAEL,KAAK,wBAAwB,EAC7B,KAAK,uBAAuB,EAC7B,MAAM,sBAAsB,CAAC;AAM9B,KAAK,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEvC,UAAU,+BAA+B;IACvC,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,iBAAiB,EAAE,CACjB,OAAO,EAAE,wBAAwB,KAC9B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACtC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE,SAAS,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AA+KD,wBAAgB,gCAAgC,CAC9C,SAAS,GAAE,OAAO,CAAC,+BAA+B,CAAM,GACvD,OAAO,CA2BT"}

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

@@ -1,5 +1,6 @@
 import { buildCommandContext, } from '../../../../app/command-context.js';
 import { resolvePackDefaultScope } from '../../../init/tools/shared/skill-manifest.js';
+import { withScopeOption } from '../../../shared/scope-option.js';
 import { confirmAction, } from '../../../shared/shared.prompts.js';
 import { readGlobalOptions } from '../../../shared/shared.utils.js';
 import { canonicalPathsForPack, setInstalledCanonicalPaths, } from '../../../tools/shared/install-sync-context.js';
@@ -132,7 +133,7 @@ export function createInitToolsBrainstormCommand(overrides = {}) {
         ...DEFAULT_DEPENDENCIES,
         ...overrides,
     };
-    return new Command('brainstorm')
+    return withScopeOption(new Command('brainstorm'))
         .description('Install OAT brainstorm skill (always-on entry point with visual companion)')
         .option('--force', 'Overwrite existing files where applicable')
         .action(async (options, command) => {

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,WAAW,EAEX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAMxB,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1E;AAqED,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAkBT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,sBAAsB,CAAC;AAQ9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,WAAW,EAEX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAC;AAMxB,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,cAAc,CAAC;IAChE,gBAAgB,EAAE,CAChB,KAAK,EAAE,SAAS,GAAG,MAAM,EACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACT,MAAM,CAAC;IACZ,iBAAiB,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IACzC,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC1E;AAqED,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAsCT"}

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

@@ -65,6 +65,24 @@ export function createInitToolsCoreCommand(overrides = {}) {
         .option('--force', 'Overwrite existing files where applicable')
         .action(async (options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        // Core always installs at user scope. If the caller explicitly passed a
+        // conflicting --scope on an ancestor (init or tools install), reject it
+        // rather than silently ignoring it. A matching --scope user, or no
+        // explicit --scope, proceeds unchanged.
+        if (command.getOptionValueSourceWithGlobals('scope') === 'cli') {
+            const opts = command.optsWithGlobals();
+            if (opts.scope !== 'user') {
+                const msg = 'the core pack always installs at user scope; remove --scope or pass --scope user';
+                if (context.json) {
+                    context.logger.json({ status: 'error', message: msg });
+                }
+                else {
+                    context.logger.error(msg);
+                }
+                process.exitCode = 1;
+                return;
+            }
+        }
         const didInstall = await runInitToolsCore(context, options, dependencies);
         if (didInstall) {
             setInstalledCanonicalPaths(command, canonicalPathsForPack('core'));

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

@@ -1 +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;AAQzC,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;AAuID,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAeT"}
+{"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;AAE9B,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAEnB,MAAM,iCAAiC,CAAC;AAQzC,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;AAuID,wBAAgB,0BAA0B,CACxC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CAeT"}

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

@@ -1,4 +1,5 @@
 import { buildCommandContext, } from '../../../../app/command-context.js';
+import { withScopeOption } from '../../../shared/scope-option.js';
 import { confirmAction, selectManyWithAbort, } from '../../../shared/shared.prompts.js';
 import { readGlobalOptions } from '../../../shared/shared.utils.js';
 import { canonicalSkillPaths, setInstalledCanonicalPaths, } from '../../../tools/shared/install-sync-context.js';
@@ -102,7 +103,7 @@ export function createInitToolsDocsCommand(overrides = {}) {
         ...DEFAULT_DEPENDENCIES,
         ...overrides,
     };
-    return new Command('docs')
+    return withScopeOption(new Command('docs'))
         .description('Install OAT docs workflow skills')
         .option('--force', 'Overwrite existing files where applicable')
         .action(async (options, command) => {

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

@@ -1 +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;AAQzC,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;AAuGD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAsBT"}
+{"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;AAE9B,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,iCAAiC,CAAC;AAQzC,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;AAuGD,wBAAgB,2BAA2B,CACzC,SAAS,GAAE,OAAO,CAAC,0BAA0B,CAAM,GAClD,OAAO,CAsBT"}