@nanonets/graft 0.23.1 → 0.24.1

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":"AAiBA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C,gEAAgE;AAChE,MAAM,cAAc,GAAG,gMAAgM,CAAC;AACxN,MAAM,YAAY,GAAG,+CAA+C,CAAC;AACrE,qGAAqG;AACrG,MAAM,YAAY,GAAG,kLAAkL,CAAC;AACxM,MAAM,QAAQ,GAAG,cAAc,CAAC;AAEhC,kGAAkG;AAClG,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,aAAa,CAAC,CAAU,EAAE,GAAuB;IAC/D,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,KAAiD,EAAE,MAAkB,EAAE,KAAyB;IACzH,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IAC7G,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAC7H,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACzD,MAAM,GAAG,GAAG,yBAAyB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,0BAA0B,CAAC;IAClH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC;IAC1D,IAAI,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpH,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACnI,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,GAAuB,EAAE,SAAyB,EAAE,MAA+B,EAAE,OAAsB;IACvI,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,IAAI,OAAO;QAAE,OAAO,IAAI,OAAO,GAAG,CAAC;IACnC,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACjE,OAAQ;QACN,UAAU,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,iBAAiB;QACjE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,SAAS;QACjD,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB;QAC5D,KAAK,EAAE,gBAAgB;QACvB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC;KACvB,CAAC,GAAI,CAAC,IAAI,IAAI,CAAC;AAClD,CAAC"}

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,82 @@
+/**
+ * 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;
+}
+/** Stable branches pushed, in order, from the calls the steps came from (`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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"}

package/dist/skills/compile-words.js

@@ -0,0 +1,385 @@
+import { programOf } from '../trace/shell.js';
+import { factsFromCalls } from '../trace/checks.js';
+import { flatLine } from '../notes/flatten.js';
+import { cleanLine } from '../trace/redact.js';
+import { STABLE_BRANCHES } from './params.js';
+import { gatedGroups } from './risk.js';
+import { askText, JUDGEMENT_JOBS, matchJob } from '../trace/jobs.js';
+import { SAVE_REQUEST } from '../trace/typed.js';
+/** At least one letter, so the digits of `trail skills keep 1 3` (init, 1b) can never be a name. */
+export const NAME_RE = /^(?=[a-z0-9-]*[a-z])[a-z0-9][a-z0-9-]{1,47}$/;
+/** Names Trail's own commands use. store.ts (g4) re-exports this list. */
+export const BUILT_IN_NAMES = new Set([
+    'trail', 'graft', 'verify', 'run', 'init', 'review', 'skills', 'keep', 'forget', 'restore', 'add', 'show', 'draft', 'offers', 'help', 'on', 'off', 'promote', 'team', 'manual',
+]);
+/** 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 const RESERVED_ID = /^(?:ls-[0-9a-f]{6}|l-[0-9a-f]{6,16})$/;
+/** NAME_RE, not built in, not an id's shape, and a valid Agent Skills name (no `--`, no trailing `-`). */
+export function goodName(name) {
+    return NAME_RE.test(name) && !/--|-$/.test(name) && !BUILT_IN_NAMES.has(name) && !RESERVED_ID.test(name);
+}
+const MONTHS = ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'];
+/** 'Oct 27', in local time. */
+export function monthDay(iso) {
+    const d = new Date(iso);
+    return Number.isNaN(d.getTime()) ? 'an earlier day' : `${MONTHS[d.getMonth()]} ${d.getDate()}`;
+}
+const hm = (d) => `${String(d.getHours()).padStart(2, '0')}:${String(d.getMinutes()).padStart(2, '0')}`;
+const slug = (t) => t.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+export const repoName = (key) => key.split('/').filter(Boolean).pop() || 'this repo';
+const cap = (w) => w.charAt(0).toUpperCase() + w.slice(1);
+const joinWith = (items, last) => (items.length < 2 ? items.join('') : `${items.slice(0, -1).join(', ')} ${last} ${items[items.length - 1]}`);
+const REGISTRIES = [
+    [/\b(?:npm|pnpm|yarn(?:\s+npm)?)\s+publish\b/, 'npm', 'npm'],
+    [/\btwine\s+upload\b/, 'pypi', 'PyPI'],
+    [/\bcargo\s+publish\b/, 'crates', 'crates.io'],
+    [/\bdocker\s+push\b/, 'docker', 'Docker'],
+    [/\bgem\s+push\b/, 'gem', 'RubyGems'],
+];
+/** Stable branches pushed, in order, from the calls the steps came from (`push origin beta` then `beta:prod` too). */
+export function stableBranches(calls, jobWords) {
+    const pushed = factsFromCalls(calls.filter((c) => !c.failed), {}).pushedBranches.filter((b) => STABLE_BRANCHES.has(b));
+    const out = [...new Set(pushed)];
+    if (out.length)
+        return out;
+    return ['beta', 'staging', 'prod'].filter((b) => jobWords.includes(b));
+}
+/** The program the null-job name and title come from: the first step that isn't a wait. */
+function mainProgram(steps) {
+    const s = steps.find((x) => !x.wait) ?? steps[0];
+    return s ? programOf(s.cmd) : null;
+}
+/**
+ * The kind of tests the person asked for, in their own words ("run the integration tests"), from the job words their
+ * asks matched; null when they said only "the tests". Never the runner's name: nobody asked for "pytest tests".
+ */
+function testsTag(jobWordsSaid) {
+    return ['integration', 'e2e'].find((w) => jobWordsSaid.includes(w)) ?? null;
+}
+/** 4.6's stop words, and words that say how to keep a skill or how the job went, not what the job is. */
+const ASK_SKIP = new Set(("a an the to and then please can could would you we i it its this that now also just so okay ok yes lets let's do some me my our for of on in at "
+    + 'first again too as well be is are will save saved keep kept make made turn remember skill skills step steps next time later thanks thank '
+    + 'great nice cool awesome perfect good pls works worked working done everything every all repo repos team when need needs want how what way '
+    + 'us your they them he she was were been has have had there here').split(' '));
+const KEEP_CLAUSE = new RegExp(SAVE_REQUEST.source, 'gi');
+const SCOPE_CLAUSE = /\b(?:for|in|on|across)\s+(?:every|all(?:\s+my)?|this|the|my|our|each)\s+(?:repos?|repositories|team|mac|machine|laptop|projects?)\b|\beverywhere\b|\balways\b/g;
+const CLAUSE_BREAK = /[,.;:!?()[\]"{}\n]+|\s(?:and then|then|so that|so|because|since|but)\s/;
+/**
+ * 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 function askPhrases(typed) {
+    const t = askText(String(typed ?? '')).toLowerCase().replace(/[\u2018\u2019]/g, "'")
+        .replace(KEEP_CLAUSE, ' , ').replace(SCOPE_CLAUSE, ' , ')
+        .replace(/\b[a-z][a-z0-9+.-]*:\/\/\S+/g, ' ')
+        .replace(/\S*\w[./\\]\w\S*/g, ' ')
+        .replace(/(?<![\w-])(?=[0-9a-f]*\d)[0-9a-f]{7,40}(?![\w-])/g, ' ')
+        .replace(/(?<![\w-])#?\d[\w-]*/g, ' ');
+    const out = [];
+    for (const clause of t.split(CLAUSE_BREAK)) {
+        const words = clause.split(/[^a-z0-9-]+/).filter((w) => w.length >= 2 && /^[a-z]/.test(w) && !ASK_SKIP.has(w));
+        if (words.length < 2 || words.length > 5)
+            continue;
+        const phrase = words.join(' ');
+        if (!out.includes(phrase))
+            out.push(phrase);
+        if (out.length === 2)
+            break;
+    }
+    return out;
+}
+/**
+ * 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 function askedJob(askedWith, steps, calls, checkFamily) {
+    const said = askedWith ? matchJob(String(askedWith).replace(KEEP_CLAUSE, ' , '))?.job ?? null : null;
+    if (said !== null && !JUDGEMENT_JOBS.has(said))
+        return said;
+    const text = steps.map((s) => s.cmd).join('\n');
+    if (REGISTRIES.some(([re]) => re.test(text)) && (checkFamily === 'npm-view' || checkFamily === null))
+        return 'release';
+    if (stableBranches(calls, []).length)
+        return 'ship';
+    return 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 function jobWords(sheet, steps, extra = {}) {
+    const repo = repoName(sheet.repoKey);
+    const other = 'Jobs other than this one.';
+    const job = sheet.job;
+    if (job === 'release') {
+        const text = `${steps.map((s) => s.cmd).join('\n')}\n${extra.helperText ?? ''}`;
+        const reg = REGISTRIES.find(([re]) => re.test(text));
+        const asks = ['publish', 'release', 'bump', 'redo the publish'];
+        if (!reg)
+            return { base: 'release', title: `Release ${repo}`, lead: `Releases ${repo}`, asks, statusAsks: ['is it published', 'did it publish'], dontUse: 'Pre-releases, or packages other than the ones above.' };
+        return { base: `release-${reg[1]}`, title: `Release ${repo} to ${reg[2]}`, lead: `Publishes ${repo} to ${reg[2]}`, asks: [...asks, `ship to ${reg[1]}`], statusAsks: ['is it published', 'did it publish'], dontUse: 'Pre-releases, or packages other than the ones above.' };
+    }
+    if (job === 'ship') {
+        const b = stableBranches(extra.calls ?? steps.map((s, i) => ({ id: `s${i}`, cmd: s.cmd, failed: false })), sheet.jobWords);
+        const dontUse = 'Pushes to other branches, or other repos.';
+        if (b.length >= 2) {
+            const [b1, b2] = [b[0], b[b.length - 1]];
+            return {
+                base: `ship-${b1}-then-${b2}`, title: `Ship ${repo}: ${b1}, then ${b2}`, lead: `Ships ${repo} to ${b1}, then fast-forwards ${b2}`,
+                asks: [`push to ${b1}`, `ff to ${b2}`, `fast-forward ${b2}`, `promote to ${b2}`, `deploy to ${b2}`, `update ${b2}`, 'ship it'],
+                statusAsks: ['is it live', `is ${b2} updated`, 'did it deploy'], dontUse,
+            };
+        }
+        if (b.length === 1) {
+            const one = b[0];
+            return { base: `ship-${one}`, title: `Ship ${repo} to ${one}`, lead: `Ships ${repo} to ${one}`, asks: [`push to ${one}`, `deploy to ${one}`, `update ${one}`, 'ship it'], statusAsks: ['is it live', `is ${one} updated`, 'did it deploy'], dontUse };
+        }
+        return { base: 'ship', title: `Ship ${repo}`, lead: `Ships ${repo}`, asks: ['ship it', 'deploy it'], statusAsks: ['is it live', 'did it deploy'], dontUse };
+    }
+    if (job === 'tests') {
+        const tag = testsTag(sheet.jobWords);
+        if (!tag)
+            return { base: 'run-tests', title: `Run ${repo}'s tests`, lead: `Runs ${repo}'s tests`, asks: ['run the tests'], statusAsks: ['did the tests pass'], dontUse: 'Other test suites.' };
+        return { base: `${tag}-tests`, title: `Run ${repo}'s ${tag} tests`, lead: `Runs ${repo}'s ${tag} tests`, asks: [`${tag} tests`, `run the ${tag} tests`], statusAsks: ['did the tests pass'], dontUse: 'Other test suites.' };
+    }
+    if (job === 'report') {
+        const w = sheet.jobWords.filter((x) => x !== 'report').slice(0, 2);
+        const dontUse = 'Other numbers or other tables.';
+        if (w.length === 2) {
+            const [w1, w2] = w;
+            return { base: `${w1}-${w2}-report`, title: `${cap(w1)} ${w2} report for ${repo}`, lead: `Reads the ${w1} ${w2} numbers for ${repo}`, asks: [`any ${w1} ${w2}`, `${w1} ${w2}`, `how many ${w2}`], statusAsks: [], dontUse };
+        }
+        if (w.length === 1)
+            return { base: `${w[0]}-report`, title: `${cap(w[0])} report for ${repo}`, lead: `Reads the ${w[0]} numbers for ${repo}`, asks: [w[0]], statusAsks: [], dontUse };
+        return { base: 'report', title: `Report for ${repo}`, lead: `Reads the numbers for ${repo}`, asks: ['report'], statusAsks: [], dontUse };
+    }
+    if (job === 'run-local')
+        return { base: 'run-locally', title: `Run ${repo} locally`, lead: `Starts ${repo} locally`, asks: ['open it locally', 'run it locally', 'localhost'], statusAsks: [], dontUse: other };
+    // A check that is a step (tests, a query, a push) is what the run was for: it names the skill.
+    const prog = (extra.main !== undefined ? programOf(extra.main) : null) ?? mainProgram(steps) ?? 'these commands';
+    // D71 b: a common word of the run ("done", "test", the repo's name) as an ask fired on unrelated prompts.
+    return { base: slug(prog) || 'steps', title: `Run ${prog} in ${repo}`, lead: `Runs ${prog} in ${repo}`, asks: extra.asked ?? [], statusAsks: [], dontUse: other };
+}
+/** The base name, then -<repo>, then -2, -3 ...: the first that is a good name and free. */
+export function freeName(base, repoKey, taken) {
+    const fit = (n) => n.slice(0, 48).replace(/-+$/, '');
+    const b = goodName(fit(base)) ? fit(base) : fit(`run-${base}`);
+    const tries = [b, fit(`${b}-${slug(repoName(repoKey))}`)];
+    for (let n = 2; n < 100; n++)
+        tries.push(`${b.slice(0, 44).replace(/-+$/, '')}-${n}`);
+    return tries.find((n) => goodName(n) && !taken(n)) ?? `${b.slice(0, 40)}-${repoKey.length}`;
+}
+export function proposeName(sheet, steps, taken) {
+    return freeName(jobWords(sheet, steps).base, sheet.repoKey, taken);
+}
+/** Words an ask starts with when it is something to do: "asked to run the tests", "asked to publish". */
+const ASK_VERBS = new Set(['run', 'rerun', 'push', 'ff', 'fast-forward', 'promote', 'deploy', 'update', 'ship', 'publish', 'release', 'bump', 'redo',
+    'open', 'start', 'restart', 'stop', 'build', 'rebuild', 'test', 'check', 'fix', 'merge', 'rebase', 'lint', 'format', 'generate', 'regenerate',
+    'install', 'upgrade', 'clean', 'reset', 'sync', 'pull', 'fetch', 'commit', 'tag', 'create', 'make', 'add', 'remove', 'delete', 'migrate', 'seed',
+    'serve', 'compile', 'pack', 'upload', 'download', 'review', 'refresh', 'roll', 'revert', 'cut', 'prepare', 'verify', 'show', 'list', 'count',
+    'get', 'find', 'read', 'send', 'do', 'try', 'tidy', 'trim', 'backup', 'restore', 'export', 'import', 'reindex', 'index', 'measure', 'profile']);
+const ASK_QUESTION = /^(?:how|what|which|who|when|where|why|is|are|was|were|did|does|can)\b/i;
+/** How one ask follows "asked" or "you ask": `to` a verb, a question bare, `about` a gerund, `for` anything else. */
+function askLead(ask) {
+    const first = ask.trim().split(/\s+/)[0]?.toLowerCase() ?? '';
+    if (ASK_QUESTION.test(first))
+        return '';
+    if (/^\S+ tests$/i.test(ask.trim()))
+        return 'for';
+    if (ASK_VERBS.has(first))
+        return 'to';
+    return /\w{3,}ing$/.test(first) ? 'about' : 'for';
+}
+/**
+ * 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 function askedWords(asks) {
+    const groups = [];
+    for (const a of asks) {
+        const lead = askLead(a);
+        const last = groups[groups.length - 1];
+        if (last && last.lead === lead && lead !== '')
+            last.items.push(a);
+        else
+            groups.push({ lead, items: [a] });
+    }
+    const parts = groups.map((g) => `${g.lead ? `${g.lead} ` : ''}${joinWith(g.items, 'or')}`);
+    return parts.length < 2 ? parts.join('') : `${parts.slice(0, -1).join(', ')}, or ${parts[parts.length - 1]}`;
+}
+/** "<lead>, from the steps that worked on <Mon D>. Use when asked to <a, b or c>.", at most 300 characters. */
+export function describe(lead, endedAt, asks) {
+    if (!asks.length)
+        return flatLine(`${lead}, from the steps that worked on ${monthDay(endedAt)}.`, 300);
+    const make = (a) => flatLine(`${lead}, from the steps that worked on ${monthDay(endedAt)}. Use when asked ${askedWords(a)}.`, 1000);
+    for (let n = asks.length; n >= 1; n--) {
+        const d = make(asks.slice(0, n));
+        if (d.length <= 300)
+            return d;
+    }
+    return flatLine(make(asks.slice(0, 1)), 300);
+}
+const split = (s) => (s ? s.split(' ; ').map((x) => x.trim()).filter(Boolean) : []);
+function probeWords(p) {
+    let m;
+    if (p === 'git status --porcelain')
+        return 'no uncommitted changes (git status --porcelain)';
+    if ((m = /^git rev-parse --abbrev-ref HEAD = (\S+)$/.exec(p)))
+        return `on ${m[1]} (git rev-parse --abbrev-ref HEAD)`;
+    if ((m = /^command -v (\S+)$/.exec(p)))
+        return `${m[1]} is installed (${p})`;
+    if ((m = /^(?:test -\w|\[ -S) (\S+)/.exec(p)))
+        return `${m[1]} is there (${p})`;
+    if ((m = /^git rev-parse --verify (\S+)$/.exec(p)))
+        return `${m[1]} exists (${p})`;
+    return p;
+}
+const WAIT_TOKEN = /^s=\$SECONDS; until \[ "\$\((.*)\)" = "([^"]*)" \]; do /;
+const WAIT_ANY = /^s=\$SECONDS; (until|while) (.*) >\/dev\/null 2>&1; do /;
+function stepWords(s) {
+    if (s.wait) {
+        const t = WAIT_TOKEN.exec(s.cmd);
+        if (t)
+            return `wait up to 5 min until ${t[1]} shows ${t[2]}`;
+        const a = WAIT_ANY.exec(s.cmd);
+        if (a)
+            return a[1] === 'until' ? `wait up to 5 min until ${a[2]} works` : `wait up to 5 min while ${a[2]} still works`;
+    }
+    return s.bg ? `${s.cmd} (in the background)` : s.cmd;
+}
+const LEFT = [
+    ['failed', (n) => `${n} that failed`],
+    ['lookOnly', (n) => `${n} that only looked around`],
+    ['duplicates', (n) => `${n} ${n === 1 ? 'repeat' : 'repeats'}`],
+    ['plumbing', (n) => `${n} that only set up the shell`],
+    ['work', (n) => `${n} that changed files`],
+];
+/** D58 b: a left-out step as the draft shows it (`clean`: compile's step cleaning and paths), and where it ran. */
+export function elsewhereLines(calls, repoKey, clean) {
+    const out = [];
+    for (const c of calls) {
+        const text = c.cmd === null ? null : cleanLine(clean(c.cmd), 100);
+        const cmd = text ?? (c.truncated ? 'a command too long to show' : "a command Trail can't show (it held a secret)");
+        const where = c.key === null ? 'outside any repo' : c.key !== repoKey ? `in ${repoName(c.key)}` : "in a folder Trail couldn't follow";
+        if (!out.some((x) => x.cmd === cmd && x.where === where))
+            out.push({ cmd, where });
+    }
+    return out;
+}
+/** D59a: a joined sheet's compactions, its first start, and the steps whose every run came before the last compaction. */
+export function carriedSteps(sheet, steps) {
+    const n = (sheet.joined ?? []).reduce((a, p) => a + p.calls, 0);
+    const before = new Set(sheet.calls.slice(0, n).map((c) => c.id));
+    return { compactions: sheet.joined?.length ?? 0, startedAt: sheet.startedAt, steps: steps.filter((s) => s.from?.length && s.from.every((id) => before.has(id))).map((s) => s.n) };
+}
+/** "step 2", "steps 1 and 2", "steps 1, 2 and 3". */
+const stepList = (ns) => `${ns.length === 1 ? 'step' : 'steps'} ${joinWith(ns.map(String), 'and')}`;
+/** D59a: the draft line for a job a compaction cut, and which steps ran before the (last) compaction. */
+function carriedWords(k) {
+    const across = k.compactions === 1 ? 'a compaction' : `${k.compactions} compactions`;
+    const before = k.compactions === 1 ? 'before it' : 'before the last one';
+    return `  compaction  the job ran across ${across}: ${k.steps.length ? `${stepList(k.steps)} ran ${before}, the rest after` : `every step ran after ${k.compactions === 1 ? 'it' : 'the last one'}`}`;
+}
+/**
+ * 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 function toolCheckWords(tool, facts, params) {
+    const [, server = '', name = tool] = /^mcp__(.+)__([^_].*)$/.exec(tool) ?? [];
+    const provider = /vercel/i.test(server) ? 'Vercel' : flatLine(server, 40) || 'the deploy';
+    const sha = facts.sha;
+    const commit = sha ? params.find((p) => p.shape === 'sha' && p.seen.some((v) => v.length >= 7 && (sha.startsWith(v) || v.startsWith(sha)))) : undefined;
+    const branch = facts.branch ? params.find((p) => p.seen.includes(facts.branch)) : undefined;
+    const target = commit ? `{${commit.name}}` : facts.branch ? `the newest commit on ${branch ? `{${branch.name}}` : facts.branch}` : 'the new commit';
+    return `read the ${provider} deployment for ${target} with ${name}`;
+}
+/** The "show me" text (2.1). */
+export function draftText(c, sheet) {
+    const from = c.carried?.startedAt ?? sheet.startedAt;
+    const start = new Date(from);
+    const end = new Date(sheet.endedAt);
+    const sameDay = monthDay(from) === monthDay(sheet.endedAt);
+    const when = `${monthDay(from)}, ${hm(start)} to ${sameDay ? '' : `${monthDay(sheet.endedAt)}, `}${hm(end)}`;
+    const out = [`${c.name} · copied from the run that just ${sheet.checked ? 'worked' : 'ran'} (${when})`];
+    if (c.carried)
+        out.push(carriedWords(c.carried));
+    for (const x of split(c.meta['check-first']))
+        out.push(`  check first  ${x}`);
+    for (const x of split(c.meta.ready))
+        out.push(`  ready        ${probeWords(x)}`);
+    const groups = gatedGroups(c.steps);
+    for (const s of c.steps) {
+        const g = groups.find((x) => x.steps[0] === s.n);
+        if (g)
+            out.push(`  ■  can't be undone: Claude Code asks you once, right before step ${s.n}${g.steps.length > 1 ? ` (it covers ${joinWith(g.steps.map(String), 'and')})` : ''}`);
+        out.push(`  ${s.n}  ${stepWords(s)}`);
+    }
+    if (!c.check)
+        out.push('  check  none: no check ran in the run this came from');
+    else if (c.checkIsStep)
+        out.push(`  check  step ${[...c.steps].reverse().find((s) => s.cmd === c.check)?.n ?? c.steps.length} passing is the check`);
+    else if (c.meta['check-tool'])
+        out.push(`  check  ${c.check}: it should show ${c.checkShows ?? 'READY'}`);
+    else
+        out.push(`  check  ${c.check} ${c.checkShows ? `shows ${c.checkShows}` : 'works'}`);
+    for (const h of c.helpers)
+        out.push(`  helper  ${h.file}, copied into the skill from a temporary folder`);
+    for (const p of c.params) {
+        const seen = p.seen[0] ? `; it was ${p.seen[0]} this time` : '';
+        if (p.default?.startsWith('$('))
+            out.push(`  {${p.name}}  from what you type, or ${p.default.slice(2, -1)}${seen}`);
+        else if (p.default !== undefined)
+            out.push(`  {${p.name}}  from what you type, or ${p.default} as last time`);
+        else
+            out.push(`  {${p.name}}  from what you type${seen}`);
+    }
+    const away = c.elsewhere ?? [];
+    const total = Object.values(c.leftOut).reduce((a, b) => a + b, 0) + away.length;
+    const parts = LEFT.filter(([k]) => c.leftOut[k]).map(([k, f]) => f(c.leftOut[k]));
+    if (away.length)
+        parts.push(`${away.length} that ran outside this repo`);
+    if (total)
+        out.push(`  left out  ${total} ${total === 1 ? 'command' : 'commands'}: ${parts.join(', ')}`);
+    // D58 b: what ran elsewhere, so the person sees it before saying yes.
+    for (const e of away.slice(0, 6))
+        out.push(`  elsewhere  ${e.cmd} (${e.where})`);
+    if (away.length > 6)
+        out.push(`  elsewhere  and ${away.length - 6} more`);
+    out.push(`  just for you, ${c.meta.applies === 'every repo' ? 'in every repo' : 'in this repo'} · nothing is shared or uploaded`);
+    return out.join('\n');
+}
+/** A refusal in plain words: "a step reads a credential file: `TOKEN=$(python3 -c …auth.json…)`". */
+export function refusalWords(reason, detail) {
+    const d = flatLine(detail, 120);
+    switch (reason) {
+        case 'judgement':
+            return d === 'sweep'
+                ? "going through PRs takes judgement each time, so Trail doesn't keep it as fixed steps"
+                : "getting checks green takes judgement each time, so Trail doesn't keep it as fixed steps";
+        case 'no-steps': return d === 'report'
+            ? 'the numbers came from a script written inline, not from a command Trail can keep'
+            : 'no command in the run did the job itself: they only looked around, set up the shell or changed files';
+        case 'too-long': return d === 'overflow' ? 'the run had more commands than Trail keeps for one job' : `the job takes ${d || 'more than 12'} steps, and a skill holds at most 12`;
+        case 'step-too-long': return `a step is longer than 300 characters: \`${d}\``;
+        case 'multi-line': return /^(?:uses|needs|runs) [^`]*: `/.test(d) ? `a step ${d}` : `a step runs over several lines (a heredoc or an inline script): \`${d}\``;
+        case 'never-save': return d.startsWith('bug: ') ? `the skill file came out wrong (${d.slice(5)})` : `a step ${d}`;
+        case 'secret': return "a step holds a secret Trail can't turn into a variable name";
+        case 'scratch-path': return `a step uses a temporary file: \`${d}\``;
+        case 'outside-repo': return `a step ran outside this repo: \`${d}\``;
+        case 'truncated': return 'a step is over 2,000 characters';
+        case 'no-check': return d === 'version'
+            ? "the check reads a version, but no step names or makes the version it should show, so it can't tell this release from the last one"
+            : 'nothing in the run checked that the job worked';
+        case 'trivial': return `every step is already a script in the repo (\`${d}\`), so there is nothing worked out to keep`;
+        case 'helper-missing': return `a step runs a temporary script that is gone now: \`${d}\``;
+        case 'answers-prompt': return `a step answers a login or confirmation prompt for the person: \`${d}\``;
+    }
+}
+/** D56a: what a push check shows, its branch as the param that holds it. */
+export function pushShows(branch, params) {
+    const p = branch ? params.find((x) => x.seen.includes(branch)) : undefined;
+    const dst = p ? `{${p.name}}` : branch;
+    return dst ? `${dst} moved: git prints old..new -> ${dst}, not "Everything up-to-date"` : 'the branch moved: git prints old..new, not "Everything up-to-date"';
+}
+//# sourceMappingURL=compile-words.js.map