@fission-ai/openspec 1.4.0 → 1.5.0

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

@@ -56,6 +56,7 @@ export const COMMAND_REGISTRY = [
                 values: ['recent', 'name'],
             },
             COMMON_FLAGS.json,
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -91,6 +92,7 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
             },
             COMMON_FLAGS.noInteractive,
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -125,6 +127,7 @@ export const COMMAND_REGISTRY = [
                 description: 'Show specific requirement by ID (JSON only, spec-specific)',
                 takesValue: true,
             },
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -147,6 +150,11 @@ export const COMMAND_REGISTRY = [
                 name: 'no-validate',
                 description: 'Skip validation (not recommended)',
             },
+            {
+                name: 'json',
+                description: 'Output as JSON (non-interactive)',
+            },
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -164,6 +172,7 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
             },
             COMMON_FLAGS.json,
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -183,6 +192,7 @@ export const COMMAND_REGISTRY = [
                 takesValue: true,
             },
             COMMON_FLAGS.json,
+            COMMON_FLAGS.store,
         ],
     },
     {
@@ -222,27 +232,7 @@ export const COMMAND_REGISTRY = [
                     },
                     {
                         name: 'goal',
-                        description: 'Workspace product goal to store with the change',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'areas',
-                        description: 'Comma-separated affected workspace link names',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'initiative',
-                        description: 'Link the repo-local change to an initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store',
-                        description: 'Context store id for --initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root for --initiative',
+                        description: 'Optional goal metadata to store with the change',
                         takesValue: true,
                     },
                     {
@@ -251,254 +241,64 @@ export const COMMAND_REGISTRY = [
                         takesValue: true,
                     },
                     COMMON_FLAGS.json,
+                    COMMON_FLAGS.store,
                 ],
             },
         ],
     },
     {
-        name: 'set',
-        description: 'Set checked-in OpenSpec metadata',
-        flags: [],
-        subcommands: [
-            {
-                name: 'change',
-                description: 'Set repo-local change metadata',
-                acceptsPositional: true,
-                positionalType: 'change-id',
-                positionals: [{ name: 'name', type: 'change-id' }],
-                flags: [
-                    {
-                        name: 'initiative',
-                        description: 'Link the repo-local change to an initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store',
-                        description: 'Context store id for --initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root for --initiative',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                ],
-            },
-        ],
-    },
-    {
-        name: 'workspace',
-        description: 'Set up and inspect coordination workspaces',
-        flags: [],
-        subcommands: [
-            {
-                name: 'setup',
-                description: 'Set up a workspace and link existing repos or folders',
-                flags: [
-                    {
-                        name: 'name',
-                        description: 'Workspace name',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'link',
-                        description: 'Repo or folder link. Use <path> or <name>=<path>',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'opener',
-                        description: 'Preferred opener: codex-cli, claude, github-copilot, or editor',
-                        takesValue: true,
-                        values: ['codex-cli', 'claude', 'github-copilot', 'editor'],
-                    },
-                    {
-                        name: 'tools',
-                        description: 'Install OpenSpec skills for agents (all, none, or comma-separated tool IDs)',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-            {
-                name: 'list',
-                description: 'List known OpenSpec workspaces',
-                flags: [
-                    COMMON_FLAGS.json,
-                ],
-            },
-            {
-                name: 'ls',
-                description: 'List known OpenSpec workspaces',
-                flags: [
-                    COMMON_FLAGS.json,
-                ],
-            },
-            {
-                name: 'link',
-                description: 'Link an existing repo or folder to a workspace',
-                acceptsPositional: true,
-                positionals: [
-                    { name: 'name-or-path', type: 'path', optional: true },
-                    { name: 'path', type: 'path', optional: true },
-                ],
-                flags: [
-                    {
-                        name: 'workspace',
-                        description: 'Workspace name from local workspace views',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-            {
-                name: 'relink',
-                description: 'Update the local path for an existing workspace link',
-                acceptsPositional: true,
-                positionals: [
-                    { name: 'name' },
-                    { name: 'path', type: 'path' },
-                ],
-                flags: [
-                    {
-                        name: 'workspace',
-                        description: 'Workspace name from local workspace views',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-            {
-                name: 'doctor',
-                description: 'Check what a workspace can resolve on this machine',
-                flags: [
-                    {
-                        name: 'workspace',
-                        description: 'Workspace name from local workspace views',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-            {
-                name: 'update',
-                description: 'Refresh workspace-local OpenSpec guidance and agent skills',
-                acceptsPositional: true,
-                positionals: [{ name: 'name', optional: true }],
-                flags: [
-                    {
-                        name: 'workspace',
-                        description: 'Workspace name from local workspace views',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'tools',
-                        description: 'Select agents for workspace skills-only delivery; global profile selects workflows',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-            {
-                name: 'open',
-                description: 'Open a workspace in an agent or VS Code editor',
-                acceptsPositional: true,
-                positionals: [{ name: 'name', optional: true }],
-                flags: [
-                    {
-                        name: 'workspace',
-                        description: 'Workspace name from local workspace views',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'initiative',
-                        description: 'Open an initiative as a local workspace view',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store',
-                        description: 'Context store id for --initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root for --initiative',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'agent',
-                        description: 'Use an agent for this session: codex-cli, claude, or github-copilot',
-                        takesValue: true,
-                        values: ['codex-cli', 'claude', 'github-copilot'],
-                    },
-                    {
-                        name: 'editor',
-                        description: 'Open the workspace in VS Code editor mode',
-                    },
-                    {
-                        name: 'prepare-only',
-                        description: 'Unsupported: preview surfaces belong to a future context/query command',
-                    },
-                    COMMON_FLAGS.json,
-                    {
-                        name: 'change',
-                        description: 'Unsupported: change-scoped open belongs to future workspace change planning',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.noInteractive,
-                ],
-            },
-        ],
-    },
-    {
-        name: 'context-store',
-        description: 'Set up and inspect context stores',
+        name: 'store',
+        description: 'Create and manage stores - standalone OpenSpec repos you register on this machine',
         flags: [],
         subcommands: [
             {
                 name: 'setup',
-                description: 'Create or register a local context store',
+                description: 'Create or register a local store',
                 acceptsPositional: true,
                 positionals: [{ name: 'id', optional: true }],
                 flags: [
                     {
                         name: 'path',
-                        description: 'Directory to use for the context store',
+                        description: 'Directory to use for the store',
                         takesValue: true,
                     },
                     {
                         name: 'init-git',
-                        description: 'Initialize a Git repository in the context store',
+                        description: 'Initialize a Git repository in the store',
                     },
                     {
                         name: 'no-init-git',
                         description: 'Skip Git repository initialization',
                     },
+                    {
+                        name: 'remote',
+                        description: 'Canonical clone source recorded in store.yaml',
+                        takesValue: true,
+                    },
                     COMMON_FLAGS.json,
                 ],
             },
             {
                 name: 'register',
-                description: 'Register an existing context store directory',
+                description: 'Register an existing store directory',
                 acceptsPositional: true,
                 positionals: [{ name: 'path', type: 'path', optional: true }],
                 flags: [
                     {
                         name: 'id',
-                        description: 'Context store id',
+                        description: 'Store id',
                         takesValue: true,
                     },
+                    {
+                        name: 'yes',
+                        description: 'Confirm creating store identity metadata',
+                    },
                     COMMON_FLAGS.json,
                 ],
             },
             {
                 name: 'unregister',
-                description: 'Forget a local context-store registration without deleting files',
+                description: 'Forget a local store registration without deleting files',
                 acceptsPositional: true,
                 positionals: [{ name: 'id' }],
                 flags: [
@@ -507,34 +307,34 @@ export const COMMAND_REGISTRY = [
             },
             {
                 name: 'remove',
-                description: 'Forget a local context-store registration and delete its local folder',
+                description: 'Forget a local store registration and delete its local folder',
                 acceptsPositional: true,
                 positionals: [{ name: 'id' }],
                 flags: [
                     {
                         name: 'yes',
-                        description: 'Confirm local context-store folder deletion',
+                        description: 'Confirm local store folder deletion',
                     },
                     COMMON_FLAGS.json,
                 ],
             },
             {
                 name: 'list',
-                description: 'List registered context stores',
+                description: 'List registered stores',
                 flags: [
                     COMMON_FLAGS.json,
                 ],
             },
             {
                 name: 'ls',
-                description: 'List registered context stores',
+                description: 'List registered stores',
                 flags: [
                     COMMON_FLAGS.json,
                 ],
             },
             {
                 name: 'doctor',
-                description: 'Check local context-store registration and metadata',
+                description: 'Check local store registration and metadata',
                 acceptsPositional: true,
                 positionals: [{ name: 'id', optional: true }],
                 flags: [
@@ -544,88 +344,86 @@ export const COMMAND_REGISTRY = [
         ],
     },
     {
-        name: 'initiative',
-        description: 'Create and list coordinated initiatives',
+        name: 'context',
+        description: 'Print the working context for the resolved OpenSpec root',
+        flags: [
+            COMMON_FLAGS.json,
+            COMMON_FLAGS.store,
+            {
+                name: 'code-workspace',
+                description: 'Also write a VS Code workspace file for the set',
+                takesValue: true,
+            },
+            {
+                name: 'force',
+                description: 'Overwrite an existing --code-workspace file',
+            },
+        ],
+    },
+    {
+        name: 'doctor',
+        description: 'Report relationship health for the resolved OpenSpec root',
+        flags: [
+            COMMON_FLAGS.json,
+            COMMON_FLAGS.store,
+        ],
+    },
+    {
+        name: 'workset',
+        description: 'Compose, keep, and open personal working views (purely local)',
         flags: [],
         subcommands: [
             {
                 name: 'create',
-                description: 'Create an initiative in a context store',
+                description: 'Compose and save a named working view of folders you choose',
                 acceptsPositional: true,
-                positionals: [{ name: 'id', optional: true }],
+                positionals: [{ name: 'name', optional: true }],
                 flags: [
                     {
-                        name: 'store',
-                        description: 'Context store id from the local context-store registry',
+                        name: 'member',
+                        description: 'Member folder as <path> or <name>=<path>; repeatable, first is the primary',
                         takesValue: true,
                     },
                     {
-                        name: 'store-path',
-                        description: 'Existing local context store root',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'title',
-                        description: 'Initiative title',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'summary',
-                        description: 'Initiative summary',
+                        name: 'tool',
+                        description: 'Preferred tool to open this workset with',
                         takesValue: true,
                     },
                     COMMON_FLAGS.json,
                 ],
             },
             {
-                name: 'show',
-                description: 'Show where an initiative lives and how to read it',
-                acceptsPositional: true,
-                positionals: [{ name: 'id' }],
-                flags: [
-                    {
-                        name: 'store',
-                        description: 'Context store id from the local context-store registry',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
-                ],
+                name: 'list',
+                description: 'Show saved worksets with their members',
+                flags: [COMMON_FLAGS.json],
             },
             {
-                name: 'list',
-                description: 'List initiatives across registered context stores',
+                name: 'ls',
+                description: 'Show saved worksets with their members',
+                flags: [COMMON_FLAGS.json],
+            },
+            {
+                name: 'open',
+                description: 'Open a saved workset in your tool (editor window or agent session)',
+                acceptsPositional: true,
+                positionals: [{ name: 'name' }],
                 flags: [
                     {
-                        name: 'store',
-                        description: 'Context store id from the local context-store registry',
+                        name: 'tool',
+                        description: 'Open with this tool just this once',
                         takesValue: true,
                     },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root',
-                        takesValue: true,
-                    },
-                    COMMON_FLAGS.json,
                 ],
             },
             {
-                name: 'ls',
-                description: 'List initiatives across registered context stores',
+                name: 'remove',
+                description: 'Delete a saved workset (member folders are never touched)',
+                acceptsPositional: true,
+                positionals: [{ name: 'name' }],
                 flags: [
                     {
-                        name: 'store',
-                        description: 'Context store id from the local context-store registry',
-                        takesValue: true,
-                    },
-                    {
-                        name: 'store-path',
-                        description: 'Existing local context store root',
-                        takesValue: true,
+                        name: 'yes',
+                        description: 'Confirm removal non-interactively',
                     },
                     COMMON_FLAGS.json,
                 ],

package/dist/core/completions/generators/zsh-generator.js

@@ -250,7 +250,9 @@ compdef _openspec openspec
     escapeDescription(desc) {
         return desc
             .replace(/\\/g, '\\\\')
-            .replace(/'/g, "\\'")
+            // Inside zsh single quotes, backslash-quote does NOT escape; the
+            // idiom is close-quote, literal quote, reopen: '\''
+            .replace(/'/g, "'\\''")
             .replace(/\[/g, '\\[')
             .replace(/]/g, '\\]')
             .replace(/:/g, '\\:');

package/dist/core/completions/installers/bash-installer.js

@@ -210,6 +210,9 @@ export class BashInstaller {
                 // File doesn't exist or can't be read, proceed with installation
                 console.debug(`Unable to read existing completion file at ${targetPath}: ${error.message}`);
             }
+            if (!(await FileSystemUtils.canWriteFile(targetPath))) {
+                throw new Error(`Path is not writable: ${targetPath}`);
+            }
             // Ensure the directory exists
             const targetDir = path.dirname(targetPath);
             await fs.mkdir(targetDir, { recursive: true });

package/dist/core/completions/installers/fish-installer.js

@@ -1,6 +1,7 @@
 import { promises as fs } from 'fs';
 import path from 'path';
 import os from 'os';
+import { FileSystemUtils } from '../../../utils/file-system.js';
 /**
  * Installer for Fish completion scripts.
  * Fish automatically loads completions from ~/.config/fish/completions/
@@ -70,6 +71,9 @@ export class FishInstaller {
                 // File doesn't exist or can't be read, proceed with installation
                 console.debug(`Unable to read existing completion file at ${targetPath}: ${error.message}`);
             }
+            if (!(await FileSystemUtils.canWriteFile(targetPath))) {
+                throw new Error(`Path is not writable: ${targetPath}`);
+            }
             // Ensure the directory exists
             const targetDir = path.dirname(targetPath);
             await fs.mkdir(targetDir, { recursive: true });
@@ -125,6 +129,10 @@ export class FishInstaller {
                     message: 'Completion script is not installed',
                 };
             }
+            const targetDir = path.dirname(targetPath);
+            if (!(await FileSystemUtils.canWriteFile(targetDir))) {
+                throw new Error(`Path is not writable: ${targetDir}`);
+            }
             // Remove the completion script
             await fs.unlink(targetPath);
             return {

package/dist/core/completions/installers/powershell-installer.js

@@ -1,6 +1,7 @@
 import { promises as fs } from 'fs';
 import path from 'path';
 import os from 'os';
+import { FileSystemUtils } from '../../../utils/file-system.js';
 /**
  * Installer for PowerShell completion scripts.
  * Works with both Windows PowerShell 5.1 and PowerShell Core 7+
@@ -154,9 +155,23 @@ export class PowerShellInstaller {
         let anyConfigured = false;
         for (const profilePath of profilePaths) {
             try {
-                // Create profile file if it doesn't exist
                 const profileDir = path.dirname(profilePath);
-                await fs.mkdir(profileDir, { recursive: true });
+                let profileExists = false;
+                try {
+                    await fs.access(profilePath);
+                    profileExists = true;
+                }
+                catch (err) {
+                    if (err?.code !== 'ENOENT') {
+                        throw err;
+                    }
+                }
+                if (!profileExists) {
+                    if (!(await FileSystemUtils.canWriteFile(profilePath))) {
+                        throw new Error(`Path is not writable: ${profilePath}`);
+                    }
+                    await fs.mkdir(profileDir, { recursive: true });
+                }
                 let profileContent = '';
                 let fileEncoding = 'utf-8';
                 let fileBom = Buffer.alloc(0);
@@ -191,6 +206,9 @@ export class PowerShellInstaller {
                     '',
                 ].join('\n');
                 const newContent = profileContent + openspecBlock;
+                if (!(await FileSystemUtils.canWriteFile(profilePath))) {
+                    throw new Error(`Path is not writable: ${profilePath}`);
+                }
                 await this.writeProfileFile(profilePath, newContent, fileEncoding, fileBom);
                 anyConfigured = true;
             }
@@ -246,6 +264,9 @@ export class PowerShellInstaller {
                 const afterBlock = profileContent.substring(endIndex + endMarker.length);
                 // Clean up extra newlines
                 const newContent = (beforeBlock.trimEnd() + '\n' + afterBlock.trimStart()).trim() + '\n';
+                if (!(await FileSystemUtils.canWriteFile(profilePath))) {
+                    throw new Error(`Path is not writable: ${profilePath}`);
+                }
                 await this.writeProfileFile(profilePath, newContent, fileEncoding, fileBom);
                 anyRemoved = true;
             }
@@ -287,6 +308,9 @@ export class PowerShellInstaller {
                 // File doesn't exist or can't be read, proceed with installation
                 console.debug(`Unable to read existing completion file at ${targetPath}: ${error.message}`);
             }
+            if (!(await FileSystemUtils.canWriteFile(targetPath))) {
+                throw new Error(`Path is not writable: ${targetPath}`);
+            }
             // Ensure the directory exists
             const targetDir = path.dirname(targetPath);
             await fs.mkdir(targetDir, { recursive: true });
@@ -367,6 +391,10 @@ export class PowerShellInstaller {
                     message: 'Completion script is not installed',
                 };
             }
+            const targetDir = path.dirname(targetPath);
+            if (!(await FileSystemUtils.canWriteFile(targetDir))) {
+                throw new Error(`Path is not writable: ${targetDir}`);
+            }
             // Remove the completion script
             await fs.unlink(targetPath);
             // Remove profile configuration

package/dist/core/completions/installers/zsh-installer.js

@@ -228,6 +228,9 @@ export class ZshInstaller {
                 // File doesn't exist or can't be read, proceed with installation
                 console.debug(`Unable to read existing completion file at ${targetPath}: ${error.message}`);
             }
+            if (!(await FileSystemUtils.canWriteFile(targetPath))) {
+                throw new Error(`Path is not writable: ${targetPath}`);
+            }
             // Ensure the directory exists
             const targetDir = path.dirname(targetPath);
             await fs.mkdir(targetDir, { recursive: true });

package/dist/core/completions/shared-flags.d.ts

@@ -8,5 +8,6 @@ export declare const COMMON_FLAGS: {
     readonly strict: FlagDefinition;
     readonly noInteractive: FlagDefinition;
     readonly type: FlagDefinition;
+    readonly store: FlagDefinition;
 };
 //# sourceMappingURL=shared-flags.d.ts.map