@uiid/bertrand 0.10.1 → 0.11.0

package/README.md

@@ -195,6 +195,17 @@ bun run db:migrate      # Apply migrations to ~/.bertrand/bertrand.db
 
 The dashboard has its own `tsc -b` typecheck — run from `dashboard/`.
 
+## Releasing
+
+Releases are driven by [release-please](https://github.com/googleapis/release-please) from conventional commits on `main`.
+
+1. Land commits in conventional format (`feat:`, `fix:`, `refactor:`, etc.). Hidden types — `chore`, `docs`, `test`, `ci` — don't trigger a release.
+2. The `Release Please` workflow opens or updates a release PR with the next version + `CHANGELOG.md` entries.
+3. Merging the release PR creates the git tag and a GitHub Release.
+4. The same workflow then publishes to npm with provenance (typecheck + tests run first).
+
+The `.release-please-manifest.json` file tracks the last released version; release-please updates it automatically. Publishing relies on the `NPM_TOKEN` repo secret (npm Automation token).
+
 ## License
 
 MIT

package/dist/bertrand.js

@@ -358,6 +358,24 @@ function getEventsBySession(sessionId) {
 function getEventsByType(sessionId, eventType) {
   return getDb().select().from(events).where(and2(eq2(events.sessionId, sessionId), eq2(events.event, eventType))).orderBy(events.createdAt).all();
 }
+function getLatestRecaps() {
+  const rows = getDb().select({
+    sessionId: events.sessionId,
+    meta: events.meta,
+    createdAt: events.createdAt
+  }).from(events).where(eq2(events.event, "session.recap")).orderBy(desc(events.createdAt)).all();
+  const result = {};
+  for (const row of rows) {
+    if (result[row.sessionId])
+      continue;
+    const meta = row.meta;
+    const recap = typeof meta?.recap === "string" ? meta.recap : null;
+    if (!recap)
+      continue;
+    result[row.sessionId] = { recap, createdAt: row.createdAt };
+  }
+  return result;
+}
 var init_events = __esm(() => {
   init_client();
   init_schema();
@@ -650,12 +668,14 @@ function summarize(text2) {
   const trimmed = firstLine.trim();
   return trimmed.length > 80 ? `${trimmed.slice(0, 77)}...` : trimmed;
 }
+var RECAP_TAG_RE;
 var init_assistant_message = __esm(() => {
   init_router();
   init_sessions();
   init_conversations();
   init_events();
   init_transcript();
+  RECAP_TAG_RE = /<recap>[\s\S]*?<\/recap>/gi;
   register("assistant-message", async (args) => {
     let sessionId = "";
     let transcriptPath = "";
@@ -686,15 +706,16 @@ var init_assistant_message = __esm(() => {
     const turn = getLatestAssistantTurn(transcriptPath);
     if (!turn)
       return;
+    const text2 = turn.text.replace(RECAP_TAG_RE, "").trim();
     const convoId = conversationId && getConversation(conversationId) ? conversationId : undefined;
     insertEvent({
       sessionId,
       conversationId: convoId,
       event: "assistant.message",
-      summary: turn.text ? summarize(turn.text) : "thinking only",
+      summary: text2 ? summarize(text2) : "thinking only",
       meta: {
         model: turn.model,
-        text: turn.text,
+        text: text2,
         thinkingBlocks: turn.thinkingBlocks,
         thinkingBytes: turn.thinkingBytes,
         claude_id: convoId
@@ -703,6 +724,58 @@ var init_assistant_message = __esm(() => {
   });
 });
 
+// src/cli/commands/recap-thinking.ts
+var exports_recap_thinking = {};
+var RECAP_RE;
+var init_recap_thinking = __esm(() => {
+  init_router();
+  init_sessions();
+  init_conversations();
+  init_events();
+  init_transcript();
+  RECAP_RE = /<recap>([\s\S]*?)<\/recap>/i;
+  register("recap-thinking", async (args) => {
+    let sessionId = "";
+    let transcriptPath = "";
+    let conversationId = "";
+    for (let i = 0;i < args.length; i++) {
+      const arg = args[i];
+      const next = args[i + 1];
+      if (arg === "--session-id" && next) {
+        sessionId = next;
+        i++;
+      } else if (arg === "--transcript-path" && next) {
+        transcriptPath = next;
+        i++;
+      } else if (arg === "--conversation-id" && next) {
+        conversationId = next;
+        i++;
+      }
+    }
+    if (!sessionId || !transcriptPath) {
+      console.error("Usage: bertrand recap-thinking --session-id <id> --transcript-path <path> [--conversation-id <id>]");
+      process.exit(1);
+    }
+    if (!getSession(sessionId))
+      return;
+    const turn = getLatestAssistantTurn(transcriptPath);
+    if (!turn?.text)
+      return;
+    const match = turn.text.match(RECAP_RE);
+    const recap = match?.[1]?.trim();
+    if (!recap)
+      return;
+    const convoId = conversationId && getConversation(conversationId) ? conversationId : undefined;
+    insertEvent({
+      sessionId,
+      conversationId: convoId,
+      event: "assistant.recap",
+      summary: recap.length > 80 ? `${recap.slice(0, 77)}...` : recap,
+      meta: { recap, claude_id: convoId }
+    });
+  });
+});
+
 // src/terminal/wave.ts
 import { execSync } from "child_process";
 
@@ -1139,6 +1212,21 @@ var init_server = __esm(() => {
         return getEventsByType(sessionId, eventType);
       return getEventsBySession(sessionId);
     }],
+    [/^\/api\/stats$/, () => {
+      const all = getAllSessions();
+      const now = new Date().toISOString();
+      const result = {};
+      for (const { session } of all) {
+        const isLive = session.status === "active" || session.status === "waiting";
+        if (isLive) {
+          result[session.id] = { sessionId: session.id, ...computeSessionStats(session.id), updatedAt: now };
+          continue;
+        }
+        const stored = getSessionStats(session.id);
+        result[session.id] = stored ?? { sessionId: session.id, ...computeSessionStats(session.id), updatedAt: now };
+      }
+      return result;
+    }],
     [/^\/api\/stats\/(?<sessionId>[^/]+)$/, ({ sessionId }) => {
       const session = getSession(sessionId);
       if (!session)
@@ -1154,6 +1242,9 @@ var init_server = __esm(() => {
     }],
     [/^\/api\/engagement\/(?<sessionId>[^/]+)$/, ({ sessionId }) => {
       return computeEngagementStats(sessionId);
+    }],
+    [/^\/api\/recaps$/, () => {
+      return getLatestRecaps();
     }]
   ];
 });
@@ -1216,6 +1307,29 @@ var init_groups = __esm(() => {
   init_id();
 });
 
+// src/db/queries/labels.ts
+import { eq as eq7, and as and4 } from "drizzle-orm";
+function createLabel(opts) {
+  return getDb().insert(labels).values({ id: createId(), ...opts }).returning().get();
+}
+function getLabelByName(name) {
+  return getDb().select().from(labels).where(eq7(labels.name, name)).get();
+}
+function getOrCreateLabelByName(name) {
+  const existing = getLabelByName(name);
+  if (existing)
+    return existing;
+  return createLabel({ name });
+}
+function addLabelToSession(sessionId, labelId) {
+  return getDb().insert(sessionLabels).values({ sessionId, labelId }).onConflictDoNothing().returning().get();
+}
+var init_labels = __esm(() => {
+  init_client();
+  init_schema();
+  init_id();
+});
+
 // src/contract/template.md
 var template_default = `You are running inside bertrand, session: {sessionName}. Follow these rules strictly:
 
@@ -1228,6 +1342,8 @@ If the user's most recent answer to AskUserQuestion was "Done for now" (or conta
 Every option must be a concrete, actionable next step. No filler like "Have questions?" or "Want to learn more?" \u2014 if clarification is needed, phrase it as a specific action: "Discuss tradeoffs of X vs Y".
 
 Every AskUserQuestion call MUST use multiSelect: true. No exceptions. Single-select fires on Enter with no confirmation, which causes accidental selections when a block gains focus. multiSelect requires explicit confirmation before submitting.
+
+Before each AskUserQuestion call, emit a \`<recap>...</recap>\` block in your text output. Use markdown \u2014 a short bullet list is usually the most scannable shape; a single short paragraph is fine when the turn was one cohesive thing. Keep it concise. The recap covers what happened since the previous AskUserQuestion (or session start) \u2014 what you found, decided, or did. Write the gist for someone reading the session timeline, not a process log. The dashboard renders these between AskUserQuestion events; do not use this tag for any other purpose.
 `;
 var init_template = () => {};
 
@@ -1385,6 +1501,10 @@ async function launch(opts) {
     slug: opts.slug,
     name: opts.name ?? opts.slug
   });
+  for (const name of opts.labelNames ?? []) {
+    const label = getOrCreateLabelByName(name);
+    addLabelToSession(session.id, label.id);
+  }
   const claudeId = randomUUID();
   const conversation = createConversation({
     id: claudeId,
@@ -1471,6 +1591,7 @@ var init_session = __esm(() => {
   init_conversations();
   init_events();
   init_groups();
+  init_labels();
   init_template2();
   init_context();
   init_process();
@@ -1707,6 +1828,7 @@ ${BIN} update --session-id "$sid" --event session.waiting --meta "$(jq -n --arg
 tpath="$(printf '%s' "$input" | grep -o '"transcript_path":"[^"]*"' | cut -d'"' -f4)"
 if [ -n "$tpath" ]; then
   ${BIN} snapshot --session-id "$sid" --transcript-path "$tpath" --conversation-id "$cid" &
+  ${BIN} recap-thinking --session-id "$sid" --transcript-path "$tpath" --conversation-id "$cid" &
 fi
 
 # Badge + notify in background \u2014 terminal UI doesn't need to block Claude
@@ -2944,6 +3066,7 @@ var hotPath = {
   update: () => Promise.resolve().then(() => (init_update(), exports_update)),
   snapshot: () => Promise.resolve().then(() => (init_snapshot(), exports_snapshot)),
   "assistant-message": () => Promise.resolve().then(() => (init_assistant_message(), exports_assistant_message)),
+  "recap-thinking": () => Promise.resolve().then(() => (init_recap_thinking(), exports_recap_thinking)),
   badge: () => Promise.resolve().then(() => (init_badge(), exports_badge)),
   notify: () => Promise.resolve().then(() => (init_notify(), exports_notify)),
   serve: () => Promise.resolve().then(() => (init_serve(), exports_serve))
@@ -2962,6 +3085,7 @@ if (command && command in hotPath) {
     Promise.resolve().then(() => (init_update(), exports_update)),
     Promise.resolve().then(() => (init_snapshot(), exports_snapshot)),
     Promise.resolve().then(() => (init_assistant_message(), exports_assistant_message)),
+    Promise.resolve().then(() => (init_recap_thinking(), exports_recap_thinking)),
     Promise.resolve().then(() => (init_serve(), exports_serve)),
     Promise.resolve().then(() => (init_badge(), exports_badge)),
     Promise.resolve().then(() => (init_notify(), exports_notify))