@skill-map/cli 0.57.0 → 0.58.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 // cli/entry.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]="e6038423-ea97-5e66-b371-0916d382d819")}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]="7e4fdbab-f037-5030-b67a-732bb7ee46fd")}catch(e){}}();
 import { existsSync as existsSync33 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -250,7 +250,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.57.0",
+  version: "0.58.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -1442,71 +1442,12 @@ var coreMarkdownProvider = {
   }
 };
 
-// plugins/core/extractors/annotations/index.ts
-var ID4 = "annotations";
-var annotationsExtractor = {
-  id: ID4,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "extractor",
-  description: "Turns the `supersedes` and `supersededBy` entries from a node's `.sm` sidecar into arrows between nodes in the graph. Example: `supersededBy: v1-skill.md` in a `.sm` sidecar draws an arrow to `v1-skill.md`.",
-  scope: "frontmatter",
-  extract(ctx) {
-    const sourcePath = ctx.node.path;
-    const seen = /* @__PURE__ */ new Set();
-    function emit(source, target, fieldPath) {
-      const key = `${source} ${target}`;
-      if (seen.has(key)) return;
-      seen.add(key);
-      ctx.emitSignal({
-        source,
-        scope: "sidecar",
-        fieldPath,
-        raw: target,
-        candidates: [
-          {
-            extractorId: ID4,
-            kind: "supersedes",
-            target,
-            confidence: 1,
-            rationale: "structured sidecar annotation"
-          }
-        ]
-      });
-    }
-    const ann = pickAnnotations(ctx.node);
-    if (ann) processBlock(ann, sourcePath, emit);
-  }
-};
-function processBlock(block, sourcePath, emit) {
-  const supersedes = stringArray(block["supersedes"]);
-  for (let i = 0; i < supersedes.length; i += 1) {
-    emit(sourcePath, supersedes[i], ["annotations", "supersedes", String(i)]);
-  }
-  const supersededBy = block["supersededBy"];
-  if (typeof supersededBy === "string" && supersededBy.length > 0) {
-    emit(supersededBy, sourcePath, ["annotations", "supersededBy"]);
-  }
-}
-function pickAnnotations(node) {
-  const sidecar = node.sidecar;
-  if (!sidecar || sidecar.present !== true) return null;
-  const ann = sidecar.annotations;
-  if (ann && typeof ann === "object" && !Array.isArray(ann)) {
-    return ann;
-  }
-  return null;
-}
-function stringArray(value) {
-  if (!Array.isArray(value)) return [];
-  return value.filter((v) => typeof v === "string" && v.length > 0);
-}
-
 // plugins/core/extractors/backtick-path/index.ts
 import { posix as pathPosix2 } from "path";
-var ID5 = "backtick-path";
+var ID4 = "backtick-path";
 var PATH_RE = /(?<![\w/:.-])(?:\.{1,2}\/)?[\w][\w.-]*(?:\/[\w.-]+)*\.md\b(?![\w/])/g;
 var backtickPathExtractor = {
-  id: ID5,
+  id: ID4,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
   description: "Turns relative .md paths written inside code spans and fenced blocks into arrows between nodes in the graph. Example: a backticked `references/rules.md` path draws an arrow to that file.",
@@ -1531,7 +1472,7 @@ var backtickPathExtractor = {
         raw: original,
         candidates: [
           {
-            extractorId: ID5,
+            extractorId: ID4,
             kind: "points",
             target: resolved,
             // 0.85: a strong file signal with one degree of inference,
@@ -1560,7 +1501,7 @@ function resolveTarget(sourceDir, raw) {
 }
 
 // plugins/core/extractors/external-url-counter/index.ts
-var ID6 = "external-url-counter";
+var ID5 = "external-url-counter";
 var count2 = {
   slot: "card.footer.left",
   icon: "pi-link",
@@ -1580,7 +1521,7 @@ var settings = {
 var URL_RE = /https?:\/\/[^\s<>"'`)\]]+/g;
 var TRAILING_PUNCT = /[.,;:!?]+$/;
 var externalUrlCounterExtractor = {
-  id: ID6,
+  id: ID5,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
   description: "Counts the distinct external URLs in a node's body and shows the count on the card. Example: a body linking `https://example.com` and `https://docs.rs` shows a count of 2.",
@@ -1632,7 +1573,7 @@ var externalUrlCounterExtractor = {
         raw: original,
         candidates: [
           {
-            extractorId: ID6,
+            extractorId: ID5,
             kind: "references",
             target: normalized.href,
             confidence: 0.3,
@@ -1674,11 +1615,11 @@ function normalizeUrl(raw) {
 
 // plugins/core/extractors/markdown-link/index.ts
 import { posix as pathPosix3 } from "path";
-var ID7 = "markdown-link";
+var ID6 = "markdown-link";
 var LINK_RE = /(?<!!)\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
 var URL_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
 var markdownLinkExtractor = {
-  id: ID7,
+  id: ID6,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
   description: "Turns markdown links (`[text](path)`) in a node's body into arrows between nodes in the graph. Example: `[the guide](docs/guide.md)` draws an arrow to `docs/guide.md`.",
@@ -1703,7 +1644,7 @@ var markdownLinkExtractor = {
         raw: match[0],
         candidates: [
           {
-            extractorId: ID7,
+            extractorId: ID6,
             kind: "references",
             target: resolved,
             // 0.95: the `[text](path)` syntax is unambiguous (the spec's
@@ -1738,10 +1679,10 @@ function resolveTarget2(sourceDir, raw) {
 }
 
 // plugins/core/extractors/mcp-tools/index.ts
-var ID8 = "mcp-tools";
+var ID7 = "mcp-tools";
 var MCP_PATTERN = /^mcp__([a-z0-9][a-z0-9_-]*)__[a-z0-9_-]+$/i;
 var mcpToolsExtractor = {
-  id: ID8,
+  id: ID7,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
   description: "Turns `tools: [mcp__<server>__<tool>]` entries in a node's frontmatter into an MCP node per unique server and an arrow from the source to each one. Example: `tools: [mcp__github__create_pr]` adds an `mcp://github` node and an arrow to it.",
@@ -1772,7 +1713,7 @@ var mcpToolsExtractor = {
         raw: `mcp__${server}__*`,
         candidates: [
           {
-            extractorId: ID8,
+            extractorId: ID7,
             kind: "references",
             target: mcpPath,
             confidence: 0.85,
@@ -1841,10 +1782,10 @@ var ANNOTATION_FIELD_UNKNOWN_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-field-unknown/index.ts
-var ID9 = "annotation-field-unknown";
+var ID8 = "annotation-field-unknown";
 var RESERVED_ROOT_BLOCKS = /* @__PURE__ */ new Set(["identity", "annotations", "settings", "audit"]);
 var annotationFieldUnknownAnalyzer = {
-  id: ID9,
+  id: ID8,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags typos or unrecognized keys in sidecars (`.sm`).",
@@ -1883,7 +1824,7 @@ var annotationFieldUnknownAnalyzer = {
         for (const key of Object.keys(annotations)) {
           if (!knownAnnotationKeys.has(key)) {
             issues.push({
-              analyzerId: ID9,
+              analyzerId: ID8,
               severity: "warn",
               nodeIds: [node.path],
               message: formatFinding({
@@ -1910,7 +1851,7 @@ var annotationFieldUnknownAnalyzer = {
             if (validator(value)) continue;
             const errors = (validator.errors ?? []).map((e) => `${e.instancePath || "(root)"} ${e.message ?? e.keyword}`).join("; ");
             issues.push({
-              analyzerId: ID9,
+              analyzerId: ID8,
               severity: "warn",
               nodeIds: [node.path],
               message: formatFinding({
@@ -1926,7 +1867,7 @@ var annotationFieldUnknownAnalyzer = {
           continue;
         }
         issues.push({
-          analyzerId: ID9,
+          analyzerId: ID8,
           severity: "warn",
           nodeIds: [node.path],
           message: formatFinding({
@@ -2000,9 +1941,9 @@ var ANNOTATION_ORPHAN_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-orphan/index.ts
-var ID10 = "annotation-orphan";
+var ID9 = "annotation-orphan";
 var annotationOrphanAnalyzer = {
-  id: ID10,
+  id: ID9,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags sidecars (`.sm`) whose `.md` file no longer exists.",
@@ -2014,7 +1955,7 @@ var annotationOrphanAnalyzer = {
     for (const orphan of orphans) {
       const expectedMdRelative = orphan.relativePath.endsWith(".sm") ? `${orphan.relativePath.slice(0, -".sm".length)}.md` : `${orphan.relativePath}.md`;
       issues.push({
-        analyzerId: ID10,
+        analyzerId: ID9,
         severity: "warn",
         nodeIds: [expectedMdRelative],
         message: formatFinding({
@@ -2057,7 +1998,7 @@ var ANNOTATION_STALE_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-stale/index.ts
-var ID11 = "annotation-stale";
+var ID10 = "annotation-stale";
 var staleIcon = {
   slot: "card.footer.right",
   icon: "pi-clock",
@@ -2070,7 +2011,7 @@ var staleBadge = {
   priority: 20
 };
 var annotationStaleAnalyzer = {
-  id: ID11,
+  id: ID10,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Marks sidecars (`.sm`) that are out of date with their `.md`.",
@@ -2086,7 +2027,7 @@ var annotationStaleAnalyzer = {
       const status = staleStatus(node.sidecar);
       if (status === null) continue;
       issues.push({
-        analyzerId: ID11,
+        analyzerId: ID10,
         severity: "info",
         nodeIds: [node.path],
         message: formatFinding({ body: messageFor(status) }),
@@ -2132,9 +2073,9 @@ function tooltipFor(status) {
 }
 
 // plugins/core/analyzers/contribution-orphan/index.ts
-var ID12 = "contribution-orphan";
+var ID11 = "contribution-orphan";
 var contributionOrphanAnalyzer = {
-  id: ID12,
+  id: ID11,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Warns about plugin data referencing nodes renamed or deleted in the latest scan.",
@@ -2166,12 +2107,12 @@ var EXTRACTOR_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/extractor-collision/index.ts
-var ID13 = "extractor-collision";
+var ID12 = "extractor-collision";
 function signalLines(signal) {
   return signal.range && typeof signal.range.line === "number" ? [signal.range.line] : void 0;
 }
 var extractorCollisionAnalyzer = {
-  id: ID13,
+  id: ID12,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Reports when two extractors detect something at the same span of body text and the resolver drops one.",
@@ -2195,7 +2136,7 @@ function makeIssue(signal) {
   const loserRange = signal.range ? `${signal.range.start}-${signal.range.end}` : "unknown";
   const winnerRange = `${winner.range.start}-${winner.range.end}`;
   return {
-    analyzerId: ID13,
+    analyzerId: ID12,
     severity: "warn",
     nodeIds: [signal.source],
     message: formatFinding({
@@ -2239,7 +2180,7 @@ var ISSUE_COUNTER_TEXTS = {
 };
 
 // plugins/core/analyzers/issue-counter/index.ts
-var ID14 = "issue-counter";
+var ID13 = "issue-counter";
 var warnCount = {
   slot: "card.footer.right",
   icon: "pi-exclamation-triangle",
@@ -2275,7 +2216,7 @@ function emitTierChips(ctx, ref, severity, counts, singleTooltip, manyTooltip) {
   }
 }
 var issueCounterAnalyzer = {
-  id: ID14,
+  id: ID13,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Emits one aggregate severity chip per node (error + warn counts) from the live issue accumulator.",
@@ -2338,7 +2279,7 @@ var LINK_COUNTER_TEXTS = {
 };
 
 // plugins/core/analyzers/link-counter/index.ts
-var ID15 = "link-counter";
+var ID14 = "link-counter";
 var linksIn = {
   slot: "card.footer.left",
   icon: "pi-download",
@@ -2354,7 +2295,7 @@ var linksOut = {
   priority: 20
 };
 var linkCounterAnalyzer = {
-  id: ID15,
+  id: ID14,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Counts incoming and outgoing links per node.",
@@ -2419,10 +2360,10 @@ var LINK_KIND_CONFLICT_TEXTS = {
 };
 
 // plugins/core/analyzers/link-kind-conflict/index.ts
-var ID16 = "link-kind-conflict";
+var ID15 = "link-kind-conflict";
 var NON_CONFLICTING_KINDS = /* @__PURE__ */ new Set(["points"]);
 var linkKindConflictAnalyzer = {
-  id: ID16,
+  id: ID15,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags conflicting arrow meanings between extractors (e.g. `references` vs `invokes`).",
@@ -2470,7 +2411,7 @@ var linkKindConflictAnalyzer = {
       const [source, target] = key.split("\0");
       const kindList = variants.map((v) => v.kind).join(" / ");
       issues.push({
-        analyzerId: ID16,
+        analyzerId: ID15,
         severity: "warn",
         nodeIds: [source, target],
         message: formatFinding({
@@ -2509,9 +2450,9 @@ var LINK_SELF_LOOP_TEXTS = {
 };
 
 // plugins/core/analyzers/link-self-loop/index.ts
-var ID17 = "link-self-loop";
+var ID16 = "link-self-loop";
 var linkSelfLoopAnalyzer = {
-  id: ID17,
+  id: ID16,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags links whose source is also their own resolved target (e.g. a body heading like `# /deploy` inside the file that defines `/deploy`).",
@@ -2521,7 +2462,7 @@ var linkSelfLoopAnalyzer = {
     for (const link of ctx.links) {
       if (!isSelfLoop(link)) continue;
       issues.push({
-        analyzerId: ID17,
+        analyzerId: ID16,
         severity: "warn",
         nodeIds: [link.source],
         message: formatFinding({
@@ -2553,9 +2494,9 @@ var NAME_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/name-collision/index.ts
-var ID18 = "name-collision";
+var ID17 = "name-collision";
 var nameCollisionAnalyzer = {
-  id: ID18,
+  id: ID17,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   mode: "deterministic",
@@ -2569,7 +2510,7 @@ var nameCollisionAnalyzer = {
     for (const [name, claims] of collisions) {
       const paths = claims.map((c) => c.path);
       issues.push({
-        analyzerId: ID18,
+        analyzerId: ID17,
         severity: "error",
         nodeIds: paths,
         message: formatFinding({
@@ -2619,9 +2560,9 @@ var NAME_RESERVED_TEXTS = {
 };
 
 // plugins/core/analyzers/name-reserved/index.ts
-var ID19 = "name-reserved";
+var ID18 = "name-reserved";
 var nameReservedAnalyzer = {
-  id: ID19,
+  id: ID18,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags two kinds of reserved-name collision: a file whose name shadows a built-in command of the active runtime, and a link that resolves to one of those reserved names.",
@@ -2639,7 +2580,7 @@ var nameReservedAnalyzer = {
       const node = byPath3.get(path);
       if (!node) continue;
       issues.push({
-        analyzerId: ID19,
+        analyzerId: ID18,
         severity: "warn",
         nodeIds: [node.path],
         message: formatFinding({
@@ -2661,7 +2602,7 @@ var nameReservedAnalyzer = {
         adjust(link, { kind: "delta", value: -RESERVED_PENALTY });
       }
       issues.push({
-        analyzerId: ID19,
+        analyzerId: ID18,
         severity: "warn",
         nodeIds: [link.source],
         message: formatFinding({
@@ -2688,26 +2629,32 @@ var nameReservedAnalyzer = {
   }
 };
 
+// plugins/core/stability.ts
+var STABILITY_VALUES = ["experimental", "stable", "deprecated"];
+function isStability(value) {
+  return value === "experimental" || value === "stable" || value === "deprecated";
+}
+function readEffectiveStability(node) {
+  const fromAnn = node.sidecar?.annotations?.["stability"];
+  if (isStability(fromAnn)) return fromAnn;
+  const legacy = readLegacyMetadataStability(node.frontmatter);
+  return isStability(legacy) ? legacy : null;
+}
+function readLegacyMetadataStability(fm) {
+  if (!fm) return void 0;
+  const meta = fm["metadata"];
+  if (!meta || typeof meta !== "object" || Array.isArray(meta)) return void 0;
+  return meta["stability"];
+}
+
 // plugins/core/analyzers/node-stability/text.ts
 var NODE_STABILITY_TEXTS = {
-  /** Issue body (`<what>; <why>`) for an experimental-marked node. */
-  experimental: "Marked experimental; API may change",
   /** Issue body (`<what>; <why>`) for a deprecated-marked node. */
-  deprecated: "Marked deprecated; avoid in new code",
-  /** Label of the inspector action button that sets the lifecycle stage. */
-  setLabel: "Set stability",
-  /** Prompt label for the enum-pick stability input. */
-  promptLabel: "Stability",
-  /** Prompt option label for the `experimental` stage. */
-  optionExperimental: "Experimental",
-  /** Prompt option label for the `stable` stage. */
-  optionStable: "Stable",
-  /** Prompt option label for the `deprecated` stage. */
-  optionDeprecated: "Deprecated"
+  deprecated: "Marked deprecated; avoid using it"
 };
 
 // plugins/core/analyzers/node-stability/index.ts
-var ID20 = "node-stability";
+var ID19 = "node-stability";
 var EXPERIMENTAL_TOOLTIP = "Experimental: API may change";
 var DEPRECATED_TOOLTIP = "Deprecated: avoid in new code";
 var experimental = {
@@ -2724,36 +2671,22 @@ var deprecated = {
   emitWhenEmpty: false,
   priority: 10
 };
-var setStabilityButton = {
-  slot: "inspector.action.button",
-  priority: 15
-};
 var nodeStabilityAnalyzer = {
-  id: ID20,
+  id: ID19,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
-  description: "Reports a node's stability stage (`experimental`, `deprecated`) on the card.",
+  description: "Surfaces a node's stability stage on the card: `deprecated` as a chip plus a finding, `experimental` as a chip only; `stable` and unset stay silent.",
   mode: "deterministic",
-  ui: { experimental, deprecated, setStabilityButton },
+  ui: { experimental, deprecated },
   evaluate(ctx) {
     const issues = [];
     for (const node of ctx.nodes) {
-      const stability = readStability(node);
-      if (node.sidecar?.present === true) {
-        emitSetStabilityButton(ctx, node.path, stability ?? "stable");
-      }
+      const stability = readEffectiveStability(node);
       if (stability === "experimental") {
         ctx.emitContribution(node.path, experimental, {
           value: 0,
           tooltip: EXPERIMENTAL_TOOLTIP
         });
-        issues.push({
-          analyzerId: ID20,
-          severity: "info",
-          nodeIds: [node.path],
-          message: formatFinding({ body: tx(NODE_STABILITY_TEXTS.experimental) }),
-          data: { stability }
-        });
       } else if (stability === "deprecated") {
         ctx.emitContribution(node.path, deprecated, {
           value: 0,
@@ -2761,7 +2694,7 @@ var nodeStabilityAnalyzer = {
           severity: "warn"
         });
         issues.push({
-          analyzerId: ID20,
+          analyzerId: ID19,
           severity: "warn",
           nodeIds: [node.path],
           message: formatFinding({ body: tx(NODE_STABILITY_TEXTS.deprecated) }),
@@ -2772,93 +2705,6 @@ var nodeStabilityAnalyzer = {
     return issues;
   }
 };
-function readStability(node) {
-  const fromAnn = node.sidecar?.annotations?.["stability"];
-  if (isStability(fromAnn)) return fromAnn;
-  const legacy = readLegacyMetadataStability(node.frontmatter);
-  return isStability(legacy) ? legacy : null;
-}
-function readLegacyMetadataStability(fm) {
-  if (!fm) return void 0;
-  const meta = fm["metadata"];
-  if (!meta || typeof meta !== "object" || Array.isArray(meta)) return void 0;
-  return meta["stability"];
-}
-function isStability(value) {
-  return value === "experimental" || value === "deprecated" || value === "stable";
-}
-function emitSetStabilityButton(ctx, nodePath, current) {
-  ctx.emitContribution(nodePath, setStabilityButton, {
-    actionId: "core/node-set-stability",
-    label: NODE_STABILITY_TEXTS.setLabel,
-    icon: "pi-flag",
-    enabled: true,
-    prompt: {
-      inputType: "enum-pick",
-      paramKey: "stability",
-      label: NODE_STABILITY_TEXTS.promptLabel,
-      options: [
-        { value: "experimental", label: NODE_STABILITY_TEXTS.optionExperimental },
-        { value: "stable", label: NODE_STABILITY_TEXTS.optionStable },
-        { value: "deprecated", label: NODE_STABILITY_TEXTS.optionDeprecated }
-      ],
-      defaultValue: current
-    }
-  });
-}
-
-// plugins/core/analyzers/node-superseded/text.ts
-var NODE_SUPERSEDED_TEXTS = {
-  /**
-   * Diagnosis body (`<what>; <why>`). The shared `formatFinding` helper
-   * wraps it with the backtick subject (the superseding artifact); the
-   * superseded node is the finding's own node, so its path never appears.
-   */
-  message: "Superseded; a newer node supersedes this one"
-};
-
-// plugins/core/analyzers/node-superseded/index.ts
-var ID21 = "node-superseded";
-var nodeSupersededAnalyzer = {
-  id: ID21,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "analyzer",
-  description: "Marks nodes replaced by a newer one via `supersededBy`.",
-  // Part of the experimental supersession feature: ships disabled by
-  // default alongside the declarer (`core/supersede` button +
-  // `core/node-supersede` action). With the declarer off by default a
-  // user rarely produces `supersededBy` data, so surfacing it stays
-  // experimental too; the operator opts the whole family in together.
-  stability: "experimental",
-  mode: "deterministic",
-  evaluate(ctx) {
-    const issues = [];
-    for (const node of ctx.nodes) {
-      const supersededBy = pickSupersededBy(node);
-      if (supersededBy === null) continue;
-      issues.push({
-        analyzerId: ID21,
-        severity: "info",
-        nodeIds: [node.path],
-        message: formatFinding({
-          subject: supersededBy,
-          body: tx(NODE_SUPERSEDED_TEXTS.message)
-        }),
-        data: { supersededBy }
-      });
-    }
-    return issues;
-  }
-};
-function pickSupersededBy(node) {
-  const sidecar = node.sidecar;
-  if (!sidecar || sidecar.present !== true) return null;
-  const ann = sidecar.annotations;
-  if (!ann || typeof ann !== "object" || Array.isArray(ann)) return null;
-  const value = ann["supersededBy"];
-  if (typeof value !== "string" || value.length === 0) return null;
-  return value;
-}
 
 // plugins/core/analyzers/reference-broken/index.ts
 import { resolve as resolve2 } from "path";
@@ -2890,7 +2736,6 @@ var REFERENCE_BROKEN_TEXTS = {
     references: "reference",
     mentions: "mention",
     invokes: "invocation",
-    supersedes: "supersession",
     points: "pointer"
   },
   kindLabelFallback: "{{kind}} link",
@@ -2901,9 +2746,9 @@ var REFERENCE_BROKEN_TEXTS = {
 };
 
 // plugins/core/analyzers/reference-broken/index.ts
-var ID22 = "reference-broken";
+var ID20 = "reference-broken";
 var referenceBrokenAnalyzer = {
-  id: ID22,
+  id: ID20,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags arrows pointing at a node not part of the current scan.",
@@ -2946,7 +2791,7 @@ function penalizeBrokenConfidence(adjust, link) {
 }
 function buildIssue(link) {
   return {
-    analyzerId: ID22,
+    analyzerId: ID20,
     // `error`, not `warn`: a link whose target is not in the scan is a
     // structural defect the operator must notice, and the card chip
     // paints `danger` (red) to match. Per the chip-vs-issue policy in
@@ -3010,9 +2855,9 @@ var REFERENCE_REDUNDANT_TEXTS = {
 };
 
 // plugins/core/analyzers/reference-redundant/index.ts
-var ID23 = "reference-redundant";
+var ID21 = "reference-redundant";
 var referenceRedundantAnalyzer = {
-  id: ID23,
+  id: ID21,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags when one node references the same target through two or more different links (e.g. a markdown link plus a `references:` entry).",
@@ -3035,7 +2880,7 @@ var referenceRedundantAnalyzer = {
       const [source, resolvedTarget] = key.split("\0");
       const flat = flattenOccurrences(links);
       issues.push({
-        analyzerId: ID23,
+        analyzerId: ID21,
         severity: "info",
         nodeIds: [source],
         message: formatFinding({
@@ -3380,9 +3225,9 @@ var SCHEMA_VIOLATION_TEXTS = {
 };
 
 // plugins/core/analyzers/schema-violation/index.ts
-var ID24 = "schema-violation";
+var ID22 = "schema-violation";
 var schemaViolationAnalyzer = {
-  id: ID24,
+  id: ID22,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags nodes or links that violate the project schemas.",
@@ -3434,7 +3279,7 @@ function collectNodeFindings(v, node, out) {
   const result = v.validate("node", toNodeForSchema(node));
   if (result.ok) return;
   out.push({
-    analyzerId: ID24,
+    analyzerId: ID22,
     severity: "error",
     nodeIds: [node.path],
     message: formatFinding({
@@ -3463,7 +3308,7 @@ function collectFrontmatterBaseFindings(node, out, kernelFlagged) {
   if (isMissingStringField(fm, "description")) missing.push("description");
   if (missing.length === 0) return;
   out.push({
-    analyzerId: ID24,
+    analyzerId: ID22,
     // `warn` (not `error`) so the default `sm scan` exit code stays
     // 0 even when nodes are missing frontmatter base fields. Strict
     // mode (`sm scan --strict`) still escalates to exit 1. Matches
@@ -3486,7 +3331,7 @@ function collectLinkFindings(v, link, out) {
   const result = v.validate("link", toLinkForSchema(link));
   if (result.ok) return;
   out.push({
-    analyzerId: ID24,
+    analyzerId: ID22,
     severity: "error",
     nodeIds: [link.source],
     message: formatFinding({
@@ -3555,13 +3400,13 @@ var ASCII_FORMATTER_TEXTS = {
 };
 
 // plugins/core/formatters/ascii/index.ts
-var ID25 = "ascii";
+var ID23 = "ascii";
 var KIND_ORDER = ["agent", "command", "skill", "markdown"];
 var asciiFormatter = {
-  id: ID25,
+  id: ID23,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
-  formatId: ID25,
+  formatId: ID23,
   description: "Renders the scan as plain text in three sections: nodes (grouped by kind), arrows, and issues. Used by `sm scan --format ascii`.",
   // ASCII tree formatter, header + per-kind sections + per-issue
   // section. Each section iterates and renders; splitting per section
@@ -3655,13 +3500,13 @@ function renderSection(out, kind, group) {
 }
 
 // plugins/core/formatters/json/index.ts
-var ID26 = "json";
+var ID24 = "json";
 var jsonFormatter = {
-  id: ID26,
+  id: ID24,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
   description: "Renders the persisted scan as JSON (conforms to `scan-result.schema.json`). Used by `sm graph --format json` and `GET /api/graph?format=json`.",
-  formatId: ID26,
+  formatId: ID24,
   format(ctx) {
     if (ctx.scanResult !== void 0) {
       return JSON.stringify(ctx.scanResult);
@@ -3808,13 +3653,13 @@ var BUMP_TEXTS = {
 };
 
 // plugins/core/actions/node-bump/index.ts
-var ID27 = "node-bump";
+var ID25 = "node-bump";
 var bumpButton = {
   slot: "inspector.action.button",
   priority: 10
 };
 var nodeBumpAction = {
-  id: ID27,
+  id: ID25,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Marks a node as updated: bumps `annotations.version`, refreshes sidecar hashes, and records the timestamp.",
@@ -3822,8 +3667,9 @@ var nodeBumpAction = {
   ui: { bumpButton },
   project(ctx) {
     for (const node of ctx.nodes) {
-      if (node.sidecar?.present !== true) continue;
-      emitBumpButton(ctx, node.path, staleStatus2(node.sidecar) !== null);
+      if (node.virtual === true) continue;
+      const enabled = node.sidecar?.present !== true || staleStatus2(node.sidecar) !== null;
+      emitBumpButton(ctx, node.path, enabled);
     }
   },
   // The runtime contract uses generic <TInput, TReport>; bump narrows
@@ -3892,15 +3738,39 @@ function pickCurrentVersion(overlay) {
   return typeof v === "number" && Number.isFinite(v) ? v : 0;
 }
 
+// plugins/core/actions/node-set-stability/text.ts
+var NODE_SET_STABILITY_TEXTS = {
+  /** Label of the inspector action button that sets the lifecycle stage. */
+  setLabel: "Set stability",
+  /** Prompt label for the enum-pick stability input. */
+  promptLabel: "Stability",
+  /** Prompt option label for the `experimental` stage. */
+  optionExperimental: "Experimental",
+  /** Prompt option label for the `stable` stage. */
+  optionStable: "Stable",
+  /** Prompt option label for the `deprecated` stage. */
+  optionDeprecated: "Deprecated"
+};
+
 // plugins/core/actions/node-set-stability/index.ts
-var STABILITY_VALUES = ["experimental", "stable", "deprecated"];
-var ID28 = "node-set-stability";
+var ID26 = "node-set-stability";
+var setStabilityButton = {
+  slot: "inspector.action.button",
+  priority: 15
+};
 var nodeSetStabilityAction = {
-  id: ID28,
+  id: ID26,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the lifecycle stage of the current node (writes `stability` to the sidecar).",
   mode: "deterministic",
+  ui: { setStabilityButton },
+  project(ctx) {
+    for (const node of ctx.nodes) {
+      if (node.virtual === true) continue;
+      emitSetStabilityButton(ctx, node);
+    }
+  },
   // The runtime contract uses generic <TInput, TReport>; this narrows
   // both. The cast is the standard pattern for built-ins that want
   // typed local I/O while staying compatible with the open generic.
@@ -3909,6 +3779,27 @@ var nodeSetStabilityAction = {
     return invokeSetStability(input, ctx);
   }
 };
+function emitSetStabilityButton(ctx, node) {
+  ctx.emitContribution(node.path, setStabilityButton, {
+    actionId: "core/node-set-stability",
+    label: NODE_SET_STABILITY_TEXTS.setLabel,
+    icon: "pi-flag",
+    enabled: true,
+    prompt: {
+      inputType: "enum-pick",
+      paramKey: "stability",
+      label: NODE_SET_STABILITY_TEXTS.promptLabel,
+      options: [
+        { value: "experimental", label: NODE_SET_STABILITY_TEXTS.optionExperimental },
+        { value: "stable", label: NODE_SET_STABILITY_TEXTS.optionStable },
+        { value: "deprecated", label: NODE_SET_STABILITY_TEXTS.optionDeprecated }
+      ],
+      // Pre-load the node's current stage so the picker opens on the active
+      // value; `stable` when nothing is set yet.
+      defaultValue: readEffectiveStability(node) ?? "stable"
+    }
+  });
+}
 function invokeSetStability(input, ctx) {
   const stability = input.stability;
   if (!STABILITY_VALUES.includes(stability)) {
@@ -3944,13 +3835,13 @@ var TAGS_TEXTS = {
 };
 
 // plugins/core/actions/node-set-tags/index.ts
-var ID29 = "node-set-tags";
+var ID27 = "node-set-tags";
 var setTagsButton = {
   slot: "inspector.action.button",
   priority: 15
 };
 var nodeSetTagsAction = {
-  id: ID29,
+  id: ID27,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the taxonomy tags of the current node (writes `tags` to the sidecar; whole-array replace).",
@@ -3958,7 +3849,7 @@ var nodeSetTagsAction = {
   ui: { setTagsButton },
   project(ctx) {
     for (const node of ctx.nodes) {
-      if (node.sidecar?.present !== true) continue;
+      if (node.virtual === true) continue;
       emitSetTagsButton(ctx, node);
     }
   },
@@ -4014,107 +3905,6 @@ function invokeSetTags(input, ctx) {
   return { report, writes: [write] };
 }
 
-// plugins/core/actions/node-supersede/text.ts
-var SUPERSEDE_TEXTS = {
-  /** Label of the inspector action button that declares supersession. */
-  supersedeLabel: "Supersede",
-  /** Tooltip shown when the supersede button is disabled (already superseded). */
-  supersedeDisabledReason: "Already superseded.",
-  /** Tooltip shown when there is no other node to supersede this one. */
-  supersedeNoTargetsReason: "No other node to supersede this one.",
-  /** Prompt label for the target node-picker (enum-pick over the live node set). */
-  supersedePromptLabel: "Superseded by"
-};
-
-// plugins/core/actions/node-supersede/index.ts
-var ID30 = "node-supersede";
-var supersedeButton = {
-  slot: "inspector.action.button",
-  priority: 10
-};
-var nodeSupersedeAction = {
-  id: ID30,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "action",
-  description: "Declares the current node as superseded by another (writes `supersededBy` to the sidecar).",
-  // Ships disabled by default (the declarer feature is still settling its
-  // node-picker UX). The button self-projection gates as a unit with the
-  // invoke executor: an enabled button pointing at a disabled action
-  // would error on click, so the whole action stays experimental.
-  stability: "experimental",
-  mode: "deterministic",
-  ui: { supersedeButton },
-  project(ctx) {
-    const candidates = ctx.nodes.filter((n) => n.virtual !== true).map((n) => n.path);
-    for (const node of ctx.nodes) {
-      if (node.virtual === true) continue;
-      const options = candidates.filter((p) => p !== node.path).map((p) => ({ value: p, label: p }));
-      emitSupersedeButton(ctx, node, options);
-    }
-  },
-  // The runtime contract uses generic <TInput, TReport>; supersede
-  // narrows both. The cast is the standard pattern for built-ins that
-  // want typed local I/O while staying compatible with the open generic.
-  invoke(rawInput, ctx) {
-    const input = rawInput ?? {};
-    return invokeSupersede(input, ctx);
-  }
-};
-function emitSupersedeButton(ctx, node, options) {
-  const disabledReason = resolveDisabledReason(node, options.length);
-  ctx.emitContribution(node.path, supersedeButton, {
-    actionId: "core/node-supersede",
-    label: SUPERSEDE_TEXTS.supersedeLabel,
-    icon: "pi-arrow-right-arrow-left",
-    enabled: disabledReason === void 0,
-    ...disabledReason === void 0 ? {} : { disabledReason },
-    prompt: {
-      inputType: "enum-pick",
-      paramKey: "supersededBy",
-      label: SUPERSEDE_TEXTS.supersedePromptLabel,
-      options
-    }
-  });
-}
-function resolveDisabledReason(node, optionCount) {
-  if (alreadySuperseded(node)) return SUPERSEDE_TEXTS.supersedeDisabledReason;
-  if (optionCount === 0) return SUPERSEDE_TEXTS.supersedeNoTargetsReason;
-  return void 0;
-}
-function alreadySuperseded(node) {
-  const sidecar = node.sidecar;
-  if (!sidecar || sidecar.present !== true) return false;
-  const ann = sidecar.annotations;
-  if (!ann || typeof ann !== "object" || Array.isArray(ann)) return false;
-  const value = ann["supersededBy"];
-  return typeof value === "string" && value.length > 0;
-}
-function invokeSupersede(input, ctx) {
-  const supersededBy = input.supersededBy;
-  if (supersededBy === ctx.node.path) {
-    return { report: { ok: false, reason: "self" } };
-  }
-  const timestamp = ctx.now().toISOString();
-  const write = {
-    kind: "sidecar",
-    path: sidecarPathFor(ctx.nodeAbsolutePath),
-    changes: {
-      identity: {
-        path: ctx.node.path,
-        bodyHash: ctx.node.bodyHash,
-        frontmatterHash: ctx.node.frontmatterHash
-      },
-      annotations: { supersededBy },
-      audit: {
-        lastBumpedAt: timestamp,
-        lastBumpedBy: ctx.invoker
-      }
-    }
-  };
-  const report = { ok: true, supersededBy };
-  return { report, writes: [write] };
-}
-
 // kernel/update-check/index.ts
 var SEMVER_SHAPE_RE = /^[0-9]+\.[0-9]+\.[0-9]+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
 async function fetchLatestVersion(pkg, opts) {
@@ -4599,7 +4389,6 @@ var antigravityProvider2 = { ...antigravityProvider, pluginId: "antigravity", ve
 var openaiProvider2 = { ...openaiProvider, pluginId: "openai", version: VERSION };
 var agentSkillsProvider2 = { ...agentSkillsProvider, pluginId: "agent-skills", version: VERSION };
 var coreMarkdownProvider2 = { ...coreMarkdownProvider, pluginId: "core", version: VERSION };
-var annotationsExtractor2 = { ...annotationsExtractor, pluginId: "core", version: VERSION };
 var backtickPathExtractor2 = { ...backtickPathExtractor, pluginId: "core", version: VERSION };
 var externalUrlCounterExtractor2 = { ...externalUrlCounterExtractor, pluginId: "core", version: VERSION };
 var markdownLinkExtractor2 = { ...markdownLinkExtractor, pluginId: "core", version: VERSION };
@@ -4616,7 +4405,6 @@ var linkSelfLoopAnalyzer2 = { ...linkSelfLoopAnalyzer, pluginId: "core", version
 var nameCollisionAnalyzer2 = { ...nameCollisionAnalyzer, pluginId: "core", version: VERSION };
 var nameReservedAnalyzer2 = { ...nameReservedAnalyzer, pluginId: "core", version: VERSION };
 var nodeStabilityAnalyzer2 = { ...nodeStabilityAnalyzer, pluginId: "core", version: VERSION };
-var nodeSupersededAnalyzer2 = { ...nodeSupersededAnalyzer, pluginId: "core", version: VERSION };
 var referenceBrokenAnalyzer2 = { ...referenceBrokenAnalyzer, pluginId: "core", version: VERSION };
 var referenceRedundantAnalyzer2 = { ...referenceRedundantAnalyzer, pluginId: "core", version: VERSION };
 var schemaViolationAnalyzer2 = { ...schemaViolationAnalyzer, pluginId: "core", version: VERSION };
@@ -4625,7 +4413,6 @@ var jsonFormatter2 = { ...jsonFormatter, pluginId: "core", version: VERSION };
 var nodeBumpAction2 = { ...nodeBumpAction, pluginId: "core", version: VERSION };
 var nodeSetStabilityAction2 = { ...nodeSetStabilityAction, pluginId: "core", version: VERSION };
 var nodeSetTagsAction2 = { ...nodeSetTagsAction, pluginId: "core", version: VERSION };
-var nodeSupersedeAction2 = { ...nodeSupersedeAction, pluginId: "core", version: VERSION };
 var updateCheckHook2 = { ...updateCheckHook, pluginId: "core", version: VERSION };
 var builtInPlugins = [
   {
@@ -4664,7 +4451,6 @@ var builtInPlugins = [
     description: "Core extensions shared across providers: parsers, extractors, analyzers, actions, hooks, formatters, and the universal `.md` fallback provider.",
     extensions: [
       coreMarkdownProvider2,
-      annotationsExtractor2,
       backtickPathExtractor2,
       externalUrlCounterExtractor2,
       markdownLinkExtractor2,
@@ -4681,7 +4467,6 @@ var builtInPlugins = [
       nameCollisionAnalyzer2,
       nameReservedAnalyzer2,
       nodeStabilityAnalyzer2,
-      nodeSupersededAnalyzer2,
       referenceBrokenAnalyzer2,
       referenceRedundantAnalyzer2,
       schemaViolationAnalyzer2,
@@ -4690,7 +4475,6 @@ var builtInPlugins = [
       nodeBumpAction2,
       nodeSetStabilityAction2,
       nodeSetTagsAction2,
-      nodeSupersedeAction2,
       updateCheckHook2
     ]
   }
@@ -7593,7 +7377,6 @@ var LINK_KIND_VALUES = Object.freeze([
   "invokes",
   "references",
   "mentions",
-  "supersedes",
   "points"
 ]);
 var SEVERITY_VALUES = Object.freeze([
@@ -10734,17 +10517,6 @@ var LOCKED_PLUGIN_IDS = /* @__PURE__ */ new Set([
   // silently invisible, a foot-gun the host product does not want to
   // expose. Lock it in the enabled state.
   "core/markdown",
-  // `core/annotations` turns the `supersedes` / `supersededBy` /
-  // `requires` / `related` / `conflictsWith` entries of the sidecar
-  // `annotations:` block into the arrows the graph draws between nodes.
-  // It does NOT own the rest of the block (`version`, `stability`,
-  // `tags`, `description`, those live on the node bundle directly and
-  // keep rendering with the plugin off). Disabling it produces a
-  // confusing "edges disappear but the sidecar metadata stays" split
-  // that no operator actually wants; the lock makes the asymmetry
-  // unreachable from CLI / BFF / UI. Re-evaluate if a third-party ever
-  // ships a competing supersession extractor.
-  "core/annotations",
   // `core/schema-violation` validates every scanned Node against
   // `node.schema.json` and every Link against `link.schema.json` (the
   // authoritative @skill-map/spec). Disabling it makes the system
@@ -15709,7 +15481,7 @@ function buildVirtualNode(extractor, emitted, emitter) {
   if (emitted.frontmatter) node.frontmatter = emitted.frontmatter;
   return node;
 }
-var KNOWN_LINK_KINDS = ["invokes", "references", "mentions", "supersedes", "points"];
+var KNOWN_LINK_KINDS = ["invokes", "references", "mentions", "points"];
 function validateLink(extractor, link, emitter) {
   const knownKinds = KNOWN_LINK_KINDS;
   if (!knownKinds.includes(link.kind)) {
@@ -16150,26 +15922,24 @@ function validateIssue(analyzer, issue, emitter) {
 // kernel/orchestrator/cache.ts
 function indexPriorSnapshot(prior) {
   const priorNodesByPath = /* @__PURE__ */ new Map();
-  const priorNodePaths = /* @__PURE__ */ new Set();
   const priorLinksByOriginating = /* @__PURE__ */ new Map();
   const priorFrontmatterIssuesByNode = /* @__PURE__ */ new Map();
   if (!prior) {
-    return { priorNodesByPath, priorNodePaths, priorLinksByOriginating, priorFrontmatterIssuesByNode };
+    return { priorNodesByPath, priorLinksByOriginating, priorFrontmatterIssuesByNode };
   }
-  indexPriorNodes(prior.nodes, priorNodesByPath, priorNodePaths);
-  indexPriorLinks(prior.links, priorNodePaths, priorLinksByOriginating);
+  indexPriorNodes(prior.nodes, priorNodesByPath);
+  indexPriorLinks(prior.links, priorLinksByOriginating);
   indexPriorFrontmatterIssues(prior.issues, priorFrontmatterIssuesByNode);
-  return { priorNodesByPath, priorNodePaths, priorLinksByOriginating, priorFrontmatterIssuesByNode };
+  return { priorNodesByPath, priorLinksByOriginating, priorFrontmatterIssuesByNode };
 }
-function indexPriorNodes(nodes, byPath3, paths) {
+function indexPriorNodes(nodes, byPath3) {
   for (const node of nodes) {
     byPath3.set(node.path, node);
-    paths.add(node.path);
   }
 }
-function indexPriorLinks(links, priorNodePaths, byOriginating) {
+function indexPriorLinks(links, byOriginating) {
   for (const link of links) {
-    const key = originatingNodeOf(link, priorNodePaths);
+    const key = link.source;
     const list = byOriginating.get(key);
     if (list) list.push(link);
     else byOriginating.set(key, [link]);
@@ -16185,12 +15955,6 @@ function indexPriorFrontmatterIssues(issues, byNode) {
     else byNode.set(path, [issue]);
   }
 }
-function originatingNodeOf(link, priorNodePaths) {
-  if (link.kind === "supersedes" && !priorNodePaths.has(link.source)) {
-    return link.target;
-  }
-  return link.source;
-}
 function computeCacheDecision(opts) {
   const applicableExtractors = opts.extractors.filter((ex) => {
     if (!matchesKindPrecondition(ex, opts.kind)) return false;
@@ -24409,8 +24173,8 @@ var ScanCommand = class extends SmCommand {
     details: `
       Walks the given roots with the built-in claude Provider, runs the
       frontmatter / slash / at-directive / external-url-counter
-      extractors per node, then the name-collision / broken-ref /
-      superseded analyzers over the full graph. Emits a ScanResult
+      extractors per node, then the name-collision / broken-ref
+      analyzers over the full graph. Emits a ScanResult
       conforming to scan-result.schema.json.
 
       The result is persisted into <cwd>/.skill-map/skill-map.db
@@ -31209,4 +30973,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=e6038423-ea97-5e66-b371-0916d382d819
+//# debugId=7e4fdbab-f037-5030-b67a-732bb7ee46fd