@fission-ai/openspec 1.0.2 → 1.1.1

package/dist/core/archive.js

@@ -4,6 +4,44 @@ import { getTaskProgressForChange, formatTaskStatus } from '../utils/task-progre
 import { Validator } from './validation/validator.js';
 import chalk from 'chalk';
 import { findSpecUpdates, buildUpdatedSpec, writeUpdatedSpec, } from './specs-apply.js';
+/**
+ * Recursively copy a directory. Used when fs.rename fails (e.g. EPERM on Windows).
+ */
+async function copyDirRecursive(src, dest) {
+    await fs.mkdir(dest, { recursive: true });
+    const entries = await fs.readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            await fs.copyFile(srcPath, destPath);
+        }
+    }
+}
+/**
+ * Move a directory from src to dest. On Windows, fs.rename() often fails with
+ * EPERM when the directory is non-empty or another process has it open (IDE,
+ * file watcher, antivirus). Fall back to copy-then-remove when rename fails
+ * with EPERM or EXDEV.
+ */
+async function moveDirectory(src, dest) {
+    try {
+        await fs.rename(src, dest);
+    }
+    catch (err) {
+        const code = err?.code;
+        if (code === 'EPERM' || code === 'EXDEV') {
+            await copyDirRecursive(src, dest);
+            await fs.rm(src, { recursive: true, force: true });
+        }
+        else {
+            throw err;
+        }
+    }
+}
 export class ArchiveCommand {
     async execute(changeName, options = {}) {
         const targetPath = '.';
@@ -225,8 +263,8 @@ export class ArchiveCommand {
         }
         // Create archive directory if needed
         await fs.mkdir(archiveDir, { recursive: true });
-        // Move change to archive
-        await fs.rename(changeDir, archivePath);
+        // Move change to archive (uses copy+remove on EPERM/EXDEV, e.g. Windows)
+        await moveDirectory(changeDir, archivePath);
         console.log(`Change '${changeName}' archived as '${archiveName}'.`);
     }
     async selectChange(changesDir) {

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

@@ -2,11 +2,14 @@
  * Codex Command Adapter
  *
  * Formats commands for Codex following its frontmatter specification.
+ * Codex custom prompts live in the global home directory (~/.codex/prompts/)
+ * and are not shared through the repository. The CODEX_HOME env var can
+ * override the default ~/.codex location.
  */
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Codex adapter for command generation.
- * File path: .codex/prompts/opsx-<id>.md
+ * File path: <CODEX_HOME>/prompts/opsx-<id>.md (absolute, global)
  * Frontmatter: description, argument-hint
  */
 export declare const codexAdapter: ToolCommandAdapter;

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

@@ -2,17 +2,29 @@
  * Codex Command Adapter
  *
  * Formats commands for Codex following its frontmatter specification.
+ * Codex custom prompts live in the global home directory (~/.codex/prompts/)
+ * and are not shared through the repository. The CODEX_HOME env var can
+ * override the default ~/.codex location.
  */
+import os from 'os';
 import path from 'path';
+/**
+ * Returns the Codex home directory.
+ * Respects the CODEX_HOME env var, defaulting to ~/.codex.
+ */
+function getCodexHome() {
+    const envHome = process.env.CODEX_HOME?.trim();
+    return path.resolve(envHome ? envHome : path.join(os.homedir(), '.codex'));
+}
 /**
  * Codex adapter for command generation.
- * File path: .codex/prompts/opsx-<id>.md
+ * File path: <CODEX_HOME>/prompts/opsx-<id>.md (absolute, global)
  * Frontmatter: description, argument-hint
  */
 export const codexAdapter = {
     toolId: 'codex',
     getFilePath(commandId) {
-        return path.join('.codex', 'prompts', `opsx-${commandId}.md`);
+        return path.join(getCodexHome(), 'prompts', `opsx-${commandId}.md`);
     },
     formatFile(content) {
         return `---

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

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

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

@@ -7,7 +7,7 @@
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Windsurf adapter for command generation.
- * File path: .windsurf/commands/opsx/<id>.md
+ * File path: .windsurf/workflows/opsx-<id>.md
  * Frontmatter: name, description, category, tags
  */
 export declare const windsurfAdapter: ToolCommandAdapter;

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

@@ -28,13 +28,13 @@ function formatTagsArray(tags) {
 }
 /**
  * Windsurf adapter for command generation.
- * File path: .windsurf/commands/opsx/<id>.md
+ * File path: .windsurf/workflows/opsx-<id>.md
  * Frontmatter: name, description, category, tags
  */
 export const windsurfAdapter = {
     toolId: 'windsurf',
     getFilePath(commandId) {
-        return path.join('.windsurf', 'commands', 'opsx', `${commandId}.md`);
+        return path.join('.windsurf', 'workflows', `opsx-${commandId}.md`);
     },
     formatFile(content) {
         return `---

package/dist/core/command-generation/types.d.ts

@@ -31,9 +31,10 @@ export interface ToolCommandAdapter {
     /** Tool identifier matching AIToolOption.value (e.g., 'claude', 'cursor') */
     toolId: string;
     /**
-     * Returns the relative file path for a command.
+     * Returns the file path for a command.
      * @param commandId - The command identifier (e.g., 'explore')
-     * @returns Relative path from project root (e.g., '.claude/commands/opsx/explore.md')
+     * @returns Path from project root (e.g., '.claude/commands/opsx/explore.md').
+     *          May be absolute for tools with global-scoped prompts (e.g., Codex).
      */
     getFilePath(commandId: string): string;
     /**
@@ -47,7 +48,7 @@ export interface ToolCommandAdapter {
  * Result of generating a command file.
  */
 export interface GeneratedCommand {
-    /** Relative file path from project root */
+    /** File path from project root, or absolute for global-scoped tools */
     path: string;
     /** Complete file content (frontmatter + body) */
     fileContent: string;

package/dist/core/config.js

@@ -24,6 +24,7 @@ export const AI_TOOLS = [
     { name: 'Qoder', value: 'qoder', available: true, successLabel: 'Qoder', skillsDir: '.qoder' },
     { name: 'Qwen Code', value: 'qwen', available: true, successLabel: 'Qwen Code', skillsDir: '.qwen' },
     { name: 'RooCode', value: 'roocode', available: true, successLabel: 'RooCode', skillsDir: '.roo' },
+    { name: 'Trae', value: 'trae', available: true, successLabel: 'Trae', skillsDir: '.trae' },
     { name: 'Windsurf', value: 'windsurf', available: true, successLabel: 'Windsurf', skillsDir: '.windsurf' },
     { name: 'AGENTS.md (works with Amp, VS Code, …)', value: 'agents', available: false, successLabel: 'your AGENTS.md-compatible assistant' }
 ];

package/dist/core/init.js

@@ -10,6 +10,7 @@ import ora from 'ora';
 import * as fs from 'fs';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
+import { transformToHyphenCommands } from '../utils/command-references.js';
 import { AI_TOOLS, OPENSPEC_DIR_NAME, } from './config.js';
 import { PALETTE } from './styles/palette.js';
 import { isInteractive } from '../utils/interactive.js';
@@ -301,7 +302,9 @@ 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
-                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION);
+                    // Use hyphen-based command references for OpenCode
+                    const transformer = tool.value === 'opencode' ? transformToHyphenCommands : undefined;
+                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
                     // Write the skill file
                     await FileSystemUtils.writeFile(skillFile, skillContent);
                 }
@@ -310,7 +313,7 @@ export class InitCommand {
                 if (adapter) {
                     const generatedCommands = generateCommands(commandContents, adapter);
                     for (const cmd of generatedCommands) {
-                        const commandFile = path.join(projectPath, cmd.path);
+                        const commandFile = path.isAbsolute(cmd.path) ? cmd.path : path.join(projectPath, cmd.path);
                         await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                     }
                 }

package/dist/core/shared/skill-generation.d.ts

@@ -36,6 +36,7 @@ export declare function getCommandContents(): CommandContent[];
  *
  * @param template - The skill template
  * @param generatedByVersion - The OpenSpec version to embed in the file
+ * @param transformInstructions - Optional callback to transform the instructions content
  */
-export declare function generateSkillContent(template: SkillTemplate, generatedByVersion: string): string;
+export declare function generateSkillContent(template: SkillTemplate, generatedByVersion: string, transformInstructions?: (instructions: string) => string): string;
 //# sourceMappingURL=skill-generation.d.ts.map

package/dist/core/shared/skill-generation.js

@@ -57,8 +57,12 @@ export function getCommandContents() {
  *
  * @param template - The skill template
  * @param generatedByVersion - The OpenSpec version to embed in the file
+ * @param transformInstructions - Optional callback to transform the instructions content
  */
-export function generateSkillContent(template, generatedByVersion) {
+export function generateSkillContent(template, generatedByVersion, transformInstructions) {
+    const instructions = transformInstructions
+        ? transformInstructions(template.instructions)
+        : template.instructions;
     return `---
 name: ${template.name}
 description: ${template.description}
@@ -70,7 +74,7 @@ metadata:
   generatedBy: "${generatedByVersion}"
 ---
 
-${template.instructions}
+${instructions}
 `;
 }
 //# sourceMappingURL=skill-generation.js.map

package/dist/core/templates/skill-templates.js

@@ -1730,7 +1730,7 @@ export function getOpsxContinueCommandTemplate() {
    **If all artifacts are complete (\`isComplete: true\`)**:
    - Congratulate the user
    - Show final status including the schema used
-   - Suggest: "All artifacts created! You can now implement this change or archive it."
+   - Suggest: "All artifacts created! You can now implement this change with \`/opsx:apply\` or archive it with \`/opsx:archive\`."
    - STOP
 
    ---
@@ -1918,7 +1918,7 @@ Working on task 4/7: <task description>
 - [x] Task 2
 ...
 
-All tasks complete! Ready to archive this change.
+All tasks complete! You can archive this change with \`/opsx:archive\`.
 \`\`\`
 
 **Output On Pause (Issue Encountered)**

package/dist/core/update.js

@@ -9,6 +9,7 @@ import chalk from 'chalk';
 import ora from 'ora';
 import { createRequire } from 'module';
 import { FileSystemUtils } from '../utils/file-system.js';
+import { transformToHyphenCommands } from '../utils/command-references.js';
 import { AI_TOOLS, OPENSPEC_DIR_NAME } from './config.js';
 import { generateCommands, CommandAdapterRegistry, } from './command-generation/index.js';
 import { getConfiguredTools, getAllToolVersionStatus, getSkillTemplates, getCommandContents, generateSkillContent, getToolsWithSkillsDir, } from './shared/index.js';
@@ -73,7 +74,9 @@ export class UpdateCommand {
                 for (const { template, dirName } of skillTemplates) {
                     const skillDir = path.join(skillsDir, dirName);
                     const skillFile = path.join(skillDir, 'SKILL.md');
-                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION);
+                    // Use hyphen-based command references for OpenCode
+                    const transformer = tool.value === 'opencode' ? transformToHyphenCommands : undefined;
+                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
                     await FileSystemUtils.writeFile(skillFile, skillContent);
                 }
                 // Update commands
@@ -81,7 +84,7 @@ export class UpdateCommand {
                 if (adapter) {
                     const generatedCommands = generateCommands(commandContents, adapter);
                     for (const cmd of generatedCommands) {
-                        const commandFile = path.join(resolvedProjectPath, cmd.path);
+                        const commandFile = path.isAbsolute(cmd.path) ? cmd.path : path.join(resolvedProjectPath, cmd.path);
                         await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                     }
                 }
@@ -277,7 +280,9 @@ export class UpdateCommand {
                 for (const { template, dirName } of skillTemplates) {
                     const skillDir = path.join(skillsDir, dirName);
                     const skillFile = path.join(skillDir, 'SKILL.md');
-                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION);
+                    // Use hyphen-based command references for OpenCode
+                    const transformer = tool.value === 'opencode' ? transformToHyphenCommands : undefined;
+                    const skillContent = generateSkillContent(template, OPENSPEC_VERSION, transformer);
                     await FileSystemUtils.writeFile(skillFile, skillContent);
                 }
                 // Create commands
@@ -285,7 +290,7 @@ export class UpdateCommand {
                 if (adapter) {
                     const generatedCommands = generateCommands(commandContents, adapter);
                     for (const cmd of generatedCommands) {
-                        const commandFile = path.join(projectPath, cmd.path);
+                        const commandFile = path.isAbsolute(cmd.path) ? cmd.path : path.join(projectPath, cmd.path);
                         await FileSystemUtils.writeFile(commandFile, cmd.fileContent);
                     }
                 }

package/dist/utils/command-references.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Command Reference Utilities
+ *
+ * Utilities for transforming command references to tool-specific formats.
+ */
+/**
+ * Transforms colon-based command references to hyphen-based format.
+ * Converts `/opsx:` patterns to `/opsx-` for tools that use hyphen syntax.
+ *
+ * @param text - The text containing command references
+ * @returns Text with command references transformed to hyphen format
+ *
+ * @example
+ * transformToHyphenCommands('/opsx:new') // returns '/opsx-new'
+ * transformToHyphenCommands('Use /opsx:apply to implement') // returns 'Use /opsx-apply to implement'
+ */
+export declare function transformToHyphenCommands(text: string): string;
+//# sourceMappingURL=command-references.d.ts.map

package/dist/utils/command-references.js

@@ -0,0 +1,20 @@
+/**
+ * Command Reference Utilities
+ *
+ * Utilities for transforming command references to tool-specific formats.
+ */
+/**
+ * Transforms colon-based command references to hyphen-based format.
+ * Converts `/opsx:` patterns to `/opsx-` for tools that use hyphen syntax.
+ *
+ * @param text - The text containing command references
+ * @returns Text with command references transformed to hyphen format
+ *
+ * @example
+ * transformToHyphenCommands('/opsx:new') // returns '/opsx-new'
+ * transformToHyphenCommands('Use /opsx:apply to implement') // returns 'Use /opsx-apply to implement'
+ */
+export function transformToHyphenCommands(text) {
+    return text.replace(/\/opsx:/g, '/opsx-');
+}
+//# sourceMappingURL=command-references.js.map

package/dist/utils/index.d.ts

@@ -2,4 +2,5 @@ export { validateChangeName, createChange } from './change-utils.js';
 export type { ValidationResult, CreateChangeOptions } from './change-utils.js';
 export { readChangeMetadata, writeChangeMetadata, resolveSchemaForChange, validateSchemaName, ChangeMetadataError, } from './change-metadata.js';
 export { FileSystemUtils, removeMarkerBlock } from './file-system.js';
+export { transformToHyphenCommands } from './command-references.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -4,4 +4,6 @@ export { validateChangeName, createChange } from './change-utils.js';
 export { readChangeMetadata, writeChangeMetadata, resolveSchemaForChange, validateSchemaName, ChangeMetadataError, } from './change-metadata.js';
 // File system utilities
 export { FileSystemUtils, removeMarkerBlock } from './file-system.js';
+// Command reference utilities
+export { transformToHyphenCommands } from './command-references.js';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",