@fission-ai/openspec 0.3.0 → 0.4.0

package/README.md

@@ -15,6 +15,7 @@
   <a href="https://nodejs.org/"><img alt="node version" src="https://img.shields.io/node/v/@fission-ai/openspec?style=flat-square" /></a>
   <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>
   <a href="https://conventionalcommits.org"><img alt="Conventional Commits" src="https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg?style=flat-square" /></a>
+  <a href="https://discord.gg/saTQQGQZ"><img alt="Discord" src="https://img.shields.io/discord/1411657095639601154?logo=discord&logoColor=white&style=flat-square" /></a>
 </p>
 
 <p align="center">
@@ -22,7 +23,7 @@
 </p>
 
 <p align="center">
-  Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates.
+  Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates · Join the <a href="https://discord.gg/saTQQGQZ">OpenSpec Discord</a> for help and questions.
 </p>
 
 # OpenSpec
@@ -82,13 +83,14 @@ These tools have built-in OpenSpec commands. Select the OpenSpec integration whe
 |------|----------|
 | **Claude Code** | `/openspec:proposal`, `/openspec:apply`, `/openspec:archive` |
 | **Cursor** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
+| **OpenCode** | `/openspec-proposal`, `/openspec-apply`, `/openspec-archive` |
 
 #### AGENTS.md Compatible
 These tools automatically read workflow instructions from `openspec/AGENTS.md`. Ask them to follow the OpenSpec workflow if they need a reminder. Learn more about the [AGENTS.md convention](https://agents.md/).
 
 | Tools |
 |-------|
-| Codex • Amp • Jules • OpenCode • Gemini CLI • GitHub Copilot • Others |
+| Codex • Amp • Jules • Gemini CLI • GitHub Copilot • Others |
 
 ### Install & Initialize
 

package/dist/core/config.js

@@ -6,6 +6,7 @@ export const OPENSPEC_MARKERS = {
 export const AI_TOOLS = [
     { name: 'Claude Code (✅ OpenSpec custom slash commands available)', value: 'claude', available: true, successLabel: 'Claude Code' },
     { name: 'Cursor (✅ OpenSpec custom slash commands available)', value: 'cursor', available: true, successLabel: 'Cursor' },
+    { name: 'OpenCode (✅ OpenSpec custom slash commands available)', value: 'opencode', available: true, successLabel: 'OpenCode' },
     { name: 'AGENTS.md (works with Codex, Amp, Copilot, …)', value: 'agents', available: true, successLabel: 'your AGENTS.md-compatible assistant' }
 ];
 //# sourceMappingURL=config.js.map

package/dist/core/configurators/slash/opencode.d.ts

@@ -0,0 +1,9 @@
+import { SlashCommandConfigurator } from "./base.js";
+import { SlashCommandId } from "../../templates/index.js";
+export declare class OpenCodeSlashCommandConfigurator extends SlashCommandConfigurator {
+    readonly toolId = "opencode";
+    readonly isAvailable = true;
+    protected getRelativePath(id: SlashCommandId): string;
+    protected getFrontmatter(id: SlashCommandId): string | undefined;
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/core/configurators/slash/opencode.js

@@ -0,0 +1,36 @@
+import { SlashCommandConfigurator } from "./base.js";
+const FILE_PATHS = {
+    proposal: ".opencode/command/openspec-proposal.md",
+    apply: ".opencode/command/openspec-apply.md",
+    archive: ".opencode/command/openspec-archive.md",
+};
+const FRONTMATTER = {
+    proposal: `---
+agent: build
+description: Scaffold a new OpenSpec change and validate strictly.
+---
+The user has requested the following change proposal. Use the openspec instructions to create their change proposal.
+<UserRequest>
+  $ARGUMENTS
+</UserRequest>
+`,
+    apply: `---
+agent: build
+description: Implement an approved OpenSpec change and keep tasks in sync.
+---`,
+    archive: `---
+agent: build
+description: Archive a deployed OpenSpec change and update specs.
+---`,
+};
+export class OpenCodeSlashCommandConfigurator extends SlashCommandConfigurator {
+    toolId = "opencode";
+    isAvailable = true;
+    getRelativePath(id) {
+        return FILE_PATHS[id];
+    }
+    getFrontmatter(id) {
+        return FRONTMATTER[id];
+    }
+}
+//# sourceMappingURL=opencode.js.map

package/dist/core/configurators/slash/registry.js

@@ -1,12 +1,15 @@
 import { ClaudeSlashCommandConfigurator } from './claude.js';
 import { CursorSlashCommandConfigurator } from './cursor.js';
+import { OpenCodeSlashCommandConfigurator } from './opencode.js';
 export class SlashCommandRegistry {
     static configurators = new Map();
     static {
         const claude = new ClaudeSlashCommandConfigurator();
         const cursor = new CursorSlashCommandConfigurator();
+        const opencode = new OpenCodeSlashCommandConfigurator();
         this.configurators.set(claude.toolId, claude);
         this.configurators.set(cursor.toolId, cursor);
+        this.configurators.set(opencode.toolId, opencode);
     }
     static register(configurator) {
         this.configurators.set(configurator.toolId, configurator);

package/dist/core/init.js

@@ -1,72 +1,30 @@
 import path from 'path';
-import { createPrompt, isBackspaceKey, isDownKey, isEnterKey, isSpaceKey, isUpKey, useKeypress, usePagination, useState } from '@inquirer/core';
+import { createPrompt, isBackspaceKey, isDownKey, isEnterKey, isSpaceKey, isUpKey, useKeypress, usePagination, useState, } from '@inquirer/core';
 import chalk from 'chalk';
 import ora from 'ora';
 import { FileSystemUtils } from '../utils/file-system.js';
 import { TemplateManager } from './templates/index.js';
 import { ToolRegistry } from './configurators/registry.js';
 import { SlashCommandRegistry } from './configurators/slash/registry.js';
-import { AI_TOOLS, OPENSPEC_DIR_NAME } from './config.js';
+import { AI_TOOLS, OPENSPEC_DIR_NAME, } from './config.js';
 const PROGRESS_SPINNER = {
     interval: 80,
-    frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓']
+    frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
 };
 const PALETTE = {
     white: chalk.hex('#f4f4f4'),
     lightGray: chalk.hex('#c8c8c8'),
     midGray: chalk.hex('#8a8a8a'),
-    darkGray: chalk.hex('#4a4a4a')
+    darkGray: chalk.hex('#4a4a4a'),
 };
 const LETTER_MAP = {
-    O: [
-        ' ████ ',
-        '██  ██',
-        '██  ██',
-        '██  ██',
-        ' ████ '
-    ],
-    P: [
-        '█████ ',
-        '██  ██',
-        '█████ ',
-        '██    ',
-        '██    '
-    ],
-    E: [
-        '██████',
-        '██    ',
-        '█████ ',
-        '██    ',
-        '██████'
-    ],
-    N: [
-        '██  ██',
-        '███ ██',
-        '██ ███',
-        '██  ██',
-        '██  ██'
-    ],
-    S: [
-        ' █████',
-        '██    ',
-        ' ████ ',
-        '    ██',
-        '█████ '
-    ],
-    C: [
-        ' █████',
-        '██    ',
-        '██    ',
-        '██    ',
-        ' █████'
-    ],
-    ' ': [
-        '  ',
-        '  ',
-        '  ',
-        '  ',
-        '  '
-    ]
+    O: [' ████ ', '██  ██', '██  ██', '██  ██', ' ████ '],
+    P: ['█████ ', '██  ██', '█████ ', '██    ', '██    '],
+    E: ['██████', '██    ', '█████ ', '██    ', '██████'],
+    N: ['██  ██', '███ ██', '██ ███', '██  ██', '██  ██'],
+    S: [' █████', '██    ', ' ████ ', '    ██', '█████ '],
+    C: [' █████', '██    ', '██    ', '██    ', ' █████'],
+    ' ': ['  ', '  ', '  ', '  ', '  '],
 };
 const sanitizeToolLabel = (raw) => raw.replace(/✅/gu, '✔').trim();
 const parseToolLabel = (raw) => {
@@ -77,7 +35,7 @@ const parseToolLabel = (raw) => {
     }
     return {
         primary: match[1].trim(),
-        annotation: match[2].trim()
+        annotation: match[2].trim(),
     };
 };
 const toolSelectionWizard = createPrompt((config, done) => {
@@ -101,12 +59,16 @@ const toolSelectionWizard = createPrompt((config, done) => {
         loop: config.choices.length > 1,
         renderItem: ({ item, isActive }) => {
             const isSelected = selectedSet.has(item.value);
-            const cursorSymbol = isActive ? PALETTE.white('›') : PALETTE.midGray(' ');
-            const indicator = isSelected ? PALETTE.white('◉') : PALETTE.midGray('○');
+            const cursorSymbol = isActive
+                ? PALETTE.white('›')
+                : PALETTE.midGray(' ');
+            const indicator = isSelected
+                ? PALETTE.white('◉')
+                : PALETTE.midGray('○');
             const nameColor = isActive ? PALETTE.white : PALETTE.midGray;
             const label = `${nameColor(item.label.primary)}${item.configured ? PALETTE.midGray(' (already configured)') : ''}`;
             return `${cursorSymbol} ${indicator} ${label}`;
-        }
+        },
     });
     useKeypress((key) => {
         if (step === 'intro') {
@@ -247,13 +209,13 @@ export class InitCommand {
             }
             throw new Error('You must select at least one AI tool to configure.');
         }
-        const availableTools = AI_TOOLS.filter(tool => tool.available);
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
         const selectedIds = new Set(config.aiTools);
-        const selectedTools = availableTools.filter(tool => selectedIds.has(tool.value));
-        const created = selectedTools.filter(tool => !existingToolStates[tool.value]);
-        const refreshed = selectedTools.filter(tool => existingToolStates[tool.value]);
-        const skippedExisting = availableTools.filter(tool => !selectedIds.has(tool.value) && existingToolStates[tool.value]);
-        const skipped = availableTools.filter(tool => !selectedIds.has(tool.value) && !existingToolStates[tool.value]);
+        const selectedTools = availableTools.filter((tool) => selectedIds.has(tool.value));
+        const created = selectedTools.filter((tool) => !existingToolStates[tool.value]);
+        const refreshed = selectedTools.filter((tool) => existingToolStates[tool.value]);
+        const skippedExisting = availableTools.filter((tool) => !selectedIds.has(tool.value) && existingToolStates[tool.value]);
+        const skipped = availableTools.filter((tool) => !selectedIds.has(tool.value) && !existingToolStates[tool.value]);
         // Step 1: Create directory structure
         if (!extendMode) {
             const structureSpinner = this.startSpinner('Creating OpenSpec structure...');
@@ -261,7 +223,7 @@ export class InitCommand {
             await this.generateFiles(openspecPath, config);
             structureSpinner.stopAndPersist({
                 symbol: PALETTE.white('▌'),
-                text: PALETTE.white('OpenSpec structure created')
+                text: PALETTE.white('OpenSpec structure created'),
             });
         }
         else {
@@ -272,7 +234,7 @@ export class InitCommand {
         await this.configureAITools(projectPath, openspecDir, config.aiTools);
         toolSpinner.stopAndPersist({
             symbol: PALETTE.white('▌'),
-            text: PALETTE.white('AI tools configured')
+            text: PALETTE.white('AI tools configured'),
         });
         // Success message
         this.displaySuccessMessage(selectedTools, created, refreshed, skippedExisting, skipped, extendMode);
@@ -280,7 +242,7 @@ export class InitCommand {
     async validate(projectPath, _openspecPath) {
         const extendMode = await FileSystemUtils.directoryExists(_openspecPath);
         // Check write permissions
-        if (!await FileSystemUtils.ensureWritePermissions(projectPath)) {
+        if (!(await FileSystemUtils.ensureWritePermissions(projectPath))) {
             throw new Error(`Insufficient permissions to write to ${projectPath}`);
         }
         return extendMode;
@@ -290,7 +252,7 @@ export class InitCommand {
         return { aiTools: selectedTools };
     }
     async promptForAITools(existingTools, extendMode) {
-        const availableTools = AI_TOOLS.filter(tool => tool.available);
+        const availableTools = AI_TOOLS.filter((tool) => tool.available);
         if (availableTools.length === 0) {
             return [];
         }
@@ -298,7 +260,9 @@ export class InitCommand {
             ? 'Which AI tools would you like to add or refresh?'
             : 'Which AI tools do you use?';
         const initialSelected = extendMode
-            ? availableTools.filter(tool => existingTools[tool.value]).map(tool => tool.value)
+            ? availableTools
+                .filter((tool) => existingTools[tool.value])
+                .map((tool) => tool.value)
             : [];
         return this.prompt({
             extendMode,
@@ -306,9 +270,9 @@ export class InitCommand {
             choices: availableTools.map((tool) => ({
                 value: tool.value,
                 label: parseToolLabel(tool.name),
-                configured: Boolean(existingTools[tool.value])
+                configured: Boolean(existingTools[tool.value]),
             })),
-            initialSelected
+            initialSelected,
         });
     }
     async getExistingToolStates(projectPath) {
@@ -320,7 +284,8 @@ export class InitCommand {
     }
     async isToolConfigured(projectPath, toolId) {
         const configFile = ToolRegistry.get(toolId)?.configFileName;
-        if (configFile && await FileSystemUtils.fileExists(path.join(projectPath, configFile)))
+        if (configFile &&
+            (await FileSystemUtils.fileExists(path.join(projectPath, configFile))))
             return true;
         const slashConfigurator = SlashCommandRegistry.get(toolId);
         if (!slashConfigurator)
@@ -336,7 +301,7 @@ export class InitCommand {
             openspecPath,
             path.join(openspecPath, 'specs'),
             path.join(openspecPath, 'changes'),
-            path.join(openspecPath, 'changes', 'archive')
+            path.join(openspecPath, 'changes', 'archive'),
         ];
         for (const dir of directories) {
             await FileSystemUtils.createDirectory(dir);
@@ -376,10 +341,18 @@ export class InitCommand {
         console.log();
         console.log(PALETTE.lightGray('Tool summary:'));
         const summaryLines = [
-            created.length ? `${PALETTE.white('▌')} ${PALETTE.white('Created:')} ${this.formatToolNames(created)}` : null,
-            refreshed.length ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('Refreshed:')} ${this.formatToolNames(refreshed)}` : null,
-            skippedExisting.length ? `${PALETTE.midGray('▌')} ${PALETTE.midGray('Skipped (already configured):')} ${this.formatToolNames(skippedExisting)}` : null,
-            skipped.length ? `${PALETTE.darkGray('▌')} ${PALETTE.darkGray('Skipped:')} ${this.formatToolNames(skipped)}` : null
+            created.length
+                ? `${PALETTE.white('▌')} ${PALETTE.white('Created:')} ${this.formatToolNames(created)}`
+                : null,
+            refreshed.length
+                ? `${PALETTE.lightGray('▌')} ${PALETTE.lightGray('Refreshed:')} ${this.formatToolNames(refreshed)}`
+                : null,
+            skippedExisting.length
+                ? `${PALETTE.midGray('▌')} ${PALETTE.midGray('Skipped (already configured):')} ${this.formatToolNames(skippedExisting)}`
+                : null,
+            skipped.length
+                ? `${PALETTE.darkGray('▌')} ${PALETTE.darkGray('Skipped:')} ${this.formatToolNames(skipped)}`
+                : null,
         ].filter((line) => Boolean(line));
         for (const line of summaryLines) {
             console.log(line);
@@ -427,7 +400,7 @@ export class InitCommand {
             PALETTE.lightGray,
             PALETTE.midGray,
             PALETTE.lightGray,
-            PALETTE.white
+            PALETTE.white,
         ];
         console.log();
         rows.forEach((row, index) => {
@@ -442,7 +415,7 @@ export class InitCommand {
             text,
             stream: process.stdout,
             color: 'gray',
-            spinner: PROGRESS_SPINNER
+            spinner: PROGRESS_SPINNER,
         }).start();
     }
 }

package/dist/core/parsers/change-parser.js

@@ -124,7 +124,7 @@ export class ChangeParser extends MarkdownParser {
     }
     parseRenames(content) {
         const renames = [];
-        const lines = content.split('\n');
+        const lines = ChangeParser.normalizeContent(content).split('\n');
         let currentRename = {};
         for (const line of lines) {
             const fromMatch = line.match(/^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);
@@ -146,7 +146,8 @@ export class ChangeParser extends MarkdownParser {
         return renames;
     }
     parseSectionsFromContent(content) {
-        const lines = content.split('\n');
+        const normalizedContent = ChangeParser.normalizeContent(content);
+        const lines = normalizedContent.split('\n');
         const sections = [];
         const stack = [];
         for (let i = 0; i < lines.length; i++) {

package/dist/core/parsers/markdown-parser.d.ts

@@ -9,6 +9,7 @@ export declare class MarkdownParser {
     private lines;
     private currentLine;
     constructor(content: string);
+    protected static normalizeContent(content: string): string;
     parseSpec(name: string): Spec;
     parseChange(name: string): Change;
     protected parseSections(): Section[];

package/dist/core/parsers/markdown-parser.js

@@ -2,9 +2,13 @@ export class MarkdownParser {
     lines;
     currentLine;
     constructor(content) {
-        this.lines = content.split('\n');
+        const normalized = MarkdownParser.normalizeContent(content);
+        this.lines = normalized.split('\n');
         this.currentLine = 0;
     }
+    static normalizeContent(content) {
+        return content.replace(/\r\n?/g, '\n');
+    }
     parseSpec(name) {
         const sections = this.parseSections();
         const purpose = this.findSection(sections, 'Purpose')?.content || '';

package/dist/core/parsers/requirement-blocks.js

@@ -6,7 +6,8 @@ const REQUIREMENT_HEADER_REGEX = /^###\s*Requirement:\s*(.+)\s*$/;
  * Extracts the Requirements section from a spec file and parses requirement blocks.
  */
 export function extractRequirementsSection(content) {
-    const lines = content.split('\n');
+    const normalized = normalizeLineEndings(content);
+    const lines = normalized.split('\n');
     const reqHeaderIndex = lines.findIndex(l => /^##\s+Requirements\s*$/i.test(l));
     if (reqHeaderIndex === -1) {
         // No requirements section; create an empty one at the end
@@ -70,11 +71,15 @@ export function extractRequirementsSection(content) {
         after: after.startsWith('\n') ? after : '\n' + after,
     };
 }
+function normalizeLineEndings(content) {
+    return content.replace(/\r\n?/g, '\n');
+}
 /**
  * Parse a delta-formatted spec change file content into a DeltaPlan with raw blocks.
  */
 export function parseDeltaSpec(content) {
-    const sections = splitTopLevelSections(content);
+    const normalized = normalizeLineEndings(content);
+    const sections = splitTopLevelSections(normalized);
     const added = parseRequirementBlocksFromSection(sections['ADDED Requirements'] || '');
     const modified = parseRequirementBlocksFromSection(sections['MODIFIED Requirements'] || '');
     const removedNames = parseRemovedNames(sections['REMOVED Requirements'] || '');
@@ -103,7 +108,7 @@ function splitTopLevelSections(content) {
 function parseRequirementBlocksFromSection(sectionBody) {
     if (!sectionBody)
         return [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     const blocks = [];
     let i = 0;
     while (i < lines.length) {
@@ -133,7 +138,7 @@ function parseRemovedNames(sectionBody) {
     if (!sectionBody)
         return [];
     const names = [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     for (const line of lines) {
         const m = line.match(REQUIREMENT_HEADER_REGEX);
         if (m) {
@@ -152,7 +157,7 @@ function parseRenamedPairs(sectionBody) {
     if (!sectionBody)
         return [];
     const pairs = [];
-    const lines = sectionBody.split('\n');
+    const lines = normalizeLineEndings(sectionBody).split('\n');
     let current = {};
     for (const line of lines) {
         const fromMatch = line.match(/^\s*-?\s*FROM:\s*`?###\s*Requirement:\s*(.+?)`?\s*$/);

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

@@ -24,7 +24,7 @@ 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>\` to let the CLI move the change and apply spec updates (use \`--skip-specs\` only for tooling-only work).
+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.`;
 const archiveReferences = `**Reference**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",
@@ -18,8 +18,7 @@
   "author": "OpenSpec Contributors",
   "type": "module",
   "publishConfig": {
-    "access": "public",
-    "tag": "next"
+    "access": "public"
   },
   "exports": {
     ".": {