agent-tasks 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 keshrath
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,74 @@
+# agent-tasks
+
+Pipeline-driven task management for AI coding agents. An [MCP](https://modelcontextprotocol.io/) server that provides stage-gated task pipelines with dependencies, artifacts, and multi-agent claiming.
+
+Part of the **agent-\*** family: [`agent-comm`](https://github.com/keshrath/agent-comm) (messaging) + `agent-tasks` (pipeline).
+
+## Features
+
+- **Pipeline stages** — tasks flow through configurable stages: `backlog → spec → plan → implement → test → review → done`
+- **Dependencies** — tasks can depend on other tasks; advancement is blocked until dependencies are met (with cycle detection)
+- **Artifacts** — attach specs, plans, test results, review notes to tasks at each stage
+- **Multi-agent claiming** — agents claim tasks from a shared queue; highest-priority unblocked task is served first
+- **Per-project pipelines** — customize stage definitions per project
+- **SQLite storage** — WAL-mode SQLite via better-sqlite3 for concurrent access
+
+## Quick Start
+
+```bash
+npm install
+npm run build
+```
+
+### As an MCP server (stdio)
+
+```json
+{
+  "mcpServers": {
+    "agent-tasks": {
+      "command": "node",
+      "args": ["/path/to/agent-tasks/dist/index.js"]
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool                     | Description                                                               |
+| ------------------------ | ------------------------------------------------------------------------- |
+| `task_create`            | Create a task with title, description, stage, priority, project, tags     |
+| `task_list`              | List tasks with filters (status, assignee, stage, project) and pagination |
+| `task_claim`             | Claim a pending task — assigns it and advances from backlog               |
+| `task_complete`          | Mark a task as completed with a result                                    |
+| `task_fail`              | Mark a task as failed with an error                                       |
+| `task_cancel`            | Cancel a task                                                             |
+| `task_advance`           | Advance to the next (or a specific) stage; checks dependencies            |
+| `task_regress`           | Send a task back to an earlier stage (e.g. review rejection)              |
+| `task_update`            | Update task metadata (title, description, priority, tags, assignee)       |
+| `task_next`              | Get the highest-priority unassigned task with all dependencies met        |
+| `task_add_dependency`    | Add a dependency between tasks (with cycle detection)                     |
+| `task_remove_dependency` | Remove a dependency                                                       |
+| `task_add_artifact`      | Attach a document/artifact to a task at a specific stage                  |
+| `task_get_artifacts`     | Retrieve artifacts for a task                                             |
+| `task_pipeline_config`   | Get or set pipeline stages for a project                                  |
+| `task_set_session`       | Set the session identity for tracking who creates/claims tasks            |
+
+## Configuration
+
+| Environment Variable | Description                          | Default                    |
+| -------------------- | ------------------------------------ | -------------------------- |
+| `AGENT_TASKS_DB`     | Path to SQLite database              | `~/.claude/agent-tasks.db` |
+| `AGENT_TASKS_TEST`   | Use in-memory database (for testing) | —                          |
+
+## Development
+
+```bash
+npm run dev          # watch mode
+npm test             # run tests
+npm run check        # typecheck + lint + format + test
+```
+
+## License
+
+MIT

package/dist/context.d.ts

@@ -0,0 +1,17 @@
+import { type Db, type DbOptions } from './storage/database.js';
+import { EventBus } from './domain/events.js';
+import { TaskService } from './domain/tasks.js';
+import { CommentService } from './domain/comments.js';
+import { CollaboratorService } from './domain/collaborators.js';
+import { ApprovalService } from './domain/approvals.js';
+export interface AppContext {
+    readonly db: Db;
+    readonly events: EventBus;
+    readonly tasks: TaskService;
+    readonly comments: CommentService;
+    readonly collaborators: CollaboratorService;
+    readonly approvals: ApprovalService;
+    close(): void;
+}
+export declare function createContext(dbOptions?: DbOptions): AppContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAOA,OAAO,EAAY,KAAK,EAAE,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,EAAE,CAAC;IAChB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAwB/D"}

package/dist/context.js

@@ -0,0 +1,37 @@
+// =============================================================================
+// agent-tasks — Application context
+//
+// Dependency injection root. Creates and wires together all services.
+// Every layer receives its dependencies explicitly — no global state.
+// =============================================================================
+import { createDb } from './storage/database.js';
+import { EventBus } from './domain/events.js';
+import { TaskService } from './domain/tasks.js';
+import { CommentService } from './domain/comments.js';
+import { CollaboratorService } from './domain/collaborators.js';
+import { ApprovalService } from './domain/approvals.js';
+export function createContext(dbOptions) {
+    const db = createDb(dbOptions);
+    const events = new EventBus();
+    let closed = false;
+    const tasks = new TaskService(db, events);
+    const comments = new CommentService(db, events);
+    const collaborators = new CollaboratorService(db, events);
+    const approvals = new ApprovalService(db, events);
+    return {
+        db,
+        events,
+        tasks,
+        comments,
+        collaborators,
+        approvals,
+        close() {
+            if (closed)
+                return;
+            closed = true;
+            events.removeAll();
+            db.close();
+        },
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,oCAAoC;AACpC,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,gFAAgF;AAEhF,OAAO,EAAE,QAAQ,EAA2B,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAYxD,MAAM,UAAU,aAAa,CAAC,SAAqB;IACjD,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAC9B,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,IAAI,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAElD,OAAO;QACL,EAAE;QACF,MAAM;QACN,KAAK;QACL,QAAQ;QACR,aAAa;QACb,SAAS;QACT,KAAK;YACH,IAAI,MAAM;gBAAE,OAAO;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,CAAC,SAAS,EAAE,CAAC;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,10 @@
+import Database from 'better-sqlite3';
+export declare function log(level: string, msg: string): void;
+export declare function initDb(): Promise<Database.Database>;
+export declare function getDb(): Database.Database;
+export declare function transaction<T>(fn: () => T): T;
+export declare function queryAll<T>(sql: string, params?: unknown[]): T[];
+export declare function queryOne<T>(sql: string, params?: unknown[]): T | null;
+export declare function run(sql: string, params?: unknown[]): Database.RunResult;
+export declare function closeDb(): void;
+//# sourceMappingURL=db.d.ts.map

package/dist/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAqBzD;AAED,wBAAgB,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAGzC;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAG7C;AAuDD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAIhE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI,CAKrE;AAED,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAC,SAAS,CAIvE;AAED,wBAAgB,OAAO,IAAI,IAAI,CAS9B"}

package/dist/db.js

@@ -0,0 +1,112 @@
+import Database from 'better-sqlite3';
+import { homedir } from 'os';
+import { join } from 'path';
+import { mkdirSync } from 'fs';
+let db = null;
+export function log(level, msg) {
+    process.stderr.write(`[agent-tasks:${level}] ${new Date().toISOString()} ${msg}\n`);
+}
+export async function initDb() {
+    if (db)
+        return db;
+    const inMemory = !!process.env.AGENT_TASKS_TEST;
+    if (inMemory) {
+        db = new Database(':memory:');
+    }
+    else {
+        const dir = join(homedir(), '.claude');
+        mkdirSync(dir, { recursive: true });
+        const dbPath = process.env.AGENT_TASKS_DB || join(dir, 'agent-tasks.db');
+        db = new Database(dbPath);
+    }
+    db.pragma('journal_mode = WAL');
+    db.pragma('busy_timeout = 5000');
+    db.pragma('synchronous = NORMAL');
+    db.pragma('foreign_keys = ON');
+    initSchema(db);
+    return db;
+}
+export function getDb() {
+    if (!db)
+        throw new Error('Database not initialized. Call initDb() first.');
+    return db;
+}
+export function transaction(fn) {
+    const database = getDb();
+    return database.transaction(fn)();
+}
+function initSchema(database) {
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS tasks (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      title TEXT NOT NULL,
+      description TEXT,
+      created_by TEXT NOT NULL,
+      assigned_to TEXT,
+      status TEXT NOT NULL DEFAULT 'pending',
+      stage TEXT NOT NULL DEFAULT 'backlog',
+      priority INTEGER NOT NULL DEFAULT 0,
+      project TEXT,
+      tags TEXT,
+      result TEXT,
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    database.exec(`CREATE INDEX IF NOT EXISTS idx_tasks_assigned ON tasks(assigned_to, status)`);
+    database.exec(`CREATE INDEX IF NOT EXISTS idx_tasks_stage ON tasks(stage, priority)`);
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS task_dependencies (
+      task_id INTEGER NOT NULL,
+      depends_on INTEGER NOT NULL,
+      PRIMARY KEY (task_id, depends_on)
+    )
+  `);
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS task_artifacts (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      task_id INTEGER NOT NULL,
+      stage TEXT NOT NULL,
+      name TEXT NOT NULL,
+      content TEXT NOT NULL,
+      created_by TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+    database.exec(`CREATE INDEX IF NOT EXISTS idx_task_artifacts_task ON task_artifacts(task_id, stage)`);
+    database.exec(`
+    CREATE TABLE IF NOT EXISTS pipeline_config (
+      project TEXT PRIMARY KEY,
+      stages TEXT NOT NULL DEFAULT '["backlog","spec","plan","implement","test","review","done","cancelled"]',
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+}
+export function queryAll(sql, params) {
+    const database = getDb();
+    const stmt = database.prepare(sql);
+    return (params?.length ? stmt.all(...params) : stmt.all());
+}
+export function queryOne(sql, params) {
+    const database = getDb();
+    const stmt = database.prepare(sql);
+    const row = params?.length ? stmt.get(...params) : stmt.get();
+    return row ?? null;
+}
+export function run(sql, params) {
+    const database = getDb();
+    const stmt = database.prepare(sql);
+    return params?.length ? stmt.run(...params) : stmt.run();
+}
+export function closeDb() {
+    if (db) {
+        try {
+            db.close();
+        }
+        catch (e) {
+            log('warn', `Error closing db: ${e}`);
+        }
+        db = null;
+    }
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

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

package/dist/domain/agent-bridge.d.ts

@@ -0,0 +1,13 @@
+import type { EventBus } from './events.js';
+export declare class AgentBridge {
+    private readonly events;
+    private unsubs;
+    constructor(events: EventBus);
+    start(): void;
+    stop(): void;
+    fetchAgents(): Promise<unknown[]>;
+    private notify;
+    private notifyChannel;
+    private postMessage;
+}
+//# sourceMappingURL=agent-bridge.d.ts.map

package/dist/domain/agent-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-bridge.d.ts","sourceRoot":"","sources":["../../src/domain/agent-bridge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI5C,qBAAa,WAAW;IAGV,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,MAAM,CAAsB;gBAEP,MAAM,EAAE,QAAQ;IAE7C,KAAK,IAAI,IAAI;IAiDb,IAAI,IAAI,IAAI;IAKZ,WAAW,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAuBjC,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;CA6BpB"}

package/dist/domain/agent-bridge.js

@@ -0,0 +1,99 @@
+// =============================================================================
+// agent-tasks — Agent-comm bridge
+//
+// Listens to task events and forwards notifications to agents via
+// agent-comm's REST API. Lightweight runtime integration — no npm dependency.
+// =============================================================================
+import http from 'http';
+const AGENT_COMM_URL = process.env.AGENT_COMM_URL || 'http://localhost:3421';
+export class AgentBridge {
+    events;
+    unsubs = [];
+    constructor(events) {
+        this.events = events;
+    }
+    start() {
+        this.unsubs.push(this.events.on('task:claimed', (e) => {
+            const task = e.data.task;
+            if (task.assigned_to) {
+                this.notify(`Task #${task.id} "${task.title}" has been assigned to you.`, task.assigned_to);
+            }
+        }));
+        this.unsubs.push(this.events.on('task:advanced', (e) => {
+            const task = e.data.task;
+            const toStage = e.data.to_stage;
+            if (task.assigned_to) {
+                this.notify(`Task #${task.id} "${task.title}" advanced to ${toStage}.`, task.assigned_to);
+            }
+        }));
+        this.unsubs.push(this.events.on('comment:created', (e) => {
+            const comment = e.data.comment;
+            this.notifyChannel(`Comment on task #${comment.task_id} by ${comment.agent_id}: ${comment.content.slice(0, 100)}`);
+        }));
+        this.unsubs.push(this.events.on('approval:requested', (e) => {
+            const approval = e.data.approval;
+            if (approval.reviewer) {
+                this.notify(`Approval requested for task #${approval.task_id} at stage ${approval.stage}.`, approval.reviewer);
+            }
+        }));
+    }
+    stop() {
+        for (const unsub of this.unsubs)
+            unsub();
+        this.unsubs = [];
+    }
+    fetchAgents() {
+        return new Promise((resolve) => {
+            const url = new URL('/api/agents', AGENT_COMM_URL);
+            http
+                .get(url, { timeout: 3000 }, (res) => {
+                let body = '';
+                res.on('data', (c) => (body += c));
+                res.on('end', () => {
+                    try {
+                        resolve(JSON.parse(body));
+                    }
+                    catch {
+                        resolve([]);
+                    }
+                });
+            })
+                .on('error', () => resolve([]))
+                .on('timeout', function () {
+                this.destroy();
+                resolve([]);
+            });
+        });
+    }
+    notify(content, agentName) {
+        this.postMessage({ to: agentName, content }).catch(() => { });
+    }
+    notifyChannel(content) {
+        this.postMessage({ channel: 'general', content }).catch(() => { });
+    }
+    postMessage(payload) {
+        return new Promise((resolve) => {
+            const data = JSON.stringify({ ...payload, from: 'agent-tasks' });
+            const url = new URL('/api/messages', AGENT_COMM_URL);
+            const req = http.request({
+                hostname: url.hostname,
+                port: url.port,
+                path: url.pathname,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(data),
+                },
+                timeout: 3000,
+            }, () => resolve());
+            req.on('error', () => resolve());
+            req.on('timeout', () => {
+                req.destroy();
+                resolve();
+            });
+            req.write(data);
+            req.end();
+        });
+    }
+}
+//# sourceMappingURL=agent-bridge.js.map

package/dist/domain/agent-bridge.js.map

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

package/dist/domain/approvals.d.ts

@@ -0,0 +1,18 @@
+import type { Db } from '../storage/database.js';
+import type { EventBus } from './events.js';
+import type { TaskApproval } from '../types.js';
+export declare class ApprovalService {
+    private readonly db;
+    private readonly events;
+    constructor(db: Db, events: EventBus);
+    request(taskId: number, stage: string, reviewer?: string): TaskApproval;
+    approve(approvalId: number, reviewer: string, comment?: string): TaskApproval;
+    reject(approvalId: number, reviewer: string, comment?: string): TaskApproval;
+    getPending(reviewer?: string): TaskApproval[];
+    getForTask(taskId: number): TaskApproval[];
+    isApprovalRequired(stage: string, project?: string): boolean;
+    hasPendingApproval(taskId: number, stage: string): boolean;
+    isApproved(taskId: number, stage: string): boolean;
+    private resolve;
+}
+//# sourceMappingURL=approvals.d.ts.map

package/dist/domain/approvals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/domain/approvals.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,aAAa,CAAC;AAIhE,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,QAAQ;IAGnC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY;IA6BvE,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IAK7E,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,YAAY;IAM5E,UAAU,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE;IAY7C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,EAAE;IAO1C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO;IAkB5D,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQ1D,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO;IAQlD,OAAO,CAAC,OAAO;CA4BhB"}

package/dist/domain/approvals.js

@@ -0,0 +1,89 @@
+// =============================================================================
+// agent-tasks — Approval domain service
+//
+// Stage-gated approvals for pipeline advancement.
+// =============================================================================
+import { NotFoundError, ConflictError, ValidationError } from '../types.js';
+import { rejectNullBytes } from './validate.js';
+export class ApprovalService {
+    db;
+    events;
+    constructor(db, events) {
+        this.db = db;
+        this.events = events;
+    }
+    request(taskId, stage, reviewer) {
+        const task = this.db.queryOne('SELECT id, project FROM tasks WHERE id = ?', [taskId]);
+        if (!task)
+            throw new NotFoundError('Task', taskId);
+        const existing = this.db.queryOne(`SELECT * FROM task_approvals WHERE task_id = ? AND stage = ? AND status = 'pending'`, [taskId, stage]);
+        if (existing)
+            throw new ConflictError(`Pending approval already exists for task ${taskId} at stage ${stage}.`);
+        const result = this.db.run(`INSERT INTO task_approvals (task_id, stage, reviewer) VALUES (?, ?, ?)`, [taskId, stage, reviewer ?? null]);
+        const approval = this.db.queryOne('SELECT * FROM task_approvals WHERE id = ?', [
+            Number(result.lastInsertRowid),
+        ]);
+        this.events.emit('approval:requested', { approval });
+        return approval;
+    }
+    approve(approvalId, reviewer, comment) {
+        rejectNullBytes(reviewer, 'reviewer');
+        return this.resolve(approvalId, 'approved', reviewer, comment);
+    }
+    reject(approvalId, reviewer, comment) {
+        rejectNullBytes(reviewer, 'reviewer');
+        if (!comment?.trim())
+            throw new ValidationError('Rejection requires a comment.');
+        return this.resolve(approvalId, 'rejected', reviewer, comment);
+    }
+    getPending(reviewer) {
+        if (reviewer) {
+            return this.db.queryAll(`SELECT * FROM task_approvals WHERE status = 'pending' AND (reviewer = ? OR reviewer IS NULL) ORDER BY requested_at ASC`, [reviewer]);
+        }
+        return this.db.queryAll(`SELECT * FROM task_approvals WHERE status = 'pending' ORDER BY requested_at ASC`);
+    }
+    getForTask(taskId) {
+        return this.db.queryAll('SELECT * FROM task_approvals WHERE task_id = ? ORDER BY requested_at DESC', [taskId]);
+    }
+    isApprovalRequired(stage, project) {
+        if (!project)
+            return false;
+        const config = this.db.queryOne('SELECT * FROM pipeline_config WHERE project = ?', [project]);
+        if (!config?.approval_config)
+            return false;
+        try {
+            const approvalConfig = JSON.parse(config.approval_config);
+            return !!approvalConfig[stage]?.required;
+        }
+        catch {
+            return false;
+        }
+    }
+    hasPendingApproval(taskId, stage) {
+        const pending = this.db.queryOne(`SELECT id FROM task_approvals WHERE task_id = ? AND stage = ? AND status = 'pending'`, [taskId, stage]);
+        return !!pending;
+    }
+    isApproved(taskId, stage) {
+        const approved = this.db.queryOne(`SELECT id FROM task_approvals WHERE task_id = ? AND stage = ? AND status = 'approved'`, [taskId, stage]);
+        return !!approved;
+    }
+    resolve(approvalId, status, reviewer, comment) {
+        const approval = this.db.queryOne('SELECT * FROM task_approvals WHERE id = ?', [
+            approvalId,
+        ]);
+        if (!approval)
+            throw new NotFoundError('Approval', approvalId);
+        if (approval.status !== 'pending') {
+            throw new ConflictError(`Approval ${approvalId} is already ${approval.status}.`);
+        }
+        this.db.run(`UPDATE task_approvals SET status = ?, reviewer = ?, resolved_at = datetime('now'), comment = ? WHERE id = ?`, [status, reviewer, comment ?? null, approvalId]);
+        const resolved = this.db.queryOne('SELECT * FROM task_approvals WHERE id = ?', [
+            approvalId,
+        ]);
+        this.events.emit(status === 'approved' ? 'approval:approved' : 'approval:rejected', {
+            approval: resolved,
+        });
+        return resolved;
+    }
+}
+//# sourceMappingURL=approvals.js.map

package/dist/domain/approvals.js.map

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

package/dist/domain/cleanup.d.ts

@@ -0,0 +1,28 @@
+import type { Db } from '../storage/database.js';
+export declare class CleanupService {
+    private readonly db;
+    private readonly retentionDays;
+    private timer;
+    constructor(db: Db, retentionDays?: number);
+    start(): void;
+    stop(): void;
+    run(): {
+        purgedTasks: number;
+        purgedComments: number;
+        purgedArtifacts: number;
+        purgedApprovals: number;
+    };
+    purgeAll(): {
+        purgedTasks: number;
+        purgedComments: number;
+        purgedArtifacts: number;
+        purgedApprovals: number;
+    };
+    purgeEverything(): {
+        purgedTasks: number;
+        purgedComments: number;
+        purgedArtifacts: number;
+        purgedApprovals: number;
+    };
+}
+//# sourceMappingURL=cleanup.d.ts.map

package/dist/domain/cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup.d.ts","sourceRoot":"","sources":["../../src/domain/cleanup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAC;AAEjD,qBAAa,cAAc;IAIvB,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,aAAa;IAJhC,OAAO,CAAC,KAAK,CAA+C;gBAGzC,EAAE,EAAE,EAAE,EACN,aAAa,GAAE,MAAW;IAG7C,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAOZ,GAAG,IAAI;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB;IAmCD,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB;IAoBD,eAAe,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB;CAaF"}

package/dist/domain/cleanup.js

@@ -0,0 +1,68 @@
+export class CleanupService {
+    db;
+    retentionDays;
+    timer = null;
+    constructor(db, retentionDays = 30) {
+        this.db = db;
+        this.retentionDays = retentionDays;
+    }
+    start() {
+        // Run cleanup every hour
+        this.timer = setInterval(() => this.run(), 60 * 60 * 1000);
+        this.timer.unref();
+        // Run once on start (delayed 10s)
+        setTimeout(() => this.run(), 10_000).unref();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    run() {
+        const cutoff = new Date(Date.now() - this.retentionDays * 24 * 60 * 60 * 1000)
+            .toISOString()
+            .replace('T', ' ')
+            .slice(0, 19);
+        const tasks = this.db.run(`DELETE FROM tasks WHERE status IN ('completed', 'cancelled') AND updated_at < ?`, [cutoff]);
+        // Orphaned comments (task deleted via CASCADE should handle this, but just in case)
+        const comments = this.db.run(`DELETE FROM task_comments WHERE task_id NOT IN (SELECT id FROM tasks)`);
+        // Orphaned artifacts (defensive — CASCADE should handle this)
+        const artifacts = this.db.run(`DELETE FROM task_artifacts WHERE task_id NOT IN (SELECT id FROM tasks)`);
+        // Resolved approvals older than retention
+        const approvals = this.db.run(`DELETE FROM task_approvals WHERE status != 'pending' AND resolved_at < ?`, [cutoff]);
+        return {
+            purgedTasks: tasks.changes,
+            purgedComments: comments.changes,
+            purgedArtifacts: artifacts.changes,
+            purgedApprovals: approvals.changes,
+        };
+    }
+    purgeAll() {
+        // Purge completed/cancelled by status OR tasks in done/cancelled stage
+        const tasks = this.db.run(`DELETE FROM tasks WHERE status IN ('completed', 'cancelled') OR stage IN ('done', 'cancelled')`);
+        const comments = this.db.run(`DELETE FROM task_comments WHERE task_id NOT IN (SELECT id FROM tasks)`);
+        const artifacts = this.db.run(`DELETE FROM task_artifacts WHERE task_id NOT IN (SELECT id FROM tasks)`);
+        const approvals = this.db.run(`DELETE FROM task_approvals WHERE status != 'pending'`);
+        return {
+            purgedTasks: tasks.changes,
+            purgedComments: comments.changes,
+            purgedArtifacts: artifacts.changes,
+            purgedApprovals: approvals.changes,
+        };
+    }
+    purgeEverything() {
+        // Nuclear option — delete ALL tasks regardless of status/stage
+        const tasks = this.db.run(`DELETE FROM tasks`);
+        const comments = this.db.run(`DELETE FROM task_comments`);
+        const artifacts = this.db.run(`DELETE FROM task_artifacts`);
+        const approvals = this.db.run(`DELETE FROM task_approvals`);
+        return {
+            purgedTasks: tasks.changes,
+            purgedComments: comments.changes,
+            purgedArtifacts: artifacts.changes,
+            purgedApprovals: approvals.changes,
+        };
+    }
+}
+//# sourceMappingURL=cleanup.js.map