@nanonets/graft 0.24.0 → 0.25.0

package/dist/init/transcript.js

@@ -0,0 +1,216 @@
+/**
+ * Reading one past Claude Code transcript for `trail init`'s look-back: what
+ * the person typed (g4's shared filter decides, so IDE tags and reminders are
+ * stripped and the prompt kept, pastes become a marker), each with its own
+ * time and the end of Claude's reply before it, plus the tool calls, so a
+ * session started in a folder above the repo can be judged by how much of its
+ * work was in the repo.
+ *
+ * Files are read in chunks, line by line, never whole: one real transcript
+ * passed 233 MB. Tool results are never parsed (they are most of the bytes
+ * and hold nothing the person typed), and neither is any line over 2 MB.
+ */
+import { closeSync, readSync } from "node:fs";
+import { basename } from "node:path";
+import { openPlain } from "./plain-file.js";
+import { ownText, textOf, typedText } from "../trace/claude.js";
+import { labInteractive } from "../skills/host-facts.js";
+const PROMPT_CHARS = 1200;
+const BEFORE_CHARS = 240;
+/** How much of a file's start is read to find where its session began. */
+const HEAD_BYTES = 256 * 1024;
+const CHUNK_BYTES = 4 * 1024 * 1024;
+/** No typed message or tool call worth reading is this long: a line over it is skipped unparsed. */
+const MAX_LINE = 2 * 1024 * 1024;
+const NEWLINE = 0x0a;
+/**
+ * The date an ISO time fell on where the person lives (this machine's time
+ * zone), `2026-10-09`; "" for anything else. Not the UTC date: UTC midnight
+ * is mid-afternoon in California, so a restart at 4:55 and 5:05 pm would
+ * count as two days.
+ */
+export function dayOf(iso) {
+    if (!iso || !/^\d{4}-\d{2}-\d{2}/.test(iso))
+        return "";
+    if (!/T\d{2}:\d{2}/.test(iso))
+        return iso.slice(0, 10);
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return "";
+    const two = (n) => String(n).padStart(2, "0");
+    return `${d.getFullYear()}-${two(d.getMonth() + 1)}-${two(d.getDate())}`;
+}
+/**
+ * Each complete line of `path`, in order, read in chunks, with the byte offset it starts at. `range` reads only
+ * the lines that start at or after `from` and before `to` (`from` must be a line start). Lines over 2 MB are
+ * skipped unread. Throws when the file can't be opened or isn't a plain file (a FIFO would hang the read).
+ */
+export function eachLine(path, onLine, range) {
+    // Never a FIFO or a device, even one swapped in after discovery's stat (b5 review).
+    const fd = openPlain(path, { follow: true });
+    try {
+        const buf = Buffer.allocUnsafe(CHUNK_BYTES);
+        const end = range ? Math.max(0, range.to) : Infinity;
+        let pos = range ? Math.max(0, range.from) : 0;
+        let carry = Buffer.alloc(0);
+        // A line longer than MAX_LINE is dropped as it streams by, never held whole.
+        let skipping = false;
+        // Past `to`, read on only to finish a line that started before it.
+        while (pos < end || (!skipping && carry.length > 0 && pos - carry.length < end)) {
+            const got = readSync(fd, buf, 0, CHUNK_BYTES, pos);
+            if (got <= 0)
+                break;
+            const dataStart = pos - carry.length;
+            pos += got;
+            const data = carry.length ? Buffer.concat([carry, buf.subarray(0, got)]) : buf.subarray(0, got);
+            let from = 0;
+            for (let nl = data.indexOf(NEWLINE, from); nl !== -1; nl = data.indexOf(NEWLINE, from)) {
+                const at = dataStart + from;
+                if (at >= end)
+                    return;
+                if (!skipping && nl > from && nl - from <= MAX_LINE)
+                    onLine(data.toString("utf8", from, nl), at);
+                skipping = false;
+                from = nl + 1;
+            }
+            if (data.length - from > MAX_LINE) {
+                skipping = true;
+                carry = Buffer.alloc(0);
+            }
+            else
+                carry = Buffer.from(data.subarray(from));
+        }
+        const at = pos - carry.length;
+        if (!skipping && carry.length && carry.length <= MAX_LINE && at < end)
+            onLine(carry.toString("utf8"), at);
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+/** The first `cwd` in the first 256 KB of a transcript: the folder its session started in. Null when there's none or the file can't be read. */
+export function firstCwd(path) {
+    let text;
+    try {
+        const fd = openPlain(path, { follow: true });
+        try {
+            const buf = Buffer.allocUnsafe(HEAD_BYTES);
+            text = buf.toString("utf8", 0, readSync(fd, buf, 0, HEAD_BYTES, 0));
+        }
+        finally {
+            closeSync(fd);
+        }
+    }
+    catch {
+        return null;
+    }
+    const m = /"cwd":"((?:[^"\\]|\\.)*)"/.exec(text);
+    if (!m)
+        return null;
+    try {
+        return JSON.parse(`"${m[1]}"`);
+    }
+    catch {
+        return null;
+    }
+}
+/** One message's words, cut at PROMPT_CHARS; null when there are none. */
+function capped(t) {
+    if (!t)
+        return null;
+    return t.length > PROMPT_CHARS ? `${t.slice(0, PROMPT_CHARS)}…` : t;
+}
+/** The person's message with what isn't theirs taken out (trace/claude.ts decides), or null when nothing of theirs is left. */
+export function ownWords(raw) {
+    return capped(ownText(raw));
+}
+/**
+ * One transcript's typed messages and tool calls. `touches(cwd, name, input)`
+ * says whether a tool call worked in the repo; without it every call counts
+ * as out of the repo. `env` decides only whether an sdk run is read (a lab home with the switch, D99). Never throws:
+ * an unreadable file scans as empty.
+ */
+export function scanTranscript(path, touches, env = process.env) {
+    const scan = { headless: false, prompts: [], calls: [] };
+    let i = 0;
+    let lastReply = "";
+    try {
+        eachLine(path, (line, o) => {
+            // Tool output is most of a transcript and never the person's words.
+            if (scan.headless || line.includes('"type":"tool_result"'))
+                return;
+            let e;
+            try {
+                e = JSON.parse(line);
+            }
+            catch {
+                return;
+            }
+            if (!e || typeof e !== "object")
+                return;
+            // A script's run, unless a lab home has the switch (D99, D136 (2)), as the hooks read it.
+            if (typeof e.entrypoint === "string" && e.entrypoint.startsWith("sdk") && !labInteractive(env)) {
+                scan.headless = true;
+                return;
+            }
+            if (e.isSidechain)
+                return;
+            if (e.type === "assistant") {
+                const content = e.message?.content;
+                const said = textOf(content).trim();
+                if (said)
+                    lastReply = said;
+                if (!Array.isArray(content))
+                    return;
+                for (const part of content) {
+                    if (!part || typeof part !== "object" || part.type !== "tool_use")
+                        continue;
+                    let inRepo = false;
+                    try {
+                        inRepo = touches ? touches(typeof e.cwd === "string" ? e.cwd : "", String(part.name ?? ""), part.input) : false;
+                    }
+                    catch {
+                        /* a call that can't be judged isn't in the repo */
+                    }
+                    scan.calls.push({ i: i++, o, inRepo });
+                }
+                return;
+            }
+            // The one typed-words filter every learning path shares.
+            const words = capped(typedText(e, env));
+            if (!words)
+                return;
+            scan.branch ||= e.gitBranch;
+            const before = lastReply ? lastReply.slice(-BEFORE_CHARS).replace(/\s+/g, " ").trim() : undefined;
+            const at = typeof e.timestamp === "string" ? e.timestamp : undefined;
+            scan.prompts.push({ text: words, ...(before ? { before } : {}), ...(at ? { at } : {}), i: i++, o });
+            lastReply = "";
+        });
+    }
+    catch {
+        /* unreadable: nothing in it */
+    }
+    return scan;
+}
+/** A session from scanned prompts, or null when none is left. */
+export function sessionOf(path, scan, prompts = scan.prompts, source) {
+    if (scan.headless || !prompts.length)
+        return null;
+    return {
+        id: basename(path, ".jsonl"),
+        path,
+        at: prompts.find((p) => p.at)?.at ?? "",
+        branch: scan.branch,
+        prompts: prompts.map(({ i: _i, o: _o, ...p }) => p),
+        ...(source ? { source } : {}),
+    };
+}
+/**
+ * One transcript's messages from the person, oldest first. Headless runs
+ * (`claude -p`, scripts) are skipped whole: their prompts were written once
+ * and replayed, so a repeat there isn't the person repeating themselves.
+ */
+export function readSession(path) {
+    return sessionOf(path, scanTranscript(path));
+}
+//# sourceMappingURL=transcript.js.map

package/dist/init/transcript.js.map

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

package/dist/init/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * The shapes `trail init` shares between its look-back (b5) and its screen,
+ * relay and keep (b6): candidates, the items a person sees, what the
+ * look-back read, and where an init skill came from.
+ *
+ * Types only. No typed text is ever stored in these on disk: a typed line is
+ * a pointer to it (transcript, offset, sha), and an init skill is a byte
+ * range in a host transcript plus the sha of what it compiled to.
+ */
+import type { CompiledSkill } from '../skills/types.js';
+import type { WallClass } from '../trace/types.js';
+export type InitKind = 'skill' | 'guardrail' | 'preference' | 'review' | 'claude';
+/** A pointer to a typed line. The line itself is never stored (0 rule 6). */
+export interface TypedRef {
+    /** The transcript path. */
+    t: string;
+    /** The line's byte offset. */
+    o: number;
+    /** sha256 of the line. */
+    s: string;
+}
+export interface InitCandidate {
+    /** 'i-' + sha256(kind + key) first 10 hex; stable across inits. */
+    id: string;
+    kind: InitKind;
+    /** skill: '<repoKey>|job:<class>'; guardrail: 'wall:<cls>'; preference: 'pref:<cluster sha>'. */
+    key: string;
+    /** NAME_RE for skills; a fixed title for guardrails; '' for preferences (the line is the title). */
+    plainName: string;
+    /** Lead words for the relay check (4.9 step 3): the plain name, or the first 4 content words of the person's line. */
+    nameWords: string[];
+    count: {
+        days: number;
+        from: string;
+        to: string;
+        costly?: number;
+        repos?: number;
+    };
+    scope: 'personal' | 'repo';
+    /** A repo key or 'every repo'. */
+    applies: string;
+    /** The person's own words (preferences only). */
+    typed: boolean;
+    /** Only typed preferences start ticked (D23). */
+    ticked: boolean;
+    /** The compiled skill (in memory) and where to compile it again. */
+    skill?: {
+        compiled: CompiledSkill;
+        src: SkillSource;
+    };
+    /** The template. */
+    guardrail?: {
+        cls: WallClass;
+        check?: 'no-timeout';
+    };
+    /** Up to 3, newest first. */
+    pref?: {
+        refs: TypedRef[];
+    };
+    /** D24 items, unchanged from phase 0. */
+    review?: {
+        prs: number[];
+    };
+    /** #662: the Claude Code memory note a team row came from. */
+    memory?: {
+        path: string;
+    };
+    /** Counted words for the screen, e.g. 'your how-to release-notes.md describes it'. */
+    evidence: string[];
+    rank: number;
+}
+export interface InitItem extends InitCandidate {
+    /** 1-based number on the screen or in the relay. */
+    n: number;
+    /** In memory only: the model's name, the plain name, or the person's line. */
+    title: string;
+    /** In memory only. */
+    description: string;
+}
+export interface LookBack {
+    sessions: Array<{
+        sh: string;
+        how: 'own' | 'worktree' | 'clone' | 'ancestor';
+        days: number;
+    }>;
+    skipped: Array<{
+        sh: string;
+        why: 'headless' | 'ancestor-under-30' | 'unreadable' | 'too-old' | 'scratch';
+    }>;
+    days: number;
+    from: string | null;
+    to: string | null;
+    parent: number;
+    candidates: InitCandidate[];
+    alreadyKept: {
+        here: number;
+        elsewhere: Array<{
+            repo: string;
+            n: number;
+        }>;
+    };
+    /** How-to file names read (never their text). */
+    howtos: string[];
+    ms: number;
+    /** "couldn't read {what} this time ({reason})". */
+    errors: string[];
+}
+export type KeepAnswer = {
+    numbers: number[];
+} | {
+    all: true;
+} | {
+    none: true;
+};
+/**
+ * Where an init skill came from, enough to compile it again at keep (R24). No command text: the run's own byte
+ * range in a host transcript, and the sha of the skill as compiled at init.
+ */
+export interface SkillSource {
+    /** The transcript path, realpath under ~/.claude/projects or $CLAUDE_CONFIG_DIR/projects. */
+    t: string;
+    /** When init read it. */
+    size: number;
+    mtimeMs: number;
+    /** Byte offsets: the run's first typed line to its last call. */
+    run: {
+        from: number;
+        to: number;
+    };
+    /** The prior checked run of the same job, for params. */
+    prior: {
+        t: string;
+        from: number;
+        to: number;
+    } | null;
+    /** 1a skillSha(compiled). */
+    skillSha: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/init/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/init/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/init/types.ts"],"names":[],"mappings":""}

package/dist/mcp/brains.d.ts

@@ -0,0 +1,72 @@
+/**
+ * The workspace's brains, served by the local trail MCP server.
+ *
+ * Once this machine is connected to a Trail workspace (`trail init --connect`,
+ * or `trail login`), the one `trail` MCP entry Claude Code already has also
+ * answers the workspace connector's brain tools: `list_brains`,
+ * `get_context`, `search_rules` and `get_rules`. Each call is passed to the
+ * workspace connector (`<trail>/api/v1/mcp`, MCP over streamable HTTP) with
+ * the stored token, and its answer comes back as is: every result names the
+ * brain and the rule it came from.
+ *
+ * The repo tools never wait on this. Not connected, the brain tools aren't
+ * listed; connected but offline, they're listed and answer with a soft error,
+ * while the repo tools keep working.
+ */
+import type { ToolDef } from './tools.js';
+import { type Cloud } from '../cloud/workspace.js';
+/** The workspace connector's brain tools, the only ones passed through. */
+export declare const BRAIN_TOOLS: readonly ["list_brains", "get_context", "search_rules", "get_rules"];
+export declare function isBrainTool(name: string): boolean;
+/**
+ * What's listed when the connector can't be asked for its own list (offline,
+ * slow): the same four tools, as the workspace connector describes them.
+ */
+export declare const BRAIN_TOOL_DEFS: ToolDef[];
+/** The workspace connector for a connection: TRAIL_MCP_URL, else `<trail>/api/v1/mcp`. */
+export declare function connectorUrl(cloud: Cloud, env?: NodeJS.ProcessEnv): string;
+export interface CallResult {
+    content: Array<{
+        type: string;
+        text?: string;
+        [k: string]: unknown;
+    }>;
+    isError?: boolean;
+    structuredContent?: unknown;
+}
+type Fetch = typeof fetch;
+/**
+ * A small MCP client for the workspace connector. One per server process:
+ * it initializes once, keeps a session id if the connector hands one out
+ * (it runs stateless today, so it usually doesn't), and reads the connection
+ * from `~/.trail/cloud.json` on every call, so `trail logout` or a new
+ * `--connect` takes effect without restarting the agent.
+ */
+export declare class BrainProxy {
+    private readonly opts;
+    private nextId;
+    private session;
+    private listing;
+    constructor(opts?: {
+        env?: NodeJS.ProcessEnv;
+        fetchImpl?: Fetch;
+        timeoutMs?: number;
+        version?: string;
+    });
+    private cloud;
+    /** Whether this machine is connected to a workspace, so the brain tools are offered. */
+    connected(): boolean;
+    private rpc;
+    /** Initialize once per token: a new connection starts a new session. */
+    private ready;
+    /**
+     * The brain tools to list: the connector's own definitions of the four
+     * when it answers in time, else the built-in ones. Empty when not connected.
+     * Asked once per process; the answer is reused.
+     */
+    listTools(): Promise<ToolDef[]>;
+    /** Pass one brain tool call to the workspace. Never throws: a failure is a soft error the agent can read. */
+    callTool(name: string, args: Record<string, unknown>): Promise<CallResult>;
+}
+export {};
+//# sourceMappingURL=brains.d.ts.map

package/dist/mcp/brains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brains.d.ts","sourceRoot":"","sources":["../../src/mcp/brains.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAa,KAAK,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAE9D,2EAA2E;AAC3E,eAAO,MAAM,WAAW,sEAAuE,CAAC;AAEhG,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAAO,EAyCpC,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAEvF;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC,CAAC;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,KAAK,KAAK,GAAG,OAAO,KAAK,CAAC;AAyB1B;;;;;;GAMG;AACH,qBAAa,UAAU;IAMnB,OAAO,CAAC,QAAQ,CAAC,IAAI;IALvB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAiE;IAChF,OAAO,CAAC,OAAO,CAAmC;gBAG/B,IAAI,GAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,SAAS,CAAC,EAAE,KAAK,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;IAGlH,OAAO,CAAC,KAAK;IAIb,wFAAwF;IACxF,SAAS,IAAI,OAAO;YAIN,GAAG;IA6BjB,wEAAwE;YAC1D,KAAK;IA6BnB;;;;OAIG;IACH,SAAS,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAkB/B,6GAA6G;IACvG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAmBjF"}