@kynetic-ai/spec 0.1.2 → 0.3.0

package/dist/cli/commands/serve.js

@@ -0,0 +1,491 @@
+/**
+ * kspec serve commands - daemon server lifecycle management
+ * AC: @cli-serve-commands
+ */
+import { spawn, execSync } from 'child_process';
+import { existsSync, readdirSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { error, info, output, success, warn, isJsonMode } from '../output.js';
+import { EXIT_CODES } from '../exit-codes.js';
+import { PidFileManager } from '../pid-utils.js';
+import { loadProjectConfig } from '../../parser/config.js';
+/**
+ * Check if Bun runtime is available.
+ * Daemon requires Bun to run TypeScript directly.
+ */
+function isBunAvailable() {
+    try {
+        execSync('bun --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Check if daemon dist files are stale (source newer than dist)
+ * Returns true if rebuild is recommended
+ */
+function checkDaemonStaleness() {
+    // __dirname is dist/cli/commands, go up 3 levels to package root, then into packages/daemon/src
+    const sourceDir = join(__dirname, '../../../packages/daemon/src');
+    // dist/daemon is 2 levels up from __dirname
+    const distDir = join(__dirname, '../../daemon');
+    if (!existsSync(sourceDir) || !existsSync(distDir))
+        return false;
+    try {
+        const getNewestMtime = (dir) => {
+            const files = readdirSync(dir, { withFileTypes: true });
+            let newest = 0;
+            for (const f of files) {
+                const fullPath = join(dir, f.name);
+                if (f.isDirectory()) {
+                    newest = Math.max(newest, getNewestMtime(fullPath));
+                }
+                else if (f.name.endsWith('.ts')) {
+                    newest = Math.max(newest, statSync(fullPath).mtimeMs);
+                }
+            }
+            return newest;
+        };
+        const newestSource = getNewestMtime(sourceDir);
+        const newestDist = getNewestMtime(distDir);
+        return newestSource > newestDist;
+    }
+    catch {
+        return false; // Don't warn if check fails
+    }
+}
+/**
+ * Register serve commands
+ */
+export function registerServeCommands(program) {
+    const serve = program
+        .command('serve')
+        .description('Manage the kspec daemon server');
+    // AC: @cli-serve-commands ac-1, ac-2, ac-3
+    // AC: @config-daemon ac-1, ac-2 — port from config, CLI flag overrides
+    serve
+        .command('start', { isDefault: true })
+        .description('Start the daemon server')
+        .option('-d, --daemon', 'Run in background (detached mode)')
+        .option('-p, --port <port>', 'Server port (uses config daemon.port if not specified)')
+        .option('--kspec-dir <dir>', 'Path to .kspec directory', join(process.cwd(), '.kspec'))
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            await startServer(opts);
+        }
+        catch (err) {
+            if (isJsonMode()) {
+                output({ error: err instanceof Error ? err.message : String(err) });
+            }
+            else {
+                error(`Failed to start server: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+    // AC: @cli-serve-commands ac-4, ac-5
+    serve
+        .command('stop')
+        .description('Stop the daemon server')
+        .option('--kspec-dir <dir>', 'Path to .kspec directory', join(process.cwd(), '.kspec'))
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            await stopServer(opts);
+        }
+        catch (err) {
+            if (isJsonMode()) {
+                output({ error: err instanceof Error ? err.message : String(err) });
+            }
+            else {
+                error(`Failed to stop server: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+    // AC: @cli-serve-commands ac-6
+    serve
+        .command('status')
+        .description('Check daemon server status')
+        .option('--kspec-dir <dir>', 'Path to .kspec directory', join(process.cwd(), '.kspec'))
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            await statusServer(opts);
+        }
+        catch (err) {
+            if (isJsonMode()) {
+                output({ error: err instanceof Error ? err.message : String(err) });
+            }
+            else {
+                error(`Failed to check status: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+    // AC: @cli-serve-commands ac-7
+    serve
+        .command('restart')
+        .description('Restart the daemon server')
+        .option('--kspec-dir <dir>', 'Path to .kspec directory', join(process.cwd(), '.kspec'))
+        .option('--json', 'Output as JSON')
+        .action(async (opts) => {
+        try {
+            await restartServer(opts);
+        }
+        catch (err) {
+            if (isJsonMode()) {
+                output({ error: err instanceof Error ? err.message : String(err) });
+            }
+            else {
+                error(`Failed to restart server: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            process.exit(EXIT_CODES.ERROR);
+        }
+    });
+}
+/**
+ * Start the daemon server
+ * AC: @cli-serve-commands ac-1 (foreground), ac-2 (daemon), ac-3 (port), ac-10 (port error)
+ * AC: @config-daemon ac-1 — port from config, ac-2 — CLI flag overrides config
+ */
+async function startServer(opts) {
+    const jsonMode = isJsonMode();
+    // AC: @config-daemon ac-1, ac-2 — load config for default port, CLI flag overrides
+    const { config } = await loadProjectConfig();
+    const configPort = config.daemon.port;
+    // AC: @config-daemon ac-2 — CLI flag takes precedence over config
+    const port = opts.port ? parseInt(opts.port, 10) : configPort;
+    // AC: @cli-serve-commands ac-10
+    if (isNaN(port) || port < 1 || port > 65535) {
+        if (jsonMode) {
+            output({
+                error: 'Invalid port number. Must be between 1 and 65535.',
+                hint: 'Try: kspec serve --port <PORT>',
+            });
+        }
+        else {
+            error('Invalid port number. Must be between 1 and 65535.');
+            error('Try: kspec serve --port <PORT>');
+        }
+        process.exit(EXIT_CODES.VALIDATION_FAILED);
+    }
+    const pidManager = new PidFileManager();
+    // Check if already running
+    if (pidManager.isDaemonRunning()) {
+        const pid = pidManager.readPid();
+        const existingPort = pidManager.readPort();
+        if (isJsonMode()) {
+            output({ running: true, pid, port: existingPort, message: 'Daemon already running' });
+        }
+        else {
+            warn(`Daemon already running on port ${existingPort}`);
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    // Get path to daemon entry point
+    // Daemon source is bundled at dist/daemon/index.ts (relative to package root)
+    // __dirname is dist/cli/commands, so go up 2 levels to dist/, then into daemon/
+    // Note: Daemon is TypeScript source - requires Bun runtime
+    const daemonBinary = join(__dirname, '../../daemon/index.ts');
+    if (!existsSync(daemonBinary)) {
+        if (isJsonMode()) {
+            output({ error: `Daemon binary not found at ${daemonBinary}`, hint: 'Ensure the kspec package is properly installed' });
+        }
+        else {
+            error(`Daemon binary not found at: ${daemonBinary}`);
+            error('Ensure the kspec package is properly installed');
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Daemon requires Bun to run TypeScript directly
+    if (!isBunAvailable()) {
+        if (isJsonMode()) {
+            output({ error: 'Bun runtime not found', hint: 'Install Bun: https://bun.sh/docs/installation' });
+        }
+        else {
+            error('Bun runtime is required for the daemon server');
+            error('Install Bun: https://bun.sh/docs/installation');
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // Check for stale daemon build (dev experience improvement)
+    if (checkDaemonStaleness() && !jsonMode) {
+        warn('Warning: dist/daemon/ may be stale (source files are newer).');
+        warn('  Run "npm run build:daemon" to update.');
+    }
+    // AC: @cli-serve-commands ac-2 - background mode
+    if (opts.daemon) {
+        const runtime = 'bun';
+        // Spawn detached process
+        // Set BUN_ENV=production to prevent Bun dev mode HTML transformation
+        // which can cause asset hash mismatches in the web UI
+        const child = spawn(runtime, [daemonBinary, '--port', String(port), '--kspec-dir', opts.kspecDir], {
+            detached: true,
+            stdio: 'ignore', // TODO: redirect to log file when logging implemented
+            cwd: process.cwd(),
+            env: { ...process.env, BUN_ENV: 'production' },
+        });
+        // Detach from parent
+        child.unref();
+        // Poll for PID file with timeout (max 5 seconds)
+        const maxWait = 5000;
+        const startTime = Date.now();
+        let pid = null;
+        while (Date.now() - startTime < maxWait) {
+            pid = pidManager.readPid();
+            if (pid && pidManager.isDaemonRunning()) {
+                break;
+            }
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        if (pid && pidManager.isDaemonRunning()) {
+            if (isJsonMode()) {
+                output({ running: true, pid, port });
+            }
+            else {
+                success(`Daemon started with PID ${pid} on port ${port}`);
+                output({ running: true, pid, port });
+            }
+        }
+        else {
+            if (isJsonMode()) {
+                output({ error: 'Daemon failed to start within 5 seconds' });
+            }
+            else {
+                error('Daemon failed to start within 5 seconds');
+            }
+            process.exit(EXIT_CODES.ERROR);
+        }
+    }
+    else {
+        // AC: @cli-serve-commands ac-1 - foreground mode
+        if (!isJsonMode()) {
+            info(`Starting server in foreground on port ${port}...`);
+            info('Press Ctrl+C to stop');
+        }
+        const runtime = 'bun';
+        // Set BUN_ENV=production to prevent Bun dev mode HTML transformation
+        const child = spawn(runtime, [daemonBinary, '--port', String(port), '--kspec-dir', opts.kspecDir], {
+            stdio: 'inherit',
+            cwd: process.cwd(),
+            env: { ...process.env, BUN_ENV: 'production' },
+        });
+        // Handle Ctrl+C - forward SIGTERM to child for graceful shutdown
+        process.on('SIGINT', () => {
+            if (!isJsonMode()) {
+                info('\nStopping server...');
+            }
+            child.kill('SIGTERM');
+            // Wait for graceful shutdown (max 5 seconds)
+            const shutdownTimeout = setTimeout(() => {
+                child.kill('SIGKILL'); // Force kill if not stopped
+            }, 5000);
+            child.on('exit', () => {
+                clearTimeout(shutdownTimeout);
+            });
+        });
+        // Wait for process to exit
+        child.on('exit', (code) => {
+            process.exit(code ?? 0);
+        });
+    }
+}
+/**
+ * Stop the daemon server
+ * AC: @cli-serve-commands ac-4 (stop), ac-5 (idempotent)
+ */
+async function stopServer(opts) {
+    if (isJsonMode()) {
+    }
+    const pidManager = new PidFileManager();
+    if (!pidManager.isDaemonRunning()) {
+        // AC: @cli-serve-commands ac-5
+        if (isJsonMode()) {
+            output({ running: false });
+        }
+        else {
+            info('Daemon not running');
+            output({ running: false });
+        }
+        process.exit(EXIT_CODES.SUCCESS);
+    }
+    const pid = pidManager.readPid();
+    if (!pid) {
+        if (isJsonMode()) {
+            output({ error: 'Failed to read PID file' });
+        }
+        else {
+            error('Failed to read PID file');
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+    // AC: @cli-serve-commands ac-4
+    if (!isJsonMode()) {
+        info(`Stopping daemon (PID ${pid})...`);
+    }
+    try {
+        // Send SIGTERM
+        process.kill(pid, 'SIGTERM');
+        // Wait for clean shutdown (max 5 seconds)
+        const maxWait = 5000;
+        const startTime = Date.now();
+        while (Date.now() - startTime < maxWait) {
+            if (!pidManager.isDaemonRunning()) {
+                break;
+            }
+            await new Promise(resolve => setTimeout(resolve, 100));
+        }
+        if (pidManager.isDaemonRunning()) {
+            if (!isJsonMode()) {
+                warn(`Daemon did not stop gracefully, forcing...`);
+            }
+            process.kill(pid, 'SIGKILL');
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        if (isJsonMode()) {
+            output({ stopped: true, pid });
+        }
+        else {
+            success('Daemon stopped');
+            output({ stopped: true, pid });
+        }
+    }
+    catch (err) {
+        if (isJsonMode()) {
+            output({ error: err instanceof Error ? err.message : String(err) });
+        }
+        else {
+            error(`Failed to stop daemon: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        process.exit(EXIT_CODES.ERROR);
+    }
+}
+/**
+ * Check daemon server status
+ * AC: @cli-serve-commands ac-6, @multi-directory-daemon ac-12
+ */
+async function statusServer(opts) {
+    if (isJsonMode()) {
+    }
+    const pidManager = new PidFileManager();
+    const running = pidManager.isDaemonRunning();
+    const pid = pidManager.readPid();
+    // Read port from global config (AC: @multi-directory-daemon ac-13)
+    let port = null;
+    if (running) {
+        try {
+            port = pidManager.readPort();
+        }
+        catch {
+            // Port file might not exist or be invalid
+            port = null;
+        }
+    }
+    // AC: @multi-directory-daemon ac-12 - Fetch list of registered projects and uptime
+    let projects = [];
+    let uptime = null;
+    if (running && port) {
+        try {
+            const response = await fetch(`http://localhost:${port}/api/projects`);
+            if (response.ok) {
+                const data = await response.json();
+                projects = data.projects || [];
+            }
+        }
+        catch {
+            // If daemon is not responding, continue without projects list
+            // This can happen if daemon is still starting up or network issues
+        }
+        // Fetch uptime from health endpoint
+        try {
+            const healthResponse = await fetch(`http://localhost:${port}/api/health`);
+            if (healthResponse.ok) {
+                const healthData = await healthResponse.json();
+                uptime = healthData.uptime;
+            }
+        }
+        catch {
+            // If health endpoint fails, continue without uptime
+        }
+    }
+    const status = {
+        running,
+        pid: pid ?? null,
+        port,
+        uptime,
+        projects,
+    };
+    if (isJsonMode()) {
+        output(status);
+    }
+    else {
+        if (running) {
+            output(`Daemon running (PID: ${pid})`);
+            if (port) {
+                output(`  Port: ${port}`);
+            }
+            // AC: @multi-directory-daemon ac-12 - Show uptime
+            if (uptime !== null) {
+                const hours = Math.floor(uptime / 3600);
+                const minutes = Math.floor((uptime % 3600) / 60);
+                const seconds = Math.floor(uptime % 60);
+                if (hours > 0) {
+                    output(`  Uptime: ${hours}h ${minutes}m ${seconds}s`);
+                }
+                else if (minutes > 0) {
+                    output(`  Uptime: ${minutes}m ${seconds}s`);
+                }
+                else {
+                    output(`  Uptime: ${seconds}s`);
+                }
+            }
+            // AC: @multi-directory-daemon ac-12 - Show registered projects
+            if (projects.length > 0) {
+                output(`\nRegistered projects (${projects.length}):`);
+                for (const project of projects) {
+                    output(`  ${project.path} (watcher: ${project.watcherStatus})`);
+                }
+            }
+            else {
+                output(`\nNo projects registered`);
+            }
+        }
+        else {
+            output('Daemon not running');
+        }
+    }
+}
+/**
+ * Restart the daemon server
+ * AC: @cli-serve-commands ac-7
+ */
+async function restartServer(opts) {
+    const pidManager = new PidFileManager();
+    // AC: @cli-serve-commands ac-7 - preserve port across restarts
+    // Try to read port from existing daemon, otherwise startServer will use config default
+    let port;
+    try {
+        port = pidManager.readPort().toString();
+    }
+    catch {
+        // Port file doesn't exist or is invalid, let startServer use config
+    }
+    if (pidManager.isDaemonRunning()) {
+        if (!isJsonMode()) {
+            info('Stopping daemon...');
+        }
+        await stopServer(opts);
+    }
+    if (!isJsonMode()) {
+        info('Starting daemon...');
+    }
+    await startServer({ daemon: true, port, kspecDir: opts.kspecDir });
+}
+//# sourceMappingURL=serve.js.map

package/dist/cli/commands/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/cli/commands/serve.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/session.d.ts

@@ -3,10 +3,10 @@
  *
  * Provides context for starting/resuming work sessions.
  */
-import { Command } from 'commander';
-import { type KspecContext } from '../../parser/index.js';
-import type { SessionContext as StoredSessionContext } from '../../schema/index.js';
-import { type GitWorkingTree } from '../../utils/index.js';
+import type { Command } from "commander";
+import { type KspecContext } from "../../parser/index.js";
+import type { SessionContext as StoredSessionContext } from "../../schema/index.js";
+import { type GitWorkingTree } from "../../utils/index.js";
 export interface CheckpointResult {
     /** Whether session can end cleanly */
     ok: boolean;
@@ -18,7 +18,7 @@ export interface CheckpointResult {
     instructions: string[];
 }
 export interface CheckpointIssue {
-    type: 'uncommitted_changes' | 'in_progress_task' | 'incomplete_todo';
+    type: "uncommitted_changes" | "in_progress_task" | "incomplete_todo";
     description: string;
     details?: Record<string, unknown>;
 }
@@ -66,6 +66,7 @@ export interface ActiveTaskSummary {
 export interface NoteSummary {
     task_ref: string;
     task_title: string;
+    task_status: "in_progress" | "pending_review" | "needs_work" | "completed";
     note_ulid: string;
     created_at: string;
     author: string | null;
@@ -97,7 +98,7 @@ export interface CompletedTaskSummary {
     title: string;
     completed_at: string;
     closed_reason: string | null;
-    origin?: 'manual' | 'derived' | 'observation_promotion';
+    origin?: "manual" | "derived" | "observation_promotion";
 }
 export interface CommitSummary {
     hash: string;
@@ -109,6 +110,7 @@ export interface CommitSummary {
 export interface SessionStats {
     total_tasks: number;
     in_progress: number;
+    needs_work: number;
     pending_review: number;
     ready: number;
     blocked: number;
@@ -134,6 +136,23 @@ export interface SessionOptions {
  * Gather session context data
  */
 export declare function gatherSessionContext(ctx: KspecContext, options: SessionOptions): Promise<SessionContext>;
+/**
+ * Stats for tasks completed/started within a time window.
+ * Used by ralph to track task completions per iteration.
+ */
+export interface IterationStats {
+    /** Number of tasks completed since the given time */
+    tasks_completed: number;
+    /** Number of tasks started since the given time */
+    tasks_started: number;
+    /** References of completed tasks */
+    completed_refs: string[];
+}
+/**
+ * Get iteration stats - tasks completed/started since a given time.
+ * AC: @ralph-task-limit ac-detection
+ */
+export declare function getIterationStats(ctx: KspecContext, since: Date): Promise<IterationStats>;
 export interface CheckpointOptions {
     force?: boolean;
     /** Set when stop hook is already active (retry after previous block) */

package/dist/cli/commands/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/session.ts"],"names":[],"mappings":"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"}