@plusplusoneplusplus/coc 1.0.0

package/dist/server/infrastructure/watcher-infrastructure.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Watcher Infrastructure Builder
+ *
+ * Creates TaskWatcher, WorkflowWatcher, and TemplateWatcher instances,
+ * bootstraps them for already-registered workspaces (server restart scenario),
+ * and monkey-patches store.registerWorkspace / store.removeWorkspace so watchers
+ * stay in sync as workspaces are added or removed at runtime.
+ *
+ * Extracted from createExecutionServer to keep index.ts focused on composition.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import { TaskWatcher } from '../task-watcher';
+import { WorkflowWatcher } from '../workflow-watcher';
+import { TemplateWatcher } from '../template-watcher';
+import type { ProcessStore } from '@plusplusoneplusplus/forge';
+import type { ProcessWebSocketServer } from '../websocket';
+import type { MultiRepoQueueExecutorBridge } from '../multi-repo-executor-bridge';
+export interface WatcherInfrastructure {
+    taskWatcher: TaskWatcher;
+    pipelineWatcher: WorkflowWatcher;
+    templateWatcher: TemplateWatcher;
+}
+/**
+ * Creates all three file watchers, bootstraps them for pre-existing workspaces,
+ * and wires store registration/removal hooks so watchers track workspace changes.
+ *
+ * @param store     - Process store (for workspace enumeration and hook interception).
+ * @param dataDir   - Root data directory used to resolve per-repo task roots.
+ * @param wsServer  - WebSocket server that receives file-change broadcasts.
+ * @param bridge    - Multi-repo bridge for registering repo IDs on workspace add.
+ * @returns The three watcher instances for use during server shutdown.
+ */
+export declare function createWatcherInfrastructure(store: ProcessStore, dataDir: string, wsServer: ProcessWebSocketServer, bridge: MultiRepoQueueExecutorBridge): Promise<WatcherInfrastructure>;
+//# sourceMappingURL=watcher-infrastructure.d.ts.map

package/dist/server/infrastructure/watcher-infrastructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher-infrastructure.d.ts","sourceRoot":"","sources":["../../../src/server/infrastructure/watcher-infrastructure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAGtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAMlF,MAAM,WAAW,qBAAqB;IAClC,WAAW,EAAE,WAAW,CAAC;IACzB,eAAe,EAAE,eAAe,CAAC;IACjC,eAAe,EAAE,eAAe,CAAC;CACpC;AAMD;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAC7C,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,4BAA4B,GACrC,OAAO,CAAC,qBAAqB,CAAC,CAoDhC"}

package/dist/server/infrastructure/watcher-infrastructure.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Watcher Infrastructure Builder
+ *
+ * Creates TaskWatcher, WorkflowWatcher, and TemplateWatcher instances,
+ * bootstraps them for already-registered workspaces (server restart scenario),
+ * and monkey-patches store.registerWorkspace / store.removeWorkspace so watchers
+ * stay in sync as workspaces are added or removed at runtime.
+ *
+ * Extracted from createExecutionServer to keep index.ts focused on composition.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWatcherInfrastructure = createWatcherInfrastructure;
+const task_watcher_1 = require("../task-watcher");
+const workflow_watcher_1 = require("../workflow-watcher");
+const template_watcher_1 = require("../template-watcher");
+const task_root_resolver_1 = require("../task-root-resolver");
+const task_migration_1 = require("../task-migration");
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Creates all three file watchers, bootstraps them for pre-existing workspaces,
+ * and wires store registration/removal hooks so watchers track workspace changes.
+ *
+ * @param store     - Process store (for workspace enumeration and hook interception).
+ * @param dataDir   - Root data directory used to resolve per-repo task roots.
+ * @param wsServer  - WebSocket server that receives file-change broadcasts.
+ * @param bridge    - Multi-repo bridge for registering repo IDs on workspace add.
+ * @returns The three watcher instances for use during server shutdown.
+ */
+async function createWatcherInfrastructure(store, dataDir, wsServer, bridge) {
+    const taskWatcher = new task_watcher_1.TaskWatcher((workspaceId) => {
+        wsServer.broadcastProcessEvent({ type: 'tasks-changed', workspaceId, timestamp: Date.now() });
+    });
+    const pipelineWatcher = new workflow_watcher_1.WorkflowWatcher((workspaceId) => {
+        wsServer.broadcastProcessEvent({ type: 'workflows-changed', workspaceId, timestamp: Date.now() });
+    });
+    const templateWatcher = new template_watcher_1.TemplateWatcher((workspaceId) => {
+        wsServer.broadcastProcessEvent({ type: 'templates-changed', workspaceId, timestamp: Date.now() });
+    });
+    // Bootstrap watchers for workspaces that already exist (server restart scenario)
+    const existingWorkspaces = await store.getWorkspaces();
+    for (const ws of existingWorkspaces) {
+        if ((0, task_migration_1.isMigrationNeeded)(ws.rootPath, ws.id, dataDir)) {
+            const result = await (0, task_migration_1.migrateTasksToRepoScoped)({ workspaceRoot: ws.rootPath, workspaceId: ws.id, dataDir });
+            if (result.migrated) {
+                process.stderr.write(`[TaskMigration] ${result.fileCount} files: ${ws.rootPath}\n`);
+            }
+        }
+        taskWatcher.watchWorkspace(ws.id, (0, task_root_resolver_1.resolveTaskRoot)({ dataDir, rootPath: ws.rootPath, workspaceId: ws.id }).absolutePath);
+        pipelineWatcher.watchWorkspace(ws.id, ws.rootPath);
+        templateWatcher.watchWorkspace(ws.id, ws.rootPath);
+        bridge.registerRepoId(ws.id, ws.rootPath);
+    }
+    // Intercept store workspace registration/removal to keep watchers in sync
+    const originalRegister = store.registerWorkspace.bind(store);
+    const originalRemove = store.removeWorkspace.bind(store);
+    store.registerWorkspace = async (workspace) => {
+        await originalRegister(workspace);
+        if ((0, task_migration_1.isMigrationNeeded)(workspace.rootPath, workspace.id, dataDir)) {
+            const result = await (0, task_migration_1.migrateTasksToRepoScoped)({ workspaceRoot: workspace.rootPath, workspaceId: workspace.id, dataDir });
+            if (result.migrated) {
+                process.stderr.write(`[TaskMigration] ${result.fileCount} files: ${workspace.rootPath}\n`);
+            }
+        }
+        taskWatcher.watchWorkspace(workspace.id, (0, task_root_resolver_1.resolveTaskRoot)({ dataDir, rootPath: workspace.rootPath, workspaceId: workspace.id }).absolutePath);
+        pipelineWatcher.watchWorkspace(workspace.id, workspace.rootPath);
+        templateWatcher.watchWorkspace(workspace.id, workspace.rootPath);
+        bridge.registerRepoId(workspace.id, workspace.rootPath);
+    };
+    store.removeWorkspace = async (id) => {
+        taskWatcher.unwatchWorkspace(id);
+        pipelineWatcher.unwatchWorkspace(id);
+        templateWatcher.unwatchWorkspace(id);
+        return originalRemove(id);
+    };
+    return { taskWatcher, pipelineWatcher, templateWatcher };
+}
+//# sourceMappingURL=watcher-infrastructure.js.map

package/dist/server/infrastructure/watcher-infrastructure.js.map

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

package/dist/server/infrastructure/websocket-infrastructure.d.ts

@@ -0,0 +1,30 @@
+/**
+ * WebSocket Infrastructure Builder
+ *
+ * Creates the ProcessWebSocketServer and wires all event sources
+ * (drain events, process-store changes, queue changes, schedule changes)
+ * to it. Extracted from createExecutionServer to keep index.ts focused
+ * on composition.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import * as http from 'http';
+import { ProcessWebSocketServer } from '../websocket';
+import type { ProcessStore } from '@plusplusoneplusplus/forge';
+import { RepoQueueRegistry } from '@plusplusoneplusplus/forge';
+import type { MultiRepoQueueExecutorBridge } from '../multi-repo-executor-bridge';
+import type { ScheduleManager } from '../schedule-manager';
+/**
+ * Creates a ProcessWebSocketServer, attaches it to the HTTP server, and wires
+ * all event sources to it.
+ *
+ * @param server          - The HTTP server to attach the WebSocket server to.
+ * @param store           - Process store whose changes are forwarded over WS.
+ * @param bridge          - Multi-repo bridge for drain and queue-change events.
+ * @param registry        - Queue registry used to build aggregate queue snapshots.
+ * @param scheduleManager - Schedule manager for schedule-change events.
+ * @returns The configured ProcessWebSocketServer instance.
+ */
+export declare function createWebSocketInfrastructure(server: http.Server, store: ProcessStore, bridge: MultiRepoQueueExecutorBridge, registry: RepoQueueRegistry, scheduleManager: ScheduleManager): ProcessWebSocketServer;
+//# sourceMappingURL=websocket-infrastructure.d.ts.map

package/dist/server/infrastructure/websocket-infrastructure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-infrastructure.d.ts","sourceRoot":"","sources":["../../../src/server/infrastructure/websocket-infrastructure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,sBAAsB,EAAoB,MAAM,cAAc,CAAC;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAM3D;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CACzC,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,4BAA4B,EACpC,QAAQ,EAAE,iBAAiB,EAC3B,eAAe,EAAE,eAAe,GACjC,sBAAsB,CAuJxB"}

package/dist/server/infrastructure/websocket-infrastructure.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * WebSocket Infrastructure Builder
+ *
+ * Creates the ProcessWebSocketServer and wires all event sources
+ * (drain events, process-store changes, queue changes, schedule changes)
+ * to it. Extracted from createExecutionServer to keep index.ts focused
+ * on composition.
+ *
+ * No VS Code dependencies — uses only Node.js built-in modules.
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWebSocketInfrastructure = createWebSocketInfrastructure;
+const websocket_1 = require("../websocket");
+// ============================================================================
+// Factory
+// ============================================================================
+/**
+ * Creates a ProcessWebSocketServer, attaches it to the HTTP server, and wires
+ * all event sources to it.
+ *
+ * @param server          - The HTTP server to attach the WebSocket server to.
+ * @param store           - Process store whose changes are forwarded over WS.
+ * @param bridge          - Multi-repo bridge for drain and queue-change events.
+ * @param registry        - Queue registry used to build aggregate queue snapshots.
+ * @param scheduleManager - Schedule manager for schedule-change events.
+ * @returns The configured ProcessWebSocketServer instance.
+ */
+function createWebSocketInfrastructure(server, store, bridge, registry, scheduleManager) {
+    const wsServer = new websocket_1.ProcessWebSocketServer();
+    wsServer.attach(server);
+    // Wire drain events from multi-repo bridge to WebSocket
+    bridge.on('drain-start', (event) => {
+        wsServer.broadcastProcessEvent({ type: 'drain-start', queued: event.queued, running: event.running });
+    });
+    bridge.on('drain-progress', (event) => {
+        wsServer.broadcastProcessEvent({ type: 'drain-progress', queued: event.queued, running: event.running });
+    });
+    bridge.on('drain-complete', (event) => {
+        wsServer.broadcastProcessEvent({ type: 'drain-complete', outcome: event.outcome, queued: event.queued, running: event.running });
+    });
+    bridge.on('drain-timeout', (event) => {
+        wsServer.broadcastProcessEvent({ type: 'drain-timeout', queued: event.queued, running: event.running, timeoutMs: event.timeoutMs });
+    });
+    // Store process change → WS broadcast
+    store.onProcessChange = (event) => {
+        switch (event.type) {
+            case 'process-added':
+                if (event.process) {
+                    wsServer.broadcastProcessEvent({
+                        type: 'process-added',
+                        process: (0, websocket_1.toProcessSummary)(event.process),
+                    });
+                }
+                break;
+            case 'process-updated':
+                if (event.process) {
+                    wsServer.broadcastProcessEvent({
+                        type: 'process-updated',
+                        process: (0, websocket_1.toProcessSummary)(event.process),
+                    });
+                }
+                break;
+            case 'process-removed':
+                if (event.process) {
+                    wsServer.broadcastProcessEvent({
+                        type: 'process-removed',
+                        processId: event.process.id,
+                    });
+                }
+                break;
+            case 'processes-cleared':
+                wsServer.broadcastProcessEvent({
+                    type: 'processes-cleared',
+                    count: 0,
+                });
+                break;
+        }
+    };
+    // Helper to map task arrays to WS-friendly summaries
+    const mapQueued = (t) => ({
+        id: t.id, repoId: t.repoId, type: t.type, priority: t.priority,
+        status: t.status, displayName: t.displayName, createdAt: t.createdAt,
+        workingDirectory: t.payload?.workingDirectory,
+        payload: {
+            kind: t.payload?.kind,
+            mode: t.payload?.mode,
+            prompt: t.payload?.prompt,
+            planFilePath: t.payload?.planFilePath,
+            filePath: t.payload?.filePath,
+            workingDirectory: t.payload?.workingDirectory,
+            context: t.payload?.context?.files
+                ? { files: t.payload.context.files }
+                : undefined,
+            data: t.payload?.data ? {
+                originalTaskPath: t.payload?.data?.originalTaskPath,
+            } : undefined,
+        },
+    });
+    const mapRunning = (t) => ({
+        ...mapQueued(t), startedAt: t.startedAt,
+    });
+    const mapHistory = (t) => ({
+        ...mapRunning(t), completedAt: t.completedAt, error: t.error,
+    });
+    // Bridge queue change events from all repos to WebSocket
+    bridge.on('queueChange', (event) => {
+        // 1) Per-repo scoped broadcast
+        const repoManager = registry.getQueueForRepo(event.repoPath);
+        const repoStats = repoManager.getStats();
+        wsServer.broadcastProcessEvent({
+            type: 'queue-updated',
+            queue: {
+                repoId: event.repoId,
+                queued: repoManager.getQueued().map(mapQueued),
+                running: repoManager.getRunning().map(mapRunning),
+                history: repoManager.getHistory().map(mapHistory),
+                stats: repoStats,
+            },
+        });
+        // 2) Global aggregate broadcast (no repoId) for top-level stats badge
+        const allQueued = [];
+        const allRunning = [];
+        const allHistory = [];
+        const combinedStats = { queued: 0, running: 0, completed: 0, failed: 0, cancelled: 0, total: 0, isPaused: false, isDraining: false };
+        let allPaused = true;
+        let anyManager = false;
+        let anyDraining = false;
+        for (const [, manager] of registry.getAllQueues()) {
+            allQueued.push(...manager.getQueued());
+            allRunning.push(...manager.getRunning());
+            allHistory.push(...manager.getHistory());
+            const s = manager.getStats();
+            combinedStats.queued += s.queued;
+            combinedStats.running += s.running;
+            combinedStats.completed += s.completed;
+            combinedStats.failed += s.failed;
+            combinedStats.cancelled += s.cancelled;
+            combinedStats.total += s.total;
+            if (!s.isPaused) {
+                allPaused = false;
+            }
+            if (s.isDraining) {
+                anyDraining = true;
+            }
+            anyManager = true;
+        }
+        combinedStats.isPaused = anyManager && allPaused;
+        combinedStats.isDraining = anyDraining;
+        // Debug: log queue state changes
+        const taskInfo = event.taskId ? ` task=${event.taskId}` : '';
+        process.stderr.write(`[Queue] ${event.type}${taskInfo} — queued=${combinedStats.queued} running=${combinedStats.running} completed=${combinedStats.completed} failed=${combinedStats.failed} ws_clients=${wsServer.clientCount}\n`);
+        wsServer.broadcastProcessEvent({
+            type: 'queue-updated',
+            queue: {
+                queued: allQueued.map(mapQueued),
+                running: allRunning.map(mapRunning),
+                history: allHistory.map(mapHistory),
+                stats: combinedStats,
+            },
+        });
+    });
+    // Bridge schedule change events to WebSocket
+    scheduleManager.on('change', (event) => {
+        wsServer.broadcastProcessEvent({
+            type: event.type,
+            repoId: event.repoId,
+            scheduleId: event.scheduleId,
+            schedule: event.schedule,
+            run: event.run,
+        });
+    });
+    return wsServer;
+}
+//# sourceMappingURL=websocket-infrastructure.js.map

package/dist/server/infrastructure/websocket-infrastructure.js.map

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

package/dist/server/instruction-handler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Per-Repo Instruction Files REST API Handler
+ *
+ * CRUD endpoints for managing .github/coc/instructions*.md files
+ * inside a workspace repository.
+ *
+ * Routes:
+ *   GET    /api/workspaces/:id/instructions         — list all files with content
+ *   GET    /api/workspaces/:id/instructions/:mode   — read one file
+ *   PUT    /api/workspaces/:id/instructions/:mode   — create/update file
+ *   DELETE /api/workspaces/:id/instructions/:mode   — delete file
+ *
+ * No VS Code dependencies. Cross-platform (Linux/Mac/Windows).
+ */
+import type { ProcessStore } from '@plusplusoneplusplus/forge';
+import type { Route } from './types';
+/**
+ * Register CRUD routes for per-repo instruction files.
+ * Mutates the routes array in-place (same pattern as other handlers).
+ */
+export declare function registerInstructionRoutes(routes: Route[], store: ProcessStore): void;
+//# sourceMappingURL=instruction-handler.d.ts.map

package/dist/server/instruction-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instruction-handler.d.ts","sourceRoot":"","sources":["../../src/server/instruction-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAK/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAsCrC;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAwHpF"}

package/dist/server/instruction-handler.js

@@ -0,0 +1,202 @@
+"use strict";
+/**
+ * Per-Repo Instruction Files REST API Handler
+ *
+ * CRUD endpoints for managing .github/coc/instructions*.md files
+ * inside a workspace repository.
+ *
+ * Routes:
+ *   GET    /api/workspaces/:id/instructions         — list all files with content
+ *   GET    /api/workspaces/:id/instructions/:mode   — read one file
+ *   PUT    /api/workspaces/:id/instructions/:mode   — create/update file
+ *   DELETE /api/workspaces/:id/instructions/:mode   — delete file
+ *
+ * No VS Code dependencies. Cross-platform (Linux/Mac/Windows).
+ */
+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.registerInstructionRoutes = registerInstructionRoutes;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const forge_1 = require("@plusplusoneplusplus/forge");
+const api_handler_1 = require("./api-handler");
+const errors_1 = require("./errors");
+const handler_utils_1 = require("./shared/handler-utils");
+// ============================================================================
+// Constants
+// ============================================================================
+/** Valid mode values accepted as the :mode URL parameter. */
+const VALID_MODES = new Set(['base', 'ask', 'plan', 'autopilot']);
+/** Maps mode to file name relative to the instruction dir. */
+const MODE_TO_FILE = {
+    base: 'instructions.md',
+    ask: 'instructions-ask.md',
+    plan: 'instructions-plan.md',
+    autopilot: 'instructions-autopilot.md',
+};
+// ============================================================================
+// Helpers
+// ============================================================================
+function resolveInstructionPath(workspaceRoot, mode) {
+    return path.join(workspaceRoot, forge_1.INSTRUCTION_DIR, MODE_TO_FILE[mode]);
+}
+function parseMode(raw) {
+    return VALID_MODES.has(raw) ? raw : undefined;
+}
+function invalidModeError(raw) {
+    return (0, errors_1.badRequest)(`Invalid mode '${raw}'. Valid values: base, ask, plan, autopilot`);
+}
+// ============================================================================
+// Route registration
+// ============================================================================
+/**
+ * Register CRUD routes for per-repo instruction files.
+ * Mutates the routes array in-place (same pattern as other handlers).
+ */
+function registerInstructionRoutes(routes, store) {
+    // GET /api/workspaces/:id/instructions — list all files
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/workspaces\/([^/]+)\/instructions$/,
+        handler: async (_req, res, match) => {
+            try {
+                const workspace = await (0, handler_utils_1.resolveWorkspaceOrFail)(store, match, res);
+                if (!workspace)
+                    return;
+                const fileSet = (0, forge_1.findInstructionFiles)(workspace.rootPath);
+                const result = {};
+                for (const mode of VALID_MODES) {
+                    const filePath = fileSet[mode];
+                    if (filePath) {
+                        try {
+                            result[mode] = await fs.promises.readFile(filePath, 'utf-8');
+                        }
+                        catch {
+                            result[mode] = null;
+                        }
+                    }
+                    else {
+                        result[mode] = null;
+                    }
+                }
+                (0, api_handler_1.sendJSON)(res, 200, result);
+            }
+            catch (err) {
+                (0, errors_1.handleAPIError)(res, err);
+            }
+        },
+    });
+    // GET /api/workspaces/:id/instructions/:mode — read one file
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/workspaces\/([^/]+)\/instructions\/([^/]+)$/,
+        handler: async (_req, res, match) => {
+            try {
+                const workspace = await (0, handler_utils_1.resolveWorkspaceOrFail)(store, match, res);
+                if (!workspace)
+                    return;
+                const mode = parseMode(match[2] ?? '');
+                if (!mode) {
+                    return (0, errors_1.handleAPIError)(res, invalidModeError(match[2]));
+                }
+                const filePath = resolveInstructionPath(workspace.rootPath, mode);
+                if (!fs.existsSync(filePath)) {
+                    return (0, errors_1.handleAPIError)(res, (0, errors_1.notFound)(`Instructions file for mode '${mode}'`));
+                }
+                const content = await fs.promises.readFile(filePath, 'utf-8');
+                (0, api_handler_1.sendJSON)(res, 200, { mode, content });
+            }
+            catch (err) {
+                (0, errors_1.handleAPIError)(res, err);
+            }
+        },
+    });
+    // PUT /api/workspaces/:id/instructions/:mode — create/update file
+    routes.push({
+        method: 'PUT',
+        pattern: /^\/api\/workspaces\/([^/]+)\/instructions\/([^/]+)$/,
+        handler: async (req, res, match) => {
+            try {
+                const workspace = await (0, handler_utils_1.resolveWorkspaceOrFail)(store, match, res);
+                if (!workspace)
+                    return;
+                const mode = parseMode(match[2] ?? '');
+                if (!mode) {
+                    return (0, errors_1.handleAPIError)(res, invalidModeError(match[2]));
+                }
+                const body = await (0, handler_utils_1.parseBodyOrReject)(req, res);
+                if (body === null)
+                    return;
+                if (typeof body?.content !== 'string') {
+                    return (0, errors_1.handleAPIError)(res, (0, errors_1.badRequest)('Request body must be JSON with a "content" string field'));
+                }
+                const dir = path.join(workspace.rootPath, forge_1.INSTRUCTION_DIR);
+                await fs.promises.mkdir(dir, { recursive: true });
+                const filePath = resolveInstructionPath(workspace.rootPath, mode);
+                await fs.promises.writeFile(filePath, body.content, 'utf-8');
+                (0, api_handler_1.sendJSON)(res, 200, { mode, content: body.content });
+            }
+            catch (err) {
+                (0, errors_1.handleAPIError)(res, err);
+            }
+        },
+    });
+    // DELETE /api/workspaces/:id/instructions/:mode — delete file
+    routes.push({
+        method: 'DELETE',
+        pattern: /^\/api\/workspaces\/([^/]+)\/instructions\/([^/]+)$/,
+        handler: async (_req, res, match) => {
+            try {
+                const workspace = await (0, handler_utils_1.resolveWorkspaceOrFail)(store, match, res);
+                if (!workspace)
+                    return;
+                const mode = parseMode(match[2] ?? '');
+                if (!mode) {
+                    return (0, errors_1.handleAPIError)(res, invalidModeError(match[2]));
+                }
+                const filePath = resolveInstructionPath(workspace.rootPath, mode);
+                if (!fs.existsSync(filePath)) {
+                    return (0, errors_1.handleAPIError)(res, (0, errors_1.notFound)(`Instructions file for mode '${mode}'`));
+                }
+                await fs.promises.unlink(filePath);
+                (0, api_handler_1.sendJSON)(res, 200, { success: true });
+            }
+            catch (err) {
+                (0, errors_1.handleAPIError)(res, err);
+            }
+        },
+    });
+}
+//# sourceMappingURL=instruction-handler.js.map

package/dist/server/instruction-handler.js.map

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

package/dist/server/logs-routes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Logs Routes
+ *
+ * Registers the /api/logs/* REST and SSE endpoints.
+ *
+ * GET /api/logs/stream   — SSE: live log streaming (text/event-stream)
+ * GET /api/logs/history  — JSON array of buffered log entries, newest-first
+ * GET /api/logs/sources  — JSON: configured log sources + status
+ *
+ * Live streaming uses the in-process EventEmitter from server-log-capture.ts.
+ * No log files are required for live streaming; file-based history is optional.
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+import type { Route } from './types';
+/**
+ * Register all /api/logs/* routes on the given route table.
+ * Mutates the `routes` array in-place.
+ *
+ * @param routes  - Shared route table
+ * @param logDir  - Optional log file directory (enables "files configured" in /sources)
+ */
+export declare function registerLogsRoutes(routes: Route[], logDir?: string): void;
+//# sourceMappingURL=logs-routes.d.ts.map

package/dist/server/logs-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs-routes.d.ts","sourceRoot":"","sources":["../../src/server/logs-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA0BrC;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAyIzE"}