@codewalla_india/openspec 1.3.0 → 1.3.2

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

@@ -4,6 +4,7 @@
  * Formats commands for CoStrict following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * CoStrict adapter for command generation.
  * File path: .cospec/openspec/commands/opsx-<id>.md
@@ -15,12 +16,12 @@ export const costrictAdapter = {
         return path.join('.cospec', 'openspec', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-description: "${content.description}"
-argument-hint: command arguments
----
-
-${content.body}
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
 `;
     },
 };

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

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

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

@@ -17,14 +17,14 @@ export const cursorAdapter = {
         return path.join('.cursor', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-name: /opsx-${content.id}
-id: opsx-${content.id}
-category: ${escapeYamlValue(content.category)}
-description: ${escapeYamlValue(content.description)}
----
-
-${content.body}
+        return `---
+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/devin.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Devin Desktop Command Adapter
+ *
+ * Formats commands for Devin Desktop following its frontmatter specification.
+ * Devin Desktop reads Cascade-style workflows from `.devin/workflows/`, the
+ * same shape Windsurf uses.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Devin Desktop adapter for command generation.
+ * File path: .devin/workflows/opsx-<id>.md
+ * Frontmatter: name, description, category, tags
+ *
+ * The `opsx-` filename prefix makes this a flat invocation, so the generator
+ * rewrites the body's `/opsx:*` references to the `/opsx-*` form Devin
+ * registers — see invocation.ts.
+ */
+export declare const devinAdapter: ToolCommandAdapter;
+//# sourceMappingURL=devin.d.ts.map

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

@@ -0,0 +1,36 @@
+/**
+ * Devin Desktop Command Adapter
+ *
+ * Formats commands for Devin Desktop following its frontmatter specification.
+ * Devin Desktop reads Cascade-style workflows from `.devin/workflows/`, the
+ * same shape Windsurf uses.
+ */
+import path from 'path';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
+/**
+ * Devin Desktop adapter for command generation.
+ * File path: .devin/workflows/opsx-<id>.md
+ * Frontmatter: name, description, category, tags
+ *
+ * The `opsx-` filename prefix makes this a flat invocation, so the generator
+ * rewrites the body's `/opsx:*` references to the `/opsx-*` form Devin
+ * registers — see invocation.ts.
+ */
+export const devinAdapter = {
+    toolId: 'devin',
+    getFilePath(commandId) {
+        return path.join('.devin', 'workflows', `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=devin.js.map

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

@@ -4,6 +4,7 @@
  * Formats commands for Factory Droid following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Factory adapter for command generation.
  * File path: .factory/commands/opsx-<id>.md
@@ -15,12 +16,12 @@ export const factoryAdapter = {
         return path.join('.factory', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
-argument-hint: command arguments
----
-
-${content.body}
+        return `---
+description: ${escapeYamlValue(content.description)}
+argument-hint: command arguments
+---
+
+${content.body}
 `;
     },
 };

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,11 +50,11 @@ export const geminiAdapter = {
         return path.join('.gemini', 'commands', 'opsx', `${commandId}.toml`);
     },
     formatFile(content) {
-        return `description = "${content.description}"
-
-prompt = """
-${content.body}
-"""
+        return `description = "${escapeTomlBasicString(content.description)}"
+
+prompt = """
+${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
@@ -15,11 +16,11 @@ export const githubCopilotAdapter = {
         return path.join('.github', 'prompts', `opsx-${commandId}.prompt.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
----
-
-${content.body}
+        return `---
+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
@@ -15,14 +16,14 @@ export const iflowAdapter = {
         return path.join('.iflow', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-name: /opsx-${content.id}
-id: opsx-${content.id}
-category: ${content.category}
-description: ${content.description}
----
-
-${content.body}
+        return `---
+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';
@@ -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 { windsurfAdapter } from './windsurf.js';
+export { traeAdapter } from './trae.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';
@@ -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 { windsurfAdapter } from './windsurf.js';
+export { traeAdapter } from './trae.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
@@ -15,11 +16,11 @@ export const junieAdapter = {
         return path.join('.junie', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
----
-
-${content.body}
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
 `;
     },
 };

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

@@ -16,7 +16,7 @@ export const kilocodeAdapter = {
         return path.join('.kilocode', 'workflows', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        return `${content.body}
+        return `${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
@@ -15,11 +16,11 @@ export const kiroAdapter = {
         return path.join('.kiro', 'prompts', `opsx-${commandId}.prompt.md`);
     },
     formatFile(content) {
-        return `---
-description: ${content.description}
----
-
-${content.body}
+        return `---
+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,15 +16,14 @@ 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}]
----
-
-${content.body}
+        return `---
+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

@@ -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. 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.
+ */
+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,42 @@
+/**
+ * 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 { 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. 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.
+ */
+export const ohMyPiAdapter = {
+    toolId: 'oh-my-pi',
+    getFilePath(commandId) {
+        return path.join('.omp', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${injectOmpArgs(content.body)}
+`;
+    },
+};
+//# sourceMappingURL=oh-my-pi.js.map

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}
----
-
-${transformedBody}
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${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)}
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${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,15 +16,14 @@ 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}]
----
-
-${content.body}
+        return `---
+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