cgraphx 1.4.1 → 2.0.0

package/dist/web/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * web 子系统公共门面。
+ *
+ * 外部调用方(组合根 src/cli/index.ts)必须经此接入 —— 不得直接伸手进
+ * 内部模块(coding-standards「门面是硬约定」)。web 与 CLI 是 core 的两个
+ * 平行消费方,共享同一 DB 文件;web 仅依赖 src/core/(分层铁律),cli→web
+ * 的 wiring import 是唯一已记录例外。
+ */
+export { registerWebCommand } from './register';
+export { startWebServer } from './server';
+export type { WebServer } from './server';
+export { WebError, WebStartupError, exitCodeForWebError } from './errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/web/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}

package/dist/web/index.js

@@ -0,0 +1,20 @@
+"use strict";
+/**
+ * web 子系统公共门面。
+ *
+ * 外部调用方(组合根 src/cli/index.ts)必须经此接入 —— 不得直接伸手进
+ * 内部模块(coding-standards「门面是硬约定」)。web 与 CLI 是 core 的两个
+ * 平行消费方,共享同一 DB 文件;web 仅依赖 src/core/(分层铁律),cli→web
+ * 的 wiring import 是唯一已记录例外。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitCodeForWebError = exports.WebStartupError = exports.WebError = exports.startWebServer = exports.registerWebCommand = void 0;
+var register_1 = require("./register");
+Object.defineProperty(exports, "registerWebCommand", { enumerable: true, get: function () { return register_1.registerWebCommand; } });
+var server_1 = require("./server");
+Object.defineProperty(exports, "startWebServer", { enumerable: true, get: function () { return server_1.startWebServer; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "WebError", { enumerable: true, get: function () { return errors_1.WebError; } });
+Object.defineProperty(exports, "WebStartupError", { enumerable: true, get: function () { return errors_1.WebStartupError; } });
+Object.defineProperty(exports, "exitCodeForWebError", { enumerable: true, get: function () { return errors_1.exitCodeForWebError; } });
+//# sourceMappingURL=index.js.map

package/dist/web/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/web/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAEH,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,mCAA0C;AAAjC,wGAAA,cAAc,OAAA;AAEvB,mCAA0E;AAAjE,kGAAA,QAAQ,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,6GAAA,mBAAmB,OAAA"}

package/dist/web/layout.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 应用壳模板(spec §3.2 / §11 #12,视觉基线 plan index §7.7)。
+ *
+ * 深松绿侧栏三入口(知识库 / 开发时间线 / 数据库「后续」灰置不可点)+
+ * 顶栏(页面标题 + 只读 pill「本地 · <host:port> · 只读」)。
+ * 字体经 Google Fonts 引入(Space Grotesk / Noto Sans SC / JetBrains Mono,
+ * display=swap),字体栈尾部系统字体兜底(离线仅视觉降级)。
+ *
+ * B-2 的 renderShellPage 最小骨架在本文件升级为完整视觉壳(任务允许:
+ * 「renderShellPage 可重构进 layout.ts」);404/500 错误页复用本壳,
+ * 其行为(状态码 + 文案要素)保持不变。
+ */
+/** 当前导航激活项。'none' 表示错误页等非导航页面。 */
+export type ShellActive = 'knowledge' | 'timeline' | 'none';
+/**
+ * 渲染应用壳 + 主内容,返回完整 HTML 文档。
+ *
+ * `contentHtml` 为调用方已组装好的可信 HTML(其中的动态值由调用方自行
+ * escapeHtml);title / version / localHost 在此统一转义。
+ *
+ * @param localHost 顶栏只读 pill 展示的本地地址(形如 `127.0.0.1:2468`,
+ *        port 0 启动时取实际端口)。
+ */
+export declare function renderShellPage(opts: {
+    title: string;
+    active: ShellActive;
+    contentHtml: string;
+    version: string;
+    localHost: string;
+}): string;
+//# sourceMappingURL=layout.d.ts.map

package/dist/web/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/web/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,kCAAkC;AAClC,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,MAAM,CAAC;AAc5D;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAwCT"}

package/dist/web/layout.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * 应用壳模板(spec §3.2 / §11 #12,视觉基线 plan index §7.7)。
+ *
+ * 深松绿侧栏三入口(知识库 / 开发时间线 / 数据库「后续」灰置不可点)+
+ * 顶栏(页面标题 + 只读 pill「本地 · <host:port> · 只读」)。
+ * 字体经 Google Fonts 引入(Space Grotesk / Noto Sans SC / JetBrains Mono,
+ * display=swap),字体栈尾部系统字体兜底(离线仅视觉降级)。
+ *
+ * B-2 的 renderShellPage 最小骨架在本文件升级为完整视觉壳(任务允许:
+ * 「renderShellPage 可重构进 layout.ts」);404/500 错误页复用本壳,
+ * 其行为(状态码 + 文案要素)保持不变。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderShellPage = renderShellPage;
+const render_utils_1 = require("./render-utils");
+/** 侧栏导航条目。href 为 null → 「后续」灰置占位(不可点击)。 */
+function navItem(label, glyph, href, key, active) {
+    if (href === null) {
+        // 「后续」灰置占位:渲染为 span(无 href ⇒ 不可点击,spec §3.2)。
+        return `<span class="nav__item nav__item--disabled"><span class="nav__glyph">${(0, render_utils_1.escapeHtml)(glyph)}</span>${(0, render_utils_1.escapeHtml)(label)}<em class="nav__soon">后续</em></span>`;
+    }
+    const isActive = active === key;
+    const cls = isActive ? 'nav__item nav__item--active' : 'nav__item';
+    const aria = isActive ? ' aria-current="page"' : '';
+    return `<a class="${cls}" href="${(0, render_utils_1.escapeHtml)(href)}"${aria}><span class="nav__glyph">${(0, render_utils_1.escapeHtml)(glyph)}</span>${(0, render_utils_1.escapeHtml)(label)}</a>`;
+}
+/**
+ * 渲染应用壳 + 主内容,返回完整 HTML 文档。
+ *
+ * `contentHtml` 为调用方已组装好的可信 HTML(其中的动态值由调用方自行
+ * escapeHtml);title / version / localHost 在此统一转义。
+ *
+ * @param localHost 顶栏只读 pill 展示的本地地址(形如 `127.0.0.1:2468`,
+ *        port 0 启动时取实际端口)。
+ */
+function renderShellPage(opts) {
+    const { title, active, contentHtml, version, localHost } = opts;
+    return `<!doctype html>
+<html lang="zh-CN">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>${(0, render_utils_1.escapeHtml)(title)} · cgraphx web</title>
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@500;700&family=Noto+Sans+SC:wght@400;500;700&family=JetBrains+Mono:wght@400;600&display=swap" rel="stylesheet">
+<link rel="stylesheet" href="/assets/app.css">
+</head>
+<body>
+<div class="shell">
+  <aside class="shell__nav">
+    <div class="nav__brand">cgraphx <span class="nav__brand-tag">WEB</span></div>
+    <div class="nav__label">LOCAL DATA</div>
+    <nav class="nav">
+      ${navItem('知识库', '◈', '/', 'knowledge', active)}
+      ${navItem('开发时间线', '≡', '/timeline', 'timeline', active)}
+      ${navItem('数据库', '⛁', null, 'none', active)}
+    </nav>
+    <div class="nav__foot">cgraphx v${(0, render_utils_1.escapeHtml)(version)}<br>local · read-only viewer</div>
+  </aside>
+  <div class="shell__body">
+    <header class="shell__topbar">
+      <div class="topbar__title">${(0, render_utils_1.escapeHtml)(title)}</div>
+      <span class="readonly-pill"><span class="readonly-pill__dot"></span>本地 · ${(0, render_utils_1.escapeHtml)(localHost)} · 只读</span>
+    </header>
+    <main class="shell__main">
+      ${contentHtml}
+    </main>
+  </div>
+</div>
+<script src="/assets/app.js" defer></script>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=layout.js.map

package/dist/web/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/web/layout.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AA4BH,0CA8CC;AAxED,iDAA4C;AAK5C,2CAA2C;AAC3C,SAAS,OAAO,CAAC,KAAa,EAAE,KAAa,EAAE,IAAmB,EAAE,GAAgB,EAAE,MAAmB;IACvG,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,8CAA8C;QAC9C,OAAO,wEAAwE,IAAA,yBAAU,EAAC,KAAK,CAAC,UAAU,IAAA,yBAAU,EAAC,KAAK,CAAC,sCAAsC,CAAC;IACpK,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,KAAK,GAAG,CAAC;IAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,WAAW,CAAC;IACnE,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,OAAO,aAAa,GAAG,WAAW,IAAA,yBAAU,EAAC,IAAI,CAAC,IAAI,IAAI,6BAA6B,IAAA,yBAAU,EAAC,KAAK,CAAC,UAAU,IAAA,yBAAU,EAAC,KAAK,CAAC,MAAM,CAAC;AAC5I,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,eAAe,CAAC,IAM/B;IACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEhE,OAAO;;;;;SAKA,IAAA,yBAAU,EAAC,KAAK,CAAC;;;;;;;;;;;;QAYlB,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC;QAC7C,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC;QACtD,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC;;sCAEX,IAAA,yBAAU,EAAC,OAAO,CAAC;;;;mCAItB,IAAA,yBAAU,EAAC,KAAK,CAAC;iFAC6B,IAAA,yBAAU,EAAC,SAAS,CAAC;;;QAG9F,WAAW;;;;;;;CAOlB,CAAC;AACF,CAAC"}

package/dist/web/markdown.d.ts

@@ -0,0 +1,23 @@
+/**
+ * markdown 正文渲染器(spec §3.4 全文渲染 / §5.2 数据源边界 / §11 #7)。
+ *
+ * 进程级 markdown-it 单例,选项**固定** `{ html: false, linkify: false,
+ * typographer: false }`:
+ *   - html:false → 正文内的原始 HTML 一律转义为文本(XSS 契约,spec §3.2);
+ *   - linkify:false → 裸 URL 不自动转链接(避免意外出站);
+ *   - typographer:false → 不做排版替换(保留原文标点)。
+ * 内置规则(标题层级 / 段落 / 列表 / 行内与围栏代码 / 表格 / 引用块)默认
+ * 启用,不引入任何插件(YAGNI:内置规则已覆盖 spec §3.4 的呈现清单)。
+ *
+ * 边界:本模块只做「markdown 文本 → 可信 HTML」的纯转换,不感知文件路径——
+ * 数据源(源文件路径解析 / 读取 / frontmatter 剥离)由 pages-detail.ts 承担,
+ * 从构造上杜绝「给个路径就渲染」的端点(spec §5.2 / §11 #7)。
+ */
+/**
+ * 渲染 markdown 正文为 HTML 片段(不含壳)。
+ *
+ * 返回值是本系统中**唯一**作为可信 HTML 直出的内容;其余一切插值(元数据、
+ * 路径、引用标题……)由调用方过 escapeHtml。
+ */
+export declare function renderMarkdownBody(markdown: string): string;
+//# sourceMappingURL=markdown.d.ts.map

package/dist/web/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../../src/web/markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/web/markdown.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * markdown 正文渲染器(spec §3.4 全文渲染 / §5.2 数据源边界 / §11 #7)。
+ *
+ * 进程级 markdown-it 单例,选项**固定** `{ html: false, linkify: false,
+ * typographer: false }`:
+ *   - html:false → 正文内的原始 HTML 一律转义为文本(XSS 契约,spec §3.2);
+ *   - linkify:false → 裸 URL 不自动转链接(避免意外出站);
+ *   - typographer:false → 不做排版替换(保留原文标点)。
+ * 内置规则(标题层级 / 段落 / 列表 / 行内与围栏代码 / 表格 / 引用块)默认
+ * 启用,不引入任何插件(YAGNI:内置规则已覆盖 spec §3.4 的呈现清单)。
+ *
+ * 边界:本模块只做「markdown 文本 → 可信 HTML」的纯转换,不感知文件路径——
+ * 数据源(源文件路径解析 / 读取 / frontmatter 剥离)由 pages-detail.ts 承担,
+ * 从构造上杜绝「给个路径就渲染」的端点(spec §5.2 / §11 #7)。
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMarkdownBody = renderMarkdownBody;
+const markdown_it_1 = __importDefault(require("markdown-it"));
+/** 单例:选项固定、渲染无状态,可安全跨请求复用。 */
+const renderer = new markdown_it_1.default({
+    html: false,
+    linkify: false,
+    typographer: false,
+});
+/**
+ * 渲染 markdown 正文为 HTML 片段(不含壳)。
+ *
+ * 返回值是本系统中**唯一**作为可信 HTML 直出的内容;其余一切插值(元数据、
+ * 路径、引用标题……)由调用方过 escapeHtml。
+ */
+function renderMarkdownBody(markdown) {
+    return renderer.render(markdown);
+}
+//# sourceMappingURL=markdown.js.map

package/dist/web/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../../src/web/markdown.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;;;AAiBH,gDAEC;AAjBD,8DAAqC;AAErC,8BAA8B;AAC9B,MAAM,QAAQ,GAAG,IAAI,qBAAU,CAAC;IAC9B,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,WAAW,EAAE,KAAK;CACnB,CAAC,CAAC;AAEH;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,QAAgB;IACjD,OAAO,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACnC,CAAC"}

package/dist/web/overview-templates.d.ts

@@ -0,0 +1,123 @@
+/**
+ * 知识库总览页模板(纯 HTML 渲染函数,spec §3.3)。
+ *
+ * 设计:所有数据查询与 URL 拼装在上游(pages-overview.ts)完成,本文件
+ * 只消费已组装好的视图模型做字符串渲染 —— 每个 DB / 用户来源值在插值处
+ * 过 escapeHtml(XSS 契约,spec §3.2)。href 由上游经 URLSearchParams 编码
+ * 生成,插值处仍统一转义。
+ */
+import type { DocumentStatus } from '../core/markdown';
+import type { TypeTone } from './constants';
+/** 筛选芯片(类型 / 状态 / 领域):href 为点击后的切换链接。 */
+export interface ChipModel {
+    /** 中文显示标签(领域芯片无中文映射,label = 领域名)。 */
+    label: string;
+    /** 英文原值 / 领域名(URL 参数值)。 */
+    raw: string;
+    count: number;
+    href: string;
+    active: boolean;
+    /** 仅类型芯片有着色。 */
+    tone?: TypeTone;
+}
+/** 概念行(带篇数占比条)。 */
+export interface ConceptRowModel {
+    name: string;
+    count: number;
+    /** 占比百分数(0–100,纯 CSS 宽度)。 */
+    percent: number;
+    href: string;
+    active: boolean;
+}
+/** 激活筛选 pill(✕ = 移除该值后的 URL)。 */
+export interface PillModel {
+    /** 维度标签:类型 / 状态 / 领域 / 概念 / 关键词。 */
+    dimension: string;
+    value: string;
+    removeHref: string;
+}
+/** 文档卡上的概念标签链接(点击追加为概念筛选)。 */
+export interface CardTagModel {
+    name: string;
+    href: string;
+    active: boolean;
+}
+/** <time> 元素数据(datetime 供 app.js 本地化,text 为服务端本地时间)。 */
+export interface TimeModel {
+    datetime: string;
+    text: string;
+}
+/** 文档卡视图模型(字段与 spec §3.3 卡片要素一一对应)。 */
+export interface DocCardModel {
+    detailHref: string;
+    tone: TypeTone;
+    typeLabel: string;
+    typeRaw: string;
+    title: string;
+    alias: string | null;
+    summary: string;
+    conceptTags: CardTagModel[];
+    /** 「 / 」连接后的负责人;无负责人为 null。 */
+    ownersText: string | null;
+    status: DocumentStatus;
+    statusLabel: string;
+    statusRaw: string;
+    /** 「 / 」连接后的领域;无领域为 null。 */
+    domainsText: string | null;
+    referencesCount: number;
+    updated: TimeModel | null;
+}
+export interface SortLinkModel {
+    label: string;
+    href: string;
+    active: boolean;
+}
+export interface PagerModel {
+    /** 「第 X / Y 页 · 共 N 篇」—— total 始终可见(spec §11 #10)。 */
+    info: string;
+    prevHref: string | null;
+    nextHref: string | null;
+    /** 请求页超界时的提示文案;正常为 null。 */
+    notice: string | null;
+    /** total = 0 时不渲染分页区。 */
+    visible: boolean;
+}
+/** 总览页主区内容全量视图模型。 */
+export interface OverviewContentModel {
+    stats: {
+        documentCount: number;
+        conceptCount: number;
+        domainCount: number;
+        tagCount: number;
+        /** 全库最近索引时间;null → 「尚未索引」。 */
+        latestIndexed: TimeModel | null;
+    };
+    search: {
+        q: string;
+        /** 保留其余筛选的隐藏输入(name/value 原文,模板侧转义)。 */
+        hiddenInputs: Array<{
+            name: string;
+            value: string;
+        }>;
+    };
+    typeChips: ChipModel[];
+    statusChips: ChipModel[];
+    domainChips: ChipModel[];
+    topConcepts: ConceptRowModel[];
+    moreConcepts: ConceptRowModel[];
+    /** 概念总数(details summary 文案用)。 */
+    conceptTotal: number;
+    /** 列表头计数徽章:有筛选 「M / N」,无筛选 「N 篇」。 */
+    countBadge: string;
+    sortLinks: SortLinkModel[];
+    pills: PillModel[];
+    /** 激活条件 ≥2 → 清除全部。 */
+    clearAllVisible: boolean;
+    cards: DocCardModel[];
+    /** 空状态:kb-empty = 全库为空;no-match = 筛选 0 命中(spec §8 两态)。 */
+    empty: 'none' | 'kb-empty' | 'no-match';
+    pager: PagerModel;
+}
+/** 渲染总览页主区内容(壳由 layout.renderShellPage 提供)。 */
+export declare function renderOverviewContent(m: OverviewContentModel): string;
+//# sourceMappingURL=overview-templates.d.ts.map

package/dist/web/overview-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-templates.d.ts","sourceRoot":"","sources":["../../src/web/overview-templates.ts"],"names":[],"mappings":"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"}

package/dist/web/overview-templates.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * 知识库总览页模板(纯 HTML 渲染函数,spec §3.3)。
+ *
+ * 设计:所有数据查询与 URL 拼装在上游(pages-overview.ts)完成,本文件
+ * 只消费已组装好的视图模型做字符串渲染 —— 每个 DB / 用户来源值在插值处
+ * 过 escapeHtml(XSS 契约,spec §3.2)。href 由上游经 URLSearchParams 编码
+ * 生成,插值处仍统一转义。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderOverviewContent = renderOverviewContent;
+const render_utils_1 = require("./render-utils");
+// ----- 局部渲染 ------------------------------------------------------------
+/** 筛选芯片组。 */
+function renderChips(chips, withEnglish) {
+    return chips
+        .map((c) => {
+        const toneCls = c.tone !== undefined ? ` chip--${c.tone}` : '';
+        const activeCls = c.active ? ' chip--on' : '';
+        const en = withEnglish ? `<span class="chip__en">${(0, render_utils_1.escapeHtml)(c.raw)}</span>` : '';
+        return `<a class="chip${toneCls}${activeCls}" href="${(0, render_utils_1.escapeHtml)(c.href)}"><span class="chip__zh">${(0, render_utils_1.escapeHtml)(c.label)}</span>${en}<span class="chip__n">${c.count}</span></a>`;
+    })
+        .join('\n            ');
+}
+/** 概念行(名称 + 篇数 + 占比条,spec §3.3)。 */
+function renderConceptRows(rows) {
+    return rows
+        .map((r) => {
+        const activeCls = r.active ? ' con-row--on' : '';
+        return `<a class="con-row${activeCls}" href="${(0, render_utils_1.escapeHtml)(r.href)}">
+          <span class="con-row__name">${(0, render_utils_1.escapeHtml)(r.name)}</span>
+          <span class="con-row__cnt">${r.count} 篇 · ${r.percent}%</span>
+          <span class="con-row__bar"><i style="width:${r.percent}%"></i></span>
+        </a>`;
+    })
+        .join('\n        ');
+}
+/** 左侧筛选面板(五维:关键词 / 类型 / 状态 / 领域 / 概念)。 */
+function renderFiltersPanel(m) {
+    const hidden = m.search.hiddenInputs
+        .map((h) => `<input type="hidden" name="${(0, render_utils_1.escapeHtml)(h.name)}" value="${(0, render_utils_1.escapeHtml)(h.value)}">`)
+        .join('\n        ');
+    const conceptMore = m.moreConcepts.length > 0
+        ? `
+        <details class="con-more">
+          <summary>展开全部 ${m.conceptTotal} 个概念</summary>
+          ${renderConceptRows(m.moreConcepts)}
+        </details>`
+        : '';
+    return `
+    <aside class="filters">
+      <div class="filters__head"><b>筛选</b></div>
+      <form class="filters__search" action="/" method="get">
+        ${hidden}
+        <label class="search-box">
+          <span class="search-box__glyph">⌕</span>
+          <input id="search-input" name="q" type="search" placeholder="搜索标题 / 摘要…" value="${(0, render_utils_1.escapeHtml)(m.search.q)}" autocomplete="off">
+        </label>
+        <div class="filters__hint">回车搜索 · 按 / 聚焦搜索框</div>
+      </form>
+      <div class="filters__group">
+        <div class="filters__lab">文档类型 <i>TYPE</i></div>
+        <div class="filters__chips">
+          ${renderChips(m.typeChips, true)}
+        </div>
+      </div>
+      <div class="filters__group">
+        <div class="filters__lab">状态 <i>STATUS</i></div>
+        <div class="filters__chips">
+          ${renderChips(m.statusChips, true)}
+        </div>
+      </div>
+      <div class="filters__group">
+        <div class="filters__lab">领域 <i>DOMAIN</i></div>
+        <div class="filters__chips">
+          ${renderChips(m.domainChips, false)}
+        </div>
+      </div>
+      <div class="filters__group">
+        <div class="filters__lab">热门概念 <i>CONCEPTS</i></div>
+        <div class="filters__concepts">
+          ${renderConceptRows(m.topConcepts)}${conceptMore}
+        </div>
+      </div>
+    </aside>`;
+}
+/** 统计条:四数 + 最近索引时间(spec §3.3 / §4.2)。 */
+function renderStatbar(m) {
+    const s = m.stats;
+    const indexed = s.latestIndexed === null
+        ? `<span class="statbar__indexed-value">尚未索引</span>`
+        : `<time class="statbar__indexed-value" datetime="${(0, render_utils_1.escapeHtml)(s.latestIndexed.datetime)}" data-local-time>${(0, render_utils_1.escapeHtml)(s.latestIndexed.text)}</time>`;
+    const cell = (num, zh, en) => `<div class="stat"><div class="stat__num">${num}</div><div class="stat__lab">${zh}<i>${en}</i></div></div>`;
+    return `
+    <div class="statbar">
+      ${cell(s.documentCount, '文档', 'DOCUMENTS')}
+      ${cell(s.conceptCount, '概念', 'CONCEPTS')}
+      ${cell(s.domainCount, '领域', 'DOMAINS')}
+      ${cell(s.tagCount, '标签', 'TAGS')}
+    </div>
+    <div class="statbar__indexed">最近索引 ${indexed}</div>`;
+}
+/** 激活筛选 pill 区(无激活不渲染;≥2 追加「清除全部」)。 */
+function renderActivePills(m) {
+    if (m.pills.length === 0)
+        return '';
+    const pills = m.pills
+        .map((p) => `<span class="apill"><b>${(0, render_utils_1.escapeHtml)(p.dimension)}:</b>${(0, render_utils_1.escapeHtml)(p.value)}<a class="apill__x" href="${(0, render_utils_1.escapeHtml)(p.removeHref)}" title="移除该筛选">✕</a></span>`)
+        .join('\n        ');
+    const clearAll = m.clearAllVisible
+        ? `\n        <a class="apill apill--clear" href="/">清除全部</a>`
+        : '';
+    return `
+    <div class="active-pills">
+        ${pills}${clearAll}
+    </div>`;
+}
+/** 单张文档卡(spec §3.3 卡片要素)。 */
+function renderDocCard(c) {
+    const alias = c.alias !== null ? `<span class="doc__alias">${(0, render_utils_1.escapeHtml)(c.alias)}</span>` : '';
+    const tags = c.conceptTags
+        .map((t) => `<a class="doc__tag${t.active ? ' doc__tag--on' : ''}" href="${(0, render_utils_1.escapeHtml)(t.href)}">${(0, render_utils_1.escapeHtml)(t.name)}</a>`)
+        .join('');
+    const owners = c.ownersText !== null
+        ? `<span class="doc__owners">负责人 <b>${(0, render_utils_1.escapeHtml)(c.ownersText)}</b></span>`
+        : '';
+    const domains = c.domainsText !== null
+        ? `<span class="doc__domain">${(0, render_utils_1.escapeHtml)(c.domainsText)}</span>`
+        : `<span class="doc__domain doc__domain--none">—</span>`;
+    const updated = c.updated !== null
+        ? `<time class="doc__time" datetime="${(0, render_utils_1.escapeHtml)(c.updated.datetime)}">${(0, render_utils_1.escapeHtml)(c.updated.text)}</time>`
+        : `<span class="doc__time doc__time--none">—</span>`;
+    return `
+    <article class="doc doc--${c.tone}">
+      <div class="tbadge tbadge--${c.tone}"><b>${(0, render_utils_1.escapeHtml)(c.typeLabel)}</b><i>${(0, render_utils_1.escapeHtml)(c.typeRaw.toUpperCase())}</i></div>
+      <div class="doc__body">
+        <div class="doc__titlerow">
+          <a class="doc__title" href="${(0, render_utils_1.escapeHtml)(c.detailHref)}">${(0, render_utils_1.escapeHtml)(c.title)}</a>${alias}
+        </div>
+        <p class="doc__sum">${(0, render_utils_1.escapeHtml)(c.summary)}</p>
+        <div class="doc__tagrow">${tags}${owners}</div>
+      </div>
+      <div class="doc__side">
+        <span class="status status--${c.status}"><b></b>${(0, render_utils_1.escapeHtml)(c.statusLabel)} ${(0, render_utils_1.escapeHtml)(c.statusRaw)}</span>
+        ${domains}
+        <span class="doc__refs">引用 ${c.referencesCount}</span>
+        ${updated}
+      </div>
+    </article>`;
+}
+/** 空状态(spec §8:两态文案严格区分)。 */
+function renderEmpty(kind) {
+    if (kind === 'kb-empty') {
+        return `
+    <div class="empty">
+      <span class="empty__glyph">▦</span>
+      <h3 class="empty__title">知识库为空</h3>
+      <p class="empty__text">尚未索引任何文档。</p>
+      <p class="empty__hint">run <code>cgraphx docs index</code> to build the index</p>
+    </div>`;
+    }
+    return `
+    <div class="empty">
+      <span class="empty__glyph">⌕</span>
+      <h3 class="empty__title">没有匹配的文档</h3>
+      <p class="empty__text">当前筛选组合没有命中任何文档。</p>
+      <a class="empty__reset" href="/">重置全部筛选</a>
+    </div>`;
+}
+/** 分页区(上一页 / 下一页 + 「第 X / Y 页 · 共 N 篇」,边界禁用)。 */
+function renderPager(p) {
+    if (!p.visible)
+        return '';
+    const prev = p.prevHref !== null
+        ? `<a class="pager__btn" href="${(0, render_utils_1.escapeHtml)(p.prevHref)}">‹ 上一页</a>`
+        : `<span class="pager__btn pager__btn--disabled">‹ 上一页</span>`;
+    const next = p.nextHref !== null
+        ? `<a class="pager__btn" href="${(0, render_utils_1.escapeHtml)(p.nextHref)}">下一页 ›</a>`
+        : `<span class="pager__btn pager__btn--disabled">下一页 ›</span>`;
+    const notice = p.notice !== null ? `<p class="pager__notice">${(0, render_utils_1.escapeHtml)(p.notice)}</p>` : '';
+    return `
+    <nav class="pager">
+      ${notice}
+      <div class="pager__bar">
+        ${prev}
+        <span class="pager__info">${(0, render_utils_1.escapeHtml)(p.info)}</span>
+        ${next}
+      </div>
+    </nav>`;
+}
+// ----- 页面主区 ------------------------------------------------------------
+/** 渲染总览页主区内容(壳由 layout.renderShellPage 提供)。 */
+function renderOverviewContent(m) {
+    const sortSeg = m.sortLinks
+        .map((s) => `<a class="seg__btn${s.active ? ' seg__btn--on' : ''}" href="${(0, render_utils_1.escapeHtml)(s.href)}">${(0, render_utils_1.escapeHtml)(s.label)}</a>`)
+        .join('');
+    const listBody = m.empty !== 'none'
+        ? renderEmpty(m.empty)
+        : `<div class="doclist">${m.cards.map(renderDocCard).join('\n')}</div>${renderPager(m.pager)}`;
+    return `
+  <div class="kb-layout">
+    ${renderFiltersPanel(m)}
+    <div class="kb-main">
+      ${renderStatbar(m)}
+      <div class="list-head">
+        <h2>文档 <span class="count-badge">${(0, render_utils_1.escapeHtml)(m.countBadge)}</span></h2>
+        <div class="seg">${sortSeg}</div>
+      </div>${renderActivePills(m)}
+      ${listBody}
+    </div>
+  </div>`;
+}
+//# sourceMappingURL=overview-templates.js.map

package/dist/web/overview-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overview-templates.js","sourceRoot":"","sources":["../../src/web/overview-templates.ts"],"names":[],"mappings":"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"}

package/dist/web/pages-detail.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 知识库文档详情页(spec §3.4 / §5.2 / §8 / §11 #6/#7)。
+ *
+ * 只读 SSR:GET /doc/<ident> → 元数据网格 + 摘要块 + 源文件 markdown 全文
+ * 服务端渲染 + 双向引用导航 + 文档 ID/路径展示;未找到与源文件缺失各自有
+ * 明确状态(spec §8)。
+ *
+ * 数据消费硬约定:只经 markdown 子系统门面(MarkdownQuery / stripFrontmatter /
+ * DocumentNotFoundError),不伸手进内部模块。每请求以基座进程级连接构造
+ * `new MarkdownQuery(db)`(无状态、廉价,只读 SELECT)。
+ *
+ * 转义边界(XSS 契约,spec §3.2):所有元数据字段 / 路径 / 引用标题插值前过
+ * escapeHtml;**仅** markdown-it 输出(renderMarkdownBody)作为可信 HTML 直出。
+ */
+import type { SqliteDatabase } from '../core/db';
+/** 详情页渲染结果:status 仅 200(命中,含源文件缺失)/ 404(文档未找到)。 */
+export interface DetailRenderResult {
+    status: 200 | 404;
+    html: string;
+}
+/**
+ * 渲染文档详情页完整 HTML(壳 + 主区)。
+ *
+ * @param db 基座进程级单连接(每请求 new MarkdownQuery(db),只读 SELECT)。
+ * @param projectRoot 项目根(源文件读取基准;源文件路径仅从索引 DB 解析)。
+ * @param ident decodeURIComponent 后的 64 位十六进制 ID 或项目相对路径。
+ */
+export declare function renderDetailPage(db: SqliteDatabase, projectRoot: string, ident: string, ctx: {
+    version: string;
+    localHost: string;
+}): DetailRenderResult;
+//# sourceMappingURL=pages-detail.d.ts.map

package/dist/web/pages-detail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages-detail.d.ts","sourceRoot":"","sources":["../../src/web/pages-detail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwKjD,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,cAAc,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC1C,kBAAkB,CAmEpB"}