@fission-ai/openspec 0.23.0 → 1.0.0

package/dist/ui/ascii-patterns.js

@@ -0,0 +1,133 @@
+/**
+ * ASCII art animation patterns for the welcome screen.
+ * OpenSpec logo animation - diamond/rhombus shape with hollow center "O".
+ */
+// Detect if full Unicode is supported
+const supportsUnicode = process.platform !== 'win32' ||
+    !!process.env.WT_SESSION || // Windows Terminal
+    !!process.env.TERM_PROGRAM; // Modern terminal
+// Character set based on Unicode support
+// Block characters for pixel-art aesthetic
+const CHARS = supportsUnicode
+    ? { full: '██', dim: '░░', empty: '  ' }
+    : { full: '##', dim: '++', empty: '  ' };
+const _ = CHARS.empty;
+const F = CHARS.full;
+const D = CHARS.dim;
+/**
+ * Welcome animation frames - OpenSpec logo building from center
+ * 7 rows × 6 columns diamond with hollow center "O"
+ * Center bar is 2 cols × 3 rows (rows 3,4,5 cols 3,4)
+ * Each frame is an array of strings (lines of ASCII art)
+ * Grid: 6 cols × 2 chars = 12 chars wide
+ */
+export const WELCOME_ANIMATION = {
+    interval: 120,
+    frames: [
+        // Frame 1: Empty
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 2: Center blocks appear (dim) - 2x3 center bar
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 3: Center blocks solidify
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+        ],
+        // Frame 4: Top and bottom points appear
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${D}${D}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${_}${_}${_}${_}`,
+            `${_}${_}${_}${_}${D}${D}${_}${_}`,
+        ],
+        // Frame 5: Inner ring forming
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${D}${_}${_}${D}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${D}${_}${_}${D}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+        ],
+        // Frame 6: Outer ring appearing
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}`,
+            `${_}${_}${D}${_}${F}${F}${_}${D}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+        ],
+        // Frame 7: Full logo
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+        ],
+        // Frame 8: Hold complete logo
+        [
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 1
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 2
+            `${_}${_}${_}${_}${_}${_}${_}${_}`, // padding row 3
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${F}${_}${F}${F}${_}${F}`,
+            `${_}${_}${_}${F}${_}${_}${F}${_}`,
+            `${_}${_}${_}${_}${F}${F}${_}${_}`,
+        ],
+    ],
+};
+//# sourceMappingURL=ascii-patterns.js.map

package/dist/ui/welcome-screen.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Animated welcome screen for the experimental artifact workflow setup.
+ * Shows side-by-side layout with animated ASCII art on left and welcome text on right.
+ */
+/**
+ * Shows the animated welcome screen.
+ * Returns when user presses Enter.
+ */
+export declare function showWelcomeScreen(): Promise<void>;
+//# sourceMappingURL=welcome-screen.d.ts.map

package/dist/ui/welcome-screen.js

@@ -0,0 +1,146 @@
+/**
+ * Animated welcome screen for the experimental artifact workflow setup.
+ * Shows side-by-side layout with animated ASCII art on left and welcome text on right.
+ */
+import chalk from 'chalk';
+import { WELCOME_ANIMATION } from './ascii-patterns.js';
+// Minimum terminal width for side-by-side layout
+const MIN_WIDTH = 60;
+// Width of the ASCII art column (with padding)
+const ART_COLUMN_WIDTH = 24;
+/**
+ * Welcome text content (right column)
+ */
+function getWelcomeText() {
+    return [
+        chalk.white.bold('Welcome to OpenSpec'),
+        chalk.dim('A lightweight spec-driven framework'),
+        '',
+        chalk.white('This setup will configure:'),
+        chalk.dim('  • Agent Skills for AI tools'),
+        chalk.dim('  • /opsx:* slash commands'),
+        '',
+        chalk.white('Quick start after setup:'),
+        `  ${chalk.yellow('/opsx:new')}      ${chalk.dim('Create a change')}`,
+        `  ${chalk.yellow('/opsx:continue')} ${chalk.dim('Next artifact')}`,
+        `  ${chalk.yellow('/opsx:apply')}    ${chalk.dim('Implement tasks')}`,
+        '',
+        chalk.cyan('Press Enter to select tools...'),
+    ];
+}
+/**
+ * Renders a single frame with side-by-side layout
+ */
+function renderFrame(artLines, textLines) {
+    const maxLines = Math.max(artLines.length, textLines.length);
+    const lines = [];
+    for (let i = 0; i < maxLines; i++) {
+        const artLine = artLines[i] || '';
+        const textLine = textLines[i] || '';
+        // Pad the art column to fixed width
+        const paddedArt = artLine.padEnd(ART_COLUMN_WIDTH);
+        // Color the ASCII art with cyan for visual appeal
+        const coloredArt = chalk.cyan(paddedArt);
+        // Clear line before writing to prevent residual characters
+        lines.push(`\x1b[2K${coloredArt}${textLine}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Checks if the terminal supports animation
+ */
+function canAnimate() {
+    // Must be TTY
+    if (!process.stdout.isTTY)
+        return false;
+    // Respect NO_COLOR
+    if (process.env.NO_COLOR)
+        return false;
+    // Check terminal width
+    const columns = process.stdout.columns || 80;
+    if (columns < MIN_WIDTH)
+        return false;
+    return true;
+}
+/**
+ * Wait for Enter key press
+ */
+function waitForEnter() {
+    return new Promise((resolve) => {
+        const { stdin } = process;
+        // Handle non-TTY gracefully
+        if (!stdin.isTTY) {
+            resolve();
+            return;
+        }
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        const onData = (data) => {
+            const char = data.toString();
+            // Enter key or Ctrl+C
+            if (char === '\r' || char === '\n' || char === '\u0003') {
+                stdin.removeListener('data', onData);
+                stdin.setRawMode(wasRaw);
+                stdin.pause();
+                // Handle Ctrl+C
+                if (char === '\u0003') {
+                    process.stdout.write('\n');
+                    process.exit(0);
+                }
+                resolve();
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+/**
+ * Shows the animated welcome screen.
+ * Returns when user presses Enter.
+ */
+export async function showWelcomeScreen() {
+    const textLines = getWelcomeText();
+    if (!canAnimate()) {
+        // Fallback: show static welcome
+        const frame = WELCOME_ANIMATION.frames[3]; // Peak frame
+        process.stdout.write('\n' + renderFrame(frame, textLines) + '\n\n');
+        return;
+    }
+    let frameIndex = 0;
+    let running = true;
+    let isFirstRender = true;
+    // Content height for cursor movement between frames
+    const numContentLines = Math.max(WELCOME_ANIMATION.frames[0].length, textLines.length);
+    const frameHeight = numContentLines + 1; // internal newlines (11) + trailing newlines (2) = 13
+    // Total height including initial newline (for cleanup)
+    const totalHeight = frameHeight + 1; // 14
+    // Initial render
+    process.stdout.write('\n');
+    // Animation loop
+    const interval = setInterval(() => {
+        if (!running)
+            return;
+        const frame = WELCOME_ANIMATION.frames[frameIndex];
+        // Move cursor up to overwrite previous frame (always after first render)
+        if (!isFirstRender) {
+            process.stdout.write(`\x1b[${frameHeight}A`);
+        }
+        isFirstRender = false;
+        // Render current frame
+        process.stdout.write(renderFrame(frame, textLines) + '\n\n');
+        // Advance to next frame
+        frameIndex = (frameIndex + 1) % WELCOME_ANIMATION.frames.length;
+    }, WELCOME_ANIMATION.interval);
+    // Wait for Enter
+    await waitForEnter();
+    // Stop animation
+    running = false;
+    clearInterval(interval);
+    // Clear the welcome screen and move on
+    process.stdout.write(`\x1b[${totalHeight}A`);
+    for (let i = 0; i < totalHeight; i++) {
+        process.stdout.write('\x1b[2K\n'); // Clear line
+    }
+    process.stdout.write(`\x1b[${totalHeight}A`); // Move back up
+}
+//# sourceMappingURL=welcome-screen.js.map

package/dist/utils/file-system.d.ts

@@ -22,4 +22,15 @@ export declare class FileSystemUtils {
     static updateFileWithMarkers(filePath: string, content: string, startMarker: string, endMarker: string): Promise<void>;
     static ensureWritePermissions(dirPath: string): Promise<boolean>;
 }
+/**
+ * Removes a marker block from file content.
+ * Only removes markers that are on their own lines (ignores inline mentions).
+ * Cleans up double blank lines that may result from removal.
+ *
+ * @param content - File content with markers
+ * @param startMarker - The start marker string
+ * @param endMarker - The end marker string
+ * @returns Content with marker block removed, or original content if markers not found/invalid
+ */
+export declare function removeMarkerBlock(content: string, startMarker: string, endMarker: string): string;
 //# sourceMappingURL=file-system.d.ts.map

package/dist/utils/file-system.js

@@ -204,9 +204,28 @@ export class FileSystemUtils {
                 }
                 return await this.ensureWritePermissions(parentDir);
             }
-            const testFile = path.join(dirPath, '.openspec-test-' + Date.now());
+            const testFile = path.join(dirPath, '.openspec-test-' + Date.now() + '-' + Math.random().toString(36).slice(2));
             await fs.writeFile(testFile, '');
-            await fs.unlink(testFile);
+            // On Windows, file may be temporarily locked by antivirus or indexing services.
+            // Retry unlink with a small delay if it fails.
+            const maxRetries = 3;
+            for (let attempt = 0; attempt < maxRetries; attempt++) {
+                try {
+                    await fs.unlink(testFile);
+                    break;
+                }
+                catch (unlinkError) {
+                    if (attempt === maxRetries - 1) {
+                        // Last attempt failed, but we successfully wrote the file, so permissions are OK
+                        // Just log and continue - the temp file will be cleaned up eventually
+                        console.debug(`Could not clean up test file ${testFile}: ${unlinkError.message}`);
+                    }
+                    else {
+                        // Wait briefly before retrying (Windows file lock release)
+                        await new Promise((resolve) => setTimeout(resolve, 50));
+                    }
+                }
+            }
             return true;
         }
         catch (error) {
@@ -215,4 +234,48 @@ export class FileSystemUtils {
         }
     }
 }
+/**
+ * Removes a marker block from file content.
+ * Only removes markers that are on their own lines (ignores inline mentions).
+ * Cleans up double blank lines that may result from removal.
+ *
+ * @param content - File content with markers
+ * @param startMarker - The start marker string
+ * @param endMarker - The end marker string
+ * @returns Content with marker block removed, or original content if markers not found/invalid
+ */
+export function removeMarkerBlock(content, startMarker, endMarker) {
+    const startIndex = findMarkerIndex(content, startMarker);
+    const endIndex = startIndex !== -1
+        ? findMarkerIndex(content, endMarker, startIndex + startMarker.length)
+        : findMarkerIndex(content, endMarker);
+    if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
+        return content;
+    }
+    // Find the start of the line containing the start marker
+    let lineStart = startIndex;
+    while (lineStart > 0 && content[lineStart - 1] !== '\n') {
+        lineStart--;
+    }
+    // Find the end of the line containing the end marker
+    let lineEnd = endIndex + endMarker.length;
+    while (lineEnd < content.length && content[lineEnd] !== '\n') {
+        lineEnd++;
+    }
+    // Include the trailing newline if present
+    if (lineEnd < content.length && content[lineEnd] === '\n') {
+        lineEnd++;
+    }
+    const before = content.substring(0, lineStart);
+    const after = content.substring(lineEnd);
+    // Clean up double blank lines (handle both Unix \n and Windows \r\n)
+    let result = before + after;
+    result = result.replace(/(\r?\n){3,}/g, '\n\n');
+    // Trim trailing whitespace but preserve leading whitespace and original newline style
+    if (result.trimEnd() === '') {
+        return '';
+    }
+    const newline = content.includes('\r\n') ? '\r\n' : '\n';
+    return result.trimEnd() + newline;
+}
 //# sourceMappingURL=file-system.js.map

package/dist/utils/index.d.ts

@@ -1,4 +1,5 @@
 export { validateChangeName, createChange } from './change-utils.js';
 export type { ValidationResult, CreateChangeOptions } from './change-utils.js';
 export { readChangeMetadata, writeChangeMetadata, resolveSchemaForChange, validateSchemaName, ChangeMetadataError, } from './change-metadata.js';
+export { FileSystemUtils, removeMarkerBlock } from './file-system.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -2,4 +2,6 @@
 export { validateChangeName, createChange } from './change-utils.js';
 // Change metadata utilities
 export { readChangeMetadata, writeChangeMetadata, resolveSchemaForChange, validateSchemaName, ChangeMetadataError, } from './change-metadata.js';
+// File system utilities
+export { FileSystemUtils, removeMarkerBlock } from './file-system.js';
 //# sourceMappingURL=index.js.map

package/package.json

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

package/dist/commands/artifact-workflow.d.ts

@@ -1,17 +0,0 @@
-/**
- * Artifact Workflow CLI Commands (Experimental)
- *
- * This file contains all artifact workflow commands in isolation for easy removal.
- * Commands expose the ArtifactGraph and InstructionLoader APIs to users and agents.
- *
- * To remove this feature:
- * 1. Delete this file
- * 2. Remove the registerArtifactWorkflowCommands() call from src/cli/index.ts
- */
-import type { Command } from 'commander';
-/**
- * Registers all artifact workflow commands on the given program.
- * All commands are marked as experimental in their help text.
- */
-export declare function registerArtifactWorkflowCommands(program: Command): void;
-//# sourceMappingURL=artifact-workflow.d.ts.map