@skill-map/cli 0.51.0 → 0.53.0

package/dist/kernel/index.js

@@ -1,6 +1,6 @@
 // kernel/i18n/registry.texts.ts
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="77a22e54-0917-5b5e-a29d-af0ad20bed19")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="5a40a4c9-3996-540c-b687-874d383944d0")}catch(e){}}();
 var REGISTRY_TEXTS = {
   duplicateExtension: "Extension already registered: {{kind}}:{{qualifiedId}}",
   unknownKind: "Unknown extension kind: {{kind}}",
@@ -102,7 +102,7 @@ import { Tiktoken as Tiktoken2 } from "js-tiktoken/lite";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.51.0",
+  version: "0.53.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -160,15 +160,16 @@ var package_default = {
     prebuild: "pnpm build-built-ins",
     validate: "pnpm validate:compile && pnpm validate:test",
     "validate:compile": "pnpm typecheck && pnpm lint && pnpm build && pnpm built-ins:check && pnpm view-catalog:check",
-    "validate:test": "pnpm test:ci",
+    "validate:test": "pnpm test:ci && pnpm conformance",
+    conformance: "SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 node --import tsx cli/entry.ts conformance run",
     pretest: "tsup",
     "pretest:coverage": "tsup",
     "pretest:coverage:html": "tsup",
-    test: "tsc --noEmit && SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:ci": "FORCE_COLOR=1 SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:spec": "SKILL_MAP_TELEMETRY=0 node --import tsx --test --test-reporter=spec '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:coverage": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SKILL_MAP_SKIP_BENCHMARK=1 node --experimental-default-config-file --import tsx --test --experimental-test-coverage '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
-    "test:coverage:html": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SKILL_MAP_SKIP_BENCHMARK=1 c8 node --import tsx --test '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    test: "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:ci": "FORCE_COLOR=1 SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 node --import tsx --test --test-reporter=./scripts/test-reporter.js --test-reporter-destination=stdout '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:spec": "SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 node --import tsx --test --test-reporter=spec '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:coverage": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 SKILL_MAP_SKIP_BENCHMARK=1 node --experimental-default-config-file --import tsx --test --experimental-test-coverage '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
+    "test:coverage:html": "tsc --noEmit && SKILL_MAP_TELEMETRY=0 SM_NO_UPDATE_CHECK=1 SKILL_MAP_SKIP_BENCHMARK=1 c8 node --import tsx --test '__tests__/**/*.spec.ts' 'kernel/**/__tests__/**/*.spec.ts' 'cli/**/__tests__/**/*.spec.ts' 'server/**/__tests__/**/*.spec.ts' 'plugins/**/__tests__/**/*.spec.ts' 'core/**/__tests__/**/*.spec.ts' 'conformance/**/__tests__/**/*.spec.ts'",
     clean: "rm -rf dist coverage"
   },
   dependencies: {
@@ -200,6 +201,7 @@ var package_default = {
     c8: "11.0.0",
     eslint: "10.2.1",
     "eslint-plugin-import-x": "4.16.2",
+    "json-schema-to-typescript": "15.0.4",
     tsup: "8.5.1",
     tsx: "4.22.3",
     typescript: "5.9.3",
@@ -228,150 +230,54 @@ var InMemoryProgressEmitter = class {
 };
 
 // kernel/adapters/plugin-loader/index.ts
-import { createRequire } from "module";
-import { existsSync as existsSync2, readFileSync as readFileSync3, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
-import { join as join2, resolve as resolve3 } from "path";
+import { createRequire as createRequire2 } from "module";
+import { existsSync as existsSync2, readFileSync as readFileSync4, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { join as join2, resolve as resolve4 } from "path";
 import { pathToFileURL } from "url";
 import semver from "semver";
 
-// kernel/adapters/plugin-loader/id-utils.ts
-import { isAbsolute, relative, resolve } from "path";
-
-// kernel/adapters/plugin-loader/validation.ts
-import * as nodeFs from "fs";
-import { existsSync } from "fs";
-import { dirname, join } from "path";
-import { Ajv2020 } from "ajv/dist/2020.js";
-
-// kernel/util/ajv-interop.ts
-import addFormatsModule from "ajv-formats";
-var addFormats = addFormatsModule.default ?? addFormatsModule;
-function applyAjvFormats(ajv) {
-  addFormats(ajv);
-}
-
-// kernel/extensions/hook.ts
-var HOOK_TRIGGERS = Object.freeze([
-  "boot",
-  "scan.started",
-  "scan.completed",
-  "extractor.completed",
-  "analyzer.completed",
-  "action.completed",
-  "job.spawning",
-  "job.completed",
-  "job.failed",
-  "shutdown"
-]);
-
-// kernel/adapters/plugin-loader/validation.ts
-var KNOWN_KINDS = /* @__PURE__ */ new Set([
-  "provider",
-  "extractor",
-  "analyzer",
-  "action",
-  "formatter",
-  "hook"
-]);
-var KNOWN_KINDS_LIST = [...KNOWN_KINDS].join(" / ");
-var HOOKABLE_TRIGGERS_LIST = HOOK_TRIGGERS.join(", ");
-
-// kernel/adapters/plugin-loader/storage-schemas.ts
-import { readFileSync as readFileSync2 } from "fs";
-import { resolve as resolve2 } from "path";
-import { Ajv2020 as Ajv20202 } from "ajv/dist/2020.js";
-
-// kernel/i18n/plugin-store.texts.ts
-var PLUGIN_STORE_TEXTS = {
-  kvValidationFailed: "plugin '{{pluginId}}' ctx.store.set('{{key}}', value): value violates declared schema ({{schemaPath}}): {{errors}}",
-  dedicatedValidationFailed: "plugin '{{pluginId}}' ctx.store.write('{{table}}', row): row violates declared schema ({{schemaPath}}): {{errors}}"
+// kernel/i18n/plugin-loader.texts.ts
+var SPEC_GITHUB_BASE = "https://github.com/crystian/skill-map/blob/main";
+var PLUGIN_LOADER_TEXTS = {
+  invalidManifestJsonParse: "{{manifestPath}}: {{errDescription}}. Validate the JSON (e.g. `npx jsonlint plugin.json`).",
+  invalidManifestAjv: `{{manifestPath}}: {{errors}}. See ${SPEC_GITHUB_BASE}/spec/schemas/plugins-registry.schema.json#/$defs/PluginManifest.`,
+  invalidSpecCompat: 'specCompat "{{specCompat}}" is not a valid semver range. Use a range like "^1.0.0".',
+  incompatibleSpec: `@skill-map/spec {{installedSpecVersion}} does not satisfy specCompat "{{specCompat}}". Either update the plugin's specCompat (and re-test) or pin sm to a compatible spec version.`,
+  loadErrorFileNotFound: "extension file not found: {{relEntry}} (resolved to {{abs}}). Check plugin.json#/extensions paths.",
+  loadErrorImportFailed: "{{relEntry}}: import failed: {{errDescription}}",
+  loadErrorMissingKind: "{{relEntry}}: default export missing a string `kind` field. Expected one of: {{knownKindsList}}.",
+  loadErrorUnknownKind: '{{relEntry}}: unknown extension kind "{{kindReceived}}". Expected one of: {{knownKindsList}}.',
+  // No "manifest invalid" framing here: the warning wrapper already
+  // carries the `(invalid-manifest)` status, so this reason is just the
+  // file + the specific error + the doc link. `{{docUrl}}` is chosen by
+  // the caller: a bad view-slot value points to the slot catalog
+  // (`spec/view-slots.md`), every other manifest-shape error to the kind
+  // schema. Both are GitHub blob URLs.
+  invalidManifestExtensionShape: "{{relEntry}}: {{errors}}. See {{docUrl}}.",
+  importExceededTimeout: "import exceeded {{timeoutMs}}ms; likely a top-level side effect (network call, infinite loop, large blocking work). Move side effects into the runtime methods (`detect` / `evaluate` / `render` / etc.).",
+  disabledByConfig: "disabled by config_plugins or settings.json",
+  invalidManifestDirMismatch: "directory name '{{dirName}}' does not match manifest id '{{manifestId}}'. Rename the directory to match the id, or update the manifest id to match the directory.",
+  idCollision: "Plugin '{{id}}' at {{pathA}} collides with the plugin at {{pathB}}. Rename one and rerun.",
+  loadErrorPluginIdMismatch: "{{relEntry}}: extension declares pluginId '{{declared}}' but its plugin.json declares id '{{manifestId}}'. Remove the explicit pluginId from the extension; the loader injects it from plugin.json#/id.",
+  invalidManifestRedeclaredField: "{{relEntry}}: extension manifest declares {{fields}}, derived from the folder layout (structure-as-truth) and not a manifest field. Remove it: id is the leaf folder, kind the parent folder, provider kinds the `kinds/` catalog, formatter formatId the formatter folder name.",
+  loadErrorStorageSchemaRead: "plugin '{{pluginId}}' failed to load schema for table '{{table}}': {{schemaPath}}: {{errDescription}}",
+  loadErrorStorageSchemaCompile: "plugin '{{pluginId}}' failed to compile schema for table '{{table}}': {{schemaPath}}: {{errDescription}}",
+  loadErrorStorageKvSchemaRead: "plugin '{{pluginId}}' failed to load KV schema: {{schemaPath}}: {{errDescription}}",
+  loadErrorStorageKvSchemaCompile: "plugin '{{pluginId}}' failed to compile KV schema: {{schemaPath}}: {{errDescription}}",
+  invalidManifestHookUnknownTrigger: "Hook '{{hookId}}' declares unknown trigger '{{trigger}}'. Hookable triggers: {{hookableList}}.",
+  invalidManifestHookEmptyTriggers: "Hook '{{hookId}}' declares no triggers. At least one entry from the curated set is required.",
+  loadErrorPathEscapesPlugin: "extension entry '{{relEntry}}' resolves outside the plugin directory ({{pluginPath}}). Plugin entries must be relative paths inside the plugin tree.",
+  loadErrorSchemaPathEscapesPlugin: "schema path '{{relPath}}' resolves outside the plugin directory ({{pluginPath}}). Plugin schemas must be relative paths inside the plugin tree.",
+  invalidManifestRootSharedAnnotation: "{{relEntry}}: annotationContributions['{{key}}'] declares location: 'root' with ownership: '{{ownership}}'; root keys MUST be 'exclusive' (a top-level reserved key cannot be silently shared between plugins).",
+  invalidManifestAnnotationSchemaCompile: "{{relEntry}}: annotationContributions['{{key}}'].schema is not a valid JSON Schema: {{errDescription}}",
+  fatalAnnotationRootCollision: "Annotation root-key collision: '{{key}}' is claimed with ownership: 'exclusive' by multiple plugins ({{plugins}}). The kernel cannot boot with this configuration. Rename or merge the contributions and rerun."
 };
 
-// kernel/adapters/plugin-store.ts
-var KV_SCHEMA_KEY = "__kv__";
-function makeKvStoreWrapper(opts) {
-  const { pluginId, schema, persist } = opts;
-  return {
-    async set(key, value) {
-      if (schema) {
-        if (!schema.validate(value)) {
-          throw new Error(
-            tx(PLUGIN_STORE_TEXTS.kvValidationFailed, {
-              pluginId,
-              schemaPath: schema.schemaPath,
-              key,
-              errors: formatAjvErrors(schema.validate.errors ?? null)
-            })
-          );
-        }
-      }
-      await persist(key, value);
-    }
-  };
-}
-function makeDedicatedStoreWrapper(opts) {
-  const { pluginId, schemas, persist } = opts;
-  return {
-    async write(table, row) {
-      const schema = schemas?.[table];
-      if (schema) {
-        if (!schema.validate(row)) {
-          throw new Error(
-            tx(PLUGIN_STORE_TEXTS.dedicatedValidationFailed, {
-              pluginId,
-              table,
-              schemaPath: schema.schemaPath,
-              errors: formatAjvErrors(schema.validate.errors ?? null)
-            })
-          );
-        }
-      }
-      await persist(table, row);
-    }
-  };
-}
-function makePluginStore(opts) {
-  const manifest = opts.plugin.manifest;
-  if (!manifest?.storage) return void 0;
-  const storageSchemas = opts.plugin.storageSchemas;
-  if (manifest.storage.mode === "kv") {
-    if (!opts.persistKv) return void 0;
-    const schema = storageSchemas?.[KV_SCHEMA_KEY];
-    return makeKvStoreWrapper({
-      pluginId: opts.plugin.id,
-      schema,
-      persist: opts.persistKv
-    });
-  }
-  if (manifest.storage.mode === "dedicated") {
-    if (!opts.persistDedicated) return void 0;
-    return makeDedicatedStoreWrapper({
-      pluginId: opts.plugin.id,
-      schemas: storageSchemas,
-      persist: opts.persistDedicated
-    });
-  }
-  return void 0;
-}
-function formatAjvErrors(errors) {
-  if (!errors || errors.length === 0) return "(no AJV details)";
-  return errors.map((e) => `${e.instancePath || "(root)"} ${e.message ?? e.keyword}`).join("; ");
-}
-
-// kernel/adapters/plugin-loader/index.ts
-function installedSpecVersion() {
-  const require2 = createRequire(import.meta.url);
-  const indexPath = require2.resolve("@skill-map/spec/index.json");
-  const pkgPath = resolve3(indexPath, "..", "package.json");
-  const pkg = JSON.parse(readFileSync3(pkgPath, "utf8"));
-  return pkg.version;
-}
-
 // kernel/adapters/schema-validators.ts
-import { readFileSync as readFileSync4 } from "fs";
-import { dirname as dirname2, resolve as resolve4 } from "path";
-import { createRequire as createRequire2 } from "module";
-import { Ajv2020 as Ajv20203 } from "ajv/dist/2020.js";
+import { readFileSync } from "fs";
+import { dirname, resolve } from "path";
+import { createRequire } from "module";
+import { Ajv2020 } from "ajv/dist/2020.js";
 
 // kernel/types/view-catalog.generated.ts
 var ALL_SLOT_NAMES = [
@@ -380,8 +286,8 @@ var ALL_SLOT_NAMES = [
   "card.footer.left",
   "card.footer.right",
   "graph.node.alert",
-  "inspector.header.badge.counter",
-  "inspector.header.badge.tag",
+  "inspector.header.badge",
+  "inspector.action.button",
   "inspector.body.panel.breakdown",
   "inspector.body.panel.records",
   "inspector.body.panel.tree",
@@ -392,6 +298,13 @@ var ALL_SLOT_NAMES = [
 ];
 var KNOWN_SLOT_NAMES = new Set(ALL_SLOT_NAMES);
 
+// kernel/util/ajv-interop.ts
+import addFormatsModule from "ajv-formats";
+var addFormats = addFormatsModule.default ?? addFormatsModule;
+function applyAjvFormats(ajv) {
+  addFormats(ajv);
+}
+
 // kernel/adapters/schema-validators.ts
 var SCHEMA_FILES = {
   node: "schemas/node.schema.json",
@@ -430,22 +343,22 @@ function loadSchemaValidators() {
 }
 function buildSchemaValidators() {
   const specRoot = resolveSpecRoot();
-  const ajv = new Ajv20203({
+  const ajv = new Ajv2020({
     strict: false,
     allErrors: true,
     allowUnionTypes: true
   });
   applyAjvFormats(ajv);
   for (const rel of SUPPORTING_SCHEMAS) {
-    const file = resolve4(specRoot, rel);
+    const file = resolve(specRoot, rel);
     if (!existsSyncSafe(file)) continue;
-    const schema = JSON.parse(readFileSync4(file, "utf8"));
+    const schema = JSON.parse(readFileSync(file, "utf8"));
     ajv.addSchema(schema);
   }
   const validators = /* @__PURE__ */ new Map();
   for (const [name, rel] of Object.entries(SCHEMA_FILES)) {
-    const file = resolve4(specRoot, rel);
-    const schema = JSON.parse(readFileSync4(file, "utf8"));
+    const file = resolve(specRoot, rel);
+    const schema = JSON.parse(readFileSync(file, "utf8"));
     const byId = typeof schema.$id === "string" ? ajv.getSchema(schema.$id) : void 0;
     validators.set(name, byId ?? ajv.compile(schema));
   }
@@ -489,12 +402,12 @@ function buildSchemaValidators() {
       const v = validators.get(name);
       if (!v) throw new Error(`Unknown schema: ${name}`);
       if (v(data)) return { ok: true, data };
-      const errors = (v.errors ?? []).map(formatError).join("; ");
+      const errors = formatAjvErrors(v.errors);
       return { ok: false, errors };
     },
     validatePluginManifest(data) {
       if (pluginManifestValidator(data)) return { ok: true, data };
-      const errors = (pluginManifestValidator.errors ?? []).map(formatError).join("; ");
+      const errors = formatAjvErrors(pluginManifestValidator.errors);
       return { ok: false, errors };
     },
     validateContributionPayload(slot, payload) {
@@ -503,21 +416,21 @@ function buildSchemaValidators() {
         return { ok: false, errors: "unknown-slot" };
       }
       if (validator(payload)) return { ok: true };
-      const errors = (validator.errors ?? []).map(formatError).join("; ");
+      const errors = formatAjvErrors(validator.errors);
       return { ok: false, errors };
     }
   };
 }
 function buildProviderFrontmatterValidator(providers) {
   const specRoot = resolveSpecRoot();
-  const ajv = new Ajv20203({
+  const ajv = new Ajv2020({
     strict: false,
     allErrors: true,
     allowUnionTypes: true
   });
   applyAjvFormats(ajv);
-  const baseFile = resolve4(specRoot, "schemas/frontmatter/base.schema.json");
-  const baseSchema = JSON.parse(readFileSync4(baseFile, "utf8"));
+  const baseFile = resolve(specRoot, "schemas/frontmatter/base.schema.json");
+  const baseSchema = JSON.parse(readFileSync(baseFile, "utf8"));
   ajv.addSchema(baseSchema);
   registerProviderAuxiliarySchemas(ajv, providers);
   const compiled = /* @__PURE__ */ new Map();
@@ -535,7 +448,7 @@ function buildProviderFrontmatterValidator(providers) {
       const v = compiled.get(key);
       if (!v) return { ok: false, errors: "no-schema" };
       if (v(data)) return { ok: true };
-      const errors = (v.errors ?? []).map(formatError).join("; ");
+      const errors = formatAjvErrors(v.errors);
       return { ok: false, errors };
     }
   };
@@ -544,6 +457,47 @@ function formatError(err) {
   const path = err.instancePath || "(root)";
   return `${path} ${err.message ?? err.keyword}`;
 }
+function formatAjvErrors(errors) {
+  const list = errors ?? [];
+  if (list.length === 0) return "";
+  const byPath2 = /* @__PURE__ */ new Map();
+  for (const e of list) {
+    const path = e.instancePath || "(root)";
+    const bucket = byPath2.get(path);
+    if (bucket) bucket.push(e);
+    else byPath2.set(path, [e]);
+  }
+  const parts = [];
+  for (const [path, errs] of byPath2) parts.push(...formatPathErrors(path, errs));
+  return [...new Set(parts)].join("; ");
+}
+function constBranchValues(errs) {
+  let count = 0;
+  for (const e of errs) {
+    const isConst = e.keyword === "const" && typeof e.params === "object" && e.params !== null && "allowedValue" in e.params;
+    if (isConst) count += 1;
+  }
+  return count;
+}
+function formatPathErrors(path, errs) {
+  if (constBranchValues(errs) >= 2) {
+    const parts2 = [`${path} is not a valid value`];
+    for (const e of errs) {
+      if (e.keyword !== "const" && e.keyword !== "oneOf") parts2.push(formatError(e));
+    }
+    return parts2;
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const parts = [];
+  for (const e of errs) {
+    const msg = formatError(e);
+    if (!seen.has(msg)) {
+      seen.add(msg);
+      parts.push(msg);
+    }
+  }
+  return parts;
+}
 function registerProviderAuxiliarySchemas(ajv, providers) {
   for (const provider of providers) {
     if (!provider.schemas) continue;
@@ -555,10 +509,10 @@ function registerProviderAuxiliarySchemas(ajv, providers) {
   }
 }
 function resolveSpecRoot() {
-  const require2 = createRequire2(import.meta.url);
+  const require2 = createRequire(import.meta.url);
   try {
     const indexPath = require2.resolve("@skill-map/spec/index.json");
-    return dirname2(indexPath);
+    return dirname(indexPath);
   } catch {
     throw new Error(
       "@skill-map/spec not resolvable: ensure the workspace is linked or the package is installed."
@@ -567,13 +521,139 @@ function resolveSpecRoot() {
 }
 function existsSyncSafe(path) {
   try {
-    readFileSync4(path, "utf8");
+    readFileSync(path, "utf8");
     return true;
   } catch {
     return false;
   }
 }
 
+// kernel/adapters/plugin-loader/id-utils.ts
+import { isAbsolute, relative, resolve as resolve2 } from "path";
+
+// kernel/adapters/plugin-loader/validation.ts
+import * as nodeFs from "fs";
+import { existsSync } from "fs";
+import { dirname as dirname2, join } from "path";
+import { Ajv2020 as Ajv20202 } from "ajv/dist/2020.js";
+
+// kernel/extensions/hook.ts
+var HOOK_TRIGGERS = Object.freeze([
+  "boot",
+  "scan.started",
+  "scan.completed",
+  "extractor.completed",
+  "analyzer.completed",
+  "action.completed",
+  "job.spawning",
+  "job.completed",
+  "job.failed",
+  "shutdown"
+]);
+
+// kernel/adapters/plugin-loader/validation.ts
+var KNOWN_KINDS = /* @__PURE__ */ new Set([
+  "provider",
+  "extractor",
+  "analyzer",
+  "action",
+  "formatter",
+  "hook"
+]);
+var KNOWN_KINDS_LIST = [...KNOWN_KINDS].join(" / ");
+var HOOKABLE_TRIGGERS_LIST = HOOK_TRIGGERS.join(", ");
+
+// kernel/adapters/plugin-loader/storage-schemas.ts
+import { readFileSync as readFileSync3 } from "fs";
+import { resolve as resolve3 } from "path";
+import { Ajv2020 as Ajv20203 } from "ajv/dist/2020.js";
+
+// kernel/i18n/plugin-store.texts.ts
+var PLUGIN_STORE_TEXTS = {
+  kvValidationFailed: "plugin '{{pluginId}}' ctx.store.set('{{key}}', value): value violates declared schema ({{schemaPath}}): {{errors}}",
+  dedicatedValidationFailed: "plugin '{{pluginId}}' ctx.store.write('{{table}}', row): row violates declared schema ({{schemaPath}}): {{errors}}"
+};
+
+// kernel/adapters/plugin-store.ts
+var KV_SCHEMA_KEY = "__kv__";
+function makeKvStoreWrapper(opts) {
+  const { pluginId, schema, persist } = opts;
+  return {
+    async set(key, value) {
+      if (schema) {
+        if (!schema.validate(value)) {
+          throw new Error(
+            tx(PLUGIN_STORE_TEXTS.kvValidationFailed, {
+              pluginId,
+              schemaPath: schema.schemaPath,
+              key,
+              errors: formatAjvErrors2(schema.validate.errors ?? null)
+            })
+          );
+        }
+      }
+      await persist(key, value);
+    }
+  };
+}
+function makeDedicatedStoreWrapper(opts) {
+  const { pluginId, schemas, persist } = opts;
+  return {
+    async write(table, row) {
+      const schema = schemas?.[table];
+      if (schema) {
+        if (!schema.validate(row)) {
+          throw new Error(
+            tx(PLUGIN_STORE_TEXTS.dedicatedValidationFailed, {
+              pluginId,
+              table,
+              schemaPath: schema.schemaPath,
+              errors: formatAjvErrors2(schema.validate.errors ?? null)
+            })
+          );
+        }
+      }
+      await persist(table, row);
+    }
+  };
+}
+function makePluginStore(opts) {
+  const manifest = opts.plugin.manifest;
+  if (!manifest?.storage) return void 0;
+  const storageSchemas = opts.plugin.storageSchemas;
+  if (manifest.storage.mode === "kv") {
+    if (!opts.persistKv) return void 0;
+    const schema = storageSchemas?.[KV_SCHEMA_KEY];
+    return makeKvStoreWrapper({
+      pluginId: opts.plugin.id,
+      schema,
+      persist: opts.persistKv
+    });
+  }
+  if (manifest.storage.mode === "dedicated") {
+    if (!opts.persistDedicated) return void 0;
+    return makeDedicatedStoreWrapper({
+      pluginId: opts.plugin.id,
+      schemas: storageSchemas,
+      persist: opts.persistDedicated
+    });
+  }
+  return void 0;
+}
+function formatAjvErrors2(errors) {
+  if (!errors || errors.length === 0) return "(no AJV details)";
+  return errors.map((e) => `${e.instancePath || "(root)"} ${e.message ?? e.keyword}`).join("; ");
+}
+
+// kernel/adapters/plugin-loader/index.ts
+function installedSpecVersion() {
+  const require2 = createRequire2(import.meta.url);
+  const indexPath = require2.resolve("@skill-map/spec/index.json");
+  const pkgPath = resolve4(indexPath, "..", "package.json");
+  const pkg = JSON.parse(readFileSync4(pkgPath, "utf8"));
+  return pkg.version;
+}
+
 // kernel/util/format-error.ts
 function formatErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
@@ -691,7 +771,7 @@ var ORCHESTRATOR_TEXTS = {
   frontmatterMalformedMissingClose: "Frontmatter in {{path}} opens with `---` but never closes (no matching `---` line at column 0 was found). The file was scanned as body-only and every metadata field was silently lost. Add a closing `---` line below the metadata block.",
   extensionErrorLinkKindNotDeclared: 'Extractor "{{extractorId}}" emitted a link of kind "{{linkKind}}" outside its declared `emitsLinkKinds` set [{{declaredKinds}}]. Link dropped.',
   extensionErrorIssueInvalidSeverity: `Rule "{{analyzerId}}" emitted an issue with invalid severity {{severity}} (allowed: 'error' | 'warn' | 'info'). Issue dropped.`,
-  extensionErrorContributionUnknownId: 'Extractor "{{extractorId}}" emitted contribution "{{contributionId}}" on {{nodePath}} but did not declare it in its `viewContributions` map. Contribution dropped.',
+  extensionErrorContributionUndeclaredRef: 'Extension "{{extractorId}}" emitted a view contribution on {{nodePath}} whose object is not one declared in its `ui` map (pass the declared const by reference, do not spread or inline it). Contribution dropped.',
   extensionErrorContributionPayloadInvalid: 'Extractor "{{extractorId}}" emitted contribution "{{contributionId}}" on {{nodePath}}; payload failed the "{{slot}}" schema: {{errors}}. Contribution dropped.',
   extensionErrorRecommendedActionMissing: 'Analyzer "{{analyzerId}}" declares recommendedAction "{{actionId}}" but no Action is registered under that qualified id. The analyzer stays registered; the recommendation will not surface in the inspector.',
   runScanRootEmptyArray: "runScan: roots must contain at least one path (spec requires minItems: 1)",
@@ -728,6 +808,7 @@ async function runExtractorsForNode(opts) {
   const externalLinks = [];
   const enrichmentBuffer = /* @__PURE__ */ new Map();
   const contributions = [];
+  const contributionErrors = [];
   const signals = [];
   const virtualNodes = [];
   const virtualNodePaths = /* @__PURE__ */ new Set();
@@ -759,36 +840,54 @@ async function runExtractorsForNode(opts) {
         });
       }
     };
-    const declaredContributions = readDeclaredContributions(extractor);
-    const emitContribution = (contributionId, payload) => {
-      const declared = declaredContributions.get(contributionId);
+    const declaredContributions = readDeclaredContributionRefs(extractor);
+    const emitContribution = (ref, payload) => {
+      const declared = typeof ref === "object" && ref !== null ? declaredContributions.get(ref) : void 0;
       if (!declared) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUndeclaredRef, {
+          extractorId: qualifiedId,
+          nodePath: opts.node.path
+        });
         emitExtensionError(opts.emitter, qualifiedId, opts.node.path, {
           phase: "emitContribution",
-          contributionId,
-          reason: "unknown-contribution-id",
-          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUnknownId, {
-            extractorId: qualifiedId,
-            contributionId,
-            nodePath: opts.node.path
-          })
+          reason: "undeclared-contribution-ref",
+          message
+        });
+        contributionErrors.push({
+          pluginId: extractor.pluginId,
+          extensionId: extractor.id,
+          nodePath: opts.node.path,
+          reason: "undeclared-contribution-ref",
+          message,
+          emittedAt: Date.now()
         });
         return;
       }
       const result = validators.validateContributionPayload(declared.slot, payload);
       if (!result.ok) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
+          extractorId: qualifiedId,
+          contributionId: declared.id,
+          nodePath: opts.node.path,
+          slot: declared.slot,
+          errors: result.errors
+        });
         emitExtensionError(opts.emitter, qualifiedId, opts.node.path, {
           phase: "emitContribution",
-          contributionId,
+          contributionId: declared.id,
           slot: declared.slot,
           reason: result.errors,
-          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
-            extractorId: qualifiedId,
-            contributionId,
-            nodePath: opts.node.path,
-            slot: declared.slot,
-            errors: result.errors
-          })
+          message
+        });
+        contributionErrors.push({
+          pluginId: extractor.pluginId,
+          extensionId: extractor.id,
+          nodePath: opts.node.path,
+          reason: result.errors,
+          message,
+          contributionId: declared.id,
+          slot: declared.slot,
+          emittedAt: Date.now()
         });
         return;
       }
@@ -796,7 +895,7 @@ async function runExtractorsForNode(opts) {
         pluginId: extractor.pluginId,
         extensionId: extractor.id,
         nodePath: opts.node.path,
-        contributionId,
+        contributionId: declared.id,
         slot: declared.slot,
         payload,
         emittedAt: Date.now()
@@ -834,11 +933,12 @@ async function runExtractorsForNode(opts) {
     externalLinks,
     enrichments: Array.from(enrichmentBuffer.values()),
     contributions,
+    contributionErrors,
     signals,
     virtualNodes
   };
 }
-function readDeclaredContributions(extension) {
+function readDeclaredContributionRefs(extension) {
   const out = /* @__PURE__ */ new Map();
   const raw = extension.ui;
   if (typeof raw !== "object" || raw === null) return out;
@@ -846,7 +946,7 @@ function readDeclaredContributions(extension) {
     if (typeof value !== "object" || value === null) continue;
     const slot = value.slot;
     if (typeof slot !== "string") continue;
-    out.set(id, { slot });
+    out.set(value, { id, slot });
   }
   return out;
 }
@@ -1094,6 +1194,7 @@ function isExternalUrlLink(link) {
 async function runAnalyzers(analyzers, nodes, internalLinks, orphanSidecars, sidecarRoots, annotationContributions, viewContributions, orphanJobFiles, referenceablePaths, cwd, registeredActionIds, emitter, hookDispatcher, reservedNodePaths, signals, seedIssues = []) {
   const issues = [...seedIssues];
   const contributions = [];
+  const contributionErrors = [];
   const validators = loadSchemaValidators();
   void registeredActionIds;
   const analyzerOrphans = orphanSidecars.map((o) => ({
@@ -1103,36 +1204,54 @@ async function runAnalyzers(analyzers, nodes, internalLinks, orphanSidecars, sid
   const scheduled = orderAnalyzersByPhase(analyzers);
   for (const analyzer of scheduled) {
     const qualifiedId = qualifiedExtensionId(analyzer.pluginId, analyzer.id);
-    const declaredContributions = readDeclaredContributions(analyzer);
-    const emitContribution = (nodePath, contributionId, payload) => {
-      const declared = declaredContributions.get(contributionId);
+    const declaredContributions = readDeclaredContributionRefs(analyzer);
+    const emitContribution = (nodePath, ref, payload) => {
+      const declared = typeof ref === "object" && ref !== null ? declaredContributions.get(ref) : void 0;
       if (!declared) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUndeclaredRef, {
+          extractorId: qualifiedId,
+          nodePath
+        });
         emitExtensionError(emitter, qualifiedId, nodePath, {
           phase: "emitContribution",
-          contributionId,
-          reason: "unknown-contribution-id",
-          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUnknownId, {
-            extractorId: qualifiedId,
-            contributionId,
-            nodePath
-          })
+          reason: "undeclared-contribution-ref",
+          message
+        });
+        contributionErrors.push({
+          pluginId: analyzer.pluginId,
+          extensionId: analyzer.id,
+          nodePath,
+          reason: "undeclared-contribution-ref",
+          message,
+          emittedAt: Date.now()
         });
         return;
       }
       const result = validators.validateContributionPayload(declared.slot, payload);
       if (!result.ok) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
+          extractorId: qualifiedId,
+          contributionId: declared.id,
+          nodePath,
+          slot: declared.slot,
+          errors: result.errors
+        });
         emitExtensionError(emitter, qualifiedId, nodePath, {
           phase: "emitContribution",
-          contributionId,
+          contributionId: declared.id,
           slot: declared.slot,
           reason: result.errors,
-          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
-            extractorId: qualifiedId,
-            contributionId,
-            nodePath,
-            slot: declared.slot,
-            errors: result.errors
-          })
+          message
+        });
+        contributionErrors.push({
+          pluginId: analyzer.pluginId,
+          extensionId: analyzer.id,
+          nodePath,
+          reason: result.errors,
+          message,
+          contributionId: declared.id,
+          slot: declared.slot,
+          emittedAt: Date.now()
         });
         return;
       }
@@ -1140,7 +1259,7 @@ async function runAnalyzers(analyzers, nodes, internalLinks, orphanSidecars, sid
         pluginId: analyzer.pluginId,
         extensionId: analyzer.id,
         nodePath,
-        contributionId,
+        contributionId: declared.id,
         slot: declared.slot,
         payload,
         emittedAt: Date.now()
@@ -1173,7 +1292,7 @@ async function runAnalyzers(analyzers, nodes, internalLinks, orphanSidecars, sid
     emitter.emit(evt);
     await hookDispatcher.dispatch("analyzer.completed", evt);
   }
-  return { issues, contributions };
+  return { issues, contributions, contributionErrors };
 }
 function orderAnalyzersByPhase(analyzers) {
   return analyzers.slice().sort((a, b) => phaseRank(a) - phaseRank(b));
@@ -2423,7 +2542,7 @@ function resolveSidecarOverlay(relativePath, nodePathForIssue, roots, liveBodyHa
     for (const parseIssue of result.issues) {
       issues.push({
         analyzerId: "invalid-sidecar",
-        severity: "warn",
+        severity: "error",
         nodeIds: [nodePathForIssue],
         message: parseIssue.message,
         data: { sidecarPath: relativePathFromRoots(mdAbs, roots) }
@@ -2589,6 +2708,7 @@ async function walkAndExtract(opts) {
     enrichments: [...accum.enrichmentBuffer.values()],
     extractorRuns: accum.extractorRuns,
     contributions: accum.contributionsBuffer,
+    contributionErrors: accum.contributionErrorsBuffer,
     freshlyRunTuples: accum.freshlyRunTuples,
     orphanSidecars,
     sidecarRoots: accum.sidecarRoots,
@@ -2605,6 +2725,7 @@ function createWalkAccumulators() {
     frontmatterIssues: [],
     enrichmentBuffer: /* @__PURE__ */ new Map(),
     contributionsBuffer: [],
+    contributionErrorsBuffer: [],
     freshlyRunTuples: /* @__PURE__ */ new Set(),
     extractorRuns: [],
     sidecarRoots: /* @__PURE__ */ new Map()
@@ -2755,7 +2876,11 @@ function mergeExtractResult(extractResult, accum) {
     accum.enrichmentBuffer.set(`${enr.nodePath}\0${enr.extractorId}`, enr);
   }
   for (const c of extractResult.contributions) accum.contributionsBuffer.push(c);
-  for (const vn of extractResult.virtualNodes) {
+  for (const e of extractResult.contributionErrors) accum.contributionErrorsBuffer.push(e);
+  mergeVirtualNodes(extractResult.virtualNodes, accum);
+}
+function mergeVirtualNodes(virtualNodes, accum) {
+  for (const vn of virtualNodes) {
     if (accum.nodes.some((n) => n.path === vn.path)) continue;
     accum.nodes.push(vn);
   }
@@ -3031,6 +3156,7 @@ async function dispatchExtractorCompleted(extractors, emitter, hookDispatcher) {
 }
 function mergeAnalyzerEmissions(walked, analyzerResult, analyzers) {
   for (const c of analyzerResult.contributions) walked.contributions.push(c);
+  for (const e of analyzerResult.contributionErrors) walked.contributionErrors.push(e);
   for (const analyzer of analyzers ?? []) {
     if (analyzer.ui === void 0) continue;
     for (const node of walked.nodes) {
@@ -3076,6 +3202,7 @@ function buildScanReturn(walked, issues, renameOps, stats, options, setup) {
     extractorRuns: walked.extractorRuns,
     enrichments: walked.enrichments,
     contributions: walked.contributions,
+    contributionErrors: walked.contributionErrors,
     freshlyRunTuples: walked.freshlyRunTuples
   };
 }
@@ -3505,4 +3632,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=77a22e54-0917-5b5e-a29d-af0ad20bed19
+//# debugId=5a40a4c9-3996-540c-b687-874d383944d0