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

package/dist/core/change-metadata/schema.d.ts

@@ -14,6 +14,7 @@ export declare const ChangeMetadataSchema: z.ZodObject<{
         store: z.ZodString;
         id: z.ZodString;
     }, z.core.$strict>>;
+    skip_specs: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
 export type ChangeMetadata = z.infer<typeof ChangeMetadataSchema>;
 //# sourceMappingURL=schema.d.ts.map

package/dist/core/change-metadata/schema.js

@@ -26,5 +26,11 @@ export const ChangeMetadataSchema = z.object({
     goal: z.string().min(1).optional(),
     affected_areas: z.array(z.string().min(1)).optional(),
     initiative: InitiativeLinkSchema.optional(),
+    // Declares that this change intentionally has no spec deltas (pure refactor,
+    // tooling, or docs work). Validation accepts zero deltas, and the artifact
+    // graph counts artifacts whose `generates` path lives under specs/ as
+    // complete - that path prefix, not the artifact id, is the contract custom
+    // schemas inherit.
+    skip_specs: z.boolean().optional(),
 });
 //# sourceMappingURL=schema.js.map

package/dist/core/change-status-policy.d.ts

@@ -18,7 +18,7 @@ export interface ActionContext {
 }
 export interface ChangeStatusPolicyArtifact {
     id: string;
-    status: 'done' | 'ready' | 'blocked';
+    status: 'done' | 'skipped' | 'ready' | 'blocked';
 }
 export interface ChangeNextStepsInput {
     changeName: string;

package/dist/core/command-generation/adapters/amazon-q.d.ts

@@ -8,6 +8,10 @@ import type { ToolCommandAdapter } from '../types.js';
  * Amazon Q adapter for command generation.
  * File path: .amazonq/prompts/opsx-<id>.md
  * Frontmatter: description
+ *
+ * Amazon Q surfaces these files as its prompt library rather than as slash
+ * commands: the user types `@opsx-propose`, not `/opsx-propose`.
+ * https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-prompts.html
  */
 export declare const amazonQAdapter: ToolCommandAdapter;
 //# sourceMappingURL=amazon-q.d.ts.map

package/dist/core/command-generation/adapters/amazon-q.js

@@ -4,19 +4,25 @@
  * Formats commands for Amazon Q Developer following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Amazon Q adapter for command generation.
  * File path: .amazonq/prompts/opsx-<id>.md
  * Frontmatter: description
+ *
+ * Amazon Q surfaces these files as its prompt library rather than as slash
+ * commands: the user types `@opsx-propose`, not `/opsx-propose`.
+ * https://docs.aws.amazon.com/amazonq/latest/qdeveloper-ug/command-line-prompts.html
  */
 export const amazonQAdapter = {
     toolId: 'amazon-q',
     getFilePath(commandId) {
         return path.join('.amazonq', 'prompts', `opsx-${commandId}.md`);
     },
+    invocationPrefix: '@',
     formatFile(content) {
         return `---
-description: ${content.description}
+description: ${escapeYamlValue(content.description)}
 ---
 
 ${content.body}

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

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

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

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

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

@@ -8,7 +8,11 @@ import type { ToolCommandAdapter } from '../types.js';
 /**
  * Bob Shell adapter for command generation.
  * File path: .bob/commands/opsx-<id>.md
- * Frontmatter: description, argument-hint
+ * Frontmatter: description
+ *
+ * Bob 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.
  */
 export declare const bobAdapter: ToolCommandAdapter;
 //# sourceMappingURL=bob.d.ts.map

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

@@ -5,12 +5,15 @@
  * Commands are stored in .bob/commands/ directory.
  */
 import path from 'path';
-import { transformToHyphenCommands } from '../../../utils/command-references.js';
 import { escapeYamlValue } from '../yaml.js';
 /**
  * Bob Shell adapter for command generation.
  * File path: .bob/commands/opsx-<id>.md
- * Frontmatter: description, argument-hint
+ * Frontmatter: description
+ *
+ * Bob 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.
  */
 export const bobAdapter = {
     toolId: 'bob',
@@ -18,14 +21,12 @@ export const bobAdapter = {
         return path.join('.bob', 'commands', `opsx-${commandId}.md`);
     },
     formatFile(content) {
-        // Transform command references from colon to hyphen format for Bob
-        const transformedBody = transformToHyphenCommands(content.body);
         return `---
 description: ${escapeYamlValue(content.description)}
 argument-hint: command arguments
 ---
 
-${transformedBody}
+${content.body}
 `;
     },
 };

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

@@ -4,15 +4,8 @@
  * Formats commands for Claude Code following its frontmatter specification.
  */
 import path from 'path';
-import { escapeYamlValue } from '../yaml.js';
+import { escapeYamlValue, formatTagsArray } from '../yaml.js';
 import { OPENSPEC_CLI_ALLOWED_TOOLS } from '../../shared/allowed-tools.js';
-/**
- * Formats a tags array as a YAML array with proper escaping.
- */
-function formatTagsArray(tags) {
-    const escapedTags = tags.map((tag) => escapeYamlValue(tag));
-    return `[${escapedTags.join(', ')}]`;
-}
 /**
  * Claude Code adapter for command generation.
  * File path: .claude/commands/opsx/<id>.md

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

@@ -4,6 +4,7 @@
  * Formats commands for CodeBuddy following its frontmatter specification.
  */
 import path from 'path';
+import { escapeYamlValue } from '../yaml.js';
 /**
  * CodeBuddy adapter for command generation.
  * File path: .codebuddy/commands/opsx/<id>.md
@@ -16,8 +17,8 @@ export const codebuddyAdapter = {
     },
     formatFile(content) {
         return `---
-name: ${content.name}
-description: "${content.description}"
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
 argument-hint: "[command arguments]"
 ---
 

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

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

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
@@ -16,7 +17,7 @@ export const costrictAdapter = {
     },
     formatFile(content) {
         return `---
-description: "${content.description}"
+description: ${escapeYamlValue(content.description)}
 argument-hint: command arguments
 ---
 

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,12 +16,11 @@ 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}]
+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

@@ -18,8 +18,8 @@ export const cursorAdapter = {
     },
     formatFile(content) {
         return `---
-name: /opsx-${content.id}
-id: opsx-${content.id}
+name: ${escapeYamlValue(`/opsx-${content.id}`)}
+id: ${escapeYamlValue(`opsx-${content.id}`)}
 category: ${escapeYamlValue(content.category)}
 description: ${escapeYamlValue(content.description)}
 ---

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
@@ -16,7 +17,7 @@ export const factoryAdapter = {
     },
     formatFile(content) {
         return `---
-description: ${content.description}
+description: ${escapeYamlValue(content.description)}
 argument-hint: command arguments
 ---
 

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