@fission-ai/openspec 1.0.2 → 1.1.0

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/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

@@ -310,7 +310,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/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

@@ -81,7 +81,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);
                     }
                 }
@@ -285,7 +285,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/package.json

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