chore: 刪掉兩個死零件與其壞範例（leo：這裏的每個不要的零件還存在啊）

📋 SDD：workflow-discovery（active）／對應 CP arcrun-usable 步驟 5「死代碼清除」

刪除（git rm 保留歷史）：
- registry/components/km_writer      + .component-builds/km_writer
- registry/components/kbdb_upsert_block + .component-builds/kbdb_upsert_block
- registry/examples/km-wiki-ingest（唯一引用 kbdb_upsert_block 的範例，Mira 時代同源產物）

為什麼刪（Arcrun 自己的 06-mindset.md §1 早已載明）：
「mira 的 claude_api / km_writer 就是這樣被錯做成零件的（其實是自用服務膠水）」
＋ kbdb_upsert_block 是「一個 CRUD 操作一個零件」（leo：總不能每個都建一個零件）
＋ 兩者綁的 Mira 已於 2026-06-29 蒸發＝死零件。

刪前實測引用數：workflows.json 0／cypher src 0／examples 僅 km-wiki-ingest。
零件數 22 → 20。

✅ 投影模型驗證成功：build-bundles.mjs 掃 .component-builds/ 目錄（readdirSync），
重跑後 manifest 自動 25 顆 → 23 顆，兩顆消失，**不需手動改 manifest**。
⇒ 證明 manifest 這層本來就是投影（leo 的設計），只有 registry KV 那層是獨立登記簿（待改）。

驗：vitest 9 failed/179 passed＝與刪除前相同（既有債）。

registry/components/kbdb_upsert_block/component.contract.yaml

@@ -1,90 +0,0 @@
-canonical_id: "kbdb_upsert_block"
-display_name: "KBDB Upsert Block"
-category: "data"
-version: "v1"
-wasi_target: "preview1"
-stability: "floating"
-runtime_compat:
-  - "cf-workers"
-  - "workerd"
-  - "wazero"
-constraints:
-  max_size_kb: 2048
-  max_cold_start_ms: 50
-  no_network_syscall: false
-  no_filesystem_syscall: true
-  io_model: "stdin_stdout_json"
-input_schema:
-  type: object
-  required: [api_key, page_name, content]
-  properties:
-    api_key:
-      type: string
-      description: KBDB partner key（ak_xxx）
-    page_name:
-      type: string
-      description: 當 idempotency key。內部用 GET /blocks?page_name= 查找。
-    content:
-      type: string
-      description: block 內容（PATCH 時覆寫，CREATE 時新建）
-    type:
-      type: string
-      description: block type（建立時用，PATCH 時忽略）
-    parent_id:
-      type: string
-      description: 父 block id（建立時用，PATCH 時忽略）
-    user_id:
-      type: string
-      description: 建立時帶入 + lookup 時用來 filter（同 page_name 多 user 共存場景）
-    source:
-      type: string
-      description: 來源標記
-    tags_json:
-      type: string
-      description: tags JSON 字串（PATCH 時轉 array、CREATE 時直傳）
-    kbdb_url:
-      type: string
-      description: KBDB API base（預設 https://kbdb.finally.click）
-output_schema:
-  type: object
-  properties:
-    success:
-      type: boolean
-    action:
-      type: string
-      enum: [created, patched]
-      description: 實際做了哪個動作
-    data:
-      type: object
-      description: KBDB 回傳（含 block id 等）
-    error:
-      type: string
-    phase:
-      type: string
-      enum: [lookup, patch, create]
-      description: 出錯在哪個階段
-gherkin_tests:
-  - scenario: "缺 page_name"
-    given: '{"api_key":"ak_x","content":"hi"}'
-    then_contains: '"success":false'
-  - scenario: "建立新 block"
-    given: '{"api_key":"ak_x","page_name":"new-page-uniq","content":"hello"}'
-    then_contains: '"action":"created"'
-  - scenario: "PATCH 既有 block"
-    given: '{"api_key":"ak_x","page_name":"existing-page","content":"updated"}'
-    then_contains: '"action":"patched"'
-tags: [data, storage, kbdb, upsert, primitive, idempotent]
-description: |
-  Upsert：用 page_name 當 idempotency key。內部 GET 找有沒有同 page_name 的 block，
-  找到就 PATCH 不到就 POST 新建。解 arcrun workflow 缺 IF/branch 能力的缺口
-  （arcrun.md P1 #1）。mira 7B.3f index-entry per-entity 維護是第一個使用者。
-config_example: |
-  upsert_index_entry:
-    api_key: "{{api_key}}"
-    page_name: "index-{{entity}}"
-    parent_id: "{{mira_wiki_index_entities_id}}"
-    type: "index-entry"
-    user_id: "inkstone_mira_tools"
-    source: "ai-canon-wiki"
-    content: "{{compose_index_entry.data.text}}"
-    tags_json: '["mira-wiki", "ai-generated", "index"]'

registry/components/kbdb_upsert_block/go.mod

@@ -1,3 +0,0 @@
-module kbdb_upsert_block
-
-go 1.21

registry/components/kbdb_upsert_block/main.go

@@ -1,280 +0,0 @@
-// kbdb_upsert_block — 用 page_name 當 idempotency key 做 upsert
-// 內部：GET /blocks?page_name=X → user_id filter → 找到 PATCH /blocks/:id 沒找到 POST /blocks
-// 解 arcrun workflow 沒 IF/branch 能力的缺口（arcrun.md P1 #1）
-// 對應 SDD：polaris/mira/.agents/specs/mira-app/design.md §3.5.12.4.1
-//
-//go:build tinygo
-
-package main
-
-import (
-	"encoding/json"
-	"io"
-	"os"
-	"strconv"
-	"unsafe"
-)
-
-//go:wasmimport u6u http_request
-func hostHttpRequest(
-	urlPtr uintptr, urlLen uint32,
-	methodPtr uintptr, methodLen uint32,
-	headersPtr uintptr, headersLen uint32,
-	bodyPtr uintptr, bodyLen uint32,
-	outPtr uintptr, outLenPtr uintptr,
-) uint32
-
-type Input struct {
-	KBDBUrl    string `json:"kbdb_url"`    // optional
-	APIKey     string `json:"api_key"`     // 必填
-	PageName   string `json:"page_name"`   // 必填，當 idempotency key
-	Content    string `json:"content"`     // 必填
-	Type       string `json:"type"`        // optional（建立時用，PATCH 時忽略）
-	ParentID   string `json:"parent_id"`   // optional（建立時用，PATCH 時忽略）
-	UserID     string `json:"user_id"`     // optional（建立時用 + lookup filter）
-	Source     string `json:"source"`      // optional
-	TagsJSON   string `json:"tags_json"`   // optional（完整覆寫）
-	CreateOnly bool   `json:"create_only"` // 2026-05-17 加：若 true + 已存在 → 不 PATCH，回 action="exists"
-	                                       // 用於 stub creation 場景（避免 stub 覆寫已存在的 full wiki）
-}
-
-var dummy [1]byte
-
-func safePtr(b []byte) (uintptr, uint32) {
-	if len(b) == 0 {
-		return uintptr(unsafe.Pointer(&dummy[0])), 0
-	}
-	return uintptr(unsafe.Pointer(&b[0])), uint32(len(b))
-}
-
-func writeError(msg string) {
-	out, _ := json.Marshal(map[string]interface{}{"success": false, "error": msg})
-	os.Stdout.Write(out)
-}
-
-func writeResult(action string, data map[string]interface{}) {
-	out, _ := json.Marshal(map[string]interface{}{
-		"success": true,
-		"action":  action,
-		"data":    data,
-	})
-	os.Stdout.Write(out)
-}
-
-// urlEncode：跟 kbdb_get 一致，避免引入 net/url
-func urlEncode(s string) string {
-	var out []byte
-	for i := 0; i < len(s); i++ {
-		c := s[i]
-		if (c >= 'a' && c <= 'z') || (c >= 'A' && c <= 'Z') || (c >= '0' && c <= '9') ||
-			c == '-' || c == '_' || c == '.' || c == '~' {
-			out = append(out, c)
-		} else {
-			const hex = "0123456789ABCDEF"
-			out = append(out, '%', hex[c>>4], hex[c&0x0f])
-		}
-	}
-	return string(out)
-}
-
-func httpCall(method, url string, headers map[string]string, body []byte) ([]byte, uint32) {
-	headersBytes, _ := json.Marshal(headers)
-	urlBytes := []byte(url)
-	methodBytes := []byte(method)
-
-	outBuf := make([]byte, 1<<20) // 1MB
-	var outLen uint32
-
-	urlPtr, urlLen := safePtr(urlBytes)
-	methodPtr, methodLen := safePtr(methodBytes)
-	headersPtr, headersLenU := safePtr(headersBytes)
-	bodyPtr, bodyLenU := safePtr(body)
-
-	result := hostHttpRequest(
-		urlPtr, urlLen,
-		methodPtr, methodLen,
-		headersPtr, headersLenU,
-		bodyPtr, bodyLenU,
-		uintptr(unsafe.Pointer(&outBuf[0])), uintptr(unsafe.Pointer(&outLen)),
-	)
-	return outBuf[:outLen], result
-}
-
-func main() {
-	raw, err := io.ReadAll(os.Stdin)
-	if err != nil {
-		writeError("failed to read stdin: " + err.Error())
-		return
-	}
-
-	var input Input
-	if err := json.Unmarshal(raw, &input); err != nil {
-		writeError("invalid input JSON: " + err.Error())
-		return
-	}
-
-	if input.APIKey == "" {
-		writeError("api_key 必填")
-		return
-	}
-	if input.PageName == "" {
-		writeError("page_name 必填（upsert 的 idempotency key）")
-		return
-	}
-	if input.Content == "" {
-		writeError("content 必填")
-		return
-	}
-
-	kbdbURL := input.KBDBUrl
-	if kbdbURL == "" {
-		kbdbURL = "https://kbdb.finally.click"
-	}
-
-	headers := map[string]string{
-		"Authorization": "Bearer " + input.APIKey,
-	}
-
-	// ── Step 1：lookup by page_name ────────────────────────────────────
-	lookupURL := kbdbURL + "/blocks?page_name=" + urlEncode(input.PageName) +
-		"&limit=" + strconv.Itoa(10)
-	lookupResp, callResult := httpCall("GET", lookupURL, headers, nil)
-	if callResult != 0 {
-		writeError("KBDB lookup failed (host_http_request returned non-zero)")
-		return
-	}
-
-	var lookupParsed struct {
-		Blocks []map[string]interface{} `json:"blocks"`
-		Count  int                      `json:"count"`
-		Error  interface{}              `json:"error"`
-	}
-	if err := json.Unmarshal(lookupResp, &lookupParsed); err != nil {
-		writeError("KBDB lookup returned non-JSON: " + string(lookupResp))
-		return
-	}
-	if lookupParsed.Error != nil {
-		errBytes, _ := json.Marshal(map[string]interface{}{
-			"success": false,
-			"error":   lookupParsed.Error,
-			"phase":   "lookup",
-		})
-		os.Stdout.Write(errBytes)
-		return
-	}
-
-	// ── Step 2：找符合 user_id 的第一筆 ──────────────────────────────
-	var existing map[string]interface{}
-	for _, b := range lookupParsed.Blocks {
-		if input.UserID == "" {
-			existing = b
-			break
-		}
-		if uid, ok := b["user_id"].(string); ok && uid == input.UserID {
-			existing = b
-			break
-		}
-	}
-
-	// ── Step 3：分支寫入 ───────────────────────────────────────────────
-	postHeaders := map[string]string{
-		"Content-Type":  "application/json",
-		"Authorization": "Bearer " + input.APIKey,
-	}
-
-	if existing != nil {
-		// CreateOnly 模式：已存在 → 不動，回 action="exists"（給 stub creation 用，
-		// 避免後續 raw 提到同 entity 時把完整 wiki 覆寫成 stub）
-		if input.CreateOnly {
-			writeResult("exists", existing)
-			return
-		}
-
-		// PATCH 路徑
-		existingID, _ := existing["id"].(string)
-		if existingID == "" {
-			writeError("lookup 找到 block 但 id 為空")
-			return
-		}
-
-		patchBody := make(map[string]interface{})
-		patchBody["content"] = input.Content
-		if input.Source != "" {
-			patchBody["source"] = input.Source
-		}
-		if input.TagsJSON != "" {
-			// PATCH endpoint 用 tags array 不是 tags_json string
-			var tagsArr []string
-			if err := json.Unmarshal([]byte(input.TagsJSON), &tagsArr); err == nil {
-				patchBody["tags"] = tagsArr
-			}
-		}
-		patchBodyBytes, _ := json.Marshal(patchBody)
-
-		patchURL := kbdbURL + "/blocks/" + existingID
-		patchResp, callResult := httpCall("PATCH", patchURL, postHeaders, patchBodyBytes)
-		if callResult != 0 {
-			writeError("KBDB PATCH failed (host_http_request returned non-zero)")
-			return
-		}
-		var patchParsed map[string]interface{}
-		if err := json.Unmarshal(patchResp, &patchParsed); err != nil {
-			writeError("KBDB PATCH returned non-JSON: " + string(patchResp))
-			return
-		}
-		if _, hasErr := patchParsed["error"]; hasErr {
-			errBytes, _ := json.Marshal(map[string]interface{}{
-				"success": false,
-				"error":   patchParsed["error"],
-				"phase":   "patch",
-			})
-			os.Stdout.Write(errBytes)
-			return
-		}
-		writeResult("patched", patchParsed)
-		return
-	}
-
-	// CREATE 路徑
-	postBody := make(map[string]interface{})
-	postBody["content"] = input.Content
-	postBody["page_name"] = input.PageName
-	if input.Type != "" {
-		postBody["type"] = input.Type
-	}
-	if input.ParentID != "" {
-		postBody["parent_id"] = input.ParentID
-	}
-	if input.UserID != "" {
-		postBody["user_id"] = input.UserID
-	}
-	if input.Source != "" {
-		postBody["source"] = input.Source
-	}
-	if input.TagsJSON != "" {
-		postBody["tags_json"] = input.TagsJSON
-	}
-	postBodyBytes, _ := json.Marshal(postBody)
-
-	postURL := kbdbURL + "/blocks"
-	postResp, callResult := httpCall("POST", postURL, postHeaders, postBodyBytes)
-	if callResult != 0 {
-		writeError("KBDB POST failed (host_http_request returned non-zero)")
-		return
-	}
-	var postParsed map[string]interface{}
-	if err := json.Unmarshal(postResp, &postParsed); err != nil {
-		writeError("KBDB POST returned non-JSON: " + string(postResp))
-		return
-	}
-	if _, hasErr := postParsed["error"]; hasErr {
-		errBytes, _ := json.Marshal(map[string]interface{}{
-			"success": false,
-			"error":   postParsed["error"],
-			"phase":   "create",
-		})
-		os.Stdout.Write(errBytes)
-		return
-	}
-	writeResult("created", postParsed)
-}

registry/components/km_writer/component.contract.yaml

@@ -1,67 +0,0 @@
-canonical_id: "km_writer"
-display_name: "KM Writer"
-category: "api"
-version: "v1"
-wasi_target: "preview1"
-stability: "floating"
-runtime_compat:
-  - "cf-workers"
-  - "workerd"
-constraints:
-  max_size_kb: 2048
-  max_cold_start_ms: 50
-  no_network_syscall: false
-  no_filesystem_syscall: true
-  io_model: "stdin_stdout_json"
-input_schema:
-  type: object
-  required: [action, mira_url, token]
-  properties:
-    action:
-      type: string
-      description: "操作類型：read_journal | read_journal_date | append_journal | list_pages | read_page | write_page"
-      enum: [read_journal, read_journal_date, append_journal, list_pages, read_page, write_page]
-    mira_url:
-      type: string
-      description: "Mira 服務基礎 URL（例：https://mira.uncle6.me）"
-    token:
-      type: string
-      description: "Mira MIRA_TOKEN（Bearer token）"
-    content:
-      type: string
-      description: "內容（append_journal / write_page 時必填）"
-    timestamp:
-      type: string
-      description: "ISO 8601 時間戳（append_journal 時選填，影響日期和時間顯示）"
-    date:
-      type: string
-      description: "日期 YYYY-MM-DD（read_journal_date 時必填）"
-    name:
-      type: string
-      description: "頁面名稱（read_page / write_page 時必填）"
-output_schema:
-  type: object
-  properties:
-    success:
-      type: boolean
-    data:
-      type: object
-      description: "Mira API 回應資料"
-    error:
-      type: string
-      description: "錯誤訊息（success=false 時）"
-gherkin_tests:
-  - scenario: "缺少 action"
-    given: '{"mira_url":"https://mira.uncle6.me","token":"abc"}'
-    then_contains: '{"success":false'
-  - scenario: "缺少 token"
-    given: '{"action":"list_pages","mira_url":"https://mira.uncle6.me"}'
-    then_contains: '{"success":false'
-tags: [km, journal, logseq, mira, knowledge-management]
-description: "讀寫 Mira leo-graph 的 journals 和 pages。透過 host function 呼叫 Mira /km/* API，支援讀取、新增日誌條目，以及讀寫頁面。"
-config_example: |
-  append_to_journal:
-    action: "append_journal"
-    mira_url: "https://mira.uncle6.me"
-    token: "<mira_token>"
-    content: "今天完成了 arcrun km_writer 元件"

registry/components/km_writer/go.mod

@@ -1,3 +0,0 @@
-module component
-
-go 1.21

registry/components/km_writer/main.go

@@ -1,177 +0,0 @@
-// km_writer — 讀寫 Mira leo-graph（journals + pages）
-// 透過 host function 呼叫 Mira /km/* API
-//
-//go:build tinygo
-
-package main
-
-import (
-	"encoding/json"
-	"fmt"
-	"io"
-	"os"
-	"unsafe"
-)
-
-//go:wasmimport u6u http_request
-func hostHttpRequest(
-	urlPtr uintptr, urlLen uint32,
-	methodPtr uintptr, methodLen uint32,
-	headersPtr uintptr, headersLen uint32,
-	bodyPtr uintptr, bodyLen uint32,
-	outPtr uintptr, outLenPtr uintptr,
-) uint32
-
-// Input actions:
-//   read_journal        — GET today's journal (requires: mira_url, token)
-//   read_journal_date   — GET journal by date (requires: mira_url, token, date)
-//   append_journal      — POST append entry (requires: mira_url, token, content; optional: timestamp)
-//   list_pages          — GET all pages (requires: mira_url, token)
-//   read_page           — GET page by name (requires: mira_url, token, name)
-//   write_page          — PUT write page (requires: mira_url, token, name, content)
-
-type Input struct {
-	Action    string `json:"action"`
-	MiraURL   string `json:"mira_url"`
-	Token     string `json:"token"`
-	Content   string `json:"content"`
-	Timestamp string `json:"timestamp"`
-	Date      string `json:"date"`
-	Name      string `json:"name"`
-}
-
-func main() {
-	raw, err := io.ReadAll(os.Stdin)
-	if err != nil {
-		writeError("failed to read stdin: " + err.Error())
-		return
-	}
-	var inp Input
-	if err := json.Unmarshal(raw, &inp); err != nil {
-		writeError("invalid input JSON: " + err.Error())
-		return
-	}
-	if inp.Action == "" {
-		writeError("action 必填")
-		return
-	}
-	if inp.MiraURL == "" {
-		writeError("mira_url 必填")
-		return
-	}
-	if inp.Token == "" {
-		writeError("token 必填")
-		return
-	}
-
-	authHeader := fmt.Sprintf(`{"Authorization":"Bearer %s","Content-Type":"application/json"}`, inp.Token)
-
-	switch inp.Action {
-	case "read_journal":
-		result := doRequest(inp.MiraURL+"/km/journal", "GET", authHeader, "")
-		os.Stdout.Write(result)
-
-	case "read_journal_date":
-		if inp.Date == "" {
-			writeError("date 必填（格式 YYYY-MM-DD）")
-			return
-		}
-		result := doRequest(inp.MiraURL+"/km/journal/"+inp.Date, "GET", authHeader, "")
-		os.Stdout.Write(result)
-
-	case "append_journal":
-		if inp.Content == "" {
-			writeError("content 必填")
-			return
-		}
-		bodyMap := map[string]string{"content": inp.Content}
-		if inp.Timestamp != "" {
-			bodyMap["timestamp"] = inp.Timestamp
-		}
-		bodyBytes, _ := json.Marshal(bodyMap)
-		result := doRequest(inp.MiraURL+"/km/journal", "POST", authHeader, string(bodyBytes))
-		os.Stdout.Write(result)
-
-	case "list_pages":
-		result := doRequest(inp.MiraURL+"/km/pages", "GET", authHeader, "")
-		os.Stdout.Write(result)
-
-	case "read_page":
-		if inp.Name == "" {
-			writeError("name 必填")
-			return
-		}
-		result := doRequest(inp.MiraURL+"/km/page/"+inp.Name, "GET", authHeader, "")
-		os.Stdout.Write(result)
-
-	case "write_page":
-		if inp.Name == "" {
-			writeError("name 必填")
-			return
-		}
-		if inp.Content == "" {
-			writeError("content 必填")
-			return
-		}
-		bodyMap := map[string]string{"content": inp.Content}
-		bodyBytes, _ := json.Marshal(bodyMap)
-		result := doRequest(inp.MiraURL+"/km/page/"+inp.Name, "PUT", authHeader, string(bodyBytes))
-		os.Stdout.Write(result)
-
-	default:
-		writeError("未知 action: " + inp.Action)
-	}
-}
-
-func doRequest(url, method, headersJSON, body string) []byte {
-	urlBytes := []byte(url)
-	methodBytes := []byte(method)
-	headersBytes := []byte(headersJSON)
-	bodyBytes := []byte(body)
-
-	outBuf := make([]byte, 131072) // 128KB
-	var outLen uint32
-
-	if len(bodyBytes) == 0 {
-		bodyBytes = []byte{}
-	}
-
-	var bodyPtr uintptr
-	var bodyLen uint32
-	if len(bodyBytes) > 0 {
-		bodyPtr = uintptr(unsafe.Pointer(&bodyBytes[0]))
-		bodyLen = uint32(len(bodyBytes))
-	}
-
-	code := hostHttpRequest(
-		uintptr(unsafe.Pointer(&urlBytes[0])), uint32(len(urlBytes)),
-		uintptr(unsafe.Pointer(&methodBytes[0])), uint32(len(methodBytes)),
-		uintptr(unsafe.Pointer(&headersBytes[0])), uint32(len(headersBytes)),
-		bodyPtr, bodyLen,
-		uintptr(unsafe.Pointer(&outBuf[0])), uintptr(unsafe.Pointer(&outLen)),
-	)
-
-	if code != 0 {
-		out, _ := json.Marshal(map[string]interface{}{"success": false, "error": "HTTP request failed"})
-		return out
-	}
-
-	responseStr := string(outBuf[:outLen])
-
-	// Try to parse the response as JSON to forward it
-	var parsed interface{}
-	if err := json.Unmarshal([]byte(responseStr), &parsed); err != nil {
-		// Not JSON — wrap it
-		out, _ := json.Marshal(map[string]interface{}{"success": true, "data": responseStr})
-		return out
-	}
-
-	// Forward the parsed response as-is, wrapped in success
-	out, _ := json.Marshal(map[string]interface{}{"success": true, "data": parsed})
-	return out
-}
-
-func writeError(msg string) {
-	out, _ := json.Marshal(map[string]interface{}{"success": false, "error": msg})
-	os.Stdout.Write(out)
-}