@uasyraf/helm 0.1.0

package/dist/server/src/db/schema.js

@@ -0,0 +1,107 @@
+import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core";
+export const project = sqliteTable("project", {
+    id: text("id").primaryKey(),
+    slug: text("slug").notNull().unique(),
+    name: text("name").notNull(),
+    gitRemote: text("git_remote"),
+    dod: text("dod"),
+    sprintLengthDays: integer("sprint_length_days").notNull().default(14),
+    wipEnabled: integer("wip_enabled", { mode: "boolean" }).notNull().default(false),
+    estimationEnabled: integer("estimation_enabled", { mode: "boolean" }).notNull().default(true),
+    createdAt: text("created_at").notNull(),
+});
+export const developer = sqliteTable("developer", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    handle: text("handle").notNull(),
+    email: text("email"),
+    lastSeenAt: text("last_seen_at").notNull(),
+});
+export const sprint = sqliteTable("sprint", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    name: text("name").notNull(),
+    goal: text("goal"),
+    startedAt: text("started_at").notNull(),
+    endedAt: text("ended_at"),
+    status: text("status").notNull(),
+    wipLimit: integer("wip_limit"),
+});
+export const epic = sqliteTable("epic", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    title: text("title").notNull(),
+    description: text("description"),
+    status: text("status").notNull().default("open"),
+    priority: integer("priority").notNull().default(3),
+    targetSprintId: text("target_sprint_id").references(() => sprint.id),
+    createdAt: text("created_at").notNull(),
+});
+export const story = sqliteTable("story", {
+    id: text("id").primaryKey(),
+    epicId: text("epic_id").references(() => epic.id),
+    sprintId: text("sprint_id").references(() => sprint.id),
+    title: text("title").notNull(),
+    description: text("description"),
+    acceptance: text("acceptance"),
+    status: text("status").notNull().default("backlog"),
+    size: text("size"),
+    assigneeId: text("assignee_id").references(() => developer.id),
+    priority: integer("priority").notNull().default(3),
+    startedAt: text("started_at"),
+    completedAt: text("completed_at"),
+    createdAt: text("created_at").notNull(),
+});
+export const task = sqliteTable("task", {
+    id: text("id").primaryKey(),
+    storyId: text("story_id").notNull().references(() => story.id),
+    assigneeId: text("assignee_id").references(() => developer.id),
+    title: text("title").notNull(),
+    status: text("status").notNull().default("todo"),
+    blockedBy: text("blocked_by"),
+    createdAt: text("created_at").notNull(),
+});
+export const techDebt = sqliteTable("tech_debt", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    title: text("title").notNull(),
+    description: text("description"),
+    severity: text("severity").notNull().default("med"),
+    location: text("location"),
+    ownerId: text("owner_id").references(() => developer.id),
+    expiresAt: text("expires_at"),
+    openedAt: text("opened_at").notNull(),
+    closedAt: text("closed_at"),
+    linkedStoryId: text("linked_story_id").references(() => story.id),
+});
+export const decision = sqliteTable("decision", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    title: text("title").notNull(),
+    context: text("context"),
+    decision: text("decision").notNull(),
+    status: text("status").notNull().default("accepted"),
+    decidedAt: text("decided_at").notNull(),
+});
+export const progressEvent = sqliteTable("progress_event", {
+    id: text("id").primaryKey(),
+    projectId: text("project_id").notNull().references(() => project.id),
+    developerId: text("developer_id").references(() => developer.id),
+    sprintId: text("sprint_id").references(() => sprint.id),
+    kind: text("kind").notNull(),
+    refId: text("ref_id"),
+    summary: text("summary").notNull(),
+    ts: text("ts").notNull(),
+});
+export const schema = {
+    project,
+    developer,
+    sprint,
+    epic,
+    story,
+    task,
+    techDebt,
+    decision,
+    progressEvent,
+};
+//# sourceMappingURL=schema.js.map

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

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

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

@@ -0,0 +1,21 @@
+import type { HelmRepo } from "../db/repo.js";
+export type EventKind = "sprint.started" | "sprint.ended" | "epic.opened" | "epic.updated" | "epic.closed" | "story.opened" | "story.updated" | "story.moved" | "story.closed" | "task.opened" | "task.updated" | "task.closed" | "debt.opened" | "debt.closed" | "decision.recorded" | "mission.linked" | "mission.logged" | "progress.logged";
+export interface EmitArgs {
+    projectId: string;
+    developerId: string | null;
+    sprintId?: string | null;
+    kind: EventKind;
+    refId?: string | null;
+    summary: string;
+}
+export declare function emitEvent(repo: HelmRepo, args: EmitArgs): Promise<void>;
+export declare function recentEvents(repo: HelmRepo, projectId: string, limit?: number): Promise<{
+    id: string;
+    projectId: string;
+    sprintId: string | null;
+    developerId: string | null;
+    kind: string;
+    refId: string | null;
+    summary: string;
+    ts: string;
+}[]>;

package/dist/server/src/events/emit.js

@@ -0,0 +1,17 @@
+import { newId, now } from "../util/ids.js";
+export async function emitEvent(repo, args) {
+    await repo.emitEvent({
+        id: newId(),
+        projectId: args.projectId,
+        developerId: args.developerId,
+        sprintId: args.sprintId ?? null,
+        kind: args.kind,
+        refId: args.refId ?? null,
+        summary: args.summary,
+        ts: now(),
+    });
+}
+export async function recentEvents(repo, projectId, limit = 50) {
+    return repo.findRecentEvents(projectId, limit);
+}
+//# sourceMappingURL=emit.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../../../server/src/events/emit.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AA+B5C,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAAc,EAAE,IAAc;IAC5D,MAAM,IAAI,CAAC,SAAS,CAAC;QACnB,EAAE,EAAE,KAAK,EAAE;QACX,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI;QACzB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,EAAE,EAAE,GAAG,EAAE;KACV,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAc,EAAE,SAAiB,EAAE,KAAK,GAAG,EAAE;IAC9E,OAAO,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,10 @@
+export interface HttpServerOptions {
+    host?: string;
+    port?: number;
+    apiToken?: string;
+    cwd?: string;
+}
+export declare function startHttpServer(opts?: HttpServerOptions): Promise<{
+    close: () => Promise<void>;
+    port: number;
+}>;

package/dist/server/src/http/server.js

@@ -0,0 +1,119 @@
+import { createServer } from "node:http";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { buildServer } from "../server.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+export async function startHttpServer(opts = {}) {
+    const host = opts.host ?? "127.0.0.1";
+    const port = opts.port ?? 4500;
+    const apiToken = opts.apiToken ?? process.env.HELM_API_TOKEN;
+    const cwd = opts.cwd ?? process.cwd();
+    const sessions = new Map();
+    const http = createServer(async (req, res) => {
+        try {
+            if (req.url === "/health" && req.method === "GET")
+                return health(res);
+            if (req.url?.startsWith("/mcp"))
+                return await handleMcp(req, res, { apiToken, cwd, sessions });
+            res.writeHead(404, { "content-type": "text/plain" }).end("not found");
+        }
+        catch (err) {
+            console.error("[helm-http] handler error:", err);
+            if (!res.headersSent)
+                res.writeHead(500, { "content-type": "text/plain" }).end("server error");
+        }
+    });
+    await new Promise((resolve, reject) => {
+        http.once("error", reject);
+        http.listen(port, host, () => resolve());
+    });
+    const addr = http.address();
+    const boundPort = typeof addr === "object" && addr ? addr.port : port;
+    console.error(`[helm-http] listening on http://${host}:${boundPort}/mcp${apiToken ? " (bearer auth)" : " (UNAUTHENTICATED)"}`);
+    return {
+        port: boundPort,
+        close: async () => {
+            for (const s of sessions.values())
+                await s.serverHandle.close();
+            sessions.clear();
+            await new Promise((resolve) => http.close(() => resolve()));
+        },
+    };
+}
+function health(res) {
+    res.writeHead(200, { "content-type": "application/json" }).end(JSON.stringify({ ok: true, name: "helm", version: "0.1.0" }));
+}
+async function handleMcp(req, res, ctx) {
+    if (!authorize(req, res, ctx.apiToken))
+        return;
+    const body = await readJsonBody(req);
+    const sessionId = req.headers["mcp-session-id"];
+    const headerId = Array.isArray(sessionId) ? sessionId[0] : sessionId;
+    let session = headerId ? ctx.sessions.get(headerId) : undefined;
+    if (!session) {
+        if (req.method !== "POST" || !body || !isInitializeRequest(body)) {
+            res.writeHead(400, { "content-type": "application/json" }).end(JSON.stringify({ error: "missing or unknown session" }));
+            return;
+        }
+        session = await createSession(ctx);
+    }
+    await session.transport.handleRequest(req, res, body);
+}
+async function createSession(ctx) {
+    const serverHandle = await buildServer(ctx.cwd);
+    const transport = new StreamableHTTPServerTransport({
+        sessionIdGenerator: () => randomUUID(),
+        onsessioninitialized: (id) => {
+            ctx.sessions.set(id, { transport, serverHandle });
+        },
+    });
+    transport.onclose = () => {
+        const id = transport.sessionId;
+        if (id) {
+            ctx.sessions.delete(id);
+            void serverHandle.close();
+        }
+    };
+    await serverHandle.server.connect(transport);
+    return { transport, serverHandle };
+}
+function authorize(req, res, expected) {
+    if (!expected)
+        return true;
+    const header = req.headers.authorization;
+    if (!header || typeof header !== "string" || !header.startsWith("Bearer ")) {
+        res.writeHead(401, { "content-type": "application/json" }).end(JSON.stringify({ error: "missing bearer token" }));
+        return false;
+    }
+    const token = header.slice("Bearer ".length).trim();
+    if (token !== expected) {
+        res.writeHead(403, { "content-type": "application/json" }).end(JSON.stringify({ error: "invalid token" }));
+        return false;
+    }
+    return true;
+}
+function readJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        let data = "";
+        req.setEncoding("utf8");
+        req.on("data", (chunk) => {
+            data += chunk;
+            if (data.length > 1_048_576) {
+                reject(new Error("request body too large"));
+                req.destroy();
+            }
+        });
+        req.on("end", () => {
+            if (!data.trim())
+                return resolve(undefined);
+            try {
+                resolve(JSON.parse(data));
+            }
+            catch (err) {
+                reject(err);
+            }
+        });
+        req.on("error", reject);
+    });
+}
+//# sourceMappingURL=server.js.map

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

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

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

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

package/dist/server/src/index.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { buildServer } from "./server.js";
+async function main() {
+    const handle = await buildServer();
+    const transport = new StdioServerTransport();
+    await handle.server.connect(transport);
+}
+main().catch((err) => {
+    console.error("[helm] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/src/index.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,WAAW,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,12 @@
+export interface InitOptions {
+    team: boolean;
+    syncUrl?: string;
+    syncToken?: string;
+    cwd?: string;
+    nonInteractive?: boolean;
+}
+export interface InitResult {
+    configPath: string;
+    wrote: boolean;
+}
+export declare function runInit(opts: InitOptions): Promise<InitResult>;

package/dist/server/src/init.js

@@ -0,0 +1,59 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { repoRoot } from "./util/git.js";
+export async function runInit(opts) {
+    const cwd = opts.cwd ?? process.cwd();
+    const root = repoRoot(cwd) ?? cwd;
+    const helmDir = join(root, ".helm");
+    const configPath = join(helmDir, "config.json");
+    if (!opts.team) {
+        return { configPath, wrote: false };
+    }
+    let syncUrl = opts.syncUrl;
+    let syncToken = opts.syncToken;
+    if (!opts.nonInteractive && !syncUrl) {
+        const rl = createInterface({ input: stdin, output: stdout });
+        try {
+            stdout.write("helm init --team\n");
+            stdout.write("---\n");
+            stdout.write("Configure shared sync so teammates running `npx -y @uasyraf/helm` auto-pick it up.\n\n");
+            syncUrl = (await rl.question("Turso sync URL (libsql://...): ")).trim();
+            if (!syncUrl) {
+                stdout.write("aborted: no sync URL provided\n");
+                return { configPath, wrote: false };
+            }
+            syncToken = (await rl.question("Auth token (optional, blank for none): ")).trim() || undefined;
+        }
+        finally {
+            rl.close();
+        }
+    }
+    if (!syncUrl) {
+        throw new Error("--sync-url required in non-interactive mode");
+    }
+    mkdirSync(helmDir, { recursive: true });
+    const existing = readExisting(configPath);
+    const next = {
+        ...existing,
+        sync: {
+            ...(existing.sync ?? {}),
+            url: syncUrl,
+            ...(syncToken ? { authToken: syncToken } : {}),
+        },
+    };
+    writeFileSync(configPath, JSON.stringify(next, null, 2) + "\n", "utf8");
+    return { configPath, wrote: true };
+}
+function readExisting(path) {
+    if (!existsSync(path))
+        return {};
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=init.js.map

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

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

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

@@ -0,0 +1,8 @@
+export declare function installHooks(settingsPath?: string): {
+    installed: string[];
+    path: string;
+};
+export declare function installSkills(skillsRoot?: string): {
+    installed: string[];
+    skipped: string[];
+};

package/dist/server/src/install.js

@@ -0,0 +1,100 @@
+import { existsSync, mkdirSync, readFileSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+const HELM_SESSION_START_TAG = "# helm: SessionStart";
+const HELM_POST_TOOL_USE_TAG = "# helm: PostToolUse";
+const HELM_STATUSLINE_TAG = "# helm: statusline";
+function packageRoot() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    let dir = here;
+    while (true) {
+        if (existsSync(join(dir, "package.json")))
+            return dir;
+        const parent = dirname(dir);
+        if (parent === dir)
+            return here;
+        dir = parent;
+    }
+}
+export function installHooks(settingsPath = join(homedir(), ".claude", "settings.json")) {
+    mkdirSync(dirname(settingsPath), { recursive: true });
+    const existing = existsSync(settingsPath)
+        ? JSON.parse(readFileSync(settingsPath, "utf8"))
+        : {};
+    existing.hooks ??= {};
+    existing.hooks.SessionStart ??= [];
+    existing.hooks.PostToolUse ??= [];
+    const installed = [];
+    if (!hasTag(existing.hooks.SessionStart, HELM_SESSION_START_TAG)) {
+        existing.hooks.SessionStart.push({
+            matcher: "*",
+            hooks: [
+                {
+                    type: "command",
+                    command: `npx -y @uasyraf/helm banner 2>/dev/null ${HELM_SESSION_START_TAG}`,
+                    timeout: 5,
+                },
+            ],
+        });
+        installed.push("SessionStart");
+    }
+    if (!hasTag(existing.hooks.PostToolUse, HELM_POST_TOOL_USE_TAG)) {
+        existing.hooks.PostToolUse.push({
+            matcher: "Edit|Write|MultiEdit",
+            hooks: [
+                {
+                    type: "command",
+                    command: `npx -y @uasyraf/helm hook post-tool-use 2>/dev/null ${HELM_POST_TOOL_USE_TAG}`,
+                    timeout: 5,
+                },
+            ],
+        });
+        installed.push("PostToolUse");
+    }
+    if (!existing.statusLine || !existing.statusLine.command.includes(HELM_STATUSLINE_TAG)) {
+        existing.statusLine = {
+            type: "command",
+            command: `npx -y @uasyraf/helm banner 2>/dev/null ${HELM_STATUSLINE_TAG}`,
+            padding: 0,
+        };
+        installed.push("statusLine");
+    }
+    if (installed.length > 0) {
+        writeFileSync(settingsPath, JSON.stringify(existing, null, 2) + "\n", "utf8");
+    }
+    return { installed, path: settingsPath };
+}
+function hasTag(matchers, tag) {
+    return matchers.some((m) => m.hooks.some((h) => h.command.includes(tag)));
+}
+export function installSkills(skillsRoot = join(homedir(), ".claude", "skills")) {
+    mkdirSync(skillsRoot, { recursive: true });
+    const pkgSkillsDir = join(packageRoot(), "skills");
+    if (!existsSync(pkgSkillsDir))
+        return { installed: [], skipped: [] };
+    const skills = ["project-tracker", "sprint", "story", "epic", "debt", "backlog", "review", "nelson-integration"];
+    const installed = [];
+    const skipped = [];
+    for (const name of skills) {
+        const src = join(pkgSkillsDir, name);
+        const dst = join(skillsRoot, name);
+        if (!existsSync(src)) {
+            skipped.push(name);
+            continue;
+        }
+        if (existsSync(dst)) {
+            try {
+                unlinkSync(dst);
+            }
+            catch {
+                skipped.push(name);
+                continue;
+            }
+        }
+        symlinkSync(src, dst, "dir");
+        installed.push(name);
+    }
+    return { installed, skipped };
+}
+//# sourceMappingURL=install.js.map

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

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

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

@@ -0,0 +1,9 @@
+import type { HelmRepo } from "../db/repo.js";
+import type { Project, Developer, Sprint } from "../db/schema.js";
+export interface SessionContext {
+    project: Project;
+    developer: Developer;
+    activeSprint: Sprint;
+    warnings: string[];
+}
+export declare function bootstrapSession(repo: HelmRepo, cwd: string): Promise<SessionContext>;

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

@@ -0,0 +1,83 @@
+import { newId, now } from "../util/ids.js";
+import { detectProject } from "./detect.js";
+import { resolveIdentity } from "./identity.js";
+import { emitEvent } from "../events/emit.js";
+export async function bootstrapSession(repo, cwd) {
+    const warnings = [];
+    const detected = detectProject(cwd);
+    if (detected.warning)
+        warnings.push(detected.warning);
+    const identity = resolveIdentity(cwd);
+    if (identity.prompt)
+        warnings.push(identity.prompt);
+    const projectRow = await ensureProject(repo, detected);
+    const developerRow = await ensureDeveloper(repo, projectRow.id, identity);
+    const sprintRow = await ensureActiveSprint(repo, projectRow, developerRow.id);
+    return {
+        project: projectRow,
+        developer: developerRow,
+        activeSprint: sprintRow,
+        warnings,
+    };
+}
+async function ensureProject(repo, detected) {
+    const existing = await repo.findProjectBySlug(detected.slug);
+    if (existing)
+        return existing;
+    const row = {
+        id: newId(),
+        slug: detected.slug,
+        name: detected.name,
+        gitRemote: detected.gitRemote,
+        dod: null,
+        sprintLengthDays: 14,
+        wipEnabled: false,
+        estimationEnabled: true,
+        createdAt: now(),
+    };
+    await repo.insertProject(row);
+    return row;
+}
+async function ensureDeveloper(repo, projectId, identity) {
+    const existing = await repo.findDeveloperByHandle(projectId, identity.handle);
+    if (existing) {
+        const updated = { ...existing, lastSeenAt: now() };
+        await repo.touchDeveloper(existing.id, updated.lastSeenAt);
+        return updated;
+    }
+    const row = {
+        id: newId(),
+        projectId,
+        handle: identity.handle,
+        email: identity.email,
+        lastSeenAt: now(),
+    };
+    await repo.insertDeveloper(row);
+    return row;
+}
+async function ensureActiveSprint(repo, projectRow, developerId) {
+    const existing = await repo.findActiveSprint(projectRow.id);
+    if (existing)
+        return existing;
+    const row = {
+        id: newId(),
+        projectId: projectRow.id,
+        name: "sprint-1",
+        goal: null,
+        startedAt: now(),
+        endedAt: null,
+        status: "active",
+        wipLimit: null,
+    };
+    await repo.insertSprint(row);
+    await emitEvent(repo, {
+        projectId: projectRow.id,
+        developerId,
+        sprintId: row.id,
+        kind: "sprint.started",
+        refId: row.id,
+        summary: `${row.name} started (default, 14d)`,
+    });
+    return row;
+}
+//# sourceMappingURL=bootstrap.js.map

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

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

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

@@ -0,0 +1,10 @@
+export type SlugSource = "remote" | "cwd-with-git" | "cwd-no-git" | "override";
+export interface DetectedProject {
+    slug: string;
+    name: string;
+    gitRemote: string | null;
+    source: SlugSource;
+    warning: string | null;
+    rootDir: string;
+}
+export declare function detectProject(cwd: string): DetectedProject;