@skill-map/cli 0.53.6 → 0.54.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]="3118bb11-aad2-50b2-b70d-ed15c2f72a97")}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.54.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");
@@ -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.",
+  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,9 +1439,9 @@ 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.",
@@ -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.-]+)+\.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.",
+  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,7 +1567,7 @@ 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.",
@@ -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,12 +1642,12 @@ 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.",
@@ -1550,10 +1656,10 @@ var markdownLinkExtractor = {
     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,7 +1672,7 @@ var markdownLinkExtractor = {
         raw: match[0],
         candidates: [
           {
-            extractorId: ID5,
+            extractorId: ID7,
             kind: "references",
             target: resolved,
             // 1.0: the `[text](path)` syntax is unambiguous. Markdown
@@ -1587,7 +1693,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 +1701,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.",
+  // 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 +1739,7 @@ var mcpToolsExtractor = {
         raw: `mcp__${server}__*`,
         candidates: [
           {
-            extractorId: ID6,
+            extractorId: ID8,
             kind: "references",
             target: mcpPath,
             confidence: 0.85,
@@ -1659,44 +1769,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 +1784,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 +1799,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 +1841,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 +1868,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 +1884,7 @@ var annotationFieldUnknownAnalyzer = {
           continue;
         }
         issues.push({
-          analyzerId: ID8,
+          analyzerId: ID9,
           severity: "warn",
           nodeIds: [node.path],
           message: tx(ANNOTATION_FIELD_UNKNOWN_TEXTS.unknownRootKey, {
@@ -1871,14 +1945,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 +1969,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 +1988,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
@@ -1931,7 +2012,7 @@ var ANNOTATION_STALE_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-stale/index.ts
-var ID10 = "annotation-stale";
+var ID11 = "annotation-stale";
 var staleIcon = {
   slot: "card.footer.right",
   icon: "pi-clock",
@@ -1948,7 +2029,7 @@ var bumpButton = {
   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`.",
@@ -1966,7 +2047,7 @@ var annotationStaleAnalyzer = {
       }
       if (status === null) continue;
       issues.push({
-        analyzerId: ID10,
+        analyzerId: ID11,
         severity: "info",
         nodeIds: [node.path],
         message: messageFor(status, node.path),
@@ -2020,9 +2101,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 +2122,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 +2158,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 +2193,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 +2213,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 +2226,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 +2250,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 +2286,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 +2353,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 +2369,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 +2416,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 +2447,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 +2468,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 +2500,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,16 +2524,16 @@ 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;
 }
 
@@ -2492,7 +2608,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 +2616,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 +2642,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 +2658,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 +2682,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 +2739,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 +2761,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 +2780,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 +2793,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,14 +2841,18 @@ 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`.",
@@ -2733,7 +2863,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 +2887,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 +2928,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 +2967,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 +2977,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 +3026,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 +3073,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 +3121,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 +3174,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 +3478,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 +3493,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 +3546,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 +3565,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 +3587,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 +3642,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 +3651,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 +3689,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,7 +3722,7 @@ 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, {
@@ -3572,7 +3741,7 @@ function makeIssue(signal) {
     const loserRange = signal.range ? `${signal.range.start}-${signal.range.end}` : "unknown";
     const topCandidate = signal.candidates[0];
     return {
-      analyzerId: ID23,
+      analyzerId: ID24,
       severity: "warn",
       nodeIds: [signal.source],
       message: tx(SIGNAL_COLLISION_TEXTS.messageBelowFloor, {
@@ -3604,13 +3773,13 @@ var SUPERSEDE_TEXTS = {
 };
 
 // plugins/core/analyzers/supersede/index.ts
-var ID24 = "supersede";
+var ID25 = "supersede";
 var supersedeButton = {
   slot: "inspector.action.button",
   priority: 10
 };
 var supersedeAnalyzer = {
-  id: ID24,
+  id: ID25,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: 'Projects the inspector "Supersede" button (declares a node replaced by another).',
@@ -3665,13 +3834,13 @@ var TAGS_TEXTS = {
 };
 
 // plugins/core/analyzers/tags/index.ts
-var ID25 = "tags";
+var ID26 = "tags";
 var setTagsButton = {
   slot: "inspector.action.button",
   priority: 15
 };
 var tagsAnalyzer = {
-  id: ID25,
+  id: ID26,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: `Projects the inspector "Edit tags" button (edits a node's taxonomy tags).`,
@@ -3714,18 +3883,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 +3902,14 @@ var TRIGGER_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/trigger-collision/index.ts
-var ID26 = "trigger-collision";
+var ID27 = "trigger-collision";
 var ADVERTISING_KINDS = /* @__PURE__ */ new Set([
   "command",
   "skill",
   "agent"
 ]);
 var triggerCollisionAnalyzer = {
-  id: ID26,
+  id: ID27,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   mode: "deterministic",
@@ -3838,7 +4007,7 @@ function analyzeTriggerBucket(normalized, claims) {
     part: parts[0]
   });
   return {
-    analyzerId: ID26,
+    analyzerId: ID27,
     severity: "error",
     nodeIds,
     message,
@@ -3878,13 +4047,13 @@ var ASCII_FORMATTER_TEXTS = {
 };
 
 // plugins/core/formatters/ascii/index.ts
-var ID27 = "ascii";
+var ID28 = "ascii";
 var KIND_ORDER = ["agent", "command", "skill", "markdown"];
 var asciiFormatter = {
-  id: ID27,
+  id: ID28,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
-  formatId: ID27,
+  formatId: ID28,
   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 +4147,13 @@ function renderSection(out, kind, group) {
 }
 
 // plugins/core/formatters/json/index.ts
-var ID28 = "json";
+var ID29 = "json";
 var jsonFormatter = {
-  id: ID28,
+  id: ID29,
   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: ID29,
   format(ctx) {
     if (ctx.scanResult !== void 0) {
       return JSON.stringify(ctx.scanResult);
@@ -4123,9 +4292,9 @@ function resolveSpecRoot2() {
 }
 
 // plugins/core/actions/node-bump/index.ts
-var ID29 = "node-bump";
+var ID30 = "node-bump";
 var nodeBumpAction = {
-  id: ID29,
+  id: ID30,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Marks a node as updated: bumps `annotations.version`, refreshes sidecar hashes, and records the timestamp.",
@@ -4184,9 +4353,9 @@ function pickCurrentVersion(overlay) {
 
 // plugins/core/actions/node-set-stability/index.ts
 var STABILITY_VALUES = ["experimental", "stable", "deprecated"];
-var ID30 = "node-set-stability";
+var ID31 = "node-set-stability";
 var nodeSetStabilityAction = {
-  id: ID30,
+  id: ID31,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the lifecycle stage of the current node (writes `stability` to the sidecar).",
@@ -4226,9 +4395,9 @@ function invokeSetStability(input, ctx) {
 }
 
 // plugins/core/actions/node-set-tags/index.ts
-var ID31 = "node-set-tags";
+var ID32 = "node-set-tags";
 var nodeSetTagsAction = {
-  id: ID31,
+  id: ID32,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the taxonomy tags of the current node (writes `tags` to the sidecar; whole-array replace).",
@@ -4265,9 +4434,9 @@ function invokeSetTags(input, ctx) {
 }
 
 // plugins/core/actions/node-supersede/index.ts
-var ID32 = "node-supersede";
+var ID33 = "node-supersede";
 var nodeSupersedeAction = {
-  id: ID32,
+  id: ID33,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Declares the current node as superseded by another (writes `supersededBy` to the sidecar).",
@@ -4785,15 +4954,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 };
@@ -4827,7 +4997,8 @@ var builtInPlugins = [
     extensions: [
       claudeProvider2,
       atDirectiveExtractor2,
-      slashCommandExtractor2
+      slashCommandExtractor2,
+      toolsCounterExtractor2
     ]
   },
   {
@@ -4857,10 +5028,10 @@ var builtInPlugins = [
     extensions: [
       coreMarkdownProvider2,
       annotationsExtractor2,
+      backtickPathExtractor2,
       externalUrlCounterExtractor2,
       markdownLinkExtractor2,
       mcpToolsExtractor2,
-      toolsCounterExtractor2,
       annotationFieldUnknownAnalyzer2,
       annotationOrphanAnalyzer2,
       annotationStaleAnalyzer2,
@@ -7784,7 +7955,8 @@ var LINK_KIND_VALUES = Object.freeze([
   "invokes",
   "references",
   "mentions",
-  "supersedes"
+  "supersedes",
+  "points"
 ]);
 var SEVERITY_VALUES = Object.freeze([
   "error",
@@ -10802,11 +10974,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
@@ -11796,7 +11970,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 +12024,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 +16000,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 +16037,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) {
@@ -20469,6 +20646,13 @@ var PLUGINS_TEXTS = {
    * the visible output stay in sync.
    */
   pluginSubIndent: "       ",
+  /**
+   * 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 show <id>` for kinds, versions, and per-extension status.\n",
   /** Show command, built-in header (no version row, no path). */
   detailHeaderBuiltIn: "  {{glyph}}  {{id}}   {{source}}   {{count}} extension{{plural}}\n",
@@ -20624,9 +20808,14 @@ function extensionRowFromBuiltIn(ext, plugin, resolveEnabled) {
     enabled: resolveEnabled(qualifiedExtensionId(plugin.id, ext.id)),
     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;
@@ -20713,9 +20902,10 @@ function renderListHuman(builtIns2, plugins, resolveEnabled, ansi) {
   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}`
-  );
+  const names = b.extensions.map((e) => {
+    const name = withStabilityTag(e.id, e.stability);
+    return e.enabled ? name : `${PLUGINS_TEXTS.rowGlyphOff} ${name}`;
+  });
   return {
     id: b.id,
     enabled: b.enabled,
@@ -20728,7 +20918,7 @@ function pluginToListRow(p, resolveEnabled) {
   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);
+    const safeId = withStabilityTag(sanitizeForTerminal(e.id), e.stability);
     return resolveEnabled(qualifiedExtensionId(p.id, e.id)) ? safeId : `${PLUGINS_TEXTS.rowGlyphOff} ${safeId}`;
   });
   const reason = p.status === "enabled" ? void 0 : sanitizeForTerminal(p.reason ?? "") || void 0;
@@ -20908,7 +21098,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 +21177,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)
     };
   });
@@ -21021,6 +21211,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 +21229,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 +21239,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"
@@ -25737,6 +25927,7 @@ function buildBuiltInItems(resolveEnabled) {
         version: ext.version,
         enabled: resolveEnabled(qualified),
         ...ext.description ? { description: ext.description } : {},
+        ...ext.stability ? { stability: ext.stability } : {},
         ...extLocked ? { locked: true } : {}
       };
     });
@@ -25792,6 +25983,7 @@ function projectExtensionRows(plugin, resolveEnabled, pluginLocked) {
       version: ext.version,
       enabled: resolveEnabled(qualified),
       ...description ? { description } : {},
+      ...ext.stability ? { stability: ext.stability } : {},
       ...extLocked ? { locked: true } : {}
     };
   });
@@ -30277,4 +30469,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=3bc438eb-6e57-550d-aab1-392242aca915
+//# debugId=3118bb11-aad2-50b2-b70d-ed15c2f72a97