@nanonets/graft 0.23.0 → 0.24.0

package/dist/notes/credit.js

@@ -0,0 +1,78 @@
+/** `~9.6k tokens`, `~600 tokens`. */
+export function tokensLabel(n) {
+    if (n >= 1000)
+        return `~${(n / 1000).toFixed(n >= 10_000 ? 0 : 1).replace(/\.0$/, "")}k tokens`;
+    return `~${n} tokens`;
+}
+/** `Anay`, `Anay and Rushil`, `Anay, Rushil and 3 others`. */
+export function namesLabel(names) {
+    if (names.length <= 2)
+        return names.join(" and ");
+    if (names.length === 3)
+        return `${names[0]}, ${names[1]} and ${names[2]}`;
+    return `${names[0]}, ${names[1]} and ${names.length - 2} others`;
+}
+/** `48k`, `3.8k`, `600`. */
+function tokensShort(n) {
+    return tokensLabel(n).replace(/^~/, "").replace(" tokens", "");
+}
+/** What starting from a teammate's learning is worth when its tokens are too few to say: time to a PR. */
+export const PR_SPEEDUP = "3x faster";
+/**
+ * Below this many tokens, what a learning saves is too small a number to
+ * impress, so trail credits it as a faster PR instead.
+ */
+export const TOKEN_CREDIT_FLOOR = 80_000;
+/** Whether a token count is big enough to be the credit. */
+export function tokensWorthSaying(tokens) {
+    return (tokens ?? 0) >= TOKEN_CREDIT_FLOOR;
+}
+/**
+ * The lines that close a reply after a team learning is saved, one for each
+ * way the turn can end, since only the agent knows whether it committed the
+ * learning by then. Uncommitted, it makes the case for committing: who else
+ * works on the same files, and the head start their agents would get, which
+ * is what the learning took to work out, or a faster PR when that's small.
+ */
+export function commitLines(note, teammates, where = "files") {
+    const tokens = note.cost?.tokens;
+    const short = tokensWorthSaying(tokens) ? tokensShort(tokens) : null;
+    // "an 80k-token", "an 11k-token": said aloud, they start with a vowel.
+    const start = short ? `${/^8|^1[18]k$/.test(short) ? "an" : "a"} ${short}-token head start` : null;
+    const place = where === "files" ? "this part of the codebase" : "this repo";
+    if (!teammates.length) {
+        return start
+            ? {
+                committed: `📝 Committed · your teammates' agents now get ${start}`,
+                uncommitted: `🌱 Commit what you learned and give your teammates' agents ${start}`,
+            }
+            : {
+                committed: `📝 Committed · your teammates' agents now get to a PR ${PR_SPEEDUP}`,
+                uncommitted: `🌱 Commit what you learned and your teammates' agents get to a PR ${PR_SPEEDUP}`,
+            };
+    }
+    const who = namesLabel(teammates);
+    const work = teammates.length === 1 ? "works" : "work";
+    return start
+        ? {
+            committed: `📝 Committed · ${who} ${work} in ${place}, and their agents now get ${start}`,
+            uncommitted: `🌱 ${who} ${work} in ${place}. Commit what you learned and give their agents ${start}`,
+        }
+        : {
+            committed: `📝 Committed · ${who} ${work} in ${place}, and their agents now get to a PR ${PR_SPEEDUP}`,
+            uncommitted: `🌱 ${who} ${work} in ${place}. Commit what you learned and their agents get to a PR ${PR_SPEEDUP}`,
+        };
+}
+/**
+ * The line asking for trail's shared setup to be committed, once: `.trail/`
+ * and the SessionStart entry in `.claude/settings.json` are what let a
+ * teammate's Claude read the learnings before they install anything.
+ */
+export function setupCommitLine(teammates) {
+    const ask = "Commit .trail/ and .claude/settings.json once";
+    if (!teammates.length)
+        return `🌱 ${ask}, and your teammates' Claude starts from your learnings, even before they install trail`;
+    const work = teammates.length === 1 ? "works" : "work";
+    return `🌱 ${namesLabel(teammates)} ${work} in this repo. ${ask}, and their Claude starts from your learnings, even before they install trail`;
+}
+//# sourceMappingURL=credit.js.map

package/dist/notes/credit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit.js","sourceRoot":"","sources":["../../src/notes/credit.ts"],"names":[],"mappings":"AAOA,qCAAqC;AACrC,MAAM,UAAU,WAAW,CAAC,CAAS;IACnC,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC;IAChG,OAAO,IAAI,CAAC,SAAS,CAAC;AACxB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1E,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC;AACnE,CAAC;AAED,4BAA4B;AAC5B,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACjE,CAAC;AAED,0GAA0G;AAC1G,MAAM,CAAC,MAAM,UAAU,GAAG,WAAW,CAAC;AAEtC;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,MAA0B;IAC1D,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,kBAAkB,CAAC;AAC7C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,IAAwB,EACxB,SAAmB,EACnB,QAA0B,OAAO;IAEjC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;IACjC,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACtE,uEAAuE;IACvE,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC;IACnG,MAAM,KAAK,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,WAAW,CAAC;IAC5E,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACtB,OAAO,KAAK;YACV,CAAC,CAAC;gBACE,SAAS,EAAE,iDAAiD,KAAK,EAAE;gBACnE,WAAW,EAAE,8DAA8D,KAAK,EAAE;aACnF;YACH,CAAC,CAAC;gBACE,SAAS,EAAE,yDAAyD,UAAU,EAAE;gBAChF,WAAW,EAAE,qEAAqE,UAAU,EAAE;aAC/F,CAAC;IACR,CAAC;IACD,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,KAAK;QACV,CAAC,CAAC;YACE,SAAS,EAAE,kBAAkB,GAAG,IAAI,IAAI,OAAO,KAAK,8BAA8B,KAAK,EAAE;YACzF,WAAW,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,KAAK,mDAAmD,KAAK,EAAE;SACrG;QACH,CAAC,CAAC;YACE,SAAS,EAAE,kBAAkB,GAAG,IAAI,IAAI,OAAO,KAAK,sCAAsC,UAAU,EAAE;YACtG,WAAW,EAAE,MAAM,GAAG,IAAI,IAAI,OAAO,KAAK,0DAA0D,UAAU,EAAE;SACjH,CAAC;AACR,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,SAAmB;IACjD,MAAM,GAAG,GAAG,+CAA+C,CAAC;IAC5D,IAAI,CAAC,SAAS,CAAC,MAAM;QAAE,OAAO,MAAM,GAAG,yFAAyF,CAAC;IACjI,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;IACvD,OAAO,MAAM,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,kBAAkB,GAAG,+EAA+E,CAAC;AACjJ,CAAC"}

package/dist/notes/find-notes.d.ts

@@ -0,0 +1,17 @@
+import type { Note } from "./notes.js";
+export interface NoteHit {
+    note: Note;
+    score: number;
+    /** Files the note touches that this query's results also point into. */
+    shared: string[];
+}
+/**
+ * The notes worth showing next to a query's results: ones whose title or body
+ * share the query's words, or that touch a file the results point into. At
+ * most `limit`, best first. A note has to clear a bar — two of the query's
+ * words, or one in its title, or a shared file — so an unrelated note never
+ * rides along just because it exists. Only live learnings: never one that was
+ * retired, is held for a yes, or that a newer learning replaces.
+ */
+export declare function findNotes(notes: Note[], query: string, files?: string[], limit?: number): NoteHit[];
+//# sourceMappingURL=find-notes.d.ts.map

package/dist/notes/find-notes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-notes.d.ts","sourceRoot":"","sources":["../../src/notes/find-notes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAiBvC,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE,CAwBlG"}

package/dist/notes/find-notes.js

@@ -0,0 +1,48 @@
+/**
+ * Which learnings to show next to a query's results.
+ */
+import { liveLearnings } from "./learning-fields.js";
+const STOP = new Set("the and for with from that this what when where which into does how why are was were not but you your our out its it's can should would could about after before over under use using used fix find make".split(" "));
+function terms(s) {
+    return [...new Set(s.toLowerCase().split(/[^a-z0-9_]+/).filter((t) => t.length >= 3 && !STOP.has(t)))];
+}
+/** The file part of a `file#Symbol` touch. */
+function touchFile(t) {
+    return t.split("#")[0];
+}
+/**
+ * The notes worth showing next to a query's results: ones whose title or body
+ * share the query's words, or that touch a file the results point into. At
+ * most `limit`, best first. A note has to clear a bar — two of the query's
+ * words, or one in its title, or a shared file — so an unrelated note never
+ * rides along just because it exists. Only live learnings: never one that was
+ * retired, is held for a yes, or that a newer learning replaces.
+ */
+export function findNotes(notes, query, files = [], limit = 2) {
+    const q = terms(query);
+    const hitFiles = new Set(files);
+    const out = [];
+    for (const note of liveLearnings(notes)) {
+        const title = new Set(terms(note.title));
+        const text = new Set(terms(`${note.body} ${note.touches.join(" ")}`));
+        let score = 0;
+        let matched = 0;
+        for (const t of q) {
+            if (title.has(t)) {
+                score += 3;
+                matched++;
+            }
+            else if (text.has(t)) {
+                score += 1;
+                matched++;
+            }
+        }
+        const shared = [...new Set(note.touches.map(touchFile))].filter((f) => hitFiles.has(f));
+        score += shared.length * 4;
+        const clears = shared.length > 0 || matched >= 2 || [...title].some((t) => q.includes(t));
+        if (clears && score >= 3)
+            out.push({ note, score, shared });
+    }
+    return out.sort((a, b) => b.score - a.score || b.note.date.localeCompare(a.note.date)).slice(0, limit);
+}
+//# sourceMappingURL=find-notes.js.map

package/dist/notes/find-notes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-notes.js","sourceRoot":"","sources":["../../src/notes/find-notes.ts"],"names":[],"mappings":"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"}

package/dist/notes/flatten.d.ts

@@ -0,0 +1,31 @@
+/**
+ * One line of text, for anything a learning carries into what an agent or a
+ * person reads.
+ *
+ * A learning's title, author and section leads come from whoever wrote the
+ * file, a teammate's unmerged branch included. A newline in a title used to
+ * print as a line of its own, and a line that starts `[trail] ...` reads
+ * exactly like trail's own instructions. So every such field goes through
+ * `flatLine` on its way out: breaks collapse to spaces, a `[trail]`-style
+ * marker at the start or after a collapsed break is dropped, invisible and
+ * control characters go (they can hide a marker or rewrite a terminal), and
+ * the line is capped.
+ *
+ * The hooks shim committed into repos runs as plain Node and can't import
+ * this, so `FLAT_LINE_JS` is the same function as source text, and a test
+ * holds the two to the same output.
+ */
+/**
+ * `text` as one line of at most `max` characters, ending in "…" when cut.
+ * Anything but a string, a number or a boolean reads as "".
+ */
+export declare function flatLine(text: unknown, max?: number): string;
+/**
+ * The words of `text` as one line, none of them starting with a marker: for
+ * text wrapped onto several lines, where any word can start one. A marker in
+ * the middle of a word stays, since no line can start there.
+ */
+export declare function unmarkedWords(text: unknown): string[];
+/** `flatLine` as plain JS source, for the generated hooks shim. Keep the two in step. */
+export declare const FLAT_LINE_JS = "function flatLine(text, max) {\n  if (max === undefined) max = 160;\n  const raw = typeof text === 'string' ? text : typeof text === 'number' || typeof text === 'boolean' ? String(text) : '';\n  const line = raw\n    .replace(/[\\p{Cf}\\ufe00-\\ufe0f\\u{e0100}-\\u{e01ef}]/gu, '')\n    .replace(/[\\u0000-\\u0008\\u000e-\\u001f\\u007f-\\u0084\\u0086-\\u009f]/g, '')\n    .split(/\\r\\n|[\\n\\r\\u000b\\u000c\\u0085\\u2028\\u2029]/)\n    .map((part) => part.replace(/^\\s*(?:\\[(?:trail|graft|trail-code)\\]\\s*)+/i, ''))\n    .join(' ')\n    .replace(/\\s+/g, ' ')\n    .trim();\n  const chars = Array.from(line);\n  return chars.length > max ? chars.slice(0, Math.max(0, max - 1)).join('').trimEnd() + '\\u2026' : line;\n}";
+//# sourceMappingURL=flatten.d.ts.map

package/dist/notes/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../../src/notes/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAeH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,MAAM,CAYzD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAKrD;AAED,yFAAyF;AACzF,eAAO,MAAM,YAAY,wtBAavB,CAAC"}

package/dist/notes/flatten.js

@@ -0,0 +1,73 @@
+/**
+ * One line of text, for anything a learning carries into what an agent or a
+ * person reads.
+ *
+ * A learning's title, author and section leads come from whoever wrote the
+ * file, a teammate's unmerged branch included. A newline in a title used to
+ * print as a line of its own, and a line that starts `[trail] ...` reads
+ * exactly like trail's own instructions. So every such field goes through
+ * `flatLine` on its way out: breaks collapse to spaces, a `[trail]`-style
+ * marker at the start or after a collapsed break is dropped, invisible and
+ * control characters go (they can hide a marker or rewrite a terminal), and
+ * the line is capped.
+ *
+ * The hooks shim committed into repos runs as plain Node and can't import
+ * this, so `FLAT_LINE_JS` is the same function as source text, and a test
+ * holds the two to the same output.
+ */
+/**
+ * Characters nobody sees: every Unicode format character (zero-width ones,
+ * direction marks and overrides, the soft hyphen, tag characters that can
+ * spell out text only an agent reads) and the variation selectors.
+ */
+const INVISIBLE = /[\p{Cf}\ufe00-\ufe0f\u{e0100}-\u{e01ef}]/gu;
+/** Control characters other than tab and the line breaks below (ESC, BEL, DEL, C1 but NEL). */
+const CONTROL = /[\u0000-\u0008\u000e-\u001f\u007f-\u0084\u0086-\u009f]/g;
+/** Every line break JavaScript, YAML or a terminal might honour. */
+const BREAK = /\r\n|[\n\r\u000b\u000c\u0085\u2028\u2029]/;
+/** `[trail]`, `[graft]`, `[trail-code]`, any case, once or more, at the start. */
+const MARKER = /^\s*(?:\[(?:trail|graft|trail-code)\]\s*)+/i;
+/**
+ * `text` as one line of at most `max` characters, ending in "…" when cut.
+ * Anything but a string, a number or a boolean reads as "".
+ */
+export function flatLine(text, max = 160) {
+    const raw = typeof text === "string" ? text : typeof text === "number" || typeof text === "boolean" ? String(text) : "";
+    const line = raw
+        .replace(INVISIBLE, "")
+        .replace(CONTROL, "")
+        .split(BREAK)
+        .map((part) => part.replace(MARKER, ""))
+        .join(" ")
+        .replace(/\s+/g, " ")
+        .trim();
+    const chars = Array.from(line);
+    return chars.length > max ? `${chars.slice(0, Math.max(0, max - 1)).join("").trimEnd()}…` : line;
+}
+/**
+ * The words of `text` as one line, none of them starting with a marker: for
+ * text wrapped onto several lines, where any word can start one. A marker in
+ * the middle of a word stays, since no line can start there.
+ */
+export function unmarkedWords(text) {
+    return flatLine(text, Number.POSITIVE_INFINITY)
+        .split(" ")
+        .map((word) => word.replace(MARKER, ""))
+        .filter(Boolean);
+}
+/** `flatLine` as plain JS source, for the generated hooks shim. Keep the two in step. */
+export const FLAT_LINE_JS = `function flatLine(text, max) {
+  if (max === undefined) max = 160;
+  const raw = typeof text === 'string' ? text : typeof text === 'number' || typeof text === 'boolean' ? String(text) : '';
+  const line = raw
+    .replace(/[\\p{Cf}\\ufe00-\\ufe0f\\u{e0100}-\\u{e01ef}]/gu, '')
+    .replace(/[\\u0000-\\u0008\\u000e-\\u001f\\u007f-\\u0084\\u0086-\\u009f]/g, '')
+    .split(/\\r\\n|[\\n\\r\\u000b\\u000c\\u0085\\u2028\\u2029]/)
+    .map((part) => part.replace(/^\\s*(?:\\[(?:trail|graft|trail-code)\\]\\s*)+/i, ''))
+    .join(' ')
+    .replace(/\\s+/g, ' ')
+    .trim();
+  const chars = Array.from(line);
+  return chars.length > max ? chars.slice(0, Math.max(0, max - 1)).join('').trimEnd() + '\\u2026' : line;
+}`;
+//# sourceMappingURL=flatten.js.map

package/dist/notes/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../../src/notes/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;GAIG;AACH,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAC/D,+FAA+F;AAC/F,MAAM,OAAO,GAAG,yDAAyD,CAAC;AAC1E,oEAAoE;AACpE,MAAM,KAAK,GAAG,2CAA2C,CAAC;AAC1D,kFAAkF;AAClF,MAAM,MAAM,GAAG,6CAA6C,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa,EAAE,GAAG,GAAG,GAAG;IAC/C,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACxH,MAAM,IAAI,GAAG,GAAG;SACb,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,KAAK,CAAC,KAAK,CAAC;SACZ,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACvC,IAAI,CAAC,GAAG,CAAC;SACT,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;IACV,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACnG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,iBAAiB,CAAC;SAC5C,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;SACvC,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;EAa1B,CAAC"}

package/dist/notes/git-facts.d.ts

@@ -3,11 +3,17 @@ export declare function noteAuthor(repo: string): string;
 export declare function currentBranch(repo: string): string | undefined;
 /** Paths that are the code map, agent wiring or the learnings themselves, never what a learning is about. */
 export declare function ownPath(p: string): boolean;
+/** A repo path that is trail's or the agents' own (`ownPath`, plus AGENTS.md and the like): never what a learning is about. */
+export declare function trailOwnPath(p: string): boolean;
 /**
  * Files this session changed: uncommitted changes, plus files in commits made
  * since `since` (epoch ms). At most `limit`, in the order git lists them.
+ * `uncommitted: false` leaves the working tree out, for when the session's own
+ * transcript already says which files it changed: uncommitted files from
+ * before the session (an untracked token file, a stray AGENTS.md) were
+ * otherwise listed on every learning saved there.
  */
-export declare function changedFiles(repo: string, since?: number, limit?: number): string[];
+export declare function changedFiles(repo: string, since?: number, limit?: number, uncommitted?: boolean): string[];
 /**
  * The people who changed `files` (the whole repo when empty) in the last six
  * months, by first name, most commits first: the ones whose agents a learning

package/dist/notes/git-facts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"git-facts.d.ts","sourceRoot":"","sources":["../../src/notes/git-facts.ts"],"names":[],"mappings":"AAkBA,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,6GAA6G;AAC7G,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAI1C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,MAAM,EAAE,CAkB/E;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAqBxE"}
+{"version":3,"file":"git-facts.d.ts","sourceRoot":"","sources":["../../src/notes/git-facts.ts"],"names":[],"mappings":"AAkBA,yFAAyF;AACzF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG9D;AAED,6GAA6G;AAC7G,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAI1C;AAKD,+HAA+H;AAC/H,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,SAAK,EAAE,WAAW,UAAO,GAAG,MAAM,EAAE,CAkBnG;AAKD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAqBxE"}

package/dist/notes/git-facts.js

@@ -39,18 +39,28 @@ export function ownPath(p) {
     // to them, which is never what a session's note is about.
     return /^(graft|\.graft|\.claude|\.cursor|\.codex|\.trail)(\/|$)/.test(p) || p === ".mcp.json" || p === ".gitignore" || p === ".ignore";
 }
+/** Files the agent instructions live in: trail writes them, so editing them is setting trail up. */
+const AGENT_FILES = new Set(["AGENTS.md", "CLAUDE.md", "GEMINI.md", ".github/copilot-instructions.md"]);
+/** A repo path that is trail's or the agents' own (`ownPath`, plus AGENTS.md and the like): never what a learning is about. */
+export function trailOwnPath(p) {
+    return ownPath(p) || AGENT_FILES.has(p);
+}
 /**
  * Files this session changed: uncommitted changes, plus files in commits made
  * since `since` (epoch ms). At most `limit`, in the order git lists them.
+ * `uncommitted: false` leaves the working tree out, for when the session's own
+ * transcript already says which files it changed: uncommitted files from
+ * before the session (an untracked token file, a stray AGENTS.md) were
+ * otherwise listed on every learning saved there.
  */
-export function changedFiles(repo, since, limit = 10) {
+export function changedFiles(repo, since, limit = 10, uncommitted = true) {
     const out = [];
     const add = (p) => {
         const f = p.trim();
         if (f && !ownPath(f) && !out.includes(f))
             out.push(f);
     };
-    const status = git(repo, ["status", "--porcelain", "--untracked-files=all"], true);
+    const status = uncommitted ? git(repo, ["status", "--porcelain", "--untracked-files=all"], true) : null;
     for (const line of (status ?? "").split("\n")) {
         if (!line.trim())
             continue;

package/dist/notes/git-facts.js.map

@@ -1 +1 @@
-{"version":3,"file":"git-facts.js","sourceRoot":"","sources":["../../src/notes/git-facts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"git-facts.js","sourceRoot":"","sources":["../../src/notes/git-facts.ts"],"names":[],"mappings":"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"}

package/dist/notes/home.d.ts

@@ -1,5 +1,5 @@
-/** `~/.trail`, or `$TRAIL_HOME`. */
-export declare function trailHome(env?: NodeJS.ProcessEnv, home?: string): string;
+import { trailHome } from "./trail-home.js";
+export { trailHome };
 /** A path as people read it: `~/.trail/…` under the home folder, absolute otherwise. */
 export declare function shownPath(p: string): string;
 /** The nearest folder at or above `start` holding a `.git` (folder or file), or null outside git. */
@@ -12,6 +12,16 @@ export declare function remoteUrl(config: string): string | null;
  * Null for a remote that is a path on this machine: those are keyed by path.
  */
 export declare function keyFromRemote(url: string): string | null;
+/**
+ * The checkout at or above `start` and its remote's key (`github.com/nanonets/assign`),
+ * as written in its git config, before any `insteadOf`: a clone whose fetches go
+ * somewhere else still names the same repo. Null outside git or without a remote.
+ * Reads only; spawns nothing.
+ */
+export declare function remoteKey(start: string): {
+    checkout: string;
+    key: string;
+} | null;
 export interface RepoPlace {
     /** The top of the checkout the folder is in (a worktree's own top), or the folder itself outside git. */
     checkout: string;
@@ -30,7 +40,7 @@ export declare function repoPlace(start: string, env?: NodeJS.ProcessEnv): RepoP
  * statusline); a machine with no notes anywhere never spawns it.
  */
 export declare function findRepoPlace(start: string, env?: NodeJS.ProcessEnv): RepoPlace;
-export declare const HOME_README = "# ~/.trail\n\nWhat Trail keeps on this machine. Learnings about the code are in each\nrepo's own .trail/learnings/, committed with the code; this folder holds\nthe rest, and none of it leaves this machine unless you share it.\n\n- repos/<repo>/notes/    personal learnings: about your setup or habits,\n                         not the code\n- repos/<repo>/skills/   corrections you taught your agent, per skill\n- repos/known.json       the repos Trail has run in, which is the list a\n                         workspace's repo picker shows\n- cloud.json             your Trail workspace, once you've connected one\n\n<repo> is the repo's remote (github.com/owner/name), so every clone and\nworktree of one repo shares its notes. Repos without a remote are under\nlocal/, by path.\n";
+export declare const HOME_README = "# ~/.trail\n\nWhat Trail keeps on this machine. Learnings about the code are in each\nrepo's own .trail/learnings/, committed with the code; this folder holds\nthe rest, and none of it leaves this machine unless you share it.\n\n- repos/<repo>/notes/    personal learnings: about your setup or habits,\n                         not the code\n- repos/<repo>/skills/   corrections you taught your agent, per skill\n- repos/known.json       the repos Trail has run in, which is the list a\n                         workspace's repo picker shows\n- cloud.json             your Trail workspace, once you've connected one\n\n<repo> is the repo's remote (github.com/owner/name), so every clone and\nworktree of one repo shares its learnings. Repos without a remote are under\nlocal/, by path.\n";
 /**
  * Make the folder for `start`'s repo, and return where it is. A repo seen for
  * the first time under this key, whose first commit already has a folder (a
@@ -57,11 +67,19 @@ export declare function notePlaces(dir: string, env?: NodeJS.ProcessEnv): RepoPl
 /** This repo keeps learnings: it has a committed `.trail/`, or `trail init` or a first learning made its folder in ~/.trail. */
 export declare function keepsNotes(dir: string, env?: NodeJS.ProcessEnv): boolean;
 /**
- * How many learnings bear on `dir`, counted without reading them: the repo's
- * `.trail/learnings/`, this machine's own, and the ones on teammates' pushed
- * branches, one per file name. Spawns nothing: the statusline calls it.
+ * How many live learnings bear on `dir`: the repo's `.trail/learnings/`, this
+ * machine's own, and the ones on teammates' pushed branches, one per file
+ * name, leaving out what is retired, held or replaced (`liveLearnings`).
+ * Spawns nothing and prints nothing: the statusline calls it.
  */
 export declare function noteCount(dir: string, env?: NodeJS.ProcessEnv): number;
+/** The live learnings bearing on `dir` by where they live: the repo's (`.trail/learnings/`, teammates' branches) and the person's own in the Trail home. */
+export interface NoteCounts {
+    repo: number;
+    personal: number;
+}
+/** `noteCount`, split by place, so the session start names each where it is. */
+export declare function noteCounts(dir: string, env?: NodeJS.ProcessEnv): NoteCounts;
 export interface KnownRepo {
     /** `github.com/hashicorp/go-retryablehttp`: the key notes are kept under. */
     key: string;

package/dist/notes/home.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/notes/home.ts"],"names":[],"mappings":"AAwCA,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,CAEhG;AAED,wFAAwF;AACxF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK3C;AAMD,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQzD;AA8CD,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBvD;AAQD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BxD;AAWD,MAAM,WAAW,SAAS;IACxB,yGAAyG;IACzG,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAgBxF;AA+BD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,CAS5F;AAED,eAAO,MAAM,WAAW,oxBAgBvB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAe1H;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAYvE;AASD,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAcpD;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,EAAE,CAKzF;AAED,gIAAgI;AAChI,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAErF;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAYnF;AAMD,MAAM,WAAW,SAAS;IACxB,6EAA6E;IAC7E,GAAG,EAAE,MAAM,CAAC;IACZ,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAI/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,SAAS,EAAE,CAK5E;AAKD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,GAAG,SAAa,GAAG,IAAI,CAatG"}
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../src/notes/home.ts"],"names":[],"mappings":"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"}

package/dist/notes/home.js

@@ -36,11 +36,11 @@ import { homedir } from "node:os";
 import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
 import { readJson, writeJsonAtomic } from "../util/state.js";
 import { readBranchCache } from "./branches.js";
-import { hasRepoTrail, learningFiles } from "./repo-trail.js";
-/** `~/.trail`, or `$TRAIL_HOME`. */
-export function trailHome(env = process.env, home = homedir()) {
-    return env.TRAIL_HOME ? resolve(env.TRAIL_HOME) : join(home, ".trail");
-}
+import { hasRepoTrail, learningFiles, learningsDir } from "./repo-trail.js";
+import { liveLearnings, readLearningFields } from "./learning-fields.js";
+import { matter } from "../util/front-matter.js";
+import { trailHome } from "./trail-home.js";
+export { trailHome };
 /** A path as people read it: `~/.trail/…` under the home folder, absolute otherwise. */
 export function shownPath(p) {
     if (!isAbsolute(p))
@@ -131,7 +131,15 @@ export function remoteUrl(config) {
 }
 /** One path segment of a key: lowercase, safe as a folder name, never `.` or `..`. */
 function segment(s) {
-    const out = s.toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+    const dashed = s.toLowerCase().replace(/[^a-z0-9._-]+/g, "-");
+    // Trim the dashes by hand: `/-+$/` rescans every run of dashes, quadratic on a long one.
+    let a = 0;
+    let b = dashed.length;
+    while (a < b && dashed[a] === "-")
+        a++;
+    while (b > a && dashed[b - 1] === "-")
+        b--;
+    const out = dashed.slice(a, b);
     return /^\.+$/.test(out) ? "" : out;
 }
 /**
@@ -172,6 +180,26 @@ export function keyFromRemote(url) {
         return null;
     return [host, ...parts].join("/");
 }
+/**
+ * The checkout at or above `start` and its remote's key (`github.com/nanonets/assign`),
+ * as written in its git config, before any `insteadOf`: a clone whose fetches go
+ * somewhere else still names the same repo. Null outside git or without a remote.
+ * Reads only; spawns nothing.
+ */
+export function remoteKey(start) {
+    const top = checkoutRoot(start);
+    const dirs = top ? gitDirs(top) : null;
+    if (!top || !dirs)
+        return null;
+    try {
+        const url = remoteUrl(readFileSync(join(dirs.commonDir, "config"), "utf8"));
+        const key = url ? keyFromRemote(url) : null;
+        return key ? { checkout: top, key } : null;
+    }
+    catch {
+        return null;
+    }
+}
 /** `local/Users-priya-src-extract`: the key for a repo with no remote, or a folder outside git. */
 function pathKey(dir) {
     return `local/${segment(resolve(dir)) || "root"}`;
@@ -267,7 +295,7 @@ the rest, and none of it leaves this machine unless you share it.
 - cloud.json             your Trail workspace, once you've connected one
 
 <repo> is the repo's remote (github.com/owner/name), so every clone and
-worktree of one repo shares its notes. Repos without a remote are under
+worktree of one repo shares its learnings. Repos without a remote are under
 local/, by path.
 `;
 /**
@@ -351,21 +379,58 @@ export function notePlaces(dir, env = process.env) {
 export function keepsNotes(dir, env = process.env) {
     return notePlaces(dir, env).some((p) => existsSync(p.dir) || (p.git && hasRepoTrail(p.checkout)));
 }
+function counted(text, name, scope, ref) {
+    try {
+        const parsed = matter(text);
+        const d = parsed.data;
+        if (parsed.refused || typeof d.title !== "string" || !d.title.trim())
+            return null;
+        const date = d.date instanceof Date ? d.date.toISOString().slice(0, 10) : String(d.date ?? "");
+        return { ...readLearningFields(d, name), scope, date, path: name, ...(ref ? { ref } : {}) };
+    }
+    catch {
+        return null;
+    }
+}
+function readText(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
 /**
- * How many learnings bear on `dir`, counted without reading them: the repo's
- * `.trail/learnings/`, this machine's own, and the ones on teammates' pushed
- * branches, one per file name. Spawns nothing: the statusline calls it.
+ * How many live learnings bear on `dir`: the repo's `.trail/learnings/`, this
+ * machine's own, and the ones on teammates' pushed branches, one per file
+ * name, leaving out what is retired, held or replaced (`liveLearnings`).
+ * Spawns nothing and prints nothing: the statusline calls it.
  */
 export function noteCount(dir, env = process.env) {
-    const names = new Set();
+    const c = noteCounts(dir, env);
+    return c.repo + c.personal;
+}
+/** `noteCount`, split by place, so the session start names each where it is. */
+export function noteCounts(dir, env = process.env) {
+    const all = [];
+    const seen = new Set();
+    const add = (name, text, scope, ref) => {
+        if (seen.has(name) || text === null)
+            return;
+        const c = counted(text, name, scope, ref);
+        if (!c)
+            return;
+        seen.add(name);
+        all.push(c);
+    };
     for (const p of notePlaces(dir, env)) {
         if (p.git)
             for (const f of learningFiles(p.checkout))
-                names.add(f);
+                add(f, readText(join(learningsDir(p.checkout), f)), "repo");
         try {
             for (const f of readdirSync(join(p.dir, "notes")))
                 if (f.endsWith(".md"))
-                    names.add(f);
+                    add(f, readText(join(p.dir, "notes", f)), "personal");
         }
         catch {
             /* none */
@@ -373,9 +438,11 @@ export function noteCount(dir, env = process.env) {
         if (p.git)
             for (const b of readBranchCache(p.checkout)?.branches ?? [])
                 for (const l of b.learnings)
-                    names.add(l.name);
+                    add(l.name, l.text, "repo", b.ref);
     }
-    return names.size;
+    const live = liveLearnings(all);
+    const personal = live.filter((c) => c.scope === "personal").length;
+    return { repo: live.length - personal, personal };
 }
 function knownPath(home) {
     return join(home, "repos", "known.json");