@fission-ai/openspec 0.12.0 → 0.14.0

package/dist/core/templates/agents-template.js

@@ -60,7 +60,7 @@ Track these steps as TODOs and complete them one by one.
 After deployment, create separate PR to:
 - Move \`changes/[name]/\` → \`changes/archive/YYYY-MM-DD-[name]/\`
 - Update \`specs/\` if capabilities changed
-- Use \`openspec archive [change] --skip-specs --yes\` for tooling-only changes
+- Use \`openspec archive <change-id> --skip-specs --yes\` for tooling-only changes (always pass the change ID explicitly)
 - Run \`openspec validate --strict\` to confirm the archived change passes checks
 
 ## Before Any Task
@@ -95,9 +95,8 @@ After deployment, create separate PR to:
 openspec list                  # List active changes
 openspec list --specs          # List specifications
 openspec show [item]           # Display change or spec
-openspec diff [change]         # Show spec differences
 openspec validate [item]       # Validate changes or specs
-openspec archive [change] [--yes|-y]      # Archive after deployment (add --yes for non-interactive runs)
+openspec archive <change-id> [--yes|-y]   # Archive after deployment (add --yes for non-interactive runs)
 
 # Project management
 openspec init [path]           # Initialize OpenSpec
@@ -161,6 +160,8 @@ New request?
 
 2. **Write proposal.md:**
 \`\`\`markdown
+# Change: [Brief description of change]
+
 ## Why
 [1-2 sentences on problem/opportunity]
 
@@ -448,9 +449,8 @@ Only add complexity with:
 \`\`\`bash
 openspec list              # What's in progress?
 openspec show [item]       # View details
-openspec diff [change]     # What's changing?
 openspec validate --strict # Is it correct?
-openspec archive [change] [--yes|-y]  # Mark complete (add --yes for automation)
+openspec archive <change-id> [--yes|-y]  # Mark complete (add --yes for automation)
 \`\`\`
 
 Remember: Specs are truth. Changes are proposals. Keep them in sync.

package/dist/core/templates/cline-template.d.ts

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as clineTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=cline-template.d.ts.map

package/dist/core/templates/cline-template.js

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as clineTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=cline-template.js.map

package/dist/core/templates/costrict-template.d.ts

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as costrictTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=costrict-template.d.ts.map

package/dist/core/templates/costrict-template.js

@@ -0,0 +1,2 @@
+export { agentsRootStubTemplate as costrictTemplate } from './agents-root-stub.js';
+//# sourceMappingURL=costrict-template.js.map

package/dist/core/templates/index.d.ts

@@ -7,6 +7,8 @@ export interface Template {
 export declare class TemplateManager {
     static getTemplates(context?: ProjectContext): Template[];
     static getClaudeTemplate(): string;
+    static getClineTemplate(): string;
+    static getCostrictTemplate(): string;
     static getAgentsStandardTemplate(): string;
     static getSlashCommandBody(id: SlashCommandId): string;
 }

package/dist/core/templates/index.js

@@ -1,6 +1,8 @@
 import { agentsTemplate } from './agents-template.js';
 import { projectTemplate } from './project-template.js';
 import { claudeTemplate } from './claude-template.js';
+import { clineTemplate } from './cline-template.js';
+import { costrictTemplate } from './costrict-template.js';
 import { agentsRootStubTemplate } from './agents-root-stub.js';
 import { getSlashCommandBody } from './slash-command-templates.js';
 export class TemplateManager {
@@ -19,6 +21,12 @@ export class TemplateManager {
     static getClaudeTemplate() {
         return claudeTemplate;
     }
+    static getClineTemplate() {
+        return clineTemplate;
+    }
+    static getCostrictTemplate() {
+        return costrictTemplate;
+    }
     static getAgentsStandardTemplate() {
         return agentsRootStubTemplate;
     }

package/dist/core/templates/slash-command-templates.js

@@ -25,11 +25,17 @@ Track these steps as TODOs and complete them one by one.
 const applyReferences = `**Reference**
 - Use \`openspec show <id> --json --deltas-only\` if you need additional context from the proposal while implementing.`;
 const archiveSteps = `**Steps**
-1. Identify the requested change ID (via the prompt or \`openspec list\`).
-2. Run \`openspec archive <id> --yes\` to let the CLI move the change and apply spec updates without prompts (use \`--skip-specs\` only for tooling-only work).
-3. Review the command output to confirm the target specs were updated and the change landed in \`changes/archive/\`.
-4. Validate with \`openspec validate --strict\` and inspect with \`openspec show <id>\` if anything looks off.`;
+1. Determine the change ID to archive:
+   - If this prompt already includes a specific change ID (for example inside a \`<ChangeId>\` block populated by slash-command arguments), use that value after trimming whitespace.
+   - If the conversation references a change loosely (for example by title or summary), run \`openspec list\` to surface likely IDs, share the relevant candidates, and confirm which one the user intends.
+   - Otherwise, review the conversation, run \`openspec list\`, and ask the user which change to archive; wait for a confirmed change ID before proceeding.
+   - If you still cannot identify a single change ID, stop and tell the user you cannot archive anything yet.
+2. Validate the change ID by running \`openspec list\` (or \`openspec show <id>\`) and stop if the change is missing, already archived, or otherwise not ready to archive.
+3. Run \`openspec archive <id> --yes\` so the CLI moves the change and applies spec updates without prompts (use \`--skip-specs\` only for tooling-only work).
+4. Review the command output to confirm the target specs were updated and the change landed in \`changes/archive/\`.
+5. Validate with \`openspec validate --strict\` and inspect with \`openspec show <id>\` if anything looks off.`;
 const archiveReferences = `**Reference**
+- Use \`openspec list\` to confirm change IDs before archiving.
 - Inspect refreshed specs with \`openspec list --specs\` and address any validation issues before handing off.`;
 export const slashCommandBodies = {
     proposal: [proposalGuardrails, proposalSteps, proposalReferences].join('\n\n'),

package/dist/core/validation/validator.d.ts

@@ -28,5 +28,6 @@ export declare class Validator {
     private extractRequirementText;
     private containsShallOrMust;
     private countScenarios;
+    private formatSectionList;
 }
 //# sourceMappingURL=validator.d.ts.map

package/dist/core/validation/validator.js

@@ -93,6 +93,8 @@ export class Validator {
         const issues = [];
         const specsDir = path.join(changeDir, 'specs');
         let totalDeltas = 0;
+        const missingHeaderSpecs = [];
+        const emptySectionSpecs = [];
         try {
             const entries = await fs.readdir(specsDir, { withFileTypes: true });
             for (const entry of entries) {
@@ -109,6 +111,23 @@ export class Validator {
                 }
                 const plan = parseDeltaSpec(content);
                 const entryPath = `${specName}/spec.md`;
+                const sectionNames = [];
+                if (plan.sectionPresence.added)
+                    sectionNames.push('## ADDED Requirements');
+                if (plan.sectionPresence.modified)
+                    sectionNames.push('## MODIFIED Requirements');
+                if (plan.sectionPresence.removed)
+                    sectionNames.push('## REMOVED Requirements');
+                if (plan.sectionPresence.renamed)
+                    sectionNames.push('## RENAMED Requirements');
+                const hasSections = sectionNames.length > 0;
+                const hasEntries = plan.added.length + plan.modified.length + plan.removed.length + plan.renamed.length > 0;
+                if (!hasEntries) {
+                    if (hasSections)
+                        emptySectionSpecs.push({ path: entryPath, sections: sectionNames });
+                    else
+                        missingHeaderSpecs.push(entryPath);
+                }
                 const addedNames = new Set();
                 const modifiedNames = new Set();
                 const removedNames = new Set();
@@ -216,6 +235,20 @@ export class Validator {
         catch {
             // If no specs dir, treat as no deltas
         }
+        for (const { path: specPath, sections } of emptySectionSpecs) {
+            issues.push({
+                level: 'ERROR',
+                path: specPath,
+                message: `Delta sections ${this.formatSectionList(sections)} were found, but no requirement entries parsed. Ensure each section includes at least one "### Requirement:" block (REMOVED may use bullet list syntax).`,
+            });
+        }
+        for (const path of missingHeaderSpecs) {
+            issues.push({
+                level: 'ERROR',
+                path,
+                message: 'No delta sections found. Add headers such as "## ADDED Requirements" or move non-delta notes outside specs/.',
+            });
+        }
         if (totalDeltas === 0) {
             issues.push({ level: 'ERROR', path: 'file', message: this.enrichTopLevelError('change', VALIDATION_MESSAGES.CHANGE_NO_DELTAS) });
         }
@@ -334,17 +367,26 @@ export class Validator {
     }
     extractRequirementText(blockRaw) {
         const lines = blockRaw.split('\n');
-        // Skip header
+        // Skip header line (index 0)
         let i = 1;
-        const bodyLines = [];
+        // Find the first substantial text line, skipping metadata and blank lines
         for (; i < lines.length; i++) {
             const line = lines[i];
+            // Stop at scenario headers
             if (/^####\s+/.test(line))
-                break; // scenarios start
-            bodyLines.push(line);
+                break;
+            const trimmed = line.trim();
+            // Skip blank lines
+            if (trimmed.length === 0)
+                continue;
+            // Skip metadata lines (lines starting with ** like **ID**, **Priority**, etc.)
+            if (/^\*\*[^*]+\*\*:/.test(trimmed))
+                continue;
+            // Found first non-metadata, non-blank line - this is the requirement text
+            return trimmed;
         }
-        const text = bodyLines.join('\n').split('\n').map(l => l.trim()).find(l => l.length > 0);
-        return text;
+        // No requirement text found
+        return undefined;
     }
     containsShallOrMust(text) {
         return /\b(SHALL|MUST)\b/.test(text);
@@ -353,5 +395,14 @@ export class Validator {
         const matches = blockRaw.match(/^####\s+/gm);
         return matches ? matches.length : 0;
     }
+    formatSectionList(sections) {
+        if (sections.length === 0)
+            return '';
+        if (sections.length === 1)
+            return sections[0];
+        const head = sections.slice(0, -1);
+        const last = sections[sections.length - 1];
+        return `${head.join(', ')} and ${last}`;
+    }
 }
 //# sourceMappingURL=validator.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -43,7 +43,7 @@
     "@changesets/cli": "^2.27.7",
     "@types/node": "^24.2.0",
     "@vitest/ui": "^3.2.4",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "vitest": "^3.2.4"
   },
   "dependencies": {