@skill-map/cli 0.69.0 → 0.71.0

package/dist/index.js

@@ -1,6 +1,6 @@
 // kernel/i18n/registry.texts.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]="8412e979-4214-5385-b673-277f1b8e6e02")}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]="44976d76-8c48-5b39-862d-641f0e3be027")}catch(e){}}();
 var REGISTRY_TEXTS = {
   duplicateExtension: "Extension already registered: {{kind}}:{{qualifiedId}}",
   unknownKind: "Unknown extension kind: {{kind}}",
@@ -102,7 +102,7 @@ import { Tiktoken as Tiktoken2 } from "js-tiktoken/lite";
 // 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",
@@ -789,6 +789,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.',
@@ -814,14 +816,16 @@ function installedDefaultEnabled(stability) {
 // kernel/scan/detect-providers.ts
 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;
@@ -1506,6 +1510,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) {
@@ -1535,7 +1544,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);
@@ -1817,7 +1826,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) {
@@ -2801,6 +2810,83 @@ function malformedMessage(hint, path) {
   }
 }
 
+// kernel/util/strip-code-blocks.ts
+var FENCE_RE = /^(?<indent> {0,3})(?<fence>`{3,}|~{3,})/;
+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 scanFences(input) {
+  const out = [];
+  const lines = input.split("\n");
+  let openFence = null;
+  let openFenceLine = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (openFence) {
+      if (matchClosingFence(line, openFence)) openFence = null;
+      out.push(blank(line));
+      continue;
+    }
+    const open = FENCE_RE.exec(line);
+    if (open?.groups) {
+      openFence = open.groups["fence"];
+      openFenceLine = i + 1;
+      out.push(blank(line));
+      continue;
+    }
+    out.push(line);
+  }
+  return { stripped: out.join("\n"), openFenceLine: openFence ? openFenceLine : 0 };
+}
+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/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(args) {
   const bytesFrontmatter = Buffer.byteLength(args.frontmatterRaw, "utf8");
@@ -2927,6 +3013,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,
@@ -2954,19 +3043,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 };
 }
 function mergeNodeWithEnrichments(node, enrichments, opts = {}) {
@@ -4164,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=8412e979-4214-5385-b673-277f1b8e6e02
+//# debugId=44976d76-8c48-5b39-862d-641f0e3be027

package/dist/kernel/index.d.ts

@@ -2582,6 +2582,21 @@ interface IProviderUi {
      * topbar lens chip; only the per-card badge is suppressed.
      */
     hideChip?: boolean;
+    /**
+     * Single glyph this lens's runtime uses to invoke a skill / command,
+     * surfaced as the `invokes` edge-kind glyph (and its tooltip example)
+     * in the link-kind palette so the operator recognises the source
+     * syntax instantly. `/` for the slash-invoking lenses (`claude`
+     * commands + skills, `antigravity` skills + workflows), `$` for
+     * `codex` (skills are `$skill`; `/` is reserved for Codex's own
+     * built-in commands). Omitted for lenses with no `/`/`$` invocation
+     * channel (the open-standard `agent-skills`, where skills activate by
+     * `description`, and the non-lens `markdown` base): under those no
+     * `invokes` edge arises, so the palette never paints the glyph.
+     * Projected into `providerRegistry` and joined client-side against
+     * the active lens.
+     */
+    invocationSigil?: string;
 }
 /**
  * Auto-detection markers for the active-provider lens. The lens resolver
@@ -2598,6 +2613,18 @@ interface IProviderDetect {
      * A directory or a file both count; existence is the only test.
      */
     markers: string[];
+    /**
+     * When `true`, this Provider is the open-standard FALLBACK lens: its
+     * markers produce a detection candidate ONLY when no non-fallback
+     * (vendor) Provider matched under the same scope. Reserved for
+     * `agent-skills`, whose `.agents/` marker is the shared skill home that
+     * vendor lenses (`codex`, `antigravity`) also populate; without this flag
+     * a `.codex/` + `.agents/` project would falsely read as an ambiguous
+     * `codex` vs `agent-skills` pair. Vendor Providers omit it (default
+     * `false`) so two vendor markers still surface a real ambiguous prompt.
+     * Mirrors `provider.schema.json#/properties/detect/properties/fallback`.
+     */
+    fallback?: boolean;
 }
 /**
  * Authoring targets for verbs that MATERIALISE files into this

package/dist/kernel/index.js

@@ -1,6 +1,6 @@
 // kernel/i18n/registry.texts.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]="c7e7d754-73eb-5f99-8e19-732a9f84a4c8")}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]="7667ff07-bdd8-541a-b813-e01e201964f0")}catch(e){}}();
 var REGISTRY_TEXTS = {
   duplicateExtension: "Extension already registered: {{kind}}:{{qualifiedId}}",
   unknownKind: "Unknown extension kind: {{kind}}",
@@ -102,7 +102,7 @@ import { Tiktoken as Tiktoken2 } from "js-tiktoken/lite";
 // 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",
@@ -789,6 +789,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.',
@@ -814,14 +816,16 @@ function installedDefaultEnabled(stability) {
 // kernel/scan/detect-providers.ts
 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;
@@ -1506,6 +1510,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) {
@@ -1535,7 +1544,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);
@@ -1817,7 +1826,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) {
@@ -2801,6 +2810,83 @@ function malformedMessage(hint, path) {
   }
 }
 
+// kernel/util/strip-code-blocks.ts
+var FENCE_RE = /^(?<indent> {0,3})(?<fence>`{3,}|~{3,})/;
+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 scanFences(input) {
+  const out = [];
+  const lines = input.split("\n");
+  let openFence = null;
+  let openFenceLine = 0;
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (openFence) {
+      if (matchClosingFence(line, openFence)) openFence = null;
+      out.push(blank(line));
+      continue;
+    }
+    const open = FENCE_RE.exec(line);
+    if (open?.groups) {
+      openFence = open.groups["fence"];
+      openFenceLine = i + 1;
+      out.push(blank(line));
+      continue;
+    }
+    out.push(line);
+  }
+  return { stripped: out.join("\n"), openFenceLine: openFence ? openFenceLine : 0 };
+}
+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/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(args) {
   const bytesFrontmatter = Buffer.byteLength(args.frontmatterRaw, "utf8");
@@ -2927,6 +3013,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,
@@ -2954,19 +3043,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 };
 }
 function mergeNodeWithEnrichments(node, enrichments, opts = {}) {
@@ -4164,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=c7e7d754-73eb-5f99-8e19-732a9f84a4c8
+//# debugId=7667ff07-bdd8-541a-b813-e01e201964f0