@nanonets/graft 0.23.1 → 0.24.0

package/dist/notes/learning-fields.js

@@ -0,0 +1,214 @@
+/**
+ * What a learning says about itself beyond its title, author and date: a
+ * stable id, what kind of learning it is, who it is for, whether it still
+ * holds, and which older learning it replaces.
+ *
+ * A file written before these fields existed reads with defaults: its id
+ * comes from its file name (the same id a new file of that name is given),
+ * its status is active, and its scope comes from where it sits. A value a
+ * learning can't hold (an unknown kind, a malformed id, a line break in a
+ * repo key) is dropped rather than carried into what an agent reads.
+ *
+ * `replaces` means the newest wins: recall and `trail check` read only the
+ * live learnings (`liveLearnings`), never one a newer learning replaced.
+ */
+import { createHash } from "node:crypto";
+import { flatLine } from "./flatten.js";
+export const KINDS = ["preference", "guardrail", "decision", "lesson"];
+export const SCOPES = ["personal", "repo", "team"];
+export const STATUSES = ["active", "held", "replaced", "retired"];
+export const SOURCES = ["person", "init-typed", "init-review", "error-class", "agent", "correction", "repair"];
+export const CHECKS = ["no-timeout"];
+export const ENFORCES = ["sure-fail"];
+/**
+ * The wall catalog's classes at run time, in the catalog's order (trace/walls.ts). Equal to the WallClass type and
+ * to telemetry's wall_hit.class values; a test holds all three equal.
+ */
+export const WALL_CLASSES = [
+    "timeout-missing", "zsh-no-match", "git-https-auth", "docker-rootless", "npm-e401-eotp", "claude-not-logged-in", "enospc",
+];
+/** A personal learning's `applies` when it holds in every repo, not just one. */
+export const EVERY_REPO = "every repo";
+/** The front-matter keys, in the order they're written. */
+export const LEARNING_KEYS = ["id", "kind", "scope", "applies", "status", "replaces", "src", "skill", "check", "enforce", "wall", "evidence"];
+/** `l-` and 6 to 16 lowercase hex digits. */
+export const LEARNING_ID = /^l-[0-9a-f]{6,16}$/;
+/** A repo key as `home.ts` makes them: `github.com/acme/api`, `local/…`. */
+const REPO_KEY = /^[a-z0-9._-]+(?:\/[a-z0-9._-]+)*$/;
+const EVIDENCE_MAX = 160;
+/** A skill name as compile gives them (compile-words.ts NAME_RE, no `--`, no trailing `-`). Kept here so notes don't load compile. */
+const SKILL_NAME = /^(?=[a-z0-9-]*[a-z])[a-z0-9][a-z0-9-]{1,47}$/;
+function skillName(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const s = v.trim().toLowerCase();
+    return SKILL_NAME.test(s) && !/--|-$/.test(s) ? s : undefined;
+}
+/** The file name in a path: after the last `/`, `\\` or a branch ref's `:`. */
+export function learningFileName(path) {
+    return path.slice(Math.max(path.lastIndexOf("/"), path.lastIndexOf("\\"), path.lastIndexOf(":")) + 1);
+}
+/**
+ * The id of a learning file that doesn't say its own: `l-` and the first 6 hex
+ * digits of the file name's sha1. Files written before ids keep this one.
+ */
+export function learningId(fileName) {
+    return `l-${createHash("sha1").update(fileName).digest("hex").slice(0, 6)}`;
+}
+/**
+ * The id a new learning is written with: the first 8 hex digits of the same
+ * sha1, so a repo with hundreds of learnings doesn't hand two the same one.
+ * Its first 6 are the id the file would get if its id line were lost.
+ */
+export function newLearningId(fileName) {
+    return `l-${createHash("sha1").update(fileName).digest("hex").slice(0, 8)}`;
+}
+/** `v` as one of `allowed`, ignoring case and padding, or undefined. */
+function oneOf(v, allowed) {
+    if (typeof v !== "string")
+        return undefined;
+    const s = v.trim().toLowerCase();
+    return allowed.includes(s) ? s : undefined;
+}
+/** A learning id, normalised, or undefined when `v` isn't one. */
+export function asLearningId(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const s = v.trim().toLowerCase();
+    return LEARNING_ID.test(s) ? s : undefined;
+}
+function appliesValue(v) {
+    if (typeof v !== "string")
+        return undefined;
+    const s = v.trim().toLowerCase();
+    if (s === EVERY_REPO)
+        return EVERY_REPO;
+    return s.length <= 200 && REPO_KEY.test(s) ? s : undefined;
+}
+/** The fields of a learning's front matter `d`, read from the file `fileName`, with defaults for what it lacks. */
+export function readLearningFields(d, fileName) {
+    const out = { id: asLearningId(d.id) ?? learningId(fileName), status: oneOf(d.status, STATUSES) ?? "active" };
+    const kind = oneOf(d.kind, KINDS);
+    const scope = oneOf(d.scope, SCOPES);
+    const applies = appliesValue(d.applies);
+    const replaces = asLearningId(d.replaces);
+    const src = oneOf(d.src, SOURCES);
+    const skill = skillName(d.skill);
+    const check = oneOf(d.check, CHECKS);
+    const enforce = oneOf(d.enforce, ENFORCES);
+    const wall = oneOf(d.wall, WALL_CLASSES);
+    // One line, the way every field an agent reads is (flatten.ts).
+    const evidence = flatLine(d.evidence, EVIDENCE_MAX) || undefined;
+    if (kind)
+        out.kind = kind;
+    if (scope)
+        out.scope = scope;
+    if (applies)
+        out.applies = applies;
+    if (replaces && replaces !== out.id)
+        out.replaces = replaces;
+    if (src)
+        out.src = src;
+    if (skill)
+        out.skill = skill;
+    if (check)
+        out.check = check;
+    if (enforce)
+        out.enforce = enforce;
+    if (wall)
+        out.wall = wall;
+    if (evidence)
+        out.evidence = evidence;
+    return out;
+}
+/** Whether following `replaces` from `x` comes back round to the id `to`. */
+function leadsTo(x, to, byId) {
+    const seen = new Set();
+    const todo = x.replaces ? [x.replaces] : [];
+    while (todo.length) {
+        const id = todo.pop();
+        if (id === to)
+            return true;
+        if (seen.has(id))
+            continue;
+        seen.add(id);
+        for (const n of byId.get(id) ?? [])
+            if (n.replaces)
+                todo.push(n.replaces);
+    }
+    return false;
+}
+function byIdOf(notes) {
+    const byId = new Map();
+    for (const n of notes)
+        byId.set(n.id, [...(byId.get(n.id) ?? []), n]);
+    return byId;
+}
+/**
+ * Whether `r` replaces `x`. Only a learning someone has seen through counts:
+ * not one on a teammate's unmerged branch, nor one held for a yes. A
+ * just-for-you learning never hides one the repo or team shares. The newest
+ * wins; on the same day the replacement does, and of learnings that replace
+ * each other in a circle (only a hand edit makes one), the later file name.
+ */
+function replaces(r, x, byId) {
+    if (r === x || r.replaces !== x.id || r.id === x.id)
+        return false;
+    if (r.ref || r.status === "held")
+        return false;
+    if (r.scope === "personal" && x.scope !== "personal")
+        return false;
+    if (r.date !== x.date)
+        return r.date > x.date;
+    return r.path > x.path || !leadsTo(x, r.id, byId);
+}
+/** Active and not replaced (the rule both lists below share). */
+function stillHold(notes, counts) {
+    const byTarget = new Map();
+    for (const r of notes)
+        if (r.replaces)
+            byTarget.set(r.replaces, [...(byTarget.get(r.replaces) ?? []), r]);
+    const byId = byIdOf(notes);
+    return notes.filter((x) => (x.status ?? "active") === "active" && !(byTarget.get(x.id) ?? []).some((r) => replaces(r, x, byId) && counts(r, x)));
+}
+/**
+ * The learnings that still hold: active ones (a file without a status is
+ * active) that no newer learning replaces. Order is kept. `counts(r, x)` can
+ * turn a replacement down: `trail check` lets only one on the base branch
+ * hide a learning that is there.
+ *
+ * 1b (R47): never a `lesson`. Session start, recall, standing learnings and
+ * `trail check` all read through here, and a lesson loads only through
+ * `lastTimeText` once it has worked twice (`liveLessons`).
+ */
+export function liveLearnings(notes, counts = () => true) {
+    return stillHold(notes, counts).filter((x) => x.kind !== "lesson");
+}
+/** The lessons that still hold, by the same rule: what `lastTimeText`'s caller reads (4.10). */
+export function liveLessons(notes) {
+    return stillHold(notes, () => true).filter((x) => x.kind === "lesson");
+}
+/** The learnings among `notes` that replace `x` by the rule above, newest first. */
+export function replacementsOf(notes, x) {
+    const byId = byIdOf(notes);
+    return notes.filter((r) => replaces(r, x, byId)).sort((a, b) => (a.date === b.date ? b.path.localeCompare(a.path) : b.date.localeCompare(a.date)));
+}
+/**
+ * The learning `ref` names: by id, or by its file name (with or without `.md`,
+ * or a path ending in it). An id is copied from file to file by hand, so when
+ * two share one, the one in this checkout or on this machine comes before one
+ * on a teammate's branch.
+ */
+export function findLearning(notes, ref) {
+    const id = asLearningId(ref);
+    if (id) {
+        const named = notes.filter((n) => n.id === id);
+        return named.find((n) => !n.ref) ?? named[0];
+    }
+    const name = learningFileName(ref.trim());
+    if (!name)
+        return undefined;
+    const file = name.endsWith(".md") ? name : `${name}.md`;
+    return notes.find((n) => learningFileName(n.path) === file);
+}
+//# sourceMappingURL=learning-fields.js.map

package/dist/notes/learning-fields.js.map

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

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

@@ -0,0 +1,71 @@
+import { type Note } from "./notes.js";
+export type MemoryType = "project" | "reference" | "feedback" | "user" | "other";
+/** One of Claude Code's memory notes, as written. */
+export interface MemoryNote {
+    /** Absolute path of the note. */
+    path: string;
+    name: string;
+    description: string;
+    type: MemoryType;
+    body: string;
+    /** YYYY-MM-DD it was last changed. */
+    updated: string;
+}
+/** A memory note as `trail init` offers it. */
+export interface MemoryCandidate {
+    title: string;
+    /** Markdown under `## Decided` and maybe `## Watch out`, secrets scrubbed. */
+    body: string;
+    /** Tied to code that exists now and not already said: offered for the team, ticked. */
+    forTeam: boolean;
+    touches: string[];
+    /** The note it came from, for the once-per-note mark. */
+    path: string;
+    updated: string;
+}
+/** The memory folders of this repo's checkouts on this machine: its own, its worktrees', and other clones'. */
+export declare function memoryDirs(repo: string, home?: string): string[];
+/** One memory note, or null when it isn't one (no frontmatter, empty, the MEMORY.md index). */
+export declare function readMemoryNote(path: string): MemoryNote | null;
+/** Every memory note of the repo's checkouts on this machine, newest first. */
+export declare function memoryNotes(repo: string, home?: string): MemoryNote[];
+/** A title a person reads: the note's name when it's words, else its description's first clause. */
+export declare function memoryTitle(note: Pick<MemoryNote, "name" | "description">): string;
+/**
+ * A memory note's body as a learning's: what it says, with its **Why:**,
+ * under `## Decided`; its **How to apply:** under `## Watch out`. Its own
+ * headings become bold lines so they don't break the learning's sections.
+ */
+export declare function memoryBody(note: Pick<MemoryNote, "body">): string;
+/**
+ * A short fact with its reason, not a work log. Status write-ups, and long
+ * notes with no **Why:**, stay in Claude's memory: as a learning they'd read
+ * as a diary, and be wrong by next week.
+ */
+export declare function readsAsLearning(body: string): boolean;
+/**
+ * What `trail init` offers from Claude Code's memory of this repo, for the
+ * team: project and reference notes that read as a learning, are tied to code
+ * that exists now, and aren't already said. Notes offered before and
+ * unchanged since are left out.
+ */
+export declare function memoryCandidates(repo: string, opts?: {
+    home?: string;
+    offered?: Set<string>;
+}): MemoryCandidate[];
+/** The memory notes init offered in this repo before, unchanged since. */
+export declare function offeredBefore(repo: string): Set<string>;
+/** Each kept candidate as a learning: the team's in `.trail/learnings/`, the person's own in ~/.trail. */
+export declare function saveMemoryCandidates(repo: string, kept: MemoryCandidate[], author?: string, date?: string): Note[];
+/**
+ * Save the candidates the person keeps and remember every one was offered.
+ * Without `keep` (no terminal to ask on), the team ones are kept: the
+ * person's own are already in their Claude's memory. `keep` resolving null
+ * means they cancelled: nothing is saved or marked, and the next init asks again.
+ */
+export declare function finishMemoryRead(repo: string, candidates: MemoryCandidate[], keep?: (candidates: MemoryCandidate[]) => Promise<MemoryCandidate[] | null>): Promise<{
+    saved: Note[];
+    kept: MemoryCandidate[];
+    cancelled: boolean;
+}>;
+//# sourceMappingURL=memory-notes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memory-notes.d.ts","sourceRoot":"","sources":["../../src/notes/memory-notes.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAwB,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAI7D,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAEjF,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAQD,+GAA+G;AAC/G,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,MAAM,EAAE,CAE3E;AAmBD,+FAA+F;AAC/F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAyB9D;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,UAAU,EAAE,CAehF;AAMD,oGAAoG;AACpG,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,CAAC,GAAG,MAAM,CAOlF;AAeD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,GAAG,MAAM,CAQjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGrD;AAKD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAAO,GAAG,eAAe,EAAE,CAsBrH;AAYD,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAEvD;AAED,0GAA0G;AAC1G,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,MAAM,SAAmB,EAAE,IAAI,SAAwC,GAAG,IAAI,EAAE,CAc3J;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,eAAe,EAAE,EAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,OAAO,CAAC,eAAe,EAAE,GAAG,IAAI,CAAC,GAC1E,OAAO,CAAC;IAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAAC,IAAI,EAAE,eAAe,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAuBzE"}

package/dist/notes/memory-notes.js

@@ -0,0 +1,239 @@
+/**
+ * Learnings from the notes Claude Code keeps for this repo on this machine
+ * (`~/.claude/projects/<folder>/memory/*.md`), for `trail init` to offer on
+ * day one. Those notes are Claude's own memory of the repo: what it was told
+ * about the project, where things are, how the person likes to work. They
+ * never leave this machine, so a teammate's Claude starts without them.
+ *
+ * No model reads them: each note is already short and written for Claude.
+ * trail keeps a project or reference note as a team learning only when it
+ * names code that exists now and the repo doesn't already say it; the rest,
+ * and the person's feedback notes, are offered as their own. Notes about the
+ * person (`user`) are never offered. Anything that looks like a secret is
+ * scrubbed, and a note that still looks like one is skipped.
+ */
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { countBucket } from "../telemetry/contract.js";
+import { track } from "../telemetry/track.js";
+import { readJson, writeJsonAtomic } from "../util/state.js";
+import { sameRepoRoots, scrub } from "./cold-start.js";
+import { noteAuthor } from "./git-facts.js";
+import { ensureRepoHome } from "./home.js";
+import { shortDate, writeNote } from "./notes.js";
+import { claudeProjectDir } from "./session-cost.js";
+import { alreadySaid, codeAnchors, knownText } from "./team-check.js";
+const BODY_CHARS = 1500;
+/* -------------------------------------------------------------------------- */
+/* Reading the notes                                                          */
+/* -------------------------------------------------------------------------- */
+/** The memory folders of this repo's checkouts on this machine: its own, its worktrees', and other clones'. */
+export function memoryDirs(repo, home = homedir()) {
+    return [...new Set(sameRepoRoots(repo, home).map((r) => join(claudeProjectDir(r, home), "memory")))];
+}
+/** The value of `key:` in a frontmatter block, top level or under `metadata:`, unquoted. */
+function field(front, key) {
+    const m = new RegExp(`^\\s*${key}:\\s*(.*)$`, "m").exec(front);
+    if (!m)
+        return "";
+    const v = m[1].trim();
+    if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+        try {
+            return v.startsWith('"') ? JSON.parse(v) : v.slice(1, -1);
+        }
+        catch {
+            return v.slice(1, -1);
+        }
+    }
+    return v;
+}
+const TYPES = ["project", "reference", "feedback", "user"];
+/** One memory note, or null when it isn't one (no frontmatter, empty, the MEMORY.md index). */
+export function readMemoryNote(path) {
+    if (basename(path) === "MEMORY.md")
+        return null;
+    let text;
+    let updated;
+    try {
+        text = readFileSync(path, "utf8");
+        updated = statSync(path).mtime.toISOString().slice(0, 10);
+    }
+    catch {
+        return null;
+    }
+    const m = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/.exec(text);
+    if (!m)
+        return null;
+    const front = m[1];
+    const body = m[2].trim();
+    if (!body)
+        return null;
+    const raw = field(front, "type").toLowerCase();
+    const modified = /^\d{4}-\d{2}-\d{2}/.exec(field(front, "modified"))?.[0];
+    return {
+        path,
+        name: field(front, "name") || basename(path, ".md"),
+        description: field(front, "description"),
+        type: TYPES.includes(raw) ? raw : "other",
+        body,
+        updated: modified ?? updated,
+    };
+}
+/** Every memory note of the repo's checkouts on this machine, newest first. */
+export function memoryNotes(repo, home = homedir()) {
+    const out = [];
+    for (const dir of memoryDirs(repo, home)) {
+        let files;
+        try {
+            files = readdirSync(dir).filter((f) => f.endsWith(".md"));
+        }
+        catch {
+            continue;
+        }
+        for (const f of files) {
+            const note = readMemoryNote(join(dir, f));
+            if (note)
+                out.push(note);
+        }
+    }
+    return out.sort((a, b) => b.updated.localeCompare(a.updated));
+}
+/* -------------------------------------------------------------------------- */
+/* As learnings                                                               */
+/* -------------------------------------------------------------------------- */
+/** A title a person reads: the note's name when it's words, else its description's first clause. */
+export function memoryTitle(note) {
+    const words = /\s/.test(note.name.trim()) ? note.name.trim() : "";
+    const first = note.description.split(/(?<=[a-z0-9)`])\.\s|;\s| — | -- /)[0].trim();
+    let t = words || first || note.name.replace(/[-_]+/g, " ");
+    t = t.replace(/\.$/, "");
+    if (t.length > 90)
+        t = `${t.slice(0, 89).replace(/\s+\S*$/, "")}…`;
+    return t.charAt(0).toUpperCase() + t.slice(1);
+}
+/** `[[name]]` links to other memory notes read as plain words outside Claude's memory. */
+function unlink(s) {
+    return s.replace(/\[\[([^\]]+)\]\]/g, "$1");
+}
+/** At most `max` characters, cut at a paragraph or line break when there is one. */
+function clip(s, max) {
+    if (s.length <= max)
+        return s;
+    const cut = s.slice(0, max);
+    const at = Math.max(cut.lastIndexOf("\n\n"), cut.lastIndexOf("\n"));
+    return `${(at > max / 2 ? cut.slice(0, at) : cut).trimEnd()}\n…`;
+}
+/**
+ * A memory note's body as a learning's: what it says, with its **Why:**,
+ * under `## Decided`; its **How to apply:** under `## Watch out`. Its own
+ * headings become bold lines so they don't break the learning's sections.
+ */
+export function memoryBody(note) {
+    const text = unlink(note.body).replace(/^#{1,6}\s+(.+)$/gm, "**$1**");
+    const split = /\*\*How to apply:?\*\*:?/i.exec(text);
+    const decided = (split ? text.slice(0, split.index) : text).trim();
+    const apply = split ? text.slice(split.index + split[0].length).trim() : "";
+    let out = `## Decided\n${clip(decided, BODY_CHARS)}`;
+    if (apply)
+        out += `\n\n## Watch out\n${clip(apply, 600)}`;
+    return scrub(out);
+}
+/**
+ * A short fact with its reason, not a work log. Status write-ups, and long
+ * notes with no **Why:**, stay in Claude's memory: as a learning they'd read
+ * as a diary, and be wrong by next week.
+ */
+export function readsAsLearning(body) {
+    if (/\*\*Status\b|^Status:|Shipped on branch|SLA breach|\bnot merged yet\b/im.test(body))
+        return false;
+    return body.split(/\s+/).filter(Boolean).length <= 150 || /\*\*Why:?\*\*/i.test(body);
+}
+/** Still looks like a credential after scrubbing, or names where one lives: not worth the risk of committing. */
+const SECRETISH = /\b(?:AWS_SECRET_ACCESS_KEY|PRIVATE KEY|client_secret|BEGIN OPENSSH)\b|\[redacted\]/;
+/**
+ * What `trail init` offers from Claude Code's memory of this repo, for the
+ * team: project and reference notes that read as a learning, are tied to code
+ * that exists now, and aren't already said. Notes offered before and
+ * unchanged since are left out.
+ */
+export function memoryCandidates(repo, opts = {}) {
+    const known = knownText(repo);
+    const team = [];
+    const titles = new Set();
+    for (const note of memoryNotes(repo, opts.home)) {
+        // Only what the team can use: Claude already reads the rest of its memory
+        // on this machine, so offering it again as a personal learning repeats it.
+        if (note.type !== "project" && note.type !== "reference")
+            continue;
+        if (opts.offered?.has(offerKey(note)))
+            continue;
+        if (!readsAsLearning(note.body))
+            continue;
+        const title = memoryTitle(note);
+        const key = title.toLowerCase();
+        if (titles.has(key))
+            continue;
+        const body = memoryBody(note);
+        if (SECRETISH.test(body))
+            continue;
+        if (alreadySaid(known, title, body))
+            continue;
+        titles.add(key);
+        const touches = codeAnchors(repo, `${note.description}\n${note.body}`);
+        if (!touches.length)
+            continue;
+        team.push({ title, body, forTeam: true, touches, path: note.path, updated: note.updated });
+    }
+    return team;
+}
+/** A note is offered again only once it changes. */
+function offerKey(note) {
+    return `${note.path}@${note.updated}`;
+}
+/** Where a repo remembers which memory notes init offered, on this machine. */
+function offeredMark(repo) {
+    return join(ensureRepoHome(repo).place.dir, "memory-notes.json");
+}
+/** The memory notes init offered in this repo before, unchanged since. */
+export function offeredBefore(repo) {
+    return new Set(readJson(offeredMark(repo))?.offered ?? []);
+}
+/** Each kept candidate as a learning: the team's in `.trail/learnings/`, the person's own in ~/.trail. */
+export function saveMemoryCandidates(repo, kept, author = noteAuthor(repo), date = new Date().toISOString().slice(0, 10)) {
+    return kept.map((c) => writeNote(repo, {
+        title: c.title,
+        author,
+        date,
+        body: `${c.body.trim()}\n\n_From Claude Code's memory of this repo, last updated ${shortDate(c.updated)}._`,
+        touches: c.touches,
+    }, c.forTeam ? "repo" : "personal"));
+}
+/**
+ * Save the candidates the person keeps and remember every one was offered.
+ * Without `keep` (no terminal to ask on), the team ones are kept: the
+ * person's own are already in their Claude's memory. `keep` resolving null
+ * means they cancelled: nothing is saved or marked, and the next init asks again.
+ */
+export async function finishMemoryRead(repo, candidates, keep) {
+    const chosen = candidates.length && keep ? await keep(candidates) : candidates.filter((c) => c.forTeam);
+    const kept = chosen ?? [];
+    const saved = kept.length ? saveMemoryCandidates(repo, kept) : [];
+    if (chosen !== null && candidates.length) {
+        const offered = offeredBefore(repo);
+        for (const c of candidates)
+            offered.add(offerKey(c));
+        writeJsonAtomic(offeredMark(repo), { at: Date.now(), offered: [...offered] }, true);
+    }
+    const team = candidates.filter((c) => c.forTeam);
+    track("cold_start", {
+        source: "memory",
+        outcome: chosen === null ? "cancelled" : candidates.length ? "found" : "none_found",
+        offered_bucket: countBucket(candidates.length),
+        picked_bucket: countBucket(saved.length),
+        team_offered_bucket: countBucket(team.length),
+        team_picked_bucket: countBucket(kept.filter((c) => c.forTeam).length),
+    }, { repo });
+    return { saved, kept, cancelled: chosen === null };
+}
+//# sourceMappingURL=memory-notes.js.map

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

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

package/dist/notes/note-gate.d.ts

@@ -0,0 +1,42 @@
+import { type Note } from "./notes.js";
+/** Past this many words a learning gets skimmed: a warning, never a refusal. */
+export declare const LONG_NOTE_WORDS = 250;
+export interface GateInput {
+    title: string;
+    body: string;
+    /** Kept in ~/.trail for this person, not the team: only the status and repeat checks apply. */
+    personal: boolean;
+    /** Repo files the note names that exist (from `mentionedFiles`), relative to the checkout. */
+    files: string[];
+    /** Whether the note names a function, type or other symbol that's in the repo's code. */
+    namesSymbol: boolean;
+    /** What it will touch, for the repeat check. */
+    touches: string[];
+    /** The id of the learning it says it replaces (`--replaces`). */
+    replaces?: string;
+}
+export interface GateResult {
+    /** Why it can't be saved as it is, each with how to fix it. Empty: it passes. */
+    problems: string[];
+    warnings: string[];
+}
+/** The learning this one repeats: same files, and much the same title or text. */
+export declare function repeatOf(input: Pick<GateInput, "title" | "body" | "touches" | "replaces" | "personal">, existing: Note[]): Note | null;
+/** The checks, on a learning about to be saved. `existing`: the learnings already there. */
+export declare function gateNote(input: GateInput, existing: Note[]): GateResult;
+/** The names a note uses that might be symbols, most likely first: backticked, then code-shaped. At most `limit`. */
+export declare function symbolCandidates(text: string, limit?: number): string[];
+/**
+ * Whether any of `names` is in the repo's code: a whole-word `git grep` over
+ * tracked files, leaving out trail's own files and markdown, which would find
+ * the note's own words. Outside git, false: the files it names still count.
+ */
+export declare function namesRepoSymbol(repo: string, names: string[]): boolean;
+/**
+ * Of `files` (relative to the checkout at `repo`), the ones git tracks. A
+ * learning's `touches:` lists these, plus files the session itself edited:
+ * an untracked file that was already lying around (a token, a scratch file)
+ * is never what a learning is about. Outside git, every file that exists.
+ */
+export declare function trackedFiles(repo: string, files: string[]): Set<string>;
+//# sourceMappingURL=note-gate.d.ts.map

package/dist/notes/note-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-gate.d.ts","sourceRoot":"","sources":["../../src/notes/note-gate.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA4C,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAEjF,gFAAgF;AAChF,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,QAAQ,EAAE,OAAO,CAAC;IAClB,8FAA8F;IAC9F,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yFAAyF;IACzF,WAAW,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiED,kFAAkF;AAClF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,GAAG,IAAI,CAYtI;AAED,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,UAAU,CAsCvE;AAMD,qHAAqH;AACrH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,MAAM,EAAE,CAUlE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CActE;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQvE"}