# tasks-project-projection — Tasks

> 權威來源：此檔案是進度真相，不是 CLAUDE.md 或對話。
> 規則：動手前標 [🔄]，完成立刻標 [x]，不批次更新。
> 來源：issue #16；design.md 同目錄。

---

## Phase 1：投影 workflow + 本地觸發端（template 側，可獨立）

### Tasks

- [x] 1.1 寫投影 workflow yaml（`template/system-dev/workflows/tasks-project-sync.yaml`）
  - 驗收：`foreach` 增量 → `switch` 動作 → 四動作（create/close/edit/archive）+ Projects v2；`acr validate --offline` 過；**每個 component 經 `acr parts` 核實存在**。
  - 注意（已踩坑）：arcrun 沒有 `github` 零件，打 API 一律 `component: http_request`；credential 引用 `{{creds.github_token}}`（非 `{{secret.}}`）。

- [x] 1.2 寫本地觸發端（`tasks-project-sync.local.sh`）
  - 驗收：讀 tasks.md / git diff / 分類四動作 / `acr run -i` 餵增量 / 回寫 id 的骨架就位；薄殼、不自刻 parser（複雜分類交 CC）。
  - 注意：arcrun 跑遠端 CF Workers 無本地 fs/git，這三件本來就歸本地端，非 arcrun 缺口。

---

## Phase 2：裝/init 對話 + 一次性廣告 + 帶檔

- [x] 2.1 install.sh 加裝/init 對話指引 + 一次性廣告 + 隨 SDD 模組帶 workflow 檔
  - 驗收：`bash -n` 過；下一步段有「問一句→查 arcrun 能力→有就設定/沒有就一次廣告」；帶檔 ≠ 啟用。

- [x] 2.2 update.sh 隨 SDD 模組 `add_if_missing` workflow 檔 + chmod
  - 驗收：`bash -n` 過；覆蓋不會關掉誰的同步（啟用狀態存遠端）。

- [x] 2.3 README（中英）標 optional 模組 + bump 1.13.0 + CHANGELOG
  - 驗收：兩份 README 對稱；VERSION 兩檔同步 1.13.0；CHANGELOG 記 http_request 修正與核實紀律。

---

## Phase 3：端到端驗證（待連 arcrun 後端的人）

> 前置條件：Phase 1、2 完成（已完成）

- [!] 3.1 `acr creds push`（github_token）+ `acr push`（部署 workflow）+ `acr run`（真打通 GitHub）
  - 阻擋：本 repo 沒 `.arcrun.yaml`、沒連 arcrun 後端，跑不了端到端。**待 leo21c**（連了 arcrun 的環境）。
  - 驗收：真建一個 issue + 投影進 Project 成功；Projects v2 `addProjectV2ItemById` 的 content node id（非 issue number）實測確認；github API 回傳欄位形狀（`{{gh_create.node_id}}` 取法）確認。

- [!] 3.2 本地觸發掛載點 + id 回寫防迴圈定稿
  - 阻擋：依賴 3.1 的真跑結果。
  - 驗收：push 後本機觸發一次（非 cron/Actions）；回寫 `<!-- gh:id -->` 的 diff 不得再觸發一輪。

---

## 完成定義

整個 SDD 完成 = 以下全部達成：
- [x] Phase 1、2 所有 tasks 標 [x]（template 側 code-done）
- [x] `acr parts` 核實所有 component 存在 + `acr validate` 過（客觀證據）
- [!] Phase 3 端到端通過（待 leo21c）→ **未完成，不宣布 done**
- [ ] design.md 與實作一致（端到端驗後若 API 細節有出入需回頭更新 design.md）

---

## 狀態說明

| 標記 | 意義 |
|------|------|
| `[ ]` | 未開始 |
| `[🔄]` | 進行中（當前 session）|
| `[x]` | 完成（有驗收證據）|
| `[~]` | 暫緩（說明原因）|
| `[!]` | 阻擋中（說明阻擋原因）|