@skill-map/cli 0.29.0 → 0.30.0

package/dist/cli.js

@@ -775,6 +775,53 @@ function link(source, target) {
   };
 }
 
+// kernel/util/strip-code-blocks.ts
+var FENCE_RE = /^(?<indent> {0,3})(?<fence>`{3,}|~{3,})/;
+function stripCodeBlocks(input) {
+  if (!input) return input;
+  const fenceless = stripFences(input);
+  return stripInline(fenceless);
+}
+function stripFences(input) {
+  const out = [];
+  const lines = input.split("\n");
+  let openFence = null;
+  for (const line of lines) {
+    if (openFence) {
+      const closer = matchClosingFence(line, openFence);
+      if (closer) {
+        out.push(blank(line));
+        openFence = null;
+      } else {
+        out.push(blank(line));
+      }
+      continue;
+    }
+    const open = FENCE_RE.exec(line);
+    if (open?.groups) {
+      openFence = open.groups["fence"];
+      out.push(blank(line));
+      continue;
+    }
+    out.push(line);
+  }
+  return out.join("\n");
+}
+function matchClosingFence(line, openFence) {
+  const m = FENCE_RE.exec(line);
+  if (!m?.groups) return false;
+  const fence = m.groups["fence"];
+  return fence[0] === openFence[0] && fence.length >= openFence.length;
+}
+function stripInline(input) {
+  return input.replace(/(`+)([\s\S]*?)\1/g, (_full, ticks, body) => {
+    return ticks.replace(/`/g, " ") + blank(body) + ticks.replace(/`/g, " ");
+  });
+}
+function blank(s) {
+  return s.replace(/[^\s]/g, " ");
+}
+
 // kernel/trigger-normalize.ts
 function normalizeTrigger(source) {
   let out = source.normalize("NFD");
@@ -787,21 +834,43 @@ function normalizeTrigger(source) {
 
 // plugins/core/extractors/at-directive/index.ts
 var ID2 = "at-directive";
-var AT_RE = /(?:^|[^A-Za-z0-9_@])(@[a-z0-9][a-z0-9_-]*(?:[/:][a-z0-9][a-z0-9_-]*)?)/gi;
+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: ID2,
   pluginId: "core",
   kind: "extractor",
   version: "1.0.0",
-  description: "Detects `@agent-name` mentions in a node's body and turns each one into an arrow between nodes in the graph.",
+  description: "Detects `@<token>` directives in a node's body. 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, matching how Claude Code / Gemini CLI / Cursor read the same syntax.",
   scope: "body",
   extract(ctx) {
-    const seen = /* @__PURE__ */ new Set();
-    for (const match of ctx.body.matchAll(AT_RE)) {
+    const seenMentions = /* @__PURE__ */ new Set();
+    const seenReferences = /* @__PURE__ */ new Set();
+    const body = stripCodeBlocks(ctx.body);
+    for (const match of body.matchAll(AT_RE)) {
       const original = match[1];
+      const bare = original.slice(1);
+      const isReference = bare.startsWith("./") || bare.startsWith("../") || bare.startsWith("/") || FILE_EXT_RE.test(bare);
+      if (isReference) {
+        const target = bare.replace(/^\.\//, "");
+        if (seenReferences.has(target)) continue;
+        seenReferences.add(target);
+        ctx.emitLink({
+          source: ctx.node.path,
+          target,
+          kind: "references",
+          confidence: "medium",
+          sources: [ID2],
+          trigger: {
+            originalTrigger: original,
+            normalizedTrigger: target.toLowerCase()
+          }
+        });
+        continue;
+      }
       const normalized = normalizeTrigger(original);
-      if (seen.has(normalized)) continue;
-      seen.add(normalized);
+      if (seenMentions.has(normalized)) continue;
+      seenMentions.add(normalized);
       ctx.emitLink({
         source: ctx.node.path,
         target: original,
@@ -993,8 +1062,12 @@ var slashExtractor = {
   scope: "body",
   extract(ctx) {
     const seen = /* @__PURE__ */ new Set();
-    for (const match of ctx.body.matchAll(SLASH_RE)) {
+    const body = stripCodeBlocks(ctx.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);
@@ -1176,7 +1249,7 @@ function tooltipFor(status) {
 }
 
 // plugins/core/analyzers/broken-ref/index.ts
-import { resolve } from "path";
+import { posix as pathPosix2, resolve } from "path";
 
 // plugins/core/analyzers/broken-ref/text.ts
 var BROKEN_REF_TEXTS = {
@@ -1185,7 +1258,13 @@ var BROKEN_REF_TEXTS = {
   // Tooltips for the per-node view-contribution badges. Singular vs
   // plural keeps the count grammar correct without a sub-template.
   alertTooltipSingle: "This node has a broken reference. Open the inspector for details.",
-  alertTooltipMany: "This node has {{count}} broken references. Open the inspector for details."
+  alertTooltipMany: "This node has {{count}} broken references. Open the inspector for details.",
+  // Fix-summary copy when the broken trigger has a same-named file on
+  // disk that does not advertise `name:` in its frontmatter. Two
+  // variants for single vs multiple candidates; same template family
+  // as the alert tooltips above.
+  hintSummarySingle: "Add `name: {{name}}` to the frontmatter of {{candidate}} so this reference resolves.",
+  hintSummaryMany: "Add `name: {{name}}` to the frontmatter of one of these files so this reference resolves: {{candidates}}."
 };
 
 // plugins/core/analyzers/broken-ref/index.ts
@@ -1225,13 +1304,15 @@ var brokenRefAnalyzer = {
   evaluate(ctx) {
     const byPath3 = new Set(ctx.nodes.map((n) => n.path));
     const byNormalizedName = indexByNormalizedName(ctx.nodes);
+    const byBasenameWithoutName = indexByBasenameWithoutName(ctx.nodes);
     const refIndex = ctx.referenceablePaths && ctx.referenceablePaths.size > 0 && ctx.cwd ? { paths: ctx.referenceablePaths, cwd: ctx.cwd } : null;
     const issues = [];
     const perNode = /* @__PURE__ */ new Map();
     for (const link2 of ctx.links) {
       if (isResolved(link2, byPath3, byNormalizedName)) continue;
       if (refIndex && resolvesViaReferencePaths(link2, refIndex)) continue;
-      issues.push(buildIssue(link2));
+      const candidates = findHintCandidates(link2, byBasenameWithoutName);
+      issues.push(buildIssue(link2, candidates));
       perNode.set(link2.source, (perNode.get(link2.source) ?? 0) + 1);
     }
     for (const [nodePath, count] of perNode) {
@@ -1251,8 +1332,13 @@ var brokenRefAnalyzer = {
     return issues;
   }
 };
-function buildIssue(link2) {
-  return {
+function buildIssue(link2, hintCandidates = []) {
+  const data = {
+    target: link2.target,
+    kind: link2.kind,
+    trigger: link2.trigger?.normalizedTrigger ?? null
+  };
+  const issue = {
     analyzerId: ID9,
     severity: "warn",
     nodeIds: [link2.source],
@@ -1261,12 +1347,28 @@ function buildIssue(link2) {
       source: link2.source,
       target: link2.target
     }),
-    data: {
-      target: link2.target,
-      kind: link2.kind,
-      trigger: link2.trigger?.normalizedTrigger ?? null
-    }
+    data
   };
+  if (hintCandidates.length > 0) {
+    const suggestedName = (link2.trigger?.normalizedTrigger ?? "").replace(/^[/@]/, "").trim();
+    const candidatePaths = hintCandidates.map((n) => n.path);
+    data["hint"] = {
+      kind: "missing-frontmatter-name",
+      suggestedName,
+      candidates: candidatePaths
+    };
+    issue.fix = {
+      summary: candidatePaths.length === 1 ? tx(BROKEN_REF_TEXTS.hintSummarySingle, {
+        name: suggestedName,
+        candidate: candidatePaths[0]
+      }) : tx(BROKEN_REF_TEXTS.hintSummaryMany, {
+        name: suggestedName,
+        candidates: candidatePaths.join(", ")
+      }),
+      autofixable: false
+    };
+  }
+  return issue;
 }
 function resolvesViaReferencePaths(link2, refIndex) {
   if (!isPathStyleLink(link2)) return false;
@@ -1285,6 +1387,36 @@ function indexByNormalizedName(nodes) {
   }
   return out;
 }
+function basenameWithoutExt(path) {
+  const base = pathPosix2.basename(path);
+  const ext = pathPosix2.extname(base);
+  return ext ? base.slice(0, -ext.length) : base;
+}
+function indexByBasenameWithoutName(nodes) {
+  const out = /* @__PURE__ */ new Map();
+  for (const node of nodes) {
+    const raw = node.frontmatter?.["name"];
+    const name = typeof raw === "string" ? raw : "";
+    if (name) continue;
+    const bare = basenameWithoutExt(node.path);
+    if (!bare) continue;
+    const key = normalizeTrigger(bare);
+    if (!key) continue;
+    const bucket = out.get(key) ?? [];
+    bucket.push(node);
+    out.set(key, bucket);
+  }
+  return out;
+}
+function findHintCandidates(link2, idx) {
+  const normalized = link2.trigger?.normalizedTrigger;
+  if (!normalized) return [];
+  const sigil = normalized.charAt(0);
+  if (sigil !== "/" && sigil !== "@") return [];
+  const withoutSigil = normalized.slice(1).trim();
+  if (!withoutSigil) return [];
+  return idx.get(withoutSigil) ?? [];
+}
 function isResolved(link2, byPath3, byNormalizedName) {
   const normalized = link2.trigger?.normalizedTrigger;
   if (normalized) {
@@ -2831,7 +2963,7 @@ var UPDATE_CHECK_TEXTS = {
 // package.json
 var package_default = {
   name: "@skill-map/cli",
-  version: "0.29.0",
+  version: "0.30.0",
   description: "skill-map reference implementation \u2014 kernel + CLI + adapters.",
   license: "MIT",
   type: "module",