Skip to content

spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548

Closed

Description

@kiki830621

Problem

Original text:這張不是使用者的原話,是執行 /idd-all 的 session 在一個真實專案裡跑 spec-change.py links 時觀察到的。

spec-change.py links 用 git grep -F -e "spec-example: <capability> / <title>" <head> -- . 找帶標記的檔案。這個指令不進 submodule,所以標記寫在 submodule 的測試檔裡時,檢查一律回報「no tracked file outside openspec/ (and not .md) carries its marker」。

遇到的情境:規格放在主 repo 的 openspec/,被規格描述的套件是主 repo 的 submodule,測試在套件自己的 repo 裡。這種配置下,套件的每一個 Example 都不可能通過 links,不論測試檔有沒有標記。

Type

enhancement

Expected

  • 標記寫在 submodule 的已追蹤檔案裡時,links 找得到它。讀的是主 repo 在 <head> 記錄的那個 submodule commit,不是工作樹當下的內容。
  • submodule 沒有初始化或抓不到那個 commit 時,links 回報 error 並說明原因,不把它當成「沒有標記」。
  • 說明文件(spec-on-every-issue 的規則與 spec-change.py 的說明)寫明標記可以放在 submodule 裡,以及這時需要 submodule 已經取出。

Actual

  • marker_files() 的 git grep 沒有 --recurse-submodules,只看主 repo 自己追蹤的檔案。
  • 結果是 status: missing,原因寫「沒有檔案帶這個標記」。讀報告的人看不出這是工具看不到,還是測試真的沒有標記。

Impact

  • 規格在主 repo、程式與測試在 submodule 的專案,verify 的規格連結這一列永遠不會通過。
  • 這類專案若為了讓檢查通過而在主 repo 放一個只帶標記、不執行任何檢查的檔案,檢查就失去意義。

Repro

  1. 主 repo 有 openspec/specs/<capability>/spec.md,其中一條新增的 requirement 帶 ##### Example: <title>。
  2. 把含有 # spec-example: <capability> / <title> 的測試檔放在一個 submodule 裡並提交,主 repo 提交 submodule 指標。
  3. 在主 repo 跑 python3 scripts/spec-change.py links --base <base> --head HEAD --cwd .。
  4. 輸出是 {"status": "missing", ...},why 是「no tracked file outside openspec/ (and not .md) carries its marker」。

可能的做法(供診斷參考,未驗證)

git grep 在給定 tree 時可以加 --recurse-submodules,它會搜尋那個 tree 記錄的 submodule commit;需要確認輸出的路徑前綴在這個模式下的格式,以及 submodule 未取出時的行為。

Related


Clarity Surface(idd-clarify run 2026-11-14T02:00:00Z)

Type Source Question for you Status
(none) — no issues detected passed

Linked-Context Siblings Filed

(none surfaced)


Current Status

Phase: closed(PR #572 於 2026-11-16 以 squash 合併成 28e0de2,內容與 ee3fcd9 相同;結案摘要是留言 6911419356;2026-11-16 發布為 4.2.0)
Last updated: 2026-11-16 by idd-update(結案後發布為 4.2.0)
Dashboard: #548 (comment)

Key Decisions

  • links 自己列出 <head> 的 gitlink,逐一在記錄的 commit 上搜尋(含巢狀),不用 git grep --recurse-submodules;每一次 git grep 都帶 --no-recurse-submodules。
  • 一個 Example 有三種結果:找到標記 → 有連結;沒找到且每個 gitlink 都搜尋過 → missing;沒找到且有 gitlink 搜尋不了 → error。維護者已確認這個讀法(留言 6878497822)。
  • 第一輪之後:主 repo 找到標記就停;只在符合六個條件的目錄跑 git;在那裡跑 git 時關掉 lazy fetch、拿掉六個繼承的 git 位置變數(GIT_DIR、GIT_WORK_TREE 等)。
  • 第二輪之後(留言 6878497822):兩處「checked exactly as before」改成可以檢查的句子,三個子命令用同一個方式讀頂層目錄;搜尋失敗的 submodule 底下的 submodule 照樣搜尋;git 比 2.45 舊時不在 submodule 目錄跑 git。
  • 第三輪之後(留言 6885330621):物件打不開時算缺物件;submodule 的搜尋中途中止時不採用它印出的內容,一律 error。
  • 第四輪之後(留言 6888927012,維護者委託協調者決定):symbolic link 的 blob 打不開也算缺物件;預設分支的 4.1.0 用合併接進來,重複的兩條 requirement 併成一條;合併前補整條分支的審查,最多兩輪。
  • 第五輪之後(留言 6890121460,同一個委託):submodule 的目錄落在主 repo 自己的 git 目錄或它底下時不搜尋、不在那裡執行 git(第 2 個條件補一句,Example 第 55 列)。
  • 第六輪之後(留言 6891118023,維護者:照建議修,條文改成封閉列舉,再審一輪):第 2 個條件改寫成兩個目錄的封閉列舉(git rev-parse --absolute-git-dir 與 --git-common-dir 在頂層印出的那兩個);submodule 自己的 git 目錄不排除、解析後等於頂層目錄的路徑照樣接受,兩件事都寫進條文(Example 第 56 到 59 列)。後兩件是協調者的選擇,維護者可以改。
  • 第七輪中途(留言 6892950238):維護者決定先把這一輪跑完、不改程式,並選定席位的執行方式。
  • 第七輪之後(留言 6894347661,維護者:改程式,再審一輪):第 2 個條件的前半與第 5 個條件改成比對目錄(作業系統回報的裝置與 inode),不比對路徑字串;條文的兩句照程式改寫(Example 第 60 到 63 列)。
  • 同一個 change 多做的一步(留言 6894894048,協調者依委託決定):解析後落在規格目錄裡的 submodule 不搜尋,不論它的路徑叫什麼(Example 第 64、65 列)。
  • 第八輪之後(留言 6909585903,維護者從選項中選定):多做的那一步留著;第八輪的後續項留在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559、分支不再改;開 draft PR 讓 Linux 的 CI 跑一次,不合併。
  • CI 失敗之後(留言 6910032608,維護者從選項中選定):在分支上修第 50 列的測試前提與 Example 那一列的敘述,不再審。這只推翻「分支不再改」對這一件事的適用。
  • Complexity:Spectra。九個 change 都已封存:idd-548-links-submodule-markers(afd0021)、idd-548-links-submodule-hardening(7ad9152)、idd-548-links-search-completeness(726050b)、idd-548-links-unreadable-objects(54a9092)、idd-548-one-top-directory-requirement(8003a7b)、idd-548-fix5(59979f2)、idd-548-fix6(941f881)、idd-548-fix7(e5022f4)、idd-548-fix8(ee3fcd9)。

Verification

  • 八輪:FAIL(6876450742)、FAIL(6878222878)、FAIL(6881182720)、PASS(6887766646,只審第三輪之後的修正)、FAIL(6889821186,第一次從頭審整條分支)、FAIL(6891008905)、FAIL(6893428419)、PASS(6908861611,審整條分支)。
  • 第八輪:0 blocking、0 項要在分支上修、9 項後續(7 項 LOW、2 項 INFO)。閘門:clean。第七輪的四列都解決了:第 2 個條件的前半與第 5 個條件改成比對目錄,同一個目錄的另一種拼法(另一種大小寫、macOS 的另一種絕對路徑寫法、Unicode 的另一種正規化形式)不再被回 error;條文的兩句照字面成立。issue 的三點 Expected 在審查席建的輸入上都成立;整套 75 個 suite 全過,spec-change 878 項。
  • 這個「乾淨」的限度:裁定席的把握約七成五。條文有三處容許兩種讀法(規格目錄的路徑是一般檔案、規格目錄是 link、「上一層目錄」),照較嚴的讀法就還要各補一句。另一個模型家族的審查席把第一處評為 HIGH,裁定席重建後定為 LOW。這些都列為後續,補在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559。
  • 第八個 change 多做了一步,維護者沒有點名:解析後落在規格目錄裡的 submodule 不搜尋。裁定席裁定它照字面寫明了、與程式相符、不是缺陷;留不留由維護者決定。
  • 六席都交出了結果,各啟動一次,其中一席是另一個模型家族(OpenAI gpt-6.1-sol,沒有工具)。協調者撰寫了這個 change,沒有分級。
  • 測試只在 macOS 上跑過(git 2.55.0 與 2.54.0;另在區分大小寫的磁碟映像上跑過,需要兩種拼法的第 60 到 64 列在那裡略過)。
  • draft PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572 的第一次 CI(ubuntu-26.04、git 2.56.1)失敗,75 個 suite 裡 2 個(留言 6909882017)。spec-change 停在第 50 列的 fixture:它的前提是空的物件檔讓 git grep 以 0 或 1 結束,git 2.56 起改成以 128 結束;之後的檢查在 CI 上都沒有跑到。協調者在 macOS 上用 git 2.56.0 重現,拿掉那一行前提檢查後 878 項全過,所以 links 的答案沒有錯,壞的是測試的前提與 Example 那一列對 git 行為的敘述。edit-run 的 1 項是 [bug] edit-run: the check "the first backup id stays once" fails when two corrections land in the same second (found during #519) #534 記錄的不穩定檢查,與這條分支無關。
  • 第九個 change(6178467、ee3fcd9):第 50 列的 fixture 改成記下結束碼、不停下;Example 那一列的第一欄改成兩種情形並列。spec-change.py 沒有改,與第八輪審過的 e5022f4 逐位元組相同。測試檔在 git 2.54.0、2.55.0、2.56.0 上都是 878 項通過。這個 change 沒有獨立讀者,也沒有 verify 輪(維護者的決定)。
  • 第二次 CI(run 43828661537,head ee3fcd9,ubuntu-26.04、git 2.56.1)通過:75 個 suite、0 個失敗。CI 不執行第 60 到 64 列(它們需要不分大小寫的檔案系統),在 git 2.56 上也沒有只有「搜尋前先問哪些物件打不開」那一步才抓得到的測試輸入。

Scope Changes

Blocking

  • 沒有。這張 issue 已結案。
  • 已發布為 4.2.0(2026-11-16)。

Tasks

Commits

預設分支:28e0de2(PR #572 的 squash 合併)。分支 idd/548-spec-change-py-links-submodule-missing 保留,合併前比預設分支多 47 個 commit:

  • ee3fcd9 chore: archive idd-548-fix8
  • 6178467 test: row 50 of the Example "markers in submodules" runs whether git skips an empty object or ends the search on it
  • e5022f4 chore: archive idd-548-fix7
  • a84797f docs: acceptance record of idd-548-fix7
  • f6fe368 test: the fixture of row 58 checks where the top directory lies, not what git says about it
  • 338da27 docs: the changelog entry states that a submodule lying in the spec directory is not searched
  • 9fb5cc1 fix: links does not search a submodule whose directory lies in the spec directory, whatever its path is named
  • 65f7a17 test: a submodule that lies in the spec directory is not searched, whatever its path is named — rows 64 and 65 of the Example "markers in submodules"
  • e01674e docs: the changelog entry and the comment of row 57 state the two conditions as the script checks them
  • 54d1775 fix: links decides conditions 2 and 5 by comparing directories, not path names
  • c3b5798 test: links compares directories, not names, where a path spells one in another letter case — rows 60 to 63 of the Example "markers in submodules"
  • 941f881 chore: archive idd-548-fix6
  • 5be6f2d docs: the task list of idd-548-fix6 is complete
  • 25fe633 docs: acceptance record of idd-548-fix6
  • 6f91370 fix: links ends in error when git names no directory for one of the two questions
  • 20048d8 test: an answer of git that names no directory is not taken for one; rows 57 to 59 show the directory searched
  • 4af6539 docs: the changelog entry and the comment of row 55 state the condition as the script checks it
  • 8e5e0c1 fix: links also compares the repository's common git directory, so a linked worktree that holds the main repository is covered
  • 8ebcecb test: links compares the two git directories of the main repository and nothing else — rows 56 to 59 of the Example "markers in submodules"
  • 59979f2 chore: archive idd-548-fix5
  • 2bff808 docs: every task of idd-548-fix5 is done
  • 5360a91 docs: the acceptance record of idd-548-fix5
  • dd8d2b9 docs: the design of idd-548-fix5 records a related case it leaves alone
  • 50d01da docs: the changelog entry says what counts as the main working tree and which answer changes with submodule.recurse on
  • f170baa test: row 29 of the Example "markers in submodules" builds what it states; the suite stops when its temporary directory cannot be made
  • 3fac72d fix: links does not search a submodule directory inside the main repository's own git directory
  • 925062d test: links does not run git inside the main repository's git directory — row 55 of the Example "markers in submodules"
  • 8003a7b chore: archive idd-548-one-top-directory-requirement
  • 6758b3d docs: the changelog entry no longer lists as new what release 4.1.0 shipped
  • 0e0f153 test: the top-directory block of the spec-change suite names the Example released in 4.1.0
  • f08839f chore: merge the default branch at release 4.1.0 into the branch
  • 54a9092 chore: archive idd-548-links-unreadable-objects
  • 08168c7 docs: an object counts as lacking when it cannot be opened, not when it merely cannot be read to its end
  • 6c88ba8 fix: links counts an object it cannot open as lacking, and ignores what a submodule's search printed before it ended early
  • a552f39 test: links opens the objects of a submodule and does not use the output of a search that ended early — rows 50 to 54 of the Example "markers in submodules"
  • 726050b chore: archive idd-548-links-search-completeness
  • f8fde3a fix: links asks git which objects a submodule lacks instead of reading its error stream, and links, archived and preflight read the top directory alike
  • 1da57e1 test: links keeps searching inside a failed submodule, ignores git's error stream and checks the git version — rows 42 to 49 of the Example "markers in submodules"
  • 7ad9152 chore: archive idd-548-links-submodule-hardening
  • 57ee7e2 fix: links stops at a marker found in the main repository and runs git only in a checked-out submodule
  • 66beef4 test: links runs git only in checked-out submodules — rows 16 to 41 of the Example "markers in submodules"
  • afd0021 chore: archive idd-548-links-submodule-markers
  • 4e0f47b fix: links turns git's own recursion into submodules off
  • ed0bb10 test: links gives the same answer when submodule.recurse is on; joined reasons, a nested submodule not checked out, a submodule under the spec directory
  • 41fea78 chore: record the attachment manifest of issue 548
  • aa067f0 feat: spec-change.py links reads markers in submodules and answers error when it cannot decide
  • 9ebccfd test: links finds markers in submodules — ten checks for the Example "markers in submodules"

Activity

  1. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Diagnosis

    Type

    feature(issue 的 label 是 enhancement)

    Root Cause / Analysis

    spec-change.py 的 marker_files() 用 git grep -z -F -e <標記> <head> -- . 找帶標記的檔案。給定 tree 時,git grep 不進 submodule,所以標記在 submodule 的檔案裡時 links 一律回報 missing。

    在一個三層的臨時 repo(主 repo → submodule → 巢狀 submodule,git 2.55.0)上量到的行為:

    1. 不加旗標、給定 tree:submodule 檔案裡的標記找不到(exit 1)。這就是 issue 描述的情況。
    2. 加 --recurse-submodules、給定 tree:找得到,巢狀的也找得到;輸出的路徑是 <tree>:<submodule 路徑>/<檔案>。
    3. 它讀的是 tree 記錄的那個 submodule commit,不是 submodule 工作樹當下的內容:把 submodule 往前提交一版、拿掉標記,舊的 tree 仍然找得到;主 repo 的新 commit 記錄了沒有標記的那一版之後,新的 tree 找不到。
    4. submodule 沒有取出時(git submodule deinit),--recurse-submodules 安靜略過它,exit 1,跟「沒有標記」分不出來。git 的說明寫它只搜尋「active and checked out」的 submodule,所以取出了但不是 active 的 submodule 也會被安靜略過。
    5. tree 記錄的 commit 不在 submodule 的物件庫裡時,git grep 以 fatal: unable to read tree 結束(exit 128);現行程式把 0 與 1 以外的結束碼當成 error,這一種已經不會被讀成「沒有標記」。

    第 4 點決定了做法:只加 --recurse-submodules 會讓「沒取出」與「沒有標記」同樣回報 missing,這正是 issue 的 Expected 第二點要排除的。所以由 links 自己列出 <head> 的 gitlink(git ls-tree -r 裡 mode 160000 的項目),逐一確認該目錄是自己的工作樹頂層、而且有記錄的那個 commit,再在那個 commit 上搜尋,巢狀的 gitlink 照同樣方式往下走。每一個沒辦法搜尋的 submodule 都留下路徑與原因。

    對 Expected 第二點的讀法(見下方 Choice Default Record):一個 Example 有三種結果。

    標記 submodule links 對這個 Example 的結果
    在主 repo 或任一個搜尋得到的 submodule 裡找到 不論其他 submodule 能不能搜尋 有連結
    沒找到 每一個 gitlink 都搜尋過 missing(現行的 why 文字不變)
    沒找到 至少一個 gitlink 沒辦法搜尋 error,原因寫出是哪個 Example、哪個 submodule 路徑、為什麼搜尋不了

    links 要回答的是「這個 Example 有沒有帶標記的檔案」。已經找到一個,答案就確定了,其他 submodule 能不能搜尋不影響;沒找到而又有地方沒看過,答案無法確定,照這支 script 的既有約定(讀不到或無法判定的一律 error)回報。

    排除規則不變:主 repo 規格目錄底下的檔案與 .md 檔不算。submodule 裡的檔案以「submodule 路徑/檔案路徑」比對 .md 結尾。

    Existing work

    unknown:已合併 PR 的清單達到查詢上限(100 筆),更早的沒有查到。目前開著的五個 PR 都沒有動 spec-change.py。#547 的修正預期也會改 scripts/spec-change.py(別的 subcommand),兩邊先後合併時可能要解衝突。

    Impact

    • 影響的檔案:plugins/issue-driven-dev/scripts/spec-change.py(marker_files()、cmd_links()、檔頭說明)、plugins/issue-driven-dev/scripts/tests/spec-change/test.sh、openspec/specs/spec-on-every-issue/spec.md(經 Spectra change)、plugins/issue-driven-dev/references/spec-wrapper.md、寫到標記放在哪裡的 skill 文字(idd-implement、idd-all)、CHANGELOG.md。
    • 影響的使用者流程:idd-implement 的 Spec close-out、idd-all 的 Step 3b.6、idd-verify 的規格連結那一列。只有 repo 底下有 submodule 時行為才會不同;沒有 gitlink 的 repo 結果與現在相同。

    Strategy

    • Spectra change:修改 requirement「Added and modified requirements carry an executable check」,寫明標記可以在 submodule 的已追蹤檔案裡(讀 <head> 記錄的 commit,含巢狀)、上表的三種結果,並加一個 Example 表。
    • 先寫測試(tests/spec-change/test.sh,在目前的 main 上要失敗):標記在 submodule;標記只在 submodule 較新的 commit;標記在巢狀 submodule;submodule 沒取出且別處沒有標記;submodule 沒取出但主 repo 有標記;記錄的 commit 不在物件庫;submodule 路徑含空白;submodule 裡的 .md。
    • 改 spec-change.py:列舉 gitlink、逐一搜尋、無法判定時回 error;同一次執行內 gitlink 清單只算一次。
    • 文件:檔頭說明、references/spec-wrapper.md、兩個 skill 裡講標記位置的句子、CHANGELOG。
    • Spec close-out:spectra-verify、封存、links(從 merge-base)、archived。

    Conflict Class

    A_parallel_safe
    改動在一個 script、它的測試與說明文件,沒有單一寫入者的共享資源;與 #547 動到同一個檔案的不同函式,屬於合併時的一般衝突。

    Complexity

    Spectra

    • Layer 2:links 是其他 skill 呼叫的工具介面(idd-implement、idd-all、idd-verify 的 spec 包裝流程),它的行為寫在 capability spec-on-every-issue。
    • Layer 3:這次修改既有規格的規範性行為(標記可以放在哪裡、新增一種 error 的情況)。

    Hard-gate: triggered — 標記規則同時寫在 spec-change.py、tests/spec-change/test.sh、openspec/specs/spec-on-every-issue/spec.md、references/spec-wrapper.md 與兩個 skill 的文字裡(同一個概念約六個檔案);判定已經是 Spectra,硬閘不改變它。

    Risks

    • 在 submodule 目錄裡執行 git:submodule 的內容與設定是資料,不是可信任的輸入。只用唯讀的 ls-tree、cat-file、grep,沿用 script 既有的 git() 包裝。
    • CI 的 checkout 預設不取出 submodule。這類環境裡,找不到標記的 Example 會從 missing 變成 error;找得到的不受影響。這是想要的結果,但文件要寫明。
    • submodule 多、Example 多時,每個 Example 對每個 submodule 各跑一次 git grep。gitlink 清單與可搜尋性在一次執行內只算一次。
    • 路徑含空白或非 ASCII 字元:沿用 -z 與 core.quotePath=false,測試要有含空白的 submodule 路徑。

    Residue

    (none)

    Vagueness Pre-check

    • V1: 2 — Expected 的三點各自指明行為:讀 <head> 記錄的 commit、沒取出時回 error、文件要寫什麼。
    • V4: 2 — Repro 四步可以直接寫成測試;唯一需要解讀的是 Expected 第二點的範圍,已記在 Choice Default Record。
    • Triggered: no — both axes ≤ 3

    Choice Default Record

    • Reason: unattended-auto-Step-4-choice-default
    • Decision: submodule 沒辦法搜尋時,links 什麼時候回 error。
    • Options: (a) 只有在某個 Example 的標記別處都找不到時才回 error(上表的三種結果);(b) 只要 <head> 有任何一個 gitlink 沒辦法搜尋就回 error,不論標記是否已在別處找到。
    • Default taken: (a)。它不會把「沒看過」讀成「沒有」,也不會讓一個與規格無關、沒取出的 submodule 擋住整個檢查。(b) 比較嚴格,之後要改成 (b) 只需要把條件放寬成一律檢查,已通過 (a) 的 repo 在取出所有 submodule 後結果相同。
  2. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    📊 For Reviewer / Collaborator

    現在:已結案(2026-11-16)。spec-change.py links 原本只在主 repo 找 Example 的標記,測試放在 submodule 時一律回 missing;現在它也讀 submodule 記錄的 commit,看不到的時候回 error。PR #572 以 squash 合併成 28e0de2,結案摘要是留言 6911419356。
    要知道的:(1) 已發布為 4.2.0(預設分支 6c26645,tag issue-driven-dev-v4.2.0)。(2) 最後一輪 verify 審的是 e5022f4;它後面的兩個 commit 只改測試檔的一列與 Example 的一列,沒有人獨立讀過,spec-change.py 沒有變。(3) 各輪留給別的 issue 的項目在 #554、#556、#558、#559。
    你該做什麼:無。

    last-updated by idd-update at → closed, 2026-11-16

  3. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-548-links-submodule-markers

    Spectra change idd-548-links-submodule-markers 已封存在 afd0021;進度見 openspec/changes/archive/2026-11-14-idd-548-links-submodule-markers/tasks.md。

    做了什麼

    • spec-change.py links 自己列出 <head> 的 gitlink,對每一個已取出、而且物件庫裡有記錄的 commit 的 submodule,在那個 commit 上搜尋標記;巢狀的 submodule 照同樣方式往下走。找到的檔案以「submodule 路徑/檔案路徑」套用既有的兩個排除(規格目錄底下、.md 結尾)。
    • 一個 Example 有三種結果:找到標記就算有連結;沒找到而且每個 submodule 都搜尋過,照舊回報 missing(why 文字不變);沒找到而且至少一個 submodule 搜尋不了,整個指令回 error,原因寫出 Example、submodule 路徑、是沒取出還是缺 commit。
    • 每一次 git grep 都帶 --no-recurse-submodules,所以使用者的 git 設定開了 submodule.recurse 時結果不變。這一點是封存前的 spectra-verify 指出、實測成立後補上的。
    • 沒有 gitlink 的 repo,輸出與結束碼和改動前相同。
    • 規格:requirement「Added and modified requirements carry an executable check」加一段 Submodules 與 Example「markers in submodules」(十五列)。
    • 文件:spec-change.py 檔頭的 links 說明、references/spec-wrapper.md 一句、CHANGELOG 的 Unreleased。

    怎麼驗證的

    • 先寫測試:第一批十列在改 script 之前,第 1、2、3、4、8、10 列失敗(20 項檢查),其餘通過;改完 474 項全過。第二批五列(第 11 到 15 列)在加 --no-recurse-submodules 之前,第 11、12 列的三項檢查失敗,其餘通過;加上之後 tests/spec-change/test.sh 497 通過、0 失敗。
    • 舊測試檔配新 script:431 通過、0 失敗,既有的檢查沒有少。
    • 沒有 gitlink 的 repo:對這個 repo 自己的三段歷史比對改動前後 links 的輸出與結束碼,逐位元組相同。
    • 整套測試(在第一批改動上):run-all-tests.sh 74 個 suite、0 個失敗;spectra-archive-post-ic 141 通過。封存後的 HEAD 上正在重跑一次,結果會補在這張 issue。
    • 連結檢查,從這條 branch 與 main 的分岔點 6ed8dec 到 afd0021:{"status": "ok", "missing": [], "reason": ""}。archived:pass。套用到規格的 requirement 與 delta 逐字相同(腳本比對)。
    • 在一個有五個 submodule、規格在主 repo 而測試在 submodule 的 repo 上實跑:改動前回報 missing,改動後回報 ok,一次約 2.6 秒。

    誰寫的

    測試、script 與文件的第一批由實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。第二批(--no-recurse-submodules、第 11 到 15 列的檢查、fixture 失敗時的訊息)是協調者自己寫的。兩批都還沒有經過獨立審查,接著跑 verify。

    無人值守時取的預設

    • submodule 搜尋不了時,只有在某個 Example 的標記別處都找不到時才回 error(Diagnosis 的 Choice Default Record)。等維護者確認。
    • 無法判定的 Example 不只一個時,只點名遇到的第一個;規格已照這樣寫。

    Commits(branch idd/548-spec-change-py-links-submodule-missing,還沒推)

    • 9ebccfd test:十列的檢查
    • aa067f0 feat:links 讀 submodule
    • 41fea78 chore:附件清單
    • ed0bb10 test:第 11 到 15 列
    • 4e0f47b fix:關掉 git 自己的遞迴
    • afd0021 chore:封存 change

    Next: verification pending

  4. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Verify: #548

    審的是這張 issue 的整條分支對預設分支的 diff:spec-change.py 的 marker_files() 與 cmd_links()、tests/spec-change/test.sh、references/spec-wrapper.md、CHANGELOG、規格 spec-on-every-issue 與封存的 change idd-548-links-submodule-markers。分支只在本機,還沒有推上來。

    Engine

    pai ensemble(parallel-ai-agents 2.26.0,profile custom):requirements、logic、security、regression 四席與 devil's advocate 用 Claude opus,另一席是 Codex(gpt-6.1-sol,xhigh)。devil's advocate 讀過前五席的結果,並自己重現了其中的主要項目。協調者另外在臨時 repo 上重現了第 1 列與第 2 列。
    6 / 6 reviewers completed

    Aggregate

    FAIL — 2 blocking, 10 in-scope fix, 1 follow-up, 0 rejected

    Reviewed: 6ed8dec5895f6c88a24aa0ecdf1e3b2b0e635bdd..afd0021434856a6fec3bde5fe2d06d63c8228a2d

    要求覆蓋率

    2 / 3 requirements addressed

    Expected 第一點(標記在 submodule 裡找得到,讀記錄的 commit)與第二點(沒取出或缺 commit 時回 error 並說明原因)成立。第三點只做到一半:規格與 references/spec-wrapper.md 有寫 submodule 要取出,spec-change.py 自己的說明沒有寫(第 10 列)。

    成立的部分

    • Example「markers in submodules」的十五列在 tests/spec-change/test.sh 各有檢查,分支上 497 項全部通過。requirements 席把新的測試檔配上改動之前的 script 重跑:第 1、2、3、4、8、10、11、12、13、14 列失敗,第 5、6、7、9、15 列通過,與封存的驗收紀錄一致。
    • 沒有 gitlink 的 repo,links 的輸出與改動之前逐位元組相同。
    • 規格檢查:issue 上的宣告是 change idd-548-links-submodule-markers;links 回 ok;archived 回 pass。
    • 整套測試在分支的 HEAD 上跑了兩次,都是 74 個 suite、0 個失敗;.claude/scripts/tests/spectra-archive-post-ic/test.sh 通過。
    • 走訪讀到的內容是對的:搜尋的是記錄的 commit,內容由雜湊決定。下面的問題不在「讀到什麼」,在「git 在哪裡執行」與「找到之後還做了什麼」。

    Findings(合併後)

    # Severity Finding Source Action
    1 HIGH links 會執行 commit 內容指定的指令。marker_files() 把「目錄存在、git rev-parse --show-toplevel 回報它自己」當成取出的 submodule,接著在裡面跑 git cat-file -e。一組一般的已追蹤檔案可以排成 git 目錄的形狀(沒有 .git);git 把它認成 repository、讀它的設定,在找不存在的 commit 時發動 lazy fetch,執行設定裡指定的指令。這個目錄可以放在 submodule 記錄的 commit 再記的一個 gitlink 路徑上,而 submodule 的工作樹停在另一個 commit,這正是 Example 第 4 列明文支援的狀態。devil's advocate 確認:主 repo 已經找到標記、結果是 ok 的時候,指令照樣執行。改動之前 links 只在主 repo 的頂層跑 git,所以這是這條分支帶進來的。封存的 design 寫「在 submodule 目錄裡只跑唯讀的 git 指令」,這句不成立:cat-file -e 與 grep 會向網路抓物件並寫入物件庫。 security + devil's advocate;協調者重現 Blocking
    2 HIGH 主 repo 已經找到標記的 Example,會被 submodule 走訪裡的失敗蓋掉。requirement 寫「When the marker of an Example is found, the Example has its check, whether or not every submodule could be searched」,程式卻在找到之後繼續走完每個 gitlink。三個觸發點都重現了:路徑不是合法 UTF-8 的 gitlink 讓 script 以 traceback 結束(沒有 JSON,結束碼 1);記錄的 commit 在而它的 tree 讀不到時回 error;部分 clone 的 submodule 在遠端連不到時回 error,遠端恢復後又回 ok。改動之前的 script 在這些情況都回 ok。封存的 design 把 submodule 裡的失敗寫成「照現行的 git grep failed 處理」,與 requirement 的這一句互相矛盾。另外,這時的原因文字帶著 git 的錯誤訊息,裡面可以有本機的絕對路徑,而這段文字會進 verify 報告。 regression + requirements + logic + security + Codex + devil's advocate;協調者重現 Blocking
    3 MEDIUM gitlink 的路徑直接接在目錄後面,沒有檢查是否留在 repo 之內。兩條路線都重現:tree 裡有名為 .. 的段(fsck 只給警告);或工作樹裡有一個指向外面的 symbolic link,而 tree 記錄的 gitlink 路徑經過它。os.path.islink 只看最後一段,擋不住後者。結果是 links 在受檢 repo 以外的 repository 跑 git,用的是那個 repository 的設定與物件庫;原因文字還會因為那個位置上有沒有工作樹而不同。讀到的內容仍然是對的,問題在 git 在哪裡執行。 security + devil's advocate In-scope fix
    4 MEDIUM rev-parse --show-toplevel 的輸出用 .strip() 處理,連路徑結尾的空白一起去掉。路徑結尾是空白的 submodule 已經取出、記錄的 commit 也有標記,卻被回報成 not checked out。Example 第 3 列只測了中間有空白的路徑。 Codex + logic In-scope fix
    5 LOW 掛在規格目錄底下、沒取出的 submodule,會讓找不到標記的 Example 回 error。它的檔案本來就不算,所有可能算數的檔案其實都讀過了,正確的結果是 missing。第 15 列只測了取出的情況。 logic In-scope fix
    6 LOW rev-parse 的每一種失敗都被報成 not checked out。繼承到的 GIT_DIR 會讓取出的 submodule 被回報成缺 commit;因為擁有者不同而被 git 拒絕開啟的 submodule、壞掉的 gitfile、不認得的 repository extension 也都標成同一個原因。issue 的 Expected 要 links 說明原因。status 不會因此變成錯的 ok 或 missing,錯的是原因。 logic + devil's advocate In-scope fix
    7 LOW submodule 裡有檔案內容讀不到時(commit 與 tree 都在),git grep 在錯誤輸出印出訊息、結束碼仍是 1,被當成「搜尋過、沒有標記」而回 missing。改動之前也是 missing,所以不是 regression,但新的 requirement 說沒讀完的不回報成缺少。 regression In-scope fix
    8 LOW 第 4、5 列的 fixture 在 submodule 工作樹做較新 commit 的兩行沒有失敗檢查。那個 commit 失敗時兩列仍然通過,而「工作樹在較新的 commit 上」這個條件已經不存在;改成搜尋工作樹 HEAD 的實作也會通過。 logic In-scope fix
    9 LOW design 規定目錄是 symbolic link 時算 not checked out,程式也這樣做,但 requirement 沒有寫這一條,Example 也沒有對應的列。 requirements + regression In-scope fix
    10 LOW spec-change.py 檔頭的說明只寫「找不到而有 submodule 搜尋不了時回 error」,沒有寫 submodule 要取出、要有記錄的 commit 才搜尋得了。issue 的 Expected 第三點要求 script 的說明也寫明。 requirements In-scope fix
    11 LOW tree 裡記成 submodule、.gitmodules 卻沒有對應項目的路徑,讓找不到標記的 Example 回 error,原因是 not checked out;references/spec-wrapper.md 叫人取出 submodule,而這種路徑無法取出。 regression In-scope fix
    12 INFO 原因文字列出每一個搜尋不了的 submodule 的完整路徑,沒有數量與長度的上限。路徑與數量由送 commit 的人決定,而這段文字會進 verify 報告與審查者的說明。 security In-scope fix
    13 INFO 在另外的 clone 或 idd-worktree.sh 建的 worktree 跑 verify 時,沒有任何步驟取出 submodule,links 會回 error。這是要的結果,原因也點名了 submodule;但只有 references/spec-wrapper.md 提醒要先取出,idd-verify 的文字沒有。不是這個 diff 的缺陷。 requirements Follow-up

    Scope Check

    改動都在 #548 的範圍內。沒有任何項目被擱置。

    以下三點是說明,不列成列。

    • 非 UTF-8 的 gitlink 當掉這一項,logic 與 Codex 各給 MEDIUM,security 給 LOW。devil's advocate 查過呼叫端:idd-verify 把沒有 JSON 的輸出讀成 error,references/spec-wrapper.md 第 5 步規定沒有印出 JSON 就停下,所以它是往保守的方向失敗。真正被破壞的是「主 repo 已找到標記」的情況,已經在第 2 列。
    • 封存的 design 與 proposal 寫的驗收條件是「十列」,Example 現在是十五列;tasks 4.1 記了補強的經過。封存檔不改。
    • issue 的 Diagnosis 記了一個無人在場時取的預設:submodule 搜尋不了時,只有標記到處都找不到才回 error。這個讀法對不對由維護者決定,這一輪沒有評。第 2 列說的是程式沒有照這個讀法做到底。

    接下來:依 /idd-all 的規則修正第 1 列到第 12 列(新的 Spectra change,先寫測試),再跑第二輪,也是最後一輪。第 13 列另開 issue。

  5. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed

    verify 報告(留言 6876450742)第 13 列:

    第 1 列到第 12 列在這條分支上修正(新的 Spectra change),修完跑第二輪。

  6. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening

    這一則取代先前的實作摘要:第一輪 verify(FAIL,2 項 blocking、10 項要修)之後的修正都在裡面。第二個 Spectra change idd-548-links-submodule-hardening 已封存在 7ad9152;進度與驗收紀錄見 openspec/changes/archive/2026-11-14-idd-548-links-submodule-hardening/tasks.md。

    第一輪之後改了什麼

    • 主 repo 找到標記就停。每個 Example 先搜尋主 repo;找到就不列 gitlink,也不在任何 submodule 目錄跑 git。標記都在主 repo 的 repository,輸出與這條分支之前相同(第 1、2 列的後半)。
    • 只在符合六個條件的目錄跑 git:記錄的路徑是相對路徑、沒有空的、. 或 .. 的段;解開 symbolic link 之後仍在主 repo 的工作樹之內;目錄本身不是 symbolic link;目錄底下有自己的 .git;git 回報它是自己工作樹的頂層;物件庫裡有記錄的 commit。前四個不成立時不在那裡跑任何 git 指令(第 1、3、9 列)。
    • 在 submodule 目錄跑 git 時一律加 safe.bareRepository=explicit、關掉 lazy fetch、拿掉六個繼承來的 GIT_* 變數(第 1、6 列)。檢查不向遠端抓任何東西。
    • submodule 開始搜尋之後才失敗的,算「搜尋不了」,不讓整個指令失敗,也不被讀成「沒有標記」(第 2、7 列)。原因是五種固定文字之一,不帶 git 的錯誤訊息;git 拒絕開啟的 submodule 有自己的原因,不再併入「沒取出」(第 6 列)。
    • 路徑照位元組處理,rev-parse 的輸出只去掉結尾的一個換行(第 2、4 列)。掛在規格目錄底下的 gitlink 略過(第 5 列)。原因最多列五個 submodule,依路徑排序,過長的路徑截斷(第 12 列)。
    • 測試:Example「markers in submodules」從十五列加到四十一列,每列都有檢查;第 4、5 列的 fixture 補上失敗檢查(第 8 列)。
    • 文件:spec-change.py 檔頭寫明 submodule 要取出並有記錄的 commit 才搜尋得了(第 10 列);references/spec-wrapper.md 補上檢查前先取出 submodule、部分 clone 要先備齊物件、沒有 .gitmodules 項目的路徑無法取出(第 11 列);CHANGELOG 的 spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548 條目改寫成最後的行為。
    • 第 13 列另開 idd-verify 與 worktree:在另外的 clone 或 worktree 跑 links 時沒有取出 submodule 的說明(#548 驗證第 13 列) #554。

    括號裡的列號是第一輪報告(留言 6876450742)的列。

    怎麼驗證的

    • 新測試檔配第一輪審過的 script(afd0021):587 通過、61 失敗。其中「植入的指令沒有執行」(第 21、22、31 列)與「沒有抓取」(第 32、33 列)在舊 script 上失敗,所以這些檢查分辨得出第一輪找到的問題。配新 script:648 通過、0 失敗。
    • 舊測試檔配新 script:afd0021 的 497 項與 6ed8dec 的 431 項都通過,既有的檢查沒有少。
    • 輸出不變的兩種 repo,新 script 對照 6ed8dec 的 script,輸出與結束碼逐位元組相同:沒有 gitlink 的 repo(這個 repo 自己的三段歷史);有 gitlink 而標記都在主 repo 的臨時 repo(含一個路徑不是合法 UTF-8 的 gitlink)。
    • 第一輪的兩個重現在新 script 上:路徑不是合法 UTF-8 的 gitlink、標記在主 repo → ok;形狀像 git 目錄的資料夾 → error、原因是 not checked out、指令沒有執行。
    • 變異測試:各拿掉一處防護再跑測試,共 22 種,21 種都有檢查失敗。唯一沒有的是留著 GIT_INDEX_FILE:這裡只讀記錄的 commit、不讀 index,留著它不改變任何輸出,寫不出會失敗的測試;design 把它記成明文例外。
    • 整套測試在最後的檔案上:run-all-tests.sh 74 個 suite、0 個失敗;spectra-archive-post-ic 141 通過。第一輪審過的 HEAD(afd0021)上的第二次整套測試也是 74 個 suite、0 個失敗。
    • 連結檢查,從分岔點 6ed8dec 到 7ad9152:{"status": "ok", "missing": [], "reason": ""}。套用到規格的 requirement 與 delta 逐字相同(腳本比對)。

    誰寫的、誰看過

    • 第 16 到 35 列的檢查、spec-change.py 的改動與文件:實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。
    • 以下是協調者自己寫的,寫在封存前的 spectra-verify 之後:submodule 搜尋「結束碼 0、只符合不算數的檔案、又有檔案讀不到」時算搜尋不了的那個分支;第 36 到 41 列;第 22 列記錄 git 呼叫的檢查;判斷檔案內容在不在物件庫的輔助函式。
    • 封存前的 spectra-verify 讀的是補強之前的檔案,而且沒有執行測試;它的三項 warning 都重現或確認後處理了(tasks 4.1)。
    • 協調者寫的那一部分沒有獨立讀者審過。第二輪 verify 請特別看它。

    無人值守時取的預設

    • submodule 搜尋不了時,只有在某個 Example 的標記別處都找不到時才回 error(Diagnosis 的 Choice Default Record)。這次的「找到就停」是把這個讀法做到底,沒有換讀法。等維護者確認。
    • 無法判定的 Example 不只一個時,只點名遇到的第一個。

    Commits(branch idd/548-spec-change-py-links-submodule-missing,還沒推)

    第一輪之前的六個(9ebccfd 到 afd0021)不變。第一輪之後:

    • 66beef4 test:第 16 到 41 列
    • 57ee7e2 fix:找到就停、只在取出的 submodule 跑 git
    • 7ad9152 chore:封存 change

    Next: verification pending

  7. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Verify: #548 (round 2)

    第二輪,也是最後一輪。審的是整條分支對預設分支的 diff,審查者另外拿到第一輪的表與第一輪之後三個 commit 的 diff。分支只在本機,還沒有推上來。

    Engine

    pai ensemble(parallel-ai-agents 2.26.0,profile custom):requirements、logic、security、regression 四席與 devil's advocate 用 Claude opus,另一席是 Codex(gpt-6.1-sol,xhigh)。devil's advocate 讀過前五席的結果,並自己做了變異測試與重現。協調者另外在臨時 repo 上重現了第 1 列的 (a)、第 2 列與第 4 列。
    6 / 6 reviewers completed

    Aggregate

    FAIL — 1 blocking, 6 in-scope fix, 1 follow-up, 0 rejected

    Reviewed: 6ed8dec5895f6c88a24aa0ecdf1e3b2b0e635bdd..7ad9152fa1dbd0714970754b97654c0274644a05

    要求覆蓋率

    3 / 3 requirements addressed

    issue 的三點 Expected 都成立(requirements 席逐點對照):讀記錄的 commit、搜尋不了時回 error 並說明原因、說明文件寫明 submodule 要取出。

    成立的部分

    • 第一輪的第 1 到 12 列都修好了。requirements 席逐列對照改動與 Example 的列;devil's advocate 另外確認。
    • 第一輪的兩項 blocking:形狀像 git 目錄的資料夾不再被當成 submodule,裡面設定的指令不執行;主 repo 已經找到標記時,不在任何 submodule 目錄跑 git。「不執行 commit 內容指定的指令」這一項由 Python 裡的檢查擋下,與 git 的版本無關(devil's advocate)。
    • 協調者自己寫的檢查做得到該做的事(devil's advocate 重跑):新測試檔配第一輪審過的 script 是 587 通過、61 失敗,其中標記檔的檢查、第 22 列的 git 呼叫紀錄、檔案內容有沒有被抓回的檢查都會失敗;拿掉排序、拿掉頂層比對、接受 .、留著兩個繼承的變數、主 repo 找到後繼續走訪,這六個變異分別被第 38、37、39、41、40、22 列擋下。判斷檔案內容在不在的輔助函式,對「在」與「被抓回」兩種情況都判得出來。
    • 規格檢查:issue 上的宣告是兩個 change;links 回 ok;archived 回 pass;套用到規格的 requirement 與 delta 逐字相同。
    • tests/spec-change/test.sh 648 項通過。diff 與封存的檔案裡沒有寫給審查者的指示。

    Findings(合併後)

    # Severity Finding Source Action
    1 HIGH requirement 寫了兩次主 repo 這一層不變(「a repository whose markers are all in its own files is checked exactly as before」「A repository whose head revision records no submodule is checked exactly as before」),而 cmd_links 有兩處改動讓沒有 submodule 的 repo 也得到不同的結果。(a) links 不再呼叫 repo_top(),改成自己讀頂層目錄、只去掉結尾的一個換行:頂層目錄名稱以空白結尾的 repo,分支之前回 error(原因是不實的「revision does not exist」),現在回正確的答案;archived 與 preflight 仍用舊的 repo_top(),所以同一個 repo 上三個子命令的判斷不一致。(b) except 擴大到整個 cmd_links:規格目錄底下有路徑不是合法 UTF-8 的 capability 時,分支之前以 traceback 結束(結束碼 1),現在回一行 error、結束碼 2,原因是 Python 的例外文字。另外,主 repo 找不到標記時多跑一次列 gitlink 的指令,失敗時的原因帶 git 的錯誤訊息;design 有寫,requirement 沒有。devil's advocate 的讀法:這幾處都是把舊的錯誤修好,沒有任何先前正確的答案被改掉,錯的是 requirement 那句話,以及驗收時用來比對的 repo 沒有這類名稱,所以量不出來;他認為該改的是那句話並補 Example 的列,不是把程式改回去。依審查規則(diff 裡的行為改變沒有任何 requirement 寫明),這一列是 HIGH。 regression + devil's advocate;協調者重現 (a) Blocking
    2 MEDIUM submodule 的搜尋失敗時,它底下的 submodule 不再被搜尋。marker_files() 有兩處在列出 gitlink 之前就跳到下一個:git grep 的結束碼不是 0 或 1,以及沒找到算數的檔案而有錯誤輸出。外層 submodule 少了一個無關的檔案內容、tree 仍讀得到,而標記在一個取出而且完整的巢狀 submodule 裡時,links 回 error、只點名外層;外層完整時回 ok。requirement 寫 submodule 的 submodule 的檔案算數,也寫一個 submodule 找到標記就確定了,沒有任何一句或任何一列 Example 說搜尋失敗的 submodule 的子項不看。方向是保守的:只會多回 error,不會給錯的 ok 或 missing。 Codex + requirements + logic + devil's advocate;協調者重現 In-scope fix
    3 MEDIUM 「找到的標記不被別處的失敗蓋掉」在 submodule 這一層沒有測試擋住。第 35 列的 fixture 先走到有標記的 submodule,才走到搜尋不了的那一個,所以「不論其他 submodule 的狀態」從沒被執行:把 cmd_links 的 if files: 改成 if files and not unavailable:,648 項仍然全過。另外,把錯誤輸出的檢查移到逐行比對之前(submodule 已經找到算數的檔案、同時有錯誤輸出時也算搜尋不了),648 項也全過。現行程式在兩種情況都是對的(實測回 ok),缺的是測試:第一輪第 2 列那一類缺陷若在 submodule 這一層重新出現,沒有檢查會失敗。協調者的變異表只拿掉防護,沒有涵蓋這個性質。帶標記的測試沒有執行它的 Example 所寫的事,依審查規則是 MEDIUM。 requirements + logic + devil's advocate In-scope fix
    4 MEDIUM submodule 的搜尋只要有任何錯誤輸出、又沒找到算數的檔案,就算「搜尋不了」,原因寫 its recorded commit could not be read。完全讀得到的 submodule 也會這樣:環境裡有 GIT_TRACE=1 或 GIT_TRACE2=1、submodule 裡有名稱像那個 commit 雜湊的分支(git 警告名稱有歧義)、有已淘汰的 grafts 檔(git 印出提示)。這時 missing 變成 error,而原因說的是一件程式沒有檢查過的事;requirement 的括號「(something could not be read)」也是。與第 2 列合起來,一個完全健康、標記在巢狀 submodule 的 repo,在 GIT_TRACE=1 之下從 ok 變成 error。design 的 Risks 把「警告也算進去」當成可接受的保守方向;regression 席認為那個理由站不住,給 MEDIUM,其餘各席與 devil's advocate 給 LOW。這個分支是協調者寫的。修法有兩種:只認 git 的 error: 與 fatal: 行;或不靠錯誤輸出,列出記錄的 commit 的每個檔案內容、確認都在物件庫裡。 regression + requirements + logic + security + devil's advocate;協調者重現 In-scope fix
    5 LOW links 依賴兩個 git 的功能而沒有檢查版本,也沒有寫明最低版本:safe.bareRepository(git 2.38 起)與 GIT_NO_LAZY_FETCH(security 席查到是 git 2.45 起;script 裡另一處註解寫支援 git 2.31)。較舊的 git 會忽略它們。第 31 列只靠 safe.bareRepository 擋,不過它的前提(一個空的 .git 目錄)不可能由 commit 的內容造出來。第 32、33 列與 CHANGELOG 的「nothing is fetched into submodules」在較舊的 git 上不成立:部分 clone 的 submodule 會向它自己設定的遠端抓物件,也可能停在等候輸入帳密。design 的 Risks 提到測試會在舊 git 上失敗,但那只保護這個 repo 的 CI,不保護使用者的執行。 security + logic + devil's advocate In-scope fix
    6 INFO 第一輪第 8 列只修了第 4、5 列的 fixture。第 11、12 列設定 submodule.recurse 的那一步沒有失敗檢查,之後也沒有確認設定生效;script 的答案本來就不依賴這個設定,所以設定沒寫進去時這兩列照樣通過。 devil's advocate In-scope fix
    7 INFO references/spec-wrapper.md 叫人在檢查前跑 git submodule update --init --recursive。在別人寫的分支上,這個指令會向那條分支的 .gitmodules 指定的位址抓東西,文字沒有提醒這一點。 security In-scope fix
    8 INFO 三件在這條分支之前就存在、主 repo 這一層的事:使用者的 git 設定把 color.ui 或 color.grep 設成 always 時,每個標記都被回報成 missing(輸出夾了色碼,舊 script 與新 script 都一樣);檔名裡有換行時,規格目錄底下的標記會被算進去;主 repo 裡帶標記的檔案內容讀不到時回 missing,而 submodule 裡同樣的情況現在回 error。 devil's advocate + security + logic Follow-up

    Scope Check

    改動都在 #548 的範圍內。沒有任何項目被擱置。

    以下三點是說明,不列成列。

    • 第 1 列的嚴重度有兩種讀法,都寫在列裡。協調者照審查規則列為 HIGH:requirement 的那句話與程式不一致,合併前要先決定改哪一邊。
    • 第 2 列與第 4 列,devil's advocate 都重現成立而評為 LOW,理由是方向保守、兩種結果都不是 ok。表上取各席裡最高的評級。
    • 第 2、4 列牽涉的那個分支,以及第 3 列說的變異表,是協調者在封存前自己寫的,當時沒有獨立讀者;這一輪就是它的第一次獨立審查。

    接下來:兩輪 verify 已經用完,這一輪之後不再自動修正,也不再開第三輪。第 1 到 7 列留在分支上等維護者決定;第 8 列另開 issue。

  8. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed

    第二輪 verify 報告(留言 6878222878)第 8 列:

    第 1 列到第 7 列留在這條分支上等維護者決定;兩輪 verify 已經用完,沒有自動修正,也沒有開第三輪。

  9. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Decision(2026-11-14,第二輪 verify 之後)

    維護者在選項式提問裡選了下面四項。問題與選項的文字是協調者寫的,維護者選了其中一個選項。

    1. 第二輪的 7 項怎麼處理:選「修完再審一輪 (Recommended)」。選項的說明:「我修這 7 項(新的 Spectra change、先寫測試),再跑一輪只審這批修正的六席審查。約一小時、約 200 萬 subagent token。不論結果都不再開下一輪。」
    2. 第 1 列改哪一邊:選「改規格那句話 (Recommended)」。選項的說明:「保留現在的行為。把那句話改成「先前答對的輸入,答案不變」,補兩列 Example,並讓 archived、preflight 兩個子命令用同一種讀法。」
    3. submodule 搜尋不了時何時回 error:選「標記找不到才回 error (Recommended)」。選項的說明:「現在的做法:別處已經找到標記就算通過;到處都找不到、又有 submodule 沒看過時,才回 error。」這確認了 Diagnosis 的 Choice Default Record 取的預設 (a)。
    4. 分支要不要推:選「只推分支 (Recommended)」。選項的說明:「推到 PsychQuant/issue-driven-development 的 idd/548 分支當備份,不開 PR。推之前我會先確認這個分支不會觸發任何部署。」

    接下來:推分支;第二輪的第 1 到 7 列以第三個 Spectra change 修正(先寫測試),然後跑第三輪,只審這批修正。第三輪之後不再開下一輪。

  10. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness

    這一則取代先前的實作摘要:第二輪 verify(FAIL,1 項 blocking、6 項要修;留言 6878222878)之後的修正都在裡面,方向依維護者的決定(留言 6878497822)。第三個 Spectra change idd-548-links-search-completeness 已封存在 726050b;進度與驗收紀錄見 openspec/changes/archive/2026-11-14-idd-548-links-search-completeness/tasks.md。

    第二輪之後改了什麼

    括號裡的列號是第二輪報告的列。

    • requirement 的兩處「checked exactly as before」改成可以檢查的句子(第 1 列,維護者選「改規格那句話」):主 repo 找到標記時不列 gitlink、不檢查 submodule;head 沒有記錄 submodule 的 repo 只搜尋自己追蹤的檔案。新增 requirement「The repository's top directory is read as git prints it」:links、archived、preflight 用同一個方式讀頂層目錄,只去掉 git 加的行尾,名稱以空白結尾的目錄三個子命令的判斷一致。規格目錄底下有路徑不是合法 UTF-8 時,回固定的原因,不帶例外文字。
    • submodule 的搜尋失敗之後,仍然列出它記錄的 gitlink,底下的 submodule 符合條件就照樣搜尋(第 2 列)。
    • 不再用 git 的錯誤輸出判斷 submodule 讀不讀得完(第 4 列)。搜尋之前先問 git 記錄的 commit 缺哪些物件(git rev-list --objects --no-walk --missing=print,不抓取)。缺物件的 submodule 照樣搜尋,找到算數的檔案就確定;沒找到時,缺物件、搜尋以 0 與 1 以外的結束碼結束、或 tree 列不出來,才算搜尋不了。
    • git 比 2.45 舊、或讀不出版號時,不在任何 submodule 的目錄跑 git,那個 submodule 算搜尋不了、原因是 git is older than 2.45(第 5 列)。主 repo 找到標記時不檢查版本。
    • 測試(第 3、6 列):Example「markers in submodules」從四十一列加到四十九列;「找到的標記確定這個 Example」在 submodule 這一層有兩列固定(第 44、45 列);第 11、12 列的 fixture 確認 submodule.recurse 真的設成了 true;第 22 列另外確認沒有列 gitlink 的呼叫,並附一個會留下這種呼叫的對照。
    • 文件(第 7 列):references/spec-wrapper.md 寫明取出 submodule 會連到那條分支的 .gitmodules 指定的位址,只在信任它時執行,並寫明最低的 git 版本;spec-change.py 檔頭與 CHANGELOG 的 spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548 條目改成最後的行為。
    • 第 8 列已另開 spec-change.py links:主 repo 這一層的三個既有缺口(顏色設定、檔名含換行、讀不到的檔案內容) #556,不在這次的範圍。

    怎麼驗證的

    • 新測試檔配第二輪審過的 script(7ad9152):724 通過、21 失敗。失敗的是非 UTF-8 那一列的原因、第 42、46、47 列、archived 與 preflight 的頂層目錄兩列,也就是第二輪指出的行為。配新 script:745 通過、0 失敗。
    • 舊測試檔配新 script:7ad9152 的 648 項、afd0021 的 497 項、6ed8dec 的 431 項都通過,既有的檢查沒有少。
    • 輸出不變的兩種 repo,新 script 對照 6ed8dec 的 script,輸出與結束碼逐位元組相同:沒有 gitlink 的 repo(這個 repo 自己的三段歷史);有 gitlink 而標記都在主 repo 的臨時 repo。
    • 第二輪的三個重現在新 script 上:submodule 完整、沒有標記,設不設 GIT_TRACE=1 都回 missing,而且是同一行;外層缺一個無關的檔案內容、標記在完整的巢狀 submodule 裡,回 ok;頂層目錄名稱以空白結尾的 repo 回 ok。
    • 變異測試 34 種,每種各改 script 一處:拿掉防護的 21 種,把性質改壞的 13 種(第二輪指出上一次只有前一類)。32 種各有檢查失敗。沒有的兩種在 design 記為明文例外,都沒有輸入能分辨:留著 GIT_INDEX_FILE;submodule 的 tree 列不出來時不另外記原因。
    • 整套測試在最後的檔案上、封存之前:run-all-tests.sh 74 個 suite、0 個失敗;spectra-archive-post-ic 141 通過。封存之後的 HEAD 上 tests/spec-change/test.sh 再跑一次,745 通過。
    • 連結檢查,從分岔點 6ed8dec 到 726050b:{"status": "ok", "missing": [], "reason": ""}(這條分支的 script 與已安裝的 4.0.1 都是這個答案)。套用到規格的兩個 requirement 與 delta 逐字相同(腳本比對)。

    與工作單不同的兩處

    • 工作單預期第 43 列在修改前的 script 上會失敗,實際上通過:外層搜尋失敗、標記哪裡都沒有時,修改前同樣回 error、只點名外層,所以這一列固定的是答案不變。分辨得出第二輪第 2 列的是第 42 列。預期寫錯,不是實作的問題。
    • 封存前重讀 delta,發現兩句話寫得比行為寬,已經限定在 submodule:「git 的錯誤輸出不改變答案」與「原因不帶 git 錯誤輸出的文字」。主 repo 搜尋失敗時的原因從這條分支之前就是 git grep failed: 加上 git 錯誤輸出的前 200 個字元,實測設了 GIT_TRACE=1 時那段文字會跟著變。這個行為沒有改,requirement 現在照實寫它,並有一列 Example 與兩項檢查固定。

    誰寫的、誰看過

    • 第 42 到 48 列與它們的檢查、「top directory names」的檢查、非 UTF-8 那一列、spec-change.py 的改動與文件:實作者模型(Codex)依工作單完成,協調者(Claude)在它寫不到的目錄驗收。實作者的工作在寫完程式與文件之後被中途停下,沒有交回報,所以它這一部分的檢查全部由協調者重跑。
    • 協調者自己寫的:把主 repo 搜尋失敗的原因改回這條分支之前的寫法(實作者把它縮成了固定文字;改回後那一行與 7ad9152 相同);第 49 列(物件在、但已損壞);第 47 列的第二種情況(讀不出的版號);「what the link check reports」裡主 repo 的 tree 讀不到的那一列與兩項檢查;requirement 裡上面說的兩句限定,以及「讀不出版號時也這樣回報」幾個字。
    • 協調者寫的那一部分沒有獨立讀者審過。第三輪 verify 請特別看它。

    無人值守時取的預設

    • submodule 搜尋不了時,只有在某個 Example 的標記別處都找不到時才回 error:維護者已確認(留言 6878497822)。
    • 無法判定的 Example 不只一個時,只點名遇到的第一個。

    Commits(branch idd/548-spec-change-py-links-submodule-missing,已推,沒有開 PR)

    第二輪之前的九個(9ebccfd 到 7ad9152)不變。第二輪之後:

    • 1da57e1 test:第 42 到 49 列、頂層目錄、補強的檢查
    • f8fde3a fix:問 git 缺哪些物件、搜尋失敗後仍列 gitlink、版本檢查、頂層目錄的讀法
    • 726050b chore:封存 change

    Next: verification pending

  11. kiki830621 commented on Nov 14, 2026

    @kiki830621
    MemberAuthor

    變異測試清單(第三個 change 的驗收)

    第三輪 verify 的 requirements 一席指出,封存的 tasks.md 只記了變異測試的總數(34 種、32 種有檢查失敗),沒有逐項的結果,而且它寫的「把性質改壞的 13 種」與 design 列的 11 種對不上。封存的檔案不再修改,所以清單補在這裡。

    • 做法:每一種各改 plugins/issue-driven-dev/scripts/spec-change.py 一處,在複本上執行 bash plugins/issue-driven-dev/scripts/tests/spec-change/test.sh,看有沒有檢查失敗。script 與測試檔是 f8fde3a、1da57e1 的內容。
    • G 是拿掉一處防護,21 種:第二個 change 的 22 種重新對位,原來的第 8 種(不看 submodule 搜尋的錯誤輸出)已經沒有對應的程式,所以沒有 G08。
    • P 是把一個性質改壞,13 種。design 的清單列了 11 種,少的兩種是 P09(design 寫在例外那一段)與 P10。數字對不上是紀錄寫得不一致,不是少跑。
    • 沒有檢查失敗的兩種(G20、P09)是 design 記為明文例外的那兩種。

    括號裡是失敗的檢查所屬的列(Example「markers in submodules」的列號,或檢查的名稱)。

    • G01 keep walking after a marker is found in the main repository: 3 checks fail (row 22; row 48)
    • G02 no .git entry required: 1 checks fail (row 21)
    • G03 no safe.bareRepository: 1 checks fail (row 31)
    • G04 lazy fetch left on: 1 checks fail (row 33)
    • G05 no containment checks: 10 checks fail (row 23)
    • G06 strip() on the top that git reports for a submodule: 2 checks fail (row 25)
    • G07 inherited GIT_* variables kept: 7 checks fail (row 28; row 40; row 41)
    • G09 gitlinks under the spec directory not skipped: 3 checks fail (row 26)
    • G10 strict UTF-8 for gitlink paths: 1 checks fail (row 17)
    • G11 every unsearchable submodule listed: 3 checks fail (row 29)
    • G12 long paths not cut: 2 checks fail (row 34)
    • G13 only the symbolic-link test removed: 3 checks fail (row 27)
    • G14 git's refusal reported as not checked out: 2 checks fail (row 30; row 31)
    • G15 unsearchable submodules not sorted: 1 checks fail (row 38)
    • G16 a '.' component accepted: 1 checks fail (row 39)
    • G17 GIT_WORK_TREE kept: 2 checks fail (row 40)
    • G18 GIT_OBJECT_DIRECTORY kept: 2 checks fail (row 40)
    • G19 GIT_COMMON_DIR kept: 2 checks fail (row 40)
    • G20 GIT_INDEX_FILE kept (reading a commit does not use the index: no input can show it): no check fails
    • G21 GIT_ALTERNATE_OBJECT_DIRECTORIES kept: 3 checks fail (row 41)
    • G22 the top that git names for a submodule is not compared: 4 checks fail (row 37)
    • P01 a found marker does not settle the Example when a submodule could not be searched: 4 checks fail (row 42; row 44)
    • P02 a file found in a submodule that lacks objects does not count: 2 checks fail (row 45)
    • P03 the submodules inside an unreadable submodule are skipped: 2 checks fail (row 42)
    • P04 output on git's error stream counts as unreadable again: 5 checks fail (row 46)
    • P05 the git version is not checked: 8 checks fail (row 47)
    • P06 repo_top strips white space again: 9 checks fail (top directory names: links trailing space; top directory names: links; top directory names: archived trailing space)
    • P07 the object store is not asked which objects it lacks: 12 checks fail (row 20; row 36)
    • P08 a search of a submodule that exits with another code is not a failure: 4 checks fail (row 49)
    • P09 a tree of a submodule that cannot be listed is not reported: no check fails
    • P10 the reason for a non-UTF-8 path under the spec directory is the exception text: 1 checks fail (invalid-UTF-8 spec path)
    • P11 a version that cannot be read counts as new enough: 4 checks fail (row 47)
    • P12 the main repository's failed search loses git's message: 2 checks fail (unreadable main tree)
    • P13 the main repository's failed search reports git's whole message, not its first 200 characters: 1 checks fail (unreadable main tree)

    已知的不足:P13 的檢查只比對原因的長度。第三輪發現把「前 200 個字元」改成「後 200 個字元」時沒有檢查失敗(報告的第 5 列),這一種變異不在上面的清單裡。

  12. 52 remaining items

  13. kiki830621 commented on Nov 15, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness, idd-548-links-unreadable-objects, idd-548-one-top-directory-requirement, idd-548-fix5, idd-548-fix6, idd-548-fix7

    這一則取代先前的實作摘要。第七輪 verify(留言 6893428419)確認第七個 change 本身沒有問題,但找到一個更早就有的缺陷,落在兩行程式(2 項 blocking),另有兩句條文要改。維護者 2026-11-15 的決定記在留言 6894347661:改程式,再審一輪。四項都用第八個 Spectra change idd-548-fix7 處理,封存在 e5022f4,進度與驗收紀錄見 openspec/changes/archive/2026-11-15-idd-548-fix7/tasks.md。這個 change 另外多做了一步,是協調者在送審前自己找到的,決定記在留言 6894894048。

    第七輪之後改了什麼

    • 第 1、2 列(blocking):第 5 個條件與第 2 個條件的前半用路徑字串比對。 程式改了。現在從解析後的目錄逐層往上走,每一層與頂層目錄比對裝置與 inode;遇到頂層目錄就算「在頂層目錄底下」,走到根還沒遇到就是 path leaves the repository。沿路經過的目錄就是拿來與那兩個 git 目錄比對的清單。git 回報的頂層與那個目錄,也用同一種方式比對。同一個目錄的另一種拼法(不分大小寫的磁碟上的另一種大小寫、macOS 的 /System/Volumes/Data/…)因此不再被當成另一個目錄。第七輪協調者的兩個重現(上游只改大小寫之後 pull;link 的目標寫成另一種拼法)現在都回 ok。
    • 第 3、4 列:條文的兩句。 「submodule 的 git 目錄不在清單上」改成「不另外把任何 submodule 的 git 目錄加進清單;它是那兩個目錄之一或在其中之一底下時,第 2 個條件照寫的適用」。第 2 個條件的子句加上「除非它就是頂層目錄」,後面那一句補上頂層目錄就是那兩個目錄之一的情形。
    • 條文另外加的兩句。 一句說明第 2、5 個條件比對的是目錄(作業系統對兩個路徑回報同一個裝置與同一個 inode),一句說明往上走時檢查不到的目錄(例如不存在)略過。
    • 多做的一步:實際落在規格目錄裡的 submodule 不搜尋,不論它的路徑叫什麼。 只改上面兩個條件,會讓一種輸入從 error 變成 ok:gitlink 記在 OPENSPEC/specs/sub、clone 落在規格目錄 openspec/specs/sub 裡(它原本回 error 的原因正是第 5 個條件比對名稱)。另一個形狀,路徑經過一個指進規格目錄的 link,從這條分支的第一個 change 起就回 ok,前七輪沒有人建過。Example 第 15 列說放在 openspec/ 底下的 submodule 回 missing。現在第 1、2 個條件通過之後,往上走經過的目錄裡有規格目錄時,這個 submodule 不搜尋,也不算搜尋不到;兩個形狀都回 missing,git 不在那個目錄執行。後一個形狀的答案因此從 ok 變成 missing。「Submodules」一段加了三句。
    • Example「markers in submodules」多了第 60 到 65 列。 60:link 的目標把頂層目錄寫成另一種大小寫(ok)。61:樹裡記的路徑與磁碟上的目錄只差大小寫(ok)。62:link 指到頂層目錄之外、目標用另一種大小寫(error,git 不在那裡執行)。63:第 55 列的輸入改用這種 link(error,git 不在那裡執行,而且這次是由 git 目錄的比對擋下的)。64:路徑把規格目錄寫成另一種大小寫(missing)。65:link 指進規格目錄(missing)。
    • 同一句話的其他地方:script 開頭的說明、函式的 docstring、CHANGELOG 的 spec-change.py links:標記在 submodule 的測試檔裡時找不到,一律回報 missing #548 條目、測試檔第 57 列的註解。
    • 測試檔第 58 列的 fixture(上一個 change 的列):它原本用 git rev-parse --is-inside-git-dir 確認頂層目錄在 git 目錄裡。這個配置下 git 2.55.0 回 true、git 2.54.0(macOS 內附的)回 false,舊的 git 在 PATH 前面時整個測試檔停在那裡。改成直接看檔案系統。這是量檢查項數時發現的,沒有改任何對 script 行為的檢查。
    • 第 5、6 列是後續項目,沒有在這條分支上改。

    怎麼驗證的

    • 測試先寫,兩次。第 60 到 63 列的 commit(c3b5798)在程式修改(54d1775)之前:在 c3b5798 上測試檔 859 項通過、9 項失敗,失敗的是第 60 列的三項、第 60 列改用 /System/Volumes/Data 拼法的兩項、第 61 列的三項、第 63 列「git 被問過那兩個目錄」的一項。第 62 列與第 63 列的其他檢查修改前後都通過:第 62 列寫的是原本就有的行為;第 63 列的答案原本就對,但原本是被字串比對擋下的。第 64、65 列的 commit(65f7a17)在規格目錄的檢查(9fb5cc1)之前:870 項通過、8 項失敗,兩列各四項。
    • 修改之後:tests/spec-change/test.sh 878 項通過(spectra 在 PATH 上、不分大小寫的磁碟),git 2.55.0 與 git 2.54.0 各跑一次都是。整套 run-all-tests.sh:跑了三次,都是 75 個 suite、0 個失敗、結束碼 0:封存前的 e01674e(第二步之前)與 f6fe368,以及封存之後的 e5022f4。.claude/scripts/tests/spectra-archive-post-ic/test.sh:三次都是 141 項通過、0 項失敗。
    • 第 60 到 64 列需要同一個目錄的兩種拼法,只在不分大小寫的磁碟上執行。在區分大小寫的磁碟映像上跑測試檔:845 項通過、0 項失敗,印出略過這五列的說明;PATH 上沒有 spectra 時是 876 項(不分大小寫)與 843 項(區分大小寫)。所以這五列的「測試先寫、先失敗」只在不分大小寫的磁碟上看得到,Linux 上的 CI 看不到它們;第 65 列在任何磁碟上都執行。
    • 變異,各改 script 一處,記下哪些檢查失敗:第 2 個條件改回字串比對時,是第 60 列與第 63 列的一項;第 5 個條件改回字串相等時,是第 60、61 列;拿掉與 git 目錄的比對時,是第 55、56、63 列與「git 不回答 common 目錄」的檢查;走到根也算遇到頂層目錄時,是第 24、62 列;把頂層目錄與它的上層也拿去比對時,只有第 58 列;與 git 目錄的比對改回名稱時,只有第 63 列;檢查不到的目錄不略過時,是第 17、34、38、57 列各一項;拿掉規格目錄的檢查時,是第 64、65 列。第 60 列的輸入要第 2、5 個條件兩處都改了才回 ok,所以前兩種變異都讓它失敗。
    • 只推理過、沒有跑過的配置,這次跑了:頂層目錄就是 git 目錄時,解析後等於頂層目錄的路徑不被第 2 個條件拒絕(頂層沒有 .git 項目時由第 4 個條件回 not checked out,有的時候回 ok,與第七輪的 script 相同);submodule 的 git 目錄就是那兩個目錄之一時,它底下的目錄回 path leaves the repository,git 不在那裡執行。
    • git 呼叫次數沒有變:有一個取出的 submodule 時 20 次,標記在主 repo 時 11 次(那兩個問題仍然只在遇到頂層目錄之後才問)。
    • 連結檢查,從預設分支(3b87909)到 e5022f4:{"status": "ok", "missing": [], "reason": ""}(這條分支的 script 與已安裝的 4.1.0 都是)。archived 的結果在下一則驗證報告的規格檢查(這一則貼出之後才能對它執行)。

    這次沒有改、仍然比對名稱的地方

    • --cwd 只交給 git 找頂層目錄,換一種大小寫答案不變。
    • 「同一個目錄、同一個 commit 只搜尋一次」的鍵仍是解析後的路徑字串。同一個目錄以兩種拼法各記一次時會搜尋兩次,答案相同。
    • 主 repo 自己的檔案在規格目錄底下的排除,與 .md 的排除,照條文看的是樹裡記的名稱。主 repo 的檔案記在 OPENSPEC/specs/cap/check.sh、帶標記時,從 4.1.0 起就回 ok,現在也是;它取出來會落在規格目錄裡,與上面 submodule 的處理不一致。改它會改變沒有 submodule 的 repository 的答案,超出這張的第三點 Expected,記在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559。

    協調者另外找過答案從 error 變成 ok 的輸入。找到的都是第 60、61 列的形狀與既有各列的組合(第 59 列的形狀經由另一種拼法;兩個 gitlink 指同一個目錄),以及上面已經處理的規格目錄那一種。

    已知的限制

    誰寫的、誰看過

    • 第八個 change 的文件、規格差異、測試、程式都由協調者(Claude)撰寫,沒有實作者模型,也沒有獨立讀者。第八輪 verify 是第一次獨立審查。
    • 規格目錄那一步與第 58 列的 fixture 是協調者送審前自己找到的,不是審查席的發現。規格目錄那一步超出維護者點名的範圍,是協調者依委託做的決定(留言 6894894048),維護者可以推翻。

    Commits(branch idd/548-spec-change-py-links-submodule-missing,已推,沒有開 PR)

    第七輪之前的三十六個(9ebccfd 到 941f881)不變。第七輪之後:

    • c3b5798 test:第 60 到 63 列的 fixture 與檢查,連同這個 change 的文件(這個 commit 上第 60、61 列失敗)
    • 54d1775 fix:第 2、5 個條件改成比對目錄
    • e01674e docs:CHANGELOG 與第 57 列的註解
    • 65f7a17 test:第 64、65 列(這個 commit 上兩列都失敗)
    • 9fb5cc1 fix:落在規格目錄裡的 submodule 不搜尋
    • 338da27 docs:CHANGELOG
    • f6fe368 test:第 58 列的 fixture
    • 驗收紀錄與工作單、封存 change(到 e5022f4)

    Next: verification pending

  14. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    Verify: #548 (round 8)

    第八輪。維護者在第七輪之後決定「改程式,再審一輪」(留言 6894347661),這一輪就是那一輪。範圍與前幾輪相同:預設分支(4.1.0)到分支最新的 commit e5022f4,重點放在第七輪之後的第八個 change idd-548-fix7(實作摘要是留言 6895459368)。這個 change 除了維護者點名的修正,還多做了一步(落在規格目錄裡的 submodule 不搜尋),是協調者依委託做的決定(留言 6894894048);審查者被明白告知這一步超出點名的範圍,可以反對。

    Engine

    六席都交出了結果,各啟動一次,沒有席位被切斷。四個 Claude 審查席(requirements、logic、security、regression)與裁定席(devil's advocate):Claude Fable 5.2、effort medium、fast mode 關,用 Claude Agent SDK 以 API key 執行,不載入協調者這一端的設定。第六席是另一個模型家族:OpenAI gpt-6.1-sol,單次請求、沒有工具,讀整份 diff 與 head 的 script。

    裁定席讀過其他五席的結果之後再審,自己另外建輸入重跑。協調者撰寫了這個 change,所以不分級;協調者只提供事實紀錄:先前量測的輸出、跨模型一席三個重現步驟用三份 script 實跑的結果,以及其中一項已經記在 #556 的出處。

    6 / 6 reviewers completed

    Aggregate

    PASS — 0 blocking, 0 in-scope fix, 9 follow-up

    Reviewed: 3b87909eb6db40ea89630665a172918270b738ad..e5022f43abfd692bc69a63221f2335014414330f

    要求覆蓋率

    3 / 3 requirements addressed

    issue 的三點 Expected,requirements 一席在它建的輸入上逐點實跑,都成立。第二點有一個條文寫明的例外(落在規格目錄裡的 submodule 回 missing,不回 error),這個例外在 head 比第七輪寬,見下面「多做的那一步」。

    成立的部分

    • 第七輪的四列都解決了。
      • 第 1、2 列(第 5 個條件與第 2 個條件的前半用路徑字串比對):裁定席重建了兩個重現。上游只改大小寫之後 pull,head 回 ok(第七輪的 script 回 error);link 的目標寫成另一種大小寫、/System/Volumes/Data 的拼法、Unicode 的另一種正規化形式,head 都回 ok(第七輪都回 error)。它另外試了沒有人列過的輸入(樹裡記的是 NFD 而磁碟上是 NFC、掛載在工作目錄裡的另一個磁碟、沿路有一層沒有搜尋權限的目錄),答案都是條文寫的那一個。logic 用 30 種兩種拼法的輸入對照第七輪的 script,head 的答案每一種都是條文寫的。security 用 20 種配置,把 clone 放在不該進去的地方,再用另一種拼法指過去:每一種都回 error,git 沒有在那個目錄執行。裁定席對「沒有第二種拼法能打開被拒絕的目錄」約九成的把握,對「第 1、2 列在一般使用者或 git 會產生的拼法上完全解決」約八成五。
      • 第 3、4 列(條文的兩句):裁定席與 requirements 各自在那兩列點名的配置上實跑(主 checkout 被記成 gitlink、第 59 列的形狀、頂層目錄就是 git 目錄),兩句現在照字面都成立。裁定席約九成的把握。
    • 測試先於程式,兩次都成立(requirements 實跑):c3b5798 上測試檔 859 項通過、9 項失敗,正是實作摘要列的九項;65f7a17 上 870 項通過、8 項失敗,是第 64、65 列各四項;head 上 878 項全過。這個證據只能用 git 2.55.0 重現:用 macOS 內附的 git 2.54.0 時,那兩個 commit 的測試檔停在第 58 列的 fixture(之後在 f6fe368 修掉),head 不受影響。regression 另外交叉跑:第七輪的測試檔對 head 的 script 是 840 項全過;head 的測試檔對第七輪的 script 是 861 項通過、17 項失敗,正是上面的 9 項加 8 項。
    • 變異(regression 逐行讀過協調者的變異腳本,再自己跑八種):每一種失敗的檢查與協調者記的完全相同。它另外指出兩件事:第七種只靠原因的文字被抓到(status 仍是 error);in_spec_directory() 裡讀不到目錄時的兩個分支不在八種裡面,它在那個函式另做一種變異(規格目錄改用 lstat 取),878 項全過,見下表第 3 列。
    • Example「markers in submodules」的 65 列在 head 上都有執行過並通過的檢查,每一列測試期望的 status 與表的第三欄相同;第 60 到 64 列在這台機器的磁碟上有執行(requirements 以腳本逐列比對)。
    • 與第七輪的 script 逐位元組比對(regression):122 組一般輸入裡 120 組完全相同,不同的 2 組是第 61 列的形狀,差別正是第 5 個條件現在寫的。archived 與 preflight 沒有任何不同。在協調者的兩個量測輸入上,git 呼叫次數與第七輪相同(標記在 submodule 時 20 次、在主 repo 時 11 次;logic 重跑得到同樣的數字,它另建的一個輸入兩份 script 都是 38 次)。那兩個問題仍然只在遇到頂層目錄之後才問、整次只問一次。答案沒有變而次數不同的,logic 列了第 63 列寫的那一種:第七輪照名稱就拒絕的路徑,head 先問那兩個問題再拒絕(14 次對 12 次)。答案變了的輸入次數也跟著不同;每一層都有兩種拼法時的增長見下表第 5 列。
    • 往上走的迴圈(logic):目錄就是頂層、目錄或中間一層不存在、沒有搜尋權限、link 成環、指到外面的斷掉的 link、頂層目錄名稱以空白結尾、經由 link 走到頂層,每一種都會結束,答案都是條文寫的。
    • 安全(security 實跑):第一輪建立的兩個性質在 head 仍然成立:submodule 是部分 clone 時沒有被觸發去抓取,commit 裡惡意的 .gitmodules 與 .gitattributes 沒有讓任何程式執行。主 repo 自己是部分 clone 時,一次 links 留下 3 行抓取紀錄,head、第七輪與 4.1.0 都一樣:來自主 repo 原本就有的呼叫,新加的那兩個問題單獨執行是 0 行。這比這條分支早,security 不列為這一輪的發現。目錄比對只呼叫 realpath、stat、samefile,不開檔、不啟動程式;commit 的內容只能透過 checkout 放到磁碟上的東西(一個被追蹤的 link、另一種大小寫的路徑)影響它,security 建的這類配置,在執行期間沒有人改動工作目錄時,不是被拒絕就是被略過,git 都沒有在不該進去的目錄執行。比對與之後的 git 指令之間有時間差,與第七輪是同一種。security 用會在中途換掉 link 的 git 替身跑了三種:link 換成指進主 repo 的 git 目錄、換成指到頂層目錄之外時,head 與第七輪的 script 都回 ok,帶防護的 git 指令在換過去的目錄執行了 5 次;換成指進規格目錄時,第七輪回 ok(5 次),head 回 missing(0 次)。所以 head 沒有比第七輪寬,有一種比較窄。security 不把它列為發現:要做到這件事,得在執行期間能改寫主 repo 的工作目錄,有這個權限的人本來就能改 repo 自己的設定。第 60 到 65 列的 fixture 中途失敗時(七種各跑一次)不會動到測試暫存目錄之外。
    • 多做的那一步(落在規格目錄裡的 submodule 不搜尋):實作摘要列的兩個形狀在 head 都回 missing,git 不在那個目錄執行。security 另外試了六種走進規格目錄的方式(例如巢狀、各層用另一種大小寫、/System/Volumes/Data、經由 link 走到規格目錄),都擋住;它也反過來找這條規則能不能被用來把該回 error 的變成 ok,沒有找到:被略過的 submodule 只會離開搜尋,ok 需要找到標記。logic 用約二十種輸入(規格目錄設在別處、規格目錄不存在、submodule 自己有 openspec/、同時不符合第 1 或第 2 個條件)找「規格目錄之外的被略過」或「裡面的被搜尋」,在規格目錄是真的目錄時沒有找到。裁定席裁定這一步照字面寫明了、與程式相符、不是缺陷,而且分支有它比沒有好(約八成五):沒有它,第 5 個條件的修正自己會讓規格目錄裡的一個標記開始算數。它超出維護者點名的範圍這件事是授權的問題,由維護者確認或推翻。
    • 整套測試(regression 在 head 實跑):75 個 suite、0 個失敗;spec-change 878 項通過;另一個 suite 141 項全過。用 git 2.54.0 跑 head 的測試檔也是 878 項全過。在區分大小寫的磁碟映像上是 845 項全過,印出略過第 60 到 64 列的說明;少跑的 33 項就是這個 repo 的 CI 會少跑的。
    • 封存與規格檢查(regression):idd-548-fix7 已封存,delta 與現行 requirement 逐字相同,規格的其他部分與第七輪逐位元組相同;links 從預設分支到 head 回 ok(分支的 script 與 4.1.0 都是),archived 回 pass。
    • 協調者的其他四個選擇(主 repo 的檔案仍照名稱排除、第 60 到 64 列只在不分大小寫的磁碟上執行、只搜尋一次的鍵仍是路徑字串、兩句關於讀不到的目錄的話):裁定席裁定都不是缺陷,是維護者的事,其中三件已記在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559。

    Findings(合併後)

    # Severity Finding Source Action
    1 LOW in_spec_directory() 沒有確認規格目錄的路徑是目錄。工作目錄裡的 openspec 被換成一般檔案、某個 gitlink 的路徑又是那個檔案的硬連結時,那個 gitlink 被當成落在規格目錄裡而略過,links 回 missing;第七輪的 script 回 error(not checked out),4.1.0 回 missing。對照(不是硬連結的一般檔案)仍回 error。規格目錄是目錄時不會發生(在這個檔案系統上目錄不能有第二個硬連結)。有兩種讀法:條文把「同一個目錄」定義成作業系統回報同一個裝置與 inode,照這個定義 missing 是寫明的答案;認為兩個路徑都不是目錄的讀者,會說這個答案沒有被寫明。改法是一行(確認是目錄)或條文的一個子句。 跨模型一席(HIGH,閱讀);協調者照它的步驟用三份 script 實跑,結果如它所預測;裁定席重建後定為 LOW(對 LOW 約七成,取第一種讀法約六成五) Follow-up
    2 LOW 工作目錄裡的 openspec 被換成指到頂層目錄的 link 時,條文的兩句有兩種讀法:前一句說目錄「是規格目錄或在它底下」的 submodule 不搜尋,後一句說規格目錄是「遇到頂層目錄之前經過的目錄之一」;頂層目錄永遠不在經過的目錄裡,所以程式照樣搜尋(ok,與第七輪相同)。把後一句讀成前一句的定義就沒有矛盾。spec_dir 寫成 . 之類的值三份 script 都拒絕,所以只有工作目錄與 commit 不同時才走得到。可加一個子句:規格目錄就是頂層目錄或在它之上時,沒有東西算在它底下。 跨模型一席(MEDIUM,閱讀);協調者實跑;裁定席重建後定為 LOW(取「後一句是定義」的讀法約七成) Follow-up
    3 LOW 工作目錄裡的 openspec 是指到另一個目錄的 link 時,那個目錄底下一般的 submodule 從 ok(第七輪)變成 missing(head),4.1.0 也是 missing。原因是程式用會跟著 link 走的 stat 取規格目錄。條文只對 submodule 的目錄說了「解析 link 之後」,沒有對規格目錄說;沒有任何一列或檢查分得出兩種讀法(改用 lstat 的變異 878 項全過)。實作摘要沒有列這個形狀。可在條文寫明規格目錄也是解析 link 之後的目錄,或加一列。 regression(LOW,並指出照另一種讀法會是 HIGH);logic、security、requirements(觀察);裁定席重建後定為 LOW(約七成) Follow-up
    4 LOW 落在規格目錄裡的檔案,經由一個目錄不在規格目錄裡的 submodule 被叫到時仍然算數(submodule 的目錄在規格目錄之上,或解析後就是頂層目錄)。照條文這是寫明的:排除看的是「submodule 的路徑加檔案的路徑」這個名稱。其中兩個輸入用另一種大小寫時,因為第 2、5 個條件的修正從 error 變成 ok。實作摘要提過這類輸入會從 error 變成 ok(第 60、61 列的形狀與既有各列的組合,含第 59 列的形狀經由另一種拼法),沒有說的是這樣算進去的標記可以落在規格目錄裡。這與已記在 #559 的「主 repo 的檔案照名稱排除」是同一個問題,只是換成 submodule 的檔案。 logic(LOW)、security(LOW),兩席同級;裁定席確認(約八成) Follow-up
    5 LOW 每一層都把同一個目錄以兩種拼法各記一次時,搜尋次數是 2 的(深度加一)次方減一(深度 1 到 5 是 3、7、15、31、63 次)。答案正確、一定會結束,只是花時間。修正之前第二種拼法過不了第 5 個條件,所以走不到。#559 記的「多搜尋一次」只對一層成立。 logic(實跑);裁定席 Follow-up
    6 LOW script 檔頭與 CHANGELOG 的 #548 條目寫「no other directory is excluded」,少了 requirement 那一句的「under that condition」;兩處在幾行之後又寫了規格目錄的排除。只是文字,程式與條文一致。 requirements;裁定席(可以在合併時或之後補,不列為條件) Follow-up
    7 LOW link 的目標用 macOS 的 volfs 寫法(/.vol/<裝置>/<inode>)指到頂層目錄裡的目錄時,仍然回 error(path leaves the repository),與第七輪相同:realpath 不會改寫這種路徑,往上走是照名稱取上一層,走不到頂層目錄。條文的「its parent directory」有兩種讀法;取名稱上的上一層時(條文接著說「不存在的目錄略過」,只有照名稱走才會遇到不存在的目錄),程式照條文做。方向是保守的;用這種寫法指進 git 目錄或規格目錄也都被拒絕。這種 link 含裝置與 inode 編號,沒辦法經由 commit 分享。 裁定席自己的發現(實跑;取這種讀法約六成五,並說明採另一種讀法的維護者應該比照第七輪第 2 列分級) Follow-up
    8 INFO 主 repo 的檔名含換行時,規格目錄底下的標記會被算進去。成立,但 4.1.0 就是這樣(三份 script 都回 ok),而且已經記在 #556 的第 2 點;跨模型一席拿到的材料沒有 #556 的全文。不是這一輪的新發現。 跨模型一席(MEDIUM,閱讀);協調者實跑並查到出處;裁定席 Follow-up
    9 INFO 沒有人做到的:這條分支仍然沒有在 Linux 或這個 repo 的 CI 上跑過,第 60 到 64 列在那裡會被略過,所以第 1、2 列的修正只在開發者的 macOS 磁碟上有測試守著;git 2.45 到 2.53 沒有人試;Linux 的 bind mount 沒有人試;頂層目錄名稱以換行結尾的情形 logic 沒有跑成。另一個觀察:樹裡記在 OPENSPEC/x、沒有取出的 submodule,在不分大小寫的磁碟上回 missing,在區分大小寫的磁碟上回 error,同一個 commit 在兩種磁碟上答案不同。 裁定席;logic;requirements(觀察) Follow-up

    Scope Check

    分支的改動都在 #548 與八個封存的 change 的範圍內。

    多做的那一步超出維護者點名的範圍,已在決定留言說明。它改變的答案比實作摘要列的兩個形狀多(實作摘要列的是:link 指進規格目錄,ok 變 missing;用另一種大小寫記在規格目錄裡,error 變 missing)。各席另外列出:巢狀一層的 link 形狀(ok 變 missing),以及幾種從 error 變成 missing 的輸入(gitlink 的路徑本身就是指進規格目錄的 link、用另一種大小寫記在規格目錄裡又沒有取出、經由 /System/Volumes/Data 指進去)。這些都是條文照字面寫的。規格目錄本身是 link 的形狀見第 3 列。

    以下是說明,不列成列。

    • 第 1 到 4 列都出在多做的那一步,或被它與第 2、5 個條件的修正碰到的邊角。第 1 到 3 列的輸入都需要工作目錄與 commit 不同(把 openspec 換成檔案或 link);第 4 列需要樹裡記了另一種拼法,或手動放一個 link。
    • 第 1 列各席的分級差距最大:跨模型一席評 HIGH,裁定席定為 LOW。裁定席的理由是條文自己對「同一個目錄」的定義給出了這個答案,而且整個範圍的起點(4.1.0)對這個輸入也回 missing。它說得很清楚,這是兩種讀法裡它取的一種。
    • 裁定席對「這一輪乾淨」的把握約七成五。它說較弱的一環不是程式做了什麼(每一項觀察都有人重建過,各席一致),而是條文有三處容許兩種讀法:一般檔案(第 1 列)、規格目錄是 link(第 3 列)、「上一層目錄」(第 7 列)。照其中任何一處較嚴的讀法,這條分支就還要再修一句條文;照第 7 列最嚴的讀法,是第七輪第 2 列的缺陷多一種拼法。
    • 協調者給審查者的說明有一處寫錯,regression 指出:說明寫 338da27 是 head 的前一個 commit,其實是前三個(之後的兩個只改文件與封存)。

    花費與執行

    五席 Claude 的用戶端估計是 3.60、3.97、3.45、3.00、3.68 美元,合計約 17.7 美元,回應都是標準速度。gpt-6.1-sol 一次請求約 0.64 美元。用戶端的估計與實際扣款是否一致還沒有核對。

    下一步

    照維護者的決定,這一輪之後停下來回報,不論結果。head 仍是 e5022f4,沒有開 PR、沒有 verified 的 tag、沒有合併。第 1 到 7 列與第 9 列補到 #559,第 8 列已在 #556。往下由維護者決定:多做的那一步要不要留;上面三處兩種讀法要不要在合併前各補一句;以及開 PR 讓 Linux 上的 CI 跑一次。

  15. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    Follow-up Findings Filed

    第八輪 verify 報告(留言 6908861611)的後續項目補在 #559(留言 6908886968):第 1 到 7 列與第 9 列。第 8 列(主 repo 的檔名含換行)已經是 #556 的第 2 點,沒有再補。這一輪沒有 blocking,也沒有列為要在分支上修的項目,所以沒有另外開 issue。

  16. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    決定:第八輪之後

    維護者 2026-11-16 對第八輪 verify 報告(留言 6908861611)的三個選擇。題目與選項文字由協調者撰寫,維護者從選項中選定。

    1. 多做的那一步留著。 第八個 change 裡「解析後落在規格目錄裡的 submodule 不搜尋」這一步(留言 6894894048)是協調者依委託加的,維護者當時沒有點名;現在確認保留。
    2. 第八輪的後續項留在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559,分支不再改。 報告表中的四處(規格目錄的路徑是一般檔案、是 link、解析後是頂層目錄,以及 /.vol 拼法)各是一行程式或一句條文,會隨合併一起出去,之後由 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559 處理。分支維持在第八輪審過的 e5022f4。
    3. 開一個 draft PR,讓 Linux 的 CI 跑一次。 只開 PR,不合併。這條分支到目前為止只在 macOS 上測過。

    合併與發布還沒有決定。

  17. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    CI 結果:draft PR #572 在 Linux 上失敗(2 個 suite)

    PR #572(head e5022f4)的第一次 CI(run 43819776536;ubuntu-26.04、git 2.56.1、Python 3.12):75 個 suite 裡 2 個失敗,其餘 73 個通過。

    1. spec-change:停在第 50 列的 fixture,之後的檢查都沒有跑。

    • 訊息:FATAL: spec-change suite: fixture setup failed: the search of a submodule with an empty object must end with 0 or 1。停下之前通過的檢查到第 49 列為止。
    • 原因是 git 的版本,不是 Linux。第 50 列的前提是:物件檔是空的時,git grep 跳過那個檔案、以 0 或 1 結束。協調者在 macOS 上用兩個版本對同一個輸入實跑:git 2.55.0 以 1 結束(error: … unable to read);git 2.56.0 以 128 結束(fatal: loose object … is corrupt)。CI 用的是 2.56.1。
    • 在 macOS 上把 git 2.56.0 放在 PATH 最前面跑 head 的測試檔:同樣停在這一行,停下之前 559 項通過、0 項失敗。在暫存的副本裡拿掉這一行前提檢查再跑:878 項通過、0 項失敗。所以用 git 2.56 時 links 對第 50 列的答案仍是 error(its recorded commit could not be read),其他各列也都通過。壞掉的是 fixture 的前提檢查,以及 Example 那一列對 git 行為的敘述:「so the search skips the file and ends with exit code 0 or 1」從 git 2.56 起不成立。
    • 還不知道的:第 50 列之後的檢查沒有在 Linux 上跑到。Linux 上還有沒有別的差異,要等這一行修掉、CI 跑過去才知道。
    • 連帶的一點:從 git 2.56 起,空的物件檔會讓搜尋自己失敗。「搜尋前先問 git 哪些物件打不開」這一步,在這個版本上因此沒有只有它才抓得到的測試輸入(第 50 列變成與第 49 列走同一條路)。

    2. edit-run:1 項失敗(the first backup id stays once),253 項通過。

    這是 #534 已經記錄的不穩定檢查(兩次更正落在同一秒時會失敗)。這條分支沒有改 edit-run 的任何檔案;預設分支與其他 PR 最近的 CI 都通過。

    現況:PR 是紅燈,沒有合併。維護者稍早的決定是分支不再改(留言 6909585903)。要讓 CI 通過就得改測試檔與 Example 的那一列,這與那個決定衝突,所以停在這裡等維護者。

  18. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    決定:修第 50 列的測試前提,不再審

    維護者 2026-11-16 對 CI 結果(留言 6909882017)的選擇:在分支上修,不再開 verify 輪。題目與選項文字由協調者撰寫,維護者從選項中選定。這個決定只推翻留言 6909585903 第 2 點裡「分支不再改」對這一件事的適用;第八輪的後續項仍留在 #559。

    範圍(第九個 change,spec-change.py 不動):

    1. tests/spec-change/test.sh 第 50 列:git grep 在空的物件檔上以大於 1 的結束碼結束時,不再讓整個測試檔停下;印一行說明這個 git 讓搜尋自己失敗,答案的檢查照樣執行。
    2. Requirement「Added and modified requirements carry an executable check」的 Example「markers in submodules」第 50 列第一欄:不再斷言搜尋一定以 0 或 1 結束,改寫成依 git 的版本有兩種情形;第三欄(答案是 error)不變。
    3. 驗收:git 2.54.0、2.55.0、2.56.0 三個版本各跑一次測試檔,都要 878 項通過;整套測試;封存 change。
    4. 推到 PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572 的分支,CI 自動重跑。第 50 列以後的檢查會第一次在 Linux 上跑到;再有失敗就停下回報。不合併、不發布。
  19. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Spec: change idd-548-links-submodule-markers, idd-548-links-submodule-hardening, idd-548-links-search-completeness, idd-548-links-unreadable-objects, idd-548-one-top-directory-requirement, idd-548-fix5, idd-548-fix6, idd-548-fix7, idd-548-fix8

    這一則取代先前的實作摘要(留言 6895459368)。第八輪 verify 通過之後(留言 6908861611),draft PR #572 的第一次 CI 停在 Example「markers in submodules」第 50 列的 fixture(留言 6909882017)。維護者 2026-11-16 的決定記在留言 6910032608:修測試,不再審。這一項用第九個 Spectra change idd-548-fix8 處理,封存在 ee3fcd9,紀錄見 openspec/changes/archive/2026-11-16-idd-548-fix8/tasks.md。前八個 change 的內容不變,見上一則摘要。

    第八輪之後改了什麼

    • 測試檔第 50 列的前提檢查不再讓整個測試檔停下。 這一列的輸入是:標記所在檔案的物件檔存在,但長度為零。fixture 原本要求 git grep 在這個輸入上以 0 或 1 結束,否則停下。git 2.54.0 與 2.55.0 是以 1 結束;git 2.56.0 以 128 結束,CI 用的 2.56.1 也大於 1。現在 fixture 記下結束碼,大於 1 時印一行說明,答案的檢查兩種情形都執行。另一個前提(git 把那個物件列為存在)不動,不成立時仍然停下。
    • Example 第 50 列第一欄改寫。 原本寫「so the search skips the file and ends with exit code 0 or 1」,現在寫成依 git 的版本有兩種情形(跳過檔案、以 0 或 1 結束;或搜尋以 128 結束)。第三欄的答案不變:error,its recorded commit could not be read。requirement 的條文與其他 64 列沒有動。
    • spec-change.py 沒有改。 e5022f4..ee3fcd9 對這個檔案沒有差異,第八輪審過的程式就是現在的程式。

    怎麼驗證的

    • 改之前的測試檔在 git 2.56.0 上(macOS):559 項通過之後停在第 50 列,與 CI 停在同一行。
    • 改之後,git 2.54.0、2.55.0、2.56.0 各跑一次測試檔:都是 878 項通過、0 項失敗。只有 2.56.0 印出說明行(搜尋以 128 結束,第 50 列走的是第 49 列的路)。
    • 整套 run-all-tests.sh(封存之前,改過的工作目錄):75 個 suite、0 個失敗;.claude/scripts/tests/spectra-archive-post-ic/test.sh 141 項通過。
    • 封存之後:現行規格與封存前只差那一列(移除 1 行、加入 1 行);links 從預設分支(3b87909)到 ee3fcd9 回 ok(這條分支的 script 與已安裝的 4.1.0 都是);測試檔在封存後的 commit 上 878 項通過。
    • CI:PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572 的第二次 CI(run 43828661537;ubuntu-26.04、git 2.56.1;head ee3fcd9)通過:75 個 suite、0 個失敗,spec-change 與 edit-run 都在其中,post-ic 那一步 141 項通過。CI 的紀錄只印每個 suite 通過與否,不印通過的 suite 跑了幾項檢查,所以 spec-change 在 Linux 上的項數沒有數字。第一次 CI(run 43819776536;head e5022f4)是失敗的,見留言 6909882017。

    已知的限制

    誰寫的、誰看過

    第九個 change 的文件、規格差異與測試修改都由協調者(Claude)撰寫,沒有實作者模型,也沒有人獨立讀過。

    Commits(branch idd/548-spec-change-py-links-submodule-missing,已推,draft PR #572)

    第八輪審過的四十五個(9ebccfd 到 e5022f4)不變。之後:

    • 6178467 test:第 50 列的 fixture,連同這個 change 的文件
    • ee3fcd9 chore:封存 idd-548-fix8

    Next

    合併與發布等維護者決定。

    Checklist

    結案時補上(2026-11-16):Diagnosis 的 Strategy 五項,逐項對照合併後的預設分支(28e0de2,內容與分支的 ee3fcd9 相同)。先前九則實作摘要都沒有這一段。

    • Spectra change:requirement「Added and modified requirements carry an executable check」寫明標記可以在 submodule 的已追蹤檔案裡與三種結果;Example「markers in submodules」共 65 列;九個 change 都已封存。
    • 先寫測試:plugins/issue-driven-dev/scripts/tests/spec-change/test.sh。改了行為的七個 change,各自的 tasks.md 都記有新測試配舊 script 時失敗的項目;第五個 change 只搬標記、第九個 change 只改 fixture,沒有這一步。
    • 改 plugins/issue-driven-dev/scripts/spec-change.py:列舉 gitlink、逐一搜尋、無法判定時回 error。
    • 文件:script 檔頭的說明、plugins/issue-driven-dev/references/spec-wrapper.md、plugins/issue-driven-dev/CHANGELOG.md。
    • [-] 文件:idd-implement 與 idd-all 裡講標記的句子 — 沒有改。第一個 change 的 design 把其他 skill 的文字劃在範圍外;這兩句只說測試檔帶標記,沒有說標記要在哪一個 repository,合併後仍然成立。
    • Spec close-out:九個 change 封存;links 從預設分支到分支 head 回 ok;archived 通過。
    • [~] Spec close-out 裡的 spectra-verify — 只有前兩個 change 在封存前跑過,第三到第九個 change 的封存紀錄裡沒有它。第三到第八個 change 的內容由第三到第八輪 verify 讀過;第九個 change 的紀錄有 spectra validate,沒有人獨立讀過。(2026-11-16 更正:這一項原本寫第三到第八個 change 跑的是 spectra validate,封存紀錄裡查不到;也把「第二到第八輪」改成「第三到第八輪」。)
  20. kiki830621 commented on Nov 16, 2026

    @kiki830621
    MemberAuthor

    Closing Summary

    Problem

    spec-change.py links 只在主 repo 找 Example 的標記(spec-example: <capability> / <Example title>)。測試放在 submodule 的專案,每一個 Example 都被回報成 missing,連結檢查因此過不了;訊息說的是「沒有標記」,實際上是檢查沒有看那裡。

    Root Cause

    marker_files() 對 <head> 的樹跑 git grep。git 搜尋一棵樹時不會走進 gitlink,程式也沒有另外列出 gitlink,所以 submodule 裡的檔案從來沒有被讀過。檢查沒有看過的地方卻回 missing,把「看不到」說成了「沒有」。

    Solution

    • links 自己列出 <head> 的 gitlink,逐一在記錄的 commit 上搜尋,含巢狀。一個 Example 有三種結果:找到標記是有連結;沒找到而且每個 gitlink 都搜尋過是 missing;沒找到而且有 gitlink 搜尋不了是 error,原因點名那個 Example 與路徑。
    • 只在符合六個條件的 submodule 目錄執行 git;執行時關掉 lazy fetch、拿掉六個繼承的 git 位置變數(GIT_DIR、GIT_WORK_TREE、GIT_INDEX_FILE、GIT_OBJECT_DIRECTORY、GIT_ALTERNATE_OBJECT_DIRECTORIES、GIT_COMMON_DIR);目錄的比對看作業系統回報的裝置與 inode,不看路徑名稱。
    • 解析後落在規格目錄裡的 submodule 不搜尋。
    • 沒有 submodule 的 repository,答案不變。
    • requirement「Added and modified requirements carry an executable check」的 Example「markers in submodules」從 10 列加到 65 列,每一列在 plugins/issue-driven-dev/scripts/tests/spec-change/test.sh 有對應的檢查。九個 Spectra change 都已封存。

    Verification

    • 八輪 verify:第 1、2、3、5、6、7 輪 FAIL,第 4、8 輪 PASS。最後一輪(留言 6908861611)審的是 3b87909..e5022f4:0 項 blocking、0 項要修、9 項留給別的 issue。
    • 第八輪審過的 commit 後面還有兩個 commit(第九個 change,idd-548-fix8):只改測試檔第 50 列的前提檢查與 Example 那一列的敘述,spec-change.py 沒有變。這個 change 沒有人獨立讀過,是維護者的決定(留言 6910032608)。
    • CI,PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572:第一次(head e5022f4)失敗,spec-change 停在第 50 列的 fixture(git 2.56 起,空的物件檔讓 git grep 以 128 結束);第二次(head ee3fcd9;ubuntu-26.04、git 2.56.1)通過,75 個 suite、0 個失敗。
    • CI,合併後的預設分支(28e0de2):結案時還在跑(run 43830800147);結果記在下面的 Distribution Sync。
    • 本機(macOS):測試檔在 git 2.54.0、2.55.0、2.56.0 上各 878 項通過;整套 75 個 suite 全過。
    • 合併:PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572 以 squash 合併成 28e0de2,它的樹與 ee3fcd9 的樹相同。合併後的三項檢查:分支的內容都落在預設分支上;九個 change 在 28e0de2 上都已封存;links 從 3b87909 到 28e0de2 回 ok(已安裝的 4.1.0 與合併後的 script 各跑一次)。
    • 沒有驗證到的兩處:Example 第 60 到 64 列需要同一個目錄的兩種拼法,在區分大小寫的檔案系統上略過,所以 CI 不執行它們;git 2.56 起,「搜尋前先問 git 哪些物件打不開」那一步沒有只有它才抓得到的測試輸入(記在 spec-change.py 與它的測試:#548 第四輪 verify 留下的八件小事(測試的環境隔離、TERM 與逾時監看、註解與文字) #559)。

    Changes

    • 28e0de2 feat: spec-change.py links reads markers in submodules and answers error when it cannot decide(PR feat: spec-change.py links reads markers in submodules and answers error when it cannot decide (#548) #572,squash;分支 idd/548-spec-change-py-links-submodule-missing 上的 47 個 commit,分支保留)
    • 51 個檔案,+4103 −33:
      • plugins/issue-driven-dev/scripts/spec-change.py(+292 −25)
      • plugins/issue-driven-dev/scripts/tests/spec-change/test.sh(+1006 −7)
      • openspec/specs/spec-on-every-issue/spec.md(+88 −1)
      • plugins/issue-driven-dev/CHANGELOG.md(+44)、plugins/issue-driven-dev/references/spec-wrapper.md(+3)
      • 九個封存的 change(45 個檔)與這張 issue 的附件清單(一個檔,清單是空的)

    結案時的狀態

    Residue Acknowledgement

    residue declared as (none) at diagnose time — no acknowledgement needed

    更正於 2026-11-16:spectra-verify 那一句原本寫第三到第九個 change 跑的是 spectra validate,封存紀錄只有第九個 change 記了它,已改成查得到的說法;links 那一項改成合併後重跑的結果;Solution 原本寫拿掉繼承的 GIT_* 變數,程式拿掉的是列出的六個,已改。

    Distribution Sync

    • Detected: plugin(issue-driven-dev,這個 repository 的 marketplace 列出的一個 plugin)
    • Remote CI: 預設分支 28e0de2 上 1 項檢查,通過(run 43830800147;75 個 suite、0 個失敗;ubuntu-26.04、git 2.56.1)
    • Choice: chain to plugin-update(維護者於 2026-11-16 確認發布,版本號 4.2.0)
    • Outcome: 發布為 4.2.0。預設分支 6c26645(chore: release 4.2.0)的 CI 通過(run 43849981801;75 個 suite、0 個失敗);tag issue-driven-dev-v4.2.0 打在 6c26645;marketplace 的版本與這台機器安裝的版本都是 4.2.0
    • At: 2026-11-16T10:45:02Z(偵測與 CI 檢查在 2026-11-16T08:39:15Z)
  21. added a commit that references this issue on Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions