@fission-ai/openspec 1.5.0 → 1.6.0-beta.1

package/README.md

@@ -85,6 +85,18 @@ AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
 
 </details>
 
+## Why teams adopt OpenSpec
+
+Solo, OpenSpec keeps you and your AI honest on a single repo. On a team, the hard part moves: a feature spans the API server, the web app, and a shared library; requirements are owned by one team and consumed by others; planning starts before any code exists.
+
+**[Stores](docs/stores-beta/user-guide.md)** are the answer — planning in a repo of its own. The same `openspec/` shape you already know (specs and changes), shared by `git push` like anything else. One source of truth your whole team and every coding agent can read, across every repo.
+
+- **Cross-repo features** — one change, one plan, even when the code lands in three repos.
+- **Shared requirements** — a platform team owns the specs; product teams reference them read-only, right where their coding agent can read them. No drifting wiki.
+- **Plan before code** — capture the plan in the store now; the code repos catch up later.
+
+> Stores are in **beta**. Start with the [Stores User Guide](docs/stores-beta/user-guide.md).
+
 ## Quick Start
 
 **Requires Node.js 20.19.0 or higher.**
@@ -150,7 +162,7 @@ AI coding assistants are powerful but unpredictable when requirements live only
 - **Agree before you build** — human and AI align on specs before code gets written
 - **Stay organized** — each change gets its own folder with proposal, specs, design, and tasks
 - **Work fluidly** — update any artifact anytime, no rigid phase gates
-- **Use your tools** — works with 20+ AI assistants via slash commands
+- **Use your tools** — works with 30+ AI assistants via slash commands
 
 ### How we compare
 

package/dist/commands/change.d.ts

@@ -33,7 +33,6 @@ export declare class ChangeCommand {
     }): Promise<void>;
     private getActiveChanges;
     private extractTitle;
-    private countTasks;
     private printNextSteps;
 }
 //# sourceMappingURL=change.d.ts.map

package/dist/commands/change.js

@@ -5,10 +5,9 @@ import { Validator } from '../core/validation/validator.js';
 import { ChangeParser } from '../core/parsers/change-parser.js';
 import { isInteractive } from '../utils/interactive.js';
 import { getActiveChangeIds } from '../utils/item-discovery.js';
+import { getTaskProgressForChange } from '../utils/task-progress.js';
 // Constants for better maintainability
 const ARCHIVE_DIR = 'archive';
-const TASK_PATTERN = /^[-*]\s+\[[\sx]\]/i;
-const COMPLETED_TASK_PATTERN = /^[-*]\s+\[x\]/i;
 export class ChangeCommand {
     converter;
     rootPath;
@@ -94,23 +93,14 @@ export class ChangeCommand {
         if (options?.json) {
             const changeDetails = await Promise.all(changes.map(async (changeName) => {
                 const proposalPath = path.join(changesPath, changeName, 'proposal.md');
-                const tasksPath = path.join(changesPath, changeName, 'tasks.md');
                 try {
                     const content = await fs.readFile(proposalPath, 'utf-8');
                     const changeDir = path.join(changesPath, changeName);
                     const parser = new ChangeParser(content, changeDir);
                     const change = await parser.parseChangeWithDeltas(changeName);
-                    let taskStatus = { total: 0, completed: 0 };
-                    try {
-                        const tasksContent = await fs.readFile(tasksPath, 'utf-8');
-                        taskStatus = this.countTasks(tasksContent);
-                    }
-                    catch (error) {
-                        // Tasks file may not exist, which is okay
-                        if (process.env.DEBUG) {
-                            console.error(`Failed to read tasks file at ${tasksPath}:`, error);
-                        }
-                    }
+                    // Resolve task progress through the shared tracked-tasks helper so
+                    // this deprecated noun-form list cannot re-fork the resolution (#1202).
+                    const taskStatus = await getTaskProgressForChange(changesPath, changeName, process.cwd());
                     return {
                         id: changeName,
                         title: this.extractTitle(content, changeName),
@@ -144,21 +134,11 @@ export class ChangeCommand {
             // Long format: id: title and minimal counts
             for (const changeName of sorted) {
                 const proposalPath = path.join(changesPath, changeName, 'proposal.md');
-                const tasksPath = path.join(changesPath, changeName, 'tasks.md');
                 try {
                     const content = await fs.readFile(proposalPath, 'utf-8');
                     const title = this.extractTitle(content, changeName);
-                    let taskStatusText = '';
-                    try {
-                        const tasksContent = await fs.readFile(tasksPath, 'utf-8');
-                        const { total, completed } = this.countTasks(tasksContent);
-                        taskStatusText = ` [tasks ${completed}/${total}]`;
-                    }
-                    catch (error) {
-                        if (process.env.DEBUG) {
-                            console.error(`Failed to read tasks file at ${tasksPath}:`, error);
-                        }
-                    }
+                    const { total, completed } = await getTaskProgressForChange(changesPath, changeName, process.cwd());
+                    const taskStatusText = total > 0 ? ` [tasks ${completed}/${total}]` : '';
                     const changeDir = path.join(changesPath, changeName);
                     const parser = new ChangeParser(await fs.readFile(proposalPath, 'utf-8'), changeDir);
                     const change = await parser.parseChangeWithDeltas(changeName);
@@ -253,20 +233,6 @@ export class ChangeCommand {
         const match = content.match(/^#\s+(?:Change:\s+)?(.+)$/im);
         return match ? match[1].trim() : changeName;
     }
-    countTasks(content) {
-        const lines = content.split('\n');
-        let total = 0;
-        let completed = 0;
-        for (const line of lines) {
-            if (line.match(TASK_PATTERN)) {
-                total++;
-                if (line.match(COMPLETED_TASK_PATTERN)) {
-                    completed++;
-                }
-            }
-        }
-        return { total, completed };
-    }
     printNextSteps() {
         const bullets = [];
         bullets.push('- Ensure change has deltas in specs/: use headers ## ADDED/MODIFIED/REMOVED/RENAMED Requirements');

package/dist/commands/validate.d.ts

@@ -14,6 +14,14 @@ interface ExecuteOptions {
 export declare class ValidateCommand {
     execute(itemName: string | undefined, options?: ExecuteOptions): Promise<void>;
     private normalizeType;
+    /**
+     * Resolve change IDs by directory existence within the resolved root — the
+     * same rule `openspec status`/`instructions` use (`getAvailableChanges`) —
+     * rather than requiring `proposal.md`. This lets `validate` resolve a
+     * scaffolded or still-authoring change that the sibling commands already
+     * resolve (#1182). Sorted to preserve the prior `getActiveChangeIds` ordering.
+     */
+    private listChangeIds;
     private runInteractiveSelector;
     private printNonInteractiveHint;
     private validateDirectItem;

package/dist/commands/validate.js

@@ -3,7 +3,8 @@ import path from 'path';
 import { Validator } from '../core/validation/validator.js';
 import { resolveRootForCommand, toRootOutput, withStoreFlag, isStoreSelectedRoot, } from '../core/root-selection.js';
 import { isInteractive, resolveNoInteractive } from '../utils/interactive.js';
-import { getActiveChangeIds, getSpecIds } from '../utils/item-discovery.js';
+import { getSpecIds } from '../utils/item-discovery.js';
+import { getAvailableChanges } from './workflow/shared.js';
 import { nearestMatches } from '../utils/match.js';
 export class ValidateCommand {
     async execute(itemName, options = {}) {
@@ -42,6 +43,17 @@ export class ValidateCommand {
             return v;
         return undefined;
     }
+    /**
+     * Resolve change IDs by directory existence within the resolved root — the
+     * same rule `openspec status`/`instructions` use (`getAvailableChanges`) —
+     * rather than requiring `proposal.md`. This lets `validate` resolve a
+     * scaffolded or still-authoring change that the sibling commands already
+     * resolve (#1182). Sorted to preserve the prior `getActiveChangeIds` ordering.
+     */
+    async listChangeIds(root) {
+        const ids = await getAvailableChanges(root.path, root.changesDir);
+        return ids.sort();
+    }
     async runInteractiveSelector(root, opts) {
         const { select } = await import('@inquirer/prompts');
         const choice = await select({
@@ -60,7 +72,7 @@ export class ValidateCommand {
         if (choice === 'specs')
             return this.runBulkValidation(root, { changes: false, specs: true }, opts);
         // one
-        const [changes, specs] = await Promise.all([getActiveChangeIds(root.path), getSpecIds(root.path)]);
+        const [changes, specs] = await Promise.all([this.listChangeIds(root), getSpecIds(root.path)]);
         const items = [];
         items.push(...changes.map(id => ({ name: `change/${id}`, value: { type: 'change', id } })));
         items.push(...specs.map(id => ({ name: `spec/${id}`, value: { type: 'spec', id } })));
@@ -81,7 +93,7 @@ export class ValidateCommand {
         console.error('Or run in an interactive terminal.');
     }
     async validateDirectItem(root, itemName, opts) {
-        const [changes, specs] = await Promise.all([getActiveChangeIds(root.path), getSpecIds(root.path)]);
+        const [changes, specs] = await Promise.all([this.listChangeIds(root), getSpecIds(root.path)]);
         const isChange = changes.includes(itemName);
         const isSpec = specs.includes(itemName);
         const type = opts.typeOverride ?? (isChange ? 'change' : isSpec ? 'spec' : undefined);
@@ -183,7 +195,7 @@ export class ValidateCommand {
     async runBulkValidation(root, scope, opts) {
         const spinner = !opts.json && !opts.noInteractive ? ora('Validating...').start() : undefined;
         const [changeIds, specIds] = await Promise.all([
-            scope.changes ? getActiveChangeIds(root.path) : Promise.resolve([]),
+            scope.changes ? this.listChangeIds(root) : Promise.resolve([]),
             scope.specs ? getSpecIds(root.path) : Promise.resolve([]),
         ]);
         const DEFAULT_CONCURRENCY = 6;

package/dist/core/archive.js

@@ -5,6 +5,12 @@ import { Validator } from './validation/validator.js';
 import chalk from 'chalk';
 import { emitStoreRootBanner, isRootSelectionError, resolveOpenSpecRoot, toRootOutput, withStoreFlag, isStoreSelectedRoot, } from './root-selection.js';
 import { findSpecUpdates, buildUpdatedSpec, writeUpdatedSpec, } from './specs-apply.js';
+function isMissingPathError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
 async function listActiveChangeNames(changesDir) {
     try {
         const entries = await fs.readdir(changesDir, { withFileTypes: true });
@@ -13,7 +19,9 @@ async function listActiveChangeNames(changesDir) {
             .map((entry) => entry.name)
             .sort();
     }
-    catch {
+    catch (error) {
+        if (!isMissingPathError(error))
+            throw error;
         return [];
     }
 }
@@ -136,13 +144,6 @@ export class ArchiveCommand {
         const changesDir = root.changesDir;
         const archiveDir = root.archiveDir;
         const mainSpecsDir = root.specsDir;
-        // Check if changes directory exists
-        try {
-            await fs.access(changesDir);
-        }
-        catch {
-            throw new Error("No OpenSpec changes directory found. Run 'openspec init' first.");
-        }
         // Get change name interactively if not provided
         if (!changeName) {
             if (json) {
@@ -237,6 +238,7 @@ export class ArchiveCommand {
                 }
                 console.log(chalk.red('\nValidation failed. Please fix the errors before archiving.'));
                 console.log(chalk.yellow('To skip validation (not recommended), use --no-validate flag.'));
+                process.exitCode = 1;
                 return null;
             }
         }
@@ -266,7 +268,7 @@ export class ArchiveCommand {
             console.log(chalk.yellow(`Affected files: ${changeDir}`));
         }
         // Show progress and check for incomplete tasks
-        const progress = await getTaskProgressForChange(changesDir, changeName);
+        const progress = await getTaskProgressForChange(changesDir, changeName, path.resolve(changesDir, '..', '..'));
         if (!json) {
             const status = formatTaskStatus(progress);
             console.log(`Task status: ${status}`);
@@ -342,6 +344,7 @@ export class ArchiveCommand {
                         }
                         console.log(String(err.message || err));
                         console.log('Aborted. No files were changed.');
+                        process.exitCode = 1;
                         return null;
                     }
                     // Validate every rebuilt spec before writing any of them, so a
@@ -362,6 +365,7 @@ export class ArchiveCommand {
                                         console.log(chalk.yellow(`  ⚠ ${issue.message}`));
                                 }
                                 console.log('Aborted. No files were changed.');
+                                process.exitCode = 1;
                                 return null;
                             }
                         }
@@ -422,12 +426,7 @@ export class ArchiveCommand {
     }
     async selectChange(changesDir) {
         const { select } = await import('@inquirer/prompts');
-        // Get all directories in changes (excluding archive)
-        const entries = await fs.readdir(changesDir, { withFileTypes: true });
-        const changeDirs = entries
-            .filter(entry => entry.isDirectory() && entry.name !== 'archive')
-            .map(entry => entry.name)
-            .sort();
+        const changeDirs = await listActiveChangeNames(changesDir);
         if (changeDirs.length === 0) {
             console.log('No active changes found.');
             return null;
@@ -437,7 +436,7 @@ export class ArchiveCommand {
         try {
             const progressList = [];
             for (const id of changeDirs) {
-                const progress = await getTaskProgressForChange(changesDir, id);
+                const progress = await getTaskProgressForChange(changesDir, id, path.resolve(changesDir, '..', '..'));
                 const status = formatTaskStatus(progress);
                 progressList.push({ id, status });
             }

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

@@ -7,7 +7,7 @@ import type { ToolCommandAdapter } from '../types.js';
 /**
  * Claude Code adapter for command generation.
  * File path: .claude/commands/opsx/<id>.md
- * Frontmatter: name, description, category, tags
+ * Frontmatter: name, description, allowed-tools, category, tags
  */
 export declare const claudeAdapter: ToolCommandAdapter;
 //# sourceMappingURL=claude.d.ts.map

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

@@ -5,6 +5,7 @@
  */
 import path from 'path';
 import { escapeYamlValue } from '../yaml.js';
+import { OPENSPEC_CLI_ALLOWED_TOOLS } from '../../shared/allowed-tools.js';
 /**
  * Formats a tags array as a YAML array with proper escaping.
  */
@@ -15,7 +16,7 @@ function formatTagsArray(tags) {
 /**
  * Claude Code adapter for command generation.
  * File path: .claude/commands/opsx/<id>.md
- * Frontmatter: name, description, category, tags
+ * Frontmatter: name, description, allowed-tools, category, tags
  */
 export const claudeAdapter = {
     toolId: 'claude',
@@ -26,6 +27,7 @@ export const claudeAdapter = {
         return `---
 name: ${escapeYamlValue(content.name)}
 description: ${escapeYamlValue(content.description)}
+allowed-tools: ${OPENSPEC_CLI_ALLOWED_TOOLS}
 category: ${escapeYamlValue(content.category)}
 tags: ${formatTagsArray(content.tags)}
 ---

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

@@ -22,11 +22,13 @@ export { iflowAdapter } from './iflow.js';
 export { junieAdapter } from './junie.js';
 export { kilocodeAdapter } from './kilocode.js';
 export { kiroAdapter } from './kiro.js';
+export { ohMyPiAdapter } from './oh-my-pi.js';
 export { opencodeAdapter } from './opencode.js';
 export { piAdapter } from './pi.js';
 export { qoderAdapter } from './qoder.js';
 export { lingmaAdapter } from './lingma.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';
+export { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -22,11 +22,13 @@ export { iflowAdapter } from './iflow.js';
 export { junieAdapter } from './junie.js';
 export { kilocodeAdapter } from './kilocode.js';
 export { kiroAdapter } from './kiro.js';
+export { ohMyPiAdapter } from './oh-my-pi.js';
 export { opencodeAdapter } from './opencode.js';
 export { piAdapter } from './pi.js';
 export { qoderAdapter } from './qoder.js';
 export { lingmaAdapter } from './lingma.js';
 export { qwenAdapter } from './qwen.js';
 export { roocodeAdapter } from './roocode.js';
+export { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.js.map

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

@@ -0,0 +1,21 @@
+/**
+ * Oh My Pi (OMP) Command Adapter
+ *
+ * Formats commands for Oh My Pi following its slash command specification.
+ * OMP loads slash commands from .omp/commands/*.md with YAML frontmatter.
+ * The filename (minus .md) becomes the slash command name.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Oh My Pi adapter for command generation.
+ * File path: .omp/commands/opsx-<id>.md
+ * Frontmatter: description
+ *
+ * OMP uses the filename (minus .md) as the slash command name, so
+ * opsx-propose.md → /opsx-propose. Command references in the body
+ * are transformed from /opsx: to /opsx- for consistency, and
+ * $@ is injected after **Input**: headings so user-supplied arguments
+ * (e.g. /opsx-propose my-feature) are visible to the agent.
+ */
+export declare const ohMyPiAdapter: ToolCommandAdapter;
+//# sourceMappingURL=oh-my-pi.d.ts.map

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

@@ -0,0 +1,44 @@
+/**
+ * Oh My Pi (OMP) Command Adapter
+ *
+ * Formats commands for Oh My Pi following its slash command specification.
+ * OMP loads slash commands from .omp/commands/*.md with YAML frontmatter.
+ * The filename (minus .md) becomes the slash command name.
+ */
+import path from 'path';
+import { transformToHyphenCommands } from '../../../utils/command-references.js';
+import { escapeYamlValue } from '../yaml.js';
+const OMP_INPUT_HEADING = /^\*\*Input\*\*:[^\n]*$/m;
+function injectOmpArgs(body) {
+    if (body.includes('$@') || body.includes('$ARGUMENTS')) {
+        return body;
+    }
+    return body.replace(OMP_INPUT_HEADING, (heading) => `${heading}\n**Provided arguments**: $@`);
+}
+/**
+ * Oh My Pi adapter for command generation.
+ * File path: .omp/commands/opsx-<id>.md
+ * Frontmatter: description
+ *
+ * OMP uses the filename (minus .md) as the slash command name, so
+ * opsx-propose.md → /opsx-propose. Command references in the body
+ * are transformed from /opsx: to /opsx- for consistency, and
+ * $@ is injected after **Input**: headings so user-supplied arguments
+ * (e.g. /opsx-propose my-feature) are visible to the agent.
+ */
+export const ohMyPiAdapter = {
+    toolId: 'oh-my-pi',
+    getFilePath(commandId) {
+        return path.join('.omp', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        const transformedBody = transformToHyphenCommands(content.body);
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${injectOmpArgs(transformedBody)}
+`;
+    },
+};
+//# sourceMappingURL=oh-my-pi.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae IDE following its command specification.
+ */
+import path from 'path';
+/**
+ * Escapes a string value for safe YAML output.
+ * Quotes the string if it contains special YAML characters.
+ */
+function escapeYamlValue(value) {
+    if (value === '') {
+        return '""';
+    }
+    // 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, backslashes, and newlines
+        const escaped = value
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/opsx-<id>.md
+ * Frontmatter: name, description
+ */
+export const traeAdapter = {
+    toolId: 'trae',
+    getFilePath(commandId) {
+        return path.join('.trae', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=trae.js.map

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

@@ -23,12 +23,14 @@ import { iflowAdapter } from './adapters/iflow.js';
 import { junieAdapter } from './adapters/junie.js';
 import { kilocodeAdapter } from './adapters/kilocode.js';
 import { kiroAdapter } from './adapters/kiro.js';
+import { ohMyPiAdapter } from './adapters/oh-my-pi.js';
 import { opencodeAdapter } from './adapters/opencode.js';
 import { piAdapter } from './adapters/pi.js';
 import { qoderAdapter } from './adapters/qoder.js';
 import { lingmaAdapter } from './adapters/lingma.js';
 import { qwenAdapter } from './adapters/qwen.js';
 import { roocodeAdapter } from './adapters/roocode.js';
+import { traeAdapter } from './adapters/trae.js';
 import { windsurfAdapter } from './adapters/windsurf.js';
 /**
  * Registry for looking up tool command adapters.
@@ -56,12 +58,14 @@ export class CommandAdapterRegistry {
         CommandAdapterRegistry.register(junieAdapter);
         CommandAdapterRegistry.register(kilocodeAdapter);
         CommandAdapterRegistry.register(kiroAdapter);
+        CommandAdapterRegistry.register(ohMyPiAdapter);
         CommandAdapterRegistry.register(opencodeAdapter);
         CommandAdapterRegistry.register(piAdapter);
         CommandAdapterRegistry.register(qoderAdapter);
         CommandAdapterRegistry.register(lingmaAdapter);
         CommandAdapterRegistry.register(qwenAdapter);
         CommandAdapterRegistry.register(roocodeAdapter);
+        CommandAdapterRegistry.register(traeAdapter);
         CommandAdapterRegistry.register(windsurfAdapter);
     }
     /**

package/dist/core/config.js

@@ -27,6 +27,7 @@ export const AI_TOOLS = [
     { name: 'Kiro', value: 'kiro', available: true, successLabel: 'Kiro', skillsDir: '.kiro' },
     { name: 'Lingma', value: 'lingma', available: true, successLabel: 'Lingma', skillsDir: '.lingma' },
     { name: 'Mistral Vibe', value: 'vibe', available: true, successLabel: 'Mistral Vibe', skillsDir: '.vibe' },
+    { name: 'Oh My Pi', value: 'oh-my-pi', available: true, successLabel: 'Oh My Pi', skillsDir: '.omp' },
     { name: 'OpenCode', value: 'opencode', available: true, successLabel: 'OpenCode', skillsDir: '.opencode' },
     { name: 'Pi', value: 'pi', available: true, successLabel: 'Pi', skillsDir: '.pi' },
     { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },

package/dist/core/init.js

@@ -39,6 +39,7 @@ const WORKFLOW_TO_SKILL_DIR = {
     'new': 'openspec-new-change',
     'continue': 'openspec-continue-change',
     'apply': 'openspec-apply-change',
+    'update': 'openspec-update-change',
     'ff': 'openspec-ff-change',
     'sync': 'openspec-sync-specs',
     'archive': 'openspec-archive-change',
@@ -403,8 +404,8 @@ export class InitCommand {
                         const skillDir = path.join(skillsDir, dirName);
                         const skillFile = path.join(skillDir, 'SKILL.md');
                         // Generate SKILL.md content with YAML frontmatter including generatedBy
-                        // Use hyphen-based command references for tools where filename = command name
-                        const transformer = (tool.value === 'opencode' || tool.value === 'pi') ? transformToHyphenCommands : undefined;
+                        // Use hyphen-based command references for tools where filename === command name (oh-my-pi, opencode, pi)
+                        const transformer = (tool.value === 'opencode' || tool.value === 'pi' || tool.value === 'oh-my-pi') ? transformToHyphenCommands : undefined;
                         const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
                         // Write the skill file
                         await FileSystemUtils.writeFile(skillFile, skillContent);

package/dist/core/list.js

@@ -4,6 +4,22 @@ import { getTaskProgressForChange, formatTaskStatus } from '../utils/task-progre
 import { readFileSync } from 'fs';
 import { join } from 'path';
 import { MarkdownParser } from './parsers/markdown-parser.js';
+function isMissingPathError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ENOENT');
+}
+async function readChangeDirectoryEntries(changesDir) {
+    try {
+        return await fs.readdir(changesDir, { withFileTypes: true });
+    }
+    catch (error) {
+        if (isMissingPathError(error))
+            return [];
+        throw error;
+    }
+}
 /**
  * Get the most recent modification time of any file in a directory (recursive).
  * Falls back to the directory's own mtime if no files are found.
@@ -64,15 +80,8 @@ export class ListCommand {
         const { sort = 'recent', json = false, root } = options;
         if (mode === 'changes') {
             const changesDir = path.join(targetPath, 'openspec', 'changes');
-            // Check if changes directory exists
-            try {
-                await fs.access(changesDir);
-            }
-            catch {
-                throw new Error("No OpenSpec changes directory found. Run 'openspec init' first.");
-            }
             // Get all directories in changes (excluding archive)
-            const entries = await fs.readdir(changesDir, { withFileTypes: true });
+            const entries = await readChangeDirectoryEntries(changesDir);
             const changeDirs = entries
                 .filter(entry => entry.isDirectory() && entry.name !== 'archive')
                 .map(entry => entry.name);
@@ -88,7 +97,7 @@ export class ListCommand {
             // Collect information about each change
             const changes = [];
             for (const changeDir of changeDirs) {
-                const progress = await getTaskProgressForChange(changesDir, changeDir);
+                const progress = await getTaskProgressForChange(changesDir, changeDir, targetPath);
                 const changePath = path.join(changesDir, changeDir);
                 const lastModified = await getLastModified(changePath);
                 changes.push({

package/dist/core/openspec-root.js

@@ -11,8 +11,8 @@ export const OPENSPEC_CHANGES_DIR = 'openspec/changes';
 export const OPENSPEC_ARCHIVE_DIR = 'openspec/changes/archive';
 export const DEFAULT_OPENSPEC_SCHEMA = 'spec-driven';
 export const DIRECTORY_ANCHOR_FILE_NAME = '.gitkeep';
-// Git cannot track empty directories, so clones of a fresh store would lose
-// these and fail root-health checks. Anchored at setup time.
+// Git cannot track empty directories, so setup anchors otherwise-empty
+// conventional store directories for teammates who clone the repo later.
 export const ANCHORED_OPENSPEC_DIRS = [OPENSPEC_SPECS_DIR, OPENSPEC_ARCHIVE_DIR];
 async function pathKind(targetPath) {
     try {
@@ -51,6 +51,14 @@ function unresolvedInspection() {
 function missingDirectoryDiagnostic(code, message, target) {
     return makeStoreDiagnostic('error', code, message, { target });
 }
+async function inspectOptionalPlanningDirectory(inspection, storeRoot, key, relativePath, notDirectoryCode, target) {
+    const kind = await pathKind(path.join(storeRoot, relativePath));
+    inspection[key] = { present: kind === 'directory' };
+    if (kind === 'directory' || kind === 'missing')
+        return kind;
+    inspection.diagnostics.push(missingDirectoryDiagnostic(notDirectoryCode, `${relativePath}/ exists but is not a directory.`, target));
+    return kind;
+}
 export async function inspectOpenSpecRoot(storeRoot) {
     const rootKind = await pathKind(storeRoot);
     const inspection = unresolvedInspection();
@@ -90,23 +98,18 @@ export async function inspectOpenSpecRoot(storeRoot) {
             inspection.diagnostics.push(missingDirectoryDiagnostic('openspec_config_missing', 'Missing openspec/config.yaml or openspec/config.yml.', 'openspec.config'));
         }
     }
-    for (const [key, relativePath, code, message, target] of [
-        ['specs', OPENSPEC_SPECS_DIR, 'openspec_specs_missing', 'Missing openspec/specs/.', 'openspec.specs'],
-        ['changes', OPENSPEC_CHANGES_DIR, 'openspec_changes_missing', 'Missing openspec/changes/.', 'openspec.changes'],
-        ['archive', OPENSPEC_ARCHIVE_DIR, 'openspec_archive_missing', 'Missing openspec/changes/archive/.', 'openspec.archive'],
-    ]) {
-        const kind = await pathKind(path.join(storeRoot, relativePath));
-        inspection[key] = { present: kind === 'directory' };
-        if (kind === 'directory')
-            continue;
-        inspection.diagnostics.push(missingDirectoryDiagnostic(kind === 'missing' ? code : code.replace('_missing', '_not_directory'), kind === 'missing' ? message : `${relativePath}/ exists but is not a directory.`, target));
+    await inspectOptionalPlanningDirectory(inspection, storeRoot, 'specs', OPENSPEC_SPECS_DIR, 'openspec_specs_not_directory', 'openspec.specs');
+    const changesKind = await inspectOptionalPlanningDirectory(inspection, storeRoot, 'changes', OPENSPEC_CHANGES_DIR, 'openspec_changes_not_directory', 'openspec.changes');
+    if (changesKind === 'directory') {
+        await inspectOptionalPlanningDirectory(inspection, storeRoot, 'archive', OPENSPEC_ARCHIVE_DIR, 'openspec_archive_not_directory', 'openspec.archive');
+    }
+    else {
+        inspection.archive = { present: false };
     }
     inspection.healthy =
         inspection.present === true &&
             inspection.config.present === true &&
-            inspection.specs.present === true &&
-            inspection.changes.present === true &&
-            inspection.archive.present === true;
+            inspection.diagnostics.length === 0;
     return inspection;
 }
 async function ensureDirectory(storeRoot, relativePath, ledger) {