@sushanglewis/lincoln 1.8.4 → 1.9.0

package/framework/.claude/skills/build-product-prototype/prompts/main.md

@@ -60,7 +60,7 @@ You may still read the categorized example templates under `.claude/templates/is
 
    Use the structured renderer with `--data` containing `sections`, `pages`, and `interactions` as appropriate.
 
-5. **Plan prototype generation granularity.** Before writing prototype pages, derive a **角色×场景矩阵** from `scenarios.html` and `page-map.html`: rows are the user roles/personas, columns are the key scenarios (including boundary cases such as empty, loading, error, success). Every cell that a real user can reach must map to exactly one prototype sub-page; the matrix itself is written into `ui-spec.html` (章节 `## 角色×场景矩阵`) and serves as the splitting contract. Then group the sub-pages into cohesive clusters (e.g. onboarding, main shell, settings, overlays, tray). Generate one cluster at a time. After each cluster, verify that every page has complete annotation meta tags before starting the next cluster.
+5. **Plan prototype generation granularity.** Before writing prototype pages, derive a **角色×场景矩阵** from `scenarios.html` and `page-map.html`: rows are the user roles/personas, columns are the key scenarios (including boundary cases such as empty, loading, error, success). Every cell that a real user can reach must map to exactly one prototype sub-page; the matrix itself is written into `ui-spec.html` (章节 `## 角色×场景矩阵`) and serves as the splitting contract. Then group the sub-pages into cohesive clusters (e.g. onboarding, main shell, settings, overlays, tray). Generate one cluster at a time. After each cluster, verify that every page has complete hotspot annotations (numbered badges covering functionality, fields, boundary cases, and exception flows) before starting the next cluster.
 
    Each cluster is organized by one main shell page (e.g. `pages/prototype/{app,web,mobile}/main/page.html`) whose `navItems` link to all sub-pages of that cluster, so the portal viewer can walk every role/scenario state from a single entry page.
 
@@ -85,15 +85,13 @@ You may still read the categorized example templates under `.claude/templates/is
      navItems:
        - {id: dashboard, label: 概览, href: ./dashboard/page.html}
        - {id: list, label: 列表, href: ./list/page.html}
-   annotations:
-     doc-purpose: "展示核心指标与快捷入口"
-     doc-layout: "顶部导航 | 指标卡片网格 | 列表区"
-     doc-fields: "..."
-     doc-stories: "..."
-     doc-rules: "..."
-     doc-boundaries: "..."
-     doc-exceptions: "..."
-     doc-refs: "flows.html | page-map.html"
+   hotspots:
+     - target: "metric-revenue"      # CSS selector, data-uid, or element id
+       title: "营收指标卡"
+       text: "展示本月营收与环比；点击进入详情页。"
+     - target: "#global-search"
+       title: "全局搜索"
+       text: "支持名称/拼音/首字母搜索，回车跳转首个结果。"
    components:
      - type: html
        uid: dashboard-metrics
@@ -112,11 +110,11 @@ You may still read the categorized example templates under `.claude/templates/is
    - Link to `../../../assets/prototype.css` and `../../../assets/prototype.js` (depth 3) or `../../../../assets/...` (depth 4) depending on its path.
    - Include theme sync support (built into the structured template).
    - Include `<meta name="prototype-base" content="../../../">` (or `../../../../` for depth 4).
-   - Include `<meta name="page-uid" content="...">`, `<meta name="nav-group" content="...">`, and `<meta name="nav-label" content="...">` (injected by the renderer from CLI args; annotations come from the YAML `annotations` block).
-   - Provide the full annotation meta tags so the portal right panel explains functionality, layout, fields, boundary cases, and exception flows.
-   - State the applicable role(s), scenario, page state (default / empty / loading / error / success), and which functions are visible and usable in that state via the `doc-purpose`, `doc-rules`, and `doc-boundaries` annotations, so each sub-page precisely depicts what a given role sees and can do in that case.
-   - Depict only the final system as it will ship: no demo-only buttons, explanatory text rows, or walkthrough-only jumps. Explanations belong in the `doc-*` annotation metas rendered in the portal right panel, never as on-screen prose.
-   - Declare the user story and business-flow step the page implements via `doc-stories` / `doc-refs`, so the prototype aligns bidirectionally with the PRD: every flow step has at least one page, and every page belongs to a flow step or story.
+   - Include `<meta name="page-uid" content="...">`, `<meta name="nav-group" content="...">`, and `<meta name="nav-label" content="...">` (injected by the renderer from CLI args; hotspots come from the YAML `hotspots` block and are rendered as numbered badges via driver.js).
+   - Provide a `hotspots` array so numbered on-page badges explain functionality, layout, fields, boundary cases, and exception flows (hover for the popover, click to pin; the prototype toolbar can hide badges).
+   - State the applicable role(s), scenario, page state (default / empty / loading / error / success), and which functions are visible and usable in that state via the hotspot `title`/`text` entries, so each sub-page precisely depicts what a given role sees and can do in that case.
+   - Depict only the final system as it will ship: no demo-only buttons, explanatory text rows, or walkthrough-only jumps. Explanations belong in the `hotspots` badges rendered on the page, never as on-screen prose.
+   - Declare the user story and business-flow step the page implements in the hotspot `text` entries, so the prototype aligns bidirectionally with the PRD: every flow step has at least one page, and every page belongs to a flow step or story.
    - Use `LincolnPrototype.ui` builders and `prototype.css` tokens for every visual element so both light and dark themes render correctly; verify both themes by toggling the portal theme switch.
    - Assign a stable `data-uid` attribute to every interactive element, screen region, and WebView placeholder.
    - Override `LincolnPrototype.data` in the page script for issue-specific mock data (user, org, webviews, settings, unread items).
@@ -143,7 +141,7 @@ You may still read the categorized example templates under `.claude/templates/is
 - Keep controls and states complete enough for implementation: default, hover/focus where relevant, disabled, empty, loading, error, and success.
 - Every interactive element must carry a stable `data-uid`. Do not generate random UIDs that change on every render.
 - Prototype links use relative paths so they work both inside the portal iframe and when opened standalone.
-- Do not add collapse toggles or custom panel chrome to the portal; the right annotation panel is always visible.
+- Do not add custom chrome to the portal. The portal sidebar is collapsible and supports focus mode out of the box; prototype pages open in focus mode automatically.
 - The system tray is portal-level chrome. Never redraw the tray inside an app prototype page with `.menubar`, `.tray-icon`, `.tray-panel`, `bindTray`, or `trayMenu`. Tray scenario pages must be thin controllers that post `lincoln-tray-state` messages to the portal.
-- 原型即最终系统样貌：禁止仅用于演示的模拟按钮、屏内说明文字与演示跳转；解释一律走 `doc-*` 注释由门户右侧面板呈现；每个原型页面经 `doc-stories` / `doc-refs` 标注所属用户故事与业务流程步骤，与 PRD 文字双向对齐。
+- 原型即最终系统样貌：禁止仅用于演示的模拟按钮、屏内说明文字与演示跳转；解释一律走 `hotspots` 数字角标（driver.js，hover 弹出说明）呈现；每个原型页面经角标 `text` 标注所属用户故事与业务流程步骤，与 PRD 文字双向对齐。
 - After approval, tell the user to run: `claude plan-tdd-development <session_id> <design_id>`.

package/framework/.claude/skills/lc-workflow/validators/validate.py

@@ -526,22 +526,15 @@ def validate_prototype_artifact_complete(design_id: str):
     if missing_nav_label:
         fail(f"Prototype pages missing nav-label meta: {', '.join(missing_nav_label)}")
 
-    required_annotation_metas = [
-        ("doc-purpose", 'doc-purpose'),
-        ("doc-layout", 'doc-layout'),
-        ("doc-fields", 'doc-fields'),
-        ("doc-boundaries", 'doc-boundaries'),
-        ("doc-exceptions", 'doc-exceptions'),
-    ]
-    annotation_gaps: dict[str, list[str]] = {}
+    # Explanations are numbered on-page hotspots (driver.js), not doc-* metas.
+    hotspot_gaps: dict[str, str] = {}
     for p in html_files:
         text = p.read_text(encoding="utf-8")
-        missing = [name for label, name in required_annotation_metas if f'<meta name="{name}"' not in text]
-        if missing:
-            annotation_gaps[str(p.relative_to(process_root()))] = missing
-    if annotation_gaps:
-        messages = [f"{path}: missing {', '.join(metas)}" for path, metas in annotation_gaps.items()]
-        fail(f"Prototype pages missing required annotation meta tags:\n" + "\n".join(messages))
+        if '"hotspots"' not in text:
+            hotspot_gaps[str(p.relative_to(process_root()))] = '"hotspots"'
+    if hotspot_gaps:
+        messages = [f"{path}: missing {key} in pageData" for path, key in hotspot_gaps.items()]
+        fail(f"Prototype pages missing required hotspot annotations:\n" + "\n".join(messages))
 
     # Anti-pattern: in-app tray redraw. The system tray is portal-level chrome.
     in_app_tray_markers = [

package/framework/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "lincoln",
       "description": "AI-Native product R&D collaboration system for Conductor + Claude Code. Orchestrates stages, gates, artifacts, skills, and roles across product, design, and engineering into a repeatable workflow from recordings to GitHub Issues to Obsidian knowledge base.",
-      "version": "1.8.4",
+      "version": "1.9.0",
       "author": {
         "name": "Lincoln contributors"
       },
@@ -28,5 +28,5 @@
       ]
     }
   ],
-  "version": "1.8.4"
+  "version": "1.9.0"
 }

package/framework/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "lincoln",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "description": "AI-Native product R&D collaboration system for Conductor + Claude Code + OpenSpec + GitHub + Obsidian",
   "author": {
     "name": "Lincoln contributors"

package/framework/.version-bump.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.8.4",
+  "version": "1.9.0",
   "manifests": [
     {
       "path": ".claude-plugin/plugin.json",

package/framework/README.en.md

@@ -12,9 +12,9 @@ Lincoln is an AI-Native R&D workflow system spanning **IDEs, agent harnesses, co
 
 ## Latest Release
 
-[![Release](https://img.shields.io/badge/release-v1.8.4-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.9.0-blue)](RELEASE.md)
 
-**v1.8.4** is released: hook-injected less-is-more artifact discipline, plus a fix syncing the `policies` directory into vendored projects.
+**v1.9.0** is released: the issue-package portal is rebuilt as a docsify-style documentation framework — collapsible/filterable sidebar, focus mode, full Markdown rendering via marked, and driver.js numbered hotspot annotations, all openable via file:// with zero services (#131).
 
 See the full release notes in [RELEASE.md](RELEASE.md).
 
@@ -175,6 +175,17 @@ Every requirement maps to one GitHub issue and one Lincoln feature branch. The `
 - `pages/prototype/` — interactive HTML prototypes
 - `handoffs/` — stage handoff documents
 
+### Docsify-Style Portal & Numbered Hotspot Annotations
+
+The `index.html` portal adopts a docsify-style documentation framework: content is baked at generation time with zero runtime requests, so packages open directly via **file://** and can also be pushed to static hosting for shareable links (`#/pages/docs/prd.html` deep links included):
+
+- **Sidebar**: collapsible groups with remembered state, a filter box for instant page location, collapse/expand-all
+- **Focus mode**: hides the sidebar while reading docs or reviewing prototypes, giving prototypes full-width space (Esc to exit)
+- **Documents**: marked (MIT) renders full Markdown — images, tables, task lists, and mermaid diagrams, all synced with the portal's light/dark theme
+- **Prototype annotations**: declare `hotspots` in the page YAML to render numbered badges on elements; hover for the explanation without on-screen prose
+
+Run `lincoln update` after upgrading to sync the latest portal templates and runtimes into every harness and project.
+
 ## Natural-Language Interaction
 
 Lincoln is AI-Native — **you don't need to type terminal commands**. Describe your intent in plain language and the Agent translates and executes the right scripts for you.
@@ -242,6 +253,7 @@ Before submitting a PR, please read:
 
 | Version | Date | Key capabilities |
 |---|---|---|
+| v1.9.0 | 2026-10-12 | Docsify-style issue-package portal: collapsible/filterable sidebar, focus mode, full Markdown rendering via marked, driver.js numbered hotspot annotations, hash deep links (#131) |
 | v1.8.4 | 2026-10-08 | PM-stage PRD quality gates: six-question clarity check, 13-section progressive PRD skeleton, content-hygiene and cross-validation checks, final-system-only prototype discipline (#129) |
 | v1.8.3 | 2026-10-08 | Less-is-more artifact discipline (hook-injected); platform-aware install hints for non-npm CLIs; `lincoln update` refreshes external skill libraries |
 | v1.7.0 | 2026-09-05 | SecurityAnalyzer gating; Trace 2.0 event log; friction scoring/knowledge recall/trace condensation/MR mining; parallel specialist delegation; stakeholder analysis model |

package/framework/README.md

@@ -12,9 +12,9 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ## 最新版本
 
-[![Release](https://img.shields.io/badge/release-v1.8.4-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.9.0-blue)](RELEASE.md)
 
-**v1.8.4** 已发布：新增少即是多制品生成纪律（hook 注入），修复 policies 目录未同步进 vendored 项目的问题。
+**v1.9.0** 已发布：issue-package 门户升级为 docsify 风格文档框架——可折叠可过滤目录、focus 模式、marked 完整 Markdown 渲染、driver.js 数字角标注解，零服务 file:// 直接打开（#131）。
 
 查看完整发布说明：[RELEASE.md](RELEASE.md)
 
@@ -177,6 +177,17 @@ AI 生成的交接产物容易内容堆积、重点淹没。Lincoln 把「少即
 - `pages/prototype/` — 可交互原型 HTML 页面
 - `handoffs/` — 阶段交接文档
 
+### docsify 式门户与数字角标注解
+
+`index.html` 门户采用 docsify 风格的文档框架，生成时烘焙、运行时零外部请求，**file:// 双击即可浏览**，也可由流水线推到静态托管后直接分享链接（`#/pages/docs/prd.html` 支持深链定位）：
+
+- **目录**：分组折叠（状态记忆）、过滤框实时定位、一键收起/展开；文档与原型分组清晰
+- **Focus 模式**：阅读文档或验收原型时隐藏目录，原型获得全屏空间（Esc 退出）
+- **文档**：marked（MIT）完整渲染 Markdown——图片、表格、任务列表、mermaid 流程图，随门户明暗主题切换
+- **原型注解**：页面 YAML 声明 `hotspots` 后在元素上生成数字角标，hover 查看说明，解释不再占用屏内空间
+
+升级到本版本后执行 `lincoln update` 即同步最新门户模板与运行时。
+
 ## 自然语言交互
 
 Lincoln 是 AI-Native 工作流——**你不需要在终端输入任何命令**。直接用自然语言描述意图，Agent 会自动翻译成对应脚本并代为执行。
@@ -244,6 +255,7 @@ Lincoln 的 `.claude/` 是开放的系统提示层，欢迎基于同一套元模
 
 | 版本 | 日期 | 关键能力 |
 |---|---|---|
+| v1.9.0 | 2026-10-12 | docsify 式 issue-package 门户：可折叠过滤目录、focus 模式、marked 完整 Markdown 渲染、driver.js 数字角标注解、hash 深链（#131） |
 | v1.8.4 | 2026-10-08 | PM 阶段 PRD 质量门控：需求六问自检、13 章递进骨架、PRD 内容卫生与交叉验证校验、原型最终样貌纪律（#129） |
 | v1.8.3 | 2026-10-08 | 少即是多制品生成纪律（hook 注入）；非 npm CLI 平台化安装提示；`lincoln update` 同步刷新外部技能库 |
 | v1.7.0 | 2026-09-05 | SecurityAnalyzer 安全门控；Trace 2.0 事件日志；摩擦学习/知识召回/Trace 浓缩/MR 挖掘；并行专家子代理委托；相关者分析模型 |

package/framework/RELEASE.md

@@ -1,3 +1,26 @@
+# Lincoln v1.9.0 Release Notes
+
+**Release date:** 2026-10-12
+
+## Highlights
+
+- **docsify 式 issue-package 门户 + 数字角标注解 (#131 / LEW-76)** — issue-package 的 `index.html` 人读门户整体升级为 docsify 风格的文档承载框架，生成时烘焙、运行时零请求，继续支持 file:// 双击打开与静态托管零部署：
+  - **docsify 式门户风格** — 白色侧边栏顶部药丸搜索框、加粗分组标题带 ▸/▾ 折叠箭头、激活页浅绿底 + 绿色左边条；文档内容区去掉窗口卡片，860px 居中大号排版（h1 34px、1.75 行距）、蓝色竖条引用样式；顶部精简为 40px 白色工具条（聚焦/主题/托盘/日期）。
+  - **可折叠、可定位的目录** — 目录分组独立折叠（状态存 localStorage）+ 一键全部收起/展开；过滤框按标题/路径匹配并自动展开命中组、高亮定位；文档与原型分组一目了然。右侧说明面板与「必要产物清单」从目录栏移除。
+  - **Focus 模式** — 菜单栏按钮或打开原型页自动进入：目录整体隐藏、内容 100% 宽，原型获得最大展示空间，Esc 退出。
+  - **完整 Markdown 渲染（marked）** — vendor `marked` v18（MIT，docsify 同款渲染器）替换手写解析器：图片、表格、任务列表等原生元素全支持；mermaid 代码块自动渲染并随门户明暗主题切换；`<script id="docSource">` 内嵌契约不变，全部 PRD 门控校验零回归。
+  - **数字角标注解（driver.js）** — vendor `driver.js` v1.9（MIT）；原型 YAML 新增 `hotspots: [{target, title, text}]`，在搜索框、字段、卡片等元素上渲染数字角标，hover 弹出说明、点击固定、可整体隐藏，解释不再依赖门户右侧面板，也不再以屏内文字出现。
+  - **hash 深链路由** — `#/pages/docs/prd.html` 形式的地址可直接定位到任意文档或原型页，Agent share 链接给人类验收更友好。
+  - 顺带修复：结构化原型模板资源引用深度（depth-3 → depth-4）与技能规范不一致导致 `prototype.js` 404 的问题。
+
+## Migration Notes
+
+- 无破坏性变更：新门户由 `lincoln_index.py` 重新生成 `package-data.js` 后自动生效；进行中的 issue 工作包在包目录内重跑 `scripts/lincoln_index.py`（或任一 `stage_loader.py` 产物记录动作）即完成升级。
+- 原型页的 `doc-*` 注解 meta 已被 `hotspots` 取代：`prototype_artifact_complete` 校验器现要求页面数据含 `hotspots`；存量原型页在下一次 `build-product-prototype` 重渲染时自动迁移。
+- 升级方式：`npm install -g @sushanglewis/lincoln@latest` 后执行 `lincoln update`，即把新门户模板、marked/driver.js 运行时与校验器同步进各 harness 与项目。
+
+---
+
 # Lincoln v1.8.4 Release Notes
 
 **Release date:** 2026-10-08

package/framework/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.8.4",
-  "generatedAt": "2026-10-08T15:05:56.234Z",
+  "version": "1.9.0",
+  "generatedAt": "2026-10-12T03:56:22.196Z",
   "files": [
     {
       "path": ".claude-plugin/hooks.json",
@@ -8,11 +8,11 @@
     },
     {
       "path": ".claude-plugin/marketplace.json",
-      "sha256": "eedc0fe820496ffa76731e694758753e81d55bcbab1b3f4700562559aeebeba8"
+      "sha256": "1fa447cb84c758beb21134854712cb938b5bc0e7dc01bccf48047c6b63f118ba"
     },
     {
       "path": ".claude-plugin/plugin.json",
-      "sha256": "c18a2bb7fa9907deccc2e14556a3279d876ed08560eb092a59f341587f7fe7c9"
+      "sha256": "9eaf9b63df95f32433d655a46a0f976dddedde2e9201908228835cfbc50ff897"
     },
     {
       "path": ".claude/agents/architect.md",
@@ -172,7 +172,7 @@
     },
     {
       "path": ".claude/skills/build-product-prototype/prompts/main.md",
-      "sha256": "6523aa6def0f75f93cbbbcbb76e5de285ecc730bb81211add8900826f6a51d5b"
+      "sha256": "eb2a23f58f8b0bf28263b03484ff0c672a72f3f10e300fecabb35097cfe5f994"
     },
     {
       "path": ".claude/skills/clarify-requirements/SKILL.md",
@@ -348,7 +348,7 @@
     },
     {
       "path": ".claude/skills/lc-workflow/validators/validate.py",
-      "sha256": "0a6b9afab31c0e0e4b33dc7cc2e421604bafbc386cb9bd259098232f161e0e1b"
+      "sha256": "5668b9ef229e5c42cfb41cfe75e1c4b7bb5cafdf727f2e18b4257a3a9c41bf4f"
     },
     {
       "path": ".claude/skills/plan-tdd-development/SKILL.md",
@@ -540,7 +540,7 @@
     },
     {
       "path": ".version-bump.json",
-      "sha256": "19c15c1eae8c4e4a1062f0e82bdbf4201910f6fd9a42019a0627fa7e41061546"
+      "sha256": "6abdf12c5f36113acbfc13f2261cded6efb331cea7e6649a0157740b5cc4349a"
     },
     {
       "path": "CLAUDE.md",
@@ -556,15 +556,15 @@
     },
     {
       "path": "README.en.md",
-      "sha256": "12325801ae226d0dfa825b66cae2fb48758af0c979d890f56f7447fa1be8b89b"
+      "sha256": "386c243a93a88b13a8e7fde9d6e189014fdc9909246fe38c510a47f278450af6"
     },
     {
       "path": "README.md",
-      "sha256": "8b5427ce20877fddd96a763f50841bf91706e0611e22320fd255dbc19d72e66d"
+      "sha256": "28e96b5cbbf45f3d710d8d9811a200bc38f6ca5fba804712b103364e33c91f91"
     },
     {
       "path": "RELEASE.md",
-      "sha256": "a4d72d108a6f676a48392327bab1a5b88b40eaf3c8eec581d3866705f3994942"
+      "sha256": "ad4237d5b283200e49a7b3b2f2a4387cf12e69e6732c5794bec1a55a3d2da5ee"
     },
     {
       "path": "SKILL.md",
@@ -684,7 +684,7 @@
     },
     {
       "path": "scripts/lincoln_index.py",
-      "sha256": "8b237e80673dd96e6aa6fba6cf65f6c9bb4e09777ef17ed7bf1eaa2dce0c10ff"
+      "sha256": "d9212b5fee3808d031f849b79e2cfb734834859ed126fa319d5c2d0024cacf2b"
     },
     {
       "path": "scripts/lincoln_mr_mine.py",
@@ -704,7 +704,7 @@
     },
     {
       "path": "scripts/lincoln_render.py",
-      "sha256": "0750b3cdcd77a0679e4dda626eebc0ab2bea90072d844e7979ac1c1365fa0800"
+      "sha256": "923ff42a64b36c955bab4e0213f7191f1971cb981b2c5a70ff2410e3feea9a3a"
     },
     {
       "path": "scripts/lincoln_role.py",
@@ -788,7 +788,7 @@
     },
     {
       "path": "tools/lincoln-installer/package.json",
-      "sha256": "8af7b6ee0dc6da02d47413495af0b8f042d90ffb0a79c46e8bce5c6dafb19671"
+      "sha256": "03b08328e3ccd97f7d989b5c0cac5017c7b09d9ba1685eb8cd36730468829a91"
     },
     {
       "path": "tools/lincoln-installer/src/cli.tsx",
@@ -1072,11 +1072,11 @@
     },
     {
       "path": "tools/lincoln/package-lock.json",
-      "sha256": "5156ad816f5a4eb0ea354943b74af393c2586878bf5b64a1ab228bb6cae98ae4"
+      "sha256": "4ac004e537b8f6db8348deb2e6821a079f1bd18f893be87a8a03c910e36516f9"
     },
     {
       "path": "tools/lincoln/package.json",
-      "sha256": "6631b2928992358105633a0e0b4c693c40e40fbd73757f74a39dc8bd2302165e"
+      "sha256": "da614ee0caea0ae442defae9bf1a90ce857d2b9de15c9983f2ee9d209410f094"
     },
     {
       "path": "tools/lincoln/src/cli.tsx",

package/framework/scripts/lincoln_index.py

@@ -29,8 +29,6 @@ PACKAGE_DATA_FILENAME = "assets/js/package-data.js"
 ARCHIVE_NAV_GROUP = "归档"
 VERSION_COMMENT_RE = re.compile(r"<!--\s*version:\s*(v\d+\.\d+)\s*-->", re.IGNORECASE)
 STATUS_COMMENT_RE = re.compile(r"<!--\s*status:\s*(\w+)\s*-->", re.IGNORECASE)
-LIST_META_KEYS = ("doc-fields", "doc-stories", "doc-rules", "doc-boundaries", "doc-exceptions", "doc-refs")
-LIST_SEPARATOR = "|"
 
 
 class MetaParser(HTMLParser):
@@ -71,13 +69,6 @@ def package_relative(path: str, process_slug: str) -> str:
     return path[len(prefix) :] if path.startswith(prefix) else path
 
 
-def split_list_meta(value: str) -> list[str]:
-    """Split a pipe-separated meta value into a list of trimmed non-empty items."""
-    if not value:
-        return []
-    return [item.strip() for item in value.split(LIST_SEPARATOR) if item.strip()]
-
-
 def extract_html_meta(full_path: Path) -> dict[str, Any]:
     """Parse meta tags and version/status comments from an HTML page."""
     if not full_path.exists():
@@ -91,20 +82,15 @@ def extract_html_meta(full_path: Path) -> dict[str, Any]:
 
     version_match = VERSION_COMMENT_RE.search(text)
     status_match = STATUS_COMMENT_RE.search(text)
-    meta = {
+    return {
         "title": parser.meta.get("doc-title") or parser.title or full_path.stem,
         "nav_label": parser.meta.get("nav-label", ""),
         "nav_group": parser.meta.get("nav-group", "Docs"),
         "version": parser.meta.get("doc-version") or (version_match.group(1) if version_match else None),
         "status": status_match.group(1) if status_match else "",
         "uid": parser.meta.get("doc-uid") or parser.meta.get("page-uid", ""),
-        "purpose": parser.meta.get("doc-purpose", ""),
-        "layout": parser.meta.get("doc-layout", ""),
+        "markdown": extract_html_markdown(full_path) if 'id="docSource"' in text else "",
     }
-    for key in LIST_META_KEYS:
-        field = key.replace("doc-", "")
-        meta[field] = split_list_meta(parser.meta.get(key, ""))
-    return meta
 
 
 def extract_html_markdown(full_path: Path) -> str:
@@ -196,15 +182,8 @@ def build_package_data(
                 "stage": entry.get("stage", ""),
                 "gate_passed": entry.get("gate_passed", False),
                 "human_confirmed": entry.get("human_confirmed", False),
-                "purpose": entry.get("purpose", ""),
-                "layout": entry.get("layout", ""),
-                "stories": entry.get("stories", []),
-                "fields": entry.get("fields", []),
-                "rules": entry.get("rules", []),
-                "boundaries": entry.get("boundaries", []),
-                "exceptions": entry.get("exceptions", []),
-                "refs": entry.get("refs", []),
                 "uid": entry.get("uid", ""),
+                "markdown": entry.get("markdown", ""),
             }
         )
 

package/framework/scripts/lincoln_render.py

@@ -519,7 +519,7 @@ def _inject_meta(html: str, name: str, content: str) -> str:
 
 
 def _inject_annotation_metas(html: str, page_data: dict[str, Any]) -> str:
-    """Inject portal annotation meta tags from page_data.annotations into <head>."""
+    """Inject doc annotation meta tags from page_data.annotations into <head>."""
     annotations = page_data.get("annotations") if isinstance(page_data, dict) else None
     if not isinstance(annotations, dict):
         return html
@@ -716,9 +716,11 @@ def render_page(
     uid_kind = _resolve_meta_uid_kind(template, target)
     html = _inject_meta(html, uid_kind, uid)
 
-    # Inject portal annotation metas from structured page data so the portal
-    # index and right-panel annotations are present in the static HTML source.
-    html = _inject_annotation_metas(html, page_data or {})
+    # Inject doc annotation metas for doc pages only. Prototype pages carry
+    # their explanations as on-page hotspots (window.LincolnHotspots) instead.
+    is_prototype = "/prototype/" in target or PAGE_UID_META_RE.search(template)
+    if not is_prototype:
+        html = _inject_annotation_metas(html, page_data or {})
 
     html = _ensure_version_comment(html, version)
 

package/framework/tools/lincoln/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "@sushanglewis/lincoln",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@sushanglewis/lincoln",
-      "version": "1.8.4",
+      "version": "1.9.0",
       "license": "MIT",
       "dependencies": {
         "ink": "^5.2.0",

package/framework/tools/lincoln/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sushanglewis/lincoln-recorder",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "description": "Cross-tool terminal UI for recording Lincoln interviews",
   "type": "module",
   "main": "./dist/index.js",

package/framework/tools/lincoln-installer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lincoln-install",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "description": "Terminal TUI installer for the Lincoln AI-Native R&D workflow system",
   "type": "module",
   "main": "dist/main.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sushanglewis/lincoln",
-  "version": "1.8.4",
+  "version": "1.9.0",
   "description": "Global Lincoln agent harness plugin CLI",
   "type": "module",
   "main": "./dist/index.js",