@sanqianx/project-knowledge 5.0.24 → 5.0.26

package/templates/project-readme.md

@@ -1,52 +1,52 @@
-# __PROJECT__ Knowledge Base
-
-Schema: minimal-kb/v1
-Created: __DATE__
-
-This knowledge base stores only useful, reviewed project memory. It is not a dump of every prompt, file, or intermediate AI artifact.
-
-## Final Layout
-
-| Path | Purpose | Policy |
-|---|---|---|
-| `README.md` | Knowledge-base purpose and reading guidance | Updated only through verified promotion |
-| `GOAL.md` | Stable project goal, boundaries, and non-goals | Updated conservatively from committed evidence |
-| `ARCHITECTURE.md` | Current architecture and key decisions | Updated conservatively from committed evidence |
-| `modules/<module>.md` | Durable module facts tied to source paths, routes, symbols, and tests | Verified promotion only |
-| `changes/<change>.md` | Accepted change memory with intent, result, and evidence | Verified promotion only |
-
-AI run records, per-commit automation state, backups, and context packs live outside the knowledge base.
-
-## Design Principles
-
-1. Keep the official KB small: store stable intent, architecture, module facts, and accepted change summaries.
-2. Search first: use the read-only knowledge tools before opening detail files.
-3. Read only relevant memory: choose module and change files by source paths, routes, symbols, and affected modules.
-4. Store development intent, not raw prompts: summarize the user's request in `changes/<change>.md` under `## Development Intent`.
-5. Update `GOAL.md` and `ARCHITECTURE.md` only when committed evidence clearly changes their current facts.
-
-## Reading Rule
-
-When starting work on a feature or fix:
-
-1. Resolve the current project and search its scoped knowledge.
-2. Read `GOAL.md` when the task depends on product boundaries.
-3. Open only relevant `modules/<module>.md` and `changes/<change>.md` files.
-4. Verify retrieved facts against current source code.
-5. Let post-commit reconciliation update knowledge from committed evidence; do not write the final KB directly.
-
-## Change File Example
-
-```md
-## Development Intent
-Add a branch-aware knowledge update flow so AI records the user's feature intent without storing raw prompts.
-
-## Implementation Result
-- Added a frozen per-commit claim and exact Commit evidence.
-- Promoted validated Markdown before advancing state.
-
-## Evidence
-- `_site/lib/commit-reconciler.js`
-- `_site/lib/knowledge-promotion.js`
-- `_site/lib/index-service.js`
-```
+# __PROJECT__ Knowledge Base
+
+Schema: minimal-kb/v1
+Created: __DATE__
+
+This knowledge base stores only useful, reviewed project memory. It is not a dump of every prompt, file, or intermediate AI artifact.
+
+## Final Layout
+
+| Path | Purpose | Policy |
+|---|---|---|
+| `README.md` | Knowledge-base purpose and reading guidance | Updated only through verified promotion |
+| `GOAL.md` | Stable project goal, boundaries, and non-goals | Updated conservatively from committed evidence |
+| `ARCHITECTURE.md` | Current architecture and key decisions | Updated conservatively from committed evidence |
+| `modules/<module>.md` | Durable module facts tied to source paths, routes, symbols, and tests | Verified promotion only |
+| `changes/<change>.md` | Accepted change memory with intent, result, and evidence | Verified promotion only |
+
+AI run records, per-commit automation state, backups, and context packs live outside the knowledge base.
+
+## Design Principles
+
+1. Keep the official KB small: store stable intent, architecture, module facts, and accepted change summaries.
+2. Search first: use the read-only knowledge tools before opening detail files.
+3. Read only relevant memory: choose module and change files by source paths, routes, symbols, and affected modules.
+4. Store development intent, not raw prompts: summarize the user's request in `changes/<change>.md` under `## Development Intent`.
+5. Update `GOAL.md` and `ARCHITECTURE.md` only when committed evidence clearly changes their current facts.
+
+## Reading Rule
+
+When starting work on a feature or fix:
+
+1. Resolve the current project and search its scoped knowledge.
+2. Read `GOAL.md` when the task depends on product boundaries.
+3. Open only relevant `modules/<module>.md` and `changes/<change>.md` files.
+4. Verify retrieved facts against current source code.
+5. Let post-commit reconciliation update knowledge from committed evidence; do not write the final KB directly.
+
+## Change File Example
+
+```md
+## Development Intent
+Add a branch-aware knowledge update flow so AI records the user's feature intent without storing raw prompts.
+
+## Implementation Result
+- Added a frozen per-commit claim and exact Commit evidence.
+- Promoted validated Markdown before advancing state.
+
+## Evidence
+- `_site/lib/commit-reconciler.js`
+- `_site/lib/knowledge-promotion.js`
+- `_site/lib/index-service.js`
+```

package/ui/index.html

@@ -2,12 +2,12 @@
 <html lang="zh-CN" data-theme="light">
 <head>
   <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="light dark">
-  <title>Project Knowledge · 我的智脑</title><link rel="icon" type="image/svg+xml" href="/favicon.svg?v=folded-k-1"><link rel="stylesheet" href="/product.css">
+  <title>Project Knowledge · 我的智脑</title><link rel="icon" type="image/svg+xml" href="/favicon.svg?v=folded-k-1"><link rel="stylesheet" href="/product.css"><link rel="stylesheet" href="/version-info.css">
 </head>
 <body>
 <div class="app">
   <aside class="sidebar">
-    <div class="brand"><img class="brand-mark" src="/favicon.svg?v=folded-k-1" width="32" height="32" alt=""><div><strong>Project Knowledge</strong><small>个人工程智脑</small></div></div>
+    <div class="brand"><img class="brand-mark" src="/favicon.svg?v=folded-k-1" width="32" height="32" alt=""><div><strong>Project Knowledge</strong><small>个人工程智脑</small></div><span class="brand-version" id="brandVersion" tabindex="0" role="note" aria-label="知识库版本">知识库 版本读取中…</span></div>
     <div id="brainLabel" class="brain-label">我的智脑</div>
     <nav aria-label="主要导航">
       <button data-view="home"><svg viewBox="0 0 24 24"><path d="m3 11 9-7 9 7M5 10v10h14V10"/></svg>智脑首页</button>
@@ -64,4 +64,5 @@
 <div id="toast" class="toast" role="status" aria-live="polite" hidden></div>
 <script src="/live-client.js"></script>
 <script src="/product.js"></script>
+<script src="/version-info.js"></script>
 </body></html>

package/ui/version-info.css

@@ -0,0 +1,44 @@
+/* 版本与模块（R2 简化版）——左上角商标悬停版本提示。只含 brand-version
+   前缀规则；主题色继承 product.css 变量（浅色默认 + 深色覆盖）。
+   默认 opacity:0 隐藏且不占布局空间——刻意不用 visibility:hidden，那会把
+   元素从 Tab 焦点序剔除，键盘 focus 查看将永远失效；.brand 悬停或自身
+   聚焦时展示；无轮询。 */
+
+.brand{position:relative}
+
+.brand-version{
+  position:absolute;
+  left:20px;
+  top:calc(100% - 6px);
+  z-index:30;
+  padding:4px 10px;
+  border:1px solid var(--line);
+  border-radius:6px;
+  background:var(--surface);
+  color:var(--muted);
+  font-size:11px;
+  line-height:1.5;
+  white-space:nowrap;
+  box-shadow:0 4px 14px rgba(0,0,0,.18);
+  opacity:0;
+  transform:translateY(-2px);
+  transition:opacity .12s ease, transform .12s ease;
+  pointer-events:none;
+}
+
+.brand:hover .brand-version,
+.brand-version:focus,
+.brand-version:focus-visible{
+  opacity:1;
+  transform:translateY(0);
+}
+
+.brand-version:focus{
+  pointer-events:auto;
+  outline:2px solid var(--accent);
+  outline-offset:2px;
+}
+
+@media (prefers-reduced-motion: reduce){
+  .brand-version{transition:none;transform:none}
+}

package/ui/version-info.js

@@ -0,0 +1,24 @@
+'use strict';
+/* 版本与模块（R2 简化版）——左上角商标悬停版本提示的取数脚本。
+ *
+ * 一次性读取 GET /api/system/version（当前 Project Knowledge 服务进程的
+ * package 版本），填入 #brandVersion 显示「知识库 vX.Y.Z」。失败时诚实显示
+ * 「知识库 版本未知」；不重试、不轮询、不阻塞页面其他部分，也不做任何
+ * 模块聚合/桌面版本猜测。展示/隐藏完全由 version-info.css 的 hover/focus
+ * 规则承担。 */
+(function () {
+  const label = document.getElementById('brandVersion');
+  if (!label) return;
+  fetch('/api/system/version', { headers: { Accept: 'application/json' } })
+    .then(response => {
+      if (!response.ok) throw new Error(`HTTP ${response.status}`);
+      return response.json();
+    })
+    .then(payload => {
+      const version = payload && payload.core && payload.core.version;
+      label.textContent = version ? `知识库 v${version}` : '知识库 版本未知';
+    })
+    .catch(() => {
+      label.textContent = '知识库 版本未知';
+    });
+})();

package/vendor-manifest.json

@@ -1,55 +1,55 @@
-{
-  "schema": "project-knowledge/vendor-runtime/v1",
-  "modules": {
-    "knowledge-engine": {
-      "name": "@sanqianx/ai-coding-knowledge-engine",
-      "version": "0.2.7-rc.10",
-      "root": "_modules/knowledge-engine",
-      "files": {
-        "README.md": "27236264aa40ca3abd12a82d779120410d09507c0b0ad8d3f16896a03ae363ee",
-        "package.json": "2e24f8fc1ac3269bdcbd9b7179edf3eff31758545e970c689ab5ae3cb1c49c41",
-        "src/analysis-contract.js": "6d4b9fde0e05d9a80d43e96d0c27febf082ecdb19312faf0280d6c9b16ac71b1",
-        "src/analysis-failures.js": "eb1e5a476b1e3e3c87dfd9955707c85151707799883595bcb5e9cc3e26a991c4",
-        "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
-        "src/analysis-worker.js": "a0bae40784c690ac68a174cb6d98fbb21dbdb69becfd27eee316ba17de544de9",
-        "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
-        "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
-        "src/context.js": "edd9d4942f6039dd4aaadec88533042ae130f1b80d935d87f61b071904a6688c",
-        "src/coordinator.js": "6ced0a3b6314a72f40e9fd9b285916d15554130f02ba04faafb52b0f2b3a8fd2",
-        "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
-        "src/headless-analyzer.js": "df570864136981cf98f3f69d047fa5729fbbfdeeaee0c6bfad26dab941dbbdae",
-        "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
-        "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
-        "src/memories.js": "7ad6701033c9a98a0d918b9745c012f9e90b8de6db6e1d870e2ebf77000a1aac",
-        "src/memory-eligibility.js": "48af31f23f81140dbc706ff83a39ba9f411314d87d01e5accfaf419c7a74e0ea",
-        "src/retrieval-policy.json": "3205fb4eb114a839a74f902e6fae6a61e1460958e5a9d7e29add32b60ba4e05a",
-        "src/retrieval-ranking.js": "061b64f5bffec3269851830b30ab51abc3260274e5207ea4864ae33d9cb22809",
-        "src/retrieval.js": "32f17494eb838cc6b209df35dbe33a155c1728420c9e501a4974c4f2a1b33ceb",
-        "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
-        "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
-        "src/runtime/automation-config.js": "6498c5397be12b155829740595a1553d4dcd6eaa7db6ced3ef88fdc60218f00e",
-        "src/runtime/commit-conversation-binder.js": "1b3539d9218cfb9867feec3c60b5632403b73433698fc96c61418a84fe83625a",
-        "src/runtime/commit-processing-ledger.js": "455aa1ac4e212c0b63d9df99e49aa94703cd24145e41aa9794f16274b2ec2e18",
-        "src/runtime/commit-prompt.js": "db7b6942fc1a1a561c88b901075ccc2015e5cb4c2c3c673d62ac329459968494",
-        "src/runtime/commit-reconciler.js": "41d0bafe43692cf37ac4e9c4b81a8bcfd828ca849cbe20d9fede237b6d001c69",
-        "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
-        "src/runtime/contracts.js": "1088fd8bb36a5dc32a52496d54a6c7c5255c53ca5ff1fe90e42cfeb276e99044",
-        "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
-        "src/runtime/conversation-store.js": "9bdfab167e2803d14cc16e66bf253e13d67d2f85d567faec8a8b08fd9f9aafd0",
-        "src/runtime/evidence-bundle.js": "33d4614849d5e1d69aba8b75c3a43c18b7b6f94e5c78654c82ef631331cc94cc",
-        "src/runtime/git-runner.js": "b74fe197bd4dcf3e70635ef7b1f2615edf965c1d9a3ffe5406aabd41b76d74a9",
-        "src/runtime/knowledge-promotion.js": "62fbd8282f83d666f0cae9c39c97a9a9b0175473356a0da0aa3805c757b0a9c1",
-        "src/runtime/knowledge-retrieval-service.js": "161917638f518d9436024c7a0960a5b38619e397af91099c01a0232bbd6b6a43",
-        "src/runtime/layout.js": "e47fe54c605218493ce46f6289798d9db2a3ecec95089d288ed03d3b75cf871a",
-        "src/runtime/markdown-knowledge-indexer.js": "f771afcc1a08bf0c6456d6756c8e04885fac15bc700a86ab0114853ac662727e",
-        "src/runtime/scanner.js": "d99fa8d74a6fbbaae75ca49f62127e14cf9e48b1404e4b4d597ef39df5441410",
-        "src/server.js": "4bb07e1538c70ee53f2238be29f8452f11c2ddf87725c4e063d7999765a8082c",
-        "src/store.js": "8fe9c415c845feefab3e2129b5850686747a880c827189026e3eb6295b158c0a",
-        "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
-        "ui/app.js": "33a2ba38f0dafbbb2e30a1eb3fc93476bfcaf528e124e1a9b2edd2fb69221e9e",
-        "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
-      },
-      "sourceCommit": "85c618f4f0bc94c67e16a544c9f20d5c796cfa15"
-    }
-  }
-}
+{
+  "schema": "project-knowledge/vendor-runtime/v1",
+  "modules": {
+    "knowledge-engine": {
+      "name": "@sanqianx/ai-coding-knowledge-engine",
+      "version": "0.2.7-rc.11",
+      "root": "_modules/knowledge-engine",
+      "files": {
+        "README.md": "27236264aa40ca3abd12a82d779120410d09507c0b0ad8d3f16896a03ae363ee",
+        "package.json": "ad46440e59ee83f43e23a985418f9b94e1f5bc91ec93c589eb22bf39e4c3201d",
+        "src/analysis-contract.js": "6d4b9fde0e05d9a80d43e96d0c27febf082ecdb19312faf0280d6c9b16ac71b1",
+        "src/analysis-failures.js": "eb1e5a476b1e3e3c87dfd9955707c85151707799883595bcb5e9cc3e26a991c4",
+        "src/analysis-output.js": "95a3c19dcc9ab85d1dba7fee5b9aec80f9c000dfba89da3fd0be25a81e2fb680",
+        "src/analysis-worker.js": "a0bae40784c690ac68a174cb6d98fbb21dbdb69becfd27eee316ba17de544de9",
+        "src/bin.js": "22208907431d0f3a971a669c7e5eb44b3b7af9bbb36fd7ba17c3b90c4288bd70",
+        "src/bridge-client.js": "ae0dba21e4286694bcd9e064ca36564ec997969ae1eb1ce4f8a6665e447cbffe",
+        "src/context.js": "edd9d4942f6039dd4aaadec88533042ae130f1b80d935d87f61b071904a6688c",
+        "src/coordinator.js": "fb0ef2fe2cdc35c0a99e3095c6abc94c6cf7c0b9c722c16a1c1a46b6efce6b83",
+        "src/diagnostics.js": "f7b516ace61a1e9faaa6876930b9e2e258499a25857d1203f4e53d28bfd0fa1a",
+        "src/headless-analyzer.js": "df570864136981cf98f3f69d047fa5729fbbfdeeaee0c6bfad26dab941dbbdae",
+        "src/index-request.js": "78f26b872299005499fff4f2d1f9e8f986784f2ff36a5cf2be2b1e7b7c7d9378",
+        "src/knowledge-targets.js": "aa44ec285d16d7b1c0b63bf084058a1d6f867fa9929c753b6b0cbb24f7b20ee2",
+        "src/memories.js": "7ad6701033c9a98a0d918b9745c012f9e90b8de6db6e1d870e2ebf77000a1aac",
+        "src/memory-eligibility.js": "48af31f23f81140dbc706ff83a39ba9f411314d87d01e5accfaf419c7a74e0ea",
+        "src/retrieval-policy.json": "3205fb4eb114a839a74f902e6fae6a61e1460958e5a9d7e29add32b60ba4e05a",
+        "src/retrieval-ranking.js": "061b64f5bffec3269851830b30ab51abc3260274e5207ea4864ae33d9cb22809",
+        "src/retrieval.js": "32f17494eb838cc6b209df35dbe33a155c1728420c9e501a4974c4f2a1b33ceb",
+        "src/runtime/README.md": "9be676eca76a7857b34d7357194e6f0ee733c22e61d962d53984715dbec7f673",
+        "src/runtime/atomic-file.js": "9846b4b69db5ded811acf19a1181ef93615d93efaa542b858e552a7f3124ad23",
+        "src/runtime/automation-config.js": "2794aea67e3604db9b69dcaef6d303d0b5163b7e998a9730b93797f306c679cc",
+        "src/runtime/commit-conversation-binder.js": "5dd4b65d153918ecf491acf68db81dfbdd78156fc5a2a4f9b962b4dcfdd50135",
+        "src/runtime/commit-processing-ledger.js": "82cf7e15df123e2e9ea28129d9ab91d075c119923ad78f828f211f4cffbced5a",
+        "src/runtime/commit-prompt.js": "3382cfa8f3476dfb5255ffae2189f91b03e8c795103f1ae7af04d92deaa90f8d",
+        "src/runtime/commit-reconciler.js": "64ede337ce3734560df0425c539f084fe58a6ec073c227c34f83c69c414c191e",
+        "src/runtime/content-hash.js": "201ee7dcc054310f14097a00058cf9b28fa913367eef616e0fdd8facbf3c6c41",
+        "src/runtime/contracts.js": "68cff2d6007330ad11637f717c368ed67cefd5ee9532e5ea8f27ded3b93e0301",
+        "src/runtime/conversation-exclusions.js": "ef8545034b862d384fb460140490bb531b58d94992f5e2222ebaaa079b44fa63",
+        "src/runtime/conversation-store.js": "4c91f16cef516556e381ee4369d67165b00833214b7675012340cbc1637ec8d7",
+        "src/runtime/evidence-bundle.js": "d8e74774c2860a869f62e8adbe54d1c80818ea3da09436eff94037536ba559bf",
+        "src/runtime/git-runner.js": "8d4b784e33f05733e0236d0c39f573d07ec7b44e093d022e0fbc05305cdaab7b",
+        "src/runtime/knowledge-promotion.js": "c1d29e8eca3708f8841f1a697e8bb51ed7a977f4fea649b8ae98be2d7195c06e",
+        "src/runtime/knowledge-retrieval-service.js": "a4dcd09d34185f196814ff37821666e43ed0839126eab63b234bd53c4513ef1a",
+        "src/runtime/layout.js": "e47fe54c605218493ce46f6289798d9db2a3ecec95089d288ed03d3b75cf871a",
+        "src/runtime/markdown-knowledge-indexer.js": "ac094e947e52cbaeb781c0e1a9437b52b4e46bda9ae92fdd5c626ee13eb0b8be",
+        "src/runtime/scanner.js": "2b5443a1b782b4b73458de907a06a34e6bb6bfa9ba45d20c443ef8272ada97e6",
+        "src/server.js": "4bb07e1538c70ee53f2238be29f8452f11c2ddf87725c4e063d7999765a8082c",
+        "src/store.js": "8fe9c415c845feefab3e2129b5850686747a880c827189026e3eb6295b158c0a",
+        "ui/app.css": "7ad370c269e60a7b5ec907d81a607b2d16bd07b2d7c22a81f102dab51eeb2889",
+        "ui/app.js": "e9ecb0125d5f2a8bb30a58c4d278fe0737ee2540ecfb065f97f453495cfc792d",
+        "ui/index.html": "ce3565cfefd4838b11d37a91a906ef26ca5a1834844fe3f7c897b56851a3c418"
+      },
+      "sourceCommit": "28475eb83f794d6fa578577b4f6e80114d40a85c"
+    }
+  }
+}