@sushanglewis/lincoln 1.7.0 → 1.8.2

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.7.0-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.8.2-blue)](RELEASE.md)
 
-**v1.7.0** is released: SecurityAnalyzer pre-tool-use gating, Trace 2.0 event log, session friction scoring and knowledge recall, plus multi-dimensional stakeholder analysis in the clarify stage.
+**v1.8.2** is released: SecurityAnalyzer pre-tool-use gating, Trace 2.0 event log, session friction scoring and knowledge recall, plus multi-dimensional stakeholder analysis in the clarify stage.
 
 See the full release notes in [RELEASE.md](RELEASE.md).
 
@@ -94,10 +94,28 @@ This creates a `.lincoln.yaml` marker file. After that, opening Claude Code in t
 
 ### Update Lincoln
 
+Already installed? One command upgrades Lincoln and re-syncs the framework into your harnesses — `lincoln update` pulls the latest release from npm and re-runs the sync:
+
 ```bash
-lincoln update
+lincoln update            # upgrade to the latest release and re-sync
+lincoln update --check    # check for a newer version without installing
 ```
 
+On an older install (e.g. from the `lincoln-install` era), or if npm reports `EEXIST: file already exists`, a leftover bin from an old package is blocking the install — clean up first, then reinstall:
+
+```bash
+npm uninstall -g lincoln lincoln-install   # remove legacy package names (skips if absent)
+npm install -g @sushanglewis/lincoln@latest
+lincoln install --yes
+```
+
+> **Dangling-bin symptom**: the install fails with `EEXIST: file already exists` while running `lincoln` reports `command not found` — a dead symlink from an old package occupies the bin path. Verify with `ls -la "$(npm prefix -g)/bin/lincoln"` that it points to a removed package, delete it, and retry:
+>
+> ```bash
+> rm "$(npm prefix -g)/bin/lincoln"
+> npm install -g @sushanglewis/lincoln@latest && lincoln install --yes
+> ```
+
 ### Migrate from the old vendored model
 
 If your project previously committed the Lincoln framework source directly into the repo:

package/framework/README.md

@@ -12,9 +12,9 @@ Lincoln 是一个贯穿 **IDE、Agent Harness、代码托管、知识管理、
 
 ## 最新版本
 
-[![Release](https://img.shields.io/badge/release-v1.7.0-blue)](RELEASE.md)
+[![Release](https://img.shields.io/badge/release-v1.8.2-blue)](RELEASE.md)
 
-**v1.7.0** 已发布：新增 SecurityAnalyzer 安全门控、Trace 2.0 事件日志与会话摩擦学习/知识召回能力，clarify 阶段支持多维度相关者分析。
+**v1.8.2** 已发布：新增 SecurityAnalyzer 安全门控、Trace 2.0 事件日志与会话摩擦学习/知识召回能力，clarify 阶段支持多维度相关者分析。
 
 查看完整发布说明：[RELEASE.md](RELEASE.md)
 
@@ -94,10 +94,30 @@ lincoln init-project
 
 ### 更新 Lincoln
 
+已安装过 Lincoln 的用户，一条命令即可升级——`lincoln update` 会自动拉取 npm 最新版本，重新把框架同步到各 harness，并按新版本中 pin 的版本刷新外部技能库（superpowers、gsd、oh-my-claudecode 等 `~/.claude/skills/` 下的 git 仓库，以及 openspec 等 npm 管理的 CLI）：
+
+```bash
+lincoln update            # 升级本体 + 同步框架 + 刷新外部技能库到最新 pin
+lincoln update --check    # 只检查是否有新版本，不安装
+```
+
+技能库同步遵循 dependencies.yaml 的 pin 策略：本地有未提交修改的仓库会被跳过并警告（不会被强制覆盖），非 npm 管理的 CLI（如 gh）缺失时只提示安装命令。同步失败降级为警告，不会阻断升级。
+
+如果还是旧版安装（例如 bin 名是 `lincoln-install` 的时代），或更新时 npm 报 `EEXIST: file already exists`，说明有旧包残留的 bin 文件挡住了安装，先清理再重装：
+
 ```bash
-lincoln update
+npm uninstall -g lincoln lincoln-install              # 卸载旧包名（未安装会自动跳过）
+npm install -g @sushanglewis/lincoln@latest
+lincoln install --yes
 ```
 
+> **EEXIST / command not found 残留软链**：如果安装报 `EEXIST: file already exists`（bin 位置已被占用），而运行 `lincoln` 却是 `command not found`，说明 bin 位置是旧包遗留的悬空软链。用 `ls -la "$(npm prefix -g)/bin/lincoln"` 确认它指向已卸载的旧包路径，删除后重试安装：
+>
+> ```bash
+> rm "$(npm prefix -g)/bin/lincoln"
+> npm install -g @sushanglewis/lincoln@latest && lincoln install --yes
+> ```
+
 ### 从旧版 vendored 模式迁移
 
 如果你的项目之前是把 Lincoln 框架源码直接提交到仓库里的，可以用：

package/framework/RELEASE.md

@@ -1,3 +1,43 @@
+# Lincoln v1.8.2 Release Notes
+
+**Release date:** 2026-10-07
+
+## Highlights
+
+- **修复非 npm CLI 安装提示的平台命令选择** — 技能库同步在非 npm CLI（gh、ffmpeg、faster-whisper 等）缺失时，按当前运行平台（可用 `platform` 参数覆盖，便于跨平台测试）从 `dependencies.yaml` 的 `platforms` 映射中选择对应的安装提示命令。
+- **一条命令更新 Lincoln 与全部外部技能库 (#124 / LEW-73)** — `lincoln update`（以及 `lincoln install`）现在会读取新安装 payload 中的 `.claude/skills/dependencies.yaml`，把外部依赖刷新到当前 pin 的稳定版本，不再需要手动逐个仓库升级：
+  - git 类技能库（superpowers、oh-my-claudecode）：缺失时自动 clone + checkout 到 pin；本地 HEAD 落后时 `git fetch origin <pin>` 后 checkout FETCH_HEAD；pin 不在任何远端 ref 尖端时回退全量 fetch + checkout SHA。工作区有本地修改（dirty）的仓库一律跳过并警告，绝不强制覆盖。
+  - npm 管理的 CLI（openspec）：缺失或版本低于 pin 时自动 `npm install -g <pkg>@<pin>` 升级；非 npm 管理的 CLI（gh、ffmpeg、faster-whisper 等）缺失时只提示对应平台的手动安装命令，不会擅自执行 brew/apt/pip。
+  - 单个依赖的同步失败（网络故障、上游不可用等）降级为警告，不会阻断 Lincoln 本体升级；`--dry-run` 下只报告计划动作，不执行任何命令。
+- **外部依赖 pin 升级至 2026-10-07 上游版本 (#124 / LEW-73)** — superpowers → `8ca22db`（v6.4.2，快进 242 个上游提交），oh-my-claudecode → `454bae0`（v5.6.2，快进 1599 个上游提交），openspec → v1.14.1（npm 同版本发布，要求 Node.js >= 20.19.0）；gsd 与上游无漂移，保持 `bdcaab2` 不变。用户升级 Lincoln 到本版本后，一次 `lincoln update` 即把本地技能库同步到这些 pin。
+
+## Migration Notes
+
+- 无破坏性变更：框架文件、issue 工作包、阶段协议与 hooks 均保持兼容。
+- 升级后首次运行 `lincoln update` 会自动补齐或刷新技能库；若某个技能仓库有本地未提交修改，同步会跳过该仓库并给出警告，手动 commit/stash 后重跑即可。
+
+---
+
+# Lincoln v1.8.0 Release Notes
+
+**Release date:** 2026-09-21
+
+## Highlights
+
+- **PM 阶段门户产物人类可读性改造 (#123 / LEW-72)** — issue-package `index.html` 在 PM 阶段的输出全面聚焦业务说明：主阅读路径只保留需求背景、用户角色、旅程、业务状态、业务流程、页面路由/元素/交互与可交互原型。
+- **门户归档层级** — `nav-group: 归档` 的页面在 `package-data.js` 中标记 `archived: true`，portal 左侧导航将归档组折叠置于末尾（点击展开）；`调研笔记` 从头条产物清单移除。
+- **决策归档页 decisions.html** — product-design-docs 阶段新增必备产物 `pages/docs/decisions.html`，以「日期/场景/选项/决定/理由/影响/状态」表格归档澄清与设计阶段的重要沟通记录与决策；`design_docs_complete` 校验器强制其存在及 design-review 的链接，`design-review` 不再承载决策摘要章节。
+- **技术调研归入归档** — `feasibility.html` 仍为必备产物，但必须以 `--nav-group "归档"` 渲染；三个 PM 阶段 prompt 新增硬规则：技术调研/方案对比只允许进入 feasibility（归档）或 handoff 契约，禁止进入 PRD、requirements、design-review、scenarios、feature-catalog 等主路径页面。
+- **每页意图与边界纪律** — clarify-requirements、draft-product-design、build-product-prototype 三个 prompt 统一要求：每个文档页以 `## 页面意图` 与 `## 边界` 开篇，遵循标准 Markdown 结构（单一 H1、H2 分章、优先表格与 Mermaid），跨页内容禁止复制、以链接引用单一事实来源。
+- **原型按角色×场景拆分** — build-product-prototype 要求先从 scenarios/page-map 产出「角色×场景矩阵」并写入 ui-spec.html 作为拆分契约；每个可达矩阵单元对应一个原型子页面，由 main shell 组织导航；每个原型页通过 annotations 标注适用角色、场景、页面状态（默认/空/加载/错误/成功）及该状态下可见可用的功能。
+
+## Migration Notes
+
+- 无破坏性变更：既有 issue-package 的页面与门户继续工作；新规则在下次渲染或重新生成 PM 阶段产物时生效。
+- 已有 package 如希望获得归档折叠导航，重新运行 `python scripts/lincoln_index.py --state-file <process_slug>/workflow-stage.yaml` 刷新 `package-data.js` 即可。
+
+---
+
 # Lincoln v1.7.0 Release Notes
 
 **Release date:** 2026-09-05
@@ -14,7 +54,7 @@
 
 ## Migration Notes
 
-- 全局插件用户升级：`npm update -g @sushanglewis/lincoln` 后重跑 `lincoln install --yes`，把新 hooks、安全策略与技能同步到 `~/.claude/`（以及 codex/opencode 对应目录）。
+- 全局插件用户升级：直接运行 `lincoln update`（一键拉取 npm 最新版并重新同步框架到各 harness）；或手动 `npm update -g @sushanglewis/lincoln` 后重跑 `lincoln install --yes`。若旧版 bin 名残留导致安装报 `EEXIST`，先 `npm uninstall -g lincoln lincoln-install` 并删除悬空软链（详见 README「更新 Lincoln」一节）。
 - 安全门控默认生效且为人类确认制（confirm_required），不是自动阻断；策略可在项目 `.claude/policies/security.yaml` 中按需调整。
 - 无破坏性变更：现有 issue 工作包、`.lincoln.yaml` 激活方式与阶段协议均保持兼容。
 

package/framework/manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.7.0",
-  "generatedAt": "2026-09-07T14:48:46.564Z",
+  "version": "1.8.2",
+  "generatedAt": "2026-10-08T06:40:17.950Z",
   "files": [
     {
       "path": ".claude-plugin/hooks.json",
@@ -8,11 +8,11 @@
     },
     {
       "path": ".claude-plugin/marketplace.json",
-      "sha256": "5dc4fba17ae11c15bcfe85a416f2f723233cb6ccb02a6a6281476eede2aace54"
+      "sha256": "d75b0baca7dc97591d380f263bc05926822b4ff786275b0508b372acc3cb981a"
     },
     {
       "path": ".claude-plugin/plugin.json",
-      "sha256": "3db704b95c999bf6fcc48498e18b336e297aa2c047d9a37bebfe54d4d515412d"
+      "sha256": "85cc6d4828c84ac38ed0a5972b6e76a624b96092e2f0868e1928bb407307ca4d"
     },
     {
       "path": ".claude/agents/architect.md",
@@ -168,7 +168,7 @@
     },
     {
       "path": ".claude/skills/build-product-prototype/prompts/main.md",
-      "sha256": "de20a3aa5ea85747069668834d39e9a255ca8c5d7d3752264d7393e9c9185d5a"
+      "sha256": "390589f01598b749d8c85e5ecab425ea70b428cb3fe91484b91136168e0b4a82"
     },
     {
       "path": ".claude/skills/clarify-requirements/SKILL.md",
@@ -176,19 +176,19 @@
     },
     {
       "path": ".claude/skills/clarify-requirements/prompts/main.md",
-      "sha256": "57415b733f66c14529ff07754195bf0e28a7054b1f5917b69ef32bd63c3e9474"
+      "sha256": "5431aa1a268058d397d1a0acbf79d50b8c87e42ab3ae7f329e0e810e2e519f7b"
     },
     {
       "path": ".claude/skills/dependencies.yaml",
-      "sha256": "7301ed88c7ae4eb01ed7a350a9706c81b9b7153e57853aafcd9a07cdefea7e3f"
+      "sha256": "ec7c2f4d4da047009bf3e323aa9ebde13b01871372361f0caf5ab5edf33ae337"
     },
     {
       "path": ".claude/skills/draft-product-design/SKILL.md",
-      "sha256": "4fc3bd6cd45f06a3182415064b110ef4a641704a63c5640409acba401d0b2a00"
+      "sha256": "8fc7e2de16c0e82657ce253ccd0cb1b8f21dd6cb648436f5c689f4118e7b678f"
     },
     {
       "path": ".claude/skills/draft-product-design/prompts/main.md",
-      "sha256": "0ac5aac8da4a965135d36936baabb14fef852f65cc9d66da7b71de105fb1cf61"
+      "sha256": "22d3a9635ab3937206eb1bb686728e5d5135b9b1de27ca76d6976180ab97b8ab"
     },
     {
       "path": ".claude/skills/lc-analyze-frameworks/SKILL.md",
@@ -344,7 +344,7 @@
     },
     {
       "path": ".claude/skills/lc-workflow/validators/validate.py",
-      "sha256": "785120fca36af77f71ac3819a9ad7a457aa6febdf6e79d487e6d80163bca5aa6"
+      "sha256": "2ef99c40e29de06761005ac58f9e47a32955a104a18987d4b8059507f179bdbf"
     },
     {
       "path": ".claude/skills/plan-tdd-development/SKILL.md",
@@ -472,7 +472,7 @@
     },
     {
       "path": ".claude/stages/product-design-docs.yaml",
-      "sha256": "10d59c8d14e1f930c550ee7caa57eb636cfd162c040d406f980f173c17738e31"
+      "sha256": "04829200479439864b95cd5ce34d86035a557e699d8a441ae09b55c1e89e7ddb"
     },
     {
       "path": ".claude/stages/product-prototype.yaml",
@@ -508,15 +508,15 @@
     },
     {
       "path": ".claude/workflows/bug-fix.yaml",
-      "sha256": "4988af45c32098a5d129bff29e27b3bd6c567f133916d58f05d09f6a50d1d431"
+      "sha256": "10ec84aefe852f9b36d5694cf1139107877df1cec7bf906c7b1f5e5174b0d2e4"
     },
     {
       "path": ".claude/workflows/design-spike.yaml",
-      "sha256": "55b90ad567755e2eb84c976a21a90eeb7a0905b7be838910ebb5a55bee975ed1"
+      "sha256": "bf19482918ee0356db06b606afccbd4fbe0289db1eeedc5ab81cf81a6b23ad04"
     },
     {
       "path": ".claude/workflows/existing-project-iteration.yaml",
-      "sha256": "027a27a493e1458549aaa66e2d8a139a86fe87d378f51b260f76a0ff7d159fea"
+      "sha256": "10d52c8e005a2ba98297fa6b961a54b2755d3e470b2feff765de7fa32e509830"
     },
     {
       "path": ".claude/workflows/framework-self-improvement.yaml",
@@ -524,11 +524,11 @@
     },
     {
       "path": ".claude/workflows/interview-to-knowledge.yaml",
-      "sha256": "d0aeb1f6f6ef09d86bbcd16d3e2945edfcaa590824bb3118bb999196ad37ef0e"
+      "sha256": "ba7178a7459025e9fa003cc9b0f3318ec0dc7f0b0bda89114d69723028398d47"
     },
     {
       "path": ".claude/workflows/oss-first-design.yaml",
-      "sha256": "8dfb9010196dcf569539e1ec4f89d3ae7e437f1a8eb45791d2f47802dce715e2"
+      "sha256": "0ec0dcc91a5545acd1e50afe54f6935d7008ec70dfd33648a689fd3ac006d4c1"
     },
     {
       "path": ".claude/workflows/pm-research.yaml",
@@ -536,7 +536,7 @@
     },
     {
       "path": ".version-bump.json",
-      "sha256": "a338d715d3c7d9cdee6740069fecc67bbda35f867b306dfe40b957eb99e8f100"
+      "sha256": "979ac3fdc2994408a873fb1ac7b942163c1b19c344f08b60469fb331e5d3d85a"
     },
     {
       "path": "CLAUDE.md",
@@ -552,15 +552,15 @@
     },
     {
       "path": "README.en.md",
-      "sha256": "5edfd7c89ebbf3a79bb5dffb142fd678f84fc3a534359c1ca0d48e68cab9a2bb"
+      "sha256": "88b4d0e3161b12b90290bdc92811f535d2c607bb94d79147412020c55d270477"
     },
     {
       "path": "README.md",
-      "sha256": "6271d86b4126d76177aefec1a8bb257d23f493505e7bffa04ca76266f2a92fe1"
+      "sha256": "7bb00a07982f4d0b5046e41b197db9609ae440d2b808ce27650b4a91ba3bb22a"
     },
     {
       "path": "RELEASE.md",
-      "sha256": "ca6640f4611391065b799f253dfddad939ff734689270e54f2e86d7b7fd2e0b7"
+      "sha256": "45edad15cbaee8ba16e889d16239eea83a4c8118839fe9d0bbe709f105de504c"
     },
     {
       "path": "SKILL.md",
@@ -680,7 +680,7 @@
     },
     {
       "path": "scripts/lincoln_index.py",
-      "sha256": "5119c6f5211f5facfb9f66f61b07728a2b30c3b7596f2db3e5de8a97fb5ec84d"
+      "sha256": "8b237e80673dd96e6aa6fba6cf65f6c9bb4e09777ef17ed7bf1eaa2dce0c10ff"
     },
     {
       "path": "scripts/lincoln_mr_mine.py",
@@ -784,7 +784,7 @@
     },
     {
       "path": "tools/lincoln-installer/package.json",
-      "sha256": "a9cec32af90103609521e37484a847d14ebd2b2d096062349a398b4b9a84bc11"
+      "sha256": "ff14d4cc2cc7c6a661482b0cc9e6fc40492f9e5b930c3370917ecc1944f3fdc6"
     },
     {
       "path": "tools/lincoln-installer/src/cli.tsx",
@@ -1068,11 +1068,11 @@
     },
     {
       "path": "tools/lincoln/package-lock.json",
-      "sha256": "39391a584993f28f83082ed36f141bd2f4b4807f54d6872421b21c6017917fc4"
+      "sha256": "08dc3bac6e6902190e5d670a62fd937aa4ac5911bccd0231d983f4cafd81a189"
     },
     {
       "path": "tools/lincoln/package.json",
-      "sha256": "a881553482f59d9c2767828cca1b2ad2b81c4efd987a3c86b14664ee4cf5b442"
+      "sha256": "63be991c34f907564f53df7a75e845a9153f4285f966b1c12a5cad8335674b0c"
     },
     {
       "path": "tools/lincoln/src/cli.tsx",

package/framework/scripts/lincoln_index.py

@@ -26,6 +26,7 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
 from scripts.lincoln_paths import STATE_FILENAME, is_process_state_path
 
 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")
@@ -183,11 +184,13 @@ def build_package_data(
         if not entry.get("uid"):
             meta_warnings.append(f"{rel}: missing <meta name=\"doc-uid\"> or <meta name=\"page-uid\">")
         group_name = entry.get("group") or entry.get("nav_group") or "Docs"
+        archived = group_name == ARCHIVE_NAV_GROUP
         groups.setdefault(group_name, []).append(
             {
                 "path": rel,
                 "label": entry.get("nav_label") or entry.get("label") or entry.get("title") or Path(rel).stem,
                 "title": entry.get("title") or Path(rel).stem,
+                "archived": archived,
                 "version": entry.get("version"),
                 "status": entry.get("status", ""),
                 "stage": entry.get("stage", ""),
@@ -210,7 +213,11 @@ def build_package_data(
         for warning in meta_warnings:
             print(f"  - {warning}", file=sys.stderr)
 
-    nav = [{"group": g, "items": items} for g, items in groups.items()]
+    # Archive groups render last and collapsed in the portal.
+    nav = (
+        [{"group": g, "items": items} for g, items in groups.items() if g != ARCHIVE_NAV_GROUP]
+        + [{"group": g, "items": items} for g, items in groups.items() if g == ARCHIVE_NAV_GROUP]
+    )
 
     return {
         "process_slug": process_slug,

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

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

package/framework/tools/lincoln/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sushanglewis/lincoln-recorder",
-  "version": "1.7.0",
+  "version": "1.8.2",
   "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.7.0",
+  "version": "1.8.2",
   "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.7.0",
+  "version": "1.8.2",
   "description": "Global Lincoln agent harness plugin CLI",
   "type": "module",
   "main": "./dist/index.js",