@uasyraf/helm 0.1.0

package/dist/server/src/project/detect.js

@@ -0,0 +1,82 @@
+import { basename } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { probeGit, repoRoot, parseRemoteToSlug } from "../util/git.js";
+function loadOverride(cwd) {
+    let dir = cwd;
+    while (true) {
+        const candidate = join(dir, ".helm", "project.json");
+        if (existsSync(candidate)) {
+            try {
+                const parsed = JSON.parse(readFileSync(candidate, "utf8"));
+                return { override: parsed, rootDir: dir };
+            }
+            catch {
+                return null;
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+export function detectProject(cwd) {
+    const override = loadOverride(cwd);
+    const git = probeGit(cwd);
+    const baseDir = override?.rootDir ?? repoRoot(cwd) ?? cwd;
+    const cwdName = sanitize(basename(baseDir));
+    if (override?.override.slug) {
+        return {
+            slug: override.override.slug,
+            name: override.override.name ?? override.override.slug,
+            gitRemote: git.remoteUrl,
+            source: "override",
+            warning: null,
+            rootDir: override.rootDir,
+        };
+    }
+    if (git.remoteUrl) {
+        const slug = parseRemoteToSlug(git.remoteUrl);
+        if (slug) {
+            return {
+                slug,
+                name: humanize(slug),
+                gitRemote: git.remoteUrl,
+                source: "remote",
+                warning: null,
+                rootDir: baseDir,
+            };
+        }
+    }
+    if (git.isRepo) {
+        return {
+            slug: cwdName,
+            name: humanize(cwdName),
+            gitRemote: null,
+            source: "cwd-with-git",
+            warning: "no git remote configured — using directory name as slug",
+            rootDir: baseDir,
+        };
+    }
+    return {
+        slug: cwdName,
+        name: humanize(cwdName),
+        gitRemote: null,
+        source: "cwd-no-git",
+        warning: "not a git repo — using directory name. Run `helm init --slug <name>` to override.",
+        rootDir: baseDir,
+    };
+}
+function sanitize(raw) {
+    const cleaned = raw.toLowerCase().replace(/[^a-z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return cleaned || "project";
+}
+function humanize(slug) {
+    return slug
+        .split(/[-_]/)
+        .filter(Boolean)
+        .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+        .join(" ");
+}
+//# sourceMappingURL=detect.js.map

package/dist/server/src/project/detect.js.map

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

package/dist/server/src/project/identity.d.ts

@@ -0,0 +1,8 @@
+export type IdentitySource = "git" | "env-user" | "anonymous";
+export interface ResolvedIdentity {
+    handle: string;
+    email: string | null;
+    source: IdentitySource;
+    prompt: string | null;
+}
+export declare function resolveIdentity(cwd: string): ResolvedIdentity;

package/dist/server/src/project/identity.js

@@ -0,0 +1,42 @@
+import { userInfo } from "node:os";
+import { probeGit } from "../util/git.js";
+export function resolveIdentity(cwd) {
+    const git = probeGit(cwd);
+    if (git.userEmail) {
+        return {
+            handle: handleFromEmail(git.userEmail),
+            email: git.userEmail,
+            source: "git",
+            prompt: null,
+        };
+    }
+    const envUser = safeUserInfo();
+    if (envUser) {
+        return {
+            handle: envUser,
+            email: `${envUser}@local`,
+            source: "env-user",
+            prompt: null,
+        };
+    }
+    return {
+        handle: "anonymous",
+        email: null,
+        source: "anonymous",
+        prompt: "no git user.email or $USER detected — set `git config user.email` or run `helm whoami --set <email>`",
+    };
+}
+function handleFromEmail(email) {
+    const at = email.indexOf("@");
+    return at > 0 ? email.slice(0, at) : email;
+}
+function safeUserInfo() {
+    try {
+        const info = userInfo();
+        return info.username || null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=identity.js.map

package/dist/server/src/project/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../../server/src/project/identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAW1C,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,OAAO;YACL,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC;YACtC,KAAK,EAAE,GAAG,CAAC,SAAS;YACpB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAC/B,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO;YACL,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,GAAG,OAAO,QAAQ;YACzB,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,IAAI;SACb,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,WAAW;QACnB,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,sGAAsG;KAC/G,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC7C,CAAC;AAED,SAAS,YAAY;IACnB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/server/src/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./tools/types.js";
+export interface ServerHandle {
+    server: McpServer;
+    ctx: ToolContext;
+    close: () => Promise<void>;
+}
+export declare function buildServer(cwd?: string): Promise<ServerHandle>;

package/dist/server/src/server.js

@@ -0,0 +1,22 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { bootstrapSession } from "./project/bootstrap.js";
+import { openProjectRepo } from "./db/open-repo.js";
+import { registerAllTools } from "./tools/index.js";
+export async function buildServer(cwd = process.cwd()) {
+    const { handle } = await openProjectRepo(cwd);
+    const session = await bootstrapSession(handle.repo, cwd);
+    const server = new McpServer({
+        name: "helm",
+        version: "0.1.0",
+    });
+    const ctx = { repo: handle.repo, session, cwd };
+    registerAllTools(server, ctx);
+    return {
+        server,
+        ctx,
+        close: async () => {
+            await handle.close();
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/server/src/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../server/src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AASpD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,eAAe,CAAC,GAAG,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAEzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAgB,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC7D,gBAAgB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE9B,OAAO;QACL,MAAM;QACN,GAAG;QACH,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server/src/tools/debt.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerDebtTools: ToolRegistrar;

package/dist/server/src/tools/debt.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+const SEVERITY = z.enum(["low", "med", "high", "critical"]);
+export const registerDebtTools = (server, ctx) => {
+    server.registerTool("log_debt", {
+        title: "Log a tech debt item",
+        description: "Records a debt item. Auto-attributed to active sprint via the progress event.",
+        inputSchema: {
+            title: z.string().min(1),
+            description: z.string().optional(),
+            severity: SEVERITY.optional(),
+            location: z.string().optional().describe("file:line or symbol path"),
+            expiresAt: z.string().optional().describe("ISO date when this should be paid down"),
+            linkedStoryId: z.string().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const id = newId();
+        await repo.insertDebt({
+            id,
+            projectId: session.project.id,
+            title: args.title,
+            description: args.description ?? null,
+            severity: args.severity ?? "med",
+            location: args.location ?? null,
+            ownerId: session.developer.id,
+            expiresAt: args.expiresAt ?? null,
+            openedAt: now(),
+            closedAt: null,
+            linkedStoryId: args.linkedStoryId ?? null,
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "debt.opened",
+            refId: id,
+            summary: `debt: ${args.title}${args.location ? ` @ ${args.location}` : ""}`,
+        });
+        return jsonResult({ id, title: args.title, severity: args.severity ?? "med" });
+    });
+    server.registerTool("close_debt", {
+        title: "Close a debt item",
+        description: "Marks debt paid down. Closes during the active sprint count toward the killer metric.",
+        inputSchema: { id: z.string() },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        await repo.closeDebt(args.id, now());
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "debt.closed",
+            refId: args.id,
+            summary: "debt closed",
+        });
+        return jsonResult({ id: args.id, closed: true });
+    });
+    server.registerTool("list_debt", {
+        title: "List debt items",
+        description: "Open debt by default; pass includeClosed=true for the full history.",
+        inputSchema: {
+            includeClosed: z.boolean().optional(),
+            limit: z.number().int().positive().max(500).optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const limit = args.limit ?? 100;
+        const rows = args.includeClosed
+            ? await repo.findAllDebtByProject(session.project.id, limit)
+            : await repo.findOpenDebtByProject(session.project.id, limit);
+        return jsonResult({
+            count: rows.length,
+            items: rows.map((r) => ({
+                id: r.id,
+                title: r.title,
+                severity: r.severity,
+                location: r.location,
+                openedAt: r.openedAt,
+                closedAt: r.closedAt,
+                expiresAt: r.expiresAt,
+            })),
+        });
+    });
+};
+//# sourceMappingURL=debt.js.map

package/dist/server/src/tools/debt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debt.js","sourceRoot":"","sources":["../../../../server/src/tools/debt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,iBAAiB,GAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAC9D,MAAM,CAAC,YAAY,CACjB,UAAU,EACV;QACE,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAClC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;YAC7B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;YACpE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;YACnF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACrC;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,UAAU,CAAC;YACpB,EAAE;YACF,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;YAChC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;YAC/B,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI;YACjC,QAAQ,EAAE,GAAG,EAAE;YACf,QAAQ,EAAE,IAAI;YACd,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;SAC1C,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE;YACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YACjC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE;YACjC,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,SAAS,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAC5E,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;IACjF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,uFAAuF;QACpG,WAAW,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;KAChC,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACrC,MAAM,SAAS,CAAC,IAAI,EAAE;YACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YACjC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE;YACjC,IAAI,EAAE,aAAa;YACnB,KAAK,EAAE,IAAI,CAAC,EAAE;YACd,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,WAAW,EACX;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,qEAAqE;QAClF,WAAW,EAAE;YACX,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;YACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SACvD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa;YAC7B,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC;YAC5D,CAAC,CAAC,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QAChE,OAAO,UAAU,CAAC;YAChB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,QAAQ,EAAE,CAAC,CAAC,QAAQ;gBACpB,SAAS,EAAE,CAAC,CAAC,SAAS;aACvB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/server/src/tools/decision.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerDecisionTools: ToolRegistrar;

package/dist/server/src/tools/decision.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+const STATUS = z.enum(["proposed", "accepted", "superseded"]);
+export const registerDecisionTools = (server, ctx) => {
+    server.registerTool("record_decision", {
+        title: "Record an architectural decision (ADR-lite)",
+        description: "Captures context + decision + status. Surfaces on the dashboard timeline.",
+        inputSchema: {
+            title: z.string().min(1),
+            context: z.string().optional(),
+            decision: z.string().min(1),
+            status: STATUS.optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const id = newId();
+        await repo.insertDecision({
+            id,
+            projectId: session.project.id,
+            title: args.title,
+            context: args.context ?? null,
+            decision: args.decision,
+            status: args.status ?? "accepted",
+            decidedAt: now(),
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "decision.recorded",
+            refId: id,
+            summary: `decision: ${args.title}`,
+        });
+        return jsonResult({ id, title: args.title, status: args.status ?? "accepted" });
+    });
+};
+//# sourceMappingURL=decision.js.map

package/dist/server/src/tools/decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decision.js","sourceRoot":"","sources":["../../../../server/src/tools/decision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,qBAAqB,GAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,6CAA6C;QACpD,WAAW,EAAE,2EAA2E;QACxF,WAAW,EAAE;YACX,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;SAC1B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,cAAc,CAAC;YACxB,EAAE;YACF,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU;YACjC,SAAS,EAAE,GAAG,EAAE;SACjB,CAAC,CAAC;QACH,MAAM,SAAS,CAAC,IAAI,EAAE;YACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YACjC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE;YACjC,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,aAAa,IAAI,CAAC,KAAK,EAAE;SACnC,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;IAClF,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/server/src/tools/epic.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerEpicTools: ToolRegistrar;

package/dist/server/src/tools/epic.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+const EPIC_STATUS = z.enum(["open", "in-progress", "done", "dropped"]);
+export const registerEpicTools = (server, ctx) => {
+    server.registerTool("open_epic", {
+        title: "Open a new epic",
+        description: "Create a cross-sprint theme. Epics group stories around a shared goal.",
+        inputSchema: {
+            title: z.string().min(1),
+            description: z.string().optional(),
+            priority: z.number().int().min(1).max(5).optional(),
+            targetSprintId: z.string().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const id = newId();
+        await repo.insertEpic({
+            id,
+            projectId: session.project.id,
+            title: args.title,
+            description: args.description ?? null,
+            status: "open",
+            priority: args.priority ?? 3,
+            targetSprintId: args.targetSprintId ?? null,
+            createdAt: now(),
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "epic.opened",
+            refId: id,
+            summary: `epic: ${args.title}`,
+        });
+        return jsonResult({ id, title: args.title, status: "open" });
+    });
+    server.registerTool("update_epic", {
+        title: "Update an epic",
+        description: "Edit title, description, priority, or status.",
+        inputSchema: {
+            id: z.string(),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            priority: z.number().int().min(1).max(5).optional(),
+            status: EPIC_STATUS.optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const updates = {};
+        if (args.title !== undefined)
+            updates.title = args.title;
+        if (args.description !== undefined)
+            updates.description = args.description;
+        if (args.priority !== undefined)
+            updates.priority = args.priority;
+        if (args.status !== undefined)
+            updates.status = args.status;
+        if (Object.keys(updates).length === 0)
+            return jsonResult({ id: args.id, changed: false });
+        await repo.updateEpic(args.id, updates);
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "epic.updated",
+            refId: args.id,
+            summary: `epic updated: ${Object.keys(updates).join(", ")}`,
+        });
+        return jsonResult({ id: args.id, changed: true, updates });
+    });
+    server.registerTool("close_epic", {
+        title: "Close an epic",
+        description: "Marks epic as done (or dropped if specified).",
+        inputSchema: {
+            id: z.string(),
+            dropped: z.boolean().optional().describe("Set true to mark dropped instead of done."),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const status = args.dropped ? "dropped" : "done";
+        await repo.updateEpic(args.id, { status });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "epic.closed",
+            refId: args.id,
+            summary: `epic ${status}`,
+        });
+        return jsonResult({ id: args.id, status });
+    });
+};
+//# sourceMappingURL=epic.js.map

package/dist/server/src/tools/epic.js.map

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

package/dist/server/src/tools/index.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ToolContext } from "./types.js";
+export declare function registerAllTools(server: McpServer, ctx: ToolContext): void;

package/dist/server/src/tools/index.js

@@ -0,0 +1,21 @@
+import { registerStatusTools } from "./status.js";
+import { registerSprintTools } from "./sprint.js";
+import { registerEpicTools } from "./epic.js";
+import { registerStoryTools } from "./story.js";
+import { registerTaskTools } from "./task.js";
+import { registerDebtTools } from "./debt.js";
+import { registerDecisionTools } from "./decision.js";
+import { registerProgressTools } from "./progress.js";
+import { registerNelsonTools } from "./nelson.js";
+export function registerAllTools(server, ctx) {
+    registerStatusTools(server, ctx);
+    registerSprintTools(server, ctx);
+    registerEpicTools(server, ctx);
+    registerStoryTools(server, ctx);
+    registerTaskTools(server, ctx);
+    registerDebtTools(server, ctx);
+    registerDecisionTools(server, ctx);
+    registerProgressTools(server, ctx);
+    registerNelsonTools(server, ctx);
+}
+//# sourceMappingURL=index.js.map

package/dist/server/src/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../server/src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,GAAgB;IAClE,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACjC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAChC,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,iBAAiB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACnC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/server/src/tools/nelson.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerNelsonTools: ToolRegistrar;

package/dist/server/src/tools/nelson.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { emitEvent } from "../events/emit.js";
+export const registerNelsonTools = (server, ctx) => {
+    server.registerTool("link_mission", {
+        title: "Link a Nelson mission to a story/sprint",
+        description: "Called by Nelson's Step 3 (Battle Plan approved). Creates a mission.linked progress event.",
+        inputSchema: {
+            missionId: z.string().min(1),
+            storyId: z.string().optional(),
+            sprintId: z.string().optional(),
+            summary: z.string().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const sprintId = args.sprintId ?? session.activeSprint.id;
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId,
+            kind: "mission.linked",
+            refId: args.missionId,
+            summary: args.summary ?? `mission ${args.missionId} linked${args.storyId ? ` to story ${args.storyId}` : ""}`,
+        });
+        return jsonResult({ missionId: args.missionId, storyId: args.storyId ?? null, sprintId });
+    });
+};
+//# sourceMappingURL=nelson.js.map

package/dist/server/src/tools/nelson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nelson.js","sourceRoot":"","sources":["../../../../server/src/tools/nelson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,mBAAmB,GAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,yCAAyC;QAChD,WAAW,EAAE,4FAA4F;QACzG,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC/B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QAC1D,MAAM,SAAS,CAAC,IAAI,EAAE;YACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YACjC,QAAQ;YACR,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAI,CAAC,SAAS;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,WAAW,IAAI,CAAC,SAAS,UAAU,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;SAC9G,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5F,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/server/src/tools/progress.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerProgressTools: ToolRegistrar;

package/dist/server/src/tools/progress.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { emitEvent } from "../events/emit.js";
+export const registerProgressTools = (server, ctx) => {
+    server.registerTool("log_progress", {
+        title: "Log a free-form progress event",
+        description: "Appends to the project timeline. Use for narrative milestones that don't fit other tools.",
+        inputSchema: {
+            summary: z.string().min(1),
+            refId: z.string().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "progress.logged",
+            refId: args.refId ?? null,
+            summary: args.summary,
+        });
+        return jsonResult({ logged: true, summary: args.summary });
+    });
+    server.registerTool("who_did_what", {
+        title: "Developer activity feed",
+        description: "Recent events optionally filtered by developer handle.",
+        inputSchema: {
+            handle: z.string().optional(),
+            limit: z.number().int().positive().max(500).optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const limit = args.limit ?? 100;
+        if (args.handle) {
+            const found = await repo.findDeveloperByHandle(session.project.id, args.handle);
+            if (!found)
+                return jsonResult({ count: 0, events: [], note: `no developer with handle ${args.handle}` });
+            const rows = await repo.findEventsByDeveloper(session.project.id, found.id, limit);
+            return jsonResult({ count: rows.length, developer: found.handle, events: rows });
+        }
+        const rows = await repo.findRecentEvents(session.project.id, limit);
+        return jsonResult({ count: rows.length, events: rows });
+    });
+};
+//# sourceMappingURL=progress.js.map

package/dist/server/src/tools/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../../server/src/tools/progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C,MAAM,CAAC,MAAM,qBAAqB,GAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAClE,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,gCAAgC;QACvC,WAAW,EAAE,2FAA2F;QACxG,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SAC7B;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,SAAS,CAAC,IAAI,EAAE;YACpB,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;YAC7B,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,EAAE;YACjC,QAAQ,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE;YACjC,IAAI,EAAE,iBAAiB;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC,CAAC;QACH,OAAO,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,wDAAwD;QACrE,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SACvD;KACF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,GAAG,CAAC;QAEhC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAChF,IAAI,CAAC,KAAK;gBAAE,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,4BAA4B,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACzG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACnF,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,UAAU,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

package/dist/server/src/tools/sprint.d.ts

@@ -0,0 +1,2 @@
+import type { ToolRegistrar } from "./types.js";
+export declare const registerSprintTools: ToolRegistrar;