@nanonets/graft 0.23.0 → 0.24.0

package/dist/trace/types.d.ts

@@ -0,0 +1,477 @@
+/**
+ * The shapes the trace layer folds a session into: runs of tool work that
+ * serve one typed ask, their calls, the checks that prove a job worked, and
+ * the per-session state the skills hooks keep under the `skills` key of
+ * `~/.trail/sessions/<id>.json`.
+ *
+ * Types only (a type import of skills/types.ts for the fold ops). Typed text never appears here: a run carries job words from a
+ * fixed vocabulary, parameter values of known shapes, counts, hashes of typed
+ * lines, and the commands that ran (secret-checked).
+ */
+import type { FoldOp } from '../skills/types.js';
+export type JobClass = 'release' | 'ship' | 'pr-green' | 'sweep' | 'run-local' | 'report' | 'tests';
+export interface JobMatch {
+    job: JobClass;
+    /** Canonical vocabulary words that matched, e.g. ['push', 'beta', 'ff', 'prod']. Never raw text. */
+    words: string[];
+}
+/** Parameter values of known shapes found in a typed ask. Values only, never the text around them. */
+export type PromptParams = Partial<Record<'version' | 'sha' | 'pr' | 'port' | 'branch' | 'date', string>>;
+/** What a Bash call is, decided at fold time from its raw command (4.1). */
+export type CallKind = 'step' | 'look' | 'plumbing' | 'work';
+export interface RunCall {
+    /** tool_use id */
+    id: string;
+    at: string;
+    /** The command after redactSecrets (4.10). null when it held a secret that could not be named, or ran over 2,000 characters (then `parts` holds it piece by piece, D58c). */
+    cmd: string | null;
+    /** For a call with `parts`, the worst of its pieces' (refused over named). */
+    secret?: 'named' | 'refused';
+    /** Repo key of the effective folder (4.1); null outside git. */
+    key: string | null;
+    /** Effective folder (4.1), relative to that checkout's root ('' = root); null outside git. A sheet stores null for calls in another repo than the run's. */
+    cwd: string | null;
+    /** tool_input.run_in_background === true, or the command ends in a top-level `&`. */
+    bg: boolean;
+    /** !ok from the trace: is_error, or failure text in head or tail. */
+    failed: boolean;
+    /** The host's own error flag only. */
+    isError: boolean;
+    /** errorLine(result), cleanLine(.., 160). */
+    errorLine?: string;
+    /** Last 200 chars of the result, cleanLine'd. Kept for check-family calls, polls, `git rev-parse`, `git push` and publish calls only. */
+    tail?: string;
+    check?: CheckHit;
+    /** Raw command over 2,000 chars: never kept whole; its pieces are in `parts` (D58c). */
+    truncated?: boolean;
+    /** isMultiLine(raw command). */
+    multiLine?: boolean;
+    kind: CallKind;
+    /** Byte offsets of the tool_use line and the tool_result line, for the gate (4.9). -1 / null when unknown. */
+    src: {
+        use: number;
+        result: number | null;
+    };
+    /** The outcome came from a PostToolUse(Failure) mark because the transcript had no result yet (3.4). A later transcript result replaces it. */
+    fromMark?: true;
+    /** Only when the raw command ran over 2,000 characters (then `cmd` is null and `truncated` set): its top-level pieces in order (D58c). */
+    parts?: RunCallPart[];
+    /**
+     * Not a Bash call: a deployment status tool over MCP (D59b, `mcp__claude_ai_Vercel__get_deployment`). Then `cmd` is
+     * null, `kind` is 'look', `key`/`cwd` are null, and `check` is the deploy check its result gave. Never a step,
+     * never counted in `commands` or `failedCount`.
+     */
+    tool?: string;
+    /**
+     * D116 item 5: the call only fed keystrokes into a login (`... | script -q /dev/null npm login`): the service it logs
+     * in to. Then `cmd` is the login alone (`npm login`): what was fed is never kept, and compile drops the step.
+     */
+    loginFeed?: string;
+}
+/**
+ * One top-level piece of a call over 2,000 characters (D58c), as `splitTop` cuts it: a subshell, a loop or an `if`
+ * is one piece, a heredoc body belongs to the piece that opened it. The call's `id` and `src` are every piece's
+ * `from` (the save gate re-reads that one transcript line).
+ */
+export interface RunCallPart {
+    /** Word for word what ran, after redactSecrets; null when it held a secret that could not be named, or is `long`. */
+    cmd: string | null;
+    /** The top-level separator after it; '' for the last. A newline reads as ';'. */
+    sep: '&&' | '||' | ';' | '|' | '&' | '';
+    /** 4.1 kinds for the piece alone; always 'work' when `long`. */
+    kind: CallKind;
+    secret?: 'named' | 'refused';
+    /** The piece ran over 2,000 characters (a heredoc body, an inline edit): a work marker, never a step, never kept. */
+    long?: true;
+}
+/** `push`: a `git push` whose output shows the remote ref moved (D56a); a step, like `tests` and `query`. */
+export type CheckFamily = 'tests' | 'npm-view' | 'deploy' | 'gh-checks' | 'ls-remote' | 'query' | 'push';
+export interface CheckHit {
+    family: CheckFamily;
+    passed: boolean;
+    facts: {
+        version?: string;
+        sha?: string;
+        state?: string;
+        pr?: string;
+        branch?: string;
+        remote?: string;
+        pkg?: string;
+        passedCount?: number;
+    };
+}
+export type RunEnd = 'done' | 'failure' | 'question' | 'open';
+export interface RunState {
+    id: string;
+    epoch: number;
+    startedAt: string;
+    lastAt: string;
+    /** Repo key that most of the run's commands ran in (4.1). */
+    repoKey: string;
+    /** D93: the top of the checkout `repoKey` names, as the fold found it; absent when no call ran in it. */
+    checkout?: string;
+    /** gitBranch of its first step call; null when unknown. */
+    branch: string | null;
+    job: JobClass | null;
+    jobWords: string[];
+    promptParams: PromptParams;
+    /** Words both in the typed ask and in the kept commands (moment 1 cue words when job is null). */
+    sharedWords: string[];
+    typedCount: number;
+    toolCalls: number;
+    edits: number;
+    commands: number;
+    failedCount: number;
+    stepCalls: number;
+    /** Open run only, newest last, at most 200. Emptied when the run closes, after its sheet is written. */
+    calls: RunCall[];
+    closed: boolean;
+    /** Recomputed at every Stop while the run is open (4.2), kept when it closes. */
+    end: RunEnd;
+    /** Set when a run block was injected for this run (not "from scratch"). */
+    skillId?: string;
+    /** The run a compaction cut before it checked out, whose job this run continues (D59a). The agent started it with no typed ask. */
+    carriedFrom?: string;
+    /**
+     * D116 item 3: a go-ahead continued this run after a turn the agent ended in failure; this many calls had run then.
+     * Only a check at or after that call can check the run out.
+     */
+    failedTurn?: number;
+    sheet: 'none' | 'draft' | 'checked';
+    checkIndex: number | null;
+    poolNoted: boolean;
+}
+/** ~/.trail/runs/<id>.json. What compile copies from. */
+export interface RunSheet {
+    v: 1;
+    id: string;
+    session: string;
+    repoKey: string;
+    /** D93: the checkout the run ran in (RunState.checkout). The save gate's halves read it, never their own cwd. */
+    checkout?: string;
+    branch: string | null;
+    host: string;
+    tier: 'A' | 'B' | 'C' | 'D';
+    epoch: number;
+    startedAt: string;
+    endedAt: string;
+    job: JobClass | null;
+    jobWords: string[];
+    sharedWords: string[];
+    promptParams: PromptParams;
+    calls: RunCall[];
+    /** Index into calls of the passing check that made it a checked success, or null. */
+    checkIndex: number | null;
+    checked: boolean;
+    end: RunEnd;
+    counts: {
+        commands: number;
+        failed: number;
+        toolCalls: number;
+        edits: number;
+    };
+    /** Absolute paths of helper scripts the run executed from scratch folders (4.5 step 7). */
+    helpers: string[];
+    /** The skill whose block drove this run, or null. */
+    skillId: string | null;
+    /** The run (and sheet) before the compaction that this one continues (D59a); its calls are the job's first part. */
+    carriedFrom?: string;
+    /** Set only by `joinCarriedSheet`: the earlier parts joined in, oldest first, and how many calls each brought (they come first). */
+    joined?: Array<{
+        id: string;
+        calls: number;
+    }>;
+}
+/** Phase 2: 'retire', the retire proposal's and drift's retire (4.10, classifyFor); 1a's classifyAnswer never gives it. */
+export type TypedAnswer = 'yes' | 'no' | 'show' | 'correction' | 'retire' | 'other';
+export type GatedKind = 'publish' | 'push-prod' | 'deploy' | 'merge' | 'migrate' | 'prune' | 'login';
+export interface SkillInjection {
+    injId: string;
+    skillId: string;
+    name: string;
+    epoch: number;
+    at: string;
+    cue: 'job' | 'name' | 'check' | 'compact';
+    params: Record<string, string>;
+    /** Steps with params filled, in order (step n = index + 1). [] for a check cue. */
+    steps: string[];
+    gated: Array<{
+        step: number;
+        kind: GatedKind;
+    }>;
+    check: string | null;
+    /**
+     * D66: the skill's `metadata.check-tool` (e.g. 'get_deployment') when its check is a deploy status read over MCP,
+     * not a command. Credit then takes the check from that tool's result (READY passes). Absent for a command check.
+     */
+    checkTool?: string | null;
+    /**
+     * D106: the version a version check should show (the skill's `check-shows` is a `{version}` param, filled with a
+     * literal version). Credit passes the check only when it shows this version. Absent otherwise.
+     */
+    checkVersion?: string;
+    /**
+     * The ready probes (their text, from the skill's `ready` line) that failed when the block came in. Credit puts
+     * their forms in the use line; they never count against the skill (g4 open issue 4, D71 d). Absent when none failed.
+     */
+    readyFailed?: string[];
+    /** Set by the fold: the run of the first typed event at or after `at` minus 5 s. */
+    runId: string | null;
+    /** Its gated ask applies (3.3). Ends per 3.1 step 3, 3.2 step 7 and 3.5 step 5. */
+    live: boolean;
+}
+export type OfferChannel = 'stop' | 'notice' | 'post-tool';
+export interface PendingOffer {
+    offerId: string;
+    moment: OfferMoment;
+    runId: string;
+    name: string;
+    key: string;
+    /**
+     * The 2 lines (4.12). 1b: null only for a 'correction' offer, rebuilt from the transcript (P17); every reader goes
+     * through offerLinesOf (b4, R12). Until then each 1a reader treats null as no offer: never shown, answered or saved.
+     */
+    lines: [string, string] | null;
+    channel: OfferChannel;
+    shownAt: string | null;
+    showMe: boolean;
+    /** Set by the prompt hook from the UserPromptSubmit payload: the person's yes, as a hash. */
+    yes: {
+        at: string;
+        typedSha: string;
+    } | null;
+    /** Set by the fold: the first typed events after shownAt (at most 2: a 'show' then the answer). */
+    typedAfter: Array<{
+        offset: number;
+        sha: string;
+        answer: TypedAnswer;
+    }>;
+    /** g5 review: `skillSha` of the skill the offer counted (offerDue). The gate saves only that skill on its yes. */
+    skillSha?: string;
+    /** D101: how often the job worked out from scratch (line 1's count), for Trail's own reason in the Stop and post-tool text. */
+    seen?: {
+        n: number;
+        unit: 'day' | 'time';
+    };
+}
+export interface CreditState {
+    useId: string;
+    injId: string;
+    skillId: string;
+    epoch: number;
+    runId: string | null;
+    stepsRan: number[];
+    failedStep: number | null;
+    check: 'passed' | 'failed' | 'none';
+    calls: number;
+    failed: number;
+    flushed: boolean;
+    promptsAfter: number;
+}
+/** The `skills` key of ~/.trail/sessions/<id>.json. The `trace` key beside it is the catch-up cursor (0.1). */
+export interface SkillSessionState {
+    v: 1;
+    sessionHash: string;
+    host: string;
+    tier: 'A' | 'B' | 'C' | 'D';
+    /** GateCtx.learn when this state was made (0 rule 2). */
+    learn: boolean;
+    /** Repo keys in scope for recall: the cwd's key, plus child checkouts when cwd is not in git (3.1). */
+    scopeKeys: string[];
+    epoch: number;
+    /** SessionStart(compact) bumped the epoch before the fold met the compaction line (4.1). */
+    pendingBoundary: boolean;
+    /** At most 20, open run last. */
+    runs: RunState[];
+    pendingOffer: PendingOffer | null;
+    /** The one offer of this session is spent (an offer, an asked save, or the shim's install line, D27). */
+    offerUsed: boolean;
+    offerUsedBy: 'offer' | 'asked' | 'install-line' | null;
+    /** typed: set by the fold when it meets the typed line with this typedSha at or after `at` minus 5 s. */
+    saveRequest: {
+        runId: string;
+        at: string;
+        typedSha: string;
+        scope: 'this repo' | 'every repo' | 'repo' | 'team';
+        typed: {
+            offset: number;
+            sha: string;
+        } | null;
+        /** D73: `skillSha` of the skill compiled when the person asked. The gate saves only that skill; missing: refused. */
+        skillSha?: string;
+        /** The name Trail gave that skill (the add it told the agent to run). The gate keeps it under this name, or
+         *  a numbered one when it was taken since; missing: refused. */
+        name?: string;
+    } | null;
+    /** All epochs this session, newest last, at most 20. */
+    injected: SkillInjection[];
+    /** Newest last, at most 10. */
+    credit: CreditState[];
+    /** The first call that wrote Trail's or the host's files (4.1), as '<tool> <path or program>'. Never cleared. */
+    tampered: string | null;
+    /**
+     * The run the last compaction cut mid-job, before it checked out (D59a): the next run the agent starts with no
+     * typed ask continues its job. Spent by that run; cleared by any typed line.
+     */
+    cut?: string;
+    /**
+     * D116 item 3: how the agent's last reply ended (4.3: failure first, then a question, else done), from the fold's
+     * last assistant text before a typed line or a call; cleared by a call, a typed line and a compaction. Never text.
+     */
+    replyEnd?: 'failure' | 'question' | 'done';
+    updatedAt: string;
+    /**
+     * What was already folded, so a block of history the transcript repeats, or a transcript read again from
+     * the top, folds once (D56d): 10 hex of sha256 per tool_use id, typed line and compaction line, concatenated,
+     * oldest first, at most 6,000. Never an id in the clear.
+     */
+    seen?: string;
+}
+/** The wall catalog's classes (spec 12). Closed: equal to telemetry's wall_hit.class values, in the catalog's order. */
+export type WallClass = 'timeout-missing' | 'zsh-no-match' | 'git-https-auth' | 'docker-rootless' | 'npm-e401-eotp' | 'claude-not-logged-in' | 'enospc';
+/** What changed between a failing call and the retry that worked (4.12). */
+export type FixDeltaKind = 'env' | 'flag' | 'wrapper' | 'enable-step';
+export interface FixDelta {
+    kind: FixDeltaKind;
+    /** env: the variable name; flag: the flag; wrapper: the program put in front; enable-step: that call's program. */
+    name: string;
+    /** The text as it ran, secret-checked and relativized ($HOME, repo-relative). Never a typed word. */
+    text: string;
+    /** The tool_use id that carried it. */
+    callId: string;
+}
+export interface RepairEvent {
+    cls: WallClass;
+    program: string;
+    failCallId: string;
+    /** The retry that worked. */
+    fixCallId: string;
+    /** Non-empty, else it is not a repair. */
+    delta: FixDelta[];
+    epoch: number;
+    runId: string | null;
+    at: string;
+}
+/** Phase 2: moment 5 'update', moment 6 'drift', and the retire proposal 'retire' (4.7 to 4.10). */
+export type OfferMoment = 'repeated' | 'repaired' | 'correction' | 'update' | 'drift' | 'retire';
+export interface RunCall {
+    /** Set by run-calls.ts makeCall (b2, R8): matchWall(result text, command, failed). Kept in run sheets as a class name only. */
+    wall?: WallClass;
+    /** The run's Edit/Write tool calls before this one, when any (b2 review): an edit between a failure and its retry may be the fix, so no repair. */
+    editsBefore?: number;
+}
+export interface RunState {
+    /** Filled at run close (4.12): at most 5 per run. The wall hits themselves are RunCall.wall. */
+    repairs?: RepairEvent[];
+}
+export interface PendingOffer {
+    /** b4: the repo the offer is for (its `offers.jsonl` line's `repo`). A correction's key names the skill, not the repo. */
+    repo?: string;
+    /** Moment 3. as 'lesson': lessonSha is the sha256 of the lesson text line 2 shows (R26). */
+    repair?: {
+        cls: WallClass;
+        program: string;
+        nth: number;
+        firstAt: string;
+        as: 'skill' | 'lesson';
+        delta: FixDelta[];
+        lessonSha?: string;
+    };
+    /** Moment 4: the person's correction line (offset and sha), the first new step that worked after it, the lesson as offered. */
+    correction?: {
+        skillId: string;
+        useId: string;
+        typed: {
+            offset: number;
+            sha: string;
+        };
+        fixCallId: string | null;
+        lessonSha: string;
+        /** b4: the fix command as the lesson holds it (params put back, relativized, risk-checked), or null: the agent's
+         *  command, never the person's words, so line 2 is rebuilt from the typed line and this (P17). */
+        fix?: string | null;
+    };
+}
+export interface SkillInjection {
+    /** 8 hex of sha256 of the asks phrase that fired a 'job' cue; null for name, check, compact. Never the phrase (D71 b, R30). */
+    phraseSha?: string | null;
+}
+export interface CreditState {
+    /** Copied from the injection. */
+    phraseSha?: string | null;
+    /** creditWindow sets sha; the fold fills offset from an origin-human typed line only. */
+    corrected?: {
+        offset: number | null;
+        sha: string;
+    } | null;
+}
+export interface SkillSessionState {
+    lessonWatch?: {
+        skillId: string;
+        useId: string;
+        typedSha: string;
+        at: string;
+    } | null;
+    /** The correction that withdrew this session's offer: only the moment-4 offer for that same correction may use the freed slot (P18, R40). */
+    withdrewFor?: {
+        typedSha: string;
+    } | null;
+    /** Lines of sessions/<id>.denied.jsonl Stop has counted (3.5 step 5). */
+    deniedSeen?: number;
+}
+/** The facts of a Codex rollout's first line (`session_meta`, 4.15), read once. No text but `cwd`. c6's `codexMeta` returns it. */
+export interface CodexMeta {
+    id: string;
+    originator: string | null;
+    source: string | null;
+    cliVersion: string | null;
+    cwd: string | null;
+    historyMode: 'legacy' | 'paginated' | null;
+}
+export interface PendingOffer {
+    /** Moments 5 and 6 (4.7, 4.8): the change shown, pinned to the file it was computed from and to the text it would write. */
+    fold?: {
+        op: FoldOp | 'replace';
+        skillId: string;
+        baseHash: string;
+        proposalSha: string;
+        handEdited: boolean;
+        splitName?: string;
+        lessonIds?: string[];
+        version: number;
+    };
+    /** The retire proposal and drift (4.9): the skill a 'retire' answer retires. */
+    retire?: {
+        skillId: string;
+        name: string;
+    };
+}
+export interface SkillSessionState {
+    /** c7: Codex only. The rollout's first line, read once (4.17), and the keyed hashes (HMAC with its own key file,
+     *  state/typed-key, D138 (3); 16 hex, last 20) of prompts the prompt hook saw (P30, R7). Never a prompt. */
+    codex?: {
+        meta: CodexMeta | null;
+        typedShas: string[];
+    };
+    /** c8 (4.9): not-followed firings the prompt hook's settle wrote, for the next Stop's retire proposal. At most 4. */
+    firedLater?: Array<{
+        skillId: string;
+        name: string;
+        followed: boolean;
+        runId: string;
+        at: string;
+    }>;
+}
+/** Phase 2 c8 (D137): a gated step this session couldn't ask for was denied and handed to the person to run. */
+export interface SkillInjection {
+    /** The gated steps handed to the person (from the gate file's marks): credit counts each as handed, not failed. */
+    handed?: Array<{
+        n: number;
+        at: string;
+    }>;
+}
+export interface RunState {
+    /** The newest hand-off of one of its block's gated steps: the person's next ask of the job continues this run. */
+    handedAt?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/trace/types.js

@@ -0,0 +1,12 @@
+/**
+ * The shapes the trace layer folds a session into: runs of tool work that
+ * serve one typed ask, their calls, the checks that prove a job worked, and
+ * the per-session state the skills hooks keep under the `skills` key of
+ * `~/.trail/sessions/<id>.json`.
+ *
+ * Types only (a type import of skills/types.ts for the fold ops). Typed text never appears here: a run carries job words from a
+ * fixed vocabulary, parameter values of known shapes, counts, hashes of typed
+ * lines, and the commands that ran (secret-checked).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/trace/types.js.map

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

package/dist/trace/walls-glob.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A word as zsh would print it in its error: quotes gone, expansions as `.*`, glob characters literal. `glob` says
+ * whether the word holds an unquoted glob character (only those make zsh's error). Null for a word too long to read.
+ */
+export declare function wordShape(w: string): {
+    re: RegExp;
+    glob: boolean;
+} | null;
+/** True when a zsh "no matches found" line in `ends` (not quoted) names a word of `command` that makes it a real wall. */
+export declare function globWallTied(ends: string, command: string): boolean;
+//# sourceMappingURL=walls-glob.d.ts.map

package/dist/trace/walls-glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"walls-glob.d.ts","sourceRoot":"","sources":["../../src/trace/walls-glob.ts"],"names":[],"mappings":"AAmEA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAmDzE;AAuED,0HAA0H;AAC1H,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAYnE"}