Arcrun

Leo/Arcrun

Fork 0

Commit Graph

Author	SHA1	Message	Date
uncle6me-web	ae81d22775	fix(harness): 世代閘的 ON_TRUE 判準過時，反過來擋下正確教材引擎自 2026-08-01 起已支援條件邊（cypher-executor/src/graph-executor.ts case 'ON_TRUE'/'ON_FALSE'/'ON_BRANCH'，VALID_EDGE_TYPES 亦已列入；31 個 cypher-executor 測試全過）。registry/skills/write_intent_workflow.md（單一真相源）也已在同日更正為教 ON_TRUE/ON_FALSE/ON_BRANCH 是合法邊。但 cli/scripts/check-harness-generation.mjs 的世代閘還停在舊世代判準：只要 SKILL.md 出現正面示範的 ON_TRUE 就擋——這道閘本身才是落後的一方，把已經寫對的教材當錯誤攔下，害乾淨 `npm run build` 必敗。同源的過時內容還藏在三個手動維護的 harness 原始檔（非腳本產物）： CLAUDE.block.md／commands/arcrun.md／hooks/arcrun-guard.sh 都寫著「引擎沒有條件邊」「沒有 ON_TRUE/ON_FALSE/ON_FAILURE」，一併更正。真正不存在的邊是 ON_FAILURE（VALID_EDGE_TYPES 只有 ON_FAIL），把 mustNot 判準從 ON_TRUE 換成 ON_FAILURE，並新增 must 規則要求 ON_TRUE 必須出現，防止教材日後又被改回「條件邊不存在」的舊世代說法。 skills/arcrun-mindset/SKILL.md 是由 registry 於建置期重建的產物（build-harness-skill.mjs），本次改動只跑 `npm run build:harness` 重建、不手改。驗證：故意把 SKILL.md 的 ON_FAILURE 改成正面示範，確認閘仍會擋下（exit 1），還原後 `npm run build` 連跑兩次皆全綠且冪等（SKILL.md md5 不變）。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>	2026-08-10 11:03:43 +08:00
uncle6me-web	46afea83c2	步驟1 最後一筆：install-harness 交付內容升級到現世代＋世代閘管道本來就是好的（install-harness 功能完整、冪等），過時的是內容： harness skill（4066B）grep「意圖」「>>」= 0 命中，只講世界觀／別寫 Python ⇒ 新裝的封測者拿不到步驟 1 的核心教材（`>>` 意圖語法）。 ■ 單一真相源：harness skill 改為建置期由 registry 複製 build-harness-skill.mjs＝head ＋ registry/skills/write_intent_workflow.md 正文＋ tail。選「建置期複製」的理由：npm files 只收 harness/，registry 不進套件； symlink 在 npm pack 與 Windows 不可靠。產物 commit 進 repo（npm 裝的是產物、不跑 build）。 head/tail 是 harness 專屬（CLI 語境入口／acr 指令表／暴露同意／誠實鐵律）， install-harness 的 copyTree 跳過 .head/.tail，不鋪進使用者專案。 ■ 其餘三件逐份對照現世代事實後更新（過時的直接刪，不留死代碼） - CLAUDE.block.md：補 >> 意圖語法、not_found 兩條路、零件 vs recipe 分型、腹語術紅線、金鑰只拿名字 - commands/arcrun.md：步驟改成「先寫意圖 → 丟去查 → 再寫 YAML」，補 acr search／validate - hooks/arcrun-guard.sh：正路提示改為指向 arcrun-mindset Skill ＋意圖語法（呼應「hook 沒提 skill 反而把 AI 導向 repo 文件」的教訓）；新增 code 節點腹語術提醒，settings.fragment 補 Write\|Edit\|MultiEdit matcher ■ 世代閘（防再度脫節） check-harness-generation.mjs 檢查四件交付物的現世代指紋，缺指紋 exit 1，掛進 npm run build（prepublishOnly 因此也擋）。反向驗證：把 skill／CLAUDE.block 換回上一代 → 兩者都被擋下並逐條點名缺哪個指紋。 ■ 驗收（考生 haiku／受測物＝環境）乾淨臨時目錄 acr install-harness → 四件鋪好；重跑冪等（全檔 md5 不變、 CLAUDE.md 66 行不變、hooks 條目 2 不變、arcrun 區塊仍 1 個）。 haiku 只讀該目錄的 CLAUDE.md＋SKILL.md（明令禁讀 ~/.claude、禁上網；兩份教材 md5 與大小均不同，可證非考本機那支）答十題 → grade-step1.sh 10 / 10 通過（判分器同時反向驗證仍會抓 ON_TRUE／ON_FAILURE／第一節點非 input）。 npm test 18/18、tsc 綠。 SDD：workflow-discovery/tasks.md 3.11 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>	2026-07-31 15:29:17 +08:00

Author

SHA1

Message

Date

uncle6me-web

ae81d22775

fix(harness): 世代閘的 ON_TRUE 判準過時，反過來擋下正確教材

引擎自 2026-08-01 起已支援條件邊（cypher-executor/src/graph-executor.ts
case 'ON_TRUE'/'ON_FALSE'/'ON_BRANCH'，VALID_EDGE_TYPES 亦已列入；31 個
cypher-executor 測試全過）。registry/skills/write_intent_workflow.md（單一
真相源）也已在同日更正為教 ON_TRUE/ON_FALSE/ON_BRANCH 是合法邊。

但 cli/scripts/check-harness-generation.mjs 的世代閘還停在舊世代判準：
只要 SKILL.md 出現正面示範的 ON_TRUE 就擋——這道閘本身才是落後的一方，
把已經寫對的教材當錯誤攔下，害乾淨 `npm run build` 必敗。

同源的過時內容還藏在三個手動維護的 harness 原始檔（非腳本產物）：
CLAUDE.block.md／commands/arcrun.md／hooks/arcrun-guard.sh 都寫著
「引擎沒有條件邊」「沒有 ON_TRUE/ON_FALSE/ON_FAILURE」，一併更正。

真正不存在的邊是 ON_FAILURE（VALID_EDGE_TYPES 只有 ON_FAIL），把 mustNot
判準從 ON_TRUE 換成 ON_FAILURE，並新增 must 規則要求 ON_TRUE 必須出現，
防止教材日後又被改回「條件邊不存在」的舊世代說法。

skills/arcrun-mindset/SKILL.md 是由 registry 於建置期重建的產物
（build-harness-skill.mjs），本次改動只跑 `npm run build:harness`
重建、不手改。

驗證：故意把 SKILL.md 的 ON_FAILURE 改成正面示範，確認閘仍會擋下
（exit 1），還原後 `npm run build` 連跑兩次皆全綠且冪等（SKILL.md
md5 不變）。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-10 11:03:43 +08:00

uncle6me-web

46afea83c2

步驟1 最後一筆：install-harness 交付內容升級到現世代＋世代閘

管道本來就是好的（install-harness 功能完整、冪等），**過時的是內容**：
harness skill（4066B）grep「意圖」「>>」= 0 命中，只講世界觀／別寫 Python
⇒ 新裝的封測者拿不到步驟 1 的核心教材（`>>` 意圖語法）。

■ 單一真相源：harness skill 改為建置期由 registry 複製
  build-harness-skill.mjs＝head ＋ registry/skills/write_intent_workflow.md 正文 ＋ tail。
  選「建置期複製」的理由：npm files 只收 harness/，registry 不進套件；
  symlink 在 npm pack 與 Windows 不可靠。產物 commit 進 repo（npm 裝的是產物、不跑 build）。
  head/tail 是 harness 專屬（CLI 語境入口／acr 指令表／暴露同意／誠實鐵律），
  install-harness 的 copyTree 跳過 .head/.tail，不鋪進使用者專案。

■ 其餘三件逐份對照現世代事實後更新（過時的直接刪，不留死代碼）
  - CLAUDE.block.md：補 >> 意圖語法、not_found 兩條路、零件 vs recipe 分型、
    腹語術紅線、金鑰只拿名字
  - commands/arcrun.md：步驟改成「先寫意圖 → 丟去查 → 再寫 YAML」，補 acr search／validate
  - hooks/arcrun-guard.sh：**正路提示改為指向 arcrun-mindset Skill ＋意圖語法**
    （呼應「hook 沒提 skill 反而把 AI 導向 repo 文件」的教訓）；
    新增 code 節點腹語術提醒，settings.fragment 補 Write|Edit|MultiEdit matcher

■ 世代閘（防再度脫節）
  check-harness-generation.mjs 檢查四件交付物的現世代指紋，缺指紋 exit 1，
  掛進 npm run build（prepublishOnly 因此也擋）。
  反向驗證：把 skill／CLAUDE.block 換回上一代 → 兩者都被擋下並逐條點名缺哪個指紋。

■ 驗收（考生 haiku／受測物＝環境）
  乾淨臨時目錄 acr install-harness → 四件鋪好；重跑冪等（全檔 md5 不變、
  CLAUDE.md 66 行不變、hooks 條目 2 不變、arcrun 區塊仍 1 個）。
  haiku 只讀該目錄的 CLAUDE.md＋SKILL.md（明令禁讀 ~/.claude、禁上網；
  兩份教材 md5 與大小均不同，可證非考本機那支）答十題
  → grade-step1.sh **10 / 10 通過**（判分器同時反向驗證仍會抓
  ON_TRUE／ON_FAILURE／第一節點非 input）。
  npm test 18/18、tsc 綠。

SDD：workflow-discovery/tasks.md 3.11

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

2026-07-31 15:29:17 +08:00

2 Commits