@fission-ai/openspec 1.3.1 → 1.4.1

package/README.md

@@ -96,7 +96,7 @@ openspec init
 
 Now tell your AI: `/opsx:propose <what-you-want-to-build>`
 
-If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.
+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.
@@ -115,6 +115,13 @@ If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/
 → **[Customization](docs/customization.md)**: make it yours
 
 
+## Community schemas
+
+Third-party schema bundles distributed via standalone repositories — these provide opinionated workflows that integrate OpenSpec with other tools, similar to how [github/spec-kit's community extension catalog](https://github.com/github/spec-kit/tree/main/extensions) handles tool integrations.
+
+→ **[Browse the catalog](docs/customization.md#community-schemas)** in the customization docs.
+
+
 ## Why OpenSpec?
 
 AI coding assistants are powerful but unpredictable when requirements live only in chat history. OpenSpec adds a lightweight spec layer so you agree on what to build before any code is written.
@@ -150,7 +157,7 @@ openspec update
 
 ## Usage Notes
 
-**Model selection**: OpenSpec works best with high-reasoning models. We recommend Opus 4.5 and GPT 5.2 for both planning and implementation.
+**Model selection**: OpenSpec works best with high-reasoning models. We recommend Codex 5.5 and Opus 4.7 for both planning and implementation.
 
 **Context hygiene**: OpenSpec benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.
 

package/bin/openspec.js

@@ -1,3 +1,5 @@
 #!/usr/bin/env node
 
-import '../dist/cli/index.js';
+import { runCli } from '../dist/cli/index.js';
+
+runCli();

package/dist/cli/index.d.ts

@@ -1,2 +1,5 @@
-export {};
+import { Command } from 'commander';
+declare const program: Command;
+export { program };
+export declare function runCli(argv?: string[]): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/cli/index.js

@@ -2,8 +2,9 @@ import { Command } 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 } from '../core/config.js';
+import { AI_TOOLS, OPENSPEC_DIR_NAME } from '../core/config.js';
 import { UpdateCommand } from '../core/update.js';
 import { ListCommand } from '../core/list.js';
 import { ArchiveCommand } from '../core/archive.js';
@@ -16,7 +17,11 @@ 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 { statusCommand, instructionsCommand, applyInstructionsCommand, templatesCommand, schemasCommand, newChangeCommand, DEFAULT_SCHEMA, } from '../commands/workflow/index.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 { maybeShowTelemetryNotice, trackCommand, shutdown } from '../telemetry/index.js';
 const program = new Command();
 const require = createRequire(import.meta.url);
@@ -65,6 +70,21 @@ 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')
@@ -137,6 +157,14 @@ program
     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);
     }
     catch (error) {
@@ -259,6 +287,9 @@ program
 registerSpecCommand(program);
 registerConfigCommand(program);
 registerSchemaCommand(program);
+registerWorkspaceCommand(program);
+registerContextStoreCommand(program);
+registerInitiativeCommand(program);
 // Top-level validate command
 program
     .command('validate [item-name]')
@@ -467,7 +498,13 @@ 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('--schema <name>', `Workflow schema to use (default: ${DEFAULT_SCHEMA})`)
+    .option('--json', 'Output as JSON')
     .action(async (name, options) => {
     try {
         await newChangeCommand(name, options);
@@ -478,5 +515,30 @@ newCmd
         process.exit(1);
     }
 });
-program.parse();
+// 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}`);
+        process.exit(1);
+    }
+});
+export { program };
+export function runCli(argv = process.argv) {
+    program.parse(argv);
+}
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+    runCli();
+}
 //# sourceMappingURL=index.js.map

package/dist/commands/completion.js

@@ -229,6 +229,13 @@ export class CompletionCommand {
                     }
                     break;
                 }
+                case 'schemas': {
+                    const schemaNames = await this.completionProvider.getSchemaNames();
+                    for (const name of schemaNames) {
+                        console.log(`${name}\tschema`);
+                    }
+                    break;
+                }
                 case 'archived-changes': {
                     const archivedIds = await getArchivedChangeIds();
                     for (const id of archivedIds) {

package/dist/commands/config.js

@@ -6,6 +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';
 const WORKFLOW_PROMPT_META = {
     propose: {
         name: 'Propose change',
@@ -132,7 +133,17 @@ export function diffProfileState(before, after) {
         lines,
     };
 }
-function maybeWarnConfigDrift(projectDir, state, colorize) {
+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)) {
         return;
@@ -142,6 +153,30 @@ function maybeWarnConfigDrift(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;
+    }
+    console.log('Config updated. Run `openspec update` in your projects to apply.');
+}
 /**
  * Register the config command and all its subcommands.
  *
@@ -383,7 +418,8 @@ export function registerConfigCommand(program) {
             config.workflows = [...CORE_WORKFLOWS];
             // Preserve delivery setting
             saveGlobalConfig(config);
-            console.log('Config updated. Run `openspec update` in your projects to apply.');
+            const workspaceContext = await resolveWorkspaceConfigProfileContext();
+            printConfigProfileApplyGuidance(workspaceContext);
             return;
         }
         if (preset) {
@@ -436,7 +472,7 @@ export function registerConfigCommand(program) {
             });
             if (action === 'keep') {
                 console.log('No config changes.');
-                maybeWarnConfigDrift(process.cwd(), currentState, chalk.yellow);
+                await maybeWarnConfigDrift(currentState, chalk.yellow);
                 return;
             }
             const nextState = {
@@ -505,7 +541,7 @@ export function registerConfigCommand(program) {
             const diff = diffProfileState(currentState, nextState);
             if (!diff.hasChanges) {
                 console.log('No config changes.');
-                maybeWarnConfigDrift(process.cwd(), nextState, chalk.yellow);
+                await maybeWarnConfigDrift(nextState, chalk.yellow);
                 return;
             }
             console.log(chalk.bold('\nConfig changes:'));
@@ -517,6 +553,29 @@ 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);
@@ -537,7 +596,7 @@ export function registerConfigCommand(program) {
                     return;
                 }
             }
-            console.log('Config updated. Run `openspec update` in your projects to apply.');
+            printConfigProfileApplyGuidance(null);
         }
         catch (error) {
             if (isPromptCancellationError(error)) {

package/dist/commands/context-store.d.ts

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