opencode-courier 0.8.0 → 0.9.0

package/dist/tui.js

@@ -6,7 +6,7 @@ import { Plugin } from "@opencode/plugin/tui";
 import { Rpc } from "@opencode/plugin/rpc";
 import { Schema } from "effect";
 var Count = Schema.Int.check(Schema.isGreaterThanOrEqualTo(0));
-var PART_STATUSES = ["done", "partial", "blocked", "failed", "interrupted", "stopped", "stalled", "out"];
+var PART_STATUSES = ["done", "partial", "blocked", "failed", "interrupted", "stopped", "gone", "stalled", "out"];
 var Part = Schema.Struct({
   sessionID: Schema.String,
   title: Schema.String,
@@ -29,6 +29,8 @@ var Record = Schema.Struct({
   finished: Schema.Boolean,
   recalled: Schema.optionalKey(Schema.Struct({ at: Schema.optionalKey(Schema.Number), calls: Count })),
   lesson: Schema.optionalKey(Lesson),
+  reads: Schema.optionalKey(Schema.Struct({ shown: Count, read: Count, at: Schema.Number })),
+  pinned: Schema.optionalKey(Schema.Struct({ at: Schema.Number })),
   parts: Schema.Array(Part)
 });
 var Records = Schema.Struct({
@@ -37,6 +39,7 @@ var Records = Schema.Struct({
   records: Schema.Array(Record)
 });
 var Forgotten = Schema.Struct({ outcome: Schema.Literals(["record", "lesson", "none"]) });
+var Pinned = Schema.Struct({ outcome: Schema.Literals(["pinned", "unpinned", "none"]) });
 var memoryRpc = Rpc.define({
   id: "courier-memory",
   methods: {
@@ -47,6 +50,10 @@ var memoryRpc = Rpc.define({
     forget: {
       input: Schema.toStandardSchemaV1(Schema.Struct({ sessionID: Schema.String, lesson: Schema.optionalKey(Schema.Boolean) })),
       output: Schema.toStandardSchemaV1(Forgotten)
+    },
+    pin: {
+      input: Schema.toStandardSchemaV1(Schema.Struct({ sessionID: Schema.String, pinned: Schema.Boolean })),
+      output: Schema.toStandardSchemaV1(Pinned)
     }
   },
   events: {}
@@ -57,7 +64,7 @@ var STATUSES = ["done", "partial", "blocked", "failed"];
 
 // src/memory/domain.ts
 var RETENTION_MS = 90 * 24 * 60 * 60000;
-var PART_STATUSES2 = [...STATUSES, "interrupted", "stopped", "stalled", "out"];
+var PART_STATUSES2 = [...STATUSES, "interrupted", "stopped", "gone", "stalled", "out"];
 
 // src/memory/text.ts
 function duration(ms) {
@@ -73,12 +80,13 @@ var NOTE_EMPTY = `Not noted: text is empty. Write one line, ${ONE_LINE}, or noth
 
 // src/memory/tui.tsx
 var MEMORY_COMMAND = "courier.memory";
-var MEMORY_USAGE = "/courier memory lists this project's tree records, to read or forget";
+var MEMORY_USAGE = "/courier memory lists this project's tree records, to read, pin or forget";
 var MEMORY_OFF = "Memory is off in this project: the plugin's memory option is false, so no record of a session tree is kept or listed here.";
 var NO_RECORDS = "No record of a session tree in this project: one is written as each turn in a tree ends, and kept 90 days.";
 var LESSON_LINE_MAX = 160;
 var ROW_TITLE_MAX = 46;
 var TODAY = "Today";
+var PINNED = "Pinned";
 var LESSON_ROW = 90;
 var pad = (n) => String(n).padStart(2, "0");
 var localDay = (at) => new Date(at).toDateString();
@@ -96,6 +104,7 @@ var minute = (at) => {
 var oneLine2 = (text) => text.replace(/\s+/g, " ").trim();
 var clip = (text, max) => text.length > max ? `${text.slice(0, max - 1)}\u2026` : text;
 var count = (n, noun) => `${n} ${noun}${n === 1 ? "" : "s"}`;
+var times = (n) => n === 1 ? "once" : `${n} times`;
 var money = (cost) => `$${cost.toFixed(2)}`;
 var nameOf = (record) => clip(oneLine2(record.title) || record.sessionID, 60);
 function partsCounted(parts) {
@@ -114,16 +123,21 @@ function recordTitle(record, open) {
   return `${clip(oneLine2(record.title) || record.sessionID, ROW_TITLE_MAX)}${record.sessionID === open ? " (this session)" : ""}`;
 }
 function recordCategory(record, now = Date.now()) {
+  if (record.pinned)
+    return PINNED;
   const moved = localDay(record.movedAt);
   return moved === localDay(now) ? TODAY : moved;
 }
+function readsLine(reads) {
+  return [reads.shown ? `shown ${times(reads.shown)}` : "", reads.read ? `opened ${times(reads.read)}` : ""].filter(Boolean).join(", ");
+}
 function lessonHeading(lesson) {
   const from = lesson.depth === undefined ? "" : `, from depth ${lesson.depth}`;
   return `lesson (${day(lesson.at)}${from})`;
 }
 function recordDescription(record) {
   const cost = costOf(record);
-  return [partsCounted(record.parts), duration(record.movedAt - record.startedAt), cost === undefined ? "" : money(cost), record.finished ? "" : "not finished"].filter(Boolean).join(" \xB7 ");
+  return [partsCounted(record.parts), duration(record.movedAt - record.startedAt), cost === undefined ? "" : money(cost), record.finished ? "" : "not finished", record.reads ? readsLine(record.reads) : ""].filter(Boolean).join(" \xB7 ");
 }
 function recordDetails(record) {
   return record.lesson ? [clip(`${lessonHeading(record.lesson)}: "${oneLine2(record.lesson.text)}"`, LESSON_LINE_MAX)] : [];
@@ -178,6 +192,8 @@ function detailOptions(record) {
   });
   const cost = costOf(record);
   const recalled = record.recalled ? fact("recalled", `Recalled ${count(record.recalled.calls, "time")}`, record.recalled.at === undefined ? "by a part only" : `first by the top ${minute(record.recalled.at)}`) : fact("recalled", "Not recalled");
+  const reads = record.reads ? fact("reads", `${readsLine(record.reads).replace(/^./, (first) => first.toUpperCase())}`, `by other trees' courier_recall, last ${minute(record.reads.at)}`) : fact("reads", "Never shown", "no other tree's courier_recall has listed it yet");
+  const pinned = record.pinned ? fact("pinned", "Pinned", `since ${minute(record.pinned.at)}: listed first, never swept; p unpins`) : fact("pinned", "Not pinned", "p pins it: listed first, never swept");
   const lesson = record.lesson ? [{
     title: lessonHeading(record.lesson),
     value: {
@@ -201,7 +217,7 @@ function detailOptions(record) {
     category: "Lesson",
     description: "courier_note writes one line per tree"
   }];
-  return [fact("top", `Top session ${record.sessionID}`), fact("started", `Started ${minute(record.startedAt)}`, `last moved ${minute(record.movedAt)}, ran ${duration(record.movedAt - record.startedAt)}`), fact("split", clip(oneLine2(record.split), 160)), fact("finished", record.finished ? "Finished" : "Not finished", cost === undefined ? undefined : `${money(cost)} in all`), recalled, ...record.parts.length ? record.parts.map((part) => ({
+  return [fact("top", `Top session ${record.sessionID}`), fact("started", `Started ${minute(record.startedAt)}`, `last moved ${minute(record.movedAt)}, ran ${duration(record.movedAt - record.startedAt)}`), fact("split", clip(oneLine2(record.split), 160)), fact("finished", record.finished ? "Finished" : "Not finished", cost === undefined ? undefined : `${money(cost)} in all`), recalled, reads, pinned, ...record.parts.length ? record.parts.map((part) => ({
     title: `${"  ".repeat(Math.max(0, part.depth - 1))}${clip(oneLine2(part.title) || part.sessionID, 60)}`,
     value: {
       kind: "part",
@@ -233,6 +249,14 @@ function forgottenLine(record, outcome) {
     return `Forgot the lesson of ${name}; its facts stay`;
   return `Nothing to forget for ${name}: it was already gone`;
 }
+function pinnedLine(record, outcome) {
+  const name = `"${nameOf(record)}"`;
+  if (outcome === "pinned")
+    return `Pinned ${name}: listed first, never swept`;
+  if (outcome === "unpinned")
+    return `Unpinned ${name}: kept as the others are`;
+  return `Nothing to pin for ${name}: it was already gone`;
+}
 function addMemoryView(ctx) {
   const memory = ctx.client.rpc(memoryRpc);
   const openSession = () => {
@@ -258,7 +282,7 @@ function addMemoryView(ctx) {
     message,
     variant: "info"
   });
-  function show(options, chosen, forget) {
+  function show(options, chosen, forget, pin) {
     let request = () => {
       return;
     };
@@ -271,6 +295,10 @@ function addMemoryView(ctx) {
         bind: "x",
         title: "forget",
         onTrigger: (value) => request(forget(value))
+      }, {
+        bind: "p",
+        title: pin.title,
+        onTrigger: (value) => request(pin.ask(value))
       }]
     });
     ctx.ui.dialog.set({
@@ -303,7 +331,13 @@ function addMemoryView(ctx) {
       kind: "forget",
       record,
       lesson: false
-    }));
+    }), {
+      title: "pin",
+      ask: (record) => ({
+        kind: "pin",
+        record
+      })
+    });
   };
   const showRecord = (record, current) => show({
     title: `${localDay(record.movedAt)}  ${nameOf(record)}`,
@@ -319,7 +353,32 @@ function addMemoryView(ctx) {
     record,
     lesson: line.kind === "lesson",
     line
-  }));
+  }), {
+    title: record.pinned ? "unpin" : "pin",
+    ask: (line) => ({
+      kind: "pin",
+      record,
+      line
+    })
+  });
+  async function togglePin(record) {
+    const pinned = !record.pinned;
+    try {
+      const result = await memory.pin({
+        sessionID: record.sessionID,
+        pinned
+      }, {
+        location: where()
+      });
+      ctx.ui.toast.show({
+        title: "courier",
+        message: pinnedLine(record, result.outcome),
+        variant: result.outcome === "none" ? "warning" : "success"
+      });
+    } catch (error) {
+      fail(pinned ? "Not pinned" : "Not unpinned")(error);
+    }
+  }
   async function confirmForget(record, lesson) {
     const confirmed = await ctx.ui.dialog.confirm({
       title: lesson ? "Forget lesson" : "Forget record",
@@ -386,6 +445,12 @@ function addMemoryView(ctx) {
           viewing = request.record.sessionID;
           continue;
         }
+        if (request.kind === "pin") {
+          await togglePin(request.record);
+          near = [request.record.sessionID];
+          line = request.line;
+          continue;
+        }
         const forgotten = await confirmForget(request.record, request.lesson);
         near = nearby(listed, request.record.sessionID, forgotten && !request.lesson);
         if (record && !forgotten)
@@ -404,7 +469,7 @@ function addMemoryView(ctx) {
     commands: [{
       id: MEMORY_COMMAND,
       title: "Courier: memory",
-      description: "The records of this project's session trees, newest first under the day each last moved: enter for one in full, x to forget one or its lesson",
+      description: "The records of this project's session trees, pinned first, then newest first under the day each last moved: enter for one in full, p to pin or unpin one, x to forget one or its lesson",
       group: "Courier",
       palette: true,
       run: () => void open()
@@ -1295,7 +1360,7 @@ function digby(rise, { top = 6, eyes = "open", slump = false, shift = 0, mound =
     span(head + 2, 8, "k", (column) => !eyeColumns.includes(column), lean(2));
   span(head + 4, 2, "a", undefined, lean(4));
   span(10, SIZE, ".", (column) => column >= 6 && column <= 9);
-  span(10, top, mound, (column) => column >= 6 && column <= 9, shift);
+  span(10, top, mound, (column) => column + shift >= 6 && column + shift <= 9, shift);
   span(11, 10, mound, undefined, shift);
   span(12, 12, mound, undefined, shift);
   for (const row of [13, 14, 15])
@@ -1958,6 +2023,7 @@ var digbyColours = (theme) => ({
   e: theme.text.feedback.error.base,
   s: theme.text.feedback.success.base
 });
+var DIGBY_UNDER = RGBA.fromValues(0, 0, 0, 0);
 function restBackground(theme, {
   selected,
   hovered
@@ -2200,7 +2266,7 @@ function TreePanel(props) {
         _$insert(_el$5, () => one().char);
         _$effect((_$p) => _$setProp(_el$5, "style", {
           fg: one().fg && tokens[one().fg],
-          bg: one().bg && tokens[one().bg]
+          bg: one().bg ? tokens[one().bg] : DIGBY_UNDER
         }, _$p));
         return _el$5;
       })()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-courier",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Multi-session orchestration for OpenCode V2: spawn child sessions, be woken by them. No polling.",
   "license": "MIT",
   "author": "Ivo Pogace <71701666+ivopogace@users.noreply.github.com>",