kennel 0.2.23 → 0.2.25

package/dist/plugins/external.d.ts

@@ -1,3 +1,4 @@
+import { type SkillState } from "./skills.js";
 export type ExternalPluginEntry = {
     url: string;
     requestedRef?: string;
@@ -15,6 +16,15 @@ export type ExternalPluginEntry = {
         api?: string;
         css?: string;
     };
+    skill?: {
+        entry: string;
+        name: string;
+        installed?: {
+            path: string;
+            commit: string;
+            digest: string;
+        };
+    };
 };
 export declare function kennelConfigPath(): string;
 export declare const PLUGIN_SOURCE_IGNORED: Set<string>;
@@ -25,6 +35,28 @@ export declare function readExternalPlugins(): ExternalPluginEntry[];
 export declare function installExternalPlugin(url: string, options?: {
     directory?: string;
 }): Promise<ExternalPluginEntry>;
+/** Installs a declared skill from local source or the pinned cached checkout. */
+export declare function installPluginSkill(id: string, options?: {
+    force?: boolean;
+}): {
+    duplicates: string[];
+    path: string;
+    commit: string;
+    digest: string;
+    name: string;
+};
+export type PluginStatus = {
+    id: string;
+    packageName: string;
+    commit: string;
+    skill: {
+        name?: string;
+        state: SkillState;
+        path?: string;
+    };
+};
+/** Reports installed plugins and the real state of each declared skill. */
+export declare function listPluginStatus(): PluginStatus[];
 /** The compiled host web app this CLI serves. */
 export declare function webRoot(): string;
 /**

package/dist/plugins/external.js

@@ -14,6 +14,7 @@ import { basename, dirname, isAbsolute, join, relative, resolve, } from "node:pa
 import { pathToFileURL, fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
 import { z } from "zod";
+import { duplicateSkills, readPluginSkill, skillDestination, skillState, writeSkill } from "./skills.js";
 const CONFIG_FILE = join("kennel", "config.json");
 const VALID_ID = /^[a-z][a-z0-9-]*$/u;
 const CORE_IDS = new Set(["agents", "notes"]);
@@ -142,9 +143,13 @@ function resolveCommit(url, requestedRef) {
         throw new Error(`Could not resolve ref ${requestedRef} for ${url}`);
     return commit;
 }
-function sourceCheckout(url, commit) {
+function sourceDir(url) {
     const dir = join(cacheRoot(), "plugins", "sources", hash(url), "repo");
     assertUnderCache(dir);
+    return dir;
+}
+function sourceCheckout(url, commit) {
+    const dir = sourceDir(url);
     mkdirSync(dirname(dir), { recursive: true });
     if (!existsSync(join(dir, ".git")))
         run("git", ["clone", "--no-checkout", url, dir]);
@@ -400,6 +405,7 @@ export async function validateExternalPlugin(inputUrl, options = {}) {
     const api = entryByConvention(root, "api.ts", false);
     const cssValue = metadata?.exports?.css;
     const css = cssValue === undefined ? undefined : safeRelativeFile(root, cssValue, "css export path");
+    const skill = metadata?.skill === undefined ? undefined : readPluginSkill(root, metadata.skill);
     const entry = {
         url: source.url,
         ...(source.requestedRef ? { requestedRef: source.requestedRef } : {}),
@@ -417,6 +423,7 @@ export async function validateExternalPlugin(inputUrl, options = {}) {
             ...(api ? { api } : {}),
             ...(css ? { css } : {}),
         },
+        ...(skill ? { skill: { entry: skill.entry, name: skill.name } } : {}),
     };
     installPluginDependencies(root, pkg.dependencies);
     await validateImports(entry);
@@ -449,6 +456,58 @@ export async function installExternalPlugin(url, options = {}) {
     }
     return entry;
 }
+/** Uses local source or checks out the pinned cached commit without fetching. */
+function pinnedPackageRoot(plugin) {
+    if (plugin.path)
+        return pluginRoot(realpathSync(plugin.path), plugin.directory);
+    const dir = sourceDir(plugin.url);
+    if (!existsSync(join(dir, ".git")))
+        throw new Error(`Cached source for ${plugin.id} is missing; run \`kennel plugin add\` again`);
+    run("git", ["checkout", "--force", "--quiet", plugin.commit], { cwd: dir });
+    if (run("git", ["rev-parse", "HEAD"], { cwd: dir }) !== plugin.commit)
+        throw new Error(`Cached source for ${plugin.id} is not at ${plugin.commit}`);
+    return pluginRoot(realpathSync(dir), plugin.directory);
+}
+/** Installs a declared skill from local source or the pinned cached checkout. */
+export function installPluginSkill(id, options = {}) {
+    const path = kennelConfigPath();
+    const config = readJson(path);
+    const plugins = config.externalPlugins ?? [];
+    const plugin = plugins.find((item) => item.id === id);
+    if (!plugin)
+        throw new Error(`No installed plugin with id ${id}`);
+    if (!plugin.skill)
+        throw new Error(`Plugin ${id} declares no skill (kennel.plugin.skill or kennel.plugin.json > skill)`);
+    const skill = readPluginSkill(pinnedPackageRoot(plugin), plugin.skill.entry);
+    if (skill.name !== plugin.skill.name)
+        throw new Error(`Pinned skill name ${skill.name} does not match recorded name ${plugin.skill.name}`);
+    const duplicates = duplicateSkills(skill.name);
+    const commit = plugin.path ? contentHash(pluginRoot(plugin.path, plugin.directory)) : plugin.commit;
+    const written = writeSkill(skill, options);
+    const installed = { path: written.path, commit, digest: written.digest };
+    const nextConfig = {
+        ...config,
+        externalPlugins: plugins.map((item) => item.id === id ? { ...item, skill: { entry: skill.entry, name: skill.name, installed } } : item),
+    };
+    assertUserConfig(nextConfig, path);
+    writeJsonAtomic(path, nextConfig);
+    return { name: skill.name, ...installed, duplicates };
+}
+/** Reports installed plugins and the real state of each declared skill. */
+export function listPluginStatus() {
+    return readExternalPlugins().map((plugin) => ({
+        id: plugin.id,
+        packageName: plugin.packageName,
+        commit: plugin.commit,
+        skill: plugin.skill
+            ? {
+                name: plugin.skill.name,
+                state: skillState(plugin.skill.name, plugin.skill.installed?.digest),
+                path: skillDestination(plugin.skill.name),
+            }
+            : { state: "missing" },
+    }));
+}
 function cliRoot() {
     return resolve(dirname(fileURLToPath(import.meta.url)), "../..");
 }

package/dist/plugins/skills.d.ts

@@ -0,0 +1,30 @@
+export type PluginSkill = {
+    entry: string;
+    name: string;
+    directory: string;
+};
+export type SkillState = "missing" | "installed" | "conflict";
+/** Canonical global agent store: `${AGENTS_HOME:-$HOME/.agents}/skills`. */
+export declare function agentSkillsRoot(): string;
+export declare function skillDestination(name: string): string;
+/**
+ * Resolves `package.json > kennel.plugin.skill` inside a plugin package root.
+ * The entry must be a contained, non-symlinked `SKILL.md` with a valid name and description.
+ */
+export declare function readPluginSkill(packageRoot: string, entry: unknown): PluginSkill;
+/** Content digest of a skill directory: relative paths plus file bytes. */
+export declare function skillDigest(directory: string): string;
+/** Reports the installed skill state at the canonical destination. */
+export declare function skillState(name: string, digest?: string): SkillState;
+/** Same-name skills in known agent stores other than the canonical one. Read only. */
+export declare function duplicateSkills(name: string): string[];
+/**
+ * Copies a resolved skill directory into the canonical agent store.
+ * An existing destination is a conflict unless `force` is set.
+ */
+export declare function writeSkill(skill: PluginSkill, options?: {
+    force?: boolean;
+}): {
+    path: string;
+    digest: string;
+};

package/dist/plugins/skills.js

@@ -0,0 +1,175 @@
+import { createHash } from "node:crypto";
+import { cpSync, existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, realpathSync, renameSync, rmSync, } from "node:fs";
+import { homedir } from "node:os";
+import { basename, dirname, isAbsolute, join, relative, resolve, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+/** Agent skill folder names follow the Agent Skills naming rule. */
+const VALID_SKILL_NAME = /^[a-z0-9][a-z0-9-]{0,63}$/u;
+/** Never copy repository metadata when a skill lives at a repository root. */
+const SKIPPED_ENTRIES = new Set([".git"]);
+function isInside(root, target) {
+    const rel = relative(root, target);
+    return rel === "" || (!rel.startsWith("..") && !isAbsolute(rel));
+}
+/** Canonical global agent store: `${AGENTS_HOME:-$HOME/.agents}/skills`. */
+export function agentSkillsRoot() {
+    const home = process.env.AGENTS_HOME?.trim() || join(homedir(), ".agents");
+    if (!isAbsolute(home))
+        throw new Error(`AGENTS_HOME must be an absolute path: ${home}`);
+    return resolve(home, "skills");
+}
+export function skillDestination(name) {
+    if (!VALID_SKILL_NAME.test(name))
+        throw new Error(`Invalid skill name: ${name}`);
+    const root = agentSkillsRoot();
+    const target = resolve(root, name);
+    if (dirname(target) !== root)
+        throw new Error(`Refusing skill path outside ${root}: ${name}`);
+    return target;
+}
+function frontmatter(path) {
+    const text = readFileSync(path, "utf8");
+    const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(text);
+    if (!match)
+        throw new Error(`Skill ${path} has no YAML frontmatter`);
+    const data = parseYaml(match[1] ?? "");
+    if (!data || typeof data !== "object" || Array.isArray(data))
+        throw new Error(`Skill ${path} frontmatter is not a mapping`);
+    return data;
+}
+/**
+ * Resolves `package.json > kennel.plugin.skill` inside a plugin package root.
+ * The entry must be a contained, non-symlinked `SKILL.md` with a valid name and description.
+ */
+export function readPluginSkill(packageRoot, entry) {
+    if (typeof entry !== "string" || !entry.trim())
+        throw new Error("kennel.plugin.skill must be a relative path to SKILL.md");
+    if (isAbsolute(entry) || entry.includes("\0") || entry.includes("\\"))
+        throw new Error(`Unsafe skill path: ${entry}`);
+    if (basename(entry) !== "SKILL.md")
+        throw new Error(`Skill path must name a SKILL.md file: ${entry}`);
+    const root = realpathSync(packageRoot);
+    const file = resolve(root, entry);
+    if (!isInside(root, file) || file === root)
+        throw new Error(`Unsafe skill path: ${entry}`);
+    if (!existsSync(file))
+        throw new Error(`Missing skill file: ${entry}`);
+    const directory = realpathSync(dirname(file));
+    if (!isInside(root, directory))
+        throw new Error(`Skill directory escapes the plugin package: ${entry}`);
+    const stat = lstatSync(join(directory, "SKILL.md"));
+    if (!stat.isFile())
+        throw new Error(`Skill path is not a regular file: ${entry}`);
+    const data = frontmatter(join(directory, "SKILL.md"));
+    const name = typeof data.name === "string" ? data.name.trim() : "";
+    const description = typeof data.description === "string" ? data.description.trim() : "";
+    if (!name)
+        throw new Error(`Skill ${entry} frontmatter needs a nonempty name`);
+    if (!description)
+        throw new Error(`Skill ${entry} frontmatter needs a nonempty description`);
+    if (!VALID_SKILL_NAME.test(name))
+        throw new Error(`Skill ${entry} frontmatter name must match ${VALID_SKILL_NAME}: ${name}`);
+    return { entry: relative(root, join(directory, "SKILL.md")).split(sep).join("/"), name, directory };
+}
+/** Lists regular files under a skill directory. Symlinks and special files are refused. */
+function skillFiles(directory, prefix = "") {
+    return readdirSync(join(directory, prefix), { withFileTypes: true })
+        .filter((item) => !SKIPPED_ENTRIES.has(item.name))
+        .sort((a, b) => a.name.localeCompare(b.name))
+        .flatMap((item) => {
+        const rel = prefix ? join(prefix, item.name) : item.name;
+        if (item.isDirectory())
+            return skillFiles(directory, rel);
+        if (item.isFile())
+            return [rel];
+        throw new Error(`Skill contains an unsupported entry (symlink or special file): ${join(directory, rel)}`);
+    });
+}
+/** Content digest of a skill directory: relative paths plus file bytes. */
+export function skillDigest(directory) {
+    const hash = createHash("sha256");
+    for (const file of skillFiles(directory)) {
+        hash.update(file.split(sep).join("/")).update("\0").update(readFileSync(join(directory, file))).update("\0");
+    }
+    return hash.digest("hex");
+}
+/** Reports the installed skill state at the canonical destination. */
+export function skillState(name, digest) {
+    const target = skillDestination(name);
+    if (!existsSync(target) && !isSymlink(target))
+        return "missing";
+    try {
+        if (!lstatSync(target).isDirectory())
+            return "conflict";
+        return digest && skillDigest(target) === digest ? "installed" : "conflict";
+    }
+    catch {
+        return "conflict";
+    }
+}
+function isSymlink(path) {
+    try {
+        return lstatSync(path).isSymbolicLink();
+    }
+    catch {
+        return false;
+    }
+}
+/** Same-name skills in known agent stores other than the canonical one. Read only. */
+export function duplicateSkills(name) {
+    const canonical = agentSkillsRoot();
+    const roots = [
+        process.env.CODEX_HOME?.trim() ? join(process.env.CODEX_HOME.trim(), "skills") : undefined,
+        join(homedir(), ".codex", "skills"),
+        join(homedir(), ".claude", "skills"),
+    ].filter((root) => Boolean(root));
+    const canonicalReal = existsSync(canonical) ? realpathSync(canonical) : canonical;
+    const seen = new Set();
+    return roots.flatMap((root) => {
+        const real = existsSync(root) ? realpathSync(root) : resolve(root);
+        if (real === canonicalReal || seen.has(real))
+            return [];
+        seen.add(real);
+        const path = join(root, name);
+        return existsSync(path) || isSymlink(path) ? [path] : [];
+    });
+}
+/**
+ * Copies a resolved skill directory into the canonical agent store.
+ * An existing destination is a conflict unless `force` is set.
+ */
+export function writeSkill(skill, options = {}) {
+    const root = agentSkillsRoot();
+    const target = skillDestination(skill.name);
+    const exists = existsSync(target) || isSymlink(target);
+    if (exists && !options.force) {
+        throw new Error(`Skill conflict: ${target} already exists. Re-run with --force to replace it.`);
+    }
+    const files = skillFiles(skill.directory);
+    mkdirSync(root, { recursive: true });
+    const temp = join(root, `.${skill.name}.kennel-${process.pid}-${Date.now()}`);
+    try {
+        for (const file of files) {
+            const from = join(skill.directory, file);
+            const to = join(temp, file);
+            if (!isInside(skill.directory, from) || !isInside(temp, to))
+                throw new Error(`Unsafe skill file: ${file}`);
+            mkdirSync(dirname(to), { recursive: true });
+            cpSync(from, to, { errorOnExist: true, force: false, preserveTimestamps: true });
+        }
+        const digest = skillDigest(temp);
+        if (exists) {
+            const previous = `${temp}.previous`;
+            renameSync(target, previous);
+            renameSync(temp, target);
+            rmSync(previous, { force: true, recursive: true });
+        }
+        else {
+            renameSync(temp, target);
+        }
+        return { path: target, digest };
+    }
+    finally {
+        rmSync(temp, { force: true, recursive: true });
+    }
+}

package/dist/site/folder-icons.d.ts

@@ -20,13 +20,6 @@ export declare function assetKey(value: Buffer): string;
 export declare function encodeBase64Url(value: string): string;
 export declare function decodeBase64Url(value: string): string;
 export declare function iconUrl(folder: string, hash: string, mediaType: IconMediaType): string;
-/**
- * Nearest ancestor icon for a folder, walking up parent directories so
- * nested folders inherit the closest icon above them. The bundled
- * `@raggle-ai/local` does not export the ancestor-aware discovery helper
- * yet, so the walk is implemented here over `discoverProjectIcon`.
- */
-export declare function discoverAncestorIcon(folder: string): string | undefined;
 export declare function folderIcon(folder: string, assets: Record<string, IconAsset>, assetFiles: Map<string, {
     mediaType: IconMediaType;
     path: string;

package/dist/site/folder-icons.js

@@ -1,7 +1,7 @@
 import { createHash } from 'node:crypto';
 import { readFile, stat } from 'node:fs/promises';
-import { dirname, extname } from 'node:path';
-import { discoverProjectIcon } from '@raggle-ai/local';
+import { extname } from 'node:path';
+import { discoverFolderIcon } from '@raggle-ai/local';
 /**
  * Folder icons are served as immutable, content-addressed assets, so the
  * cap is generous: it only guards against pathological files, not normal
@@ -34,26 +34,8 @@ export function decodeBase64Url(value) {
 export function iconUrl(folder, hash, mediaType) {
     return `/api/folders/${encodeBase64Url(folder)}/assets/${hash}.${iconExtensions.get(mediaType)}`;
 }
-/**
- * Nearest ancestor icon for a folder, walking up parent directories so
- * nested folders inherit the closest icon above them. The bundled
- * `@raggle-ai/local` does not export the ancestor-aware discovery helper
- * yet, so the walk is implemented here over `discoverProjectIcon`.
- */
-export function discoverAncestorIcon(folder) {
-    let current = folder;
-    while (true) {
-        const icon = discoverProjectIcon(current);
-        if (icon)
-            return icon;
-        const parent = dirname(current);
-        if (parent === current)
-            return undefined;
-        current = parent;
-    }
-}
 export async function folderIcon(folder, assets, assetFiles, fallback) {
-    const icon = discoverAncestorIcon(folder);
+    const icon = discoverFolderIcon(folder);
     const mediaType = icon ? iconTypes.get(extname(icon).toLowerCase()) : null;
     const details = icon && mediaType ? await stat(icon).catch(() => undefined) : undefined;
     if (!icon || !mediaType || !details?.size || details.size > maxIconBytes) {

package/dist/site/hot-viewer.js

@@ -201,7 +201,7 @@ export async function hotViewer(options) {
         env: {
             ...process.env,
             // Explicit remote bindings (--lan) switch the Vite plugins into
-            // remote mode: realpath root scope, host actions disabled, ACP off.
+            // remote mode: realpath root scope, host actions disabled.
             // KENNEL_VIEWER_HOSTS tells the config which Host headers are legit
             // (DNS-rebinding guard; loopback is always allowed).
             KENNEL_VIEWER_ROOT: options.root,

package/dist/site/kinds.d.ts

@@ -1 +1 @@
-export * from "kennel-preview/kinds";
+export { previewKind } from "kennel-api/shared/document-kinds";

package/dist/site/kinds.js

@@ -1,4 +1,4 @@
-// packages/kinds/src/kinds.ts
+// packages/api/src/shared/document-kinds.ts
 var previewTextKinds = new Set([
   "code",
   "eml",
@@ -7,9 +7,6 @@ var previewTextKinds = new Set([
   "table",
   "text"
 ]);
-function previewTextKind(kind) {
-  return previewTextKinds.has(kind);
-}
 var codeExtensions = new Set([
   ".astro",
   ".bash",
@@ -100,60 +97,6 @@ function previewKind(path) {
     return "binary";
   return;
 }
-var rawMime = {
-  ".avif": "image/avif",
-  ".bmp": "image/bmp",
-  ".gif": "image/gif",
-  ".htm": "text/html; charset=utf-8",
-  ".html": "text/html; charset=utf-8",
-  ".ico": "image/x-icon",
-  ".jpeg": "image/jpeg",
-  ".jpg": "image/jpeg",
-  ".pdf": "application/pdf",
-  ".png": "image/png",
-  ".svg": "image/svg+xml",
-  ".webp": "image/webp"
-};
-function previewRawMime(path) {
-  const extension = path.slice(path.lastIndexOf(".")).toLowerCase();
-  const mime = rawMime[extension];
-  if (mime)
-    return mime;
-  if (previewKind(path) === "code" || previewKind(path) === "table")
-    return "text/plain; charset=utf-8";
-  return;
-}
-var mediaMime = {
-  ".aac": "audio/aac",
-  ".avif": "image/avif",
-  ".bmp": "image/bmp",
-  ".flac": "audio/flac",
-  ".gif": "image/gif",
-  ".ico": "image/x-icon",
-  ".jpeg": "image/jpeg",
-  ".jpg": "image/jpeg",
-  ".m4a": "audio/mp4",
-  ".m4v": "video/mp4",
-  ".mov": "video/quicktime",
-  ".mp3": "audio/mpeg",
-  ".mp4": "video/mp4",
-  ".oga": "audio/ogg",
-  ".ogg": "audio/ogg",
-  ".ogv": "video/ogg",
-  ".opus": "audio/opus",
-  ".png": "image/png",
-  ".wav": "audio/wav",
-  ".webm": "video/webm",
-  ".webp": "image/webp"
-};
-function mediaRawMime(path) {
-  const extension = path.slice(path.lastIndexOf(".")).toLowerCase();
-  return mediaMime[extension];
-}
 export {
-  mediaRawMime,
-  previewKind,
-  previewRawMime,
-  previewTextKind,
-  previewTextKinds
+  previewKind
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kennel",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "description": "Open-source pop-up previews for AI output: markdown, HTML artifacts, email, images, code, tables, notes, and calendars, from the terminal or your agent session.",
   "type": "module",
   "license": "MIT",
@@ -49,7 +49,8 @@
   "scripts": {
     "build": "node scripts/build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "check": "npm run build && node --check bin/kennel.mjs && node --check dist/main.js",
+    "check": "npm run build && node --check bin/kennel.mjs && node --check dist/main.js && npm run smoke",
+    "smoke": "node --input-type=module -e \"await import('./dist/mcp/generate.js')\"",
     "prepack": "node scripts/build.mjs",
     "pack:check": "bun pm pack --dry-run",
     "publish:public": "npm publish --access public --registry=https://registry.npmjs.org --@raggle-ai:registry=https://registry.npmjs.org",
@@ -65,12 +66,10 @@
     "date-fns": "^4.1.0",
     "effect": "^3.19.7",
     "esbuild": "^0.27.0",
-    "kennel-knowledge": "https://registry.npmjs.org/%40raggle-ai%2fkennel-knowledge/-/kennel-knowledge-0.1.0.tgz",
     "kennel-mcp": "https://registry.npmjs.org/%40raggle-ai%2fkennel-mcp/-/kennel-mcp-0.1.8.tgz",
-    "kennel-plugins": "0.1.10",
+    "kennel-plugins": "0.1.11",
     "koffi": "^3.3.1",
     "lucide-react": "^0.562.0",
-    "pi-acp": "0.0.33",
     "radix-ui": "^1.6.7",
     "react": "19.1.0",
     "react-dom": "19.1.0",
@@ -84,6 +83,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.13.4",
+    "kennel-api": "0.1.0",
     "kennel-preview": "0.1.0",
     "typescript": "^5.9.3"
   },

package/schemas/config.schema.json

@@ -79,6 +79,7 @@
           "type": "string",
           "pattern": "^(?!\\.{1,2}$)[^/\\\\]+$"
         },
+        "skill": { "$ref": "#/$defs/pluginSkill" },
         "entries": {
           "description": "Resolved absolute convention entry files. api is optional.",
           "oneOf": [
@@ -88,6 +89,35 @@
         }
       }
     },
+    "pluginSkill": {
+      "description": "Agent skill declared by package.json > kennel.plugin.skill or kennel.plugin.json > skill. Managed by `kennel plugin add` and `kennel plugin skill install`.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["entry", "name"],
+      "properties": {
+        "entry": {
+          "description": "SKILL.md path relative to the plugin package root.",
+          "type": "string",
+          "pattern": "^(?!/)(?:[^\\\\]*/)?SKILL\\.md$"
+        },
+        "name": {
+          "description": "Skill frontmatter name; the agent-store folder name.",
+          "type": "string",
+          "pattern": "^[a-z0-9][a-z0-9-]{0,63}$"
+        },
+        "installed": {
+          "description": "Last install into ${AGENTS_HOME:-$HOME/.agents}/skills.",
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["path", "commit", "digest"],
+          "properties": {
+            "path": { "$ref": "#/$defs/absolutePath" },
+            "commit": { "description": "Pinned Git commit or local source SHA-256.", "type": "string", "pattern": "^(?:[0-9a-f]{40}|[0-9a-f]{64})$" },
+            "digest": { "description": "SHA-256 of the installed skill files.", "type": "string", "pattern": "^[0-9a-f]{64}$" }
+          }
+        }
+      }
+    },
     "entriesWithoutApi": {
       "type": "object",
       "additionalProperties": false,

package/web/assets/{abnfDiagram-VRR7QNED-aRemVX7f.js → abnfDiagram-VRR7QNED-CIyEzNaJ.js}

@@ -1 +1 @@
-import{g as p,r as u,d as a}from"./chunk-MOJQB5TN-zyGgx-VW.js";import{p as f}from"./chunk-JWPE2WC7-CckCaqu_.js";import{_ as n,l as o}from"./mermaid.core-CL9g6xVu.js";import{b as c,M as d}from"./cynefin-VYW2F7L2-B75MWf5b.js";import"./index-D_Fcgs3V.js";import"./react-DELVxLrX.js";import"./markdown-BP-54rPU.js";import"./tanstack-CRaSxWtK.js";var v=c().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),m=t?parseInt(t,10):0,l=s?parseInt(s,10):1/0;return{min:m,max:l}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new d(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},C={parser:R,db:a,renderer:u,styles:p};export{C as diagram};
+import{g as p,r as u,d as a}from"./chunk-MOJQB5TN-BSlB5ICN.js";import{p as f}from"./chunk-JWPE2WC7-DotlQGla.js";import{_ as n,l as o}from"./mermaid.core-BIJiZKob.js";import{b as c,M as d}from"./cynefin-VYW2F7L2-D-wd85t1.js";import"./index-DmJQJIC1.js";import"./react-DELVxLrX.js";import"./markdown-BP-54rPU.js";import"./tanstack-CRaSxWtK.js";var v=c().RailroadAbnf.parser.LangiumParser,i=n(e=>{const r=e.alternatives.map(g);return r.length===1?r[0]:{type:"choice",alternatives:r}},"transformAlternation"),g=n(e=>{const r=e.elements.map(y);return r.length===1?r[0]:{type:"sequence",elements:r}},"transformConcatenation"),b=n(e=>{if(e.includes("*")){const[t,s]=e.split("*"),m=t?parseInt(t,10):0,l=s?parseInt(s,10):1/0;return{min:m,max:l}}const r=parseInt(e,10);return{min:r,max:r}},"parseRepeat"),y=n(e=>{const r=A(e.primary);if(!e.repeat)return r;const{min:t,max:s}=b(e.repeat);return t===0&&s===1?{type:"optional",element:r}:{type:"repetition",element:r,min:t,max:s}},"transformElement"),A=n(e=>{switch(e.$type){case"AbnfStringLiteral":return{type:"terminal",value:e.value};case"AbnfNumVal":return{type:"terminal",value:e.value};case"AbnfRuleName":return{type:"nonterminal",name:e.name};case"AbnfGroup":return i(e.element);case"AbnfOptionalGroup":return{type:"optional",element:i(e.element)};default:throw new Error(`Unsupported ABNF primary node: ${e.$type}`)}},"transformPrimary"),P=n(e=>({name:e.name,definition:i(e.definition)}),"transformRule"),h=n(e=>{f(e,a),e.title&&a.setTitle(e.title),e.rules.map(r=>a.addRule(P(r)))},"populateDb"),R={parse:n(e=>{a.clear(),o.debug("[ABNF Parser] Starting Langium parse");const r=v.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new d(r);const t=r.value;o.debug("[ABNF Parser] Parsed rules:",t.rules.length),h(t),o.debug("[ABNF Parser] Parse complete")},"parse"),parser:{yy:a}},C={parser:R,db:a,renderer:u,styles:p};export{C as diagram};

package/web/assets/{arc-BpDsnNTf.js → arc-Dba3y3eW.js}

@@ -1 +1 @@
-import{Y as ln,$ as an,a0 as F,a1 as q,a2 as j,a3 as un,a4 as y,a5 as tn,a6 as J,a7 as _,a8 as rn,a9 as o,aa as sn,ab as on,ac as fn}from"./mermaid.core-CL9g6xVu.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,z,a){var O=I-l,i=D-h,n=z-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function U(l,h,I,D,v,A,z){var a=l-I,O=h-D,i=(z?A:-A)/J(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,B=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*J(on(0,T*T*R-P*P)),Y=(P*g-m*S)/R,$=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=Y-B,e=$-t,r=w-B,C=p-t;return x*x+e*e>r*r+C*C&&(Y=w,$=p),{cx:Y,cy:$,x01:-n,y01:-d,x11:Y*(v/T-1),y11:$*(v/T-1)}}function hn(){var l=cn,h=yn,I=j(0),D=null,v=gn,A=dn,z=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-un,c=A.apply(this,arguments)-un,B=rn(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(B>tn-y)a.moveTo(s*F(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*F(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=B,S=B,Y=z.apply(this,arguments)/2,$=Y>y&&(D?+D.apply(this,arguments):J(u*u+s*s)),w=_(rn(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if($>y){var C=sn($/u*q(Y)),K=sn($/s*q(Y));(P-=C*2)>y?(C*=t?1:-1,R+=C,T-=C):(P=0,R=T=(f+c)/2),(S-=K*2)>y?(K*=t?1:-1,m+=K,g-=K):(S=0,m=g=(f+c)/2)}var G=s*F(m),H=s*q(m),L=u*F(T),M=u*q(T);if(w>y){var N=s*F(g),Q=s*q(g),V=u*F(R),W=u*q(R),E;if(B<an)if(E=pn(G,H,V,W,N,Q,L,M)){var X=G-E[0],Z=H-E[1],b=N-E[0],k=Q-E[1],nn=1/q(fn((X*b+Z*k)/(J(X*X+Z*Z)*J(b*b+k*k)))/2),en=J(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=U(V,W,G,H,s,x,t),r=U(N,Q,L,M,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(G,H),a.arc(0,0,s,m,g,!t)):a.moveTo(G,H),!(u>y)||!(P>y)?a.lineTo(L,M):p>y?(e=U(L,M,N,Q,u,-p,t),r=U(G,H,V,W,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-an/2;return[F(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:j(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:j(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:j(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:j(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:j(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:j(+n),i):A},i.padAngle=function(n){return arguments.length?(z=typeof n=="function"?n:j(+n),i):z},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};
+import{Y as ln,$ as an,a0 as F,a1 as q,a2 as j,a3 as un,a4 as y,a5 as tn,a6 as J,a7 as _,a8 as rn,a9 as o,aa as sn,ab as on,ac as fn}from"./mermaid.core-BIJiZKob.js";function cn(l){return l.innerRadius}function yn(l){return l.outerRadius}function gn(l){return l.startAngle}function dn(l){return l.endAngle}function mn(l){return l&&l.padAngle}function pn(l,h,I,D,v,A,z,a){var O=I-l,i=D-h,n=z-v,d=a-A,u=d*O-n*i;if(!(u*u<y))return u=(n*(h-A)-d*(l-v))/u,[l+u*O,h+u*i]}function U(l,h,I,D,v,A,z){var a=l-I,O=h-D,i=(z?A:-A)/J(a*a+O*O),n=i*O,d=-i*a,u=l+n,s=h+d,f=I+n,c=D+d,B=(u+f)/2,t=(s+c)/2,m=f-u,g=c-s,R=m*m+g*g,T=v-A,P=u*c-f*s,S=(g<0?-1:1)*J(on(0,T*T*R-P*P)),Y=(P*g-m*S)/R,$=(-P*m-g*S)/R,w=(P*g+m*S)/R,p=(-P*m+g*S)/R,x=Y-B,e=$-t,r=w-B,C=p-t;return x*x+e*e>r*r+C*C&&(Y=w,$=p),{cx:Y,cy:$,x01:-n,y01:-d,x11:Y*(v/T-1),y11:$*(v/T-1)}}function hn(){var l=cn,h=yn,I=j(0),D=null,v=gn,A=dn,z=mn,a=null,O=ln(i);function i(){var n,d,u=+l.apply(this,arguments),s=+h.apply(this,arguments),f=v.apply(this,arguments)-un,c=A.apply(this,arguments)-un,B=rn(c-f),t=c>f;if(a||(a=n=O()),s<u&&(d=s,s=u,u=d),!(s>y))a.moveTo(0,0);else if(B>tn-y)a.moveTo(s*F(f),s*q(f)),a.arc(0,0,s,f,c,!t),u>y&&(a.moveTo(u*F(c),u*q(c)),a.arc(0,0,u,c,f,t));else{var m=f,g=c,R=f,T=c,P=B,S=B,Y=z.apply(this,arguments)/2,$=Y>y&&(D?+D.apply(this,arguments):J(u*u+s*s)),w=_(rn(s-u)/2,+I.apply(this,arguments)),p=w,x=w,e,r;if($>y){var C=sn($/u*q(Y)),K=sn($/s*q(Y));(P-=C*2)>y?(C*=t?1:-1,R+=C,T-=C):(P=0,R=T=(f+c)/2),(S-=K*2)>y?(K*=t?1:-1,m+=K,g-=K):(S=0,m=g=(f+c)/2)}var G=s*F(m),H=s*q(m),L=u*F(T),M=u*q(T);if(w>y){var N=s*F(g),Q=s*q(g),V=u*F(R),W=u*q(R),E;if(B<an)if(E=pn(G,H,V,W,N,Q,L,M)){var X=G-E[0],Z=H-E[1],b=N-E[0],k=Q-E[1],nn=1/q(fn((X*b+Z*k)/(J(X*X+Z*Z)*J(b*b+k*k)))/2),en=J(E[0]*E[0]+E[1]*E[1]);p=_(w,(u-en)/(nn-1)),x=_(w,(s-en)/(nn+1))}else p=x=0}S>y?x>y?(e=U(V,W,G,H,s,x,t),r=U(N,Q,L,M,s,x,t),a.moveTo(e.cx+e.x01,e.cy+e.y01),x<w?a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,x,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,s,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),!t),a.arc(r.cx,r.cy,x,o(r.y11,r.x11),o(r.y01,r.x01),!t))):(a.moveTo(G,H),a.arc(0,0,s,m,g,!t)):a.moveTo(G,H),!(u>y)||!(P>y)?a.lineTo(L,M):p>y?(e=U(L,M,N,Q,u,-p,t),r=U(G,H,V,W,u,-p,t),a.lineTo(e.cx+e.x01,e.cy+e.y01),p<w?a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(r.y01,r.x01),!t):(a.arc(e.cx,e.cy,p,o(e.y01,e.x01),o(e.y11,e.x11),!t),a.arc(0,0,u,o(e.cy+e.y11,e.cx+e.x11),o(r.cy+r.y11,r.cx+r.x11),t),a.arc(r.cx,r.cy,p,o(r.y11,r.x11),o(r.y01,r.x01),!t))):a.arc(0,0,u,T,R,t)}if(a.closePath(),n)return a=null,n+""||null}return i.centroid=function(){var n=(+l.apply(this,arguments)+ +h.apply(this,arguments))/2,d=(+v.apply(this,arguments)+ +A.apply(this,arguments))/2-an/2;return[F(d)*n,q(d)*n]},i.innerRadius=function(n){return arguments.length?(l=typeof n=="function"?n:j(+n),i):l},i.outerRadius=function(n){return arguments.length?(h=typeof n=="function"?n:j(+n),i):h},i.cornerRadius=function(n){return arguments.length?(I=typeof n=="function"?n:j(+n),i):I},i.padRadius=function(n){return arguments.length?(D=n==null?null:typeof n=="function"?n:j(+n),i):D},i.startAngle=function(n){return arguments.length?(v=typeof n=="function"?n:j(+n),i):v},i.endAngle=function(n){return arguments.length?(A=typeof n=="function"?n:j(+n),i):A},i.padAngle=function(n){return arguments.length?(z=typeof n=="function"?n:j(+n),i):z},i.context=function(n){return arguments.length?(a=n??null,i):a},i}export{hn as d};