foreman-ai 1.0.0

package/README.md

@@ -0,0 +1,56 @@
+# foreman-ai
+
+AI Project Manager MCP server — persistent, cross-project backlog management for Claude Code.
+
+Foreman gives Claude Code a shared backlog across all your projects. Add work items, track priorities, and ask "what should I work on next?" from any session.
+
+## Install
+
+```bash
+npm install -g foreman-ai
+```
+
+## Configure
+
+Add to your Claude Code MCP config (`~/.claude/settings.json` or project `.mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "foreman": {
+      "command": "foreman-ai",
+      "args": ["--db", "~/.foreman/foreman.db"]
+    }
+  }
+}
+```
+
+## Tools
+
+### Project Management
+- **pm_register_project** — Register a project (run once per project)
+- **pm_list_projects** — List all registered projects
+
+### Backlog CRUD
+- **pm_add_item** — Add a work item (required: project_id, title)
+- **pm_update_item** — Update any field on an item
+- **pm_list_items** — List items with filters (project, status, category, tag)
+- **pm_get_item** — Get full detail on one item
+- **pm_delete_item** — Remove an item
+
+### Smart Operations
+- **pm_next_work** — "What should I work on?" Top unblocked items by priority and ROI
+- **pm_prioritize** — Re-score items with new ROI scores
+- **pm_bulk_import** — Import items from JSON array
+
+## Data Model
+
+Items have: title, description, status (backlog/ready/in_progress/done/archived), priority, category (feature/bug/research/chore), ROI score (1-10), effort (small/medium/large), blocked_by, tags, and source tracking.
+
+## Database
+
+SQLite, stored at `~/.foreman/foreman.db` by default. Override with `--db <path>`.
+
+## License
+
+MIT

package/dist/db.d.ts

@@ -0,0 +1,3 @@
+import Database from "better-sqlite3";
+export declare function getDb(): Database.Database;
+export declare function initDb(dbPath: string): Database.Database;

package/dist/db.js

@@ -0,0 +1,68 @@
+import Database from "better-sqlite3";
+import path from "path";
+import fs from "fs";
+let db;
+export function getDb() {
+    if (!db) {
+        throw new Error("Database not initialized. Call initDb() first.");
+    }
+    return db;
+}
+export function initDb(dbPath) {
+    const dir = path.dirname(dbPath);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    migrate(db);
+    return db;
+}
+function migrate(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS projects (
+      id TEXT PRIMARY KEY,
+      name TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      repo_path TEXT NOT NULL DEFAULT '',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+
+    CREATE TABLE IF NOT EXISTS items (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id),
+      title TEXT NOT NULL,
+      description TEXT NOT NULL DEFAULT '',
+      status TEXT NOT NULL DEFAULT 'backlog',
+      priority INTEGER NOT NULL DEFAULT 100,
+      category TEXT NOT NULL DEFAULT 'feature',
+      roi_score INTEGER,
+      roi_reason TEXT NOT NULL DEFAULT '',
+      effort TEXT,
+      blocked_by TEXT NOT NULL DEFAULT '[]',
+      tags TEXT NOT NULL DEFAULT '[]',
+      source TEXT NOT NULL DEFAULT 'user',
+      execution_mode TEXT NOT NULL DEFAULT 'manual',
+      assigned_to TEXT NOT NULL DEFAULT '',
+      created_at TEXT NOT NULL DEFAULT (datetime('now')),
+      updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+      completed_at TEXT
+    );
+
+    CREATE TABLE IF NOT EXISTS sessions (
+      id TEXT PRIMARY KEY,
+      project_id TEXT NOT NULL REFERENCES projects(id),
+      started_at TEXT NOT NULL DEFAULT (datetime('now')),
+      ended_at TEXT,
+      summary TEXT NOT NULL DEFAULT '',
+      items_touched TEXT NOT NULL DEFAULT '[]'
+    );
+
+    CREATE INDEX IF NOT EXISTS idx_items_project ON items(project_id);
+    CREATE INDEX IF NOT EXISTS idx_items_status ON items(status);
+    CREATE INDEX IF NOT EXISTS idx_sessions_project ON sessions(project_id);
+  `);
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,IAAI,EAAqB,CAAC;AAE1B,MAAM,UAAU,KAAK;IACnB,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,MAAc;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC1B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,OAAO,CAAC,EAAqB;IACpC,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CP,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { initDb } from "./db.js";
+import { registerProjectTools } from "./tools/projects.js";
+import { registerItemTools } from "./tools/items.js";
+import { registerSmartTools } from "./tools/smart.js";
+import path from "path";
+import os from "os";
+function getDbPath() {
+    const args = process.argv.slice(2);
+    const dbIndex = args.indexOf("--db");
+    if (dbIndex !== -1 && args[dbIndex + 1]) {
+        const raw = args[dbIndex + 1];
+        if (raw.startsWith("~")) {
+            return path.join(os.homedir(), raw.slice(1));
+        }
+        return path.resolve(raw);
+    }
+    return path.join(os.homedir(), ".foreman", "foreman.db");
+}
+async function main() {
+    const dbPath = getDbPath();
+    initDb(dbPath);
+    const server = new McpServer({
+        name: "foreman-ai",
+        version: "1.0.0",
+    });
+    registerProjectTools(server);
+    registerItemTools(server);
+    registerSmartTools(server);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Foreman failed to start:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAEpB,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,CAAC,MAAM,CAAC,CAAC;IAEf,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,YAAY;QAClB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/items.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerItemTools(server: McpServer): void;

package/dist/tools/items.js

@@ -0,0 +1,157 @@
+import { z } from "zod";
+import { v4 as uuidv4 } from "uuid";
+import { getDb } from "../db.js";
+const StatusEnum = z.enum(["backlog", "ready", "in_progress", "done", "archived"]);
+const CategoryEnum = z.enum(["feature", "bug", "research", "chore"]);
+const EffortEnum = z.enum(["small", "medium", "large"]);
+const SourceEnum = z.enum(["user", "claude", "auto"]);
+const ExecutionModeEnum = z.enum(["manual", "auto"]);
+function rowToItem(row) {
+    return {
+        ...row,
+        blocked_by: JSON.parse(row.blocked_by),
+        tags: JSON.parse(row.tags),
+    };
+}
+export function registerItemTools(server) {
+    server.tool("pm_add_item", "Add a work item to the backlog.", {
+        project_id: z.string().describe("Project slug"),
+        title: z.string().describe("Item title"),
+        description: z.string().optional(),
+        status: StatusEnum.optional(),
+        priority: z.number().int().optional().describe("Lower = higher priority"),
+        category: CategoryEnum.optional(),
+        roi_score: z.number().int().min(1).max(10).optional(),
+        roi_reason: z.string().optional(),
+        effort: EffortEnum.optional(),
+        blocked_by: z.array(z.string()).optional(),
+        tags: z.array(z.string()).optional(),
+        source: SourceEnum.optional(),
+        execution_mode: ExecutionModeEnum.optional(),
+        assigned_to: z.string().optional(),
+    }, async (args) => {
+        const db = getDb();
+        const id = uuidv4();
+        const now = new Date().toISOString();
+        db.prepare(`
+        INSERT INTO items (id, project_id, title, description, status, priority, category,
+          roi_score, roi_reason, effort, blocked_by, tags, source, execution_mode,
+          assigned_to, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(id, args.project_id, args.title, args.description ?? "", args.status ?? "backlog", args.priority ?? 100, args.category ?? "feature", args.roi_score ?? null, args.roi_reason ?? "", args.effort ?? null, JSON.stringify(args.blocked_by ?? []), JSON.stringify(args.tags ?? []), args.source ?? "user", args.execution_mode ?? "manual", args.assigned_to ?? "", now, now);
+        return { content: [{ type: "text", text: `Item '${args.title}' added (${id}).` }] };
+    });
+    server.tool("pm_update_item", "Update any fields on a work item.", {
+        id: z.string().describe("Item UUID"),
+        title: z.string().optional(),
+        description: z.string().optional(),
+        status: StatusEnum.optional(),
+        priority: z.number().int().optional(),
+        category: CategoryEnum.optional(),
+        roi_score: z.number().int().min(1).max(10).optional(),
+        roi_reason: z.string().optional(),
+        effort: EffortEnum.optional(),
+        blocked_by: z.array(z.string()).optional(),
+        tags: z.array(z.string()).optional(),
+        source: SourceEnum.optional(),
+        execution_mode: ExecutionModeEnum.optional(),
+        assigned_to: z.string().optional(),
+    }, async (args) => {
+        const db = getDb();
+        const { id, ...updates } = args;
+        const now = new Date().toISOString();
+        const sets = [];
+        const values = [];
+        for (const [key, value] of Object.entries(updates)) {
+            if (value === undefined)
+                continue;
+            if (key === "blocked_by" || key === "tags") {
+                sets.push(`${key} = ?`);
+                values.push(JSON.stringify(value));
+            }
+            else {
+                sets.push(`${key} = ?`);
+                values.push(value);
+            }
+        }
+        if (sets.length === 0) {
+            return { content: [{ type: "text", text: "No fields to update." }] };
+        }
+        // Set completed_at when moving to done
+        if (updates.status === "done") {
+            sets.push("completed_at = ?");
+            values.push(now);
+        }
+        sets.push("updated_at = ?");
+        values.push(now);
+        values.push(id);
+        db.prepare(`UPDATE items SET ${sets.join(", ")} WHERE id = ?`).run(...values);
+        return { content: [{ type: "text", text: `Item ${id} updated.` }] };
+    });
+    server.tool("pm_list_items", "List backlog items with optional filters. Defaults to current project, non-archived.", {
+        project_id: z.string().optional().describe("Filter by project"),
+        status: StatusEnum.optional().describe("Filter by status"),
+        category: CategoryEnum.optional().describe("Filter by category"),
+        tag: z.string().optional().describe("Filter by tag"),
+    }, async (args) => {
+        const db = getDb();
+        const conditions = [];
+        const params = [];
+        if (args.project_id) {
+            conditions.push("project_id = ?");
+            params.push(args.project_id);
+        }
+        if (args.status) {
+            conditions.push("status = ?");
+            params.push(args.status);
+        }
+        else {
+            conditions.push("status != 'archived'");
+        }
+        if (args.category) {
+            conditions.push("category = ?");
+            params.push(args.category);
+        }
+        if (args.tag) {
+            conditions.push("tags LIKE ?");
+            params.push(`%"${args.tag}"%`);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+        const rows = db
+            .prepare(`SELECT * FROM items ${where} ORDER BY priority ASC, roi_score DESC`)
+            .all(...params);
+        if (rows.length === 0) {
+            return { content: [{ type: "text", text: "No items found." }] };
+        }
+        const items = rows.map(rowToItem);
+        const text = items
+            .map((i) => `[${i.status}] **${i.title}** (${i.id.slice(0, 8)})\n  Project: ${i.project_id} | Priority: ${i.priority} | ROI: ${i.roi_score ?? "?"}/10 | ${i.category} | ${i.effort ?? "unsized"}`)
+            .join("\n\n");
+        return { content: [{ type: "text", text: `${items.length} items:\n\n${text}` }] };
+    });
+    server.tool("pm_get_item", "Get full details of a single work item.", {
+        id: z.string().describe("Item UUID (full or prefix)"),
+    }, async ({ id }) => {
+        const db = getDb();
+        const row = db
+            .prepare("SELECT * FROM items WHERE id = ? OR id LIKE ?")
+            .get(id, `${id}%`);
+        if (!row) {
+            return { content: [{ type: "text", text: `Item '${id}' not found.` }] };
+        }
+        const item = rowToItem(row);
+        const text = JSON.stringify(item, null, 2);
+        return { content: [{ type: "text", text }] };
+    });
+    server.tool("pm_delete_item", "Delete a work item.", {
+        id: z.string().describe("Item UUID"),
+    }, async ({ id }) => {
+        const db = getDb();
+        const result = db.prepare("DELETE FROM items WHERE id = ?").run(id);
+        if (result.changes === 0) {
+            return { content: [{ type: "text", text: `Item '${id}' not found.` }] };
+        }
+        return { content: [{ type: "text", text: `Item ${id} deleted.` }] };
+    });
+}
+//# sourceMappingURL=items.js.map

package/dist/tools/items.js.map

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

package/dist/tools/projects.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerProjectTools(server: McpServer): void;

package/dist/tools/projects.js

@@ -0,0 +1,34 @@
+import { z } from "zod";
+import { getDb } from "../db.js";
+export function registerProjectTools(server) {
+    server.tool("pm_register_project", "Register a project with Foreman. Run once per project to enable backlog tracking.", {
+        id: z.string().describe("Slug ID for the project, e.g. 'paris-bets'"),
+        name: z.string().describe("Display name"),
+        description: z.string().optional().describe("Project description"),
+        repo_path: z.string().optional().describe("Filesystem path to repo root"),
+    }, async ({ id, name, description, repo_path }) => {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const existing = db
+            .prepare("SELECT id FROM projects WHERE id = ?")
+            .get(id);
+        if (existing) {
+            db.prepare("UPDATE projects SET name = ?, description = ?, repo_path = ?, updated_at = ? WHERE id = ?").run(name, description ?? "", repo_path ?? "", now, id);
+            return { content: [{ type: "text", text: `Project '${id}' updated.` }] };
+        }
+        db.prepare("INSERT INTO projects (id, name, description, repo_path, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)").run(id, name, description ?? "", repo_path ?? "", now, now);
+        return { content: [{ type: "text", text: `Project '${id}' registered.` }] };
+    });
+    server.tool("pm_list_projects", "List all registered projects.", {}, async () => {
+        const db = getDb();
+        const projects = db.prepare("SELECT * FROM projects ORDER BY name").all();
+        if (projects.length === 0) {
+            return { content: [{ type: "text", text: "No projects registered. Use pm_register_project first." }] };
+        }
+        const text = projects
+            .map((p) => `**${p.name}** (${p.id})\n  ${p.description || "No description"}\n  Path: ${p.repo_path || "not set"}`)
+            .join("\n\n");
+        return { content: [{ type: "text", text }] };
+    });
+}
+//# sourceMappingURL=projects.js.map

package/dist/tools/projects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.js","sourceRoot":"","sources":["../../src/tools/projects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAGjC,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,IAAI,CACT,qBAAqB,EACrB,mFAAmF,EACnF;QACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,cAAc,CAAC;QACzC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;QAClE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;KAC1E,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,QAAQ,GAAG,EAAE;aAChB,OAAO,CAAC,sCAAsC,CAAC;aAC/C,GAAG,CAAC,EAAE,CAAwB,CAAC;QAElC,IAAI,QAAQ,EAAE,CAAC;YACb,EAAE,CAAC,OAAO,CACR,2FAA2F,CAC5F,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,IAAI,EAAE,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAEzD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QACpF,CAAC;QAED,EAAE,CAAC,OAAO,CACR,2GAA2G,CAC5G,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,IAAI,EAAE,EAAE,SAAS,IAAI,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;QAE9D,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,YAAY,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IACvF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,+BAA+B,EAC/B,EAAE,EACF,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAe,CAAC;QAEvF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,wDAAwD,EAAE,CAAC,EAAE,CAAC;QAClH,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ;aAClB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,WAAW,IAAI,gBAAgB,aAAa,CAAC,CAAC,SAAS,IAAI,SAAS,EAAE,CAAC;aAClH,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IACxD,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/smart.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSmartTools(server: McpServer): void;

package/dist/tools/smart.js

@@ -0,0 +1,118 @@
+import { z } from "zod";
+import { v4 as uuidv4 } from "uuid";
+import { getDb } from "../db.js";
+function rowToItem(row) {
+    return {
+        ...row,
+        blocked_by: JSON.parse(row.blocked_by),
+        tags: JSON.parse(row.tags),
+    };
+}
+export function registerSmartTools(server) {
+    server.tool("pm_next_work", "What should I work on next? Returns top unblocked items sorted by priority and ROI. This is the killer feature.", {
+        project_id: z.string().optional().describe("Filter by project (omit for all projects)"),
+        limit: z.number().int().min(1).max(20).optional().describe("Number of items to return (default 5)"),
+    }, async ({ project_id, limit }) => {
+        const db = getDb();
+        const max = limit ?? 5;
+        // Get all non-archived, non-done items
+        let query = `SELECT * FROM items WHERE status NOT IN ('done', 'archived')`;
+        const params = [];
+        if (project_id) {
+            query += " AND project_id = ?";
+            params.push(project_id);
+        }
+        const rows = db.prepare(query).all(...params);
+        const items = rows.map(rowToItem);
+        // Filter out blocked items: an item is blocked if any of its blocked_by IDs
+        // correspond to items that are NOT done
+        const doneIds = new Set(db.prepare("SELECT id FROM items WHERE status = 'done'").all().map((r) => r.id));
+        const unblocked = items.filter((item) => item.blocked_by.every((blockerId) => doneIds.has(blockerId)));
+        // Sort: lower priority number first, then higher ROI score, then ready before backlog
+        const statusOrder = { in_progress: 0, ready: 1, backlog: 2 };
+        unblocked.sort((a, b) => {
+            const statusDiff = (statusOrder[a.status] ?? 3) - (statusOrder[b.status] ?? 3);
+            if (statusDiff !== 0)
+                return statusDiff;
+            const priDiff = a.priority - b.priority;
+            if (priDiff !== 0)
+                return priDiff;
+            return (b.roi_score ?? 0) - (a.roi_score ?? 0);
+        });
+        const top = unblocked.slice(0, max);
+        if (top.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No actionable items found. Either everything is done, blocked, or archived.",
+                    },
+                ],
+            };
+        }
+        const text = top
+            .map((i, idx) => `${idx + 1}. **${i.title}** (${i.id.slice(0, 8)})\n   Status: ${i.status} | Priority: ${i.priority} | ROI: ${i.roi_score ?? "?"}/10 | ${i.category} | ${i.effort ?? "unsized"}\n   ${i.description ? i.description.slice(0, 120) : "No description"}${i.roi_reason ? `\n   ROI reason: ${i.roi_reason}` : ""}`)
+            .join("\n\n");
+        return {
+            content: [{ type: "text", text: `Top ${top.length} items to work on:\n\n${text}` }],
+        };
+    });
+    server.tool("pm_prioritize", "Re-score and re-rank items by ROI. Provide item IDs with new scores.", {
+        updates: z
+            .array(z.object({
+            id: z.string(),
+            roi_score: z.number().int().min(1).max(10),
+            roi_reason: z.string().optional(),
+            priority: z.number().int().optional(),
+        }))
+            .describe("Array of items with new ROI scores"),
+    }, async ({ updates }) => {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const stmt = db.prepare("UPDATE items SET roi_score = ?, roi_reason = COALESCE(?, roi_reason), priority = COALESCE(?, priority), updated_at = ? WHERE id = ?");
+        let updated = 0;
+        for (const u of updates) {
+            const result = stmt.run(u.roi_score, u.roi_reason ?? null, u.priority ?? null, now, u.id);
+            updated += result.changes;
+        }
+        return {
+            content: [{ type: "text", text: `Updated ${updated} of ${updates.length} items.` }],
+        };
+    });
+    server.tool("pm_bulk_import", "Import items from a JSON array. Each object needs at minimum: project_id and title.", {
+        items: z
+            .array(z.object({
+            project_id: z.string(),
+            title: z.string(),
+            description: z.string().optional(),
+            status: z.string().optional(),
+            priority: z.number().int().optional(),
+            category: z.string().optional(),
+            roi_score: z.number().int().optional(),
+            roi_reason: z.string().optional(),
+            effort: z.string().optional(),
+            blocked_by: z.array(z.string()).optional(),
+            tags: z.array(z.string()).optional(),
+            source: z.string().optional(),
+        }))
+            .describe("Array of items to import"),
+    }, async ({ items }) => {
+        const db = getDb();
+        const now = new Date().toISOString();
+        const stmt = db.prepare(`
+        INSERT INTO items (id, project_id, title, description, status, priority, category,
+          roi_score, roi_reason, effort, blocked_by, tags, source, execution_mode,
+          assigned_to, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'manual', '', ?, ?)
+      `);
+        let imported = 0;
+        for (const item of items) {
+            stmt.run(uuidv4(), item.project_id, item.title, item.description ?? "", item.status ?? "backlog", item.priority ?? 100, item.category ?? "feature", item.roi_score ?? null, item.roi_reason ?? "", item.effort ?? null, JSON.stringify(item.blocked_by ?? []), JSON.stringify(item.tags ?? []), item.source ?? "auto", now, now);
+            imported++;
+        }
+        return {
+            content: [{ type: "text", text: `Imported ${imported} items.` }],
+        };
+    });
+}
+//# sourceMappingURL=smart.js.map

package/dist/tools/smart.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export type Status = "backlog" | "ready" | "in_progress" | "done" | "archived";
+export type Category = "feature" | "bug" | "research" | "chore";
+export type Effort = "small" | "medium" | "large";
+export type Source = "user" | "claude" | "auto";
+export type ExecutionMode = "manual" | "auto";
+export interface Project {
+    id: string;
+    name: string;
+    description: string;
+    repo_path: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface Item {
+    id: string;
+    project_id: string;
+    title: string;
+    description: string;
+    status: Status;
+    priority: number;
+    category: Category;
+    roi_score: number | null;
+    roi_reason: string;
+    effort: Effort | null;
+    blocked_by: string[];
+    tags: string[];
+    source: Source;
+    execution_mode: ExecutionMode;
+    assigned_to: string;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+}
+export interface Session {
+    id: string;
+    project_id: string;
+    started_at: string;
+    ended_at: string | null;
+    summary: string;
+    items_touched: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "foreman-ai",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "AI Project Manager MCP server — persistent, cross-project backlog management for Claude Code",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "foreman-ai": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "claude",
+    "project-management",
+    "backlog",
+    "ai"
+  ],
+  "author": "Mitchell",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "better-sqlite3": "^12.8.0",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.5.0",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^6.0.2"
+  }
+}