@starlove/orbit 1.1.1 → 1.1.2

package/README.md

@@ -176,8 +176,8 @@ A copy-editable client config lives at [docs/mcp-client.example.json](docs/mcp-c
 | Purpose       | Tool                                                                                                                                                                            |
 | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Index         | `board_list` (tiny registry), `board_set_active`                                                                                                                                |
-| Board context | `board_context` (settings + journal + deployment; optional board + `include_struck`)                                                                                            |
-| Read          | `board_read_ticket`, `board_read_comments`, `board_get_ticket_context` (heavy), `board_get_ticket_relations`, `board_get_ticket_blockers`, `board_search`, `board_list_archive` |
+| Board context | `board_context` (settings + journal + deployment; optional board + `include_struck`)                                                                     |
+| Read          | `board_read_ticket`, `board_read_comments`, `board_get_ticket_context` (lean), `board_get_ticket_context_full` (manual/journal), `board_get_ticket_relations`, `board_get_ticket_blockers`, `board_search`, `board_list_archive` |
 | Agent flow    | `board_claim_next`, `board_checkpoint`, `board_complete`                                                                                                                        |
 | Write         | `board_update_ticket`, `board_add_comment`, `board_add_board_entry`, `board_archive_ticket`, `board_restore_ticket`, `board_delete_ticket`                                      |
 | Admin         | `board_export_board`, `board_update_settings`                                                                                                                                   |

package/dist/full/version.json

@@ -1,6 +1,6 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "edition": "full",
-  "builtAt": "2026-05-26T05:55:12.573Z"
+  "builtAt": "2026-05-26T06:59:10.275Z"
 }

package/docs/AGENT_PROTOCOL.md

@@ -72,7 +72,7 @@ Returns the first schedulable `AI Ready` ticket. The scheduler skips tickets blo
 
 By default, `claim-next` skips `epic` cards because they are index/planning cards. To claim an epic for planning, pass `"type": "epic"` or `"include_epics": true`.
 
-The response shape is `{ claimed: true, ticket_id, context }` where `context` is the lightweight `board_read_ticket` pack (`ticket` with title/description/labels/state and the `board_manual`). Ticket comments are not included in the default claim context; call `GET /api/tickets/:id/comments` (or MCP `board_read_comments`) when an explicit chat/comment surface needs them. For the heavier ticket pack with relations, blockers, implementation fields, and child cards, call `GET /api/tickets/:id/context` (or MCP `board_get_ticket_context`).
+The response shape is `{ claimed: true, ticket_id, context }` where `context` is the lightweight `board_read_ticket` pack (`ticket` with title/description/labels/state and the `board_manual`). Ticket comments are not included in the default claim context; call `GET /api/tickets/:id/comments` (or MCP `board_read_comments`) when an explicit chat/comment surface needs them. For the lean ticket relationship pack, call `GET /api/tickets/:id/context` (or MCP `board_get_ticket_context`). For the historical heavy pack with board manual/journal attached, call `GET /api/tickets/:id/context/full` (or MCP `board_get_ticket_context_full`).
 
 ### Read Lightweight Ticket
 
@@ -86,7 +86,7 @@ MCP equivalent: `board_read_ticket`.
 
 Returns the lightweight agent read shape: `ticket` with identity, title, description, labels, state/type/priority, plus `board_manual`. Ticket comments, relations, blockers, child cards, and implementation fields are intentionally omitted. Use this for quick orientation and claim context. The `lookup` form is exact by per-board ticket number or exact title; it does not use fuzzy search or comment/implementation indexes.
 
-### Get Context Pack
+### Get Lean Ticket Context Pack
 
 ```http
 GET /api/tickets/:id/context?depth=1
@@ -94,15 +94,31 @@ GET /api/tickets/:id/context?depth=1
 
 Returns:
 
-- Ticket, board, state, labels.
-- The board manual (`board_manual`), including `agent_instructions` and `project_notes`.
+- Ticket, board identity, state, labels.
 - Dedicated implementation fields: `ai_plan`, `implementation_summary`, and `implementation_updates`.
 - Parent epic/story ticket when present.
 - Child feature cards when the ticket is an epic/story.
 - Related tickets.
 - Blockers and blocking tickets.
 
-Ticket comments are intentionally omitted from this default agent context. Explicit comment/chat consumers should call:
+Project manual/journal (`agent_instructions`, `project_notes`, and board entries) and ticket comments are intentionally omitted from this default agent context. Fetch project context and comments explicitly when needed:
+
+```http
+GET /api/boards/:board_id/context?include_struck=false
+GET /api/tickets/:id/comments
+```
+
+MCP equivalents: `board_context` and `board_read_comments`.
+
+### Get Full Ticket Context Pack
+
+```http
+GET /api/tickets/:id/context/full?depth=1
+```
+
+MCP equivalent: `board_get_ticket_context_full`.
+
+Returns the historical heavy context shape: everything in the lean ticket context plus the full board row and `board_manual` / journal. Comments are still intentionally omitted; explicit comment/chat consumers should call:
 
 ```http
 GET /api/tickets/:id/comments
@@ -176,7 +192,7 @@ Searches ticket titles, descriptions, and comments.
 GET /api/boards/:board_id/context?include_struck=false
 ```
 
-Returns the same shape as MCP `board_context`: a trimmed `board` (`name`, `agent_instructions`, `updated_at`), `entries` (journal / decisions / lessons), and `deployment` paths. Use `include_struck=true` to include struck journal rows (default off).
+Returns the same shape as MCP `board_context`: board metadata (`agent_instructions`, `project_notes`, repository paths, default branch), `entries` (journal / decisions / lessons), and `deployment` paths. Use `include_struck=true` to include struck journal rows (default off).
 
 MCP: `board_context` with optional `board_id` / `board_slug` / `board` and optional `include_struck`.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Starscape Orbit ??? zero-dependency, pretty, human-ai-first kanban system.",
   "license": "AGPL-3.0",
   "type": "module",

package/public/js/local-backend.js

@@ -726,7 +726,7 @@ async function handleTicketArchive(ticketId, archive) {
   });
 }
 
-async function handleTicketContext(ticketId) {
+async function handleTicketContext(ticketId, { includeProjectContext = false } = {}) {
   const db = await openDb();
   const snap = await readBoardSnapshot(db);
   const ticket = snap.tickets.find((t) => t.id === ticketId);
@@ -776,16 +776,26 @@ async function handleTicketContext(ticketId) {
         other_ticket: compact(other)
       };
     });
-  return {
+  const context = {
     ticket: { ...ticket, labels },
-    board: snap.board,
-    board_manual: { entries: snap.boardEntries.filter((e) => !e.struck_at) },
+    board: includeProjectContext
+      ? snap.board
+      : {
+          id: snap.board.id,
+          slug: snap.board.slug,
+          name: snap.board.name,
+          repo_path: snap.board.system_path || "",
+          system_path: snap.board.system_path || "",
+          default_branch: snap.board.default_branch || "main"
+        },
     parent_ticket: compact(parent),
     child_tickets: childTickets,
     relations,
     blockers: [],
     related_tickets: [...childTickets, ...(parent ? [parent] : [])]
   };
+  if (includeProjectContext) context.board_manual = { entries: snap.boardEntries.filter((e) => !e.struck_at) };
+  return context;
 }
 
 async function handleTicketComments(ticketId) {
@@ -955,6 +965,7 @@ const ROUTES = [
   { m: "DELETE", re: /^\/api\/tickets\/([^/]+)$/, fn: (m) => handleTicketDelete(decodeURIComponent(m[1])) },
   { m: "POST", re: /^\/api\/tickets\/([^/]+)\/archive$/, fn: (m) => handleTicketArchive(decodeURIComponent(m[1]), true) },
   { m: "POST", re: /^\/api\/tickets\/([^/]+)\/restore$/, fn: (m) => handleTicketArchive(decodeURIComponent(m[1]), false) },
+  { m: "GET", re: /^\/api\/tickets\/([^/]+)\/context\/full$/, fn: (m) => handleTicketContext(decodeURIComponent(m[1]), { includeProjectContext: true }) },
   { m: "GET", re: /^\/api\/tickets\/([^/]+)\/context$/, fn: (m) => handleTicketContext(decodeURIComponent(m[1])) },
   { m: "GET", re: /^\/api\/tickets\/([^/]+)\/comments$/, fn: (m) => handleTicketComments(decodeURIComponent(m[1])) },
   { m: "GET", re: /^\/api\/tickets\/([^/]+)\/history$/, fn: (m) => handleTicketHistory(decodeURIComponent(m[1])) },

package/src/core/agent.js

@@ -210,7 +210,18 @@ export function completeTicket(body, ctx) {
   return getContextPack(ticket.id, ctx, 1);
 }
 
-export function getContextPack(ticketId, ctx, depth = 1, options = {}) {
+function contextBoardIdentity(innerBoard, ctx) {
+  return {
+    id: innerBoard.id,
+    slug: innerBoard.slug,
+    name: innerBoard.name,
+    repo_path: innerBoard.system_path || ctx.board.repo_path || "",
+    system_path: innerBoard.system_path || ctx.board.repo_path || "",
+    default_branch: innerBoard.default_branch || "main"
+  };
+}
+
+function buildContextPack(ticketId, ctx, depth = 1, options = {}, { includeProjectContext = false } = {}) {
   const { db, board, actor } = ctx;
   const maxCharsPerField = positiveInt(options.max_chars_per_field ?? options.maxCharsPerField, 0);
   const includeParentFull = Boolean(options.include_parent_full ?? options.includeParentFull);
@@ -236,13 +247,12 @@ export function getContextPack(ticketId, ctx, depth = 1, options = {}) {
     ...(parentTicket ? [parentTicket] : [])
   ]);
 
-  return {
+  const pack = {
     ticket: capTicketFields({
       ...ticket,
       labels
     }, maxCharsPerField),
-    board: innerBoard,
-    board_manual: boardManual(innerBoard.id, ctx),
+    board: includeProjectContext ? innerBoard : contextBoardIdentity(innerBoard, ctx),
     parent_ticket: parentTicket ? (includeParentFull ? capTicketFields({ ...parentTicket, labels: labelsForTicket(db, parentTicket.id) }, maxCharsPerField) : compactTicket(parentTicket)) : null,
     child_tickets: childTickets.map((child) => ({
       ...capTicketFields(child, maxCharsPerField),
@@ -259,6 +269,17 @@ export function getContextPack(ticketId, ctx, depth = 1, options = {}) {
       includeRelatedFull ? capTicketFields({ ...related, labels: labelsForTicket(db, related.id) }, maxCharsPerField) : compactTicket(related)
     )
   };
+
+  if (includeProjectContext) pack.board_manual = boardManual(innerBoard.id, ctx);
+  return pack;
+}
+
+export function getContextPack(ticketId, ctx, depth = 1, options = {}) {
+  return buildContextPack(ticketId, ctx, depth, options, { includeProjectContext: false });
+}
+
+export function getContextPackFull(ticketId, ctx, depth = 1, options = {}) {
+  return buildContextPack(ticketId, ctx, depth, options, { includeProjectContext: true });
 }
 
 export function getAgentDispatchPacket(ticketId, ctx, options = {}) {

package/src/core/board.js

@@ -134,7 +134,7 @@ export {
 export { archiveTicket, createComment, createTicket, deleteTicket, restoreTicket, updateTicket } from "./tickets.js";
 export { archivedTicketsForBoard } from "./queries.js";
 export { getTicketBlockers, getTicketRelations } from "./relations.js";
-export { checkpointTicket, claimNext, completeTicket, getAgentDispatchPacket, getContextPack, readComments, readTicket } from "./agent.js";
+export { checkpointTicket, claimNext, completeTicket, getAgentDispatchPacket, getContextPack, getContextPackFull, readComments, readTicket } from "./agent.js";
 export { searchTickets } from "./search.js";
 export { exportBoard } from "./snapshots.js";
 

package/src/core/dispatch.js

@@ -3,7 +3,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "n
 import { extname, join, resolve } from "node:path";
 import { localOwnerActor } from "./auth.js";
 import { DISPATCH_RUNS_DIR } from "./paths.js";
-import { getContextPack } from "./agent.js";
+import { getContextPackFull } from "./agent.js";
 import { openBoardDb, getBoardByRegistryId, getBoardByRepoPath, getBoardBySlug, touchBoardActive } from "./registry.js";
 import { stateByName, stateByRole, ticketById, ticketByNumber, unresolvedBlockers } from "./queries.js";
 import { createRegistrySchema } from "./db.js";
@@ -438,7 +438,7 @@ export function dispatchTicket(options) {
 
   mkdirSync(runDir, { recursive: true });
   const policyBin = createPolicyBin(runDir, policyName);
-  const context = getContextPack(ticket.id, ctx, 1);
+  const context = getContextPackFull(ticket.id, ctx, 1);
   const handoff = buildHandoff({
     boardRow,
     context,

package/src/core/router.js

@@ -67,6 +67,7 @@ import {
   completeTicket,
   getAgentDispatchPacket,
   getContextPack,
+  getContextPackFull,
   readComments,
   readTicket
 } from "./agent.js";
@@ -282,6 +283,11 @@ export async function handleApi(req, res, url) {
       sendJson(res, 200, getContextPack(ticketId, ctx, depth, agentContextOptions(url)));
       return;
     }
+    if (sub === "context/full" && req.method === "GET") {
+      const depth = Number(url.searchParams.get("depth") || 1);
+      sendJson(res, 200, getContextPackFull(ticketId, ctx, depth, agentContextOptions(url)));
+      return;
+    }
     if ((sub === "dispatch-packet" || sub === "agent-dispatch-packet") && req.method === "GET") {
       sendJson(res, 200, getAgentDispatchPacket(ticketId, ctx, agentContextOptions(url)));
       return;

package/src/mcp/orbit-client.js

@@ -87,6 +87,7 @@ export function createHttpOrbitClient(env = process.env, fetchImpl = globalThis.
     async boardSetActive(args = {}) { if (!args.slug) throw rpcError(-32602, "slug is required."); env.ORBIT_DEFAULT_BOARD = String(args.slug); return { ok: true, slug: String(args.slug), mode: "remote" }; },
     async claimNext(args = {}) { return request("POST", "/api/agent/claim-next", { body: { ...args, board: requireBoard(args) } }); },
     async getTicketContext(args = {}) { return request("GET", `/api/tickets/${encodeURIComponent(args.ticket_id)}/context`, { query: { ...contextQuery(args), depth: args.depth || 1 } }); },
+    async getTicketContextFull(args = {}) { return request("GET", `/api/tickets/${encodeURIComponent(args.ticket_id)}/context/full`, { query: { ...contextQuery(args), depth: args.depth || 1 } }); },
     async getAgentDispatchPacket(args = {}) { return request("GET", `/api/tickets/${encodeURIComponent(args.ticket_id)}/dispatch-packet`, { query: contextQuery(args) }); },
     async readTicket(args = {}) {
       if (args.ticket_id) {
@@ -216,6 +217,7 @@ export async function createLocalOrbitClient(env = process.env) {
     boardSetActive: (args = {}) => { const slug = String(args.slug || "").trim(); if (!slug) throw rpcError(-32602, "slug is required."); const row = registry.getBoardBySlug(slug); if (!row) throw rpcError(-32004, `Board slug not found: ${slug}`); setSessionBoard(row); return { ok: true, board_id: row.id, slug: row.slug, name: row.name, db_path: row.db_path }; },
     claimNext: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return backup(ctx, board.claimNext(args, ctx)); },
     getTicketContext: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return board.getContextPack(args.ticket_id, ctx, Number(args.depth || 1), args); },
+    getTicketContextFull: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return board.getContextPackFull(args.ticket_id, ctx, Number(args.depth || 1), args); },
     getAgentDispatchPacket: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return board.getAgentDispatchPacket(args.ticket_id, ctx, args); },
     readTicket: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return board.readTicket(args, ctx); },
     readComments: (args = {}) => { const ctx = ctxFor(rowOrSession(args), actor()); return board.readComments(args, ctx); },

package/src/mcp-server.js

@@ -185,7 +185,7 @@ const TOOL_DEFS = [
   {
     name: "board_context",
     description:
-      "Board context pack: name, agent_instructions, journal entries (board_entries), deployment paths. Resolves board from board_id / board_slug / board, else the MCP session board. Set include_struck true to include struck journal rows (default false). Same payload as GET /api/boards/:id/context.",
+      "Board/project context pack: board metadata, agent_instructions, journal entries (board_entries), and deployment paths. Complements the lean board_get_ticket_context. Resolves board from board_id / board_slug / board, else the MCP session board. Set include_struck true to include struck journal rows (default false). Same payload as GET /api/boards/:id/context.",
     inputSchema: {
       type: "object",
       properties: {
@@ -243,7 +243,7 @@ const TOOL_DEFS = [
   {
     name: "board_get_ticket_context",
     description:
-      "Read the default agent context pack for a ticket, including board agent_instructions (project-level agent context), relations, blockers, implementation fields, and child cards. Ticket comments are intentionally omitted; use board_read_comments for explicit comment retrieval.",
+      "Return the default lean context pack for a ticket: ticket fields, board identity only, relations, blockers, parent/children, and related ticket summaries. Project manual/journal and comments are intentionally omitted; use board_context for board manual/journal and board_read_comments for comment threads.",
     inputSchema: {
       type: "object",
       properties: {
@@ -261,6 +261,27 @@ const TOOL_DEFS = [
     },
     handler: (args) => orbitClient.getTicketContext(args)
   },
+  {
+    name: "board_get_ticket_context_full",
+    description:
+      "Return the explicit heavy ticket context pack, preserving the historical board_get_ticket_context shape: ticket, full board row, board_manual/journal, relations, blockers, parent/children, and related tickets. Comments are still intentionally omitted; use board_read_comments for comment threads.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        ticket_id: { type: "string" },
+        board_id: { type: "string" },
+        board_slug: { type: "string" },
+        board: { type: "string" },
+        depth: { type: "integer", minimum: 1, maximum: 3 },
+        max_chars_per_field: { type: "integer", minimum: 1 },
+        include_parent_full: { type: "boolean" },
+        include_related_full: { type: "boolean" }
+      },
+      required: ["ticket_id"],
+      additionalProperties: false
+    },
+    handler: (args) => orbitClient.getTicketContextFull(args)
+  },
   {
     name: "board_get_agent_dispatch_packet",
     description: