@starlove/orbit 1.4.0 → 2.0.0

package/src/core/boards.js

@@ -1,409 +0,0 @@
-import { getRegistry, tx } from "./db.js";
-import { boardById, compactStatePositions } from "./queries.js";
-import {
-  computeNewBoardDbPath,
-  ensureBoardDbFileAndSchema,
-  insertBoard,
-  updateBoardMeta
-} from "./registry.js";
-import { requireBoardAccess, requirePermission } from "./auth.js";
-import { recordEvent } from "./events.js";
-import { buildBoardFromRepo } from "./seed.js";
-import { generateHelperFiles } from "./agents-md.js";
-import { httpError, id, now, normalizePath, normalizeProjectEntryType, requiredString, slugify } from "./util.js";
-import { DATA_DIR, MCP_SERVER_PATH, ROOT_DIR } from "./paths.js";
-import { resolve } from "node:path";
-
-/** Create a brand-new board on disk + register it. Does not require an
- *  existing ctx.board / ctx.db: this is registry-only. */
-export function createBoard(body, ctx) {
-  const { actor } = ctx;
-  requirePermission(actor, "owner");
-
-  const name = requiredString(body.name, "name");
-  const slug = slugify(body.slug || name);
-  // Folder is optional: a board without a repo_path is a pure kanban board (no
-  // agent dispatch, no managed helper files). When present it is the coding
-  // project where SKILL-ORBIT.md / AGENTS.md live for the AI agent's reference.
-  const repoPath = normalizePath(body.repo_path || body.system_path || "");
-  // Only meaningful with a folder; default on so the common "link my repo" path
-  // keeps writing the docs. Stored so the serve-time refresh respects opt-out.
-  const manageHelperFiles = repoPath ? body.manage_helper_files !== false : false;
-  const reg = getRegistry();
-  if (reg.prepare("SELECT id FROM boards WHERE slug = ?").get(slug)) {
-    throw httpError(409, "board_slug_taken");
-  }
-
-  const dbPath = computeNewBoardDbPath(repoPath, slug);
-  const db = ensureBoardDbFileAndSchema(dbPath);
-
-  const boardId = id();
-  const time = now();
-  const sniff = repoPath ? buildBoardFromRepo(repoPath) : { repoUrl: "", defaultBranch: "main" };
-
-  const aiEnabled = body.ai_enabled === undefined ? true : Boolean(body.ai_enabled);
-  const defaultStates = body.states || (aiEnabled ? [
-    ["Backlog", null],
-    ["Todo", null],
-    ["AI Ready", "ai_ready"],
-    ["In Progress", "in_progress"],
-    ["Review", "review"],
-    ["Done", "done"],
-    ["Cancelled", null]
-  ] : [
-    ["Backlog", null],
-    ["Todo", null],
-    ["In Progress", "in_progress"],
-    ["Review", "review"],
-    ["Done", "done"],
-    ["Cancelled", null]
-  ]);
-
-  // Board row + lanes + creation event land atomically in the board DB. The
-  // registry insert below is a different database (can't share this
-  // transaction); syncRegistryFromBoardDb repairs it idempotently if that
-  // second write is ever lost.
-  tx(db, () => {
-    db.prepare(
-      `INSERT INTO boards
-       (id, slug, name, repo_url, system_path, default_branch, ai_enabled, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-    ).run(
-      boardId,
-      slug,
-      name,
-      body.repo_url || sniff.repoUrl || "",
-      repoPath,
-      body.default_branch || sniff.defaultBranch || "main",
-      aiEnabled ? 1 : 0,
-      time,
-      time
-    );
-
-    defaultStates.forEach(([stateName, role], position) => {
-      db.prepare(
-        `INSERT INTO states
-         (id, board_id, name, position, is_default, role, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?)`
-      ).run(id(), boardId, stateName, position, stateName === "Todo" ? 1 : 0, role || null, time);
-    });
-
-    if (aiEnabled) ensureAgentLanes(db, boardId);
-    recordEvent(db, boardId, "board_created", null, actor.name, { board_id: boardId, slug });
-  });
-
-  insertBoard({
-    id: boardId,
-    slug,
-    name,
-    repo_path: repoPath,
-    db_path: dbPath,
-    repo_url: body.repo_url || sniff.repoUrl || "",
-    default_branch: body.default_branch || sniff.defaultBranch || "main",
-    manage_helper_files: manageHelperFiles ? 1 : 0,
-    last_active_at: time,
-    created_at: time,
-    updated_at: time
-  });
-
-  // Mirror `orbit init`: write SKILL-ORBIT.md + the AGENTS.md Orbit section into
-  // the project so the browser flow leaves the same files on disk. Best-effort —
-  // a board is still created if the files can't be written.
-  if (manageHelperFiles) {
-    try {
-      generateHelperFiles(repoPath, resolve(ROOT_DIR, "SKILL-ORBIT.md"));
-    } catch (error) {
-      console.warn(`[orbit] Could not write helper files in ${repoPath}: ${error.message}`);
-    }
-  }
-
-  return boardById(db, boardId);
-}
-
-const AGENT_LANES = [
-  { name: "AI Ready", role: "ai_ready" },
-  { name: "In Progress", role: "in_progress" },
-  { name: "Review", role: "review" }
-];
-
-function desiredAgentLanePosition(db, boardId, role) {
-  if (role === "ai_ready") {
-    const todo = db.prepare("SELECT position FROM states WHERE board_id = ? AND name = 'Todo'").get(boardId);
-    if (todo) return Number(todo.position) + 1;
-    const inProgress = db.prepare("SELECT position FROM states WHERE board_id = ? AND role = 'in_progress'").get(boardId);
-    if (inProgress) return Number(inProgress.position);
-  }
-  const maxPosition = db
-    .prepare("SELECT MAX(position) AS value FROM states WHERE board_id = ?")
-    .get(boardId).value;
-  return Number(maxPosition ?? -1) + 1;
-}
-
-function openStateSlot(db, boardId, position, exceptStateId = null) {
-  db.prepare(
-    `UPDATE states
-     SET position = position + 1
-     WHERE board_id = ?
-       AND position >= ?
-       AND (? IS NULL OR id != ?)`
-  ).run(boardId, position, exceptStateId, exceptStateId);
-}
-
-/** Ensure the role-bearing lanes that agent flow depends on exist on the
- *  board. AI Ready is kept directly after Todo so claim-next has a predictable
- *  handoff column. Idempotent. */
-export function ensureAgentLanes(db, boardId) {
-  const time = now();
-  for (const lane of AGENT_LANES) {
-    const existing = db
-      .prepare("SELECT id, position FROM states WHERE board_id = ? AND role = ?")
-      .get(boardId, lane.role);
-    if (existing) {
-      if (lane.role === "ai_ready") {
-        let desiredPosition = desiredAgentLanePosition(db, boardId, lane.role);
-        if (Number(existing.position) !== desiredPosition) {
-          db.prepare("UPDATE states SET position = -1 WHERE id = ?").run(existing.id);
-          compactStatePositions(db, boardId);
-          desiredPosition = desiredAgentLanePosition(db, boardId, lane.role);
-          openStateSlot(db, boardId, desiredPosition, existing.id);
-          db.prepare("UPDATE states SET position = ? WHERE id = ?").run(desiredPosition, existing.id);
-        }
-      }
-      continue;
-    }
-    const position = desiredAgentLanePosition(db, boardId, lane.role);
-    openStateSlot(db, boardId, position);
-    db.prepare(
-      `INSERT INTO states
-       (id, board_id, name, position, is_default, role, created_at)
-       VALUES (?, ?, ?, ?, 0, ?, ?)`
-    ).run(id(), boardId, lane.name, position, lane.role, time);
-  }
-}
-
-export function enableAiCollaboration(db, boardId, options = {}) {
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-
-  const time = now();
-  tx(db, () => {
-    db.prepare("UPDATE boards SET ai_enabled = 1, updated_at = ? WHERE id = ?").run(time, boardId);
-    ensureAgentLanes(db, boardId);
-
-    if (options.stageOnboardingTicket) {
-      const aiReadyLane = db.prepare("SELECT id FROM states WHERE board_id = ? AND role = 'ai_ready'").get(boardId);
-      if (aiReadyLane) {
-        db.prepare(
-          `UPDATE tickets
-           SET state_id = ?, updated_at = ?
-           WHERE board_id = ?
-             AND number = 12
-             AND title = 'Try Orbit MCP on this ticket'`
-        ).run(aiReadyLane.id, time, boardId);
-      }
-    }
-
-    recordEvent(db, boardId, "ai_enabled", null, options.actor || "system", { board_id: boardId });
-  });
-  return boardById(db, boardId);
-}
-
-export function disableAiCollaboration(db, boardId, options = {}) {
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-
-  const time = now();
-  return tx(db, () => {
-    db.prepare("UPDATE boards SET ai_enabled = 0, updated_at = ? WHERE id = ?").run(time, boardId);
-    recordEvent(db, boardId, "ai_disabled", null, options.actor || "system", { board_id: boardId });
-    return boardById(db, boardId);
-  });
-}
-
-export function updateBoard(boardId, body, ctx) {
-  const { db, board, actor } = ctx;
-  if (boardId !== board.id) throw httpError(404, "board_not_found");
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-  requireBoardAccess(actor, innerBoard);
-  requirePermission(actor, "write");
-
-  const allowed = [
-    "name",
-    "repo_url",
-    "system_path",
-    "default_branch",
-    "project_notes",
-    "agent_instructions"
-  ];
-  const sets = [];
-  const values = [];
-
-  for (const field of allowed) {
-    if (body[field] !== undefined) {
-      sets.push(`${field} = ?`);
-      values.push(field === "name" ? requiredString(body[field], "name") : String(body[field] ?? ""));
-    }
-  }
-
-  const aiTurningOn = body.ai_enabled !== undefined && Boolean(body.ai_enabled);
-  if (body.ai_enabled !== undefined) {
-    sets.push("ai_enabled = ?");
-    values.push(body.ai_enabled ? 1 : 0);
-  }
-
-  // manage_helper_files lives on the registry row (not the per-board DB), so it
-  // is handled separately from `sets`. A request that only toggles it must
-  // still be processed even when no per-board columns change.
-  const manageHelperFiles =
-    body.manage_helper_files === undefined ? undefined : Boolean(body.manage_helper_files);
-
-  if (sets.length === 0 && manageHelperFiles === undefined) return innerBoard;
-
-  if (sets.length > 0) {
-    sets.push("updated_at = ?");
-    values.push(now(), boardId);
-    tx(db, () => {
-      db.prepare(`UPDATE boards SET ${sets.join(", ")} WHERE id = ?`).run(...values);
-      if (aiTurningOn) ensureAgentLanes(db, boardId);
-      recordEvent(db, boardId, "board_updated", null, actor.name, { board_id: boardId, fields: Object.keys(body) });
-    });
-  }
-
-  // Mirror the changed fields into the registry row so cross-board listings
-  // stay coherent without needing a second source of truth.
-  const after = boardById(db, boardId);
-  const repoPath = normalizePath(after.system_path || "");
-  updateBoardMeta(boardId, {
-    name: after.name,
-    repo_url: after.repo_url,
-    default_branch: after.default_branch,
-    repo_path: repoPath,
-    ...(manageHelperFiles === undefined ? {} : { manage_helper_files: manageHelperFiles ? 1 : 0 })
-  });
-
-  // Generating the helper files is the active half of turning the toggle on:
-  // write them now rather than waiting for the next `orbit run` refresh.
-  // Turning it off just stops the managed refresh; existing files are left.
-  if (manageHelperFiles && repoPath) {
-    try {
-      generateHelperFiles(repoPath, resolve(ROOT_DIR, "SKILL-ORBIT.md"));
-    } catch (error) {
-      console.warn(`[orbit] Could not write helper files in ${repoPath}: ${error.message}`);
-    }
-  }
-
-  return after;
-}
-
-export function getBoardContext(boardId, ctx, options = {}) {
-  const { db, board, actor } = ctx;
-  if (boardId !== board.id) throw httpError(404, "board_not_found");
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-  requireBoardAccess(actor, innerBoard);
-  return boardManual(boardId, ctx, options);
-}
-
-export function boardManual(boardId, ctx, options = {}) {
-  const { db } = ctx;
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-  const includeStruck = Boolean(options.includeStruck);
-  const allEntries = db
-    .prepare("SELECT * FROM board_entries WHERE board_id = ? ORDER BY created_at DESC")
-    .all(boardId);
-  const activeEntries = allEntries.filter((entry) => !entry.struck_at);
-  const entries = includeStruck ? allEntries : activeEntries;
-  return {
-    board: {
-      id: innerBoard.id,
-      slug: innerBoard.slug,
-      name: innerBoard.name,
-      repo_url: innerBoard.repo_url,
-      system_path: innerBoard.system_path || ctx.board.repo_path || "",
-      default_branch: innerBoard.default_branch,
-      agent_instructions: innerBoard.agent_instructions,
-      ai_enabled: innerBoard.ai_enabled,
-      manage_helper_files: ctx.board.manage_helper_files,
-      created_at: innerBoard.created_at,
-      updated_at: innerBoard.updated_at
-    },
-    entries,
-    deployment: {
-      app_root: ROOT_DIR,
-      system_path: innerBoard.system_path || ctx.board.repo_path || "",
-      data_dir: DATA_DIR,
-      mcp_server_path: MCP_SERVER_PATH,
-      db_path: ctx.board.db_path
-    }
-  };
-}
-
-export function createBoardEntry(boardId, body, ctx) {
-  const { db, board, actor } = ctx;
-  if (boardId !== board.id) throw httpError(404, "board_not_found");
-  const innerBoard = boardById(db, boardId);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-  requireBoardAccess(actor, innerBoard);
-  requirePermission(actor, "write");
-
-  const entryType = normalizeProjectEntryType(body.type);
-  const entryTitle = requiredString(body.title, "title");
-  return tx(db, () => {
-    const entry = insertBoardEntry(
-      db,
-      boardId,
-      entryType,
-      entryTitle,
-      body.body || "",
-      actor.name,
-      body.ticket_id || null
-    );
-    recordEvent(db, boardId, "board_entry_created", body.ticket_id || null, actor.name, {
-      board_id: boardId,
-      entry_id: entry.id,
-      type: entry.type
-    });
-    return entry;
-  });
-}
-
-export function updateBoardEntry(entryId, body, ctx) {
-  const { db, board, actor } = ctx;
-  const entry = db.prepare("SELECT * FROM board_entries WHERE id = ?").get(entryId);
-  if (!entry || entry.board_id !== board.id) throw httpError(404, "board_entry_not_found");
-
-  const innerBoard = boardById(db, entry.board_id);
-  if (!innerBoard) throw httpError(404, "board_not_found");
-  requireBoardAccess(actor, innerBoard);
-  requirePermission(actor, "write");
-
-  const shouldStrike = Boolean(body.struck);
-  const struckAt = shouldStrike ? entry.struck_at || now() : null;
-  const updatedAt = now();
-  return tx(db, () => {
-    db.prepare("UPDATE board_entries SET struck_at = ?, updated_at = ? WHERE id = ?").run(struckAt, updatedAt, entryId);
-    const updated = db.prepare("SELECT * FROM board_entries WHERE id = ?").get(entryId);
-    recordEvent(
-      db,
-      entry.board_id,
-      shouldStrike ? "board_entry_struck" : "board_entry_restored",
-      entry.ticket_id || null,
-      actor.name,
-      { board_id: entry.board_id, entry_id: entry.id, type: entry.type }
-    );
-    return updated;
-  });
-}
-
-export function insertBoardEntry(db, boardId, type, title, body, createdBy, ticketId = null) {
-  const entryId = id();
-  const time = now();
-  db.prepare(
-    `INSERT INTO board_entries
-     (id, board_id, type, title, body, ticket_id, created_by, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(entryId, boardId, normalizeProjectEntryType(type), title, body || "", ticketId, createdBy, time, time);
-  return db.prepare("SELECT * FROM board_entries WHERE id = ?").get(entryId);
-}

package/src/core/bootstrap.js

@@ -1,170 +0,0 @@
-import { compactTicket, ticketById } from "./queries.js";
-import { canAccessBoard, publicActor } from "./auth.js";
-import { EXPORT_DIR } from "./paths.js";
-import {
-  getBoardByRegistryId,
-  listBoards,
-  openBoardDb,
-  pickDefaultBoard,
-  touchBoardActive
-} from "./registry.js";
-
-function boardSummaryFromRegistry(r) {
-  return {
-    id: r.id,
-    slug: r.slug,
-    name: r.name,
-    repo_url: r.repo_url,
-    default_branch: r.default_branch,
-    repo_path: r.repo_path,
-    system_path: r.repo_path,
-    project_notes: "",
-    agent_instructions: "",
-    ai_enabled: 0,
-    created_at: r.created_at,
-    updated_at: r.updated_at
-  };
-}
-
-/**
- * Build the bootstrap payload for one board (or just registry metadata if the
- * actor has no accessible boards). No global state is mutated; the chosen
- * board's last_active_at is bumped so subsequent default-pick prefers it.
- *
- * @param actor authenticated actor
- * @param requestedBoardId optional board id from `?board_id=` (or null)
- * @param requestedBoardSlug optional board slug from `?board=` (or null)
- */
-export function getBootstrap(actor, requestedBoardId = null, requestedBoardSlug = null) {
-  const registryRows = listBoards();
-  const accessible = registryRows.filter((row) => canAccessBoard(actor, { slug: row.slug }));
-
-  if (accessible.length === 0) {
-    return {
-      actor: publicActor(actor),
-      meta: {
-        db_path: null,
-        export_dir: EXPORT_DIR
-      },
-      boards: [],
-      board_entries: [],
-      states: [],
-      labels: [],
-      tickets: []
-    };
-  }
-
-  let chosen = null;
-  if (requestedBoardId) {
-    chosen = accessible.find((row) => row.id === requestedBoardId) || null;
-  }
-  if (!chosen && requestedBoardSlug) {
-    chosen = accessible.find((row) => row.slug === requestedBoardSlug) || null;
-  }
-  if (!chosen) {
-    const defaultRow = pickDefaultBoard();
-    if (defaultRow && accessible.some((row) => row.id === defaultRow.id)) {
-      chosen = defaultRow;
-    }
-  }
-  if (!chosen) {
-    const sorted = [...accessible].sort(
-      (a, b) =>
-        String(b.last_active_at || "").localeCompare(String(a.last_active_at || "")) ||
-        String(a.name).localeCompare(String(b.name))
-    );
-    chosen = sorted[0];
-  }
-
-  // Re-fetch in case the chosen row came from pickDefaultBoard before the
-  // accessible filter. Either way, this is the row we open.
-  const chosenRow = getBoardByRegistryId(chosen.id);
-  touchBoardActive(chosenRow.id);
-  const db = openBoardDb(chosenRow);
-  const innerBoard = db.prepare("SELECT * FROM boards LIMIT 1").get();
-
-  const boards = accessible.map((r) => {
-    if (innerBoard && r.id === innerBoard.id) {
-      return {
-        ...innerBoard,
-        repo_path: r.repo_path,
-        system_path: innerBoard.system_path || r.repo_path
-      };
-    }
-    return boardSummaryFromRegistry(r);
-  });
-
-  const boardIds = new Set(innerBoard ? [innerBoard.id] : []);
-
-  const states = db
-    .prepare("SELECT * FROM states ORDER BY position")
-    .all()
-    .filter((state) => boardIds.has(state.board_id));
-
-  const tickets = db
-    .prepare(
-      `SELECT t.*, s.name AS state_name, s.role AS state_role,
-              b.slug AS board_slug, b.name AS board_name
-       FROM tickets t
-       JOIN states s ON s.id = t.state_id
-       JOIN boards b ON b.id = t.board_id
-       WHERE t.archived_at IS NULL
-       ORDER BY t.updated_at DESC, t.id ASC`
-    )
-    .all()
-    .filter((ticket) => boardIds.has(ticket.board_id));
-
-  const labels = db
-    .prepare("SELECT * FROM labels ORDER BY name")
-    .all()
-    .filter((label) => boardIds.has(label.board_id));
-
-  const ticketLabels = db
-    .prepare(
-      `SELECT tl.ticket_id, l.id, l.name, l.color
-       FROM ticket_labels tl
-       JOIN labels l ON l.id = tl.label_id`
-    )
-    .all()
-    .filter((label) => tickets.some((ticket) => ticket.id === label.ticket_id));
-
-  const commentCounts = db
-    .prepare("SELECT ticket_id, COUNT(*) AS count FROM comments GROUP BY ticket_id")
-    .all()
-    .filter((row) => tickets.some((ticket) => ticket.id === row.ticket_id));
-
-  const childCounts = db
-    .prepare(
-      "SELECT parent_ticket_id AS ticket_id, COUNT(*) AS count FROM tickets WHERE parent_ticket_id IS NOT NULL AND archived_at IS NULL GROUP BY parent_ticket_id"
-    )
-    .all()
-    .filter((row) => tickets.some((ticket) => ticket.id === row.ticket_id));
-
-  const boardEntries = db
-    .prepare("SELECT * FROM board_entries ORDER BY created_at DESC")
-    .all()
-    .filter((entry) => boardIds.has(entry.board_id));
-
-  return {
-    actor: publicActor(actor),
-    // The server may choose a default board that is not first in the registry's
-    // alphabetic board list. Expose that choice explicitly so first-page load
-    // selects the same board whose lanes/tickets are included below.
-    active_board_id: chosenRow.id,
-    meta: {
-      db_path: chosenRow.db_path,
-      export_dir: EXPORT_DIR
-    },
-    boards,
-    board_entries: boardEntries,
-    states,
-    labels,
-    tickets: tickets.map((ticket) => ({
-      ...ticket,
-      labels: ticketLabels.filter((label) => label.ticket_id === ticket.id),
-      comment_count: commentCounts.find((row) => row.ticket_id === ticket.id)?.count || 0,
-      child_count: childCounts.find((row) => row.ticket_id === ticket.id)?.count || 0,
-      parent_ticket: ticket.parent_ticket_id ? compactTicket(ticketById(db, ticket.parent_ticket_id)) : null
-    }))
-  };
-}

package/src/core/css-bundle.js

@@ -1,30 +0,0 @@
-// CSS bundling seam for Starscape UI package imports.
-//
-// public/styles.css remains Orbit's editable source of truth, but it can now
-// import @starlove/ui component CSS. Static builds and source dev serving both
-// pass that source through esbuild so browsers never have to resolve package
-// specifiers from raw CSS.
-
-const CURSOR_ASSET_LOADERS = {
-  ".cur": "file"
-};
-
-export async function bundleCss({ entryPoint, outfile, minify = false }) {
-  const { build } = await import("esbuild");
-  const result = await build({
-    entryPoints: [entryPoint],
-    bundle: true,
-    target: "es2022",
-    minify,
-    sourcemap: false,
-    write: false,
-    outfile,
-    assetNames: "cursors/[name]",
-    loader: CURSOR_ASSET_LOADERS,
-    external: ["./fonts/*", "fonts/*"],
-    legalComments: "none"
-  });
-  const cssFile = result.outputFiles.find((file) => file.path.endsWith(".css"));
-  if (!cssFile) throw new Error("CSS bundle did not produce a stylesheet");
-  return { cssFile, outputFiles: result.outputFiles };
-}