@uasyraf/helm 0.1.0

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

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+export const registerSprintTools = (server, ctx) => {
+    server.registerTool("start_sprint", {
+        title: "Start a new sprint",
+        description: "Closes the current active sprint (if any) and opens a new one. Sprint length comes from project config.",
+        inputSchema: {
+            name: z.string().min(1).optional().describe("Optional sprint name. Defaults to sprint-N."),
+            goal: z.string().optional().describe("One-line sprint goal."),
+            wipLimit: z.number().int().positive().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        await repo.closeActiveSprints(session.project.id, now());
+        const seq = (await repo.countSprintsByProject(session.project.id)) + 1;
+        const id = newId();
+        const name = args.name ?? `sprint-${seq}`;
+        await repo.insertSprint({
+            id,
+            projectId: session.project.id,
+            name,
+            goal: args.goal ?? null,
+            startedAt: now(),
+            endedAt: null,
+            status: "active",
+            wipLimit: args.wipLimit ?? null,
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: id,
+            kind: "sprint.started",
+            refId: id,
+            summary: `${name} started${args.goal ? `: ${args.goal}` : ""}`,
+        });
+        return jsonResult({ id, name, status: "active" });
+    });
+    server.registerTool("end_sprint", {
+        title: "End the active sprint",
+        description: "Closes the active sprint. Incomplete stories return to backlog (locked default — see PRD F2).",
+        inputSchema: {},
+    }, async () => {
+        const { repo, session } = ctx;
+        const row = await repo.findActiveSprint(session.project.id);
+        if (!row) {
+            return jsonResult({ error: "no active sprint" });
+        }
+        const incomplete = await repo.findStoriesInSprintNotDoneOrDropped(row.id);
+        if (incomplete.length > 0) {
+            await repo.rolloverIncompleteStoriesToBacklog(row.id);
+            for (const s of incomplete) {
+                await emitEvent(repo, {
+                    projectId: session.project.id,
+                    developerId: session.developer.id,
+                    sprintId: row.id,
+                    kind: "story.moved",
+                    refId: s.id,
+                    summary: `${s.title} → backlog (sprint rollover)`,
+                });
+            }
+        }
+        await repo.updateSprint(row.id, { status: "closed", endedAt: now() });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: row.id,
+            kind: "sprint.ended",
+            refId: row.id,
+            summary: `${row.name} ended${incomplete.length > 0 ? ` (${incomplete.length} rolled to backlog)` : ""}`,
+        });
+        return jsonResult({ id: row.id, name: row.name, status: "closed", rolledToBacklog: incomplete.length });
+    });
+    server.registerTool("sprint_review", {
+        title: "Sprint review summary",
+        description: "Completed stories, velocity (sized stories closed), debt delta, top events for a sprint.",
+        inputSchema: {
+            sprintId: z.string().optional().describe("Defaults to active sprint."),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const sprintId = args.sprintId ?? session.activeSprint.id;
+        const inSprint = await repo.findStoriesInSprint(sprintId);
+        const completed = inSprint.filter((s) => s.status === "done");
+        const opened = await repo.countEventsByKindInSprint(sprintId, "debt.opened");
+        const closed = await repo.countEventsByKindInSprint(sprintId, "debt.closed");
+        const sized = completed.filter((s) => s.size).length;
+        return jsonResult({
+            sprintId,
+            completedStories: completed.length,
+            velocitySizedStories: sized,
+            debt: { opened, closed, delta: opened - closed },
+            stories: completed.map((s) => ({ id: s.id, title: s.title, size: s.size })),
+        });
+    });
+};
+//# sourceMappingURL=sprint.js.map

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

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

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

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

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

@@ -0,0 +1,31 @@
+import { jsonResult } from "./types.js";
+export const registerStatusTools = (server, ctx) => {
+    server.registerTool("get_status", {
+        title: "Project status",
+        description: "Active sprint, in-flight stories, open debt counts, killer metric (debt delta this sprint).",
+        inputSchema: {},
+    }, async () => {
+        const { repo, session } = ctx;
+        const sprintId = session.activeSprint.id;
+        const projectId = session.project.id;
+        const inSprintByStatus = await repo.countStoriesInSprintByStatus(sprintId);
+        const backlogCount = await repo.countBacklog(projectId);
+        const openDebt = await repo.countOpenDebtByProject(projectId);
+        const opened = await repo.countEventsByKindInSprint(sprintId, "debt.opened");
+        const closed = await repo.countEventsByKindInSprint(sprintId, "debt.closed");
+        return jsonResult({
+            project: { slug: session.project.slug, name: session.project.name },
+            sprint: {
+                id: session.activeSprint.id,
+                name: session.activeSprint.name,
+                goal: session.activeSprint.goal,
+                startedAt: session.activeSprint.startedAt,
+                status: session.activeSprint.status,
+            },
+            stories: { inSprintByStatus, backlogCount },
+            debt: { open: openDebt, openedThisSprint: opened, closedThisSprint: closed, delta: opened - closed },
+            warnings: session.warnings,
+        });
+    });
+};
+//# sourceMappingURL=status.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../../server/src/tools/status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,CAAC,MAAM,mBAAmB,GAAkB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;IAChE,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAC9B,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAErC,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAC3E,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACxD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC7E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAE7E,OAAO,UAAU,CAAC;YAChB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE;YACnE,MAAM,EAAE;gBACN,EAAE,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE;gBAC3B,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI;gBAC/B,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI;gBAC/B,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,SAAS;gBACzC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,MAAM;aACpC;YACD,OAAO,EAAE,EAAE,gBAAgB,EAAE,YAAY,EAAE;YAC3C,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;YACpG,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;IACL,CAAC,CACF,CAAC;AACJ,CAAC,CAAC"}

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

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

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

@@ -0,0 +1,155 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+const STORY_STATUS = z.enum(["backlog", "todo", "doing", "review", "done", "dropped"]);
+const SIZE = z.enum(["XS", "S", "M", "L", "XL", "XXL"]);
+export const registerStoryTools = (server, ctx) => {
+    server.registerTool("open_story", {
+        title: "Open a new story",
+        description: "Create a user-valued increment. Optionally attach to an epic or sprint; default lands in backlog.",
+        inputSchema: {
+            title: z.string().min(1),
+            description: z.string().optional(),
+            acceptance: z.string().optional(),
+            epicId: z.string().optional(),
+            sprintId: z.string().optional(),
+            size: SIZE.optional(),
+            priority: z.number().int().min(1).max(5).optional(),
+            assigneeId: z.string().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const id = newId();
+        const initialStatus = args.sprintId ? "todo" : "backlog";
+        await repo.insertStory({
+            id,
+            epicId: args.epicId ?? null,
+            sprintId: args.sprintId ?? null,
+            title: args.title,
+            description: args.description ?? null,
+            acceptance: args.acceptance ?? null,
+            status: initialStatus,
+            size: args.size ?? null,
+            assigneeId: args.assigneeId ?? null,
+            priority: args.priority ?? 3,
+            startedAt: null,
+            completedAt: null,
+            createdAt: now(),
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: args.sprintId ?? session.activeSprint.id,
+            kind: "story.opened",
+            refId: id,
+            summary: `story: ${args.title}`,
+        });
+        return jsonResult({ id, title: args.title, status: initialStatus, sprintId: args.sprintId ?? null });
+    });
+    server.registerTool("update_story", {
+        title: "Update a story",
+        description: "Edit any mutable field. Status transitions to doing/review/done emit timeline events.",
+        inputSchema: {
+            id: z.string(),
+            title: z.string().optional(),
+            description: z.string().optional(),
+            acceptance: z.string().optional(),
+            status: STORY_STATUS.optional(),
+            size: SIZE.optional(),
+            priority: z.number().int().min(1).max(5).optional(),
+            assigneeId: z.string().optional(),
+            epicId: z.string().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.acceptance !== undefined)
+            updates.acceptance = args.acceptance;
+        if (args.status !== undefined)
+            updates.status = args.status;
+        if (args.size !== undefined)
+            updates.size = args.size;
+        if (args.priority !== undefined)
+            updates.priority = args.priority;
+        if (args.assigneeId !== undefined)
+            updates.assigneeId = args.assigneeId;
+        if (args.epicId !== undefined)
+            updates.epicId = args.epicId;
+        if (args.status === "doing")
+            updates.startedAt = now();
+        if (Object.keys(updates).length === 0)
+            return jsonResult({ id: args.id, changed: false });
+        await repo.updateStory(args.id, updates);
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "story.updated",
+            refId: args.id,
+            summary: `story updated: ${Object.keys(updates).join(", ")}`,
+        });
+        return jsonResult({ id: args.id, changed: true, updates });
+    });
+    server.registerTool("move_story", {
+        title: "Move a story to a sprint or back to backlog",
+        description: "Pass sprintId to move into a sprint, or null to send to backlog.",
+        inputSchema: {
+            id: z.string(),
+            sprintId: z.string().nullable().describe("null to send to backlog"),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const newStatus = args.sprintId ? "todo" : "backlog";
+        await repo.updateStory(args.id, { sprintId: args.sprintId, status: newStatus });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: args.sprintId ?? session.activeSprint.id,
+            kind: "story.moved",
+            refId: args.id,
+            summary: args.sprintId ? `story moved to sprint ${args.sprintId}` : `story moved to backlog`,
+        });
+        return jsonResult({ id: args.id, sprintId: args.sprintId, status: newStatus });
+    });
+    server.registerTool("close_story", {
+        title: "Close a story",
+        description: "Marks done (or dropped). Sets completed_at.",
+        inputSchema: {
+            id: z.string(),
+            dropped: z.boolean().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const status = args.dropped ? "dropped" : "done";
+        await repo.updateStory(args.id, { status, completedAt: now() });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "story.closed",
+            refId: args.id,
+            summary: `story ${status}`,
+        });
+        return jsonResult({ id: args.id, status });
+    });
+    server.registerTool("list_backlog", {
+        title: "List backlog stories",
+        description: "Stories not assigned to a sprint, ordered by priority then creation time.",
+        inputSchema: {
+            limit: z.number().int().positive().max(200).optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const rows = await repo.findBacklogStories(session.project.id, args.limit ?? 50);
+        return jsonResult({
+            count: rows.length,
+            stories: rows.map((r) => ({ id: r.id, title: r.title, priority: r.priority, size: r.size })),
+        });
+    });
+};
+//# sourceMappingURL=story.js.map

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

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

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

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

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

@@ -0,0 +1,90 @@
+import { z } from "zod";
+import { jsonResult } from "./types.js";
+import { newId, now } from "../util/ids.js";
+import { emitEvent } from "../events/emit.js";
+const TASK_STATUS = z.enum(["todo", "doing", "done"]);
+export const registerTaskTools = (server, ctx) => {
+    server.registerTool("open_task", {
+        title: "Open a task under a story",
+        description: "Implementation step inside a story. Not a substitute for TodoWrite.",
+        inputSchema: {
+            storyId: z.string(),
+            title: z.string().min(1),
+            assigneeId: z.string().optional(),
+            blockedBy: z.string().optional().describe("ID of a blocking task, if any."),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const id = newId();
+        await repo.insertTask({
+            id,
+            storyId: args.storyId,
+            assigneeId: args.assigneeId ?? null,
+            title: args.title,
+            status: "todo",
+            blockedBy: args.blockedBy ?? null,
+            createdAt: now(),
+        });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "task.opened",
+            refId: id,
+            summary: `task: ${args.title}`,
+        });
+        return jsonResult({ id, title: args.title, status: "todo" });
+    });
+    server.registerTool("update_task", {
+        title: "Update a task",
+        description: "Edit title, status, assignee, or blocked_by.",
+        inputSchema: {
+            id: z.string(),
+            title: z.string().optional(),
+            status: TASK_STATUS.optional(),
+            assigneeId: z.string().optional(),
+            blockedBy: z.string().nullable().optional(),
+        },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        const updates = {};
+        if (args.title !== undefined)
+            updates.title = args.title;
+        if (args.status !== undefined)
+            updates.status = args.status;
+        if (args.assigneeId !== undefined)
+            updates.assigneeId = args.assigneeId;
+        if (args.blockedBy !== undefined)
+            updates.blockedBy = args.blockedBy;
+        if (Object.keys(updates).length === 0)
+            return jsonResult({ id: args.id, changed: false });
+        await repo.updateTask(args.id, updates);
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "task.updated",
+            refId: args.id,
+            summary: `task updated: ${Object.keys(updates).join(", ")}`,
+        });
+        return jsonResult({ id: args.id, changed: true, updates });
+    });
+    server.registerTool("close_task", {
+        title: "Close a task",
+        description: "Marks a task done.",
+        inputSchema: { id: z.string() },
+    }, async (args) => {
+        const { repo, session } = ctx;
+        await repo.updateTask(args.id, { status: "done" });
+        await emitEvent(repo, {
+            projectId: session.project.id,
+            developerId: session.developer.id,
+            sprintId: session.activeSprint.id,
+            kind: "task.closed",
+            refId: args.id,
+            summary: "task done",
+        });
+        return jsonResult({ id: args.id, status: "done" });
+    });
+};
+//# sourceMappingURL=task.js.map

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

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

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

@@ -0,0 +1,15 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { HelmRepo } from "../db/repo.js";
+import type { SessionContext } from "../project/bootstrap.js";
+export interface ToolContext {
+    repo: HelmRepo;
+    session: SessionContext;
+    cwd: string;
+}
+export type ToolRegistrar = (server: McpServer, ctx: ToolContext) => void;
+export declare function jsonResult(payload: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

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

@@ -0,0 +1,11 @@
+export function jsonResult(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload, null, 2),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../server/src/tools/types.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aACvC;SACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+export interface GitProbe {
+    isRepo: boolean;
+    remoteUrl: string | null;
+    userEmail: string | null;
+}
+export declare function probeGit(cwd: string): GitProbe;
+export declare function repoRoot(cwd: string): string | null;
+export declare function parseRemoteToSlug(remoteUrl: string): string | null;

package/dist/server/src/util/git.js

@@ -0,0 +1,51 @@
+import { execFileSync } from "node:child_process";
+function tryGit(args, cwd) {
+    try {
+        const out = execFileSync("git", args, {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+        return out.trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function probeGit(cwd) {
+    const insideRepo = tryGit(["rev-parse", "--is-inside-work-tree"], cwd) === "true";
+    return {
+        isRepo: insideRepo,
+        remoteUrl: insideRepo ? tryGit(["remote", "get-url", "origin"], cwd) : null,
+        userEmail: insideRepo ? tryGit(["config", "user.email"], cwd) : null,
+    };
+}
+export function repoRoot(cwd) {
+    return tryGit(["rev-parse", "--show-toplevel"], cwd);
+}
+export function parseRemoteToSlug(remoteUrl) {
+    let url = remoteUrl.trim();
+    if (url.endsWith(".git"))
+        url = url.slice(0, -4);
+    url = url.replace(/^git@([^:]+):/, "https://$1/");
+    try {
+        const parsed = new URL(url);
+        const parts = parsed.pathname.replace(/^\/+/, "").split("/").filter(Boolean);
+        if (parts.length < 2) {
+            const tail = parts[0];
+            return tail ? sanitize(tail) : null;
+        }
+        const org = parts[parts.length - 2];
+        const repo = parts[parts.length - 1];
+        if (!org || !repo)
+            return null;
+        return sanitize(`${org}-${repo}`);
+    }
+    catch {
+        return null;
+    }
+}
+function sanitize(raw) {
+    return raw.toLowerCase().replace(/[^a-z0-9._-]/g, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+}
+//# sourceMappingURL=git.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../../server/src/util/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD,SAAS,MAAM,CAAC,IAAc,EAAE,GAAW;IACzC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;YACpC,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;IAClF,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;QAC3E,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI;KACrE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,OAAO,MAAM,CAAC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,IAAI,GAAG,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACjD,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,EAAE,aAAa,CAAC,CAAC;IAClD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACtC,CAAC;QACD,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,QAAQ,CAAC,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,GAAW;IAC3B,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnG,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function newId(): string;
+export declare function now(): string;

package/dist/server/src/util/ids.js

@@ -0,0 +1,8 @@
+import { randomUUID } from "node:crypto";
+export function newId() {
+    return randomUUID();
+}
+export function now() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=ids.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../../../server/src/util/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,UAAU,KAAK;IACnB,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function helmHome(): string;
+export declare function dbPathFor(slug: string): string;

package/dist/server/src/util/paths.js

@@ -0,0 +1,9 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function helmHome() {
+    return process.env.HELM_HOME ?? join(homedir(), ".helm");
+}
+export function dbPathFor(slug) {
+    return join(helmHome(), `${slug}.db`);
+}
+//# sourceMappingURL=paths.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../server/src/util/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,QAAQ;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;AACxC,CAAC"}

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

@@ -0,0 +1,12 @@
+import type { HookPayload } from "./scanner.js";
+interface ScanResponse {
+    ok: boolean;
+    summary?: {
+        inserted: number;
+        skipped: number;
+        filePath: string | null;
+    };
+    error?: string;
+}
+export declare function sendScan(cwd: string, payload: HookPayload): Promise<ScanResponse>;
+export {};