Merge PR #112: 藏書地圖看得到自己的知識——租戶字串改從寫入端來(Arcrun#108)

總管複驗(不聽自述,自己重跑並與 base 逐條比對):
  cypher  14 failed / 441 passed(base 14 / 400)⇒ 多 41 條新測試全過
          失敗清單 diff 無輸出=逐字元相同、零回歸
  閘實測  照 #105/#108 的原句形狀種一個違規(env.CONSOLE_TENANT || leo)
          → 掃描器當場抓到並指名道姓;移除後恢復綠 ⇒ 不是假綠

這道閘的價值超過本票:它擋的是「身分來自環境變數」整族,
#105 那句話今天再寫一次也會被擋。符合 leo 08-12 立的
「做平台要減少 hotfix」——修掉 bug 不算完成,要留下下次再犯會被擋住的機制。

agent 誠實標的殘項(不擋併):
  · kbdb_get_map 回 1851、Portal 總圖畫面、部分授權帳號實測——都要部署 leo21c,紅線沒碰
  · 想把閘也接進 .claude/hooks/pre-write-guard.sh(寫入前就擋),該檔受保護改不動;
    檢查器已備妥 --stdin 模式,總管代接
This commit was merged in pull request #112.
This commit is contained in:
Leo
2026-08-12 16:24:45 +00:00
25 changed files with 1513 additions and 201 deletions
+31
View File
@@ -142,6 +142,37 @@ SDD 屬於架構決策,必須人確認。CC 不可以自行在 `docs/3-specs/`
---
---
## 第六類:租戶字串來源(Arcrun#108#105 同族)
### 6.1 靜態租戶字串不得用於資料面過濾
**知識資料面的 `owner_id`(三元組/entriesrecords/藏書地圖/工作流 KV)必須與寫入端同源。**
寫入端只有一個真相源=使用者 `~/.arcrun/config.yaml``api_key`(=實例 namespace
CLI push/小幫手上傳/MCP 都用它)。讀取端拿另一份手抄的環境變數預設值 → 全被過濾掉。
實害:`portalTenant(env) = env.CONSOLE_TENANT || "leo"` 讓 leo 的 **1854 條三元組被過濾成 0 個庫**
#108);前一天 `ownerNamespace(env) = env.MCP_OWNER_NAMESPACE || "leo"` 是同一句話(#105)。
**規則**
1. `cypher-executor/src/lib/tenant.ts` 是租戶字串的**唯一產地**。
`CONSOLE_TENANT` / `ARCRUN_NAMESPACE` 只能在該檔被讀取。
2. 知識資料面用 `knowledgeOwner(env)`(回 `TenantId`),過濾一律經
`ownerQuery()` / `ownerField()`——它們只吃 `TenantId``tsc` 就擋掉「隨手一個 string」。
3. 帳號層用 `accountTenant(env)`(回 `string`**刻意不是 TenantId**):帳號子 namespace
`{tenant}::portal` 與 cypher 自己寫的設定用它,型別上不可能流進知識資料面。
4. 身分解析路徑上**不准有字面預設值**。解析不到 → 丟 `TenantUnresolvedError`
誠實回「讀不到」(不是「你沒有」,#100 同一條)。
**機械強制**(規則存在但沒機制驗證=它會再犯第三次):
- 出貨閘:`scripts/build-worker-artifacts.mjs` 編 tier2 成品前先掃,違規 → **編不出成品**
- 本機自查:`cd cypher-executor && npm run check:tenant``npm test` 也會先跑它)。
- 規則本體:`cypher-executor/scripts/tenant-source-rules.mjs`(純函式);
閘自己的測試:`cypher-executor/tests/tenant-gate.test.ts`(壞例子會擋+合法寫法零誤攔)。
> 尚未接上 PreToolUse hook`.claude/hooks/` 為受保護檔案,需人類加入)。
> 要加的話:檢查器已備妥 `--stdin <相對路徑>` 模式,可在寫入前擋。
## Hook Block 訊息格式
當 hook 擋住一個操作時,訊息格式統一為: