@starlove/orbit 1.4.0 → 2.0.0

package/src/core/search.js

@@ -1,183 +0,0 @@
-import { labelsForTicket } from "./queries.js";
-import { canAccessBoard } from "./auth.js";
-import { toFtsQuery } from "./util.js";
-
-/**
- * Search tickets on the resolved board only. The router/MCP layer is
- * responsible for resolving which board to search (slug in URL, body, or
- * session board); this function never crosses board boundaries or mutates
- * shared state.
- */
-export function searchTickets(args, ctx) {
-  const { db, board, actor } = ctx;
-  const q = String(args.q || "").trim();
-  const limit = Math.min(Number(args.limit || 20), 50);
-  const mode = normalizeMode(args);
-  const maxCharsPerField = positiveInt(args.max_chars_per_field ?? args.maxCharsPerField, 0);
-  const fields = parseFields(args.fields);
-
-  if (!q) return { query: q, mode, results: [] };
-  if (!canAccessBoard(actor, board)) return { query: q, mode, results: [] };
-
-  const ticketNumber = ticketNumberQuery(q);
-  const fts = toFtsQuery(q);
-  let rows = [];
-
-  if (ticketNumber !== null) {
-    rows = db
-      .prepare(
-        `SELECT t.*, s.name AS state_name, s.role AS state_role, b.slug AS board_slug, -1 AS rank
-         FROM tickets t
-         JOIN states s ON s.id = t.state_id
-         JOIN boards b ON b.id = t.board_id
-         WHERE t.board_id = ? AND t.number = ? AND t.archived_at IS NULL
-         LIMIT ?`
-      )
-      .all(board.id, ticketNumber, limit);
-  }
-
-  try {
-    rows = rows.concat(
-      db
-        .prepare(
-          `SELECT t.*, s.name AS state_name, s.role AS state_role, b.slug AS board_slug,
-                  bm25(ticket_fts) AS rank
-           FROM ticket_fts
-           JOIN tickets t ON t.id = ticket_fts.ticket_id
-           JOIN states s ON s.id = t.state_id
-           JOIN boards b ON b.id = t.board_id
-           WHERE ticket_fts MATCH ? AND t.board_id = ? AND t.archived_at IS NULL
-           ORDER BY rank
-           LIMIT ?`
-        )
-        .all(fts, board.id, limit)
-    );
-  } catch {
-    const like = `%${q}%`;
-    const numberRank = ticketNumber !== null ? "CASE WHEN t.number = ? THEN -1 ELSE 0 END" : "0";
-    const numberPredicate = ticketNumber !== null ? "OR t.number = ?" : "";
-    const fallbackArgs = ticketNumber !== null ? [ticketNumber, board.id] : [board.id];
-    fallbackArgs.push(like, like, like, like, like, like, like, like);
-    if (ticketNumber !== null) fallbackArgs.push(ticketNumber);
-    fallbackArgs.push(limit);
-
-    rows = rows.concat(
-      db
-        .prepare(
-          `SELECT DISTINCT t.*, s.name AS state_name, s.role AS state_role, b.slug AS board_slug, ${numberRank} AS rank
-           FROM tickets t
-           JOIN states s ON s.id = t.state_id
-           JOIN boards b ON b.id = t.board_id
-           LEFT JOIN comments c ON c.ticket_id = t.id
-           WHERE t.board_id = ? AND t.archived_at IS NULL
-             AND (t.title LIKE ? OR t.description LIKE ? OR t.ai_plan LIKE ?
-              OR t.implementation_summary LIKE ? OR t.implementation_updates LIKE ?
-              OR t.plan_artifact_path LIKE ? OR t.implementation_artifact_path LIKE ? OR c.body LIKE ?
-              ${numberPredicate})
-           ORDER BY t.updated_at DESC, t.id ASC
-           LIMIT ?`
-        )
-        .all(...fallbackArgs)
-    );
-  }
-
-  rows.sort((a, b) => {
-    if (a.rank !== b.rank) return a.rank - b.rank;
-    const byTime = String(b.updated_at).localeCompare(String(a.updated_at));
-    if (byTime !== 0) return byTime;
-    return String(a.id).localeCompare(String(b.id));
-  });
-
-  const seen = new Set();
-  const deduped = [];
-  for (const ticket of rows) {
-    if (seen.has(ticket.id)) continue;
-    seen.add(ticket.id);
-    deduped.push(ticket);
-    if (deduped.length >= limit) break;
-  }
-
-  const results = deduped.map((ticket) =>
-    shapeSearchResult(ticket, labelsForTicket(db, ticket.id), { mode, fields, maxCharsPerField })
-  );
-
-  return { query: q, mode, results };
-}
-
-function normalizeMode(args) {
-  if (args.include_full === true || args.includeFull === true) return "full";
-  const mode = String(args.mode || "summary").trim().toLowerCase();
-  return ["ids", "summary", "full"].includes(mode) ? mode : "summary";
-}
-
-function positiveInt(value, fallback) {
-  const n = Number(value);
-  return Number.isInteger(n) && n > 0 ? n : fallback;
-}
-
-function parseFields(fields) {
-  if (Array.isArray(fields)) return new Set(fields.map(String));
-  if (typeof fields === "string" && fields.trim()) {
-    return new Set(fields.split(",").map((field) => field.trim()).filter(Boolean));
-  }
-  return null;
-}
-
-function cap(value, maxChars) {
-  if (!maxChars || typeof value !== "string") return value;
-  return value.length > maxChars ? value.slice(0, maxChars) : value;
-}
-
-function snippetFor(ticket, maxChars) {
-  const text = ticket.description || ticket.ai_plan || ticket.implementation_summary || "";
-  return cap(text, maxChars || 240);
-}
-
-function labelNames(labels) {
-  return labels.map((label) => label.name);
-}
-
-function pickFields(row, fields) {
-  if (!fields) return row;
-  const picked = {};
-  for (const field of fields) {
-    if (Object.hasOwn(row, field)) picked[field] = row[field];
-  }
-  return picked;
-}
-
-function shapeSearchResult(ticket, labels, { mode, fields, maxCharsPerField }) {
-  if (mode === "ids") {
-    return pickFields({ ticket_id: ticket.id, id: ticket.id, number: ticket.number, rank: ticket.rank }, fields);
-  }
-  if (mode === "full") {
-    const full = { ...ticket, labels };
-    if (maxCharsPerField) {
-      for (const key of ["description", "ai_plan", "implementation_summary", "implementation_updates"]) {
-        full[key] = cap(full[key], maxCharsPerField);
-      }
-    }
-    return pickFields(full, fields);
-  }
-  return pickFields({
-    ticket_id: ticket.id,
-    id: ticket.id,
-    number: ticket.number,
-    title: ticket.title,
-    state_name: ticket.state_name,
-    state_role: ticket.state_role,
-    type: ticket.type,
-    priority: ticket.priority,
-    parent_ticket_id: ticket.parent_ticket_id,
-    rank: ticket.rank,
-    snippet: snippetFor(ticket, maxCharsPerField),
-    labels: labelNames(labels)
-  }, fields);
-}
-
-function ticketNumberQuery(q) {
-  const match = String(q).trim().match(/^#?(\d+)$/);
-  if (!match) return null;
-  const number = Number(match[1]);
-  return Number.isSafeInteger(number) ? number : null;
-}

package/src/core/seed.js

@@ -1,234 +0,0 @@
-import { execFileSync } from "node:child_process";
-import { existsSync, readFileSync } from "node:fs";
-import { basename, join } from "node:path";
-import { addComment } from "./queries.js";
-import { recordEvent } from "./events.js";
-import { id, now, normalizeTicketType, slugify, titleize } from "./util.js";
-
-/**
- * Seed a fresh per-board DB with the universal first-run profile. Caller
- * supplies the connection and the repo path the board lives in. Returns the
- * new board row, or null if the DB already had a board.
- */
-export function seedIfEmpty(db, repoPath, options = {}) {
-  const existing = db.prepare("SELECT COUNT(*) AS count FROM boards").get().count;
-  if (existing > 0) return null;
-
-  const time = now();
-  const boardId = id();
-  const seed = buildBoardFromRepo(repoPath);
-
-  db.exec("BEGIN;");
-  try {
-    db.prepare(
-      `INSERT INTO boards
-       (id, slug, name, repo_url, system_path, default_branch,
-        project_notes, agent_instructions, ai_enabled, created_at, updated_at)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
-    ).run(
-      boardId,
-      seed.boardSlug,
-      seed.boardName,
-      seed.repoUrl,
-      seed.systemPath,
-      seed.defaultBranch,
-      seed.projectNotes,
-      seed.agentInstructions,
-      options.enableAi === false ? 0 : 1,
-      time,
-      time
-    );
-
-    const states = options.enableAi === false ? [
-      ["Backlog", null],
-      ["Todo", null],
-      ["In Progress", "in_progress"],
-      ["Review", "review"],
-      ["Done", "done"],
-      ["Cancelled", null]
-    ] : [
-      ["Backlog", null],
-      ["Todo", null],
-      ["AI Ready", "ai_ready"],
-      ["In Progress", "in_progress"],
-      ["Review", "review"],
-      ["Done", "done"],
-      ["Cancelled", null]
-    ];
-    const stateIds = new Map();
-    states.forEach(([name, role], position) => {
-      const stateId = id();
-      stateIds.set(name, stateId);
-      db.prepare(
-        `INSERT INTO states
-         (id, board_id, name, position, is_default, role, created_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?)`
-      ).run(stateId, boardId, name, position, name === "Todo" ? 1 : 0, role, time);
-    });
-
-    // User-defined labels only at seed time.
-    const labelIds = new Map();
-    [
-      ["human-only", "#7c2d12"],
-      ["needs-human-input", "#dc2626"],
-      ["needs-decomposition", "#9333ea"],
-      ["needs-followup", "#b45309"],
-      ["tech-debt", "#64748b"],
-      ["security", "#991b1b"],
-      ["onboarding", "#0f766e"]
-    ].forEach(([name, color]) => {
-      const labelId = id();
-      labelIds.set(name, labelId);
-      db.prepare(
-        "INSERT INTO labels (id, board_id, name, color, created_at) VALUES (?, ?, ?, ?, ?)"
-      ).run(labelId, boardId, name, color, time);
-    });
-
-    if (options.includeExamples) {
-      const epicTicket = insertSeedTicket(db, boardId, 1, {
-        title: `Onboard ${seed.boardName} into this board`,
-        description:
-          "First-run onboarding epic. Use this to turn the generic seed into a useful repo-specific project context and work queue.",
-        type: "epic",
-        aiPlan:
-          "1. Fill Settings → AI (Agent Instructions) and Settings → Notes (Notes For You).\n2. Capture initial decisions and lessons in the Journal.\n3. Create the first real epic or AI-ready implementation ticket.",
-        stateId: stateIds.get("Todo"),
-        priority: 4,
-        labels: [labelIds.get("human-only"), labelIds.get("needs-decomposition"), labelIds.get("onboarding")]
-      });
-
-      const firstTicket = insertSeedTicket(db, boardId, 2, {
-        title: "Fill agent context & personal notes",
-        description:
-          "Open Settings → AI (Agent Instructions) and Settings → Notes, and add real project context plus your own reminders.",
-        type: "feature",
-        parentTicketId: epicTicket,
-        stateId: stateIds.get("Todo"),
-        priority: 3,
-        labels: [labelIds.get("human-only"), labelIds.get("onboarding")]
-      });
-
-      insertSeedTicket(db, boardId, 3, {
-        title: "Create the first real implementation ticket",
-        description:
-          "Create a focused feature, task, or bug card with acceptance criteria, labels, and enough context for an agent or human to execute.",
-        type: "feature",
-        parentTicketId: epicTicket,
-        stateId: stateIds.get("Backlog"),
-        priority: 1,
-        labels: [labelIds.get("human-only"), labelIds.get("onboarding")]
-      });
-
-      // #12 is a stable “try the agent on this card” handle for docs and `orbit init` next steps (MCP + claim-next).
-      insertSeedTicket(db, boardId, 12, {
-        title: "Try Orbit MCP on this ticket",
-        description:
-          "After `orbit init` and registering MCP, ask your agent from this repo to use the Orbit MCP tools on ticket 12 (claim context, update fields, move lanes). Read SKILL-ORBIT.md first.",
-        type: "task",
-        stateId: stateIds.get("Backlog"),
-        priority: 2,
-        labels: [labelIds.get("onboarding")]
-      });
-
-      addComment(db, epicTicket, "system", "note", "Universal first-run seed. Delete or complete these onboarding cards once this board reflects the repo.");
-      addComment(db, firstTicket, "system", "note", "Settings → AI: agent_instructions (ticket context). Settings → Notes: project_notes (you only).");
-    }
-    recordEvent(db, boardId, "seed", null, "system", { board: seed.boardSlug });
-    db.exec("COMMIT;");
-  } catch (error) {
-    db.exec("ROLLBACK;");
-    throw error;
-  }
-
-  return db.prepare("SELECT * FROM boards WHERE id = ?").get(boardId);
-}
-
-function insertSeedTicket(db, boardId, number, ticket) {
-  const ticketId = id();
-  const time = now();
-  db.prepare(
-    `INSERT INTO tickets
-     (id, board_id, number, title, description, type, parent_ticket_id, ai_plan,
-      implementation_summary, implementation_updates, state_id, priority, created_by, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`
-  ).run(
-    ticketId,
-    boardId,
-    number,
-    ticket.title,
-    ticket.description,
-    normalizeTicketType(ticket.type || (ticket.parentTicketId ? "feature" : "task")),
-    ticket.parentTicketId || null,
-    ticket.aiPlan || "",
-    ticket.implementationSummary || "",
-    ticket.implementationUpdates || "",
-    ticket.stateId,
-    ticket.priority,
-    "system",
-    time,
-    time
-  );
-
-  for (const labelId of ticket.labels || []) {
-    db.prepare("INSERT OR IGNORE INTO ticket_labels (ticket_id, label_id) VALUES (?, ?)").run(ticketId, labelId);
-  }
-  return ticketId;
-}
-
-/** Sniff repo metadata for a new board (package.json, git, env). */
-export function buildBoardFromRepo(projectRoot) {
-  const packageInfo = readPackageInfo(projectRoot);
-  const directoryName = basename(projectRoot);
-  const boardName =
-    readSeedValue("board_name") || titleize(packageInfo.name || directoryName || "My Board");
-  const boardSlug = slugify(
-    readSeedValue("board_slug") || packageInfo.name || boardName || "my-board"
-  );
-  const repoUrl = readSeedValue("repo_url") || gitValue(["config", "--get", "remote.origin.url"], projectRoot) || "";
-  const systemPath = readSeedValue("system_path") || projectRoot;
-  const defaultBranch =
-    readSeedValue("default_branch") ||
-    gitValue(["branch", "--show-current"], projectRoot) ||
-    gitValue(["symbolic-ref", "--short", "HEAD"], projectRoot) ||
-    "main";
-  const defaultProjectNotes =
-    "Personal reminders (Settings → Notes: Notes For You). Point yourself at SKILL-ORBIT.md, runbooks, or nudges for your tools.";
-  return {
-    boardName,
-    boardSlug,
-    repoUrl,
-    systemPath,
-    defaultBranch,
-    projectNotes: readSeedValue("project_notes") || defaultProjectNotes,
-    agentInstructions: readSeedValue("agent_instructions") || ""
-  };
-}
-
-function readPackageInfo(root) {
-  const path = join(root, "package.json");
-  if (!existsSync(path)) return {};
-  try {
-    return JSON.parse(readFileSync(path, "utf8"));
-  } catch {
-    return {};
-  }
-}
-
-function readSeedValue(key) {
-  const envValue = process.env[key.toUpperCase()];
-  if (typeof envValue === "string" && envValue.trim()) return envValue.trim();
-  return "";
-}
-
-function gitValue(args, cwd) {
-  try {
-    return execFileSync("git", args, {
-      cwd,
-      encoding: "utf8",
-      stdio: ["ignore", "pipe", "ignore"],
-      timeout: 2000
-    }).trim();
-  } catch {
-    return "";
-  }
-}