docs: finalize paperclip dev review

docs/paperclip_dev_review_2026-04-11.md

@@ -4,7 +4,8 @@
 > 審查對象：`origin/dev`
 > 初次審查 commit：`43c1770`
 > 追蹤審查 commit：`aceb1ba`
-> 用途：提供另一個 agent 依此修正 Paperclip package；本文件聚焦在匯入後行為與規格一致性
+> 最終追蹤 commit：`cb44714`
+> 用途：記錄 `dev` branch 的 Paperclip package 審查結果、修正追蹤與最終 smoke test 驗證
 
 ---
 
@@ -30,68 +31,98 @@ paperclipai company import <repo> --dry-run --json
 3. `quant-strategist` 的過大權限已移除
 4. project 的 Paperclip 專屬 metadata 已改由 `.paperclip.yaml` 承載，dry-run 匯入後可正確保留
 
-目前剩下 1 個新的 Paperclip 專屬結構問題，建議修完後再視為本輪完成。
+第三輪追蹤後，P5 也已修正完成，且額外完成了真正的 import smoke test。
+
+目前結論是：
+
+1. 這份 `dev` package 已通過本輪 Paperclip 規格審查
+2. `paperclipai company import --dry-run --json` 可通過，`warnings` / `errors` 為空
+3. 實際 import 到本地 Paperclip instance 也成功
+4. recurring task 會被建立為 routines，而不是 one-off issues，行為符合 Paperclip 設計
 
 ---
 
-## 2. 必修問題
+## 2. 最終驗證結果
 
-### P5. `ceo` agent 的 `role` 不是 Paperclip 預期的 `ceo`
+### 2.1 Dry-run 驗證
 
-**現況**
+使用：
 
-`agents/ceo/AGENTS.md` 目前是：
+```bash
+paperclipai company import <repo> --dry-run --json
+```
+
+確認結果：
+
+1. `ceo` 匯入後的 role 為 `ceo`
+2. `projects` 的 `leadAgentSlug` / `status` 有正確保留
+3. 四個 recurring task 都有對應的 `routine`
+4. `warnings: []`
+5. `errors: []`
+
+### 2.2 實際 import smoke test
+
+使用：
+
+```bash
+paperclipai company import /Users/chirs/workspace/KingClawArmy_dev_review \
+  --target new \
+  --new-company-name "KingClawArmy Smoke Test 2026-04-11" \
+  --yes \
+  --json
+```
+
+實測結果：
+
+1. 成功建立 company：`KingClawArmy Smoke Test 2026-04-11`
+2. 成功建立 11 個 agents
+3. 成功建立 2 個 projects
+4. recurring task 沒有被當成一般 issues 匯入，而是建立為 4 個 active routines
+5. `GET /api/companies/{companyId}/routines` 可查到：
+   - `每日量化 Pipeline 啟動`
+   - `每日盤後情報整理`
+   - `每日資料摘要`
+   - `每日記憶壓縮與狀態摘要`
+
+補充：
+
+1. 實際 import 回傳的 `issues` 數量是 0，這是正常的
+2. 原因是這 4 個 recurring tasks 在 Paperclip 內會被提升為 routines，而不是預先建立 one-off issues
+3. 真正的執行 issue 會在 routine 觸發時才產生
+
+### 2.3 最終判定
+
+就本輪審查範圍而言，`dev` branch 已可視為：
+
+1. Paperclip importable package
+2. 規格與實際匯入行為一致
+3. 可進入下一階段整合或實跑驗證
+
+---
+
+## 3. 已修正問題（追蹤確認）
+
+### 已修正 P5. `ceo` agent 的 `role` 不是 Paperclip 預期的 `ceo`
+
+**前次問題**
+
+`agents/ceo/AGENTS.md` 原本是：
 
 ```yaml
 role: manager
 ```
 
-參考：
+這會讓匯入後的執行長無法被 Paperclip 視為真正的 CEO，進而失去部分 CEO-safe 行為與公司層級權限。
 
-- `origin/dev:agents/ceo/AGENTS.md` 第 1-7 行
+**追蹤結果：**
 
-**影響**
+已修正。`origin/dev` 的 `cb44714` 已將其改為：
-
-這不是純命名風格問題。Paperclip 內部有多處行為直接依賴：
-
-```ts
-agent.role === "ceo"
-```
-
-例如：
-
-- 公司 branding 變更權限
-- company import/export 等 company portability 權限
-- CEO 專屬任務分派與部分控制面能力
-
-參考：
-
-- `paperclip/server/src/routes/companies.ts` 第 60-75 行
-- `paperclip/server/src/routes/agents.ts` 第 127-139 行
-
-如果匯入後 `ceo` 的 role 仍然是 `manager`，那他雖然因 `.paperclip.yaml` 的 `canCreateAgents: true` 仍保有部分管理能力，但不會被系統視為真正 CEO，會失去部分 CEO-safe 路由與公司層級操作能力。
-
-**建議修法**
-
-把 `agents/ceo/AGENTS.md` 中的：
-
-```yaml
-role: manager
-```
-
-改為：
 
 ```yaml
 role: ceo
 ```
 
-**建議採用：**
+而且 dry-run 匯入結果也已確認 `ceo.role == "ceo"`。
-
-直接改成 `role: ceo`
-
----
-
-## 3. 已修正問題（追蹤確認）
 
 ### 已修正 P1. 07:30 主排程沒有綁到真正的 recurring task
 
@@ -284,28 +315,28 @@ paperclipai company import . --dry-run --json
 
 ---
 
-## 5. 建議修改順序
+## 5. 後續建議
 
-另一個 agent 建議依照這個順序修：
+接下來如果要繼續往前推，建議順序是：
 
-1. 修 P5：把 `agents/ceo/AGENTS.md` 的 `role` 改為 `ceo`
+1. 在本地或測試環境做一次 routine 實跑驗證，確認觸發後會建立 execution issue
-2. 跑一次 `paperclipai company import --dry-run --json`
+2. 若要正式採用，補一份簡短的 import / smoke test 操作說明到 `docs/`
-3. 確認匯入後 CEO 具備 company-level portability / branding 等 CEO-safe 權限
+3. 若後續要擴充行銷或內容團隊，再以相同模式擴展 package 結構
-4. 若有需要，再更新 `docs/INDEX.md` 或其他說明文件
 
 ---
 
-## 6. 修正後的驗收標準
+## 6. 本輪驗收標準
 
-修完後，至少要確認：
+本輪已確認：
 
 1. `agents/ceo/AGENTS.md` 的 frontmatter 為 `role: ceo`
-2. `paperclipai company import --dry-run --json` 仍可成功通過
+2. `paperclipai company import --dry-run --json` 成功通過
 3. 匯入後 CEO 在系統中被辨識為真正的 CEO，而不是一般 manager
-4. 文件敘述與 package 實際內容一致
+4. recurring task 在真實 import 後會建立為 routines
+5. 文件敘述與 package 實際內容一致
 
 ---
 
-## 7. 給下一位 Agent 的一句話任務說明
+## 7. 一句話結論
 
-請修正 `origin/dev` 的 Paperclip package，將 `agents/ceo/AGENTS.md` 的 `role` 改成 `ceo`，確保匯入後 CEO 能取得 Paperclip 的 CEO-safe 行為與公司層級權限；修完後用 `paperclipai company import --dry-run --json` 驗證。
+`origin/dev` 的 KingClawArmy Paperclip package 已完成本輪修正並通過 dry-run 與實際 import smoke test，可進入下一階段驗證或整合。