superbee 0.4.3-pre.3 → 0.4.3-pre.5

package/README.md

@@ -92,6 +92,12 @@ Setup itself changes nothing. It inspects your configuration and returns one saf
 a time, and the agent runs each with your approval. Setup knows Claude Code, Codex, and OpenCode,
 plus Claude Desktop for the MCP registration only.
 
+For a fresh cloud container, provision Superbee in the environment setup step before agent tool
+use. Generated hooks bind absolute Node and CLI paths from their installation, so a project hook
+copied from a laptop does not install Superbee or provide a working container launcher. Configure
+hooks inside the environment and verify startup in a fresh session. Startup pulls are best-effort;
+inspect an explicit `superbee sync` receipt to verify publication of edits.
+
 ## Everyday use
 
 You rarely type Superbee commands yourself. You ask your agent, and the Agent Skill translates the

package/SKILL.md

@@ -97,7 +97,7 @@ When the tone fits, a single 🐝 may mark a successful Superbee outcome.
 
 ## Host setup
 
-Persistent integrations require `npm install -g superbee` followed by `superbee setup`.
+Persistent integrations require `npm install -g superbee` followed by `superbee setup`. Fresh cloud containers need the CLI provisioned before agent tool use and container-valid hook paths; copied laptop hooks do not provision them. Startup pulls are best-effort; inspect sync receipts to verify publication.
 Setup is an agent-driven read-only conductor: the calling agent selects its exact host, executes
 the returned argv action, reports what it is doing, requests approval only when the action says
 `approval.required: true`, restarts after Skill, Hook, or MCP changes, and reruns setup to verify.

package/dist/publication-bridge.mjs

@@ -3199,7 +3199,8 @@ function isExternalHref(href) {
   const h = href.trim();
   return /^[a-z][a-z0-9+.-]*:\/\//i.test(h) || h.startsWith("mailto:") || h.startsWith("#");
 }
-function extractMarkdownLinks(body) {
+function extractMarkdownLinks(source, options = {}) {
+  const body = options.skipCode ? maskMarkdownCode(source) : source;
   const out = [];
   let textOpen = -1;
   let afterClose;
@@ -3211,8 +3212,8 @@ function extractMarkdownLinks(body) {
       if (char === ")") {
         if (hrefRest.open === 0 || body[hrefRest.open - 1] !== "!") {
           out.push({
-            text: body.slice(hrefRest.open + 1, hrefRest.close),
-            href: body.slice(hrefRest.hrefStart, cursor)
+            text: source.slice(hrefRest.open + 1, hrefRest.close),
+            href: source.slice(hrefRest.hrefStart, cursor)
           });
         }
         textOpen = -1;
@@ -3243,6 +3244,150 @@ function extractMarkdownLinks(body) {
   }
   return out;
 }
+function leadingIndent(line, from, startColumn) {
+  let columns = 0;
+  let index = from;
+  while (index < line.length) {
+    const char = line[index];
+    if (char === " ") columns += 1;
+    else if (char === "	") columns += 4 - (startColumn + columns) % 4;
+    else break;
+    index++;
+  }
+  return { columns, chars: index - from };
+}
+var FENCE_OPEN = /^(`{3,}|~{3,})(.*)$/;
+var LIST_MARKER = /^([-+*]|\d{1,9}[.)])([ \t]+|$)/;
+var THEMATIC_BREAK = /^(?:(?:\*[ \t]*){3,}|(?:-[ \t]*){3,}|(?:_[ \t]*){3,})$/;
+var ATX_HEADING = /^#{1,6}(?:[ \t]|$)/;
+function maskMarkdownCode(body) {
+  const out = body.split("");
+  const blank = (from, to) => {
+    for (let index = from; index < to; index++) if (out[index] !== "\n" && out[index] !== "\r") out[index] = " ";
+  };
+  const lists = [];
+  let fence = null;
+  let inParagraph = false;
+  let segmentStart = -1;
+  const closeSegment = (end) => {
+    if (segmentStart >= 0) maskCodeSpans(body, segmentStart, end, blank);
+    segmentStart = -1;
+  };
+  let lineStart = 0;
+  while (lineStart <= body.length) {
+    const newline = body.indexOf("\n", lineStart);
+    const lineEnd = newline < 0 ? body.length : newline;
+    const line = body.slice(lineStart, lineEnd);
+    let contentAt = 0;
+    let quotes = 0;
+    for (let match = /^ {0,3}> ?/.exec(line); match; match = /^ {0,3}> ?/.exec(line.slice(contentAt))) {
+      if (fence && quotes >= fence.quotes) break;
+      contentAt += match[0].length;
+      quotes++;
+    }
+    const { columns: indent, chars } = leadingIndent(line, contentAt, contentAt);
+    const rest = line.slice(contentAt + chars).replace(/\r$/, "");
+    const isBlank = rest.trim() === "";
+    if (fence && (quotes < fence.quotes || !isBlank && indent < fence.container)) fence = null;
+    if (fence) {
+      const close = indent - fence.container <= 3 ? FENCE_OPEN.exec(rest) : null;
+      if (close && close[1][0] === fence.char && close[1].length >= fence.length && close[2].trim() === "") fence = null;
+      blank(lineStart, lineEnd);
+    } else if (isBlank) {
+      closeSegment(lineStart);
+      inParagraph = false;
+    } else {
+      if (!inParagraph) while (lists.length > 0 && lists[lists.length - 1] > indent) lists.pop();
+      let container = lists.length > 0 ? lists[lists.length - 1] : 0;
+      let relative = indent - container;
+      let text = rest;
+      let textAt = lineStart + contentAt + chars;
+      const marker = relative <= 3 && !THEMATIC_BREAK.test(text) ? LIST_MARKER.exec(text) : null;
+      if (marker) {
+        closeSegment(lineStart);
+        const markerEnd = indent + marker[1].length;
+        const spacing = leadingIndent(marker[2], 0, contentAt + markerEnd).columns;
+        const wide = marker[2] === "" || spacing >= 5;
+        lists.push(markerEnd + (wide ? 1 : spacing));
+        container = lists[lists.length - 1];
+        text = text.slice(marker[1].length + (wide ? 0 : marker[2].length));
+        textAt += marker[1].length + (wide ? 0 : marker[2].length);
+        relative = wide ? Math.max(spacing - 1, 0) : 0;
+        inParagraph = false;
+      }
+      const open = relative <= 3 ? FENCE_OPEN.exec(text) : null;
+      if (open && !(open[1][0] === "`" && open[2].includes("`"))) {
+        closeSegment(lineStart);
+        fence = { char: open[1][0], length: open[1].length, container, quotes };
+        blank(textAt, lineEnd);
+        inParagraph = false;
+      } else if (!inParagraph && relative >= 4) {
+        closeSegment(lineStart);
+        blank(textAt, lineEnd);
+      } else if (ATX_HEADING.test(text) || THEMATIC_BREAK.test(text)) {
+        closeSegment(lineStart);
+        maskCodeSpans(body, textAt, lineEnd, blank);
+        inParagraph = false;
+      } else {
+        if (segmentStart < 0) segmentStart = textAt;
+        inParagraph = text.trim() !== "";
+      }
+    }
+    if (newline < 0) break;
+    lineStart = newline + 1;
+  }
+  closeSegment(body.length);
+  return out.join("");
+}
+function maskCodeSpans(body, from, to, blank) {
+  const runs = [];
+  for (let index = from; index < to; ) {
+    if (body[index] !== "`") {
+      index++;
+      continue;
+    }
+    let end = index;
+    while (end < to && body[end] === "`") end++;
+    runs.push({ at: index, length: end - index });
+    index = end;
+  }
+  const byLength = /* @__PURE__ */ new Map();
+  runs.forEach((run, position) => {
+    const list2 = byLength.get(run.length);
+    if (list2) list2.push(position);
+    else byLength.set(run.length, [position]);
+  });
+  const next = /* @__PURE__ */ new Map();
+  const nextRun = (length, after) => {
+    const list2 = byLength.get(length);
+    if (!list2) return -1;
+    let cursor = next.get(length) ?? 0;
+    while (cursor < list2.length && list2[cursor] <= after) cursor++;
+    next.set(length, cursor);
+    return cursor < list2.length ? list2[cursor] : -1;
+  };
+  let escapeScan = from;
+  let escaped = false;
+  for (let position = 0; position < runs.length; position++) {
+    let { at, length } = runs[position];
+    for (; escapeScan < at; escapeScan++) escaped = body[escapeScan] === "\\" ? !escaped : false;
+    if (escaped) {
+      at += 1;
+      length -= 1;
+      escaped = false;
+      if (length === 0) continue;
+      const list2 = byLength.get(length);
+      if (!list2) continue;
+    }
+    const closer = nextRun(length, position);
+    if (closer < 0) continue;
+    const close = runs[closer];
+    blank(at, close.at + close.length);
+    position = closer;
+    escapeScan = close.at + close.length;
+    escaped = false;
+  }
+}
 function resolveConceptId(fromId, href) {
   const target = (href.split("#")[0] ?? "").split("?")[0]?.trim() ?? "";
   if (target === "" || isExternalHref(target)) return null;

package/dist/publication.mjs

@@ -31153,7 +31153,8 @@ function isExternalHref(href) {
   const h = href.trim();
   return /^[a-z][a-z0-9+.-]*:\/\//i.test(h) || h.startsWith("mailto:") || h.startsWith("#");
 }
-function extractMarkdownLinks(body) {
+function extractMarkdownLinks(source, options = {}) {
+  const body = options.skipCode ? maskMarkdownCode(source) : source;
   const out = [];
   let textOpen = -1;
   let afterClose;
@@ -31165,8 +31166,8 @@ function extractMarkdownLinks(body) {
       if (char === ")") {
         if (hrefRest.open === 0 || body[hrefRest.open - 1] !== "!") {
           out.push({
-            text: body.slice(hrefRest.open + 1, hrefRest.close),
-            href: body.slice(hrefRest.hrefStart, cursor)
+            text: source.slice(hrefRest.open + 1, hrefRest.close),
+            href: source.slice(hrefRest.hrefStart, cursor)
           });
         }
         textOpen = -1;
@@ -31197,6 +31198,150 @@ function extractMarkdownLinks(body) {
   }
   return out;
 }
+function leadingIndent(line, from, startColumn) {
+  let columns = 0;
+  let index2 = from;
+  while (index2 < line.length) {
+    const char = line[index2];
+    if (char === " ") columns += 1;
+    else if (char === "	") columns += 4 - (startColumn + columns) % 4;
+    else break;
+    index2++;
+  }
+  return { columns, chars: index2 - from };
+}
+var FENCE_OPEN = /^(`{3,}|~{3,})(.*)$/;
+var LIST_MARKER = /^([-+*]|\d{1,9}[.)])([ \t]+|$)/;
+var THEMATIC_BREAK = /^(?:(?:\*[ \t]*){3,}|(?:-[ \t]*){3,}|(?:_[ \t]*){3,})$/;
+var ATX_HEADING = /^#{1,6}(?:[ \t]|$)/;
+function maskMarkdownCode(body) {
+  const out = body.split("");
+  const blank = (from, to) => {
+    for (let index2 = from; index2 < to; index2++) if (out[index2] !== "\n" && out[index2] !== "\r") out[index2] = " ";
+  };
+  const lists = [];
+  let fence = null;
+  let inParagraph = false;
+  let segmentStart = -1;
+  const closeSegment = (end) => {
+    if (segmentStart >= 0) maskCodeSpans(body, segmentStart, end, blank);
+    segmentStart = -1;
+  };
+  let lineStart = 0;
+  while (lineStart <= body.length) {
+    const newline = body.indexOf("\n", lineStart);
+    const lineEnd = newline < 0 ? body.length : newline;
+    const line = body.slice(lineStart, lineEnd);
+    let contentAt = 0;
+    let quotes = 0;
+    for (let match = /^ {0,3}> ?/.exec(line); match; match = /^ {0,3}> ?/.exec(line.slice(contentAt))) {
+      if (fence && quotes >= fence.quotes) break;
+      contentAt += match[0].length;
+      quotes++;
+    }
+    const { columns: indent2, chars } = leadingIndent(line, contentAt, contentAt);
+    const rest = line.slice(contentAt + chars).replace(/\r$/, "");
+    const isBlank = rest.trim() === "";
+    if (fence && (quotes < fence.quotes || !isBlank && indent2 < fence.container)) fence = null;
+    if (fence) {
+      const close = indent2 - fence.container <= 3 ? FENCE_OPEN.exec(rest) : null;
+      if (close && close[1][0] === fence.char && close[1].length >= fence.length && close[2].trim() === "") fence = null;
+      blank(lineStart, lineEnd);
+    } else if (isBlank) {
+      closeSegment(lineStart);
+      inParagraph = false;
+    } else {
+      if (!inParagraph) while (lists.length > 0 && lists[lists.length - 1] > indent2) lists.pop();
+      let container = lists.length > 0 ? lists[lists.length - 1] : 0;
+      let relative = indent2 - container;
+      let text4 = rest;
+      let textAt = lineStart + contentAt + chars;
+      const marker = relative <= 3 && !THEMATIC_BREAK.test(text4) ? LIST_MARKER.exec(text4) : null;
+      if (marker) {
+        closeSegment(lineStart);
+        const markerEnd = indent2 + marker[1].length;
+        const spacing = leadingIndent(marker[2], 0, contentAt + markerEnd).columns;
+        const wide = marker[2] === "" || spacing >= 5;
+        lists.push(markerEnd + (wide ? 1 : spacing));
+        container = lists[lists.length - 1];
+        text4 = text4.slice(marker[1].length + (wide ? 0 : marker[2].length));
+        textAt += marker[1].length + (wide ? 0 : marker[2].length);
+        relative = wide ? Math.max(spacing - 1, 0) : 0;
+        inParagraph = false;
+      }
+      const open = relative <= 3 ? FENCE_OPEN.exec(text4) : null;
+      if (open && !(open[1][0] === "`" && open[2].includes("`"))) {
+        closeSegment(lineStart);
+        fence = { char: open[1][0], length: open[1].length, container, quotes };
+        blank(textAt, lineEnd);
+        inParagraph = false;
+      } else if (!inParagraph && relative >= 4) {
+        closeSegment(lineStart);
+        blank(textAt, lineEnd);
+      } else if (ATX_HEADING.test(text4) || THEMATIC_BREAK.test(text4)) {
+        closeSegment(lineStart);
+        maskCodeSpans(body, textAt, lineEnd, blank);
+        inParagraph = false;
+      } else {
+        if (segmentStart < 0) segmentStart = textAt;
+        inParagraph = text4.trim() !== "";
+      }
+    }
+    if (newline < 0) break;
+    lineStart = newline + 1;
+  }
+  closeSegment(body.length);
+  return out.join("");
+}
+function maskCodeSpans(body, from, to, blank) {
+  const runs = [];
+  for (let index2 = from; index2 < to; ) {
+    if (body[index2] !== "`") {
+      index2++;
+      continue;
+    }
+    let end = index2;
+    while (end < to && body[end] === "`") end++;
+    runs.push({ at: index2, length: end - index2 });
+    index2 = end;
+  }
+  const byLength = /* @__PURE__ */ new Map();
+  runs.forEach((run, position2) => {
+    const list3 = byLength.get(run.length);
+    if (list3) list3.push(position2);
+    else byLength.set(run.length, [position2]);
+  });
+  const next = /* @__PURE__ */ new Map();
+  const nextRun = (length, after) => {
+    const list3 = byLength.get(length);
+    if (!list3) return -1;
+    let cursor = next.get(length) ?? 0;
+    while (cursor < list3.length && list3[cursor] <= after) cursor++;
+    next.set(length, cursor);
+    return cursor < list3.length ? list3[cursor] : -1;
+  };
+  let escapeScan = from;
+  let escaped = false;
+  for (let position2 = 0; position2 < runs.length; position2++) {
+    let { at, length } = runs[position2];
+    for (; escapeScan < at; escapeScan++) escaped = body[escapeScan] === "\\" ? !escaped : false;
+    if (escaped) {
+      at += 1;
+      length -= 1;
+      escaped = false;
+      if (length === 0) continue;
+      const list3 = byLength.get(length);
+      if (!list3) continue;
+    }
+    const closer = nextRun(length, position2);
+    if (closer < 0) continue;
+    const close = runs[closer];
+    blank(at, close.at + close.length);
+    position2 = closer;
+    escapeScan = close.at + close.length;
+    escaped = false;
+  }
+}
 function resolveConceptId(fromId, href) {
   const target = (href.split("#")[0] ?? "").split("?")[0]?.trim() ?? "";
   if (target === "" || isExternalHref(target)) return null;
@@ -42627,6 +42772,10 @@ function gfmFromMarkdown() {
 
 // ../markdown-renderer/src/index.tsx
 var import_jsx_runtime = __toESM(require_jsx_runtime(), 1);
+function renderableConceptId(fromId, raw) {
+  if (/^okf:/i.test(raw.trim())) return null;
+  return resolveConceptId(fromId, raw);
+}
 var MAX_BODY_CHARS = 262144;
 var MAX_NODES = 2e4;
 var MAX_DEPTH = 40;
@@ -42652,7 +42801,7 @@ function isBareLinkBlock(node2, fromId) {
   let sawLink = false;
   for (const child of node2.children) {
     if (isBlankInline(child)) continue;
-    if (child.type === "link" && resolveConceptId(fromId, child.url ?? "") !== null) {
+    if (child.type === "link" && renderableConceptId(fromId, child.url ?? "") !== null) {
       sawLink = true;
       continue;
     }
@@ -42780,7 +42929,7 @@ function renderNode(node2, state, depth, index2) {
       return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("br", {}, index2);
     case "link": {
       const raw = node2.url ?? "";
-      const resolved = resolveConceptId(state.options.fromId, raw);
+      const resolved = renderableConceptId(state.options.fromId, raw);
       const children = renderChildren(node2, state, depth);
       if (resolved === null) {
         const external = admitExternalLink(raw, state.options.externalLinkHosts);
@@ -42849,7 +42998,7 @@ function renderEdgeList(links, state, index2) {
       break;
     }
     state.count++;
-    const to = resolveConceptId(fromId, links[i].url ?? "");
+    const to = renderableConceptId(fromId, links[i].url ?? "");
     if (to === null) continue;
     const verb = textOf(links[i]).trim();
     const target = titleFor?.(to) ?? to;