@nanonets/graft 0.18.0 → 0.20.0

package/dist/brain/watch.js

@@ -0,0 +1,172 @@
+import { baseUrlFor } from "./link.js";
+/** The stages, in the order they happen. The wording matches Trail's build
+ *  screen deliberately: two products describing one process differently is how
+ *  a person ends up unsure whether they are looking at the same thing. */
+export const STAGES = [
+    { id: "reach", label: "reaching the repository" },
+    { id: "read", label: "reading its history" },
+    { id: "mine", label: "mining the rules" },
+    { id: "file", label: "filing them into the brain" },
+];
+const num = (v) => (typeof v === "number" && v > 0 ? v : 0);
+/**
+ * Which stage the work is in.
+ *
+ * The rule that matters is where a failure lands. A row that never left
+ * `pending` failed at the access check; one that read 412 commits and then died
+ * failed in the miner. Reporting both as "could not reach it" would send someone
+ * to fix repository access for a problem that has nothing to do with it.
+ */
+export function stagesFrom(repo) {
+    const commits = num(repo?.commitCount);
+    const threads = num(repo?.threadCount);
+    const rules = num(repo?.ruleCount);
+    const filedSoFar = num(repo?.filedSoFar);
+    const foundSoFar = num(repo?.foundSoFar);
+    const reached = !!repo && repo.status !== "pending";
+    const readIt = commits > 0 || threads > 0;
+    // Rules that exist, whether the job has finished writing its count or not.
+    const hasRules = filedSoFar > 0 || rules > 0;
+    const filed = rules > 0;
+    const failed = repo?.status === "failed";
+    const failedAt = !failed ? null : !reached || !readIt ? "reach" : !hasRules ? "mine" : "file";
+    const order = STAGES.map((s) => s.id);
+    const state = (id) => {
+        if (failedAt === id)
+            return "failed";
+        if (failedAt && order.indexOf(id) > order.indexOf(failedAt))
+            return "waiting";
+        switch (id) {
+            case "reach":
+                return reached ? "done" : "doing";
+            case "read":
+                return readIt ? "done" : reached ? "doing" : "waiting";
+            case "mine":
+                // Done on the first slice's rules. The remaining slices are still being
+                // mined at this point, behind the prompt this watcher is about to
+                // return — which is the whole change.
+                return hasRules ? "done" : readIt ? "doing" : "waiting";
+            case "file":
+                return filed ? "done" : hasRules ? "doing" : readIt ? "waiting" : "waiting";
+        }
+    };
+    const detail = (id) => {
+        if (id === "read" && (commits || threads)) {
+            return [commits ? `${commits} commits` : null, threads ? `${threads} discussions` : null].filter(Boolean).join(", ");
+        }
+        // "so far" because the count grows with each slice that lands. Printing it
+        // as a total would promise history that has not been read yet.
+        if (id === "mine" && foundSoFar)
+            return `${foundSoFar} rules so far`;
+        if (id === "file" && rules)
+            return `${rules} rules`;
+        if (id === "file" && filedSoFar)
+            return `${filedSoFar} rules so far`;
+        return undefined;
+    };
+    return {
+        stages: STAGES.map((s) => ({ id: s.id, label: s.label, state: state(s.id), detail: detail(s.id) })),
+        ready: hasRules && !failed,
+        done: repo?.status === "completed" && filed,
+        error: failed ? (repo?.errorMessage?.trim() || "the read stopped before it finished") : null,
+    };
+}
+/**
+ * Read the repo row this brain is building.
+ *
+ * The same endpoint `fetchExpectedRepo` uses, read for its counts rather than
+ * its slug. Null on any failure, so a watcher that cannot reach the API prints
+ * nothing new rather than inventing a failure the build did not have.
+ */
+export async function fetchRepoState(link, fetchImpl = fetch) {
+    try {
+        const res = await fetchImpl(`${baseUrlFor(link)}/api/public/brains/${encodeURIComponent(link.brainId)}/repo`, {
+            headers: { authorization: `Bearer ${link.token}`, accept: "application/json" },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        if (!body.repo)
+            return null;
+        return {
+            status: String(body.repo.status ?? ""),
+            errorMessage: body.repo.error_message,
+            ruleCount: num(body.repo.rule_count),
+            commitCount: num(body.repo.commit_count),
+            threadCount: num(body.repo.thread_count),
+            filedSoFar: num(body.build?.filed_so_far),
+            foundSoFar: num(body.build?.found_so_far),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** One printable line per stage that has moved since it was last printed. */
+export function linesFor(view, already) {
+    const out = [];
+    for (const s of view.stages) {
+        // Only settled states are printed. A line per poll for a stage that is
+        // merely still running would bury the four that matter under a hundred
+        // that do not — this is a log, not a redrawn frame.
+        if (s.state !== "done" && s.state !== "failed")
+            continue;
+        const key = `${s.id}:${s.state}`;
+        if (already.has(key))
+            continue;
+        already.add(key);
+        const mark = s.state === "done" ? "✓" : "✗";
+        out.push(`  ${mark} ${s.label}${s.detail ? ` — ${s.detail}` : ""}`);
+    }
+    return out;
+}
+/**
+ * Hold until the brain has rules, printing each stage as it settles.
+ *
+ * Returns on the first rules rather than on the finished job: mining is what
+ * fails and it is done by then, and filing the rest is minutes of work nobody
+ * needs to watch. The caller prints where to see the rest.
+ *
+ * Fifteen minutes by default. That is far more than the mining now takes, and it
+ * stays generous on purpose: a watcher that gives up before the build does would
+ * report a healthy build as a timeout, which is the exact confusion this is
+ * meant to remove. Giving up says so and says the work continues, because it
+ * does.
+ */
+export async function watchBuild(link, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 15 * 60 * 1000;
+    const pollMs = opts.pollMs ?? 4000;
+    const write = opts.write ?? ((l) => console.error(l));
+    const sleep = opts.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms).unref?.()));
+    const printed = new Set();
+    const startedAt = Date.now();
+    // A row we could never read at all, as opposed to one that answered once and
+    // then stopped answering: the first is a broken link or a host that is down
+    // and is worth saying, the second is a blip the next poll usually covers.
+    let everRead = false;
+    for (;;) {
+        const repo = await fetchRepoState(link, opts.fetchImpl);
+        if (repo) {
+            everRead = true;
+            const view = stagesFrom(repo);
+            for (const line of linesFor(view, printed))
+                write(line);
+            if (view.error) {
+                write(`✗ ${view.error}`);
+                return "failed";
+            }
+            if (view.done)
+                return "completed";
+            // The ordinary ending now. The job is still filing the rules the miner
+            // has handed over, and still mining the older slices of the history, and
+            // neither is worth a terminal sitting on it.
+            if (view.ready)
+                return "building";
+        }
+        if (Date.now() - startedAt >= timeoutMs)
+            return everRead ? "timed_out" : "unreachable";
+        await sleep(pollMs);
+    }
+}
+//# sourceMappingURL=watch.js.map

package/dist/brain/watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.js","sourceRoot":"","sources":["../../src/brain/watch.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC;;0EAE0E;AAC1E,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,yBAAyB,EAAE;IACjD,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,EAAE;IAC5C,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE;IACzC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,4BAA4B,EAAE;CAC3C,CAAC;AA+CX,MAAM,GAAG,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7E;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,IAAsB;IAC/C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAEnC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACzC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;IAC1C,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,UAAU,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,KAAK,QAAQ,CAAC;IAEzC,MAAM,QAAQ,GAAmB,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;IAE9G,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,CAAC,EAAW,EAAc,EAAE;QACxC,IAAI,QAAQ,KAAK,EAAE;YAAE,OAAO,QAAQ,CAAC;QACrC,IAAI,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9E,QAAQ,EAAE,EAAE,CAAC;YACX,KAAK,OAAO;gBACV,OAAO,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YACpC,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YACzD,KAAK,MAAM;gBACT,wEAAwE;gBACxE,kEAAkE;gBAClE,sCAAsC;gBACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YAC1D,KAAK,MAAM;gBACT,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAChF,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,EAAW,EAAsB,EAAE;QACjD,IAAI,EAAE,KAAK,MAAM,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvH,CAAC;QACD,2EAA2E;QAC3E,+DAA+D;QAC/D,IAAI,EAAE,KAAK,MAAM,IAAI,UAAU;YAAE,OAAO,GAAG,UAAU,eAAe,CAAC;QACrE,IAAI,EAAE,KAAK,MAAM,IAAI,KAAK;YAAE,OAAO,GAAG,KAAK,QAAQ,CAAC;QACpD,IAAI,EAAE,KAAK,MAAM,IAAI,UAAU;YAAE,OAAO,GAAG,UAAU,eAAe,CAAC;QACrE,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnG,KAAK,EAAE,QAAQ,IAAI,CAAC,MAAM;QAC1B,IAAI,EAAE,IAAI,EAAE,MAAM,KAAK,WAAW,IAAI,KAAK;QAC3C,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,IAAI,qCAAqC,CAAC,CAAC,CAAC,CAAC,IAAI;KAC7F,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAe,EAAE,YAA0B,KAAK;IACnF,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,sBAAsB,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;YAC5G,OAAO,EAAE,EAAE,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC9E,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAM7B,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;YACtC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;YACrC,SAAS,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YACxC,WAAW,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;YACxC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;YACzC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC;SAC1C,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,QAAQ,CAAC,IAAe,EAAE,OAAoB;IAC5D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,uEAAuE;QACvE,uEAAuE;QACvE,oDAAoD;QACpD,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,SAAS;QACzD,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAS;QAC/B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjB,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAC5C,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAsBD;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAe,EAAE,OAAqB,EAAE;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAEpG,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,6EAA6E;IAC7E,4EAA4E;IAC5E,0EAA0E;IAC1E,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,SAAS,CAAC;QACR,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACxD,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YAC9B,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBACf,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;gBACzB,OAAO,QAAQ,CAAC;YAClB,CAAC;YACD,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,WAAW,CAAC;YAClC,uEAAuE;YACvE,yEAAyE;YACzE,6CAA6C;YAC7C,IAAI,IAAI,CAAC,KAAK;gBAAE,OAAO,UAAU,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,IAAI,SAAS;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC;QACvF,MAAM,KAAK,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKlF,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAWrG;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,GAAG,EAAE,QAAQ,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACtG,UAAU,CAsCZ"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/claude/init.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAKlF,OAAO,EAA6B,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CAWzD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,OAAO,CAarG;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,GAAG,EAAE,QAAQ,CAAC;IACd,2EAA2E;IAC3E,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GACtG,UAAU,CAsCZ"}

package/dist/claude/init.js

@@ -38,7 +38,9 @@ export function buildGraphIfMissing(dir, opts) {
     if (opts.build === false || !opts.cliPath || hasGraftIndex(dir))
         return false;
     try {
-        execFileSync(process.execPath, [opts.cliPath, 'build', '.'], { cwd: dir, stdio: 'inherit', timeout: 300000 });
+        // execArgv carries the loader graft itself was started with (tsx, when run
+        // from source), so the child can run a .ts entry point too.
+        execFileSync(process.execPath, [...process.execArgv, opts.cliPath, 'build', '.'], { cwd: dir, stdio: 'inherit', timeout: 300000 });
         return true;
     }
     catch {

package/dist/claude/init.js.map

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

package/dist/cli.js

@@ -19,8 +19,12 @@ import { hostIds } from "./hosts/registry.js";
 import { parseBrainArg, connectBrain, pullBrain, brainStatus } from "./brain/connect.js";
 import { rulesForPointers } from "./brain/attach.js";
 import { clearLink } from "./brain/link.js";
-import { buildLocalDigest, fetchExpectedRepo, pushDigest, repoSlugFromGit, sameRepo } from "./brain/push.js";
-import { readLink } from "./brain/link.js";
+import { buildEarlyDigest, buildLocalDigest, fetchExpectedRepo, pushDigest, pushEarlyDigest, repoSlugFromGit, sameRepo, } from "./brain/push.js";
+import { readLink, writeLink } from "./brain/link.js";
+import { withLegacyNames } from "./legacy-args.js";
+import { applyChanges, fetchAcceptedChanges, markApplied } from "./brain/claude-md.js";
+import { watchBuild } from "./brain/watch.js";
+import { openBrowser, signupUrl, startHandoff } from "./brain/signup.js";
 import { contextDirFor } from "./context/node-file.js";
 import { loadGraphCached } from "./graph/load.js";
 import { ensureFreshChildren, ensureFreshGraph, refreshNote } from "./graph/refresh.js";
@@ -39,7 +43,7 @@ import { patchBuildConfig } from "./util/state.js";
 import { normalizePathPrefix } from "./util/paths.js";
 import { latestSession, formatSessionStats, sessionInputRate } from "./claude/session-metrics.js";
 import { setInputRate } from "./context/savings.js";
-import { formatUpdateNudge, maybeRefreshInBackground, readUpdateCache, refreshUpdateCache, writeStamp } from "./upkeep.js";
+import { formatUpdateNudge, maybeRefreshInBackground, readUpdateCache, refreshUpdateCache, wiredHostIds, writeStamp } from "./upkeep.js";
 import { errorCode, filesBucket, durationBucket, formatDebug, formatStatus, firstRunNotice, isTrackedCommand, langsValue, offReason, maybeFlushInBackground, patchState, runFlush, track, trackFirstRunIfNew, } from "./telemetry/index.js";
 const program = new Command();
 const currentVersion = readCurrentVersion(import.meta.url);
@@ -815,8 +819,15 @@ program
     .option("--dry-run", "print every file init would touch, then exit without writing")
     .option("-y, --yes", "skip the picker and wire every detected agent (the pre-0.8 default)")
     .option("--no-global", "skip writes outside this repo (the ~/.codex/ config + hooks)")
-    .option("--brain <handoff>", "attach a Trail brain: <brainId>:<token> (or a bare brain id with GRAFT_BRAIN_TOKEN set)")
-    .action(async (dir, opts) => {
+    .option("--trail <handoff>", "attach a Trail: <brainId>:<token> (or a bare id with GRAFT_BRAIN_TOKEN set)")
+    .action((dir, opts) => runInitCommand(dir, opts));
+/**
+ * `graft init`. Also run by `graft trail push` on a repo graft has not been set
+ * up in — the Trail pages start people at push, and a trail whose rules no
+ * coding agent reads is only half set up. `epilogue: false` leaves out the
+ * closing banner when push is going to keep talking.
+ */
+async function runInitCommand(dir, opts, how = {}) {
     if (opts.listAgents) {
         for (const id of [...hostIds(), "claude"])
             console.log(id);
@@ -825,10 +836,10 @@ program
     // Parsed before anything is written: a mistyped handoff should cost the user
     // an error, not a half-wired repo they have to `graft uninstall` out of.
     let brainLink;
-    if (opts.brain) {
-        const parsed = parseBrainArg(opts.brain);
+    if (opts.trail) {
+        const parsed = parseBrainArg(opts.trail);
         if ("error" in parsed) {
-            console.error(`✗ --brain: ${parsed.error}`);
+            console.error(`✗ --trail: ${parsed.error}`);
             process.exitCode = 1;
             return;
         }
@@ -917,7 +928,7 @@ program
         wireTarget(target, ids, { home, cliPath, plan, opts, wantClaude });
     }
     // The brain comes last, after the graph exists: its rules are anchored to
-    // symbols, and `graft brain status` can only report how many of them resolve
+    // symbols, and `graft trail status` can only report how many of them resolve
     // once there is a graph to resolve them against.
     if (brainLink) {
         const res = await connectBrain(repo, brainLink, { home, ids });
@@ -936,15 +947,16 @@ program
     const graphs = (children.length ? children.map((c) => join(repo, c)) : [repo])
         .map((d) => loadGraphCached(contextDirFor(d, children.length ? undefined : globalDir)))
         .filter((g) => g !== null);
-    console.error("\n" +
-        formatInitEpilogue({
-            graphBuilt: graphs.length > 0,
-            nodes: graphs.reduce((n, g) => n + g.meta.nodeCount, 0),
-            edges: graphs.reduce((n, g) => n + g.meta.edgeCount, 0),
-        }));
+    if (how.epilogue !== false)
+        console.error("\n" +
+            formatInitEpilogue({
+                graphBuilt: graphs.length > 0,
+                nodes: graphs.reduce((n, g) => n + g.meta.nodeCount, 0),
+                edges: graphs.reduce((n, g) => n + g.meta.edgeCount, 0),
+            }));
     // Sorted so `claude,cursor` and `cursor,claude` aggregate as one value.
     track("init_completed", { agents: [...ids].sort().join(","), consent: consent === undefined ? "unasked" : String(consent) }, { repo });
-});
+}
 /** One repo's worth of `init` writes — the parent, then each workspace child. */
 function wireTarget(repo, ids, ctx) {
     const { home, cliPath, plan, wantClaude, opts } = ctx;
@@ -1076,9 +1088,57 @@ program
         ? `\n⚠ ${bad.length} file(s) could not be parsed and were left as-is — see above.`
         : "\n✓ graft fully removed. `graft init` re-wires from scratch.");
 });
+// `graft trail …` still works: see legacy-args.ts.
 const brain = program
-    .command("brain")
-    .description("The Trail brain attached to this repo: the rules mined from its own history");
+    .command("trail")
+    .description("The Trail attached to this repo: the rules mined from its own history");
+/**
+ * Get this repo a brain from the terminal, by sending the user through signup
+ * in their browser and catching the handoff on loopback.
+ *
+ * Returns the link, already saved, or null when the user should be left alone —
+ * every failure prints its own reason first, because the caller only needs to
+ * know whether to carry on.
+ */
+async function signUpForBrain(repo, slug) {
+    const handoff = await startHandoff();
+    const url = signupUrl({ repo: slug, port: handoff.port, state: handoff.state });
+    const startedAt = Date.now();
+    // Queued before the link is printed rather than after the outcome, because
+    // the outcome is the one thing a terminal handoff can lose: a user who reads
+    // the URL and walks away kills the process, and only an event already on disk
+    // survives that. This is the denominator; `brain_signup_settled` is not.
+    track("brain_signup_opened", {}, { repo });
+    // Printed before the browser opens, and printed whether or not it opens: on a
+    // remote shell nothing can open, and on a desktop the window sometimes lands
+    // behind the terminal. The URL is the thing that always works.
+    console.error(`· ${slug} has no brain yet. Opening your browser to make one:`);
+    console.error(`  ${url}`);
+    // A non-interactive shell has nobody to click anything, so waiting five
+    // minutes for a browser that will never come is worse than saying so now.
+    if (!process.stderr.isTTY) {
+        console.error("· not a terminal — open that link, then run `graft trail connect <brainId>:<token>` here");
+        // Its own outcome, not a timeout: nothing here could have opened a browser,
+        // so folding the two together would read as people abandoning signup when
+        // it is only a remote shell doing what it has to.
+        track("brain_signup_settled", { outcome: "no_tty", duration_bucket: durationBucket(Date.now() - startedAt) }, { repo });
+        handoff.close();
+        return null;
+    }
+    openBrowser(url);
+    console.error("· waiting for you to finish signing up…");
+    const got = await handoff.wait();
+    if ("error" in got) {
+        console.error(`✗ ${got.error}`);
+        // The category, never the sentence: `got.error` names the repo and the link.
+        track("brain_signup_settled", { outcome: got.reason, duration_bucket: durationBucket(Date.now() - startedAt) }, { repo });
+        return null;
+    }
+    writeLink(repo, got.link);
+    console.error(`✓ brain connected to ${slug}`);
+    track("brain_signup_settled", { outcome: "linked", duration_bucket: durationBucket(Date.now() - startedAt) }, { repo });
+    return got.link;
+}
 brain
     .command("connect")
     .description("Attach a brain to this repo and pull its rules")
@@ -1102,7 +1162,7 @@ brain
         // read the repo yet. Saying "0 rules" without saying why reads as a
         // failure, and the next step is the whole point.
         console.error("✓ attached this repo to the brain — it has no rules yet");
-        console.error("· run `graft brain push` to read this repository into it");
+        console.error("· run `graft trail push` to read this repository into it");
         return;
     }
     console.error(`✓ pulled ${res.ruleCount} rule(s) from ${parsed.brainId}`);
@@ -1117,7 +1177,7 @@ brain
     const repo = resolve(dir);
     const res = await pullBrain(repo, { home: homedir() });
     if (!res) {
-        console.error("· no brain attached — run `graft brain connect <brainId>:<token>`");
+        console.error("· no brain attached — run `graft trail connect <brainId>:<token>`");
         return;
     }
     if (res.warning) {
@@ -1134,19 +1194,32 @@ brain
     .description("Read THIS repo on your machine and build its brain — no GitHub App, works on private repos")
     .argument("[dir]", "target repo directory", ".")
     .option("--no-approve", "leave the mined rules as drafts for review")
+    .option("--no-watch", "return as soon as the push is sent, without following the build")
     .action(async (dir, opts) => {
     const repo = resolve(dir);
-    const link = readLink(repo);
+    // Resolved before the link, because an unlinked repo now signs up for a
+    // brain and Trail creates that brain FOR a named repository. Without a slug
+    // there is nothing to name it after — and the digest builder would fail on
+    // the same missing remote a moment later regardless.
+    const here = repoSlugFromGit(repo);
+    let link = readLink(repo);
     if (!link) {
-        console.error("· no brain attached — run `graft brain connect <brainId>:<token>` first");
-        process.exitCode = 1;
-        return;
+        if (!here) {
+            console.error("✗ this directory has no GitHub `origin` remote — graft can only push a GitHub repository today");
+            process.exitCode = 1;
+            return;
+        }
+        const signedUp = await signUpForBrain(repo, `${here.owner}/${here.name}`);
+        if (!signedUp) {
+            process.exitCode = 1;
+            return;
+        }
+        link = signedUp;
     }
     // What the website said this brain is for. Checked BEFORE any reading, so
     // standing in the wrong checkout costs a message rather than a brain full
     // of another repository's rules — a mistake that is silent afterwards,
     // because the rules look perfectly plausible, just not about your code.
-    const here = repoSlugFromGit(repo);
     const expected = await fetchExpectedRepo(link);
     if (expected && here && !sameRepo(expected.slug, `${here.owner}/${here.name}`)) {
         console.error(`✗ this brain is for ${expected.slug}, but you are in ${here.owner}/${here.name}`);
@@ -1154,16 +1227,48 @@ brain
         process.exitCode = 1;
         return;
     }
+    const label = expected?.slug ?? (here ? `${here.owner}/${here.name}` : "this repository");
+    console.error(`· reading ${label} — commit messages, pull-request discussion and the docs in the tree.`);
+    console.error("  No file contents leave this machine.");
+    // The instruction file and the newest pull requests go first, when the brain
+    // takes them: its CLAUDE.md suggestions start from those while the rest of
+    // the history is still being read here. Not awaited — the full read starts
+    // at once, reusing the threads the early one already fetched.
+    let early = Promise.resolve();
+    let knownThreads = [];
+    if (expected?.earlyUpload) {
+        const first = await buildEarlyDigest(repo);
+        if (first) {
+            knownThreads = first.threads;
+            early = pushEarlyDigest(link, first.digest).then((ok) => {
+                if (ok)
+                    console.error("· CLAUDE.md suggestions are on their way in your browser, from the newest pull requests");
+            });
+        }
+    }
+    // A repo graft was never set up in gets `graft init` first — after the early
+    // upload has gone, so the CLAUDE.md suggestions are not held up by the graph
+    // build. Same picker as init: it is how someone agrees to what gets written,
+    // so a non-interactive push only says what to run.
+    if (wiredHostIds(repo).length === 0) {
+        if (process.stdin.isTTY && process.stderr.isTTY) {
+            // Its one line of output lands before the picker, not across it.
+            await early;
+            console.error("· graft is not set up in this repo yet — setting it up first, the same as `graft init`");
+            await runInitCommand(repo, { build: true, mcp: true, hooks: true, statusline: true, global: true }, { epilogue: false });
+        }
+        else {
+            console.error("· graft is not set up in this repo — run `graft init` so your coding agent reads these rules");
+        }
+    }
     // The graph is what symbol anchors are resolved against, so a rule mined
     // here can later go stale on its own. Without one the ingest still works;
     // its rules simply govern the repo rather than a symbol in it.
     const graph = loadGraphCached(contextDirFor(repo, program.opts().dir));
     if (!graph)
         console.error("· no graph yet — run `graft build` first so rules can be anchored to symbols");
-    const label = expected?.slug ?? (here ? `${here.owner}/${here.name}` : "this repository");
-    console.error(`· reading ${label} — commit messages, pull-request discussion and the docs in the tree.`);
-    console.error("  No file contents leave this machine.");
-    const built = await buildLocalDigest(repo, graph, { autoApprove: opts.approve !== false });
+    const built = await buildLocalDigest(repo, graph, { autoApprove: opts.approve !== false, knownThreads });
+    await early;
     if ("error" in built) {
         console.error(`✗ ${built.error}`);
         process.exitCode = 1;
@@ -1181,8 +1286,106 @@ brain
     }
     const brainLabel = expected?.brainName ? `“${expected.brainName}”` : link.brainId;
     console.error(`✓ sent ${d.owner}/${d.name} to ${brainLabel}`);
-    console.error("· it is being mined into rules now — a few minutes. Watch it finish in your browser.");
-    console.error("  The rules reach this repo on their own; nothing else to run.");
+    // Held rather than handed back. Everything above this line succeeded even
+    // in the runs that end badly: the push lands, and then the miner fails —
+    // which is where roughly a third of production's repo brains die. Returning
+    // the prompt here is what made that invisible from this side, on CI and
+    // over SSH permanently so. `--no-watch` is for a caller that genuinely
+    // wants fire-and-forget, and it prints the old two lines instead.
+    if (opts.watch === false) {
+        console.error("· it is being mined into rules now — a few minutes. Watch it finish in your browser.");
+        console.error("  The rules reach this repo on their own; nothing else to run.");
+        return;
+    }
+    console.error("· building the brain — Ctrl-C detaches, it keeps going without you");
+    const outcome = await watchBuild(link);
+    if (outcome === "completed") {
+        console.error("✓ the brain is built — its rules reach this repo on their own; nothing else to run");
+        return;
+    }
+    // The ordinary ending for anything but a small repository. The history is
+    // mined in slices, and the prompt comes back on the first of them: mining is
+    // the part that fails and it has now succeeded, and the rest is filing,
+    // which is minutes of reliable work nobody gains by watching. The rules
+    // already in the brain are already being served.
+    if (outcome === "building") {
+        console.error("✓ the brain has its first rules — they reach this repo on their own; nothing else to run");
+        console.error("  The rest of the history is still being read. Watch it fill in your browser.");
+        return;
+    }
+    if (outcome === "failed") {
+        // A non-zero exit, unlike every other ending here: this is the one case
+        // where the work did not produce a brain, and a CI step that ran the push
+        // should hear about it the way it hears about any other failure.
+        console.error("  Nothing was lost — the brain is still there. Run `graft trail push` again to retry the read.");
+        process.exitCode = 1;
+        return;
+    }
+    if (outcome === "unreachable") {
+        console.error("· could not reach Trail to follow the build — it is still running. Watch it finish in your browser.");
+        return;
+    }
+    console.error("· still building after 15 minutes — it has not failed, it is just long. Watch it finish in your browser.");
+});
+const claudeMd = program
+    .command("claude-md")
+    .description("The CLAUDE.md changes this repo's brain suggested and you accepted in Trail");
+claudeMd
+    .command("pull")
+    .description("Write the CLAUDE.md changes you accepted in Trail into this repo's instruction file")
+    .argument("[dir]", "target repo directory", ".")
+    .option("--dry-run", "show what would change without writing the file or telling Trail")
+    .action(async (dir, opts) => {
+    const repo = resolve(dir);
+    const link = readLink(repo);
+    if (!link) {
+        console.error("✗ this repo has no brain attached — run `graft trail push` first");
+        process.exitCode = 1;
+        return;
+    }
+    const pulled = await fetchAcceptedChanges(link);
+    if ("error" in pulled) {
+        console.error(`✗ ${pulled.error}`);
+        process.exitCode = 1;
+        return;
+    }
+    if (pulled.changes.length === 0) {
+        console.error("· nothing accepted yet — accept suggestions on the brain's CLAUDE.md page, then pull again");
+        return;
+    }
+    // The file Trail read, or a new CLAUDE.md when the repo had none.
+    const rel = pulled.path || "CLAUDE.md";
+    const file = join(repo, rel);
+    const { existsSync, readFileSync, writeFileSync } = await import("node:fs");
+    const before = existsSync(file) ? readFileSync(file, "utf8") : "";
+    const result = applyChanges(before, pulled.changes);
+    for (const c of result.written)
+        console.error(`  + ${c.kind === "add" ? "new section" : "edit"} · ${c.heading}`);
+    for (const c of result.present)
+        console.error(`  = already in the file · ${c.heading}`);
+    for (const s of result.skipped)
+        console.error(`  ! skipped · ${s.change.heading} — ${s.why}`);
+    if (opts.dryRun) {
+        console.error(`· dry run: ${result.written.length} change(s) would be written to ${rel}; nothing was written`);
+        return;
+    }
+    if (result.written.length > 0)
+        writeFileSync(file, result.text);
+    // Written now or already there: either way the page should stop listing it.
+    const done = [...result.written, ...result.present].map((c) => c.id);
+    const told = await markApplied(link, done);
+    if (result.written.length > 0) {
+        console.error(`✓ wrote ${result.written.length} change(s) to ${rel} — review and commit it like any other edit`);
+    }
+    else if (result.present.length > 0) {
+        console.error(`✓ ${rel} already has every accepted change`);
+    }
+    if (!told)
+        console.error("⚠ could not tell Trail which changes were written; the page may still list them");
+    if (result.skipped.length > 0) {
+        console.error(`· ${result.skipped.length} change(s) no longer match the local file — edit them on the CLAUDE.md page, or apply them by hand`);
+        process.exitCode = 1;
+    }
 });
 brain
     .command("status")
@@ -1203,7 +1406,7 @@ brain
         return;
     }
     if (!link) {
-        console.error("· no brain attached — run `graft brain connect <brainId>:<token>`");
+        console.error("· no brain attached — run `graft trail connect <brainId>:<token>`");
         return;
     }
     console.error(`brain ${link.brainId}`);
@@ -1229,7 +1432,7 @@ brain
     clearLink(resolve(dir));
     console.error(`✓ detached the brain from ${repo}`);
 });
-program.parseAsync().catch((err) => {
+program.parseAsync(withLegacyNames(process.argv)).catch((err) => {
     console.error(err instanceof Error ? err.message : err);
     process.exit(1);
 });