@skill-map/cli 0.19.0 → 0.20.1

package/dist/index.js

@@ -28,7 +28,7 @@ function tx(template, vars = {}) {
 var EXTENSION_KINDS = Object.freeze([
   "provider",
   "extractor",
-  "rule",
+  "analyzer",
   "action",
   "formatter",
   "hook"
@@ -103,7 +103,7 @@ import yaml4 from "js-yaml";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.19.0",
+  version: "0.20.1",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -169,7 +169,7 @@ var package_default = {
   },
   dependencies: {
     "@hono/node-server": "2.0.1",
-    "@skill-map/spec": "0.19.0",
+    "@skill-map/spec": "0.20.0",
     ajv: "8.18.0",
     "ajv-formats": "3.0.1",
     chokidar: "5.0.0",
@@ -508,18 +508,20 @@ function formatAjvErrors(errors) {
 
 // kernel/extensions/hook.ts
 var HOOK_TRIGGERS = Object.freeze([
+  "boot",
   "scan.started",
   "scan.completed",
   "extractor.completed",
-  "rule.completed",
+  "analyzer.completed",
   "action.completed",
   "job.spawning",
   "job.completed",
-  "job.failed"
+  "job.failed",
+  "shutdown"
 ]);
 
 // kernel/adapters/plugin-loader.ts
-var KNOWN_KINDS = /* @__PURE__ */ new Set(["provider", "extractor", "rule", "action", "formatter", "hook"]);
+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(", ");
 function installedSpecVersion() {
@@ -549,7 +551,7 @@ var SCHEMA_FILES = {
   "history-stats": "schemas/history-stats.schema.json",
   "extension-provider": "schemas/extensions/provider.schema.json",
   "extension-extractor": "schemas/extensions/extractor.schema.json",
-  "extension-rule": "schemas/extensions/rule.schema.json",
+  "extension-analyzer": "schemas/extensions/analyzer.schema.json",
   "extension-action": "schemas/extensions/action.schema.json",
   "extension-formatter": "schemas/extensions/formatter.schema.json",
   "extension-hook": "schemas/extensions/hook.schema.json",
@@ -559,7 +561,7 @@ var SUPPORTING_SCHEMAS = [
   "schemas/extensions/base.schema.json",
   "schemas/frontmatter/base.schema.json",
   "schemas/summaries/security-scanner.schema.json",
-  "schemas/view-contracts.schema.json",
+  "schemas/view-slots.schema.json",
   "schemas/input-types.schema.json"
 ];
 var cachedValidators = null;
@@ -592,7 +594,7 @@ function buildSchemaValidators() {
   const extensionByKind = {
     provider: "extension-provider",
     extractor: "extension-extractor",
-    rule: "extension-rule",
+    analyzer: "extension-analyzer",
     action: "extension-action",
     formatter: "extension-formatter",
     hook: "extension-hook"
@@ -601,18 +603,35 @@ function buildSchemaValidators() {
     $ref: "https://skill-map.dev/spec/v0/plugins-registry.schema.json#/$defs/PluginManifest"
   });
   const contributionValidators = /* @__PURE__ */ new Map();
-  const VIEW_CONTRACTS_ID = "https://skill-map.dev/spec/v0/view-contracts.schema.json";
-  function getContributionValidator(contract) {
-    const existing = contributionValidators.get(contract);
+  const VIEW_SLOTS_ID = "https://skill-map.dev/spec/v0/view-slots.schema.json";
+  const KNOWN_SLOTS = /* @__PURE__ */ new Set([
+    "card.title.right",
+    "card.subtitle.left",
+    "card.footer.left.counter",
+    "card.footer.right",
+    "graph.node.alert",
+    "inspector.header.badge.counter",
+    "inspector.header.badge.tag",
+    "inspector.body.panel.breakdown",
+    "inspector.body.panel.records",
+    "inspector.body.panel.tree",
+    "inspector.body.panel.key-values",
+    "inspector.body.panel.link-list",
+    "inspector.body.panel.markdown",
+    "topbar.actions.indicator"
+  ]);
+  function getContributionValidator(slot) {
+    if (!KNOWN_SLOTS.has(slot)) return null;
+    const existing = contributionValidators.get(slot);
     if (existing) return existing;
-    const ref = `${VIEW_CONTRACTS_ID}#/$defs/payloads/${contract}`;
+    const ref = `${VIEW_SLOTS_ID}#/$defs/payloads/${slot}`;
     let compiled;
     try {
       compiled = ajv.compile({ $ref: ref });
     } catch {
       return null;
     }
-    contributionValidators.set(contract, compiled);
+    contributionValidators.set(slot, compiled);
     return compiled;
   }
   return {
@@ -636,10 +655,10 @@ function buildSchemaValidators() {
       const errors = (pluginManifestValidator.errors ?? []).map(formatError).join("; ");
       return { ok: false, errors };
     },
-    validateContributionPayload(contract, payload) {
-      const validator = getContributionValidator(contract);
+    validateContributionPayload(slot, payload) {
+      const validator = getContributionValidator(slot);
       if (!validator) {
-        return { ok: false, errors: "unknown-contract" };
+        return { ok: false, errors: "unknown-slot" };
       }
       if (validator(payload)) return { ok: true };
       const errors = (validator.errors ?? []).map(formatError).join("; ");
@@ -720,9 +739,9 @@ var ORCHESTRATOR_TEXTS = {
   frontmatterMalformedByteOrderMark: "Frontmatter fence in {{path}} is preceded by a UTF-8 byte-order mark (BOM); the file was scanned as body-only. Re-save the file as UTF-8 without BOM. The metadata block was silently lost.",
   frontmatterMalformedMissingClose: "Frontmatter in {{path}} opens with `---` but never closes \u2014 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 "{{ruleId}}" emitted an issue with invalid severity {{severity}} (allowed: 'error' | 'warn' | 'info'). Issue 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.',
-  extensionErrorContributionPayloadInvalid: 'Extractor "{{extractorId}}" emitted contribution "{{contributionId}}" on {{nodePath}}; payload failed the "{{contract}}" schema: {{errors}}. Contribution dropped.',
+  extensionErrorContributionPayloadInvalid: 'Extractor "{{extractorId}}" emitted contribution "{{contributionId}}" on {{nodePath}}; payload failed the "{{slot}}" schema: {{errors}}. Contribution dropped.',
   runScanRootEmptyArray: "runScan: roots must contain at least one path (spec requires minItems: 1)",
   runScanRootMissing: "runScan: root path '{{root}}' does not exist or is not a directory"
 };
@@ -789,7 +808,7 @@ function readDefaultsFromDisk() {
   return "";
 }
 
-// kernel/scan/parsers/frontmatter-yaml.ts
+// built-in-plugins/parsers/frontmatter-yaml/index.ts
 import yaml3 from "js-yaml";
 var FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/;
 var FORBIDDEN_FRONTMATTER_KEYS = /* @__PURE__ */ new Set(["__proto__", "constructor", "prototype"]);
@@ -815,7 +834,7 @@ var frontmatterYamlParser = {
   }
 };
 
-// kernel/scan/parsers/plain.ts
+// built-in-plugins/parsers/plain/index.ts
 var plainParser = {
   id: "plain",
   parse(raw, _path) {
@@ -916,6 +935,85 @@ function resolveProviderWalk(provider) {
   };
 }
 
+// kernel/extensions/hook-dispatcher.ts
+function makeHookDispatcher(hooks, emitter) {
+  if (hooks.length === 0) {
+    return { dispatch: async () => {
+    } };
+  }
+  const byTrigger = /* @__PURE__ */ new Map();
+  for (const hook of hooks) {
+    if (hook.mode === "probabilistic") {
+      const qualifiedId = qualifiedExtensionId(hook.pluginId, hook.id);
+      log.warn(
+        `Probabilistic hook ${qualifiedId} deferred to job subsystem (future job subsystem). The hook is registered but will not dispatch in-scan.`,
+        { hookId: qualifiedId, mode: "probabilistic" }
+      );
+      continue;
+    }
+    for (const trig of hook.triggers) {
+      const bucket = byTrigger.get(trig);
+      if (bucket) bucket.push(hook);
+      else byTrigger.set(trig, [hook]);
+    }
+  }
+  return {
+    async dispatch(trigger, event) {
+      const subs = byTrigger.get(trigger);
+      if (!subs || subs.length === 0) return;
+      for (const hook of subs) {
+        if (!matchesFilter(hook, event)) continue;
+        const ctx = buildHookContext(hook, trigger, event);
+        try {
+          await hook.on(ctx);
+        } catch (err) {
+          const qualifiedId = qualifiedExtensionId(hook.pluginId, hook.id);
+          const message = formatErrorMessage(err);
+          emitter.emit(
+            makeEvent("extension.error", {
+              kind: "hook-error",
+              extensionId: qualifiedId,
+              trigger,
+              message
+            })
+          );
+        }
+      }
+    }
+  };
+}
+function makeEvent(type, data) {
+  return { type, timestamp: (/* @__PURE__ */ new Date()).toISOString(), data };
+}
+function matchesFilter(hook, event) {
+  if (!hook.filter) return true;
+  const data = event.data ?? {};
+  for (const [key, expected] of Object.entries(hook.filter)) {
+    if (data[key] !== expected) return false;
+  }
+  return true;
+}
+function buildHookContext(_hook, trigger, event) {
+  const data = event.data ?? {};
+  const ctx = {
+    event: {
+      type: trigger,
+      timestamp: event.timestamp,
+      ...event.runId !== void 0 ? { runId: event.runId } : {},
+      ...event.jobId !== void 0 ? { jobId: event.jobId } : {},
+      data: event.data
+    }
+  };
+  if (typeof data["extractorId"] === "string") ctx.extractorId = data["extractorId"];
+  if (typeof data["analyzerId"] === "string") ctx.analyzerId = data["analyzerId"];
+  if (typeof data["actionId"] === "string") ctx.actionId = data["actionId"];
+  if (data["node"] && typeof data["node"] === "object") {
+    ctx.node = data["node"];
+  }
+  if (data["jobResult"] !== void 0) ctx.jobResult = data["jobResult"];
+  return ctx;
+}
+
 // kernel/orchestrator.ts
 var SCANNED_BY = {
   name: "skill-map",
@@ -941,7 +1039,7 @@ async function runScanInternal(_kernel, options) {
   const start = Date.now();
   const scannedAt = start;
   const emitter = options.emitter ?? new InMemoryProgressEmitter();
-  const exts = options.extensions ?? { providers: [], extractors: [], rules: [] };
+  const exts = options.extensions ?? { providers: [], extractors: [], analyzers: [] };
   const hookDispatcher = makeHookDispatcher(exts.hooks ?? [], emitter);
   const tokenize = options.tokenize !== false;
   const scope = options.scope ?? "project";
@@ -978,19 +1076,28 @@ async function runScanInternal(_kernel, options) {
     emitter.emit(evt);
     await hookDispatcher.dispatch("extractor.completed", evt);
   }
-  const ruleResult = await runRules(
-    exts.rules,
+  const analyzerResult = await runAnalyzers(
+    exts.analyzers,
     walked.nodes,
     walked.internalLinks,
     walked.orphanSidecars,
     walked.sidecarRoots,
     options.annotationContributions ?? [],
     options.viewContributions ?? [],
+    options.orphanJobFiles ?? [],
+    options.referenceablePaths,
+    options.cwd,
     emitter,
     hookDispatcher
   );
-  const issues = ruleResult.issues;
-  for (const c of ruleResult.contributions) walked.contributions.push(c);
+  const issues = analyzerResult.issues;
+  for (const c of analyzerResult.contributions) walked.contributions.push(c);
+  for (const analyzer of exts.analyzers ?? []) {
+    if (analyzer.viewContributions === void 0) continue;
+    for (const node of walked.nodes) {
+      walked.freshlyRunTuples.add(`${analyzer.pluginId}/${analyzer.id}/${node.path}`);
+    }
+  }
   for (const issue of walked.frontmatterIssues) issues.push(issue);
   const renameOps = prior ? detectRenamesAndOrphans(prior, walked.nodes, issues) : [];
   const stats = {
@@ -1025,7 +1132,8 @@ async function runScanInternal(_kernel, options) {
     renameOps,
     extractorRuns: walked.extractorRuns,
     enrichments: walked.enrichments,
-    contributions: walked.contributions
+    contributions: walked.contributions,
+    freshlyRunTuples: walked.freshlyRunTuples
   };
 }
 function validateRoots(roots) {
@@ -1057,7 +1165,7 @@ function indexPriorSnapshot(prior) {
     else priorLinksByOriginating.set(key, [link]);
   }
   for (const issue of prior.issues) {
-    if (issue.ruleId !== "frontmatter-invalid" && issue.ruleId !== "frontmatter-malformed") continue;
+    if (issue.analyzerId !== "frontmatter-invalid" && issue.analyzerId !== "frontmatter-malformed") continue;
     if (issue.nodeIds.length !== 1) continue;
     const path = issue.nodeIds[0];
     const list = priorFrontmatterIssuesByNode.get(path);
@@ -1115,18 +1223,18 @@ async function runExtractorsForNode(opts) {
         });
         return;
       }
-      const result = validators.validateContributionPayload(declared.contract, payload);
+      const result = validators.validateContributionPayload(declared.slot, payload);
       if (!result.ok) {
         emitExtensionError(opts.emitter, qualifiedId, opts.node.path, {
           phase: "emitContribution",
           contributionId,
-          contract: declared.contract,
+          slot: declared.slot,
           reason: result.errors,
           message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
             extractorId: qualifiedId,
             contributionId,
             nodePath: opts.node.path,
-            contract: declared.contract,
+            slot: declared.slot,
             errors: result.errors
           })
         });
@@ -1137,7 +1245,7 @@ async function runExtractorsForNode(opts) {
         extensionId: extractor.id,
         nodePath: opts.node.path,
         contributionId,
-        contract: declared.contract,
+        slot: declared.slot,
         payload,
         emittedAt: Date.now()
       });
@@ -1168,9 +1276,9 @@ function readDeclaredContributions(extension) {
   if (typeof raw !== "object" || raw === null) return out;
   for (const [id, value] of Object.entries(raw)) {
     if (typeof value !== "object" || value === null) continue;
-    const contract = value.contract;
-    if (typeof contract !== "string") continue;
-    out.set(id, { contract });
+    const slot = value.slot;
+    if (typeof slot !== "string") continue;
+    out.set(id, { slot });
   }
   return out;
 }
@@ -1307,6 +1415,7 @@ async function walkAndExtract(opts) {
   const frontmatterIssues = [];
   const enrichmentBuffer = /* @__PURE__ */ new Map();
   const contributionsBuffer = [];
+  const freshlyRunTuples = /* @__PURE__ */ new Set();
   const extractorRuns = [];
   const sidecarRoots = /* @__PURE__ */ new Map();
   let filesWalked = 0;
@@ -1425,6 +1534,9 @@ async function walkAndExtract(opts) {
         ...partialCacheHit ? { partialCache: true } : {}
       }));
       const extractorsToRun = partialCacheHit ? missingExtractors : applicableExtractors;
+      for (const ex of extractorsToRun) {
+        freshlyRunTuples.add(`${ex.pluginId}/${ex.id}/${node.path}`);
+      }
       const extractResult = await runExtractorsForNode({
         extractors: extractorsToRun,
         node,
@@ -1463,6 +1575,7 @@ async function walkAndExtract(opts) {
     enrichments: [...enrichmentBuffer.values()],
     extractorRuns,
     contributions: contributionsBuffer,
+    freshlyRunTuples,
     orphanSidecars,
     sidecarRoots
   };
@@ -1493,17 +1606,17 @@ function reuseCachedLink(link, shortIdToQualified, cachedQualifiedIds, applicabl
   if (obsoleteSources.length === 0) return link;
   return { ...link, sources: cachedSources };
 }
-async function runRules(rules, nodes, internalLinks, orphanSidecars, sidecarRoots, annotationContributions, viewContributions, emitter, hookDispatcher) {
+async function runAnalyzers(analyzers, nodes, internalLinks, orphanSidecars, sidecarRoots, annotationContributions, viewContributions, orphanJobFiles, referenceablePaths, cwd, emitter, hookDispatcher) {
   const issues = [];
   const contributions = [];
   const validators = loadSchemaValidators();
-  const ruleOrphans = orphanSidecars.map((o) => ({
+  const analyzerOrphans = orphanSidecars.map((o) => ({
     relativePath: o.relativePath,
     expectedMdPath: o.expectedMdPath
   }));
-  for (const rule of rules) {
-    const qualifiedId = qualifiedExtensionId(rule.pluginId, rule.id);
-    const declaredContributions = readDeclaredContributions(rule);
+  for (const analyzer of analyzers) {
+    const qualifiedId = qualifiedExtensionId(analyzer.pluginId, analyzer.id);
+    const declaredContributions = readDeclaredContributions(analyzer);
     const emitContribution = (nodePath, contributionId, payload) => {
       const declared = declaredContributions.get(contributionId);
       if (!declared) {
@@ -1519,49 +1632,52 @@ async function runRules(rules, nodes, internalLinks, orphanSidecars, sidecarRoot
         });
         return;
       }
-      const result = validators.validateContributionPayload(declared.contract, payload);
+      const result = validators.validateContributionPayload(declared.slot, payload);
       if (!result.ok) {
         emitExtensionError(emitter, qualifiedId, nodePath, {
           phase: "emitContribution",
           contributionId,
-          contract: declared.contract,
+          slot: declared.slot,
           reason: result.errors,
           message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
             extractorId: qualifiedId,
             contributionId,
             nodePath,
-            contract: declared.contract,
+            slot: declared.slot,
             errors: result.errors
           })
         });
         return;
       }
       contributions.push({
-        pluginId: rule.pluginId,
-        extensionId: rule.id,
+        pluginId: analyzer.pluginId,
+        extensionId: analyzer.id,
         nodePath,
         contributionId,
-        contract: declared.contract,
+        slot: declared.slot,
         payload,
         emittedAt: Date.now()
       });
     };
-    const emitted = await rule.evaluate({
+    const emitted = await analyzer.evaluate({
       nodes,
       links: internalLinks,
-      orphanSidecars: ruleOrphans,
+      orphanSidecars: analyzerOrphans,
       sidecarRoots,
       annotationContributions,
       viewContributions,
+      orphanJobFiles,
+      ...referenceablePaths ? { referenceablePaths } : {},
+      ...cwd ? { cwd } : {},
       emitContribution
     });
     for (const issue of emitted) {
-      const validated = validateIssue(rule, issue, emitter);
+      const validated = validateIssue(analyzer, issue, emitter);
       if (validated) issues.push(validated);
     }
-    const evt = makeEvent("rule.completed", { ruleId: qualifiedId });
+    const evt = makeEvent("analyzer.completed", { analyzerId: qualifiedId });
     emitter.emit(evt);
-    await hookDispatcher.dispatch("rule.completed", evt);
+    await hookDispatcher.dispatch("analyzer.completed", evt);
   }
   return { issues, contributions };
 }
@@ -1617,7 +1733,7 @@ function claimSingletonRenames(opts) {
       const fromPath = remaining[0];
       ops.push({ from: fromPath, to: toPath, confidence: "medium" });
       opts.issues.push({
-        ruleId: "auto-rename-medium",
+        analyzerId: "auto-rename-medium",
         severity: "warn",
         nodeIds: [toPath],
         message: `Auto-rename (medium confidence): ${fromPath} \u2192 ${toPath}`,
@@ -1637,7 +1753,7 @@ function flagAmbiguousRenames(opts) {
     const remaining = candidates.filter((p) => !opts.claimedDeleted.has(p));
     if (remaining.length > 1) {
       opts.issues.push({
-        ruleId: "auto-rename-ambiguous",
+        analyzerId: "auto-rename-ambiguous",
         severity: "warn",
         nodeIds: [toPath],
         message: `Auto-rename ambiguous: ${toPath} matches ${remaining.length} prior frontmatters \u2014 pick one with \`sm orphans undo-rename ${toPath} --from <old.path>\`.`,
@@ -1650,7 +1766,7 @@ function flagOrphans(opts) {
   for (const fromPath of opts.deletedPaths) {
     if (opts.claimedDeleted.has(fromPath)) continue;
     opts.issues.push({
-      ruleId: "orphan",
+      analyzerId: "orphan",
       severity: "info",
       nodeIds: [fromPath],
       message: `Orphan history: ${fromPath} was deleted; no rename match found.`,
@@ -1699,83 +1815,6 @@ var EXTERNAL_URL_SCHEME_RE = /^[a-z][a-z0-9+\-.]+:/i;
 function isExternalUrlLink(link) {
   return EXTERNAL_URL_SCHEME_RE.test(link.target);
 }
-function makeEvent(type, data) {
-  return { type, timestamp: (/* @__PURE__ */ new Date()).toISOString(), data };
-}
-function makeHookDispatcher(hooks, emitter) {
-  if (hooks.length === 0) {
-    return { dispatch: async () => {
-    } };
-  }
-  const byTrigger = /* @__PURE__ */ new Map();
-  for (const hook of hooks) {
-    if (hook.mode === "probabilistic") {
-      const qualifiedId = qualifiedExtensionId(hook.pluginId, hook.id);
-      log.warn(
-        `Probabilistic hook ${qualifiedId} deferred to job subsystem (future job subsystem). The hook is registered but will not dispatch in-scan.`,
-        { hookId: qualifiedId, mode: "probabilistic" }
-      );
-      continue;
-    }
-    for (const trig of hook.triggers) {
-      const bucket = byTrigger.get(trig);
-      if (bucket) bucket.push(hook);
-      else byTrigger.set(trig, [hook]);
-    }
-  }
-  return {
-    async dispatch(trigger, event) {
-      const subs = byTrigger.get(trigger);
-      if (!subs || subs.length === 0) return;
-      for (const hook of subs) {
-        if (!matchesFilter(hook, event)) continue;
-        const ctx = buildHookContext(hook, trigger, event);
-        try {
-          await hook.on(ctx);
-        } catch (err) {
-          const qualifiedId = qualifiedExtensionId(hook.pluginId, hook.id);
-          const message = formatErrorMessage(err);
-          emitter.emit(
-            makeEvent("extension.error", {
-              kind: "hook-error",
-              extensionId: qualifiedId,
-              trigger,
-              message
-            })
-          );
-        }
-      }
-    }
-  };
-}
-function matchesFilter(hook, event) {
-  if (!hook.filter) return true;
-  const data = event.data ?? {};
-  for (const [key, expected] of Object.entries(hook.filter)) {
-    if (data[key] !== expected) return false;
-  }
-  return true;
-}
-function buildHookContext(_hook, trigger, event) {
-  const data = event.data ?? {};
-  const ctx = {
-    event: {
-      type: trigger,
-      timestamp: event.timestamp,
-      ...event.runId !== void 0 ? { runId: event.runId } : {},
-      ...event.jobId !== void 0 ? { jobId: event.jobId } : {},
-      data: event.data
-    }
-  };
-  if (typeof data["extractorId"] === "string") ctx.extractorId = data["extractorId"];
-  if (typeof data["ruleId"] === "string") ctx.ruleId = data["ruleId"];
-  if (typeof data["actionId"] === "string") ctx.actionId = data["actionId"];
-  if (data["node"] && typeof data["node"] === "object") {
-    ctx.node = data["node"];
-  }
-  if (data["jobResult"] !== void 0) ctx.jobResult = data["jobResult"];
-  return ctx;
-}
 function buildNode(args) {
   const bytesFrontmatter = Buffer.byteLength(args.frontmatterRaw, "utf8");
   const bytesBody = Buffer.byteLength(args.body, "utf8");
@@ -1837,7 +1876,7 @@ function resolveAndApplySidecar(node, relativePath, roots, liveBodyHash, liveFro
     node.sidecar = { present: true, status: null, annotations: null, root: null };
     for (const parseIssue of result.issues) {
       issues.push({
-        ruleId: "invalid-sidecar",
+        analyzerId: "invalid-sidecar",
         severity: "warn",
         nodeIds: [node.path],
         message: parseIssue.message,
@@ -1918,7 +1957,7 @@ function validateFrontmatter(providerFrontmatter, provider, kind, frontmatter, p
   const result = providerFrontmatter.validate(provider, kind, frontmatter);
   if (result.ok) return null;
   return {
-    ruleId: "frontmatter-invalid",
+    analyzerId: "frontmatter-invalid",
     severity: strict ? "error" : "warn",
     nodeIds: [path],
     message: tx(ORCHESTRATOR_TEXTS.frontmatterInvalid, { path, kind, errors: result.errors }),
@@ -1929,7 +1968,7 @@ function detectMalformedFrontmatter(body, path, strict) {
   const hint = classifyMalformedFrontmatter(body);
   if (!hint) return null;
   return {
-    ruleId: "frontmatter-malformed",
+    analyzerId: "frontmatter-malformed",
     severity: strict ? "error" : "warn",
     nodeIds: [path],
     message: malformedMessage(hint, path),
@@ -1963,25 +2002,25 @@ function malformedMessage(hint, path) {
       return tx(ORCHESTRATOR_TEXTS.frontmatterMalformedMissingClose, { path });
   }
 }
-function validateIssue(rule, issue, emitter) {
+function validateIssue(analyzer, issue, emitter) {
   const severity = issue.severity;
   if (severity !== "error" && severity !== "warn" && severity !== "info") {
-    const qualifiedId = `${rule.pluginId}/${rule.id}`;
+    const qualifiedId = `${analyzer.pluginId}/${analyzer.id}`;
     emitter.emit(
       makeEvent("extension.error", {
         kind: "issue-invalid-severity",
         extensionId: qualifiedId,
         severity,
-        issue: { ruleId: issue.ruleId || rule.id, message: issue.message, nodeIds: issue.nodeIds },
+        issue: { analyzerId: issue.analyzerId || analyzer.id, message: issue.message, nodeIds: issue.nodeIds },
         message: tx(ORCHESTRATOR_TEXTS.extensionErrorIssueInvalidSeverity, {
-          ruleId: qualifiedId,
+          analyzerId: qualifiedId,
           severity: JSON.stringify(severity)
         })
       })
     );
     return null;
   }
-  return { ...issue, ruleId: issue.ruleId || rule.id };
+  return { ...issue, analyzerId: issue.analyzerId || analyzer.id };
 }
 function recomputeLinkCounts(nodes, links) {
   const byPath2 = /* @__PURE__ */ new Map();
@@ -2218,10 +2257,10 @@ function diffIssues(priorIssues, currentIssues) {
 }
 function issueIdentity(issue) {
   const ids = [...issue.nodeIds].sort().join(",");
-  return `${issue.ruleId}\0${ids}\0${issue.message}`;
+  return `${issue.analyzerId}\0${ids}\0${issue.message}`;
 }
 function byIssueSort(a, b) {
-  if (a.ruleId !== b.ruleId) return a.ruleId.localeCompare(b.ruleId);
+  if (a.analyzerId !== b.analyzerId) return a.analyzerId.localeCompare(b.analyzerId);
   return a.message.localeCompare(b.message);
 }
 
@@ -2416,6 +2455,8 @@ export {
   log,
   logLevelRank,
   makeDedicatedStoreWrapper,
+  makeEvent,
+  makeHookDispatcher,
   makeKvStoreWrapper,
   makePluginStore,
   mergeNodeWithEnrichments,