Repository navigation
Closed
Description
Problem
Original text(maintainer,2026-11-09):
「CLI也要有根safari-brwoser一樣的更新機制吧」
akashic CLI 在本機沒有任何「是不是過期了」的提示。#768 合併後,SKILL 要求 fulltext contract 8,本機的 CLI 卻還是 10 月底建的、只印 6。這件事是在準備跑全文批次、主動去問另一個 session 時才發現的:開 session 時沒有任何訊息,fetch 也還沒跑到。若沒有人問,第一個訊號會是 SKILL 第 0 步拒絕執行,或者更糟,用舊 CLI 跑了。
safari-browser 已有這個機制(plugin 的 SessionStart hook hooks/check-cli.sh):
- binary 的
--version印出它建置時的git describe - hook 把它和本機原始碼 checkout 的歷史比,落後就印出「落後 N 個 commit」和安裝指令
- 不連網、不自動覆蓋已能用的 binary;squash merge、checkout 落後、在別處建置這些情況都有處理(改比檔案時間)
Type
feature
Expected
akashic --version(或同等子命令)印出建置時的 commit(git describe),舊版 CLI 不支援時 hook 要能分辨。- akashic-mcp plugin 加一個 SessionStart hook,比照 safari-browser 的
check-cli.sh:- 找不到 CLI:印安裝指令
- CLI 比原始碼落後:印「落後 N 個 commit」與重建指令(
swift build -c release --product akashic,再放到原本的位置) - CLI 印出的
fulltext contract比 plugin 內 SKILL 要求的小:明確說出兩個數字 - 不連網、不自動安裝
- 原始碼 checkout 的位置可設定;沒有 checkout 時只做第 3 點的契約比對。
Actual
本機 CLI 落後時沒有任何提示;契約版本要靠 SKILL 第 0 步或人主動檢查才看得到。
Related
- [feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633:CLI 沒有發布管道(給其他使用者)。本 issue 只處理本機的過期提示,不取代 [feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633;[feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633 若改成 release 下載,這個 hook 的比對基準可以跟著換成 release 版本。
- fulltext fetch can close the user's own tab: ownTab comes from the current tab #768:要求 contract 8 的那次變更
Current Status
Phase: closed
Last updated: 2026-11-12 by idd-close
Dashboard: #775 (comment)
Key Decisions
- 戳記照 safari-browser:建置期間改寫受追蹤佔位檔、建完還原;版本字串是裸
<hash>[-dirty](排除所有 tag) - 落後的基準
origin/main,沒有才用HEAD;編譯輸入取整個Sources等,接受過報 - 修改
swift-is-the-implementation-language例外 1,收 hook 與戳記腳本(hook 為具名例外) - 契約數字只留在 SKILL 第 0 步,hook 抽出;測試釘在 CLI 的契約常數
- verify r1(PR feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775) #783)FAIL:3 blocking(比不出祖先關係時安靜漏報、git 呼叫沒有中和設定與環境、並行戳記留下戳記值)+10 項 in-scope fix
- verify finding 4(輸出是否畫面可見)照預設:維持純文字 stdout(與 safari-browser 相同,使用者要求的比照對象),重建提示改成「告訴使用者、由使用者決定」;畫面可見(
systemMessage)列為可選,使用者要再改 - verify r2 FAIL:3 blocking(squash 之後被 revert 的漏報、
core.fsmonitor被執行、檢查與備份之間寫入的戳記)+13 項一併修;修正輪把落後判定改成「看基準上每個不在建置歷史裡的 commit 動過什麼」 - verify r3 FAIL:r2 的 3 個 blocking 都已關上、落後判定找不到新的漏報;但有 2 個 MEDIUM 落在 r2 修正輪新寫的程式上(探測用的
/bin/sh -p在 dash 上失敗;分岔時算交集的成本沒有上限)。照 r2 報告的預告停損:不再自行加新機制,處置先問使用者 - 使用者 2026-11-10 23:06 裁決 M2 選項 1:分岔比對成本寫成界線、另開 check-cli.sh:分岔時比對兩份 commit 清單的成本沒有上限,歷史夠長會撞上 hook 的 30 秒上限 (follow-up finding from #775) #793,不在這個 PR 加機制
- verify r4(停損輪)PASS:四席都沒有 MEDIUM 以上;找到的新寫句子不成立處已照改字(
12b04e72),其中 M2 的成本數字改成 hook 實際條件(C locale)下的量測,約是原數字的四分之一 - 使用者 2026-11-11 選擇讓 取全文 #777 拆出:兩件待裁寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 #779 先上 main;取全文 #777 拆出:兩件待裁寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 #779(PR docs: 取全文的待裁事項寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 (#779) #787)合併後,本 PR 併入 main 並把版號讓到 0.13.15
Scope Changes
- 版號 0.13.15:0.13.13 由 feat: 取得全文——Find Full Text 缺口的 plugin skill(akashic-fetch-fulltext) #613 b49 先發布(b49 同時把契約升到 9),0.13.14 由 取全文 #777 拆出:兩件待裁寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 #779(PR docs: 取全文的待裁事項寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 (#779) #787)先發布
- 動到
WriteGateRulingsTests(排除--version)與GitSpawnHygieneTests(登記新測試檔)
Blocking
- 無(PR feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775) #783 已於 2026-11-12 經使用者確認 squash 合併;issue 已結案,見 Closing Summary)
Commits
- branch
idd/775-cli-stale-check:22 個 commit 都已推送(283e640d…6a112fc2;前 11 個使用者 2026-11-10 14:15 確認,其後 10 個 2026-11-11 05:11、merge commit6a112fc22026-11-11 20:43 依〈推到非預設分支不用問〉推送;6a112fc2的 pre-push:7 個 bundle 5,640 支、0 失敗、1 略過,守衛無缺口);PR feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775) #783 - main:
8fc7fc0b(squash merge,2026-11-12);結案摘要 akashic CLI 過期時沒有提示:比照 safari-browser 加 SessionStart 檢查 #775 (comment) - follow-up:殼層檔的 $名字 緊接全形字元沒有守衛:UTF-8 locale 下變數名被吃掉 (follow-up finding from #775) #778、CI 不跑 akashic-mcp plugin hook 的測試:只改 plugin/** 的 push 沒有 CI 證據 (follow-up finding from #775) #784、official-validate 守衛只驗 marketplace 根,看不到 plugin 層的 hooks.json 警告 (follow-up finding from #775) #785、SessionStart hook 找 akashic CLI 的 PATH 可能不是 Bash 工具的 PATH (follow-up finding from #775) #786、SessionStart hook:原始碼 checkout 不存在時不說沒有比新舊 (follow-up finding from #775) #788、stamp-version.sh 沒有鎖:並行建置與訊號下 binary 可能印 unknown (follow-up finding from #775) #789、SessionStart hook 在 partial clone 而 git 早於 2.45 時可能 lazy fetch (follow-up finding from #775) #790、check-cli.sh 探測的暫存檔:標記檔名字沒保留、被砍時留下殘檔、建不出暫存檔時怪到 CLI (follow-up finding from #775) #791、check-cli.sh:CLI 是包裝腳本而確實落後時,提示的 install 目的是那支腳本 (follow-up finding from #775) #792、check-cli.sh:分岔時比對兩份 commit 清單的成本沒有上限,歷史夠長會撞上 hook 的 30 秒上限 (follow-up finding from #775) #793;sister:akashic-discovery 的 akashic-work-references 依賴 CLI 的 references 契約,開 session 時沒有過期提示 (sister concern from #775) #776
Metadata
Metadata
Assignees
Labels
No labels
Activity
kiki830621 commentedon Nov 9, 2026
Diagnosis
Type
feature
Root Cause / Analysis
現況(2026-11-09 量)
~/bin/akashic是 2026-10-28 建置的。akashic --version回Error: Unknown option '--version'、結束碼 64(ArgumentParser 的用法錯誤);akashic fulltext contract印fulltext-contract 6、結束碼 0。origin/main的FulltextFetch.contractVersion是 8;plugin/skills/akashic-fetch-fulltext/SKILL.md第 0 步要求-ge 8。plugin/)沒有hooks/目錄,也就是沒有任何 SessionStart 檢查。需求拆解
akashic --version印建置時的 commit;沒有戳記的建置印unknown;舊 CLI 回 64,hook 據此分辨。hooks/check-cli.sh:找不到 CLI、落後原始碼、契約不足三種情形各自印出;不連網、不自動安裝、不覆蓋現有 binary。與 safari-browser 不同、要在 plan 階段裁決的五點
HEAD。這個 repo 的工作在 worktree 與 PR 上進行,主 checkout 不常 pull:本機主 checkout 的main實測落後origin/main308 個 commit。候選:比refs/remotes/origin/main(不連網,fetch 過就新),沒有這個 ref 時退回HEAD,訊息寫明用的是哪一個HEAD則在這個 repo 幾乎恆落後Sources、Package.swift、Package.resolved、submodulerepos/biblatex-apa-swift(AkashicExport依賴它)。Sources也含akashic-mcp、AkashicAppKit、akashic-guards、tractatus-doc等不進 CLI 的 targetPackage.swift分岔)git describe寫進受追蹤的佔位檔、建完還原。B:連結時以-Xlinker -sectcreate放進 Mach-O section,執行時以getsectiondata讀akashicmodule。B 不碰任何受追蹤檔;兩個 repo 都沒用過,SwiftPM 的增量連結行為要量swift buildswift build -c release --product akashic,不經包裝,建出的 CLI 印unknownunknown、由 hook 走檔案時間swift-is-the-implementation-language例外 1 目前「恰為四個檔」,且要求「只做串接」;hook 含判斷(祖先關係、檔案時間退路、契約比對)契約要求的數字只能有一份:目前只寫在 SKILL 第 0 步的
-ge 8。hook 若另寫一個 8,就是no-compat-fallback說的第二份描述。候選:hook 從 plugin 內的 SKILL 抽出那個數字(要有測試釘住抽取與 SKILL 一致、抽不到時具名說出來),或 SKILL 與 hook 改讀同一個資料檔(要動 SKILL)。Existing work
unknown:check-existing-work.sh的 merged PR 清單到了上限 100,更早的 merged PR 沒有查。沒有 open PR 引用 akashic CLI 過期時沒有提示:比照 safari-browser 加 SessionStart 檢查 #775。idd/775-cli-stale-check,停在閱讀階段、沒有任何改動;本機 branch 與 worktree 已刪,遠端從沒有過。本次在同名 branch 上從頭開始(從origin/maindad21f86分出)。Impact
plugin/hooks/hooks.json、plugin/hooks/check-cli.sh、CLI 的版本旗標(Sources/akashic/)、建置戳記腳本、Swift 測試(Process 執行 hook,假 HOME、假 checkout、假 CLI;不新增 shell 或 Python 測試)。plugin/.claude-plugin/plugin.json(升version)、.githooks/plugin-shell-versions.txt(加一列)、plugin/CHANGELOG.md、.claude/rules/swift-is-the-implementation-language.md(例外 1)、docs/rulings/mcp-cli-parity.md(--version的兩面裁決:它是CommandConfiguration(version:)的旗標,既不是 subcommand 也不是ParsableArguments,三種稽核都枚舉不到,要手動加列;MCP 面的對應物是 wrapper 依binary_version下載),視 (d) 的裁決改 SKILL 第 0 步的建置指示。~/bin/akashic,不取代 [feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633。Strategy
CommandConfiguration(version:)讀建置戳記,沒有戳記印unknowngit describe --always --dirty(排除idd-*-baseline等 tag)、戳記、swift build -c release --product akashic、印出 bin 路徑;不安裝--version(4 秒上限、自己的 process group、暫存檔在任何結束方式下都清掉);比對 (a) 選定的基準;比不出祖先關係時說明原因並退回比檔案時間;比fulltext contract與 SKILL 要求的數字;沒有 checkout 時只比契約;任何失敗都 exit 0hooks.json、plugin.json升版、版號表加列、plugin/CHANGELOG.mdmcp-cli-parity裁決列--version回 64)、落後 N 個 commit、squash 之後內容相同、checkout 比建置舊、印unknown、契約不足、沒有 checkout、--version卡住plugin-shell-version、official-validate等守衛與相關測試Conflict Class
B_resource_serialize — 共享資源:
plugin/.claude-plugin/plugin.json的version與.githooks/plugin-shell-versions.txt(只增、版號依序)。其他工作線同期在升 plugin 版號,同時改會衝突,合併前要 rebase 並重算那一列。Complexity
Plan
Hard-gate: triggered — 同一個概念(CLI 過期提示)散佈到 ≥5 檔:
plugin/hooks/check-cli.sh、plugin/hooks/hooks.json、Sources/akashic/的版本旗標、建置戳記腳本、plugin/.claude-plugin/plugin.json、.githooks/plugin-shell-versions.txt、.claude/rules/swift-is-the-implementation-language.md、docs/rulings/mcp-cli-parity.md、Swift 測試--version是 CLI 的新旗標,但不改任何既有 spec 的規範行為、不影響多份 spec → 不是 SpectraRisks
Residue
akashicCLI 沒有發布管道([feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633);本 issue 只做到本機提示,不做下載或安裝。Vagueness Pre-check
--version印git describe、hook 的三種情形各印什麼、checkout 位置可設定),沒有「改善」「優化」這類無標的動詞。Sister Concerns Filed (mid-diagnose, v2.47.0+ #528)
akashic-work-references同樣依賴 CLI 的契約(references,要恰好 10),在另一個 plugin 根,CLI 也沒有唯讀的契約查詢子命令(sister-concern:同根因、不同檔)kiki830621 commentedon Nov 9, 2026
🎯 Decision
決定
Diagnosis 列出的五個待裁決點與契約數字的來源,依上面四題的選擇定案:(c) 照 safari-browser,用建置期間改寫、建完還原的受追蹤佔位檔;(d) SKILL 的建置指示改用那支戳記腳本,裸
swift build建出的 CLI 印unknown,由 hook 改比檔案時間;(a) 比對基準是refs/remotes/origin/main,沒有這個 ref 才用 checkout 的HEAD,訊息寫明用了哪一個;(e) 修改swift-is-the-implementation-language的例外 1,收plugin/hooks/check-cli.sh與戳記腳本;契約要求的數字由 hook 從akashic-fetch-fulltextSKILL 第 0 步抽出,測試釘住抽到的值等於 SKILL 那一行,抽不到時具名說出來。(b) 沒有另外問,採 Diagnosis 寫的預設:編譯輸入取整個Sources、Package.swift、Package.resolved與 submodulerepos/biblatex-apa-swift,接受過報,提示文字寫「動到 package 原始碼」。Rationale
戳記方法選已在 safari-browser 用過、有測試的那一種,代價是建置期間有一個受追蹤檔被改著;連結期 section 雖然不碰受追蹤檔,但兩個 repo 都沒用過,SwiftPM 的增量連結行為要另外量,這一輪不承擔那個未知。比對基準不照 safari-browser 用
HEAD,因為這個 repo 的工作都在 worktree 與 PR 上,主 checkout 很少 pull(實測落後origin/main308 個 commit),拿HEAD當尺會系統性地少報落後。殼層規則選擇顯式改規則而不是類推:hook 要判斷的就是akashicbinary 在不在、新不新,判斷者不能住在被判斷的 binary 裡,而規則要求這種情況寫明理由加列。契約數字留在 SKILL 一處,是no-compat-fallback「同一件事只能有一份描述」的直接應用;另一個選項(兩邊改讀同一個資料檔)要改 SKILL 第 0 步的指令,範圍較大,這一輪不採。Related
#775 Diagnosis、#776(
akashic-discovery的references契約,sister concern)、#633(CLI 的發布管道)kiki830621 commentedon Nov 9, 2026
Implementation Plan (Plan tier)
依 Diagnosis 與 2026-11-09 的 decision comment 定案的方向寫成。branch
idd/775-cli-stale-check(從origin/maindad21f86分出),走 PR;推送、開 PR、合併都另外問。Files & Changes
Sources/akashic/BuildVersion.swift(新)— 受追蹤的佔位檔:enum BuildVersion { static let value = "unknown" }。平常的swift build/swift test讀到的就是unknown,不會失敗。Sources/akashic/CLI.swift— 根命令的CommandConfiguration加version: BuildVersion.value。akashic --version印那一行、結束碼 0;舊 CLI 對同一個旗標回 64,hook 據此分辨。scripts/stamp-version.sh(新,100755)— 移植 safari-browser 的scripts/stamp-version.sh:在 repo 根目錄執行;先算版本再動檔(否則每次都是-dirty);改寫佔位檔、以子行程執行後面的命令並等它結束;成功、失敗、INT/TERM/HUP/QUIT 都從備份還原佔位檔。版本字串取git describe --always --dirty --abbrev=12 --exclude='*',也就是裸的<hash>[-dirty]:這個 repo 的 tag 是akashic-mcp-v*、idd-*-baseline等,沒有一個描述 CLI 的建置。白名單之外的字元與任何 git 失敗一律unknown;所在目錄不是自己 repo 的根時也是unknown(防止被外層 repo 的 tag 冒充)。plugin/hooks/hooks.json(新)— SessionStart 執行${CLAUDE_PLUGIN_ROOT}/hooks/check-cli.sh。plugin/hooks/check-cli.sh(新,100755)— 移植 safari-browser 的hooks/check-cli.sh,三處不同:command -v akashic,沒有才看$HOME/bin/akashic(後者時多說一句「不在 PATH 上」,因為 SKILL 呼叫的是裸的akashic)。找不到 → 印建置指令,沒有原始碼目錄時先印 clone 指令。${CLAUDE_PLUGIN_ROOT}/skills/akashic-fetch-fulltext/SKILL.md第 0 步那一行"${v#fulltext-contract }" -ge <N>抽出,必須恰好一處;CLI 的fulltext contract輸出要是fulltext-contract <數字>。CLI 沒有那個子命令(回 64)→ 說「CLI 沒有 fulltext contract,要求 ≥ N」;數字比 N 小 → 兩個數字都說出來;SKILL 抽不到 → 一行「讀不到 SKILL 要求的契約版本,沒有比對」,不當成通過。${AKASHIC_SOURCE_DIR:-$HOME/Developer/Akashic-Library},是 git 工作樹(含 worktree,.git是檔)才比。基準取refs/remotes/origin/main,沒有這個 ref 才用HEAD,訊息寫明用的是哪一個(origin/main 是上次 fetch 時的狀態)。編譯輸入:Sources、Package.swift、Package.resolved、repos/biblatex-apa-swift。比對流程照 safari-browser:建置 commit 是基準的祖先 → 數之後動到編譯輸入的 commit;不是祖先但編譯輸入與基準相同(squash merge 的常態)→ 視為最新;基準比建置舊 → 說明並改比檔案時間;其他 → 說明原因並改比檔案時間;unknown或舊 CLI → 直接比檔案時間(binary 的修改時間 vs 基準上最後一個動到編譯輸入的 commit)。共通:
--version與fulltext contract各以 4 秒為上限、在自己的 process group 執行,逾時整組 kill,暫存檔在任何結束方式下都刪掉;--version逾時就不再跑契約探測(最壞情形約 4 秒,不是 8 秒)。印出的版本字串只收白名單字元、128 字元以內。任何失敗都 exit 0、不寫 stderr。重建指令:(
install先刪掉目的檔再寫入,換成新的 inode;原地cp覆寫已簽章的 binary 會在下次執行時被系統終止。)plugin/skills/akashic-fetch-fulltext/SKILL.md— 第 0 步錯誤訊息裡的建置指示改成上面四行的寫法(經戳記腳本、以install放回原位)。.claude/rules/swift-is-the-implementation-language.md— 例外 1「目前恰為四個檔」改成六個,加scripts/stamp-version.sh(建置前就得跑的串接)與plugin/hooks/check-cli.sh。後者含判斷(祖先關係、檔案時間退路、契約比對),要寫明為什麼仍列為例外而不是移進 Swift:它判斷的對象就是akashicbinary 本身(不存在、過舊、卡住),判斷者不能住在被判斷的 binary 裡;它的行為測試寫在 Swift test target。〈觸發過的實例〉加一列;〈語言組成〉加一行新量測(不改舊的那一行)。docs/rulings/mcp-cli-parity.md— CLI-only 裁決表加一列「根層旗標 --version(akashic CLI 過期時沒有提示:比照 safari-browser 加 SessionStart 檢查 #775)」:有理由缺席。它既不是 subcommand 也不是ParsableArguments,三種稽核都枚舉不到,所以手動加列;MCP 面的 server binary 由 wrapper 依binary_version下載,版本由那裡管,--version只服務本機的 SessionStart 檢查。第一欄不加反引號(parity-table-drift會把反引號裡的第一個詞當成命令名)。plugin/.claude-plugin/plugin.json—version0.13.12 → 0.13.13(hooks/底下的檔是送出的內容)。.githooks/plugin-shell-versions.txt— 加一列plugin 0.13.13 <摘要>,摘要由akashic-guards plugin-shell-version算出。plugin/CHANGELOG.md— 0.13.13:新的 SessionStart 檢查、AKASHIC_SOURCE_DIR、SKILL 第 0 步的建置指示。Tests/…/CheckCLIHookTests.swift(新)— 照WrapperDownloadTests的做法:暫存 HOME、暫存的原始碼 repo(git init後做幾個動到Sources與只動文件的 commit,另建refs/remotes/origin/main)、假 CLI(shell 腳本,依環境變數印--version與fulltext contract,或回 64、或卡住)、把真的 hook 與真的 SKILL 複製到暫存 plugin 根,以/bin/bash執行。Tests/…/StampVersionTests.swift(新)— 在暫存 git repo 裡跑scripts/stamp-version.sh:命令看到的是戳記值、結束後佔位檔還原(命令成功、失敗、收到 TERM 三種)、有未 commit 修改時帶-dirty、不在 repo 根時是unknown。Tests/AkashicCLITests/…— 測試建置的akashic --version印unknown、結束碼 0。Family-wide scope (shared-abstraction hard-gate trigger only)
n/a — 硬閘因「同一概念散佈 ≥5 檔」命中,不是 shared abstraction。
Sequencing & Dependencies
BuildVersion.swift+CLI.swift的version:(先寫--version印unknown的測試,RED → GREEN)。scripts/stamp-version.sh+ 它的測試:hook 的測試要用「印出某個 commit 的 CLI」,這個格式由這一步定。plugin/hooks/check-cli.sh+hooks.json+ hook 測試(先寫測試)。plugin.json版號、算摘要、加版號表那一列、寫 CHANGELOG——摘要涵蓋 plugin 底下所有送出的檔,任何 plugin 檔之後再改都要重算。run-guards.sh(含plugin-shell-version、official-validate、parity-table-drift、受保護清單棘輪)。Decision Points
已由使用者裁決(見 decision comment):戳記照 safari-browser 用受追蹤佔位檔;基準
origin/main,沒有才HEAD;修改例外 1;契約數字由 hook 從 SKILL 抽;編譯輸入取整個Sources,接受過報。本計畫另外定的細節:
--exclude='*'):hook 只需要解析<hash>[-dirty]一種形狀;safari-browser 那種v<tag>分支在這個 repo 用不到。FulltextFetch.contractVersion:測試用真的 SKILL,假 CLI 印contractVersion - 1時要求兩個數字都出現、印contractVersion時不出聲。這同時釘住兩件事:hook 抽得到 SKILL 的數字,以及 SKILL 第 0 步的數字等於 CLI 的契約常數。後者是新增的不變式:日後升契約版本卻忘了改 SKILL,這支測試會紅。AKASHIC_SOURCE_DIR:與既有的AKASHIC_HOME(store 位置)同一個前綴、不同意思。Risks & Mitigations
unknown),並有測試確保還原。akashic-mcp、App、guards 的 commit 也算「落後」;訊息寫「動到 package 原始碼」,不說「CLI 的程式碼」。Test Plan
--version印unknownCLI.swiftUnknown optionunknown、0-dirty、非 repo 根stamp-version.sh<hash>;結束後檔案回到佔位值--version64、契約 6)Sourcescommit + 1 個只改文件unknown:binary 比最後一個編譯輸入 commit 舊/新HEAD落後origin/mainorigin/main計數,訊息寫明--version卡住contractVersion - 1/contractVersionOut-of-scope (will NOT be touched)
akashic-discovery的references契約與它的建置指示 → akashic-discovery 的 akashic-work-references 依賴 CLI 的 references 契約,開 session 時沒有過期提示 (sister concern from #775) #776。~/bin/akashic的重建(由使用者決定)。akashic-mcp的版本旗標、改用 section 戳記。Tangential Observations (filed mid-plan, v2.42.0+ #524)
none surfaced — 看到的兩件都已有記錄:
check-existing-work.sh在 merged PR 超過 100 筆時回unknown(PsychQuant/issue-driven-development#471);fulltext子命令群在docs/rulings/mcp-cli-parity.md已有裁決列。本機主 checkout 落後origin/main是環境狀態,不是 repo 的缺陷。kiki830621 commentedon Nov 9, 2026
Implementation Complete
branch
idd/775-cli-stale-check(已 rebase 到origin/main8f8859c0),11 個 commit,尚未推送。Checklist (synced from TaskList)
Sources/akashic/BuildVersion.swift+ 根命令version::akashic --version印建置時的 commit,未戳記印unknown→283e640dscripts/stamp-version.sh:建置期間寫入、任何結束方式都還原;排除所有 tag,只印裸<hash>[-dirty]→b6718e30plugin/hooks/check-cli.sh+hooks.json:找不到 CLI/契約不足/落後原始碼三種提示,基準origin/main沒有才用 HEAD →c21d3682、236a1f6f、1be7fc48akashic-fetch-fulltextSKILL 第 0 步的建置指示改經戳記腳本 →27833693swift-is-the-implementation-language例外 1 四個檔改六個(hook 以具名例外列入);docs/rulings/mcp-cli-parity.md加「根層旗標 --version」 →cec5fecce6927a60、886ce15eCLIVersionTests(1)、StampVersionTests(8)、CheckCLIHookTests(18) → 同上各 commitchangelog/2026-11-09-cli-stale-check-775.md→7854f899、36a966f1Scope Changes
WriteGateRulingsTests把 ArgumentParser 自帶的--version與--help一起排除在「寫入腿」之外(根命令設了version:之後它出現在每個子命令上);GitSpawnHygieneTests登記兩支新測試檔(它們 spawn git,環境已剝除GIT_*)。${名字};hook 測試固定在LANG=C.UTF-8下跑,並斷言輸出沒有 U+FFFD(修 hook 之前同一組測試在這個環境下出現 21 個失敗)。Verification
-Xswiftc -warnings-as-errors)與全套swift test -Xswiftc -warnings-as-errors在 rebase 後的886ce15e上:0 個錯誤(最大的 bundle 927 支)。bash .githooks/run-guards.sh在 HEAD36a966f1上 rc=0(5/5 PASS、觸發點覆蓋無缺口)。$HOME/bin、檔案時間不比、dirty 不說),戳記腳本兩個(不排除 tag、拿掉 TERM 的 trap)——每個都讓對應的測試轉紅,檔案已從備份位元組相同地還原。scripts/stamp-version.sh建 release 版、install到暫存目錄:--version印886ce15e5cf1,等於 HEAD;建完工作樹乾淨、佔位檔已還原;hook 讀到版本並說明「比 origin/main 新」。~/bin/akashic(只讀,這一輪沒有覆蓋):Files Changed
Scope Compliance
所有改動都對應 #775 的 Expected 或其直接後果(見 Scope Changes)。
akashic-discovery的references契約在 #776,CLI 的發布管道在 #633,都沒有動。Sister Bugs Filed (mid-impl, v2.44.0+ #526)
$名字緊接非 ASCII 字元」(本 issue 的 hook 第一版就是這樣;2026-11-09 量六支殼層檔目前 0 處)Next: verification pending
推送 branch、開 PR 都等使用者確認後才做;之後
/idd-verify #775。kiki830621 commentedon Nov 9, 2026
📊 For Reviewer / Collaborator
現在:已結案。根因是 CLI 說不出自己是哪一次建置、plugin 也沒有開 session 時的檢查;改成
akashic --version印建置 commit,加上 SessionStart hook 說出找不到 CLI、契約不足、落後原始碼三種情形。PR #783 已 squash 合併(8fc7fc0b),plugin 殼發布為 0.13.15。Blocking:無
你該做什麼:無。本機的
akashic要不要重建由你決定;verify 留下的界線在 #778、#784、#785、#786、#788–#793,發布管道在 #633。last-updated by idd-close at closed, 2026-11-12
kiki830621 commentedon Nov 10, 2026
Verify (via PR #783)
Result: FAIL — 3 blocking(MEDIUM:比不出祖先關係時安靜漏報、git 呼叫沒有中和設定與環境、並行戳記留下戳記值)、1 項待使用者裁決(SessionStart 輸出進模型 context、畫面上不一定看得到)
Full report: #783 (comment)
This issue's findings: see "#775" section in the linked report.
kiki830621 commentedon Nov 10, 2026
Verify r2 — FAIL(報告在 PR #783)
完整報告:#783 (comment)
受審的是 r1 之後的三個修正 commit(本機,還沒推上 PR)。六席都交回報告。
core.fsmonitor設定的程式會被diff-tree執行;戳記腳本在檢查與備份之間的空檔仍會把戳記留在受追蹤的檔裡。akashic是包裝腳本時,探測拿到的是收窄過的 PATH,被報成執行失敗。下一步:修完再做一輪只看這批修正的複審(r3),通過才推上 PR。
kiki830621 commentedon Nov 10, 2026
Verify r3 — FAIL(報告在 PR #783)
完整報告:#783 (comment)
受審的是 r2 之後的三個修正 commit(本機,連同 r1 的三個都還沒推上 PR)。六席都交回報告。
/bin/sh -p在/bin/sh指向 dash 的機器上每次都失敗(預設的 macOS 指向 bash,不受影響);兩者分岔時算交集的成本是兩份清單長度的乘積,歷史長到幾千個 commit 時可能撞上 hook 的 30 秒上限。下一步:照 r2 報告的預告停損,這一輪不推、不再自行加新機制;分岔比對成本的處置先請使用者決定。
kiki830621 commentedon Nov 10, 2026
Verify r4 — PASS(停損輪,報告在 PR #783)
完整報告:#783 (comment)
受審的是 r3 之後的三個 commit。兩席 Claude、Codex 與 Devil's Advocate 都沒有 MEDIUM 以上的問題。找到的都是 r3 修正輪新寫的句子不成立,已照各席給的實測與句子改字(
12b04e72,不碰判定邏輯)。其中一項更正了 M2 的成本數字:原本是在 UTF-8 locale 下量的,hook 跑在 C locale,實際約是四分之一(#793 已同步更正)。下一步:推送到 PR 分支;合併另外問。
fix: SessionStart 檢查看內容判定落後、只用 git plumbing、探測傳回結束碼 (#775)
fix: 戳記腳本拒絕非佔位值的檔、寫不進去就中止、未追蹤檔算 dirty (#775)
docs: verify r1 修正輪的 changelog、README 的 AKASHIC_SOURCE_DIR、版號表摘要 (#775)
fix: 落後判定看每個 commit 動過什麼、關掉 fsmonitor、探測用使用者的 PATH (#775)
fix: 戳記腳本備份後再查備份、戳記帶標記、submodule 的未追蹤檔算 dirty (#775)
docs: verify r2 修正輪的 changelog、例外 1 的描述、README、版號表摘要 (#775)
fix: 探測的小 shell 指名 /bin/bash、檔頭照實寫 grafts 與被砍時的輸出 (#775)
docs: 分岔比對的成本寫成界線、改用 package 路徑時訊息說實話 (#775)
docs: changelog 補上 verify r3 修正的驗證結果 (#775)
docs: verify r4 的改字——成本數字改用 C locale 的量測、被砍時留下什麼照實寫 (#775)
chore: 併入 main(#779 的 PR #787 已合併)、plugin 殼改升 0.13.15 (#775)
feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775)…
kiki830621 commentedon Nov 12, 2026
Closing Summary
Problem
本機的
akashicCLI 過期時沒有任何提示。#768 合併後,SKILL 要求fulltext contract8,本機 10 月底建的 CLI 只印 6;開 session 時沒有訊息,第一個訊號會是 SKILL 第 0 步拒絕執行,或者用舊 CLI 跑了。safari-browser 已有同類機制(--version加 SessionStart hook)。Root Cause
CLI 說不出自己是哪一次建置(沒有
--version,舊 CLI 回結束碼 64),akashic-mcp plugin 也沒有任何 SessionStart 檢查,所以落後原始碼與契約不足都要等到執行時才看得到。Solution
akashic --version印建置時的 commit(裸<hash>[-dirty],排除所有 tag);沒有戳記的建置印unknown。scripts/stamp-version.sh:建置期間把 commit 寫進受追蹤的佔位檔,任何結束方式都還原;佔位檔不是原樣就拒絕、寫入失敗就中止、package 路徑下有未追蹤檔算-dirty。plugin/hooks/check-cli.sh(SessionStart):找不到 CLI、契約不足、落後原始碼三種情形各自說出來;不連網、不自動安裝,重建由使用者決定。origin/main,沒有才用HEAD。判定看基準上每個不在建置歷史裡、動到 package 原始碼的 commit,所以 squash 合併、revert、分支沒 rebase 這些情形都分得出來。GIT_*;探測 CLI 用/bin/bash -p加 8 秒上限。swift-is-the-implementation-language的例外 1 收入 hook 與戳記腳本。Verification
b96ecb10)。12b04e72只照審查席的實測改字;6a112fc2併入 main、版號改成 0.13.15。兩者都跑過下一條的全套測試與 CI。6a112fc2的 pre-push:嚴格建置、7 個 bundle 5,640 支測試、0 失敗、1 略過,守衛無缺口;PR feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775) #783 的遠端parity通過。Changes
8fc7fc0bfeat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (akashic CLI 過期時沒有提示:比照 safari-browser 加 SessionStart 檢查 #775) (feat: akashic --version 印建置 commit,plugin 開 session 時檢查 CLI 是否過期 (#775) #783) —— main 上的 squash merge,使用者 2026-11-12 確認合併idd/775-cli-stale-check:22 個 commit(283e640d…6a112fc2),分支保留Sources/akashic/BuildVersion.swift、Sources/akashic/CLI.swift、scripts/stamp-version.sh、plugin/hooks/check-cli.sh、plugin/hooks/hooks.json、plugin/skills/akashic-fetch-fulltext/SKILL.md、plugin/.claude-plugin/plugin.json、plugin/CHANGELOG.md、.githooks/plugin-shell-versions.txt、.claude/rules/swift-is-the-implementation-language.md、docs/rulings/mcp-cli-parity.md、README.md、changelog/2026-11-09-cli-stale-check-775.md,以及測試CLIVersionTests、StampVersionTests、CheckCLIHookTests、WriteGateRulingsTests、GitSpawnHygieneTests已知界線與 follow-up
akashic沒有重建。更新 plugin 之後,每次開 session 都會看到「CLI 落後」的提示,直到使用者決定重建。Residue Acknowledgement
Acknowledged as still residue, tracked in #633(CLI 沒有發布管道):
兩項都在 #633 的範圍內:它若改成 release 下載,hook 的比對基準可以換成 release 版本,沒有 checkout 的使用者也就能知道自己落後。所以不另開 follow-up。
Doc-sync 檢查
main 上 3 份文件(
README.md、CLAUDE.md、docs/tractatus/README.md)都看過。CLAUDE.md與docs/tractatus/README.md不受這次改動影響;README.md的環境變數表已在本 PR 加了AKASHIC_SOURCE_DIR。有一處沒有改:
README.md的 akashic-discovery 一段寫「CLI 要在本 reposwift build -c release後自行放上 PATH」。沒有經過scripts/stamp-version.sh建出的 CLI,--version印unknown,hook 只能改比檔案時間,所以那句話已不是最好的建置方式。改它要推到 main,不在這次結案的範圍內,留給 #776(同一個 skill 的過期提示)一併處理。Distribution Sync
akashicCLI 沒有發布管道([feature] akashic CLI 沒有發布管道,但依賴它的 skill 已有 5 個 (tangential from #617) #633)8fc7fc0b: 2 個 check 都通過(parity、test)merge: 併入 main(PR #783 的 CLI 過期檢查),plugin 殼改成 0.13.16 (#777)