Skip to content

取全文 #777 拆出:兩件待裁寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 #779

Closed

Description

@kiki830621

Problem

#777 裡有一部分工作不需要等它的兩件使用者裁決,從 #777 拆出來,讓 #777 只留裁決本身(它的 ### Blocking)。

這裡的工作是兩類:

1. 兩件待裁的事,文件寫成「待使用者裁決」

b49 changelog 把這兩件寫成「接受的代價(記下,不改)」,但沒有使用者接受過(#613 b52 verify 的 DA 席指出):

  • Atypon 平台的 /action/showLogin 不算登入長相,導航之後落在那裡、頁面寫著 CAPTCHA 仍是結束碼 8。
  • 連 document.contentType 都讀不到的同站分頁,網址有登入長相、帶驗證服務標記時仍是 8。

現行行為不改(改不改由 #777 的裁決決定)。要改的是描述:changelog/2026-11-04-b49-fulltext-613.md 的「接受的代價」段、FulltextFetch.swift 開頭結束碼 6、8 的定義、SKILL 結束碼 8 那一列——寫成「現行行為如此,是否改變待使用者裁決(#777)」,不寫成已定案。

2. b52 verify 的文字殘留(LOW),照現行行為改正

  • Tests/AkashicKitTests/FulltextB39Tests.swift testAnIdPNameInATitleSlugStillPausesTheLanding 的註解:開頭仍是「待使用者裁決的代價」,後一句「裁決為不收時這一支改成負例」已不成立(使用者 2026-11-04 第 1 則已裁決維持收)。
  • changelog/2026-11-04-b49-fulltext-613.md 第 8、33 行:主機標籤的副作用只列 signon;hostLoginLook 對 sign-on、single-sign-on 也算(SKILL 版本 9 那段與 contractVersion 註解已列三種)。FulltextB37Tests 的註解說 BotSignals 與 changelog「寫明」三種,兩處都沒有。
  • BotSignals.swift 驗證服務清單 doc、SKILL 第 47 行、FulltextOffSiteTests.swift 新加的例外句沒有帶「連 document.contentType 都讀不到的分頁不適用」;onSiteStop 的註解也沒有。
  • b49 changelog 沒有 b51 修正那一段(兩支新測試與文字修正只記在 feat: 取得全文——Find Full Text 缺口的 plugin skill(akashic-fetch-fulltext) #613 的 b51 comment)。
  • testAfterNavigationASignOnPageOnAnotherHostPauses 可另斷言 (login page),確認暫停的是登入長相那一支(INFO)。

Type

refactor

Expected

Source: split from #777 so the ruling-independent work is not blocked by its two rulings.


Current Status

Phase: closed
Last updated: 2026-11-11 by idd-close

Key Decisions

Scope Changes

Blocking

Commits

Activity

  1. added
    refactorArchitecture / structure improvement (IDD type)
    on Nov 9, 2026
  2. kiki830621 commented on Nov 9, 2026

    @kiki830621
    MemberAuthor

    Diagnosis

    Type

    refactor

    Root Cause / Analysis

    這是 #777 拆出、不依賴裁決的部分,只動註解、文件與一支測試的斷言,不改行為。逐項定位(行號為 8f8859c0):

    A. 兩件待裁寫成「待使用者裁決(#777)」

    B. 例外句補上讀不到的分頁不適用(第 6 則的例外句,帶與不帶的對照,grep '2026-11-04' 逐行看過)

    • 缺:FulltextFetch.swift 第 586 行(onSiteStop 的 doc)、BotSignals.swift 第 296 行(knownVerificationHosts 的 doc)、SKILL 第 47 行、FulltextOffSiteTests.swift 第 276 行。
    • 已帶:FulltextFetch.swift 第 33 行、SKILL 第 58、94、139 行。
    • 不必帶:FulltextFetch.swift 第 603 行講的是讀得到的同站 HTML 頁;FulltextB37Tests.swift 第 119 行是單一可讀情境的測試說明。

    C. 其他文字殘留

    • Tests/AkashicKitTests/FulltextB39Tests.swift 第 151–152 行:開頭「待使用者裁決的代價(### Blocking 第 1 項…)」與「裁決為不收時這一支改成負例」都不成立了(使用者 2026-11-04 第 1 則裁決維持收),改寫成已裁決的正例。
    • changelog 第 8、33 行:主機標籤的副作用只列 signon,hostLoginLook 對 sign-on、single-sign-on 也算——補成三種。FulltextB37Tests.swift 第 202 行說 BotSignals 與 changelog「寫明」三種;BotSignals 沒有寫,改註解指向 SKILL 版本 9 那段與 contractVersion 註解(已列三種)與補完的 changelog。
    • changelog 補一段 b51 的修正(兩支釘邊界的測試與文字修正,現在只記在 feat: 取得全文——Find Full Text 缺口的 plugin skill(akashic-fetch-fulltext) #613 的 b51 comment)。
    • testAfterNavigationASignOnPageOnAnotherHostPauses 另斷言 (login page),確認暫停走的是登入長相那一支。

    D. plugin 殼
    SKILL.md 改字會讓 plugin 殼的摘要變,pre-push 的 plugin-shell-version 守衛要求升版:plugin.json 0.13.13 → 0.13.14、plugin/CHANGELOG.md 一條、.githooks/plugin-shell-versions.txt 接一列。契約版本不調(不改行為與輸出)。

    Existing work

    • unknown:merged PR list reached its limit (100); older merged PRs were not checked(check-existing-work.sh)。本 issue 今天才建,沒有已知的 PR 或 branch。

    Impact

    • 檔案:changelog(b49)、FulltextFetch.swift、BotSignals.swift、SKILL.md、FulltextB37Tests.swift、FulltextB39Tests.swift、FulltextOffSiteTests.swift、plugin 殼三處。
    • 行為:不變。唯一的程式改動是一支測試多一個斷言。

    Strategy

    Conflict Class

    A_parallel_safe — 只動 fulltext 相關的註解、文件與一支測試,沒有共享的可變資源。

    Complexity

    Simple

    Layer 1 命中:主要交付物是既有說明文字的更新、不改行為(文件與註解對齊)。多檔但各自獨立,不是單一概念散佈(每處是同一句話的不同副本,逐處改字)。
    Hard-gate: not triggered — 不動任何共享抽象的介面,改的是註解與文件;唯一的程式改動是一支測試的斷言。

    Risks

    Residue

    (none)

    Vagueness Pre-check

    • V1: 1 — 每一項都給了檔案與行號(取自 b52 verify 的報告,本 diagnosis 逐行重新定位)。
    • V4: 2 — 完成定義是「文件寫成待裁、殘留照現行行為改正、測試綠」,可逐項檢查;措辭本身需要判斷。
    • Triggered: no — both axes ≤ 3

    [Layer V: V1=1 V4=2, not triggered]

  3. kiki830621 commented on Nov 9, 2026

    @kiki830621
    MemberAuthor

    Implementation Plan

  4. kiki830621 commented on Nov 9, 2026

    @kiki830621
    MemberAuthor

    Implementation Complete

    Checklist (synced from TaskList)

    Legend: - [x] done · - [~] skipped · - [-] won't fix

    Changes

    • f23e2ca:docs: 取全文的待裁事項寫成「待使用者裁決」、b52 的文字殘留照現行行為改正

    Files Changed

     .githooks/plugin-shell-versions.txt              |  1 +
     Sources/AkashicSkillTools/BotSignals.swift       |  2 +-
     Sources/AkashicSkillTools/FulltextFetch.swift    |  5 +++--
     Tests/AkashicKitTests/FulltextB37Tests.swift     |  4 +++-
     Tests/AkashicKitTests/FulltextB39Tests.swift     |  4 ++--
     Tests/AkashicKitTests/FulltextOffSiteTests.swift |  2 +-
     changelog/2026-11-04-b49-fulltext-613.md         | 24 ++++++++++++++++++------
     plugin/.claude-plugin/plugin.json                |  2 +-
     plugin/CHANGELOG.md                              |  6 ++++++
     plugin/skills/akashic-fetch-fulltext/SKILL.md    |  4 ++--
     10 files changed, 38 insertions(+), 16 deletions(-)
    

    Scope Compliance

    只改註解、文件、一支測試的斷言與 plugin 殼版號。diagnose 時多找到兩條同樣沒經使用者接受的事(PDF 連結路徑有 auth、login 時 Cloudflare 挑戰頁整批暫停;主機標籤 signon 等算登入主機),文件寫成待裁、裁決本身補進 #777 第 3、4 件——不替使用者決定。

    Sister Bugs Filed (mid-impl, v2.44.0+ #526)

    Next: verification pending

  5. kiki830621 commented on Nov 9, 2026

    @kiki830621
    MemberAuthor

    Verify r1(2026-11-10):HIGH 0、MEDIUM 2(同一件事)、LOW 18、INFO 13

    Engine

    pai-ensemble 2.26.0(3 個 IDD lens:requirements、logic、regression + devil's advocate + Codex gpt-6-astra),model: sonnet。六席都完成,integrity 0。驗的是 f23e2ca4(未推送)。

    行為與輸出:四席(含 Codex、DA)都確認沒有改到行為或印出的字,契約版本不調成立;DA 以變異確認新斷言 (login page) 行為改了會紅;版號列與守衛算出的相同。

    MEDIUM(requirements、DA 同指):docs/rulings/mcp-cli-parity.md fulltext 列的 b49 段 (c) 把主機標籤的副作用寫在「使用者十項裁決」之下、只列 signon 一種寫法——那正是 #777 第 4 件,這一處漏掃。SKILL 版本 9 那段與 contractVersion 註解列了三種,但沒有待裁標記。

    LOW(全部是文字,下一輪修):

  6. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    Verify r2(2026-11-10):HIGH 0、MEDIUM 0、LOW 7、INFO 18

    Engine

    pai-ensemble 2.26.0(requirements、logic、regression + devil's advocate + Codex gpt-6-astra),model: sonnet。六席都完成,integrity 0。驗的是 f23e2ca4 + b579b768(未推送)。

    r1 的 MEDIUM 已修(docs/rulings/mcp-cli-parity.md 列全三種、寫明待裁第 4 件);行為與印出的字不變、新斷言有效、版號列與守衛一致,各席都確認。

    LOW(都是描述的精確度,下一步修,修完對增量跑一輪窄的 verify):

    INFO(擇要):待裁第 4 件不只三種寫法——最左邊標籤以非字母數字切開的任一段、或去掉連字號後的整個標籤是 signon、singlesignon 都算;plugin 殼 0.13.14 與本機 #775 分支撞號(守衛會擋後推的一邊);#779 本文的 Problem 仍寫「網址有登入長相」(原始記錄,不改,以 #777 第 2 件為準)。

  7. kiki830621 commented on Nov 10, 2026

    @kiki830621
    MemberAuthor

    Verify r3(2026-11-10,停損輪):HIGH 0、MEDIUM 0、LOW 10

    Engine

    pai-ensemble 2.26.0(requirements、logic + devil's advocate + Codex gpt-6-astra),model: sonnet。五席都完成。只驗 r2 修正的增量 b579b768..59b0e910。

    r2 的 LOW 都已修(結束碼 8 的待裁句逐件寫、驗證服務標記限定為兩個得 8 的、#777 改成四件);Codex 與 DA 確認只動註解與文件,DA 以探針重算 hostLoginLook 與六個標記的結束碼。

    LOW(多半落在上一輪新寫的句子上):結束碼 8 那兩處只有第 2 件帶「待使用者裁決」;changelog 第 8 則「…開頭的主機都算」兩個方向都不準(signonline、sign-on-portal 不算,my-signon 算);〈#779 的文字修正〉仍寫「三種寫法」;fetch --help 不動的理由(「動了要調契約版本」)與第 10 則相反;plugin CHANGELOG 待裁第 2 件少了「路徑有登入長相」的條件;#777 的 Current Status 仍寫兩件、標題仍帶「b52 的文字殘留」。

    停損:LOW 連續兩輪落在新寫的句子上,這一輪照停損規則只收縮、不加句——55ffaec4 修掉上面每一項(刪掉「開頭」那一句、改正理由、補條件、三件統一標待裁),#777 的本文與標題另改。修完沒有再跑一輪 ensemble;改動逐項對照 finding 核過,取全文相關 481 支測試綠、plugin-shell-version 守衛綠、全分支的 Swift 非註解改動只有那一支新斷言。run-guards.sh 在 59b0e910 上 rc=0,全套測試與守衛在 pre-push 再跑一次。

  8. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    Closing Summary

    Problem

    #777 有四件取全文行為的使用者裁決還沒決定,但其中有一部分工作不必等它:b49 的 changelog 把幾件從來沒有使用者接受過的現行行為寫成「接受的代價(記下,不改)」,看起來像已經定案;另外 #613 b52 verify 留下一批文字殘留(LOW)。這張 issue 把這兩類從 #777 拆出來,讓 #777 只留裁決本身。

    Root Cause

    b49 落地時,幾條「現行行為如此」的描述被直接寫成已接受的代價,沒有經過使用者裁決;同一句話又散在 changelog、FulltextFetch.swift、BotSignals.swift、SKILL.md 與三支測試的註解裡,b51、b52 修正時只改到其中幾處,所以副本之間互相矛盾(例如主機標籤只列 signon 一種寫法,例外句有的帶「讀不到的分頁不適用」、有的沒帶)。

    Solution

    只改註解、文件與一支測試的斷言,程式行為與印出的字不變,契約版本不調:

    Verification

    • verify 跑了三輪(pai-ensemble:requirements、logic、regression、Devil's Advocate 與 Codex):r1 MEDIUM 2(同一件事:docs/rulings/mcp-cli-parity.md 漏掃一處),修掉;r2、r3 都是 HIGH 0、MEDIUM 0。各輪都確認只動註解與文件、行為與輸出不變,新斷言在行為改變時會紅(DA 以變異確認)。
    • r3 起照停損規則只收縮、不加句:55ffaec4 修掉 r3 的 10 項 LOW 之後沒有再跑 ensemble,改動逐項對照 finding 核過。
    • pre-push 在 55ffaec4 上:嚴格建置通過,全套測試 7 個 bundle、5,557 支、0 失敗、1 略過,守衛全部通過;PR docs: 取全文的待裁事項寫成「待使用者裁決」、b52 的文字殘留照現行行為改正 (#779) #787 的遠端 parity 檢查通過。
    • 結案前:merge 完整性檢查(PR head 對合併後的 main)乾淨;沒有引用本 issue 的 open PR;打勾的每一項在本 issue 的 commit 裡都有對應改過的檔。

    Changes

    四件行為要不要改,仍在 #777 等使用者裁決。

    Doc-sync 檢查

    → doc-sync:main 上 3 份 README/CLAUDE.md 都檢查過,沒有提到本 issue 改過的內容,沒有過時。

    Distribution Sync

    • Detected: plugin(本 repo 自己就是 marketplace)
    • Choice: not applicable — 合併即發布:marketplace.json 不記版號,版號在 plugin/.claude-plugin/plugin.json,main 上已是 0.13.14;main(f887f1ee)的遠端檢查 parity、test 都通過
    • At: 2026-11-11T07:52:38Z
  9. kiki830621 commented on Nov 11, 2026

    @kiki830621
    MemberAuthor

    📊 For Reviewer / Collaborator

    現在:已結案。b49 把幾件沒經使用者接受的取全文行為寫成「接受的代價」;這張把它們改寫成「待使用者裁決(#777)」、修掉 b52 留下的文字殘留,只改註解、文件與一支測試的斷言,行為不變(PR #787,已合併)。
    Blocking:無
    你該做什麼:無。四件行為要不要改,在 #777 等裁決。

    last-updated by idd-close at → closed, 2026-11-11

  10. added a commit that references this issue on Nov 11, 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

    refactorArchitecture / structure improvement (IDD type)

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions