@nanonets/graft 0.24.0 → 0.25.0

package/dist/skills/compile-version.js

@@ -0,0 +1,56 @@
+import { pushShows } from './compile-words.js';
+/** A tag or release lookup, anywhere in the check's command. */
+const VERSION_LOOKUP = /\bgit\s+ls-remote\b[^;&|\n]*\s(?:--tags\b|refs\/tags\/|v?\d+\.\d+)|\bgh\s+release\s+(?:view|list)\b|\bgit\s+tag\s+(?:-l|--list|--points-at|--contains)\b|\bgit\s+describe\b[^;&|\n]*\s--tags\b/;
+const BARE_VERSION = /^\s*v?(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\s*$/;
+/** A bump that writes the next version into package.json, and a publish that reads it from there. */
+const FROM_PACKAGE = /\b(?:npm|pnpm)\s+version\s+(?:major|minor|patch|premajor|preminor|prepatch|prerelease)\b|\byarn\s+version\s+--(?:major|minor|patch)\b|\b(?:npm|pnpm|yarn(?:\s+npm)?)\s+publish\b/;
+const SAFE_DIR = /^[\w./@+-]*$/;
+/** The version a check call printed: its CheckHit's, else an output that is one version alone. */
+export function shownVersion(c) {
+    return c.check?.facts.version ?? BARE_VERSION.exec(c.tail ?? '')?.[1];
+}
+/** A check whose shown fact is a version. Tests and pushes are steps that double as the check, never a version read. */
+export function versionShaped(c, fam) {
+    if (fam === 'npm-view')
+        return true;
+    if (fam === 'tests' || fam === 'push' || c.tool)
+        return false;
+    return VERSION_LOOKUP.test(c.cmd ?? '') || shownVersion(c) !== undefined;
+}
+/**
+ * The `{version}` param a version check shows, and the params with it. A version param the steps use, the one the
+ * check printed first; else a step that bumps or publishes from package.json gives `{version}`, read from that
+ * folder's package.json when the check runs (a `{version}` the check alone wrote takes that default). Null: no
+ * step names or makes the version.
+ */
+export function versionTie(steps, params, shown) {
+    const used = params.filter((p) => p.shape === 'version' && steps.some((s) => s.cmd.includes(`{${p.name}}`)));
+    if (used.length)
+        return { name: (used.find((p) => shown !== undefined && p.seen.includes(shown)) ?? used[0]).name, params };
+    const from = steps.find((s) => FROM_PACKAGE.test(s.cmd));
+    if (!from || !SAFE_DIR.test(from.cwd ?? ''))
+        return null;
+    const def = `$(node -p "require('./${from.cwd ? `${from.cwd.replace(/\/+$/, '')}/` : ''}package.json').version")`;
+    const inCheck = params.find((p) => p.shape === 'version');
+    if (inCheck)
+        return { name: inCheck.name, params: params.map((p) => (p === inCheck ? { ...p, default: def } : p)) };
+    return { name: 'version', params: [...params, { name: 'version', shape: 'version', default: def, seen: shown ? [shown] : [] }] };
+}
+/** Step 3: what the check shows. `version`: the tied param's name (D106). */
+export function checkShowsFor(fam, checkCall, params, version) {
+    if (!checkCall)
+        return null;
+    if (version)
+        return `{${version}}`;
+    const hasParam = (n) => params.some((p) => p.name === n);
+    return {
+        'npm-view': hasParam('version') ? '{version}' : 'the new version',
+        deploy: checkCall.check?.facts.state ?? 'success',
+        'ls-remote': hasParam('sha') ? '{sha}' : 'the pushed commit',
+        tests: 'the tests pass',
+        query: 'rows come back',
+        'gh-checks': 'all checks pass',
+        push: pushShows(checkCall.check?.facts.branch, params),
+    }[fam] ?? null;
+}
+//# sourceMappingURL=compile-version.js.map

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

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

package/dist/skills/compile-waits.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 4.5 step 5, split from compile.ts: which calls of a run fold into one wait
+ * (the same command polled until it read differently), and which earlier
+ * polls each wait swallows.
+ */
+import type { RunCall, RunSheet } from '../trace/types.js';
+/** 4.5 step 5: which calls fold into a wait, and which earlier polls they swallow. */
+export declare function findWaits(calls: RunCall[], ci: number | null, job: RunSheet['job']): Map<number, {
+    token: string | null;
+    polls: number[];
+}>;
+//# sourceMappingURL=compile-waits.d.ts.map

package/dist/skills/compile-waits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile-waits.d.ts","sourceRoot":"","sources":["../../src/skills/compile-waits.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAO3D,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoC3I"}

package/dist/skills/compile-waits.js

@@ -0,0 +1,52 @@
+import { normalizeCommand } from '../trace/shell.js';
+import { READ_ONLY_FAMILIES, checkFamilyOf } from '../trace/checks.js';
+const LEADING_SLEEP = /^\s*sleep\s+\d+(?:\.\d+)?[smh]?\s*(?:;|&&)/;
+const SLEEP_ONLY = /^\s*sleep\s+\d+(?:\.\d+)?[smh]?\s*$/;
+/** 4.5 step 5: which calls fold into a wait, and which earlier polls they swallow. */
+export function findWaits(calls, ci, job) {
+    const key = calls.map((c) => (c.cmd === null || c.cwd === null ? null : `${c.cwd}\u0000${normalizeCommand(c.cmd)}`));
+    const steps = [0];
+    for (const c of calls)
+        steps.push(steps[steps.length - 1] + (c.kind === 'step' ? 1 : 0));
+    const link = calls.map(() => -1);
+    const last = new Map();
+    key.forEach((k, i) => {
+        if (k === null)
+            return;
+        const j = last.get(k);
+        // Adjacent: only looks, plumbing and work of other commands in between.
+        if (j !== undefined && steps[i] - steps[j + 1] === 0)
+            link[i] = j;
+        last.set(k, i);
+    });
+    const isPrev = new Set(link.filter((j) => j >= 0));
+    const out = new Map();
+    for (let L = 0; L < calls.length; L++) {
+        if (link[L] < 0 || isPrev.has(L))
+            continue;
+        const group = [];
+        for (let g = L; g >= 0; g = link[g])
+            group.unshift(g);
+        const lastCall = calls[L];
+        const earlier = group.slice(0, -1);
+        if (lastCall.failed)
+            continue;
+        if (!earlier.every((e) => calls[e].failed || (calls[e].tail ?? '') !== (lastCall.tail ?? '')))
+            continue;
+        const fam = checkFamilyOf(lastCall.cmd, job);
+        let poll = false;
+        if (lastCall.kind === 'look')
+            poll = fam !== null && READ_ONLY_FAMILIES.has(fam);
+        else if (lastCall.kind === 'step') {
+            // A step that ran again is a retry unless the run was polling: a leading sleep, or a sleep call in between.
+            const between = calls.slice(group[0] + 1, L).some((c) => c.cmd !== null && SLEEP_ONLY.test(c.cmd));
+            poll = between || group.slice(1).some((g) => LEADING_SLEEP.test(calls[g].cmd ?? ''));
+        }
+        if (!poll)
+            continue;
+        const t = (lastCall.tail ?? '').trim();
+        out.set(L, { token: L === ci ? null : /^[\w.-]{1,24}$/.test(t) ? t : null, polls: earlier });
+    }
+    return out;
+}
+//# sourceMappingURL=compile-waits.js.map

package/dist/skills/compile-waits.js.map

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

package/dist/skills/compile-words.d.ts

@@ -0,0 +1,85 @@
+/**
+ * The words around a compiled skill, from templates, never from a model
+ * (design 4.5 step 13, 2.1): its name, title, description, the asks that
+ * bring it back, what it is not for; the "show me" print; and a refusal in
+ * plain words.
+ *
+ * Pure: no files, no clock (dates come from the run sheet).
+ */
+import type { CheckHit, JobClass, RunCall, RunSheet } from '../trace/types.js';
+import type { CompiledSkill, SkillStep } from './types.js';
+export type CompileRefusal = 'no-steps' | 'too-long' | 'step-too-long' | 'multi-line' | 'never-save' | 'secret' | 'scratch-path' | 'outside-repo' | 'truncated' | 'no-check' | 'trivial' | 'helper-missing' | 'judgement' | 'answers-prompt';
+/** At least one letter, so the digits of `trail skills keep 1 3` (init, 1b) can never be a name. */
+export declare const NAME_RE: RegExp;
+/** Names Trail's own commands use. store.ts (g4) re-exports this list. */
+export declare const BUILT_IN_NAMES: ReadonlySet<string>;
+/** Lesson and learning id shapes (`ls-` + 6 hex, `l-` + hex): `trail forget` reads them as ids first, so no skill takes one (D114 (2)). */
+export declare const RESERVED_ID: RegExp;
+/** NAME_RE, not built in, not an id's shape, and a valid Agent Skills name (no `--`, no trailing `-`). */
+export declare function goodName(name: string): boolean;
+/** 'Oct 27', in local time. */
+export declare function monthDay(iso: string): string;
+export declare const repoName: (key: string) => string;
+export interface JobWords {
+    base: string;
+    title: string;
+    lead: string;
+    asks: string[];
+    statusAsks: string[];
+    dontUse: string;
+}
+/**
+ * Where the calls the steps came from shipped to, in order: a remote named for a deploy target (`git push prod
+ * HEAD:main` goes to prod), else the stable branch pushed (`push origin beta` then `beta:prod` too).
+ */
+export declare function stableBranches(calls: RunCall[], jobWords: string[]): string[];
+/**
+ * D71 b: the asks of a run with no job class, from the person's own typed save request: its words minus the save
+ * clause, scope words, values (a URL, a path, a version, a sha, a number) and filler, clause by clause, kept when a
+ * clause leaves 2 to 5 words. At most 2. [] when the request says only how to keep it.
+ */
+export declare function askPhrases(typed: string | null | undefined): string[];
+/**
+ * D99: the job class an asked save names the skill after when the run's typed asks gave none. First the person's
+ * typed save request ("save this publish as a skill"), then the run's own commands: a step that publishes to a
+ * registry, checked with `npm view` (or not checked at all), is a release; pushes to stable branches are a ship.
+ * Null when neither says (the run keeps the first-step name). Judgement jobs never name a skill.
+ */
+export declare function askedJob(askedWith: string | null | undefined, steps: SkillStep[], calls: RunCall[], checkFamily: CheckHit['family'] | null): JobClass | null;
+/** 4.5 step 13's table. `asked`: a job-less run's asks (D71 b), from `askPhrases`; never the run's own words. */
+export declare function jobWords(sheet: RunSheet, steps: SkillStep[], extra?: {
+    calls?: RunCall[];
+    helperText?: string;
+    main?: string;
+    asked?: string[];
+}): JobWords;
+/** The base name, then -<repo>, then -2, -3 ...: the first that is a good name and free. */
+export declare function freeName(base: string, repoKey: string, taken: (n: string) => boolean): string;
+export declare function proposeName(sheet: RunSheet, steps: SkillStep[], taken: (n: string) => boolean): string;
+/**
+ * fix-lab5: the asks as words after "asked" (or "you ask"), each the way it reads: "to publish, release or bump",
+ * "for integration tests, or to run the integration tests", "about regenerating the api client", "how many users".
+ * Asks next to each other that take the same word share it.
+ */
+export declare function askedWords(asks: string[]): string;
+/** "<lead>, from the steps that worked on <Mon D>. Use when asked to <a, b or c>.", at most 300 characters. */
+export declare function describe(lead: string, endedAt: string, asks: string[]): string;
+/** D58 b: a left-out step as the draft shows it (`clean`: compile's step cleaning and paths), and where it ran. */
+export declare function elsewhereLines(calls: RunCall[], repoKey: string, clean: (cmd: string) => string): Array<{
+    cmd: string;
+    where: string;
+}>;
+/** D59a: a joined sheet's compactions, its first start, and the steps whose every run came before the last compaction. */
+export declare function carriedSteps(sheet: RunSheet, steps: SkillStep[]): NonNullable<CompiledSkill['carried']>;
+/**
+ * D59b: a check read with a deploy status tool, not a command: what to read, the same way the run did.
+ * The deployment is named by the commit param when one holds its commit, else by its branch, else as the new commit.
+ */
+export declare function toolCheckWords(tool: string, facts: CheckHit['facts'], params: CompiledSkill['params']): string;
+/** The "show me" text (2.1). */
+export declare function draftText(c: CompiledSkill, sheet: RunSheet): string;
+/** A refusal in plain words: "a step reads a credential file: `TOKEN=$(python3 -c …auth.json…)`". */
+export declare function refusalWords(reason: CompileRefusal, detail: string): string;
+/** D56a: what a push check shows, its branch as the param that holds it. */
+export declare function pushShows(branch: string | undefined, params: CompiledSkill['params']): string;
+//# sourceMappingURL=compile-words.d.ts.map

package/dist/skills/compile-words.d.ts.map

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