specsmd 0.0.0-dev.9 → 0.0.0-dev.90

package/lib/installer.js

@@ -4,7 +4,7 @@ const prompts = require('prompts');
 const yaml = require('js-yaml');
 const CLIUtils = require('./cli-utils');
 const InstallerFactory = require('./InstallerFactory');
-const { FLOWS } = require('./constants');
+const { FLOWS, LINKS } = require('./constants');
 const analytics = require('./analytics');
 
 // Use theme from CLIUtils for consistent styling
@@ -125,6 +125,7 @@ async function install() {
   // Step 3: Select Flow
   console.log('');
   CLIUtils.displayStep(3, 4, 'Select SDLC flow');
+  console.log(theme.dim(`  Learn more about flows: ${LINKS.flows}\n`));
   const flowChoices = Object.entries(FLOWS).map(([key, flow]) => ({
     title: `${flow.name} - ${flow.description}${flow.message || ''}`,
     value: key,
@@ -171,6 +172,20 @@ async function install() {
       `Open ${selectedToolNames.join(' or ')} and run /specsmd-master-agent`
     ];
     CLIUtils.displayNextSteps(nextSteps);
+
+    // Display IDE extension info with brand colors
+    console.log('\n' + theme.primary('─'.repeat(72)));
+    console.log(CLIUtils.logoGradient('  ★ IDE Extension'));
+    console.log(theme.primary('─'.repeat(72)));
+    console.log('');
+    console.log('  ' + CLIUtils.logoGradient('Enhance your experience with the specsmd IDE extension!'));
+    console.log('');
+    console.log(`  ${theme.primary('Learn more:')}                ${LINKS.ideExtension}`);
+    console.log(`  ${theme.primary('VS Code:')}                   ${LINKS.vscodeMarketplace}`);
+    console.log(`  ${theme.primary('Cursor/Antigravity/Windsurf:')} ${LINKS.openVsx}`);
+    console.log('');
+    console.log(theme.primary('─'.repeat(72)) + '\n');
+    console.log('');
   } catch (error) {
     // Track installation failure
     const errorCategory = categorizeError(error);
@@ -229,6 +244,9 @@ async function installFlow(flowKey, toolKeys) {
   if (await fs.pathExists(path.join(flowPath, 'shared'))) {
     await fs.copy(path.join(flowPath, 'shared'), path.join(targetFlowDir, 'shared'));
   }
+  if (await fs.pathExists(path.join(flowPath, 'scripts'))) {
+    await fs.copy(path.join(flowPath, 'scripts'), path.join(targetFlowDir, 'scripts'));
+  }
 
   // Copy config files
   if (await fs.pathExists(path.join(flowPath, 'memory-bank.yaml'))) {
@@ -250,20 +268,6 @@ async function installFlow(flowKey, toolKeys) {
 
   CLIUtils.displayStatus('', 'Installed flow resources', 'success');
 
-  // Step 2.5: Install local scripts for deterministic operations
-  // These scripts are version-matched to the installed specsmd version
-  const scriptsDir = path.join(specsmdDir, 'scripts');
-  await fs.ensureDir(scriptsDir);
-
-  const sourceScriptsDir = path.join(__dirname, '..', 'scripts');
-  if (await fs.pathExists(sourceScriptsDir)) {
-    await fs.copy(sourceScriptsDir, scriptsDir);
-    CLIUtils.displayStatus('', 'Installed local scripts', 'success');
-  }
-
-  // Note: Scripts are invoked directly via relative path (e.g., node .specsmd/scripts/bolt-complete.js)
-  // No npm scripts added to package.json to avoid dependency on package.json for execution
-
   // NOTE: memory-bank/ is NOT created during installation
   // It will be created when user runs project-init
   // This allows us to detect if project is initialized by checking for memory-bank/standards/

package/lib/installers/CodexInstaller.js

@@ -1,4 +1,8 @@
 const ToolInstaller = require('./ToolInstaller');
+const fs = require('fs-extra');
+const path = require('path');
+const CLIUtils = require('../cli-utils');
+const { theme } = CLIUtils;
 
 class CodexInstaller extends ToolInstaller {
     get key() {
@@ -10,12 +14,79 @@ class CodexInstaller extends ToolInstaller {
     }
 
     get commandsDir() {
-        return '.codex';
+        return path.join('.codex', 'skills');
     }
 
     get detectPath() {
         return '.codex';
     }
+
+    async installCommands(flowPath, config) {
+        const targetSkillsDir = this.commandsDir;
+        console.log(theme.dim(`  Installing skills to ${targetSkillsDir}/...`));
+        await fs.ensureDir(targetSkillsDir);
+
+        const commandsSourceDir = path.join(flowPath, 'commands');
+        if (!await fs.pathExists(commandsSourceDir)) {
+            console.log(theme.warning(`  No commands folder found at ${commandsSourceDir}`));
+            return [];
+        }
+
+        const commandFiles = await fs.readdir(commandsSourceDir);
+        const installedFiles = [];
+
+        for (const cmdFile of commandFiles) {
+            if (!cmdFile.endsWith('.md')) continue;
+
+            try {
+                const sourcePath = path.join(commandsSourceDir, cmdFile);
+                const content = await fs.readFile(sourcePath, 'utf8');
+                const commandName = cmdFile.replace('.md', '');
+                const prefix = (config && config.command && config.command.prefix) ? `${config.command.prefix}-` : '';
+                const skillName = `specsmd-${prefix}${commandName}`;
+
+                const { description, body } = this.parseFrontmatter(content);
+
+                // Build SKILL.md with Codex frontmatter
+                const skillContent = [
+                    '---',
+                    `name: ${skillName}`,
+                    `description: "${description || 'specsmd agent'}"`,
+                    '---',
+                    '',
+                    body
+                ].join('\n');
+
+                // Write SKILL.md
+                const skillDir = path.join(targetSkillsDir, skillName);
+                await fs.ensureDir(skillDir);
+                await fs.writeFile(path.join(skillDir, 'SKILL.md'), skillContent, 'utf8');
+
+                installedFiles.push(skillName);
+            } catch (err) {
+                console.log(theme.warning(`  Failed to install ${cmdFile}: ${err.message}`));
+            }
+        }
+
+        CLIUtils.displayStatus('', `Installed ${installedFiles.length} skills for ${this.name}`, 'success');
+        return installedFiles;
+    }
+
+    /**
+     * Parse YAML frontmatter from a markdown file
+     */
+    parseFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+        if (!match) return { description: '', body: content };
+
+        const frontmatter = match[1];
+        const body = match[2];
+        const descMatch = frontmatter.match(/description:\s*["']?(.+?)["']?\s*$/m);
+        return {
+            description: descMatch ? descMatch[1] : '',
+            body: body.trim()
+        };
+    }
 }
 
 module.exports = CodexInstaller;

package/lib/installers/KiroInstaller.js

@@ -1,5 +1,8 @@
 const ToolInstaller = require('./ToolInstaller');
 const path = require('path');
+const fs = require('fs-extra');
+const CLIUtils = require('../cli-utils');
+const { theme } = CLIUtils;
 
 class KiroInstaller extends ToolInstaller {
     get key() {
@@ -17,6 +20,58 @@ class KiroInstaller extends ToolInstaller {
     get detectPath() {
         return '.kiro';
     }
+
+    /**
+     * Override to install commands and create specs symlink for simple flow
+     */
+    async installCommands(flowPath, config) {
+        // Install commands (default behavior)
+        const installedCommands = await super.installCommands(flowPath, config);
+
+        // For simple flow, create symlink to make specs visible in Kiro
+        if (flowPath.includes('simple')) {
+            await this.createSpecsSymlink();
+        }
+
+        return installedCommands;
+    }
+
+    /**
+     * Create symlink from .kiro/specs to specs/ for Kiro specifications compatibility
+     */
+    async createSpecsSymlink() {
+        const kiroSpecsPath = path.join('.kiro', 'specs');
+        const specsPath = 'specs';
+
+        // Check if .kiro/specs already exists
+        if (await fs.pathExists(kiroSpecsPath)) {
+            const stats = await fs.lstat(kiroSpecsPath);
+            if (stats.isSymbolicLink()) {
+                console.log(theme.dim(`  .kiro/specs symlink already exists, skipping`));
+            } else {
+                console.log(theme.dim(`  .kiro/specs already exists as folder, skipping symlink`));
+            }
+            return;
+        }
+
+        // Ensure specs folder exists
+        await fs.ensureDir(specsPath);
+
+        try {
+            // Create relative symlink from .kiro/specs -> ../specs
+            await fs.ensureSymlink(path.join('..', specsPath), kiroSpecsPath);
+            CLIUtils.displayStatus('', 'Created .kiro/specs symlink for Kiro compatibility', 'success');
+        } catch (err) {
+            // Handle specific error cases
+            if (err.code === 'EPERM' || err.code === 'EACCES') {
+                console.log(theme.warning(`  Cannot create symlink (permission denied). On Windows, try running as Administrator.`));
+            } else if (err.code === 'EEXIST') {
+                console.log(theme.dim(`  .kiro/specs already exists, skipping symlink`));
+            } else {
+                console.log(theme.warning(`  Failed to create specs symlink: ${err.message}`));
+            }
+        }
+    }
 }
 
 module.exports = KiroInstaller;

package/lib/installers/OpenCodeInstaller.js

@@ -11,12 +11,20 @@ class OpenCodeInstaller extends ToolInstaller {
     }
 
     get commandsDir() {
-        return path.join('.opencode', 'agent');
+        return path.join('.opencode', 'command');
     }
 
     get detectPath() {
         return '.opencode';
     }
+
+    /**
+     * OpenCode requires 'agent: build' in command frontmatter.
+     * This inserts the line before the closing '---' of existing frontmatter.
+     */
+    transformContent(content) {
+        return content.replace(/^(---\n[\s\S]*?)(---)/, '$1agent: build\n$2');
+    }
 }
 
 module.exports = OpenCodeInstaller;

package/lib/installers/ToolInstaller.js

@@ -56,7 +56,10 @@ class ToolInstaller {
                     const targetFileName = `specsmd-${prefix}${cmdFile}`;
                     const targetPath = path.join(targetCommandsDir, targetFileName);
 
-                    const content = await fs.readFile(sourcePath, 'utf8');
+                    let content = await fs.readFile(sourcePath, 'utf8');
+                    if (this.transformContent) {
+                        content = this.transformContent(content);
+                    }
                     await fs.outputFile(targetPath, content, 'utf8');
                     installedFiles.push(targetFileName);
                 } catch (err) {

package/lib/installers/WindsurfInstaller.js

@@ -1,8 +1,5 @@
 const ToolInstaller = require('./ToolInstaller');
-const fs = require('fs-extra');
 const path = require('path');
-const CLIUtils = require('../cli-utils');
-const { theme } = CLIUtils;
 
 class WindsurfInstaller extends ToolInstaller {
     get key() {
@@ -20,57 +17,6 @@ class WindsurfInstaller extends ToolInstaller {
     get detectPath() {
         return '.windsurf';
     }
-
-    /**
-     * Override to add frontmatter for Windsurf workflows
-     */
-    async installCommands(flowPath, config) {
-        const targetCommandsDir = this.commandsDir;
-        console.log(theme.dim(`  Installing workflows to ${targetCommandsDir}/...`));
-        await fs.ensureDir(targetCommandsDir);
-
-        const commandsSourceDir = path.join(flowPath, 'commands');
-
-        if (!await fs.pathExists(commandsSourceDir)) {
-            console.log(theme.warning(`  No commands folder found at ${commandsSourceDir}`));
-            return [];
-        }
-
-        const commandFiles = await fs.readdir(commandsSourceDir);
-        const installedFiles = [];
-
-        for (const cmdFile of commandFiles) {
-            if (cmdFile.endsWith('.md')) {
-                const sourcePath = path.join(commandsSourceDir, cmdFile);
-                const prefix = (config && config.command && config.command.prefix) ? `${config.command.prefix}-` : '';
-
-                const targetFileName = `specsmd-${prefix}${cmdFile}`;
-                const targetPath = path.join(targetCommandsDir, targetFileName);
-
-                // Extract agent name from target filename (e.g., "specsmd-master-agent.md" -> "specsmd-master-agent")
-                const agentName = targetFileName.replace(/\.md$/, '');
-
-                // Read source content and add Windsurf frontmatter
-                let content = await fs.readFile(sourcePath, 'utf8');
-
-                // Add Windsurf-specific frontmatter if not present
-                if (!content.startsWith('---')) {
-                    const frontmatter = `---
-description: ${agentName}
----
-
-`;
-                    content = frontmatter + content;
-                }
-
-                await fs.writeFile(targetPath, content);
-                installedFiles.push(targetFileName);
-            }
-        }
-
-        CLIUtils.displayStatus('', `Installed ${installedFiles.length} workflows for ${this.name}`, 'success');
-        return installedFiles;
-    }
 }
 
 module.exports = WindsurfInstaller;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.0.0-dev.9",
+  "version": "0.0.0-dev.90",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {
@@ -12,7 +12,10 @@
     "test:schema": "vitest run __tests__/unit/schema-validation/",
     "lint:md": "markdownlint 'flows/**/*.md' --config ../.markdownlint.yaml",
     "lint:md:fix": "markdownlint 'flows/**/*.md' --config ../.markdownlint.yaml --fix",
-    "validate:all": "npm run test && npm run lint:md"
+    "sync:webview-bundle": "node scripts/sync-webview-bundle.cjs",
+    "check:webview-bundle": "node scripts/check-webview-bundle-sync.cjs",
+    "prepack": "npm run check:webview-bundle",
+    "validate:all": "npm run test && npm run lint:md && npm run check:webview-bundle"
   },
   "keywords": [
     "ai-dlc",
@@ -40,79 +43,36 @@
     "README.md"
   ],
   "dependencies": {
+    "@inkjs/ui": "^2.0.0",
     "chalk": "^4.1.2",
+    "chokidar": "^4.0.3",
     "commander": "^11.1.0",
     "figlet": "^1.9.4",
     "fs-extra": "^11.1.1",
     "gradient-string": "^2.0.2",
+    "ink": "^5.2.1",
     "js-yaml": "^4.1.0",
     "mixpanel": "^0.18.0",
     "oh-my-logo": "^0.4.0",
-    "prompts": "^2.4.2"
+    "prompts": "^2.4.2",
+    "react": "^18.3.1",
+    "slice-ansi": "^4.0.0",
+    "string-width": "^4.2.3"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=20.0.0"
   },
   "devDependencies": {
-    "@semantic-release/git": "^10.0.1",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.10.2",
     "glob": "^13.0.0",
     "markdownlint": "^0.40.0",
     "markdownlint-cli": "^0.46.0",
     "remark-parse": "^11.0.0",
-    "semantic-release": "^24.2.0",
     "typescript": "^5.9.3",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
-    "vitest": "^4.0.15"
-  },
-  "release": {
-    "branches": [
-      "main"
-    ],
-    "plugins": [
-      [
-        "@semantic-release/commit-analyzer",
-        {
-          "releaseRules": [
-            {
-              "breaking": true,
-              "release": "minor"
-            },
-            {
-              "type": "feat",
-              "release": "minor"
-            },
-            {
-              "type": "fix",
-              "release": "patch"
-            },
-            {
-              "type": "perf",
-              "release": "patch"
-            }
-          ]
-        }
-      ],
-      "@semantic-release/release-notes-generator",
-      "@semantic-release/npm",
-      [
-        "@semantic-release/github",
-        {
-          "successComment": false,
-          "failComment": false
-        }
-      ],
-      [
-        "@semantic-release/git",
-        {
-          "assets": [
-            "package.json"
-          ],
-          "message": "chore(release): ${nextRelease.version} [skip ci]"
-        }
-      ]
-    ]
+    "vitest": "^4.0.15",
+    "yaml": "^2.8.2"
   }
 }

package/scripts/check-webview-bundle-sync.cjs

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const crypto = require('crypto');
+
+const packageRoot = path.resolve(__dirname, '..');
+const repoRoot = path.resolve(packageRoot, '..');
+const extensionBundle = path.join(repoRoot, 'vs-code-extension', 'dist', 'webview', 'bundle.js');
+const packagedBundle = path.join(packageRoot, 'lib', 'dashboard', 'web', 'public', 'webview-bundle.js');
+
+function hashFile(filePath) {
+  return crypto.createHash('sha256').update(fs.readFileSync(filePath)).digest('hex');
+}
+
+if (!fs.existsSync(extensionBundle)) {
+  console.error(`Missing VS Code webview bundle: ${extensionBundle}`);
+  console.error('Run `npm run compile:webview` in vs-code-extension first.');
+  process.exit(1);
+}
+
+if (!fs.existsSync(packagedBundle)) {
+  console.error(`Missing packaged dashboard web bundle: ${packagedBundle}`);
+  process.exit(1);
+}
+
+const extensionHash = hashFile(extensionBundle);
+const packagedHash = hashFile(packagedBundle);
+
+if (extensionHash !== packagedHash) {
+  console.error('Dashboard web bundle is out of sync with the VS Code webview bundle.');
+  console.error(`extension: ${extensionHash}`);
+  console.error(`packaged:  ${packagedHash}`);
+  console.error('Run `npm run sync:webview-bundle` from src/.');
+  process.exit(1);
+}
+
+console.log('Dashboard web bundle is synced with the VS Code webview bundle.');

package/scripts/sync-webview-bundle.cjs

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const packageRoot = path.resolve(__dirname, '..');
+const repoRoot = path.resolve(packageRoot, '..');
+const extensionBundle = path.join(repoRoot, 'vs-code-extension', 'dist', 'webview', 'bundle.js');
+const packagedBundle = path.join(packageRoot, 'lib', 'dashboard', 'web', 'public', 'webview-bundle.js');
+
+if (!fs.existsSync(extensionBundle)) {
+  console.error(`Missing VS Code webview bundle: ${extensionBundle}`);
+  console.error('Run `npm run compile:webview` in vs-code-extension first.');
+  process.exit(1);
+}
+
+fs.mkdirSync(path.dirname(packagedBundle), { recursive: true });
+fs.copyFileSync(extensionBundle, packagedBundle);
+console.log(`Synced ${path.relative(repoRoot, packagedBundle)} from ${path.relative(repoRoot, extensionBundle)}.`);