@taskyard/mcp-server 1.0.0-beta.1

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.
@@ -0,0 +1,11 @@
1
+ export interface Config {
2
+ project: string;
3
+ version: string;
4
+ heartbeat_interval_seconds: number;
5
+ lock_timeout_seconds: number;
6
+ stall_threshold_seconds: number;
7
+ max_attempts_before_escalation: number;
8
+ dashboard_port: number;
9
+ }
10
+ export declare function loadConfig(root: string): Promise<Config>;
11
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,uBAAuB,EAAE,MAAM,CAAC;IAChC,8BAA8B,EAAE,MAAM,CAAC;IACvC,cAAc,EAAE,MAAM,CAAC;CACxB;AAYD,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK9D"}
package/dist/config.js ADDED
@@ -0,0 +1,19 @@
1
+ import fs from "fs/promises";
2
+ import path from "path";
3
+ const DEFAULTS = {
4
+ project: "default",
5
+ version: "0.1.0",
6
+ heartbeat_interval_seconds: 300,
7
+ lock_timeout_seconds: 600,
8
+ stall_threshold_seconds: 1800,
9
+ max_attempts_before_escalation: 3,
10
+ dashboard_port: 3456,
11
+ };
12
+ export async function loadConfig(root) {
13
+ const configPath = path.join(root, ".taskyard/config.json");
14
+ const raw = await fs.readFile(configPath, "utf-8").catch(() => null);
15
+ if (!raw)
16
+ return DEFAULTS;
17
+ return { ...DEFAULTS, ...JSON.parse(raw) };
18
+ }
19
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAYxB,MAAM,QAAQ,GAAW;IACvB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,OAAO;IAChB,0BAA0B,EAAE,GAAG;IAC/B,oBAAoB,EAAE,GAAG;IACzB,uBAAuB,EAAE,IAAI;IAC7B,8BAA8B,EAAE,CAAC;IACjC,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,GAAG;QAAE,OAAO,QAAQ,CAAC;IAC1B,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;AAC7C,CAAC"}
@@ -0,0 +1,6 @@
1
+ import http from "http";
2
+ import type { FileStore } from "./store.js";
3
+ type ToolHandler = (args: Record<string, unknown>) => Promise<unknown>;
4
+ export declare function createHttpAdapter(store: FileStore, toolHandlers: Map<string, ToolHandler>, port: number): http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>;
5
+ export {};
6
+ //# sourceMappingURL=http-adapter.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-adapter.d.ts","sourceRoot":"","sources":["../src/http-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAIxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK5C,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEvE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,wEAmFvG"}
@@ -0,0 +1,91 @@
1
+ import http from "http";
2
+ import fs from "fs/promises";
3
+ import path from "path";
4
+ import { fileURLToPath } from "url";
5
+ export function createHttpAdapter(store, toolHandlers, port) {
6
+ const dashboardDist = path.join(path.dirname(fileURLToPath(import.meta.url)), "../../dashboard/dist");
7
+ const server = http.createServer(async (req, res) => {
8
+ const url = new URL(req.url ?? "/", `http://localhost:${port}`);
9
+ // ── CORS for local dev ─────────────────────────────────────────────────
10
+ res.setHeader("Access-Control-Allow-Origin", "*");
11
+ res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
12
+ res.setHeader("Access-Control-Allow-Headers", "Content-Type");
13
+ if (req.method === "OPTIONS") {
14
+ res.writeHead(204);
15
+ res.end();
16
+ return;
17
+ }
18
+ // ── /api/tool POST ────────────────────────────────────────────────────
19
+ if (url.pathname === "/api/tool" && req.method === "POST") {
20
+ const body = await readBody(req);
21
+ const { tool, args } = JSON.parse(body);
22
+ const handler = toolHandlers.get(tool);
23
+ if (!handler) {
24
+ res.writeHead(404, { "Content-Type": "application/json" });
25
+ res.end(JSON.stringify({ error: `Unknown tool: ${tool}` }));
26
+ return;
27
+ }
28
+ try {
29
+ const result = await handler(args);
30
+ res.writeHead(200, { "Content-Type": "application/json" });
31
+ res.end(JSON.stringify(result));
32
+ }
33
+ catch (e) {
34
+ res.writeHead(400, { "Content-Type": "application/json" });
35
+ res.end(JSON.stringify({ error: String(e) }));
36
+ }
37
+ return;
38
+ }
39
+ // ── /api/projects GET ─────────────────────────────────────────────────
40
+ if (url.pathname === "/api/projects" && req.method === "GET") {
41
+ const projectsDir = path.join(store.root, "projects");
42
+ const entries = await fs.readdir(projectsDir, { withFileTypes: true }).catch(() => []);
43
+ const names = entries.filter(e => e.isDirectory()).map(e => e.name);
44
+ res.writeHead(200, { "Content-Type": "application/json" });
45
+ res.end(JSON.stringify(names));
46
+ return;
47
+ }
48
+ // ── /api/changelog GET ────────────────────────────────────────────────
49
+ if (url.pathname === "/api/changelog" && req.method === "GET") {
50
+ const log = await fs.readFile(path.join(store.root, "CHANGELOG.md"), "utf-8").catch(() => "");
51
+ res.writeHead(200, { "Content-Type": "text/plain" });
52
+ res.end(log);
53
+ return;
54
+ }
55
+ // ── Static dashboard assets ────────────────────────────────────────────
56
+ let filePath = path.join(dashboardDist, url.pathname === "/" ? "index.html" : url.pathname);
57
+ const exists = await fs.access(filePath).then(() => true).catch(() => false);
58
+ if (!exists)
59
+ filePath = path.join(dashboardDist, "index.html"); // SPA fallback
60
+ const ext = path.extname(filePath);
61
+ const mime = {
62
+ ".html": "text/html",
63
+ ".js": "application/javascript",
64
+ ".css": "text/css",
65
+ ".svg": "image/svg+xml",
66
+ ".ico": "image/x-icon",
67
+ };
68
+ try {
69
+ const content = await fs.readFile(filePath);
70
+ res.writeHead(200, { "Content-Type": mime[ext] ?? "application/octet-stream" });
71
+ res.end(content);
72
+ }
73
+ catch {
74
+ res.writeHead(404);
75
+ res.end("Not found");
76
+ }
77
+ });
78
+ server.listen(port, () => {
79
+ console.error(`taskyard dashboard: http://localhost:${port}`);
80
+ });
81
+ return server;
82
+ }
83
+ function readBody(req) {
84
+ return new Promise((resolve, reject) => {
85
+ let body = "";
86
+ req.on("data", chunk => (body += chunk));
87
+ req.on("end", () => resolve(body));
88
+ req.on("error", reject);
89
+ });
90
+ }
91
+ //# sourceMappingURL=http-adapter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http-adapter.js","sourceRoot":"","sources":["../src/http-adapter.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export declare function startServer(root: string): Promise<void>;
2
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,iBAsB7C"}
package/dist/index.js ADDED
@@ -0,0 +1,33 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
3
+ import { registerTaskTools } from "./tools/tasks.js";
4
+ import { registerGitTools } from "./tools/git.js";
5
+ import { registerStatusTools } from "./tools/status.js";
6
+ import { Watchdog } from "./watchdog/watchdog.js";
7
+ import { FileStore } from "./store.js";
8
+ import { loadConfig } from "./config.js";
9
+ export async function startServer(root) {
10
+ const config = await loadConfig(root);
11
+ const store = new FileStore(root, config);
12
+ const server = new McpServer({
13
+ name: "taskyard",
14
+ version: "0.1.0",
15
+ });
16
+ // Register all tool groups
17
+ registerTaskTools(server, store);
18
+ registerGitTools(server, store);
19
+ registerStatusTools(server, store);
20
+ // Start watchdog (heartbeat expiry + stall detection)
21
+ const watchdog = new Watchdog(store, config);
22
+ watchdog.start();
23
+ // Connect transport
24
+ const transport = new StdioServerTransport();
25
+ await server.connect(transport);
26
+ console.error(`taskyard MCP server running — root: ${root}`);
27
+ }
28
+ // CLI entry: node dist/index.js --root /path/to/repo
29
+ const args = process.argv.slice(2);
30
+ const rootIdx = args.indexOf("--root");
31
+ const root = rootIdx !== -1 ? args[rootIdx + 1] : process.cwd();
32
+ startServer(root).catch(console.error);
33
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAY;IAC5C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,2BAA2B;IAC3B,iBAAiB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,gBAAgB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAChC,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAEnC,sDAAsD;IACtD,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,CAAC;IAEjB,oBAAoB;IACpB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,uCAAuC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,qDAAqD;AACrD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AACvC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;AAChE,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
@@ -0,0 +1,64 @@
1
+ import { z } from "zod";
2
+ export declare const TaskStatus: z.ZodEnum<["backlog", "in-progress", "review", "done", "blocked"]>;
3
+ export declare const TaskPriority: z.ZodEnum<["low", "medium", "high", "critical"]>;
4
+ export declare const RecoveryStrategy: z.ZodEnum<["resume", "restart"]>;
5
+ export declare const TaskFrontmatter: z.ZodObject<{
6
+ id: z.ZodString;
7
+ title: z.ZodString;
8
+ status: z.ZodEnum<["backlog", "in-progress", "review", "done", "blocked"]>;
9
+ priority: z.ZodDefault<z.ZodEnum<["low", "medium", "high", "critical"]>>;
10
+ assigned_to: z.ZodDefault<z.ZodNullable<z.ZodString>>;
11
+ claimed_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
12
+ last_heartbeat: z.ZodDefault<z.ZodNullable<z.ZodString>>;
13
+ last_progress_at: z.ZodDefault<z.ZodNullable<z.ZodString>>;
14
+ heartbeat_interval: z.ZodDefault<z.ZodNumber>;
15
+ needs_handoff: z.ZodDefault<z.ZodBoolean>;
16
+ attempt_count: z.ZodDefault<z.ZodNumber>;
17
+ previous_agents: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
18
+ depends_on: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
19
+ tags: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
20
+ created_by: z.ZodDefault<z.ZodString>;
21
+ recovery_strategy: z.ZodDefault<z.ZodEnum<["resume", "restart"]>>;
22
+ project: z.ZodString;
23
+ }, "strip", z.ZodTypeAny, {
24
+ project: string;
25
+ id: string;
26
+ title: string;
27
+ status: "backlog" | "in-progress" | "review" | "done" | "blocked";
28
+ priority: "low" | "medium" | "high" | "critical";
29
+ assigned_to: string | null;
30
+ claimed_at: string | null;
31
+ last_heartbeat: string | null;
32
+ last_progress_at: string | null;
33
+ heartbeat_interval: number;
34
+ needs_handoff: boolean;
35
+ attempt_count: number;
36
+ previous_agents: string[];
37
+ depends_on: string[];
38
+ tags: string[];
39
+ created_by: string;
40
+ recovery_strategy: "resume" | "restart";
41
+ }, {
42
+ project: string;
43
+ id: string;
44
+ title: string;
45
+ status: "backlog" | "in-progress" | "review" | "done" | "blocked";
46
+ priority?: "low" | "medium" | "high" | "critical" | undefined;
47
+ assigned_to?: string | null | undefined;
48
+ claimed_at?: string | null | undefined;
49
+ last_heartbeat?: string | null | undefined;
50
+ last_progress_at?: string | null | undefined;
51
+ heartbeat_interval?: number | undefined;
52
+ needs_handoff?: boolean | undefined;
53
+ attempt_count?: number | undefined;
54
+ previous_agents?: string[] | undefined;
55
+ depends_on?: string[] | undefined;
56
+ tags?: string[] | undefined;
57
+ created_by?: string | undefined;
58
+ recovery_strategy?: "resume" | "restart" | undefined;
59
+ }>;
60
+ export type Task = z.infer<typeof TaskFrontmatter>;
61
+ export type TaskStatusType = z.infer<typeof TaskStatus>;
62
+ export declare const VALID_TRANSITIONS: Record<TaskStatusType, TaskStatusType[]>;
63
+ export declare function isValidTransition(from: TaskStatusType, to: TaskStatusType): boolean;
64
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,UAAU,oEAMrB,CAAC;AAEH,eAAO,MAAM,YAAY,kDAAgD,CAAC;AAE1E,eAAO,MAAM,gBAAgB,kCAAgC,CAAC;AAG9D,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkB1B,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AACnD,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAGxD,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,cAAc,EAAE,cAAc,EAAE,CAMtE,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,OAAO,CAEnF"}
package/dist/schema.js ADDED
@@ -0,0 +1,42 @@
1
+ import { z } from "zod";
2
+ export const TaskStatus = z.enum([
3
+ "backlog",
4
+ "in-progress",
5
+ "review",
6
+ "done",
7
+ "blocked",
8
+ ]);
9
+ export const TaskPriority = z.enum(["low", "medium", "high", "critical"]);
10
+ export const RecoveryStrategy = z.enum(["resume", "restart"]);
11
+ // The frontmatter schema for every TASK-NNN.md file
12
+ export const TaskFrontmatter = z.object({
13
+ id: z.string(), // "TASK-001"
14
+ title: z.string(),
15
+ status: TaskStatus,
16
+ priority: TaskPriority.default("medium"),
17
+ assigned_to: z.string().nullable().default(null),
18
+ claimed_at: z.string().nullable().default(null),
19
+ last_heartbeat: z.string().nullable().default(null),
20
+ last_progress_at: z.string().nullable().default(null),
21
+ heartbeat_interval: z.number().default(300), // seconds
22
+ needs_handoff: z.boolean().default(false),
23
+ attempt_count: z.number().default(0),
24
+ previous_agents: z.array(z.string()).default([]),
25
+ depends_on: z.array(z.string()).default([]),
26
+ tags: z.array(z.string()).default([]),
27
+ created_by: z.string().default("human"),
28
+ recovery_strategy: RecoveryStrategy.default("restart"),
29
+ project: z.string(),
30
+ });
31
+ // Valid status transitions — enforced by update_task
32
+ export const VALID_TRANSITIONS = {
33
+ backlog: ["in-progress"],
34
+ "in-progress": ["review", "blocked", "done"],
35
+ review: ["in-progress", "done", "blocked"],
36
+ blocked: ["backlog", "in-progress"],
37
+ done: [], // terminal
38
+ };
39
+ export function isValidTransition(from, to) {
40
+ return VALID_TRANSITIONS[from]?.includes(to) ?? false;
41
+ }
42
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC;IAC/B,SAAS;IACT,aAAa;IACb,QAAQ;IACR,MAAM;IACN,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAE1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AAE9D,oDAAoD;AACpD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAA+B,aAAa;IAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,UAAU;IAClB,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC;IACxC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACnD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACrD,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,UAAU;IACvD,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACzC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAChD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,iBAAiB,EAAE,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC;IACtD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAKH,qDAAqD;AACrD,MAAM,CAAC,MAAM,iBAAiB,GAA6C;IACzE,OAAO,EAAM,CAAC,aAAa,CAAC;IAC5B,aAAa,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,CAAC;IAC5C,MAAM,EAAO,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC;IAC/C,OAAO,EAAM,CAAC,SAAS,EAAE,aAAa,CAAC;IACvC,IAAI,EAAS,EAAE,EAAE,WAAW;CAC7B,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,IAAoB,EAAE,EAAkB;IACxE,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;AACxD,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { type Task } from "./schema.js";
2
+ import type { Config } from "./config.js";
3
+ export declare class FileStore {
4
+ readonly root: string;
5
+ readonly config: Config;
6
+ constructor(root: string, config: Config);
7
+ nextTaskId(project: string): Promise<string>;
8
+ readTask(project: string, taskId: string): Promise<Task & {
9
+ body: string;
10
+ }>;
11
+ listTasks(project: string, filter?: Partial<Pick<Task, "status" | "priority">>): Promise<Task[]>;
12
+ createTask(project: string, fields: Partial<Task> & {
13
+ title: string;
14
+ }): Promise<Task>;
15
+ updateTask(project: string, taskId: string, patch: Partial<Task>): Promise<Task>;
16
+ acquireLock(project: string, taskId: string, agentId: string): Promise<boolean>;
17
+ releaseLock(project: string, taskId: string): Promise<void>;
18
+ touchHeartbeat(project: string, taskId: string): Promise<void>;
19
+ getLockInfo(project: string, taskId: string): Promise<any>;
20
+ appendLog(project: string, taskId: string, agentId: string, message: string): Promise<void>;
21
+ appendChangelog(entry: string): Promise<void>;
22
+ writeCheckpoint(project: string, taskId: string, checkpoint: {
23
+ agent_id: string;
24
+ completion_estimate: number;
25
+ work_completed: string[];
26
+ work_remaining: string[];
27
+ known_issues: string[];
28
+ files_modified: string[];
29
+ notes: string;
30
+ }): Promise<void>;
31
+ taskDir(project: string): string;
32
+ taskPath(project: string, taskId: string): string;
33
+ lockPath(project: string, taskId: string): string;
34
+ }
35
+ //# sourceMappingURL=store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,IAAI,EAAqB,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,qBAAa,SAAS;aAEF,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;gBADd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;IAK1B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAY5C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ3E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAoBhG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrF,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBhF,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiB/E,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9D,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAQ3C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE;QACjE,QAAQ,EAAE,MAAM,CAAC;QACjB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BjB,OAAO,CAAC,OAAO,EAAE,MAAM;IAIvB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAIxC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGzC"}
package/dist/store.js ADDED
@@ -0,0 +1,180 @@
1
+ import fs from "fs/promises";
2
+ import path from "path";
3
+ import matter from "gray-matter";
4
+ import { TaskFrontmatter, isValidTransition } from "./schema.js";
5
+ export class FileStore {
6
+ root;
7
+ config;
8
+ constructor(root, config) {
9
+ this.root = root;
10
+ this.config = config;
11
+ }
12
+ // ── Task ID generation ────────────────────────────────────────────────────
13
+ async nextTaskId(project) {
14
+ const dir = this.taskDir(project);
15
+ const files = await fs.readdir(dir).catch(() => []);
16
+ const ids = files
17
+ .filter(f => f.match(/^TASK-\d+\.md$/))
18
+ .map(f => parseInt(f.replace("TASK-", "").replace(".md", ""), 10));
19
+ const next = ids.length > 0 ? Math.max(...ids) + 1 : 1;
20
+ return `TASK-${String(next).padStart(3, "0")}`;
21
+ }
22
+ // ── Reading ───────────────────────────────────────────────────────────────
23
+ async readTask(project, taskId) {
24
+ const filePath = this.taskPath(project, taskId);
25
+ const raw = await fs.readFile(filePath, "utf-8");
26
+ const { data, content } = matter(raw);
27
+ const task = TaskFrontmatter.parse(data);
28
+ return { ...task, body: content };
29
+ }
30
+ async listTasks(project, filter) {
31
+ const dir = this.taskDir(project);
32
+ const files = await fs.readdir(dir).catch(() => []);
33
+ const tasks = [];
34
+ for (const file of files.filter(f => f.endsWith(".md"))) {
35
+ const raw = await fs.readFile(path.join(dir, file), "utf-8");
36
+ const { data } = matter(raw);
37
+ const task = TaskFrontmatter.safeParse(data);
38
+ if (!task.success)
39
+ continue;
40
+ if (filter?.status && task.data.status !== filter.status)
41
+ continue;
42
+ if (filter?.priority && task.data.priority !== filter.priority)
43
+ continue;
44
+ tasks.push(task.data);
45
+ }
46
+ return tasks;
47
+ }
48
+ // ── Writing ───────────────────────────────────────────────────────────────
49
+ async createTask(project, fields) {
50
+ const id = await this.nextTaskId(project);
51
+ const task = TaskFrontmatter.parse({
52
+ id,
53
+ project,
54
+ status: "backlog",
55
+ ...fields,
56
+ });
57
+ const content = matter.stringify(taskBodyTemplate(task), task);
58
+ const filePath = this.taskPath(project, id);
59
+ await fs.mkdir(path.dirname(filePath), { recursive: true });
60
+ await fs.writeFile(filePath, content);
61
+ await this.appendChangelog(`CREATE ${id} "${task.title}" by ${task.created_by}`);
62
+ return task;
63
+ }
64
+ async updateTask(project, taskId, patch) {
65
+ const existing = await this.readTask(project, taskId);
66
+ // Enforce valid status transitions
67
+ if (patch.status && patch.status !== existing.status) {
68
+ if (!isValidTransition(existing.status, patch.status)) {
69
+ throw new Error(`Invalid transition: ${existing.status} → ${patch.status}`);
70
+ }
71
+ }
72
+ const updated = { ...existing, ...patch };
73
+ const { body, ...frontmatter } = updated;
74
+ const raw = matter.stringify(body, frontmatter);
75
+ await fs.writeFile(this.taskPath(project, taskId), raw);
76
+ return updated;
77
+ }
78
+ // ── Locking (atomic via O_EXCL) ───────────────────────────────────────────
79
+ async acquireLock(project, taskId, agentId) {
80
+ const lockPath = this.lockPath(project, taskId);
81
+ const lockData = JSON.stringify({
82
+ agent_id: agentId,
83
+ claimed_at: new Date().toISOString(),
84
+ last_heartbeat: new Date().toISOString(),
85
+ });
86
+ try {
87
+ // O_EXCL = fail if file already exists — atomic
88
+ await fs.writeFile(lockPath, lockData, { flag: "wx" });
89
+ return true;
90
+ }
91
+ catch {
92
+ return false; // already locked
93
+ }
94
+ }
95
+ async releaseLock(project, taskId) {
96
+ await fs.unlink(this.lockPath(project, taskId)).catch(() => { });
97
+ }
98
+ async touchHeartbeat(project, taskId) {
99
+ const lockPath = this.lockPath(project, taskId);
100
+ const raw = await fs.readFile(lockPath, "utf-8").catch(() => null);
101
+ if (!raw)
102
+ return;
103
+ const lock = JSON.parse(raw);
104
+ lock.last_heartbeat = new Date().toISOString();
105
+ await fs.writeFile(lockPath, JSON.stringify(lock, null, 2));
106
+ // Also update task frontmatter so watchdog sees it
107
+ await this.updateTask(project, taskId, {
108
+ last_heartbeat: lock.last_heartbeat,
109
+ });
110
+ }
111
+ async getLockInfo(project, taskId) {
112
+ const lockPath = this.lockPath(project, taskId);
113
+ const raw = await fs.readFile(lockPath, "utf-8").catch(() => null);
114
+ return raw ? JSON.parse(raw) : null;
115
+ }
116
+ // ── Log / changelog ───────────────────────────────────────────────────────
117
+ async appendLog(project, taskId, agentId, message) {
118
+ const task = await this.readTask(project, taskId);
119
+ const entry = `\n<!-- log:${new Date().toISOString()} agent:${agentId} -->\n**${agentId}** — ${message}\n`;
120
+ const { body, ...frontmatter } = task;
121
+ const updated = matter.stringify(body + entry, { ...frontmatter, last_progress_at: new Date().toISOString() });
122
+ await fs.writeFile(this.taskPath(project, taskId), updated);
123
+ }
124
+ async appendChangelog(entry) {
125
+ const logPath = path.join(this.root, "CHANGELOG.md");
126
+ const line = `\n${new Date().toISOString()} — ${entry}\n`;
127
+ await fs.appendFile(logPath, line);
128
+ }
129
+ // ── Checkpoint / handoff ──────────────────────────────────────────────────
130
+ async writeCheckpoint(project, taskId, checkpoint) {
131
+ const handoffPath = path.join(this.taskDir(project), taskId, "HANDOFF.md");
132
+ await fs.mkdir(path.dirname(handoffPath), { recursive: true });
133
+ const content = `---
134
+ checkpoint_by: ${checkpoint.agent_id}
135
+ checkpoint_at: ${new Date().toISOString()}
136
+ completion_estimate: ${checkpoint.completion_estimate}%
137
+ ---
138
+
139
+ ## Work completed
140
+ ${checkpoint.work_completed.map(l => `- ${l}`).join("\n")}
141
+
142
+ ## Work remaining
143
+ ${checkpoint.work_remaining.map(l => `- ${l}`).join("\n")}
144
+
145
+ ## Known issues
146
+ ${checkpoint.known_issues.map(l => `- ${l}`).join("\n")}
147
+
148
+ ## Files modified
149
+ ${checkpoint.files_modified.map(l => `- ${l}`).join("\n")}
150
+
151
+ ## Notes for next agent
152
+ ${checkpoint.notes}
153
+ `;
154
+ await fs.writeFile(handoffPath, content);
155
+ await this.appendLog(project, taskId, checkpoint.agent_id, `Wrote checkpoint (${checkpoint.completion_estimate}% complete)`);
156
+ }
157
+ // ── Path helpers ──────────────────────────────────────────────────────────
158
+ taskDir(project) {
159
+ return path.join(this.root, "projects", project, "tasks");
160
+ }
161
+ taskPath(project, taskId) {
162
+ return path.join(this.taskDir(project), `${taskId}.md`);
163
+ }
164
+ lockPath(project, taskId) {
165
+ return path.join(this.taskDir(project), `${taskId}.lock`);
166
+ }
167
+ }
168
+ function taskBodyTemplate(task) {
169
+ return `
170
+ ## Objective
171
+ _Describe the goal of this task._
172
+
173
+ ## Acceptance criteria
174
+ - [ ] _Add criteria here_
175
+
176
+ ## Agent log
177
+ <!-- The MCP server appends entries here via append_log -->
178
+ `;
179
+ }
180
+ //# sourceMappingURL=store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"store.js","sourceRoot":"","sources":["../src/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,eAAe,EAAa,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG5E,MAAM,OAAO,SAAS;IAEF;IACA;IAFlB,YACkB,IAAY,EACZ,MAAc;QADd,SAAI,GAAJ,IAAI,CAAQ;QACZ,WAAM,GAAN,MAAM,CAAQ;IAC7B,CAAC;IAEJ,6EAA6E;IAE7E,KAAK,CAAC,UAAU,CAAC,OAAe;QAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC;QAChE,MAAM,GAAG,GAAG,KAAK;aACd,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,QAAQ,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,MAAc;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,MAAmD;QAClF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC;QAChE,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7D,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,CAAC,IAAI,CAAC,OAAO;gBAAE,SAAS;YAC5B,IAAI,MAAM,EAAE,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;gBAAE,SAAS;YACnE,IAAI,MAAM,EAAE,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ;gBAAE,SAAS;YACzE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,MAAyC;QACzE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC1C,MAAM,IAAI,GAAS,eAAe,CAAC,KAAK,CAAC;YACvC,EAAE;YACF,OAAO;YACP,MAAM,EAAE,SAAS;YACjB,GAAG,MAAM;SACV,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAe,EAAE,MAAc,EAAE,KAAoB;QACpE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEtD,mCAAmC;QACnC,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrD,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,KAAK,CAAC,uBAAuB,QAAQ,CAAC,MAAM,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;QAC1C,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;QACxD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAc,EAAE,OAAe;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,QAAQ,EAAE,OAAO;YACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACpC,cAAc,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACzC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,gDAAgD;YAChD,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC,CAAC,iBAAiB;QACjC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAc;QAC/C,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,MAAc;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACnE,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5D,mDAAmD;QACnD,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE;YACrC,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,MAAc;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,SAAS,CAAC,OAAe,EAAE,MAAc,EAAE,OAAe,EAAE,OAAe;QAC/E,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,cAAc,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,OAAO,WAAW,OAAO,QAAQ,OAAO,IAAI,CAAC;QAC3G,MAAM,EAAE,IAAI,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,EAAE,EAAE,GAAG,WAAW,EAAE,gBAAgB,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAC/G,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,KAAa;QACjC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;QAC1D,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,6EAA6E;IAE7E,KAAK,CAAC,eAAe,CAAC,OAAe,EAAE,MAAc,EAAE,UAQtD;QACC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,MAAM,OAAO,GAAG;iBACH,UAAU,CAAC,QAAQ;iBACnB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;uBAClB,UAAU,CAAC,mBAAmB;;;;EAInD,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGvD,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGvD,UAAU,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGrD,UAAU,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGvD,UAAU,CAAC,KAAK;CACjB,CAAC;QACE,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,qBAAqB,UAAU,CAAC,mBAAmB,aAAa,CAAC,CAAC;IAC/H,CAAC;IAED,6EAA6E;IAE7E,OAAO,CAAC,OAAe;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,MAAc;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,KAAK,CAAC,CAAC;IAC1D,CAAC;IAED,QAAQ,CAAC,OAAe,EAAE,MAAc;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,IAAU;IAClC,OAAO;;;;;;;;;CASR,CAAC;AACF,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { FileStore } from "../store.js";
3
+ export declare function registerGitTools(server: McpServer, store: FileStore): void;
4
+ //# sourceMappingURL=git.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,QA2CnE"}
@@ -0,0 +1,33 @@
1
+ import { z } from "zod";
2
+ import { simpleGit } from "simple-git";
3
+ export function registerGitTools(server, store) {
4
+ server.tool("git_commit", "Commit all current changes with an agent-attributed message.", {
5
+ message: z.string(),
6
+ agent_id: z.string(),
7
+ }, async ({ message, agent_id }) => {
8
+ const git = simpleGit(store.root);
9
+ await git.add(".");
10
+ const result = await git.commit(`[agent:${agent_id}] ${message}`);
11
+ return {
12
+ content: [{ type: "text", text: JSON.stringify({ success: true, commit: result.commit }) }],
13
+ };
14
+ });
15
+ server.tool("git_sync", "Pull latest from remote then push local commits. Safe for multi-machine use.", {
16
+ agent_id: z.string(),
17
+ }, async ({ agent_id }) => {
18
+ const git = simpleGit(store.root);
19
+ const hasRemote = (await git.getRemotes()).length > 0;
20
+ if (!hasRemote) {
21
+ return {
22
+ content: [{ type: "text", text: JSON.stringify({ success: true, note: "No remote configured — local only" }) }],
23
+ };
24
+ }
25
+ // Pull with rebase to keep history clean
26
+ await git.pull(["--rebase"]);
27
+ await git.push();
28
+ return {
29
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
30
+ };
31
+ });
32
+ }
33
+ //# sourceMappingURL=git.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/tools/git.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,KAAgB;IAElE,MAAM,CAAC,IAAI,CACT,YAAY,EACZ,8DAA8D,EAC9D;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;QACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,UAAU,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;QAClE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;SAC5F,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,UAAU,EACV,8EAA8E,EAC9E;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;KACrB,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,CAAC,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACtD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,mCAAmC,EAAE,CAAC,EAAE,CAAC;aAChH,CAAC;QACJ,CAAC;QAED,yCAAyC;QACzC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7B,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAEjB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SACrE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import { FileStore } from "../store.js";
3
+ export declare function registerStatusTools(server: McpServer, store: FileStore): void;
4
+ //# sourceMappingURL=status.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,QAEtE"}
@@ -0,0 +1,4 @@
1
+ export function registerStatusTools(server, store) {
2
+ // TODO: Implement status tools
3
+ }
4
+ //# sourceMappingURL=status.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/tools/status.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,KAAgB;IACrE,+BAA+B;AACjC,CAAC"}
@@ -0,0 +1,4 @@
1
+ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
2
+ import type { FileStore } from "../store.js";
3
+ export declare function registerTaskTools(server: McpServer, store: FileStore): void;
4
+ //# sourceMappingURL=tasks.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,QAwPpE"}
@@ -0,0 +1,188 @@
1
+ import { z } from "zod";
2
+ export function registerTaskTools(server, store) {
3
+ // ── list_tasks ─────────────────────────────────────────────────────────────
4
+ server.tool("list_tasks", "List tasks for a project, optionally filtered by status or priority.", {
5
+ project: z.string().describe("Project name"),
6
+ status: z.enum(["backlog", "in-progress", "review", "done", "blocked"]).optional(),
7
+ priority: z.enum(["low", "medium", "high", "critical"]).optional(),
8
+ }, async ({ project, status, priority }) => {
9
+ const tasks = await store.listTasks(project, { status, priority });
10
+ return {
11
+ content: [{
12
+ type: "text",
13
+ text: JSON.stringify(tasks, null, 2),
14
+ }],
15
+ };
16
+ });
17
+ // ── read_task ──────────────────────────────────────────────────────────────
18
+ server.tool("read_task", "Read the full contents of a task file including its agent log.", {
19
+ project: z.string(),
20
+ task_id: z.string().describe("e.g. TASK-001"),
21
+ }, async ({ project, task_id }) => {
22
+ const task = await store.readTask(project, task_id);
23
+ return {
24
+ content: [{ type: "text", text: JSON.stringify(task, null, 2) }],
25
+ };
26
+ });
27
+ // ── claim_task ─────────────────────────────────────────────────────────────
28
+ server.tool("claim_task", "Atomically claim a task. Fails if another agent already holds it.", {
29
+ project: z.string(),
30
+ task_id: z.string(),
31
+ agent_id: z.string().describe("Unique identifier for this agent instance"),
32
+ }, async ({ project, task_id, agent_id }) => {
33
+ const acquired = await store.acquireLock(project, task_id, agent_id);
34
+ if (!acquired) {
35
+ const lock = await store.getLockInfo(project, task_id);
36
+ return {
37
+ content: [{
38
+ type: "text",
39
+ text: JSON.stringify({
40
+ success: false,
41
+ reason: "Task already claimed",
42
+ held_by: lock?.agent_id,
43
+ since: lock?.claimed_at,
44
+ }),
45
+ }],
46
+ isError: true,
47
+ };
48
+ }
49
+ await store.updateTask(project, task_id, {
50
+ status: "in-progress",
51
+ assigned_to: agent_id,
52
+ claimed_at: new Date().toISOString(),
53
+ last_heartbeat: new Date().toISOString(),
54
+ attempt_count: (await store.readTask(project, task_id)).attempt_count + 1,
55
+ });
56
+ await store.appendChangelog(`CLAIM ${task_id} by ${agent_id}`);
57
+ return {
58
+ content: [{ type: "text", text: JSON.stringify({ success: true, task_id }) }],
59
+ };
60
+ });
61
+ // ── heartbeat ──────────────────────────────────────────────────────────────
62
+ server.tool("heartbeat", "Update the heartbeat timestamp for a claimed task. Call every 5 minutes.", {
63
+ project: z.string(),
64
+ task_id: z.string(),
65
+ agent_id: z.string(),
66
+ }, async ({ project, task_id, agent_id }) => {
67
+ const lock = await store.getLockInfo(project, task_id);
68
+ if (!lock || lock.agent_id !== agent_id) {
69
+ return {
70
+ content: [{ type: "text", text: JSON.stringify({ success: false, reason: "Not your lock" }) }],
71
+ isError: true,
72
+ };
73
+ }
74
+ await store.touchHeartbeat(project, task_id);
75
+ return {
76
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
77
+ };
78
+ });
79
+ // ── append_log ─────────────────────────────────────────────────────────────
80
+ server.tool("append_log", "Append a timestamped entry to the task's agent log. Updates last_progress_at.", {
81
+ project: z.string(),
82
+ task_id: z.string(),
83
+ agent_id: z.string(),
84
+ message: z.string().describe("What you just did or observed"),
85
+ }, async ({ project, task_id, agent_id, message }) => {
86
+ await store.appendLog(project, task_id, agent_id, message);
87
+ return {
88
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
89
+ };
90
+ });
91
+ // ── write_checkpoint ───────────────────────────────────────────────────────
92
+ server.tool("write_checkpoint", "Write a HANDOFF.md for this task. Call when approaching context limit before release_task.", {
93
+ project: z.string(),
94
+ task_id: z.string(),
95
+ agent_id: z.string(),
96
+ completion_estimate: z.number().min(0).max(100),
97
+ work_completed: z.array(z.string()),
98
+ work_remaining: z.array(z.string()),
99
+ known_issues: z.array(z.string()).default([]),
100
+ files_modified: z.array(z.string()).default([]),
101
+ notes: z.string().default(""),
102
+ }, async (args) => {
103
+ await store.writeCheckpoint(args.project, args.task_id, args);
104
+ return {
105
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
106
+ };
107
+ });
108
+ // ── release_task ───────────────────────────────────────────────────────────
109
+ server.tool("release_task", "Gracefully release a task back to the pool (e.g. context limit reached). Write a checkpoint first.", {
110
+ project: z.string(),
111
+ task_id: z.string(),
112
+ agent_id: z.string(),
113
+ }, async ({ project, task_id, agent_id }) => {
114
+ await store.updateTask(project, task_id, {
115
+ status: "in-progress", // stays in-progress, needs_handoff flags it
116
+ assigned_to: null,
117
+ needs_handoff: true,
118
+ previous_agents: [
119
+ ...(await store.readTask(project, task_id)).previous_agents,
120
+ agent_id,
121
+ ],
122
+ });
123
+ await store.releaseLock(project, task_id);
124
+ await store.appendChangelog(`RELEASE ${task_id} by ${agent_id} (needs handoff)`);
125
+ return {
126
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
127
+ };
128
+ });
129
+ // ── complete_task ──────────────────────────────────────────────────────────
130
+ server.tool("complete_task", "Mark a task as done. Releases the lock and records a summary.", {
131
+ project: z.string(),
132
+ task_id: z.string(),
133
+ agent_id: z.string(),
134
+ summary: z.string().describe("2–3 sentence summary of what was accomplished"),
135
+ }, async ({ project, task_id, agent_id, summary }) => {
136
+ await store.appendLog(project, task_id, agent_id, `**Completed:** ${summary}`);
137
+ await store.updateTask(project, task_id, {
138
+ status: "done",
139
+ assigned_to: null,
140
+ needs_handoff: false,
141
+ });
142
+ await store.releaseLock(project, task_id);
143
+ await store.appendChangelog(`COMPLETE ${task_id} by ${agent_id}: ${summary}`);
144
+ return {
145
+ content: [{ type: "text", text: JSON.stringify({ success: true }) }],
146
+ };
147
+ });
148
+ // ── create_task ────────────────────────────────────────────────────────────
149
+ server.tool("create_task", "Create a new task in the backlog.", {
150
+ project: z.string(),
151
+ title: z.string(),
152
+ priority: z.enum(["low", "medium", "high", "critical"]).default("medium"),
153
+ tags: z.array(z.string()).default([]),
154
+ depends_on: z.array(z.string()).default([]),
155
+ created_by: z.string().default("human"),
156
+ recovery_strategy: z.enum(["resume", "restart"]).default("restart"),
157
+ }, async (args) => {
158
+ const task = await store.createTask(args.project, args);
159
+ return {
160
+ content: [{ type: "text", text: JSON.stringify({ success: true, task }) }],
161
+ };
162
+ });
163
+ // ── get_status ─────────────────────────────────────────────────────────────
164
+ server.tool("get_status", "Get a summary of the current board — counts by status, stalled tasks, recent activity.", {
165
+ project: z.string(),
166
+ }, async ({ project }) => {
167
+ const tasks = await store.listTasks(project);
168
+ const counts = tasks.reduce((acc, t) => {
169
+ acc[t.status] = (acc[t.status] ?? 0) + 1;
170
+ return acc;
171
+ }, {});
172
+ const now = Date.now();
173
+ const stalled = tasks.filter(t => {
174
+ if (t.status !== "in-progress")
175
+ return false;
176
+ if (!t.last_progress_at)
177
+ return false;
178
+ return now - new Date(t.last_progress_at).getTime() > 30 * 60 * 1000;
179
+ });
180
+ return {
181
+ content: [{
182
+ type: "text",
183
+ text: JSON.stringify({ counts, stalled: stalled.map(t => t.id) }, null, 2),
184
+ }],
185
+ };
186
+ });
187
+ }
188
+ //# sourceMappingURL=tasks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,16 @@
1
+ import type { FileStore } from "../store.js";
2
+ import type { Config } from "../config.js";
3
+ export declare class Watchdog {
4
+ private store;
5
+ private config;
6
+ private timer;
7
+ constructor(store: FileStore, config: Config);
8
+ start(): void;
9
+ stop(): void;
10
+ private sweep;
11
+ private reclaim;
12
+ private flagStalled;
13
+ private escalate;
14
+ private listProjects;
15
+ }
16
+ //# sourceMappingURL=watchdog.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watchdog.d.ts","sourceRoot":"","sources":["../../src/watchdog/watchdog.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,qBAAa,QAAQ;IAIjB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,KAAK,CAA+B;gBAGlC,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,MAAM;IAGxB,KAAK;IAOL,IAAI;YAIU,KAAK;YA6CL,OAAO;YAiBP,WAAW;YAaX,QAAQ;YAWR,YAAY;CAK3B"}
@@ -0,0 +1,90 @@
1
+ import fs from "fs/promises";
2
+ import path from "path";
3
+ export class Watchdog {
4
+ store;
5
+ config;
6
+ timer = null;
7
+ constructor(store, config) {
8
+ this.store = store;
9
+ this.config = config;
10
+ }
11
+ start() {
12
+ // Run every 2× the heartbeat interval
13
+ const interval = this.config.heartbeat_interval_seconds * 2 * 1000;
14
+ this.timer = setInterval(() => this.sweep(), interval);
15
+ console.error(`Watchdog started — sweep every ${interval / 1000}s`);
16
+ }
17
+ stop() {
18
+ if (this.timer)
19
+ clearInterval(this.timer);
20
+ }
21
+ async sweep() {
22
+ const projects = await this.listProjects();
23
+ for (const project of projects) {
24
+ const tasks = await this.store.listTasks(project, { status: "in-progress" });
25
+ for (const task of tasks) {
26
+ const lockInfo = await this.store.getLockInfo(project, task.id);
27
+ // ── Case 1: Lock exists but heartbeat is expired ────────────────────
28
+ if (lockInfo) {
29
+ const lastBeat = new Date(lockInfo.last_heartbeat).getTime();
30
+ const elapsed = Date.now() - lastBeat;
31
+ const timeout = this.config.lock_timeout_seconds * 1000;
32
+ if (elapsed > timeout) {
33
+ await this.reclaim(project, task.id, lockInfo.agent_id, "heartbeat_expired");
34
+ continue;
35
+ }
36
+ }
37
+ // ── Case 2: No lock but task is in-progress (crash with no lock) ───
38
+ if (!lockInfo && !task.needs_handoff) {
39
+ await this.reclaim(project, task.id, task.assigned_to ?? "unknown", "no_lock");
40
+ continue;
41
+ }
42
+ // ── Case 3: Stalled — heartbeat alive but no progress ───────────────
43
+ if (task.last_progress_at) {
44
+ const lastProgress = new Date(task.last_progress_at).getTime();
45
+ const stallTime = this.config.stall_threshold_seconds * 1000;
46
+ if (Date.now() - lastProgress > stallTime) {
47
+ await this.flagStalled(project, task.id);
48
+ }
49
+ }
50
+ // ── Case 4: Too many attempts — escalate to human ───────────────────
51
+ if (task.attempt_count >= this.config.max_attempts_before_escalation) {
52
+ await this.escalate(project, task.id);
53
+ }
54
+ }
55
+ }
56
+ }
57
+ async reclaim(project, taskId, agentId, reason) {
58
+ console.error(`[watchdog] Reclaiming ${taskId} from ${agentId} — reason: ${reason}`);
59
+ await this.store.releaseLock(project, taskId);
60
+ await this.store.updateTask(project, taskId, {
61
+ status: "backlog",
62
+ assigned_to: null,
63
+ needs_handoff: false,
64
+ });
65
+ await this.store.appendLog(project, taskId, "watchdog", `[WATCHDOG] Lock expired (${reason}) — task requeued to backlog. Previous agent: ${agentId}`);
66
+ await this.store.appendChangelog(`WATCHDOG_RECLAIM ${taskId} from ${agentId} (${reason})`);
67
+ }
68
+ async flagStalled(project, taskId) {
69
+ const task = await this.store.readTask(project, taskId);
70
+ if (task.status === "blocked")
71
+ return; // already flagged
72
+ console.error(`[watchdog] Flagging ${taskId} as stalled`);
73
+ await this.store.appendLog(project, taskId, "watchdog", `[WATCHDOG] No progress detected in ${this.config.stall_threshold_seconds / 60} minutes. ` +
74
+ `Task may be stalled. Human review recommended.`);
75
+ // Dashboard will surface stalled tasks via get_status
76
+ }
77
+ async escalate(project, taskId) {
78
+ const task = await this.store.readTask(project, taskId);
79
+ console.error(`[watchdog] Escalating ${taskId} — attempt_count: ${task.attempt_count}`);
80
+ await this.store.updateTask(project, taskId, { status: "blocked" });
81
+ await this.store.appendLog(project, taskId, "watchdog", `[WATCHDOG] Task has failed ${task.attempt_count} times — escalating to human review.`);
82
+ await this.store.appendChangelog(`WATCHDOG_ESCALATE ${taskId} after ${task.attempt_count} attempts`);
83
+ }
84
+ async listProjects() {
85
+ const projectsDir = path.join(this.store.root, "projects");
86
+ const entries = await fs.readdir(projectsDir, { withFileTypes: true }).catch(() => []);
87
+ return entries.filter(e => e.isDirectory()).map(e => e.name);
88
+ }
89
+ }
90
+ //# sourceMappingURL=watchdog.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watchdog.js","sourceRoot":"","sources":["../../src/watchdog/watchdog.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,37 @@
1
+ {
2
+ "name": "@taskyard/mcp-server",
3
+ "version": "1.0.0-beta.1",
4
+ "type": "module",
5
+ "description": "MCP server for taskyard — atomic file ops, locking, git, watchdog",
6
+ "main": "./dist/index.js",
7
+ "types": "./dist/index.d.ts",
8
+ "publishConfig": {
9
+ "access": "public"
10
+ },
11
+ "files": [
12
+ "dist/**/*",
13
+ "README.md"
14
+ ],
15
+ "keywords": [
16
+ "mcp",
17
+ "model-context-protocol",
18
+ "taskyard",
19
+ "project-management",
20
+ "ai-agents"
21
+ ],
22
+ "scripts": {
23
+ "build": "tsc",
24
+ "dev": "tsc --watch",
25
+ "start": "node dist/index.js",
26
+ "lint": "eslint src --fix",
27
+ "typecheck": "tsc --noEmit",
28
+ "prepublishOnly": "npm run build"
29
+ },
30
+ "dependencies": {
31
+ "@modelcontextprotocol/sdk": "^1.0.0",
32
+ "chokidar": "^3.6.0",
33
+ "gray-matter": "^4.0.3",
34
+ "simple-git": "^3.22.0",
35
+ "zod": "^3.22.0"
36
+ }
37
+ }