@c4a/context-cli 0.7.60 → 0.7.62

package/cli.js

@@ -86607,6 +86607,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 +86680,7 @@ var init_knowledgeMapCoverage = __esm(() => {
 var exports_knowledgeMap = {};
 __export(exports_knowledgeMap, {
   readKnowledgeMap: () => readKnowledgeMap,
+  projectMenuTargets: () => projectMenuTargets,
   inspectKnowledgeMap: () => inspectKnowledgeMap,
   applyKnowledgeMapUpdate: () => applyKnowledgeMapUpdate,
   acceptStructureDecision: () => acceptStructureDecision,
@@ -86697,6 +86701,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 +86738,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 +86773,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 +86832,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));
@@ -87128,14 +87141,57 @@ function createDiagramViewer(load) {
         actorBkg: color3("surface", dark ? "#202735" : "#f5f8ff"),
         actorTextColor: color3("text", dark ? "#e2e4ed" : "#161e2e"),
         signalColor: color3("muted-text", dark ? "#9faec5" : "#66758d"),
-        signalTextColor: color3("text", dark ? "#e2e4ed" : "#161e2e")
+        signalTextColor: color3("text", dark ? "#e2e4ed" : "#161e2e"),
+        titleColor: color3("muted-text", dark ? "#9faec5" : "#66758d")
       },
-      flowchart: { useMaxWidth: false, nodeSpacing: 36, rankSpacing: 58, padding: 16, curve: "linear", wrappingWidth: 220, htmlLabels: false },
+      themeCSS: ".edgeLabel rect{opacity:1}.edgeLabel text{font-size:13px}",
+      flowchart: { useMaxWidth: false, nodeSpacing: 36, rankSpacing: 58, padding: 16, curve: "linear", wrappingWidth: 220, htmlLabels: false, subGraphTitleMargin: { top: 10, bottom: 6 } },
       sequence: { useMaxWidth: false, diagramMarginX: 24, diagramMarginY: 20, actorMargin: 48, messageMargin: 38, wrap: true },
       state: { useMaxWidth: false },
       er: { useMaxWidth: false }
     };
   }
+  function centerEdgeLabels(svg) {
+    if (svg.dataset.labelsCentered || !svg.getClientRects().length)
+      return;
+    svg.dataset.labelsCentered = "true";
+    for (const label2 of svg.querySelectorAll(".edgeLabel > .label[data-id]")) {
+      const box = label2.querySelector("rect.background");
+      const text7 = label2.querySelector("text");
+      const path2 = svg.querySelector(`path[data-id="${CSS.escape(label2.getAttribute("data-id"))}"]`);
+      const toLabel = label2.getCTM();
+      const toPath = path2?.getCTM();
+      const glyphs = text7?.getBBox();
+      if (!box || !path2 || !toLabel || !toPath || !glyphs?.width)
+        continue;
+      box.setAttribute("x", String(glyphs.x - 4));
+      box.setAttribute("y", String(glyphs.y - 1));
+      box.setAttribute("width", String(glyphs.width + 8));
+      box.setAttribute("height", String(glyphs.height + 2));
+      const center = new DOMPoint(box.x.baseVal.value + box.width.baseVal.value / 2, box.y.baseVal.value + box.height.baseVal.value / 2);
+      const local = center.matrixTransform(toLabel).matrixTransform(toPath.inverse());
+      const length = path2.getTotalLength();
+      let best = 0;
+      let distance = Infinity;
+      const probe = (at2) => {
+        const point3 = path2.getPointAtLength(at2);
+        const d = (point3.x - local.x) ** 2 + (point3.y - local.y) ** 2;
+        if (d < distance) {
+          distance = d;
+          best = at2;
+        }
+      };
+      for (let step = 0;step <= 64; step++)
+        probe(length * step / 64);
+      for (let span = length / 64;span > 0.25; span /= 2) {
+        const at2 = best;
+        probe(Math.max(0, at2 - span));
+        probe(Math.min(length, at2 + span));
+      }
+      const target = path2.getPointAtLength(best).matrixTransform(toPath).matrixTransform(toLabel.inverse());
+      label2.setAttribute("transform", `${label2.getAttribute("transform") ?? ""} translate(${target.x - center.x} ${target.y - center.y})`);
+    }
+  }
   function prune() {
     for (const [node3, state] of states)
       if (!node3.isConnected) {
@@ -87214,6 +87270,7 @@ function createDiagramViewer(load) {
       const svg = canvas.querySelector("svg");
       if (!svg || !state.width)
         return;
+      centerEdgeLabels(svg);
       if (state.fit)
         state.scale = Math.min(1, Math.max(0.1, (viewport.clientWidth - 32) / state.width));
       svg.style.width = `${state.width * state.scale}px`;
@@ -87373,6 +87430,7 @@ function createDiagramViewer(load) {
           const element = canvas.querySelector("svg");
           if (!element)
             throw new Error("Missing SVG");
+          centerEdgeLabels(element);
           state.width = element.viewBox.baseVal.width || element.getBoundingClientRect().width || 640;
           element.setAttribute("role", "img");
           if (!element.hasAttribute("aria-label") && !element.hasAttribute("aria-labelledby"))
@@ -87437,10 +87495,10 @@ var init_diagramStyles = __esm(() => {
 .context-diagram-percent{font-size:11px;color:var(--diagram-muted);min-width:34px;text-align:center}
 .context-diagram-viewport{overflow:auto;max-height:620px;min-height:60px;overscroll-behavior:contain;cursor:grab}
 .context-diagram-viewport:active{cursor:grabbing}.context-diagram-canvas{padding:16px;width:max-content;min-width:100%;box-sizing:border-box}
-.context-diagram-canvas svg{display:block;margin:auto;height:auto;max-width:none}.context-diagram-status{padding:12px 16px;font-size:13px;color:var(--diagram-muted)}
+.context-diagram-canvas svg{display:block;margin:auto;height:auto;max-width:none}.context-diagram-canvas foreignObject p{margin:0;line-height:inherit}.context-diagram-status{padding:12px 16px;font-size:13px;color:var(--diagram-muted)}
 .context-diagram-expanded{position:fixed!important;inset:16px!important;z-index:10000!important;margin:0!important;display:flex;flex-direction:column;box-shadow:0 0 0 100vmax #10182788}
 .context-diagram-expanded .context-diagram-viewport{flex:1;max-height:none}.context-diagram-expanded .context-diagram-tools{flex-shrink:0}
-.vp-doc div.language-mermaid.context-rendered{background:transparent;border:0}
+.vp-doc div.language-mermaid.context-rendered,div.language-mermaid.context-rendered{background:transparent;border:0;border-radius:0;padding:0;box-shadow:none}
 .context-rendered>pre,.context-rendered>.copy,.context-rendered>.lang{display:none!important}.context-diagram-shell [hidden]{display:none!important}
 .context-diagram-left,.context-diagram-right{display:flex;align-items:center;flex-wrap:wrap;gap:6px}.context-diagram-right{margin-left:auto}
 .context-diagram-tools{opacity:0;pointer-events:none;transition:opacity .15s}.context-diagram-shell:hover .context-diagram-tools,.context-diagram-shell:focus-within .context-diagram-tools{opacity:1;pointer-events:auto}
@@ -87809,6 +87867,12 @@ export default {
           extensions.knowledge === undefined ? siteMap() : extensions.knowledge && custom('knowledge'),
           extensions.resources === undefined ? resources() : extensions.resources && custom('resources')],
         'home-features-after': () => extensions.footer === undefined ? poweredBy() : extensions.footer && custom('footer'),
+        'not-found': () => h('div', { class: 'context-not-found' }, [
+          h('p', { class: 'context-not-found-code' }, '404'),
+          h('h1', both('页面不存在', 'Page not found')),
+          h('p', both('链接可能已失效，或页面已被移动。', 'The link may be broken, or the page has moved.')),
+          h('a', { class: 'context-not-found-home', href: data.site.value.base }, both('返回首页', 'Back to home')),
+        ]),
         'doc-after': () => history.value ? h('section', { class: 'context-history-cards' },
           history.value.length ? history.value.map((entry, index) =>
             h('details', { class: 'context-history-card', open: index < 3, key: entry.version }, [
@@ -87859,7 +87923,7 @@ export default {
         },
       };
       // History belongs between the page heading and footer metadata.
-      return () => h(DefaultTheme.Layout, { class: inHome.value ? 'context-home' :
+      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,
         'doc-footer-before': () => [slots['doc-after'](), slots['doc-footer-before']()] });
     }
@@ -88066,13 +88130,20 @@ ${readerContentStyles(".vp-doc")}
 .context-home-powered { width: var(--context-content); margin: 24px auto 0; padding: 22px 0 30px; border-top: 1px solid var(--vp-c-divider);
   color: var(--vp-c-text-2); font-size: 11px; text-align: right; }
 .context-home-powered a { color: inherit; }
+/* 404: centred in the space below the top bar, in the reader language */
+.context-not-found { display: flex; flex-direction: column; align-items: center; justify-content: center; min-height: calc(100vh - var(--vp-nav-height)); padding: 48px 24px 96px; text-align: center; }
+.context-not-found-code { margin: 0; font: 600 72px/1 var(--vp-font-family-mono); letter-spacing: -.04em; color: var(--vp-c-text-1); }
+.context-not-found h1 { margin: 20px 0 0; font-size: 20px; font-weight: 600; line-height: 1.4; color: var(--vp-c-text-1); }
+.context-not-found h1 + p { max-width: 28rem; margin: 8px 0 0; font-size: 14px; line-height: 1.7; color: var(--vp-c-text-2); }
+.context-not-found-home { margin-top: 28px; padding: 0 18px; border: 1px solid var(--vp-c-divider); border-radius: 999px; font-size: 14px; font-weight: 500; line-height: 38px; color: var(--vp-c-text-1) !important; text-decoration: none !important; transition: border-color .2s; }
+.context-not-found-home:hover { border-color: var(--vp-c-text-3); }
 @keyframes context-home-rise { from { opacity: 0; transform: translateY(10px); } to { opacity: 1; transform: translateY(0); } }
 @media (min-width: 960px) {
   /* The sidebar background reaches the screen edge; its first-level labels line up with the top-bar title. */
   .VPSidebar { top: var(--vp-nav-height) !important; left: 0 !important; width: calc(var(--vp-sidebar-width) + var(--context-edge) - 26px) !important;
     padding: 12px 0 48px calc(var(--context-edge) - 26px) !important; }
   .VPSidebar .curtain { display: none; }
-  .VPContent.has-sidebar, .Layout:not(.context-home) .VPContent:not(.is-home) { padding-left: calc(var(--vp-sidebar-width) + var(--context-edge) - 26px) !important;
+  .VPContent.has-sidebar, .Layout:not(.context-home):not(.context-missing) .VPContent:not(.is-home) { padding-left: calc(var(--vp-sidebar-width) + var(--context-edge) - 26px) !important;
     padding-right: calc(var(--context-edge) - var(--context-gutter)) !important; }
   .context-home .VPContent { padding-left: 0 !important; padding-right: 0 !important; }
   .VPDoc { padding: 44px 36px 80px !important; }
@@ -89867,6 +89938,22 @@ ${tail}`));
     });
   });
 }
+function siteHomeHero(options, input) {
+  const chinese = input.tag.toLowerCase().startsWith("zh");
+  const locale = input.tag === input.primary ? undefined : options.locales?.[input.tag];
+  const own5 = locale?.home;
+  const featured = (own5?.resources ?? options.home?.resources ?? []).filter((resource) => resource.featured && resource.href);
+  return {
+    name: own5?.title ?? locale?.title ?? options.home?.title ?? options.title ?? input.packageName,
+    text: own5?.slogan ?? options.home?.slogan ?? (chinese ? "从知识地图开始探索" : "Explore from the knowledge map"),
+    tagline: own5?.description ?? locale?.description ?? options.home?.description ?? options.description ?? "",
+    actions: own5?.actions ?? options.home?.actions ?? [
+      { theme: "brand", text: chinese ? "浏览知识" : "Browse knowledge", link: input.firstSection },
+      ...featured.map((resource) => ({ theme: "alt", text: resource.title, link: resource.href })),
+      { theme: "alt", text: "LLM Docs", link: "/llms/index.html" }
+    ]
+  };
+}
 async function writePackageSite(input) {
   if (input.pkg.kind !== "package.kb" || !input.pkg.site)
     return;
@@ -90022,7 +90109,8 @@ ${localized.body}`);
       }
     };
     await writeFile23(join75(configRoot, "config.mjs"), `const contextLocaleMarker = ${JSON.stringify(readers.translated ? marker : null)};
-` + `export default { ...${JSON.stringify(config)}, markdown: { ${siteMarkdownConfig} } };
+` + `export default { ...${JSON.stringify(config)}, markdown: { ${siteMarkdownConfig} },
+` + `  transformHtml: html => html.replace(/<script id="check-dark-mode">[\\s\\S]*?<\\/script>/u, "") };
 `);
     const menu = (lines, entries2, level, tag) => entries2.forEach((entry) => {
       const title = mdLabel(localizer.entryTitle(tag, entry));
@@ -90040,24 +90128,8 @@ ${localized.body}`);
       }));
     }
     const firstSection = sections[0]?.href ?? "/llms/index.html";
-    const heroFor = (tag) => {
-      const chinese = tag.toLowerCase().startsWith("zh");
-      const locale = tag === readers.primary ? undefined : options.locales?.[tag];
-      const home = locale ? locale.home : options.home;
-      const featured = (home?.resources ?? options.home?.resources ?? []).filter((resource) => resource.featured && resource.href);
-      return {
-        name: (locale ? locale.home?.title ?? locale.title : options.home?.title) ?? options.title ?? pkg.name,
-        text: home?.slogan ?? (chinese ? "从知识地图开始探索" : "Explore from the knowledge map"),
-        tagline: (locale ? locale.home?.description ?? locale.description : options.home?.description ?? options.description) ?? "",
-        actions: home?.actions ?? [
-          { theme: "brand", text: chinese ? "浏览知识" : "Browse knowledge", link: firstSection },
-          ...featured.map((resource) => ({ theme: "alt", text: resource.title, link: resource.href })),
-          { theme: "alt", text: "LLM Docs", link: "/llms/index.html" }
-        ]
-      };
-    };
     const heroTags = readers.translated ? readers.tags : [readers.primary];
-    const heroes = new Map(heroTags.map((tag) => [tag, heroFor(tag)]));
+    const heroes = new Map(heroTags.map((tag) => [tag, siteHomeHero(options, { tag, primary: readers.primary, packageName: pkg.name, firstSection })]));
     const hero = {
       name: localizedHtml(heroTags, (tag) => heroes.get(tag).name),
       text: localizedHtml(heroTags, (tag) => heroes.get(tag).text),
@@ -90176,7 +90248,7 @@ var init_packageSite2 = __esm(() => {
   init_packageSiteExtensions();
   init_packageDistributionMetadata();
   init_packageSiteLocales();
-  PACKAGE_SITE_VERSION = `vitepress-site-v48-reader-locales:${createHash22("sha256").update(JSON.stringify([siteThemeVariables.toString(), siteMarkdownConfig, siteThemeCss, siteThemeScript, siteThemeLabels("zh"), siteThemeLabels("en")])).digest("hex")}`;
+  PACKAGE_SITE_VERSION = `vitepress-site-v49-appearance-home-fallback:${createHash22("sha256").update(JSON.stringify([siteThemeVariables.toString(), siteMarkdownConfig, siteThemeCss, siteThemeScript, siteThemeLabels("zh"), siteThemeLabels("en")])).digest("hex")}`;
   require2 = createRequire6(import.meta.url);
 });
 
@@ -108893,7 +108965,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,