@rryando/arcs 3.10.0 → 3.11.0

package/dist/web-server/routes/collections.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Collection routes: knowledge, tasks, plans — full CRUD.
+ *
+ * All meta mutations go through the same locked, validated store functions the
+ * CLI uses (knowledge-store / task-store / plan-store). Body .md files are
+ * plain markdown and are read/written directly; meta file paths come from the
+ * store indexes, never from client input.
+ */
+import { Hono } from "hono";
+export declare const collectionsRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=collections.d.ts.map

package/dist/web-server/routes/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/collections.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgC5B,eAAO,MAAM,gBAAgB,4EAAa,CAAC"}

package/dist/web-server/routes/collections.js

@@ -0,0 +1,217 @@
+/**
+ * Collection routes: knowledge, tasks, plans — full CRUD.
+ *
+ * All meta mutations go through the same locked, validated store functions the
+ * CLI uses (knowledge-store / task-store / plan-store). Body .md files are
+ * plain markdown and are read/written directly; meta file paths come from the
+ * store indexes, never from client input.
+ */
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { Hono } from "hono";
+import { z } from "zod";
+import { DagError } from "../../utils/errors.js";
+import { createKnowledgeEntry, deleteKnowledgeEntry, KNOWLEDGE_AUDIENCES, KNOWLEDGE_KINDS, readKnowledgeIndex, updateKnowledgeDocument, } from "../../utils/knowledge-store.js";
+import { createPlan, deletePlan, PLAN_STATUSES, readPlanIndex, updatePlanDocument, } from "../../utils/plan-store.js";
+import { normalizeIdentifier } from "../../utils/slug.js";
+import { createTask, deleteTask, listTasks, TASK_PRIORITIES, TASK_STATUSES, updateTask, } from "../../utils/task-store.js";
+import { toposort } from "../../utils/toposort.js";
+import { parseBody, requireProjectDir, respond } from "../respond.js";
+export const collectionsRoute = new Hono();
+// ---------------------------------------------------------------------------
+// Shared zod pieces
+// ---------------------------------------------------------------------------
+const fileRefSchema = z.object({ path: z.string(), anchor: z.string().optional() });
+async function readEntryBody(projectDir, file) {
+    try {
+        return await readFile(join(projectDir, file), "utf-8");
+    }
+    catch {
+        return "";
+    }
+}
+function findById(items, rawId, what) {
+    const normalizedId = normalizeIdentifier(rawId);
+    const item = items.find((i) => i.normalizedId === normalizedId);
+    if (!item) {
+        throw new DagError("ENTITY_NOT_FOUND", `${what} "${rawId}" not found`);
+    }
+    return item;
+}
+// ---------------------------------------------------------------------------
+// Knowledge
+// ---------------------------------------------------------------------------
+const createKnowledgeSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    kind: z.enum(KNOWLEDGE_KINDS),
+    audience: z.enum(KNOWLEDGE_AUDIENCES).optional(),
+    keywords: z.array(z.string()).default([]),
+    summary: z.string().optional(),
+    content: z.string().optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+});
+const updateKnowledgeSchema = z.object({
+    title: z.string().min(1).optional(),
+    kind: z.enum(KNOWLEDGE_KINDS).optional(),
+    audience: z.enum(KNOWLEDGE_AUDIENCES).nullable().optional(),
+    keywords: z.array(z.string()).optional(),
+    summary: z.string().optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+    body: z.string().optional(),
+});
+collectionsRoute.get("/api/p/:slug/knowledge", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const index = await readKnowledgeIndex(projectDir);
+    return { entries: index.entries };
+}));
+collectionsRoute.post("/api/p/:slug/knowledge", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const input = await parseBody(c, createKnowledgeSchema);
+    return createKnowledgeEntry(projectDir, input);
+}, 201));
+collectionsRoute.get("/api/p/:slug/knowledge/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const index = await readKnowledgeIndex(projectDir);
+    const meta = findById(index.entries, c.req.param("id"), "Knowledge entry");
+    const body = await readEntryBody(projectDir, meta.file);
+    return { meta, body };
+}));
+collectionsRoute.patch("/api/p/:slug/knowledge/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const id = c.req.param("id");
+    const input = await parseBody(c, updateKnowledgeSchema);
+    const { body, audience, ...metaFields } = input;
+    return updateKnowledgeDocument(projectDir, {
+        id,
+        ...metaFields,
+        ...(audience !== undefined && { audience }),
+        ...(body !== undefined && { content: body }),
+    });
+}));
+collectionsRoute.delete("/api/p/:slug/knowledge/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    await deleteKnowledgeEntry(projectDir, c.req.param("id"));
+    return { deleted: true };
+}));
+// ---------------------------------------------------------------------------
+// Tasks
+// ---------------------------------------------------------------------------
+const createTaskSchema = z.object({
+    title: z.string().min(1),
+    status: z.enum(TASK_STATUSES).optional(),
+    priority: z.enum(TASK_PRIORITIES).optional(),
+    planId: z.string().optional(),
+    dependsOn: z.array(z.string()).optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+    scope: z.string().optional(),
+    acceptance: z.string().optional(),
+    verify: z.string().optional(),
+    skill: z.string().optional(),
+    workMode: z.enum(["bounded", "inspect"]).optional(),
+});
+const updateTaskSchema = z.object({
+    title: z.string().min(1).optional(),
+    status: z.enum(TASK_STATUSES).optional(),
+    priority: z.enum(TASK_PRIORITIES).optional(),
+    planId: z.string().nullable().optional(),
+    dependsOn: z.array(z.string()).nullable().optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+    scope: z.string().nullable().optional(),
+    acceptance: z.string().nullable().optional(),
+    verify: z.string().nullable().optional(),
+    skill: z.string().nullable().optional(),
+    workMode: z.enum(["bounded", "inspect"]).nullable().optional(),
+});
+collectionsRoute.get("/api/p/:slug/tasks", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const tasks = await listTasks(projectDir);
+    let order = null;
+    if (c.req.query("order") === "topo") {
+        try {
+            order = toposort(tasks.map((t) => ({ id: t.normalizedId, dependsOn: t.dependsOn, priority: t.priority })));
+        }
+        catch {
+            order = null;
+        }
+    }
+    return { tasks, order };
+}));
+collectionsRoute.post("/api/p/:slug/tasks", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const input = await parseBody(c, createTaskSchema);
+    return createTask(projectDir, input);
+}, 201));
+collectionsRoute.patch("/api/p/:slug/tasks/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const input = await parseBody(c, updateTaskSchema);
+    return updateTask(projectDir, { id: c.req.param("id"), ...input });
+}));
+collectionsRoute.delete("/api/p/:slug/tasks/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    await deleteTask(projectDir, c.req.param("id"));
+    return { deleted: true };
+}));
+// ---------------------------------------------------------------------------
+// Plans
+// ---------------------------------------------------------------------------
+const createPlanSchema = z.object({
+    id: z.string().min(1),
+    title: z.string().min(1),
+    status: z.enum(PLAN_STATUSES),
+    keywords: z.array(z.string()).default([]),
+    summary: z.string().optional(),
+    content: z.string().optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+});
+const updatePlanSchema = z.object({
+    title: z.string().min(1).optional(),
+    status: z.enum(PLAN_STATUSES).optional(),
+    keywords: z.array(z.string()).optional(),
+    summary: z.string().optional(),
+    sourceFiles: z.array(fileRefSchema).optional(),
+    body: z.string().optional(),
+    diagram: z.string().nullable().optional(),
+});
+collectionsRoute.get("/api/p/:slug/plans", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const index = await readPlanIndex(projectDir);
+    return { plans: index.plans };
+}));
+collectionsRoute.post("/api/p/:slug/plans", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const input = await parseBody(c, createPlanSchema);
+    return createPlan(projectDir, input);
+}, 201));
+collectionsRoute.get("/api/p/:slug/plans/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const index = await readPlanIndex(projectDir);
+    const meta = findById(index.plans, c.req.param("id"), "Plan");
+    const body = await readEntryBody(projectDir, meta.file);
+    let diagram = null;
+    try {
+        diagram = await readFile(join(projectDir, "plans", `${meta.normalizedId}.diagram.mmd`), "utf-8");
+    }
+    catch {
+        diagram = null;
+    }
+    return { meta, body, diagram };
+}));
+collectionsRoute.patch("/api/p/:slug/plans/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    const id = c.req.param("id");
+    const input = await parseBody(c, updatePlanSchema);
+    const { body, diagram, ...metaFields } = input;
+    return updatePlanDocument(projectDir, {
+        id,
+        ...metaFields,
+        ...(body !== undefined && { content: body }),
+        ...(diagram !== undefined && { diagram }),
+    });
+}));
+collectionsRoute.delete("/api/p/:slug/plans/:id", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    await deletePlan(projectDir, c.req.param("id"));
+    return { deleted: true };
+}));
+//# sourceMappingURL=collections.js.map

package/dist/web-server/routes/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../../src/web-server/routes/collections.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,eAAe,EAEf,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EAEb,aAAa,EACb,kBAAkB,GACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,IAAI,EAAE,CAAC;AAE3C,8EAA8E;AAC9E,oBAAoB;AACpB,8EAA8E;AAE9E,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAEpF,KAAK,UAAU,aAAa,CAAC,UAAkB,EAAE,IAAY;IAC3D,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAqC,KAAU,EAAE,KAAa,EAAE,IAAY;IAC3F,MAAM,YAAY,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,YAAY,CAAC,CAAC;IAChE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,GAAG,IAAI,KAAK,KAAK,aAAa,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,8EAA8E;AAC9E,YAAY;AACZ,8EAA8E;AAE9E,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE;IAChD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3D,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,gBAAgB,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACzD,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACnD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;AACpC,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,IAAI,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC1D,OAAO,CACL,CAAC,EACD,KAAK,IAAI,EAAE;IACT,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACxD,OAAO,oBAAoB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjD,CAAC,EACD,GAAG,CACJ,CACF,CAAC;AAEF,gBAAgB,CAAC,GAAG,CAAC,4BAA4B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC7D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,QAAQ,CAAgB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,iBAAiB,CAAC,CAAC;IAC1F,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC/D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACxD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;IAChD,OAAO,uBAAuB,CAAC,UAAU,EAAE;QACzC,EAAE;QACF,GAAG,UAAU;QACb,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC3C,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;KAC7C,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,4BAA4B,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAChE,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,oBAAoB,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC,CAAC,CACH,CAAC;AAEF,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACzC,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE;CACpD,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC9C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC/D,CAAC,CAAC;AAEH,gBAAgB,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACrD,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,CAAC;IAE1C,IAAI,KAAK,GAAoB,IAAI,CAAC;IAClC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;QACpC,IAAI,CAAC;YACH,KAAK,GAAG,QAAQ,CACd,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CACzF,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACtD,OAAO,CACL,CAAC,EACD,KAAK,IAAI,EAAE;IACT,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC,EACD,GAAG,CACJ,CACF,CAAC;AAEF,gBAAgB,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC3D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;AACrE,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC5D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC,CAAC,CACH,CAAC;AAEF,8EAA8E;AAC9E,QAAQ;AACR,8EAA8E;AAE9E,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;IAC7B,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACzC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACnC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IACxC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEH,gBAAgB,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACrD,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;AAChC,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,IAAI,CAAC,oBAAoB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACtD,OAAO,CACL,CAAC,EACD,KAAK,IAAI,EAAE;IACT,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC,EACD,GAAG,CACJ,CACF,CAAC;AAEF,gBAAgB,CAAC,GAAG,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CACzD,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,UAAU,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,QAAQ,CAAW,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CACtB,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,YAAY,cAAc,CAAC,EAC7D,OAAO,CACR,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC3D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACnD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,UAAU,EAAE,GAAG,KAAK,CAAC;IAC/C,OAAO,kBAAkB,CAAC,UAAU,EAAE;QACpC,EAAE;QACF,GAAG,UAAU;QACb,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC5C,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI,EAAE,OAAO,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC;AAEF,gBAAgB,CAAC,MAAM,CAAC,wBAAwB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,CAC5D,OAAO,CAAC,CAAC,EAAE,KAAK,IAAI,EAAE;IACpB,MAAM,UAAU,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC3B,CAAC,CAAC,CACH,CAAC"}

package/dist/web-server/routes/discovery.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Discovery routes: per-project graph (serialized adjacency index),
+ * BM25 cross-project search, and codegraph proposal queue actions.
+ */
+import { Hono } from "hono";
+export declare const discoveryRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/web-server/routes/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAkB5B,eAAO,MAAM,cAAc,4EAAa,CAAC"}

package/dist/web-server/routes/discovery.js

@@ -0,0 +1,159 @@
+/**
+ * Discovery routes: per-project graph (serialized adjacency index),
+ * BM25 cross-project search, and codegraph proposal queue actions.
+ */
+import { join } from "node:path";
+import { Hono } from "hono";
+import { z } from "zod";
+import { searchAcrossProjects } from "../../retrieval/cross-project-search.js";
+import { buildAdjacencyIndex } from "../../retrieval/graph-builder.js";
+import { DagError } from "../../utils/errors.js";
+import { withLock } from "../../utils/file-lock.js";
+import { createKnowledgeEntry, deleteKnowledgeEntry, readKnowledgeIndex, } from "../../utils/knowledge-store.js";
+import { readPlanIndex } from "../../utils/plan-store.js";
+import { readProposals, removeProposal } from "../../utils/proposal-store.js";
+import { listTasks } from "../../utils/task-store.js";
+import { parseBody, requireProjectDir, respond } from "../respond.js";
+export const discoveryRoute = new Hono();
+discoveryRoute.get("/api/p/:slug/graph", async (c) => respond(c, async () => {
+    const slug = c.req.param("slug");
+    const projectDir = requireProjectDir(slug);
+    const adjacency = await buildAdjacencyIndex(slug);
+    const [knowledge, plans, tasks] = await Promise.all([
+        readKnowledgeIndex(projectDir).catch(() => ({ entries: [] })),
+        readPlanIndex(projectDir).catch(() => ({ plans: [] })),
+        listTasks(projectDir).catch(() => []),
+    ]);
+    const kindByKnowledgeId = new Map(knowledge.entries.map((e) => [e.normalizedId, e.kind]));
+    const statusByPlanId = new Map(plans.plans.map((p) => [p.normalizedId, p.status]));
+    const taskByNormalizedId = new Map(tasks.map((t) => [t.normalizedId, t]));
+    const nodes = [...adjacency.nodes.values()].map((node) => {
+        const sep = node.id.indexOf(":");
+        const rawId = sep >= 0 ? node.id.slice(sep + 1) : node.id;
+        const enriched = { ...node };
+        if (node.type === "knowledge") {
+            enriched.kind = kindByKnowledgeId.get(rawId);
+        }
+        else if (node.type === "plan") {
+            enriched.status = statusByPlanId.get(rawId);
+        }
+        else if (node.type === "task") {
+            const task = taskByNormalizedId.get(rawId);
+            enriched.status = task?.status;
+            enriched.priority = task?.priority;
+        }
+        return enriched;
+    });
+    const edges = [...adjacency.edges.values()].flat();
+    return {
+        nodes,
+        edges,
+        buildTime: adjacency.buildTime,
+        sourceHashes: adjacency.sourceHashes,
+    };
+}));
+// ---------------------------------------------------------------------------
+// GET /api/search?q=... — BM25 search across projects
+// ---------------------------------------------------------------------------
+discoveryRoute.get("/api/search", async (c) => respond(c, async () => {
+    const rawQuery = c.req.query("q") ?? "";
+    if (rawQuery.length > 256) {
+        throw new DagError("INVALID_QUERY", "Search queries must be 256 characters or fewer");
+    }
+    const q = rawQuery.trim();
+    const slug = c.req.query("slug");
+    const kind = c.req.query("kind");
+    const limitRaw = Number(c.req.query("limit") ?? "20");
+    const limit = Number.isFinite(limitRaw) ? Math.min(Math.max(1, limitRaw), 100) : 20;
+    if (q.length < 2)
+        return { results: [], query: q };
+    const results = await searchAcrossProjects({
+        query: q,
+        limit,
+        projectSlugs: slug ? [slug] : undefined,
+        includeKnowledge: true,
+        includePlans: true,
+        kind: kind || undefined,
+    });
+    return { results, query: q };
+}));
+// ---------------------------------------------------------------------------
+// Proposals — list, drop, promote
+// ---------------------------------------------------------------------------
+discoveryRoute.get("/api/p/:slug/proposals", async (c) => respond(c, async () => {
+    const slug = c.req.param("slug");
+    requireProjectDir(slug);
+    const file = await readProposals(slug);
+    return {
+        proposals: file?.proposals ?? [],
+        generatedAt: file?.generatedAt ?? null,
+        graphFingerprint: file?.graphFingerprint ?? null,
+    };
+}));
+discoveryRoute.post("/api/p/:slug/proposals/:id/drop", async (c) => respond(c, async () => {
+    const slug = c.req.param("slug");
+    requireProjectDir(slug);
+    const removed = await removeProposal(slug, c.req.param("id"));
+    if (!removed) {
+        throw new DagError("ENTITY_NOT_FOUND", `Proposal "${c.req.param("id")}" not found`);
+    }
+    return { removed: true };
+}));
+const promoteSchema = z.object({
+    title: z.string().min(1).optional(),
+    summary: z.string().optional(),
+    keywords: z.array(z.string()).optional(),
+    content: z.string().optional(),
+});
+discoveryRoute.post("/api/p/:slug/proposals/:id/promote", async (c) => respond(c, async () => {
+    const slug = c.req.param("slug");
+    const projectDir = requireProjectDir(slug);
+    const proposalId = c.req.param("id");
+    const overrides = await parseBody(c, promoteSchema);
+    return withLock(join(projectDir, ".proposal-promotion"), async () => {
+        const file = await readProposals(slug);
+        const proposal = file?.proposals.find((entry) => entry.id === proposalId);
+        if (!proposal) {
+            throw new DagError("ENTITY_NOT_FOUND", `Proposal "${proposalId}" not found`);
+        }
+        const defaultContent = [
+            `# ${overrides.title ?? proposal.label}`,
+            "",
+            "## Structural facts",
+            "",
+            "```json",
+            JSON.stringify(proposal.structuralFacts, null, 2),
+            "```",
+            "",
+            "## Source files",
+            "",
+            ...proposal.sourceFiles.map((source) => `- \`${source.path}\`${source.anchor ? ` — ${source.anchor}` : ""}`),
+            "",
+        ].join("\n");
+        const created = await createKnowledgeEntry(projectDir, {
+            id: proposal.id,
+            title: overrides.title ?? proposal.label,
+            kind: proposal.kind,
+            keywords: overrides.keywords ?? [],
+            summary: overrides.summary ?? "",
+            content: overrides.content ?? defaultContent,
+            sourceFiles: proposal.sourceFiles,
+        });
+        try {
+            const removed = await removeProposal(slug, proposalId);
+            if (!removed)
+                throw new Error(`Proposal "${proposalId}" disappeared during promotion`);
+        }
+        catch (error) {
+            try {
+                await deleteKnowledgeEntry(projectDir, created.normalizedId);
+            }
+            catch (rollbackError) {
+                throw new DagError("PROMOTION_INCOMPLETE", `Proposal promotion created knowledge entry "${created.normalizedId}" but both proposal removal and rollback failed. Delete the knowledge entry or drop the proposal before retrying. Removal error: ${error instanceof Error ? error.message : String(error)}. Rollback error: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}.`);
+            }
+            throw error;
+        }
+        return { promoted: true, entry: created };
+    });
+}, 201));
+//# sourceMappingURL=discovery.js.map

package/dist/web-server/routes/discovery.js.map

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

package/dist/web-server/routes/events.d.ts

@@ -0,0 +1,6 @@
+/**
+ * SSE route: pushes debounced data-dir change events to connected clients.
+ */
+import { Hono } from "hono";
+export declare const eventsRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=events.d.ts.map

package/dist/web-server/routes/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,eAAO,MAAM,WAAW,4EAAa,CAAC"}

package/dist/web-server/routes/events.js

@@ -0,0 +1,25 @@
+/**
+ * SSE route: pushes debounced data-dir change events to connected clients.
+ */
+import { Hono } from "hono";
+import { streamSSE } from "hono/streaming";
+import { onDataChange } from "../watcher.js";
+export const eventsRoute = new Hono();
+const HEARTBEAT_MS = 25_000;
+eventsRoute.get("/api/events", (c) => streamSSE(c, async (stream) => {
+    const listener = (event) => {
+        void stream.writeSSE({ event: "change", data: JSON.stringify(event) }).catch(() => { });
+    };
+    const unsubscribe = onDataChange(listener);
+    const heartbeat = setInterval(() => {
+        void stream.writeSSE({ event: "ping", data: "{}" }).catch(() => { });
+    }, HEARTBEAT_MS);
+    await new Promise((resolve) => {
+        stream.onAbort(() => {
+            clearInterval(heartbeat);
+            unsubscribe();
+            resolve();
+        });
+    });
+}));
+//# sourceMappingURL=events.js.map

package/dist/web-server/routes/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../../src/web-server/routes/events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAoB,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;AAEtC,MAAM,YAAY,GAAG,MAAM,CAAC;AAE5B,WAAW,CAAC,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,EAAE,CACnC,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;IAC5B,MAAM,QAAQ,GAAG,CAAC,KAAkB,EAAE,EAAE;QACtC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACzF,CAAC,CAAC;IACF,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,KAAK,MAAM,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtE,CAAC,EAAE,YAAY,CAAC,CAAC;IAEjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YAClB,aAAa,CAAC,SAAS,CAAC,CAAC;YACzB,WAAW,EAAE,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CACH,CAAC"}

package/dist/web-server/routes/hook-events.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Claude Code session-bridge endpoint.
+ *
+ * Claude Code has no live-injection channel: hooks are stateless, fire per
+ * event, and hold no persistent connection. So the session drives the bridge —
+ * it announces itself at `SessionStart`, picks up whatever the web UI queued at
+ * every `UserPromptSubmit` checkpoint, closes out at `SessionEnd`, and reports
+ * its transcript at `Stop` (the last checkpoint before teardown).
+ *
+ * The response stays ARCS-shaped (`{sessionId, queuedMessages}`); turning that
+ * into Claude Code's `hookSpecificOutput` envelope is the hook script's job, so
+ * a change to Claude Code's wire format never reaches the server.
+ *
+ * Unlike every other route here this one is not browser-facing, so it sits
+ * behind `requireHookToken` in addition to the global loopback check.
+ */
+import { Hono } from "hono";
+export declare const hookEventsRoute: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=hook-events.d.ts.map

package/dist/web-server/routes/hook-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-events.d.ts","sourceRoot":"","sources":["../../../src/web-server/routes/hook-events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAY5B,eAAO,MAAM,eAAe,4EAAa,CAAC"}

package/dist/web-server/routes/hook-events.js

@@ -0,0 +1,135 @@
+/**
+ * Claude Code session-bridge endpoint.
+ *
+ * Claude Code has no live-injection channel: hooks are stateless, fire per
+ * event, and hold no persistent connection. So the session drives the bridge —
+ * it announces itself at `SessionStart`, picks up whatever the web UI queued at
+ * every `UserPromptSubmit` checkpoint, closes out at `SessionEnd`, and reports
+ * its transcript at `Stop` (the last checkpoint before teardown).
+ *
+ * The response stays ARCS-shaped (`{sessionId, queuedMessages}`); turning that
+ * into Claude Code's `hookSpecificOutput` envelope is the hook script's job, so
+ * a change to Claude Code's wire format never reaches the server.
+ *
+ * Unlike every other route here this one is not browser-facing, so it sits
+ * behind `requireHookToken` in addition to the global loopback check.
+ */
+import { Hono } from "hono";
+import { z } from "zod";
+import { mirrorSessionTranscript } from "../../utils/claude-transcript.js";
+import { drainSessionMessageQueue, getSession, updateSession, upsertSession, } from "../../utils/session-store.js";
+import { parseBody, requireProjectDir, respond } from "../respond.js";
+export const hookEventsRoute = new Hono();
+/**
+ * Claude Code's native stdin fields, forwarded verbatim by the hook script.
+ * Unknown extra fields are ignored rather than rejected — Claude Code adds
+ * fields between releases and a hook must not start failing because of it.
+ */
+const hookEventSchema = z.object({
+    hook_event_name: z.enum(["SessionStart", "UserPromptSubmit", "Stop", "SessionEnd"]),
+    session_id: z.string().min(1),
+    cwd: z.string().optional(),
+    source: z.string().optional(),
+    prompt: z.string().optional(),
+    reason: z.string().optional(),
+    transcript_path: z.string().optional(),
+    control: z.string().optional(),
+});
+/**
+ * Builds the metadata persisted on the session. Claude Code's `cwd` lands under
+ * the `directory` key: that is the metadata key the sessions UI and the opencode
+ * bridge already read, so both runtimes render their worktree the same way.
+ * `transcript_path` is persisted under `transcriptPath` (the sessions UI reads
+ * that key) so headless-run write-backs can resolve the transcript without the
+ * client resupplying it, and `control` is persisted verbatim — the "arcs-owned"
+ * marker that suppresses transcript mirroring for records ARCS wrote itself.
+ */
+function sessionMetadata(event) {
+    const metadata = {
+        ...(event.cwd && { directory: event.cwd }),
+        ...(event.source && { source: event.source }),
+        ...(event.control !== undefined && { control: event.control }),
+        ...(event.transcript_path !== undefined && { transcriptPath: event.transcript_path }),
+    };
+    return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+function registerSession(projectDir, event) {
+    const metadata = sessionMetadata(event);
+    return upsertSession(projectDir, {
+        runtimeType: "claude-code",
+        runtimeSessionId: event.session_id,
+        status: "active",
+        ...(metadata && { metadata }),
+    });
+}
+/**
+ * Merges checkpoint-derived fields (transcriptPath, control, directory…) into
+ * the session's metadata. A checkpoint usually arrives for a session registered
+ * at SessionStart, so `resolveCheckpointSession` returns it without persisting
+ * the checkpoint's own fields — without this merge the transcript path and the
+ * arcs-owned marker carried by the checkpoint would be dropped.
+ */
+async function persistCheckpointMetadata(projectDir, session, event) {
+    const metadata = sessionMetadata(event);
+    if (metadata === undefined)
+        return session;
+    return updateSession(projectDir, { id: session.normalizedId, metadata });
+}
+/**
+ * Resolves the session behind a checkpoint, registering it if this is the first
+ * event ARCS has seen. `resume`/`compact` can deliver a prompt for a session
+ * whose SessionStart never reached us, and dropping the checkpoint would strand
+ * every message queued for it.
+ */
+async function resolveCheckpointSession(projectDir, event) {
+    try {
+        return await getSession(projectDir, event.session_id);
+    }
+    catch {
+        return registerSession(projectDir, event);
+    }
+}
+async function handleHookEvent(projectDir, event) {
+    if (event.hook_event_name === "SessionStart") {
+        const session = await registerSession(projectDir, event);
+        return { sessionId: session.normalizedId, queuedMessages: [] };
+    }
+    if (event.hook_event_name === "UserPromptSubmit") {
+        const session = await resolveCheckpointSession(projectDir, event);
+        const checkpoint = await persistCheckpointMetadata(projectDir, session, event);
+        if (event.transcript_path !== undefined && checkpoint.metadata?.control !== "arcs-owned") {
+            await mirrorSessionTranscript(projectDir, checkpoint.normalizedId, event.transcript_path);
+        }
+        const queuedMessages = await drainSessionMessageQueue(projectDir, checkpoint.normalizedId);
+        return { sessionId: checkpoint.normalizedId, queuedMessages };
+    }
+    if (event.hook_event_name === "Stop") {
+        // Stop is a checkpoint like UserPromptSubmit, so an unknown session is
+        // auto-registered — but the queue is deliberately NOT drained: a message
+        // queued for the session must survive to the next UserPromptSubmit, and
+        // Stop can arrive before that checkpoint if the turn ends without one.
+        const session = await resolveCheckpointSession(projectDir, event);
+        const checkpoint = await persistCheckpointMetadata(projectDir, session, event);
+        if (event.transcript_path !== undefined && checkpoint.metadata?.control !== "arcs-owned") {
+            await mirrorSessionTranscript(projectDir, checkpoint.normalizedId, event.transcript_path);
+        }
+        return { sessionId: checkpoint.normalizedId, queuedMessages: [] };
+    }
+    // SessionEnd. Every documented reason (clear|resume|logout|other) is an
+    // ordinary teardown — none of them signals a crash, so none maps to "failed".
+    const metadata = sessionMetadata(event);
+    const session = await updateSession(projectDir, {
+        id: event.session_id,
+        status: "completed",
+        ...(metadata !== undefined && { metadata }),
+    });
+    if (event.transcript_path !== undefined && session.metadata?.control !== "arcs-owned") {
+        await mirrorSessionTranscript(projectDir, session.normalizedId, event.transcript_path);
+    }
+    return { sessionId: session.normalizedId, queuedMessages: [] };
+}
+hookEventsRoute.post("/api/hook/:slug/event", async (c) => respond(c, async () => {
+    const projectDir = requireProjectDir(c.req.param("slug"));
+    return handleHookEvent(projectDir, await parseBody(c, hookEventSchema));
+}));
+//# sourceMappingURL=hook-events.js.map