@nanonets/graft 0.21.1 → 0.22.1

package/dist/brain/wire.d.ts

@@ -1,38 +0,0 @@
-import { type HostTarget } from '../hosts/registry.js';
-import { type UpsertAction } from '../hosts/sections.js';
-import type { BrainRule } from './link.js';
-/** What a rules write did to one host's file. */
-export interface BrainWrite {
-    id: string;
-    path: string;
-    action: UpsertAction;
-}
-/**
- * Render the rules block for an instruction file.
- *
- * Grouped by the file the rule governs, because that is how someone reads a
- * codebase, and repo-wide rules (no symbol) come first — they apply everywhere,
- * so they should not be buried under a path heading.
- */
-export declare function renderBrainSection(rules: BrainRule[], repoLabel: string): string;
-/**
- * Every instruction file a brain section should go in.
- *
- * `section`-kind hosts only. An `owned`-kind host (Cursor's `.mdc`, Kiro's
- * steering file, a `SKILL.md`) is a file graft rewrites whole from a pure
- * template, so a second managed region inside one would be erased by the next
- * `init` — those agents get their rules through `graft ask` instead, which they
- * all call.
- *
- * Deduplicated by path: three hosts target `AGENTS.md`, and writing it three
- * times in one pass is just three identical upserts.
- */
-export declare function brainSectionTargets(repo: string, home: string, ids?: string[]): HostTarget[];
-/**
- * Write the brain's rules into each selected host's instruction file.
- *
- * Best-effort per file: one unwritable path must not stop the rest, since a
- * partially delivered rulebook is strictly better than none.
- */
-export declare function writeBrainSections(repo: string, home: string, rules: BrainRule[], repoLabel: string, ids?: string[]): BrainWrite[];
-//# sourceMappingURL=wire.d.ts.map

package/dist/brain/wire.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wire.d.ts","sourceRoot":"","sources":["../../src/brain/wire.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwC,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC7F,OAAO,EAAgC,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAK3C,iDAAiD;AACjD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAqChF;AAiBD;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAa5F;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAAE,EAClB,SAAS,EAAE,MAAM,EACjB,GAAG,CAAC,EAAE,MAAM,EAAE,GACb,UAAU,EAAE,CAed"}

package/dist/brain/wire.js

@@ -1,133 +0,0 @@
-/**
- * Writing a brain's rules into the instruction file each coding agent already
- * reads.
- *
- * Two delivery paths exist and both matter. Every `graft ask` carries the rules
- * for the symbols in its answer — that is the precise one. This is the broad
- * one: the repo-wide conventions, sitting in `AGENTS.md` / `CLAUDE.md` /
- * `.cursor/rules` where the agent picks them up whether or not it ever calls
- * graft.
- *
- * The rules land in their OWN fenced block (`BRAIN_MARKERS`), never inside the
- * instruction block: instructions are static and rewritten by `init`, rules
- * change whenever the brain does, and `uninstall` has to be able to remove
- * either one.
- */
-import { join } from 'node:path';
-import { HOSTS, detectHosts } from '../hosts/registry.js';
-import { upsertSection, BRAIN_MARKERS } from '../hosts/sections.js';
-import { statSync } from 'node:fs';
-/** How many rules go into an instruction file. */
-const MAX_FILE_RULES = 40;
-/**
- * Render the rules block for an instruction file.
- *
- * Grouped by the file the rule governs, because that is how someone reads a
- * codebase, and repo-wide rules (no symbol) come first — they apply everywhere,
- * so they should not be buried under a path heading.
- */
-export function renderBrainSection(rules, repoLabel) {
-    const capped = rules.slice(0, MAX_FILE_RULES);
-    const lines = [
-        '## House rules for this codebase',
-        '',
-        `Mined from ${repoLabel}'s own history — commit messages and pull-request`,
-        'discussion — by Trail. These are decisions the team has already made, so',
-        'follow them and do not re-litigate them in passing. Each is attributed to',
-        'what established it.',
-        '',
-    ];
-    const byFile = new Map();
-    for (const r of capped) {
-        // A node id is `<path>#<QualifiedName>`; everything before the '#' is the file.
-        const file = r.symbol.includes('#') ? r.symbol.slice(0, r.symbol.indexOf('#')) : '';
-        const bucket = byFile.get(file);
-        if (bucket)
-            bucket.push(r);
-        else
-            byFile.set(file, [r]);
-    }
-    const general = byFile.get('') ?? [];
-    for (const r of general)
-        lines.push(`- ${r.rule}${r.sourceUrl ? ` (${r.sourceUrl})` : ''}`);
-    if (general.length)
-        lines.push('');
-    for (const [file, group] of [...byFile].filter(([f]) => f !== '').sort()) {
-        lines.push(`### ${file}`);
-        for (const r of group)
-            lines.push(`- ${r.rule}${r.sourceUrl ? ` (${r.sourceUrl})` : ''}`);
-        lines.push('');
-    }
-    if (rules.length > capped.length) {
-        lines.push(`_${rules.length - capped.length} more rules apply to specific symbols; graft attaches those to each \`graft ask\` answer._`);
-    }
-    return lines.join('\n').trimEnd();
-}
-/** Build the probe `detectHosts` needs. Mirrors hosts/init.ts's own. */
-function probeFor(repo, home) {
-    return {
-        home,
-        repo,
-        dirExists: (p) => {
-            try {
-                return statSync(p).isDirectory();
-            }
-            catch {
-                return false;
-            }
-        },
-    };
-}
-/**
- * Every instruction file a brain section should go in.
- *
- * `section`-kind hosts only. An `owned`-kind host (Cursor's `.mdc`, Kiro's
- * steering file, a `SKILL.md`) is a file graft rewrites whole from a pure
- * template, so a second managed region inside one would be erased by the next
- * `init` — those agents get their rules through `graft ask` instead, which they
- * all call.
- *
- * Deduplicated by path: three hosts target `AGENTS.md`, and writing it three
- * times in one pass is just three identical upserts.
- */
-export function brainSectionTargets(repo, home, ids) {
-    const selected = ids?.length
-        ? HOSTS.filter((h) => ids.includes(h.id))
-        : detectHosts(probeFor(repo, home));
-    const seen = new Set();
-    const out = [];
-    for (const h of selected) {
-        if (h.kind !== 'section')
-            continue;
-        if (seen.has(h.relPath))
-            continue;
-        seen.add(h.relPath);
-        out.push(h);
-    }
-    return out;
-}
-/**
- * Write the brain's rules into each selected host's instruction file.
- *
- * Best-effort per file: one unwritable path must not stop the rest, since a
- * partially delivered rulebook is strictly better than none.
- */
-export function writeBrainSections(repo, home, rules, repoLabel, ids) {
-    if (!rules.length)
-        return [];
-    const body = renderBrainSection(rules, repoLabel);
-    const out = [];
-    for (const host of brainSectionTargets(repo, home, ids)) {
-        const path = join(repo, host.relPath);
-        try {
-            const { action } = upsertSection(path, body, BRAIN_MARKERS);
-            out.push({ id: host.id, path, action });
-        }
-        catch {
-            // Unwritable file (read-only checkout, a directory in the way). Skipped
-            // silently here; the caller reports what it did get.
-        }
-    }
-    return out;
-}
-//# sourceMappingURL=wire.js.map

package/dist/brain/wire.js.map

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

package/dist/legacy-args.d.ts

@@ -1,12 +0,0 @@
-/**
- * The old spellings of renamed commands, still accepted.
- *
- * `graft brain …` became `graft trail …`, and `init --brain` became
- * `init --trail`, to match the product's name. The old ones are in docs, in
- * scripts, in shell history and on Trail pages already open in someone's
- * browser, so they keep working. They are rewritten before parsing rather than
- * registered as aliases, so help lists only the new names.
- */
-/** `process.argv` with the old spellings replaced by the new ones. */
-export declare function withLegacyNames(argv: readonly string[]): string[];
-//# sourceMappingURL=legacy-args.d.ts.map

package/dist/legacy-args.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"legacy-args.d.ts","sourceRoot":"","sources":["../src/legacy-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAcjE"}

package/dist/legacy-args.js

@@ -1,31 +0,0 @@
-/**
- * The old spellings of renamed commands, still accepted.
- *
- * `graft brain …` became `graft trail …`, and `init --brain` became
- * `init --trail`, to match the product's name. The old ones are in docs, in
- * scripts, in shell history and on Trail pages already open in someone's
- * browser, so they keep working. They are rewritten before parsing rather than
- * registered as aliases, so help lists only the new names.
- */
-/** Global options that take a value: their value is never the command. */
-const VALUE_OPTIONS = new Set(["--dir", "--provider", "--model", "--api-key", "--base-url"]);
-/** `process.argv` with the old spellings replaced by the new ones. */
-export function withLegacyNames(argv) {
-    const out = [...argv];
-    // The command is the first word after the global options.
-    for (let i = 2; i < out.length; i++) {
-        const a = out[i];
-        if (a === "--")
-            break;
-        if (a.startsWith("-")) {
-            if (VALUE_OPTIONS.has(a))
-                i++;
-            continue;
-        }
-        if (a === "brain")
-            out[i] = "trail";
-        break;
-    }
-    return out.map((a) => (a === "--brain" ? "--trail" : a.startsWith("--brain=") ? `--trail=${a.slice("--brain=".length)}` : a));
-}
-//# sourceMappingURL=legacy-args.js.map

package/dist/legacy-args.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"legacy-args.js","sourceRoot":"","sources":["../src/legacy-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;AAE7F,sEAAsE;AACtE,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACtB,0DAA0D;IAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAClB,IAAI,CAAC,KAAK,IAAI;YAAE,MAAM;QACtB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IAAI,CAAC,KAAK,OAAO;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QACpC,MAAM;IACR,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChI,CAAC"}