@spader/spall-sdk 1.0.0

package/dist/server.js

@@ -0,0 +1,1433 @@
+// @bun
+// src/server.ts
+import { consola } from "consola";
+import pc from "picocolors";
+import { Bus as Bus2 } from "@spader/spall-core/event";
+import { Config as Config3 } from "@spader/spall-core/config";
+import { Model } from "@spader/spall-core/model";
+
+// src/app.ts
+import { Hono as Hono7 } from "hono";
+import { logger } from "hono/logger";
+import { describeRoute as describeRoute7, generateSpecs, resolver as resolver7 } from "hono-openapi";
+import { z } from "zod";
+
+// src/log.ts
+import { mkdirSync, appendFileSync } from "fs";
+import { dirname, join } from "path";
+import { Config } from "@spader/spall-core/config";
+var ServerLog;
+((ServerLog) => {
+  let dir = null;
+  let eventsPath;
+  let appPath;
+  function ts() {
+    return new Date().toISOString();
+  }
+  function init(port) {
+    const stamp = new Date().toISOString().replace(/:/g, "-").replace(/\.\d+Z$/, "Z");
+    const name = `${stamp}_${process.pid}_${port}`;
+    dir = join(Config.get().dirs.data, "logs", name);
+    mkdirSync(dir, { recursive: true });
+    eventsPath = join(dir, "events.log");
+    appPath = join(dir, "app.log");
+  }
+  ServerLog.init = init;
+  function safeAppend(path2, line) {
+    try {
+      appendFileSync(path2, line + `
+`);
+    } catch {
+      try {
+        mkdirSync(dirname(path2), { recursive: true });
+        appendFileSync(path2, line + `
+`);
+      } catch {}
+    }
+  }
+  function event(e) {
+    if (!dir)
+      return;
+    const line = JSON.stringify({ ts: ts(), ...e });
+    safeAppend(eventsPath, line);
+  }
+  ServerLog.event = event;
+  function error(err) {
+    if (!dir)
+      return;
+    const message = err instanceof Error ? { message: err.message, stack: err.stack } : { message: String(err) };
+    const line = JSON.stringify({ ts: ts(), tag: "error", ...message });
+    safeAppend(eventsPath, line);
+  }
+  ServerLog.error = error;
+  const ANSI_RE = /\x1b\[[0-9;]*m/g;
+  function appLog(message, ...rest) {
+    if (!dir)
+      return;
+    const raw = `${ts()} ${message} ${rest.join(" ")}`.trimEnd();
+    safeAppend(appPath, raw.replace(ANSI_RE, ""));
+  }
+  ServerLog.appLog = appLog;
+  function path() {
+    return dir;
+  }
+  ServerLog.path = path;
+})(ServerLog ||= {});
+
+// src/routes/corpus.ts
+import { Hono } from "hono";
+import { describeRoute, resolver, validator } from "hono-openapi";
+
+// src/util.ts
+function lazy(fn) {
+  let value;
+  let loaded = false;
+  const result = () => {
+    if (loaded)
+      return value;
+    loaded = true;
+    value = fn();
+    return value;
+  };
+  result.reset = () => {
+    loaded = false;
+    value = undefined;
+  };
+  return result;
+}
+
+// src/routes/corpus.ts
+import { Corpus, Note, Error as Error2 } from "@spader/spall-core";
+var CorpusRoutes = lazy(() => new Hono().get("/:id/list", describeRoute({
+  summary: "List notes",
+  description: "List all note paths in a corpus.",
+  operationId: "note.list",
+  responses: {
+    200: {
+      description: "List of notes",
+      content: {
+        "application/json": {
+          schema: resolver(Note.ListItem.array())
+        }
+      }
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  const id = c.req.param("id");
+  const result = await Note.list({
+    corpus: Corpus.Id.parse(id)
+  }).then((result2) => c.json(result2)).catch((error) => c.json(Error2.from(error), 404));
+  return result;
+}).get("/:id/notes", describeRoute({
+  summary: "List notes by path",
+  description: "List notes under a path prefix with keyset pagination. Returns full note content.",
+  operationId: "note.listByPath",
+  responses: {
+    200: {
+      description: "Paginated notes",
+      content: {
+        "application/json": {
+          schema: resolver(Note.Page)
+        }
+      }
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), validator("query", Note.listByPath.schema.omit({ corpus: true })), async (c) => {
+  const id = c.req.param("id");
+  const query = c.req.valid("query");
+  try {
+    const result = Note.listByPath({
+      corpus: Corpus.Id.parse(id),
+      ...query
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error2.from(error), 404);
+  }
+}).get("/:id/note/:path{.+}", describeRoute({
+  summary: "Get a note",
+  description: "Get a note by path within a corpus.",
+  operationId: "note.get",
+  responses: {
+    200: {
+      description: "Note with content",
+      content: {
+        "application/json": {
+          schema: resolver(Note.Info)
+        }
+      }
+    },
+    404: {
+      description: "Corpus or note not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  const id = c.req.param("id");
+  const path = c.req.param("path");
+  try {
+    const result = Note.get({
+      corpus: Corpus.Id.parse(id),
+      path
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error2.from(error), 404);
+  }
+}).post("/", describeRoute({
+  summary: "Create a corpus",
+  description: "Get or create a corpus. Returns existing corpus if name matches, creates new one otherwise.",
+  operationId: "corpus.create",
+  responses: {
+    200: {
+      description: "Corpus info",
+      content: {
+        "application/json": {
+          schema: resolver(Corpus.Info)
+        }
+      }
+    }
+  }
+}), validator("json", Corpus.create.schema), async (context) => {
+  const input = context.req.valid("json") ?? {};
+  const result = await Corpus.create(input);
+  return context.json(result);
+}).get("/list", describeRoute({
+  summary: "List corpora",
+  description: "List all corpora.",
+  operationId: "corpus.list",
+  responses: {
+    200: {
+      description: "List of corpora",
+      content: {
+        "application/json": {
+          schema: resolver(Corpus.Info.array())
+        }
+      }
+    },
+    500: {
+      description: "Server error",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  try {
+    const result = await Corpus.list({});
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error2.from(error), 500);
+  }
+}).get("/", describeRoute({
+  summary: "Get corpus",
+  description: "Look up a corpus by name or id. Returns default corpus if neither specified.",
+  operationId: "corpus.get",
+  responses: {
+    200: {
+      description: "Corpus info",
+      content: {
+        "application/json": {
+          schema: resolver(Corpus.Info)
+        }
+      }
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), validator("query", Corpus.get.schema), async (context) => {
+  const query = context.req.valid("query");
+  try {
+    const result = await Corpus.get(query);
+    return context.json(result);
+  } catch (error) {
+    return context.json(Error2.from(error), 404);
+  }
+}).delete("/:id", describeRoute({
+  summary: "Delete corpus",
+  description: "Delete a corpus and all associated notes by ID.",
+  operationId: "corpus.delete",
+  responses: {
+    204: {
+      description: "Corpus deleted successfully"
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), async (context) => {
+  try {
+    const id = context.req.param("id");
+    await Corpus.remove({ id: Corpus.Id.parse(id) });
+    return context.body(null, 204);
+  } catch (error) {
+    return context.json(Error2.from(error), 404);
+  }
+}).post("/sync", describeRoute({
+  summary: "Sync a directory as notes",
+  description: "Scan a directory, add matching notes, remove non-matches",
+  operationId: "note.sync",
+  responses: {
+    204: {
+      description: "Index complete"
+    }
+  }
+}), validator("json", Note.sync.schema), async (context) => {
+  const body = context.req.valid("json");
+  await Note.sync(body);
+  return context.body(null, 204);
+}).post("/note", describeRoute({
+  summary: "Add a note",
+  description: "Add a note to a corpus and embed it. Requires corpus ID.",
+  operationId: "note.add",
+  responses: {
+    200: {
+      description: "Created note",
+      content: {
+        "application/json": {
+          schema: resolver(Note.Info)
+        }
+      }
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), validator("json", Note.add.schema), async (context) => {
+  const body = context.req.valid("json");
+  try {
+    const result = await Note.add(body);
+    return context.json(result);
+  } catch (error) {
+    return context.json(Error2.from(error), 404);
+  }
+}).put("/:id/note/:path{.+}", describeRoute({
+  summary: "Upsert a note",
+  description: "Create or update a note by path. Creates if not exists, updates if exists.",
+  operationId: "note.upsert",
+  responses: {
+    200: {
+      description: "Created or updated note",
+      content: {
+        "application/json": {
+          schema: resolver(Note.Info)
+        }
+      }
+    },
+    404: {
+      description: "Corpus not found",
+      content: {
+        "application/json": {
+          schema: resolver(Error2.Info)
+        }
+      }
+    }
+  }
+}), validator("json", Note.upsert.schema.omit({ corpus: true, path: true })), async (context) => {
+  const id = context.req.param("id");
+  const path = context.req.param("path");
+  const body = context.req.valid("json");
+  try {
+    const result = await Note.upsert({
+      corpus: Corpus.Id.parse(id),
+      path,
+      ...body
+    });
+    return context.json(result);
+  } catch (error) {
+    return context.json(Error2.from(error), 404);
+  }
+}));
+
+// src/routes/workspace.ts
+import { Hono as Hono2 } from "hono";
+import { describeRoute as describeRoute2, resolver as resolver2, validator as validator2 } from "hono-openapi";
+import { Workspace, Error as Error3 } from "@spader/spall-core";
+var WorkspaceRoutes = lazy(() => new Hono2().post("/", describeRoute2({
+  summary: "Create a workspace",
+  description: "Get or create a workspace. Returns existing workspace if name matches, creates new one otherwise.",
+  operationId: "workspace.create",
+  responses: {
+    200: {
+      description: "Workspace info",
+      content: {
+        "application/json": {
+          schema: resolver2(Workspace.Info)
+        }
+      }
+    }
+  }
+}), validator2("json", Workspace.create.schema), async (context) => {
+  const input = context.req.valid("json") ?? {};
+  const result = await Workspace.create(input);
+  return context.json(result);
+}).get("/list", describeRoute2({
+  summary: "List workspaces",
+  description: "List all workspaces.",
+  operationId: "workspace.list",
+  responses: {
+    200: {
+      description: "List of workspaces",
+      content: {
+        "application/json": {
+          schema: resolver2(Workspace.Info.array())
+        }
+      }
+    },
+    500: {
+      description: "Server error",
+      content: {
+        "application/json": {
+          schema: resolver2(Error3.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  try {
+    const result = await Workspace.list({});
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error3.from(error), 500);
+  }
+}).get("/", describeRoute2({
+  summary: "Get workspace",
+  description: "Look up a workspace by name or id.",
+  operationId: "workspace.get",
+  responses: {
+    200: {
+      description: "Workspace info",
+      content: {
+        "application/json": {
+          schema: resolver2(Workspace.Info)
+        }
+      }
+    },
+    404: {
+      description: "Workspace not found",
+      content: {
+        "application/json": {
+          schema: resolver2(Error3.Info)
+        }
+      }
+    }
+  }
+}), validator2("query", Workspace.get.schema), async (context) => {
+  const query = context.req.valid("query");
+  try {
+    const result = await Workspace.get(query);
+    return context.json(result);
+  } catch (error) {
+    return context.json(Error3.from(error), 404);
+  }
+}).delete("/:id", describeRoute2({
+  summary: "Delete workspace",
+  description: "Delete a workspace by ID.",
+  operationId: "workspace.delete",
+  responses: {
+    204: {
+      description: "Workspace deleted successfully"
+    },
+    404: {
+      description: "Workspace not found",
+      content: {
+        "application/json": {
+          schema: resolver2(Error3.Info)
+        }
+      }
+    }
+  }
+}), async (context) => {
+  try {
+    const id = context.req.param("id");
+    await Workspace.remove({ id: Workspace.Id.parse(id) });
+    return context.body(null, 204);
+  } catch (error) {
+    return context.json(Error3.from(error), 404);
+  }
+}));
+
+// src/routes/note.ts
+import { Hono as Hono3 } from "hono";
+import { describeRoute as describeRoute3, resolver as resolver3, validator as validator3 } from "hono-openapi";
+import { Note as Note2, Error as Error4 } from "@spader/spall-core";
+var NoteRoutes = lazy(() => new Hono3().get("/:id", describeRoute3({
+  summary: "Get a note by ID",
+  description: "Get a note by its globally unique ID.",
+  operationId: "note.getById",
+  responses: {
+    200: {
+      description: "Note with content",
+      content: {
+        "application/json": {
+          schema: resolver3(Note2.Info)
+        }
+      }
+    },
+    404: {
+      description: "Note not found",
+      content: {
+        "application/json": {
+          schema: resolver3(Error4.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  const id = c.req.param("id");
+  try {
+    const result = Note2.getById({
+      id: Note2.Id.parse(id)
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error4.from(error), 404);
+  }
+}).put("/:id", describeRoute3({
+  summary: "Update a note",
+  description: "Update a note's content by ID. Re-embeds the content.",
+  operationId: "note.update",
+  responses: {
+    200: {
+      description: "Updated note",
+      content: {
+        "application/json": {
+          schema: resolver3(Note2.Info)
+        }
+      }
+    },
+    404: {
+      description: "Note not found",
+      content: {
+        "application/json": {
+          schema: resolver3(Error4.Info)
+        }
+      }
+    }
+  }
+}), validator3("json", Note2.update.schema.omit({ id: true })), async (context) => {
+  const id = context.req.param("id");
+  const body = context.req.valid("json");
+  try {
+    const result = await Note2.update({
+      id: Note2.Id.parse(id),
+      ...body
+    });
+    return context.json(result);
+  } catch (error) {
+    return context.json(Error4.from(error), 404);
+  }
+}));
+
+// src/routes/query.ts
+import { Hono as Hono4 } from "hono";
+import { describeRoute as describeRoute4, resolver as resolver4, validator as validator4 } from "hono-openapi";
+import { Query, Note as Note3, Error as Error5 } from "@spader/spall-core";
+var QueryRoutes = lazy(() => new Hono4().post("/", describeRoute4({
+  summary: "Create a query",
+  description: "Create a query scope for aggregating notes across multiple corpora.",
+  operationId: "query.create",
+  responses: {
+    200: {
+      description: "Query info",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.Info)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("json", Query.create.schema), async (c) => {
+  const body = c.req.valid("json");
+  try {
+    const result = Query.create(body);
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).get("/recent", describeRoute4({
+  summary: "List recent queries",
+  description: "Get the most recently created queries.",
+  operationId: "query.recent",
+  responses: {
+    200: {
+      description: "Recent queries",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.RecentResults)
+        }
+      }
+    }
+  }
+}), validator4("query", Query.recent.schema), async (c) => {
+  const query = c.req.valid("query");
+  const result = Query.recent(query);
+  return c.json(result);
+}).get("/:id", describeRoute4({
+  summary: "Get a query",
+  description: "Get a query by ID.",
+  operationId: "query.get",
+  responses: {
+    200: {
+      description: "Query info",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.Info)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), async (c) => {
+  const id = c.req.param("id");
+  try {
+    const result = Query.get({ id: Query.Id.parse(id) });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).get("/:id/notes", describeRoute4({
+  summary: "Query notes",
+  description: "List notes across all corpora in a query with keyset pagination.",
+  operationId: "query.notes",
+  responses: {
+    200: {
+      description: "Paginated notes",
+      content: {
+        "application/json": {
+          schema: resolver4(Note3.Page)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("query", Query.notes.schema.omit({ id: true })), async (c) => {
+  const id = c.req.param("id");
+  const query = c.req.valid("query");
+  try {
+    const result = Query.notes({
+      id: Query.Id.parse(id),
+      ...query
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).get("/:id/search", describeRoute4({
+  summary: "Keyword search",
+  description: "Search note content across all corpora in a query using FTS5.",
+  operationId: "query.search",
+  responses: {
+    200: {
+      description: "Search results",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.SearchResults)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("query", Query.search.schema.omit({ id: true })), async (c) => {
+  const id = c.req.param("id");
+  const query = c.req.valid("query");
+  try {
+    const result = Query.search({
+      id: Query.Id.parse(id),
+      ...query
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).get("/:id/vsearch", describeRoute4({
+  summary: "Vector search",
+  description: "Semantic search across all corpora in a query using embeddings.",
+  operationId: "query.vsearch",
+  responses: {
+    200: {
+      description: "Search results",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.VSearchResults)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("query", Query.vsearch.schema.omit({ id: true })), async (c) => {
+  const id = c.req.param("id");
+  const query = c.req.valid("query");
+  try {
+    const result = await Query.vsearch({
+      id: Query.Id.parse(id),
+      ...query
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).post("/:id/fetch", describeRoute4({
+  summary: "Fetch notes by ID",
+  description: "Fetch full note content for a list of note IDs through a query scope. Records access for reweighting.",
+  operationId: "query.fetch",
+  responses: {
+    200: {
+      description: "Fetched notes",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.FetchResults)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("json", Query.fetch.schema.omit({ id: true })), async (c) => {
+  const id = c.req.param("id");
+  const body = c.req.valid("json");
+  try {
+    const result = Query.fetch({
+      id: Query.Id.parse(id),
+      ...body
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}).get("/:id/paths", describeRoute4({
+  summary: "List paths",
+  description: "List all note paths across corpora in a query, grouped by corpus.",
+  operationId: "query.paths",
+  responses: {
+    200: {
+      description: "Paths grouped by corpus",
+      content: {
+        "application/json": {
+          schema: resolver4(Query.PathsResults)
+        }
+      }
+    },
+    404: {
+      description: "Query not found",
+      content: {
+        "application/json": {
+          schema: resolver4(Error5.Info)
+        }
+      }
+    }
+  }
+}), validator4("query", Query.paths.schema.omit({ id: true })), async (c) => {
+  const id = c.req.param("id");
+  const query = c.req.valid("query");
+  try {
+    const result = Query.paths({
+      id: Query.Id.parse(id),
+      ...query
+    });
+    return c.json(result);
+  } catch (error) {
+    return c.json(Error5.from(error), 404);
+  }
+}));
+
+// src/routes/commit.ts
+import { Hono as Hono5 } from "hono";
+import { describeRoute as describeRoute5, resolver as resolver5, validator as validator5 } from "hono-openapi";
+import { Commit } from "@spader/spall-core";
+var CommitRoutes = lazy(() => new Hono5().post("/", describeRoute5({
+  summary: "Commit staged events",
+  description: "Move all rows from staging to committed.",
+  operationId: "commit.run",
+  responses: {
+    200: {
+      description: "Commit result",
+      content: {
+        "application/json": {
+          schema: resolver5(Commit.Result)
+        }
+      }
+    }
+  }
+}), validator5("json", Commit.run.schema), async (c) => {
+  const body = c.req.valid("json");
+  const result = Commit.run(body);
+  return c.json(result);
+}));
+
+// src/routes/sse.ts
+import { Hono as Hono6 } from "hono";
+import { describeRoute as describeRoute6, resolver as resolver6, validator as validator6 } from "hono-openapi";
+
+// src/sse.ts
+import { streamSSE } from "hono/streaming";
+import { Bus, Context, Error as Error6, Store } from "@spader/spall-core";
+var Sse;
+((Sse) => {
+  function stream(context, handler, input) {
+    return streamSSE(context, async (stream2) => {
+      Server.Sse.track();
+      const write = async (event) => {
+        if (stream2.aborted)
+          return;
+        await stream2.writeSSE({ data: JSON.stringify(event) });
+      };
+      let unsubscribe = Bus.subscribe(write);
+      const [result, ctx] = Context.run(() => handler(input));
+      stream2.onAbort(() => {
+        ctx.aborted = true;
+        unsubscribe();
+        unsubscribe = () => false;
+      });
+      try {
+        await result;
+      } catch (error) {
+        if (!(error instanceof Store.CancelledError)) {
+          await write({ tag: "error", error: Error6.from(error) });
+        }
+      } finally {
+        unsubscribe();
+        Server.Sse.untrack();
+      }
+    });
+  }
+  Sse.stream = stream;
+  function subscribe(context) {
+    return streamSSE(context, async (stream2) => {
+      Server.Sse.track();
+      const write = async (event) => {
+        await stream2.writeSSE({ data: JSON.stringify(event) });
+      };
+      await write({ tag: "sse.connected" });
+      const unsubscribe = Bus.subscribe(write);
+      await new Promise((resolve) => {
+        if (stream2.aborted)
+          return resolve();
+        stream2.onAbort(resolve);
+      });
+      unsubscribe();
+      Server.Sse.untrack();
+    });
+  }
+  Sse.subscribe = subscribe;
+})(Sse ||= {});
+
+// src/routes/sse.ts
+import { Corpus as Corpus2, Note as Note4, EventUnion as EventUnion2 } from "@spader/spall-core";
+var SseRoutes = lazy(() => new Hono6().post("/corpus/sync", describeRoute6({
+  summary: "Index a directory (SSE)",
+  description: "Scan a directory and embed all matching notes. Streams progress events.",
+  operationId: "sse.note.sync",
+  responses: {
+    200: {
+      description: "Event stream",
+      content: {
+        "text/event-stream": {
+          schema: resolver6(EventUnion2)
+        }
+      }
+    }
+  }
+}), validator6("json", Note4.sync.schema), async (context) => {
+  const body = context.req.valid("json");
+  return Sse.stream(context, Note4.sync, body);
+}).post("/corpus/note", describeRoute6({
+  summary: "Add a note (SSE)",
+  description: "Add a note to a corpus and embed it. Streams progress events.",
+  operationId: "sse.note.add",
+  responses: {
+    200: {
+      description: "Event stream",
+      content: {
+        "text/event-stream": {
+          schema: resolver6(EventUnion2)
+        }
+      }
+    }
+  }
+}), validator6("json", Note4.add.schema), async (context) => {
+  const body = context.req.valid("json");
+  return Sse.stream(context, Note4.add, body);
+}).put("/corpus/:id/note/:path{.+}", describeRoute6({
+  summary: "Upsert a note (SSE)",
+  description: "Create or update a note by path. Streams progress events.",
+  operationId: "sse.note.upsert",
+  responses: {
+    200: {
+      description: "Event stream",
+      content: {
+        "text/event-stream": {
+          schema: resolver6(EventUnion2)
+        }
+      }
+    }
+  }
+}), validator6("json", Note4.upsert.schema.omit({ corpus: true, path: true })), async (context) => {
+  const id = context.req.param("id");
+  const path = context.req.param("path");
+  const body = context.req.valid("json");
+  return Sse.stream(context, Note4.upsert, {
+    corpus: Corpus2.Id.parse(id),
+    path,
+    ...body
+  });
+}).put("/note/:id", describeRoute6({
+  summary: "Update a note (SSE)",
+  description: "Update a note's content by ID. Re-embeds the content. Streams progress events.",
+  operationId: "sse.note.update",
+  responses: {
+    200: {
+      description: "Event stream",
+      content: {
+        "text/event-stream": {
+          schema: resolver6(EventUnion2)
+        }
+      }
+    }
+  }
+}), validator6("json", Note4.update.schema.omit({ id: true })), async (context) => {
+  const id = context.req.param("id");
+  const body = context.req.valid("json");
+  return Sse.stream(context, Note4.update, {
+    id: Note4.Id.parse(id),
+    ...body
+  });
+}));
+
+// src/app.ts
+import { EventUnion as EventUnion3 } from "@spader/spall-core";
+var App;
+((App) => {
+  const app = new Hono7;
+  let loaded = false;
+  function ensure() {
+    if (loaded)
+      return;
+    loaded = true;
+    app.use(async (_, next) => {
+      Server.increment();
+      try {
+        await next();
+      } finally {
+        Server.decrement();
+      }
+    }).use(logger()).use(logger(ServerLog.appLog)).route("/workspace", WorkspaceRoutes()).route("/corpus", CorpusRoutes()).route("/note", NoteRoutes()).route("/query", QueryRoutes()).route("/commit", CommitRoutes()).route("/sse", SseRoutes()).get("/health", describeRoute7({
+      summary: "Health check",
+      description: "Check if the server is running",
+      operationId: "health",
+      responses: {
+        200: {
+          description: "Server is healthy",
+          content: {
+            "text/plain": {
+              schema: resolver7(z.string())
+            }
+          }
+        }
+      }
+    }), (c) => {
+      return c.text("ok");
+    }).get("/events", describeRoute7({
+      summary: "Event stream",
+      description: "Subscribe to all server events via SSE",
+      operationId: "events",
+      responses: {
+        200: {
+          description: "Event stream",
+          content: {
+            "text/event-stream": {
+              schema: resolver7(EventUnion3)
+            }
+          }
+        }
+      }
+    }), (c) => {
+      return Sse.subscribe(c);
+    });
+    app.post("/shutdown", describeRoute7({
+      summary: "Shutdown server",
+      description: "Request the server to stop.",
+      operationId: "server.shutdown",
+      responses: {
+        200: {
+          description: "Shutdown acknowledged",
+          content: {
+            "application/json": {
+              schema: resolver7(z.object({ ok: z.literal(true) }))
+            }
+          }
+        }
+      }
+    }), async (c) => {
+      setTimeout(() => {
+        try {
+          process.kill(process.pid, "SIGTERM");
+        } catch {}
+      }, 0);
+      return c.json({ ok: true });
+    });
+    return app;
+  }
+  App.ensure = ensure;
+  function get() {
+    ensure();
+    return app;
+  }
+  App.get = get;
+  async function spec() {
+    return generateSpecs(App.get(), {
+      documentation: {
+        info: {
+          title: "spall",
+          version: "0.0.1",
+          description: "Local semantic note store with embeddings"
+        },
+        openapi: "3.1.1"
+      }
+    });
+  }
+  App.spec = spec;
+})(App ||= {});
+
+// src/lock.ts
+import { mkdirSync as mkdirSync2, existsSync, readFileSync, writeFileSync, rmSync } from "fs";
+import { join as join2 } from "path";
+import { Config as Config2 } from "@spader/spall-core/config";
+function debugEnabled() {
+  const value = process.env.SPALL_DEBUG;
+  return value === "1" || value === "true";
+}
+function debug(message) {
+  if (debugEnabled()) {
+    console.error(`[spall:debug] ${message}`);
+  }
+}
+var Cache;
+((Cache) => {
+  function ensure() {
+    const dir = Config2.get().dirs.data;
+    if (!existsSync(dir)) {
+      mkdirSync2(dir, { recursive: true });
+    }
+  }
+  Cache.ensure = ensure;
+})(Cache ||= {});
+var Lock;
+((Lock) => {
+  function path() {
+    return join2(Config2.get().dirs.data, "server.lock");
+  }
+  Lock.path = path;
+  function read() {
+    try {
+      const content = readFileSync(path(), "utf-8");
+      return JSON.parse(content);
+    } catch {
+      return null;
+    }
+  }
+  Lock.read = read;
+  function create() {
+    Cache.ensure();
+    try {
+      writeFileSync(path(), JSON.stringify({ pid: process.pid, port: null }), {
+        flag: "wx"
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  Lock.create = create;
+  function update(port) {
+    Cache.ensure();
+    writeFileSync(path(), JSON.stringify({ pid: process.pid, port }));
+  }
+  Lock.update = update;
+  function takeover() {
+    Cache.ensure();
+    writeFileSync(path(), JSON.stringify({ pid: process.pid, port: null }));
+  }
+  Lock.takeover = takeover;
+  function remove() {
+    rmSync(path(), { force: true });
+  }
+  Lock.remove = remove;
+})(Lock ||= {});
+function isProcessAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function checkHealth(port) {
+  try {
+    const response = await fetch(`http://127.0.0.1:${port}/health`);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+var Role = {
+  Leader: "leader",
+  Follower: "follower"
+};
+async function acquire() {
+  while (true) {
+    if (Lock.create()) {
+      debug(`Acquired startup lock as leader pid=${process.pid}`);
+      return { role: Role.Leader };
+    }
+    const lock = Lock.read();
+    if (!lock) {
+      debug("Startup lock disappeared before it could be read; retrying");
+      continue;
+    }
+    if (lock.port !== null) {
+      if (await checkHealth(lock.port)) {
+        debug(`Following healthy server pid=${lock.pid} port=${lock.port}`);
+        return { role: Role.Follower, url: `http://127.0.0.1:${lock.port}` };
+      }
+      debug(`Removing stale unhealthy lock pid=${lock.pid} port=${lock.port}`);
+      Lock.remove();
+      continue;
+    }
+    if (!isProcessAlive(lock.pid)) {
+      debug(`Removing stale startup lock pid=${lock.pid}`);
+      Lock.remove();
+      continue;
+    }
+    debug(`Waiting for leader pid=${lock.pid} to publish server port`);
+    await Bun.sleep(50);
+  }
+}
+async function ensure() {
+  const result = await acquire();
+  if (result.role === Role.Follower) {
+    debug(`ensure returning follower url ${result.url}`);
+    return result.url;
+  }
+  const script = join2(import.meta.dir, "serve.ts");
+  debug(`ensure spawning local server from ${script}`);
+  Bun.spawn([process.execPath, script], {
+    stdin: "ignore",
+    stdout: "ignore",
+    stderr: "ignore",
+    env: {
+      ...process.env,
+      SPALL_CACHE_DIR: Config2.get().dirs.cache
+    }
+  }).unref();
+  for (let i = 0;i < 40; i++) {
+    await Bun.sleep(50);
+    const lock = Lock.read();
+    if (lock && lock.port !== null) {
+      debug(`ensure observed server port ${lock.port}`);
+      return `http://127.0.0.1:${lock.port}`;
+    }
+  }
+  debug("ensure timed out waiting for local server port");
+  throw new Error("Claimed leader role, but timed out waiting for server to start");
+}
+
+// src/server.ts
+import { Store as Store2 } from "@spader/spall-core";
+function formatBytes(bytes) {
+  if (bytes < 1024)
+    return `${bytes} B`;
+  if (bytes < 1024 * 1024)
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024)
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+function parseBooleanEnv(value) {
+  if (!value)
+    return;
+  if (value === "1" || value === "true")
+    return true;
+  if (value === "0" || value === "false")
+    return false;
+  return;
+}
+function parseNumberEnv(value) {
+  if (!value)
+    return;
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : undefined;
+}
+var Server;
+((Server) => {
+  let server = null;
+  let persist = false;
+  let activeRequests = 0;
+  let timer;
+  let idleTimeoutMs = 1000;
+  let resolved = null;
+  let unsubscribeBus = null;
+  let processHandlersInstalled = false;
+  function installProcessHandlers() {
+    if (processHandlersInstalled)
+      return;
+    processHandlersInstalled = true;
+    process.once("SIGINT", () => {
+      consola.info(`Received ${pc.gray("SIGINT")}`);
+      stop();
+    });
+    process.once("SIGTERM", () => {
+      consola.info(`Received ${pc.gray("SIGTERM")}`);
+      stop();
+    });
+    process.on("uncaughtException", (err) => {
+      ServerLog.error(err);
+      consola.error("Uncaught exception:", err);
+    });
+    process.on("unhandledRejection", (err) => {
+      ServerLog.error(err);
+      consola.error("Unhandled rejection:", err);
+    });
+  }
+  let Sse2;
+  ((Sse) => {
+    let count = 0;
+    function active() {
+      return count > 0;
+    }
+    Sse.active = active;
+    function track() {
+      count++;
+      clearTimeout(timer);
+    }
+    Sse.track = track;
+    function untrack() {
+      count--;
+      clearTimeout(timer);
+    }
+    Sse.untrack = untrack;
+    function reset() {
+      count = 0;
+    }
+    Sse.reset = reset;
+  })(Sse2 = Server.Sse ||= {});
+  function increment() {
+    activeRequests++;
+    clearTimeout(timer);
+  }
+  Server.increment = increment;
+  function decrement() {
+    activeRequests--;
+    resetShutdownTimer();
+  }
+  Server.decrement = decrement;
+  function resetShutdownTimer() {
+    if (persist)
+      return;
+    if (activeRequests > 0 || Sse2.active())
+      return;
+    timer = setTimeout(() => {
+      if (activeRequests === 0 && !Sse2.active()) {
+        stop();
+      }
+    }, idleTimeoutMs);
+  }
+  function render(event) {
+    switch (event.tag) {
+      case "model.download":
+        return `Downloading ${pc.cyan(event.info.name)}`;
+      case "model.downloaded":
+        return `Finished downloading ${pc.cyanBright(event.info.name)}`;
+      case "model.progress": {
+        const percent = event.downloaded / event.total * 100;
+        const percentStr = percent.toFixed(0).padStart(3);
+        return `${pc.cyan(event.info.name)} ${pc.bold(percentStr + "%")}`;
+      }
+      case "model.load":
+        return `Loaded ${pc.cyanBright(event.info.name)}`;
+      case "model.failed":
+        return `${pc.red("Failed to load model:")} ${event.error}`;
+      case "store.create":
+        return `Creating database at ${pc.cyanBright(event.path)}`;
+      case "store.created":
+        return `Created database at ${pc.cyanBright(event.path)}`;
+      case "note.created":
+        return `${pc.cyanBright(event.info.path)} (${formatBytes(event.info.content.length)}, hash: ${event.info.contentHash})`;
+      case "note.updated":
+        return `${pc.cyanBright(event.info.path)} (${formatBytes(event.info.content.length)}, hash: ${event.info.contentHash})`;
+      case "embed.cancel":
+        return "Cancelled embedding";
+    }
+    return event.tag;
+  }
+  Server.render = render;
+  async function start(request) {
+    const env = {
+      persist: parseBooleanEnv(process.env.SPALL_SERVER_PERSIST),
+      force: parseBooleanEnv(process.env.SPALL_SERVER_FORCE),
+      idleTimeoutMs: parseNumberEnv(process.env.SPALL_SERVER_IDLE_TIMEOUT_MS)
+    };
+    const config = {
+      idleTimeoutMs: Config3.get().server.idleTimeout * 1000
+    };
+    const options = {
+      persist: request?.persist ?? env.persist ?? false,
+      idleTimeoutMs: request?.idleTimeoutMs ?? env.idleTimeoutMs ?? config.idleTimeoutMs ?? 1000,
+      force: request?.force ?? env.force ?? false
+    };
+    Store2.ensure();
+    persist = options.persist;
+    idleTimeoutMs = options.idleTimeoutMs;
+    const existing = Lock.read();
+    if (existing && existing.port !== null && await checkHealth(existing.port)) {
+      if (options.force) {
+        const pid = `${pc.gray("pid")} ${pc.yellow(existing.pid)}`;
+        const port2 = `${pc.gray("port")} ${pc.cyan(existing.port)}`;
+        consola.info(`Killing existing server (${pid}, ${port2})`);
+        Lock.takeover();
+        try {
+          process.kill(existing.pid, "SIGTERM");
+          for (let i = 0;i < 40; i++) {
+            if (!isProcessAlive(existing.pid))
+              break;
+            await Bun.sleep(50);
+          }
+        } catch {}
+      } else {
+        throw new Error(`Server is already running at port ${existing.port}`);
+      }
+    }
+    server = Bun.serve({
+      port: 0,
+      fetch: App.get().fetch,
+      idleTimeout: 0
+    });
+    const port = server.port;
+    if (!port) {
+      server.stop();
+      throw new Error("Failed to start server");
+    }
+    consola.log(`Listening on port ${pc.cyanBright(String(port))}`);
+    Lock.update(port);
+    ServerLog.init(port);
+    installProcessHandlers();
+    resetShutdownTimer();
+    const stopped = new Promise((resolve) => {
+      resolved = resolve;
+    });
+    unsubscribeBus?.();
+    unsubscribeBus = Bus2.subscribe((event) => {
+      consola.info(`${pc.gray(event.tag)} ${render(event)}`);
+      ServerLog.event(event);
+    });
+    Model.load().catch(() => {});
+    return { port, stopped };
+  }
+  Server.start = start;
+  function stop() {
+    if (!server)
+      return;
+    consola.info("Stopping server");
+    server.stop();
+    server = null;
+    Sse2.reset();
+    unsubscribeBus?.();
+    unsubscribeBus = null;
+    const lock = Lock.read();
+    if (lock && lock.pid === process.pid) {
+      Lock.remove();
+    }
+    resolved?.();
+    resolved = null;
+  }
+  Server.stop = stop;
+})(Server ||= {});
+export {
+  isProcessAlive,
+  ensure,
+  checkHealth,
+  Server,
+  Lock
+};
+
+//# debugId=39A5F6D19C8A6DCE64756E2164756E21