@nanonets/graft 0.24.0 → 0.24.1

package/dist/skills/skill-diff.js

@@ -0,0 +1,191 @@
+import { oneLine } from './skillmd.js';
+import { MAX_SKILL_BYTES } from './store-fs.js';
+/** Spec 13: a fold changes at most 800 characters, and at most 40% of the file. */
+export const FOLD_MAX_CHARS = 800;
+export const FOLD_MAX_SHARE = 0.4;
+/** The printed diff's default length, the more-lines line included. */
+const PRINT_MAX_LINES = 40;
+const CONTEXT = 3;
+/** Cells of the alignment table after the common start and end are taken off; past it the middle is one hunk. */
+const MAX_CELLS = 4_000_000;
+/** Lines of a text; a trailing line break ends the last line, it doesn't start an empty one. '' has none. */
+function linesOf(text) {
+    const t = String(text ?? '');
+    if (!t)
+        return [];
+    const out = t.split('\n');
+    if (out[out.length - 1] === '')
+        out.pop();
+    return out;
+}
+/** The edit script of the middle (LCS, a table of at most MAX_CELLS); past it, all removed then all added. */
+function middleOps(a, b) {
+    const n = a.length;
+    const m = b.length;
+    if (!n || !m || n * m > MAX_CELLS)
+        return [...a.map((line) => ({ kind: '-', line })), ...b.map((line) => ({ kind: '+', line }))];
+    const w = m + 1;
+    const t = new Uint32Array((n + 1) * w);
+    for (let i = n - 1; i >= 0; i--) {
+        for (let j = m - 1; j >= 0; j--) {
+            t[i * w + j] = a[i] === b[j] ? t[(i + 1) * w + j + 1] + 1 : Math.max(t[(i + 1) * w + j], t[i * w + j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < n && j < m) {
+        if (a[i] === b[j]) {
+            ops.push({ kind: '=', line: a[i] });
+            i++;
+            j++;
+        }
+        else if (t[(i + 1) * w + j] >= t[i * w + j + 1])
+            ops.push({ kind: '-', line: a[i++] });
+        else
+            ops.push({ kind: '+', line: b[j++] });
+    }
+    while (i < n)
+        ops.push({ kind: '-', line: a[i++] });
+    while (j < m)
+        ops.push({ kind: '+', line: b[j++] });
+    return ops;
+}
+function editScript(a, b) {
+    const la = linesOf(a);
+    const lb = linesOf(b);
+    if (Buffer.byteLength(String(a ?? '')) > MAX_SKILL_BYTES || Buffer.byteLength(String(b ?? '')) > MAX_SKILL_BYTES) {
+        return [...la.map((line) => ({ kind: '-', line })), ...lb.map((line) => ({ kind: '+', line }))];
+    }
+    let pre = 0;
+    while (pre < la.length && pre < lb.length && la[pre] === lb[pre])
+        pre++;
+    let post = 0;
+    while (post < la.length - pre && post < lb.length - pre && la[la.length - 1 - post] === lb[lb.length - 1 - post])
+        post++;
+    const same = (l) => l.map((line) => ({ kind: '=', line }));
+    return [...same(la.slice(0, pre)), ...middleOps(la.slice(pre, la.length - post), lb.slice(pre, lb.length - post)), ...same(la.slice(la.length - post))];
+}
+/** LCS on lines. A hunk's `at` is how many lines of `a` come before it (0-based). */
+export function lineDiff(a, b) {
+    const out = { removed: [], added: [], hunks: [] };
+    let at = 0;
+    let open = null;
+    for (const op of editScript(a, b)) {
+        if (op.kind === '=') {
+            open = null;
+            at++;
+            continue;
+        }
+        if (!open) {
+            open = { at, del: [], add: [] };
+            out.hunks.push(open);
+        }
+        if (op.kind === '-') {
+            open.del.push(op.line);
+            out.removed.push(op.line);
+            at++;
+        }
+        else {
+            open.add.push(op.line);
+            out.added.push(op.line);
+        }
+    }
+    return out;
+}
+/**
+ * D131: step numbers read as one mark, so a renumber alone changes no line: a Run line's `N. `, the check line's
+ * `Step N, ` and an If it fails line's `what worked was step N.`.
+ */
+const unnumbered = (text) => String(text ?? '').split('\n').map((l) => l
+    .replace(/^\d+\. /, '#. ')
+    .replace(/^Step \d+, /, 'Step #, ')
+    .replace(/\bwhat worked was step \d+\./, 'what worked was step #.')).join('\n');
+/**
+ * 4.3 as D131 changed it: the characters an edit changes (every removed and added line, its line break counted), step
+ * numbers taken out first, so one inserted step anywhere costs about its own length. `share` is of the file as it is.
+ */
+export function sizeGate(before, after) {
+    const d = lineDiff(unnumbered(before), unnumbered(after));
+    const chars = [...d.removed, ...d.added].reduce((n, l) => n + l.length + 1, 0);
+    const len = String(before ?? '').length;
+    const share = len ? chars / len : chars ? 1 : 0;
+    return { chars, share, ok: chars <= FOLD_MAX_CHARS && share <= FOLD_MAX_SHARE };
+}
+/** A printed line's length cap: a 2 MB line (a binary file, a minified blob) is cut, never printed whole (review). */
+const PRINT_MAX_LINE = 400;
+/**
+ * Control characters, bidi marks and line separators, printed as escapes (review): a file a person or a teammate
+ * edited can hold an ESC sequence (a terminal title, a clipboard write) or a right-to-left mark that shows other text
+ * than the bytes. Trail's own files never hold one (oneLine drops them), so a skill's text prints as it is.
+ */
+const UNSAFE = /[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u061c\u200e\u200f\u2028\u2029\u202a-\u202e\u2066-\u2069\ufeff]/g;
+const escapeOne = (ch) => (ch === '\r' ? '\\r' : `\\u${ch.charCodeAt(0).toString(16).padStart(4, '0')}`);
+const shown = (line) => {
+    const t = line.length > PRINT_MAX_LINE * 2 ? line.slice(0, PRINT_MAX_LINE * 2) : line;
+    const e = t.replace(UNSAFE, escapeOne);
+    return e.length > PRINT_MAX_LINE || t.length < line.length ? `${e.slice(0, PRINT_MAX_LINE)}…` : e;
+};
+const range = (start, count) => `${count === 0 ? start : start + 1},${count}`;
+/**
+ * A unified diff (3 lines of context), at most `maxLines` lines with the more-lines line, step text as it is. '' when
+ * the texts are equal. Each line at most 400 characters, control characters and bidi marks as escapes (review). An empty `a` prints a new file: phase 3's `renderNewFileDiff` prints through it.
+ */
+export function printDiff(a, b, labels, maxLines = PRINT_MAX_LINES) {
+    const ops = editScript(a, b);
+    if (!ops.some((o) => o.kind !== '='))
+        return '';
+    // Each op with its place in a and b; hunks are runs of changes with the context around them, merged when they touch.
+    const at = [];
+    let ai = 0;
+    let bi = 0;
+    for (const o of ops) {
+        at.push({ ai, bi });
+        if (o.kind !== '+')
+            ai++;
+        if (o.kind !== '-')
+            bi++;
+    }
+    const out = [`--- ${oneLine(labels[0])}`, `+++ ${oneLine(labels[1])}`];
+    let k = 0;
+    while (k < ops.length) {
+        if (ops[k].kind === '=') {
+            k++;
+            continue;
+        }
+        const start = Math.max(0, k - CONTEXT);
+        let end = k;
+        for (;;) {
+            while (end < ops.length && ops[end].kind !== '=')
+                end++;
+            let gap = end;
+            while (gap < ops.length && ops[gap].kind === '=')
+                gap++;
+            if (gap < ops.length && gap - end <= CONTEXT * 2) {
+                end = gap;
+                continue;
+            }
+            end = Math.min(ops.length, end + CONTEXT);
+            break;
+        }
+        const part = ops.slice(start, end);
+        const aCount = part.filter((o) => o.kind !== '+').length;
+        const bCount = part.filter((o) => o.kind !== '-').length;
+        out.push(`@@ -${range(at[start].ai, aCount)} +${range(at[start].bi, bCount)} @@`);
+        for (const o of part)
+            out.push(`${o.kind === '=' ? ' ' : o.kind}${shown(o.line)}`);
+        k = end;
+    }
+    const max = Math.max(3, Math.floor(maxLines));
+    if (out.length <= max)
+        return out.join('\n');
+    return [...out.slice(0, max - 1), `… ${out.length - (max - 1)} more lines`].join('\n');
+}
+/** A Run line without its number: what the step is, so a renumber alone changes no line. */
+const stepKey = (s) => `${s.gated ? 'G ' : ''}${oneLine(s.cmd)}${s.wait ? ' (wait)' : s.bg ? ' (bg)' : ''}`;
+/** The Run lines a change touches, for "1 line changes": per hunk the larger of what goes and what comes. */
+export function runLinesChanged(before, after) {
+    const text = (c) => c.steps.map(stepKey).join('\n') + (c.steps.length ? '\n' : '');
+    return lineDiff(text(before), text(after)).hunks.reduce((n, h) => n + Math.max(h.del.length, h.add.length), 0);
+}
+//# sourceMappingURL=skill-diff.js.map

package/dist/skills/skill-diff.js.map

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

package/dist/skills/skill-file.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The `metadata.trail` value a takeaway skill gets: `s-` and 6 hex digits
+ * from its name. The same name always gets the same one, so a skill that is
+ * marked twice (on two machines) is marked alike.
+ */
+export declare function skillMark(name: string): string;
+/**
+ * Whether Trail may rewrite the SKILL.md `text` (front matter `data`, kept in
+ * the repo or on this machine): see the top of this file.
+ */
+export declare function trailOwned(text: string, data: Record<string, unknown>, where: "repo" | "home"): boolean;
+/**
+ * Rewrite `file` at `version` with `body`. In the front matter only
+ * `metadata.version` changes (an old top-level `version` moves there), and a
+ * skill without `metadata.trail` gets `mark`, so it stays Trail's once the old
+ * `version` line is gone. A BOM is dropped: the reference validator refuses
+ * one. False, and the file untouched, when its front matter can't be found.
+ */
+export declare function rewriteSkill(file: string, version: number, body: string, mark: string): boolean;
+/** `path`, or the nearest folder above it that is there (a dangling link counts as there). */
+export declare function nearestThere(path: string): string;
+/** Whether `path`, every link followed, is inside `root` (links followed too). False when either can't be resolved. */
+export declare function within(path: string, root: string): boolean;
+//# sourceMappingURL=skill-file.d.ts.map

package/dist/skills/skill-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-file.d.ts","sourceRoot":"","sources":["../../src/skills/skill-file.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAsBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CASvG;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO/F;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,uHAAuH;AACvH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAO1D"}

package/dist/skills/skill-file.js

@@ -0,0 +1,97 @@
+/**
+ * One SKILL.md on disk: whether it is Trail's to rewrite, and the rewrite.
+ *
+ * A skill is Trail's when its front matter says so (`metadata.trail`, the one
+ * key spec section 6 gives Trail), when it is kept on this machine in
+ * ~/.trail (only Trail writes there), or when an older Trail already versioned
+ * it with a top-level `version: 3` line. Trail never rewrites any other
+ * SKILL.md: a skill someone wrote by hand stays exactly as they wrote it, and
+ * its corrections reach the agent through `trail skills show` instead.
+ *
+ * The rewrite finds the front matter the way the reader does (gray-matter
+ * skips a BOM and spaces after a fence), keeps the file's line ends, and
+ * leaves the file alone when it can't find both fences, so a skill never
+ * loses its name or description to a rewrite.
+ *
+ * A skill file is read or written only where its links keep it inside its
+ * own root, the repo's checkout or ~/.trail (`within`).
+ */
+import { createHash } from "node:crypto";
+import { lstatSync, readFileSync, realpathSync, writeFileSync } from "node:fs";
+import { dirname, isAbsolute, relative, sep } from "node:path";
+import { withMetadataVersion } from "./front-version.js";
+/**
+ * The `metadata.trail` value a takeaway skill gets: `s-` and 6 hex digits
+ * from its name. The same name always gets the same one, so a skill that is
+ * marked twice (on two machines) is marked alike.
+ */
+export function skillMark(name) {
+    return `s-${createHash("sha1").update(`skill:${name}`).digest("hex").slice(0, 6)}`;
+}
+/** Where `text`'s front matter is, or null when it doesn't open and close with a `---` line. */
+function front(text) {
+    const lines = text.replace(/^/, "").split(/\r?\n/);
+    const fence = (l) => l !== undefined && l.trimEnd() === "---";
+    if (!fence(lines[0]))
+        return null;
+    const close = lines.findIndex((l, i) => i > 0 && fence(l));
+    return close === -1 ? null : { lines, close, eol: text.includes("\r\n") ? "\r\n" : "\n" };
+}
+/** The line an older Trail wrote at the top level, and nothing a person would write by hand for a version ("1.0", "1.0.0"). */
+const OLD_VERSION_LINE = /^version:[ \t]*\d+[ \t]*$/;
+/**
+ * Whether Trail may rewrite the SKILL.md `text` (front matter `data`, kept in
+ * the repo or on this machine): see the top of this file.
+ */
+export function trailOwned(text, data, where) {
+    if (where === "home")
+        return true;
+    const meta = data.metadata;
+    if (typeof meta === "object" && meta !== null && !Array.isArray(meta)) {
+        const mark = meta.trail;
+        if (typeof mark === "string" && mark.trim())
+            return true;
+    }
+    const f = front(text);
+    return f !== null && f.lines.slice(1, f.close).some((l) => OLD_VERSION_LINE.test(l));
+}
+/**
+ * Rewrite `file` at `version` with `body`. In the front matter only
+ * `metadata.version` changes (an old top-level `version` moves there), and a
+ * skill without `metadata.trail` gets `mark`, so it stays Trail's once the old
+ * `version` line is gone. A BOM is dropped: the reference validator refuses
+ * one. False, and the file untouched, when its front matter can't be found.
+ */
+export function rewriteSkill(file, version, body, mark) {
+    const f = front(readFileSync(file, "utf8"));
+    if (!f)
+        return false;
+    const fm = withMetadataVersion(f.lines.slice(1, f.close), version, mark);
+    const text = `---\n${fm.join("\n")}\n---\n\n${body.trim()}\n`;
+    writeFileSync(file, f.eol === "\n" ? text : text.replace(/\r?\n/g, f.eol));
+    return true;
+}
+/** `path`, or the nearest folder above it that is there (a dangling link counts as there). */
+export function nearestThere(path) {
+    for (let p = path;; p = dirname(p)) {
+        try {
+            lstatSync(p);
+            return p;
+        }
+        catch {
+            if (dirname(p) === p)
+                return p;
+        }
+    }
+}
+/** Whether `path`, every link followed, is inside `root` (links followed too). False when either can't be resolved. */
+export function within(path, root) {
+    try {
+        const rel = relative(realpathSync(root), realpathSync(path));
+        return rel === "" || (rel !== ".." && !rel.startsWith(`..${sep}`) && !isAbsolute(rel));
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=skill-file.js.map

package/dist/skills/skill-file.js.map

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

package/dist/skills/skill-rebuild.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A SKILL.md back to the CompiledSkill that renders it (phase 2 design 4.4,
+ * P11). A skill's fields depend on each other (the steps, `confirm-before`,
+ * `needs`, the check line's "Step N", `version`), so a fold never edits the
+ * text: it rebuilds the CompiledSkill, changes its steps and renders again.
+ * That is only safe when the renderer gives back exactly the file Trail
+ * wrote, so `rebuildCompiled` returns null unless the round trip is byte for
+ * byte. `rebuildLoose` reads a hand-edited file as Trail reads it, for a
+ * proposal beside it (4.6); nothing it returns is ever written over that file.
+ *
+ * Pure: no disk. The source and the helper names come from the caller (the
+ * skill's state and its scripts/ folder).
+ */
+import type { CompiledSkill, ParsedSkill, SkillState } from './types.js';
+/**
+ * A SKILL.md Trail wrote, back to the CompiledSkill that renders it. null unless renderSkillMd(result) === text exactly,
+ * or when `parsed` is not this text's parse. `helpers` are the names in scripts/ (content '': a fold never writes
+ * scripts/, 4.5); `runId` is the state's run, when the caller has it.
+ */
+export declare function rebuildCompiled(text: string, parsed: ParsedSkill, extra: {
+    source: SkillState['source'];
+    helpers: string[];
+    runId?: string | null;
+}): CompiledSkill | null;
+/** Same, without the exact round trip: for a proposal beside a hand-edited file (4.6). null when it has no steps. */
+export declare function rebuildLoose(text: string, parsed: ParsedSkill): CompiledSkill | null;
+//# sourceMappingURL=skill-rebuild.d.ts.map

package/dist/skills/skill-rebuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-rebuild.d.ts","sourceRoot":"","sources":["../../src/skills/skill-rebuild.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8CzE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE;IAAE,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,aAAa,GAAG,IAAI,CAkB1K;AAED,qHAAqH;AACrH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,IAAI,CAQpF"}

package/dist/skills/skill-rebuild.js

@@ -0,0 +1,85 @@
+import { renderSkillMd, skillHash } from './skillmd.js';
+/** The `# ` heading after the front matter, or null. */
+function titleOf(text) {
+    const lines = String(text ?? '').split('\n');
+    let i = 0;
+    if (lines[0]?.trim() === '---') {
+        i = lines.findIndex((l, k) => k > 0 && l.trim() === '---');
+        if (i < 0)
+            return null;
+        i++;
+    }
+    for (; i < lines.length; i++) {
+        const m = /^#\s+(.*?)\s*$/.exec(lines[i]);
+        if (m)
+            return m[1];
+        if (/^##\s/.test(lines[i]))
+            return null;
+    }
+    return null;
+}
+/** The line under "## Check it worked": "Step N, `…`, is the check" or "`…` is the check" means the check is a step. */
+function checkReadsAsStep(text) {
+    const m = /\n## Check it worked\s*\n([^\n]*)/.exec(String(text ?? ''));
+    return !!m && /^(?:Step \d+, )?`.*`,? is the check\b/.test(m[1]);
+}
+function base(parsed, title, checkIsStep, source, helpers) {
+    const check = parsed.check ?? '';
+    return {
+        name: parsed.name,
+        title,
+        description: parsed.description,
+        meta: { ...parsed.meta },
+        steps: parsed.steps.map((s) => ({ n: s.n, cmd: s.cmd, gated: s.gated, bg: s.bg, wait: s.wait })),
+        check,
+        checkShows: check ? parsed.checkShows : null,
+        checkIsStep: checkIsStep && !!check,
+        ifFails: [...parsed.ifFails],
+        dontUse: parsed.dontUse,
+        params: parsed.params.map((p) => ({ ...p, seen: [...p.seen] })),
+        helpers,
+        leftOut: { failed: 0, lookOnly: 0, duplicates: 0, plumbing: 0, work: 0 },
+        source,
+    };
+}
+/**
+ * A SKILL.md Trail wrote, back to the CompiledSkill that renders it. null unless renderSkillMd(result) === text exactly,
+ * or when `parsed` is not this text's parse. `helpers` are the names in scripts/ (content '': a fold never writes
+ * scripts/, 4.5); `runId` is the state's run, when the caller has it.
+ */
+export function rebuildCompiled(text, parsed, extra) {
+    try {
+        const src = String(text ?? '');
+        if (!parsed || parsed.hash !== skillHash(src))
+            return null;
+        const title = titleOf(src);
+        if (title === null)
+            return null;
+        const s = extra?.source;
+        const source = { runId: String(extra?.runId ?? ''), commands: s?.commands ?? 0, failed: s?.failed ?? 0, at: s?.at ?? '' };
+        const helpers = (extra?.helpers ?? []).filter((f) => typeof f === 'string' && f).map((file) => ({ file, from: `scripts/${file}`, content: '' }));
+        const first = checkReadsAsStep(src);
+        for (const asStep of [first, !first]) {
+            const c = base(parsed, title, asStep, source, helpers);
+            if (renderSkillMd(c) === src)
+                return c;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Same, without the exact round trip: for a proposal beside a hand-edited file (4.6). null when it has no steps. */
+export function rebuildLoose(text, parsed) {
+    try {
+        if (!parsed || !parsed.steps.length)
+            return null;
+        const src = String(text ?? '');
+        return base(parsed, titleOf(src) ?? parsed.name, checkReadsAsStep(src), { runId: '', commands: 0, failed: 0, at: '' }, []);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=skill-rebuild.js.map

package/dist/skills/skill-rebuild.js.map

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

package/dist/skills/skillmd.d.ts

@@ -0,0 +1,17 @@
+import type { CompiledSkill, ParsedSkill, SkillMeta } from './types.js';
+export declare const GATED_PREFIX = "Can't be undone (Claude Code asks the person first): ";
+export declare const WAIT_NOTE = "(a wait: run it in the background if it may take over 2 minutes)";
+export declare const BG_NOTE = "(in the background)";
+export declare const NO_CHECK = "No check ran in the run this came from.";
+export declare const NOTHING_FAILED = "Nothing failed in the run this came from.";
+/** D59b: a check read with a deploy status tool (`check-tool`), not run as a command. */
+export declare const TOOL_CHECK = "Check the deployment the same way the run did: ";
+/** A command on one line: breaks become spaces, hidden characters go; spaces inside it are kept. */
+export declare function oneLine(text: string): string;
+export declare function renderSkillMd(c: CompiledSkill): string;
+/** D116 item 5: the lines of `metadata.before-you-start`, each one flat line. */
+export declare function beforeYouStart(meta: Pick<SkillMeta, 'before-you-start'>): string[];
+export declare function skillHash(text: string): string;
+/** Through phase 0's matter(): null on `refused` (anchors, aliases, non-scalars) or when there is no `metadata.trail` key. */
+export declare function parseSkillMd(text: string, folderName: string): ParsedSkill | null;
+//# sourceMappingURL=skillmd.d.ts.map

package/dist/skills/skillmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillmd.d.ts","sourceRoot":"","sources":["../../src/skills/skillmd.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAS,SAAS,EAAa,MAAM,YAAY,CAAC;AAM1F,eAAO,MAAM,YAAY,0DAA0D,CAAC;AACpF,eAAO,MAAM,SAAS,qEAAqE,CAAC;AAC5F,eAAO,MAAM,OAAO,wBAAwB,CAAC;AAC7C,eAAO,MAAM,QAAQ,4CAA4C,CAAC;AAClE,eAAO,MAAM,cAAc,8CAA8C,CAAC;AAC1E,yFAAyF;AACzF,eAAO,MAAM,UAAU,oDAAoD,CAAC;AAY5E,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5C;AAkBD,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,CAgDtD;AAED,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,kBAAkB,CAAC,GAAG,MAAM,EAAE,CAElF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAsBD,8HAA8H;AAC9H,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAiEjF"}