@nanonets/graft 0.24.0 → 0.25.0

package/dist/init/discover-worker.js

@@ -0,0 +1,111 @@
+/**
+ * Discovery and the look-back off the main thread: `trail init` keeps wiring
+ * and building the graph (and its spinner keeps turning) while a worker
+ * reads the transcripts. The worker is this same module, started on its own
+ * file; anything that goes wrong with the thread falls back to reading on
+ * the main thread.
+ */
+import { isMainThread, parentPort, workerData, Worker } from "node:worker_threads";
+import { lookBack } from "./look-back-mine.js";
+import { discoverSessions } from "./sessions.js";
+const TAG = "trailDiscover";
+const LOOK = "trailLookBack";
+/** Past the cap, how long the main thread waits for the worker's answer before it gives up on it. */
+const GRACE_MS = 30_000;
+/** `discoverSessions(repo, home, now, env)` in a worker thread, under the Trail home `env` names. Never rejects. */
+export function discoverOffThread(repo, home, env = process.env) {
+    return new Promise((resolve) => {
+        let settled = false;
+        const done = (d) => {
+            if (settled)
+                return;
+            settled = true;
+            resolve(d);
+        };
+        const here = () => {
+            if (!settled)
+                done(discoverSessions(repo, home, new Date(), env));
+        };
+        let worker;
+        try {
+            worker = new Worker(new URL(import.meta.url), { workerData: { [TAG]: { repo, home, env: { ...env } } } });
+        }
+        catch {
+            setImmediate(here);
+            return;
+        }
+        worker.once("message", (d) => done(d));
+        worker.once("error", here);
+        worker.once("exit", here);
+    });
+}
+/**
+ * The no-model look-back (design 4.1 to 4.5) in a worker: discovery, replay, miners, how-tos and candidates, with
+ * progress every 2 s. Never rejects: a worker that can't start (or can't load this module) runs it here; one that dies or overruns its cap by
+ * 30 s gives an empty look-back that says so.
+ */
+export function lookBackOffThread(dir, opts) {
+    const { onProgress, ...plain } = opts;
+    const empty = (why) => ({
+        sessions: [], skipped: [], days: 0, from: null, to: null, parent: 0, candidates: [], alreadyKept: { here: 0, elsewhere: [] }, howtos: [], ms: 0,
+        errors: [`couldn't read your past sessions this time (${why})`],
+    });
+    return new Promise((resolve) => {
+        let settled = false;
+        let timer;
+        const done = (lb) => {
+            if (settled)
+                return;
+            settled = true;
+            if (timer)
+                clearTimeout(timer);
+            resolve(lb);
+        };
+        let worker;
+        try {
+            worker = new Worker(new URL(import.meta.url), { workerData: { [LOOK]: { dir, opts: { ...plain, env: { ...plain.env } } } } });
+        }
+        catch {
+            setImmediate(() => done(lookBack(dir, opts)));
+            return;
+        }
+        timer = setTimeout(() => {
+            done(empty("out of time"));
+            void worker.terminate();
+        }, Math.max(0, opts.capMs) + GRACE_MS);
+        timer.unref?.();
+        worker.on("message", (m) => {
+            if (m?.progress && onProgress) {
+                try {
+                    onProgress(m.progress);
+                }
+                catch { /* a progress line never stops the look-back */ }
+            }
+            if (m?.done)
+                done(m.done);
+        });
+        worker.once("error", (e) => {
+            // A worker that can't load this module (Node 20 runs a .ts source only on the main thread) never started: run it here.
+            if (e?.code === "ERR_UNKNOWN_FILE_EXTENSION") {
+                if (!settled)
+                    done(lookBack(dir, opts));
+                return;
+            }
+            done(empty(e instanceof Error ? e.message.slice(0, 80) : "the reader stopped"));
+        });
+        worker.once("exit", () => done(empty("the reader stopped")));
+    });
+}
+if (!isMainThread && workerData && typeof workerData === "object") {
+    const data = workerData;
+    if (TAG in data) {
+        const { repo, home, env } = data[TAG];
+        parentPort?.postMessage(discoverSessions(repo, home, new Date(), env ?? process.env));
+    }
+    else if (LOOK in data) {
+        const { dir, opts } = data[LOOK];
+        const lb = lookBack(dir, { ...opts, onProgress: (p) => parentPort?.postMessage({ progress: p }) });
+        parentPort?.postMessage({ done: lb });
+    }
+}
+//# sourceMappingURL=discover-worker.js.map

package/dist/init/discover-worker.js.map

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

package/dist/init/handover.d.ts

@@ -0,0 +1,16 @@
+import { type PendingItem } from './init-record.js';
+import type { InitItem } from './types.js';
+/**
+ * A pending item as the relay shows it again: its plain name, or the person's line read now by its pointer (title ''
+ * when that line is gone). Shared with `trail keep`, which names the same items.
+ */
+export declare function pendingAsItem(p: PendingItem, env: NodeJS.ProcessEnv): InitItem;
+/**
+ * The context to add at this session's start, or null. Writes the record: `handedAt` and `handover` the first time;
+ * `pending` dropped when another session already had it. Never throws.
+ */
+export declare function initHandover(repoKey: string, session: {
+    id: string;
+    transcriptPath: string | null;
+}, env?: NodeJS.ProcessEnv, now?: Date): string | null;
+//# sourceMappingURL=handover.d.ts.map

package/dist/init/handover.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handover.d.ts","sourceRoot":"","sources":["../../src/init/handover.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAyD,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAM3G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,QAAQ,CAW9E;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,EACxI,GAAG,GAAE,IAAiB,GAAG,MAAM,GAAG,IAAI,CAkCvC"}

package/dist/init/handover.js

@@ -0,0 +1,92 @@
+/**
+ * The init handover (design 3.1 step 10, 4.8, J02 leg C), for b7's
+ * SessionStart to call: when a relay's list waits unanswered, the next
+ * interactive session in this repo gets the same list once, numbers
+ * unchanged, titles rebuilt from the record (a preference's line read again
+ * by its pointer), and the record notes that session and its transcript's
+ * size, from which the keep gate reads (R22). A later session says nothing
+ * and drops the list: its items become never-shown (P10).
+ *
+ * Light on purpose (it runs inside the SessionStart budget): the record, at
+ * most 5 positioned reads, no replay or compile. When a list waits to be
+ * handed over, the session's own transcript tail is read once (keep-list's
+ * `findList`): the session that showed the list, resumed, is not handed it
+ * again (fix-lab5).
+ */
+import { statSync } from 'node:fs';
+import { directive } from '../skills/directive-words.js';
+import { HOOK_RECORD_WAIT_MS, readInitRecord, updateInitRecord } from './init-record.js';
+import { leadWords, replyNamesList } from './keep-answer.js';
+import { isInitCommand } from './keep-gate.js';
+import { findList, typedLine } from './keep-list.js';
+import { prefText } from './prefs.js';
+import { fill, INIT_COPY, relayBlock, repoNameOf } from './review-screen.js';
+/**
+ * A pending item as the relay shows it again: its plain name, or the person's line read now by its pointer (title ''
+ * when that line is gone). Shared with `trail keep`, which names the same items.
+ */
+export function pendingAsItem(p, env) {
+    let title = p.plainName;
+    if (p.kind === 'preference') {
+        const ref = p.pref?.refs[0];
+        const text = ref ? typedLine(ref, env) : null;
+        title = text ? prefText(text).slice(0, 120) : '';
+    }
+    return {
+        ...p, title, description: '', evidence: [], rank: 0, nameWords: p.kind === 'preference' ? leadWords(title) : p.nameWords,
+        ...(p.skill ? { skill: { src: p.skill.src, ...(p.skill.branches ? { branches: p.skill.branches } : {}) } } : {}),
+    };
+}
+/** This session's transcript already holds a clean `trail init` call's list naming every pending item. */
+function holdsList(path, all) {
+    if (!path)
+        return false;
+    const found = findList(path, isInitCommand, null);
+    const list = found?.list;
+    return !!list && list.via === 'init-call' && replyNamesList(list.text, all.map((i) => ({ n: i.n, nameWords: i.nameWords })));
+}
+/**
+ * The context to add at this session's start, or null. Writes the record: `handedAt` and `handover` the first time;
+ * `pending` dropped when another session already had it. Never throws.
+ */
+export function initHandover(repoKey, session, env = process.env, now = new Date()) {
+    try {
+        const r = readInitRecord(repoKey, env);
+        if (!r.pending.length || !r.shownAt || !r.pendingFrom)
+            return null;
+        if (r.handedAt) {
+            if (r.handover?.session !== session.id) {
+                updateInitRecord(repoKey, (x) => {
+                    x.pending = [];
+                    x.pendingFrom = null;
+                    x.shownAt = null;
+                    x.handedAt = null;
+                    x.handover = null;
+                }, env, HOOK_RECORD_WAIT_MS);
+            }
+            return null;
+        }
+        const items = r.pending.slice(0, 5).map((p) => pendingAsItem(p, env)).filter((x) => x.title !== '');
+        if (!items.length)
+            return null;
+        // fix-lab5: the session that showed this list, resumed (every `claude -p` turn is one), already holds it. Handing
+        // it over again would make the person's next typed line read as before the list. Another session still gets it.
+        if (holdsList(session.transcriptPath, r.pending.map((p) => pendingAsItem(p, env))))
+            return null;
+        let offset = 0;
+        try {
+            offset = session.transcriptPath ? statSync(session.transcriptPath).size : 0;
+        }
+        catch { /* no transcript yet: from its start */ }
+        updateInitRecord(repoKey, (x) => {
+            x.handedAt = now.toISOString();
+            x.handover = { session: session.id, offset };
+        }, env, HOOK_RECORD_WAIT_MS);
+        const block = relayBlock(items, repoNameOf(repoKey), true);
+        return [directive(null, fill(INIT_COPY.handover, { k: items.length })), ...block.slice(1)].join('\n');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=handover.js.map

package/dist/init/handover.js.map

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

package/dist/init/howtos.d.ts

@@ -0,0 +1,20 @@
+import type { JobClass } from '../trace/types.js';
+/** Reads ~/.claude/projects/<key>/memory/*.md for each discovered project key. Never writes. */
+export declare function readHowtos(projectKeys: string[], claudeHome: string): Array<{
+    file: string;
+    text: string;
+}>;
+/**
+ * Evidence for a skill candidate: the first how-to with a paragraph that names one of the job's programs and one of
+ * its words (`npm publish` with release). The file name, or null.
+ */
+export declare function howtoDescribes(h: Array<{
+    file: string;
+    text: string;
+}>, job: JobClass, programs: string[]): string | null;
+/** True when a how-to line already says the preference (content-word Jaccard 0.5, 4.4 step 5). */
+export declare function howtoKnows(h: Array<{
+    file: string;
+    text: string;
+}>, prefText: string): boolean;
+//# sourceMappingURL=howtos.d.ts.map

package/dist/init/howtos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"howtos.d.ts","sourceRoot":"","sources":["../../src/init/howtos.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA8BlD,gGAAgG;AAChG,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAmB3G;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAWzH;AAED,kGAAkG;AAClG,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAO9F"}

package/dist/init/howtos.js

@@ -0,0 +1,90 @@
+/**
+ * Claude Code's how-to files (design 4.5, P34): the `memory/*.md` files
+ * Claude Code keeps beside a project's transcripts. Init reads them, never
+ * writes them, and never sends or copies their text: a how-to that already
+ * describes a job is evidence on the skill's line (its file name only), and
+ * a preference a how-to already says is not offered again.
+ */
+import { lstatSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { readPlain } from './plain-file.js';
+import { contentWords, jaccard, SAME_WORDS } from './prefs.js';
+const MAX_FILES = 50;
+const MAX_BYTES = 64 * 1024;
+const KEY = /^[A-Za-z0-9._ -]{1,255}$/;
+/** A how-to's file name is shown as evidence ("your Claude Code how-to {file} describes it"): a plain name only. */
+const FILE = /^[A-Za-z0-9][\w. -]{0,80}\.md$/;
+/** A real folder, not a link to one. */
+const realDir = (p) => {
+    try {
+        return lstatSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+/** Words that say a how-to is about a job (beside one of the job's programs). */
+const JOB_WORDS = {
+    release: ['release', 'releasing', 'publish', 'publishing', 'version', 'bump'],
+    ship: ['ship', 'deploy', 'deploying', 'prod', 'production', 'beta', 'staging', 'promote'],
+    tests: ['test', 'tests', 'suite', 'e2e', 'integration'],
+    report: ['report', 'users', 'signups', 'query'],
+    'pr-green': ['ci', 'checks'],
+    sweep: ['sweep', 'prs', 'issues'],
+    'run-local': ['locally', 'localhost', 'dev'],
+};
+/** Reads ~/.claude/projects/<key>/memory/*.md for each discovered project key. Never writes. */
+export function readHowtos(projectKeys, claudeHome) {
+    const out = [];
+    for (const key of new Set(projectKeys)) {
+        if (!KEY.test(key) || key === '.' || key === '..' || key.includes('..'))
+            continue;
+        // Never through a link: a linked project or memory folder can bring in any file (b5 review).
+        if (!realDir(join(claudeHome, 'projects', key)) || !realDir(join(claudeHome, 'projects', key, 'memory')))
+            continue;
+        const dir = join(claudeHome, 'projects', key, 'memory');
+        let names;
+        try {
+            names = readdirSync(dir).filter((f) => FILE.test(f)).sort().slice(0, MAX_FILES);
+        }
+        catch {
+            continue;
+        }
+        for (const file of names) {
+            const text = readPlain(join(dir, file), MAX_BYTES);
+            if (text !== null)
+                out.push({ file, text });
+        }
+    }
+    return out;
+}
+const wordsOf = (t) => new Set(t.toLowerCase().split(/[^a-z0-9+_-]+/).filter(Boolean));
+/**
+ * Evidence for a skill candidate: the first how-to with a paragraph that names one of the job's programs and one of
+ * its words (`npm publish` with release). The file name, or null.
+ */
+export function howtoDescribes(h, job, programs) {
+    const jobWords = JOB_WORDS[job] ?? [];
+    const progs = programs.map((p) => p.toLowerCase()).filter(Boolean);
+    if (!progs.length)
+        return null;
+    for (const { file, text } of h) {
+        for (const para of text.split(/\n\s*\n/)) {
+            const w = wordsOf(para);
+            if (progs.some((p) => w.has(p)) && jobWords.some((j) => w.has(j)))
+                return file;
+        }
+    }
+    return null;
+}
+/** True when a how-to line already says the preference (content-word Jaccard 0.5, 4.4 step 5). */
+export function howtoKnows(h, prefText) {
+    const mine = contentWords(prefText);
+    if (!mine.length)
+        return false;
+    return h.some(({ text }) => text.split('\n').some((line) => {
+        const theirs = contentWords(line.replace(/^\s*(?:[-*+]|\d+[.)]|#+)\s*/, ''));
+        return theirs.length > 0 && jaccard(mine, theirs) >= SAME_WORDS;
+    }));
+}
+//# sourceMappingURL=howtos.js.map

package/dist/init/howtos.js.map

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

package/dist/init/init-record.d.ts

@@ -0,0 +1,134 @@
+import type { JobClass, WallClass } from '../trace/types.js';
+import type { InitKind, SkillSource, TypedRef } from './types.js';
+export declare const MAX_RUNS = 10;
+export interface InitRun {
+    id: string;
+    at: string;
+    /** Who ran it: the person at a terminal, an agent, or the person's own script (no TTY, not an agent). */
+    by: 'person' | 'agent' | 'script';
+    /** What it showed: the TTY screen, the relay (agent), or the plain list (script). */
+    screen: 'tty' | 'relay' | 'list';
+    reads: {
+        sessions: number;
+        days: number;
+        from: string | null;
+        to: string | null;
+        parent: number;
+        read: string[];
+        skipped: Array<{
+            sh: string;
+            why: string;
+        }>;
+        /** D135 (3): jobs that met moment 2's bar but didn't compile: the job, its session-days, each run's refusal code
+         *  (newest first). Codes only, no text. Left out when there are none. */
+        uncompiled?: Uncompiled[];
+    };
+    /** The model the naming call used, or 'none'. */
+    model: string;
+    /** Why no model: 'agent', 'plain', 'no-tty', 'off', 'no-skills', or a ClaudeFailure. */
+    modelWhy: string | null;
+    calls: number;
+    tokens: number;
+    ms: number;
+    shown: string[];
+    kept: string[];
+    closed: string[];
+    deferred: string[];
+}
+export interface Uncompiled {
+    job: JobClass;
+    days: number;
+    why: string[];
+}
+/** One relayed item, as written: no title, no description, no compiled skill (2.6). */
+export interface PendingItem {
+    n: number;
+    id: string;
+    kind: InitKind;
+    /** The candidate's key (no typed words: a repo key and job, a wall class, a cluster sha): what a closed skill is said no to by. */
+    key: string;
+    plainName: string;
+    nameWords: string[];
+    count: {
+        days: number;
+        from: string;
+        to: string;
+        costly?: number;
+        repos?: number;
+    };
+    applies: string;
+    scope: 'personal' | 'repo';
+    typed: boolean;
+    ticked: boolean;
+    /** `branches`: a ship skill's branch names from its check, for its job phrase when the list is handed over (D112). */
+    skill?: {
+        src: SkillSource;
+        branches?: string[];
+    };
+    guardrail?: {
+        cls: WallClass;
+        check?: 'no-timeout';
+    };
+    pref?: {
+        refs: TypedRef[];
+    };
+}
+/** D87: one item the TTY screen kept, as the next SessionStart notice names it. No typed words: a preference is its learning id. */
+export interface KeptName {
+    kind: InitKind;
+    /** The skill's or guardrail's name; '' for a preference (the notice reads its words from the learning). */
+    name: string;
+    /** The skill id or the learning id. */
+    id: string;
+    /** What `trail forget` takes to undo it. */
+    forget: string;
+}
+export interface InitRecord {
+    v: 2;
+    repo: string;
+    runs: InitRun[];
+    pending: PendingItem[];
+    pendingFrom: string | null;
+    shownAt: string | null;
+    handedAt: string | null;
+    handover: {
+        session: string;
+        offset: number;
+    } | null;
+    closed: string[];
+    closedV1: string[];
+    deferred: string[];
+    /** D87: what the last TTY screen kept, until the next SessionStart has named it (b7 sets `shownAt`). */
+    notice: {
+        run: string;
+        at: string;
+        items: KeptName[];
+        shownAt: string | null;
+    } | null;
+}
+export declare function emptyRecord(repoKey: string): InitRecord;
+/** `<trail home>/init/<repo key>.json`, one folder per key part (phase 0's place). */
+export declare function initRecordPath(repoKey: string, env?: NodeJS.ProcessEnv): string;
+/** 'ir-' + 4 hex. */
+export declare function newRunId(): string;
+/** D135 (3): the uncompiled jobs an edited record may hold, kept only when each is a known job, a count and codes. */
+export declare function uncompiledOf(v: unknown): Uncompiled[];
+/** A parsed file as a v2 record; a phase 0 (v1) file upgraded (R33). */
+export declare function recordFrom(raw: unknown, repoKey: string): InitRecord;
+/** The record for `repoKey`, v1 files upgraded; an empty one when there is none, or it can't be read as a plain file. */
+export declare function readInitRecord(repoKey: string, env?: NodeJS.ProcessEnv): InitRecord;
+export declare function writeInitRecord(repoKey: string, r: InitRecord, env?: NodeJS.ProcessEnv): void;
+/** Read, change and write back under the record's lock. Throws when the lock can't be had (another init is writing). */
+/** How long a hook waits for the record's lock (b7 review): session start has 400 ms in all; a busy record waits for the next one. */
+export declare const HOOK_RECORD_WAIT_MS = 50;
+export declare function updateInitRecord(repoKey: string, change: (r: InitRecord) => void, env?: NodeJS.ProcessEnv, waitMs?: number): InitRecord;
+export declare function pendingItems(r: InitRecord): InitRecord['pending'];
+/**
+ * Every init record on this machine, with its repo key (from its path): the keep gate's way to the record without
+ * resolving the repo (it runs on the hook's path, R11). At most 200 files, 6 folders deep, plain files only.
+ */
+export declare function listInitRecords(env?: NodeJS.ProcessEnv): Array<{
+    repoKey: string;
+    record: InitRecord;
+}>;
+//# sourceMappingURL=init-record.d.ts.map

package/dist/init/init-record.d.ts.map

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