skyl.dev 0.1.0

package/node_modules/@skyl/core/dist/lockfile.js

@@ -0,0 +1,47 @@
+import { createHash } from 'node:crypto';
+export const LOCKFILE_NAME = 'skyl.lock';
+export function hashContent(text) {
+    return `sha256:${createHash('sha256').update(text, 'utf8').digest('hex')}`;
+}
+export function emptyLockfile(target) {
+    return { lockfileVersion: 1, target, skills: {} };
+}
+export function parseLockfile(text) {
+    const data = JSON.parse(text);
+    if (data.lockfileVersion !== 1) {
+        throw new Error(`unsupported lockfile version ${String(data.lockfileVersion)}`);
+    }
+    return data;
+}
+/** Serialised with sorted keys so a reinstall produces no diff. */
+export function formatLockfile(lock) {
+    const skills = {};
+    for (const name of Object.keys(lock.skills).sort())
+        skills[name] = lock.skills[name];
+    const ordered = { lockfileVersion: lock.lockfileVersion, target: lock.target, ...(lock.source ? { source: lock.source } : {}), skills };
+    return `${JSON.stringify(ordered, null, 2)}\n`;
+}
+export function entryFor(skill, installed, reason) {
+    return { version: skill.version, hash: hashContent(installed), reason };
+}
+/**
+ * What happened to an installed skill.
+ *
+ * `local-edit` and `upstream-change` are told apart because the fix differs: one is the
+ * user's work to keep, the other is ours to offer. When both moved, neither can be
+ * applied blindly.
+ */
+export function drift(entry, onDisk, upstream) {
+    if (!entry || onDisk === undefined)
+        return 'missing';
+    const localChanged = hashContent(onDisk) !== entry.hash;
+    const upstreamChanged = upstream !== undefined && upstream.version !== entry.version;
+    if (localChanged && upstreamChanged)
+        return 'both';
+    if (localChanged)
+        return 'local-edit';
+    if (upstreamChanged)
+        return 'upstream-change';
+    return 'unchanged';
+}
+//# sourceMappingURL=lockfile.js.map

package/node_modules/@skyl/core/dist/lockfile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockfile.js","sourceRoot":"","sources":["../src/lockfile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAwBzC,MAAM,CAAC,MAAM,aAAa,GAAG,WAAW,CAAC;AAEzC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,OAAO,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;IAC1C,IAAI,IAAI,CAAC,eAAe,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,MAAM,MAAM,GAA8B,EAAE,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC;IACtF,MAAM,OAAO,GAAG,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;IACxI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,SAAiB,EAAE,MAA2B;IACnF,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;AAC1E,CAAC;AAID;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACnB,KAA4B,EAC5B,MAA0B,EAC1B,QAA2B;IAE3B,IAAI,CAAC,KAAK,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACrD,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC;IACxD,MAAM,eAAe,GAAG,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC;IACrF,IAAI,YAAY,IAAI,eAAe;QAAE,OAAO,MAAM,CAAC;IACnD,IAAI,YAAY;QAAE,OAAO,YAAY,CAAC;IACtC,IAAI,eAAe;QAAE,OAAO,iBAAiB,CAAC;IAC9C,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/node_modules/@skyl/core/dist/match.d.ts

@@ -0,0 +1,19 @@
+/**
+ * How a wanted value is compared against a signal, chosen by the shape of the detect key.
+ *
+ * Substring matching everywhere looked simpler and is wrong in both directions:
+ *
+ *   - `androidx.compose.ui:ui-test-junit4` contains `androidx.compose.ui:ui`, so a
+ *     project with only Compose test helpers would pull the whole Compose skill.
+ *   - a file pattern is a glob, and `app/src/main/Main.kt` does not contain the literal
+ *     text `**` + `/*.kt`, so file detection never fired at all.
+ */
+/**
+ * A detect key's matching strategy. Unknown keys fall back to exact comparison, which
+ * fails closed: a new key matches nothing until it is taught how, rather than matching
+ * everything by accident.
+ */
+export type Strategy = 'coordinate' | 'glob' | 'exact';
+export declare function strategyFor(key: string): Strategy;
+export declare function matches(key: string, wanted: string, signal: string): boolean;
+//# sourceMappingURL=match.d.ts.map

package/node_modules/@skyl/core/dist/match.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.d.ts","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmCH;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAEvD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAIjD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAS5E"}

package/node_modules/@skyl/core/dist/match.js

@@ -0,0 +1,72 @@
+/**
+ * How a wanted value is compared against a signal, chosen by the shape of the detect key.
+ *
+ * Substring matching everywhere looked simpler and is wrong in both directions:
+ *
+ *   - `androidx.compose.ui:ui-test-junit4` contains `androidx.compose.ui:ui`, so a
+ *     project with only Compose test helpers would pull the whole Compose skill.
+ *   - a file pattern is a glob, and `app/src/main/Main.kt` does not contain the literal
+ *     text `**` + `/*.kt`, so file detection never fired at all.
+ */
+/** `group:artifact:version` reduced to `group:artifact`, which is the identity. */
+function coordinate(value) {
+    const parts = value.split(':');
+    return parts.length >= 2 ? `${parts[0]}:${parts[1]}` : value;
+}
+function globToRegExp(glob) {
+    let out = '';
+    for (let i = 0; i < glob.length; i += 1) {
+        const c = glob[i];
+        if (c === '*') {
+            if (glob[i + 1] === '*') {
+                // `**/` spans directories, and also matches nothing so `**/*.kt` hits `a.kt`
+                if (glob[i + 2] === '/') {
+                    out += '(?:.*/)?';
+                    i += 2;
+                }
+                else {
+                    out += '.*';
+                    i += 1;
+                }
+            }
+            else {
+                out += '[^/]*';
+            }
+        }
+        else if (c === '?')
+            out += '[^/]';
+        else if ('.+^${}()|[]\\'.includes(c))
+            out += `\\${c}`;
+        else
+            out += c;
+    }
+    return new RegExp(`^${out}$`);
+}
+const globCache = new Map();
+function globMatch(pattern, path) {
+    let re = globCache.get(pattern);
+    if (!re) {
+        re = globToRegExp(pattern);
+        globCache.set(pattern, re);
+    }
+    const normalised = path.replace(/^\.\//, '').replace(/\\/g, '/');
+    return re.test(normalised) || re.test(`./${normalised}`.slice(2));
+}
+export function strategyFor(key) {
+    if (key.endsWith('dependency') || key.endsWith('dependencies'))
+        return 'coordinate';
+    if (key === 'file' || key.endsWith('_file') || key.endsWith('path'))
+        return 'glob';
+    return 'exact';
+}
+export function matches(key, wanted, signal) {
+    switch (strategyFor(key)) {
+        case 'coordinate':
+            return coordinate(signal) === coordinate(wanted);
+        case 'glob':
+            return globMatch(wanted, signal);
+        case 'exact':
+            return signal === wanted || signal.includes(wanted);
+    }
+}
+//# sourceMappingURL=match.js.map

package/node_modules/@skyl/core/dist/match.js.map

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

package/node_modules/@skyl/core/dist/names.d.ts

@@ -0,0 +1,11 @@
+import type { SkillMeta } from './types.ts';
+/**
+ * Accept `android/kotlin` and bare `kotlin`, because typing the family once is the
+ * natural way to ask: `skyl add android/core kotlin compose`.
+ *
+ * A bare name resolves against the families already named in the same request, then
+ * against the whole index. Ambiguity is an error rather than a guess: silently picking
+ * one of two families would install the wrong thing and look like it worked.
+ */
+export declare function normalise(skills: readonly SkillMeta[], requested: readonly string[]): string[];
+//# sourceMappingURL=names.d.ts.map

package/node_modules/@skyl/core/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAuB9F"}

package/node_modules/@skyl/core/dist/names.js

@@ -0,0 +1,31 @@
+import { ResolutionError } from "./errors.js";
+/**
+ * Accept `android/kotlin` and bare `kotlin`, because typing the family once is the
+ * natural way to ask: `skyl add android/core kotlin compose`.
+ *
+ * A bare name resolves against the families already named in the same request, then
+ * against the whole index. Ambiguity is an error rather than a guess: silently picking
+ * one of two families would install the wrong thing and look like it worked.
+ */
+export function normalise(skills, requested) {
+    const known = new Set(skills.map((s) => s.name));
+    const families = new Set(requested.filter((r) => r.includes('/')).map((r) => r.split('/')[0]));
+    return requested.map((raw) => {
+        const name = raw.trim();
+        if (name.includes('/')) {
+            if (!known.has(name))
+                throw new ResolutionError(`unknown skill \`${name}\``);
+            return name;
+        }
+        const inNamedFamily = skills.filter((s) => families.has(s.family) && s.skill === name);
+        if (inNamedFamily.length === 1)
+            return inNamedFamily[0].name;
+        const anywhere = skills.filter((s) => s.skill === name);
+        if (anywhere.length === 1)
+            return anywhere[0].name;
+        if (anywhere.length === 0)
+            throw new ResolutionError(`unknown skill \`${name}\``);
+        throw new ResolutionError(`\`${name}\` is ambiguous`, `it exists in ${anywhere.map((s) => s.family).join(', ')}. Name the family.`);
+    });
+}
+//# sourceMappingURL=names.js.map

package/node_modules/@skyl/core/dist/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,MAA4B,EAAE,SAA4B;IAClF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC;IAEhG,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC3B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACvF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,aAAa,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;QAE9D,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;QACpD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,eAAe,CAAC,mBAAmB,IAAI,IAAI,CAAC,CAAC;QAElF,MAAM,IAAI,eAAe,CACvB,KAAK,IAAI,iBAAiB,EAC1B,gBAAgB,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAC7E,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@skyl/core/dist/parse.d.ts

@@ -0,0 +1,22 @@
+import { type Rule, type Skill } from './types.ts';
+/**
+ * The frontmatter shapes this format uses: scalars, inline arrays, and one level of
+ * nested map-of-arrays for `detect`. Parsed here rather than with a YAML library so
+ * `@skyl/core` stays dependency-free, and because accepting only these shapes means a
+ * malformed skill fails loudly instead of parsing into something surprising.
+ */
+type Scalar = string;
+type FrontmatterValue = Scalar | string[] | Record<string, string[]>;
+export declare function parseFrontmatter(text: string): Record<string, FrontmatterValue>;
+/** Everything after the frontmatter. */
+export declare function body(text: string): string;
+/**
+ * Split a markdown body into its `##` sections, keyed by heading text.
+ * Content before the first heading is dropped: the format puts nothing there.
+ */
+export declare function sections(markdown: string): Map<string, string>;
+export declare function rules(markdown: string): Rule[];
+/** Parse one SKILL.md into the shape everything else in this package consumes. */
+export declare function parseSkill(text: string): Skill;
+export {};
+//# sourceMappingURL=parse.d.ts.map

package/node_modules/@skyl/core/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtF;;;;;GAKG;AACH,KAAK,MAAM,GAAG,MAAM,CAAC;AACrB,KAAK,gBAAgB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAkBrE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAiD/E;AAED,wCAAwC;AACxC,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGzC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9D;AAID,wBAAgB,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,CAM9C;AAiBD,kFAAkF;AAClF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CA6D9C"}

package/node_modules/@skyl/core/dist/parse.js

@@ -0,0 +1,163 @@
+import { SkillFormatError } from "./errors.js";
+import { AXES } from "./types.js";
+const FRONTMATTER = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function stripQuotes(v) {
+    const t = v.trim();
+    if (t.length >= 2 && ((t.startsWith('"') && t.endsWith('"')) || (t.startsWith("'") && t.endsWith("'")))) {
+        return t.slice(1, -1);
+    }
+    return t;
+}
+function inlineList(v) {
+    const inner = v.trim().slice(1, -1).trim();
+    if (inner === '')
+        return [];
+    return inner.split(',').map(stripQuotes).filter((s) => s !== '');
+}
+export function parseFrontmatter(text) {
+    const m = FRONTMATTER.exec(text);
+    if (!m)
+        throw new SkillFormatError('no frontmatter', 'a skill starts with a --- delimited block');
+    const out = {};
+    const lines = m[1].split('\n');
+    let currentKey = null;
+    let currentSub = null;
+    for (const raw of lines) {
+        if (raw.trim() === '' || raw.trimStart().startsWith('#'))
+            continue;
+        const top = /^([A-Za-z_][\w-]*):\s*(.*)$/.exec(raw);
+        if (top && !/^\s/.test(raw)) {
+            const [, key, rest] = top;
+            currentKey = key;
+            currentSub = null;
+            const value = rest.trim();
+            if (value === '')
+                out[key] = {};
+            else if (value.startsWith('['))
+                out[key] = inlineList(value);
+            else
+                out[key] = stripQuotes(value);
+            continue;
+        }
+        const nested = /^\s+([A-Za-z_][\w-]*):\s*(.*)$/.exec(raw);
+        if (nested && currentKey) {
+            const [, sub, rest] = nested;
+            const bucket = (out[currentKey] ??= {});
+            if (typeof bucket !== 'object' || Array.isArray(bucket)) {
+                throw new SkillFormatError(`\`${currentKey}\` has both a value and nested keys`);
+            }
+            const value = rest.trim();
+            bucket[sub] = value.startsWith('[') ? inlineList(value) : value === '' ? [] : [stripQuotes(value)];
+            currentSub = sub;
+            continue;
+        }
+        const item = /^\s*-\s+(.*)$/.exec(raw);
+        if (item && currentKey) {
+            const value = stripQuotes(item[1]);
+            const bucket = out[currentKey];
+            if (Array.isArray(bucket))
+                bucket.push(value);
+            else if (currentSub && bucket && typeof bucket === 'object') {
+                (bucket[currentSub] ??= []).push(value);
+            }
+            else
+                out[currentKey] = [value];
+            continue;
+        }
+    }
+    return out;
+}
+/** Everything after the frontmatter. */
+export function body(text) {
+    const m = FRONTMATTER.exec(text);
+    return m ? text.slice(m[0].length) : text;
+}
+/**
+ * Split a markdown body into its `##` sections, keyed by heading text.
+ * Content before the first heading is dropped: the format puts nothing there.
+ */
+export function sections(markdown) {
+    const out = new Map();
+    const parts = markdown.split(/^## (.+)$/m);
+    for (let i = 1; i < parts.length; i += 2) {
+        out.set(parts[i].trim(), (parts[i + 1] ?? '').trim());
+    }
+    return out;
+}
+const RULE = /^- \*\*([A-Z0-9]+-\d+)\*\*\s+`(must|should)`/gm;
+export function rules(markdown) {
+    const out = [];
+    for (const m of markdown.matchAll(RULE)) {
+        out.push({ id: m[1], priority: m[2] });
+    }
+    return out;
+}
+function requireString(fm, key) {
+    const v = fm[key];
+    if (typeof v !== 'string' || v === '') {
+        throw new SkillFormatError(`frontmatter is missing \`${key}\``);
+    }
+    return v;
+}
+function list(fm, key) {
+    const v = fm[key];
+    if (v === undefined)
+        return [];
+    if (Array.isArray(v))
+        return v;
+    throw new SkillFormatError(`\`${key}\` must be a list`);
+}
+/** Parse one SKILL.md into the shape everything else in this package consumes. */
+export function parseSkill(text) {
+    const fm = parseFrontmatter(text);
+    const md = body(text);
+    const name = requireString(fm, 'name');
+    const slash = name.indexOf('/');
+    if (slash <= 0 || slash === name.length - 1) {
+        throw new SkillFormatError(`name \`${name}\` is not \`family/skill\``);
+    }
+    const axis = requireString(fm, 'axis');
+    if (!AXES.includes(axis)) {
+        throw new SkillFormatError(`axis \`${axis}\` is not one of ${AXES.join(', ')}`);
+    }
+    const version = requireString(fm, 'version');
+    if (!/^\d+\.\d+\.\d+$/.test(version)) {
+        throw new SkillFormatError(`version \`${version}\` is not semver`);
+    }
+    const agentSections = list(fm, 'agent_sections');
+    if (agentSections.length === 0) {
+        throw new SkillFormatError('frontmatter is missing `agent_sections`', 'nothing would be installed');
+    }
+    const detectRaw = fm['detect'];
+    const detect = detectRaw && typeof detectRaw === 'object' && !Array.isArray(detectRaw)
+        ? detectRaw
+        : {};
+    const all = sections(md);
+    const installable = agentSections
+        .map((s) => {
+        const heading = s.charAt(0).toUpperCase() + s.slice(1);
+        const found = all.get(heading) ?? all.get(s);
+        if (found === undefined) {
+            throw new SkillFormatError(`\`agent_sections\` names \`${s}\` but the file has no \`## ${heading}\``);
+        }
+        return `## ${heading}\n\n${found}`;
+    })
+        .join('\n\n');
+    return {
+        name,
+        family: name.slice(0, slash),
+        skill: name.slice(slash + 1),
+        axis: axis,
+        version,
+        requires: list(fm, 'requires'),
+        agentSections,
+        retired: list(fm, 'retired'),
+        detect,
+        authors: list(fm, 'authors'),
+        rules: rules(md),
+        installable,
+        installableWords: installable.split(/\s+/).filter(Boolean).length,
+        raw: text,
+    };
+}
+//# sourceMappingURL=parse.js.map

package/node_modules/@skyl/core/dist/parse.js.map

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

package/node_modules/@skyl/core/dist/resolve.d.ts

@@ -0,0 +1,12 @@
+import type { SkillMeta } from './types.ts';
+/**
+ * Expand a requested set to include everything it requires, and order it so a skill
+ * always appears after what it depends on.
+ *
+ * Install order matters: `agent_sections` are concatenated in the order written, and a
+ * layer that refers to its core reads wrong if it lands first.
+ */
+export declare function resolve<T extends SkillMeta>(skills: readonly T[], requested: readonly string[]): T[];
+/** What `resolve` added that the caller did not ask for, so a prompt can say so. */
+export declare function implied<T extends SkillMeta>(resolved: readonly T[], requested: readonly string[]): T[];
+//# sourceMappingURL=resolve.d.ts.map

package/node_modules/@skyl/core/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,EAAE,CAkCpG;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,CAAC,SAAS,SAAS,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,EAAE,CAGtG"}

package/node_modules/@skyl/core/dist/resolve.js

@@ -0,0 +1,40 @@
+import { ResolutionError } from "./errors.js";
+/**
+ * Expand a requested set to include everything it requires, and order it so a skill
+ * always appears after what it depends on.
+ *
+ * Install order matters: `agent_sections` are concatenated in the order written, and a
+ * layer that refers to its core reads wrong if it lands first.
+ */
+export function resolve(skills, requested) {
+    const byName = new Map(skills.map((s) => [s.name, s]));
+    const ordered = [];
+    const done = new Set();
+    const path = [];
+    const visit = (name, from) => {
+        if (done.has(name))
+            return;
+        if (path.includes(name)) {
+            throw new ResolutionError('skills require each other in a cycle', [...path.slice(path.indexOf(name)), name].join(' -> '));
+        }
+        const skill = byName.get(name);
+        if (!skill) {
+            throw new ResolutionError(`unknown skill \`${name}\``, from ? `required by \`${from}\`` : 'not in the index');
+        }
+        path.push(name);
+        for (const dep of skill.requires)
+            visit(dep, name);
+        path.pop();
+        done.add(name);
+        ordered.push(skill);
+    };
+    for (const name of requested)
+        visit(name);
+    return ordered;
+}
+/** What `resolve` added that the caller did not ask for, so a prompt can say so. */
+export function implied(resolved, requested) {
+    const asked = new Set(requested);
+    return resolved.filter((s) => !asked.has(s.name));
+}
+//# sourceMappingURL=resolve.js.map

package/node_modules/@skyl/core/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9C;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAsB,MAAoB,EAAE,SAA4B;IAC7F,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,OAAO,GAAQ,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;IAE1B,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,IAAa,EAAQ,EAAE;QAClD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO;QAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CACvB,sCAAsC,EACtC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CACvD,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,eAAe,CACvB,mBAAmB,IAAI,IAAI,EAC3B,IAAI,CAAC,CAAC,CAAC,iBAAiB,IAAI,IAAI,CAAC,CAAC,CAAC,kBAAkB,CACtD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChB,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ;YAAE,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,EAAE,CAAC;QAEX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CAAsB,QAAsB,EAAE,SAA4B;IAC/F,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACpD,CAAC"}

package/node_modules/@skyl/core/dist/source.d.ts

@@ -0,0 +1,35 @@
+import type { Skill } from './types.ts';
+/**
+ * Where skill content comes from.
+ *
+ * Three routes, tried in order, because each fails in a different way: a bundle shipped
+ * inside the package always works and goes stale, a fetched artifact is current and needs
+ * a network, and a local directory is what a contributor is editing. Resolution order is
+ * configuration rather than something baked into the CLI.
+ */
+export interface Source {
+    readonly name: string;
+    /** Every skill this source can supply. */
+    load(): Promise<Skill[]>;
+}
+/** A directory laid out as `<root>/<family>/<skill>/SKILL.md`. */
+export declare function directorySource(root: string, label?: string): Source;
+/** A JSON bundle: `{ "skills": { "android/core": "<raw SKILL.md>" } }`. */
+export interface Bundle {
+    readonly version?: string;
+    readonly skills: Record<string, string>;
+}
+export declare function bundleSource(load: () => Promise<Bundle>, label: string): Source;
+export declare function httpBundleSource(url: string, label?: string): Source;
+/**
+ * Try sources in order and take the first that yields anything.
+ *
+ * Failures are collected rather than thrown as they happen: falling back from a network
+ * source to a bundled one is the normal path, not an error, and a caller only needs to
+ * hear about it when every route failed.
+ */
+export declare function firstAvailable(sources: readonly Source[]): Promise<{
+    skills: Skill[];
+    from: Source;
+}>;
+//# sourceMappingURL=source.d.ts.map

package/node_modules/@skyl/core/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;CAC1B;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,SAAc,GAAG,MAAM,CAiCzE;AAED,2EAA2E;AAC3E,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc/E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAW,GAAG,MAAM,CAMtE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAY3G"}

package/node_modules/@skyl/core/dist/source.js

@@ -0,0 +1,85 @@
+import { SourceError } from "./errors.js";
+import { parseSkill } from "./parse.js";
+/** A directory laid out as `<root>/<family>/<skill>/SKILL.md`. */
+export function directorySource(root, label = 'directory') {
+    return {
+        name: `${label} (${root})`,
+        async load() {
+            const { readdir, readFile } = await import('node:fs/promises');
+            const { join } = await import('node:path');
+            const out = [];
+            let families;
+            try {
+                families = (await readdir(root, { withFileTypes: true }))
+                    .filter((e) => e.isDirectory())
+                    .map((e) => e.name);
+            }
+            catch (cause) {
+                throw new SourceError(`cannot read ${root}`, String(cause));
+            }
+            for (const family of families) {
+                const dir = join(root, family);
+                const entries = (await readdir(dir, { withFileTypes: true })).filter((e) => e.isDirectory());
+                for (const entry of entries) {
+                    const file = join(dir, entry.name, 'SKILL.md');
+                    try {
+                        out.push(parseSkill(await readFile(file, 'utf8')));
+                    }
+                    catch (cause) {
+                        if (cause.code === 'ENOENT')
+                            continue;
+                        throw new SourceError(`cannot parse ${file}`, cause.message);
+                    }
+                }
+            }
+            return out;
+        },
+    };
+}
+export function bundleSource(load, label) {
+    return {
+        name: label,
+        async load() {
+            const bundle = await load();
+            return Object.entries(bundle.skills).map(([name, raw]) => {
+                try {
+                    return parseSkill(raw);
+                }
+                catch (cause) {
+                    throw new SourceError(`cannot parse \`${name}\` from ${label}`, cause.message);
+                }
+            });
+        },
+    };
+}
+export function httpBundleSource(url, label = 'remote') {
+    return bundleSource(async () => {
+        const res = await fetch(url, { headers: { accept: 'application/json' } });
+        if (!res.ok)
+            throw new SourceError(`${label} returned ${res.status}`, url);
+        return (await res.json());
+    }, `${label} (${url})`);
+}
+/**
+ * Try sources in order and take the first that yields anything.
+ *
+ * Failures are collected rather than thrown as they happen: falling back from a network
+ * source to a bundled one is the normal path, not an error, and a caller only needs to
+ * hear about it when every route failed.
+ */
+export async function firstAvailable(sources) {
+    const failures = [];
+    for (const source of sources) {
+        try {
+            const skills = await source.load();
+            if (skills.length > 0)
+                return { skills, from: source };
+            failures.push(`${source.name}: empty`);
+        }
+        catch (cause) {
+            failures.push(`${source.name}: ${cause.message}`);
+        }
+    }
+    throw new SourceError('no source could supply the registry', failures.join('\n  '));
+}
+//# sourceMappingURL=source.js.map

package/node_modules/@skyl/core/dist/source.js.map

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

package/node_modules/@skyl/core/dist/targets.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Where an installer writes, per agent tool.
+ *
+ * Vendor neutrality is cheap here and expensive to retrofit: the same resolved skill is
+ * written to a different directory with a different extension, and nothing above this
+ * layer needs to know which tool is in use.
+ */
+export interface Target {
+    readonly id: string;
+    /** Directory, relative to the project root. */
+    readonly dir: string;
+    /** File name for a skill, given its `family/skill` name. */
+    fileFor(name: string): string;
+    /** Some tools want their own frontmatter on each file. */
+    header?(name: string, version: string): string;
+}
+export declare const TARGETS: readonly Target[];
+export declare const DEFAULT_TARGET = "claude";
+export declare function targetById(id: string): Target | undefined;
+//# sourceMappingURL=targets.d.ts.map

package/node_modules/@skyl/core/dist/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../src/targets.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CAChD;AAID,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAiBpC,CAAC;AAEF,eAAO,MAAM,cAAc,WAAW,CAAC;AAEvC,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzD"}