ente-cli 0.4.62 → 0.4.64

package/README.md

@@ -131,7 +131,7 @@ Every command supports `--json`. Run `ente --help` or `ente <group> --help`.
 |---|---|
 | `auth` | `pair`, `login`, `status`, `logout`, `profiles` |
 | `entity` | `list`, `create`, `get`, `update` (`--name`, `--tag`, `--description`), `rename`, `archive`, `restore` (`--share-parents` plus the returned grant fingerprint), `pin` (`--role`, optional confirmed parent grants), `unpin`, `add-to-space`, `remove-from-space` (`--remove-from-activities` optional) |
-| `activity` | `list`, `create`, `search`, `get`, `update`, `delete`, `restore`, `message add`, `attachment upload` |
+| `activity` | `list`, `create`, `search`, `get`, `transcript` (`--grep`, `--context`), `update`, `delete`, `restore`, `message add`, `attachment upload` |
 | `agenda` | `create-point`, `link-task` |
 | `task` | `list`, `get`, `create`, `update`, `done`, `assign`, `unassign`, `set-assignees`, `clear-assignees` |
 | `pins` | `list` |

package/dist/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: m:ente-cli
 description: "Cli: drives the ente CRM and knowledge graph over its Convex API as the signed-in user — entities (people, organisations, projects, topics, places, objects), activities (notes, calls, meetings, tasks), relationships, spaces, full-text and AI-backed search, agent threads and mail, plus Excalidraw canvas prototypes. Use when context about a person, an organisation or a meeting has to be stored, looked up or updated from the shell. Not for splitting shared costs, which is schnorrer-cli."
-when_to_use: "Remembering what was said in a call or meeting; looking up open tasks, deadlines or follow-ups for a person or project; creating or renaming an entity and pinning it to a parent; linking an activity to several entities or moving it between spaces; asking a question over the whole graph and getting citations; reviewing the voice-recording prompt or debugging a failed recording; sending a notification mail or an agent-inbox reply; posting to the in-app feedback board; managing Excalidraw canvas HTML prototypes on an entity board."
+when_to_use: "Remembering what was said in a call or meeting, including reading or searching the transcript of the recording behind an activity; looking up open tasks, deadlines or follow-ups for a person or project; creating or renaming an entity and pinning it to a parent; linking an activity to several entities or moving it between spaces; asking a question over the whole graph and getting citations; reviewing the voice-recording prompt or debugging a failed recording; sending a notification mail or an agent-inbox reply; posting to the in-app feedback board; managing Excalidraw canvas HTML prototypes on an entity board."
 metadata:
   short-description: Relationship memory through ente
 ---
@@ -132,6 +132,7 @@ ente activity list [--entity "Jane"] [--type note|conversation|meeting|call|mess
 ente activity create --type meeting --title "Call with Jane" --entity "Jane Doe" --entity "Acme Corp" --space "Work" [--content "…"] [--content-file ./notes.md] [--auto-link --entity-space-grant-fingerprint <token>] [--json]
 ente activity search "quarterly review" [--entity "Acme"] [--type meeting] [--limit 10] [--json]
 ente activity get <activityId> [--json]                # complete detail: body, full nested agenda, messages/replies, entities, attachments
+ente activity transcript <activityId> [--grep "Preis"] [--context 2] [--recording <id>] [--json]   # transcript of the recording behind it
 ente activity update <activityId> [--title "…"] [--content "…"] [--entity-add "Bob"] [--entity-remove "Carol"] [--agent-assignee <agentId> ... | --clear-agent-assignees] [--json]
 ente activity content read <activityId> [--cursor <cursor> --expected-version <version>] [--max-blocks 20] [--max-characters 12000] [--json]
 ente activity content edit <activityId> --expected-version <version> --operations-file ./operations.json [--json]
@@ -285,6 +286,32 @@ board is already dense. The create result includes `reviewPath`. Update and dele
 read and fail on a concurrent human edit. These remote scene changes sync into open boards, but do
 not enter another browser's local undo stack.
 
+### Recording transcripts — check them when something is unclear
+
+Activities, notes and summaries made from a recording keep only what the
+recording agent chose to keep. **When a note, summary, task or meeting record is
+unclear, contradictory or lacks a detail you need (an amount, a date, who said
+what, the reason for a decision), deliberately read the transcript before you
+answer or act** — do not guess from the summary.
+
+```bash
+ente activity transcript <activityId>                         # every recording that created or changed it, full transcript
+ente activity transcript <activityId> --grep "Rechnung" --context 3   # only the passages around a term
+```
+
+- Finds recordings through the agent runs that created or changed the activity; an
+  activity made by hand, or by a recording processed outside Ente, has none.
+- Your own recordings are readable as long as what they wrote lies in spaces your
+  agent key may read. Another member's recording is readable only when
+  **everything it wrote** (activities, entities, agenda points, pins) lies in spaces
+  you are a member of and your agent key may read; mail, calendar or space-move
+  tools withhold it. Otherwise
+  it is listed with the reason (`outside_reader_spaces`, `untraceable_tool` for mail,
+  calendar or space moves, `processing`, …) and no text.
+- `--grep` matches case-insensitively by sentence or line. `--json` returns per
+  recording either `transcript`, or with `--grep` `transcript: null` plus `matches`
+  (lists of passages). At most the 5 newest recordings are listed.
+
 ### Recording (voice) pipeline
 
 ```bash
@@ -371,6 +398,7 @@ ente feedback status <feedbackId> <status>               # move to a board colum
 5. **Operate** — entity/activity/task CRUD (prefer `--json` for parsing).
 6. **Link precisely** — link independently central entities, prefer specific children, and omit ancestors that are implied by hierarchy.
 7. **Confirm** — re-run the relevant list/get after writes to verify.
+8. **Unclear? Read the source** — if an activity from a recording leaves a question open, run `ente activity transcript <activityId> --grep <term>` before answering.
 
 ---
 

package/dist/cli.mjs

@@ -3711,7 +3711,7 @@ function warn(opts, latest) {
 }
 
 // ente/version.ts
-var VERSION = "0.4.62";
+var VERSION = "0.4.64";
 
 // ente/branding.ts
 var NPM_REGISTRY = "https://registry.npmjs.org";
@@ -13013,6 +13013,97 @@ var ACTIVITY_COMMANDS = [
   ActivityAttachmentUpload
 ];
 
+// ente/commands/activityTranscript.ts
+var listForActivity = makeFunctionReference(
+  "recordingTranscripts:listForActivity"
+);
+var getForActivity = makeFunctionReference("recordingTranscripts:getForActivity");
+var WITHHELD_TEXT = {
+  processing: "still being processed",
+  external_recipient: "processed by an external recipient, so its writes cannot be traced",
+  no_traceable_writes: "its writes cannot be traced",
+  untraceable_tool: "it used a tool whose effect cannot be traced",
+  outside_reader_spaces: "it also wrote into spaces you are not a member of",
+  too_large: "too many runs or messages to check"
+};
+function transcriptPassages(transcript) {
+  return transcript.split(/\n+|(?<=[.!?])\s+/u).map((passage) => passage.trim()).filter((passage) => passage.length > 0);
+}
+function grepTranscript(transcript, term, context) {
+  const passages = transcriptPassages(transcript);
+  const needle = term.toLocaleLowerCase();
+  const windows = [];
+  passages.forEach((passage, index) => {
+    if (!passage.toLocaleLowerCase().includes(needle)) return;
+    const start = Math.max(0, index - context);
+    const end = Math.min(passages.length - 1, index + context);
+    const last = windows.at(-1);
+    if (last && start <= last[1] + 1) last[1] = end;
+    else windows.push([start, end]);
+  });
+  return windows.map(([start, end]) => passages.slice(start, end + 1));
+}
+function heading(summary) {
+  const date = new Date(summary.createdAt).toLocaleString("de-DE", { timeZone: "Europe/Berlin" });
+  const who = summary.own ? "you" : summary.createdByName ?? "another member";
+  return `Recording ${summary.recordingId} \xB7 ${summary.title ?? "untitled"} \xB7 ${date} \xB7 by ${who} \xB7 ${summary.operations.join("/")} this activity`;
+}
+var ActivityTranscript = class extends ProfileCommand {
+  static paths = [["activity", "transcript"]];
+  static usage = Command.Usage({
+    category: "Activity",
+    description: "Read or search the transcript of the recording behind an activity",
+    details: `
+      Lists the recordings whose processing created or changed the activity and prints their
+      transcripts. Use it whenever a note, summary or task is unclear or lacks detail: the
+      transcript holds what the recording agent left out.
+
+      You can read your own recordings within the spaces your agent key may read. Another
+      member's recording is readable only when everything it wrote is in spaces you are a
+      member of; otherwise it is listed with the reason, without title or text.
+    `,
+    examples: [
+      ["Print the transcript", "ente activity transcript <activityId>"],
+      ["Find what was said about a price", "ente activity transcript <activityId> --grep Preis --context 3"]
+    ]
+  });
+  activityId = options_exports.String({ required: true, name: "activityId" });
+  recording = options_exports.String("--recording", { description: "Only this recording ID" });
+  grep = options_exports.String("--grep", { description: "Print only passages containing this text (case-insensitive)" });
+  contextPassages = options_exports.String("--context", "2", { description: "Passages around each --grep hit (default 2)" });
+  async run() {
+    const context = Number(this.contextPassages);
+    if (!/^\d+$/u.test(this.contextPassages)) throw new Error("--context must be a whole number \u2265 0");
+    if (this.grep !== void 0 && this.grep.trim() === "") throw new Error("--grep needs a search term");
+    const caller = await resolveCaller();
+    const summaries = (await caller.query(listForActivity, { activityId: this.activityId })).filter((summary) => !this.recording || summary.recordingId === this.recording);
+    if (this.recording && summaries.length === 0) {
+      throw new Error(`Recording ${this.recording} did not create or change activity ${this.activityId}`);
+    }
+    const results = [];
+    for (const summary of summaries) {
+      const transcript = summary.readable ? (await caller.query(getForActivity, { activityId: this.activityId, recordingId: summary.recordingId })).transcript : null;
+      const matches = transcript !== null && this.grep !== void 0 ? grepTranscript(transcript, this.grep, context) : void 0;
+      results.push({ ...summary, transcript: matches === void 0 ? transcript : null, ...matches ? { matches } : {} });
+    }
+    this.emitText({ data: results }, () => {
+      if (results.length === 0) return "No recording created or changed this activity.";
+      return results.map((result) => {
+        const lines = [heading(result)];
+        if (!result.readable) {
+          lines.push(`Transcript withheld: ${WITHHELD_TEXT[result.withheldReason ?? "no_traceable_writes"]}${result.withheldDetail ? ` (${result.withheldDetail})` : ""}.`);
+        } else if (result.matches) {
+          lines.push(result.matches.length === 0 ? `No passage mentions "${this.grep}".` : result.matches.map((passages) => passages.join(" ")).join("\n\u2026\n"));
+        } else {
+          lines.push(result.transcript ?? "No transcript yet.");
+        }
+        return lines.join("\n");
+      }).join("\n\n");
+    });
+  }
+};
+var ACTIVITY_TRANSCRIPT_COMMANDS = [ActivityTranscript];
+
 // ente/deadline.ts
 var DEFAULT_HOUR = 22;
 var DEFAULT_MINUTE = 0;
@@ -15758,6 +15849,7 @@ Commands:
   ente notification send       Email your own Ente account (text, HTML, and images)
   ente activity create|list|get|update|delete|restore
   ente activity content read|edit
+  ente activity transcript <activityId> [--grep <text>]   Transcript behind an activity \u2014 read it when a note or summary is unclear
   ente agenda create-point|link-task
   ente activity message add <activityId> --content "..."
   ente activity attachment upload <activityId> <file>
@@ -16837,6 +16929,7 @@ for (const Cmd of [
   ...AUTH_COMMANDS,
   ...ENTITY_COMMANDS,
   ...ACTIVITY_COMMANDS,
+  ...ACTIVITY_TRANSCRIPT_COMMANDS,
   ...TASK_COMMANDS,
   ...LIST_COMMANDS,
   ...USERS_COMMANDS,