@fission-ai/openspec 0.5.0 → 0.6.0

package/dist/core/init.js

@@ -7,16 +7,11 @@ 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 { PALETTE } from './styles/palette.js';
 const PROGRESS_SPINNER = {
     interval: 80,
     frames: ['░░░', '▒░░', '▒▒░', '▒▒▒', '▓▒▒', '▓▓▒', '▓▓▓', '▒▓▓', '░▒▓'],
 };
-const PALETTE = {
-    white: chalk.hex('#f4f4f4'),
-    lightGray: chalk.hex('#c8c8c8'),
-    midGray: chalk.hex('#8a8a8a'),
-    darkGray: chalk.hex('#4a4a4a'),
-};
 const LETTER_MAP = {
     O: [' ████ ', '██  ██', '██  ██', '██  ██', ' ████ '],
     P: ['█████ ', '██  ██', '█████ ', '██    ', '██    '],

package/dist/core/styles/palette.d.ts

@@ -0,0 +1,7 @@
+export declare const PALETTE: {
+    white: import("chalk").ChalkInstance;
+    lightGray: import("chalk").ChalkInstance;
+    midGray: import("chalk").ChalkInstance;
+    darkGray: import("chalk").ChalkInstance;
+};
+//# sourceMappingURL=palette.d.ts.map

package/dist/core/styles/palette.js

@@ -0,0 +1,8 @@
+import chalk from 'chalk';
+export const PALETTE = {
+    white: chalk.hex('#f4f4f4'),
+    lightGray: chalk.hex('#c8c8c8'),
+    midGray: chalk.hex('#8a8a8a'),
+    darkGray: chalk.hex('#4a4a4a')
+};
+//# sourceMappingURL=palette.js.map

package/dist/core/templates/agents-root-stub.d.ts

@@ -0,0 +1,2 @@
+export declare const agentsRootStubTemplate = "# OpenSpec Instructions\n\nThese instructions are for AI assistants working in this project.\n\nAlways open `@/openspec/AGENTS.md` when the request:\n- Mentions planning or proposals (words like proposal, spec, change, plan)\n- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work\n- Sounds ambiguous and you need the authoritative spec before coding\n\nUse `@/openspec/AGENTS.md` to learn:\n- How to create and apply change proposals\n- Spec format and conventions\n- Project structure and guidelines\n\nKeep this managed block so 'openspec update' can refresh the instructions.\n";
+//# sourceMappingURL=agents-root-stub.d.ts.map

package/dist/core/templates/agents-root-stub.js

@@ -0,0 +1,17 @@
+export const agentsRootStubTemplate = `# OpenSpec Instructions
+
+These instructions are for AI assistants working in this project.
+
+Always open \`@/openspec/AGENTS.md\` when the request:
+- Mentions planning or proposals (words like proposal, spec, change, plan)
+- Introduces new capabilities, breaking changes, architecture shifts, or big performance/security work
+- Sounds ambiguous and you need the authoritative spec before coding
+
+Use \`@/openspec/AGENTS.md\` to learn:
+- How to create and apply change proposals
+- Spec format and conventions
+- Project structure and guidelines
+
+Keep this managed block so 'openspec update' can refresh the instructions.
+`;
+//# sourceMappingURL=agents-root-stub.js.map

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

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

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

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

package/dist/core/templates/index.js

@@ -1,6 +1,7 @@
 import { agentsTemplate } from './agents-template.js';
 import { projectTemplate } from './project-template.js';
 import { claudeTemplate } from './claude-template.js';
+import { agentsRootStubTemplate } from './agents-root-stub.js';
 import { getSlashCommandBody } from './slash-command-templates.js';
 export class TemplateManager {
     static getTemplates(context = {}) {
@@ -19,7 +20,7 @@ export class TemplateManager {
         return claudeTemplate;
     }
     static getAgentsStandardTemplate() {
-        return agentsTemplate;
+        return agentsRootStubTemplate;
     }
     static getSlashCommandBody(id) {
         return getSlashCommandBody(id);

package/dist/core/update.js

@@ -1,10 +1,9 @@
 import path from 'path';
 import { FileSystemUtils } from '../utils/file-system.js';
-import { OPENSPEC_DIR_NAME, OPENSPEC_MARKERS } from './config.js';
-import { agentsTemplate } from './templates/agents-template.js';
-import { TemplateManager } from './templates/index.js';
+import { OPENSPEC_DIR_NAME } from './config.js';
 import { ToolRegistry } from './configurators/registry.js';
 import { SlashCommandRegistry } from './configurators/slash/registry.js';
+import { agentsTemplate } from './templates/agents-template.js';
 export class UpdateCommand {
     async execute(projectPath) {
         const resolvedProjectPath = path.resolve(projectPath);
@@ -16,34 +15,36 @@ export class UpdateCommand {
         }
         // 2. Update AGENTS.md (full replacement)
         const agentsPath = path.join(openspecPath, 'AGENTS.md');
-        const rootAgentsPath = path.join(resolvedProjectPath, 'AGENTS.md');
-        const rootAgentsExisted = await FileSystemUtils.fileExists(rootAgentsPath);
         await FileSystemUtils.writeFile(agentsPath, agentsTemplate);
-        const agentsStandardContent = TemplateManager.getAgentsStandardTemplate();
-        await FileSystemUtils.updateFileWithMarkers(rootAgentsPath, agentsStandardContent, OPENSPEC_MARKERS.start, OPENSPEC_MARKERS.end);
         // 3. Update existing AI tool configuration files only
         const configurators = ToolRegistry.getAll();
         const slashConfigurators = SlashCommandRegistry.getAll();
-        let updatedFiles = [];
-        let failedFiles = [];
-        let updatedSlashFiles = [];
-        let failedSlashTools = [];
+        const updatedFiles = [];
+        const createdFiles = [];
+        const failedFiles = [];
+        const updatedSlashFiles = [];
+        const failedSlashTools = [];
         for (const configurator of configurators) {
             const configFilePath = path.join(resolvedProjectPath, configurator.configFileName);
-            // Only update if the file already exists
-            if (await FileSystemUtils.fileExists(configFilePath)) {
-                try {
-                    if (!await FileSystemUtils.canWriteFile(configFilePath)) {
-                        throw new Error(`Insufficient permissions to modify ${configurator.configFileName}`);
-                    }
-                    await configurator.configure(resolvedProjectPath, openspecPath);
-                    updatedFiles.push(configurator.configFileName);
+            const fileExists = await FileSystemUtils.fileExists(configFilePath);
+            const shouldConfigure = fileExists || configurator.configFileName === 'AGENTS.md';
+            if (!shouldConfigure) {
+                continue;
+            }
+            try {
+                if (fileExists && !await FileSystemUtils.canWriteFile(configFilePath)) {
+                    throw new Error(`Insufficient permissions to modify ${configurator.configFileName}`);
                 }
-                catch (error) {
-                    failedFiles.push(configurator.configFileName);
-                    console.error(`Failed to update ${configurator.configFileName}: ${error instanceof Error ? error.message : String(error)}`);
+                await configurator.configure(resolvedProjectPath, openspecPath);
+                updatedFiles.push(configurator.configFileName);
+                if (!fileExists) {
+                    createdFiles.push(configurator.configFileName);
                 }
             }
+            catch (error) {
+                failedFiles.push(configurator.configFileName);
+                console.error(`Failed to update ${configurator.configFileName}: ${error instanceof Error ? error.message : String(error)}`);
+            }
         }
         for (const slashConfigurator of slashConfigurators) {
             if (!slashConfigurator.isAvailable) {
@@ -51,30 +52,34 @@ export class UpdateCommand {
             }
             try {
                 const updated = await slashConfigurator.updateExisting(resolvedProjectPath, openspecPath);
-                updatedSlashFiles = updatedSlashFiles.concat(updated);
+                updatedSlashFiles.push(...updated);
             }
             catch (error) {
                 failedSlashTools.push(slashConfigurator.toolId);
                 console.error(`Failed to update slash commands for ${slashConfigurator.toolId}: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
-        // 4. Success message (ASCII-safe)
-        const instructionUpdates = ['openspec/AGENTS.md'];
-        instructionUpdates.push(`AGENTS.md${rootAgentsExisted ? '' : ' (created)'}`);
-        const messages = [`Updated OpenSpec instructions (${instructionUpdates.join(', ')})`];
-        if (updatedFiles.length > 0) {
-            messages.push(`Updated AI tool files: ${updatedFiles.join(', ')}`);
+        const summaryParts = [];
+        const instructionFiles = ['openspec/AGENTS.md'];
+        if (updatedFiles.includes('AGENTS.md')) {
+            instructionFiles.push(createdFiles.includes('AGENTS.md') ? 'AGENTS.md (created)' : 'AGENTS.md');
         }
-        if (updatedSlashFiles.length > 0) {
-            messages.push(`Updated slash commands: ${updatedSlashFiles.join(', ')}`);
+        summaryParts.push(`Updated OpenSpec instructions (${instructionFiles.join(', ')})`);
+        const aiToolFiles = updatedFiles.filter((file) => file !== 'AGENTS.md');
+        if (aiToolFiles.length > 0) {
+            summaryParts.push(`Updated AI tool files: ${aiToolFiles.join(', ')}`);
         }
-        if (failedFiles.length > 0) {
-            messages.push(`Failed to update: ${failedFiles.join(', ')}`);
+        if (updatedSlashFiles.length > 0) {
+            summaryParts.push(`Updated slash commands: ${updatedSlashFiles.join(', ')}`);
         }
-        if (failedSlashTools.length > 0) {
-            messages.push(`Failed slash command updates: ${failedSlashTools.join(', ')}`);
+        const failedItems = [
+            ...failedFiles,
+            ...failedSlashTools.map((toolId) => `slash command refresh (${toolId})`),
+        ];
+        if (failedItems.length > 0) {
+            summaryParts.push(`Failed to update: ${failedItems.join(', ')}`);
         }
-        console.log(messages.join('\n'));
+        console.log(summaryParts.join(' | '));
     }
 }
 //# sourceMappingURL=update.js.map

package/dist/utils/file-system.js

@@ -1,5 +1,34 @@
 import { promises as fs } from 'fs';
 import path from 'path';
+function isMarkerOnOwnLine(content, markerIndex, markerLength) {
+    let leftIndex = markerIndex - 1;
+    while (leftIndex >= 0 && content[leftIndex] !== '\n') {
+        const char = content[leftIndex];
+        if (char !== ' ' && char !== '\t' && char !== '\r') {
+            return false;
+        }
+        leftIndex--;
+    }
+    let rightIndex = markerIndex + markerLength;
+    while (rightIndex < content.length && content[rightIndex] !== '\n') {
+        const char = content[rightIndex];
+        if (char !== ' ' && char !== '\t' && char !== '\r') {
+            return false;
+        }
+        rightIndex++;
+    }
+    return true;
+}
+function findMarkerIndex(content, marker, fromIndex = 0) {
+    let currentIndex = content.indexOf(marker, fromIndex);
+    while (currentIndex !== -1) {
+        if (isMarkerOnOwnLine(content, currentIndex, marker.length)) {
+            return currentIndex;
+        }
+        currentIndex = content.indexOf(marker, currentIndex + marker.length);
+    }
+    return -1;
+}
 export class FileSystemUtils {
     static async createDirectory(dirPath) {
         await fs.mkdir(dirPath, { recursive: true });
@@ -56,9 +85,14 @@ export class FileSystemUtils {
         let existingContent = '';
         if (await this.fileExists(filePath)) {
             existingContent = await this.readFile(filePath);
-            const startIndex = existingContent.indexOf(startMarker);
-            const endIndex = existingContent.indexOf(endMarker);
+            const startIndex = findMarkerIndex(existingContent, startMarker);
+            const endIndex = startIndex !== -1
+                ? findMarkerIndex(existingContent, endMarker, startIndex + startMarker.length)
+                : findMarkerIndex(existingContent, endMarker);
             if (startIndex !== -1 && endIndex !== -1) {
+                if (endIndex < startIndex) {
+                    throw new Error(`Invalid marker state in ${filePath}. End marker appears before start marker.`);
+                }
                 const before = existingContent.substring(0, startIndex);
                 const after = existingContent.substring(endIndex + endMarker.length);
                 existingContent = before + startMarker + '\n' + content + '\n' + endMarker + after;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fission-ai/openspec",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "AI-native system for spec-driven development",
   "keywords": [
     "openspec",