@c4a/context-cli 0.5.38-beta.1 → 0.5.38-beta.2

package/cli.js

@@ -33106,18 +33106,76 @@ function renderSummaryText(value) {
 function escapeRawComment(value) {
   return value.replace(/-->/gu, "--\\>");
 }
-function renderRawBlock(section) {
+function renderRawBlock(section, renderedContent) {
   const raw = section.raw?.trim();
-  if (raw === undefined || raw.length === 0 || raw === section.content.trim())
+  if (raw === undefined || raw.length === 0 || raw === renderedContent.trim())
     return [];
   return ["", "<!-- c4a:raw", escapeRawComment(raw), "/c4a:raw -->"];
 }
-function renderSectionBody(section) {
+function plainHeadingText(value) {
+  return value.replace(/\[([^\]]+)\]\([^)]+\)/gu, "$1").replace(/`([^`]+)`/gu, "$1").replace(/\*\*([^*]+)\*\*/gu, "$1").replace(/\*([^*]+)\*/gu, "$1").replace(/_([^_]+)_/gu, "$1").replace(/<[^>]+>/gu, "").replace(/[ \t]+/gu, " ").trim().toLowerCase();
+}
+function collectHeadingLines(lines) {
+  const headings = [];
+  let fence;
+  for (const [index2, line] of lines.entries()) {
+    const fenceMatch = line.match(/^\s*(```|~~~)/u);
+    if (fenceMatch) {
+      const marker = fenceMatch[1];
+      fence = fence === undefined ? marker : fence === marker ? undefined : fence;
+      continue;
+    }
+    if (fence !== undefined)
+      continue;
+    const heading2 = line.match(/^(#{1,6})[ \t]+(.+?)(?:[ \t]+#+[ \t]*)?$/u);
+    if (!heading2)
+      continue;
+    headings.push({
+      index: index2,
+      level: heading2[1]?.length ?? 1,
+      text: heading2[2]?.trim() ?? ""
+    });
+  }
+  return headings;
+}
+function normalizeSectionContentHeadings(input) {
+  const trimmed = input.content.trim();
+  if (trimmed.length === 0)
+    return trimmed;
+  const lines = trimmed.split(/\r?\n/u);
+  const headings = collectHeadingLines(lines);
+  const removableTitleSet = new Set(input.removableTitles.map(plainHeadingText).filter((title) => title.length > 0));
+  const firstHeading = headings[0];
+  if (firstHeading !== undefined && removableTitleSet.has(plainHeadingText(firstHeading.text)) && lines.slice(0, firstHeading.index).every((line) => line.trim().length === 0)) {
+    lines.splice(firstHeading.index, 1);
+  }
+  const remainingHeadings = collectHeadingLines(lines);
+  const minDepth = remainingHeadings.reduce((current, heading2) => current === undefined ? heading2.level : Math.min(current, heading2.level), undefined);
+  const offset = minDepth === undefined ? 0 : Math.max(0, input.minHeadingLevel - minDepth);
+  if (offset === 0)
+    return lines.join(`
+`).trim();
+  const headingByLine = new Map(remainingHeadings.map((heading2) => [heading2.index, heading2]));
+  return lines.map((line, index2) => {
+    const heading2 = headingByLine.get(index2);
+    if (heading2 === undefined)
+      return line;
+    const level = Math.min(6, heading2.level + offset);
+    return `${"#".repeat(level)} ${heading2.text}`;
+  }).join(`
+`).trim();
+}
+function renderSectionBody(section, minHeadingLevel, groupTitle) {
+  const content3 = normalizeSectionContentHeadings({
+    content: section.content,
+    minHeadingLevel,
+    removableTitles: [section.summary ?? "", groupTitle]
+  });
   return [
     renderSectionComment(section),
     ...section.summary !== undefined ? ["<!-- c4a:summary -->", renderSummaryText(section.summary), "<!-- /c4a:summary -->", ""] : [],
-    section.content.trim(),
-    ...renderRawBlock(section),
+    content3,
+    ...renderRawBlock(section, content3),
     "<!-- /c4a:section -->"
   ].join(`
 `);
@@ -33140,7 +33198,7 @@ function renderSectionGroups(sections, headingLevel) {
     const groupSections2 = grouped.get(title) ?? [];
     if (groupSections2.length === 0)
       continue;
-    const renderedSections = groupSections2.map(renderSectionBody);
+    const renderedSections = groupSections2.map((section) => renderSectionBody(section, headingLevel + 1, title));
     parts.push([`${hashes} ${title}`, "", renderedSections.join(`
 
 `)].join(`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.5.38-beta.1",
+  "version": "0.5.38-beta.2",
   "type": "module",
   "bin": {
     "context": "./cli.js"

package/templates/aspect-runtime/aspectRunnerSdk.js

@@ -441,6 +441,12 @@ function cloneNode(node, children) {
     cloned.children = children;
   return cloned;
 }
+function cloneMarkdownNode(node) {
+  return {
+    ...node,
+    ...node.children !== undefined ? { children: node.children.map(cloneMarkdownNode) } : {}
+  };
+}
 function mdxAttrValueText(value) {
   if (value === null || value === undefined)
     return;
@@ -622,6 +628,14 @@ function plainText(node) {
     return node.value;
   return (node.children ?? []).map(plainText).join("");
 }
+function normalizedHeadingLabel(value) {
+  return compactWhitespace(value).toLowerCase();
+}
+function headingMatchesTitle(node, title) {
+  if (title === undefined || node.type !== "heading")
+    return false;
+  return normalizedHeadingLabel(plainText(node)) === normalizedHeadingLabel(title);
+}
 function firstHeadingText(nodes) {
   for (const node of nodes) {
     if (node.type === "heading") {
@@ -651,6 +665,56 @@ function stripYamlFrontmatter(raw) {
   }
   return raw;
 }
+function clampHeadingLevel(value) {
+  return Math.min(6, Math.max(1, Math.trunc(value)));
+}
+function minHeadingDepth(nodes) {
+  let out;
+  function visit(node) {
+    if (node.type === "heading" && typeof node.depth === "number") {
+      out = out === undefined ? node.depth : Math.min(out, node.depth);
+    }
+    for (const child of node.children ?? [])
+      visit(child);
+  }
+  for (const node of nodes)
+    visit(node);
+  return out;
+}
+function shiftHeadingDepths(nodes, offset) {
+  return nodes.map((node) => {
+    const next = cloneMarkdownNode(node);
+    if (next.type === "heading" && typeof next.depth === "number") {
+      next.depth = clampHeadingLevel(next.depth + offset);
+    }
+    if (next.children !== undefined) {
+      next.children = shiftHeadingDepths(next.children, offset);
+    }
+    return next;
+  });
+}
+function sectionBodyMarkdownFromTree(tree, options) {
+  const minHeadingLevel = clampHeadingLevel(options.minHeadingLevel ?? 3);
+  const removeTitleHeading = options.removeTitleHeading ?? true;
+  const children = (tree.children ?? []).map(cloneMarkdownNode);
+  const withoutTitle = removeTitleHeading && children[0] !== undefined && headingMatchesTitle(children[0], options.title) ? children.slice(1) : children;
+  const minDepth = minHeadingDepth(withoutTitle);
+  const headingOffset = minDepth === undefined ? 0 : Math.max(0, minHeadingLevel - minDepth);
+  return normalizeMarkdown(mdxProcessor.stringify({
+    ...tree,
+    children: shiftHeadingDepths(withoutTitle, headingOffset)
+  }));
+}
+function normalizeSectionMarkdown(markdown, options = {}) {
+  const source = stripYamlFrontmatter(markdown);
+  const tree = mdxProcessor.parse(source);
+  const normalized = mdxProcessor.runSync(tree);
+  const title = options.title ?? firstHeadingText(normalized.children ?? []);
+  return sectionBodyMarkdownFromTree(normalized, {
+    ...options,
+    ...title !== undefined ? { title } : {}
+  });
+}
 function parseMdxDocument(raw, fallbackTitle) {
   const source = stripYamlFrontmatter(raw);
   const tree = mdxProcessor.parse(source);
@@ -658,7 +722,8 @@ function parseMdxDocument(raw, fallbackTitle) {
   const markdown = normalizeMarkdown(mdxProcessor.stringify(normalized));
   const blocks = markdownBlocks(markdown);
   const title = firstHeadingText(normalized.children ?? []) ?? fallbackTitle;
-  return { title, markdown, blocks };
+  const bodyMarkdown = sectionBodyMarkdownFromTree(normalized, { title });
+  return { title, markdown, bodyMarkdown, blocks };
 }
 
 // src/aspect-runtime/index.ts
@@ -697,6 +762,7 @@ export {
   parseMdxDocument,
   parseJsLikeTokenNames,
   normalizeSymbolSlug,
+  normalizeSectionMarkdown,
   normalizeComponentSlug,
   markdownFence,
   inferComponentName,

package/templates/aspects/README.md

@@ -199,7 +199,7 @@ export default defineAspect({
         node_slug: "target-node",
         kind: "description",
         summary: doc.title,
-        content: doc.markdown,
+        content: doc.bodyMarkdown,
         source: file,
         artifact: artifactFromRelPath(file.path),
       });
@@ -208,6 +208,8 @@ export default defineAspect({
 });
 ```
 
+Use `doc.bodyMarkdown` for Section content. It removes a leading document title when it matches `doc.title`, then shifts remaining headings under the rendered Section container. The renderer applies the final heading offset again from the actual node depth, so nested child-node Sections stay structurally valid. `doc.markdown` remains available when a plugin needs the full normalized document.
+
 ---
 
 ## Section Projection Protocol (`section-projection.v2`)