@skill-map/cli 0.9.0 → 0.11.0

package/dist/kernel/index.d.ts

@@ -827,7 +827,71 @@ interface IProviderKind {
      * disables the Provider with status `invalid-manifest`.
      */
     defaultRefreshAction: string;
+    /**
+     * Presentation metadata the UI consumes to render nodes of this kind
+     * (palette swatches, list tags, graph nodes, filter chips). Required
+     * so the UI never has to invent visuals for a Provider-declared kind.
+     * Mirrors `extensions/provider.schema.json#/properties/kinds/.../ui`.
+     */
+    ui: IProviderKindUi;
 }
+/**
+ * Presentation contract for one Provider kind. The Provider declares
+ * intent (label + base color, optional dark variant + emoji + icon);
+ * the UI derives `bg`/`fg` tints per theme via a deterministic helper
+ * and reads the registry from the `kindRegistry` field embedded in REST
+ * envelopes. Single source of truth for what a kind looks like — the
+ * UI never hardcodes presentation for a built-in kind.
+ */
+interface IProviderKindUi {
+    /**
+     * Plural human-readable label for groups of this kind (e.g. `'Skills'`,
+     * `'Agents'`, `'Cursor Rules'`). Used in filter dropdowns, palette
+     * tooltips, and any list grouping.
+     */
+    label: string;
+    /**
+     * Base hex color (`#RRGGBB`) for the light theme. The UI derives `bg`
+     * and `fg` tints from this value at runtime via a deterministic
+     * helper. Declaring one base value (instead of three) keeps the
+     * manifest small and centralises accessibility-driven contrast in the
+     * UI.
+     */
+    color: string;
+    /**
+     * Optional dark-theme variant of `color`. When absent, the UI falls
+     * back to `color`. Declared explicitly because a luminosity flip
+     * rarely matches the brand intent for kinds that should stand out in
+     * dark mode.
+     */
+    colorDark?: string;
+    /**
+     * Optional decorative emoji used as a fallback when `icon` is absent
+     * or fails to render. Length-bound so the UI can lay it out
+     * predictably alongside text.
+     */
+    emoji?: string;
+    /**
+     * Optional discriminated icon descriptor. The UI prefers `icon` over
+     * `emoji`; when both are absent, the UI falls back to the first
+     * letter of `label` colored with `color`.
+     */
+    icon?: IProviderKindIcon;
+}
+/**
+ * Discriminated icon contract. `pi` references a PrimeIcons identifier
+ * (e.g. `'pi-cog'`); `svg` carries raw SVG path data the UI wraps in a
+ * `<svg viewBox="0 0 24 24"><path d="…"/></svg>` element tinted with
+ * `currentColor`. The discriminator (`kind`) keeps the UI dispatch
+ * exhaustive without string-sniffing the payload.
+ */
+type IProviderKindIcon = {
+    kind: 'pi';
+    id: string;
+} | {
+    kind: 'svg';
+    path: string;
+};
 interface IProvider extends IExtensionBase {
     kind: 'provider';
     /**

package/dist/kernel/index.js

@@ -102,7 +102,7 @@ import yaml from "js-yaml";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.9.0",
+  version: "0.11.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -149,6 +149,7 @@ var package_default = {
   scripts: {
     build: "tsup",
     dev: "tsup --watch",
+    "dev:serve": "node ../scripts/dev-serve.js",
     typecheck: "tsc --noEmit",
     lint: "eslint .",
     "lint:fix": "eslint . --fix",
@@ -159,17 +160,20 @@ var package_default = {
     clean: "rm -rf dist coverage"
   },
   dependencies: {
+    "@hono/node-server": "2.0.1",
     "@skill-map/spec": "*",
     ajv: "8.18.0",
     "ajv-formats": "3.0.1",
     chokidar: "5.0.0",
     clipanion: "4.0.0-rc.4",
+    hono: "4.12.16",
     ignore: "7.0.5",
     "js-tiktoken": "1.0.21",
     "js-yaml": "4.1.1",
     kysely: "0.28.16",
     semver: "7.7.4",
-    typanion: "3.14.0"
+    typanion: "3.14.0",
+    ws: "8.20.0"
   },
   devDependencies: {
     "@eslint/js": "10.0.1",
@@ -177,6 +181,7 @@ var package_default = {
     "@types/js-yaml": "4.0.9",
     "@types/node": "24.12.2",
     "@types/semver": "7.7.1",
+    "@types/ws": "8.18.1",
     c8: "11.0.0",
     eslint: "10.2.1",
     "eslint-plugin-import-x": "4.16.2",
@@ -246,9 +251,15 @@ import { existsSync, readFileSync, readdirSync } from "fs";
 import { isAbsolute, join, relative, resolve } from "path";
 import { pathToFileURL } from "url";
 import { Ajv2020 } from "ajv/dist/2020.js";
-import addFormatsModule from "ajv-formats";
 import semver from "semver";
 
+// kernel/util/ajv-interop.ts
+import addFormatsModule from "ajv-formats";
+var addFormats = addFormatsModule.default ?? addFormatsModule;
+function applyAjvFormats(ajv) {
+  addFormats(ajv);
+}
+
 // kernel/i18n/plugin-store.texts.ts
 var PLUGIN_STORE_TEXTS = {
   kvValidationFailed: "plugin '{{pluginId}}' ctx.store.set('{{key}}', value): value violates declared schema ({{schemaPath}}) \u2014 {{errors}}",
@@ -339,7 +350,6 @@ var HOOK_TRIGGERS = Object.freeze([
 ]);
 
 // kernel/adapters/plugin-loader.ts
-var addFormats = addFormatsModule.default ?? addFormatsModule;
 var KNOWN_KINDS = /* @__PURE__ */ new Set(["provider", "extractor", "rule", "action", "formatter", "hook"]);
 var KNOWN_KINDS_LIST = [...KNOWN_KINDS].join(" / ");
 var HOOKABLE_TRIGGERS_LIST = HOOK_TRIGGERS.join(", ");
@@ -356,8 +366,6 @@ import { readFileSync as readFileSync2 } from "fs";
 import { dirname, resolve as resolve2 } from "path";
 import { createRequire as createRequire2 } from "module";
 import { Ajv2020 as Ajv20202 } from "ajv/dist/2020.js";
-import addFormatsModule2 from "ajv-formats";
-var addFormats2 = addFormatsModule2.default ?? addFormatsModule2;
 function buildProviderFrontmatterValidator(providers) {
   const specRoot = resolveSpecRoot();
   const ajv = new Ajv20202({
@@ -365,7 +373,7 @@ function buildProviderFrontmatterValidator(providers) {
     allErrors: true,
     allowUnionTypes: true
   });
-  addFormats2(ajv);
+  applyAjvFormats(ajv);
   const baseFile = resolve2(specRoot, "schemas/frontmatter/base.schema.json");
   const baseSchema = JSON.parse(readFileSync2(baseFile, "utf8"));
   ajv.addSchema(baseSchema);