@fission-ai/openspec 1.1.0 → 1.2.0

package/dist/cli/index.js

@@ -70,6 +70,7 @@ program
     .description('Initialize OpenSpec in your project')
     .option('--tools <tools>', toolsOptionDescription)
     .option('--force', 'Auto-cleanup legacy files without prompting')
+    .option('--profile <profile>', 'Override global config profile (core or custom)')
     .action(async (targetPath = '.', options) => {
     try {
         // Validate that the path is a valid directory
@@ -96,6 +97,7 @@ program
         const initCommand = new InitCommand({
             tools: options?.tools,
             force: options?.force,
+            profile: options?.profile,
         });
         await initCommand.execute(targetPath);
     }

package/dist/commands/config.d.ts

@@ -1,8 +1,36 @@
 import { Command } from 'commander';
+import { GlobalConfig } from '../core/global-config.js';
+import type { Profile, Delivery } from '../core/global-config.js';
+interface ProfileState {
+    profile: Profile;
+    delivery: Delivery;
+    workflows: string[];
+}
+interface ProfileStateDiff {
+    hasChanges: boolean;
+    lines: string[];
+}
+/**
+ * Resolve the effective current profile state from global config defaults.
+ */
+export declare function resolveCurrentProfileState(config: GlobalConfig): ProfileState;
+/**
+ * Derive profile type from selected workflows.
+ */
+export declare function deriveProfileFromWorkflowSelection(selectedWorkflows: string[]): Profile;
+/**
+ * Format a compact workflow summary for the profile header.
+ */
+export declare function formatWorkflowSummary(workflows: readonly string[], profile: Profile): string;
+/**
+ * Build a user-facing diff summary between two profile states.
+ */
+export declare function diffProfileState(before: ProfileState, after: ProfileState): ProfileStateDiff;
 /**
  * Register the config command and all its subcommands.
  *
  * @param program - The Commander program instance
  */
 export declare function registerConfigCommand(program: Command): void;
+export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/commands/config.js

@@ -1,7 +1,147 @@
-import { spawn } from 'node:child_process';
+import { spawn, execSync } from 'node:child_process';
 import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { getGlobalConfigPath, getGlobalConfig, saveGlobalConfig, } from '../core/global-config.js';
 import { getNestedValue, setNestedValue, deleteNestedValue, coerceValue, formatValueYaml, validateConfigKeyPath, validateConfig, DEFAULT_CONFIG, } from '../core/config-schema.js';
+import { CORE_WORKFLOWS, ALL_WORKFLOWS, getProfileWorkflows } from '../core/profiles.js';
+import { OPENSPEC_DIR_NAME } from '../core/config.js';
+import { hasProjectConfigDrift } from '../core/profile-sync-drift.js';
+const WORKFLOW_PROMPT_META = {
+    propose: {
+        name: 'Propose change',
+        description: 'Create proposal, design, and tasks from a request',
+    },
+    explore: {
+        name: 'Explore ideas',
+        description: 'Investigate a problem before implementation',
+    },
+    new: {
+        name: 'New change',
+        description: 'Create a new change scaffold quickly',
+    },
+    continue: {
+        name: 'Continue change',
+        description: 'Resume work on an existing change',
+    },
+    apply: {
+        name: 'Apply tasks',
+        description: 'Implement tasks from the current change',
+    },
+    ff: {
+        name: 'Fast-forward',
+        description: 'Run a faster implementation workflow',
+    },
+    sync: {
+        name: 'Sync specs',
+        description: 'Sync change artifacts with specs',
+    },
+    archive: {
+        name: 'Archive change',
+        description: 'Finalize and archive a completed change',
+    },
+    'bulk-archive': {
+        name: 'Bulk archive',
+        description: 'Archive multiple completed changes together',
+    },
+    verify: {
+        name: 'Verify change',
+        description: 'Run verification checks against a change',
+    },
+    onboard: {
+        name: 'Onboard',
+        description: 'Guided onboarding flow for OpenSpec',
+    },
+};
+function isPromptCancellationError(error) {
+    return (error instanceof Error &&
+        (error.name === 'ExitPromptError' || error.message.includes('force closed the prompt with SIGINT')));
+}
+/**
+ * Resolve the effective current profile state from global config defaults.
+ */
+export function resolveCurrentProfileState(config) {
+    const profile = config.profile || 'core';
+    const delivery = config.delivery || 'both';
+    const workflows = [
+        ...getProfileWorkflows(profile, config.workflows ? [...config.workflows] : undefined),
+    ];
+    return { profile, delivery, workflows };
+}
+/**
+ * Derive profile type from selected workflows.
+ */
+export function deriveProfileFromWorkflowSelection(selectedWorkflows) {
+    const isCoreMatch = selectedWorkflows.length === CORE_WORKFLOWS.length &&
+        CORE_WORKFLOWS.every((w) => selectedWorkflows.includes(w));
+    return isCoreMatch ? 'core' : 'custom';
+}
+/**
+ * Format a compact workflow summary for the profile header.
+ */
+export function formatWorkflowSummary(workflows, profile) {
+    return `${workflows.length} selected (${profile})`;
+}
+function stableWorkflowOrder(workflows) {
+    const seen = new Set();
+    const ordered = [];
+    for (const workflow of ALL_WORKFLOWS) {
+        if (workflows.includes(workflow) && !seen.has(workflow)) {
+            ordered.push(workflow);
+            seen.add(workflow);
+        }
+    }
+    const extras = workflows.filter((w) => !ALL_WORKFLOWS.includes(w));
+    extras.sort();
+    for (const extra of extras) {
+        if (!seen.has(extra)) {
+            ordered.push(extra);
+            seen.add(extra);
+        }
+    }
+    return ordered;
+}
+/**
+ * Build a user-facing diff summary between two profile states.
+ */
+export function diffProfileState(before, after) {
+    const lines = [];
+    if (before.delivery !== after.delivery) {
+        lines.push(`delivery: ${before.delivery} -> ${after.delivery}`);
+    }
+    if (before.profile !== after.profile) {
+        lines.push(`profile: ${before.profile} -> ${after.profile}`);
+    }
+    const beforeOrdered = stableWorkflowOrder(before.workflows);
+    const afterOrdered = stableWorkflowOrder(after.workflows);
+    const beforeSet = new Set(beforeOrdered);
+    const afterSet = new Set(afterOrdered);
+    const added = afterOrdered.filter((w) => !beforeSet.has(w));
+    const removed = beforeOrdered.filter((w) => !afterSet.has(w));
+    if (added.length > 0 || removed.length > 0) {
+        const tokens = [];
+        if (added.length > 0) {
+            tokens.push(`added ${added.join(', ')}`);
+        }
+        if (removed.length > 0) {
+            tokens.push(`removed ${removed.join(', ')}`);
+        }
+        lines.push(`workflows: ${tokens.join('; ')}`);
+    }
+    return {
+        hasChanges: lines.length > 0,
+        lines,
+    };
+}
+function maybeWarnConfigDrift(projectDir, state, colorize) {
+    const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
+    if (!fs.existsSync(openspecDir)) {
+        return;
+    }
+    if (!hasProjectConfigDrift(projectDir, state.workflows, state.delivery)) {
+        return;
+    }
+    console.log(colorize('Warning: Global config is not applied to this project. Run `openspec update` to sync.'));
+}
 /**
  * Register the config command and all its subcommands.
  *
@@ -37,7 +177,33 @@ export function registerConfigCommand(program) {
             console.log(JSON.stringify(config, null, 2));
         }
         else {
+            // Read raw config to determine which values are explicit vs defaults
+            const configPath = getGlobalConfigPath();
+            let rawConfig = {};
+            try {
+                if (fs.existsSync(configPath)) {
+                    rawConfig = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+                }
+            }
+            catch {
+                // If reading fails, treat all as defaults
+            }
             console.log(formatValueYaml(config));
+            // Annotate profile settings
+            const profileSource = rawConfig.profile !== undefined ? '(explicit)' : '(default)';
+            const deliverySource = rawConfig.delivery !== undefined ? '(explicit)' : '(default)';
+            console.log(`\nProfile settings:`);
+            console.log(`  profile: ${config.profile} ${profileSource}`);
+            console.log(`  delivery: ${config.delivery} ${deliverySource}`);
+            if (config.profile === 'core') {
+                console.log(`  workflows: ${CORE_WORKFLOWS.join(', ')} (from core profile)`);
+            }
+            else if (config.workflows && config.workflows.length > 0) {
+                console.log(`  workflows: ${config.workflows.join(', ')} (explicit)`);
+            }
+            else {
+                console.log(`  workflows: (none)`);
+            }
         }
     });
     // config get
@@ -123,10 +289,21 @@ export function registerConfigCommand(program) {
         }
         if (!options.yes) {
             const { confirm } = await import('@inquirer/prompts');
-            const confirmed = await confirm({
-                message: 'Reset all configuration to defaults?',
-                default: false,
-            });
+            let confirmed;
+            try {
+                confirmed = await confirm({
+                    message: 'Reset all configuration to defaults?',
+                    default: false,
+                });
+            }
+            catch (error) {
+                if (isPromptCancellationError(error)) {
+                    console.log('Reset cancelled.');
+                    process.exitCode = 130;
+                    return;
+                }
+                throw error;
+            }
             if (!confirmed) {
                 console.log('Reset cancelled.');
                 return;
@@ -194,5 +371,182 @@ export function registerConfigCommand(program) {
             process.exitCode = 1;
         }
     });
+    // config profile [preset]
+    configCmd
+        .command('profile [preset]')
+        .description('Configure workflow profile (interactive picker or preset shortcut)')
+        .action(async (preset) => {
+        // Preset shortcut: `openspec config profile core`
+        if (preset === 'core') {
+            const config = getGlobalConfig();
+            config.profile = 'core';
+            config.workflows = [...CORE_WORKFLOWS];
+            // Preserve delivery setting
+            saveGlobalConfig(config);
+            console.log('Config updated. Run `openspec update` in your projects to apply.');
+            return;
+        }
+        if (preset) {
+            console.error(`Error: Unknown profile preset "${preset}". Available presets: core`);
+            process.exitCode = 1;
+            return;
+        }
+        // Non-interactive check
+        if (!process.stdout.isTTY) {
+            console.error('Interactive mode required. Use `openspec config profile core` or set config via environment/flags.');
+            process.exitCode = 1;
+            return;
+        }
+        // Interactive picker
+        const { select, checkbox, confirm } = await import('@inquirer/prompts');
+        const chalk = (await import('chalk')).default;
+        try {
+            const config = getGlobalConfig();
+            const currentState = resolveCurrentProfileState(config);
+            console.log(chalk.bold('\nCurrent profile settings'));
+            console.log(`  Delivery: ${currentState.delivery}`);
+            console.log(`  Workflows: ${formatWorkflowSummary(currentState.workflows, currentState.profile)}`);
+            console.log(chalk.dim('  Delivery = where workflows are installed (skills, commands, or both)'));
+            console.log(chalk.dim('  Workflows = which actions are available (propose, explore, apply, etc.)'));
+            console.log();
+            const action = await select({
+                message: 'What do you want to configure?',
+                choices: [
+                    {
+                        value: 'both',
+                        name: 'Delivery and workflows',
+                        description: 'Update install mode and available actions together',
+                    },
+                    {
+                        value: 'delivery',
+                        name: 'Delivery only',
+                        description: 'Change where workflows are installed',
+                    },
+                    {
+                        value: 'workflows',
+                        name: 'Workflows only',
+                        description: 'Change which workflow actions are available',
+                    },
+                    {
+                        value: 'keep',
+                        name: 'Keep current settings (exit)',
+                        description: 'Leave configuration unchanged and exit',
+                    },
+                ],
+            });
+            if (action === 'keep') {
+                console.log('No config changes.');
+                maybeWarnConfigDrift(process.cwd(), currentState, chalk.yellow);
+                return;
+            }
+            const nextState = {
+                profile: currentState.profile,
+                delivery: currentState.delivery,
+                workflows: [...currentState.workflows],
+            };
+            if (action === 'both' || action === 'delivery') {
+                const deliveryChoices = [
+                    {
+                        value: 'both',
+                        name: 'Both (skills + commands)',
+                        description: 'Install workflows as both skills and slash commands',
+                    },
+                    {
+                        value: 'skills',
+                        name: 'Skills only',
+                        description: 'Install workflows only as skills',
+                    },
+                    {
+                        value: 'commands',
+                        name: 'Commands only',
+                        description: 'Install workflows only as slash commands',
+                    },
+                ];
+                for (const choice of deliveryChoices) {
+                    if (choice.value === currentState.delivery) {
+                        choice.name += ' [current]';
+                    }
+                }
+                nextState.delivery = await select({
+                    message: 'Delivery mode (how workflows are installed):',
+                    choices: deliveryChoices,
+                    default: currentState.delivery,
+                });
+            }
+            if (action === 'both' || action === 'workflows') {
+                const formatWorkflowChoice = (workflow) => {
+                    const metadata = WORKFLOW_PROMPT_META[workflow] ?? {
+                        name: workflow,
+                        description: `Workflow: ${workflow}`,
+                    };
+                    return {
+                        value: workflow,
+                        name: metadata.name,
+                        description: metadata.description,
+                        short: metadata.name,
+                        checked: currentState.workflows.includes(workflow),
+                    };
+                };
+                const selectedWorkflows = await checkbox({
+                    message: 'Select workflows to make available:',
+                    instructions: 'Space to toggle, Enter to confirm',
+                    pageSize: ALL_WORKFLOWS.length,
+                    theme: {
+                        icon: {
+                            checked: '[x]',
+                            unchecked: '[ ]',
+                        },
+                    },
+                    choices: ALL_WORKFLOWS.map(formatWorkflowChoice),
+                });
+                nextState.workflows = selectedWorkflows;
+                nextState.profile = deriveProfileFromWorkflowSelection(selectedWorkflows);
+            }
+            const diff = diffProfileState(currentState, nextState);
+            if (!diff.hasChanges) {
+                console.log('No config changes.');
+                maybeWarnConfigDrift(process.cwd(), nextState, chalk.yellow);
+                return;
+            }
+            console.log(chalk.bold('\nConfig changes:'));
+            for (const line of diff.lines) {
+                console.log(`  ${line}`);
+            }
+            console.log();
+            config.profile = nextState.profile;
+            config.delivery = nextState.delivery;
+            config.workflows = nextState.workflows;
+            saveGlobalConfig(config);
+            // Check if inside an OpenSpec project
+            const projectDir = process.cwd();
+            const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
+            if (fs.existsSync(openspecDir)) {
+                const applyNow = await confirm({
+                    message: 'Apply changes to this project now?',
+                    default: true,
+                });
+                if (applyNow) {
+                    try {
+                        execSync('npx openspec update', { stdio: 'inherit', cwd: projectDir });
+                        console.log('Run `openspec update` in your other projects to apply.');
+                    }
+                    catch {
+                        console.error('`openspec update` failed. Please run it manually to apply the profile changes.');
+                        process.exitCode = 1;
+                    }
+                    return;
+                }
+            }
+            console.log('Config updated. Run `openspec update` in your projects to apply.');
+        }
+        catch (error) {
+            if (isPromptCancellationError(error)) {
+                console.log('Config profile cancelled.');
+                process.exitCode = 130;
+                return;
+            }
+            throw error;
+        }
+    });
 }
 //# sourceMappingURL=config.js.map

package/dist/core/available-tools.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Available Tools Detection
+ *
+ * Detects which AI tools are available in a project by scanning
+ * for their configuration directories.
+ */
+import { type AIToolOption } from './config.js';
+/**
+ * Scans the project path for AI tool configuration directories and returns
+ * the tools that are present.
+ *
+ * Checks for each tool's `skillsDir` (e.g., `.claude/`, `.cursor/`) at the
+ * project root. Only tools with a `skillsDir` property are considered.
+ */
+export declare function getAvailableTools(projectPath: string): AIToolOption[];
+//# sourceMappingURL=available-tools.d.ts.map

package/dist/core/available-tools.js

@@ -0,0 +1,30 @@
+/**
+ * Available Tools Detection
+ *
+ * Detects which AI tools are available in a project by scanning
+ * for their configuration directories.
+ */
+import path from 'path';
+import * as fs from 'fs';
+import { AI_TOOLS } from './config.js';
+/**
+ * Scans the project path for AI tool configuration directories and returns
+ * the tools that are present.
+ *
+ * Checks for each tool's `skillsDir` (e.g., `.claude/`, `.cursor/`) at the
+ * project root. Only tools with a `skillsDir` property are considered.
+ */
+export function getAvailableTools(projectPath) {
+    return AI_TOOLS.filter((tool) => {
+        if (!tool.skillsDir)
+            return false;
+        const dirPath = path.join(projectPath, tool.skillsDir);
+        try {
+            return fs.statSync(dirPath).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    });
+}
+//# sourceMappingURL=available-tools.js.map

package/dist/core/command-generation/adapters/index.d.ts

@@ -19,7 +19,9 @@ export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
 export { iflowAdapter } from './iflow.js';
 export { kilocodeAdapter } from './kilocode.js';
+export { kiroAdapter } from './kiro.js';
 export { opencodeAdapter } from './opencode.js';
+export { piAdapter } from './pi.js';
 export { qoderAdapter } from './qoder.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';

package/dist/core/command-generation/adapters/index.js

@@ -19,7 +19,9 @@ export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
 export { iflowAdapter } from './iflow.js';
 export { kilocodeAdapter } from './kilocode.js';
+export { kiroAdapter } from './kiro.js';
 export { opencodeAdapter } from './opencode.js';
+export { piAdapter } from './pi.js';
 export { qoderAdapter } from './qoder.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';

package/dist/core/command-generation/adapters/kiro.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Kiro Command Adapter
+ *
+ * Formats commands for Kiro following its .prompt.md specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Kiro adapter for command generation.
+ * File path: .kiro/prompts/opsx-<id>.prompt.md
+ * Frontmatter: description
+ */
+export declare const kiroAdapter: ToolCommandAdapter;
+//# sourceMappingURL=kiro.d.ts.map

package/dist/core/command-generation/adapters/kiro.js

@@ -0,0 +1,26 @@
+/**
+ * Kiro Command Adapter
+ *
+ * Formats commands for Kiro following its .prompt.md specification.
+ */
+import path from 'path';
+/**
+ * Kiro adapter for command generation.
+ * File path: .kiro/prompts/opsx-<id>.prompt.md
+ * Frontmatter: description
+ */
+export const kiroAdapter = {
+    toolId: 'kiro',
+    getFilePath(commandId) {
+        return path.join('.kiro', 'prompts', `opsx-${commandId}.prompt.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${content.description}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=kiro.js.map

package/dist/core/command-generation/adapters/opencode.js

@@ -4,6 +4,7 @@
  * Formats commands for OpenCode following its frontmatter specification.
  */
 import path from 'path';
+import { transformToHyphenCommands } from '../../../utils/command-references.js';
 /**
  * OpenCode adapter for command generation.
  * File path: .opencode/command/opsx-<id>.md
@@ -15,11 +16,13 @@ export const opencodeAdapter = {
         return path.join('.opencode', 'command', `opsx-${commandId}.md`);
     },
     formatFile(content) {
+        // Transform command references from colon to hyphen format for OpenCode
+        const transformedBody = transformToHyphenCommands(content.body);
         return `---
 description: ${content.description}
 ---
 
-${content.body}
+${transformedBody}
 `;
     },
 };

package/dist/core/command-generation/adapters/pi.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Pi Command Adapter
+ *
+ * Formats commands for Pi (pi.dev) following its prompt template specification.
+ * Pi prompt templates live in .pi/prompts/*.md with description frontmatter.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Pi adapter for prompt template generation.
+ * File path: .pi/prompts/opsx-<id>.md
+ * Frontmatter: description
+ */
+export declare const piAdapter: ToolCommandAdapter;
+//# sourceMappingURL=pi.d.ts.map

package/dist/core/command-generation/adapters/pi.js

@@ -0,0 +1,41 @@
+/**
+ * Pi Command Adapter
+ *
+ * Formats commands for Pi (pi.dev) following its prompt template specification.
+ * Pi prompt templates live in .pi/prompts/*.md with description frontmatter.
+ */
+import path from 'path';
+/**
+ * Escapes a string value for safe YAML output.
+ * Quotes the string if it contains special YAML characters.
+ */
+function escapeYamlValue(value) {
+    // Check if value needs quoting (contains special YAML characters or starts/ends with whitespace)
+    const needsQuoting = /[:\n\r#{}[\],&*!|>'"%@`]|^\s|\s$/.test(value);
+    if (needsQuoting) {
+        // Use double quotes and escape internal double quotes and backslashes
+        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/**
+ * Pi adapter for prompt template generation.
+ * File path: .pi/prompts/opsx-<id>.md
+ * Frontmatter: description
+ */
+export const piAdapter = {
+    toolId: 'pi',
+    getFilePath(commandId) {
+        return path.join('.pi', 'prompts', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=pi.js.map

package/dist/core/command-generation/registry.js

@@ -20,7 +20,9 @@ import { geminiAdapter } from './adapters/gemini.js';
 import { githubCopilotAdapter } from './adapters/github-copilot.js';
 import { iflowAdapter } from './adapters/iflow.js';
 import { kilocodeAdapter } from './adapters/kilocode.js';
+import { kiroAdapter } from './adapters/kiro.js';
 import { opencodeAdapter } from './adapters/opencode.js';
+import { piAdapter } from './adapters/pi.js';
 import { qoderAdapter } from './adapters/qoder.js';
 import { qwenAdapter } from './adapters/qwen.js';
 import { roocodeAdapter } from './adapters/roocode.js';
@@ -48,7 +50,9 @@ export class CommandAdapterRegistry {
         CommandAdapterRegistry.register(githubCopilotAdapter);
         CommandAdapterRegistry.register(iflowAdapter);
         CommandAdapterRegistry.register(kilocodeAdapter);
+        CommandAdapterRegistry.register(kiroAdapter);
         CommandAdapterRegistry.register(opencodeAdapter);
+        CommandAdapterRegistry.register(piAdapter);
         CommandAdapterRegistry.register(qoderAdapter);
         CommandAdapterRegistry.register(qwenAdapter);
         CommandAdapterRegistry.register(roocodeAdapter);

package/dist/core/completions/command-registry.js

@@ -374,6 +374,11 @@ export const COMMAND_REGISTRY = [
                 description: 'Open config in $EDITOR',
                 flags: [],
             },
+            {
+                name: 'profile',
+                description: 'Configure workflow profile (interactive picker or preset shortcut)',
+                flags: [],
+            },
         ],
     },
     {