@fission-ai/openspec 1.6.0 → 1.8.0

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

@@ -4,6 +4,41 @@
  * Formats commands for Gemini CLI following its TOML specification.
  */
 import path from 'path';
+/**
+ * Control characters (C0 except tab/newline/carriage return, plus DEL) are
+ * invalid inside TOML strings and must be written as escapes.
+ */
+const TOML_CONTROL_CHARS = new RegExp('[\\u0000-\\u0008\\u000b\\u000c\\u000e-\\u001f\\u007f]', 'g');
+/**
+ * TOML basic strings are escape-active: a backslash or double quote in the
+ * value breaks the file if written raw. Newlines cannot appear in a
+ * single-line basic string at all, so they are escaped too.
+ */
+function escapeTomlBasicString(value) {
+    return value
+        .replace(/\\/g, '\\\\')
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, '\\n')
+        .replace(/\r/g, '\\r')
+        .replace(/\t/g, '\\t')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+/**
+ * Multiline basic strings keep raw newlines and tabs, but backslashes are
+ * still escape-active, any run of three quotes would end the string, and the
+ * same control characters are invalid as in single-line basic strings — a
+ * lone carriage return included (only LF and CRLF may appear raw; CRLF is
+ * normalized away so the emitted file is single-convention). Escapes are
+ * introduced after backslash-doubling so they are not re-doubled.
+ */
+function escapeTomlMultilineBasicString(value) {
+    return value
+        .replace(/\r\n/g, '\n')
+        .replace(/\\/g, '\\\\')
+        .replace(/"""/g, '""\\"')
+        .replace(/\r/g, '\\r')
+        .replace(TOML_CONTROL_CHARS, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
 /**
  * Gemini adapter for command generation.
  * File path: .gemini/commands/opsx/<id>.toml
@@ -15,10 +50,10 @@ export const geminiAdapter = {
         return path.join('.gemini', 'commands', 'opsx', `${commandId}.toml`);
     },
     formatFile(content) {
-        return `description = "${content.description}"
+        return `description = "${escapeTomlBasicString(content.description)}"
 
 prompt = """
-${content.body}
+${escapeTomlMultilineBasicString(content.body)}
 """
 `;
     },

package/dist/core/command-generation/adapters/github-copilot.js

@@ -4,6 +4,7 @@
  * Formats commands for GitHub Copilot following its .prompt.md specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * GitHub Copilot adapter for command generation.
  * File path: .github/prompts/opsx-<id>.prompt.md
@@ -16,7 +17,7 @@ export const githubCopilotAdapter = {
     },
     formatFile(content) {
         return `---
-description: ${content.description}
+description: ${escapeYamlValue(content.description)}
 ---
 
 ${content.body}

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

@@ -4,6 +4,7 @@
  * Formats commands for iFlow following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * iFlow adapter for command generation.
  * File path: .iflow/commands/opsx-<id>.md
@@ -16,10 +17,10 @@ export const iflowAdapter = {
     },
     formatFile(content) {
         return `---
-name: /opsx-${content.id}
-id: opsx-${content.id}
-category: ${content.category}
-description: ${content.description}
+name: ${escapeYamlValue(`/opsx-${content.id}`)}
+id: ${escapeYamlValue(`opsx-${content.id}`)}
+category: ${escapeYamlValue(content.category)}
+description: ${escapeYamlValue(content.description)}
 ---
 
 ${content.body}

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

@@ -9,12 +9,12 @@ export { auggieAdapter } from './auggie.js';
 export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
 export { clineAdapter } from './cline.js';
-export { codexAdapter } from './codex.js';
 export { codebuddyAdapter } from './codebuddy.js';
 export { continueAdapter } from './continue.js';
 export { costrictAdapter } from './costrict.js';
 export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
+export { devinAdapter } from './devin.js';
 export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
@@ -30,5 +30,5 @@ 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';
+export { zcodeAdapter } from './zcode.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -9,12 +9,12 @@ export { auggieAdapter } from './auggie.js';
 export { bobAdapter } from './bob.js';
 export { claudeAdapter } from './claude.js';
 export { clineAdapter } from './cline.js';
-export { codexAdapter } from './codex.js';
 export { codebuddyAdapter } from './codebuddy.js';
 export { continueAdapter } from './continue.js';
 export { costrictAdapter } from './costrict.js';
 export { crushAdapter } from './crush.js';
 export { cursorAdapter } from './cursor.js';
+export { devinAdapter } from './devin.js';
 export { factoryAdapter } from './factory.js';
 export { geminiAdapter } from './gemini.js';
 export { githubCopilotAdapter } from './github-copilot.js';
@@ -30,5 +30,5 @@ 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';
+export { zcodeAdapter } from './zcode.js';
 //# sourceMappingURL=index.js.map

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

@@ -4,6 +4,7 @@
  * Formats commands for Junie following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Junie adapter for command generation.
  * File path: .junie/commands/opsx-<id>.md
@@ -16,7 +17,7 @@ export const junieAdapter = {
     },
     formatFile(content) {
         return `---
-description: ${content.description}
+description: ${escapeYamlValue(content.description)}
 ---
 
 ${content.body}

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

@@ -4,6 +4,7 @@
  * Formats commands for Kiro following its .prompt.md specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Kiro adapter for command generation.
  * File path: .kiro/prompts/opsx-<id>.prompt.md
@@ -16,7 +17,7 @@ export const kiroAdapter = {
     },
     formatFile(content) {
         return `---
-description: ${content.description}
+description: ${escapeYamlValue(content.description)}
 ---
 
 ${content.body}

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

@@ -4,6 +4,7 @@
  * Formats commands for Lingma following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
 /**
  * Lingma adapter for command generation.
  * File path: .lingma/commands/opsx/<id>.md
@@ -15,12 +16,11 @@ export const lingmaAdapter = {
         return path.join('.lingma', 'commands', 'opsx', `${commandId}.md`);
     },
     formatFile(content) {
-        const tagsStr = content.tags.join(', ');
         return `---
-name: ${content.name}
-description: ${content.description}
-category: ${content.category}
-tags: [${tagsStr}]
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
 ---
 
 ${content.body}

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

@@ -12,8 +12,8 @@ import type { ToolCommandAdapter } from '../types.js';
  * 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
+ * opsx-propose.md → /opsx-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it, and
  * $@ is injected after **Input**: headings so user-supplied arguments
  * (e.g. /opsx-propose my-feature) are visible to the agent.
  */

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

@@ -6,7 +6,6 @@
  * 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) {
@@ -21,8 +20,8 @@ function injectOmpArgs(body) {
  * 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
+ * opsx-propose.md → /opsx-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it, and
  * $@ is injected after **Input**: headings so user-supplied arguments
  * (e.g. /opsx-propose my-feature) are visible to the agent.
  */
@@ -32,12 +31,11 @@ export const ohMyPiAdapter = {
         return path.join('.omp', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        const transformedBody = transformToHyphenCommands(content.body);
         return `---
 description: ${escapeYamlValue(content.description)}
 ---
 
-${injectOmpArgs(transformedBody)}
+${injectOmpArgs(content.body)}
 `;
     },
 };

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

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

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

@@ -11,8 +11,8 @@ import type { ToolCommandAdapter } from '../types.js';
  * Frontmatter: description
  *
  * Pi 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.
+ * opsx-propose.md → /opsx-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it.
  */
 export declare const piAdapter: ToolCommandAdapter;
 //# sourceMappingURL=pi.d.ts.map

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

@@ -5,7 +5,6 @@
  * Pi prompt templates live in .pi/prompts/*.md with description frontmatter.
  */
 import path from 'path';
-import { transformToHyphenCommands } from '../../../utils/command-references.js';
 import { escapeYamlValue } from '../yaml.js';
 const PI_INPUT_HEADING = /^\*\*Input\*\*:[^\n]*$/m;
 function injectPiArgs(body) {
@@ -20,8 +19,8 @@ function injectPiArgs(body) {
  * Frontmatter: description
  *
  * Pi 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.
+ * opsx-propose.md → /opsx-propose. generateCommand rewrites the body's
+ * command references to that form before this adapter formats it.
  */
 export const piAdapter = {
     toolId: 'pi',
@@ -29,13 +28,11 @@ export const piAdapter = {
         return path.join('.pi', 'prompts', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        // Transform /opsx: references to /opsx- and inject $@ for template args
-        const transformedBody = transformToHyphenCommands(content.body);
         return `---
 description: ${escapeYamlValue(content.description)}
 ---
 
-${injectPiArgs(transformedBody)}
+${injectPiArgs(content.body)}
 `;
     },
 };

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

@@ -4,6 +4,7 @@
  * Formats commands for Qoder following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
 /**
  * Qoder adapter for command generation.
  * File path: .qoder/commands/opsx/<id>.md
@@ -15,12 +16,11 @@ export const qoderAdapter = {
         return path.join('.qoder', 'commands', 'opsx', `${commandId}.md`);
     },
     formatFile(content) {
-        const tagsStr = content.tags.join(', ');
         return `---
-name: ${content.name}
-description: ${content.description}
-category: ${content.category}
-tags: [${tagsStr}]
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
 ---
 
 ${content.body}

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

@@ -1,13 +1,17 @@
 /**
  * Qwen Code Command Adapter
  *
- * Formats commands for Qwen Code following its TOML specification.
+ * Formats commands for Qwen Code following its Markdown custom command
+ * specification. Qwen Code has deprecated TOML commands in favor of
+ * Markdown files with YAML frontmatter.
+ *
+ * @see https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/#markdown-file-format-specification-recommended
  */
 import type { ToolCommandAdapter } from '../types.js';
 /**
  * Qwen adapter for command generation.
- * File path: .qwen/commands/opsx-<id>.toml
- * Format: TOML with description and prompt fields
+ * File path: .qwen/commands/opsx-<id>.md
+ * Format: Markdown with description frontmatter
  */
 export declare const qwenAdapter: ToolCommandAdapter;
 //# sourceMappingURL=qwen.d.ts.map

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

@@ -1,25 +1,30 @@
 /**
  * Qwen Code Command Adapter
  *
- * Formats commands for Qwen Code following its TOML specification.
+ * Formats commands for Qwen Code following its Markdown custom command
+ * specification. Qwen Code has deprecated TOML commands in favor of
+ * Markdown files with YAML frontmatter.
+ *
+ * @see https://qwenlm.github.io/qwen-code-docs/en/users/features/commands/#markdown-file-format-specification-recommended
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Qwen adapter for command generation.
- * File path: .qwen/commands/opsx-<id>.toml
- * Format: TOML with description and prompt fields
+ * File path: .qwen/commands/opsx-<id>.md
+ * Format: Markdown with description frontmatter
  */
 export const qwenAdapter = {
     toolId: 'qwen',
     getFilePath(commandId) {
-        return path.join('.qwen', 'commands', `opsx-${commandId}.toml`);
+        return path.join('.qwen', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `description = "${content.description}"
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
 
-prompt = """
 ${content.body}
-"""
 `;
     },
 };

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

@@ -1,12 +1,12 @@
 /**
- * RooCode Command Adapter
+ * Zoo Code Command Adapter
  *
- * Formats commands for RooCode following its workflow specification.
- * RooCode uses markdown headers instead of YAML frontmatter.
+ * Formats commands for Zoo Code following its workflow specification.
+ * Zoo Code uses markdown headers instead of YAML frontmatter.
  */
 import type { ToolCommandAdapter } from '../types.js';
 /**
- * RooCode adapter for command generation.
+ * Zoo Code adapter for command generation.
  * File path: .roo/commands/opsx-<id>.md
  * Format: Markdown header with description
  */

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

@@ -1,12 +1,12 @@
 /**
- * RooCode Command Adapter
+ * Zoo Code Command Adapter
  *
- * Formats commands for RooCode following its workflow specification.
- * RooCode uses markdown headers instead of YAML frontmatter.
+ * Formats commands for Zoo Code following its workflow specification.
+ * Zoo Code uses markdown headers instead of YAML frontmatter.
  */
 import path from 'path';
 /**
- * RooCode adapter for command generation.
+ * Zoo Code adapter for command generation.
  * File path: .roo/commands/opsx-<id>.md
  * Format: Markdown header with description
  */

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

@@ -4,27 +4,7 @@
  * 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;
-}
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Trae adapter for command generation.
  * File path: .trae/commands/opsx-<id>.md

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

@@ -0,0 +1,16 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode following its frontmatter specification.
+ * ZCode shares Claude Code's command format conventions.
+ * File path: .zcode/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export declare const zcodeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=zcode.d.ts.map

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

@@ -0,0 +1,33 @@
+/**
+ * ZCode Command Adapter
+ *
+ * Formats commands for ZCode following its frontmatter specification.
+ * ZCode shares Claude Code's command format conventions.
+ * File path: .zcode/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+/**
+ * ZCode adapter for command generation.
+ * File path: .zcode/commands/opsx/<id>.md
+ * Frontmatter: name, description, category, tags
+ */
+export const zcodeAdapter = {
+    toolId: 'zcode',
+    getFilePath(commandId) {
+        return path.join('.zcode', 'commands', 'opsx', `${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+category: ${escapeYamlValue(content.category)}
+tags: ${formatTagsArray(content.tags)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=zcode.js.map

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

@@ -6,6 +6,14 @@
 import type { CommandContent, ToolCommandAdapter, GeneratedCommand } from './types.js';
 /**
  * Generate a single command file using the provided adapter.
+ *
+ * Command bodies are authored with `/opsx:<id>` references. Tools whose command
+ * files are invoked by filename register `/opsx-<id>` instead, and Amazon Q
+ * surfaces them in its prompt library as `@opsx-<id>`, so the body is rewritten
+ * to the form that tool answers to before the adapter formats it. Doing it here
+ * rather than per adapter keeps every tool in step (#727, #1307); adapters stay
+ * pure formatters.
+ *
  * @param content - The tool-agnostic command content
  * @param adapter - The tool-specific adapter
  * @returns Generated command with path and file content

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

@@ -3,16 +3,30 @@
  *
  * Functions for generating command files using tool adapters.
  */
+import { getInvocationForAdapter, needsInvocationRewrite } from './invocation.js';
+import { transformCommandInvocations } from '../../utils/command-references.js';
 /**
  * Generate a single command file using the provided adapter.
+ *
+ * Command bodies are authored with `/opsx:<id>` references. Tools whose command
+ * files are invoked by filename register `/opsx-<id>` instead, and Amazon Q
+ * surfaces them in its prompt library as `@opsx-<id>`, so the body is rewritten
+ * to the form that tool answers to before the adapter formats it. Doing it here
+ * rather than per adapter keeps every tool in step (#727, #1307); adapters stay
+ * pure formatters.
+ *
  * @param content - The tool-agnostic command content
  * @param adapter - The tool-specific adapter
  * @returns Generated command with path and file content
  */
 export function generateCommand(content, adapter) {
+    const invocation = getInvocationForAdapter(adapter);
+    const formatted = needsInvocationRewrite(invocation)
+        ? { ...content, body: transformCommandInvocations(content.body, invocation) }
+        : content;
     return {
         path: adapter.getFilePath(content.id),
-        fileContent: adapter.formatFile(content),
+        fileContent: adapter.formatFile(formatted),
     };
 }
 /**

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

@@ -18,5 +18,5 @@
 export type { CommandContent, ToolCommandAdapter, GeneratedCommand, } from './types.js';
 export { CommandAdapterRegistry } from './registry.js';
 export { generateCommand, generateCommands } from './generator.js';
-export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+export { claudeAdapter, cursorAdapter, devinAdapter } from './adapters/index.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -20,5 +20,5 @@ export { CommandAdapterRegistry } from './registry.js';
 // Generator functions
 export { generateCommand, generateCommands } from './generator.js';
 // Adapters (for direct access if needed)
-export { claudeAdapter, cursorAdapter, windsurfAdapter } from './adapters/index.js';
+export { claudeAdapter, cursorAdapter, devinAdapter } from './adapters/index.js';
 //# sourceMappingURL=index.js.map