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

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

@@ -1,20 +1,13 @@
-import type { ChangeMetadata } from './change-metadata/index.js';
 import type { PlanningHome } from './planning-home.js';
 export interface PlanningHomeSummary {
-    kind: 'repo' | 'workspace';
+    kind: 'repo';
     root: string;
     changesDir: string;
     defaultSchema: string;
-    workspaceName?: string;
-}
-export interface AffectedAreasSummary {
-    known: string[];
-    unresolved: boolean;
-    invalid: string[];
 }
 export interface ActionContext {
-    mode: 'repo-local' | 'workspace-planning';
-    sourceOfTruth: 'repo' | 'workspace-local';
+    mode: 'repo-local';
+    sourceOfTruth: 'repo';
     planningArtifacts: string[];
     linkedContext: Array<{
         name: string;
@@ -27,24 +20,18 @@ export interface ChangeStatusPolicyArtifact {
     id: string;
     status: 'done' | 'ready' | 'blocked';
 }
-export interface AffectedAreasInput {
-    planningHome?: PlanningHome;
-    metadata?: ChangeMetadata;
-}
 export interface ChangeNextStepsInput {
     changeName: string;
-    planningHome?: PlanningHome;
     artifactStatuses: ChangeStatusPolicyArtifact[];
-    affectedAreas?: AffectedAreasSummary;
     allArtifactsComplete: boolean;
+    /** Selected store id; next-step commands must carry it. */
+    storeId?: string;
 }
 export interface ActionContextInput {
-    planningHome?: PlanningHome;
     projectRoot: string;
     artifactIds: string[];
 }
 export declare function summarizePlanningHome(planningHome: PlanningHome | undefined): PlanningHomeSummary | undefined;
-export declare function summarizeAffectedAreas(input: AffectedAreasInput): AffectedAreasSummary | undefined;
 export declare function buildActionContext(input: ActionContextInput): ActionContext;
 export declare function buildNextSteps(input: ChangeNextStepsInput): string[];
 //# sourceMappingURL=change-status-policy.d.ts.map

package/dist/core/change-status-policy.js

@@ -7,39 +7,9 @@ export function summarizePlanningHome(planningHome) {
         root: planningHome.root,
         changesDir: planningHome.changesDir,
         defaultSchema: planningHome.defaultSchema,
-        ...(planningHome.workspace ? { workspaceName: planningHome.workspace.name } : {}),
-    };
-}
-export function summarizeAffectedAreas(input) {
-    if (input.planningHome?.kind !== 'workspace') {
-        return undefined;
-    }
-    const known = Array.from(new Set(input.metadata?.affected_areas ?? [])).sort((a, b) => a.localeCompare(b));
-    const validAreas = new Set(input.planningHome.workspace?.links ?? []);
-    const invalid = known.filter((areaName) => validAreas.size > 0 && !validAreas.has(areaName));
-    return {
-        known,
-        unresolved: known.length === 0,
-        invalid,
     };
 }
 export function buildActionContext(input) {
-    if (input.planningHome?.kind === 'workspace') {
-        return {
-            mode: 'workspace-planning',
-            sourceOfTruth: 'workspace-local',
-            planningArtifacts: input.artifactIds,
-            linkedContext: (input.planningHome.workspace?.links ?? []).map((name) => ({ name })),
-            allowedEditRoots: [],
-            requiresAffectedAreaSelection: true,
-            constraints: [
-                'Treat workspace-local planning artifacts as compatibility context for this local view.',
-                'Use initiatives for durable coordination when initiative context exists.',
-                'Treat linked repos and folders as context until an explicit edit root is selected.',
-                'Do not make implementation edits without an explicit allowed edit root.',
-            ],
-        };
-    }
     return {
         mode: 'repo-local',
         sourceOfTruth: 'repo',
@@ -54,17 +24,12 @@ export function buildNextSteps(input) {
     const readyArtifact = input.artifactStatuses.find((artifact) => artifact.status === 'ready');
     const steps = [];
     if (readyArtifact) {
-        steps.push(`Run openspec instructions ${readyArtifact.id} --change "${input.changeName}" --json before writing that artifact.`);
+        const storeFlag = input.storeId ? ` --store ${input.storeId}` : '';
+        steps.push(`Run openspec instructions ${readyArtifact.id} --change "${input.changeName}"${storeFlag} --json before writing that artifact.`);
     }
     else if (input.allArtifactsComplete) {
         steps.push('All planning artifacts are complete; review tasks before implementation.');
     }
-    if (input.planningHome?.kind === 'workspace') {
-        if (input.affectedAreas?.unresolved) {
-            steps.push('Identify affected areas in change metadata or coordination tasks as planning continues.');
-        }
-        steps.push('Select an affected area and allowed edit root before implementation edits.');
-    }
     return steps;
 }
 //# sourceMappingURL=change-status-policy.js.map

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

@@ -6,20 +6,7 @@
  */
 import path from 'path';
 import { transformToHyphenCommands } from '../../../utils/command-references.js';
-/**
- * Escapes a string value for safe YAML output.
- * Quotes the string if it contains special YAML characters.
- */
-function escapeYamlValue(value) {
-    // 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 and backslashes
-        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-        return `"${escaped}"`;
-    }
-    return value;
-}
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Bob Shell adapter for command generation.
  * File path: .bob/commands/opsx-<id>.md

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

@@ -7,7 +7,7 @@ import type { ToolCommandAdapter } from '../types.js';
 /**
  * Claude Code adapter for command generation.
  * File path: .claude/commands/opsx/<id>.md
- * Frontmatter: name, description, category, tags
+ * Frontmatter: name, description, allowed-tools, category, tags
  */
 export declare const claudeAdapter: ToolCommandAdapter;
 //# sourceMappingURL=claude.d.ts.map

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

@@ -4,20 +4,8 @@
  * Formats commands for Claude Code following its frontmatter 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) {
-    // 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 and backslashes
-        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-        return `"${escaped}"`;
-    }
-    return value;
-}
+import { escapeYamlValue } from '../yaml.js';
+import { OPENSPEC_CLI_ALLOWED_TOOLS } from '../../shared/allowed-tools.js';
 /**
  * Formats a tags array as a YAML array with proper escaping.
  */
@@ -28,7 +16,7 @@ function formatTagsArray(tags) {
 /**
  * Claude Code adapter for command generation.
  * File path: .claude/commands/opsx/<id>.md
- * Frontmatter: name, description, category, tags
+ * Frontmatter: name, description, allowed-tools, category, tags
  */
 export const claudeAdapter = {
     toolId: 'claude',
@@ -39,6 +27,7 @@ export const claudeAdapter = {
         return `---
 name: ${escapeYamlValue(content.name)}
 description: ${escapeYamlValue(content.description)}
+allowed-tools: ${OPENSPEC_CLI_ALLOWED_TOOLS}
 category: ${escapeYamlValue(content.category)}
 tags: ${formatTagsArray(content.tags)}
 ---

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

@@ -5,20 +5,7 @@
  * Cursor uses a different frontmatter format and file naming convention.
  */
 import path from 'path';
-/**
- * Escapes a string value for safe YAML output.
- * Quotes the string if it contains special YAML characters.
- */
-function escapeYamlValue(value) {
-    // 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 and backslashes
-        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-        return `"${escaped}"`;
-    }
-    return value;
-}
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Cursor adapter for command generation.
  * File path: .cursor/commands/opsx-<id>.md

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

@@ -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 { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/command-generation/adapters/index.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 { traeAdapter } from './trae.js';
 export { windsurfAdapter } from './windsurf.js';
 //# sourceMappingURL=index.js.map

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. Command references in the body
+ * are transformed from /opsx: to /opsx- for consistency, 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,44 @@
+/**
+ * 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 { transformToHyphenCommands } from '../../../utils/command-references.js';
+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. Command references in the body
+ * are transformed from /opsx: to /opsx- for consistency, 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) {
+        const transformedBody = transformToHyphenCommands(content.body);
+        return `---
+description: ${escapeYamlValue(content.description)}
+---
+
+${injectOmpArgs(transformedBody)}
+`;
+    },
+};
+//# sourceMappingURL=oh-my-pi.js.map

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

@@ -6,6 +6,7 @@
  */
 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) {
     if (body.includes('$@') || body.includes('$ARGUMENTS')) {
@@ -13,20 +14,6 @@ function injectPiArgs(body) {
     }
     return body.replace(PI_INPUT_HEADING, (heading) => `${heading}\n**Provided arguments**: $@`);
 }
-/**
- * Escapes a string value for safe YAML output.
- * Quotes the string if it contains special YAML characters.
- */
-function escapeYamlValue(value) {
-    // 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 and backslashes
-        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-        return `"${escaped}"`;
-    }
-    return value;
-}
 /**
  * Pi adapter for prompt template generation.
  * File path: .pi/prompts/opsx-<id>.md

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

@@ -0,0 +1,13 @@
+/**
+ * Trae Command Adapter
+ *
+ * Formats commands for Trae IDE following its command specification.
+ */
+import type { ToolCommandAdapter } from '../types.js';
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/opsx-<id>.md
+ * Frontmatter: name, description
+ */
+export declare const traeAdapter: ToolCommandAdapter;
+//# sourceMappingURL=trae.d.ts.map

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

@@ -0,0 +1,48 @@
+/**
+ * Trae Command Adapter
+ *
+ * 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;
+}
+/**
+ * Trae adapter for command generation.
+ * File path: .trae/commands/opsx-<id>.md
+ * Frontmatter: name, description
+ */
+export const traeAdapter = {
+    toolId: 'trae',
+    getFilePath(commandId) {
+        return path.join('.trae', 'commands', `opsx-${commandId}.md`);
+    },
+    formatFile(content) {
+        return `---
+name: ${escapeYamlValue(content.name)}
+description: ${escapeYamlValue(content.description)}
+---
+
+${content.body}
+`;
+    },
+};
+//# sourceMappingURL=trae.js.map

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

@@ -5,20 +5,7 @@
  * Windsurf uses a similar format to Claude but may have different conventions.
  */
 import path from 'path';
-/**
- * Escapes a string value for safe YAML output.
- * Quotes the string if it contains special YAML characters.
- */
-function escapeYamlValue(value) {
-    // 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 and backslashes
-        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/\n/g, '\\n');
-        return `"${escaped}"`;
-    }
-    return value;
-}
+import { escapeYamlValue } from '../yaml.js';
 /**
  * Formats a tags array as a YAML array with proper escaping.
  */

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

@@ -23,12 +23,14 @@ import { iflowAdapter } from './adapters/iflow.js';
 import { junieAdapter } from './adapters/junie.js';
 import { kilocodeAdapter } from './adapters/kilocode.js';
 import { kiroAdapter } from './adapters/kiro.js';
+import { ohMyPiAdapter } from './adapters/oh-my-pi.js';
 import { opencodeAdapter } from './adapters/opencode.js';
 import { piAdapter } from './adapters/pi.js';
 import { qoderAdapter } from './adapters/qoder.js';
 import { lingmaAdapter } from './adapters/lingma.js';
 import { qwenAdapter } from './adapters/qwen.js';
 import { roocodeAdapter } from './adapters/roocode.js';
+import { traeAdapter } from './adapters/trae.js';
 import { windsurfAdapter } from './adapters/windsurf.js';
 /**
  * Registry for looking up tool command adapters.
@@ -56,12 +58,14 @@ export class CommandAdapterRegistry {
         CommandAdapterRegistry.register(junieAdapter);
         CommandAdapterRegistry.register(kilocodeAdapter);
         CommandAdapterRegistry.register(kiroAdapter);
+        CommandAdapterRegistry.register(ohMyPiAdapter);
         CommandAdapterRegistry.register(opencodeAdapter);
         CommandAdapterRegistry.register(piAdapter);
         CommandAdapterRegistry.register(qoderAdapter);
         CommandAdapterRegistry.register(lingmaAdapter);
         CommandAdapterRegistry.register(qwenAdapter);
         CommandAdapterRegistry.register(roocodeAdapter);
+        CommandAdapterRegistry.register(traeAdapter);
         CommandAdapterRegistry.register(windsurfAdapter);
     }
     /**

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

@@ -0,0 +1,22 @@
+/**
+ * Shared YAML frontmatter helpers for command adapters.
+ *
+ * Several tool adapters emit YAML frontmatter and need to escape
+ * user-facing strings (name, description, category, tags) so the
+ * generated file stays valid YAML. This module centralizes that logic
+ * so the behavior is identical across adapters and fixed in one place.
+ */
+/**
+ * Escapes a string value for safe YAML output.
+ *
+ * Quotes the value with double quotes when it contains characters that
+ * carry special meaning in YAML (or leading/trailing whitespace), and
+ * escapes the characters that are not representable verbatim inside a
+ * double-quoted scalar: backslash, double quote, line feed and carriage
+ * return. Values without special characters are returned unquoted.
+ *
+ * @param value - The raw string to embed in YAML frontmatter.
+ * @returns The value, double-quoted and escaped when necessary.
+ */
+export declare function escapeYamlValue(value: string): string;
+//# sourceMappingURL=yaml.d.ts.map

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

@@ -0,0 +1,38 @@
+/**
+ * Shared YAML frontmatter helpers for command adapters.
+ *
+ * Several tool adapters emit YAML frontmatter and need to escape
+ * user-facing strings (name, description, category, tags) so the
+ * generated file stays valid YAML. This module centralizes that logic
+ * so the behavior is identical across adapters and fixed in one place.
+ */
+/**
+ * Escapes a string value for safe YAML output.
+ *
+ * Quotes the value with double quotes when it contains characters that
+ * carry special meaning in YAML (or leading/trailing whitespace), and
+ * escapes the characters that are not representable verbatim inside a
+ * double-quoted scalar: backslash, double quote, line feed and carriage
+ * return. Values without special characters are returned unquoted.
+ *
+ * @param value - The raw string to embed in YAML frontmatter.
+ * @returns The value, double-quoted and escaped when necessary.
+ */
+export function escapeYamlValue(value) {
+    // 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 characters that are not safe to emit
+        // verbatim inside a double-quoted YAML scalar. Carriage returns must be
+        // escaped too: a literal CR inside double quotes is subject to YAML line
+        // folding/normalization and would silently corrupt the round-tripped value.
+        const escaped = value
+            .replace(/\\/g, '\\\\')
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, '\\n')
+            .replace(/\r/g, '\\r');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=yaml.js.map