@devenius/junamis-skills 0.0.0-stage → 1.1.0

package/dist/design/yaml.js

@@ -0,0 +1,264 @@
+// Strict, dependency-free YAML subset for design files and deltas.
+//
+// Supported: nested maps, block sequences, scalars, quoted strings, and the
+// literal block scalar (`|`, `|-`, `|+`). Rejected: multiple documents,
+// anchors, aliases, tags, flow collections, folded scalars, tabs, and odd
+// indentation. This is deliberately smaller than YAML so a malformed file
+// fails closed instead of being half-understood.
+import { DesignError } from "./errors.js";
+import { isRecord } from "../types/guards.js";
+function fail(message, detail = null) {
+    throw new DesignError(message, { code: "invalid_yaml", detail });
+}
+function indentOf(line) {
+    return line.length - line.trimStart().length;
+}
+function isIgnorable(line) {
+    const trimmed = line.trim();
+    return trimmed.length === 0 || trimmed.startsWith("#");
+}
+export function parseScalar(raw, label = "value") {
+    let value = raw.trim();
+    if (value.length === 0)
+        return "";
+    if ((value.startsWith('"') && value.endsWith('"')) ||
+        (value.startsWith("'") && value.endsWith("'"))) {
+        if (value.length < 2)
+            fail(`${label} has an unterminated quoted scalar`);
+        return value.slice(1, -1);
+    }
+    if (value.startsWith('"') || value.startsWith("'")) {
+        fail(`${label} has an unterminated quoted scalar`);
+    }
+    if (value === "[]")
+        return [];
+    if (value === "{}")
+        return {};
+    if (value.startsWith("&") || value.startsWith("*") || value.startsWith("!")) {
+        fail(`${label} uses an unsupported YAML anchor, alias, or tag`);
+    }
+    if (value.startsWith("[") || value.startsWith("{")) {
+        fail(`${label} uses an unsupported flow collection`);
+    }
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    if (value === "null" || value === "~")
+        return null;
+    // A YAML comment starts after whitespace. Content hashes and URLs are safe.
+    value = value.replace(/\s+#.*$/, "").trimEnd();
+    return value;
+}
+function peekContent(state) {
+    while (state.index < state.lines.length) {
+        const line = state.lines[state.index] ?? "";
+        if (isIgnorable(line)) {
+            state.index += 1;
+            continue;
+        }
+        return { line, indent: indentOf(line), index: state.index };
+    }
+    return null;
+}
+function parseBlockScalar(state, keyIndent, style) {
+    const collected = [];
+    while (state.index < state.lines.length) {
+        const line = state.lines[state.index] ?? "";
+        if (line.trim() === "") {
+            collected.push("");
+            state.index += 1;
+            continue;
+        }
+        if (indentOf(line) <= keyIndent)
+            break;
+        collected.push(line);
+        state.index += 1;
+    }
+    const nonEmpty = collected.filter((line) => line.trim() !== "");
+    const contentIndent = nonEmpty.length === 0
+        ? keyIndent + 2
+        : Math.min(...nonEmpty.map((line) => indentOf(line)));
+    let content = collected
+        .map((line) => (line.trim() === "" ? "" : line.slice(contentIndent)))
+        .join("\n");
+    if (style === "|-") {
+        content = content.replace(/\n+$/, "");
+    }
+    else if (style === "|+") {
+        // Keep the text exactly as written; the join already preserved newlines.
+    }
+    else {
+        content = content.replace(/\n+$/, "");
+        if (content.length > 0)
+            content += "\n";
+    }
+    return content;
+}
+function parseMapping(state, indent) {
+    const object = {};
+    for (;;) {
+        const peeked = peekContent(state);
+        if (!peeked)
+            break;
+        if (peeked.indent < indent)
+            break;
+        if (peeked.indent > indent)
+            fail(`${state.label} has an unexpected indent on line ${peeked.index + 1}`);
+        const trimmed = peeked.line.trim();
+        if (trimmed.startsWith("- "))
+            fail(`${state.label} mixes a sequence and a mapping on line ${peeked.index + 1}`);
+        const match = /^([A-Za-z0-9_-]+):(.*)$/.exec(trimmed);
+        if (!match)
+            fail(`${state.label} line ${peeked.index + 1} is not a key: value line`);
+        const key = match[1] ?? "";
+        if (Object.prototype.hasOwnProperty.call(object, key))
+            fail(`${state.label} repeats key ${key}`);
+        const rest = (match[2] ?? "").trim();
+        state.index += 1;
+        if (rest.length === 0) {
+            const next = peekContent(state);
+            if (!next || next.indent <= indent) {
+                object[key] = null;
+            }
+            else {
+                object[key] = parseBlock(state, next.indent);
+            }
+            continue;
+        }
+        if (rest === "|" || rest === "|-" || rest === "|+") {
+            object[key] = parseBlockScalar(state, indent, rest);
+            continue;
+        }
+        if (rest.startsWith(">"))
+            fail(`${state.label} uses an unsupported folded block scalar for ${key}`);
+        object[key] = parseScalar(rest, `${state.label}.${key}`);
+    }
+    return object;
+}
+function parseSequence(state, indent) {
+    const items = [];
+    for (;;) {
+        const peeked = peekContent(state);
+        if (!peeked)
+            break;
+        if (peeked.indent < indent)
+            break;
+        if (peeked.indent > indent)
+            fail(`${state.label} has an unexpected indent on line ${peeked.index + 1}`);
+        const trimmed = peeked.line.trim();
+        if (!trimmed.startsWith("-"))
+            break;
+        if (trimmed !== "-" && !trimmed.startsWith("- "))
+            fail(`${state.label} has an invalid sequence item`);
+        const rest = trimmed === "-" ? "" : trimmed.slice(2).trim();
+        state.index += 1;
+        if (rest.length === 0) {
+            const next = peekContent(state);
+            if (!next || next.indent <= indent) {
+                items.push(null);
+            }
+            else {
+                items.push(parseBlock(state, next.indent));
+            }
+            continue;
+        }
+        if (/^[A-Za-z0-9_-]+:/.test(rest)) {
+            const itemIndent = indent + 2;
+            const itemLines = [`${" ".repeat(itemIndent)}${rest}`];
+            while (state.index < state.lines.length) {
+                const line = state.lines[state.index] ?? "";
+                if (line.trim() === "") {
+                    itemLines.push(line);
+                    state.index += 1;
+                    continue;
+                }
+                if (indentOf(line) <= indent)
+                    break;
+                itemLines.push(line);
+                state.index += 1;
+            }
+            const sub = { lines: itemLines, index: 0, label: state.label };
+            const value = parseMapping(sub, itemIndent);
+            const trailing = peekContent(sub);
+            if (trailing)
+                fail(`${state.label} has trailing content in a sequence item`);
+            items.push(value);
+            continue;
+        }
+        items.push(parseScalar(rest, `${state.label} item`));
+        const next = peekContent(state);
+        if (next && next.indent > indent) {
+            fail(`${state.label} has a nested value under a scalar sequence item`);
+        }
+    }
+    return items;
+}
+function parseBlock(state, indent) {
+    const peeked = peekContent(state);
+    if (!peeked)
+        return null;
+    if (peeked.indent < indent)
+        return null;
+    if (peeked.indent > indent)
+        fail(`${state.label} has an unexpected indent on line ${peeked.index + 1}`);
+    const trimmed = peeked.line.trim();
+    if (trimmed === "-" || trimmed.startsWith("- "))
+        return parseSequence(state, indent);
+    return parseMapping(state, indent);
+}
+export function parseYaml(text, { label = "yaml" } = {}) {
+    if (typeof text !== "string")
+        fail(`${label} is not text`);
+    const cleaned = text.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+    const raw = cleaned.split("\n");
+    let start = 0;
+    while (start < raw.length && isIgnorable(raw[start] ?? ""))
+        start += 1;
+    if (start < raw.length && (raw[start] ?? "").trim() === "---")
+        start += 1;
+    const lines = [];
+    for (let i = start; i < raw.length; i++) {
+        const line = raw[i] ?? "";
+        if (line.includes("\t"))
+            fail(`${label} contains a tab on line ${i + 1}`);
+        const trimmed = line.trim();
+        if (trimmed === "---" || trimmed === "...") {
+            fail(`${label} contains multiple YAML documents or an unexpected document marker`);
+        }
+        if (line.trim().length > 0 && indentOf(line) % 2 !== 0) {
+            fail(`${label} indentation must be a multiple of two spaces on line ${i + 1}`);
+        }
+        lines.push(line);
+    }
+    if (lines.every((line) => isIgnorable(line)))
+        return null;
+    const state = { lines, index: 0, label };
+    const value = parseBlock(state, 0);
+    const trailing = peekContent(state);
+    if (trailing)
+        fail(`${label} has trailing content on line ${trailing.index + 1}`);
+    return value;
+}
+export function parseFrontmatterDocument(text, { label = "design file" } = {}) {
+    if (typeof text !== "string")
+        fail(`${label} is not text`);
+    const cleaned = text.replace(/^\uFEFF/, "").replace(/\r\n?/g, "\n");
+    const lines = cleaned.split("\n");
+    if (lines[0] !== "---")
+        fail(`${label} must start with ---`);
+    const end = lines.findIndex((line, index) => index > 0 && line === "---");
+    if (end === -1)
+        fail(`${label} has no closing ---`);
+    const frontText = lines.slice(1, end).join("\n");
+    const body = lines.slice(end + 1).join("\n");
+    if (body.startsWith("---\n") || body === "---") {
+        fail(`${label} contains multiple YAML documents`);
+    }
+    const data = parseYaml(frontText, { label: `${label} frontmatter` });
+    if (!isRecord(data)) {
+        fail(`${label} frontmatter must be a mapping`);
+    }
+    return { data, body };
+}
+//# sourceMappingURL=yaml.js.map

package/dist/design/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/design/yaml.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,0EAA0E;AAC1E,0EAA0E;AAC1E,iDAAiD;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,SAAS,IAAI,CAAC,OAAe,EAAE,MAAM,GAAY,IAAI;IACnD,MAAM,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;AAC/C,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,KAAK,GAAG,OAAO;IACtD,IAAI,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,IACE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAC9C,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAC;QACzE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,GAAG,KAAK,oCAAoC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,GAAG,KAAK,iDAAiD,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACnD,IAAI,CAAC,GAAG,KAAK,sCAAsC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IACpC,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACnD,4EAA4E;IAC5E,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC/C,OAAO,KAAK,CAAC;AACf,CAAC;AAcD,SAAS,WAAW,CAAC,KAAiB;IACpC,OAAO,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IAC9D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAiB,EAAE,SAAiB,EAAE,KAAa;IAC3E,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,OAAO,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS;YAAE,MAAM;QACvC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC;QACzC,CAAC,CAAC,SAAS,GAAG,CAAC;QACf,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,OAAO,GAAG,SAAS;SACpB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;SACpE,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;SAAM,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1B,yEAAyE;IAC3E,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,IAAI,CAAC;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,YAAY,CAAC,KAAiB,EAAE,MAAc;IACrD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,MAAM;QACnB,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;YAAE,MAAM;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,qCAAqC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACxG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,2CAA2C,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QAChH,MAAM,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtD,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,SAAS,MAAM,CAAC,KAAK,GAAG,CAAC,2BAA2B,CAAC,CAAC;QACrF,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,gBAAgB,GAAG,EAAE,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAEjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBACnC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC/C,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,gDAAgD,GAAG,EAAE,CAAC,CAAC;QACpG,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,aAAa,CAAC,KAAiB,EAAE,MAAc;IACtD,MAAM,KAAK,GAAc,EAAE,CAAC;IAC5B,SAAS,CAAC;QACR,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM;YAAE,MAAM;QACnB,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;YAAE,MAAM;QAClC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,qCAAqC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACxG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,MAAM;QACpC,IAAI,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,+BAA+B,CAAC,CAAC;QACtG,MAAM,IAAI,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5D,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;QAEjB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,IAAI,MAAM,EAAE,CAAC;gBACnC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;YAC7C,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,CAAC;YAC9B,MAAM,SAAS,GAAa,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC;YACjE,OAAO,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;oBACvB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACrB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;oBACjB,SAAS;gBACX,CAAC;gBACD,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM;oBAAE,MAAM;gBACpC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACrB,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;YACnB,CAAC;YACD,MAAM,GAAG,GAAe,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC3E,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,QAAQ;gBAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,0CAA0C,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,kDAAkD,CAAC,CAAC;QACzE,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB,EAAE,MAAc;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;QAAE,OAAO,IAAI,CAAC;IACxC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM;QAAE,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,qCAAqC,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IACxG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrF,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC;AAMD,MAAM,UAAU,SAAS,CAAC,IAAa,EAAE,EAAE,KAAK,GAAG,MAAM,EAAE,GAAgB,EAAE;IAC3E,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,IAAI,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,OAAO,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QAAE,KAAK,IAAI,CAAC,CAAC;IACvE,IAAI,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,KAAK;QAAE,KAAK,IAAI,CAAC,CAAC;IAE1E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,IAAI,CAAC,GAAG,KAAK,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;YAC3C,IAAI,CAAC,GAAG,KAAK,oEAAoE,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC,GAAG,KAAK,yDAAyD,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnB,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1D,MAAM,KAAK,GAAe,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACpC,IAAI,QAAQ;QAAE,IAAI,CAAC,GAAG,KAAK,iCAAiC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAQD,MAAM,UAAU,wBAAwB,CAAC,IAAa,EAAE,EAAE,KAAK,GAAG,aAAa,EAAE,GAAgB,EAAE;IACjG,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,IAAI,CAAC,GAAG,KAAK,cAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,IAAI,CAAC,GAAG,KAAK,sBAAsB,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC;IAC1E,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,IAAI,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,GAAG,KAAK,mCAAmC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,cAAc,EAAE,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC,GAAG,KAAK,gCAAgC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/external.d.ts

@@ -0,0 +1,61 @@
+import type { ExternalInstallResult, LockGroup, PinnedSourceSkill, PreparedCheckout, SkillPartition, SkillRef } from "./types/index.js";
+declare const SECURITY_CANCELLATION = "Installation cancelled due to security concerns";
+export { SECURITY_CANCELLATION };
+export declare const KILL_GRACE_MS = 5000;
+export interface Scanner {
+    readonly name: string;
+    readonly version: string;
+    readonly registry: string;
+    readonly integrity: string;
+}
+export declare const SCANNER: Scanner;
+export declare function sanitizedEnv(base?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/** The subset of a fetch Response the integrity check reads. */
+export interface RegistryResponse {
+    readonly ok: boolean;
+    readonly status: number;
+    json(): Promise<unknown>;
+}
+export type FetchLike = (url: string, init: {
+    readonly headers: Readonly<Record<string, string>>;
+    readonly signal: AbortSignal;
+}) => Promise<RegistryResponse>;
+export declare function verifyScannerIntegrity(fetchImpl?: FetchLike): Promise<void>;
+export declare function stripControlSequences(value: unknown): string;
+export declare function validateAgent(agent: string): string;
+export declare function validateInstaller(installer: string): string;
+export declare function isSecurityCancellation(output: unknown): boolean;
+export declare function installerExitCode(code: number | null | undefined, output: unknown): number;
+export declare function groupLock(lock: unknown): LockGroup[];
+export interface BuildCommandInput {
+    readonly installer: string;
+    readonly source: string;
+    readonly agent: string;
+    readonly skills: readonly string[];
+    readonly local?: boolean;
+}
+export declare function buildCommand({ installer, source, agent, skills, local }: BuildCommandInput): string[];
+export declare function verifySkillTree(directory: string, skill: PinnedSourceSkill, readTreeSha?: (directory: string, skillPath: string) => Promise<string>): Promise<void>;
+export declare function partitionExistingSkills<T extends SkillRef>(skills: readonly T[], skillsDir: string, exists?: (path: string) => boolean): SkillPartition<T>;
+export interface RunCommandOptions {
+    readonly cwd?: string;
+    readonly env?: NodeJS.ProcessEnv;
+}
+export declare function runCommand(argv: readonly string[], timeout?: number, options?: RunCommandOptions): Promise<number>;
+export interface InstallExternalOptions {
+    readonly lockPath: string;
+    readonly agent: string;
+    readonly installer?: string;
+    readonly log?: (message: string) => void;
+    readonly run?: (argv: readonly string[], timeout: number) => Promise<number>;
+    readonly prepareSource?: (group: LockGroup, options: {
+        readonly timeout: number;
+    }) => Promise<PreparedCheckout>;
+    readonly verifyTree?: (directory: string, skill: PinnedSourceSkill) => Promise<void>;
+    readonly verifyScanner?: () => Promise<void>;
+    readonly exists?: (path: string) => boolean;
+    readonly retries?: number;
+    readonly timeout?: number;
+}
+export declare function installExternal({ lockPath, agent, installer, log, run, prepareSource, verifyTree, verifyScanner, exists, retries, timeout, }: InstallExternalOptions): Promise<ExternalInstallResult>;
+//# sourceMappingURL=external.d.ts.map

package/dist/external.d.ts.map

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