@nanonets/graft 0.23.0 → 0.24.0

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"}

package/dist/notes/note-gate.js

@@ -0,0 +1,181 @@
+/**
+ * What `trail note` checks before it saves a learning for the team: that a
+ * teammate's Claude would act differently for reading it. A learning that
+ * names no code never reaches anyone (learnings arrive when Claude opens the
+ * files they name), one about setting trail up isn't about the repo, status
+ * ("PR is open") is wrong by next week, a decision without its reason can't be
+ * weighed, and a second copy of a learning buries the first.
+ *
+ * Each check that fails says how to fix it, and the agent saves again. A long
+ * learning only gets a warning. `--anyway` saves past the checks, for when
+ * one of them is wrong.
+ */
+import { execFileSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { trailOwnPath } from "./git-facts.js";
+import { noteName, notePlace, SECTIONS, shortDate } from "./notes.js";
+/** Past this many words a learning gets skimmed: a warning, never a refusal. */
+export const LONG_NOTE_WORDS = 250;
+/** Setting trail (or graft) up, said in a title or body. */
+const SETUP_TALK = /\b(?:trail|graft)\b[^.\n]{0,40}\b(?:init|setup|set up|install(?:ed|ing)?|hooks?|wiring|wired)\b|\b(?:setting up|set up|install(?:ed|ing)?|wiring)\b[^.\n]{0,20}\b(?:trail|graft)\b/i;
+/** Status: true when written, wrong a week later. */
+const STATUS = [
+    /\b(?:PR|pull request|MR)\s*#?\d*\s+(?:is|was|got|has been|now)\s+(?:open|opened|merged|closed|approved|up|green|fixed|pushed)\b/i,
+    /\bnot (?:merged|pushed|released|published|deployed|reviewed) yet\b/i,
+    /\bpushed and not merged\b/i,
+    /\b(?:today|tomorrow|yesterday|tonight|this (?:morning|afternoon|evening|week))\b/i,
+    /\b(?:waiting on|blocked on|still open|awaiting review|in review)\b/i,
+];
+/** A reason: a cause, an error, a number, or a word that brings one. */
+const WHY = /\b(?:because|since|so that|so|otherwise|or else|else|due to|caused?|causes|causing|means|meant|breaks?|broke|broken|fails?|failed|failing|errors?|exceptions?|crash(?:es|ed)?|hangs?|leaks?|slow(?:er)?|faster|cheaper|costs?|instead|to avoid|to keep|to stop|to prevent|in order to|unless|only if|rejects?|refuses?|blocks?|loses?|lost|drops?|wipes?|overwrites?|but|though|doubles?|twice|half|latency|memory|wrong|incorrect|missing|stale|races?|timeouts?|times out|deadlocks?|conflicts?|regress(?:es|ion)?|can't|cannot|won't|doesn't|don't|isn't|aren't|never)\b|\d|["“][^"”]{4,}["”]|→|=>/i;
+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 words(s) {
+    return new Set(s.toLowerCase().split(/[^a-z0-9_]+/).filter((t) => t.length >= 3 && !STOP.has(t)));
+}
+function jaccard(a, b) {
+    if (!a.size || !b.size)
+        return 0;
+    let both = 0;
+    for (const t of a)
+        if (b.has(t))
+            both++;
+    return both / (a.size + b.size - both);
+}
+/** The body without fenced code, which quotes errors and commands rather than saying status. */
+function prose(body) {
+    return body.replace(/```[\s\S]*?```/g, "");
+}
+/** The lines a reason belongs on: under Decided and Tried and ruled out, or the whole body when it has neither. */
+function decisionLines(body) {
+    const lines = prose(body).split(/\r?\n/);
+    const wanted = new Set([SECTIONS[0].heading.toLowerCase(), SECTIONS[1].heading.toLowerCase()]);
+    const out = [];
+    let section = null;
+    let sawSection = false;
+    for (const raw of lines) {
+        const l = raw.trim();
+        const h = /^#{1,6}\s+(.*)$/.exec(l);
+        if (h) {
+            section = h[1].trim().toLowerCase();
+            if (wanted.has(section))
+                sawSection = true;
+            continue;
+        }
+        if (l && section && wanted.has(section))
+            out.push(l);
+    }
+    if (sawSection)
+        return out;
+    return lines.map((l) => l.trim()).filter((l) => l && !l.startsWith("#"));
+}
+function clip(s, n = 70) {
+    const t = s.trim().replace(/^[-*]\s+/, "");
+    return t.length > n ? `${t.slice(0, n - 1).trimEnd()}…` : t;
+}
+/** The learning this one repeats: same files, and much the same title or text. */
+export function repeatOf(input, existing) {
+    const files = new Set(input.touches.map((t) => t.split("#")[0]));
+    const title = words(input.title);
+    const body = words(input.body);
+    for (const n of existing) {
+        if (input.replaces && n.id === input.replaces)
+            continue;
+        const shared = n.touches.some((t) => files.has(t.split("#")[0]));
+        const sameTitle = jaccard(title, words(n.title));
+        const sameBody = jaccard(body, words(n.body));
+        if (shared ? sameTitle >= 0.5 || sameBody >= 0.5 : (input.personal || !files.size) && sameTitle >= 0.6)
+            return n;
+    }
+    return null;
+}
+/** The checks, on a learning about to be saved. `existing`: the learnings already there. */
+export function gateNote(input, existing) {
+    const problems = [];
+    const warnings = [];
+    const text = `${input.title}\n${prose(input.body)}`;
+    if (!input.personal) {
+        const code = input.files.filter((f) => !trailOwnPath(f));
+        const onlyTrail = input.files.length > 0 && code.length === 0;
+        if (!code.length && !input.namesSymbol) {
+            problems.push(SETUP_TALK.test(text) || onlyTrail
+                ? "It reads as a note about setting trail up, not this repo's code. Skip it, or keep it with --personal if it's about your machine."
+                : "It names no file or function in this repo. Name what it's about (`src/x.ts`, `parseConfig`), so a teammate's Claude gets it when it opens that file.");
+        }
+    }
+    for (const line of text.split(/\r?\n/)) {
+        if (STATUS.some((re) => re.test(line))) {
+            problems.push(`"${clip(line)}" is status: true today, wrong next week. Keep what stays true (the cause, the rule, the why) and put status in the PR.`);
+            break;
+        }
+    }
+    if (!input.personal && !decisionLines(input.body).some((l) => WHY.test(l))) {
+        problems.push('No line says why. Give each decision its reason: the cause, the error it hit, or the number that settled it ("because…", "otherwise…", "fails with…").');
+    }
+    const twin = repeatOf(input, existing);
+    if (twin) {
+        problems.push(`It repeats ${notePlace(twin)} ("${clip(twin.title, 50)}"${twin.author ? `, ${twin.author}` : ""}, ${shortDate(twin.date)}). If it updates that one, add --replaces ${noteName(twin)}: the old file stays as the record and yours is read instead. If it's different, say how in the title.`);
+    }
+    const count = input.body.split(/\s+/).filter(Boolean).length;
+    if (count > LONG_NOTE_WORDS)
+        warnings.push(`long: ${count} words. Long learnings get skimmed; cut it to the fact and the why.`);
+    return { problems, warnings };
+}
+/** `parseConfig`, `Client.Do`, `default_retry_max`, `retry()`: words in a note shaped like code. */
+const BACKTICKED = /`([A-Za-z_$][\w$]*(?:(?:\.|::|#)[A-Za-z_$][\w$]*)*)(?:\(\))?`/g;
+const CODE_SHAPED = /\b([a-z]+[A-Z][\w]*|[A-Z][a-z0-9]+[A-Z][\w]*|[a-z][a-z0-9]*_[a-z0-9_]+|[A-Za-z_]\w*(?=\(\)))\b/g;
+/** The names a note uses that might be symbols, most likely first: backticked, then code-shaped. At most `limit`. */
+export function symbolCandidates(text, limit = 8) {
+    const out = [];
+    const add = (s) => {
+        const name = s.split(/\.|::|#/).pop();
+        if (name.length < 3 || /\.[A-Za-z]{1,5}$/.test(s) || out.includes(name))
+            return;
+        out.push(name);
+    };
+    for (const m of text.matchAll(BACKTICKED))
+        add(m[1]);
+    for (const m of text.matchAll(CODE_SHAPED))
+        add(m[1]);
+    return out.slice(0, limit);
+}
+/**
+ * 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 function namesRepoSymbol(repo, names) {
+    if (!names.length)
+        return false;
+    for (const name of names) {
+        try {
+            execFileSync("git", ["grep", "-q", "-w", "-F", "-e", name, "--", ".", ":(exclude).trail", ":(exclude).claude", ":(exclude)*.md"], {
+                cwd: repo,
+                stdio: "ignore",
+            });
+            return true;
+        }
+        catch {
+            /* not found, or not a repo */
+        }
+    }
+    return false;
+}
+/**
+ * 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 function trackedFiles(repo, files) {
+    if (!files.length)
+        return new Set();
+    try {
+        const out = execFileSync("git", ["ls-files", "-z", "--", ...files], { cwd: repo, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] });
+        return new Set(out.split("\0").filter(Boolean));
+    }
+    catch {
+        return new Set(files.filter((f) => existsSync(join(repo, f))));
+    }
+}
+//# sourceMappingURL=note-gate.js.map

package/dist/notes/note-gate.js.map

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