@skill-map/cli 0.18.0 → 0.19.0

package/dist/index.d.ts

@@ -1 +1 @@
-export { Confidence, DuplicateExtensionError, EXTENSION_KINDS, ExecutionFailureReason, ExecutionKind, ExecutionRecord, ExecutionRunner, ExecutionStatus, ExportQueryError, Extension, ExtensionKind, FilesystemPort, HOOK_TRIGGERS, HistoryStats, HistoryStatsErrorRates, HistoryStatsExecutionsPerPeriod, HistoryStatsPerActionRate, HistoryStatsTokensPerAction, HistoryStatsTopNode, HistoryStatsTotals, IAction, IActionContext, IActionPrecondition, IActionResult, IAnnotationContribution, ICreateFsWatcherOptions, IDedicatedStorePersist, IDedicatedStoreWrapper, IDiscoveredPlugin, IEnrichmentRecord, IExportQuery, IExportSubset, IExtensionBase, IExtractor, IExtractorCallbacks, IExtractorContext, IExtractorRunRecord, IFormatter, IFormatterContext, IFsWatcher, IHook, IHookContext, IIssueRow, IKvStorePersist, IKvStoreWrapper, ILoadedExtension, INodeBundle, INodeChange, INodeCounts, INodeFilter, IPersistOptions, IPersistedEnrichment, IPluginManifest, IPluginStorageSchema, IPluginStore, IProvider, IRawNode, IRegisteredAnnotationKey, IRule, IRuleContext, IRunOptions, IRunResult, IScanDelta, ITransactionalStorage, IWalkOptions, IWatchBatch, IWatchEvent, InMemoryProgressEmitter, Issue, IssueFix, KV_SCHEMA_KEY, Kernel, LOG_LEVELS, Link, LinkKind, LinkLocation, LinkTrigger, LogRecord, LoggerPort, Node, NodeKind, NodeStat, PluginLoaderPort, ProgressEmitterPort, ProgressEvent, Registry, RenameOp, RunScanOptions, RunnerPort, ScanResult, ScanScannedBy, ScanStats, Severity, SilentLogger, Stability, StoragePort, TActionWrite, TExecutionMode, TGranularity, THookFilter, THookTrigger, TLogLevel, TLogMethodLevel, TNodeChangeReason, TPluginLoadStatus, TPluginStorage, TProgressListener, TWatchEventKind, TripleSplit, applyExportQuery, computeScanDelta, configureLogger, createChokidarWatcher, createKernel, detectRenamesAndOrphans, getActiveLogger, isEmptyDelta, isLogLevel, log, logLevelRank, makeDedicatedStoreWrapper, makeKvStoreWrapper, makePluginStore, mergeNodeWithEnrichments, parseExportQuery, parseLogLevel, qualifiedExtensionId, resetLogger, runExtractorsForNode, runScan, runScanWithRenames } from './kernel/index.js';
+export { Confidence, DuplicateExtensionError, EXTENSION_KINDS, ExecutionFailureReason, ExecutionKind, ExecutionRecord, ExecutionRunner, ExecutionStatus, ExportQueryError, Extension, ExtensionKind, FilesystemPort, HOOK_TRIGGERS, HistoryStats, HistoryStatsErrorRates, HistoryStatsExecutionsPerPeriod, HistoryStatsPerActionRate, HistoryStatsTokensPerAction, HistoryStatsTopNode, HistoryStatsTotals, IAction, IActionContext, IActionPrecondition, IActionResult, IAnnotationContribution, ICreateFsWatcherOptions, IDedicatedStorePersist, IDedicatedStoreWrapper, IDiscoveredPlugin, IEnrichmentRecord, IExportQuery, IExportSubset, IExtensionBase, IExtractor, IExtractorCallbacks, IExtractorContext, IExtractorRunRecord, IFormatter, IFormatterContext, IFsWatcher, IHook, IHookContext, IIssueRow, IKvStorePersist, IKvStoreWrapper, ILoadedExtension, INodeBundle, INodeChange, INodeCounts, INodeFilter, IPersistOptions, IPersistedEnrichment, IPluginManifest, IPluginStorageSchema, IPluginStore, IProvider, IRawNode, IRegisteredAnnotationKey, IRegisteredViewContribution, IRule, IRuleContext, IRunOptions, IRunResult, IScanDelta, ISettingDeclaration, ITransactionalStorage, IViewContribution, IWalkOptions, IWatchBatch, IWatchEvent, InMemoryProgressEmitter, Issue, IssueFix, KV_SCHEMA_KEY, Kernel, LOG_LEVELS, Link, LinkKind, LinkLocation, LinkTrigger, LogRecord, LoggerPort, Node, NodeKind, NodeStat, PluginLoaderPort, ProgressEmitterPort, ProgressEvent, Registry, RenameOp, RunScanOptions, RunnerPort, ScanResult, ScanScannedBy, ScanStats, Severity, SilentLogger, Stability, StoragePort, TActionWrite, TContractName, TExecutionMode, TGranularity, THookFilter, THookTrigger, TInputTypeName, TLogLevel, TLogMethodLevel, TNodeChangeReason, TPluginLoadStatus, TPluginStorage, TProgressListener, TSettingValue, TSeverity, TWatchEventKind, TripleSplit, applyExportQuery, computeScanDelta, configureLogger, createChokidarWatcher, createKernel, detectRenamesAndOrphans, getActiveLogger, isEmptyDelta, isLogLevel, log, logLevelRank, makeDedicatedStoreWrapper, makeKvStoreWrapper, makePluginStore, mergeNodeWithEnrichments, parseExportQuery, parseLogLevel, qualifiedExtensionId, resetLogger, runExtractorsForNode, runScan, runScanWithRenames } from './kernel/index.js';

package/dist/index.js

@@ -103,7 +103,7 @@ import yaml4 from "js-yaml";
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.18.0",
+  version: "0.19.0",
   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.18.0",
+    "@skill-map/spec": "0.19.0",
     ajv: "8.18.0",
     "ajv-formats": "3.0.1",
     chokidar: "5.0.0",
@@ -263,15 +263,15 @@ function readSidecarFor(mdAbsolutePath) {
     };
   }
   const root = parsedYaml;
-  const forBlock = root["for"];
+  const identityBlock = root["identity"];
   const annotationsRaw = root["annotations"];
   const annotations = isPlainObject(annotationsRaw) ? Object.keys(annotationsRaw).length === 0 ? null : annotationsRaw : null;
   return {
     parsed: {
       filePath: sidecarPath,
-      forBodyHash: String(forBlock["bodyHash"]),
-      forFrontmatterHash: String(forBlock["frontmatterHash"]),
-      forPath: String(forBlock["path"]),
+      identityBodyHash: String(identityBlock["bodyHash"]),
+      identityFrontmatterHash: String(identityBlock["frontmatterHash"]),
+      identityPath: String(identityBlock["path"]),
       annotations,
       raw: root
     },
@@ -535,6 +535,118 @@ import { readFileSync as readFileSync4 } from "fs";
 import { dirname as dirname3, resolve as resolve4 } from "path";
 import { createRequire as createRequire4 } from "module";
 import { Ajv2020 as Ajv20204 } from "ajv/dist/2020.js";
+var SCHEMA_FILES = {
+  node: "schemas/node.schema.json",
+  link: "schemas/link.schema.json",
+  issue: "schemas/issue.schema.json",
+  "scan-result": "schemas/scan-result.schema.json",
+  "execution-record": "schemas/execution-record.schema.json",
+  "project-config": "schemas/project-config.schema.json",
+  "plugins-registry": "schemas/plugins-registry.schema.json",
+  job: "schemas/job.schema.json",
+  "report-base": "schemas/report-base.schema.json",
+  "conformance-case": "schemas/conformance-case.schema.json",
+  "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-action": "schemas/extensions/action.schema.json",
+  "extension-formatter": "schemas/extensions/formatter.schema.json",
+  "extension-hook": "schemas/extensions/hook.schema.json",
+  "frontmatter-base": "schemas/frontmatter/base.schema.json"
+};
+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/input-types.schema.json"
+];
+var cachedValidators = null;
+function loadSchemaValidators() {
+  if (cachedValidators !== null) return cachedValidators;
+  cachedValidators = buildSchemaValidators();
+  return cachedValidators;
+}
+function buildSchemaValidators() {
+  const specRoot = resolveSpecRoot2();
+  const ajv = new Ajv20204({
+    strict: false,
+    allErrors: true,
+    allowUnionTypes: true
+  });
+  applyAjvFormats(ajv);
+  for (const rel of SUPPORTING_SCHEMAS) {
+    const file = resolve4(specRoot, rel);
+    if (!existsSyncSafe(file)) continue;
+    const schema = JSON.parse(readFileSync4(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 byId = typeof schema.$id === "string" ? ajv.getSchema(schema.$id) : void 0;
+    validators.set(name, byId ?? ajv.compile(schema));
+  }
+  const extensionByKind = {
+    provider: "extension-provider",
+    extractor: "extension-extractor",
+    rule: "extension-rule",
+    action: "extension-action",
+    formatter: "extension-formatter",
+    hook: "extension-hook"
+  };
+  const pluginManifestValidator = ajv.compile({
+    $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);
+    if (existing) return existing;
+    const ref = `${VIEW_CONTRACTS_ID}#/$defs/payloads/${contract}`;
+    let compiled;
+    try {
+      compiled = ajv.compile({ $ref: ref });
+    } catch {
+      return null;
+    }
+    contributionValidators.set(contract, compiled);
+    return compiled;
+  }
+  return {
+    getValidator(name) {
+      const v = validators.get(name);
+      if (!v) throw new Error(`Unknown schema: ${name}`);
+      return v;
+    },
+    validatorForExtension(kind) {
+      return validators.get(extensionByKind[kind]);
+    },
+    validate(name, data) {
+      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("; ");
+      return { ok: false, errors };
+    },
+    validatePluginManifest(data) {
+      if (pluginManifestValidator(data)) return { ok: true, data };
+      const errors = (pluginManifestValidator.errors ?? []).map(formatError).join("; ");
+      return { ok: false, errors };
+    },
+    validateContributionPayload(contract, payload) {
+      const validator = getContributionValidator(contract);
+      if (!validator) {
+        return { ok: false, errors: "unknown-contract" };
+      }
+      if (validator(payload)) return { ok: true };
+      const errors = (validator.errors ?? []).map(formatError).join("; ");
+      return { ok: false, errors };
+    }
+  };
+}
 function buildProviderFrontmatterValidator(providers) {
   const specRoot = resolveSpecRoot2();
   const ajv = new Ajv20204({
@@ -592,6 +704,14 @@ function resolveSpecRoot2() {
     );
   }
 }
+function existsSyncSafe(path) {
+  try {
+    readFileSync4(path, "utf8");
+    return true;
+  } catch {
+    return false;
+  }
+}
 
 // kernel/i18n/orchestrator.texts.ts
 var ORCHESTRATOR_TEXTS = {
@@ -601,6 +721,8 @@ var ORCHESTRATOR_TEXTS = {
   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.`,
+  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.',
   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"
 };
@@ -856,16 +978,19 @@ async function runScanInternal(_kernel, options) {
     emitter.emit(evt);
     await hookDispatcher.dispatch("extractor.completed", evt);
   }
-  const issues = await runRules(
+  const ruleResult = await runRules(
     exts.rules,
     walked.nodes,
     walked.internalLinks,
     walked.orphanSidecars,
     walked.sidecarRoots,
     options.annotationContributions ?? [],
+    options.viewContributions ?? [],
     emitter,
     hookDispatcher
   );
+  const issues = ruleResult.issues;
+  for (const c of ruleResult.contributions) walked.contributions.push(c);
   for (const issue of walked.frontmatterIssues) issues.push(issue);
   const renameOps = prior ? detectRenamesAndOrphans(prior, walked.nodes, issues) : [];
   const stats = {
@@ -899,7 +1024,8 @@ async function runScanInternal(_kernel, options) {
     },
     renameOps,
     extractorRuns: walked.extractorRuns,
-    enrichments: walked.enrichments
+    enrichments: walked.enrichments,
+    contributions: walked.contributions
   };
 }
 function validateRoots(roots) {
@@ -944,9 +1070,10 @@ async function runExtractorsForNode(opts) {
   const internalLinks = [];
   const externalLinks = [];
   const enrichmentBuffer = /* @__PURE__ */ new Map();
+  const contributions = [];
+  const validators = loadSchemaValidators();
   for (const extractor of opts.extractors) {
     const qualifiedId = qualifiedExtensionId(extractor.pluginId, extractor.id);
-    const isProb = extractor.mode === "probabilistic";
     const emitLink = (link) => {
       const validated = validateLink(extractor, link, opts.emitter);
       if (!validated) return;
@@ -966,10 +1093,55 @@ async function runExtractorsForNode(opts) {
           bodyHashAtEnrichment: opts.bodyHash,
           value: { ...partial },
           enrichedAt: Date.now(),
-          isProbabilistic: isProb
+          // Extractors are deterministic-only; `is_probabilistic` is
+          // reserved on the row for future Action-issued enrichments.
+          isProbabilistic: false
         });
       }
     };
+    const declaredContributions = readDeclaredContributions(extractor);
+    const emitContribution = (contributionId, payload) => {
+      const declared = declaredContributions.get(contributionId);
+      if (!declared) {
+        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
+          })
+        });
+        return;
+      }
+      const result = validators.validateContributionPayload(declared.contract, payload);
+      if (!result.ok) {
+        emitExtensionError(opts.emitter, qualifiedId, opts.node.path, {
+          phase: "emitContribution",
+          contributionId,
+          contract: declared.contract,
+          reason: result.errors,
+          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
+            extractorId: qualifiedId,
+            contributionId,
+            nodePath: opts.node.path,
+            contract: declared.contract,
+            errors: result.errors
+          })
+        });
+        return;
+      }
+      contributions.push({
+        pluginId: extractor.pluginId,
+        extensionId: extractor.id,
+        nodePath: opts.node.path,
+        contributionId,
+        contract: declared.contract,
+        payload,
+        emittedAt: Date.now()
+      });
+    };
     const store = opts.pluginStores?.get(extractor.pluginId);
     const ctx = buildExtractorContext(
       extractor,
@@ -978,6 +1150,7 @@ async function runExtractorsForNode(opts) {
       opts.frontmatter,
       emitLink,
       enrichNode,
+      emitContribution,
       store
     );
     await extractor.extract(ctx);
@@ -985,9 +1158,32 @@ async function runExtractorsForNode(opts) {
   return {
     internalLinks,
     externalLinks,
-    enrichments: Array.from(enrichmentBuffer.values())
+    enrichments: Array.from(enrichmentBuffer.values()),
+    contributions
   };
 }
+function readDeclaredContributions(extension) {
+  const out = /* @__PURE__ */ new Map();
+  const raw = extension.viewContributions;
+  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 });
+  }
+  return out;
+}
+function emitExtensionError(emitter, qualifiedId, nodePath, data) {
+  emitter.emit(
+    makeEvent("extension.error", {
+      kind: "contribution-rejected",
+      extensionId: qualifiedId,
+      nodePath,
+      ...data
+    })
+  );
+}
 function computeCacheDecision(opts) {
   const applicableExtractors = opts.extractors.filter(
     (ex) => ex.applicableKinds === void 0 || ex.applicableKinds.includes(opts.kind)
@@ -1110,6 +1306,7 @@ async function walkAndExtract(opts) {
   const cachedPaths = /* @__PURE__ */ new Set();
   const frontmatterIssues = [];
   const enrichmentBuffer = /* @__PURE__ */ new Map();
+  const contributionsBuffer = [];
   const extractorRuns = [];
   const sidecarRoots = /* @__PURE__ */ new Map();
   let filesWalked = 0;
@@ -1122,9 +1319,11 @@ async function walkAndExtract(opts) {
     if (list) list.push(qualified);
     else shortIdToQualified.set(ex.id, [qualified]);
   }
+  const claimedPaths = /* @__PURE__ */ new Set();
   for (const provider of providers) {
     for await (const raw of resolveProviderWalk(provider)(roots, walkOptions)) {
       filesWalked += 1;
+      if (claimedPaths.has(raw.path)) continue;
       const bodyHash = sha256(raw.body);
       const frontmatterHash = sha256(canonicalFrontmatter(raw.frontmatter, raw.frontmatterRaw));
       const priorNode = priorNodesByPath.get(raw.path);
@@ -1133,6 +1332,7 @@ async function walkAndExtract(opts) {
       if (kind === null) {
         continue;
       }
+      claimedPaths.add(raw.path);
       index += 1;
       const cacheDecision = computeCacheDecision({
         extractors,
@@ -1160,8 +1360,6 @@ async function walkAndExtract(opts) {
           priorLinksByOriginating,
           priorFrontmatterIssuesByNode
         });
-        reused.node.stability = null;
-        reused.node.version = null;
         const reusedSidecarIssues = resolveAndApplySidecar(
           reused.node,
           raw.path,
@@ -1241,6 +1439,7 @@ async function walkAndExtract(opts) {
       for (const enr of extractResult.enrichments) {
         enrichmentBuffer.set(`${enr.nodePath}\0${enr.extractorId}`, enr);
       }
+      for (const c of extractResult.contributions) contributionsBuffer.push(c);
       const ranAt = Date.now();
       for (const ex of applicableExtractors) {
         const qualified = qualifiedExtensionId(ex.pluginId, ex.id);
@@ -1263,6 +1462,7 @@ async function walkAndExtract(opts) {
     filesWalked,
     enrichments: [...enrichmentBuffer.values()],
     extractorRuns,
+    contributions: contributionsBuffer,
     orphanSidecars,
     sidecarRoots
   };
@@ -1293,30 +1493,77 @@ 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, emitter, hookDispatcher) {
+async function runRules(rules, nodes, internalLinks, orphanSidecars, sidecarRoots, annotationContributions, viewContributions, emitter, hookDispatcher) {
   const issues = [];
+  const contributions = [];
+  const validators = loadSchemaValidators();
   const ruleOrphans = 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);
+    const emitContribution = (nodePath, contributionId, payload) => {
+      const declared = declaredContributions.get(contributionId);
+      if (!declared) {
+        emitExtensionError(emitter, qualifiedId, nodePath, {
+          phase: "emitContribution",
+          contributionId,
+          reason: "unknown-contribution-id",
+          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUnknownId, {
+            extractorId: qualifiedId,
+            contributionId,
+            nodePath
+          })
+        });
+        return;
+      }
+      const result = validators.validateContributionPayload(declared.contract, payload);
+      if (!result.ok) {
+        emitExtensionError(emitter, qualifiedId, nodePath, {
+          phase: "emitContribution",
+          contributionId,
+          contract: declared.contract,
+          reason: result.errors,
+          message: tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
+            extractorId: qualifiedId,
+            contributionId,
+            nodePath,
+            contract: declared.contract,
+            errors: result.errors
+          })
+        });
+        return;
+      }
+      contributions.push({
+        pluginId: rule.pluginId,
+        extensionId: rule.id,
+        nodePath,
+        contributionId,
+        contract: declared.contract,
+        payload,
+        emittedAt: Date.now()
+      });
+    };
     const emitted = await rule.evaluate({
       nodes,
       links: internalLinks,
       orphanSidecars: ruleOrphans,
       sidecarRoots,
-      annotationContributions
+      annotationContributions,
+      viewContributions,
+      emitContribution
     });
     for (const issue of emitted) {
       const validated = validateIssue(rule, issue, emitter);
       if (validated) issues.push(validated);
     }
-    const ruleId = qualifiedExtensionId(rule.pluginId, rule.id);
-    const evt = makeEvent("rule.completed", { ruleId });
+    const evt = makeEvent("rule.completed", { ruleId: qualifiedId });
     emitter.emit(evt);
     await hookDispatcher.dispatch("rule.completed", evt);
   }
-  return issues;
+  return { issues, contributions };
 }
 function originatingNodeOf(link, priorNodePaths) {
   if (link.kind === "supersedes" && !priorNodePaths.has(link.source)) {
@@ -1546,11 +1793,7 @@ function buildNode(args) {
     linksOutCount: 0,
     linksInCount: 0,
     externalRefsCount: 0,
-    frontmatter: args.frontmatter,
-    title: pickString(args.frontmatter["name"]),
-    description: pickString(args.frontmatter["description"]),
-    stability: null,
-    version: null
+    frontmatter: args.frontmatter
   };
   if (args.encoder) {
     node.tokens = countTokens(args.encoder, args.frontmatterRaw, args.body);
@@ -1604,12 +1847,11 @@ function resolveAndApplySidecar(node, relativePath, roots, liveBodyHash, liveFro
     return issues;
   }
   const status = computeDriftStatus({
-    storedBodyHash: result.parsed.forBodyHash,
-    storedFrontmatterHash: result.parsed.forFrontmatterHash,
+    storedBodyHash: result.parsed.identityBodyHash,
+    storedFrontmatterHash: result.parsed.identityFrontmatterHash,
     liveBodyHash,
     liveFrontmatterHash
   });
-  applyAnnotationsOverlay(node, result.parsed);
   node.sidecar = {
     present: true,
     status,
@@ -1619,18 +1861,6 @@ function resolveAndApplySidecar(node, relativePath, roots, liveBodyHash, liveFro
   sidecarRoots.set(node.path, result.parsed.raw);
   return issues;
 }
-function applyAnnotationsOverlay(node, parsed) {
-  const annotations = parsed.annotations;
-  if (annotations === null) return;
-  const stability = annotations["stability"];
-  if (stability === "experimental" || stability === "stable" || stability === "deprecated") {
-    node.stability = stability;
-  }
-  const version = annotations["version"];
-  if (typeof version === "number" && Number.isInteger(version) && version >= 1) {
-    node.version = version;
-  }
-}
 function resolveAbsoluteMdPath(relativePath, roots) {
   if (isAbsolute2(relativePath)) {
     return existsSync6(relativePath) ? relativePath : null;
@@ -1650,10 +1880,7 @@ function relativePathFromRoots(absolutePath, roots) {
   }
   return absolutePath;
 }
-function pickString(value) {
-  return typeof value === "string" && value.length > 0 ? value : null;
-}
-function buildExtractorContext(extractor, node, body, frontmatter, emitLink, enrichNode, store) {
+function buildExtractorContext(extractor, node, body, frontmatter, emitLink, enrichNode, emitContribution, store) {
   const scope = extractor.scope;
   return {
     node,
@@ -1661,6 +1888,7 @@ function buildExtractorContext(extractor, node, body, frontmatter, emitLink, enr
     frontmatter: scope === "body" ? {} : frontmatter,
     emitLink,
     enrichNode,
+    emitContribution,
     ...store !== void 0 ? { store } : {}
   };
 }
@@ -2149,6 +2377,7 @@ function parseLogLevel(value) {
 // kernel/index.ts
 function createKernel() {
   let annotationKeys = Object.freeze([]);
+  let viewContributions = Object.freeze([]);
   return {
     registry: new Registry(),
     getRegisteredAnnotationKeys() {
@@ -2156,6 +2385,12 @@ function createKernel() {
     },
     setRegisteredAnnotationKeys(entries) {
       annotationKeys = Object.freeze([...entries]);
+    },
+    getRegisteredViewContributions() {
+      return viewContributions;
+    },
+    setRegisteredViewContributions(entries) {
+      viewContributions = Object.freeze([...entries]);
     }
   };
 }