@c4a/context-cli 0.7.61 → 0.7.63

package/cli.js

@@ -32174,6 +32174,7 @@ var init_packageSite = __esm(() => {
   packageSiteNavLinkSchema = exports_external.object({
     text: exports_external.string().trim().min(1),
     link: siteHrefSchema,
+    position: exports_external.enum(["start", "end"]).optional(),
     locales: localizedTextSchema.optional()
   }).strict();
   packageSiteMoreItemSchema = exports_external.object({
@@ -86607,6 +86608,9 @@ var init_packageBuildReceipt = __esm(() => {
 // src/project/knowledgeMapCoverage.ts
 import { readFile as readFile55 } from "node:fs/promises";
 import { join as join66 } from "node:path";
+function packageMenuTargets(packages) {
+  return new Set(packages.flatMap((pkg) => pkg.kind === "package.kb" ? (pkg.site?.more ?? []).flatMap((item) => item.target ? [item.target.artifact_ref] : []) : []));
+}
 function knowledgeMapArticleTargets(files) {
   return files.flatMap((file) => {
     const meta = parseKnowledgeFrontmatter(file.content);
@@ -86677,6 +86681,7 @@ var init_knowledgeMapCoverage = __esm(() => {
 var exports_knowledgeMap = {};
 __export(exports_knowledgeMap, {
   readKnowledgeMap: () => readKnowledgeMap,
+  projectMenuTargets: () => projectMenuTargets,
   inspectKnowledgeMap: () => inspectKnowledgeMap,
   applyKnowledgeMapUpdate: () => applyKnowledgeMapUpdate,
   acceptStructureDecision: () => acceptStructureDecision,
@@ -86697,6 +86702,12 @@ async function readKnowledgeMap(root) {
   const content3 = await optionalText(root, KNOWLEDGE_MAP_PATH);
   return content3 === undefined ? undefined : validateKnowledgeMap(import_yaml39.parse(content3));
 }
+async function projectMenuTargets(root) {
+  const { isContextProjectRoot: isContextProjectRoot2, loadContextProjectModule: loadContextProjectModule2 } = await Promise.resolve().then(() => (init_workspace(), exports_workspace));
+  if (!isContextProjectRoot2(root))
+    return new Set;
+  return packageMenuTargets((await loadContextProjectModule2(root)).project.packages);
+}
 async function inspectKnowledgeMap(root) {
   const current2 = await readKnowledgeMap(root);
   return {
@@ -86728,7 +86739,8 @@ async function acceptStructureDecision(input) {
     const next = input.knowledge_map === undefined ? current2 : updateKnowledgeMap(current2, input.knowledge_map);
     if (input.article_targets !== undefined) {
       const known = [...await approvedKnowledgeMapTargets(input.projectRoot), ...input.article_targets];
-      assertKnowledgeMapCoverage(next, known, { known, require_update: true, has_update: input.knowledge_map !== undefined, revision: input.revision, current_revision: current2?.revision ?? null });
+      const menu = await projectMenuTargets(input.projectRoot);
+      assertKnowledgeMapCoverage(next, known.filter((target) => !menu.has(target.artifact_ref)), { known, require_update: true, has_update: input.knowledge_map !== undefined, revision: input.revision, current_revision: current2?.revision ?? null });
     }
     const writes = [{ path: input.decisionPath, content: canonicalIndexerJson({ revision: input.revision, decision: "approved" }) }];
     if (input.knowledge_map !== undefined)
@@ -86762,7 +86774,8 @@ async function applyKnowledgeMapUpdate(projectRoot, update) {
       title: candidate.review.title,
       section_keys: candidate.indexer_candidate.sections.map((section) => section.section_key)
     }));
-    assertKnowledgeMapCoverage(next, approved, { known: [...approved, ...planned, ...accepted], current_revision: current2?.revision ?? null });
+    const menu = await projectMenuTargets(projectRoot);
+    assertKnowledgeMapCoverage(next, approved.filter((target) => !menu.has(target.artifact_ref)), { known: [...approved, ...planned, ...accepted], current_revision: current2?.revision ?? null });
     const content3 = import_yaml39.stringify(next);
     const previous2 = await optionalText(projectRoot, KNOWLEDGE_MAP_PATH);
     await runDurableMultiFileTransaction({
@@ -86820,7 +86833,8 @@ function packageKnowledgeMapTargets(pkg, files) {
   return targets;
 }
 async function writePackageKnowledgeMap(input) {
-  assertKnowledgeMapCoverage(input.structure, knowledgeMapArticleTargets(input.selected));
+  const menu = packageMenuTargets([input.pkg]);
+  assertKnowledgeMapCoverage(input.structure, knowledgeMapArticleTargets(input.selected).filter((target) => !menu.has(target.artifact_ref)));
   if (input.structure === undefined || input.pkg.kind !== "package.kb")
     return [];
   const projected = projectKnowledgeMap(input.structure, packageKnowledgeMapTargets(input.pkg, input.selected));
@@ -87588,6 +87602,17 @@ var init_packageSiteTheme = __esm(() => {
       return true;
     }, { alt: ['paragraph'] });
     md.renderer.rules.context_anchor = (tokens, index) => '<a id="' + md.utils.escapeHtml(tokens[index].content) + '"></a>\n';
+    // Only the compiler writes section landing pages; accept exactly its card wrappers there.
+    const sectionWrappers = new Set(['<div class="context-section-grid">', '<div class="context-section-card">', '</div>']);
+    md.block.ruler.before('paragraph', 'context_section_card', (state, line, end, silent) => {
+      if (!/(?:^|\/)sections\/[0-9a-f]+\.md$/.test(state.env.relativePath || '')) return false;
+      const raw = state.src.slice(state.bMarks[line] + state.tShift[line], state.eMarks[line]);
+      if (!sectionWrappers.has(raw)) return false;
+      if (!silent) { const token = state.push('context_section_card', '', 0); token.content = raw; }
+      state.line = line + 1;
+      return true;
+    }, { alt: ['paragraph'] });
+    md.renderer.rules.context_section_card = (tokens, index) => tokens[index].content + '\n';
     // The generated website config declares contextLocaleMarker; null when the site has no translations.
     const contextLocale = typeof contextLocaleMarker === 'string' ? contextLocaleMarker : null;
     md.block.ruler.before('paragraph', 'context_locale', (state, line, end, silent) => {
@@ -87814,10 +87839,13 @@ export default {
         return part('year') + '-' + part('month') + '-' + part('day') + ' ' +
           part('hour') + ':' + part('minute') + ':' + part('second') + ' ' + part('timeZoneName');
       });
+      const sitePath = () => {
+        const base = data.site.value.base;
+        return route.path.startsWith(base) ? '/' + route.path.slice(base.length) : route.path;
+      };
       watch(() => route.path, () => {
         allSources.value = false;
-        const base = data.site.value.base;
-        const path = route.path.startsWith(base) ? '/' + route.path.slice(base.length) : route.path;
+        const path = sitePath();
         const direct = sections.value.find(section => section.href === path);
         const current = sections.value.find(section => section.key === selected.value);
         selected.value = (direct || (current?.pages.includes(path) ? current :
@@ -87827,6 +87855,12 @@ export default {
       const inLlms = computed(() => route.path.startsWith(data.site.value.base + 'llms/'));
       const inHistory = computed(() => route.path === data.site.value.base + 'changelog.html');
       const inHome = computed(() => data.frontmatter.value.layout === 'home');
+      // Articles outside the knowledge map, such as More menu targets, belong to no section.
+      const inMore = computed(() => (data.theme.value.contextMore || []).some(item => !item.origin && item.link === sitePath()));
+      const outsideSections = computed(() => inLlms.value || inHistory.value || inMore.value || (!inHome.value &&
+        !sections.value.some(section => section.href === sitePath() || section.pages.includes(sitePath()))));
+      const userNav = position => (data.theme.value.contextNav || [])
+        .filter(item => (item.position === 'start') === (position === 'start')).map(navLink);
       // Descendants, including site extensions, read the reader language as lang.
       // The frontmatter carries it too so the content refreshes its outline on a switch.
       provide(dataSymbol, { ...data, lang: computed(() => locale.value), frontmatter: computed(() => {
@@ -87835,15 +87869,15 @@ export default {
         return { ...value, contextLocale: locale.value, ...(actions ? { hero: { ...value.hero, actions } } : {}) };
       }), theme: computed(() => ({ ...data.theme.value,
         ...data.theme.value.contextUiLabels?.[chinese.value ? 'zh' : 'en'],
-        sidebar: inLlms.value || inHistory.value ? [] : active.value?.items || [],
-        nav: [...sections.value.map(section => ({ text: section.label, link: section.href,
-          activeMatch: !inLlms.value && !inHistory.value && section.key === selected.value ? '^' : '(?!)' })),
-          ...(data.theme.value.contextNav || []).map(navLink),
+        sidebar: outsideSections.value ? [] : active.value?.items || [],
+        nav: [...userNav('start'), ...sections.value.map(section => ({ text: section.label, link: section.href,
+          activeMatch: !outsideSections.value && section.key === selected.value ? '^' : '(?!)' })),
+          ...userNav('end'),
           { text: bothHtml('更多', 'More'), items: [
             ...(data.theme.value.contextMore || []).map(navLink),
             { text: 'LLM Docs', link: '/llms/index.html' },
             { text: 'Changelog', link: '/changelog.html' }],
-            activeMatch: inLlms.value || inHistory.value ? '^' : '(?!)' }],
+            activeMatch: inLlms.value || inHistory.value || inMore.value ? '^' : '(?!)' }],
       })) });
       const slots = {
         'nav-bar-title-before': () => extensions.brand ? h('span', { class: 'context-brand' }, custom('brand')) : null,
@@ -87911,7 +87945,7 @@ export default {
       };
       // History belongs between the page heading and footer metadata.
       return () => h(DefaultTheme.Layout, { class: inHome.value ? 'context-home' : data.page.value.isNotFound ? 'context-missing' :
-        inLlms.value || inHistory.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
+        outsideSections.value ? 'context-empty-sidebar' : undefined }, { ...slots, 'doc-after': undefined,
         'doc-footer-before': () => [slots['doc-after'](), slots['doc-footer-before']()] });
     }
   },
@@ -88190,6 +88224,19 @@ ${readerContentStyles(".vp-doc")}
 .context-sources li + li { margin-top: 6px; }
 .context-sources a { color: inherit; text-decoration: none; border-bottom: 1px solid transparent; }
 .context-sources a:hover { color: var(--vp-c-brand-1); border-color: currentColor; }
+/* Section landing pages: two cards per row, one on narrow screens. */
+.context-section-grid { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 14px; margin-top: 24px; }
+.vp-doc .context-section-card { min-width: 0; padding: 18px 20px; border: 1px solid var(--vp-c-divider); border-radius: 12px;
+  background: color-mix(in srgb, var(--vp-c-bg) 88%, var(--vp-c-bg-soft)); }
+.vp-doc .context-section-card:hover { border-color: color-mix(in srgb, var(--vp-c-brand-1) 42%, var(--vp-c-divider)); }
+.vp-doc .context-section-card h2 { margin: 0 0 10px; padding: 0 0 10px; border-top: 0; border-bottom: 1px solid var(--vp-c-divider); font-size: 17px; line-height: 1.45; letter-spacing: 0; }
+.vp-doc .context-section-card h2 a { color: var(--vp-c-text-1); text-decoration: none; }
+.vp-doc .context-section-card > ul { margin: 0; padding: 0; list-style: none; }
+.vp-doc .context-section-card li { margin: 6px 0; font-size: 14px; line-height: 1.55; }
+.vp-doc .context-section-card li a { color: var(--vp-c-text-2); text-decoration: none; }
+.vp-doc .context-section-card li a:hover { color: var(--vp-c-brand-1); }
+.vp-doc .context-section-card ul ul { margin: 4px 0 8px; padding-left: 14px; border-left: 1px solid var(--vp-c-divider); list-style: none; }
+@media (max-width: 719px) { .context-section-grid { grid-template-columns: 1fr; } }
 ${DIAGRAM_STYLES}
 `;
 });
@@ -89634,6 +89681,7 @@ function siteNavigationConfig(site, pages) {
     text: item.text,
     link: item.link,
     ...item.link.startsWith("/") ? { origin: true } : {},
+    ...item.position === "start" ? { position: "start" } : {},
     ...item.locales ? { locales: item.locales } : {}
   }));
   return { nav, more };
@@ -90104,11 +90152,28 @@ ${localized.body}`);
       lines.push(`${"  ".repeat(level)}- ${entry.href ? `[${title}](${entry.href})` : title}`);
       menu(lines, entry.children, level + 1, tag);
     });
+    const card = (lines, heading, entries2, tag) => {
+      lines.push('<div class="context-section-card">', "");
+      if (heading !== undefined)
+        lines.push(`## ${heading}`, "");
+      menu(lines, entries2, 0, tag);
+      lines.push("", "</div>", "");
+    };
     await mkdir28(join75(temporary, "sections"), { recursive: true });
     for (const section of sections) {
       await writeFile23(join75(temporary, section.href.slice(1).replace(/\.html$/u, ".md")), localizer.variants((tag) => {
-        const lines = [`# ${mdLabel(localizer.entryTitle(tag, section.entry))}`, ""];
-        menu(lines, section.entries, 0, tag);
+        const lines = [`# ${mdLabel(localizer.entryTitle(tag, section.entry))}`, "", '<div class="context-section-grid">', ""];
+        const groups = section.entries.filter((entry) => entry.children.length > 0);
+        const articles = section.entries.filter((entry) => entry.children.length === 0);
+        for (const group of groups) {
+          card(lines, group.href ? `[${mdLabel(localizer.entryTitle(tag, group))}](${group.href})` : mdLabel(localizer.entryTitle(tag, group)), group.children, tag);
+        }
+        if (groups.length === 0)
+          for (const article of articles)
+            card(lines, undefined, [article], tag);
+        else if (articles.length)
+          card(lines, undefined, articles, tag);
+        lines.push("</div>");
         return lines.join(`
 `) + `
 `;
@@ -108952,7 +109017,8 @@ async function writeReviewHtml(input) {
   }
   await writeFile28(outPath, renderReviewHtml(model, diagramScript), "utf8");
   await saveReviewReportScope(input.projectRoot, reviewScope, candidates, model.baselineHash);
-  const unplaced = model.pages.filter((page) => page.candidate_id && !model.nodes.some((node3) => node3.page === page.id && node3.parent !== "review-unplaced" && !node3.removed)).map((page) => ({ article_id: page.id, candidate_id: page.candidate_id, path: page.path, title: page.title }));
+  const menu = await projectMenuTargets(input.projectRoot);
+  const unplaced = model.pages.filter((page) => page.candidate_id && !menu.has(page.id) && !model.nodes.some((node3) => node3.page === page.id && node3.parent !== "review-unplaced" && !node3.removed)).map((page) => ({ article_id: page.id, candidate_id: page.candidate_id, path: page.path, title: page.title }));
   return {
     navigation: {
       current_revision: (await readKnowledgeMap(input.projectRoot))?.revision ?? null,