diff --git a/system-dev/docs/3-specs/pending-changes.md b/system-dev/docs/3-specs/pending-changes.md index 833d972..997054e 100644 --- a/system-dev/docs/3-specs/pending-changes.md +++ b/system-dev/docs/3-specs/pending-changes.md @@ -421,3 +421,18 @@ leo 的判準(2026-07-30): ### ⏸ 等 leo confirm - confirm 後依 D35:兩份 SDD 目前皆 `paused`,要動需先處理單一活性 (現行 active=`workflow-discovery`) + + +## 提案:workflow export/import 一等公民化(2026-07-31,總管代 leo 口頭定調立案) + +- **來源**:leo 07-31 原話(見 workflow-discovery tasks.md 3.9 引文)——分享 workflow + 給同事的正路=export 檔→import,不是「用 search 湊」。 +- **變更面**:① cypher `GET /webhooks/named/:name/definition`(已實作,staging 試點中, + 零新資料模型/同 list 認證)② `acr workflow export `/`acr workflow import ` + 新 CLI 命令(已寫未接線)③ 安裝器 workflows.json=export 檔同形狀(graph 預編,已上 prod)。 +- **不動的牆**:KBDB 零接觸(export 讀 WEBHOOKS KV workflow record;import 打既有 + POST /webhooks/named);「部署≠發現」(import 不驗零件存在,執行時現形); + description 必填閘照舊。 +- **影響分析**:新公開端點 1 個(租戶 key 認證,吐的是該租戶自己部署的 workflow 定義; + 無跨租戶讀);CLI 新命令 2 個(薄殼,能力全在既有 API);無 schema migration、無新金鑰面。 +- **狀態**:⏳ 待 leo confirm 後 3.9b 接線。 diff --git a/system-dev/docs/3-specs/workflow-discovery/tasks.md b/system-dev/docs/3-specs/workflow-discovery/tasks.md index c123710..3b3176b 100644 --- a/system-dev/docs/3-specs/workflow-discovery/tasks.md +++ b/system-dev/docs/3-specs/workflow-discovery/tasks.md @@ -83,6 +83,24 @@ 有的照常編圖不必報告;缺的要兩庫(零件+recipe)都搜過後點名+給正確指示。 驗收兩層:機械(verify 01/03)綠 → haiku 真考(只讀回覆就能說出缺什麼、該做什麼)。 +## 3.9 追加(2026-07-31 深夜,t158 後續;leo 定調 export/import 原語) + +> leo:「你要做的就是一個叫 export,另一個是 import,打包好的幾個工作流準備好直接 +> import 就好了。現在如果我要把我做的工作流分享給同事,我要怎麼 export?他要如何 +> import?是缺了功能用 search 來湊嗎?在從前就是寫成幾個 yaml 丟過去讓新的送進 +> KBDB 不是嗎?」+「絕對不能違背原來的堅持(不能違規)」。 + +- [x] 3.9a `GET /webhooks/named/:name/definition`(export 引擎端):吐 workflow record + 原樣(graph+config+description)——與既有 list 同認證(X-Arcrun-API-Key)、 + 同租戶 key 前綴,**零新資料模型**。062757f 已入 staging bundle 試點。 + KBDB 牆自證:讀的是 WEBHOOKS KV(workflow 記錄),不碰 KBDB。 +- [ ] 3.9b `acr workflow export/import` CLI 接線(命令已寫 cli/commands/workflow.ts, + **未接進 index.ts**——D35 ③:新命令面屬規格層,已走 pending-changes 提案, + confirm 後才接)。import=graph 直 POST /webhooks/named(既有部署端點, + 零編圖零 search);手寫 yaml 指去 acr push。 +- [ ] 3.9c 安裝器同一條路驗證:workflows.json 打包期預編 graph+純上傳(rag-installer + 5a6539d 已上 prod)——安裝器不走私有路徑的機械檢查(copy-contract 級)留此收。 + --- ## 跨任務鐵律提醒