@fission-ai/openspec 1.4.1 → 1.5.0

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.js

@@ -4,20 +4,7 @@
  * 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';
 /**
  * Formats a tags array as a YAML array with proper escaping.
  */

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