npm - octomux - Versions diffs - 1.0.0 - Mend

octomux 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (56) hide show

package/README.md +60 -0
package/bin/octomux.js +139 -0
package/cli/dist/client.js +56 -0
package/cli/dist/commands/add-agent.js +20 -0
package/cli/dist/commands/cancel-task.js +10 -0
package/cli/dist/commands/close-task.js +16 -0
package/cli/dist/commands/create-task.js +35 -0
package/cli/dist/commands/delete-task.js +16 -0
package/cli/dist/commands/get-task.js +37 -0
package/cli/dist/commands/list-tasks.js +31 -0
package/cli/dist/commands/resume-task.js +18 -0
package/cli/dist/commands/send-message.js +18 -0
package/cli/dist/format.js +40 -0
package/cli/dist/index.js +36 -0
package/cli/package.json +9 -0
package/dist/assets/TaskDetail-GGGQ2C1J.js +1 -0
package/dist/assets/TerminalView-CguHyqU9.js +3 -0
package/dist/assets/geist-cyrillic-wght-normal-CHSlOQsW.woff2 +0 -0
package/dist/assets/geist-latin-ext-wght-normal-DMtmJ5ZE.woff2 +0 -0
package/dist/assets/geist-latin-wght-normal-Dm3htQBi.woff2 +0 -0
package/dist/assets/index-Br9dLOzs.css +1 -0
package/dist/assets/index-Bsj_BLLM.js +2 -0
package/dist/assets/vendor-react-BZ8ItZjw.js +49 -0
package/dist/assets/vendor-router-DRLGqALp.js +12 -0
package/dist/assets/vendor-ui-CWZtXYLx.js +31 -0
package/dist/assets/vendor-xterm-DYP7pi_n.css +32 -0
package/dist/assets/vendor-xterm-DvXGiZvM.js +9 -0
package/dist/index.html +17 -0
package/dist/logo.png +0 -0
package/dist-server/api.d.ts +2 -0
package/dist-server/api.js +447 -0
package/dist-server/app.d.ts +2 -0
package/dist-server/app.js +13 -0
package/dist-server/db.d.ts +7 -0
package/dist-server/db.js +107 -0
package/dist-server/events.d.ts +13 -0
package/dist-server/events.js +35 -0
package/dist-server/hook-settings.d.ts +5 -0
package/dist-server/hook-settings.js +195 -0
package/dist-server/hooks.d.ts +2 -0
package/dist-server/hooks.js +118 -0
package/dist-server/index.d.ts +5 -0
package/dist-server/index.js +81 -0
package/dist-server/orchestrator.d.ts +4 -0
package/dist-server/orchestrator.js +37 -0
package/dist-server/poller.d.ts +17 -0
package/dist-server/poller.js +170 -0
package/dist-server/pr-template.d.ts +7 -0
package/dist-server/pr-template.js +29 -0
package/dist-server/task-runner.d.ts +28 -0
package/dist-server/task-runner.js +359 -0
package/dist-server/terminal.d.ts +13 -0
package/dist-server/terminal.js +173 -0
package/dist-server/types.d.ts +73 -0
package/dist-server/types.js +1 -0
package/package.json +113 -0

package/dist/index.html ADDED Viewed

@@ -0,0 +1,17 @@
+<!doctype html>
+<html lang="en" class="dark">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/png" href="/logo.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>octomux</title>
+    <script type="module" crossorigin src="/assets/index-Bsj_BLLM.js"></script>
+    <link rel="modulepreload" crossorigin href="/assets/vendor-react-BZ8ItZjw.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-router-DRLGqALp.js">
+    <link rel="modulepreload" crossorigin href="/assets/vendor-ui-CWZtXYLx.js">
+    <link rel="stylesheet" crossorigin href="/assets/index-Br9dLOzs.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

package/dist/logo.png ADDED Viewed

Binary file

package/dist-server/api.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import type { Express } from 'express';
2	+ export declare function setupRoutes(app: Express): void;

package/dist-server/api.js ADDED Viewed

@@ -0,0 +1,447 @@
+import { nanoid } from 'nanoid';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { getDb } from './db.js';
+import { execFile as execFileCb } from 'child_process';
+import { promisify } from 'util';
+import { startTask, closeTask, deleteTask, resumeTask, addAgent, stopAgent, createUserTerminal, } from './task-runner.js';
+import { isOrchestratorRunning, startOrchestrator, stopOrchestrator, getOrchestratorSession, } from './orchestrator.js';
+import { hookRoutes } from './hooks.js';
+import { broadcast } from './events.js';
+const execFile = promisify(execFileCb);
+function safeParseJson(s) {
+    try {
+        return JSON.parse(s || '{}');
+    }
+    catch {
+        return {};
+    }
+}
+function derivedStatus(task) {
+    if (task.status !== 'running')
+        return null;
+    const activities = task.agents.filter((a) => a.status !== 'stopped').map((a) => a.hook_activity);
+    if (activities.length === 0)
+        return 'done';
+    if (activities.includes('active'))
+        return 'working';
+    if (activities.includes('waiting'))
+        return 'needs_attention';
+    return 'done';
+}
+export function setupRoutes(app) {
+    app.use('/api/hooks', hookRoutes);
+    // Browse directories for folder picker
+    app.get('/api/browse', (req, res) => {
+        const dirPath = req.query.path || os.homedir();
+        try {
+            const stat = fs.statSync(dirPath);
+            if (!stat.isDirectory()) {
+                res.status(400).json({ error: 'Path is not a directory' });
+                return;
+            }
+        }
+        catch {
+            res.status(400).json({ error: 'Path does not exist' });
+            return;
+        }
+        const entries = [];
+        for (const name of fs.readdirSync(dirPath)) {
+            const fullPath = path.join(dirPath, name);
+            try {
+                const stat = fs.statSync(fullPath);
+                if (!stat.isDirectory())
+                    continue;
+                const isGit = fs.existsSync(path.join(fullPath, '.git'));
+                entries.push({ name, path: fullPath, isGit });
+            }
+            catch {
+                // skip unreadable entries
+            }
+        }
+        // Sort: git repos first, then hidden dirs last, then alphabetical
+        entries.sort((a, b) => {
+            if (a.isGit !== b.isGit)
+                return a.isGit ? -1 : 1;
+            const aHidden = a.name.startsWith('.');
+            const bHidden = b.name.startsWith('.');
+            if (aHidden !== bHidden)
+                return aHidden ? 1 : -1;
+            return a.name.localeCompare(b.name);
+        });
+        const parent = path.dirname(dirPath);
+        res.json({
+            current: dirPath,
+            parent: parent !== dirPath ? parent : null,
+            entries,
+        });
+    });
+    // List branches for a git repo
+    app.get('/api/branches', async (req, res) => {
+        const repoPath = req.query.repo_path;
+        if (!repoPath) {
+            res.status(400).json({ error: 'repo_path is required' });
+            return;
+        }
+        try {
+            const { stdout } = await execFile('git', [
+                '-C',
+                repoPath,
+                'branch',
+                '-a',
+                '--format=%(refname:short)',
+            ]);
+            const branches = stdout
+                .trim()
+                .split('\n')
+                .filter(Boolean)
+                .map((b) => b.replace(/^origin\//, ''));
+            // Deduplicate (local + remote may overlap)
+            const unique = [...new Set(branches)].filter((b) => b !== 'HEAD');
+            res.json(unique);
+        }
+        catch {
+            res.status(400).json({ error: 'Failed to list branches' });
+        }
+    });
+    // Get default branch for a git repo
+    app.get('/api/default-branch', async (req, res) => {
+        const repoPath = req.query.repo_path;
+        if (!repoPath) {
+            res.status(400).json({ error: 'repo_path is required' });
+            return;
+        }
+        try {
+            const { stdout } = await execFile('git', [
+                '-C',
+                repoPath,
+                'symbolic-ref',
+                'refs/remotes/origin/HEAD',
+            ]);
+            const branch = stdout.trim().replace('refs/remotes/origin/', '');
+            res.json({ branch });
+        }
+        catch {
+            // Fallback to 'main'
+            res.json({ branch: 'main' });
+        }
+    });
+    // Recent repository paths from past tasks
+    app.get('/api/recent-repos', (_req, res) => {
+        const db = getDb();
+        const rows = db
+            .prepare(`SELECT repo_path, MAX(created_at) as last_used FROM tasks GROUP BY repo_path ORDER BY last_used DESC LIMIT 10`)
+            .all();
+        res.json(rows);
+    });
+    // List all tasks with agents
+    app.get('/api/tasks', (req, res) => {
+        const db = getDb();
+        const repoPath = req.query.repo_path;
+        let tasks;
+        if (repoPath) {
+            tasks = db
+                .prepare('SELECT * FROM tasks WHERE repo_path = ? ORDER BY created_at DESC')
+                .all(repoPath);
+        }
+        else {
+            tasks = db.prepare('SELECT * FROM tasks ORDER BY created_at DESC').all();
+        }
+        const agentStmt = db.prepare('SELECT * FROM agents WHERE task_id = ? ORDER BY window_index');
+        const promptStmt = db.prepare(`SELECT pp.*, a.label as agent_label
+       FROM permission_prompts pp
+       LEFT JOIN agents a ON pp.agent_id = a.id
+       WHERE pp.task_id = ? AND pp.status = 'pending'
+       ORDER BY pp.created_at ASC`);
+        const result = tasks.map((task) => {
+            const agents = agentStmt.all(task.id);
+            const pendingPrompts = promptStmt.all(task.id);
+            const parsedPrompts = pendingPrompts.map((pp) => ({
+                ...pp,
+                tool_input: safeParseJson(pp.tool_input),
+            }));
+            return {
+                ...task,
+                agents,
+                pending_prompts: parsedPrompts,
+                derived_status: derivedStatus({ status: task.status, agents }),
+            };
+        });
+        res.json(result);
+    });
+    // Get single task with agents
+    app.get('/api/tasks/:id', (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        const agents = db
+            .prepare('SELECT * FROM agents WHERE task_id = ? ORDER BY window_index')
+            .all(task.id);
+        const pendingPrompts = db
+            .prepare(`SELECT pp.*, a.label as agent_label
+       FROM permission_prompts pp
+       LEFT JOIN agents a ON pp.agent_id = a.id
+       WHERE pp.task_id = ? AND pp.status = 'pending'
+       ORDER BY pp.created_at ASC`)
+            .all(task.id);
+        const parsedPrompts = pendingPrompts.map((pp) => ({
+            ...pp,
+            tool_input: safeParseJson(pp.tool_input),
+        }));
+        res.json({
+            ...task,
+            agents,
+            pending_prompts: parsedPrompts,
+            derived_status: derivedStatus({ status: task.status, agents }),
+        });
+    });
+    // Create task
+    app.post('/api/tasks', async (req, res) => {
+        const body = req.body;
+        if (!body.title || !body.description || !body.repo_path) {
+            res.status(400).json({ error: 'title, description, and repo_path are required' });
+            return;
+        }
+        const db = getDb();
+        const id = nanoid(12);
+        db.prepare('INSERT INTO tasks (id, title, description, repo_path, status, branch, base_branch, initial_prompt) VALUES (?, ?, ?, ?, ?, ?, ?, ?)').run(id, body.title, body.description, body.repo_path, 'draft', body.branch ?? null, body.base_branch ?? null, body.initial_prompt ?? null);
+        // Start task immediately unless explicitly saved as draft
+        if (!body.draft) {
+            const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(id);
+            await startTask(task);
+        }
+        const created = db.prepare('SELECT * FROM tasks WHERE id = ?').get(id);
+        created.agents = db
+            .prepare('SELECT * FROM agents WHERE task_id = ? ORDER BY window_index')
+            .all(id);
+        broadcast({ type: 'task:created', payload: { taskId: id } });
+        res.status(201).json(created);
+    });
+    // Update task status
+    app.patch('/api/tasks/:id', async (req, res) => {
+        const body = req.body;
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        // Draft field updates (title, description, repo_path, branch, base_branch, initial_prompt)
+        const hasDraftFields = [
+            'title',
+            'description',
+            'repo_path',
+            'branch',
+            'base_branch',
+            'initial_prompt',
+        ].some((k) => body[k] !== undefined);
+        if (hasDraftFields) {
+            if (task.status !== 'draft') {
+                res.status(400).json({ error: 'Can only edit fields on draft tasks' });
+                return;
+            }
+            if (body.title !== undefined && !body.title.trim()) {
+                res.status(400).json({ error: 'title is required' });
+                return;
+            }
+            if (body.description !== undefined && !body.description.trim()) {
+                res.status(400).json({ error: 'description is required' });
+                return;
+            }
+            if (body.repo_path !== undefined) {
+                if (!body.repo_path.trim()) {
+                    res.status(400).json({ error: 'repo_path is required' });
+                    return;
+                }
+                if (!fs.existsSync(body.repo_path)) {
+                    res.status(400).json({ error: 'repo_path does not exist' });
+                    return;
+                }
+            }
+            const fields = [];
+            const values = [];
+            for (const key of [
+                'title',
+                'description',
+                'repo_path',
+                'branch',
+                'base_branch',
+                'initial_prompt',
+            ]) {
+                if (body[key] !== undefined) {
+                    fields.push(`${key} = ?`);
+                    values.push(body[key] ?? null);
+                }
+            }
+            if (fields.length > 0) {
+                fields.push(`updated_at = datetime('now')`);
+                values.push(task.id);
+                db.prepare(`UPDATE tasks SET ${fields.join(', ')} WHERE id = ?`).run(...values);
+            }
+        }
+        else if (body.status === 'running') {
+            // Resume task
+            if (task.status !== 'closed' && task.status !== 'error') {
+                res.status(400).json({ error: 'Can only resume tasks in closed or error state' });
+                return;
+            }
+            if (!task.worktree || !fs.existsSync(task.worktree)) {
+                res.status(400).json({ error: 'Worktree no longer exists on disk' });
+                return;
+            }
+            await resumeTask(task);
+        }
+        else if (body.status === 'closed') {
+            await closeTask(task);
+        }
+        const updated = db.prepare('SELECT * FROM tasks WHERE id = ?').get(task.id);
+        updated.agents = db
+            .prepare('SELECT * FROM agents WHERE task_id = ? ORDER BY window_index')
+            .all(task.id);
+        broadcast({ type: 'task:updated', payload: { taskId: task.id } });
+        res.json(updated);
+    });
+    // Start a draft task
+    app.post('/api/tasks/:id/start', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        if (task.status !== 'draft') {
+            res.status(400).json({ error: 'Only draft tasks can be started' });
+            return;
+        }
+        await startTask(task);
+        const updated = db.prepare('SELECT * FROM tasks WHERE id = ?').get(task.id);
+        updated.agents = db
+            .prepare('SELECT * FROM agents WHERE task_id = ? ORDER BY window_index')
+            .all(task.id);
+        broadcast({ type: 'task:updated', payload: { taskId: task.id } });
+        res.json(updated);
+    });
+    // Delete task
+    app.delete('/api/tasks/:id', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        const taskId = task.id;
+        await deleteTask(task);
+        db.prepare('DELETE FROM agents WHERE task_id = ?').run(taskId);
+        db.prepare('DELETE FROM tasks WHERE id = ?').run(taskId);
+        broadcast({ type: 'task:deleted', payload: { taskId } });
+        res.status(204).send();
+    });
+    // Add agent to task
+    app.post('/api/tasks/:id/agents', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        if (task.status !== 'running') {
+            res.status(400).json({ error: 'Can only add agents to running tasks' });
+            return;
+        }
+        const body = req.body;
+        const agent = await addAgent(task, body.prompt);
+        broadcast({ type: 'task:updated', payload: { taskId: task.id } });
+        res.status(201).json(agent);
+    });
+    // Stop agent
+    app.delete('/api/tasks/:id/agents/:agentId', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        const agent = db
+            .prepare('SELECT * FROM agents WHERE id = ? AND task_id = ?')
+            .get(req.params.agentId, req.params.id);
+        if (!task || !agent) {
+            res.status(404).json({ error: 'Task or agent not found' });
+            return;
+        }
+        await stopAgent(task, agent);
+        broadcast({ type: 'task:updated', payload: { taskId: task.id } });
+        res.json({ success: true });
+    });
+    // Create user terminal (lazily creates tmux window with nvim)
+    app.post('/api/tasks/:id/user-terminal', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        if (task.status !== 'running') {
+            res.status(400).json({ error: 'Can only create user terminal for running tasks' });
+            return;
+        }
+        if (!task.tmux_session) {
+            res.status(400).json({ error: 'Task has no tmux session' });
+            return;
+        }
+        try {
+            const userWindowIndex = await createUserTerminal(task);
+            broadcast({ type: 'task:updated', payload: { taskId: task.id } });
+            res.json({ user_window_index: userWindowIndex });
+        }
+        catch (err) {
+            res.status(500).json({ error: err.message });
+        }
+    });
+    // Send message to agent via tmux send-keys
+    app.post('/api/tasks/:id/agents/:agentId/message', async (req, res) => {
+        const db = getDb();
+        const task = db.prepare('SELECT * FROM tasks WHERE id = ?').get(req.params.id);
+        if (!task) {
+            res.status(404).json({ error: 'Task not found' });
+            return;
+        }
+        if (task.status !== 'running') {
+            res.status(400).json({ error: 'Task is not running' });
+            return;
+        }
+        const agent = db
+            .prepare('SELECT * FROM agents WHERE id = ? AND task_id = ?')
+            .get(req.params.agentId, req.params.id);
+        if (!agent) {
+            res.status(404).json({ error: 'Agent not found' });
+            return;
+        }
+        const { message } = req.body;
+        if (!message) {
+            res.status(400).json({ error: 'message is required' });
+            return;
+        }
+        await execFile('tmux', [
+            'send-keys',
+            '-t',
+            `${task.tmux_session}:${agent.window_index}`,
+            message,
+            'Enter',
+        ]);
+        res.json({ success: true });
+    });
+    // ─── Orchestrator ──────────────────────────────────────────────────────────
+    app.get('/api/orchestrator/status', async (_req, res) => {
+        const running = await isOrchestratorRunning();
+        res.json({ running, session: getOrchestratorSession() });
+    });
+    app.post('/api/orchestrator/start', async (req, res) => {
+        const cwd = req.body?.cwd;
+        await startOrchestrator(cwd);
+        res.json({ running: true, session: getOrchestratorSession() });
+    });
+    app.post('/api/orchestrator/stop', async (_req, res) => {
+        await stopOrchestrator();
+        res.json({ running: false });
+    });
+}

package/dist-server/app.d.ts ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ import express from 'express';
2	+ export declare function createApp(): express.Express;

package/dist-server/app.js ADDED Viewed

@@ -0,0 +1,13 @@
+import express from 'express';
+import { setupRoutes } from './api.js';
+export function createApp() {
+    const app = express();
+    app.use(express.json({ limit: '1mb' }));
+    setupRoutes(app);
+    // Error handler
+    app.use((err, _req, res, _next) => {
+        console.error('Unhandled error:', err.message, err.stack);
+        res.status(500).json({ error: err.message });
+    });
+    return app;
+}

package/dist-server/db.d.ts ADDED Viewed

@@ -0,0 +1,7 @@
+import Database from 'better-sqlite3';
+export declare const SCHEMA = "\nCREATE TABLE IF NOT EXISTS tasks (\n    id           TEXT PRIMARY KEY,\n    title        TEXT NOT NULL,\n    description  TEXT NOT NULL,\n    repo_path    TEXT NOT NULL,\n    status       TEXT NOT NULL DEFAULT 'draft',\n    branch       TEXT,\n    base_branch  TEXT,\n    worktree     TEXT,\n    tmux_session TEXT,\n    pr_url       TEXT,\n    pr_number    INTEGER,\n    initial_prompt TEXT,\n    error        TEXT,\n    created_at   TEXT NOT NULL DEFAULT (datetime('now')),\n    updated_at   TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS agents (\n    id                TEXT PRIMARY KEY,\n    task_id           TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,\n    window_index      INTEGER NOT NULL,\n    label             TEXT NOT NULL,\n    status            TEXT NOT NULL DEFAULT 'running',\n    claude_session_id TEXT,\n    created_at        TEXT NOT NULL DEFAULT (datetime('now'))\n);\n\nCREATE TABLE IF NOT EXISTS permission_prompts (\n    id         TEXT PRIMARY KEY,\n    task_id    TEXT NOT NULL,\n    agent_id   TEXT,\n    session_id TEXT NOT NULL,\n    tool_name  TEXT NOT NULL,\n    tool_input TEXT NOT NULL DEFAULT '{}',\n    status     TEXT NOT NULL DEFAULT 'pending',\n    created_at TEXT NOT NULL DEFAULT (datetime('now')),\n    resolved_at TEXT,\n    FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,\n    FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE\n);\n\nCREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);\nCREATE INDEX IF NOT EXISTS idx_agents_task ON agents(task_id);\nCREATE INDEX IF NOT EXISTS idx_permission_prompts_task_id ON permission_prompts(task_id);\nCREATE INDEX IF NOT EXISTS idx_permission_prompts_status ON permission_prompts(status);\nCREATE INDEX IF NOT EXISTS idx_permission_prompts_agent_status ON permission_prompts(agent_id, status);\n";
+export declare function getDb(): Database.Database;
+/** Replace the singleton db instance (for testing). */
+export declare function setDb(instance: Database.Database): void;
+/** Initialize a database with schema and pragmas. */
+export declare function initDb(instance: Database.Database): void;

package/dist-server/db.js ADDED Viewed

@@ -0,0 +1,107 @@
+import Database from 'better-sqlite3';
+import path from 'path';
+import fs from 'fs';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DB_DIR = path.join(__dirname, '..', 'data');
+const DB_PATH = path.join(DB_DIR, 'tasks.db');
+export const SCHEMA = `
+CREATE TABLE IF NOT EXISTS tasks (
+    id           TEXT PRIMARY KEY,
+    title        TEXT NOT NULL,
+    description  TEXT NOT NULL,
+    repo_path    TEXT NOT NULL,
+    status       TEXT NOT NULL DEFAULT 'draft',
+    branch       TEXT,
+    base_branch  TEXT,
+    worktree     TEXT,
+    tmux_session TEXT,
+    pr_url       TEXT,
+    pr_number    INTEGER,
+    initial_prompt TEXT,
+    error        TEXT,
+    created_at   TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at   TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE TABLE IF NOT EXISTS agents (
+    id                TEXT PRIMARY KEY,
+    task_id           TEXT NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+    window_index      INTEGER NOT NULL,
+    label             TEXT NOT NULL,
+    status            TEXT NOT NULL DEFAULT 'running',
+    claude_session_id TEXT,
+    created_at        TEXT NOT NULL DEFAULT (datetime('now'))
+);
+CREATE TABLE IF NOT EXISTS permission_prompts (
+    id         TEXT PRIMARY KEY,
+    task_id    TEXT NOT NULL,
+    agent_id   TEXT,
+    session_id TEXT NOT NULL,
+    tool_name  TEXT NOT NULL,
+    tool_input TEXT NOT NULL DEFAULT '{}',
+    status     TEXT NOT NULL DEFAULT 'pending',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    resolved_at TEXT,
+    FOREIGN KEY (task_id) REFERENCES tasks(id) ON DELETE CASCADE,
+    FOREIGN KEY (agent_id) REFERENCES agents(id) ON DELETE CASCADE
+);
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+CREATE INDEX IF NOT EXISTS idx_agents_task ON agents(task_id);
+CREATE INDEX IF NOT EXISTS idx_permission_prompts_task_id ON permission_prompts(task_id);
+CREATE INDEX IF NOT EXISTS idx_permission_prompts_status ON permission_prompts(status);
+CREATE INDEX IF NOT EXISTS idx_permission_prompts_agent_status ON permission_prompts(agent_id, status);
+`;
+let db;
+export function getDb() {
+    if (!db) {
+        fs.mkdirSync(DB_DIR, { recursive: true });
+        db = new Database(DB_PATH);
+        initDb(db);
+    }
+    return db;
+}
+/** Replace the singleton db instance (for testing). */
+export function setDb(instance) {
+    db = instance;
+}
+/** Initialize a database with schema and pragmas. */
+export function initDb(instance) {
+    instance.pragma('journal_mode = WAL');
+    instance.pragma('foreign_keys = ON');
+    instance.exec(SCHEMA);
+    // Migrations
+    const cols = instance.pragma('table_info(tasks)');
+    const colNames = cols.map((c) => c.name);
+    if (!colNames.includes('initial_prompt')) {
+        instance.exec('ALTER TABLE tasks ADD COLUMN initial_prompt TEXT');
+    }
+    // Add claude_session_id to agents table (for existing DBs)
+    const agentCols = instance.pragma('table_info(agents)');
+    const agentColNames = agentCols.map((c) => c.name);
+    if (!agentColNames.includes('claude_session_id')) {
+        instance.exec('ALTER TABLE agents ADD COLUMN claude_session_id TEXT');
+    }
+    if (!colNames.includes('base_branch')) {
+        instance.exec('ALTER TABLE tasks ADD COLUMN base_branch TEXT');
+    }
+    if (!colNames.includes('user_window_index')) {
+        instance.exec('ALTER TABLE tasks ADD COLUMN user_window_index INTEGER');
+    }
+    // Add hook_activity columns to agents table (for existing DBs)
+    const agentCols2 = instance.pragma('table_info(agents)');
+    const agentColNames2 = agentCols2.map((c) => c.name);
+    if (!agentColNames2.includes('hook_activity')) {
+        instance.exec("ALTER TABLE agents ADD COLUMN hook_activity TEXT NOT NULL DEFAULT 'active'");
+        instance.exec('ALTER TABLE agents ADD COLUMN hook_activity_updated_at TEXT');
+    }
+    // Migrate any legacy 'created' status to 'draft' (old schema default)
+    instance.exec(`UPDATE tasks SET status = 'draft' WHERE status = 'created'`);
+    // Resolve any stale pending permission prompts from previous run
+    // and reset agents stuck in 'waiting' state (hooks lost during restart)
+    instance.exec(`UPDATE permission_prompts SET status = 'resolved', resolved_at = datetime('now') WHERE status = 'pending'`);
+    instance.exec(`UPDATE agents SET hook_activity = 'active', hook_activity_updated_at = datetime('now')
+     WHERE hook_activity = 'waiting' AND status = 'running'`);
+}

package/dist-server/events.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import type { IncomingMessage } from 'http';
+import type { Duplex } from 'stream';
+export interface ServerEvent {
+    type: 'task:updated' | 'task:created' | 'task:deleted';
+    payload: {
+        taskId: string;
+    };
+}
+export declare function setupEventWebSocket(): void;
+export declare function handleEventUpgrade(req: IncomingMessage, socket: Duplex, head: Buffer): boolean;
+export declare function broadcast(event: ServerEvent): void;
+export declare function getEventClientCount(): number;
+export declare function cleanupEventClients(): void;

package/dist-server/events.js ADDED Viewed

@@ -0,0 +1,35 @@
+import { WebSocketServer, WebSocket } from 'ws';
+const clients = new Set();
+let wss;
+export function setupEventWebSocket() {
+    wss = new WebSocketServer({ noServer: true });
+}
+export function handleEventUpgrade(req, socket, head) {
+    if (req.url !== '/ws/events')
+        return false;
+    wss.handleUpgrade(req, socket, head, (ws) => {
+        clients.add(ws);
+        ws.on('close', () => clients.delete(ws));
+        ws.on('error', () => clients.delete(ws));
+    });
+    return true;
+}
+export function broadcast(event) {
+    const message = JSON.stringify(event);
+    for (const client of clients) {
+        if (client.readyState === WebSocket.OPEN) {
+            client.send(message);
+        }
+    }
+}
+export function getEventClientCount() {
+    return clients.size;
+}
+export function cleanupEventClients() {
+    for (const client of clients) {
+        if (client.readyState === WebSocket.OPEN) {
+            client.close(1001, 'Server shutting down');
+        }
+    }
+    clients.clear();
+}

package/dist-server/hook-settings.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+/**
+ * Install Claude Code hook settings into a worktree's `.claude/settings.local.json`.
+ * Merges with any existing settings, preserving non-hook keys and non-overlapping hook events.
+ */
+export declare function installHookSettings(worktreePath: string): void;