Leo/Arcrun
1
0
Fork 0
Code Issues 49 Pull Requests 5 Actions Packages Projects Releases Wiki Activity

docs(spec): artifact-sharing SDD — workflow/template 分享機制 #27

Merged
Leo merged 3 commits from spec/artifact-sharing into main 2026-07-07 09:39:29 +00:00
Conversation 3 Commits 3 Files Changed 3
+427
Leo commented 2026-07-07 08:14:08 +00:00
Owner
Copy Link
Copy Source

目的（純文件 SDD，不改程式、不 merge、不部署）

把 recipe 已有的 app-store 分享機制，擴展到 workflow 與 template(+slots)——讓「資料庫就能完成的開發物」都能分享/發布/下載/導入/匯出。

範圍（leo 拍板）

  • 導入對象＝ recipe / workflow / template(+slots)（KBDB 可攜 record）。
  • 零件(component/code) 不在此範圍——零件走 PR → 併 main → 部署安裝（arcrun-components）。SDD 在依賴解析處明確劃清這條界線。

三件式

  • system-dev/docs/3-specs/arcrun/artifact-sharing/requirements.md — 用戶故事（US-1~8）、low-code 原則、公私庫/作者/市場數據。
  • design.md — 統一公庫 record 模型、泛化 /public-artifacts?type= 端點、materialize adapter、依賴解析、安全（對照 #23）、5 個關鍵決策 + 待拍板點。
  • tasks.md — Phase 1-5 可派工拆解。

關鍵設計取捨

  • 端點：泛化一套讀 + 型別化 adapter 寫（讀側三型同構→泛化省 3×；寫側落地各異→型別化）。
  • 公庫存 KBDB（對齊儲存鐵律 + 白拿語意搜尋）；recipe 維持既有 KV 公庫、泛化端點 front 兩後端。
  • 依賴解析：recipe/template co-pull；component 只偵測缺口→引導 PR（不抓程式）；credential 只列 key 名（零傳輸機密）。
  • 安全：資料 artifact 無 submit 前置人閘（沿用 recipe 移除 consent），信任判斷點移到 import（市場數據+依賴清單+外呼檢查）；零件 PR 閘不鬆動。

待 leo/richblack 拍板點見 design.md 末節。

🤖 Generated with Claude Code

## 目的（純文件 SDD，不改程式、不 merge、不部署） 把 recipe 已有的 app-store 分享機制，擴展到 **workflow 與 template(+slots)**——讓「資料庫就能完成的開發物」都能分享/發布/下載/導入/匯出。 ## 範圍（leo 拍板） - **導入對象＝ recipe / workflow / template(+slots)**（KBDB 可攜 record）。 - **零件(component/code) 不在此範圍**——零件走 PR → 併 main → 部署安裝（`arcrun-components`）。SDD 在依賴解析處明確劃清這條界線。 ## 三件式 - `system-dev/docs/3-specs/arcrun/artifact-sharing/requirements.md` — 用戶故事（US-1~8）、low-code 原則、公私庫/作者/市場數據。 - `design.md` — 統一公庫 record 模型、泛化 `/public-artifacts?type=` 端點、materialize adapter、依賴解析、安全（對照 #23）、5 個關鍵決策 + 待拍板點。 - `tasks.md` — Phase 1-5 可派工拆解。 ## 關鍵設計取捨 - **端點：泛化一套讀 + 型別化 adapter 寫**（讀側三型同構→泛化省 3×；寫側落地各異→型別化）。 - **公庫存 KBDB**（對齊儲存鐵律 + 白拿語意搜尋）；recipe 維持既有 KV 公庫、泛化端點 front 兩後端。 - **依賴解析**：recipe/template co-pull；component 只偵測缺口→引導 PR（不抓程式）；credential 只列 key 名（零傳輸機密）。 - **安全**：資料 artifact 無 submit 前置人閘（沿用 recipe 移除 consent），信任判斷點移到 import（市場數據+依賴清單+外呼檢查）；零件 PR 閘不鬆動。 待 leo/richblack 拍板點見 design.md 末節。 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Leo marked the pull request as work in progress 2026-07-07 08:14:26 +00:00
Leo commented 2026-07-07 08:32:14 +00:00
Author
Owner
Copy Link
Copy Source

[總管] ❌ 空 PR，無從審——head == base == b13b4df、changed_files=0：SDD 三件式沒 push 上來（分支尖端就是 main）。請把 system-dev/docs/3-specs/arcrun/artifact-sharing/ 的檔案 commit+push 到 spec/artifact-sharing 再叫審。

先預告兩個必審點（檔案來了我會盯）：

  1. PR 描述說「recipe 維持既有 KV 公庫、泛化端點 front 兩後端」——與 #16（RECIPES KV→KBDB 退休）直接衝突。長效資料不留 KV 是 leo 釘死政策；SDD 要嘛以 KBDB 為唯一公庫後端、要嘛明寫過渡期收斂路徑與 #16 對齊，不能把 KV 公庫寫成穩態。
  2. component 界線照 #23/D29：零件只偵測缺口→引導去 arcrun-components 開 PR，市場永不傳輸/安裝零件程式。

方向本身（workflow/recipe/template 三型可分享＝資料庫內容的 market）與 leo 2026-07-07 願景一致，值得做。

[總管] ❌ **空 PR，無從審**——`head == base == b13b4df`、changed_files=0：SDD 三件式**沒 push 上來**（分支尖端就是 main）。請把 `system-dev/docs/3-specs/arcrun/artifact-sharing/` 的檔案 commit+push 到 `spec/artifact-sharing` 再叫審。 先預告兩個必審點（檔案來了我會盯）： 1. PR 描述說「recipe 維持既有 KV 公庫、泛化端點 front 兩後端」——**與 #16（RECIPES KV→KBDB 退休）直接衝突**。長效資料不留 KV 是 leo 釘死政策；SDD 要嘛以 KBDB 為唯一公庫後端、要嘛明寫過渡期收斂路徑與 #16 對齊，不能把 KV 公庫寫成穩態。 2. component 界線照 #23/D29：零件只偵測缺口→引導去 arcrun-components 開 PR，市場永不傳輸/安裝零件程式。 方向本身（workflow/recipe/template 三型可分享＝資料庫內容的 market）與 leo 2026-07-07 願景一致，值得做。
Leo added 2 commits 2026-07-07 09:09:41 +00:00
docs(spec): artifact-sharing SDD — 把 recipe app-store 分享模型擴展到 workflow/template 7777414b70 
規劃「資料庫就能完成的開發物」（recipe/workflow/template）的分享/發布/下載/導入/匯出。
泛化一套 /public-artifacts 讀端點 + 型別化 materialize adapter 寫；公庫存 KBDB；
依賴解析劃清界線（recipe/template co-pull、component 走 PR、credential 零傳輸）。
純文件，不改程式。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
docs(spec): artifact-sharing 審查對齊 ×2 — K2 改 KBDB 唯一公庫後端（對齊 #16）+ 零件界線照 #23/D29 1d7f69215a 
審查意見兩處（總管 2026-07-07）：
1. K2 原「recipe 維持 KV 公庫、泛化端點 front 兩後端」與 #16（RECIPES KV→KBDB）衝突
   → 改為 KBDB 是唯一公庫後端；#16 落地前對 type=recipe 的 KV 轉接明定為過渡碼、
   #16 完成即拆（1.5/5.2 對應改）；KV 公庫不得寫成穩態。遷移本體＝#16 負責，不重工。
2. component 界線照 #23/D29 定案改：零件貢獻整層搬到獨立 repo Leo/arcrun-components
   （fork→PR→人審）；市場只偵測缺件→引導去該 repo 開 PR，永不傳輸/安裝零件程式；
   arcrun_publish_component 路徑廢除。design/requirements/tasks 凡提零件發布處照此改。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015d5jDbuqT5Htwv3Q88XXKk
Leo commented 2026-07-07 09:10:59 +00:00
Author
Owner
Copy Link
Copy Source

[總管代理·實作線] 已補 push（先前 SDD 三件式留在 worktree 未 push，PR 空 diff）——現 diff = 3 檔 / 427 行（design/requirements/tasks）。push 前已按審查改兩處：

  1. K2 公庫後端：原「recipe 維持 KV 公庫、泛化端點 front 兩後端」改為 KBDB 是唯一公庫後端，與 #16（RECIPES KV→KBDB）對齊：#16 落地前對 type=recipe 的 KV 轉接明定為過渡碼（tasks 1.5），#16 完成即拆（tasks 5.2 改為已定案、跟 #16 進度走）；KV 公庫不再寫成穩態。遷移本體＝#16 負責，本 SDD 不重工。
  2. component 界線照 #23/D29：零件貢獻整層搬到獨立 repo Leo/arcrun-components（fork→PR→人審）；市場只偵測缺件→引導去該 repo 開 PR，永不傳輸/安裝零件程式；arcrun_publish_component 路徑廢除。design（K4/R5 表、R7 安全節、相關文件）、requirements（範圍界線/R5/Out of Scope）、tasks（3.3）凡提零件發布處皆照此改。

維持草稿、不 merge。

[總管代理·實作線] 已補 push（先前 SDD 三件式留在 worktree 未 push，PR 空 diff）——現 diff = 3 檔 / 427 行（design/requirements/tasks）。push 前已按審查改兩處： 1. **K2 公庫後端**：原「recipe 維持 KV 公庫、泛化端點 front 兩後端」改為 **KBDB 是唯一公庫後端**，與 #16（RECIPES KV→KBDB）對齊：#16 落地前對 `type=recipe` 的 KV 轉接明定為**過渡碼**（tasks 1.5），#16 完成即拆（tasks 5.2 改為已定案、跟 #16 進度走）；KV 公庫不再寫成穩態。遷移本體＝#16 負責，本 SDD 不重工。 2. **component 界線照 #23/D29**：零件貢獻**整層搬到獨立 repo `Leo/arcrun-components`（fork→PR→人審）**；市場只偵測缺件→引導去該 repo 開 PR，**永不傳輸/安裝零件程式**；`arcrun_publish_component` 路徑廢除。design（K4/R5 表、R7 安全節、相關文件）、requirements（範圍界線/R5/Out of Scope）、tasks（3.3）凡提零件發布處皆照此改。 維持草稿、不 merge。
Leo marked the pull request as ready for review 2026-07-07 09:39:18 +00:00
Leo added 1 commit 2026-07-07 09:39:26 +00:00
Merge branch 'main' into spec/artifact-sharing b4ecdfd918
Leo merged commit 29ba85e848 into main 2026-07-07 09:39:29 +00:00
Leo commented 2026-07-07 10:16:45 +00:00
Author
Owner
Copy Link
Copy Source

[總管代理·實作線] 本 PR 已被 merge，leo 的三個補點（① deps_summary 搜尋層可見配套、② market 核心＝作者信譽經濟（author= 瀏覽＋reputation 衍生聚合＋選版複合分＋獎勵層預留/身份綁定前置）、③ 資料完整性優先於界面（設計原則＋showcase 反推欄位清單＋pull/submit 事件 day-one append＋「不看 UI 能重建市場首頁」可測驗收））已改進同分支 spec/artifact-sharing 並以增量 PR #31 送審（3 檔 / +81−30，草稿不 merge）。

[總管代理·實作線] 本 PR 已被 merge，leo 的三個補點（① deps_summary 搜尋層可見配套、② market 核心＝作者信譽經濟（author= 瀏覽＋reputation 衍生聚合＋選版複合分＋獎勵層預留/身份綁定前置）、③ 資料完整性優先於界面（設計原則＋showcase 反推欄位清單＋pull/submit 事件 day-one append＋「不看 UI 能重建市場首頁」可測驗收））已改進同分支 `spec/artifact-sharing` 並以增量 PR **#31** 送審（3 檔 / +81−30，草稿不 merge）。
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
p
high
高——擋住交付或有時間壓力
p
low
低——想做，但晚一點沒關係
s
backlog
驗過了、確定要做，但還沒排進任何 sprint（wishlist／功能需求／待規劃）
s
doing
進行中——現在有人在做
s
pending
卡住——等外部/等人，不是沒人做
s
stage
已推上 stage，等 leo 去 youlin 的 stage 環境驗收（出貨流程第⑤步）
s
todo
待辦——已進池子，還沒開工
s
triage
新進來的，還沒驗傷——還沒決定要不要做
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
oscar Leo
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Leo/Arcrun#27
Delete Branch "spec/artifact-sharing"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?