@skill-map/cli 0.53.6 → 0.55.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]="3bc438eb-6e57-550d-aab1-392242aca915")}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]="e21852cd-d92e-5bdf-abc7-02fffaa89502")}catch(e){}}();
 import { existsSync as existsSync33 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -246,7 +246,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.53.6",
+  version: "0.55.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -796,6 +796,16 @@ function stripCodeBlocks(input) {
   const fenceless = stripFences(input);
   return stripInline(fenceless);
 }
+function extractCodeRegions(input) {
+  if (!input) return input;
+  const stripped = stripCodeBlocks(input);
+  let out = "";
+  for (let i = 0; i < input.length; i++) {
+    const ch = input[i];
+    out += ch === stripped[i] ? ch === "\n" ? "\n" : " " : ch;
+  }
+  return out;
+}
 function stripFences(input) {
   const out = [];
   const lines = input.split("\n");
@@ -873,7 +883,7 @@ var atDirectiveExtractor = {
   id: ID,
   pluginId: CLAUDE_PLUGIN_ID,
   kind: "extractor",
-  description: "Detects `@<token>` directives in a node's body using Claude Code rules. A bare handle (e.g. `@team`) becomes a `mentions` link; a file-flavoured token (e.g. `@docs/api.md`, `@./readme.md`) becomes a `references` link.",
+  description: "Detects `@<token>` directives in a node's body using Claude Code rules, choosing the link kind by token shape. Example: a bare handle `@team` becomes a `mentions` link, while a file-flavoured token `@docs/api.md` becomes a `references` link.",
   scope: "body",
   precondition: { provider: ["claude"] },
   // eslint-disable-next-line complexity
@@ -961,7 +971,7 @@ var slashCommandExtractor = {
   id: ID2,
   pluginId: CLAUDE_PLUGIN_ID,
   kind: "extractor",
-  description: "Turns `/command` invocations in a node's body into arrows that point at the resolved slash command or skill, using Claude Code routing rules.",
+  description: "Turns `/command` invocations in a node's body into arrows that point at the resolved slash command or skill, using Claude Code routing rules. Example: `/deploy` in the body draws an arrow to the `deploy` command.",
   scope: "body",
   precondition: { provider: ["claude"] },
   extract(ctx) {
@@ -1005,6 +1015,44 @@ var slashCommandExtractor = {
   }
 };
 
+// plugins/claude/extractors/tools-counter/index.ts
+var ID3 = "tools-counter";
+var count = {
+  slot: "card.footer.left",
+  icon: "pi-wrench",
+  label: "tools",
+  emitWhenEmpty: false,
+  priority: 40
+};
+var TOOLTIP_MAX = 255;
+var toolsCounterExtractor = {
+  id: ID3,
+  pluginId: CLAUDE_PLUGIN_ID,
+  kind: "extractor",
+  description: "Counts the tools an agent declares in its frontmatter and shows the count on the agent card. Example: an agent with `tools: [Bash, Read, Grep]` shows a count of 3.",
+  scope: "frontmatter",
+  precondition: { kind: ["claude/agent"] },
+  ui: { count },
+  extract(ctx) {
+    const raw = ctx.frontmatter["tools"];
+    if (!Array.isArray(raw)) return;
+    const names = [];
+    for (const t of raw) {
+      if (typeof t === "string" && t.length > 0) names.push(t);
+    }
+    if (names.length === 0) return;
+    ctx.emitContribution(count, {
+      value: names.length,
+      tooltip: buildTooltip(names)
+    });
+  }
+};
+function buildTooltip(names) {
+  const joined = names.join(" \xB7 ");
+  if (joined.length <= TOOLTIP_MAX) return joined;
+  return `${joined.slice(0, TOOLTIP_MAX - 1)}\u2026`;
+}
+
 // plugins/antigravity/providers/antigravity/index.ts
 var antigravityProvider = {
   id: "antigravity",
@@ -1391,12 +1439,12 @@ var coreMarkdownProvider = {
 };
 
 // plugins/core/extractors/annotations/index.ts
-var ID3 = "annotations";
+var ID4 = "annotations";
 var annotationsExtractor = {
-  id: ID3,
+  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.",
+  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;
@@ -1412,7 +1460,7 @@ var annotationsExtractor = {
         raw: target,
         candidates: [
           {
-            extractorId: ID3,
+            extractorId: ID4,
             kind: "supersedes",
             target,
             confidence: 1,
@@ -1449,9 +1497,67 @@ function stringArray(value) {
   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 PATH_RE = /(?<![\w/:.-])(?:\.{1,2}\/)?[\w][\w.-]*(?:\/[\w.-]+)*\.md\b(?![\w/])/g;
+var backtickPathExtractor = {
+  id: ID5,
+  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.",
+  scope: "body",
+  extract(ctx) {
+    const seen = /* @__PURE__ */ new Set();
+    const body = extractCodeRegions(ctx.body);
+    const lineStarts = computeLineStarts(body);
+    const sourceDir = pathPosix2.dirname(ctx.node.path);
+    for (const match of body.matchAll(PATH_RE)) {
+      const original = match[0];
+      const resolved = resolveTarget(sourceDir, original);
+      if (resolved === null) continue;
+      if (seen.has(resolved)) continue;
+      seen.add(resolved);
+      const offset = match.index ?? 0;
+      const line = lineFor(lineStarts, offset);
+      ctx.emitSignal({
+        source: ctx.node.path,
+        scope: "body",
+        range: { start: offset, end: offset + original.length, line },
+        raw: original,
+        candidates: [
+          {
+            extractorId: ID5,
+            kind: "points",
+            target: resolved,
+            // 0.85: a strong file signal with one degree of inference,
+            // the author wrote a path inside a code region rather than
+            // an explicit `[text](path)` link. Whether the path resolves
+            // to a real node is a separate concern (`core/reference-broken`
+            // flags unresolved targets), not a confidence question.
+            confidence: 0.85,
+            rationale: "relative .md path inside a code region",
+            trigger: {
+              originalTrigger: original,
+              normalizedTrigger: resolved
+            }
+          }
+        ]
+      });
+    }
+  }
+};
+function resolveTarget(sourceDir, raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length === 0) return null;
+  if (trimmed.startsWith("/")) return null;
+  const joined = sourceDir === "." ? trimmed : `${sourceDir}/${trimmed}`;
+  return pathPosix2.normalize(joined);
+}
+
 // plugins/core/extractors/external-url-counter/index.ts
-var ID4 = "external-url-counter";
-var count = {
+var ID6 = "external-url-counter";
+var count2 = {
   slot: "card.footer.left",
   icon: "pi-link",
   label: "urls",
@@ -1461,10 +1567,10 @@ var count = {
 var URL_RE = /https?:\/\/[^\s<>"'`)\]]+/g;
 var TRAILING_PUNCT = /[.,;:!?]+$/;
 var externalUrlCounterExtractor = {
-  id: ID4,
+  id: ID6,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
-  description: "Counts the distinct external URLs in a node's body and shows the count on the card.",
+  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.",
   scope: "body",
   /**
    * Phase 6 / View contribution system, surface the distinct-URL
@@ -1482,7 +1588,7 @@ var externalUrlCounterExtractor = {
    * inherited from the footer `.sm-gnode__stat` styles cloned by
    * the `NodeCounter` renderer.
    */
-  ui: { count },
+  ui: { count: count2 },
   extract(ctx) {
     const seen = /* @__PURE__ */ new Set();
     const body = stripCodeBlocks(ctx.body);
@@ -1503,7 +1609,7 @@ var externalUrlCounterExtractor = {
         raw: original,
         candidates: [
           {
-            extractorId: ID4,
+            extractorId: ID6,
             kind: "references",
             target: normalized,
             confidence: 0.3,
@@ -1517,7 +1623,7 @@ var externalUrlCounterExtractor = {
       });
     }
     if (seen.size > 0) {
-      ctx.emitContribution(count, { value: seen.size });
+      ctx.emitContribution(count2, { value: seen.size });
     }
   }
 };
@@ -1536,24 +1642,24 @@ function normalizeUrl(raw) {
 }
 
 // plugins/core/extractors/markdown-link/index.ts
-import { posix as pathPosix2 } from "path";
-var ID5 = "markdown-link";
+import { posix as pathPosix3 } from "path";
+var ID7 = "markdown-link";
 var LINK_RE = /(?<!!)\[([^\]]*)\]\(([^)\s]+)(?:\s+"[^"]*")?\)/g;
 var URL_SCHEME_RE = /^[a-z][a-z0-9+.-]*:/i;
 var markdownLinkExtractor = {
-  id: ID5,
+  id: ID7,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
-  description: "Turns markdown links (`[text](path)`) in a node's body into arrows between nodes in the graph.",
+  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`.",
   scope: "body",
   extract(ctx) {
     const seen = /* @__PURE__ */ new Set();
     const body = stripCodeBlocks(ctx.body);
     const lineStarts = computeLineStarts(body);
-    const sourceDir = pathPosix2.dirname(ctx.node.path);
+    const sourceDir = pathPosix3.dirname(ctx.node.path);
     for (const match of body.matchAll(LINK_RE)) {
       const original = match[2];
-      const resolved = resolveTarget(sourceDir, original);
+      const resolved = resolveTarget2(sourceDir, original);
       if (resolved === null) continue;
       if (seen.has(resolved)) continue;
       seen.add(resolved);
@@ -1566,16 +1672,18 @@ var markdownLinkExtractor = {
         raw: match[0],
         candidates: [
           {
-            extractorId: ID5,
+            extractorId: ID7,
             kind: "references",
             target: resolved,
-            // 1.0: the `[text](path)` syntax is unambiguous. Markdown
-            // explicitly designates an out-link via the brackets +
-            // parentheses pair; there is no inference left to discount.
-            // Whether the path resolves to a real node is a separate
-            // concern (the `core/reference-broken` analyzer flags unresolved
-            // targets), not a confidence question.
-            confidence: 1,
+            // 0.95: the `[text](path)` syntax is unambiguous (the spec's
+            // "unambiguous syntax" tier), but NOT 1.0. `1.0` is reserved
+            // for structured input and is earned post-walk by the
+            // confidence-lift transform when `target` resolves to a real
+            // node; an unresolved (broken) target is downgraded to the
+            // broken floor (0.5) by the same transform. Emitting 1.0 here
+            // would short-circuit the lift and make a broken link
+            // indistinguishable from a resolved one.
+            confidence: 0.95,
             rationale: "unambiguous markdown link syntax",
             trigger: {
               originalTrigger: original,
@@ -1587,7 +1695,7 @@ var markdownLinkExtractor = {
     }
   }
 };
-function resolveTarget(sourceDir, raw) {
+function resolveTarget2(sourceDir, raw) {
   const noFragment = raw.split("#", 1)[0];
   const noQuery = noFragment.split("?", 1)[0];
   const trimmed = noQuery.trim();
@@ -1595,17 +1703,21 @@ function resolveTarget(sourceDir, raw) {
   if (URL_SCHEME_RE.test(trimmed)) return null;
   if (trimmed.startsWith("/")) return null;
   const joined = sourceDir === "." ? trimmed : `${sourceDir}/${trimmed}`;
-  return pathPosix2.normalize(joined);
+  return pathPosix3.normalize(joined);
 }
 
 // plugins/core/extractors/mcp-tools/index.ts
-var ID6 = "mcp-tools";
+var ID8 = "mcp-tools";
 var MCP_PATTERN = /^mcp__([a-z0-9][a-z0-9_-]*)__[a-z0-9_-]+$/i;
 var mcpToolsExtractor = {
-  id: ID6,
+  id: ID8,
   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.",
+  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.",
+  // Claude-convention pattern only; per-vendor flavours and the
+  // config-side MCP declaration (Phase 5b) are still pending, so the
+  // extractor ships flagged as experimental in list / show / Settings.
+  stability: "experimental",
   scope: "frontmatter",
   extract(ctx) {
     const raw = ctx.frontmatter["tools"];
@@ -1629,7 +1741,7 @@ var mcpToolsExtractor = {
         raw: `mcp__${server}__*`,
         candidates: [
           {
-            extractorId: ID6,
+            extractorId: ID8,
             kind: "references",
             target: mcpPath,
             confidence: 0.85,
@@ -1659,44 +1771,6 @@ function collectMcpServers(tools) {
   return out;
 }
 
-// plugins/core/extractors/tools-counter/index.ts
-var ID7 = "tools-counter";
-var count2 = {
-  slot: "card.footer.left",
-  icon: "pi-wrench",
-  label: "tools",
-  emitWhenEmpty: false,
-  priority: 40
-};
-var TOOLTIP_MAX = 255;
-var toolsCounterExtractor = {
-  id: ID7,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "extractor",
-  description: "Counts the tools an agent declares in its frontmatter and shows the count on the agent card.",
-  scope: "frontmatter",
-  precondition: { kind: ["claude/agent"] },
-  ui: { count: count2 },
-  extract(ctx) {
-    const raw = ctx.frontmatter["tools"];
-    if (!Array.isArray(raw)) return;
-    const names = [];
-    for (const t of raw) {
-      if (typeof t === "string" && t.length > 0) names.push(t);
-    }
-    if (names.length === 0) return;
-    ctx.emitContribution(count2, {
-      value: names.length,
-      tooltip: buildTooltip(names)
-    });
-  }
-};
-function buildTooltip(names) {
-  const joined = names.join(" \xB7 ");
-  if (joined.length <= TOOLTIP_MAX) return joined;
-  return `${joined.slice(0, TOOLTIP_MAX - 1)}\u2026`;
-}
-
 // plugins/core/analyzers/annotation-field-unknown/index.ts
 import { readFileSync } from "fs";
 import { dirname, resolve } from "path";
@@ -1712,12 +1786,14 @@ function applyAjvFormats(ajv) {
 
 // plugins/core/analyzers/annotation-field-unknown/text.ts
 var ANNOTATION_FIELD_UNKNOWN_TEXTS = {
+  // Compact finding grammar: the affected node is the finding's own
+  // node, so its path never appears in the message.
   /** Key inside `annotations:` is not in the curated catalog. */
-  unknownAnnotationKey: "{{path}}: sidecar annotations contain unknown key '{{key}}' (not in annotations.schema.json catalog).",
+  unknownAnnotationKey: "Unknown sidecar key '{{key}}'; not in the annotations catalog.",
   /** Top-level key is neither reserved, nor a registered plugin namespace, nor a registered root key. */
-  unknownRootKey: "{{path}}: sidecar declares unknown top-level key '{{key}}'; not a reserved block, not a registered plugin namespace, not a registered root contribution.",
+  unknownRootKey: "Unknown sidecar top-level key '{{key}}'; not a reserved block, a plugin namespace, or a root contribution.",
   /** Value under a registered plugin namespace fails the contributed schema. */
-  pluginNamespaceInvalid: "{{path}}: sidecar block '{{pluginId}}.{{key}}' fails the schema contributed by plugin '{{pluginId}}': {{errors}}.",
+  pluginNamespaceInvalid: "Sidecar block '{{pluginId}}.{{key}}' fails the schema from plugin '{{pluginId}}': {{errors}}.",
   // Tooltips for the per-node view-contribution badges. Singular vs
   // plural keeps the count grammar correct without a sub-template.
   alertTooltipSingle: "This node has 1 unknown field in its sidecar. Open the inspector for details.",
@@ -1725,10 +1801,10 @@ var ANNOTATION_FIELD_UNKNOWN_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-field-unknown/index.ts
-var ID8 = "annotation-field-unknown";
+var ID9 = "annotation-field-unknown";
 var RESERVED_ROOT_BLOCKS = /* @__PURE__ */ new Set(["identity", "annotations", "settings", "audit"]);
 var annotationFieldUnknownAnalyzer = {
-  id: ID8,
+  id: ID9,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags typos or unrecognized keys in sidecars (`.sm`).",
@@ -1767,7 +1843,7 @@ var annotationFieldUnknownAnalyzer = {
         for (const key of Object.keys(annotations)) {
           if (!knownAnnotationKeys.has(key)) {
             issues.push({
-              analyzerId: ID8,
+              analyzerId: ID9,
               severity: "warn",
               nodeIds: [node.path],
               message: tx(ANNOTATION_FIELD_UNKNOWN_TEXTS.unknownAnnotationKey, {
@@ -1794,7 +1870,7 @@ var annotationFieldUnknownAnalyzer = {
             if (validator(value)) continue;
             const errors = (validator.errors ?? []).map((e) => `${e.instancePath || "(root)"} ${e.message ?? e.keyword}`).join("; ");
             issues.push({
-              analyzerId: ID8,
+              analyzerId: ID9,
               severity: "warn",
               nodeIds: [node.path],
               message: tx(ANNOTATION_FIELD_UNKNOWN_TEXTS.pluginNamespaceInvalid, {
@@ -1810,7 +1886,7 @@ var annotationFieldUnknownAnalyzer = {
           continue;
         }
         issues.push({
-          analyzerId: ID8,
+          analyzerId: ID9,
           severity: "warn",
           nodeIds: [node.path],
           message: tx(ANNOTATION_FIELD_UNKNOWN_TEXTS.unknownRootKey, {
@@ -1871,14 +1947,19 @@ function collectPluginIds(contributions) {
 
 // plugins/core/analyzers/annotation-orphan/text.ts
 var ANNOTATION_ORPHAN_TEXTS = {
-  /** Sidecar `<path>.sm` has no matching `<path>.md`. */
-  message: "Orphan sidecar: {{sidecarPath}} has no matching markdown node at {{expectedMdPath}}."
+  /**
+   * Compact finding grammar: line 1 = the orphan sidecar file, line 2
+   * = the diagnosis. The expected markdown path IS the finding's
+   * `nodeIds[0]` (the issue files under the path the sidecar points
+   * at), so it never appears in the message.
+   */
+  message: "{{sidecarPath}}:\nOrphan sidecar; no matching markdown node."
 };
 
 // plugins/core/analyzers/annotation-orphan/index.ts
-var ID9 = "annotation-orphan";
+var ID10 = "annotation-orphan";
 var annotationOrphanAnalyzer = {
-  id: ID9,
+  id: ID10,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags sidecars (`.sm`) whose `.md` file no longer exists.",
@@ -1890,7 +1971,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: ID9,
+        analyzerId: ID10,
         severity: "warn",
         nodeIds: [expectedMdRelative],
         message: tx(ANNOTATION_ORPHAN_TEXTS.message, {
@@ -1909,12 +1990,14 @@ var annotationOrphanAnalyzer = {
 
 // plugins/core/analyzers/annotation-stale/text.ts
 var ANNOTATION_STALE_TEXTS = {
+  // Compact finding grammar: the affected node is the finding's own
+  // node, so its path never appears in the message.
   /** body changed since last bump */
-  bodyDrift: "{{path}}: sidecar `.sm` is stale (body changed since last bump).",
+  bodyDrift: "Sidecar `.sm` is stale: body changed since last bump.",
   /** frontmatter changed since last bump */
-  frontmatterDrift: "{{path}}: sidecar `.sm` is stale (frontmatter changed since last bump).",
+  frontmatterDrift: "Sidecar `.sm` is stale: frontmatter changed since last bump.",
   /** both body and frontmatter changed */
-  bothDrift: "{{path}}: sidecar `.sm` is stale (body and frontmatter changed since last bump).",
+  bothDrift: "Sidecar `.sm` is stale: body and frontmatter changed since last bump.",
   // Tooltips for the `card.footer.right` clock chip emitted alongside
   // the issue. Lists only the drifted face(s), in-sync faces are
   // omitted so the operator immediately sees what's modified without
@@ -1923,15 +2006,11 @@ var ANNOTATION_STALE_TEXTS = {
   // a literal placeholder the operator substitutes.
   bodyTooltip: "Sidecar drift since last bump:\n  \u2022 body\nRun `sm bump <path>` to refresh.",
   frontmatterTooltip: "Sidecar drift since last bump:\n  \u2022 frontmatter\nRun `sm bump <path>` to refresh.",
-  bothTooltip: "Sidecar drift since last bump:\n  \u2022 body\n  \u2022 frontmatter\nRun `sm bump <path>` to refresh.",
-  /** Label of the inspector action button that dispatches a bump. */
-  bumpLabel: "Bump",
-  /** Tooltip shown when the bump button is disabled (the node is fresh, no drift). */
-  bumpDisabledReason: "No drift to bump."
+  bothTooltip: "Sidecar drift since last bump:\n  \u2022 body\n  \u2022 frontmatter\nRun `sm bump <path>` to refresh."
 };
 
 // plugins/core/analyzers/annotation-stale/index.ts
-var ID10 = "annotation-stale";
+var ID11 = "annotation-stale";
 var staleIcon = {
   slot: "card.footer.right",
   icon: "pi-clock",
@@ -1943,30 +2022,24 @@ var staleBadge = {
   emitWhenEmpty: false,
   priority: 20
 };
-var bumpButton = {
-  slot: "inspector.action.button",
-  priority: 10
-};
 var annotationStaleAnalyzer = {
-  id: ID10,
+  id: ID11,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Marks sidecars (`.sm`) that are out of date with their `.md`.",
   mode: "deterministic",
   // The natural fix is to bump the node: refreshes the sidecar hashes,
   // increments `annotations.version`, and stamps the audit block. The
-  // inspector surfaces `core/node-bump` as the `bumpButton` contribution.
-  ui: { staleIcon, staleBadge, bumpButton },
+  // inspector surfaces that affordance via the `core/node-bump` action's
+  // own scan-time `project()` self-projection, not from this analyzer.
+  ui: { staleIcon, staleBadge },
   evaluate(ctx) {
     const issues = [];
     for (const node of ctx.nodes) {
       const status = staleStatus(node.sidecar);
-      if (node.sidecar?.present === true) {
-        emitBumpButton(ctx, node.path, status !== null);
-      }
       if (status === null) continue;
       issues.push({
-        analyzerId: ID10,
+        analyzerId: ID11,
         severity: "info",
         nodeIds: [node.path],
         message: messageFor(status, node.path),
@@ -1999,15 +2072,6 @@ function messageFor(status, path) {
       return tx(ANNOTATION_STALE_TEXTS.bothDrift, { path });
   }
 }
-function emitBumpButton(ctx, nodePath, enabled) {
-  ctx.emitContribution(nodePath, bumpButton, {
-    actionId: "core/node-bump",
-    label: ANNOTATION_STALE_TEXTS.bumpLabel,
-    icon: "pi-arrow-up-right",
-    enabled,
-    ...enabled ? {} : { disabledReason: ANNOTATION_STALE_TEXTS.bumpDisabledReason }
-  });
-}
 function tooltipFor(status) {
   switch (status) {
     case "stale-body":
@@ -2020,9 +2084,9 @@ function tooltipFor(status) {
 }
 
 // plugins/core/analyzers/contribution-orphan/index.ts
-var ID11 = "contribution-orphan";
+var ID12 = "contribution-orphan";
 var contributionOrphanAnalyzer = {
-  id: ID11,
+  id: ID12,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Warns about plugin data referencing nodes renamed or deleted in the latest scan.",
@@ -2041,7 +2105,7 @@ var ISSUE_COUNTER_TEXTS = {
 };
 
 // plugins/core/analyzers/issue-counter/index.ts
-var ID12 = "issue-counter";
+var ID13 = "issue-counter";
 var warnCount = {
   slot: "card.footer.right",
   icon: "pi-exclamation-triangle",
@@ -2077,7 +2141,7 @@ function emitTierChips(ctx, ref, severity, counts, singleTooltip, manyTooltip) {
   }
 }
 var issueCounterAnalyzer = {
-  id: ID12,
+  id: ID13,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Emits one aggregate severity chip per node (error + warn counts) from the live issue accumulator.",
@@ -2112,15 +2176,16 @@ var issueCounterAnalyzer = {
 var JOB_FILE_ORPHAN_TEXTS = {
   /**
    * `<path>.md` lives under `.skill-map/jobs/` but no `state_jobs.filePath`
-   * row references it. Run `sm job prune --orphan-files` to remove.
+   * row references it. Compact finding grammar: the file IS the
+   * finding's own node, so its path never appears in the message.
    */
-  message: "Orphan job file: {{filePath}} is not referenced by any state_jobs row. Run `sm job prune --orphan-files` to remove it."
+  message: "Orphan job file; not referenced by any job. Run `sm job prune --orphan-files` to remove it."
 };
 
 // plugins/core/analyzers/job-file-orphan/index.ts
-var ID13 = "job-file-orphan";
+var ID14 = "job-file-orphan";
 var jobFileOrphanAnalyzer = {
-  id: ID13,
+  id: ID14,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags leftover job result files (no live job references them). Clean up via `sm job prune --orphan-files`.",
@@ -2131,7 +2196,7 @@ var jobFileOrphanAnalyzer = {
     const issues = [];
     for (const filePath of orphans) {
       issues.push({
-        analyzerId: ID13,
+        analyzerId: ID14,
         severity: "warn",
         nodeIds: [filePath],
         message: tx(JOB_FILE_ORPHAN_TEXTS.message, { filePath }),
@@ -2144,14 +2209,19 @@ var jobFileOrphanAnalyzer = {
 
 // plugins/core/analyzers/link-conflict/text.ts
 var LINK_CONFLICT_TEXTS = {
-  /** `Detectors disagree on link kind for <source> → <target> (<kindList>)` */
-  message: "Detectors disagree on link kind for {{source}} \u2192 {{target}} ({{kindList}})"
+  /**
+   * Compact finding grammar: line 1 = the disputed target, line 2 =
+   * the short diagnosis. The source is the finding's own node, so it
+   * never appears in the message.
+   */
+  message: "{{target}}:\nDetectors disagree on link kind ({{kindList}})."
 };
 
 // plugins/core/analyzers/link-conflict/index.ts
-var ID14 = "link-conflict";
+var ID15 = "link-conflict";
+var NON_CONFLICTING_KINDS = /* @__PURE__ */ new Set(["points"]);
 var linkConflictAnalyzer = {
-  id: ID14,
+  id: ID15,
   pluginId: "core",
   kind: "analyzer",
   description: "Flags conflicting arrow meanings between extractors (e.g. `references` vs `invokes`).",
@@ -2163,6 +2233,7 @@ var linkConflictAnalyzer = {
   evaluate(ctx) {
     const groups = /* @__PURE__ */ new Map();
     for (const link of ctx.links) {
+      if (NON_CONFLICTING_KINDS.has(link.kind)) continue;
       const key = `${link.source}\0${link.target}`;
       const bucket = groups.get(key);
       if (bucket) bucket.push(link);
@@ -2198,7 +2269,7 @@ var linkConflictAnalyzer = {
       const [source, target] = key.split("\0");
       const kindList = variants.map((v) => v.kind).join(" / ");
       issues.push({
-        analyzerId: ID14,
+        analyzerId: ID15,
         severity: "warn",
         nodeIds: [source, target],
         message: tx(LINK_CONFLICT_TEXTS.message, {
@@ -2265,7 +2336,7 @@ function resolveLinkTargetToPath(link, nameIndex) {
 }
 
 // plugins/core/analyzers/link-counter/index.ts
-var ID15 = "link-counter";
+var ID16 = "link-counter";
 var linksIn = {
   slot: "card.footer.left",
   icon: "pi-download",
@@ -2281,7 +2352,7 @@ var linksOut = {
   priority: 20
 };
 var linkCounterAnalyzer = {
-  id: ID15,
+  id: ID16,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Counts incoming and outgoing links per node.",
@@ -2328,6 +2399,27 @@ function formatBreakdown(byKind, direction) {
   return [direction, ...lines].join("\n");
 }
 
+// kernel/util/link-lines.ts
+function linkLines(link) {
+  const lines = /* @__PURE__ */ new Set();
+  for (const occ of link.occurrences ?? []) {
+    const line = occ.location?.line;
+    if (typeof line === "number") lines.add(line);
+  }
+  if (lines.size === 0) {
+    const line = link.location?.line;
+    if (typeof line === "number") lines.add(line);
+  }
+  return [...lines].sort((a, b) => a - b);
+}
+function linkWhere(link, texts) {
+  const lines = linkLines(link);
+  if (lines.length === 0) return "";
+  return tx(lines.length === 1 ? texts.single : texts.plural, {
+    lines: lines.join(", ")
+  });
+}
+
 // plugins/core/analyzers/link-self-loop/text.ts
 var LINK_SELF_LOOP_TEXTS = {
   /**
@@ -2338,13 +2430,17 @@ var LINK_SELF_LOOP_TEXTS = {
    * the operator's intent; UI consumers MAY hide it by default and
    * surface a count.
    */
-  message: "{{source}} references itself via `{{trigger}}` ({{kind}}). Self-loops typically come from the file's own heading or label and are noise rather than intent. Either remove the in-body token or treat this finding as expected and acknowledged."
+  message: "`{{trigger}}`:\nSelf-reference ({{kind}}{{where}}); typically the file's own heading or label. Remove the token or ignore deliberately.",
+  /** Location suffix inside the kind parens, one detection site. */
+  whereSingle: ", line {{lines}}",
+  /** Location suffix inside the kind parens, several detection sites. */
+  wherePlural: ", lines {{lines}}"
 };
 
 // plugins/core/analyzers/link-self-loop/index.ts
-var ID16 = "link-self-loop";
+var ID17 = "link-self-loop";
 var linkSelfLoopAnalyzer = {
-  id: ID16,
+  id: ID17,
   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`).",
@@ -2355,13 +2451,16 @@ var linkSelfLoopAnalyzer = {
     for (const link of ctx.links) {
       if (!isSelfLoop(link)) continue;
       issues.push({
-        analyzerId: ID16,
+        analyzerId: ID17,
         severity: "warn",
         nodeIds: [link.source],
         message: tx(LINK_SELF_LOOP_TEXTS.message, {
-          source: link.source,
           trigger: link.trigger?.originalTrigger ?? link.target,
-          kind: link.kind
+          kind: link.kind,
+          where: linkWhere(link, {
+            single: LINK_SELF_LOOP_TEXTS.whereSingle,
+            plural: LINK_SELF_LOOP_TEXTS.wherePlural
+          })
         }),
         data: {
           target: link.target,
@@ -2384,7 +2483,7 @@ function isSelfLoop(link) {
 }
 
 // kernel/orchestrator/node-identifiers.ts
-import { posix as pathPosix3 } from "path";
+import { posix as pathPosix4 } from "path";
 function deriveNodeIdentifiers(node, kindDescriptor) {
   const sources = kindDescriptor?.identifiers;
   if (!sources || sources.length === 0) return [];
@@ -2408,31 +2507,40 @@ function readFrontmatterName(node) {
   return raw.length > 0 ? raw : null;
 }
 function readFilenameBasename(node) {
-  const base = pathPosix3.basename(node.path);
+  const base = pathPosix4.basename(node.path);
   if (!base) return null;
-  const ext = pathPosix3.extname(base);
+  const ext = pathPosix4.extname(base);
   const stem = ext ? base.slice(0, -ext.length) : base;
   return stem.length > 0 ? stem : null;
 }
 function readDirname(node) {
-  const dir = pathPosix3.dirname(node.path);
+  const dir = pathPosix4.dirname(node.path);
   if (!dir || dir === "." || dir === "/") return null;
-  const base = pathPosix3.basename(dir);
+  const base = pathPosix4.basename(dir);
   return base.length > 0 ? base : null;
 }
 
 // kernel/orchestrator/lift-resolved-link-confidence.ts
 var RESERVED_TARGET_CONFIDENCE = 0.1;
+var BROKEN_TARGET_CONFIDENCE = 0.5;
 function liftResolvedLinkConfidence(links, nodes, ctx) {
   if (!links.some((l) => l.confidence < 1)) return;
   const indexes = buildIndexes(nodes, ctx);
   for (const link of links) {
-    if (link.confidence >= 1) continue;
-    const resolution = resolve2(link, indexes, ctx);
-    if (resolution === "none") continue;
-    link.confidence = ctx.reservedNodePaths.has(resolution) ? RESERVED_TARGET_CONFIDENCE : 1;
-    link.resolvedTarget = resolution;
+    if (link.confidence < 1) applyResolution(link, indexes, ctx);
+  }
+}
+function applyResolution(link, indexes, ctx) {
+  const resolution = resolve2(link, indexes, ctx);
+  if (resolution === "none") {
+    if (isGenuinelyBroken(link, indexes)) {
+      link.confidence = Math.min(link.confidence, BROKEN_TARGET_CONFIDENCE);
+    }
+    return;
   }
+  link.resolvedTarget = resolution;
+  if (indexes.nodeByPath.get(resolution)?.virtual) return;
+  link.confidence = ctx.reservedNodePaths.has(resolution) ? RESERVED_TARGET_CONFIDENCE : 1;
 }
 function buildIndexes(nodes, ctx) {
   const byPath3 = /* @__PURE__ */ new Set();
@@ -2449,6 +2557,12 @@ function resolve2(link, indexes, ctx) {
   if (indexes.byPath.has(link.target)) return link.target;
   return resolveByName(link, indexes, ctx);
 }
+function isGenuinelyBroken(link, indexes) {
+  if (indexes.byPath.has(link.target)) return false;
+  const stripped = stripTriggerSigil(link.trigger?.normalizedTrigger);
+  if (stripped !== null && indexes.byName.has(stripped)) return false;
+  return true;
+}
 function resolveByName(link, indexes, ctx) {
   const stripped = stripTriggerSigil(link.trigger?.normalizedTrigger);
   if (stripped === null) return "none";
@@ -2492,7 +2606,7 @@ var NAME_RESERVED_TEXTS = {
    * a runtime built-in. Same wording skill-map shipped before the
    * source-side link finding landed.
    */
-  message: "{{path}} shadows a built-in {{provider}} {{kind}}. The runtime ignores this file in favour of its own built-in. Rename the file or `frontmatter.name` to a non-reserved value.",
+  message: "Built-in {{provider}} {{kind}}:\nShadowed by this file; the runtime uses its built-in instead. Rename the file or its `frontmatter.name`.",
   /**
    * Source-side message: emitted on the node that AUTHORED a link
    * whose target resolves to a reserved name. Explains WHY the link's
@@ -2500,13 +2614,17 @@ var NAME_RESERVED_TEXTS = {
    * the kernel saw the target match a runtime built-in and downgraded
    * the edge so the operator notices.
    */
-  linkMessage: "Link `{{kind}} {{target}}` resolves to a name reserved by the {{provider}} runtime ({{reservedKind}} `{{reservedPath}}`). The runtime shadows the user file, so this edge is downgraded to confidence {{confidence}} instead of 1.0. Rename the target file or its `frontmatter.name` to a non-reserved value."
+  linkMessage: "{{target}}:\nResolves to a {{provider}} built-in ({{reservedKind}} `{{reservedPath}}`){{where}}; edge downgraded to confidence {{confidence}}. Rename the target file or its `frontmatter.name`.",
+  /** Location suffix after the built-in parens, one detection site. */
+  whereSingle: " (line {{lines}})",
+  /** Location suffix after the built-in parens, several detection sites. */
+  wherePlural: " (lines {{lines}})"
 };
 
 // plugins/core/analyzers/name-reserved/index.ts
-var ID17 = "name-reserved";
+var ID18 = "name-reserved";
 var nameReservedAnalyzer = {
-  id: ID17,
+  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.",
@@ -2522,7 +2640,7 @@ var nameReservedAnalyzer = {
       const node = byPath3.get(path);
       if (!node) continue;
       issues.push({
-        analyzerId: ID17,
+        analyzerId: ID18,
         severity: "warn",
         nodeIds: [node.path],
         message: tx(NAME_RESERVED_TEXTS.message, {
@@ -2538,16 +2656,16 @@ var nameReservedAnalyzer = {
       const reservedNode = findReservedNodeForLink(link, reserved, byPath3);
       if (!reservedNode) continue;
       issues.push({
-        analyzerId: ID17,
+        analyzerId: ID18,
         severity: "warn",
         nodeIds: [link.source],
         message: tx(NAME_RESERVED_TEXTS.linkMessage, {
-          kind: link.kind,
           target: link.target,
           provider: reservedNode.provider,
           reservedKind: reservedNode.kind,
           reservedPath: reservedNode.path,
-          confidence: RESERVED_TARGET_CONFIDENCE.toFixed(2)
+          confidence: RESERVED_TARGET_CONFIDENCE.toFixed(2),
+          where: linkWhereSuffix(link)
         }),
         data: {
           target: link.target,
@@ -2562,6 +2680,12 @@ var nameReservedAnalyzer = {
     return issues;
   }
 };
+function linkWhereSuffix(link) {
+  return linkWhere(link, {
+    single: NAME_RESERVED_TEXTS.whereSingle,
+    plural: NAME_RESERVED_TEXTS.wherePlural
+  });
+}
 function findReservedNodeForLink(link, reserved, byPath3) {
   if (reserved.has(link.target)) {
     const node = byPath3.get(link.target);
@@ -2613,7 +2737,7 @@ var NODE_STABILITY_TEXTS = {
 };
 
 // plugins/core/analyzers/node-stability/index.ts
-var ID18 = "node-stability";
+var ID19 = "node-stability";
 var EXPERIMENTAL_TOOLTIP = "Experimental: API may change";
 var DEPRECATED_TOOLTIP = "Deprecated: avoid in new code";
 var experimental = {
@@ -2635,7 +2759,7 @@ var setStabilityButton = {
   priority: 15
 };
 var nodeStabilityAnalyzer = {
-  id: ID18,
+  id: ID19,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Reports a node's stability stage (`experimental`, `deprecated`) on the card.",
@@ -2654,7 +2778,7 @@ var nodeStabilityAnalyzer = {
           tooltip: EXPERIMENTAL_TOOLTIP
         });
         issues.push({
-          analyzerId: ID18,
+          analyzerId: ID19,
           severity: "info",
           nodeIds: [node.path],
           message: `Node '${node.path}' is marked experimental: API may change.`,
@@ -2667,7 +2791,7 @@ var nodeStabilityAnalyzer = {
           severity: "warn"
         });
         issues.push({
-          analyzerId: ID18,
+          analyzerId: ID19,
           severity: "warn",
           nodeIds: [node.path],
           message: `Node '${node.path}' is marked deprecated: avoid in new code.`,
@@ -2715,17 +2839,27 @@ function emitSetStabilityButton(ctx, nodePath, current) {
 
 // plugins/core/analyzers/node-superseded/text.ts
 var NODE_SUPERSEDED_TEXTS = {
-  /** `<path> is superseded by <supersededBy>` */
-  message: "{{path}} is superseded by {{supersededBy}}"
+  /**
+   * Compact finding grammar: line 1 = the superseding artifact, line
+   * 2 = what it means. The superseded node is the finding's own node,
+   * so its path never appears in the message.
+   */
+  message: "{{supersededBy}}:\nSupersedes this node."
 };
 
 // plugins/core/analyzers/node-superseded/index.ts
-var ID19 = "node-superseded";
+var ID20 = "node-superseded";
 var nodeSupersededAnalyzer = {
-  id: ID19,
+  id: ID20,
   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 = [];
@@ -2733,7 +2867,7 @@ var nodeSupersededAnalyzer = {
       const supersededBy = pickSupersededBy(node);
       if (supersededBy === null) continue;
       issues.push({
-        analyzerId: ID19,
+        analyzerId: ID20,
         severity: "info",
         nodeIds: [node.path],
         message: tx(NODE_SUPERSEDED_TEXTS.message, {
@@ -2757,12 +2891,34 @@ function pickSupersededBy(node) {
 }
 
 // plugins/core/analyzers/reference-broken/index.ts
-import { posix as pathPosix4, resolve as resolve3 } from "path";
+import { posix as pathPosix5, resolve as resolve3 } from "path";
 
 // plugins/core/analyzers/reference-broken/text.ts
 var REFERENCE_BROKEN_TEXTS = {
-  /** `Broken <kind> reference from <source> → <target>` */
-  message: "Broken {{kind}} reference from {{source}} \u2192 {{target}}",
+  /**
+   * Compact finding grammar: line 1 = the unresolved target, line 2 =
+   * the short diagnosis plus WHERE the reference sits (`{{where}}` is
+   * the pre-rendered location suffix below, or empty when the link
+   * carries no line info). The source is the finding's own node, so it
+   * never appears in the message.
+   */
+  message: "{{target}}:\nBroken {{kindLabel}}{{where}}.",
+  /** Location suffix, one detection site. */
+  whereSingle: " (line {{lines}})",
+  /** Location suffix, several detection sites. */
+  wherePlural: " (lines {{lines}})",
+  /**
+   * Human noun per link kind for the message above. Fallback for an
+   * off-catalog kind: `<kind> link` (composed in the analyzer).
+   */
+  kindLabels: {
+    references: "reference",
+    mentions: "mention",
+    invokes: "invocation",
+    supersedes: "supersession",
+    points: "pointer"
+  },
+  kindLabelFallback: "{{kind}} link",
   // Tooltips for the per-node view-contribution badges. Singular vs
   // plural keeps the count grammar correct without a sub-template.
   alertTooltipSingle: "This node has a broken reference. Open the inspector for details.",
@@ -2776,9 +2932,9 @@ var REFERENCE_BROKEN_TEXTS = {
 };
 
 // plugins/core/analyzers/reference-broken/index.ts
-var ID20 = "reference-broken";
+var ID21 = "reference-broken";
 var referenceBrokenAnalyzer = {
-  id: ID20,
+  id: ID21,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags arrows pointing at a node not part of the current scan.",
@@ -2815,7 +2971,7 @@ function buildIssue(link, hintCandidates = []) {
     trigger: link.trigger?.normalizedTrigger ?? null
   };
   const issue = {
-    analyzerId: ID20,
+    analyzerId: ID21,
     // `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
@@ -2825,33 +2981,37 @@ function buildIssue(link, hintCandidates = []) {
     severity: "error",
     nodeIds: [link.source],
     message: tx(REFERENCE_BROKEN_TEXTS.message, {
-      kind: link.kind,
-      source: link.source,
-      target: link.target
+      target: link.target,
+      kindLabel: REFERENCE_BROKEN_TEXTS.kindLabels[link.kind] ?? tx(REFERENCE_BROKEN_TEXTS.kindLabelFallback, { kind: link.kind }),
+      where: linkWhere(link, {
+        single: REFERENCE_BROKEN_TEXTS.whereSingle,
+        plural: REFERENCE_BROKEN_TEXTS.wherePlural
+      })
     }),
     data
   };
-  if (hintCandidates.length > 0) {
-    const suggestedName = (link.trigger?.normalizedTrigger ?? "").replace(/^[/@]/, "").trim();
-    const candidatePaths = hintCandidates.map((n) => n.path);
-    data["hint"] = {
-      kind: "missing-frontmatter-name",
-      suggestedName,
-      candidates: candidatePaths
-    };
-    issue.fix = {
-      summary: candidatePaths.length === 1 ? tx(REFERENCE_BROKEN_TEXTS.hintSummarySingle, {
-        name: suggestedName,
-        candidate: candidatePaths[0]
-      }) : tx(REFERENCE_BROKEN_TEXTS.hintSummaryMany, {
-        name: suggestedName,
-        candidates: candidatePaths.join(", ")
-      }),
-      autofixable: false
-    };
-  }
+  if (hintCandidates.length > 0) attachHint(issue, data, link, hintCandidates);
   return issue;
 }
+function attachHint(issue, data, link, hintCandidates) {
+  const suggestedName = (link.trigger?.normalizedTrigger ?? "").replace(/^[/@]/, "").trim();
+  const candidatePaths = hintCandidates.map((n) => n.path);
+  data["hint"] = {
+    kind: "missing-frontmatter-name",
+    suggestedName,
+    candidates: candidatePaths
+  };
+  issue.fix = {
+    summary: candidatePaths.length === 1 ? tx(REFERENCE_BROKEN_TEXTS.hintSummarySingle, {
+      name: suggestedName,
+      candidate: candidatePaths[0]
+    }) : tx(REFERENCE_BROKEN_TEXTS.hintSummaryMany, {
+      name: suggestedName,
+      candidates: candidatePaths.join(", ")
+    }),
+    autofixable: false
+  };
+}
 function resolvesViaReferencePaths(link, refIndex) {
   if (!isPathStyleLink(link)) return false;
   return refIndex.paths.has(resolve3(refIndex.cwd, link.target));
@@ -2870,8 +3030,8 @@ function indexByNormalizedName(nodes) {
   return out;
 }
 function basenameWithoutExt(path) {
-  const base = pathPosix4.basename(path);
-  const ext = pathPosix4.extname(base);
+  const base = pathPosix5.basename(path);
+  const ext = pathPosix5.extname(base);
   return ext ? base.slice(0, -ext.length) : base;
 }
 function indexByBasenameWithoutName(nodes) {
@@ -2917,25 +3077,29 @@ function isPathStyleLink(link) {
 // plugins/core/analyzers/reference-redundant/text.ts
 var REFERENCE_REDUNDANT_TEXTS = {
   /**
-   * Multi-form / multi-occurrence reference message. Short and direct:
-   * names the duplicated target + count and lists each occurrence
-   * (trigger + line) so the operator sees the offending spots at a
-   * glance. The source node is the finding's own node, so it is not
-   * repeated here.
+   * Compact finding grammar (subject first, `\n` renders as a line
+   * break in the inspector and flattens to a space in `sm check`):
+   *
+   *   <resolvedTarget>:
+   *   Duplicate reference (2): `references/x.md` (124, 145).
+   *
+   * Occurrences are grouped BY TRIGGER: each distinct trigger text
+   * appears once with its line numbers collapsed into one paren list.
+   * The source node is the finding's own node, so it never appears.
    */
-  message: "Duplicate reference to {{resolvedTarget}} ({{count}} occurrences): {{occurrences}}.",
-  /** Inline separator between occurrences in the message. */
+  message: "{{resolvedTarget}}:\nDuplicate reference ({{count}}): {{occurrences}}.",
+  /** Inline separator between trigger groups in the message. */
   occurrenceSeparator: ", ",
-  /** Per-occurrence formatting (trigger + line). */
-  occurrence: "`{{trigger}}` ({{kind}}, line {{line}})",
-  /** Per-occurrence formatting when the extractor did not record a line. */
-  occurrenceUnknownLine: "`{{trigger}}` ({{kind}}, unknown line)"
+  /** Per-trigger formatting: the trigger once, its lines grouped. */
+  occurrence: "`{{trigger}}` ({{lines}})",
+  /** Placeholder for an occurrence whose extractor recorded no line. */
+  lineUnknown: "?"
 };
 
 // plugins/core/analyzers/reference-redundant/index.ts
-var ID21 = "reference-redundant";
+var ID22 = "reference-redundant";
 var referenceRedundantAnalyzer = {
-  id: ID21,
+  id: ID22,
   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).",
@@ -2961,14 +3125,13 @@ var referenceRedundantAnalyzer = {
       const [source, resolvedTarget] = key.split("\0");
       const flat = flattenOccurrences(links);
       issues.push({
-        analyzerId: ID21,
-        severity: "warn",
+        analyzerId: ID22,
+        severity: "info",
         nodeIds: [source],
         message: tx(REFERENCE_REDUNDANT_TEXTS.message, {
-          source,
           resolvedTarget,
           count: flat.length,
-          occurrences: flat.map(formatOccurrence).join(REFERENCE_REDUNDANT_TEXTS.occurrenceSeparator)
+          occurrences: formatGroupedOccurrences(flat)
         }),
         data: {
           target: resolvedTarget,
@@ -3015,11 +3178,19 @@ function flattenOccurrences(links) {
   });
   return out;
 }
-function formatOccurrence(occ) {
-  if (occ.line === null) {
-    return tx(REFERENCE_REDUNDANT_TEXTS.occurrenceUnknownLine, { trigger: occ.originalTrigger, kind: occ.kind });
-  }
-  return tx(REFERENCE_REDUNDANT_TEXTS.occurrence, { trigger: occ.originalTrigger, kind: occ.kind, line: occ.line });
+function formatGroupedOccurrences(occurrences) {
+  const byTrigger = /* @__PURE__ */ new Map();
+  for (const occ of occurrences) {
+    const bucket = byTrigger.get(occ.originalTrigger);
+    if (bucket) bucket.push(occ);
+    else byTrigger.set(occ.originalTrigger, [occ]);
+  }
+  return [...byTrigger.entries()].map(
+    ([trigger, occs]) => tx(REFERENCE_REDUNDANT_TEXTS.occurrence, {
+      trigger,
+      lines: occs.map((o) => o.line === null ? REFERENCE_REDUNDANT_TEXTS.lineUnknown : String(o.line)).join(", ")
+    })
+  ).join(REFERENCE_REDUNDANT_TEXTS.occurrenceSeparator);
 }
 function buildNameIndex2(nodes) {
   const out = /* @__PURE__ */ new Map();
@@ -3311,12 +3482,14 @@ function existsSyncSafe(path) {
 
 // plugins/core/analyzers/schema-violation/text.ts
 var SCHEMA_VIOLATION_TEXTS = {
-  /** `Node <path> failed schema validation: <errors>` */
-  nodeFailure: "Node {{path}} failed schema validation: {{errors}}",
-  /** `Link <source> → <target> failed schema validation: <errors>` */
-  linkFailure: "Link {{source}} \u2192 {{target}} failed schema validation: {{errors}}",
-  /** `Node <path> is missing required frontmatter fields: <missing>` */
-  frontmatterBaseFailure: "Node {{path}} is missing required frontmatter fields: {{missing}}.",
+  // Compact finding grammar: the affected node (or the link's source)
+  // is the finding's own node, so its path never appears.
+  /** `Schema validation failed: <errors>` */
+  nodeFailure: "Schema validation failed: {{errors}}",
+  /** `<target>:\nLink failed schema validation: <errors>` */
+  linkFailure: "{{target}}:\nLink failed schema validation: {{errors}}",
+  /** `Missing required frontmatter: <missing>.` */
+  frontmatterBaseFailure: "Missing required frontmatter: {{missing}}.",
   /** Singular tooltip on the alert / chip when a node has exactly one validation failure. */
   alertTooltipSingle: "Frontmatter or schema validation failed.",
   /** Plural tooltip; `{{count}}` capped at 99 in the chip badge but the tooltip text shows the raw count. */
@@ -3324,9 +3497,9 @@ var SCHEMA_VIOLATION_TEXTS = {
 };
 
 // plugins/core/analyzers/schema-violation/index.ts
-var ID22 = "schema-violation";
+var ID23 = "schema-violation";
 var schemaViolationAnalyzer = {
-  id: ID22,
+  id: ID23,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags nodes or links that violate the project schemas.",
@@ -3377,7 +3550,7 @@ function collectNodeFindings(v, node, out) {
   const result = v.validate("node", toNodeForSchema(node));
   if (result.ok) return;
   out.push({
-    analyzerId: ID22,
+    analyzerId: ID23,
     severity: "error",
     nodeIds: [node.path],
     message: tx(SCHEMA_VIOLATION_TEXTS.nodeFailure, {
@@ -3396,7 +3569,7 @@ function collectFrontmatterBaseFindings(node, out) {
   if (isMissingStringField(fm, "description")) missing.push("description");
   if (missing.length === 0) return;
   out.push({
-    analyzerId: ID22,
+    analyzerId: ID23,
     // `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
@@ -3418,7 +3591,7 @@ function collectLinkFindings(v, link, out) {
   const result = v.validate("link", toLinkForSchema(link));
   if (result.ok) return;
   out.push({
-    analyzerId: ID22,
+    analyzerId: ID23,
     severity: "error",
     nodeIds: [link.source],
     message: tx(SCHEMA_VIOLATION_TEXTS.linkFailure, {
@@ -3473,7 +3646,7 @@ var SIGNAL_COLLISION_TEXTS = {
    * the same paragraph, the markdown-link wins and the at-directive
    * silently disappears without this warning).
    */
-  message: "{{loserExtractor}} detected `{{loserRaw}}` at offset {{loserRange}} but {{winnerExtractor}}'s detection at {{winnerRange}} won the overlap collision ({{reason}}). The graph shows the winning edge only; the loser is not persisted.",
+  message: "`{{loserRaw}}`:\nOverlap collision: {{loserExtractor}} (at {{loserRange}}) lost to {{winnerExtractor}} (at {{winnerRange}}) by {{reason}}; only the winning edge persists.",
   /**
    * Same warn but for the rare case the resolver rejected a Signal
    * because the operator disabled its extractor via
@@ -3482,20 +3655,20 @@ var SIGNAL_COLLISION_TEXTS = {
    * resolver; documented now so the analyzer stays forward-compatible
    * with the upcoming filter pass.
    */
-  messageExtractorDisabled: "Extension `{{extractorId}}` is disabled; its detection `{{loserRaw}}` (offset {{loserRange}}) did not produce a Link. Re-enable the extension in Settings or via `sm plugins enable` to surface its edges.",
+  messageExtractorDisabled: "`{{loserRaw}}`:\nDropped: extension `{{extractorId}}` is disabled. Re-enable it in Settings or via `sm plugins enable`.",
   /**
    * Same warn but for the future confidence floor case. Phase 4+ stub:
    * today the resolver materialises every winning candidate regardless
    * of confidence, so this template is unreachable; documented for
    * forward compatibility.
    */
-  messageBelowFloor: "Detection `{{loserRaw}}` (offset {{loserRange}}, confidence {{confidence}}) fell below the configured threshold {{threshold}} and was dropped."
+  messageBelowFloor: "`{{loserRaw}}`:\nDropped: confidence {{confidence}} is below the threshold {{threshold}}."
 };
 
 // plugins/core/analyzers/signal-collision/index.ts
-var ID23 = "signal-collision";
+var ID24 = "signal-collision";
 var signalCollisionAnalyzer = {
-  id: ID23,
+  id: ID24,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Reports when two extractors fight over the same span of body text, or when a candidate link is dropped (extractor disabled, confidence too low) before it reaches the graph.",
@@ -3520,7 +3693,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: ID23,
+      analyzerId: ID24,
       severity: "warn",
       nodeIds: [signal.source],
       message: tx(SIGNAL_COLLISION_TEXTS.message, {
@@ -3553,158 +3726,42 @@ function makeIssue(signal) {
   if (resolution.extractorDisabled) {
     const loserRange = signal.range ? `${signal.range.start}-${signal.range.end}` : "unknown";
     return {
-      analyzerId: ID23,
+      analyzerId: ID24,
       severity: "warn",
       nodeIds: [signal.source],
       message: tx(SIGNAL_COLLISION_TEXTS.messageExtractorDisabled, {
         extractorId: resolution.extractorDisabled.extractorId,
         loserRaw: signal.raw,
-        loserRange
-      }),
-      data: {
-        extractorDisabled: resolution.extractorDisabled,
-        raw: signal.raw,
-        range: signal.range ?? null
-      }
-    };
-  }
-  if (resolution.belowFloor) {
-    const loserRange = signal.range ? `${signal.range.start}-${signal.range.end}` : "unknown";
-    const topCandidate = signal.candidates[0];
-    return {
-      analyzerId: ID23,
-      severity: "warn",
-      nodeIds: [signal.source],
-      message: tx(SIGNAL_COLLISION_TEXTS.messageBelowFloor, {
-        loserRaw: signal.raw,
-        loserRange,
-        confidence: topCandidate.confidence,
-        threshold: resolution.belowFloor.threshold
-      }),
-      data: {
-        belowFloor: resolution.belowFloor,
-        raw: signal.raw,
-        range: signal.range ?? null
-      }
-    };
-  }
-  return null;
-}
-
-// plugins/core/analyzers/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/analyzers/supersede/index.ts
-var ID24 = "supersede";
-var supersedeButton = {
-  slot: "inspector.action.button",
-  priority: 10
-};
-var supersedeAnalyzer = {
-  id: ID24,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "analyzer",
-  description: 'Projects the inspector "Supersede" button (declares a node replaced by another).',
-  mode: "deterministic",
-  ui: { supersedeButton },
-  evaluate(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);
-    }
-    return [];
-  }
-};
-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;
-}
-
-// plugins/core/analyzers/tags/text.ts
-var TAGS_TEXTS = {
-  /** Label of the inspector action button that edits the node's tags. */
-  editLabel: "Edit tags",
-  /** Prompt label for the string-list tags input. */
-  promptLabel: "Tags"
-};
-
-// plugins/core/analyzers/tags/index.ts
-var ID25 = "tags";
-var setTagsButton = {
-  slot: "inspector.action.button",
-  priority: 15
-};
-var tagsAnalyzer = {
-  id: ID25,
-  pluginId: CORE_PLUGIN_ID,
-  kind: "analyzer",
-  description: `Projects the inspector "Edit tags" button (edits a node's taxonomy tags).`,
-  mode: "deterministic",
-  ui: { setTagsButton },
-  evaluate(ctx) {
-    for (const node of ctx.nodes) {
-      if (node.sidecar?.present !== true) continue;
-      emitSetTagsButton(ctx, node);
-    }
-    return [];
+        loserRange
+      }),
+      data: {
+        extractorDisabled: resolution.extractorDisabled,
+        raw: signal.raw,
+        range: signal.range ?? null
+      }
+    };
   }
-};
-function emitSetTagsButton(ctx, node) {
-  ctx.emitContribution(node.path, setTagsButton, {
-    actionId: "core/node-set-tags",
-    label: TAGS_TEXTS.editLabel,
-    icon: "pi-tags",
-    enabled: true,
-    prompt: {
-      inputType: "string-list",
-      paramKey: "tags",
-      label: TAGS_TEXTS.promptLabel,
-      defaultValue: currentTags(node)
-    }
-  });
-}
-function currentTags(node) {
-  const ann = node.sidecar?.annotations;
-  if (!ann || typeof ann !== "object" || Array.isArray(ann)) return [];
-  const value = ann["tags"];
-  if (!Array.isArray(value)) return [];
-  return value.filter((t) => typeof t === "string");
+  if (resolution.belowFloor) {
+    const loserRange = signal.range ? `${signal.range.start}-${signal.range.end}` : "unknown";
+    const topCandidate = signal.candidates[0];
+    return {
+      analyzerId: ID24,
+      severity: "warn",
+      nodeIds: [signal.source],
+      message: tx(SIGNAL_COLLISION_TEXTS.messageBelowFloor, {
+        loserRaw: signal.raw,
+        loserRange,
+        confidence: topCandidate.confidence,
+        threshold: resolution.belowFloor.threshold
+      }),
+      data: {
+        belowFloor: resolution.belowFloor,
+        raw: signal.raw,
+        range: signal.range ?? null
+      }
+    };
+  }
+  return null;
 }
 
 // plugins/core/analyzers/trigger-collision/text.ts
@@ -3714,18 +3771,18 @@ var TRIGGER_COLLISION_TEXTS = {
    * cause part. Used for the advertiser-ambiguous-only, invocation-
    * ambiguous-only, and cross-kind-only branches.
    */
-  messageOnePart: 'Trigger "{{normalized}}" has {{part}}.',
+  messageOnePart: '"{{normalized}}":\nTrigger collision: {{part}}.',
   /**
    * Top-level message when `analyzeTriggerBucket` accumulated two cause
    * parts (advertiser-ambiguous AND invocation-ambiguous fire together).
    * The joiner lives inside the template so future locales can adapt it
    * (e.g. `'; y '` in Spanish) without touching the rule code.
    */
-  messageTwoParts: 'Trigger "{{normalized}}" has {{first}}; and {{second}}.',
-  /** `<n> nodes advertise it: <list>` part, fires on the advertiser-ambiguous branch. */
-  partAdvertisers: "{{count}} nodes advertise it: {{paths}}",
-  /** `<n> distinct invocation forms: <list>` part, fires on the invocation-ambiguous branch. */
-  partInvocations: "{{count}} distinct invocation forms: {{forms}}",
+  messageTwoParts: '"{{normalized}}":\nTrigger collision: {{first}}; and {{second}}.',
+  /** `<n> advertisers: <list>` part, fires on the advertiser-ambiguous branch. */
+  partAdvertisers: "{{count}} advertisers: {{paths}}",
+  /** `<n> invocation forms: <list>` part, fires on the invocation-ambiguous branch. */
+  partInvocations: "{{count}} invocation forms: {{forms}}",
   /** Singular cross-kind cause: `non-canonical invocation <form> against advertiser <path>`. */
   partNonCanonicalSingular: "non-canonical invocation {{forms}} against advertiser {{advertiser}}",
   /** Plural cross-kind cause: `non-canonical invocations <forms> against advertiser <path>`. */
@@ -3733,14 +3790,14 @@ var TRIGGER_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/trigger-collision/index.ts
-var ID26 = "trigger-collision";
+var ID25 = "trigger-collision";
 var ADVERTISING_KINDS = /* @__PURE__ */ new Set([
   "command",
   "skill",
   "agent"
 ]);
 var triggerCollisionAnalyzer = {
-  id: ID26,
+  id: ID25,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   mode: "deterministic",
@@ -3838,7 +3895,7 @@ function analyzeTriggerBucket(normalized, claims) {
     part: parts[0]
   });
   return {
-    analyzerId: ID26,
+    analyzerId: ID25,
     severity: "error",
     nodeIds,
     message,
@@ -3878,13 +3935,13 @@ var ASCII_FORMATTER_TEXTS = {
 };
 
 // plugins/core/formatters/ascii/index.ts
-var ID27 = "ascii";
+var ID26 = "ascii";
 var KIND_ORDER = ["agent", "command", "skill", "markdown"];
 var asciiFormatter = {
-  id: ID27,
+  id: ID26,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
-  formatId: ID27,
+  formatId: ID26,
   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
@@ -3978,13 +4035,13 @@ function renderSection(out, kind, group) {
 }
 
 // plugins/core/formatters/json/index.ts
-var ID28 = "json";
+var ID27 = "json";
 var jsonFormatter = {
-  id: ID28,
+  id: ID27,
   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: ID28,
+  formatId: ID27,
   format(ctx) {
     if (ctx.scanResult !== void 0) {
       return JSON.stringify(ctx.scanResult);
@@ -4122,14 +4179,33 @@ function resolveSpecRoot2() {
   }
 }
 
+// plugins/core/actions/node-bump/text.ts
+var BUMP_TEXTS = {
+  /** Label of the inspector action button that dispatches a bump. */
+  bumpLabel: "Bump",
+  /** Tooltip shown when the bump button is disabled (the node is fresh, no drift). */
+  bumpDisabledReason: "No drift to bump."
+};
+
 // plugins/core/actions/node-bump/index.ts
-var ID29 = "node-bump";
+var ID28 = "node-bump";
+var bumpButton = {
+  slot: "inspector.action.button",
+  priority: 10
+};
 var nodeBumpAction = {
-  id: ID29,
+  id: ID28,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Marks a node as updated: bumps `annotations.version`, refreshes sidecar hashes, and records the timestamp.",
   mode: "deterministic",
+  ui: { bumpButton },
+  project(ctx) {
+    for (const node of ctx.nodes) {
+      if (node.sidecar?.present !== true) continue;
+      emitBumpButton(ctx, node.path, staleStatus2(node.sidecar) !== null);
+    }
+  },
   // The runtime contract uses generic <TInput, TReport>; bump narrows
   // both. The cast is the standard pattern for built-ins that want
   // typed local I/O while staying compatible with the open generic.
@@ -4138,6 +4214,20 @@ var nodeBumpAction = {
     return invokeBump(input, ctx);
   }
 };
+function emitBumpButton(ctx, nodePath, enabled) {
+  ctx.emitContribution(nodePath, bumpButton, {
+    actionId: "core/node-bump",
+    label: BUMP_TEXTS.bumpLabel,
+    icon: "pi-arrow-up-right",
+    enabled,
+    ...enabled ? {} : { disabledReason: BUMP_TEXTS.bumpDisabledReason }
+  });
+}
+function staleStatus2(overlay) {
+  const status = overlay?.status;
+  if (status === void 0 || status === null || status === "fresh") return null;
+  return status;
+}
 function invokeBump(input, ctx) {
   const overlay = ctx.node.sidecar ?? null;
   const isFresh = overlay?.present === true && overlay.status === "fresh";
@@ -4184,9 +4274,9 @@ function pickCurrentVersion(overlay) {
 
 // plugins/core/actions/node-set-stability/index.ts
 var STABILITY_VALUES = ["experimental", "stable", "deprecated"];
-var ID30 = "node-set-stability";
+var ID29 = "node-set-stability";
 var nodeSetStabilityAction = {
-  id: ID30,
+  id: ID29,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the lifecycle stage of the current node (writes `stability` to the sidecar).",
@@ -4225,14 +4315,33 @@ function invokeSetStability(input, ctx) {
   return { report, writes: [write] };
 }
 
+// plugins/core/actions/node-set-tags/text.ts
+var TAGS_TEXTS = {
+  /** Label of the inspector action button that edits the node's tags. */
+  editLabel: "Edit tags",
+  /** Prompt label for the string-list tags input. */
+  promptLabel: "Tags"
+};
+
 // plugins/core/actions/node-set-tags/index.ts
-var ID31 = "node-set-tags";
+var ID30 = "node-set-tags";
+var setTagsButton = {
+  slot: "inspector.action.button",
+  priority: 15
+};
 var nodeSetTagsAction = {
-  id: ID31,
+  id: ID30,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the taxonomy tags of the current node (writes `tags` to the sidecar; whole-array replace).",
   mode: "deterministic",
+  ui: { setTagsButton },
+  project(ctx) {
+    for (const node of ctx.nodes) {
+      if (node.sidecar?.present !== true) continue;
+      emitSetTagsButton(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.
@@ -4241,6 +4350,27 @@ var nodeSetTagsAction = {
     return invokeSetTags(input, ctx);
   }
 };
+function emitSetTagsButton(ctx, node) {
+  ctx.emitContribution(node.path, setTagsButton, {
+    actionId: "core/node-set-tags",
+    label: TAGS_TEXTS.editLabel,
+    icon: "pi-tags",
+    enabled: true,
+    prompt: {
+      inputType: "string-list",
+      paramKey: "tags",
+      label: TAGS_TEXTS.promptLabel,
+      defaultValue: currentTags(node)
+    }
+  });
+}
+function currentTags(node) {
+  const ann = node.sidecar?.annotations;
+  if (!ann || typeof ann !== "object" || Array.isArray(ann)) return [];
+  const value = ann["tags"];
+  if (!Array.isArray(value)) return [];
+  return value.filter((t) => typeof t === "string");
+}
 function invokeSetTags(input, ctx) {
   const tags = Array.isArray(input.tags) ? input.tags : [];
   const timestamp = ctx.now().toISOString();
@@ -4264,14 +4394,44 @@ 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 ID32 = "node-supersede";
+var ID31 = "node-supersede";
+var supersedeButton = {
+  slot: "inspector.action.button",
+  priority: 10
+};
 var nodeSupersedeAction = {
-  id: ID32,
+  id: ID31,
   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.
@@ -4280,6 +4440,35 @@ var nodeSupersedeAction = {
     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) {
@@ -4785,15 +4974,16 @@ var updateCheckHook = {
 var claudeProvider2 = { ...claudeProvider, pluginId: "claude", version: VERSION };
 var atDirectiveExtractor2 = { ...atDirectiveExtractor, pluginId: "claude", version: VERSION };
 var slashCommandExtractor2 = { ...slashCommandExtractor, pluginId: "claude", version: VERSION };
+var toolsCounterExtractor2 = { ...toolsCounterExtractor, pluginId: "claude", version: VERSION };
 var antigravityProvider2 = { ...antigravityProvider, pluginId: "antigravity", version: VERSION };
 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 };
 var mcpToolsExtractor2 = { ...mcpToolsExtractor, pluginId: "core", version: VERSION };
-var toolsCounterExtractor2 = { ...toolsCounterExtractor, pluginId: "core", version: VERSION };
 var annotationFieldUnknownAnalyzer2 = { ...annotationFieldUnknownAnalyzer, pluginId: "core", version: VERSION };
 var annotationOrphanAnalyzer2 = { ...annotationOrphanAnalyzer, pluginId: "core", version: VERSION };
 var annotationStaleAnalyzer2 = { ...annotationStaleAnalyzer, pluginId: "core", version: VERSION };
@@ -4810,8 +5000,6 @@ var referenceBrokenAnalyzer2 = { ...referenceBrokenAnalyzer, pluginId: "core", v
 var referenceRedundantAnalyzer2 = { ...referenceRedundantAnalyzer, pluginId: "core", version: VERSION };
 var schemaViolationAnalyzer2 = { ...schemaViolationAnalyzer, pluginId: "core", version: VERSION };
 var signalCollisionAnalyzer2 = { ...signalCollisionAnalyzer, pluginId: "core", version: VERSION };
-var supersedeAnalyzer2 = { ...supersedeAnalyzer, pluginId: "core", version: VERSION };
-var tagsAnalyzer2 = { ...tagsAnalyzer, pluginId: "core", version: VERSION };
 var triggerCollisionAnalyzer2 = { ...triggerCollisionAnalyzer, pluginId: "core", version: VERSION };
 var asciiFormatter2 = { ...asciiFormatter, pluginId: "core", version: VERSION };
 var jsonFormatter2 = { ...jsonFormatter, pluginId: "core", version: VERSION };
@@ -4827,7 +5015,8 @@ var builtInPlugins = [
     extensions: [
       claudeProvider2,
       atDirectiveExtractor2,
-      slashCommandExtractor2
+      slashCommandExtractor2,
+      toolsCounterExtractor2
     ]
   },
   {
@@ -4857,10 +5046,10 @@ var builtInPlugins = [
     extensions: [
       coreMarkdownProvider2,
       annotationsExtractor2,
+      backtickPathExtractor2,
       externalUrlCounterExtractor2,
       markdownLinkExtractor2,
       mcpToolsExtractor2,
-      toolsCounterExtractor2,
       annotationFieldUnknownAnalyzer2,
       annotationOrphanAnalyzer2,
       annotationStaleAnalyzer2,
@@ -4877,8 +5066,6 @@ var builtInPlugins = [
       referenceRedundantAnalyzer2,
       schemaViolationAnalyzer2,
       signalCollisionAnalyzer2,
-      supersedeAnalyzer2,
-      tagsAnalyzer2,
       triggerCollisionAnalyzer2,
       asciiFormatter2,
       jsonFormatter2,
@@ -6287,7 +6474,7 @@ function resolveSpecRoot3() {
 }
 
 // cli/i18n/bump.texts.ts
-var BUMP_TEXTS = {
+var BUMP_TEXTS2 = {
   // --- argument validation --------------------------------------------------
   /**
    * §3.1b two-line block. Mutex between the positional <node.path> and
@@ -7784,7 +7971,8 @@ var LINK_KIND_VALUES = Object.freeze([
   "invokes",
   "references",
   "mentions",
-  "supersedes"
+  "supersedes",
+  "points"
 ]);
 var SEVERITY_VALUES = Object.freeze([
   "error",
@@ -7977,6 +8165,7 @@ function rowToNode(row) {
     const parsed = JSON.parse(row.externalRefsJson);
     if (Array.isArray(parsed) && parsed.length > 0) node.externalRefs = parsed;
   }
+  if (row.modifiedAtMs !== null) node.modifiedAtMs = row.modifiedAtMs;
   return node;
 }
 function rowToLink(row) {
@@ -8493,7 +8682,10 @@ function nodeToRow(node, scannedAt) {
     // the column stays sparse for nodes whose bodies have no http(s)
     // URLs at all. Round-tripped by `rowToNode` on load.
     externalRefsJson: node.externalRefs && node.externalRefs.length > 0 ? JSON.stringify(node.externalRefs) : null,
-    scannedAt
+    scannedAt,
+    // File mtime (Unix ms) from the walker; NULL for virtual / derived
+    // nodes that carry no backing file. Round-tripped by `rowToNode`.
+    modifiedAtMs: node.modifiedAtMs ?? null
   };
 }
 function projectAnnotationColumns(node) {
@@ -9494,10 +9686,10 @@ var BumpCommand = class extends SmCommand {
     );
     if (!persisted) {
       this.printer.error(
-        tx(BUMP_TEXTS.nodeNotFound, {
+        tx(BUMP_TEXTS2.nodeNotFound, {
           glyph: ansi.red("\u2715"),
           nodePath: this.nodePath ?? "<pending>",
-          hint: ansi.dim(BUMP_TEXTS.nodeNotFoundHint)
+          hint: ansi.dim(BUMP_TEXTS2.nodeNotFoundHint)
         })
       );
       return ExitCode.NotFound;
@@ -9517,27 +9709,27 @@ var BumpCommand = class extends SmCommand {
     const errGlyph = ansi.red("\u2715");
     if (this.pending && this.nodePath !== void 0) {
       this.printer.error(
-        tx(BUMP_TEXTS.nodeAndPendingMutex, {
+        tx(BUMP_TEXTS2.nodeAndPendingMutex, {
           glyph: errGlyph,
-          hint: ansi.dim(BUMP_TEXTS.nodeAndPendingMutexHint)
+          hint: ansi.dim(BUMP_TEXTS2.nodeAndPendingMutexHint)
         })
       );
       return ExitCode.Error;
     }
     if (!this.pending && this.nodePath === void 0) {
       this.printer.error(
-        tx(BUMP_TEXTS.noTargetSpecified, {
+        tx(BUMP_TEXTS2.noTargetSpecified, {
           glyph: errGlyph,
-          hint: ansi.dim(BUMP_TEXTS.noTargetSpecifiedHint)
+          hint: ansi.dim(BUMP_TEXTS2.noTargetSpecifiedHint)
         })
       );
       return ExitCode.Error;
     }
     if (this.staged && !this.pending) {
       this.printer.error(
-        tx(BUMP_TEXTS.stagedRequiresPending, {
+        tx(BUMP_TEXTS2.stagedRequiresPending, {
           glyph: errGlyph,
-          hint: ansi.dim(BUMP_TEXTS.stagedRequiresPendingHint)
+          hint: ansi.dim(BUMP_TEXTS2.stagedRequiresPendingHint)
         })
       );
       return ExitCode.Error;
@@ -9596,10 +9788,10 @@ var BumpCommand = class extends SmCommand {
     const node = nodes.find((n) => n.path === this.nodePath);
     if (!node) {
       this.printer.error(
-        tx(BUMP_TEXTS.nodeNotFound, {
+        tx(BUMP_TEXTS2.nodeNotFound, {
           glyph: ansi.red("\u2715"),
           nodePath: this.nodePath,
-          hint: ansi.dim(BUMP_TEXTS.nodeNotFoundHint)
+          hint: ansi.dim(BUMP_TEXTS2.nodeNotFoundHint)
         })
       );
       return ExitCode.NotFound;
@@ -9621,9 +9813,9 @@ var BumpCommand = class extends SmCommand {
     const errGlyph = ansi.red("\u2715");
     if (item.status === "error") {
       this.printer.error(
-        tx(BUMP_TEXTS.bumpFailed, {
+        tx(BUMP_TEXTS2.bumpFailed, {
           glyph: errGlyph,
-          message: tx(BUMP_TEXTS.resolveAbsPathFailed, {
+          message: tx(BUMP_TEXTS2.resolveAbsPathFailed, {
             nodePath: node.path,
             message: item.message
           })
@@ -9633,10 +9825,10 @@ var BumpCommand = class extends SmCommand {
     }
     if (item.status === "refused") {
       this.printer.error(
-        tx(BUMP_TEXTS.refusedFresh, {
+        tx(BUMP_TEXTS2.refusedFresh, {
           glyph: errGlyph,
           nodePath: node.path,
-          hint: ansi.dim(BUMP_TEXTS.refusedFreshHint)
+          hint: ansi.dim(BUMP_TEXTS2.refusedFreshHint)
         })
       );
       return ExitCode.Error;
@@ -9663,9 +9855,9 @@ var BumpCommand = class extends SmCommand {
     if (applied.error !== void 0) {
       if (applied.error instanceof EConsentRequiredError) throw applied.error;
       this.printer.error(
-        tx(BUMP_TEXTS.bumpFailed, {
+        tx(BUMP_TEXTS2.bumpFailed, {
           glyph: ansi.red("\u2715"),
-          message: tx(BUMP_TEXTS.storeFailedDetail, {
+          message: tx(BUMP_TEXTS2.storeFailedDetail, {
             path: applied.sidecarPath ?? sidecarPathFor(item.absPath),
             message: formatErrorMessage(applied.error)
           })
@@ -9682,11 +9874,11 @@ var BumpCommand = class extends SmCommand {
     const version = item.report.version ?? 1;
     if (item.report.createdSidecar === true) {
       this.printer.data(
-        tx(BUMP_TEXTS.bumpedCreated, { glyph: okGlyph, sidecarPath, nodePath: node.path, version })
+        tx(BUMP_TEXTS2.bumpedCreated, { glyph: okGlyph, sidecarPath, nodePath: node.path, version })
       );
     } else {
       this.printer.data(
-        tx(BUMP_TEXTS.bumped, { glyph: okGlyph, nodePath: node.path, version })
+        tx(BUMP_TEXTS2.bumped, { glyph: okGlyph, nodePath: node.path, version })
       );
     }
     return ExitCode.Ok;
@@ -9698,7 +9890,7 @@ var BumpCommand = class extends SmCommand {
     const stale = nodes.filter((n) => n.sidecar?.present === true && n.sidecar.status !== null && n.sidecar.status !== "fresh").sort((a, b) => a.path.localeCompare(b.path));
     if (stale.length === 0) return this.#renderEmptyPending();
     if (!this.json) {
-      this.printer.info(tx(BUMP_TEXTS.pendingBanner, { count: stale.length }));
+      this.printer.info(tx(BUMP_TEXTS2.pendingBanner, { count: stale.length }));
     }
     const plan = computeBumpPlan(stale, { cwd, force: this.force });
     const outcomes = await this.#executePending(plan, cwd, ansi);
@@ -9716,19 +9908,19 @@ var BumpCommand = class extends SmCommand {
     const gitOk = ensureGitForStaged(cwd);
     if (gitOk === "no-repo") {
       this.printer.error(
-        tx(BUMP_TEXTS.notInGitRepo, {
+        tx(BUMP_TEXTS2.notInGitRepo, {
           glyph: errGlyph,
           cwd,
-          hint: ansi.dim(BUMP_TEXTS.notInGitRepoHint)
+          hint: ansi.dim(BUMP_TEXTS2.notInGitRepoHint)
         })
       );
       return ExitCode.NotFound;
     }
     if (gitOk === "no-binary") {
       this.printer.error(
-        tx(BUMP_TEXTS.gitBinaryMissing, {
+        tx(BUMP_TEXTS2.gitBinaryMissing, {
           glyph: errGlyph,
-          hint: ansi.dim(BUMP_TEXTS.gitBinaryMissingHint)
+          hint: ansi.dim(BUMP_TEXTS2.gitBinaryMissingHint)
         })
       );
       return ExitCode.Error;
@@ -9766,7 +9958,7 @@ var BumpCommand = class extends SmCommand {
       return {
         nodePath: item.nodePath,
         status: "error",
-        message: tx(BUMP_TEXTS.storeFailedDetail, {
+        message: tx(BUMP_TEXTS2.storeFailedDetail, {
           path: applied.sidecarPath ?? sidecarPathFor(item.absPath),
           message: formatErrorMessage(applied.error)
         })
@@ -9786,11 +9978,11 @@ var BumpCommand = class extends SmCommand {
     const addErr = stageSidecar(cwd, sidecarPath);
     if (addErr === null || this.json) return;
     this.printer.warn(
-      tx(BUMP_TEXTS.gitAddFailed, {
+      tx(BUMP_TEXTS2.gitAddFailed, {
         glyph: ansi.yellow("\u26A0"),
         path: sidecarPath,
         message: addErr,
-        hint: ansi.dim(tx(BUMP_TEXTS.gitAddFailedHint, { path: sidecarPath }))
+        hint: ansi.dim(tx(BUMP_TEXTS2.gitAddFailedHint, { path: sidecarPath }))
       })
     );
   }
@@ -9810,7 +10002,7 @@ var BumpCommand = class extends SmCommand {
       this.printer.data(JSON.stringify(empty) + "\n");
       return ExitCode.Ok;
     }
-    this.printer.data(BUMP_TEXTS.pendingNone);
+    this.printer.data(BUMP_TEXTS2.pendingNone);
     return ExitCode.Ok;
   }
   // Complexity is from per-status rendering (4 status values) plus
@@ -9841,24 +10033,24 @@ var BumpCommand = class extends SmCommand {
     for (const o of outcomes) {
       if (o.status === "bumped") {
         this.printer.data(
-          tx(BUMP_TEXTS.bumpedItem, {
+          tx(BUMP_TEXTS2.bumpedItem, {
             nodePath: o.nodePath,
             version: o.version ?? 0,
             createdSuffix: o.createdSidecar === true ? " (new sidecar)" : ""
           })
         );
       } else if (o.status === "refused") {
-        this.printer.data(tx(BUMP_TEXTS.refusedItem, { nodePath: o.nodePath }));
+        this.printer.data(tx(BUMP_TEXTS2.refusedItem, { nodePath: o.nodePath }));
       } else if (o.status === "skipped") {
         this.printer.data(
-          tx(BUMP_TEXTS.skippedItem, {
+          tx(BUMP_TEXTS2.skippedItem, {
             nodePath: o.nodePath,
             reason: o.reason ?? "unknown"
           })
         );
       } else {
         this.printer.data(
-          tx(BUMP_TEXTS.errorItem, {
+          tx(BUMP_TEXTS2.errorItem, {
             nodePath: o.nodePath,
             message: o.message ?? ""
           })
@@ -9866,7 +10058,7 @@ var BumpCommand = class extends SmCommand {
       }
     }
     this.printer.info(
-      tx(BUMP_TEXTS.pendingSummary, {
+      tx(BUMP_TEXTS2.pendingSummary, {
         bumped: counts.bumped,
         refused: counts.refused,
         skipped: counts.skipped,
@@ -10802,11 +10994,13 @@ var PluginLoader = class {
     if (kind === "provider" && discoveredKinds) {
       instance["kinds"] = discoveredKinds;
     }
+    const stability = exported["stability"];
     return { ok: true, extension: {
       kind,
       id: pathId2,
       pluginId,
       version: exported["version"],
+      ...stability !== void 0 ? { stability } : {},
       entryPath: abs,
       module: mod,
       instance
@@ -10917,29 +11111,39 @@ function isPluginLocked(idOrQualified) {
 }
 
 // kernel/config/plugin-resolver.ts
-function resolvePluginEnabled(pluginId, cfg, dbOverrides) {
+var SHIPS_DISABLED = /* @__PURE__ */ new Set([
+  "experimental",
+  "deprecated"
+]);
+function installedDefaultEnabled(stability) {
+  return stability === void 0 || !SHIPS_DISABLED.has(stability);
+}
+function resolvePluginEnabled(pluginId, cfg, dbOverrides, installedDefault = true) {
   if (isPluginLocked(pluginId)) return true;
   if (dbOverrides.has(pluginId)) return dbOverrides.get(pluginId) === true;
   const settingsEntry = cfg.plugins[pluginId];
   if (settingsEntry?.enabled !== void 0) return settingsEntry.enabled;
-  return true;
+  return installedDefault;
 }
 function makeEnabledResolver(cfg, dbOverrides) {
-  return (pluginId) => resolvePluginEnabled(pluginId, cfg, dbOverrides);
+  return (pluginId, installedDefault) => resolvePluginEnabled(pluginId, cfg, dbOverrides, installedDefault);
 }
 
 // core/runtime/plugin-runtime/resolver.ts
-function defaultResolveEnabled(_id) {
-  return true;
+function defaultResolveEnabled(_id, installedDefault = true) {
+  return installedDefault;
 }
 function isBuiltInExtensionEnabled(plugin, ext, resolveEnabled) {
-  return isPluginEntryEnabled(plugin, ext.id, resolveEnabled);
+  return isPluginEntryEnabled(plugin, ext.id, resolveEnabled, ext.stability);
 }
-function isPluginEntryEnabled(plugin, extId, resolveEnabled) {
-  return resolveEnabled(qualifiedExtensionId(plugin.id, extId));
+function isPluginEntryEnabled(plugin, extId, resolveEnabled, stability) {
+  return resolveEnabled(qualifiedExtensionId(plugin.id, extId), installedDefaultEnabled(stability));
 }
 function isPluginExtensionEnabled(ext, resolveEnabled) {
-  return resolveEnabled(qualifiedExtensionId(ext.pluginId, ext.id));
+  return resolveEnabled(
+    qualifiedExtensionId(ext.pluginId, ext.id),
+    installedDefaultEnabled(ext.stability)
+  );
 }
 async function buildEnabledResolver(ctx) {
   const { effective: cfg } = loadConfig({ ...ctx });
@@ -11137,11 +11341,11 @@ async function* walkContent(roots, options) {
   const extensions = options.extensions;
   const sizeLimit = buildSizeLimit(options);
   for (const root of roots) {
-    for await (const file of walkRoot(root, root, filter, extensions, sizeLimit)) {
-      const relPath = relative2(root, file).split(sep3).join("/");
+    for await (const entry of walkRoot(root, root, filter, extensions, sizeLimit)) {
+      const relPath = relative2(root, entry.full).split(sep3).join("/");
       let raw;
       try {
-        raw = await readFile(file, "utf8");
+        raw = await readFile(entry.full, "utf8");
       } catch {
         continue;
       }
@@ -11151,6 +11355,9 @@ async function* walkContent(roots, options) {
         body: parsed.body,
         frontmatterRaw: parsed.frontmatterRaw,
         frontmatter: parsed.frontmatter,
+        // File mtime from the TOCTOU `lstat` (zero extra syscalls).
+        // Threaded onto the persisted `Node` as `modifiedAtMs`.
+        modifiedAtMs: entry.modifiedAtMs,
         // Audit L1: forward parser diagnostics (e.g. malformed YAML)
         // through the IRawNode surface so the orchestrator can
         // convert them into warn-level kernel `Issue` rows. Omitted
@@ -11191,7 +11398,7 @@ async function* walkRoot(root, current, filter, extensions, sizeLimit) {
           sizeLimit.onOversizedFile?.({ path: rel, bytes: s.size });
           continue;
         }
-        yield full;
+        yield { full, modifiedAtMs: Math.round(s.mtimeMs) };
       } catch {
       }
     }
@@ -11273,8 +11480,8 @@ function bucketLoaded(loaded, runtime, pluginOrder) {
       extractor: runtime.extensions.extractors,
       analyzer: runtime.extensions.analyzers,
       formatter: runtime.extensions.formatters,
-      hook: runtime.extensions.hooks
-      // `action` intentionally absent, see docstring.
+      hook: runtime.extensions.hooks,
+      action: runtime.extensions.actions
     });
     runtime.manifests.push({
       id: ext.id,
@@ -11389,7 +11596,7 @@ async function loadPluginRuntime(opts = {}) {
   const loader = createPluginLoader(loaderOpts);
   const discovered = await loader.discoverAndLoadAll();
   const runtime = {
-    extensions: { providers: [], extractors: [], analyzers: [], formatters: [], hooks: [] },
+    extensions: { providers: [], extractors: [], analyzers: [], formatters: [], hooks: [], actions: [] },
     annotationContributions: [],
     viewContributions: [],
     manifests: [],
@@ -11444,7 +11651,7 @@ function enforceRootExclusivity(catalog) {
 }
 function emptyPluginRuntime() {
   const runtime = {
-    extensions: { providers: [], extractors: [], analyzers: [], formatters: [], hooks: [] },
+    extensions: { providers: [], extractors: [], analyzers: [], formatters: [], hooks: [], actions: [] },
     annotationContributions: [],
     viewContributions: [],
     manifests: [],
@@ -11462,23 +11669,26 @@ function emptyPluginRuntime() {
 function collectRegisteredContributionKeys(composed) {
   const keys = /* @__PURE__ */ new Set();
   if (!composed) return keys;
-  for (const ext of [...composed.extractors, ...composed.analyzers]) {
-    const raw = ext.ui;
-    if (typeof raw !== "object" || raw === null) continue;
-    for (const [contributionId, value] of Object.entries(raw)) {
-      if (typeof value !== "object" || value === null) continue;
-      keys.add(`${ext.pluginId}/${ext.id}/${contributionId}`);
-    }
+  for (const ext of [...composed.extractors, ...composed.analyzers, ...composed.actions ?? []]) {
+    addContributionKeysForExtension(ext, keys);
   }
   return keys;
 }
+function addContributionKeysForExtension(ext, keys) {
+  const raw = ext.ui;
+  if (typeof raw !== "object" || raw === null) return;
+  for (const [contributionId, value] of Object.entries(raw)) {
+    if (typeof value !== "object" || value === null) continue;
+    keys.add(`${ext.pluginId}/${ext.id}/${contributionId}`);
+  }
+}
 function filterBuiltInManifests(manifests, resolveEnabled) {
   const pluginById = /* @__PURE__ */ new Map();
   for (const plugin of builtInPlugins) pluginById.set(plugin.id, plugin);
   return manifests.filter((m) => {
     const plugin = pluginById.get(m.pluginId);
     if (!plugin) return true;
-    return isPluginEntryEnabled(plugin, m.id, resolveEnabled);
+    return isPluginEntryEnabled(plugin, m.id, resolveEnabled, m.stability);
   });
 }
 
@@ -11489,9 +11699,10 @@ function composeScanExtensions(opts) {
   const extractors = [];
   const analyzers = [];
   const hooks = [];
+  const actions = [];
   if (!opts.noBuiltIns) {
     accumulateBuiltInScanExtensions(
-      { providers, extractors, analyzers, hooks },
+      { providers, extractors, analyzers, hooks, actions },
       resolveEnabled
     );
   }
@@ -11507,6 +11718,9 @@ function composeScanExtensions(opts) {
   for (const ext of opts.pluginRuntime.extensions.hooks) {
     if (isPluginExtensionEnabled(ext, resolveEnabled)) hooks.push(ext);
   }
+  for (const ext of opts.pluginRuntime.extensions.actions) {
+    if (isPluginExtensionEnabled(ext, resolveEnabled)) actions.push(ext);
+  }
   const finalProviders = opts.killSwitches?.providers === true ? [] : providers;
   const finalExtractors = opts.killSwitches?.extractors === true ? [] : extractors;
   const finalAnalyzers = opts.killSwitches?.analyzers === true ? [] : analyzers;
@@ -11517,7 +11731,8 @@ function composeScanExtensions(opts) {
     providers: finalProviders,
     extractors: finalExtractors,
     analyzers: finalAnalyzers,
-    hooks
+    hooks,
+    actions
   };
 }
 function accumulateBuiltInScanExtensions(buckets, resolveEnabled) {
@@ -11538,6 +11753,7 @@ function accumulateBuiltInScanExtensions(buckets, resolveEnabled) {
           buckets.hooks.push(ext);
           break;
         case "action":
+          buckets.actions.push(ext);
           break;
         case "formatter":
           break;
@@ -11796,7 +12012,7 @@ function renderHuman(issues, ansi) {
         tx(CHECK_TEXTS.issueRow, {
           glyph: severityGlyph(row.severity, ansi),
           analyzerId: ansi.dim(row.analyzerId.padEnd(analyzerWidth)),
-          message: trimRedundantPath(row.message, row.primary)
+          message: flattenMessage(trimRedundantPath(row.message, row.primary))
         })
       );
     }
@@ -11850,6 +12066,9 @@ function trimRedundantPath(message, primary) {
   if (!message.includes(needle)) return message;
   return message.replace(needle, "");
 }
+function flattenMessage(message) {
+  return message.replace(/\n+/g, " ");
+}
 
 // cli/commands/config.ts
 import { existsSync as existsSync16 } from "fs";
@@ -15823,8 +16042,9 @@ function buildVirtualNode(extractor, emitted, emitter) {
   if (emitted.frontmatter) node.frontmatter = emitted.frontmatter;
   return node;
 }
+var KNOWN_LINK_KINDS = ["invokes", "references", "mentions", "supersedes", "points"];
 function validateLink(extractor, link, emitter) {
-  const knownKinds = ["invokes", "references", "mentions", "supersedes"];
+  const knownKinds = KNOWN_LINK_KINDS;
   if (!knownKinds.includes(link.kind)) {
     const qualifiedId2 = `${extractor.pluginId}/${extractor.id}`;
     emitter.emit(
@@ -15859,7 +16079,6 @@ function validateLink(extractor, link, emitter) {
   const confidence = c ?? ConfidenceTier.MEDIUM;
   return { ...link, confidence };
 }
-var KNOWN_LINK_KINDS = ["invokes", "references", "mentions", "supersedes"];
 function validateSignal(extractor, signal, emitter) {
   const qualifiedId2 = qualifiedExtensionId(extractor.pluginId, extractor.id);
   if (!Array.isArray(signal.candidates) || signal.candidates.length === 0) {
@@ -15978,12 +16197,87 @@ function recomputeExternalRefsCount(nodes, externalLinks, cachedPaths) {
     });
     source.externalRefs = refs;
   }
-}
-var EXTERNAL_URL_SCHEME_RE = /^[a-z][a-z0-9+\-.]+:/i;
-var VIRTUAL_NODE_SCHEME_RE = /^mcp:\/\//i;
-function isExternalUrlLink(link) {
-  if (VIRTUAL_NODE_SCHEME_RE.test(link.target)) return false;
-  return EXTERNAL_URL_SCHEME_RE.test(link.target);
+}
+var EXTERNAL_URL_SCHEME_RE = /^[a-z][a-z0-9+\-.]+:/i;
+var VIRTUAL_NODE_SCHEME_RE = /^mcp:\/\//i;
+function isExternalUrlLink(link) {
+  if (VIRTUAL_NODE_SCHEME_RE.test(link.target)) return false;
+  return EXTERNAL_URL_SCHEME_RE.test(link.target);
+}
+
+// kernel/orchestrator/action-projections.ts
+function runActionProjections(actions, nodes, links, emitter) {
+  const contributions = [];
+  const contributionErrors = [];
+  const validators = loadSchemaValidators();
+  for (const action of actions) {
+    if (typeof action.project !== "function") continue;
+    const qualifiedId2 = qualifiedExtensionId(action.pluginId, action.id);
+    const declaredContributions = readDeclaredContributionRefs(action);
+    const emitContribution = (nodePath, ref, payload) => {
+      const declared = typeof ref === "object" && ref !== null ? declaredContributions.get(ref) : void 0;
+      if (!declared) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionUndeclaredRef, {
+          extractorId: qualifiedId2,
+          nodePath
+        });
+        emitExtensionError(emitter, qualifiedId2, nodePath, {
+          phase: "emitContribution",
+          reason: "undeclared-contribution-ref",
+          message
+        });
+        contributionErrors.push({
+          pluginId: action.pluginId,
+          extensionId: action.id,
+          nodePath,
+          reason: "undeclared-contribution-ref",
+          message,
+          emittedAt: Date.now()
+        });
+        return;
+      }
+      const result = validators.validateContributionPayload(declared.slot, payload);
+      if (!result.ok) {
+        const message = tx(ORCHESTRATOR_TEXTS.extensionErrorContributionPayloadInvalid, {
+          extractorId: qualifiedId2,
+          contributionId: declared.id,
+          nodePath,
+          slot: declared.slot,
+          errors: result.errors
+        });
+        emitExtensionError(emitter, qualifiedId2, nodePath, {
+          phase: "emitContribution",
+          contributionId: declared.id,
+          slot: declared.slot,
+          reason: result.errors,
+          message
+        });
+        contributionErrors.push({
+          pluginId: action.pluginId,
+          extensionId: action.id,
+          nodePath,
+          reason: result.errors,
+          message,
+          contributionId: declared.id,
+          slot: declared.slot,
+          emittedAt: Date.now()
+        });
+        return;
+      }
+      contributions.push({
+        pluginId: action.pluginId,
+        extensionId: action.id,
+        nodePath,
+        contributionId: declared.id,
+        slot: declared.slot,
+        payload,
+        emittedAt: Date.now()
+      });
+    };
+    const ctx = { nodes, links, emitContribution };
+    action.project(ctx);
+  }
+  return { contributions, contributionErrors };
 }
 
 // kernel/orchestrator/analyzers.ts
@@ -16775,6 +17069,7 @@ function buildNode(args2) {
     externalRefsCount: 0,
     frontmatter: args2.frontmatter
   };
+  if (args2.modifiedAtMs !== void 0) node.modifiedAtMs = args2.modifiedAtMs;
   if (args2.encoder) {
     node.tokens = countTokens(args2.encoder, args2.frontmatterRaw, args2.body);
   }
@@ -16890,7 +17185,10 @@ function buildFreshNodeAndValidateFrontmatter(opts) {
     frontmatter: opts.raw.frontmatter,
     bodyHash: opts.bodyHash,
     frontmatterHash: opts.frontmatterHash,
-    encoder: opts.encoder
+    encoder: opts.encoder,
+    // Thread the walker's mtime through; `buildNode` only attaches it
+    // when present, so virtual / walk()-without-stat sources stay absent.
+    modifiedAtMs: opts.raw.modifiedAtMs
   });
   const frontmatterIssues = [];
   if (opts.raw.parseIssues && opts.raw.parseIssues.length > 0) {
@@ -17324,6 +17622,13 @@ async function runScanInternal(_kernel, options) {
     walked.frontmatterIssues
   );
   mergeAnalyzerEmissions(walked, analyzerResult, exts.analyzers);
+  const projectionResult = runActionProjections(
+    exts.actions ?? [],
+    walked.nodes,
+    walked.internalLinks,
+    emitter
+  );
+  mergeActionProjections(walked, projectionResult, exts.actions);
   const issues = analyzerResult.issues;
   const silenced = options.ignoreFilter ? (path) => options.ignoreFilter.ignores(path) : void 0;
   const renameOps = prior ? detectRenamesAndOrphans(prior, walked.nodes, issues, silenced) : [];
@@ -17432,6 +17737,16 @@ function mergeAnalyzerEmissions(walked, analyzerResult, analyzers) {
     }
   }
 }
+function mergeActionProjections(walked, projectionResult, actions) {
+  for (const c of projectionResult.contributions) walked.contributions.push(c);
+  for (const e of projectionResult.contributionErrors) walked.contributionErrors.push(e);
+  for (const action of actions ?? []) {
+    if (action.ui === void 0 || typeof action.project !== "function") continue;
+    for (const node of walked.nodes) {
+      walked.freshlyRunTuples.add(`${action.pluginId}\0${action.id}\0${node.path}`);
+    }
+  }
+}
 function buildScanStats(walked, issues, start) {
   return {
     // `filesSkipped` is "files walked but not classified by any
@@ -20336,6 +20651,17 @@ var PLUGINS_TEXTS = {
   qualifiedIdNotFoundHint: "Run `sm plugins list` to see what each plugin ships.",
   qualifiedIdUnknownPlugin: "{{glyph}}  Qualified extension id references unknown plugin: {{pluginId}}\n   {{hint}}\n",
   qualifiedIdUnknownPluginHint: "Run `sm plugins list` for known plugin ids.",
+  // --- verb-shape redirects (show is extension-only; list is plugin-only) ---
+  // `sm plugins show` takes a qualified `<plugin>/<ext>` id and renders a
+  // single extension. A bare plugin id is the wrong granularity, redirect
+  // to `sm plugins list <id>`, which renders the whole plugin.
+  showBareId: '{{glyph}}  `sm plugins show` needs a qualified `<plugin>/<ext>` id; "{{id}}" is a plugin.\n   {{hint}}\n',
+  showBareIdHint: "Run `sm plugins list {{id}}` for the plugin and its extensions, then `sm plugins show {{id}}/<ext>` for one.",
+  // `sm plugins list <id>` takes a bare plugin id. A qualified
+  // `<plugin>/<ext>` id targets a single extension, redirect to
+  // `sm plugins show`.
+  listQualifiedId: "{{glyph}}  `sm plugins list` takes a plugin id, not a qualified `<plugin>/<ext>` id: {{id}}\n   {{hint}}\n",
+  listQualifiedIdHint: "Run `sm plugins show {{id}}` for that extension, or `sm plugins list {{pluginId}}` for the whole plugin.",
   // Spec § A.10, `applicableKinds` filter on Extractors. When an extractor
   // declares a kind that no installed Provider emits, the load succeeds
   // (the Provider may arrive later) but `sm plugins doctor` surfaces a
@@ -20469,7 +20795,14 @@ var PLUGINS_TEXTS = {
    * the visible output stay in sync.
    */
   pluginSubIndent: "       ",
-  listTipShow: "\nTip: `sm plugins show <id>` for kinds, versions, and per-extension status.\n",
+  /**
+   * Lifecycle tag appended to an extension name in list / show rows
+   * when the manifest declares a non-default `stability` (anything but
+   * `stable`). Inherits the surrounding line's color; `stable`
+   * (declared or defaulted) renders no tag.
+   */
+  stabilityTag: " ({{stability}})",
+  listTipShow: "\nTip: `sm plugins list <id>` for a plugin's extensions (kinds, versions, per-extension status), `sm plugins show <plugin>/<ext>` for one extension.\n",
   /** Show command, built-in header (no version row, no path). */
   detailHeaderBuiltIn: "  {{glyph}}  {{id}}   {{source}}   {{count}} extension{{plural}}\n",
   /**
@@ -20621,18 +20954,60 @@ function extensionRowFromBuiltIn(ext, plugin, resolveEnabled) {
     id: ext.id,
     kind: ext.kind,
     version: ext.version,
-    enabled: resolveEnabled(qualifiedExtensionId(plugin.id, ext.id)),
+    enabled: resolveEnabled(qualifiedExtensionId(plugin.id, ext.id), installedDefaultEnabled(ext.stability)),
     description: ext.description ?? ""
   };
+  if (ext.stability !== void 0) row.stability = ext.stability;
   if (ext.entry !== void 0) row.entry = ext.entry;
   return row;
 }
+function withStabilityTag(name, stability) {
+  if (!stability || stability === "stable") return name;
+  return name + tx(PLUGINS_TEXTS.stabilityTag, { stability: sanitizeForTerminal(stability) });
+}
 function omitModule(key, value) {
   if (key !== "module") return value;
   if (value === null || typeof value !== "object") return value;
   const tag = value[Symbol.toStringTag];
   return tag === "Module" ? void 0 : value;
 }
+function pluginCatalogue(plugins) {
+  const out = [];
+  for (const plugin of builtInPlugins) {
+    out.push({ id: plugin.id, extensionIds: plugin.extensions.map((e) => e.id) });
+  }
+  for (const p of plugins) {
+    out.push({ id: p.id, extensionIds: p.extensions?.map((e) => e.id) ?? [] });
+  }
+  return out;
+}
+function parseQualifiedExtensionId(id, catalogue) {
+  const [pluginId, extId, ...rest] = id.split("/");
+  if (!pluginId || !extId || rest.length > 0) return { ok: false, reason: "malformed" };
+  const plugin = catalogue.find((p) => p.id === pluginId);
+  if (!plugin) return { ok: false, reason: "unknown-plugin", pluginId };
+  if (!plugin.extensionIds.includes(extId)) {
+    return { ok: false, reason: "unknown-extension", pluginId, extId };
+  }
+  return { ok: true, pluginId, extId };
+}
+function renderQualifiedIdError(result, rawId, ansi) {
+  const glyph = ansi.red(PLUGINS_TEXTS.rowGlyphOff);
+  if (result.reason === "unknown-extension") {
+    return tx(PLUGINS_TEXTS.qualifiedIdNotFound, {
+      glyph,
+      id: sanitizeForTerminal(rawId),
+      pluginId: sanitizeForTerminal(result.pluginId ?? ""),
+      extId: sanitizeForTerminal(result.extId ?? ""),
+      hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdNotFoundHint)
+    });
+  }
+  return tx(PLUGINS_TEXTS.qualifiedIdUnknownPlugin, {
+    glyph,
+    pluginId: sanitizeForTerminal(result.reason === "unknown-plugin" ? result.pluginId ?? rawId : rawId),
+    hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdUnknownPluginHint)
+  });
+}
 function wrapText(text, maxWidth) {
   const words = text.split(/\s+/).filter((w) => w.length > 0);
   if (words.length === 0) return [];
@@ -20656,14 +21031,24 @@ var PluginsListCommand = class extends SmCommand {
   static paths = [["plugins", "list"]];
   static usage = Command22.Usage({
     category: "Plugins",
-    description: "List discovered plugins and their load status.",
-    details: "Scans <cwd>/.skill-map/plugins (or --plugin-dir <path>). Built-in plugins (claude, core) are listed alongside user plugins."
+    description: "List discovered plugins, or one plugin's extensions.",
+    details: `
+      No id: scans <cwd>/.skill-map/plugins (or --plugin-dir <path>) and
+      lists every plugin (built-in + user) with status, one row each.
+      With a bare plugin id: renders that plugin's manifest and its
+      extensions (kind / version / per-extension status). A qualified
+      \`<plugin>/<ext>\` id is rejected with a redirect to \`sm plugins show\`.
+    `
   });
+  id = Option21.String({ required: false });
   pluginDir = Option21.String("--plugin-dir", { required: false });
   async run() {
     const plugins = await loadAll({ pluginDir: this.pluginDir });
     const resolveEnabled = await buildResolver();
     const builtIns2 = builtInRows(resolveEnabled);
+    if (this.id !== void 0) {
+      return this.renderPluginDetailById(this.id, builtIns2, plugins);
+    }
     if (this.json) {
       this.printer.data(
         JSON.stringify({ builtIns: builtIns2, plugins }, omitModule, 2) + "\n"
@@ -20675,24 +21060,68 @@ var PluginsListCommand = class extends SmCommand {
       return ExitCode.Ok;
     }
     const ansi = this.ansiFor("stdout");
-    this.printer.data(renderListHuman(builtIns2, plugins, resolveEnabled, ansi));
+    this.printer.data(renderIndexHuman(builtIns2, plugins, resolveEnabled, ansi));
+    return ExitCode.Ok;
+  }
+  /**
+   * `sm plugins list <id>`, render one plugin's full detail. A qualified
+   * `<plugin>/<ext>` id is the wrong granularity for `list` (it targets a
+   * single extension), redirect to `sm plugins show`. A bare id that
+   * matches no plugin is a NotFound.
+   */
+  renderPluginDetailById(id, builtIns2, plugins) {
+    const stderrAnsi = this.ansiFor("stderr");
+    if (id.includes("/")) {
+      const pluginId = id.split("/")[0] ?? id;
+      this.printer.error(
+        tx(PLUGINS_TEXTS.listQualifiedId, {
+          glyph: stderrAnsi.red(PLUGINS_TEXTS.rowGlyphOff),
+          id: sanitizeForTerminal(id),
+          hint: stderrAnsi.dim(
+            tx(PLUGINS_TEXTS.listQualifiedIdHint, {
+              id: sanitizeForTerminal(id),
+              pluginId: sanitizeForTerminal(pluginId)
+            })
+          )
+        })
+      );
+      return ExitCode.Error;
+    }
+    const builtIn = builtIns2.find((b) => b.id === id);
+    const match = plugins.find((p) => p.id === id);
+    if (!builtIn && !match) {
+      this.printer.error(
+        tx(PLUGINS_TEXTS.pluginNotFound, {
+          glyph: stderrAnsi.red(PLUGINS_TEXTS.rowGlyphOff),
+          id: sanitizeForTerminal(id),
+          hint: stderrAnsi.dim(PLUGINS_TEXTS.pluginNotFoundHint)
+        })
+      );
+      return ExitCode.NotFound;
+    }
+    if (this.json) {
+      const payload = builtIn ?? match;
+      this.printer.data(JSON.stringify(payload, omitModule, 2) + "\n");
+      return ExitCode.Ok;
+    }
+    const ansi = this.ansiFor("stdout");
+    const text = builtIn ? renderBuiltInDetail(builtIn, ansi) : renderPluginDetail(match, ansi);
+    this.printer.data(text);
     return ExitCode.Ok;
   }
 };
-function renderListHuman(builtIns2, plugins, resolveEnabled, ansi) {
+function renderIndexHuman(builtIns2, plugins, resolveEnabled, ansi) {
   const rows = [
-    ...builtIns2.map(builtInToListRow),
-    ...plugins.map((p) => pluginToListRow(p, resolveEnabled))
+    ...builtIns2.map(builtInToIndexRow),
+    ...plugins.map((p) => pluginToIndexRow(p, resolveEnabled))
   ];
   const idWidth = Math.max(...rows.map((r) => r.id.length));
-  const countWidth = Math.max(
-    ...rows.map((r) => String(r.names.length).length)
-  );
+  const countWidth = Math.max(...rows.map((r) => String(r.extCount).length));
   const lines = [];
   for (const row of rows) {
     const glyph = row.enabled ? ansi.green(PLUGINS_TEXTS.rowGlyphOk) : ansi.red(PLUGINS_TEXTS.rowGlyphOff);
     const idCol = row.id.padEnd(idWidth);
-    const countCol = String(row.names.length).padStart(countWidth);
+    const countCol = String(row.extCount).padStart(countWidth);
     lines.push(
       tx(PLUGINS_TEXTS.pluginRow, {
         glyph,
@@ -20701,195 +21130,34 @@ function renderListHuman(builtIns2, plugins, resolveEnabled, ansi) {
         source: ansi.dim(row.source)
       })
     );
-    const indent = PLUGINS_TEXTS.pluginSubIndent;
     if (row.reason) {
-      lines.push(`${indent}${ansi.dim(row.reason)}`);
-    } else if (row.names.length > 0) {
-      for (const wrapped of wrapNames(row.names, indent, 76)) {
-        lines.push(`${indent}${ansi.dim(wrapped)}`);
-      }
+      lines.push(`${PLUGINS_TEXTS.pluginSubIndent}${ansi.dim(row.reason)}`);
     }
   }
   return lines.join("\n") + "\n" + PLUGINS_TEXTS.listTipShow;
 }
-function builtInToListRow(b) {
-  const names = b.extensions.map(
-    (e) => e.enabled ? e.id : `${PLUGINS_TEXTS.rowGlyphOff} ${e.id}`
-  );
+function builtInToIndexRow(b) {
   return {
     id: b.id,
     enabled: b.enabled,
     source: PLUGINS_TEXTS.sourceBuiltIn,
-    names
+    extCount: b.extensions.length
   };
 }
-function pluginToListRow(p, resolveEnabled) {
+function pluginToIndexRow(p, resolveEnabled) {
   const isLoaded = p.status === "enabled";
   const extensions = p.extensions ?? [];
-  const enabled = isLoaded ? extensions.length === 0 || extensions.some((e) => resolveEnabled(qualifiedExtensionId(p.id, e.id))) : false;
-  const names = extensions.map((e) => {
-    const safeId = sanitizeForTerminal(e.id);
-    return resolveEnabled(qualifiedExtensionId(p.id, e.id)) ? safeId : `${PLUGINS_TEXTS.rowGlyphOff} ${safeId}`;
-  });
+  const extEnabled = (e) => resolveEnabled(qualifiedExtensionId(p.id, e.id), installedDefaultEnabled(e.stability));
+  const enabled = isLoaded ? extensions.length === 0 || extensions.some((e) => extEnabled(e)) : false;
   const reason = p.status === "enabled" ? void 0 : sanitizeForTerminal(p.reason ?? "") || void 0;
   return {
     id: sanitizeForTerminal(p.id),
     enabled,
     source: PLUGINS_TEXTS.sourceUser,
-    names,
+    extCount: extensions.length,
     reason
   };
 }
-function wrapNames(names, indent, maxWidth) {
-  const out = [];
-  const sep8 = ", ";
-  let current = "";
-  for (const name of names) {
-    const candidate = current === "" ? name : `${current}${sep8}${name}`;
-    if (indent.length + candidate.length > maxWidth && current !== "") {
-      out.push(`${current},`);
-      current = name;
-    } else {
-      current = candidate;
-    }
-  }
-  if (current !== "") out.push(current);
-  return out;
-}
-
-// cli/commands/plugins/show.ts
-import { Command as Command23, Option as Option22 } from "clipanion";
-var PluginsShowCommand = class extends SmCommand {
-  static paths = [["plugins", "show"]];
-  static usage = Command23.Usage({
-    category: "Plugins",
-    description: "Show a single plugin's manifest + loaded extensions.",
-    details: `
-      Accepts a plugin id (\`core\`, \`claude\`, \`my-plugin\`)
-      or a qualified extension id (\`core/<ext-id>\`,
-      \`<plugin>/<ext-id>\`). When given a qualified id, validates the
-      extension exists and renders a single-extension detail block.
-      The bare form renders the parent plugin's detail with per-extension
-      status. The same id shapes \`sm plugins enable\` and
-      \`sm plugins disable\` accept resolve cleanly here too.
-    `
-  });
-  id = Option22.String({ required: true });
-  pluginDir = Option22.String("--plugin-dir", { required: false });
-  async run() {
-    const plugins = await loadAll({ pluginDir: this.pluginDir });
-    const resolveEnabled = await buildResolver();
-    const builtIns2 = builtInRows(resolveEnabled);
-    const stderrAnsi = this.ansiFor("stderr");
-    const lookupResult = resolveShowLookupId(this.id, builtIns2, plugins, stderrAnsi);
-    if ("error" in lookupResult) {
-      this.printer.error(lookupResult.error);
-      return ExitCode.NotFound;
-    }
-    const { pluginId, extId } = lookupResult;
-    const builtIn = builtIns2.find((b) => b.id === pluginId);
-    const match = plugins.find((p) => p.id === pluginId);
-    if (!builtIn && !match) {
-      this.printer.error(
-        tx(PLUGINS_TEXTS.pluginNotFound, {
-          glyph: stderrAnsi.red("\u2715"),
-          id: sanitizeForTerminal(this.id),
-          hint: stderrAnsi.dim(PLUGINS_TEXTS.pluginNotFoundHint)
-        })
-      );
-      return ExitCode.NotFound;
-    }
-    if (extId !== void 0) {
-      return this.renderExtensionDetail({ extId, pluginId, builtIn, match });
-    }
-    if (this.json) {
-      const payload = builtIn ?? match;
-      this.printer.data(JSON.stringify(payload, omitModule, 2) + "\n");
-      return ExitCode.Ok;
-    }
-    const ansi = this.ansiFor("stdout");
-    const text = builtIn ? renderBuiltInDetail(builtIn, ansi) : renderPluginDetail(match, ansi);
-    this.printer.data(text);
-    return ExitCode.Ok;
-  }
-  /**
-   * Render the single-extension detail block, the path taken when the
-   * user supplies a qualified `<plugin>/<ext>` id. `--json` emits the
-   * single extension row (no surrounding plugin envelope) so tooling
-   * can pipe straight into `jq`; human mode renders a focused header
-   * plus a Kind / Version / Stability / Description / Preconditions /
-   * Entry field block.
-   */
-  renderExtensionDetail(args2) {
-    const { extId, pluginId, builtIn, match } = args2;
-    const ansi = this.ansiFor("stdout");
-    if (builtIn) {
-      const ext = builtIn.extensions.find((e) => e.id === extId);
-      if (!ext) return ExitCode.NotFound;
-      if (this.json) {
-        this.printer.data(JSON.stringify({ pluginId, ...ext }, omitModule, 2) + "\n");
-        return ExitCode.Ok;
-      }
-      this.printer.data(renderBuiltInExtensionDetail(pluginId, ext, ansi));
-      return ExitCode.Ok;
-    }
-    const userExt = match?.extensions?.find((e) => e.id === extId);
-    if (!userExt) return ExitCode.NotFound;
-    if (this.json) {
-      this.printer.data(JSON.stringify(userExt, omitModule, 2) + "\n");
-      return ExitCode.Ok;
-    }
-    this.printer.data(renderUserExtensionDetail(pluginId, userExt, ansi));
-    return ExitCode.Ok;
-  }
-};
-function resolveShowLookupId(id, builtIns2, plugins, ansi) {
-  if (!id.includes("/")) return { pluginId: id };
-  const parsed = parseQualifiedId(id);
-  if ("error" in parsed) return { error: malformedQualifiedError(id, ansi) };
-  const { pluginId, extId } = parsed;
-  const knownExts = collectKnownExtensions(pluginId, builtIns2, plugins);
-  if (knownExts === null) return { error: unknownPluginError(pluginId, ansi) };
-  if (!knownExts.includes(extId)) {
-    return { error: unknownExtensionError(id, pluginId, extId, ansi) };
-  }
-  return { pluginId, extId };
-}
-function parseQualifiedId(id) {
-  const [pluginId, extId, ...rest] = id.split("/");
-  if (!pluginId || !extId || rest.length > 0) return { error: true };
-  return { pluginId, extId };
-}
-function collectKnownExtensions(pluginId, builtIns2, plugins) {
-  const builtIn = builtIns2.find((b) => b.id === pluginId);
-  if (builtIn) return builtIn.extensions.map((e) => e.id);
-  const userPlugin = plugins.find((p) => p.id === pluginId);
-  if (userPlugin) return userPlugin.extensions?.map((e) => e.id) ?? [];
-  return null;
-}
-function malformedQualifiedError(id, ansi) {
-  return tx(PLUGINS_TEXTS.qualifiedIdUnknownPlugin, {
-    glyph: ansi.red("\u2715"),
-    pluginId: sanitizeForTerminal(id),
-    hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdUnknownPluginHint)
-  });
-}
-function unknownPluginError(pluginId, ansi) {
-  return tx(PLUGINS_TEXTS.qualifiedIdUnknownPlugin, {
-    glyph: ansi.red("\u2715"),
-    pluginId: sanitizeForTerminal(pluginId),
-    hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdUnknownPluginHint)
-  });
-}
-function unknownExtensionError(id, pluginId, extId, ansi) {
-  return tx(PLUGINS_TEXTS.qualifiedIdNotFound, {
-    glyph: ansi.red("\u2715"),
-    id: sanitizeForTerminal(id),
-    pluginId: sanitizeForTerminal(pluginId),
-    extId: sanitizeForTerminal(extId),
-    hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdNotFoundHint)
-  });
-}
 function kindIndex(kind) {
   const idx = EXTENSION_KINDS.indexOf(kind);
   return idx === -1 ? EXTENSION_KINDS.length : idx;
@@ -20908,7 +21176,7 @@ function renderBuiltInDetail(b, ansi) {
   const items = sorted.map((ext) => ({
     glyph: ext.enabled ? ansi.green(PLUGINS_TEXTS.rowGlyphOk) : ansi.red(PLUGINS_TEXTS.rowGlyphOff),
     kind: ext.kind,
-    name: `${b.id}/${ext.id}`
+    name: withStabilityTag(`${b.id}/${ext.id}`, ext.stability)
   }));
   return tx(PLUGINS_TEXTS.detailHeaderBuiltIn, {
     glyph,
@@ -20987,7 +21255,7 @@ function collectPluginExtensionItems(match, ansi) {
       // status header above (✕ on the row).
       glyph: ansi.green(PLUGINS_TEXTS.rowGlyphOk),
       kind: sanitizeForTerminal(ext.kind),
-      name: `${safePluginId}/${safeExtId}`,
+      name: withStabilityTag(`${safePluginId}/${safeExtId}`, ext.stability),
       version: sanitizeForTerminal(ext.version)
     };
   });
@@ -21013,6 +21281,83 @@ function renderExtensionItems(items) {
   }
   return out.join("");
 }
+
+// cli/commands/plugins/show.ts
+import { Command as Command23, Option as Option22 } from "clipanion";
+var PluginsShowCommand = class extends SmCommand {
+  static paths = [["plugins", "show"]];
+  static usage = Command23.Usage({
+    category: "Plugins",
+    description: "Show a single extension's detail.",
+    details: `
+      Accepts a qualified extension id (\`core/<ext-id>\`,
+      \`<plugin>/<ext-id>\`) and renders a single-extension detail block
+      (Kind / Version / Stability / Description / Preconditions / Entry).
+      A bare plugin id is rejected with a redirect to
+      \`sm plugins list <id>\`, which renders the whole plugin. The same
+      qualified id shape \`sm plugins enable\` and \`sm plugins disable\`
+      accept resolves cleanly here too.
+    `
+  });
+  id = Option22.String({ required: true });
+  pluginDir = Option22.String("--plugin-dir", { required: false });
+  async run() {
+    const plugins = await loadAll({ pluginDir: this.pluginDir });
+    const resolveEnabled = await buildResolver();
+    const builtIns2 = builtInRows(resolveEnabled);
+    const stderrAnsi = this.ansiFor("stderr");
+    if (!this.id.includes("/")) {
+      this.printer.error(
+        tx(PLUGINS_TEXTS.showBareId, {
+          glyph: stderrAnsi.red(PLUGINS_TEXTS.rowGlyphOff),
+          id: sanitizeForTerminal(this.id),
+          hint: stderrAnsi.dim(
+            tx(PLUGINS_TEXTS.showBareIdHint, { id: sanitizeForTerminal(this.id) })
+          )
+        })
+      );
+      return ExitCode.Error;
+    }
+    const parsed = parseQualifiedExtensionId(this.id, pluginCatalogue(plugins));
+    if (!parsed.ok) {
+      this.printer.error(renderQualifiedIdError(parsed, this.id, stderrAnsi));
+      return ExitCode.NotFound;
+    }
+    const { pluginId, extId } = parsed;
+    const builtIn = builtIns2.find((b) => b.id === pluginId);
+    const match = plugins.find((p) => p.id === pluginId);
+    return this.renderExtensionDetail({ extId, pluginId, builtIn, match });
+  }
+  /**
+   * Render the single-extension detail block. `--json` emits the single
+   * extension row (no surrounding plugin envelope) so tooling can pipe
+   * straight into `jq`; human mode renders a focused header plus a
+   * Kind / Version / Stability / Description / Preconditions / Entry
+   * field block.
+   */
+  renderExtensionDetail(args2) {
+    const { extId, pluginId, builtIn, match } = args2;
+    const ansi = this.ansiFor("stdout");
+    if (builtIn) {
+      const ext = builtIn.extensions.find((e) => e.id === extId);
+      if (!ext) return ExitCode.NotFound;
+      if (this.json) {
+        this.printer.data(JSON.stringify({ pluginId, ...ext }, omitModule, 2) + "\n");
+        return ExitCode.Ok;
+      }
+      this.printer.data(renderBuiltInExtensionDetail(pluginId, ext, ansi));
+      return ExitCode.Ok;
+    }
+    const userExt = match?.extensions?.find((e) => e.id === extId);
+    if (!userExt) return ExitCode.NotFound;
+    if (this.json) {
+      this.printer.data(JSON.stringify(userExt, omitModule, 2) + "\n");
+      return ExitCode.Ok;
+    }
+    this.printer.data(renderUserExtensionDetail(pluginId, userExt, ansi));
+    return ExitCode.Ok;
+  }
+};
 function renderBuiltInExtensionDetail(pluginId, ext, ansi) {
   const glyph = ext.enabled ? ansi.green(PLUGINS_TEXTS.rowGlyphOk) : ansi.red(PLUGINS_TEXTS.rowGlyphOff);
   const header = tx(PLUGINS_TEXTS.detailHeaderExtensionBuiltIn, {
@@ -21021,6 +21366,7 @@ function renderBuiltInExtensionDetail(pluginId, ext, ansi) {
     source: ansi.dim(PLUGINS_TEXTS.sourceBuiltIn)
   });
   const meta = { kind: ext.kind };
+  if (ext.stability && ext.stability !== "stable") meta.stability = ext.stability;
   if (ext.description) meta.description = ext.description;
   if (ext.entry !== void 0) meta.entry = ext.entry;
   return header + "\n" + renderExtensionFields(meta);
@@ -21038,7 +21384,7 @@ function renderUserExtensionDetail(pluginId, ext, ansi) {
     version: ext.version,
     entry: ext.entryPath
   };
-  if (meta.stability !== void 0) input.stability = meta.stability;
+  if (ext.stability && ext.stability !== "stable") input.stability = ext.stability;
   if (meta.description !== void 0) input.description = meta.description;
   if (meta.preconditions !== void 0) input.preconditions = meta.preconditions;
   return header + "\n" + renderExtensionFields(input);
@@ -21048,7 +21394,6 @@ function readInstanceMeta(instance) {
   const obj = instance;
   const out = {};
   if (typeof obj["description"] === "string") out.description = obj["description"];
-  if (typeof obj["stability"] === "string") out.stability = obj["stability"];
   if (Array.isArray(obj["preconditions"])) {
     out.preconditions = obj["preconditions"].filter(
       (p) => typeof p === "string"
@@ -21849,61 +22194,15 @@ var PluginsDisableCommand = class extends TogglePluginsBase {
     return this.toggle(false);
   }
 };
-function pluginCatalogue(plugins) {
-  const out = [];
-  for (const plugin of builtInPlugins) {
-    out.push({
-      id: plugin.id,
-      extensionIds: plugin.extensions.map((e) => e.id)
-    });
-  }
-  for (const p of plugins) {
-    out.push({
-      id: p.id,
-      extensionIds: p.extensions?.map((e) => e.id) ?? []
-    });
-  }
-  return out;
-}
 function resolveToggleTarget(id, catalogue, ansi) {
   return id.includes("/") ? resolveQualifiedToggle(id, catalogue, ansi) : resolveBareToggle(id, catalogue);
 }
 function resolveQualifiedToggle(id, catalogue, ansi) {
-  const errGlyph = ansi.red("\u2715");
-  const [pluginId, extId, ...rest] = id.split("/");
-  if (!pluginId || !extId || rest.length > 0) {
-    return {
-      error: tx(PLUGINS_TEXTS.qualifiedIdUnknownPlugin, {
-        glyph: errGlyph,
-        pluginId: sanitizeForTerminal(id),
-        hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdUnknownPluginHint)
-      })
-    };
-  }
-  const plugin = catalogue.find((b) => b.id === pluginId);
-  if (!plugin) {
-    return {
-      error: tx(PLUGINS_TEXTS.qualifiedIdUnknownPlugin, {
-        glyph: errGlyph,
-        pluginId: sanitizeForTerminal(pluginId),
-        hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdUnknownPluginHint)
-      })
-    };
-  }
-  if (!plugin.extensionIds.includes(extId)) {
-    return {
-      error: tx(PLUGINS_TEXTS.qualifiedIdNotFound, {
-        glyph: errGlyph,
-        id: sanitizeForTerminal(id),
-        pluginId: sanitizeForTerminal(pluginId),
-        extId: sanitizeForTerminal(extId),
-        hint: ansi.dim(PLUGINS_TEXTS.qualifiedIdNotFoundHint)
-      })
-    };
-  }
+  const parsed = parseQualifiedExtensionId(id, catalogue);
+  if (!parsed.ok) return { error: renderQualifiedIdError(parsed, id, ansi) };
   return {
     origin: "qualified",
-    keys: [qualifiedExtensionId(pluginId, extId)]
+    keys: [qualifiedExtensionId(parsed.pluginId, parsed.extId)]
   };
 }
 function resolveBareToggle(id, catalogue) {
@@ -22283,7 +22582,7 @@ Generated by \`sm plugins create ${kind} ${pluginId}\`. Edit \`${mainFileRel}\`
 
 ## Verbs
 
-- \`sm plugins show ${pluginId}\`: manifest + load status
+- \`sm plugins list ${pluginId}\`: manifest + extensions + load status
 - \`sm plugins doctor\`: full plugin diagnostic
 - \`sm scan\`: re-emit contributions / re-run analysis
 
@@ -25735,8 +26034,9 @@ function buildBuiltInItems(resolveEnabled) {
         id: ext.id,
         kind: ext.kind,
         version: ext.version,
-        enabled: resolveEnabled(qualified),
+        enabled: resolveEnabled(qualified, installedDefaultEnabled(ext.stability)),
         ...ext.description ? { description: ext.description } : {},
+        ...ext.stability ? { stability: ext.stability } : {},
         ...extLocked ? { locked: true } : {}
       };
     });
@@ -25790,8 +26090,9 @@ function projectExtensionRows(plugin, resolveEnabled, pluginLocked) {
       id: ext.id,
       kind: ext.kind,
       version: ext.version,
-      enabled: resolveEnabled(qualified),
+      enabled: resolveEnabled(qualified, installedDefaultEnabled(ext.stability)),
       ...description ? { description } : {},
+      ...ext.stability ? { stability: ext.stability } : {},
       ...extLocked ? { locked: true } : {}
     };
   });
@@ -30277,4 +30578,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=3bc438eb-6e57-550d-aab1-392242aca915
+//# debugId=e21852cd-d92e-5bdf-abc7-02fffaa89502