speckit-assistant 0.1.0

package/bin/app/api/state/watch/route.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dynamic = void 0;
+exports.GET = GET;
+const di_1 = require("../../../../adapters/di");
+const utils_1 = require("../../../../adapters/primary/api/utils");
+const chokidar = __importStar(require("chokidar"));
+const path = __importStar(require("path"));
+exports.dynamic = 'force-dynamic';
+async function GET() {
+    const workspacePath = (0, utils_1.getWorkspacePath)();
+    const encoder = new TextEncoder();
+    const watcher = chokidar.watch([
+        path.join(workspacePath, 'specs'),
+        path.join(workspacePath, '.specify')
+    ], {
+        ignoreInitial: true,
+        persistent: true,
+        depth: 4
+    });
+    const customReadableStream = new ReadableStream({
+        start(controller) {
+            const sendUpdate = async (changedFilePath) => {
+                try {
+                    const state = await di_1.workflowService.getWorkflowState(workspacePath);
+                    const relativePath = changedFilePath
+                        ? path.relative(workspacePath, changedFilePath)
+                        : null;
+                    const payload = {
+                        state,
+                        changedFile: relativePath
+                    };
+                    controller.enqueue(encoder.encode(`event: update\ndata: ${JSON.stringify(payload)}\n\n`));
+                }
+                catch {
+                    // ignore
+                }
+            };
+            // Watch all change events (add, change, unlink)
+            watcher.on('all', (event, filePath) => {
+                // Skip changes inside the internal runtime state directory
+                if (filePath.includes('.runtime') || filePath.includes('.git'))
+                    return;
+                sendUpdate(filePath);
+            });
+        },
+        cancel() {
+            watcher.close();
+        }
+    });
+    return new Response(customReadableStream, {
+        headers: {
+            'Content-Type': 'text/event-stream',
+            'Cache-Control': 'no-cache, no-transform',
+            'Connection': 'keep-alive',
+            'X-Accel-Buffering': 'no',
+        }
+    });
+}

package/bin/app/api/task/route.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POST = POST;
+const server_1 = require("next/server");
+const di_1 = require("../../../adapters/di");
+const utils_1 = require("../../../adapters/primary/api/utils");
+async function POST(req) {
+    try {
+        const { featureName, lineIndex, checked } = await req.json();
+        if (!featureName || lineIndex === undefined || checked === undefined) {
+            return server_1.NextResponse.json({ error: 'Missing parameters' }, { status: 400 });
+        }
+        const workspacePath = (0, utils_1.getWorkspacePath)();
+        const state = await di_1.workflowService.toggleTask(workspacePath, featureName, lineIndex, checked);
+        return server_1.NextResponse.json(state);
+    }
+    catch (err) {
+        return server_1.NextResponse.json({ error: err.message }, { status: 500 });
+    }
+}

package/bin/bin/cli.js

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const open_1 = __importDefault(require("open"));
+const os = __importStar(require("os"));
+const di_1 = require("../adapters/di");
+const args = process.argv.slice(2);
+// Resolve workspace path
+function resolveWorkspace(cmdArgs, projectDir) {
+    const flagIndex = cmdArgs.findIndex(arg => arg === '-w' || arg === '--workspace');
+    if (flagIndex !== -1 && cmdArgs[flagIndex + 1]) {
+        const resolved = path.resolve(cmdArgs[flagIndex + 1]);
+        saveWorkspacePath(projectDir, resolved);
+        return resolved;
+    }
+    for (let i = 0; i < cmdArgs.length; i++) {
+        const arg = cmdArgs[i];
+        if (!arg.startsWith('-')) {
+            const prev = cmdArgs[i - 1];
+            if (prev !== '-p' && prev !== '--port' && prev !== '-w' && prev !== '--workspace' && prev !== '--agent' && prev !== '--prompt') {
+                if (fs.existsSync(arg) && fs.statSync(arg).isDirectory()) {
+                    const resolved = path.resolve(arg);
+                    saveWorkspacePath(projectDir, resolved);
+                    return resolved;
+                }
+            }
+        }
+    }
+    const saved = loadWorkspacePath(projectDir);
+    if (saved) {
+        return saved;
+    }
+    const fallback = process.cwd();
+    saveWorkspacePath(projectDir, fallback);
+    return fallback;
+}
+function loadWorkspacePath(projectDir) {
+    try {
+        const configPath = path.join(os.homedir(), '.speckit-assistant-config.json');
+        if (fs.existsSync(configPath)) {
+            const data = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            return data.lastWorkspacePath || null;
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function saveWorkspacePath(projectDir, resolvedPath) {
+    try {
+        const configPath = path.join(os.homedir(), '.speckit-assistant-config.json');
+        fs.writeFileSync(configPath, JSON.stringify({ lastWorkspacePath: resolvedPath }, null, 2), 'utf-8');
+    }
+    catch {
+        // ignore
+    }
+}
+const appDir = path.resolve(__dirname, '../..');
+const workspacePath = resolveWorkspace(args, appDir);
+process.env.WORKSPACE_PATH = workspacePath;
+const subcommands = ['status', 'approve', 'discard', 'run', 'create', 'delete'];
+const firstArg = args[0];
+// Help menu
+function showHelp() {
+    console.log(`
+🌱 Spec Kit Assistant CLI
+
+Usage:
+  speckit-assistant                   Start the Web UI server
+  speckit-assistant status            Show current SDD workflow status
+  speckit-assistant approve <phase> [feature]   Approve a phase
+  speckit-assistant discard <phase> [feature]   Reset/discard a phase
+  speckit-assistant create <feature>  Create a new feature folder
+  speckit-assistant delete <feature>  Delete a feature folder
+  speckit-assistant run <phase> [feature] [--agent <type>] [--prompt <text>]  Run an agent phase
+
+Options:
+  -w, --workspace <path>              Specify target workspace path (default: current directory)
+  -p, --port <number>                 Specify Web UI server port (default: 18080)
+  --agent <claude|gemini|copilot>     AI agent to use for run command (default: claude)
+  --prompt <text>                     User refinements or prompt additions for the run
+  --help                              Show this help menu
+`);
+}
+if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    process.exit(0);
+}
+// 1. Run Subcommands
+if (firstArg && subcommands.includes(firstArg)) {
+    handleSubcommand(firstArg, args.slice(1));
+}
+else {
+    // 2. Start Web Server
+    startWebServer();
+}
+// --- Web Server Launcher ---
+function startWebServer() {
+    const portFlagIndex = args.findIndex(arg => arg === '-p' || arg === '--port');
+    const port = portFlagIndex !== -1 && args[portFlagIndex + 1] ? args[portFlagIndex + 1] : '18080';
+    console.log(`\n🌱 Spec Kit Assistant Web Server`);
+    console.log(`📂 Workspace: ${workspacePath}`);
+    console.log(`🔌 Starting server on port ${port}...\n`);
+    // Server files are compiled in the same parent directory
+    const appDir = path.resolve(__dirname, '../..');
+    const nextBin = path.join(appDir, 'node_modules', 'next', 'dist', 'bin', 'next');
+    if (!fs.existsSync(nextBin)) {
+        console.error(`Error: next binary not found at ${nextBin}`);
+        console.error(`Please make sure you ran 'pnpm install' in ${appDir}`);
+        process.exit(1);
+    }
+    const child = (0, child_process_1.spawn)(process.execPath, [nextBin, 'start', '-p', port], {
+        cwd: appDir,
+        stdio: 'inherit',
+        env: {
+            ...process.env,
+            WORKSPACE_PATH: workspacePath
+        }
+    });
+    setTimeout(() => {
+        const url = `http://localhost:${port}`;
+        console.log(`\n🚀 Speckit Assistant available at: ${url}`);
+        (0, open_1.default)(url).catch(() => { });
+    }, 2500);
+    child.on('exit', (code) => {
+        process.exit(code || 0);
+    });
+    process.on('SIGINT', () => {
+        child.kill('SIGINT');
+        process.exit(0);
+    });
+}
+// --- CLI Subcommand Handlers ---
+async function handleSubcommand(command, cmdArgs) {
+    try {
+        switch (command) {
+            case 'status':
+                await printStatus();
+                break;
+            case 'approve':
+                await approvePhase(cmdArgs);
+                break;
+            case 'discard':
+                await discardPhase(cmdArgs);
+                break;
+            case 'create':
+                await createFeature(cmdArgs);
+                break;
+            case 'delete':
+                await deleteFeature(cmdArgs);
+                break;
+            case 'run':
+                await runPhase(cmdArgs);
+                break;
+        }
+        process.exit(0);
+    }
+    catch (err) {
+        console.error(`\n❌ Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+async function printStatus() {
+    const state = await di_1.workflowService.getWorkflowState(workspacePath);
+    console.log(`\n🌱 SDD WORKFLOW STATUS`);
+    console.log(`📂 Workspace: ${workspacePath}`);
+    console.log(`----------------------------------------------------------------------`);
+    // Constitution status
+    console.log(`📜 Constitution: [${state.constitutionPhase.status.toUpperCase()}] ${state.constitutionPhase.stale ? '(STALE)' : ''}`);
+    console.log(`   File: ${state.constitutionPhase.filePath || 'Not created'}`);
+    console.log(`----------------------------------------------------------------------`);
+    // Features status
+    if (state.features.length === 0) {
+        console.log(`(No features found in specs/ directory)`);
+        return;
+    }
+    state.features.forEach(feat => {
+        console.log(`\n🔹 Feature: "${feat.name}"`);
+        feat.phases.forEach(p => {
+            let progressStr = '';
+            if (p.phase === 'tasks' && p.content) {
+                const checkboxes = [...p.content.matchAll(/^\s*(?:[-*]|\d+\.)\s+\[( |x|X)\]/gm)];
+                if (checkboxes.length > 0) {
+                    const done = checkboxes.filter(c => c[1].toLowerCase() === 'x').length;
+                    progressStr = ` (${done}/${checkboxes.length} tasks)`;
+                }
+            }
+            const statusLabel = p.status.toUpperCase();
+            const staleLabel = p.stale ? ' (STALE)' : '';
+            console.log(`   - [${p.phase.padEnd(14)}]: ${statusLabel}${staleLabel}${progressStr}`);
+        });
+    });
+    console.log();
+}
+async function approvePhase(cmdArgs) {
+    const phase = cmdArgs[0];
+    if (!phase)
+        throw new Error('Missing phase argument. Usage: approve <phase> [feature]');
+    let feature = null;
+    if (phase !== 'constitution') {
+        feature = cmdArgs[1] || null;
+        if (!feature) {
+            const state = await di_1.workflowService.getWorkflowState(workspacePath);
+            feature = state.activeFeatureName;
+            if (!feature)
+                throw new Error('No active feature. Please specify feature name.');
+        }
+    }
+    console.log(`Approving phase "${phase}"${feature ? ` for feature "${feature}"` : ''}...`);
+    await di_1.workflowService.approvePhase(workspacePath, phase, feature);
+    console.log('✅ Approved successfully!');
+}
+async function discardPhase(cmdArgs) {
+    const phase = cmdArgs[0];
+    if (!phase)
+        throw new Error('Missing phase argument. Usage: discard <phase> [feature]');
+    let feature = null;
+    if (phase !== 'constitution') {
+        feature = cmdArgs[1] || null;
+        if (!feature) {
+            const state = await di_1.workflowService.getWorkflowState(workspacePath);
+            feature = state.activeFeatureName;
+            if (!feature)
+                throw new Error('No active feature. Please specify feature name.');
+        }
+    }
+    console.log(`Discarding/resetting phase "${phase}"${feature ? ` for feature "${feature}"` : ''}...`);
+    await di_1.workflowService.discardPhase(workspacePath, phase, feature);
+    console.log('✅ Discarded/reset successfully!');
+}
+async function createFeature(cmdArgs) {
+    const name = cmdArgs[0];
+    if (!name)
+        throw new Error('Missing feature name. Usage: create <feature-name>');
+    console.log(`Creating feature "${name}"...`);
+    await di_1.workflowService.createFeature(workspacePath, name);
+    console.log('✅ Feature folder created!');
+}
+async function deleteFeature(cmdArgs) {
+    const name = cmdArgs[0];
+    if (!name)
+        throw new Error('Missing feature name. Usage: delete <feature-name>');
+    console.log(`Deleting feature "${name}"...`);
+    await di_1.workflowService.deleteFeature(workspacePath, name);
+    console.log('✅ Feature folder deleted!');
+}
+async function runPhase(cmdArgs) {
+    const phase = cmdArgs[0];
+    if (!phase)
+        throw new Error('Missing phase argument. Usage: run <phase> [feature] [options]');
+    let feature = null;
+    let nextArgIndex = 1;
+    if (phase !== 'constitution') {
+        if (cmdArgs[1] && !cmdArgs[1].startsWith('--')) {
+            feature = cmdArgs[1];
+            nextArgIndex = 2;
+        }
+        else {
+            const state = await di_1.workflowService.getWorkflowState(workspacePath);
+            feature = state.activeFeatureName;
+            if (!feature)
+                throw new Error('No active feature. Please specify feature name.');
+        }
+    }
+    // Parse options
+    const optArgs = cmdArgs.slice(nextArgIndex);
+    const agentFlagIndex = optArgs.findIndex(arg => arg === '--agent');
+    const agentType = agentFlagIndex !== -1 && optArgs[agentFlagIndex + 1] ? optArgs[agentFlagIndex + 1] : 'claude';
+    const promptFlagIndex = optArgs.findIndex(arg => arg === '--prompt');
+    const promptText = promptFlagIndex !== -1 && optArgs[promptFlagIndex + 1] ? optArgs[promptFlagIndex + 1] : undefined;
+    const agentConfig = { agentType };
+    console.log(`Running phase "${phase}"${feature ? ` for feature "${feature}"` : ''} using agent "${agentType}"...\n`);
+    await di_1.workflowService.runPhase(workspacePath, phase, feature, agentConfig, promptText, (logData) => {
+        process.stdout.write(logData);
+    });
+    console.log('\n🏁 Phase run completed!');
+}

package/bin/cli.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const open_1 = __importDefault(require("open"));
+const args = process.argv.slice(2);
+// Resolve port
+const portFlagIndex = args.findIndex(arg => arg === '-p' || arg === '--port');
+const port = portFlagIndex !== -1 && args[portFlagIndex + 1] ? args[portFlagIndex + 1] : '18080';
+// Resolve workspace path
+let workspacePath = process.cwd();
+if (args.length > 0) {
+    const lastArg = args[args.length - 1];
+    if (!lastArg.startsWith('-') && lastArg !== port) {
+        workspacePath = lastArg;
+    }
+}
+const resolvedWorkspace = path.resolve(workspacePath);
+process.env.WORKSPACE_PATH = resolvedWorkspace;
+console.log(`\n🌱 Spec Kit Assistant`);
+console.log(`📂 Target Workspace: ${resolvedWorkspace}`);
+console.log(`🔌 Starting server on port ${port}...\n`);
+// The binary runs from the speckit-assistant directory
+const appDir = path.resolve(__dirname, '..');
+const nextBin = path.join(appDir, 'node_modules', 'next', 'dist', 'bin', 'next');
+const child = (0, child_process_1.spawn)(process.execPath, [nextBin, 'start', '-p', port], {
+    cwd: appDir,
+    stdio: 'inherit',
+    env: {
+        ...process.env,
+        WORKSPACE_PATH: resolvedWorkspace
+    }
+});
+// Auto-open browser after the server has warmed up
+setTimeout(() => {
+    const url = `http://localhost:${port}`;
+    console.log(`\n🚀 Speckit Assistant available at: ${url}`);
+    (0, open_1.default)(url).catch(() => {
+        // ignore opening failures
+    });
+}, 2500);
+child.on('exit', (code) => {
+    process.exit(code || 0);
+});
+process.on('SIGINT', () => {
+    child.kill('SIGINT');
+    process.exit(0);
+});

package/bin/domain/models/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/domain/ports/in/WorkflowUseCases.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/domain/ports/out/AgentRunnerPort.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/domain/ports/out/WorkspaceRepositoryPort.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });