@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/front-version.d.ts

@@ -0,0 +1,12 @@
+/** The version `data` (a SKILL.md's front matter) says: `metadata.version`, else the old top-level `version`, else 1. */
+export declare function versionOf(data: Record<string, unknown>): number;
+/**
+ * The front matter `lines` (without the `---` fences) with `metadata.version`
+ * set to `version`, and any old top-level `version` gone. With `mark`, a
+ * metadata without a `trail` key gets `trail: "<mark>"`; one it already has is
+ * kept. A block `metadata:` gets the lines replaced or added at its own
+ * indent; a flow one (`metadata: { … }`) is written out as a block, its other
+ * values kept as strings; none at all gets one.
+ */
+export declare function withMetadataVersion(lines: string[], version: number, mark?: string): string[];
+//# sourceMappingURL=front-version.d.ts.map

package/dist/skills/front-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-version.d.ts","sourceRoot":"","sources":["../../src/skills/front-version.ts"],"names":[],"mappings":"AAWA,yHAAyH;AACzH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQ/D;AAeD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAuC7F"}

package/dist/skills/front-version.js

@@ -0,0 +1,87 @@
+/**
+ * A skill's version, where the Agent Skills spec lets Trail keep it: under
+ * `metadata`, as a quoted string (`version: "3"`). Older Trail wrote it at the
+ * top level (`version: 3`); that still reads, and the next write moves it.
+ *
+ * The front matter is edited as text, one key, so a hand-written skill keeps
+ * every other line (`allowed-tools`, comments, its own metadata) exactly as its
+ * author wrote it.
+ */
+import { matter } from "../util/front-matter.js";
+/** The version `data` (a SKILL.md's front matter) says: `metadata.version`, else the old top-level `version`, else 1. */
+export function versionOf(data) {
+    const meta = data.metadata;
+    const fromMeta = typeof meta === "object" && meta !== null && !Array.isArray(meta) ? meta.version : undefined;
+    for (const v of [fromMeta, data.version]) {
+        const n = typeof v === "number" ? v : typeof v === "string" && /^\d+$/.test(v.trim()) ? Number(v) : NaN;
+        if (Number.isSafeInteger(n) && n >= 1)
+            return n;
+    }
+    return 1;
+}
+const TOP_KEY = /^([A-Za-z0-9_-]+)\s*:(.*)$/;
+/** Where each top-level key's lines are: from its own line up to the next top-level line. */
+function topKeyAt(lines, key) {
+    const at = lines.findIndex((l) => TOP_KEY.exec(l)?.[1] === key);
+    if (at === -1)
+        return null;
+    let end = at + 1;
+    while (end < lines.length && (lines[end].trim() === "" || /^\s/.test(lines[end])))
+        end++;
+    // Trailing blank lines belong to no key.
+    while (end > at + 1 && lines[end - 1].trim() === "")
+        end--;
+    return { at, end };
+}
+/**
+ * The front matter `lines` (without the `---` fences) with `metadata.version`
+ * set to `version`, and any old top-level `version` gone. With `mark`, a
+ * metadata without a `trail` key gets `trail: "<mark>"`; one it already has is
+ * kept. A block `metadata:` gets the lines replaced or added at its own
+ * indent; a flow one (`metadata: { … }`) is written out as a block, its other
+ * values kept as strings; none at all gets one.
+ */
+export function withMetadataVersion(lines, version, mark) {
+    const out = [...lines];
+    const old = topKeyAt(out, "version");
+    if (old)
+        out.splice(old.at, old.end - old.at);
+    const line = `version: "${version}"`;
+    const marked = mark ? [`trail: ${JSON.stringify(mark)}`] : [];
+    const meta = topKeyAt(out, "metadata");
+    if (!meta)
+        return [...out, "metadata:", ...marked.map((l) => `  ${l}`), `  ${line}`];
+    const inline = TOP_KEY.exec(out[meta.at])[2].replace(/\s+#.*$/, "").trim();
+    if (inline) {
+        // A flow map, or something that isn't a map: read what it holds, write it as a block.
+        let held = {};
+        try {
+            const data = matter(`---\n${out.slice(meta.at, meta.end).join("\n")}\n---\n`).data;
+            if (typeof data.metadata === "object" && data.metadata !== null && !Array.isArray(data.metadata))
+                held = data.metadata;
+        }
+        catch {
+            /* unreadable: replaced by the version alone */
+        }
+        const kept = Object.entries(held)
+            .filter(([k, v]) => k !== "version" && v !== null && typeof v !== "object")
+            .map(([k, v]) => `  ${k}: ${JSON.stringify(String(v))}`);
+        const mine = Object.hasOwn(held, "trail") ? [] : marked.map((l) => `  ${l}`);
+        out.splice(meta.at, meta.end - meta.at, "metadata:", ...kept, ...mine, `  ${line}`);
+        return out;
+    }
+    const children = out.slice(meta.at + 1, meta.end);
+    // The first child key's indent: a comment line can sit at any indent.
+    const indent = /^(\s+)\S/.exec(children.find((l) => l.trim() && !l.trim().startsWith("#")) ?? "")?.[1] ?? "  ";
+    const child = (key) => children.findIndex((l) => l.startsWith(indent) && !/^\s/.test(l.slice(indent.length)) && new RegExp(`^${key}\\s*:`).test(l.slice(indent.length)));
+    const has = child("version");
+    const add = (child("trail") === -1 ? marked : []).map((l) => `${indent}${l}`);
+    if (has !== -1)
+        out[meta.at + 1 + has] = `${indent}${line}`;
+    else
+        add.push(`${indent}${line}`);
+    // After the block's last line, so a comment or blank line closing it stays where it was.
+    out.splice(meta.end, 0, ...add);
+    return out;
+}
+//# sourceMappingURL=front-version.js.map

package/dist/skills/front-version.js.map

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

package/dist/skills/host-facts.d.ts

@@ -0,0 +1,51 @@
+import type { OfferChannel } from '../trace/types.js';
+import type { Host, Tier } from '../trace/host.js';
+export interface HostFacts {
+    /** Where moment 2's offer goes (3.5): 'stop' = a Stop block whose reason the agent says;
+     *  'notice' = a Stop systemMessage the person reads, no agent turn; 'post-tool' = the passing check's PostToolUse context. */
+    offerChannel: OfferChannel;
+    /** A Stop systemMessage reaches the person (needed for 'notice' and the use line). */
+    stopNotice: boolean;
+    /** A SessionStart systemMessage reaches the person (held notice). */
+    startNotice: boolean;
+    /** A UserPromptSubmit systemMessage reaches the person ("trail: using skill X"). */
+    promptNotice: boolean;
+    /** A UserPromptSubmit block shows its reason to the person and runs no model turn (bare "no"). */
+    promptBlockShown: boolean;
+    /** permission_mode values where a PreToolUse ask reaches the person, in an interactive entrypoint (D17). */
+    askModes: string[];
+    /** 1b (P23): a PostToolUseFailure additionalContext reaches the model. Default true until H3 says otherwise (H9 saw it arrive, D88). */
+    failureContext: boolean;
+    /** Phase 2 (2.10): a PostToolUse additionalContext reaches the model. Wall fixes on a passing call and the post-tool
+     *  channel need it. Claude Code: yes (host-checks 4); Codex: no until HC1 says so. */
+    postToolContext: boolean;
+}
+/** From plans/host-checks.md. A value changes only with a live check written up there (6.4). */
+export declare const HOST_FACTS: HostFacts;
+/**
+ * Codex's (phase 2, 2.10). Every value is the safe one until its host check, written up in host-checks.md, says
+ * otherwise: no ask (an `ask` from a Codex PreToolUse hook fails the hook run and the tool runs, D17), no
+ * PostToolUse context until HC1, no notices until HC4.
+ */
+export declare const CODEX_FACTS: HostFacts;
+/**
+ * $HOME/.trail-lab exists, or TRAIL_HOME is set to a folder other than $HOME/.trail (0 rule 10). Never
+ * when Trail's files are the person's own ~/.trail.
+ */
+export declare function isTestHome(env?: NodeJS.ProcessEnv): boolean;
+/** TRAIL_LAB_INTERACTIVE=1 and $HOME/.trail-lab exists (D26), and not on the person's own ~/.trail. */
+export declare function labInteractive(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * The facts for `host`: Codex's for 'codex', else Claude Code's (no host, as before phase 2, and every other host,
+ * whose hooks don't run the skills code). In a test home only, TRAIL_HOST_FACTS (a JSON object) is merged in, keyed
+ * by host (2.10): its `codex` object for Codex; for Claude its `claude` object when it has one, else the old flat
+ * object. A `codex` key never reaches Claude's facts, nor a flat field Codex's. Always a copy.
+ */
+export declare function hostFacts(env?: NodeJS.ProcessEnv, host?: Host): HostFacts;
+/**
+ * 4.18: the tier the skills code uses for `host`. Codex's is host.ts's CODEX_TIER, except that a test home may set
+ * TRAIL_TIER_CODEX=A (the lab and c6 to c8 run the learning half on Codex before the flip). Every other host keeps
+ * the tier it was detected with.
+ */
+export declare function hostTier(host: string, tier: Tier, env?: NodeJS.ProcessEnv): Tier;
+//# sourceMappingURL=host-facts.d.ts.map

package/dist/skills/host-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-facts.d.ts","sourceRoot":"","sources":["../../src/skills/host-facts.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,WAAW,SAAS;IACxB;kIAC8H;IAC9H,YAAY,EAAE,YAAY,CAAC;IAC3B,sFAAsF;IACtF,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,YAAY,EAAE,OAAO,CAAC;IACtB,kGAAkG;IAClG,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4GAA4G;IAC5G,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,wIAAwI;IACxI,cAAc,EAAE,OAAO,CAAC;IACxB;0FACsF;IACtF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,gGAAgG;AAChG,eAAO,MAAM,UAAU,EAAE,SAIV,CAAC;AAEhB;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,SAGX,CAAC;AA4ChB;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAIxE;AAED,uGAAuG;AACvG,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE5E;AAaD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,SAAS,CActF;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,IAAI,CAE7F"}

package/dist/skills/host-facts.js

@@ -0,0 +1,134 @@
+/**
+ * Every host behaviour the skills design switches on, in one place: where the
+ * repeated-job offer goes, which notices reach the person, and when a
+ * PreToolUse ask reaches them. The values come from `plans/host-checks.md`
+ * and change only with a live check written up there.
+ *
+ * Test-only switches live here too, and are honoured only in a test home:
+ * `$HOME/.trail-lab` exists (the lab's box writes it, D26) or TRAIL_HOME is a
+ * folder other than `$HOME/.trail` (unit tests). Real homes have neither. And
+ * never where Trail's files are the person's own `~/.trail` (the account's
+ * home, whatever HOME says), however it is reached: a TRAIL_HOME naming it or
+ * linking to it, or a marker someone put in the real HOME.
+ *
+ * The PreToolUse fast path imports this file, so it loads only node:path and
+ * node:os; node:fs comes from `process.getBuiltinModule`, as pre-bash.ts does.
+ */
+import { homedir, userInfo } from 'node:os';
+import { join, resolve } from 'node:path';
+/** From plans/host-checks.md. A value changes only with a live check written up there (6.4). */
+export const HOST_FACTS = Object.freeze({
+    offerChannel: 'stop', stopNotice: false, startNotice: false, promptNotice: true,
+    promptBlockShown: false, askModes: Object.freeze(['default', 'acceptEdits', 'plan']),
+    failureContext: true, postToolContext: true,
+});
+/**
+ * Codex's (phase 2, 2.10). Every value is the safe one until its host check, written up in host-checks.md, says
+ * otherwise: no ask (an `ask` from a Codex PreToolUse hook fails the hook run and the tool runs, D17), no
+ * PostToolUse context until HC1, no notices until HC4.
+ */
+export const CODEX_FACTS = Object.freeze({
+    offerChannel: 'stop', stopNotice: false, startNotice: false, promptNotice: false, promptBlockShown: false,
+    askModes: Object.freeze([]), failureContext: false, postToolContext: false,
+});
+const CHANNELS = new Set(['stop', 'notice', 'post-tool']);
+const FLAGS = ['stopNotice', 'startNotice', 'promptNotice', 'promptBlockShown', 'failureContext', 'postToolContext'];
+/** node:fs without an ESM import of it; null on a Node too old to hand it over. */
+function nodeFs() {
+    return typeof process.getBuiltinModule === 'function' ? process.getBuiltinModule('node:fs') : null;
+}
+function homeOf(env) {
+    return env.HOME || env.USERPROFILE || homedir();
+}
+/** `$HOME/.trail-lab` exists. On a Node without getBuiltinModule nothing can say so: false. */
+function labMarker(env) {
+    try {
+        return nodeFs()?.existsSync(join(homeOf(env), '.trail-lab')) === true;
+    }
+    catch {
+        return false;
+    }
+}
+/** A path with its links followed, when it exists. */
+function canonical(path) {
+    try {
+        return nodeFs()?.realpathSync.native(path) ?? resolve(path);
+    }
+    catch {
+        return resolve(path);
+    }
+}
+/** Trail's files under this env are the account's own `~/.trail` (trailHome's rule, and the passwd home, not HOME). */
+function personsOwn(env) {
+    let account;
+    try {
+        account = userInfo().homedir;
+    }
+    catch {
+        account = homedir();
+    }
+    const used = env.TRAIL_HOME ? resolve(env.TRAIL_HOME) : join(homedir(), '.trail');
+    return canonical(used) === canonical(join(account, '.trail'));
+}
+/**
+ * $HOME/.trail-lab exists, or TRAIL_HOME is set to a folder other than $HOME/.trail (0 rule 10). Never
+ * when Trail's files are the person's own ~/.trail.
+ */
+export function isTestHome(env = process.env) {
+    if (personsOwn(env))
+        return false;
+    if (env.TRAIL_HOME && resolve(env.TRAIL_HOME) !== resolve(homeOf(env), '.trail'))
+        return true;
+    return labMarker(env);
+}
+/** TRAIL_LAB_INTERACTIVE=1 and $HOME/.trail-lab exists (D26), and not on the person's own ~/.trail. */
+export function labInteractive(env = process.env) {
+    return env.TRAIL_LAB_INTERACTIVE === '1' && labMarker(env) && !personsOwn(env);
+}
+const isObject = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** Known fields of the right shape from `g`, over `base`. */
+function merged(base, g) {
+    const out = { ...base, askModes: [...base.askModes] };
+    if (typeof g.offerChannel === 'string' && CHANNELS.has(g.offerChannel))
+        out.offerChannel = g.offerChannel;
+    for (const k of FLAGS)
+        if (typeof g[k] === 'boolean')
+            out[k] = g[k];
+    if (Array.isArray(g.askModes) && g.askModes.every((m) => typeof m === 'string'))
+        out.askModes = [...g.askModes];
+    return out;
+}
+/**
+ * The facts for `host`: Codex's for 'codex', else Claude Code's (no host, as before phase 2, and every other host,
+ * whose hooks don't run the skills code). In a test home only, TRAIL_HOST_FACTS (a JSON object) is merged in, keyed
+ * by host (2.10): its `codex` object for Codex; for Claude its `claude` object when it has one, else the old flat
+ * object. A `codex` key never reaches Claude's facts, nor a flat field Codex's. Always a copy.
+ */
+export function hostFacts(env = process.env, host) {
+    const base = host === 'codex' ? CODEX_FACTS : HOST_FACTS;
+    const out = { ...base, askModes: [...base.askModes] };
+    const raw = env.TRAIL_HOST_FACTS;
+    if (!raw || !isTestHome(env))
+        return out;
+    let given;
+    try {
+        given = JSON.parse(raw);
+    }
+    catch {
+        return out;
+    }
+    if (!isObject(given))
+        return out;
+    if (host === 'codex')
+        return isObject(given.codex) ? merged(base, given.codex) : out;
+    return merged(base, isObject(given.claude) ? given.claude : given);
+}
+/**
+ * 4.18: the tier the skills code uses for `host`. Codex's is host.ts's CODEX_TIER, except that a test home may set
+ * TRAIL_TIER_CODEX=A (the lab and c6 to c8 run the learning half on Codex before the flip). Every other host keeps
+ * the tier it was detected with.
+ */
+export function hostTier(host, tier, env = process.env) {
+    return host === 'codex' && env.TRAIL_TIER_CODEX === 'A' && isTestHome(env) ? 'A' : tier;
+}
+//# sourceMappingURL=host-facts.js.map

package/dist/skills/host-facts.js.map

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

package/dist/skills/learning-steps.d.ts

@@ -0,0 +1,43 @@
+export interface Cmd {
+    prog: string;
+    args: string[];
+}
+export type StepRule = {
+    t: 'swap';
+    use: Cmd;
+    not: Cmd;
+} | {
+    t: 'never';
+    cmd: Cmd;
+} | {
+    t: 'never-edit';
+    file: string;
+} | {
+    t: 'always';
+    cmd: Cmd;
+} | {
+    t: 'before';
+    first: Cmd;
+    then: Cmd;
+};
+/** `whole`: every sentence of the text read as rules, so a line that quotes it in full leaves nothing out. */
+export interface ReadRules {
+    rules: StepRule[];
+    whole: boolean;
+}
+export interface StepVerdict {
+    repeats: number[];
+    /** `fix`: the step's command the learning's way (its folder kept), or null when Trail can't write it safely. */
+    contradicts: Array<{
+        step: number;
+        fix: string | null;
+    }>;
+}
+/** The rules a learning's text says, and whether every sentence of it was read. */
+export declare function rulesOf(text: string): ReadRules;
+/**
+ * Each rule against the steps (step `n` is `steps[n - 1]`, with its {params}). A step that does what a rule forbids
+ * is a contradiction, whatever another rule says of it; one that does what a rule says, a repeat.
+ */
+export declare function matchSteps(rules: StepRule[], steps: string[]): StepVerdict;
+//# sourceMappingURL=learning-steps.d.ts.map

package/dist/skills/learning-steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning-steps.d.ts","sourceRoot":"","sources":["../../src/skills/learning-steps.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,GAAG;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE;AACrD,MAAM,MAAM,QAAQ,GAChB;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACjC;IAAE,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACxB;IAAE,CAAC,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACzB;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,GAAG,CAAA;CAAE,CAAC;AAE3C,8GAA8G;AAC9G,MAAM,WAAW,SAAS;IAAG,KAAK,EAAE,QAAQ,EAAE,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE;AAEhE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gHAAgH;IAChH,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1D;AA0HD,mFAAmF;AACnF,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAkB/C;AAgFD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,WAAW,CA6B1E"}