@open-agent-toolkit/cli 0.0.61 → 0.0.64

package/assets/skills/oat-idea-ideate/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: oat-idea-ideate
-version: 1.2.0
-description: Use when continuing brainstorming for an existing idea or starting from a scratchpad entry. Guides conversational ideation and refinement.
+version: 1.2.1
+description: Use when continuing an existing tracked idea or expanding an explicit scratchpad seed from {IDEAS_ROOT}/scratchpad.md. Do NOT use to start a brand-new, destinationless brainstorm; use oat-brainstorm for that.
 argument-hint: '[--global]'
 disable-model-invocation: true
 user-invocable: true
@@ -10,13 +10,13 @@ allowed-tools: Read, Write, Bash, Glob, AskUserQuestion
 
 # Ideate
 
-Resume brainstorming on an existing idea, or pick one from the scratchpad to start exploring.
+Resume brainstorming on an existing tracked idea, or expand an explicit scratchpad seed into a tracked idea before continuing ideation.
 
 ## Mode Assertion
 
 **OAT MODE: Ideation**
 
-**Purpose:** Lightweight brainstorming through natural, exploratory conversation. Capture the essence of an idea without formal structure or implementation detail.
+**Purpose:** Lightweight brainstorming through natural, exploratory conversation for an idea record that already exists or for a scratchpad seed the user explicitly selects. Capture the essence of that tracked idea without formal structure or implementation detail.
 
 **BLOCKED Activities:**
 
@@ -25,6 +25,7 @@ Resume brainstorming on an existing idea, or pick one from the scratchpad to sta
 - No technical designs or architecture
 - No task breakdowns or plans
 - No forced structure — let the idea breathe
+- No brand-new destinationless brainstorm activation. Use `oat-brainstorm` when the user says "let's brainstorm", "brainstorm this", or otherwise opens exploratory discussion without naming an existing idea or scratchpad seed.
 
 **ALLOWED Activities:**
 
@@ -41,6 +42,7 @@ If you catch yourself:
 - Writing implementation details → STOP (capture as an Open Question instead)
 - Formalizing requirements → STOP (keep it conversational)
 - Creating structured deliverables → STOP (save for project workflow)
+- Treating a generic brainstorm request as a scratchpad entry → STOP. Scratchpad mode requires an actual unchecked entry in `{IDEAS_ROOT}/scratchpad.md` or an explicit user reference to one.
 
 **Recovery:**
 
@@ -90,6 +92,8 @@ Determine whether to operate at project level or user (global) level.
 
 ### Step 1: Resolve Active Idea
 
+This skill is a resume / expand flow, not a blank-slate brainstorm entry point. If the user has only asked to brainstorm and has not named an existing idea, an active idea, or a scratchpad seed, stop and route to `oat-brainstorm`.
+
 Read `activeIdea` from config:
 
 ```bash

package/assets/skills/oat-pjm-add-backlog-item/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: oat-pjm-add-backlog-item
-version: 1.1.0
+version: 1.1.1
 description: Use when the user requests or confirms adding a new repo backlog item — e.g. "add a backlog item for X", "capture that as backlog", "track that follow-up", "file a backlog ticket", or confirms a previously offered backlog capture. Do NOT auto-invoke when a follow-up is mentioned. Creates the item file in the file-per-item backlog structure, regenerates the index, and prompts for curated overview updates.
+disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
 ---

package/assets/skills/oat-pjm-update-repo-reference/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: oat-pjm-update-repo-reference
-version: 1.1.0
+version: 1.1.1
 description: Use when repo reference artifacts need updating — roadmap, decision records, backlog status, or completed history. Frequently invoked at project completion, often chained from `oat-project-document`, to ensure `.oat/repo/reference/` state reflects what shipped.
+disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash, Glob, Grep, AskUserQuestion
 ---

package/assets/skills/oat-project-document/SKILL.md

@@ -1,8 +1,9 @@
 ---
 name: oat-project-document
-version: 1.4.0
+version: 1.4.1
 description: Use when the user requests or confirms documenting an active OAT project — e.g. "document the project", "update the docs", "run oat-project-document", or confirms a previously offered documentation run. Do NOT auto-invoke when implementation completes. Analyzes project artifacts, presents a documentation delta plan, and applies approved changes.
 argument-hint: '[project-path] [--auto]'
+disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Edit, Bash(git:*), Glob, Grep, AskUserQuestion, Skill
 ---

package/assets/skills/oat-project-pr-final/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: oat-project-pr-final
-version: 1.4.0
+version: 1.4.1
 description: Use when the user requests or confirms opening the final PR for an active OAT project — e.g. "open the final PR", "ship it", "run oat-project-pr-final", or confirms a previously offered final-PR step. Do NOT auto-invoke when phases are marked complete. Generates the final lifecycle PR description from artifacts and creates the PR.
+disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
 ---

package/assets/skills/oat-project-spec/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: oat-project-spec
-version: 2.0.0
-description: Optional standalone skill for formalizing requirements into a structured spec.md when discovery is complete but you're not ready to design yet. Independent of the design workflow — oat-project-design confirms requirements automatically and does not require this skill to be run first.
+version: 2.0.1
+description: Use when discovery is complete but you're not ready to design yet, and you want to formalize requirements into a structured spec.md as an optional standalone step. Independent of the design workflow — oat-project-design confirms requirements automatically and does not require this skill to be run first.
 disable-model-invocation: true
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion

package/assets/skills/oat-project-summary/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: oat-project-summary
-version: 1.1.0
+version: 1.1.1
 description: Use when the user requests or confirms summarizing an active OAT project — e.g. "summarize the project", "generate the summary", "run oat-project-summary", or confirms a previously offered summary run. Do NOT auto-invoke when implementation completes. Generates summary.md from project artifacts as institutional memory.
+disable-model-invocation: false
 user-invocable: true
 allowed-tools: Read, Write, Bash(git:*), Glob, Grep, AskUserQuestion
 ---

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,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;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAwmCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGhF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,cAAc,EAGnB,KAAK,UAAU,EAOhB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,cAAc,EAEpB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyDpC,UAAU,yBAAyB;IACjC,mBAAmB,EAAE,CACnB,OAAO,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC,KAC/C,cAAc,CAAC;IACpB,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,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;IACvE,kBAAkB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAClE,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,cAAc,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/D,eAAe,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,mBAAmB,EAAE,CACnB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;IACrB,sBAAsB,EAAE,CACtB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,GAAG,EAAE,MAAM,CAAC,UAAU,KACnB,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC;CAC/B;AAonCD,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,OAAO,CAAC,yBAAyB,CAAM,GACjD,OAAO,CA0GT"}

package/dist/commands/config/index.js

@@ -24,6 +24,7 @@ const KEY_ORDER = [
     'documentation.requireForProjectCompletion',
     'git.defaultBranch',
     'projects.root',
+    'tools.brainstorm',
     'tools.core',
     'tools.docs',
     'tools.ideas',
@@ -196,6 +197,17 @@ const CONFIG_CATALOG = [
         owningCommand: 'oat config set archive.awsRegion <value>',
         description: 'AWS region forwarded as AWS_REGION to every `aws` invocation made by the archive S3 sync (completion + `oat project archive sync`). Precedence: per-invocation flag > existing shell env > this config value.',
     },
+    {
+        key: 'tools.brainstorm',
+        group: 'Shared Repo (.oat/config.json)',
+        file: '.oat/config.json',
+        scope: 'shared repo',
+        type: 'boolean',
+        defaultValue: 'false',
+        mutability: 'read/write',
+        owningCommand: 'oat tools install / oat tools update',
+        description: 'Whether the brainstorm tool pack is installed.',
+    },
     {
         key: 'tools.core',
         group: 'Shared Repo (.oat/config.json)',

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

@@ -0,0 +1,22 @@
+import { type CommandContext, type GlobalOptions } from '../../../../app/command-context.js';
+import { type PromptContext } from '../../../shared/shared.prompts.js';
+import { type ScanToolsOptions } from '../../../tools/shared/scan-tools.js';
+import type { ToolInfo } from '../../../tools/shared/types.js';
+import { type OatConfig } from '../../../../config/oat-config.js';
+import { Command } from 'commander';
+import { type InstallBrainstormOptions, type InstallBrainstormResult } from './install-brainstorm.js';
+type InstallScope = 'project' | 'user';
+interface InitToolsBrainstormDependencies {
+    buildCommandContext: (options: GlobalOptions) => CommandContext;
+    resolveProjectRoot: (cwd: string) => Promise<string>;
+    resolveScopeRoot: (scope: InstallScope, cwd: string, home: string) => string;
+    resolveAssetsRoot: () => Promise<string>;
+    installBrainstorm: (options: InstallBrainstormOptions) => Promise<InstallBrainstormResult>;
+    confirmAction: (message: string, ctx: PromptContext) => Promise<boolean>;
+    scanTools: (options: ScanToolsOptions) => Promise<ToolInfo[]>;
+    readOatConfig: (repoRoot: string) => Promise<OatConfig>;
+    writeOatConfig: (repoRoot: string, config: OatConfig) => Promise<void>;
+}
+export declare function createInitToolsBrainstormCommand(overrides?: Partial<InitToolsBrainstormDependencies>): Command;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,145 @@
+import { buildCommandContext, } from '../../../../app/command-context.js';
+import { resolvePackDefaultScope } from '../../../init/tools/shared/skill-manifest.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';
+import { scanTools as defaultScanTools, } from '../../../tools/shared/scan-tools.js';
+import { readOatConfig as defaultReadOatConfig, writeOatConfig as defaultWriteOatConfig, } from '../../../../config/oat-config.js';
+import { resolveAssetsRoot } from '../../../../fs/assets.js';
+import { resolveProjectRoot, resolveScopeRoot } from '../../../../fs/paths.js';
+import { Command } from 'commander';
+import { installBrainstorm as defaultInstallBrainstorm, } from './install-brainstorm.js';
+const DEFAULT_DEPENDENCIES = {
+    buildCommandContext,
+    resolveProjectRoot,
+    resolveScopeRoot,
+    resolveAssetsRoot,
+    installBrainstorm: defaultInstallBrainstorm,
+    confirmAction,
+    scanTools: defaultScanTools,
+    readOatConfig: defaultReadOatConfig,
+    writeOatConfig: defaultWriteOatConfig,
+};
+async function resolveInstallScope(context, projectRoot, userRoot, assetsRoot, dependencies) {
+    // Honor explicit --scope before any existing-install or default
+    // resolution so callers can always override.
+    if (context.scope === 'project') {
+        return { scope: 'project', source: 'explicit' };
+    }
+    if (context.scope === 'user') {
+        return { scope: 'user', source: 'explicit' };
+    }
+    // Existing-install detection MUST short-circuit before PACK_METADATA
+    // defaultScope is consulted, so re-installing a pack already placed at
+    // a particular scope never silently migrates the user across scopes.
+    const [projectTools, userTools] = await Promise.all([
+        dependencies.scanTools({
+            scope: 'project',
+            scopeRoot: projectRoot,
+            assetsRoot,
+        }),
+        dependencies.scanTools({
+            scope: 'user',
+            scopeRoot: userRoot,
+            assetsRoot,
+        }),
+    ]);
+    const installedAtProject = projectTools.some((tool) => tool.pack === 'brainstorm');
+    const installedAtUser = userTools.some((tool) => tool.pack === 'brainstorm');
+    if (installedAtProject) {
+        return { scope: 'project', source: 'existing-install' };
+    }
+    if (installedAtUser) {
+        return { scope: 'user', source: 'existing-install' };
+    }
+    return {
+        scope: resolvePackDefaultScope('brainstorm'),
+        source: 'pack-default',
+    };
+}
+function getCountSummary(result) {
+    return {
+        skills: `copied=${result.copiedSkills.length}, updated=${result.updatedSkills.length}, skipped=${result.skippedSkills.length}`,
+    };
+}
+function reportSuccess(context, scope, targetRoot, assetsRoot, result) {
+    if (context.json) {
+        context.logger.json({
+            status: 'ok',
+            scope,
+            targetRoot,
+            assetsRoot,
+            result,
+        });
+        return;
+    }
+    const counts = getCountSummary(result);
+    context.logger.info('Installed brainstorm tool pack.');
+    context.logger.info(`Scope: ${scope}`);
+    context.logger.info(`Target root: ${targetRoot}`);
+    context.logger.info(`Skills: ${counts.skills}`);
+    context.logger.info(`Run: oat sync --scope ${scope}`);
+}
+async function persistConfigAfterInstall(projectRoot, dependencies) {
+    const config = await dependencies.readOatConfig(projectRoot);
+    const tools = { ...(config.tools ?? {}), brainstorm: true };
+    await dependencies.writeOatConfig(projectRoot, { ...config, tools });
+}
+async function runInitToolsBrainstorm(context, options, dependencies) {
+    try {
+        const projectRoot = await dependencies.resolveProjectRoot(context.cwd);
+        const userRoot = dependencies.resolveScopeRoot('user', context.cwd, context.home);
+        const assetsRoot = await dependencies.resolveAssetsRoot();
+        const { scope } = await resolveInstallScope(context, projectRoot, userRoot, assetsRoot, dependencies);
+        const targetRoot = scope === 'project' ? projectRoot : userRoot;
+        if (options.force && context.interactive) {
+            const confirmed = await dependencies.confirmAction(`Force overwrite existing brainstorm assets in ${scope} scope?`, { interactive: context.interactive });
+            if (!confirmed) {
+                if (!context.json) {
+                    context.logger.info('Cancelled: no files were overwritten.');
+                }
+                process.exitCode = 0;
+                return false;
+            }
+        }
+        const result = await dependencies.installBrainstorm({
+            assetsRoot,
+            targetRoot,
+            force: options.force,
+        });
+        // Persist tools.brainstorm: true to .oat/config.json after a
+        // successful install so config-write semantics match the main
+        // installer flow used by `oat init tools`.
+        await persistConfigAfterInstall(projectRoot, dependencies);
+        reportSuccess(context, scope, targetRoot, assetsRoot, result);
+        process.exitCode = 0;
+        return true;
+    }
+    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;
+        return false;
+    }
+}
+export function createInitToolsBrainstormCommand(overrides = {}) {
+    const dependencies = {
+        ...DEFAULT_DEPENDENCIES,
+        ...overrides,
+    };
+    return 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) => {
+        const context = dependencies.buildCommandContext(readGlobalOptions(command));
+        const didInstall = await runInitToolsBrainstorm(context, options, dependencies);
+        if (didInstall) {
+            setInstalledCanonicalPaths(command, canonicalPathsForPack('brainstorm'));
+        }
+    });
+}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"install-brainstorm.d.ts","sourceRoot":"","sources":["../../../../../src/commands/init/tools/brainstorm/install-brainstorm.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAE/E,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,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,iBAAiB,CACrC,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,uBAAuB,CAAC,CAqClC"}

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

@@ -0,0 +1,37 @@
+import { join } from 'node:path';
+import { copyDirWithVersionCheck } from '../../../init/tools/shared/copy-helpers.js';
+import { BRAINSTORM_SKILLS } from '../../../init/tools/shared/skill-manifest.js';
+export { BRAINSTORM_SKILLS };
+export async function installBrainstorm(options) {
+    const force = options.force ?? false;
+    const result = {
+        copiedSkills: [],
+        updatedSkills: [],
+        skippedSkills: [],
+        outdatedSkills: [],
+    };
+    for (const skill of BRAINSTORM_SKILLS) {
+        const source = join(options.assetsRoot, 'skills', skill);
+        const destination = join(options.targetRoot, '.agents', 'skills', skill);
+        // The visual-companion bundle (scripts/, references/) ships under the
+        // skill directory and copies along with it via copyDirWithVersionCheck.
+        const copyResult = await copyDirWithVersionCheck(source, destination, force);
+        if (copyResult.status === 'copied') {
+            result.copiedSkills.push(skill);
+        }
+        else if (copyResult.status === 'updated') {
+            result.updatedSkills.push(skill);
+        }
+        else if (copyResult.status === 'outdated') {
+            result.outdatedSkills.push({
+                name: skill,
+                installed: copyResult.installedVersion ?? null,
+                bundled: copyResult.bundledVersion ?? null,
+            });
+        }
+        else {
+            result.skippedSkills.push(skill);
+        }
+    }
+    return result;
+}

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

@@ -6,6 +6,7 @@ import type { ToolInfo } from '../../tools/shared/types.js';
 import { type OatConfig } from '../../../config/oat-config.js';
 import type { ConcreteScope } from '../../../shared/types.js';
 import { Command } from 'commander';
+import { type InstallBrainstormOptions, type InstallBrainstormResult } from './brainstorm/install-brainstorm.js';
 import { type InstallCoreOptions, type InstallCoreResult } from './core/install-core.js';
 import { type InstallDocsOptions, type InstallDocsResult } from './docs/install-docs.js';
 import { type InstallIdeasOptions, type InstallIdeasResult } from './ideas/install-ideas.js';
@@ -15,7 +16,7 @@ import { type InstallUtilityOptions, type InstallUtilityResult } from './utility
 import { type InstallWorkflowsOptions, type InstallWorkflowsResult } from './workflows/install-workflows.js';
 type InstallScope = 'project' | 'user';
 type PackInstallTarget = InstallScope | 'both';
-export type ToolPack = 'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research';
+export type ToolPack = 'core' | 'ideas' | 'docs' | 'workflows' | 'utility' | 'project-management' | 'research' | 'brainstorm';
 export interface InitToolsDependencies {
     buildCommandContext: (options: GlobalOptions) => CommandContext;
     resolveProjectRoot: (cwd: string) => Promise<string>;
@@ -31,6 +32,7 @@ export interface InitToolsDependencies {
     installUtility: (options: InstallUtilityOptions) => Promise<InstallUtilityResult>;
     installProjectManagement: (options: InstallProjectManagementOptions) => Promise<InstallProjectManagementResult>;
     installResearch: (options: InstallResearchOptions) => Promise<InstallResearchResult>;
+    installBrainstorm: (options: InstallBrainstormOptions) => Promise<InstallBrainstormResult>;
     copyDirWithStatus: (source: string, destination: string, force: boolean) => Promise<'copied' | 'updated' | 'skipped'>;
     removeDirectory: (target: string) => Promise<void>;
     removeFile: (target: string) => Promise<void>;

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

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

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

@@ -13,6 +13,8 @@ import { readOatConfig, resolveLocalPaths, writeOatConfig, } from '../../../conf
 import { resolveAssetsRoot } from '../../../fs/assets.js';
 import { resolveProjectRoot, resolveScopeRoot } from '../../../fs/paths.js';
 import { Command } from 'commander';
+import { createInitToolsBrainstormCommand } from './brainstorm/index.js';
+import { installBrainstorm as defaultInstallBrainstorm, } from './brainstorm/install-brainstorm.js';
 import { createInitToolsCoreCommand } from './core/index.js';
 import { installCore as defaultInstallCore, } from './core/install-core.js';
 import { createInitToolsDocsCommand } from './docs/index.js';
@@ -24,7 +26,7 @@ import { createInitToolsProjectManagementCommand } from './project-management/in
 import { installProjectManagement as defaultInstallProjectManagement, } from './project-management/install-project-management.js';
 import { createInitToolsResearchCommand } from './research/index.js';
 import { installResearch as defaultInstallResearch, } from './research/install-research.js';
-import { DOCS_SKILLS, IDEA_SKILLS, RESEARCH_AGENTS, RESEARCH_SKILLS, UTILITY_SKILLS, } from './shared/skill-manifest.js';
+import { BRAINSTORM_SKILLS, DOCS_SKILLS, IDEA_SKILLS, RESEARCH_AGENTS, RESEARCH_SKILLS, UTILITY_SKILLS, resolvePackDefaultScope, } from './shared/skill-manifest.js';
 import { createInitToolsUtilityCommand } from './utility/index.js';
 import { installUtility as defaultInstallUtility, } from './utility/install-utility.js';
 import { createInitToolsWorkflowsCommand } from './workflows/index.js';
@@ -40,6 +42,7 @@ const ALL_TOOL_PACKS = [
     'utility',
     'project-management',
     'research',
+    'brainstorm',
 ];
 const USER_ELIGIBLE_PACK_MEMBERS = {
     ideas: {
@@ -58,6 +61,10 @@ const USER_ELIGIBLE_PACK_MEMBERS = {
         skills: RESEARCH_SKILLS,
         agents: RESEARCH_AGENTS,
     },
+    brainstorm: {
+        skills: BRAINSTORM_SKILLS,
+        agents: [],
+    },
 };
 let lastRunInitToolsMetadata = null;
 const DEFAULT_DEPENDENCIES = {
@@ -75,6 +82,7 @@ const DEFAULT_DEPENDENCIES = {
     installUtility: defaultInstallUtility,
     installProjectManagement: defaultInstallProjectManagement,
     installResearch: defaultInstallResearch,
+    installBrainstorm: defaultInstallBrainstorm,
     copyDirWithStatus,
     removeDirectory: async (target) => {
         await rm(target, { recursive: true, force: true });
@@ -104,6 +112,7 @@ const USER_ELIGIBLE_PACKS = new Set([
     'docs',
     'utility',
     'research',
+    'brainstorm',
 ]);
 function isUserEligiblePack(pack) {
     return USER_ELIGIBLE_PACKS.has(pack);
@@ -175,17 +184,32 @@ function buildPackChoices(installedPackStates) {
             value: 'research',
             checked: true,
         },
+        {
+            label: `Brainstorm [project|user]${installedPackStates.brainstorm.location === 'not-installed' ? '' : ` (installed: ${formatInstalledLocation(installedPackStates.brainstorm.location)})`} — Always-on brainstorming entry point with visual companion`,
+            value: 'brainstorm',
+            checked: true,
+        },
     ];
 }
 function buildUserScopeChoices(packs, installedPackStates) {
     return packs.map((pack) => {
         const location = installedPackStates[pack].location;
+        // Existing-install detection wins over PACK_METADATA defaultScope so
+        // re-installs of an already-placed pack do not silently migrate the
+        // user across scopes. When the pack is not yet installed at any
+        // scope, fall back to PACK_METADATA[pack]?.defaultScope (defaults
+        // to 'project' when absent).
+        const checked = location === 'user' || location === 'both'
+            ? true
+            : location === 'not-installed'
+                ? resolvePackDefaultScope(pack) === 'user'
+                : false;
         return {
             label: location === 'not-installed'
                 ? pack
                 : `${pack} (current: ${formatInstalledLocation(location)})`,
             value: pack,
-            checked: location === 'user' || location === 'both',
+            checked,
         };
     });
 }
@@ -247,10 +271,30 @@ async function resolvePackScopes(context, selections, installedPackStates, depen
         }
         return scopes;
     }
-    // Non-interactive defaults all to project
+    // Non-interactive resolution.
+    //
+    // Migration-safety contract: existing-install detection wins over
+    // PACK_METADATA defaultScope. If the pack is already installed at any
+    // scope, preserve that placement so re-running `oat init tools`
+    // non-interactively never silently migrates a user's prior install
+    // across scopes. Only when the pack is not yet present do we consult
+    // PACK_METADATA[name]?.defaultScope (with absent entries falling back
+    // to 'project' for backwards compatibility).
     if (!context.interactive) {
         for (const pack of eligiblePacks) {
-            scopes[pack] = 'project';
+            const currentLocation = installedPackStates[pack].location;
+            if (currentLocation === 'user') {
+                scopes[pack] = 'user';
+            }
+            else if (currentLocation === 'both') {
+                scopes[pack] = 'both';
+            }
+            else if (currentLocation === 'project') {
+                scopes[pack] = 'project';
+            }
+            else {
+                scopes[pack] = resolvePackDefaultScope(pack);
+            }
         }
         return scopes;
     }
@@ -323,6 +367,7 @@ const PACK_DESCRIPTIONS = {
     'project-management': 'Local backlog, roadmap, and reference doc management (oat-pjm-* skills)',
     utility: 'Standalone utilities (skill authoring, maintainability review, code reviews)',
     research: 'Research, analysis, verification, and synthesis',
+    brainstorm: 'Always-on brainstorming entry point with visual companion',
 };
 export function buildToolPacksSectionBody(packs) {
     const userPacks = packs.filter((p) => p.scope === 'user' || p.scope === 'both');
@@ -362,7 +407,15 @@ export async function runInitTools(context, dependencies) {
         const initialPackStates = await loadInstalledPackStates(projectRoot, userRoot, assetsRoot, dependencies);
         const selectedPacks = context.interactive
             ? ((await dependencies.selectManyWithAbort('Select tool packs to install', buildPackChoices(initialPackStates), { interactive: context.interactive })) ?? [])
-            : ['core', 'ideas', 'docs', 'workflows', 'utility', 'research'];
+            : [
+                'core',
+                'ideas',
+                'docs',
+                'workflows',
+                'utility',
+                'research',
+                'brainstorm',
+            ];
         if (!context.interactive) {
             selectedPacks.push('project-management');
         }
@@ -552,6 +605,22 @@ export async function runInitTools(context, dependencies) {
                 }
             }
         }
+        if (selectedPacks.includes('brainstorm')) {
+            for (const targetRoot of packTargets('brainstorm')) {
+                affectedScopes.add(targetRoot === userRoot ? 'user' : 'project');
+                const brainstormResult = await dependencies.installBrainstorm({
+                    assetsRoot,
+                    targetRoot,
+                });
+                for (const skill of brainstormResult.outdatedSkills) {
+                    outdatedSkills.push({
+                        ...skill,
+                        targetRoot,
+                        selectionKey: `${skill.name}:${targetRoot}`,
+                    });
+                }
+            }
+        }
         if (outdatedSkills.length > 0) {
             reportOutdatedSkills(context, outdatedSkills);
             if (context.interactive) {
@@ -616,7 +685,7 @@ export function createInitToolsCommand(overrides = {}) {
         ...overrides,
     };
     return new Command('tools')
-        .description('Install OAT tool packs (core, ideas, docs, workflows, utility, project-management, research)')
+        .description('Install OAT tool packs (core, ideas, docs, workflows, utility, project-management, research, brainstorm)')
         .addCommand(createInitToolsCoreCommand())
         .addCommand(createInitToolsIdeasCommand())
         .addCommand(createInitToolsDocsCommand())
@@ -624,6 +693,7 @@ export function createInitToolsCommand(overrides = {}) {
         .addCommand(createInitToolsWorkflowsCommand())
         .addCommand(createInitToolsUtilityCommand())
         .addCommand(createInitToolsResearchCommand())
+        .addCommand(createInitToolsBrainstormCommand())
         .action(async (_options, command) => {
         const context = dependencies.buildCommandContext(readGlobalOptions(command));
         const selectedPacks = await runInitTools(context, dependencies);

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

@@ -5,6 +5,12 @@
  * `bundle-assets.sh` maintains its own bash array — `bundle-consistency.test.ts`
  * validates that it stays in sync with these lists.
  */
+export interface PackMetadata {
+    name: string;
+    defaultScope: 'user' | 'project';
+}
+export declare const PACK_METADATA: Record<string, PackMetadata>;
+export declare function resolvePackDefaultScope(packName: string): 'user' | 'project';
 export declare const WORKFLOW_SKILLS: readonly ["oat-project-capture", "oat-project-clear-active", "oat-project-complete", "oat-project-design", "oat-project-discover", "oat-project-document", "oat-project-implement", "oat-project-import-plan", "oat-project-new", "oat-project-next", "oat-project-open", "oat-project-plan", "oat-project-plan-writing", "oat-project-pr-final", "oat-project-pr-progress", "oat-project-progress", "oat-project-promote-spec-driven", "oat-project-quick-start", "oat-project-reconcile", "oat-project-revise", "oat-project-review-provide", "oat-project-review-receive", "oat-project-review-receive-remote", "oat-project-spec", "oat-project-summary", "oat-repo-knowledge-index", "oat-worktree-bootstrap", "oat-worktree-bootstrap-auto", "oat-wrap-up"];
 export declare const WORKFLOW_AGENTS: readonly ["oat-codebase-mapper.md", "oat-phase-implementer.md", "oat-reviewer.md"];
 export declare const WORKFLOW_TEMPLATES: readonly ["state.md", "discovery.md", "spec.md", "design.md", "plan.md", "implementation.md", "summary.md"];
@@ -17,6 +23,7 @@ export declare const UTILITY_SKILLS: readonly ["create-agnostic-skill", "oat-rep
 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 BRAINSTORM_SKILLS: readonly ["oat-brainstorm"];
 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