@nanonets/graft 0.24.1 → 0.25.0

package/dist/skills/update-plan.js

@@ -0,0 +1,196 @@
+/**
+ * The change a moment 5 or 6 offer shows, worked out again from disk
+ * (phase 2 design 4.11, R14): the run sheet, the skill file as it is now, its
+ * unfolded lessons, and the ledger uses from before that run started (never
+ * later ones, so a use another session flushed since can't move the plan).
+ * One builder (`foldInputFor`) and one plan (`replan`) serve the offer at
+ * Stop (c3, through `OfferInput.plan`), both halves of the update gate and
+ * `trail skills draft --print`, so they can't disagree: the offer pins the
+ * `proposalSha` and `baseHash` this returns, and the gate writes only when
+ * they come out the same again.
+ *
+ * Re-exported from `update-gate.ts`, where the design names `replan`.
+ * Loaded only on the update paths, never on the PreToolUse fast path.
+ */
+import { createHash } from 'node:crypto';
+import { lstatSync, readdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { joinCarriedSheet, readRunSheet } from '../trace/runs.js';
+import { readJsonSafe, trailPath } from '../util/private-fs.js';
+import { compileRun, proposeName } from './compile.js';
+import { fidelityOf } from './fidelity.js';
+import { fidelityWhere } from './credit-facts.js';
+import { applyFold, planFold, replaceWith } from './fold.js';
+import { readLedger } from './ledger.js';
+import { readLessons } from './lessons.js';
+import { runCheckout } from './run-checkout.js';
+import { rebuildCompiled, rebuildLoose } from './skill-rebuild.js';
+import { parseSkillMd, renderSkillMd, skillHash } from './skillmd.js';
+import { getSkillState } from './state.js';
+import { listAllPersonal, nameTaken } from './store.js';
+import { MAX_SKILL_BYTES } from './store-fs.js';
+import { nextVersion } from './versions.js';
+import { fillParams } from './params.js';
+import { recallMarks, stepLearnings, whose } from './follow-learnings.js';
+const MAX_EARLIER = 4;
+const SESSION_FILES = 64;
+const SESSION_MAX_BYTES = 8 * 1024 * 1024;
+/** The file's text when it is a regular file of at most 64 KB and neither it nor its folder is a link. */
+function ownText(ref) {
+    try {
+        if (lstatSync(ref.dir).isSymbolicLink())
+            return null;
+        const s = lstatSync(ref.file);
+        if (!s.isFile() || s.size > MAX_SKILL_BYTES)
+            return null;
+        return readFileSync(ref.file, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/** The helper file names in scripts/ (a rebuilt skill names them; a fold never writes them). */
+function scriptNames(dir) {
+    try {
+        if (!lstatSync(join(dir, 'scripts')).isDirectory())
+            return [];
+        return readdirSync(join(dir, 'scripts')).filter((n) => !n.startsWith('.') && lstatSync(join(dir, 'scripts', n)).isFile()).sort();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The block as credit read it (`settleCredit`, and c3's offer at Stop): the newest injection of this skill for the
+ * job's runs (the run and the parts a compaction joined into it) gives the params, steps and check, the oldest its
+ * `at`, so the fidelity window and so the plan come out the same at Stop, in PreToolUse and in the CLI.
+ */
+function injIn(st, skillId, runIds) {
+    const all = Array.isArray(st?.injected) ? st.injected : [];
+    const mine = all.filter((i) => i && i.skillId === skillId && i.runId !== null && runIds.includes(i.runId) && i.cue !== 'check')
+        .sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
+    if (!mine.length)
+        return null;
+    const newest = mine[mine.length - 1];
+    return { params: newest.params, steps: newest.steps, check: newest.check, at: mine[0].at };
+}
+/** The run's own session file (its `skills.sessionHash` is the sheet's), among the 64 newest: for draft, which has no session. */
+export function sessionOf(sheet, env) {
+    const dir = trailPath(env, 'sessions');
+    let names;
+    try {
+        names = readdirSync(dir).filter((n) => /^[\w.-]+\.json$/.test(n) && !/\.(?:hooks|gate|lesson|update)\.json$/.test(n)).flatMap((n) => {
+            const s = lstatSync(join(dir, n));
+            return s.isFile() && s.size <= SESSION_MAX_BYTES ? [{ n, t: s.mtimeMs }] : [];
+        });
+    }
+    catch {
+        return null;
+    }
+    for (const { n } of names.sort((a, b) => b.t - a.t).slice(0, SESSION_FILES)) {
+        const st = readJsonSafe(join(dir, n))?.skills;
+        if (st && typeof st === 'object' && st.sessionHash === sheet.session)
+            return st;
+    }
+    return null;
+}
+function gather(skillId, runId, env, o, needInj) {
+    const ref = listAllPersonal(env).find((r) => r.id === skillId);
+    if (!ref || ref.scope !== 'personal')
+        return null;
+    const text = ownText(ref);
+    const skill = text === null ? null : parseSkillMd(text, ref.name);
+    if (text === null || !skill || skill.meta.trail !== skillId)
+        return null;
+    const sheet = readRunSheet(runId, env);
+    if (!sheet)
+        return null;
+    const read = (id) => readRunSheet(id, env);
+    const joined = joinCarriedSheet(sheet, read);
+    const ids = [...new Set([runId, ...(joined.joined ?? []).map((j) => j.id)])];
+    const inj = o.inj ?? injIn(o.st, skillId, ids) ?? (needInj ? injIn(sessionOf(sheet, env), skillId, ids) : null);
+    if (needInj && !inj)
+        return null;
+    const home = env.HOME || homedir();
+    const repoRoot = runCheckout(joined, env, '');
+    // c3's credit flush keys extraShas with the same `where` (one function for both), or two-uses never matches (R10).
+    const fid = fidelityOf(skill, inj ?? { params: {}, steps: [] }, joined.calls, fidelityWhere(joined, env));
+    const scope = { repoKeys: [sheet.repoKey], checkout: repoRoot, env };
+    const c = compileRun(sheet, {
+        repoRoot, home, platform: process.platform, prior: null, name: ref.name, moment: 'repeated',
+        applies: skill.meta.applies ?? sheet.repoKey, taken: () => false, id: skillId, readSheet: read,
+    });
+    const fresh = c.ok ? c.skill : null;
+    // R14: the uses before this run started, newest last.
+    const started = Date.parse(sheet.startedAt);
+    const earlier = readLedger(skillId, env).filter((l) => l.event === 'use' && Date.parse(l.at) < started).slice(-MAX_EARLIER);
+    const state = getSkillState(skillId, env);
+    const hash = skillHash(text);
+    const handEdited = !state || (hash !== state.hash && hash !== state.pendingWrite?.hash);
+    const base = handEdited ? rebuildLoose(text, skill)
+        : rebuildCompiled(text, skill, { source: state.source, helpers: scriptNames(ref.dir), runId: state.runId });
+    let splitName;
+    try {
+        if (fresh)
+            splitName = proposeName(sheet, fresh.steps, (n) => nameTaken(n, scope) !== null);
+    }
+    catch { /* no split name: no split */ }
+    // Part 7: the steps the block showed the way a live learning says, as it showed them (the injection's steps).
+    const preferred = inj ? recallMarks(skill.steps, stepLearnings({ repoKeys: [sheet.repoKey], checkout: repoRoot, env })).flatMap((m) => [...m.fixes].flatMap(([step, cmd]) => (cmd && inj.steps?.[step - 1] === fillParams(cmd, inj.params ?? {}) ? [{ step, cmd, follows: whose(m.l) }] : []))) : [];
+    const input = {
+        skill, text, fresh, fid, inj: { params: inj?.params ?? {} }, taken: (n) => nameTaken(n, scope) !== null, ...(preferred.length ? { preferred } : {}),
+        earlierExtraShas: earlier.map((u) => u.extraShas ?? []), lessons: readLessons(ref.dir),
+        earlierRan: earlier.map((u) => u.stepsRan), earlierChecks: earlier.map((u) => u.check), base, ...(splitName ? { splitName } : {}),
+    };
+    return { input, ref, state, text, sheet, handEdited };
+}
+/** The fold input for one checked use of the skill (4.2), from disk; null when the skill, the run or its block is gone. */
+export function foldInputFor(skillId, runId, env = process.env, o = {}) {
+    try {
+        return gather(skillId, runId, env, o, true)?.input ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export const proposalShaOf = (text) => createHash('sha256').update(text, 'utf8').digest('hex').slice(0, 16);
+/**
+ * The change again, from the run sheet and the file as they are now (4.11 step 6). Update and extend: `planFold`
+ * must give that same op. Replace (drift): the fresh compile as the next version, keeping the skill's id, name and
+ * asks. The next version is numbered past every kept one, as the write numbers it. null: nothing to change.
+ */
+export function replan(skillId, runId, op, env = process.env, o = {}) {
+    try {
+        if (op === 'split')
+            return null;
+        const g = gather(skillId, runId, env, o, op !== 'replace');
+        const base = g?.input.base ?? null;
+        if (!g || !base || !/^[1-9]\d{0,5}$/.test(String(base.meta.version)))
+            return null;
+        let next;
+        let plan = null;
+        if (op === 'replace') {
+            if (!g.input.fresh)
+                return null;
+            next = replaceWith(base, g.input.fresh);
+        }
+        else {
+            const p = planFold(g.input);
+            if (p.op !== op)
+                return null;
+            plan = p;
+            next = applyFold(base, plan);
+        }
+        if (!next)
+            return null;
+        const version = String(nextVersion(g.ref, Number(base.meta.version)));
+        next = { ...next, meta: { ...next.meta, version } };
+        const text = renderSkillMd(next);
+        return { next, text, proposalSha: proposalShaOf(text), baseHash: skillHash(g.text), current: g.text, handEdited: g.handEdited, plan, base, fresh: g.input.fresh };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=update-plan.js.map

package/dist/skills/update-plan.js.map

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

package/dist/skills/value-line.d.ts

@@ -0,0 +1,94 @@
+import type { Host } from '../trace/host.js';
+/** The words of the line and of the context that carries it (0 rule 6: the words test reads them by value). */
+export declare const VALUE_COPY: {
+    readonly head: "Last week in this repo, on this machine:";
+    readonly ran: "ran";
+    readonly withFailed: "with";
+    readonly failedCommand: "failed command";
+    readonly before: "the run it came from had";
+    readonly inAll: "in all";
+    readonly guardrail: "the timeout guardrail stopped";
+    readonly command: "command";
+    readonly knownError: "known error";
+    readonly cameWithIts: "came with its fix";
+    readonly cameWithTheir: "came with their fix";
+    readonly noticePrefix: "trail:";
+    readonly contextHead: "Its weekly count for this repo, for the person:";
+    readonly contextTail: "Tell them once at the start of your first reply, in one line, then go on with what they asked.";
+};
+/** The longest line (4.14). */
+export declare const VALUE_MAX = 240;
+/** D117: a hook's bookkeeping lock try; a busy lock drops the count. */
+export declare const VALUE_LOCK_MS = 50;
+/** One skill's week here: uses, uses whose check passed, failed commands summed, and the run it came from. */
+export interface SkillWeek {
+    id: string;
+    name: string;
+    uses: number;
+    checked: number;
+    failed: number;
+    before: {
+        commands: number;
+        failed: number;
+    } | null;
+}
+export interface ValueCounts {
+    skills: SkillWeek[];
+    guardrailStops: number;
+    wallFixes: number;
+}
+export declare function valuePath(env?: NodeJS.ProcessEnv): string;
+/**
+ * Stop (3.5): adds this Stop's guardrail stops and wall fixes to today's counts for the repo. Counts only: anything
+ * but a non-negative whole number is 0, a repo key that isn't one is refused, and 0 and 0 writes nothing.
+ */
+export declare function noteValue(repoKey: string, d: {
+    guardrailStops?: number;
+    wallFixes?: number;
+}, env?: NodeJS.ProcessEnv, now?: Date): void;
+/**
+ * Records that the line went out for the repo today, only while the week is still due: the check and the mark are one
+ * locked step, so of sessions that start together and all read "due", one marks it (review). False when busy,
+ * refused, or already said this week (the caller then says nothing).
+ */
+export declare function markValueSaid(repoKey: string, env?: NodeJS.ProcessEnv, now?: Date): boolean;
+/** Skills on, and on for 7 days or more (P21: there is no week to count before that). */
+export declare function valueWeek(env?: NodeJS.ProcessEnv, now?: Date): boolean;
+/** Once in 7 days per repo, after the first week (4.14). */
+export declare function valueDue(repoKey: string, env?: NodeJS.ProcessEnv, now?: Date): boolean;
+/** The week's counts for these repos (4.14): nothing but the ledgers and value.json. */
+export declare function valueCounts(repoKeys: string[], env?: NodeJS.ProcessEnv, now?: Date): ValueCounts;
+/**
+ * The line from the counts (4.14): parts at 0 left out, null when every part is 0. Cut to 240 characters at whole
+ * parts, never inside one, so no number is cut short: the most used skill, the guardrail and the fixes come first,
+ * then the other skills; what fits is said in the line's own order.
+ */
+export declare function valueWords(c: ValueCounts): string | null;
+/** 4.14: the line for these repos, or null when there is nothing to say. */
+export declare function valueLine(repoKeys: string[], env?: NodeJS.ProcessEnv, now?: Date): string | null;
+/**
+ * The line as SessionStart context where the host shows no start notice (P20, D107's shape): who it is from, that it
+ * is a count for the person, and when to tell them. One line; the quoted line can't close the quote early.
+ */
+export declare function valueContext(line: string): string;
+export interface StartValueCtx {
+    source: string;
+    learn: boolean;
+    subagent: boolean;
+    host: Host;
+    repoKey: string;
+}
+export interface StartValue {
+    channel: 'context' | 'notice';
+    context?: string;
+    notice?: string;
+}
+/**
+ * 3.1 step 3: at a startup or resume, in a session where learning runs (interactive, top level, tier A) and in a
+ * repo, when the week is due and there is something to say: the line goes out once (marked said first; a busy lock
+ * says nothing). A notice where the host shows SessionStart notices, else context. Never throws.
+ */
+export declare function startValue(ctx: StartValueCtx, env?: NodeJS.ProcessEnv, now?: Date): StartValue | null;
+/** Stop: the timeout guardrail's sure-fail denies this Stop counted (`guardrailCounts`' telemetry), for `noteValue`. The line names that guardrail, so no other class counts. */
+export declare function guardrailStopsIn(sent: ReadonlyArray<readonly [string, Record<string, string>]>): number;
+//# sourceMappingURL=value-line.d.ts.map

package/dist/skills/value-line.d.ts.map

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