@fission-ai/openspec 1.4.1 → 1.5.0

package/README.md

@@ -47,6 +47,14 @@ Our philosophy:
 ## See it in action
 
 ```text
+You: /opsx:explore
+AI:  What would you like to explore?
+You: I want dark mode but I'm not sure how to do it cleanly.
+AI:  Let me look at your styling setup...
+     Cleanest path here: CSS variables + a small theme context,
+     with system-preference detection. No new dependencies. Scope it?
+You: Yes, let's do it.
+
 You: /opsx:propose add-dark-mode
 AI:  Created openspec/changes/add-dark-mode/
      ✓ proposal.md — why we're doing this, what's changing
@@ -94,9 +102,12 @@ cd your-project
 openspec init
 ```
 
-Now tell your AI: `/opsx:propose <what-you-want-to-build>`
+Now talk to your AI:
+
+- **Not sure what to build yet?** Start with `/opsx:explore`, a no-stakes thinking partner that reads your code, weighs options, and shapes a plan before anything is written. ([Explore guide](docs/explore.md))
+- **Already know what you want?** Go straight to `/opsx:propose <what-you-want-to-build>`.
 
-If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
+Both are in the default profile. If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
 
 > [!NOTE]
 > Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 25+ tools and growing.
@@ -105,14 +116,24 @@ If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/
 
 ## Docs
 
+**Start here:** the **[Documentation Home](docs/README.md)** maps everything. New to OpenSpec? Read [Getting Started](docs/getting-started.md), then [How Commands Work](docs/how-commands-work.md) (where you actually type `/opsx:propose`).
+
 → **[Getting Started](docs/getting-started.md)**: first steps<br>
+→ **[Explore First](docs/explore.md)**: think it through with `/opsx:explore` before you commit<br>
+→ **[How Commands Work](docs/how-commands-work.md)**: where slash commands run vs the CLI<br>
+→ **[Core Concepts at a Glance](docs/overview.md)**: the whole mental model, one page<br>
+→ **[Examples & Recipes](docs/examples.md)**: real changes, start to finish<br>
 → **[Workflows](docs/workflows.md)**: combos and patterns<br>
+→ **[Existing Projects](docs/existing-projects.md)**: adopt OpenSpec on a brownfield codebase<br>
+→ **[Editing a Change](docs/editing-changes.md)**: update artifacts, go back, reconcile manual edits<br>
 → **[Commands](docs/commands.md)**: slash commands & skills<br>
 → **[CLI](docs/cli.md)**: terminal reference<br>
+→ **[Stores](docs/stores-beta/user-guide.md)**: plan in a separate repo, shared across your team (beta)<br>
 → **[Supported Tools](docs/supported-tools.md)**: tool integrations & install paths<br>
 → **[Concepts](docs/concepts.md)**: how it all fits<br>
 → **[Multi-Language](docs/multi-language.md)**: multi-language support<br>
-→ **[Customization](docs/customization.md)**: make it yours
+→ **[Customization](docs/customization.md)**: make it yours<br>
+→ **[FAQ](docs/faq.md)** · **[Troubleshooting](docs/troubleshooting.md)** · **[Glossary](docs/glossary.md)**: quick help
 
 
 ## Community schemas

package/dist/cli/index.d.ts

@@ -1,5 +1,10 @@
 import { Command } from 'commander';
 declare const program: Command;
+/**
+ * Get the full command path for nested commands.
+ * For example: 'change show' -> 'change:show'
+ */
+export declare function getCommandPath(command: Command): string;
 export { program };
 export declare function runCli(argv?: string[]): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -1,14 +1,16 @@
-import { Command } from 'commander';
+import { asStatus } from '../commands/shared-output.js';
+import { Command, Option } from 'commander';
 import { createRequire } from 'module';
 import ora from 'ora';
 import path from 'path';
 import { fileURLToPath } from 'url';
 import { promises as fs } from 'fs';
-import { AI_TOOLS, OPENSPEC_DIR_NAME } from '../core/config.js';
+import { AI_TOOLS } from '../core/config.js';
 import { UpdateCommand } from '../core/update.js';
 import { ListCommand } from '../core/list.js';
 import { ArchiveCommand } from '../core/archive.js';
 import { ViewCommand } from '../core/view.js';
+import { resolveRootForCommand, toRootOutput } from '../core/root-selection.js';
 import { registerSpecCommand } from '../commands/spec.js';
 import { ChangeCommand } from '../commands/change.js';
 import { ValidateCommand } from '../commands/validate.js';
@@ -17,12 +19,37 @@ import { CompletionCommand } from '../commands/completion.js';
 import { FeedbackCommand } from '../commands/feedback.js';
 import { registerConfigCommand } from '../commands/config.js';
 import { registerSchemaCommand } from '../commands/schema.js';
-import { registerWorkspaceCommand } from '../commands/workspace.js';
-import { registerContextStoreCommand } from '../commands/context-store.js';
-import { registerInitiativeCommand } from '../commands/initiative.js';
-import { findWorkspaceRoot } from '../core/workspace/index.js';
-import { statusCommand, instructionsCommand, applyInstructionsCommand, templatesCommand, schemasCommand, newChangeCommand, setChangeCommand, DEFAULT_SCHEMA, } from '../commands/workflow/index.js';
+import { registerStoreCommand } from '../commands/store.js';
+import { registerDoctorCommand } from '../commands/doctor.js';
+import { registerContextCommand } from '../commands/context.js';
+import { registerWorksetCommand } from '../commands/workset.js';
+import { statusCommand, instructionsCommand, applyInstructionsCommand, templatesCommand, schemasCommand, newChangeCommand, DEFAULT_SCHEMA, } from '../commands/workflow/index.js';
 import { maybeShowTelemetryNotice, trackCommand, shutdown } from '../telemetry/index.js';
+import { COMMON_FLAGS } from '../core/completions/shared-flags.js';
+const STORE_OPTION_DESCRIPTION = COMMON_FLAGS.store.description;
+// Deliberate rejection path: --store-path stays registered (hidden) so the
+// resolver can explain that registering the path is the supported route,
+// instead of Commander emitting a generic unknown-option error (or, for
+// `show`, silently ignoring it via allowUnknownOption).
+function hiddenStorePathOption() {
+    return new Option('--store-path <path>', 'Not supported; register the path with "openspec store register <path>" and use --store <id>').hideHelp();
+}
+function failWithError(error, json) {
+    // The agent contract: every --json failure leaves exactly one JSON
+    // document on stdout (the command's null-shape plus a status array).
+    if (json?.enabled) {
+        console.log(JSON.stringify({ ...(json.payload ?? {}), status: [asStatus(error, json.fallbackCode ?? 'command_error')] }, null, 2));
+        process.exitCode = 1;
+        return;
+    }
+    ora().fail(`Error: ${error.message}`);
+    // Resolution and store errors carry a pasteable fix - never drop it.
+    const fix = error.diagnostic?.fix;
+    if (fix) {
+        console.error(`Fix: ${fix}`);
+    }
+    process.exitCode = process.exitCode ?? 1;
+}
 const program = new Command();
 const require = createRequire(import.meta.url);
 const { version } = require('../../package.json');
@@ -30,7 +57,7 @@ const { version } = require('../../package.json');
  * Get the full command path for nested commands.
  * For example: 'change show' -> 'change:show'
  */
-function getCommandPath(command) {
+export function getCommandPath(command) {
     const names = [];
     let current = command;
     while (current) {
@@ -70,21 +97,6 @@ program.hook('postAction', async () => {
 });
 const availableToolIds = AI_TOOLS.filter((tool) => tool.skillsDir).map((tool) => tool.value);
 const toolsOptionDescription = `Configure AI tools non-interactively. Use "all", "none", or a comma-separated list of: ${availableToolIds.join(', ')}`;
-async function hasRepoLocalOpenSpecProject(projectPath) {
-    try {
-        const stats = await fs.stat(path.join(projectPath, OPENSPEC_DIR_NAME));
-        return stats.isDirectory();
-    }
-    catch (error) {
-        const code = typeof error === 'object' && error !== null && 'code' in error
-            ? error.code
-            : undefined;
-        if (code !== 'ENOENT' && code !== 'ENOTDIR') {
-            throw error;
-        }
-        return false;
-    }
-}
 program
     .command('init [path]')
     .description('Initialize OpenSpec in your project')
@@ -122,8 +134,7 @@ program
         await initCommand.execute(targetPath);
     }
     catch (error) {
-        console.log(); // Empty line for spacing
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -144,8 +155,7 @@ program
         await initCommand.execute('.');
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -155,21 +165,11 @@ program
     .option('--force', 'Force update even when tools are up to date')
     .action(async (targetPath = '.', options) => {
     try {
-        const resolvedPath = path.resolve(targetPath);
         const updateCommand = new UpdateCommand({ force: options?.force });
-        if (await hasRepoLocalOpenSpecProject(resolvedPath)) {
-            await updateCommand.execute(resolvedPath);
-            return;
-        }
-        const workspaceRoot = await findWorkspaceRoot(resolvedPath);
-        if (workspaceRoot) {
-            throw new Error('OpenSpec workspace detected. Run `openspec workspace update` to refresh workspace-local guidance and skills.');
-        }
-        await updateCommand.execute(resolvedPath);
+        await updateCommand.execute(targetPath);
     }
     catch (error) {
-        console.log(); // Empty line for spacing
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -180,16 +180,32 @@ program
     .option('--changes', 'List changes explicitly (default)')
     .option('--sort <order>', 'Sort order: "recent" (default) or "name"', 'recent')
     .option('--json', 'Output as JSON (for programmatic use)')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
     .action(async (options) => {
     try {
+        const root = await resolveRootForCommand(options ?? {}, {
+            json: options?.json,
+            failurePayload: options?.specs ? { specs: [], root: null } : { changes: [], root: null },
+        });
+        if (!root) {
+            return;
+        }
         const listCommand = new ListCommand();
         const mode = options?.specs ? 'specs' : 'changes';
         const sort = options?.sort === 'name' ? 'name' : 'recent';
-        await listCommand.execute('.', mode, { sort, json: options?.json });
+        await listCommand.execute(root.path, mode, {
+            sort,
+            json: options?.json,
+            ...(options?.json ? { root: toRootOutput(root) } : {}),
+        });
     }
     catch (error) {
-        console.log(); // Empty line for spacing
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error, {
+            enabled: options?.json,
+            payload: options?.specs ? { specs: [], root: null } : { changes: [], root: null },
+            fallbackCode: 'list_error',
+        });
         process.exit(1);
     }
 });
@@ -202,8 +218,7 @@ program
         await viewCommand.execute('.');
     }
     catch (error) {
-        console.log(); // Empty line for spacing
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -273,23 +288,26 @@ program
     .option('-y, --yes', 'Skip confirmation prompts')
     .option('--skip-specs', 'Skip spec update operations (useful for infrastructure, tooling, or doc-only changes)')
     .option('--no-validate', 'Skip validation (not recommended, requires confirmation)')
+    .option('--json', 'Output as JSON (non-interactive)')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
     .action(async (changeName, options) => {
     try {
         const archiveCommand = new ArchiveCommand();
         await archiveCommand.execute(changeName, options);
     }
     catch (error) {
-        console.log(); // Empty line for spacing
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
 registerSpecCommand(program);
 registerConfigCommand(program);
 registerSchemaCommand(program);
-registerWorkspaceCommand(program);
-registerContextStoreCommand(program);
-registerInitiativeCommand(program);
+registerStoreCommand(program);
+registerDoctorCommand(program);
+registerContextCommand(program);
+registerWorksetCommand(program);
 // Top-level validate command
 program
     .command('validate [item-name]')
@@ -302,14 +320,15 @@ program
     .option('--json', 'Output validation results as JSON')
     .option('--concurrency <n>', 'Max concurrent validations (defaults to env OPENSPEC_CONCURRENCY or 6)')
     .option('--no-interactive', 'Disable interactive prompts')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
     .action(async (itemName, options) => {
     try {
         const validateCommand = new ValidateCommand();
         await validateCommand.execute(itemName, options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error, { enabled: options?.json, fallbackCode: 'validate_error' });
         process.exit(1);
     }
 });
@@ -327,6 +346,10 @@ program
     .option('--requirements', 'JSON only: Show only requirements (exclude scenarios)')
     .option('--no-scenarios', 'JSON only: Exclude scenario content')
     .option('-r, --requirement <id>', 'JSON only: Show specific requirement by ID (1-based)')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    // Explicit registration required: allowUnknownOption would otherwise
+    // silently swallow --store-path instead of rejecting it deliberately.
+    .addOption(hiddenStorePathOption())
     // allow unknown options to pass-through to underlying command implementation
     .allowUnknownOption(true)
     .action(async (itemName, options) => {
@@ -335,8 +358,7 @@ program
         await showCommand.execute(itemName, options ?? {});
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error, { enabled: options?.json, fallbackCode: 'show_error' });
         process.exit(1);
     }
 });
@@ -351,8 +373,7 @@ program
         await feedbackCommand.execute(message, options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -369,8 +390,7 @@ completionCmd
         await completionCommand.generate({ shell });
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -384,8 +404,7 @@ completionCmd
         await completionCommand.install({ shell, verbose: options?.verbose });
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -399,8 +418,7 @@ completionCmd
         await completionCommand.uninstall({ shell, yes: options?.yes });
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -428,13 +446,14 @@ program
     .option('--change <id>', 'Change name to show status for')
     .option('--schema <name>', 'Schema override (auto-detected from config.yaml)')
     .option('--json', 'Output as JSON')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
     .action(async (options) => {
     try {
         await statusCommand(options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error, { enabled: options.json, fallbackCode: 'change_error' });
         process.exit(1);
     }
 });
@@ -445,6 +464,8 @@ program
     .option('--change <id>', 'Change name')
     .option('--schema <name>', 'Schema override (auto-detected from config.yaml)')
     .option('--json', 'Output as JSON')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
     .action(async (artifactId, options) => {
     try {
         // Special case: "apply" is not an artifact, but a command to get apply instructions
@@ -456,8 +477,7 @@ program
         }
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error, { enabled: options.json, fallbackCode: 'change_error' });
         process.exit(1);
     }
 });
@@ -472,8 +492,7 @@ program
         await templatesCommand(options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -487,8 +506,7 @@ program
         await schemasCommand(options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });
@@ -498,39 +516,21 @@ newCmd
     .command('change <name>')
     .description('Create a new change directory')
     .option('--description <text>', 'Description to add to README.md')
-    .option('--goal <text>', 'Workspace product goal to store with the change')
-    .option('--areas <names>', 'Comma-separated affected workspace link names')
-    .option('--initiative <id>', 'Link the repo-local change to an initiative')
-    .option('--store <id>', 'Context store id for --initiative')
-    .option('--store-path <path>', 'Existing local context store root for --initiative')
+    .option('--goal <text>', 'Optional goal metadata to store with the change')
     .option('--schema <name>', `Workflow schema to use (default: ${DEFAULT_SCHEMA})`)
     .option('--json', 'Output as JSON')
+    .option('--store <id>', STORE_OPTION_DESCRIPTION)
+    .addOption(hiddenStorePathOption())
+    // Removed options kept registered (hidden) so users get a deliberate
+    // explanation instead of a generic unknown-option error.
+    .addOption(new Option('--initiative <id>', 'No longer supported').hideHelp())
+    .addOption(new Option('--areas <names>', 'No longer supported').hideHelp())
     .action(async (name, options) => {
     try {
         await newChangeCommand(name, options);
     }
     catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
-        process.exit(1);
-    }
-});
-// Set command group
-const setCmd = program.command('set').description('Set checked-in OpenSpec metadata');
-setCmd
-    .command('change <name>')
-    .description('Set repo-local change metadata')
-    .option('--initiative <id>', 'Link the repo-local change to an initiative')
-    .option('--store <id>', 'Context store id for --initiative')
-    .option('--store-path <path>', 'Existing local context store root for --initiative')
-    .option('--json', 'Output as JSON')
-    .action(async (name, options) => {
-    try {
-        await setChangeCommand(name, options);
-    }
-    catch (error) {
-        console.log();
-        ora().fail(`Error: ${error.message}`);
+        failWithError(error);
         process.exit(1);
     }
 });

package/dist/commands/change.d.ts

@@ -1,6 +1,9 @@
+import type { RootOutput } from '../core/root-selection.js';
 export declare class ChangeCommand {
     private converter;
-    constructor();
+    private rootPath?;
+    constructor(rootPath?: string);
+    private getChangesPath;
     /**
      * Show a change proposal.
      * - Text mode: raw markdown passthrough (no filters)
@@ -12,6 +15,7 @@ export declare class ChangeCommand {
         requirementsOnly?: boolean;
         deltasOnly?: boolean;
         noInteractive?: boolean;
+        rootOutput?: RootOutput;
     }): Promise<void>;
     /**
      * List active changes.

package/dist/commands/change.js

@@ -11,8 +11,15 @@ const TASK_PATTERN = /^[-*]\s+\[[\sx]\]/i;
 const COMPLETED_TASK_PATTERN = /^[-*]\s+\[x\]/i;
 export class ChangeCommand {
     converter;
-    constructor() {
+    rootPath;
+    // rootPath is set only by root-aware callers (top-level `show`); the
+    // deprecated noun-form commands stay cwd-based.
+    constructor(rootPath) {
         this.converter = new JsonConverter();
+        this.rootPath = rootPath;
+    }
+    getChangesPath() {
+        return path.join(this.rootPath ?? process.cwd(), 'openspec', 'changes');
     }
     /**
      * Show a change proposal.
@@ -21,7 +28,7 @@ export class ChangeCommand {
      *   Note: --requirements-only is deprecated alias for --deltas-only
      */
     async show(changeName, options) {
-        const changesPath = path.join(process.cwd(), 'openspec', 'changes');
+        const changesPath = this.getChangesPath();
         if (!changeName) {
             const canPrompt = isInteractive(options);
             const changes = await this.getActiveChanges(changesPath);
@@ -62,19 +69,14 @@ export class ChangeCommand {
             const title = this.extractTitle(contentForTitle, changeName);
             const id = parsed.name;
             const deltas = parsed.deltas || [];
-            if (options.requirementsOnly || options.deltasOnly) {
-                const output = { id, title, deltaCount: deltas.length, deltas };
-                console.log(JSON.stringify(output, null, 2));
-            }
-            else {
-                const output = {
-                    id,
-                    title,
-                    deltaCount: deltas.length,
-                    deltas,
-                };
-                console.log(JSON.stringify(output, null, 2));
-            }
+            const output = {
+                id,
+                title,
+                deltaCount: deltas.length,
+                deltas,
+                ...(options.rootOutput ? { root: options.rootOutput } : {}),
+            };
+            console.log(JSON.stringify(output, null, 2));
         }
         else {
             const content = await fs.readFile(proposalPath, 'utf-8');

package/dist/commands/config.js

@@ -6,7 +6,7 @@ import { getNestedValue, setNestedValue, deleteNestedValue, coerceValue, formatV
 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';
-import { findWorkspaceRoot, hasWorkspaceSkillProfileDrift, readOptionalWorkspaceViewState, } from '../core/workspace/index.js';
+import { isPromptCancellationError } from './shared-output.js';
 const WORKFLOW_PROMPT_META = {
     propose: {
         name: 'Propose change',
@@ -53,10 +53,6 @@ const WORKFLOW_PROMPT_META = {
         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.
  */
@@ -133,16 +129,6 @@ export function diffProfileState(before, after) {
         lines,
     };
 }
-async function resolveWorkspaceConfigProfileContext(cwd = process.cwd()) {
-    const workspaceRoot = await findWorkspaceRoot(cwd);
-    if (!workspaceRoot) {
-        return null;
-    }
-    return {
-        root: workspaceRoot,
-        commandCwd: cwd,
-    };
-}
 function maybeWarnProjectConfigDrift(projectDir, state, colorize) {
     const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
     if (!fs.existsSync(openspecDir)) {
@@ -153,28 +139,7 @@ function maybeWarnProjectConfigDrift(projectDir, state, colorize) {
     }
     console.log(colorize('Warning: Global config is not applied to this project. Run `openspec update` to sync.'));
 }
-async function maybeWarnConfigDrift(state, colorize) {
-    const workspaceContext = await resolveWorkspaceConfigProfileContext();
-    if (workspaceContext) {
-        let viewState = null;
-        try {
-            viewState = await readOptionalWorkspaceViewState(workspaceContext.root);
-        }
-        catch {
-            return;
-        }
-        if (hasWorkspaceSkillProfileDrift(viewState)) {
-            console.log(colorize('Warning: Workspace-local agent skills are out of sync with the active global profile. Run `openspec workspace update` to sync.'));
-        }
-        return;
-    }
-    maybeWarnProjectConfigDrift(process.cwd(), state, colorize);
-}
-function printConfigProfileApplyGuidance(workspaceContext) {
-    if (workspaceContext) {
-        console.log('Config updated. Run `openspec workspace update` to apply it to workspace-local skills.');
-        return;
-    }
+function printConfigProfileApplyGuidance() {
     console.log('Config updated. Run `openspec update` in your projects to apply.');
 }
 /**
@@ -418,8 +383,7 @@ export function registerConfigCommand(program) {
             config.workflows = [...CORE_WORKFLOWS];
             // Preserve delivery setting
             saveGlobalConfig(config);
-            const workspaceContext = await resolveWorkspaceConfigProfileContext();
-            printConfigProfileApplyGuidance(workspaceContext);
+            printConfigProfileApplyGuidance();
             return;
         }
         if (preset) {
@@ -472,7 +436,7 @@ export function registerConfigCommand(program) {
             });
             if (action === 'keep') {
                 console.log('No config changes.');
-                await maybeWarnConfigDrift(currentState, chalk.yellow);
+                maybeWarnProjectConfigDrift(process.cwd(), currentState, chalk.yellow);
                 return;
             }
             const nextState = {
@@ -541,7 +505,7 @@ export function registerConfigCommand(program) {
             const diff = diffProfileState(currentState, nextState);
             if (!diff.hasChanges) {
                 console.log('No config changes.');
-                await maybeWarnConfigDrift(nextState, chalk.yellow);
+                maybeWarnProjectConfigDrift(process.cwd(), nextState, chalk.yellow);
                 return;
             }
             console.log(chalk.bold('\nConfig changes:'));
@@ -553,29 +517,6 @@ export function registerConfigCommand(program) {
             config.delivery = nextState.delivery;
             config.workflows = nextState.workflows;
             saveGlobalConfig(config);
-            const workspaceContext = await resolveWorkspaceConfigProfileContext();
-            if (workspaceContext) {
-                const applyNow = await confirm({
-                    message: 'Apply changes to this workspace now?',
-                    default: true,
-                });
-                if (applyNow) {
-                    try {
-                        execSync('npx openspec workspace update', {
-                            stdio: 'inherit',
-                            cwd: workspaceContext.commandCwd,
-                        });
-                        console.log('Run `openspec workspace update` in your other workspaces to apply.');
-                    }
-                    catch {
-                        console.error('`openspec workspace update` failed. Please run it manually to apply the profile changes.');
-                        process.exitCode = 1;
-                    }
-                    return;
-                }
-                printConfigProfileApplyGuidance(workspaceContext);
-                return;
-            }
             // Check if inside an OpenSpec project
             const projectDir = process.cwd();
             const openspecDir = path.join(projectDir, OPENSPEC_DIR_NAME);
@@ -596,7 +537,7 @@ export function registerConfigCommand(program) {
                     return;
                 }
             }
-            printConfigProfileApplyGuidance(null);
+            printConfigProfileApplyGuidance();
         }
         catch (error) {
             if (isPromptCancellationError(error)) {

package/dist/commands/context.d.ts

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