@skill-map/cli 0.54.0 → 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]="3118bb11-aad2-50b2-b70d-ed15c2f72a97")}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.54.0",
+  version: "0.55.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -883,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
@@ -971,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) {
@@ -1029,7 +1029,7 @@ 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.",
+  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 },
@@ -1444,7 +1444,7 @@ var annotationsExtractor = {
   id: ID4,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
-  description: "Turns the `supersedes` and `supersededBy` entries from a node's `.sm` sidecar into arrows between nodes in the graph.",
+  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;
@@ -1500,12 +1500,12 @@ function stringArray(value) {
 // 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 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.",
+  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();
@@ -1570,7 +1570,7 @@ var externalUrlCounterExtractor = {
   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
@@ -1650,7 +1650,7 @@ var markdownLinkExtractor = {
   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();
@@ -1675,13 +1675,15 @@ var markdownLinkExtractor = {
             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,
@@ -1711,7 +1713,7 @@ var mcpToolsExtractor = {
   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.
@@ -2004,11 +2006,7 @@ 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
@@ -2024,10 +2022,6 @@ var staleBadge = {
   emitWhenEmpty: false,
   priority: 20
 };
-var bumpButton = {
-  slot: "inspector.action.button",
-  priority: 10
-};
 var annotationStaleAnalyzer = {
   id: ID11,
   pluginId: CORE_PLUGIN_ID,
@@ -2036,15 +2030,13 @@ var annotationStaleAnalyzer = {
   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: ID11,
@@ -2080,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":
@@ -2539,16 +2522,25 @@ function readDirname(node) {
 
 // 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();
@@ -2565,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";
@@ -2856,6 +2854,12 @@ var nodeSupersededAnalyzer = {
   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 = [];
@@ -3760,122 +3764,6 @@ function makeIssue(signal) {
   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 ID25 = "supersede";
-var supersedeButton = {
-  slot: "inspector.action.button",
-  priority: 10
-};
-var supersedeAnalyzer = {
-  id: ID25,
-  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 ID26 = "tags";
-var setTagsButton = {
-  slot: "inspector.action.button",
-  priority: 15
-};
-var tagsAnalyzer = {
-  id: ID26,
-  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 [];
-  }
-};
-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");
-}
-
 // plugins/core/analyzers/trigger-collision/text.ts
 var TRIGGER_COLLISION_TEXTS = {
   /**
@@ -3902,14 +3790,14 @@ var TRIGGER_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/trigger-collision/index.ts
-var ID27 = "trigger-collision";
+var ID25 = "trigger-collision";
 var ADVERTISING_KINDS = /* @__PURE__ */ new Set([
   "command",
   "skill",
   "agent"
 ]);
 var triggerCollisionAnalyzer = {
-  id: ID27,
+  id: ID25,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   mode: "deterministic",
@@ -4007,7 +3895,7 @@ function analyzeTriggerBucket(normalized, claims) {
     part: parts[0]
   });
   return {
-    analyzerId: ID27,
+    analyzerId: ID25,
     severity: "error",
     nodeIds,
     message,
@@ -4047,13 +3935,13 @@ var ASCII_FORMATTER_TEXTS = {
 };
 
 // plugins/core/formatters/ascii/index.ts
-var ID28 = "ascii";
+var ID26 = "ascii";
 var KIND_ORDER = ["agent", "command", "skill", "markdown"];
 var asciiFormatter = {
-  id: ID28,
+  id: ID26,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
-  formatId: ID28,
+  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
@@ -4147,13 +4035,13 @@ function renderSection(out, kind, group) {
 }
 
 // plugins/core/formatters/json/index.ts
-var ID29 = "json";
+var ID27 = "json";
 var jsonFormatter = {
-  id: ID29,
+  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: ID29,
+  formatId: ID27,
   format(ctx) {
     if (ctx.scanResult !== void 0) {
       return JSON.stringify(ctx.scanResult);
@@ -4291,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 ID30 = "node-bump";
+var ID28 = "node-bump";
+var bumpButton = {
+  slot: "inspector.action.button",
+  priority: 10
+};
 var nodeBumpAction = {
-  id: ID30,
+  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.
@@ -4307,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";
@@ -4353,9 +4274,9 @@ function pickCurrentVersion(overlay) {
 
 // plugins/core/actions/node-set-stability/index.ts
 var STABILITY_VALUES = ["experimental", "stable", "deprecated"];
-var ID31 = "node-set-stability";
+var ID29 = "node-set-stability";
 var nodeSetStabilityAction = {
-  id: ID31,
+  id: ID29,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the lifecycle stage of the current node (writes `stability` to the sidecar).",
@@ -4394,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 ID32 = "node-set-tags";
+var ID30 = "node-set-tags";
+var setTagsButton = {
+  slot: "inspector.action.button",
+  priority: 15
+};
 var nodeSetTagsAction = {
-  id: ID32,
+  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.
@@ -4410,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();
@@ -4433,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 ID33 = "node-supersede";
+var ID31 = "node-supersede";
+var supersedeButton = {
+  slot: "inspector.action.button",
+  priority: 10
+};
 var nodeSupersedeAction = {
-  id: ID33,
+  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.
@@ -4449,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) {
@@ -4980,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 };
@@ -5048,8 +5066,6 @@ var builtInPlugins = [
       referenceRedundantAnalyzer2,
       schemaViolationAnalyzer2,
       signalCollisionAnalyzer2,
-      supersedeAnalyzer2,
-      tagsAnalyzer2,
       triggerCollisionAnalyzer2,
       asciiFormatter2,
       jsonFormatter2,
@@ -6458,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
@@ -8149,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) {
@@ -8665,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) {
@@ -9666,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;
@@ -9689,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;
@@ -9768,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;
@@ -9793,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
           })
@@ -9805,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;
@@ -9835,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)
           })
@@ -9854,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;
@@ -9870,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);
@@ -9888,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;
@@ -9938,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)
         })
@@ -9958,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 }))
       })
     );
   }
@@ -9982,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
@@ -10013,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 ?? ""
           })
@@ -10038,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,
@@ -11091,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 });
@@ -11311,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;
       }
@@ -11325,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
@@ -11365,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 {
       }
     }
@@ -11447,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,
@@ -11563,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: [],
@@ -11618,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: [],
@@ -11636,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);
   });
 }
 
@@ -11663,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
     );
   }
@@ -11681,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;
@@ -11691,7 +11731,8 @@ function composeScanExtensions(opts) {
     providers: finalProviders,
     extractors: finalExtractors,
     analyzers: finalAnalyzers,
-    hooks
+    hooks,
+    actions
   };
 }
 function accumulateBuiltInScanExtensions(buckets, resolveEnabled) {
@@ -11712,6 +11753,7 @@ function accumulateBuiltInScanExtensions(buckets, resolveEnabled) {
           buckets.hooks.push(ext);
           break;
         case "action":
+          buckets.actions.push(ext);
           break;
         case "formatter":
           break;
@@ -16155,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
@@ -16952,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);
   }
@@ -17067,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) {
@@ -17501,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) : [];
@@ -17609,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
@@ -20513,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
@@ -20653,7 +20802,7 @@ var PLUGINS_TEXTS = {
    * (declared or defaulted) renders no tag.
    */
   stabilityTag: " ({{stability}})",
-  listTipShow: "\nTip: `sm plugins show <id>` for kinds, versions, and per-extension status.\n",
+  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",
   /**
@@ -20805,7 +20954,7 @@ 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;
@@ -20822,6 +20971,43 @@ function omitModule(key, 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 [];
@@ -20845,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"
@@ -20864,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,
@@ -20890,196 +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) => {
-    const name = withStabilityTag(e.id, e.stability);
-    return e.enabled ? name : `${PLUGINS_TEXTS.rowGlyphOff} ${name}`;
-  });
+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 = withStabilityTag(sanitizeForTerminal(e.id), e.stability);
-    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;
@@ -21203,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, {
@@ -22039,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) {
@@ -22473,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
 
@@ -25925,7 +26034,7 @@ 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 } : {}
@@ -25981,7 +26090,7 @@ 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 } : {}
@@ -30469,4 +30578,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=3118bb11-aad2-50b2-b70d-ed15c2f72a97
+//# debugId=e21852cd-d92e-5bdf-abc7-02fffaa89502