schub 0.1.13 → 0.1.15

package/README.md

@@ -14,6 +14,29 @@
 bun add -g schub@latest
 ```
 
+## Test A Local Built Package (No Publish)
+
+From the monorepo root:
+
+```bash
+# 1) Build the CLI + bundled dashboard + bundled API
+bun run --cwd packages/schub build:bundle
+
+# 2) Run the built package entrypoint
+#    (set explicit local paths so the run is isolated/reproducible)
+SCHUB_DB_PATH=/tmp/schub-local.db \
+SCHUB_STORAGE_PATH=/tmp/schub-local-storage \
+node packages/schub/dist/index.js dashboard
+```
+
+From another project/repo, you can run the exact same built package via absolute path:
+
+```bash
+SCHUB_DB_PATH=/tmp/schub-local.db \
+SCHUB_STORAGE_PATH=/tmp/schub-local-storage \
+node /absolute/path/to/schub/packages/schub/dist/index.js dashboard
+```
+
 ## Usage
 
 Run the CLI using `schub`.

package/dist/api/server.js

@@ -31955,13 +31955,95 @@ var createAgentsService = (overrides = {}) => {
   return { checkAvailability, listModels };
 };
 
+// ../schub-services/src/services/docs.ts
+import { existsSync as existsSync2, readFileSync } from "node:fs";
+import path3 from "node:path";
+var createDocsError = (code, message) => Object.assign(new Error(message), { code });
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var normalizeSidebarLink = (link) => {
+  const trimmed = link.trim();
+  if (!trimmed) {
+    throw createDocsError("DOCS_CONFIG_INVALID", "Docs sidebar links must be non-empty strings.");
+  }
+  return trimmed;
+};
+var parseSidebarItem = (value, location) => {
+  if (!isRecord(value)) {
+    throw createDocsError("DOCS_CONFIG_INVALID", `Invalid sidebar item at ${location}.`);
+  }
+  const text2 = typeof value.text === "string" ? value.text.trim() : "";
+  const link = typeof value.link === "string" ? normalizeSidebarLink(value.link) : undefined;
+  const items = Array.isArray(value.items) ? value.items.map((item, index) => parseSidebarItem(item, `${location}.items[${index}]`)) : undefined;
+  if (!text2) {
+    throw createDocsError("DOCS_CONFIG_INVALID", `Sidebar item at ${location} is missing a valid text field.`);
+  }
+  if (!link && (!items || items.length === 0)) {
+    throw createDocsError("DOCS_CONFIG_INVALID", `Sidebar item at ${location} must include link or items.`);
+  }
+  return { text: text2, link, items };
+};
+var parseDocsSidebar = (content) => {
+  if (!isRecord(content)) {
+    throw createDocsError("DOCS_CONFIG_INVALID", "docs.json must contain an object.");
+  }
+  if (!Array.isArray(content.sidebar)) {
+    throw createDocsError("DOCS_CONFIG_INVALID", "docs.json must include a sidebar array.");
+  }
+  return content.sidebar.map((item, index) => parseSidebarItem(item, `sidebar[${index}]`));
+};
+var normalizeDocumentPath = (docsRoot, link) => {
+  const withoutParams = link.split("?")[0]?.split("#")[0] ?? "";
+  const trimmed = withoutParams.trim();
+  if (!trimmed || /^[a-zA-Z]+:\/\//.test(trimmed)) {
+    throw createDocsError("DOCS_LINK_INVALID", `Unsupported docs link: ${link}`);
+  }
+  const normalized = trimmed.replace(/^\/+/, "");
+  const withExtension = normalized.endsWith(".md") ? normalized : `${normalized}.md`;
+  const resolved = path3.resolve(docsRoot, withExtension);
+  const relative = path3.relative(docsRoot, resolved);
+  if (!relative || relative.startsWith("..") || path3.isAbsolute(relative)) {
+    throw createDocsError("DOCS_LINK_INVALID", `Docs link resolves outside .schub/docs: ${link}`);
+  }
+  return relative;
+};
+var isDocsServiceError = (value) => value instanceof Error && ("code" in value) && typeof value.code === "string";
+var createDocsService = (rootPath = process.env.SCHUB_CWD ?? process.cwd()) => {
+  const docsRoot = path3.join(rootPath, ".schub", "docs");
+  const docsConfigPath = path3.join(docsRoot, "docs.json");
+  const getIndex = () => {
+    if (!existsSync2(docsConfigPath)) {
+      throw createDocsError("DOCS_CONFIG_NOT_FOUND", "Docs config not found at .schub/docs/docs.json");
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(readFileSync(docsConfigPath, "utf8"));
+    } catch {
+      throw createDocsError("DOCS_CONFIG_INVALID", "Unable to parse .schub/docs/docs.json");
+    }
+    return { sidebar: parseDocsSidebar(parsed) };
+  };
+  const getDocument = (link) => {
+    const relativePath = normalizeDocumentPath(docsRoot, link);
+    const absolutePath = path3.join(docsRoot, relativePath);
+    if (!existsSync2(absolutePath)) {
+      throw createDocsError("DOCS_DOCUMENT_NOT_FOUND", `Docs markdown file not found: ${relativePath}`);
+    }
+    return {
+      link,
+      path: relativePath.replaceAll(path3.sep, "/"),
+      content: readFileSync(absolutePath, "utf8")
+    };
+  };
+  return { getIndex, getDocument };
+};
+
 // ../schub-services/src/services/files.ts
 import { createHash } from "node:crypto";
 import fs3 from "node:fs";
 
 // ../schub-services/src/storage/paths.ts
 import fs2 from "node:fs";
-import path3 from "node:path";
+import path4 from "node:path";
 var resolveStorageRoot = (storagePath) => {
   if (!storagePath) {
     throw new Error("Storage path is required. Set SCHUB_STORAGE_PATH or pass storagePath.");
@@ -31972,9 +32054,9 @@ var ensureStorageRoot = (storageRoot) => {
   fs2.mkdirSync(storageRoot, { recursive: true });
 };
 var ensureProjectStorageRoot = (storageRoot, projectId) => {
-  fs2.mkdirSync(path3.join(storageRoot, projectId), { recursive: true });
+  fs2.mkdirSync(path4.join(storageRoot, projectId), { recursive: true });
 };
-var resolveFileStoragePath = (storageRoot, projectId, fileId) => path3.join(storageRoot, projectId, fileId);
+var resolveFileStoragePath = (storageRoot, projectId, fileId) => path4.join(storageRoot, projectId, fileId);
 
 // ../schub-services/src/services/files.ts
 var nowTimestamp = () => new Date().toISOString();
@@ -32089,15 +32171,15 @@ var defaultServerHost = "127.0.0.1";
 var defaultServerPort = 4096;
 var maxServerPortAttempts = 20;
 var buildServerUrl = (host, port) => `http://${host}:${port}`;
-var buildRequestUrl = (baseUrl, path4, directory) => {
-  const url2 = new URL(path4, baseUrl);
+var buildRequestUrl = (baseUrl, path5, directory) => {
+  const url2 = new URL(path5, baseUrl);
   url2.searchParams.set("directory", directory);
   return url2.toString();
 };
-var createFileServerStore = (path4) => ({
+var createFileServerStore = (path5) => ({
   read: async () => {
     try {
-      const raw2 = await readFile(path4, "utf8");
+      const raw2 = await readFile(path5, "utf8");
       const value = raw2.trim();
       return value.length > 0 ? value : null;
     } catch {
@@ -32105,13 +32187,13 @@ var createFileServerStore = (path4) => ({
     }
   },
   write: async (url2) => {
-    await mkdir(dirname(path4), { recursive: true });
-    await writeFile(path4, `${url2}
+    await mkdir(dirname(path5), { recursive: true });
+    await writeFile(path5, `${url2}
 `, "utf8");
   },
   clear: async () => {
     try {
-      await unlink(path4);
+      await unlink(path5);
     } catch {
       return;
     }
@@ -33811,6 +33893,7 @@ var createServices = (config2 = {}) => {
   const storageRoot = resolveStorageRoot(config2.storagePath);
   ensureStorageRoot(storageRoot);
   const agents = createAgentsService();
+  const docs = createDocsService();
   const files2 = createFilesService(db, storageRoot);
   const opencode = createOpencodeService();
   const proposalStatuses = createProposalStatusesService(db);
@@ -33824,6 +33907,7 @@ var createServices = (config2 = {}) => {
   const workspaces2 = createWorkspacesService(db);
   return {
     agents,
+    docs,
     files: files2,
     opencode,
     proposalStatuses,
@@ -33968,18 +34052,18 @@ var colorStatus = async (status) => {
   }
   return `${status}`;
 };
-async function log(fn, prefix, method, path4, status = 0, elapsed) {
-  const out = prefix === "<--" ? `${prefix} ${method} ${path4}` : `${prefix} ${method} ${path4} ${await colorStatus(status)} ${elapsed}`;
+async function log(fn, prefix, method, path5, status = 0, elapsed) {
+  const out = prefix === "<--" ? `${prefix} ${method} ${path5}` : `${prefix} ${method} ${path5} ${await colorStatus(status)} ${elapsed}`;
   fn(out);
 }
 var logger = (fn = console.log) => {
   return async function logger2(c, next) {
     const { method, url: url2 } = c.req;
-    const path4 = url2.slice(url2.indexOf("/", 8));
-    await log(fn, "<--", method, path4);
+    const path5 = url2.slice(url2.indexOf("/", 8));
+    await log(fn, "<--", method, path5);
     const start = Date.now();
     await next();
-    await log(fn, "-->", method, path4, c.res.status, time3(start));
+    await log(fn, "-->", method, path5, c.res.status, time3(start));
   };
 };
 
@@ -34064,6 +34148,145 @@ var registerContainerRoutes = (router) => {
   ]);
 };
 
+// ../schub-api/src/responses.ts
+var apiSuccessSchema = (schema) => exports_external.object({ success: exports_external.literal(true), data: schema });
+var apiErrorSchema = exports_external.object({
+  success: exports_external.literal(false),
+  message: exports_external.string(),
+  error_data: exports_external.unknown().optional()
+});
+var okResponse = (data) => ({
+  success: true,
+  data
+});
+var errorResponse = (message, error_data) => error_data ? { success: false, message, error_data } : { success: false, message };
+
+// ../schub-api/src/routes/docs.ts
+var docsSidebarItemSchema = exports_external.object({
+  text: exports_external.string(),
+  link: exports_external.string().optional(),
+  items: exports_external.array(exports_external.any()).optional()
+});
+var docsIndexSchema = exports_external.object({
+  sidebar: exports_external.array(docsSidebarItemSchema)
+});
+var docsContentSchema = exports_external.object({
+  link: exports_external.string(),
+  path: exports_external.string(),
+  content: exports_external.string()
+});
+var docsContentQuerySchema = exports_external.object({
+  link: exports_external.string().min(1)
+});
+var resolveDocsError = (error48) => {
+  if (!isDocsServiceError(error48)) {
+    return {
+      status: 500,
+      body: errorResponse("Failed to read docs", { code: "DOCS_UNKNOWN_ERROR" })
+    };
+  }
+  if (error48.code === "DOCS_CONFIG_NOT_FOUND" || error48.code === "DOCS_DOCUMENT_NOT_FOUND") {
+    return {
+      status: 404,
+      body: errorResponse(error48.message, { code: error48.code })
+    };
+  }
+  return {
+    status: 400,
+    body: errorResponse(error48.message, { code: error48.code })
+  };
+};
+var registerDocsRoutes = (router) => {
+  const indexRoute = createRoute({
+    method: "get",
+    path: "/docs",
+    tags: ["Docs"],
+    summary: "Read local docs index",
+    responses: {
+      200: {
+        description: "Docs index",
+        content: {
+          "application/json": {
+            schema: apiSuccessSchema(docsIndexSchema)
+          }
+        }
+      },
+      400: {
+        description: "Invalid docs config",
+        content: {
+          "application/json": {
+            schema: apiErrorSchema
+          }
+        }
+      },
+      404: {
+        description: "Docs config not found",
+        content: {
+          "application/json": {
+            schema: apiErrorSchema
+          }
+        }
+      }
+    }
+  });
+  const indexHandler = (c) => {
+    try {
+      const data = c.get("services").docs.getIndex();
+      return c.json(okResponse(data), 200);
+    } catch (error48) {
+      const resolved = resolveDocsError(error48);
+      return c.json(resolved.body, resolved.status);
+    }
+  };
+  router.openapi(indexRoute, indexHandler);
+  const contentRoute = createRoute({
+    method: "get",
+    path: "/docs/content",
+    tags: ["Docs"],
+    summary: "Read docs markdown content",
+    request: {
+      query: docsContentQuerySchema
+    },
+    responses: {
+      200: {
+        description: "Docs markdown content",
+        content: {
+          "application/json": {
+            schema: apiSuccessSchema(docsContentSchema)
+          }
+        }
+      },
+      400: {
+        description: "Invalid docs link",
+        content: {
+          "application/json": {
+            schema: apiErrorSchema
+          }
+        }
+      },
+      404: {
+        description: "Markdown file not found",
+        content: {
+          "application/json": {
+            schema: apiErrorSchema
+          }
+        }
+      }
+    }
+  });
+  const contentHandler = (c) => {
+    const { link } = c.req.valid("query");
+    try {
+      const data = c.get("services").docs.getDocument(link);
+      return c.json(okResponse(data), 200);
+    } catch (error48) {
+      const resolved = resolveDocsError(error48);
+      return c.json(resolved.body, resolved.status);
+    }
+  };
+  router.openapi(contentRoute, contentHandler);
+};
+
 // ../schub-api/src/routes/drafts.ts
 var registerDraftRoutes = (router) => {
   registerPlaceholderRoutes(router, "Drafts", [
@@ -34095,21 +34318,6 @@ var registerExecutionProcessRoutes = (router) => {
 
 // ../schub-api/src/routes/files.ts
 import { readFile as readFile2 } from "node:fs/promises";
-
-// ../schub-api/src/responses.ts
-var apiSuccessSchema = (schema) => exports_external.object({ success: exports_external.literal(true), data: schema });
-var apiErrorSchema = exports_external.object({
-  success: exports_external.literal(false),
-  message: exports_external.string(),
-  error_data: exports_external.unknown().optional()
-});
-var okResponse = (data) => ({
-  success: true,
-  data
-});
-var errorResponse = (message, error_data) => error_data ? { success: false, message, error_data } : { success: false, message };
-
-// ../schub-api/src/routes/files.ts
 var fileSchema = exports_external.object({
   id: exports_external.string(),
   project_id: exports_external.string(),
@@ -34435,18 +34643,18 @@ var expandHomePath = (value) => {
   return value;
 };
 var resolveRootPath = (value) => resolve(expandHomePath(value) ?? process.env.SCHUB_CWD ?? process.cwd());
-var isGitRepo = async (path4) => {
+var isGitRepo = async (path5) => {
   try {
-    const gitStat = await stat(join3(path4, ".git"));
+    const gitStat = await stat(join3(path5, ".git"));
     return gitStat.isDirectory();
   } catch {
     return false;
   }
 };
-var listDirectoryEntries = async (path4) => {
-  const entries = await readdir(path4, { withFileTypes: true });
+var listDirectoryEntries = async (path5) => {
+  const entries = await readdir(path5, { withFileTypes: true });
   const mapped = await Promise.all(entries.map(async (entry) => {
-    const fullPath = join3(path4, entry.name);
+    const fullPath = join3(path5, entry.name);
     const isDirectory = entry.isDirectory();
     return {
       name: entry.name,
@@ -34464,18 +34672,18 @@ var listGitRepos = async (rootPath) => {
     const next = queue.shift();
     if (!next)
       break;
-    const { path: path4, depth } = next;
+    const { path: path5, depth } = next;
     let entries = [];
     try {
-      entries = await readdir(path4, { withFileTypes: true });
+      entries = await readdir(path5, { withFileTypes: true });
     } catch {
       continue;
     }
     const hasGit = entries.some((entry) => entry.isDirectory() && entry.name === ".git");
     if (hasGit) {
       repos2.push({
-        name: basename2(path4),
-        path: path4,
+        name: basename2(path5),
+        path: path5,
         is_directory: true,
         is_git_repo: true
       });
@@ -34489,7 +34697,7 @@ var listGitRepos = async (rootPath) => {
         return;
       if (SKIP_DIRS.has(entry.name))
         return;
-      queue.push({ path: join3(path4, entry.name), depth: depth + 1 });
+      queue.push({ path: join3(path5, entry.name), depth: depth + 1 });
     });
   }
   return repos2;
@@ -34523,8 +34731,8 @@ var registerFilesystemRoutes = (router) => {
     }
   });
   const directoryHandler = async (c) => {
-    const { path: path4 } = c.req.valid("query");
-    const resolvedPath = resolveRootPath(path4);
+    const { path: path5 } = c.req.valid("query");
+    const resolvedPath = resolveRootPath(path5);
     try {
       const entries = await listDirectoryEntries(resolvedPath);
       return c.json(okResponse({ current_path: resolvedPath, entries }), 200);
@@ -34562,8 +34770,8 @@ var registerFilesystemRoutes = (router) => {
     }
   });
   const gitReposHandler = async (c) => {
-    const { path: path4 } = c.req.valid("query");
-    const resolvedPath = resolveRootPath(path4);
+    const { path: path5 } = c.req.valid("query");
+    const resolvedPath = resolveRootPath(path5);
     try {
       const repos2 = await listGitRepos(resolvedPath);
       return c.json(okResponse(repos2), 200);
@@ -36629,7 +36837,7 @@ var registerTicketStatusRoutes = (router) => {
 
 // ../schub-api/src/routes/tickets.ts
 import { spawnSync as spawnSync2 } from "node:child_process";
-import { existsSync as existsSync2, mkdirSync } from "node:fs";
+import { existsSync as existsSync3, mkdirSync } from "node:fs";
 import { join as join5 } from "node:path";
 var runGit = (cwd, args) => {
   return spawnSync2("git", args, {
@@ -36646,7 +36854,7 @@ var createAttemptWorktree = (options) => {
   const gitRoot = gitRootResult.stdout.trim();
   const worktreePath = join5(gitRoot, ".schub", "worktrees", options.ticketShorthand, `attempt-${options.attemptNumber}`);
   const branchName = `ticket/${options.ticketShorthand}/attempt-${options.attemptNumber}`;
-  if (existsSync2(worktreePath)) {
+  if (existsSync3(worktreePath)) {
     throw new Error(`Worktree path already exists: ${worktreePath}`);
   }
   const branchCheck = runGit(gitRoot, ["show-ref", "--verify", "--quiet", `refs/heads/${branchName}`]);
@@ -37319,6 +37527,7 @@ var createRoutes = (options) => {
   const routes = new OpenAPIHono;
   registerSystemRoutes(routes);
   registerContainerRoutes(routes);
+  registerDocsRoutes(routes);
   registerProjectRoutes(routes, options.upgradeWebSocket);
   registerTicketStatusRoutes(routes);
   registerProposalRoutes(routes);

package/dist/dashboard/assets/{EquationComponent-BoOvP2LA.js → EquationComponent-B8bIWTs4.js}

@@ -1 +1 @@
-import{c as f,r as u,k as E,j as a,o as p}from"./index-cKNLpxLp.js";function x(c){const e=f.c(5),{equation:i,inline:n}=c,l=u.useRef(null);let o,t;e[0]!==i||e[1]!==n?(o=()=>{const s=l.current;s!==null&&E.render(i,s,{displayMode:!n,errorColor:"#cc0000",output:"html",strict:"warn",throwOnError:!1,trust:!1})},t=[i,n],e[0]=i,e[1]=n,e[2]=o,e[3]=t):(o=e[2],t=e[3]),u.useEffect(o,t);let r;return e[4]===Symbol.for("react.memo_cache_sentinel")?(r=a.jsxs(a.Fragment,{children:[a.jsx("img",{src:"#",alt:""}),a.jsx("span",{ref:l}),a.jsx("img",{src:"#",alt:""})]}),e[4]=r):r=e[4],r}class d extends u.Component{state={hasError:!1};static getDerivedStateFromError(){return{hasError:!0}}componentDidCatch(e){this.props.onError(e)}render(){return this.state.hasError?null:this.props.children}}function j(c){const e=f.c(8),{equation:i,inline:n}=c,[l]=p(),[o]=u.useState(i);let t;e[0]!==l?(t=m=>l._onError(m),e[0]=l,e[1]=t):t=e[1];let r;e[2]!==o||e[3]!==n?(r=a.jsx(x,{equation:o,inline:n}),e[2]=o,e[3]=n,e[4]=r):r=e[4];let s;return e[5]!==t||e[6]!==r?(s=a.jsx(d,{onError:t,children:r}),e[5]=t,e[6]=r,e[7]=s):s=e[7],s}export{j as default};
+import{c as f,r as u,k as E,j as a,o as p}from"./index-DhqXvDTi.js";function x(c){const e=f.c(5),{equation:i,inline:n}=c,l=u.useRef(null);let o,t;e[0]!==i||e[1]!==n?(o=()=>{const s=l.current;s!==null&&E.render(i,s,{displayMode:!n,errorColor:"#cc0000",output:"html",strict:"warn",throwOnError:!1,trust:!1})},t=[i,n],e[0]=i,e[1]=n,e[2]=o,e[3]=t):(o=e[2],t=e[3]),u.useEffect(o,t);let r;return e[4]===Symbol.for("react.memo_cache_sentinel")?(r=a.jsxs(a.Fragment,{children:[a.jsx("img",{src:"#",alt:""}),a.jsx("span",{ref:l}),a.jsx("img",{src:"#",alt:""})]}),e[4]=r):r=e[4],r}class d extends u.Component{state={hasError:!1};static getDerivedStateFromError(){return{hasError:!0}}componentDidCatch(e){this.props.onError(e)}render(){return this.state.hasError?null:this.props.children}}function j(c){const e=f.c(8),{equation:i,inline:n}=c,[l]=p(),[o]=u.useState(i);let t;e[0]!==l?(t=m=>l._onError(m),e[0]=l,e[1]=t):t=e[1];let r;e[2]!==o||e[3]!==n?(r=a.jsx(x,{equation:o,inline:n}),e[2]=o,e[3]=n,e[4]=r):r=e[4];let s;return e[5]!==t||e[6]!==r?(s=a.jsx(d,{onError:t,children:r}),e[5]=t,e[6]=r,e[7]=s):s=e[7],s}export{j as default};