@webinson/peer 0.4.2 → 0.4.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -24,10 +24,13 @@ In a Claude Code thread:
24
24
  - A shared thread's title starts with `● Peer · `, so it stands out in Claude Code's session list; the mark comes
25
25
  back if Claude Code renames the thread, and `/peer stop` takes it off.
26
26
  - `/peer-list` lists the shared threads by repository, then by person, with each thread's branch and
27
- state, and the threads that stopped in the last hours.
27
+ state, and the threads that stopped in the last hours. With the plugin installed it opens a `Peer` pane beside
28
+ the chat that reloads every 15 s; without it, or where no pane fits, the hook answers with the list.
28
29
 
29
- `/peer`, `/peer stop` and `/peer-list` are answered by the hook before the prompt reaches the model,
30
- so they cost no tokens. `peer list` prints the same list in a terminal.
30
+ `/peer stop` and `/peer-list` are answered by the hook before the prompt reaches the model, so they
31
+ cost no tokens. A bare `/peer` is shared by the hook too, then reaches the agent, which confirms it in a
32
+ line or two: one short turn, instead of Claude Code's "hook blocked your prompt" warning. `/peer-thread` opens a pane with what this thread saved to your own OpenViking memory, in sentences (read-only;
33
+ `peer thread <session id>` prints it). `peer list` prints the same list in a terminal; `peer list --json` gives the pane the hub's list as it came.
31
34
 
32
35
  ## What is shared
33
36
 
@@ -59,7 +62,7 @@ only the hook knows the session id. After that the hooks report that thread arou
59
62
  mark. A hook never fails or holds up a session: it gives the hub 3 seconds and drops what does not
60
63
  go through. What the hooks did, without any prompt text, is in `~/.peer/hook.log`.
61
64
 
62
- If `/peer` reaches the model ("the hook did not run"), `peer doctor` checks the sign-in, the hooks in
65
+ If the agent says the hook did not run, or `/peer stop` reaches the model, `peer doctor` checks the sign-in, the hooks in
63
66
  Claude Code's settings and the paths they run, and runs the hook the way Claude Code does. An app
64
67
  or IDE that starts Claude through the Agent SDK may not load `~/.claude/settings.json`; `claude` in
65
68
  a terminal does.
@@ -74,21 +77,34 @@ If your team runs a shared project memory (an OpenViking server, see the Peer Hu
74
77
  `deploy/team-memory/`), connect this computer once, inside the project's repository:
75
78
 
76
79
  ```bash
77
- printf '%s' "$YOUR_TEAM_KEY" | peer team connect https://memory.example.com --as <you> --project <id>
80
+ printf '%s' "$YOUR_TEAM_KEY" | peer team connect https://memory.example.com --as <you>
78
81
  ```
79
82
 
80
- The key comes on stdin and is saved in `~/.peer/team-memory/member.json` (mode 0600). After that, the first
83
+ The project is the one your Peer workspace keeps this repository in, with all of that project's repositories;
84
+ a repository in no Hub project (or without `peer login`) is a project of its own, named by its normalized
85
+ origin (`github.com-acme-shop`). `--project <id>` names another. The key comes on stdin and is saved in `~/.peer/team-memory/member.json` (mode 0600). After that, the first
81
86
  prompt of every thread in that repository (and the first after a resume or compaction) gets at most five
82
87
  teammates' published findings that match it: verified or observed, not your own, about 1,500 tokens,
83
88
  fenced as data from colleagues; a page whose paths changed in three or more commits since it was last
84
89
  confirmed comes marked "may be stale". The prompt's first 400 characters go to the team server as the search
85
90
  query. Nothing else of the thread is sent. `peer team status` shows the connection and the last recalls.
86
91
 
92
+ ## Your own memory
93
+
94
+ `/peer-all` lists what your personal OpenViking (as `~/.openviking/ovcli.conf` points to it) remembers, 20 to a
95
+ page: `/peer-all page 2`; `--newest` or `--oldest` orders it by the time a memory last changed (for an event, when it
96
+ was added). With the thread mark installed it opens a pane with a search field that searches as you type, a this-repository switch and a time
97
+ button that goes unsorted, newest first, oldest first and back. `/peer-all <words>` searches the memories' full text: every word, in
98
+ any order, anywhere in a memory, case and diacritics left aside (`pamat` finds "pamäť"); `"a phrase"` in quotes keeps
99
+ its words together; conversation archives are left out, and `here` keeps it to the current repository:
100
+ `/peer-all here batch limit`. The hook answers, so the list reaches you and never the thread or its capture.
101
+ `peer all …` prints the same in a terminal. Editing and deleting stay in OpenViking Studio.
102
+
87
103
  ## Other commands
88
104
 
89
105
  ```
90
106
  peer status who you are, the workspace and the threads this computer shares
91
- peer doctor why /peer reaches the model instead of Peer's hook
107
+ peer doctor why Peer's hook did not answer /peer
92
108
  peer team connect connect to the team's memory server (see above)
93
109
  peer team status the team server, project and the last recalls
94
110
  peer install set Claude Code up again
package/bin/peer.mjs CHANGED
@@ -34,11 +34,15 @@ const HELP = `peer: share chosen agent threads with your team
34
34
  sign in once and set up Claude Code (/peer, /peer stop, /peer-list)
35
35
  peer list people in the workspace, their shared threads and what they work on
36
36
  peer status who you are, the workspace and the threads this computer shares
37
- peer doctor why /peer reaches the model instead of Peer's hook
37
+ peer doctor why Peer's hook did not answer /peer
38
38
  peer team connect <url> --as <member> [--project <id>]
39
39
  connect to the team's memory server (your key on stdin); new threads in the
40
- project's repositories then start with teammates' published findings
40
+ project's repositories then start with teammates' published findings. The
41
+ project is the Hub project holding this repository, else the repository itself
41
42
  peer team status the team server, project and the last recalls
43
+ peer all [words] [here] [--newest | --oldest] [page N]
44
+ your own memories in your personal OpenViking, or the ones with these words
45
+ (full text); here: only this repository's. /peer-all in Claude Code
42
46
  peer install set up Claude Code again (hooks, the two commands and the thread mark)
43
47
  peer uninstall remove them from Claude Code
44
48
  peer logout forget the sign-in on this computer
@@ -242,6 +246,11 @@ async function hook(event) {
242
246
  const prompt = String(input.prompt ?? "").trim();
243
247
  const command = /^\/peer(?:\s+([\s\S]*))?$/.exec(prompt);
244
248
  const argument = command?.[1]?.trim() ?? "";
249
+ const all = /^\/peer-all(?:\s+([\s\S]*))?$/.exec(prompt);
250
+ if (all) {
251
+ const query = memoryQuery((all[1] ?? "").split(/\s+/).filter(Boolean), input.cwd || process.cwd());
252
+ return block(await memoryText(query).catch((error) => `Peer: your memories did not load (${error.message})`));
253
+ }
245
254
  if (prompt === "/peer-list") {
246
255
  let saved;
247
256
  try {
@@ -273,9 +282,11 @@ async function hook(event) {
273
282
  await report(saved, session, argument ? "working" : "idle", input.cwd).catch((error) => (hubError = error));
274
283
  const said = hubError ? `Peer: shared, but the hub did not answer yet (${hubError.message}). The next turn tries again.` : sharedText;
275
284
  const sessionTitle = retitle(input, true, what);
276
- if (!argument) return block(said, sessionTitle);
277
- log("answered /peer with a message: shared, message passed on");
278
- return answer({ hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: `${SHARED_NOTE}\n${said}`, ...(sessionTitle ? { sessionTitle } : {}) } });
285
+ // A bare /peer reaches the agent too, which confirms in one line: a block would show the person Claude
286
+ // Code's "hook blocked your prompt" warning for what went right.
287
+ const note = argument ? said : `${said}\n${ALONE_NOTE}`;
288
+ log(argument ? "answered /peer with a message: shared, message passed on" : "answered /peer: shared, the agent confirms");
289
+ return answer({ hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: `${SHARED_NOTE}\n${note}`, ...(sessionTitle ? { sessionTitle } : {}) } });
279
290
  }
280
291
  if (shared) await reportQuietly(session, "working", input.cwd);
281
292
  // Claude Code may name a thread after its first prompts; the mark goes back on, or comes off a thread
@@ -322,6 +333,10 @@ const COMMANDS = path.join(CLAUDE, "commands");
322
333
 
323
334
  // The hook's note to the model when `/peer <message>` shares a thread; peer.md looks for it.
324
335
  const SHARED_NOTE = "[Peer's hook ran]";
336
+ // Added when /peer came alone: there is no message to work on, only the confirmation, and its privacy line
337
+ // is a promise the person relies on, so it stays whole.
338
+ const ALONE_NOTE =
339
+ "The person typed /peer alone. Reply with only that confirmation, in one or two short lines in the person's language: where the thread is shared, that teammates see its repository, branch and state but never the conversation, and that /peer stop ends it. Do nothing else and use no tools.";
325
340
 
326
341
  const COMMAND_FILES = {
327
342
  "peer.md": `---
@@ -340,6 +355,14 @@ description: List the people in your Peer workspace and the agent threads they s
340
355
  Peer's hook answers this command before it reaches you, so you should not be reading it. If you are,
341
356
  the hook did not run or did not answer in time: tell the person to run \`peer doctor\` in a terminal, which says why.
342
357
  Do nothing else.
358
+ `,
359
+ "peer-all.md": `---
360
+ description: List and search what your own OpenViking memory holds (/peer-all [words] [here] [page N])
361
+ argument-hint: "[words] [here] [page N]"
362
+ ---
363
+ Peer's hook answers this command before it reaches you, so you should not be reading it. If you are,
364
+ the hook did not run or did not answer in time: tell the person to run \`peer doctor\` in a terminal, which says why.
365
+ Do nothing else.
343
366
  `,
344
367
  };
345
368
 
@@ -377,7 +400,7 @@ function install() {
377
400
  writeJson(SETTINGS, settings, 0o644);
378
401
  fs.mkdirSync(COMMANDS, { recursive: true });
379
402
  for (const [name, text] of Object.entries(COMMAND_FILES)) fs.writeFileSync(path.join(COMMANDS, name), text);
380
- console.log(`Claude Code: hooks in ${SETTINGS}, /peer and /peer-list in ${COMMANDS}. Sessions started from now on have them.`);
403
+ console.log(`Claude Code: hooks in ${SETTINGS}, /peer, /peer-list and /peer-all in ${COMMANDS}. Sessions started from now on have them.`);
381
404
  installMark();
382
405
  }
383
406
 
@@ -488,7 +511,7 @@ function status() {
488
511
  console.log(shared.length ? `Threads shared from this computer: ${shared.join(", ")}` : "No thread shared from this computer.");
489
512
  }
490
513
 
491
- // ---- peer doctor: why /peer reaches the model instead of the hook ----
514
+ // ---- peer doctor: why Peer's hook did not answer /peer ----
492
515
 
493
516
  async function doctor() {
494
517
  let problems = 0;
@@ -545,7 +568,7 @@ async function doctor() {
545
568
  }
546
569
  if (process.env.CLAUDE_CONFIG_DIR) console.log(` note CLAUDE_CONFIG_DIR=${process.env.CLAUDE_CONFIG_DIR}: Claude Code must run with the same value`);
547
570
  const commands = Object.keys(COMMAND_FILES).filter((name) => fs.existsSync(path.join(COMMANDS, name)));
548
- if (commands.length === Object.keys(COMMAND_FILES).length) ok(`/peer and /peer-list in ${COMMANDS}`);
571
+ if (commands.length === Object.keys(COMMAND_FILES).length) ok(`/peer, /peer-list and /peer-all in ${COMMANDS}`);
549
572
  else bad(`commands missing in ${COMMANDS}: run \`peer install\``);
550
573
 
551
574
  // The hook Claude Code would run, run here: a /peer-list must come back answered within Claude's limit.
@@ -571,11 +594,78 @@ async function doctor() {
571
594
  console.log(
572
595
  problems
573
596
  ? `\n${problems} thing(s) to fix. Then start a new Claude Code session.`
574
- : "\nPeer is set up here. If /peer still reaches the model, Claude Code is not loading your user settings: an app or IDE that runs Claude through the Agent SDK may ignore ~/.claude/settings.json. Start `claude` in a terminal and try /peer there.",
597
+ : "\nPeer is set up here. If the agent still says the hook did not run, Claude Code is not loading your user settings: an app or IDE that runs Claude through the Agent SDK may ignore ~/.claude/settings.json. Start `claude` in a terminal and try /peer there.",
575
598
  );
576
599
  if (problems) process.exitCode = 1;
577
600
  }
578
601
 
602
+ // ---- this thread's memories: what the person's own OpenViking kept from a Claude Code thread ----
603
+ // The OpenViking plugin stores each Claude Code thread as session `cc-<session id>`; every commit leaves a
604
+ // memory_diff.json with what it added, updated or removed. `peer thread` reads those and says them in sentences,
605
+ // with no model call. Read-only: it never changes a memory.
606
+
607
+ const OV_CONF = process.env.PEER_OV_CONF || path.join(os.homedir(), ".openviking", "ovcli.conf");
608
+
609
+ async function ovRead(ov, route) {
610
+ const response = await fetch(`${ov.url}/api/v1${route}`, {
611
+ headers: { "x-api-key": ov.api_key ?? "", "x-openviking-account": ov.account ?? "default", "x-openviking-user": ov.user ?? "" },
612
+ signal: AbortSignal.timeout(5000),
613
+ });
614
+ const value = await response.json().catch(() => ({}));
615
+ if (!response.ok || value.status !== "ok") throw new Error(value.error?.message ?? `OpenViking answered ${response.status}`);
616
+ return value.result;
617
+ }
618
+
619
+ // The memory's name in words: `entities/software_system/peer.md` is "peer", `.../autonomous_auditing.md` "autonomous auditing".
620
+ const memoryName = (uri) => path.basename(String(uri), ".md").replace(/[_-]+/g, " ");
621
+
622
+ // The sentence a memory starts with: OpenViking writes it under `# Summary`; otherwise its first line of text.
623
+ function summaryOf(text) {
624
+ const lines = String(text ?? "").split("\n").map((line) => line.trim());
625
+ const at = lines.indexOf("# Summary");
626
+ const first = (at >= 0 ? lines.slice(at + 1) : lines).find((line) => line && !line.startsWith("#"));
627
+ return (first ?? "").replace(/^[-*]\s+/, "");
628
+ }
629
+
630
+ // What an update added: the lines in `after` that `before` did not have.
631
+ function addedLines(before, after) {
632
+ const had = new Set(String(before ?? "").split("\n").map((line) => line.trim()));
633
+ return String(after ?? "").split("\n").map((line) => line.trim()).filter((line) => line && !had.has(line) && !line.startsWith("#")).map((line) => line.replace(/^[-*]\s+/, ""));
634
+ }
635
+
636
+ // Text Claude Code wrote into the turn, not the person: kept by the extraction, flagged so the person sees it.
637
+ const hasSystemText = (text) => /This is how Claude Code surfaces messages|<system-reminder>/.test(String(text ?? ""));
638
+
639
+ async function threadMemories(session) {
640
+ const ov = readJson(OV_CONF);
641
+ if (!ov?.url) return { connected: false, reason: `no OpenViking client config at ${OV_CONF}` };
642
+ const base = `viking://user/${ov.user}/sessions/cc-${session}`;
643
+ let archives;
644
+ try {
645
+ archives = await ovRead(ov, `/fs/ls?uri=${encodeURIComponent(`${base}/history`)}`);
646
+ } catch (error) {
647
+ if (/not found|no such|404/i.test(error.message)) return { connected: true, saves: [] };
648
+ throw error;
649
+ }
650
+ const saves = [];
651
+ for (const archive of archives.filter((entry) => entry.isDir)) {
652
+ let diff;
653
+ try {
654
+ diff = JSON.parse(await ovRead(ov, `/content/read?uri=${encodeURIComponent(`${archive.uri}/memory_diff.json`)}`));
655
+ } catch {
656
+ continue;
657
+ }
658
+ const ops = diff.operations ?? {};
659
+ const items = [
660
+ ...(ops.adds ?? []).map((op) => ({ change: "added", type: op.memory_type, name: memoryName(op.uri), lines: [summaryOf(op.after)], systemText: hasSystemText(op.after) })),
661
+ ...(ops.updates ?? []).map((op) => ({ change: "updated", type: op.memory_type, name: memoryName(op.uri), lines: addedLines(op.before, op.after), systemText: hasSystemText(op.after) && !hasSystemText(op.before) })),
662
+ ...(ops.deletes ?? []).map((op) => ({ change: "removed", type: op.memory_type, name: memoryName(op.uri), lines: [summaryOf(op.before)], systemText: false })),
663
+ ].map((item) => ({ ...item, name: plain(item.name), lines: item.lines.filter(Boolean).slice(0, 3).map((line) => String(line).replace(/[\u0000-\u001f\u007f-\u009f]/g, "").slice(0, 300)) }));
664
+ saves.push({ at: diff.extracted_at ?? archive.modTime, items });
665
+ }
666
+ return { connected: true, saves: saves.sort((a, b) => String(b.at).localeCompare(String(a.at))) };
667
+ }
668
+
579
669
  // ---- team memory: teammates' published project knowledge at the start of a thread ----
580
670
  // The team's OpenViking server holds pages members published for a project. `peer team connect` saves this
581
671
  // member's address and key; the hooks then add the best few teammates' pages to the first prompt of a thread
@@ -587,7 +677,10 @@ const TEAM_LOG = path.join(HOME, "team-memory", "recall.log");
587
677
 
588
678
  // OpenViking names a repository by its normalized origin URL; the team scripts do the same.
589
679
  function repositoryPeer(cwd) {
590
- const remote = git(cwd, "remote", "get-url", "origin");
680
+ return repositoryKey(git(cwd, "remote", "get-url", "origin"));
681
+ }
682
+
683
+ function repositoryKey(remote) {
591
684
  if (!remote) return "";
592
685
  return remote
593
686
  .replace(/^[a-z+]+:\/\//i, "")
@@ -610,9 +703,19 @@ async function teamCall(team, method, route, body, timeoutMs = 3000) {
610
703
  return { status: response.status, value: await response.json().catch(() => ({})) };
611
704
  }
612
705
 
706
+ // The project is the Hub's: the workspace project whose repositories include this one, with all of its
707
+ // repositories. A repository in no Hub project (or without a sign-in) is a project of its own, named by its key.
708
+ async function teamProject(repo) {
709
+ const saved = config();
710
+ if (!saved?.session || !saved?.workspace) return { project: repo, repos: [repo] };
711
+ const manifest = await call(saved, "GET", `/workspaces/${saved.workspace}/manifest`, undefined, 10000);
712
+ const keysOf = (project) => (project.repositories ?? []).map((r) => repositoryKey(r.url ?? "")).filter(Boolean);
713
+ const found = (manifest?.projects ?? []).find((project) => keysOf(project).includes(repo));
714
+ return found ? { project: found.id, repos: keysOf(found) } : { project: repo, repos: [repo] };
715
+ }
716
+
613
717
  async function teamConnect(args) {
614
718
  const member = option(args, "--as");
615
- const project = option(args, "--project") ?? "alpha";
616
719
  const repo = option(args, "--repo") ?? repositoryPeer(process.cwd());
617
720
  const url = (args[0] || "").replace(/\/+$/, "");
618
721
  if (!url || !member) throw new Error("usage: peer team connect <server-url> --as <member> [--project <id>] [--repo <id>], key on stdin");
@@ -622,11 +725,14 @@ async function teamConnect(args) {
622
725
  for await (const chunk of process.stdin) chunks.push(chunk);
623
726
  const key = Buffer.concat(chunks).toString("utf8").trim();
624
727
  if (!key) throw new Error("no key on stdin: printf '%s' \"$KEY\" | peer team connect …");
728
+ const given = option(args, "--project");
729
+ const found = given ? { project: given, repos: [repo] } : await teamProject(repo);
730
+ const { project } = found;
625
731
  const team = { url, member, key };
626
732
  const { status } = await teamCall(team, "POST", "/search/find", { query: "probe", target_uri: `viking://resources/projects/${project}`, limit: 1 }, 10000);
627
733
  if (status >= 300) throw new Error(`the team server refused ${member}'s key for project ${project} (${status})`);
628
734
  const saved = readJson(TEAM_FILE) ?? {};
629
- const repos = saved.project === project ? [...new Set([...(saved.repos ?? []), repo])] : [repo];
735
+ const repos = [...new Set([...(saved.project === project ? saved.repos ?? [] : []), ...found.repos, repo])];
630
736
  writeJson(TEAM_FILE, { url, member, project, repos, key });
631
737
  console.log(`Team memory: ${member} on ${url}, project ${project}, repositories ${repos.join(", ")}.`);
632
738
  if (readJson(SETTINGS)) install();
@@ -721,6 +827,159 @@ async function teamHook(event) {
721
827
  answer({ hookSpecificOutput: { hookEventName: "UserPromptSubmit", additionalContext: block } });
722
828
  }
723
829
 
830
+ // ---- your own memory: what your personal OpenViking remembered, listed and searched ----
831
+ // Reads the person's own OpenViking server as its CLI is configured (~/.openviking/ovcli.conf). `/peer-all` is
832
+ // answered by the hook, so the list is shown to the person and never enters the thread (nor its capture).
833
+
834
+ const MEMORY_CONF = process.env.PEER_OPENVIKING_CONF || path.join(os.homedir(), ".openviking", "ovcli.conf");
835
+ const MEMORY_PAGE = 20;
836
+
837
+ function memoryServer() {
838
+ const conf = readJson(MEMORY_CONF);
839
+ if (!conf?.url || !conf?.user) throw new Error(`no personal OpenViking configured (${MEMORY_CONF})`);
840
+ return conf;
841
+ }
842
+
843
+ async function memoryCall(conf, route, body) {
844
+ const response = await fetch(`${conf.url.replace(/\/+$/, "")}/api/v1${route}`, {
845
+ method: "POST",
846
+ headers: {
847
+ "content-type": "application/json",
848
+ ...(conf.api_key ? { "x-api-key": conf.api_key } : {}),
849
+ "x-openviking-account": conf.account || "default",
850
+ "x-openviking-user": conf.user,
851
+ },
852
+ body: JSON.stringify(body),
853
+ signal: AbortSignal.timeout(8000),
854
+ });
855
+ const value = await response.json().catch(() => ({}));
856
+ if (!response.ok) throw new Error(`${route}: ${response.status} ${plain(value?.error?.message ?? value?.detail ?? "")}`);
857
+ return value.result ?? {};
858
+ }
859
+
860
+ // viking://user/<u>/peers/<repo>/memories/<type>/… or viking://user/<u>/memories/<type>/… (global).
861
+ function memoryWhere(uri) {
862
+ const match = /^viking:\/\/user\/[^/]+\/(?:peers\/([^/]+)\/)?memories\/([^/]+)\/(.+)$/.exec(uri);
863
+ if (!match) return null;
864
+ const [, repo, type, rest] = match;
865
+ const title = rest.split("/").pop().replace(/\.md$/, "").replace(/[_-]+/g, " ");
866
+ return { repo: repo || "global", type, title };
867
+ }
868
+
869
+ const isMemoryFile = (uri) => uri.endsWith(".md") && !uri.split("/").pop().startsWith(".") && memoryWhere(uri);
870
+
871
+ // `peer all [text] [page N] [--here] [--newest | --oldest]`; the same words after /peer-all. Without a sort the
872
+ // memories come in OpenViking's own order.
873
+ function memoryQuery(words, cwd) {
874
+ const query = { text: [], page: 1, here: false, sort: "" };
875
+ for (let i = 0; i < words.length; i++) {
876
+ if (words[i] === "--here" || words[i] === "here") query.here = true;
877
+ else if (words[i] === "--newest" || words[i] === "--oldest") query.sort = words[i] === "--newest" ? "new" : "old";
878
+ else if ((words[i] === "page" || words[i] === "--page") && /^\d+$/.test(words[i + 1] ?? "")) query.page = Math.max(1, Number(words[++i]));
879
+ else query.text.push(words[i]);
880
+ }
881
+ query.text = query.text.join(" ").trim();
882
+ query.repo = query.here ? repositoryPeer(cwd) : "";
883
+ return query;
884
+ }
885
+
886
+ // Diacritics do not count: a letter matches its accented forms, so `pamat` finds "pamäť" and `pamäť` finds "pamat".
887
+ const LETTERS = { a: "aáäàâ", c: "cčç", d: "dď", e: "eéěëèê", i: "iíìî", l: "lĺľ", n: "nňñ", o: "oóôöò", r: "rŕř", s: "sš", t: "tť", u: "uúůüù", y: "yý", z: "zž" };
888
+
889
+ // The words of a search as OpenViking grep patterns: each word, or each "quoted phrase" as one, at most six.
890
+ function memoryTerms(text) {
891
+ const words = [...text.matchAll(/"([^"]+)"|(\S+)/g)].map((m) => (m[1] ?? m[2]).trim()).filter(Boolean).slice(0, 6);
892
+ return words.map((word) =>
893
+ [...word.toLowerCase()]
894
+ .map((char) => {
895
+ const base = char.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
896
+ if (LETTERS[base]) return `[${LETTERS[base]}]`;
897
+ return /\s/.test(char) ? "\\s+" : char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
898
+ })
899
+ .join(""),
900
+ );
901
+ }
902
+
903
+ // One page of the person's memories: all of them, or the files whose text has the words; each with the time it last
904
+ // changed (OpenViking keeps no other time per file), which is when an event was added.
905
+ async function memoryPage(query) {
906
+ const conf = memoryServer();
907
+ const root = `viking://user/${conf.user}`;
908
+ const scope = query.repo ? `${root}/peers/${query.repo}/memories` : root;
909
+ // The times come from the listing, so a search asks for both at once.
910
+ const listing = memoryCall(conf, "/search/glob", { pattern: "**/*.md", uri: scope, node_limit: 20000, extra_fields: ["modTime"] });
911
+ let rows;
912
+ if (query.text) {
913
+ // Every word (or "quoted phrase") must be somewhere in the memory, in any order: one grep each, then the files
914
+ // all of them hit. Lines are matched, so the words of one memory may sit on different lines.
915
+ const terms = memoryTerms(query.text);
916
+ const [files, ...found] = await Promise.all([
917
+ listing,
918
+ ...terms.map((term) =>
919
+ memoryCall(conf, "/search/grep", { uri: scope, exclude_uri: `${root}/sessions`, pattern: term, case_insensitive: true, node_limit: 2000 }),
920
+ ),
921
+ ]);
922
+ const times = new Map((files.matches ?? []).map((m) => [m.uri, m.modTime]));
923
+ const byFile = new Map();
924
+ found.forEach((result, index) => {
925
+ for (const hit of result.matches ?? []) {
926
+ if (!isMemoryFile(hit.uri)) continue;
927
+ if (!byFile.has(hit.uri)) byFile.set(hit.uri, { uri: hit.uri, at: times.get(hit.uri), lines: [], hits: new Set() });
928
+ const file = byFile.get(hit.uri);
929
+ file.hits.add(index);
930
+ const line = String(hit.content ?? "").trim();
931
+ if (!file.lines.includes(line)) file.lines.push(line);
932
+ }
933
+ });
934
+ rows = [...byFile.values()].filter((file) => file.hits.size === terms.length);
935
+ } else {
936
+ const found = await listing;
937
+ rows = (found.matches ?? []).filter((m) => !m.isDir && isMemoryFile(m.uri)).map((m) => ({ uri: m.uri, at: m.modTime }));
938
+ }
939
+ if (query.sort) rows.sort((a, b) => String(query.sort === "new" ? b.at : a.at).localeCompare(String(query.sort === "new" ? a.at : b.at)));
940
+ const pages = Math.max(1, Math.ceil(rows.length / MEMORY_PAGE));
941
+ const page = Math.min(query.page, pages);
942
+ const clean = (text, max) => String(text ?? "").replace(/[\u0000-\u001f\u007f-\u009f]/g, " ").slice(0, max);
943
+ return {
944
+ connected: true,
945
+ url: conf.url.replace(/\/+$/, ""),
946
+ text: query.text,
947
+ repo: query.repo,
948
+ sort: query.sort,
949
+ total: rows.length,
950
+ page,
951
+ pages,
952
+ rows: rows.slice((page - 1) * MEMORY_PAGE, page * MEMORY_PAGE).map((row) => {
953
+ const where = memoryWhere(row.uri);
954
+ return {
955
+ uri: clean(row.uri, 400),
956
+ repo: plain(where.repo),
957
+ type: plain(where.type),
958
+ title: plain(where.title),
959
+ at: row.at ? String(row.at).slice(0, 16).replace("T", " ") : "",
960
+ lines: (row.lines ?? []).slice(0, 2).map((line) => clean(line, 160)),
961
+ };
962
+ }),
963
+ };
964
+ }
965
+
966
+ async function memoryText(query) {
967
+ const found = await memoryPage(query);
968
+ const { page, pages } = found;
969
+ const order = { new: "newest first", old: "oldest first" }[query.sort];
970
+ const what = [query.text ? `"${plain(query.text)}"` : "all", query.repo ? `in ${query.repo}` : "", order].filter(Boolean).join(" ");
971
+ const lines = [`Your memories (${found.url}), ${what}: ${found.total} file(s), page ${page} of ${pages}`];
972
+ for (const row of found.rows) {
973
+ lines.push("", `${row.at ? `${row.at} ` : ""}${row.repo} · ${row.type} · ${row.title}`);
974
+ for (const line of row.lines) lines.push(` ${line}`);
975
+ lines.push(` ${row.uri}`);
976
+ }
977
+ if (!found.total) lines.push("", "Nothing found.");
978
+ const next = [query.text, query.here ? "here" : "", query.sort ? `--${query.sort === "new" ? "newest" : "oldest"}` : "", page < pages ? `page ${page + 1}` : ""].filter(Boolean).join(" ");
979
+ lines.push("", page < pages ? `Next: /peer-all ${next}` : "", `Search: /peer-all <words> · this repository only: /peer-all here <words> · by time: --newest or --oldest · edit or delete: OpenViking Studio, ${found.url}/studio/`);
980
+ return lines.filter((line, i, all) => line || all[i - 1]).join("\n").trim();
981
+ }
982
+
724
983
  // ---- main ----
725
984
 
726
985
  const [command, ...args] = process.argv.slice(2);
@@ -733,8 +992,28 @@ try {
733
992
  await logout();
734
993
  break;
735
994
  case "list":
736
- console.log(await listText(signedIn()));
995
+ // `--json` is for the thread-mark mod's pane: the hub's list as it came, plus who is asking.
996
+ if (args.includes("--json")) {
997
+ const saved = signedIn();
998
+ const list = await call(saved, "GET", `/workspaces/${saved.workspace}/agents`);
999
+ console.log(JSON.stringify({ ...list, you: saved.email }));
1000
+ } else console.log(await listText(signedIn()));
1001
+ break;
1002
+ case "thread": {
1003
+ // `peer thread --json <session id>` is for the thread-mark mod's pane.
1004
+ const session = args.find((arg) => !arg.startsWith("--"));
1005
+ if (!validSession(session)) throw new Error("usage: peer thread [--json] <claude code session id>");
1006
+ const memories = await threadMemories(session);
1007
+ if (args.includes("--json")) console.log(JSON.stringify(memories));
1008
+ else if (!memories.connected) console.log(`Peer: ${memories.reason}`);
1009
+ else if (!memories.saves.length) console.log("This thread has not saved anything to memory yet.");
1010
+ else
1011
+ for (const save of memories.saves) {
1012
+ console.log(save.at);
1013
+ for (const item of save.items) console.log(` ${item.change} ${item.type} "${item.name}": ${item.lines.join(" / ")}${item.systemText ? " [holds Claude Code's own text]" : ""}`);
1014
+ }
737
1015
  break;
1016
+ }
738
1017
  case "status":
739
1018
  status();
740
1019
  break;
@@ -752,6 +1031,17 @@ try {
752
1031
  // A hook never breaks the person's session: whatever goes wrong, it exits 0.
753
1032
  await (args[0]?.startsWith("team-") ? teamHook(args[0]) : hook(args[0])).catch((error) => log(`hook ${args[0]} failed: ${error?.message ?? error}`));
754
1033
  break;
1034
+ case "all": {
1035
+ // `peer all --json …` is for the thread-mark mod's pane; without a personal OpenViking it says so.
1036
+ const json = args.includes("--json");
1037
+ const query = memoryQuery(args.filter((arg) => arg !== "--json"), process.cwd());
1038
+ if (!json) console.log(await memoryText(query));
1039
+ else {
1040
+ const found = await memoryPage(query).catch((error) => ({ connected: false, reason: error.message }));
1041
+ console.log(JSON.stringify(found));
1042
+ }
1043
+ break;
1044
+ }
755
1045
  case "team":
756
1046
  if (args[0] === "connect") await teamConnect(args.slice(1));
757
1047
  else if (args[0] === "status") teamStatus();
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "peer-thread-mark",
3
- "version": "0.4.2",
4
- "description": "Marks a Claude Code thread shared with Peer (/peer) with a band above the prompt, with /peer stop and /peer start",
3
+ "version": "0.4.11",
4
+ "description": "Marks a Claude Code thread shared with Peer (/peer) with a band above the prompt, with /peer stop and /peer start; panes for /peer-list, /peer-thread and /peer-all (search your memories)",
5
5
  "license": "MIT",
6
6
  "types": "./types/index.d.ts"
7
7
  }