@starlove/orbit 1.0.4 → 1.0.6

package/dist/full/version.json

@@ -1,6 +1,6 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "edition": "full",
-  "builtAt": "2026-05-19T06:06:41.796Z"
+  "builtAt": "2026-05-20T07:25:07.448Z"
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@starlove/orbit",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "Starscape Orbit — SQLite-backed, agent-first task board (Starscape suite).",
-  "license": "MIT",
+  "license": "AGPL-3.0",
   "type": "module",
   "packageManager": "pnpm@10.20.0",
   "bin": {

package/public/js/kanban.js

@@ -257,6 +257,14 @@ function renderColumnBody(columnTickets, allTickets) {
       continue;
     }
 
+    // Defer children whose epic is in this column — they'll render under the
+    // epic when the loop reaches it. Without this skip, a child iterated before
+    // its epic would render standalone here, then again inside epic-children
+    // (rendered.add happens at the epic, which may come later in updated_at order).
+    if (t.parent_ticket_id && epicIdsInColumn.has(t.parent_ticket_id)) {
+      continue;
+    }
+
     if (t.parent_ticket_id && epicById.has(t.parent_ticket_id) && !epicIdsInColumn.has(t.parent_ticket_id)) {
       const epic = epicById.get(t.parent_ticket_id);
       const siblings = childrenByEpicId.get(t.parent_ticket_id) || [];

package/public/js/local-backend.js

@@ -307,7 +307,11 @@ function decorateTickets(snapshot, includeArchived = false) {
   const labelById = Object.fromEntries(labels.map((l) => [l.id, l]));
   const stateById = Object.fromEntries(states.map((s) => [s.id, s]));
   const visible = tickets.filter((t) => includeArchived || !t.archived_at);
-  const sorted = [...visible].sort((a, b) => String(b.updated_at).localeCompare(String(a.updated_at)));
+  const sorted = [...visible].sort((a, b) => {
+    const byTime = String(b.updated_at).localeCompare(String(a.updated_at));
+    if (byTime !== 0) return byTime;
+    return String(a.id).localeCompare(String(b.id));
+  });
   return sorted.map((ticket) => {
     const stateRow = stateById[ticket.state_id];
     const tLabels = ticketLabels
@@ -575,6 +579,17 @@ async function handleStateReorder(boardId, body) {
   });
 }
 
+// Mirrors src/core/tickets.js#bumpTicketUpdatedAt — rolls child activity up to
+// the parent epic so the column sort (updated_at DESC) keeps the epic group
+// near recent child activity even when only its children changed.
+async function bumpTicketUpdatedAt(stores, ticketId, time) {
+  if (!ticketId) return;
+  const parent = await reqPromise(stores.tickets.get(ticketId));
+  if (!parent) return;
+  parent.updated_at = time;
+  stores.tickets.put(parent);
+}
+
 async function handleTicketCreate(body) {
   const db = await openDb();
   return putAndEvent(db, async (stores) => {
@@ -610,6 +625,7 @@ async function handleTicketCreate(body) {
       stores.ticket_labels.put({ key: tlKey(ticket.id, label.id), ticket_id: ticket.id, label_id: label.id });
     }
     recordEvent(stores, "ticket_created", ticket.id, { title: ticket.title, type: ticket.type });
+    await bumpTicketUpdatedAt(stores, ticket.parent_ticket_id, ticket.updated_at);
     return ticket;
   });
 }
@@ -620,6 +636,7 @@ async function handleTicketPatch(ticketId, body) {
     const ticket = await reqPromise(stores.tickets.get(ticketId));
     if (!ticket) throw err(404, "ticket_not_found");
     const oldStateId = ticket.state_id;
+    const oldParentId = ticket.parent_ticket_id;
     const SIMPLE = [
       "title",
       "description",
@@ -663,6 +680,10 @@ async function handleTicketPatch(ticketId, body) {
     } else {
       recordEvent(stores, "ticket_updated", ticketId, { fields: Object.keys(body) });
     }
+    await bumpTicketUpdatedAt(stores, oldParentId, ticket.updated_at);
+    if (ticket.parent_ticket_id && ticket.parent_ticket_id !== oldParentId) {
+      await bumpTicketUpdatedAt(stores, ticket.parent_ticket_id, ticket.updated_at);
+    }
     return ticket;
   });
 }
@@ -678,6 +699,7 @@ async function handleTicketDelete(ticketId) {
     const cmts = await getAll(stores.comments, ticketId, "ticket_id");
     for (const c of cmts) stores.comments.delete(c.id);
     recordEvent(stores, "ticket_deleted", ticketId, {});
+    await bumpTicketUpdatedAt(stores, ticket.parent_ticket_id, nowIso());
     return { ok: true };
   });
 }
@@ -691,6 +713,7 @@ async function handleTicketArchive(ticketId, archive) {
     ticket.updated_at = nowIso();
     stores.tickets.put(ticket);
     recordEvent(stores, archive ? "ticket_archived" : "ticket_restored", ticketId, {});
+    await bumpTicketUpdatedAt(stores, ticket.parent_ticket_id, ticket.updated_at);
     return ticket;
   });
 }
@@ -785,16 +808,20 @@ async function handleCommentCreate(ticketId, body) {
   return putAndEvent(db, async (stores) => {
     const ticket = await reqPromise(stores.tickets.get(ticketId));
     if (!ticket) throw err(404, "ticket_not_found");
+    const time = nowIso();
     const comment = {
       id: uid(),
       ticket_id: ticketId,
       author: "you",
       kind: body.kind || "note",
       body: body.body || "",
-      created_at: nowIso()
+      created_at: time
     };
     stores.comments.put(comment);
+    ticket.updated_at = time;
+    stores.tickets.put(ticket);
     recordEvent(stores, "comment_created", ticketId, { kind: comment.kind });
+    await bumpTicketUpdatedAt(stores, ticket.parent_ticket_id, time);
     return comment;
   });
 }

package/src/core/agent.js

@@ -24,7 +24,7 @@ import {
   requiredString
 } from "./util.js";
 import { boardManual } from "./boards.js";
-import { reindexTicket } from "./tickets.js";
+import { bumpTicketUpdatedAt, reindexTicket } from "./tickets.js";
 
 /**
  * Claim the next AI-ready ticket on the resolved board. The router/MCP layer
@@ -71,14 +71,16 @@ export function claimNext(body, ctx) {
     if (!inProgress) throw httpError(400, "missing_in_progress_state");
 
     tx(db, () => {
+      const time = now();
       db.prepare("UPDATE tickets SET state_id = ?, updated_at = ? WHERE id = ?").run(
         inProgress.id,
-        now(),
+        time,
         candidate.id
       );
       addComment(db, candidate.id, actor.name, "agent_note", "Agent claimed this ticket and is starting work.");
       recordEvent(db, candidate.board_id, "agent_claimed", candidate.id, actor.name, { agent_id: actor.id });
       reindexTicket(db, candidate.id);
+      bumpTicketUpdatedAt(db, candidate.parent_ticket_id, time);
     });
 
     return {
@@ -157,7 +159,8 @@ export function checkpointTicket(body, ctx) {
   if (!review) throw httpError(400, "missing_review_state");
   const message = requiredString(body.message, "message");
   tx(db, () => {
-    db.prepare("UPDATE tickets SET state_id = ?, updated_at = ? WHERE id = ?").run(review.id, now(), ticket.id);
+    const time = now();
+    db.prepare("UPDATE tickets SET state_id = ?, updated_at = ? WHERE id = ?").run(review.id, time, ticket.id);
     addComment(db, ticket.id, actor.name, "checkpoint", message);
     recordEvent(db, ticket.board_id, "checkpoint_requested", ticket.id, actor.name, {
       from: ticket.state_name,
@@ -167,6 +170,7 @@ export function checkpointTicket(body, ctx) {
       actor_id: actor.id
     });
     reindexTicket(db, ticket.id);
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, time);
   });
   return getContextPack(ticket.id, ctx, 1);
 }
@@ -190,10 +194,11 @@ export function completeTicket(body, ctx) {
   if (body.pr_url) lines.push(`PR: ${body.pr_url}`);
   const updates = body.updates ? appendFieldNote(ticket.implementation_updates, body.updates, actor.name) : ticket.implementation_updates;
   tx(db, () => {
+    const time = now();
     addComment(db, ticket.id, actor.name, "completion", lines.join("\n\n"));
     db.prepare(
       "UPDATE tickets SET state_id = ?, implementation_summary = ?, implementation_updates = ?, updated_at = ? WHERE id = ?"
-    ).run(nextState.id, summary, updates, now(), ticket.id);
+    ).run(nextState.id, summary, updates, time, ticket.id);
     recordEvent(db, ticket.board_id, "agent_completed", ticket.id, actor.name, {
       from: ticket.state_name,
       next_state: nextState.name,
@@ -203,6 +208,7 @@ export function completeTicket(body, ctx) {
       actor_id: actor.id
     });
     reindexTicket(db, ticket.id);
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, time);
   });
   return getContextPack(ticket.id, ctx, 1);
 }

package/src/core/bootstrap.js

@@ -105,7 +105,7 @@ export function getBootstrap(actor, requestedBoardId = null) {
        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`
+       ORDER BY t.updated_at DESC, t.id ASC`
     )
     .all()
     .filter((ticket) => boardIds.has(ticket.board_id));

package/src/core/search.js

@@ -44,13 +44,18 @@ export function searchTickets(args, ctx) {
          WHERE 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 c.body LIKE ?)
-         ORDER BY t.updated_at DESC
+         ORDER BY t.updated_at DESC, t.id ASC
          LIMIT ?`
       )
       .all(like, like, like, like, like, like, limit);
   }
 
-  rows.sort((a, b) => (a.rank !== b.rank ? a.rank - b.rank : String(b.updated_at).localeCompare(String(a.updated_at))));
+  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 = [];

package/src/core/tickets.js

@@ -17,6 +17,17 @@ import {
   requiredString
 } from "./util.js";
 
+/**
+ * Bump a ticket's `updated_at` without recording an event or touching other
+ * fields. Used to roll child activity up to the parent epic so the column sort
+ * (ORDER BY updated_at DESC) keeps the epic group near recent activity even
+ * when only its children changed. Pass `null`/undefined to no-op.
+ */
+export function bumpTicketUpdatedAt(db, ticketId, time) {
+  if (!ticketId) return;
+  db.prepare("UPDATE tickets SET updated_at = ? WHERE id = ?").run(time, ticketId);
+}
+
 export function createTicket(body, ctx) {
   const { db, board, actor } = ctx;
   // The router resolves `ctx.board` from path/body/query before we get here.
@@ -82,6 +93,7 @@ export function createTicket(body, ctx) {
       parent_ticket_id: parentTicketId
     });
     reindexTicket(db, ticketId);
+    bumpTicketUpdatedAt(db, parentTicketId, time);
     return ticketById(db, ticketId);
   });
 }
@@ -139,11 +151,12 @@ export function updateTicket(ticketId, body, ctx) {
   }
 
   return tx(db, () => {
+    const time = now();
     if (fields.length > 0) {
       const sets = fields.map((field) => `${field} = ?`);
       const values = fields.map((field) => applied[field]);
       sets.push("updated_at = ?");
-      values.push(now(), ticketId);
+      values.push(time, ticketId);
       db.prepare(`UPDATE tickets SET ${sets.join(", ")} WHERE id = ?`).run(...values);
     }
 
@@ -160,7 +173,7 @@ export function updateTicket(ticketId, body, ctx) {
         db.prepare("INSERT OR IGNORE INTO ticket_labels (ticket_id, label_id) VALUES (?, ?)").run(ticketId, label.id);
       }
       if (fields.length === 0) {
-        db.prepare("UPDATE tickets SET updated_at = ? WHERE id = ?").run(now(), ticketId);
+        db.prepare("UPDATE tickets SET updated_at = ? WHERE id = ?").run(time, ticketId);
       }
     }
 
@@ -191,6 +204,13 @@ export function updateTicket(ticketId, body, ctx) {
       }
     }
     reindexTicket(db, ticketId);
+    // Roll activity up to the parent epic so the column sort keeps the epic
+    // group near recent child activity. On reparent, bump both old and new
+    // parent — both views changed (one lost a child, the other gained one).
+    bumpTicketUpdatedAt(db, before.parent_ticket_id, time);
+    if (after.parent_ticket_id && after.parent_ticket_id !== before.parent_ticket_id) {
+      bumpTicketUpdatedAt(db, after.parent_ticket_id, time);
+    }
     return after;
   });
 }
@@ -208,6 +228,7 @@ export function archiveTicket(ticketId, ctx) {
     const time = now();
     db.prepare("UPDATE tickets SET archived_at = ?, updated_at = ? WHERE id = ?").run(time, time, ticketId);
     recordEvent(db, ticket.board_id, "ticket_archived", ticketId, actor.name, { title: ticket.title });
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, time);
     return ticketById(db, ticketId);
   });
 }
@@ -225,6 +246,7 @@ export function restoreTicket(ticketId, ctx) {
     const time = now();
     db.prepare("UPDATE tickets SET archived_at = NULL, updated_at = ? WHERE id = ?").run(time, ticketId);
     recordEvent(db, ticket.board_id, "ticket_restored", ticketId, actor.name, { title: ticket.title });
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, time);
     return ticketById(db, ticketId);
   });
 }
@@ -246,6 +268,7 @@ export function deleteTicket(ticketId, ctx) {
     });
     db.prepare("DELETE FROM ticket_fts WHERE ticket_id = ?").run(ticketId);
     db.prepare("DELETE FROM tickets WHERE id = ?").run(ticketId);
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, now());
     return { ok: true, deleted_id: ticketId };
   });
 }
@@ -262,10 +285,12 @@ export function createComment(ticketId, body, ctx) {
   const kind = body.kind || (actor.type === "agent" ? "agent_note" : "human_comment");
 
   return tx(db, () => {
+    const time = now();
     const comment = addComment(db, ticketId, author, kind, commentBody);
-    db.prepare("UPDATE tickets SET updated_at = ? WHERE id = ?").run(now(), ticketId);
+    db.prepare("UPDATE tickets SET updated_at = ? WHERE id = ?").run(time, ticketId);
     recordEvent(db, ticket.board_id, "comment_created", ticketId, actor.name, { kind: comment.kind });
     reindexTicket(db, ticketId);
+    bumpTicketUpdatedAt(db, ticket.parent_ticket_id, time);
     return comment;
   });
 }