@skill-map/cli 0.70.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]="9e0186ab-b10f-5a49-8eef-f0668584ed01")}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.70.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.',
@@ -1508,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) {
@@ -1537,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);
@@ -2803,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");
@@ -2929,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,
@@ -2956,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 = {}) {
@@ -4166,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=9e0186ab-b10f-5a49-8eef-f0668584ed01
+//# debugId=44976d76-8c48-5b39-862d-641f0e3be027

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]="37ae34a6-8712-5003-b7e6-767b1b040298")}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.70.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.',
@@ -1508,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) {
@@ -1537,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);
@@ -2803,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");
@@ -2929,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,
@@ -2956,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 = {}) {
@@ -4166,4 +4261,4 @@ export {
   runScanWithRenames
 };
 //# sourceMappingURL=index.js.map
-//# debugId=37ae34a6-8712-5003-b7e6-767b1b040298
+//# debugId=7667ff07-bdd8-541a-b813-e01e201964f0