[bug] spectra-archive-post-ic 漏偵 prose-only #N reference

[kiki830621]

Problem

/spectra-archive Step 7（spectra-archive-post-ic.sh，#56）負責 post ## Implementation Complete 到 linked GitHub issue，觸發 /idd-close 的 supersession gate。但對 idd-worktree-isolation change 它回 (none — no linked issue detected)，雖然該 change 全程關聯 #167。

Root Cause（推測，待 diagnose 確認）

helper 的 linked-issue 偵測掃 archived tasks.md 找 explicit marker 或 Refs #N 形式。但 /spectra-propose 產出的 tasks.md 把 issue 號寫在 prose（例如 "referencing issue #167"），不是 Refs #N trailer 形式 → 偵測 miss。--linked-issue 167 也被拒（"not in candidate set"，因 candidate set 為空）。

Impact

• Spectra-path issue 的 IC 沒自動 post → /idd-close gate 會 fall back 掃 diagnosis Strategy - [ ] → 誤 refuse，或需手動補 IC（本次 [exploration] 平行執行多個 IDD 的隔離機制 — worktree vs branch 防衝突（#164 子問題） #167 就是手動補的）。
• 破壞 feature: spectra-apply auto-post Implementation Complete to GitHub issue (resolve /idd-close supersession friction) #56 「Spectra-path 自動觸發 supersession」的設計目的。

Proposed Solution（待 diagnose）

1. 擴大偵測來源 — 除 tasks.md 外也掃 proposal.md（IDD proposal 慣例會寫 issue link）。
2. 或 spectra-propose 埋 marker — 在 tasks.md 或 .openspec.yaml 寫一個 canonical linked-issue: #N 欄位，post-ic 直接讀。
3. 修 --linked-issue override：candidate set 為空時應允許明確指定（目前空集合 → 拒所有）。

Workaround（已用於 #167）

手動 compose ## Implementation Complete comment + gh issue comment。

---

Source: surfaced during /idd-close #167（spectra-archive Step 7 對 idd-worktree-isolation 回 no-linked-issue）。Sister concern from #167.

---

Current Status

Phase: closed
Last updated: 2026-05-31 by /idd-diagnose

Key Decisions

• Complexity = Simple → next: /idd-implement #170

Blocking

• (none) — closed via PR fix: spectra-archive-post-ic linked-issue escape hatch + prose detection (#170) #171 (squash 4b79694). Follow-ups: [refactor] spectra-archive-post-ic --linked-issue membership semantics (escape-hatch reliability) (follow-up from #170) #172 (membership semantics), [bug] idd-implement PR-body template generates an auto-close trap (/idd-close #N parsed by GitHub Source 1) #173 (template auto-close trap).

Commits

• 203aeb1 fix: linked-issue escape hatch + prose detection ([bug] spectra-archive-post-ic 漏偵 prose-only #N reference #170)

[kiki830621]

Diagnosis

Type

bug

Root Cause

spectra-archive-post-ic.sh 的 linked-issue 偵測掃 archived tasks.md 找 explicit marker 或 Refs #N trailer。但 /spectra-propose 產出的 tasks.md 把 issue 號寫在 prose（"referencing issue #167"）→ 偵測 miss，回 (none — no linked issue detected)。--linked-issue 167 override 又因 candidate set 為空被拒（"not in candidate set"）→ 連手動指定都救不回來。雙重失效，本次 #167 的 IC 是純手動 compose + gh issue comment 補的。

Impact

• .claude/scripts/spectra-archive-post-ic.sh（偵測邏輯 + --linked-issue 驗證）
• .claude/scripts/tests/spectra-archive-post-ic/（test fixtures）
• 破壞 feature: spectra-apply auto-post Implementation Complete to GitHub issue (resolve /idd-close supersession friction) #56「Spectra-path 自動 post IC → 觸發 idd-close supersession」的設計目的

Strategy

• 核心修：--linked-issue override 在 candidate set 為空時應允許明確指定（目前空集合 → 拒所有；override 的存在意義就是 detection 失敗時的逃生口）
• 擴大 auto-detection：除 tasks.md 也掃 proposal.md（IDD proposal 慣例會寫 issue link）— 降低需要 override 的頻率
• 加 test fixture：(a) prose-only #N reference 的 archive dir、(b) --linked-issue override-on-empty-candidate-set

Complexity

Simple

• Clear root cause（兩個明確失效點），self-contained fix 在單一 script + 其既有 test suite（TDD：先加 fixture RED → 修 → GREEN）。
• 雖有 2 個改善方向（widen detection vs allow override），但 override fix 是明確的 minimal correct（detection 永遠有漏網，override 必須可靠）；detection 擴大是錦上添花。

Risks

• Override 放寬 → user 可能 post 到錯 issue，但那是 user 明確指定的、符合預期（detection 失敗時的合理逃生口）。
• Detection 擴大掃 proposal.md → 要避免誤抓 proposal「Out of scope / 反例」段落裡的 #N（同 squash-commit-body auto-close trap: PR body clean but squashed commit bodies leak trap pattern (caught #87 in PR #94 dogfood) #97 auto-close trap 的 context-blind 教訓）。

Residue

(none)。

[kiki830621]

Implementation Plan

• .claude/scripts/spectra-archive-post-ic.sh — fix --linked-issue override: when the detected candidate set is empty, accept the explicit --linked-issue as the authoritative escape hatch (membership validation only applies when candidates were actually detected — the disambiguation use case). Also reorder: integer-validate first (clearer error), then conditional membership check.
• .claude/scripts/spectra-archive-post-ic.sh — widen detection fallback 2 regex from (Refs|Closes|Fixes) #N to (Refs|Closes|Fixes|[Ii]ssue) #N so the IDD-prose form "issue #N" (what /spectra-propose writes in tasks.md) is caught.
• .claude/scripts/tests/spectra-archive-post-ic/fixtures/12-prose-issue-detect/ — new fixture: tasks.md with prose "issue [exploration] 平行執行多個 IDD 的隔離機制 — worktree vs branch 防衝突（#164 子問題） #167" only → detection now finds 167 (RED before widening).
• .claude/scripts/tests/spectra-archive-post-ic/fixtures/13-linked-issue-empty-candidates/ — new fixture: no detectable issue + --linked-issue 555 → accepted via escape hatch (RED before override fix).

TDD: write both fixtures RED → fix script → GREEN (all 13). Existing fixture 09 (candidate set {44}, --linked-issue 99) stays rejected — membership check preserved when set is non-empty.

Refs #170

[kiki830621]

Implementation Complete

Checklist (synced from TaskList)

• spectra-archive-post-ic.sh — --linked-issue escape hatch: membership check now applies only when detection found candidates; empty set → accept the explicit override (integer-validate first, since emit_outcome exits) → commit 203aeb1
• spectra-archive-post-ic.sh — widen detection fallback 2 regex (Refs|Closes|Fixes|[Ii]ssue) #N to catch the IDD-prose form /spectra-propose writes → commit 203aeb1
• fixtures/12-prose-issue-detect/ — new fixture: prose "issue [exploration] 平行執行多個 IDD 的隔離機制 — worktree vs branch 防衝突（#164 子問題） #167" → detection finds 167 (was RED) → commit 203aeb1
• fixtures/13-linked-issue-empty-candidates/ — new fixture: empty candidates + --linked-issue 555 → accepted (was RED) → commit 203aeb1

Legend: - [x] done. idd-close will refuse to close if any - [ ] remains.

Changes

• 203aeb1: both fixes + 2 fixtures (10 files, +30/-7)

Verification

TDD: both new fixtures RED on the unfixed script → GREEN after the fix. Full suite 13/13 PASS (bash .claude/scripts/tests/spectra-archive-post-ic/test.sh). bash -n clean. Existing fixture 09 (candidate set {44}, --linked-issue 99) stays rejected — membership check preserved when the set is non-empty.

Scope Compliance

Touched only spectra-archive-post-ic.sh + its 2 new fixtures. No scope creep.

Next: verification pending

[kiki830621]

Verify (via PR #171)

Result: PASS — 0 hard-blocking; 4 in-PR fixes + 1 follow-up
Full report: #171 (comment)

[kiki830621]

Closing Summary

Problem

spectra-archive-post-ic.sh（spectra-archive Step 7, #56）對 prose-only #N reference 偵測失效（漏偵 #167），而 --linked-issue override 又在候選集為空時被拒 —— auto-detector 與其手動 fallback 同時失效，正好在最需要 fallback 的時候。#167 的 ## Implementation Complete 因此是手動補的。

Root Cause

兩個耦合的失效點：

1. Detection：fallback-2 regex 只配 Refs/Closes/Fixes trailer，不配 /spectra-propose 寫的 IDD-prose 形式「issue #N」。
2. Override：--linked-issue 的 membership validation 在候選集為空時仍跑（grep -qx 對空集合 false-fail），所以 detection 失敗時 override 救不回 —— 兩個 fallback 共享同一失效模式。

Solution

• Override escape hatch：整數檢查移到前面（emit_outcome 會 exit，原本是 dead code）；membership check 只在候選集非空時跑；空集合 → 接受 --linked-issue 作 authoritative escape hatch。
• Detection widening：fallback-2 regex → (^|[^[:alnum:]_])(Refs|Closes|Fixes|[Ii]ssue) #N（含 word-boundary anchor，防 reissue/tissue 誤配）。
• 整數 gate tighten：^[1-9][0-9]*$ 拒 0（原本 ^[0-9]+$ 讓 --linked-issue 0 post 到 /issues/0）。
• Fixtures 11 → 14（prose-detect / empty-candidate-override / word-boundary）。

Verification

6-AI ensemble（5 Claude reviewers + Codex gpt-5.5 xhigh）→ 0 hard-blocking。Codex（跨模型）把 widened regex 的隱患從「friction」升格為 load-bearing —— spurious cross-ref candidate 會讓候選集非空、defeat escape hatch；Devil's Advocate 抓到 escape-hatch 的 wrong-but-existing silent mis-post。4 個 in-PR fixes 全修，test suite 13 → 14 GREEN。Step 0.8 gate 額外抓到 PR body 的 auto-close trap（見 #173）並在 merge 前清掉。

Changes

• 4b79694（squash of 203aeb1 core + 8db1423 verify-fixes）— PR fix: spectra-archive-post-ic linked-issue escape hatch + prose detection (#170) #171。

Distribution Sync — Not Applicable

本 change 動的是 .claude/scripts/spectra-archive-post-ic.sh（project-level script，spectra-archive skill 用），不在 plugins/issue-driven-dev/ 內 → 不觸及 plugin distribution surface，無需 marketplace bump。

Follow-ups Filed

• [refactor] spectra-archive-post-ic --linked-issue membership semantics (escape-hatch reliability) (follow-up from #170) #172 — --linked-issue membership semantics（spurious candidate defeats override；wrong-but-existing mis-post）—— 深層設計層，超出 [bug] spectra-archive-post-ic 漏偵 prose-only #N reference #170 reported scope。
• [bug] idd-implement PR-body template generates an auto-close trap (/idd-close #N parsed by GitHub Source 1) #173 — idd-implement PR template auto-close trap（/idd-close #N 被 GitHub Source 1 解析為 auto-close）—— Step 0.8 dogfood 發現。