@webinson/peer 0.4.30 → 0.4.32

package/README.md

@@ -215,7 +215,8 @@ query. Nothing else of the thread is sent. `peer team status` shows the connecti
 
 In a shared thread, an edit of a file a teammate's page names in its `paths` also tells the agent about that page,
 right after the edit: at most three pages an edit and five a thread, each once, the page about the file itself
-before one about a folder above it, never your own page and never a hypothesis. Peer writes the note's provenance
+before one about a folder above it, never your own page and never a hypothesis; a page that names only a
+top-level folder (`cli/`) comes with the prompt, not after an edit. Peer writes the note's provenance
 (whose agent wrote it, its status, the date it was last confirmed, which path it is about, "may be stale") and fences
 the page's first lines as data. The edit asks the team server nothing: it reads a local list of the project's pages
 by path (`~/.peer/team-memory/index-<project>.json`), which the prompt hook refreshes in the background at most every

package/bin/codex-thread-mark.mjs

@@ -234,10 +234,16 @@ async function collideHook(input, session, peer) {
   // PEER_SESSION_TOKEN: Claude Code sessions near the app pass it on to every terminal started from them.
   if (process.env.PEER_RUN) return;
   if (!peer.readJson(peer.markerOf(session))) return;
-  const state = collideState(peer, session);
-  if (state.read().breaker) return;
   const files = patchPaths(input.tool_input?.command ?? input.tool_input);
   if (!files.length) return;
+  // A teammate's page about the files comes from the local index, so it is told even when the Hub is not asked.
+  let knowledge;
+  try {
+    knowledge = peer.teamNotesAt?.({ session, cwd: input.cwd || process.cwd(), files });
+  } catch {}
+  const notesOnly = knowledge ? { hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: knowledge } } : undefined;
+  const state = collideState(peer, session);
+  if (state.read().breaker) return notesOnly;
   const results = await peer.collidePaths({
     session,
     hubSession: session,
@@ -248,7 +254,7 @@ async function collideHook(input, session, peer) {
   });
   if (results.some((result) => result.reason === "hub-timeout")) {
     state.update((now) => ({ ...now, breaker: true }));
-    return;
+    return notesOnly;
   }
   // A path is news when the set of other people on it differs from the set named last time.
   const others = (result) => [...new Set((result.people ?? []).filter((person) => !person.own).map((person) => person.email.toLowerCase()))].sort().join(" ");
@@ -260,10 +266,6 @@ async function collideHook(input, session, peer) {
     return { ...now, shown };
   });
   const sentence = peer.collisionSentence(fresh);
-  let knowledge;
-  try {
-    knowledge = peer.teamNotesAt?.({ session, cwd: input.cwd || process.cwd(), files });
-  } catch {}
   const told = [sentence, knowledge].filter(Boolean).join("\n");
   if (!told) return;
   return { hookSpecificOutput: { hookEventName: "PostToolUse", additionalContext: told } };

package/bin/peer.mjs

@@ -1139,7 +1139,8 @@ async function teamHook(event, input) {
   const query = `${prompt.slice(0, 400)}${branch && branch !== "HEAD" ? ` (branch ${branch})` : ""}`;
   const search = async (target) =>
     ((await teamCall(team, "POST", "/search/find", { query, target_uri: target, limit: 10 })).value.result?.resources ?? [])
-      .filter((hit) => hit.score >= 0.7 && hit.uri.endsWith(".md"));
+      // A folder's own summary (.abstract.md, .overview.md) is no page; an empty knowledge/ returns only that.
+      .filter((hit) => hit.score >= 0.7 && hit.uri.endsWith(".md") && !hit.uri.split("/").pop().startsWith("."));
   let hits = await search(`${root}/knowledge`);
   if (!hits.length) hits = await search(`${root}/inputs`);
 
@@ -1197,7 +1198,7 @@ function teamPageFields(text) {
   const [, kind, status, author] = meta;
   const contributors = (text.match(/^contributors: (.+)$/m)?.[1] ?? author).split(/,\s*/).filter(Boolean);
   const paths = (text.match(/^paths: (.+)$/m)?.[1] ?? "").split(/,\s*/).map((p) => p.trim()).filter((p) => p && !p.includes("..") && !p.startsWith("/"));
-  const title = plain(text.match(/^# (.+)$/m)?.[1] ?? "");
+  const title = String(text.match(/^# (.+)$/m)?.[1] ?? "").replace(/[\u0000-\u001f\u007f-\u009f]/g, "").slice(0, 240);
   const date = text.match(/last_confirmed: (\d{4}-\d{2}-\d{2})/)?.[1] ?? "";
   const body = text.split("\n").find((line, i) => i > 2 && line.trim() && !/^(kind|paths|contributors):/.test(line) && !line.startsWith("#")) ?? "";
   return { kind, status, author, contributors, paths, title, date, body: body.slice(0, 600) };
@@ -1244,8 +1245,10 @@ function refreshTeamIndex(team) {
   } catch {}
 }
 
-// A page governs a file when one of its paths is the file or a folder above it.
-const governs = (anchor, file) => anchor === file || file.startsWith(anchor.endsWith("/") ? anchor : `${anchor}/`);
+// A page governs a file when one of its paths is the file or a folder above it. A top-level folder (`cli/`) names
+// too much of the repository to say anything about one edit: such a page still comes with the prompt, not here.
+const broad = (anchor) => !anchor.replace(/\/+$/, "").includes("/") && !/\.[\w]+$/.test(anchor);
+const governs = (anchor, file) => !broad(anchor) && (anchor === file || file.startsWith(anchor.endsWith("/") ? anchor : `${anchor}/`));
 const fenceText = (text, max = 160) => String(text ?? "").replace(/[\u0000-\u001f\u007f-\u009f]/g, " ").replace(/[<>]/g, "").trim().slice(0, max);
 
 // The fenced note for the agent after an edit of `files` (absolute or relative to `cwd`), or undefined.
@@ -1286,7 +1289,7 @@ function teamNotesAt({ session, cwd, files }) {
     const on = page.paths.filter((anchor) => relative.some((file) => governs(anchor, file)));
     const changed = changesSince(base, page.paths, page.date);
     const stale = changed >= STALE_AFTER ? `; may be stale: ${changed} commits touched its paths since ${page.date}` : "";
-    return `- ${fenceText(page.title)} (${page.status} ${page.kind}, written by ${fenceText(by)}'s agent, last confirmed ${page.date || "unknown"}, about ${on.map((anchor) => fenceText(anchor)).join(", ")}${stale})\n  ${fenceText(page.body, 600)}`;
+    return `- ${fenceText(page.title, 240)} (${page.status} ${page.kind}, written by ${fenceText(by)}'s agent, last confirmed ${page.date || "unknown"}, about ${on.map((anchor) => fenceText(anchor)).join(", ")}${stale})\n  ${fenceText(page.body, 600)}`;
   });
   teamLog(`${session.slice(0, 8)} ${team.project} edit ${fresh.length} delivered`);
   return [

package/mod/peer-thread-mark/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "peer-thread-mark",
-  "version": "0.4.30",
+  "version": "0.4.32",
   "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)",
   "license": "MIT",
   "types": "./types/index.d.ts"

package/mod/peer-thread-mark/hooks/register.tsx

@@ -529,7 +529,7 @@ const fenced = (text: unknown) => (typeof text === 'string' && SENTENCE.test(tex
 const KNOWLEDGE = /^<teammates-project-knowledge-at-edit>\n[^<>]{1,6000}\n<\/teammates-project-knowledge-at-edit>$/
 const fencedKnowledge = (text: unknown) => (typeof text === 'string' && KNOWLEDGE.test(text) ? text : undefined)
 // The titles in a knowledge note, for the line the person sees under the edit.
-const noteTitles = (text: string) => [...text.matchAll(/^- (.+?) \((?:verified|observed) /gm)].map(m => plain(m[1]!)).slice(0, 3)
+const noteTitles = (text: string) => [...text.matchAll(/^- (.+?) \((?:verified|observed) /gm)].map(m => plain(m[1]!)).slice(0, 3)  // plain() cuts each to the row's width
 
 // The one line under an edit: another person with the warning badge, or the person's own other thread, dimmed.
 function collisionLine(ui: { Box: (p: never) => RenderNode; Text: (p: never) => RenderNode }, surface: RenderSurface, signal: CollisionSignal, now: number, more = 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webinson/peer",
-  "version": "0.4.30",
+  "version": "0.4.32",
   "description": "Share chosen Claude Code and Codex threads with your team: who has agents running and on what.",
   "license": "MIT",
   "type": "module",