@skill-map/cli 0.69.0 → 0.71.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]="75d0c2c2-d08f-5d7c-aa62-3e1d53dd4ef1")}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]="81f53ca6-a8bf-5fc1-909d-ce926a83f056")}catch(e){}}();
 import { existsSync as existsSync34 } from "fs";
 import { Builtins, Cli as Cli2 } from "clipanion";
 
@@ -250,7 +250,7 @@ function bucketByKind(kind, instance, bag) {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.69.0",
+  version: "0.71.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",
@@ -581,7 +581,7 @@ var command_schema_default = {
 // plugins/ids.ts
 var CORE_PLUGIN_ID = "core";
 var CLAUDE_PLUGIN_ID = "claude";
-var OPENAI_PLUGIN_ID = "codex";
+var CODEX_PLUGIN_ID = "codex";
 var ANTIGRAVITY_PLUGIN_ID = "antigravity";
 var AGENT_SKILLS_PLUGIN_ID = "agent-skills";
 
@@ -633,7 +633,10 @@ var claudeProvider = {
   presentation: {
     label: "Anthropic's Claude",
     color: "#cc785c",
-    colorDark: "#e89270"
+    colorDark: "#e89270",
+    // Claude Code invokes both commands and skills with `/`; the palette
+    // paints this as the `invokes` edge glyph under the claude lens.
+    invocationSigil: "/"
   },
   // Auto-detect marker: a `.claude/` directory under the scope root marks
   // a Claude Code project. Provider-owned (replaces the old central
@@ -805,9 +808,6 @@ var claudeProvider = {
   }
 };
 
-// plugins/claude/extractors/at-directive/index.ts
-import { posix as pathPosix } from "path";
-
 // kernel/util/strip-code-blocks.ts
 var FENCE_RE = /^(?<indent> {0,3})(?<fence>`{3,}|~{3,})/;
 function stripCodeBlocks(input) {
@@ -815,6 +815,28 @@ function stripCodeBlocks(input) {
   const fenceless = stripFences(input);
   return stripInline(fenceless);
 }
+function findBacktickImbalance(body) {
+  if (!body) return null;
+  const { stripped, openFenceLine } = scanFences(body);
+  if (openFenceLine > 0) {
+    return { kind: "fence", line: openFenceLine, sourceLine: sourceLineAt(body, openFenceLine) };
+  }
+  const survivor = stripInline(maskEscapes(stripped)).indexOf("`");
+  if (survivor < 0) return null;
+  const line = lineOfIndex(stripped, survivor);
+  return { kind: "inline", line, sourceLine: sourceLineAt(body, line) };
+}
+function maskEscapes(text) {
+  return text.replace(/\\[^\n]/g, "  ");
+}
+function lineOfIndex(text, idx) {
+  let line = 1;
+  for (let i = 0; i < idx; i++) if (text[i] === "\n") line++;
+  return line;
+}
+function sourceLineAt(text, line) {
+  return text.split("\n")[line - 1]?.trim() ?? "";
+}
 function extractCodeRegions(input) {
   if (!input) return input;
   const stripped = stripCodeBlocks(input);
@@ -834,30 +856,31 @@ function stripHtml(input) {
 function stripCodeAndHtml(input) {
   return stripHtml(stripCodeBlocks(input));
 }
-function stripFences(input) {
+function scanFences(input) {
   const out = [];
   const lines = input.split("\n");
   let openFence = null;
-  for (const line of lines) {
+  let openFenceLine = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
     if (openFence) {
-      const closer = matchClosingFence(line, openFence);
-      if (closer) {
-        out.push(blank(line));
-        openFence = null;
-      } else {
-        out.push(blank(line));
-      }
+      if (matchClosingFence(line, openFence)) openFence = null;
+      out.push(blank(line));
       continue;
     }
     const open3 = FENCE_RE.exec(line);
     if (open3?.groups) {
       openFence = open3.groups["fence"];
+      openFenceLine = i + 1;
       out.push(blank(line));
       continue;
     }
     out.push(line);
   }
-  return out.join("\n");
+  return { stripped: out.join("\n"), openFenceLine: openFence ? openFenceLine : 0 };
+}
+function stripFences(input) {
+  return scanFences(input).stripped;
 }
 function matchClosingFence(line, openFence) {
   const m = FENCE_RE.exec(line);
@@ -903,84 +926,61 @@ function normalizeTrigger(source) {
   return out.trim();
 }
 
+// kernel/util/at-token.ts
+import { posix as pathPosix } from "path";
+var AT_TOKEN_RE = /(?:^|[^A-Za-z0-9_@])(@(?:(?:\.{1,2}\/)+|\/)?[a-z0-9](?:[a-z0-9_\-./]*[a-z0-9_])?(?::[a-z0-9][a-z0-9_-]*)?)/gi;
+var FILE_EXT_RE = /\.(md|mdx|js|jsx|ts|tsx|json|yml|yaml|toml|txt|html|css|scss|less|py|rb|go|rs|java|c|cpp|h|hpp|sh|sql|svg|png|jpg|jpeg|gif|webp|pdf)$/i;
+function classifyAtFileToken(bare) {
+  if (bare.startsWith("/")) return null;
+  if (bare.startsWith("./") || bare.startsWith("../")) return "relative path prefix";
+  if (FILE_EXT_RE.test(bare)) return "known file extension";
+  return null;
+}
+function resolveAtFileTarget(sourceDir, bare) {
+  const joined = sourceDir === "." ? bare : `${sourceDir}/${bare}`;
+  return pathPosix.normalize(joined);
+}
+
 // plugins/claude/extractors/at-directive/index.ts
 var ID = "at-directive";
-var AT_RE = /(?:^|[^A-Za-z0-9_@])(@(?:\.{1,2}\/|\/)?[a-z0-9](?:[a-z0-9_\-./]*[a-z0-9_])?(?::[a-z0-9][a-z0-9_-]*)?)/gi;
-var FILE_EXT_RE = /\.(md|mdx|js|jsx|ts|tsx|json|yml|yaml|toml|txt|html|css|scss|less|py|rb|go|rs|java|c|cpp|h|hpp|sh|sql|svg|png|jpg|jpeg|gif|webp|pdf)$/i;
 var atDirectiveExtractor = {
   id: ID,
   pluginId: CLAUDE_PLUGIN_ID,
   kind: "extractor",
-  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.",
+  description: "Detects bare `@<handle>` mentions in a node's body using Claude Code rules and emits a `mentions` link to the named entity. Example: `@team` becomes a `mentions` link. File-shaped tokens like `@docs/api.md` are handled by `core/at-file` instead.",
   scope: "body",
-  // Authorised under the claude AND codex lenses: OpenAI Codex sub-agents
-  // reference each other with the same `@<name>` mention grammar, and their
-  // prompt (the TOML `developer_instructions` body, fed in via the codex
-  // provider's `read.bodyField`) carries the same `@` tokens. The gate is the active
-  // lens, not the node's provider, so under `codex` this parses `@` across
-  // the project's markdown surface just as it does under `claude`.
-  precondition: { provider: ["claude", "codex"] },
-  // eslint-disable-next-line complexity
+  // Claude-only. This is Claude's bare `@<handle>` MENTION grammar. The
+  // file-reference half of `@` (file-shaped tokens) is the shared
+  // `core/at-file` extractor, which also serves codex / antigravity; this
+  // extractor defers file-shaped tokens to it.
+  precondition: { provider: ["claude"] },
   extract(ctx) {
     const seenMentions = /* @__PURE__ */ new Set();
-    const seenReferences = /* @__PURE__ */ new Set();
     const body = stripCodeAndHtml(ctx.body);
     const lineStarts = computeLineStarts(body);
-    const sourceDir = pathPosix.dirname(ctx.node.path);
-    for (const match of body.matchAll(AT_RE)) {
+    for (const match of body.matchAll(AT_TOKEN_RE)) {
       const original = match[1];
       const bare = original.slice(1);
-      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
-      const line = lineFor(lineStarts, captureOffset);
-      const range = { start: captureOffset, end: captureOffset + original.length, line };
       if (bare.startsWith("/")) continue;
-      const isReference = bare.startsWith("./") || bare.startsWith("../") || FILE_EXT_RE.test(bare);
-      if (isReference) {
-        const target = resolveSourceRelative(sourceDir, bare);
-        const dedupKey = target.toLowerCase();
-        if (seenReferences.has(dedupKey)) continue;
-        seenReferences.add(dedupKey);
-        ctx.emitSignal({
-          source: ctx.node.path,
-          scope: "body",
-          range,
-          raw: original,
-          candidates: [
-            {
-              extractorId: ID,
-              kind: "references",
-              target,
-              // 0.85: strong file signal (path prefix `./` / `../` OR
-              // a known file extension on the tail). One degree of
-              // inference (the runtime still resolves the path).
-              confidence: 0.85,
-              rationale: bare.startsWith("./") || bare.startsWith("../") ? "relative path prefix" : "known file extension",
-              trigger: {
-                originalTrigger: original,
-                normalizedTrigger: target
-              }
-            }
-          ]
-        });
-        continue;
-      }
+      if (classifyAtFileToken(bare) !== null) continue;
       const normalized = normalizeTrigger(original);
       if (seenMentions.has(normalized)) continue;
       seenMentions.add(normalized);
+      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
+      const line = lineFor(lineStarts, captureOffset);
       ctx.emitSignal({
         source: ctx.node.path,
         scope: "body",
-        range,
+        range: { start: captureOffset, end: captureOffset + original.length, line },
         raw: original,
         candidates: [
           {
             extractorId: ID,
             kind: "mentions",
             target: original,
-            // 0.5: genuine ambiguity. A bare `@handle` (no extension, no
-            // path prefix) could be an agent, a handle, or generic prose.
-            // The runtime decides at invocation time; the extractor leaves
-            // the question open.
+            // 0.5: genuine ambiguity. A bare `@handle` (no extension, no path
+            // prefix) could be an agent, a handle, or generic prose. The
+            // runtime decides at invocation time; the extractor leaves it open.
             confidence: 0.5,
             rationale: "no extension, no path prefix",
             trigger: {
@@ -993,73 +993,9 @@ var atDirectiveExtractor = {
     }
   }
 };
-function resolveSourceRelative(sourceDir, bare) {
-  const joined = sourceDir === "." ? bare : `${sourceDir}/${bare}`;
-  return pathPosix.normalize(joined);
-}
-
-// plugins/claude/extractors/slash-command/index.ts
-var ID2 = "slash-command";
-var SLASH_RE = /(?<![A-Za-z0-9_/.:?#=&])(\/[a-z0-9][a-z0-9_-]*(?::[a-z0-9][a-z0-9_-]*)?)/gi;
-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. Example: `/deploy` in the body draws an arrow to the `deploy` command.",
-  scope: "body",
-  // Also authorised under the codex and antigravity lenses, which share the
-  // `/command` grammar. Under codex a sub-agent's prompt body (the TOML
-  // `developer_instructions` field) has its `/command` tokens parsed for
-  // pipeline parity; codex resolves them to its open-standard skills
-  // (`invokes: ['skill']`). Under antigravity a workflow / skill / AGENTS.md
-  // body's `/name` tokens resolve to BOTH skills and workflows
-  // (`invokes: ['skill', 'workflow']`), since Antigravity invokes either by
-  // the same slash. A lens that declares no `invokes` resolution leaves the
-  // signals unresolved (no spurious edges).
-  precondition: { provider: ["claude", "codex", "antigravity"] },
-  extract(ctx) {
-    const seen = /* @__PURE__ */ new Set();
-    const body = stripCodeAndHtml(ctx.body);
-    const lineStarts = computeLineStarts(body);
-    for (const match of body.matchAll(SLASH_RE)) {
-      const original = match[1];
-      const endIdx = (match.index ?? 0) + match[0].length;
-      const nextChar = body[endIdx];
-      if (nextChar && /[A-Za-z0-9_/-]/.test(nextChar)) continue;
-      const normalized = normalizeTrigger(original);
-      if (seen.has(normalized)) continue;
-      seen.add(normalized);
-      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
-      const line = lineFor(lineStarts, captureOffset);
-      ctx.emitSignal({
-        source: ctx.node.path,
-        scope: "body",
-        range: { start: captureOffset, end: captureOffset + original.length, line },
-        raw: original,
-        candidates: [
-          {
-            extractorId: ID2,
-            kind: "invokes",
-            target: original,
-            // 0.8: clean `/command` match after code-block strip. The
-            // post-match path guard above filters URL / file-path noise,
-            // so a hit is unambiguous syntax. Resolution against the
-            // live skill / command catalog happens downstream.
-            confidence: 0.8,
-            rationale: "unambiguous slash syntax post code-block strip",
-            trigger: {
-              originalTrigger: original,
-              normalizedTrigger: normalized
-            }
-          }
-        ]
-      });
-    }
-  }
-};
 
 // plugins/claude/extractors/tools-counter/index.ts
-var ID3 = "tools-counter";
+var ID2 = "tools-counter";
 var count = {
   slot: "card.footer.left",
   icon: "pi-wrench",
@@ -1069,7 +1005,7 @@ var count = {
 };
 var TOOLTIP_MAX = 255;
 var toolsCounterExtractor = {
-  id: ID3,
+  id: ID2,
   pluginId: CLAUDE_PLUGIN_ID,
   kind: "extractor",
   description: "Counts the tools an agent declares in its frontmatter and shows the count on the agent card. Example: an agent with `tools: [Bash, Read, Grep]` shows a count of 3.",
@@ -1241,26 +1177,32 @@ var agentSkillsProvider = {
   stability: "stable",
   // Auto-detect marker: a `.agents/` directory marks an open-standard
   // project. This is also the marker a Google/Antigravity project carries
-  // (Antigravity adopted the open standard). The marker only produces an
-  // auto-detect candidate once this experimental provider is enabled.
-  // Provider-owned.
-  detect: { markers: [".agents"] },
+  // (Antigravity adopted the open standard) and the shared skill home a
+  // Codex project populates under `.agents/skills/`. `fallback: true` makes
+  // this candidate yield to any vendor marker present alongside `.agents/`:
+  // a `.codex/` + `.agents/` project resolves `codex` outright, never an
+  // ambiguous `codex` vs `agent-skills` prompt. The `.agents/` marker only
+  // wins when no vendor marker is present. Provider-owned.
+  detect: { markers: [".agents"], fallback: true },
   // Authoring target for `sm tutorial`: the open standard discovers skills
   // under `.agents/skills/<name>/SKILL.md`. `aka` lists Antigravity, which
   // shares this territory AND the BASIC tutorial track (skill + markdown,
   // references), so a tester on Antigravity scaffolds here. OpenAI Codex
   // also reads `.agents/skills/`, but Codex is a RICH-track lens (it has the
-  // `agent` kind, slash and `@`), so advertising it under this basic row
+  // `agent` kind, plus `$`-skill invocation and `@`-file references), so
+  // advertising it under this basic row
   // would hand it the wrong book; Codex is surfaced once a Codex rich
   // scaffold target lands. `aka` is display-only, `--for` matches the id.
   scaffold: { skillDir: ".agents/skills", aka: ["Google's Antigravity"] },
   read: COMMONS_READ,
   kinds: COMMONS_KINDS,
   resolution: COMMONS_RESOLUTION,
-  // Base reserved-name catalog (self-scope under the `agent-skills` lens). The
-  // shared export is inherited by every Provider that adopts the open
-  // standard (see `COMMONS_RESERVED_NAMES` above).
-  reservedNames: COMMONS_RESERVED_NAMES,
+  // NO `reservedNames`: the neutral open standard has no `/`-invocation, a
+  // skill activates by its `description` and connects via markdown links, so
+  // a skill name cannot shadow a built-in `/` command. The shared
+  // `COMMONS_RESERVED_NAMES` export above is for `/`-invoking vendors
+  // (Antigravity) to spread, NOT applied here. See spec/architecture.md
+  // §Provider · reservedNames.
   classify: classifyCommonsPath
 };
 
@@ -1308,7 +1250,10 @@ var antigravityProvider = {
   presentation: {
     label: "Google's Antigravity",
     color: "#7c3aed",
-    colorDark: "#a78bfa"
+    colorDark: "#a78bfa",
+    // Antigravity bolts `/`-invocation onto the open standard (skills and
+    // workflows are `/<name>`), so the `invokes` edge glyph is the slash.
+    invocationSigil: "/"
   },
   // Auto-detect marker: Antigravity's workflows live under `.agent/workflows/`
   // (SINGULAR `.agent`), its one vendor-specific on-disk territory. Skills
@@ -1346,10 +1291,15 @@ var antigravityProvider = {
       schemaJson: workflow_schema_default,
       ui: {
         label: "Workflows",
-        // Antigravity violet, so a workflow node reads as Antigravity's own
-        // (skills keep the normalised cross-provider green of COMMONS_KINDS).
-        color: "#7c3aed",
-        colorDark: "#a78bfa",
+        // A workflow is Antigravity's command-equivalent (its own slash-
+        // invocable procedural kind, the slot Claude fills with `command`),
+        // so it adopts the SAME color as Claude's `command` kind (amber) for a
+        // uniform cross-provider vocabulary, the same way skills normalise to
+        // the cross-provider green of COMMONS_KINDS. The Antigravity violet
+        // stays on the provider-level `presentation` (the lens identity), not
+        // on this kind.
+        color: "#f59e0b",
+        colorDark: "#fbbf24",
         icon: { kind: "pi", id: "pi-sitemap" }
       },
       // The handle is ALWAYS the filename stem (`/<name>`): Antigravity
@@ -1361,7 +1311,12 @@ var antigravityProvider = {
   // `/<name>` slash invocations resolve to BOTH skills and workflows: under
   // the antigravity lens a `/deploy` links to either `.agents/skills/deploy`
   // or `.agent/workflows/deploy.md`. Overrides the open-standard default
-  // (`invokes: ['skill']`) to add the own `workflow` kind.
+  // (`invokes: ['skill']`) to add the own `workflow` kind. Antigravity's OTHER
+  // connector, `@filename` file references (the documented rules / skill /
+  // workflow file pointer, a file-picker grammar like Codex's, distinct from
+  // Claude's `@`-agent-mention), needs no entry here: the shared `core/at-file`
+  // extractor (gated to claude / codex / antigravity) emits them as
+  // `references` resolved by PATH, lens-independent.
   resolution: { invokes: ["skill", "workflow"] },
   classify(path) {
     if (/^\.agent\/workflows\/[^/]+\.md$/.test(path.toLowerCase())) return "workflow";
@@ -1452,7 +1407,7 @@ var agent_schema_default2 = {
 // plugins/codex/providers/codex/index.ts
 var codexProvider = {
   id: "codex",
-  pluginId: OPENAI_PLUGIN_ID,
+  pluginId: CODEX_PLUGIN_ID,
   kind: "provider",
   description: "Classifies `.codex/agents/*.toml` as OpenAI Codex CLI sub-agents and `.agents/skills/*/SKILL.md` as Codex skills (open standard).",
   // Provider identity for the active-lens dropdown, the topbar lens chip,
@@ -1461,7 +1416,11 @@ var codexProvider = {
   presentation: {
     label: "OpenAI's Codex",
     color: "#22c55e",
-    colorDark: "#4ade80"
+    colorDark: "#4ade80",
+    // Codex invokes skills with `$` (`$publish`); `/` is reserved for its
+    // own built-in commands (`/model`, `/init`), so the `invokes` edge glyph
+    // under the codex lens is the dollar, not the slash.
+    invocationSigil: "$"
   },
   // Auto-detect marker: a `.codex/` directory marks a Codex CLI project.
   // `AGENTS.md` is intentionally NOT a marker: it is the open agents.md
@@ -1527,19 +1486,21 @@ var codexProvider = {
     // `frontmatter.name`.
     ...COMMONS_KINDS
   },
-  // Mentions resolve to agents (`@<name>`, the Codex sub-agent handle).
-  // Slash invocations resolve to skills (`invokes: ['skill']`, inherited
-  // from the open standard), so a `/skill-name` in an agent's prompt links
-  // to its `.agents/skills/` skill.
+  // Skill invocations resolve to skills (`invokes: ['skill']`, inherited
+  // from the open standard): a `$skill-name` in an agent's prompt (parsed by
+  // the codex `dollar-skill` extractor) links to its `.agents/skills/` skill.
+  // NO `mentions` entry: Codex's `@` is a file picker, parsed by the
+  // codex-owned `at-file` extractor as a path-resolved `references` link, not
+  // an agent-mention grammar.
   resolution: {
-    mentions: ["agent"],
     ...COMMONS_RESOLUTION
   },
-  // Open-standard reserved-name base (the universal cross-agent slash
-  // verbs an agent CLI ships built-in), inherited from `agent-skills` and
-  // applied under the codex lens via SELF scope: a user skill that shadows
-  // one is flagged by `core/name-reserved`.
-  reservedNames: COMMONS_RESERVED_NAMES,
+  // NO `reservedNames`: Codex invokes skills via `$` (the `dollar-skill`
+  // extractor), a namespace disjoint from its built-in `/` commands, so a
+  // `$`-skill named `model` does NOT collide with `/model`. Reserved-skill
+  // names only apply to lenses that invoke skills through the `/` command
+  // channel (claude, antigravity). See spec/architecture.md §Provider ·
+  // reservedNames.
   classify(path) {
     const lower = path.toLowerCase();
     if (lower.startsWith(".codex/agents/") && lower.endsWith(".toml")) return "agent";
@@ -1547,6 +1508,57 @@ var codexProvider = {
   }
 };
 
+// plugins/codex/extractors/dollar-skill/index.ts
+var ID3 = "dollar-skill";
+var DOLLAR_RE = /(?<![A-Za-z0-9_$])(\$[a-z][a-z0-9_-]*)/g;
+var dollarSkillExtractor = {
+  id: ID3,
+  pluginId: CODEX_PLUGIN_ID,
+  kind: "extractor",
+  description: "Turns `$skill` invocations in a node's body into arrows that point at the resolved Codex skill, using OpenAI Codex routing rules. Example: `$check-links` in the body draws an arrow to the `check-links` skill.",
+  scope: "body",
+  // Codex-only: `$skill` is OpenAI Codex's explicit skill-invocation
+  // grammar. The codex provider resolves it to its open-standard skills
+  // (`invokes: ['skill']`). Other lenses do not parse `$`.
+  precondition: { provider: ["codex"] },
+  extract(ctx) {
+    const seen = /* @__PURE__ */ new Set();
+    const body = stripCodeAndHtml(ctx.body);
+    const lineStarts = computeLineStarts(body);
+    for (const match of body.matchAll(DOLLAR_RE)) {
+      const original = match[1];
+      const normalized = normalizeTrigger(original);
+      if (seen.has(normalized)) continue;
+      seen.add(normalized);
+      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
+      const line = lineFor(lineStarts, captureOffset);
+      ctx.emitSignal({
+        source: ctx.node.path,
+        scope: "body",
+        range: { start: captureOffset, end: captureOffset + original.length, line },
+        raw: original,
+        candidates: [
+          {
+            extractorId: ID3,
+            kind: "invokes",
+            target: original,
+            // 0.8: clean `$skill` match after code-block strip. The
+            // lowercase-letter guard filters currency / env-var noise, so a
+            // hit is unambiguous syntax. Resolution against the live skill
+            // catalog happens downstream.
+            confidence: 0.8,
+            rationale: "unambiguous $skill syntax post code-block strip",
+            trigger: {
+              originalTrigger: original,
+              normalizedTrigger: normalized
+            }
+          }
+        ]
+      });
+    }
+  }
+};
+
 // plugins/core/providers/core-markdown/schemas/markdown.schema.json
 var markdown_schema_default = {
   $schema: "https://json-schema.org/draft/2020-12/schema",
@@ -1633,12 +1645,68 @@ var coreMarkdownProvider = {
   }
 };
 
-// plugins/core/extractors/backtick-path/index.ts
+// plugins/core/extractors/at-file/index.ts
 import { posix as pathPosix2 } from "path";
-var ID4 = "backtick-path";
+var ID4 = "at-file";
+var atFileExtractor = {
+  id: ID4,
+  pluginId: CORE_PLUGIN_ID,
+  kind: "extractor",
+  description: "Detects `@<file>` references in a node's body for the `@`-file-picker lenses (Codex, Antigravity, Claude), where `@` points at a workspace file. A path- or extension-shaped token becomes a `references` link to that file; a bare `@handle` forms no edge. Example: `@builder.toml` in a body draws an arrow to the `builder` file.",
+  scope: "body",
+  // The lenses whose runtime reads `@` as a file-path picker. Codex (`@` is a
+  // file picker, `$` invokes skills), Antigravity (documented `@filename` file
+  // refs), and Claude (`@file.md` file ref; its bare-handle MENTION half lives
+  // in `claude/at-directive`). NOT gated under `agent-skills` / `markdown`,
+  // whose runtimes read `@` as nothing (no phantom edges).
+  precondition: { provider: ["claude", "codex", "antigravity"] },
+  extract(ctx) {
+    const seenReferences = /* @__PURE__ */ new Set();
+    const body = stripCodeAndHtml(ctx.body);
+    const lineStarts = computeLineStarts(body);
+    const sourceDir = pathPosix2.dirname(ctx.node.path);
+    for (const match of body.matchAll(AT_TOKEN_RE)) {
+      const original = match[1];
+      const bare = original.slice(1);
+      const rationale = classifyAtFileToken(bare);
+      if (rationale === null) continue;
+      const target = resolveAtFileTarget(sourceDir, bare);
+      const dedupKey = target.toLowerCase();
+      if (seenReferences.has(dedupKey)) continue;
+      seenReferences.add(dedupKey);
+      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
+      const line = lineFor(lineStarts, captureOffset);
+      ctx.emitSignal({
+        source: ctx.node.path,
+        scope: "body",
+        range: { start: captureOffset, end: captureOffset + original.length, line },
+        raw: original,
+        candidates: [
+          {
+            extractorId: ID4,
+            kind: "references",
+            target,
+            // 0.85: strong file signal (path prefix or known extension),
+            // one degree of inference (the runtime resolves the path).
+            confidence: 0.85,
+            rationale,
+            trigger: {
+              originalTrigger: original,
+              normalizedTrigger: target
+            }
+          }
+        ]
+      });
+    }
+  }
+};
+
+// plugins/core/extractors/backtick-path/index.ts
+import { posix as pathPosix3 } from "path";
+var ID5 = "backtick-path";
 var PATH_RE = /(?<![\w/:.-])(?:\.{1,2}\/)?[\w][\w.-]*(?:\/[\w.-]+)*\.md\b(?![\w/])/g;
 var backtickPathExtractor = {
-  id: ID4,
+  id: ID5,
   pluginId: CORE_PLUGIN_ID,
   kind: "extractor",
   description: "Turns relative .md paths written inside code spans and fenced blocks into arrows between nodes in the graph. Example: a backticked `references/rules.md` path draws an arrow to that file.",
@@ -1647,7 +1715,7 @@ var backtickPathExtractor = {
     const seen = /* @__PURE__ */ new Set();
     const body = extractCodeRegions(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(PATH_RE)) {
       const original = match[0];
       const resolved = resolveTarget(sourceDir, original);
@@ -1663,7 +1731,7 @@ var backtickPathExtractor = {
         raw: original,
         candidates: [
           {
-            extractorId: ID4,
+            extractorId: ID5,
             kind: "points",
             target: resolved,
             // 0.85: a strong file signal with one degree of inference,
@@ -1688,11 +1756,11 @@ function resolveTarget(sourceDir, raw) {
   if (trimmed.length === 0) return null;
   if (trimmed.startsWith("/")) return null;
   const joined = sourceDir === "." ? trimmed : `${sourceDir}/${trimmed}`;
-  return pathPosix2.normalize(joined);
+  return pathPosix3.normalize(joined);
 }
 
 // plugins/core/extractors/external-url-counter/index.ts
-var ID5 = "external-url-counter";
+var ID6 = "external-url-counter";
 var count2 = {
   slot: "card.footer.left",
   icon: "pi-link",
@@ -1712,7 +1780,7 @@ var settings = {
 var URL_RE = /https?:\/\/[^\s<>"'`)\]]+/g;
 var TRAILING_PUNCT = /[.,;:!?]+$/;
 var externalUrlCounterExtractor = {
-  id: ID5,
+  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. Example: a body linking `https://example.com` and `https://docs.rs` shows a count of 2.",
@@ -1764,7 +1832,7 @@ var externalUrlCounterExtractor = {
         raw: original,
         candidates: [
           {
-            extractorId: ID5,
+            extractorId: ID6,
             kind: "references",
             target: normalized.href,
             confidence: 0.3,
@@ -1805,12 +1873,12 @@ function normalizeUrl(raw) {
 }
 
 // plugins/core/extractors/markdown-link/index.ts
-import { posix as pathPosix3 } from "path";
-var ID6 = "markdown-link";
+import { posix as pathPosix4 } 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: ID6,
+  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. Example: `[the guide](docs/guide.md)` draws an arrow to `docs/guide.md`.",
@@ -1819,7 +1887,7 @@ var markdownLinkExtractor = {
     const seen = /* @__PURE__ */ new Set();
     const body = stripCodeAndHtml(ctx.body);
     const lineStarts = computeLineStarts(body);
-    const sourceDir = pathPosix3.dirname(ctx.node.path);
+    const sourceDir = pathPosix4.dirname(ctx.node.path);
     for (const match of body.matchAll(LINK_RE)) {
       const original = match[2];
       const resolved = resolveTarget2(sourceDir, original);
@@ -1835,7 +1903,7 @@ var markdownLinkExtractor = {
         raw: match[0],
         candidates: [
           {
-            extractorId: ID6,
+            extractorId: ID7,
             kind: "references",
             target: resolved,
             // 0.95: the `[text](path)` syntax is unambiguous (the spec's
@@ -1866,14 +1934,14 @@ function resolveTarget2(sourceDir, raw) {
   if (URL_SCHEME_RE.test(trimmed)) return null;
   if (trimmed.startsWith("/")) return null;
   const joined = sourceDir === "." ? trimmed : `${sourceDir}/${trimmed}`;
-  return pathPosix3.normalize(joined);
+  return pathPosix4.normalize(joined);
 }
 
 // plugins/core/extractors/mcp-tools/index.ts
-var ID7 = "mcp-tools";
+var ID8 = "mcp-tools";
 var MCP_PATTERN = /^mcp__([a-z0-9][a-z0-9_-]*)__[a-z0-9_-]+$/i;
 var mcpToolsExtractor = {
-  id: ID7,
+  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. Example: `tools: [mcp__github__create_pr]` adds an `mcp://github` node and an arrow to it.",
@@ -1904,7 +1972,7 @@ var mcpToolsExtractor = {
         raw: `mcp__${server}__*`,
         candidates: [
           {
-            extractorId: ID7,
+            extractorId: ID8,
             kind: "references",
             target: mcpPath,
             confidence: 0.85,
@@ -1934,6 +2002,65 @@ function collectMcpServers(tools) {
   return out;
 }
 
+// plugins/core/extractors/slash-command/index.ts
+var ID9 = "slash-command";
+var SLASH_RE = /(?<![A-Za-z0-9_/.:?#=&])(\/[a-z0-9][a-z0-9_-]*(?::[a-z0-9][a-z0-9_-]*)?)/gi;
+var slashCommandExtractor = {
+  id: ID9,
+  pluginId: CORE_PLUGIN_ID,
+  kind: "extractor",
+  description: "Turns `/command` invocations in a node's body into arrows that point at the resolved slash command, skill, or workflow, using the `/`-grammar shared by Claude and Antigravity. Example: `/deploy` in the body draws an arrow to the `deploy` command.",
+  scope: "body",
+  // Also authorised under the antigravity lens, which shares the `/command`
+  // grammar: a workflow / skill / AGENTS.md body's `/name` tokens resolve to
+  // BOTH skills and workflows (`invokes: ['skill', 'workflow']`), since
+  // Antigravity invokes either by the same slash. NOT gated under codex:
+  // OpenAI Codex reserves `/` for its OWN built-in commands (`/model`,
+  // `/init`, ...) and invokes user skills with `$` instead (parsed by the
+  // codex `dollar-skill` extractor). A lens that declares no `invokes`
+  // resolution leaves the signals unresolved (no spurious edges).
+  precondition: { provider: ["claude", "antigravity"] },
+  extract(ctx) {
+    const seen = /* @__PURE__ */ new Set();
+    const body = stripCodeAndHtml(ctx.body);
+    const lineStarts = computeLineStarts(body);
+    for (const match of body.matchAll(SLASH_RE)) {
+      const original = match[1];
+      const endIdx = (match.index ?? 0) + match[0].length;
+      const nextChar = body[endIdx];
+      if (nextChar && /[A-Za-z0-9_/-]/.test(nextChar)) continue;
+      const normalized = normalizeTrigger(original);
+      if (seen.has(normalized)) continue;
+      seen.add(normalized);
+      const captureOffset = (match.index ?? 0) + match[0].indexOf(original);
+      const line = lineFor(lineStarts, captureOffset);
+      ctx.emitSignal({
+        source: ctx.node.path,
+        scope: "body",
+        range: { start: captureOffset, end: captureOffset + original.length, line },
+        raw: original,
+        candidates: [
+          {
+            extractorId: ID9,
+            kind: "invokes",
+            target: original,
+            // 0.8: clean `/command` match after code-block strip. The
+            // post-match path guard above filters URL / file-path noise,
+            // so a hit is unambiguous syntax. Resolution against the
+            // live skill / command catalog happens downstream.
+            confidence: 0.8,
+            rationale: "unambiguous slash syntax post code-block strip",
+            trigger: {
+              originalTrigger: original,
+              normalizedTrigger: normalized
+            }
+          }
+        ]
+      });
+    }
+  }
+};
+
 // plugins/core/analyzers/annotation-field-unknown/index.ts
 import { readFileSync } from "fs";
 import { dirname, resolve } from "path";
@@ -1973,10 +2100,10 @@ var ANNOTATION_FIELD_UNKNOWN_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-field-unknown/index.ts
-var ID8 = "annotation-field-unknown";
+var ID10 = "annotation-field-unknown";
 var RESERVED_ROOT_BLOCKS = /* @__PURE__ */ new Set(["identity", "annotations", "settings", "audit"]);
 var annotationFieldUnknownAnalyzer = {
-  id: ID8,
+  id: ID10,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags typos or unrecognized keys in sidecars (`.sm`).",
@@ -2011,7 +2138,7 @@ var annotationFieldUnknownAnalyzer = {
         for (const key of Object.keys(annotations)) {
           if (!knownAnnotationKeys.has(key)) {
             issues.push({
-              analyzerId: ID8,
+              analyzerId: ID10,
               severity: "warn",
               nodeIds: [node.path],
               message: formatFinding({
@@ -2037,7 +2164,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: ID10,
               severity: "warn",
               nodeIds: [node.path],
               message: formatFinding({
@@ -2052,7 +2179,7 @@ var annotationFieldUnknownAnalyzer = {
           continue;
         }
         issues.push({
-          analyzerId: ID8,
+          analyzerId: ID10,
           severity: "warn",
           nodeIds: [node.path],
           message: formatFinding({
@@ -2124,9 +2251,9 @@ var ANNOTATION_ORPHAN_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-orphan/index.ts
-var ID9 = "annotation-orphan";
+var ID11 = "annotation-orphan";
 var annotationOrphanAnalyzer = {
-  id: ID9,
+  id: ID11,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags sidecars (`.sm`) whose `.md` file no longer exists.",
@@ -2138,7 +2265,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: ID11,
         severity: "warn",
         nodeIds: [expectedMdRelative],
         message: formatFinding({
@@ -2181,7 +2308,7 @@ var ANNOTATION_STALE_TEXTS = {
 };
 
 // plugins/core/analyzers/annotation-stale/index.ts
-var ID10 = "annotation-stale";
+var ID12 = "annotation-stale";
 var staleIcon = {
   slot: "card.footer.right",
   icon: "pi-clock",
@@ -2194,7 +2321,7 @@ var staleBadge = {
   priority: 20
 };
 var annotationStaleAnalyzer = {
-  id: ID10,
+  id: ID12,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Marks sidecars (`.sm`) that are out of date with their `.md`.",
@@ -2214,7 +2341,7 @@ var annotationStaleAnalyzer = {
       const status = staleStatus(node.sidecar);
       if (status === null) continue;
       issues.push({
-        analyzerId: ID10,
+        analyzerId: ID12,
         severity: "info",
         nodeIds: [node.path],
         message: formatFinding({ body: messageFor(status) }),
@@ -2260,9 +2387,9 @@ function tooltipFor(status) {
 }
 
 // plugins/core/analyzers/contribution-orphan/index.ts
-var ID11 = "contribution-orphan";
+var ID13 = "contribution-orphan";
 var contributionOrphanAnalyzer = {
-  id: ID11,
+  id: ID13,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Warns about plugin data referencing nodes renamed or deleted in the latest scan.",
@@ -2294,12 +2421,12 @@ var EXTRACTOR_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/extractor-collision/index.ts
-var ID12 = "extractor-collision";
+var ID14 = "extractor-collision";
 function signalLines(signal) {
   return signal.range && typeof signal.range.line === "number" ? [signal.range.line] : void 0;
 }
 var extractorCollisionAnalyzer = {
-  id: ID12,
+  id: ID14,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Reports when two extractors detect something at the same span of body text and the resolver drops one.",
@@ -2323,7 +2450,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: ID12,
+    analyzerId: ID14,
     severity: "warn",
     nodeIds: [signal.source],
     message: formatFinding({
@@ -2367,7 +2494,7 @@ var ISSUE_COUNTER_TEXTS = {
 };
 
 // plugins/core/analyzers/issue-counter/index.ts
-var ID13 = "issue-counter";
+var ID15 = "issue-counter";
 var warnCount = {
   slot: "card.footer.right",
   icon: "pi-exclamation-triangle",
@@ -2403,7 +2530,7 @@ function emitTierChips(ctx, ref, severity, counts, singleTooltip, manyTooltip) {
   }
 }
 var issueCounterAnalyzer = {
-  id: ID13,
+  id: ID15,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Emits one aggregate severity chip per node (error + warn counts) from the live issue accumulator.",
@@ -2466,7 +2593,7 @@ var LINK_COUNTER_TEXTS = {
 };
 
 // plugins/core/analyzers/link-counter/index.ts
-var ID14 = "link-counter";
+var ID16 = "link-counter";
 var linksIn = {
   slot: "card.footer.left",
   icon: "pi-download",
@@ -2482,7 +2609,7 @@ var linksOut = {
   priority: 20
 };
 var linkCounterAnalyzer = {
-  id: ID14,
+  id: ID16,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Counts incoming and outgoing links per node.",
@@ -2547,10 +2674,10 @@ var LINK_KIND_CONFLICT_TEXTS = {
 };
 
 // plugins/core/analyzers/link-kind-conflict/index.ts
-var ID15 = "link-kind-conflict";
+var ID17 = "link-kind-conflict";
 var NON_CONFLICTING_KINDS = /* @__PURE__ */ new Set(["points"]);
 var linkKindConflictAnalyzer = {
-  id: ID15,
+  id: ID17,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags conflicting arrow meanings between extractors (e.g. `references` vs `invokes`).",
@@ -2598,7 +2725,7 @@ var linkKindConflictAnalyzer = {
       const [source, target] = key.split("\0");
       const kindList = variants.map((v) => v.kind).join(" / ");
       issues.push({
-        analyzerId: ID15,
+        analyzerId: ID17,
         severity: "warn",
         nodeIds: [source, target],
         message: formatFinding({
@@ -2637,9 +2764,9 @@ var LINK_SELF_LOOP_TEXTS = {
 };
 
 // plugins/core/analyzers/link-self-loop/index.ts
-var ID16 = "link-self-loop";
+var ID18 = "link-self-loop";
 var linkSelfLoopAnalyzer = {
-  id: ID16,
+  id: ID18,
   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`).",
@@ -2649,7 +2776,7 @@ var linkSelfLoopAnalyzer = {
     for (const link of ctx.links) {
       if (!isSelfLoop(link)) continue;
       issues.push({
-        analyzerId: ID16,
+        analyzerId: ID18,
         severity: "warn",
         nodeIds: [link.source],
         message: formatFinding({
@@ -2681,9 +2808,9 @@ var NAME_COLLISION_TEXTS = {
 };
 
 // plugins/core/analyzers/name-collision/index.ts
-var ID17 = "name-collision";
+var ID19 = "name-collision";
 var nameCollisionAnalyzer = {
-  id: ID17,
+  id: ID19,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   mode: "deterministic",
@@ -2697,7 +2824,7 @@ var nameCollisionAnalyzer = {
     for (const [name, claims] of collisions) {
       const paths = claims.map((c) => c.path);
       issues.push({
-        analyzerId: ID17,
+        analyzerId: ID19,
         severity: "error",
         nodeIds: paths,
         message: formatFinding({
@@ -2747,9 +2874,9 @@ var NAME_RESERVED_TEXTS = {
 };
 
 // plugins/core/analyzers/name-reserved/index.ts
-var ID18 = "name-reserved";
+var ID20 = "name-reserved";
 var nameReservedAnalyzer = {
-  id: ID18,
+  id: ID20,
   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.",
@@ -2767,7 +2894,7 @@ var nameReservedAnalyzer = {
       const node = byPath3.get(path);
       if (!node) continue;
       issues.push({
-        analyzerId: ID18,
+        analyzerId: ID20,
         severity: "warn",
         nodeIds: [node.path],
         message: formatFinding({
@@ -2789,7 +2916,7 @@ var nameReservedAnalyzer = {
         adjust(link, { kind: "delta", value: -RESERVED_PENALTY });
       }
       issues.push({
-        analyzerId: ID18,
+        analyzerId: ID20,
         severity: "warn",
         nodeIds: [link.source],
         message: formatFinding({
@@ -2841,7 +2968,7 @@ var NODE_STABILITY_TEXTS = {
 };
 
 // plugins/core/analyzers/node-stability/index.ts
-var ID19 = "node-stability";
+var ID21 = "node-stability";
 var EXPERIMENTAL_TOOLTIP = "Experimental: API may change";
 var DEPRECATED_TOOLTIP = "Deprecated: avoid in new code";
 var experimental = {
@@ -2859,7 +2986,7 @@ var deprecated = {
   priority: 10
 };
 var nodeStabilityAnalyzer = {
-  id: ID19,
+  id: ID21,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Surfaces a node's stability stage on the card: `deprecated` as a chip plus a finding, `experimental` as a chip only; `stable` and unset stay silent.",
@@ -2881,7 +3008,7 @@ var nodeStabilityAnalyzer = {
           severity: "warn"
         });
         issues.push({
-          analyzerId: ID19,
+          analyzerId: ID21,
           severity: "warn",
           nodeIds: [node.path],
           message: formatFinding({ body: tx(NODE_STABILITY_TEXTS.deprecated) }),
@@ -2933,9 +3060,9 @@ var REFERENCE_BROKEN_TEXTS = {
 };
 
 // plugins/core/analyzers/reference-broken/index.ts
-var ID20 = "reference-broken";
+var ID22 = "reference-broken";
 var referenceBrokenAnalyzer = {
-  id: ID20,
+  id: ID22,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags arrows pointing at a node not part of the current scan.",
@@ -2978,7 +3105,7 @@ function penalizeBrokenConfidence(adjust, link) {
 }
 function buildIssue(link) {
   return {
-    analyzerId: ID20,
+    analyzerId: ID22,
     // `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
@@ -3042,9 +3169,9 @@ var REFERENCE_REDUNDANT_TEXTS = {
 };
 
 // plugins/core/analyzers/reference-redundant/index.ts
-var ID21 = "reference-redundant";
+var ID23 = "reference-redundant";
 var referenceRedundantAnalyzer = {
-  id: ID21,
+  id: ID23,
   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).",
@@ -3067,7 +3194,7 @@ var referenceRedundantAnalyzer = {
       const [source, resolvedTarget] = key.split("\0");
       const flat = flattenOccurrences(links);
       issues.push({
-        analyzerId: ID21,
+        analyzerId: ID23,
         severity: "info",
         nodeIds: [source],
         message: formatFinding({
@@ -3403,9 +3530,9 @@ var SCHEMA_VIOLATION_TEXTS = {
 };
 
 // plugins/core/analyzers/schema-violation/index.ts
-var ID22 = "schema-violation";
+var ID24 = "schema-violation";
 var schemaViolationAnalyzer = {
-  id: ID22,
+  id: ID24,
   pluginId: CORE_PLUGIN_ID,
   kind: "analyzer",
   description: "Flags nodes or links that violate the project schemas.",
@@ -3455,7 +3582,7 @@ function collectNodeFindings(v, node, out) {
   const result = v.validate("node", toNodeForSchema(node));
   if (result.ok) return;
   out.push({
-    analyzerId: ID22,
+    analyzerId: ID24,
     severity: "error",
     nodeIds: [node.path],
     message: formatFinding({
@@ -3470,7 +3597,7 @@ function collectLinkFindings(v, link, out) {
   const result = v.validate("link", toLinkForSchema(link));
   if (result.ok) return;
   out.push({
-    analyzerId: ID22,
+    analyzerId: ID24,
     severity: "error",
     nodeIds: [link.source],
     message: formatFinding({
@@ -3539,13 +3666,13 @@ var ASCII_FORMATTER_TEXTS = {
 };
 
 // plugins/core/formatters/ascii/index.ts
-var ID23 = "ascii";
+var ID25 = "ascii";
 var KIND_ORDER = ["agent", "command", "skill", "markdown"];
 var asciiFormatter = {
-  id: ID23,
+  id: ID25,
   pluginId: CORE_PLUGIN_ID,
   kind: "formatter",
-  formatId: ID23,
+  formatId: ID25,
   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
@@ -3639,13 +3766,13 @@ function renderSection(out, kind, group) {
 }
 
 // plugins/core/formatters/json/index.ts
-var ID24 = "json";
+var ID26 = "json";
 var jsonFormatter = {
-  id: ID24,
+  id: ID26,
   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: ID24,
+  formatId: ID26,
   format(ctx) {
     if (ctx.scanResult !== void 0) {
       return JSON.stringify(ctx.scanResult);
@@ -3792,13 +3919,13 @@ var BUMP_TEXTS = {
 };
 
 // plugins/core/actions/node-bump/index.ts
-var ID25 = "node-bump";
+var ID27 = "node-bump";
 var bumpButton = {
   slot: "inspector.action.button",
   priority: 10
 };
 var nodeBumpAction = {
-  id: ID25,
+  id: ID27,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Marks a node as updated: bumps `annotations.version`, refreshes sidecar hashes, and records the timestamp.",
@@ -3901,13 +4028,13 @@ var NODE_SET_STABILITY_TEXTS = {
 };
 
 // plugins/core/actions/node-set-stability/index.ts
-var ID26 = "node-set-stability";
+var ID28 = "node-set-stability";
 var setStabilityButton = {
   slot: "inspector.action.button",
   priority: 15
 };
 var nodeSetStabilityAction = {
-  id: ID26,
+  id: ID28,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the lifecycle stage of the current node (writes `stability` to the sidecar).",
@@ -3979,9 +4106,9 @@ function invokeSetStability(input, ctx) {
 }
 
 // plugins/core/actions/node-set-tags/index.ts
-var ID27 = "node-set-tags";
+var ID29 = "node-set-tags";
 var nodeSetTagsAction = {
-  id: ID27,
+  id: ID29,
   pluginId: CORE_PLUGIN_ID,
   kind: "action",
   description: "Sets the taxonomy tags of the current node (writes `tags` to the sidecar; whole-array replace).",
@@ -4519,16 +4646,18 @@ var updateCheckHook = {
 // plugins/built-ins.ts
 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 codexProvider2 = { ...codexProvider, pluginId: "codex", version: VERSION };
+var dollarSkillExtractor2 = { ...dollarSkillExtractor, pluginId: "codex", version: VERSION };
 var agentSkillsProvider2 = { ...agentSkillsProvider, pluginId: "agent-skills", version: VERSION };
 var coreMarkdownProvider2 = { ...coreMarkdownProvider, pluginId: "core", version: VERSION };
+var atFileExtractor2 = { ...atFileExtractor, 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 slashCommandExtractor2 = { ...slashCommandExtractor, 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 };
@@ -4557,7 +4686,6 @@ var builtInPlugins = [
     extensions: [
       claudeProvider2,
       atDirectiveExtractor2,
-      slashCommandExtractor2,
       toolsCounterExtractor2
     ]
   },
@@ -4572,7 +4700,8 @@ var builtInPlugins = [
     id: "codex",
     description: "OpenAI Codex CLI platform integration. Classifies TOML sub-agent definitions under `.codex/agents/*.toml`.",
     extensions: [
-      codexProvider2
+      codexProvider2,
+      dollarSkillExtractor2
     ]
   },
   {
@@ -4587,10 +4716,12 @@ var builtInPlugins = [
     description: "Core extensions shared across providers: parsers, extractors, analyzers, actions, hooks, formatters, and the universal `.md` fallback provider.",
     extensions: [
       coreMarkdownProvider2,
+      atFileExtractor2,
       backtickPathExtractor2,
       externalUrlCounterExtractor2,
       markdownLinkExtractor2,
       mcpToolsExtractor2,
+      slashCommandExtractor2,
       annotationFieldUnknownAnalyzer2,
       annotationOrphanAnalyzer2,
       annotationStaleAnalyzer2,
@@ -12176,14 +12307,16 @@ import { existsSync as existsSync16 } from "fs";
 import { join as join10 } from "path";
 function detectProvidersFromFilesystem(cwd, providers) {
   const seen = /* @__PURE__ */ new Set();
-  const out = [];
+  const matched = [];
   for (const provider of providers) {
     if (seen.has(provider.id)) continue;
     if (!isDetectableUnderCwd(cwd, provider)) continue;
     seen.add(provider.id);
-    out.push(provider.id);
+    matched.push(provider);
   }
-  return out;
+  const hasVendor = matched.some((p) => p.detect?.fallback !== true);
+  const kept = hasVendor ? matched.filter((p) => p.detect?.fallback !== true) : matched;
+  return kept.map((p) => p.id);
 }
 function isDetectableUnderCwd(cwd, provider) {
   if (!installedDefaultEnabled(provider.stability)) return false;
@@ -16400,6 +16533,8 @@ var ORCHESTRATOR_TEXTS = {
   frontmatterMalformedPasteWithIndent: "Frontmatter fence in {{path}} appears indented; YAML frontmatter MUST start with `---` at column 0. The file was scanned as body-only; the metadata block was silently lost. Move the `---` lines to the start of the line.",
   frontmatterMalformedByteOrderMark: "Frontmatter fence in {{path}} is preceded by a UTF-8 byte-order mark (BOM); the file was scanned as body-only. Re-save the file as UTF-8 without BOM. The metadata block was silently lost.",
   frontmatterMalformedMissingClose: "Frontmatter in {{path}} opens with `---` but never closes (no matching `---` line at column 0 was found). The file was scanned as body-only and every metadata field was silently lost. Add a closing `---` line below the metadata block.",
+  bodyBacktickUnclosedFence: "Body of {{path}} has an unclosed fenced code block opened at body line {{line}} (no matching closing ``` or ~~~). The code-strip policy then reads the rest of the file as code, so prose extractors stop emitting edges past it. Close the fence.",
+  bodyBacktickUnclosedInline: "Body of {{path}} has an unclosed inline backtick at body line {{line}} (the backtick run has no equal-length closer). Close the inline span with a matching backtick run, or escape a literal backtick with a backslash.",
   extensionErrorLinkKindNotDeclared: 'Extractor "{{extractorId}}" emitted a link of kind "{{linkKind}}" outside its declared `emitsLinkKinds` set [{{declaredKinds}}]. Link dropped.',
   extensionErrorIssueInvalidSeverity: `Rule "{{analyzerId}}" emitted an issue with invalid severity {{severity}} (allowed: 'error' | 'warn' | 'info'). Issue dropped.`,
   extensionErrorContributionUndeclaredRef: 'Extension "{{extractorId}}" emitted a view contribution on {{nodePath}} whose object is not one declared in its `ui` map (pass the declared const by reference, do not spread or inline it). Contribution dropped.',
@@ -17085,6 +17220,11 @@ var FRONTMATTER_ISSUE_ANALYZERS = /* @__PURE__ */ new Set([
   "frontmatter-malformed",
   "frontmatter-parse-error"
 ]);
+var BACKTICK_ISSUE_ID = "backtick-unbalanced";
+var CACHED_KERNEL_ISSUE_ANALYZERS = /* @__PURE__ */ new Set([
+  ...FRONTMATTER_ISSUE_ANALYZERS,
+  BACKTICK_ISSUE_ID
+]);
 
 // kernel/orchestrator/cache.ts
 function indexPriorSnapshot(prior) {
@@ -17114,7 +17254,7 @@ function indexPriorLinks(links, byOriginating) {
 }
 function indexPriorFrontmatterIssues(issues, byNode) {
   for (const issue of issues) {
-    if (!FRONTMATTER_ISSUE_ANALYZERS.has(issue.analyzerId)) continue;
+    if (!CACHED_KERNEL_ISSUE_ANALYZERS.has(issue.analyzerId)) continue;
     if (issue.nodeIds.length !== 1) continue;
     const path = issue.nodeIds[0];
     const list = byNode.get(path);
@@ -17254,7 +17394,7 @@ function classifyLinkSource(source, shortIdToQualified, cachedQualifiedIds, appl
 }
 
 // kernel/orchestrator/node-identifiers.ts
-import { posix as pathPosix4 } from "path";
+import { posix as pathPosix5 } from "path";
 function deriveNodeIdentifiers(node, kindDescriptor) {
   const sources = kindDescriptor?.identifiers;
   if (!sources || sources.length === 0) return [];
@@ -17278,16 +17418,16 @@ function readFrontmatterName(node) {
   return raw.length > 0 ? raw : null;
 }
 function readFilenameBasename(node) {
-  const base = pathPosix4.basename(node.path);
+  const base = pathPosix5.basename(node.path);
   if (!base) return null;
-  const ext = pathPosix4.extname(base);
+  const ext = pathPosix5.extname(base);
   const stem = ext ? base.slice(0, -ext.length) : base;
   return stem.length > 0 ? stem : null;
 }
 function readDirname(node) {
-  const dir = pathPosix4.dirname(node.path);
+  const dir = pathPosix5.dirname(node.path);
   if (!dir || dir === "." || dir === "/") return null;
-  const base = pathPosix4.basename(dir);
+  const base = pathPosix5.basename(dir);
   return base.length > 0 ? base : null;
 }
 function collectNameCollisions(nodes, kindRegistry) {
@@ -17384,7 +17524,7 @@ function lookupAllowedKinds(link, _indexes, ctx) {
 }
 function stripTriggerSigil(normalized) {
   if (!normalized) return null;
-  const trimmed = normalized.replace(/^[/@]/, "").trim();
+  const trimmed = normalized.replace(/^[/@$]/, "").trim();
   return trimmed.length === 0 ? null : trimmed;
 }
 function indexNode(node, ctx, byName) {
@@ -17858,6 +17998,21 @@ function malformedMessage(hint, path) {
   }
 }
 
+// kernel/orchestrator/body-syntax.ts
+function detectUnclosedBacktick(body, path, strict) {
+  const imbalance = findBacktickImbalance(body);
+  if (!imbalance) return null;
+  const template = imbalance.kind === "fence" ? ORCHESTRATOR_TEXTS.bodyBacktickUnclosedFence : ORCHESTRATOR_TEXTS.bodyBacktickUnclosedInline;
+  return {
+    analyzerId: BACKTICK_ISSUE_ID,
+    severity: strict ? "error" : "warn",
+    nodeIds: [path],
+    message: tx(template, { path, line: imbalance.line }),
+    detail: imbalance.sourceLine,
+    data: { kind: imbalance.kind, line: imbalance.line }
+  };
+}
+
 // kernel/orchestrator/node-build.ts
 function buildNode(args2) {
   const bytesFrontmatter = Buffer.byteLength(args2.frontmatterRaw, "utf8");
@@ -17984,6 +18139,9 @@ function relativePathFromRoots(absolutePath, roots) {
   }
   return absolutePath;
 }
+function pushIssue(list, issue) {
+  if (issue) list.push(issue);
+}
 function buildFreshNodeAndValidateFrontmatter(opts) {
   const node = buildNode({
     path: opts.raw.path,
@@ -18011,19 +18169,27 @@ function buildFreshNodeAndValidateFrontmatter(opts) {
     }
   }
   if (opts.raw.frontmatterRaw.length > 0) {
-    const fmIssue = validateFrontmatter(
-      opts.providerFrontmatter,
-      opts.provider,
-      opts.kind,
-      opts.raw.frontmatter,
-      opts.raw.path,
-      opts.strict
+    pushIssue(
+      frontmatterIssues,
+      validateFrontmatter(
+        opts.providerFrontmatter,
+        opts.provider,
+        opts.kind,
+        opts.raw.frontmatter,
+        opts.raw.path,
+        opts.strict
+      )
     );
-    if (fmIssue) frontmatterIssues.push(fmIssue);
   } else {
-    const malformed = detectMalformedFrontmatter(opts.raw.body, opts.raw.path, opts.strict);
-    if (malformed) frontmatterIssues.push(malformed);
+    pushIssue(
+      frontmatterIssues,
+      detectMalformedFrontmatter(opts.raw.body, opts.raw.path, opts.strict)
+    );
   }
+  pushIssue(
+    frontmatterIssues,
+    detectUnclosedBacktick(opts.raw.body, opts.raw.path, opts.strict)
+  );
   return { node, frontmatterIssues };
 }
 
@@ -30420,6 +30586,7 @@ function presentationOptionals(ui) {
   if (ui.emoji !== void 0) out.emoji = ui.emoji;
   if (ui.icon !== void 0) out.icon = ui.icon;
   if (ui.hideChip !== void 0) out.hideChip = ui.hideChip;
+  if (ui.invocationSigil !== void 0) out.invocationSigil = ui.invocationSigil;
   return out;
 }
 function resolveProviderBodyField(read) {
@@ -32436,15 +32603,20 @@ var TUTORIAL_TEXTS = {
   writtenLabelEs: "Espa\xF1ol",
   // Destination-provider prompt (interactive stdin, no `--for`). Header
   // uses a yellow `?` glyph; options are a numbered list of the provider's
-  // vendor name (for a provider with an `aka`, the aka vendor leads and the
-  // provider label follows in parentheses), with a `(default)` marker on
-  // the first option (Claude). The destination folder is deliberately NOT
-  // shown: several providers share `.agents/skills`, so the folder does not
-  // identify the lens. The input line accepts a number, a provider id, or
-  // an empty answer (which takes the default).
+  // label (for a provider with an `aka`, the standard label leads and the
+  // supporting vendors follow in parentheses, closed by `akaOthers` to mark
+  // the set as open), with a `(default)` marker on the first option (Claude).
+  // The destination folder is deliberately NOT shown: several providers share
+  // `.agents/skills`, so the folder does not identify the lens. The input line
+  // accepts a number, a provider id, or an empty answer (which takes the
+  // default).
   promptHeader: "{{glyph}}  Which agent should host the tutorial skill?",
   promptOption: "     {{index}}) {{label}}{{marker}}",
   promptDefaultMarker: "  (default)",
+  // Trailing token appended to the `aka` vendor list in the open-lens label
+  // ("... (Google's Antigravity, others)"), signalling the open standard is
+  // not tied to a single vendor and more will support it.
+  akaOthers: "others",
   promptInput: "  Enter the number or provider id [default {{index}}]: ",
   // Prompt answer matched neither an index nor an id. Goes to stderr,
   // exit code 2. Mirrors the error shape: glyph + headline + dim hint.
@@ -32694,7 +32866,7 @@ function listScaffoldTargets(includeExperimental = false) {
   return out;
 }
 function labelWithAka(target) {
-  return target.aka.length > 0 ? `${target.aka.join(", ")} (${target.label})` : target.label;
+  return target.aka.length > 0 ? `${target.label} (${[...target.aka, TUTORIAL_TEXTS.akaOthers].join(", ")})` : target.label;
 }
 function renderTargetLines(targets, def, glyph) {
   const lines = [tx(TUTORIAL_TEXTS.promptHeader, { glyph })];
@@ -32989,4 +33161,4 @@ function resolveBareDefault() {
   process.exit(ExitCode.Error);
 }
 //# sourceMappingURL=cli.js.map
-//# debugId=75d0c2c2-d08f-5d7c-aa62-3e1d53dd4ef1
+//# debugId=81f53ca6-a8bf-5fc1-909d-ce926a83f056