# 提案：新自訂 arcrun 零件 km_wiki_card_parse 的契約（Phase A 提案，尚未部署）。
# 定位：機械把「已精耕 wiki 卡片」解析成 base entry + graph triplet envelope（無 LLM、無 fs/網路）。
# 完全符合 arcrun 元件形狀（stdin_stdout_json、no_network_syscall、no_filesystem_syscall）。
# 參考實作：lib/card-to-envelope.mjs（決定性純函式；部署時移植成 Go/WASM 或以 workerd JS 元件承載）。
canonical_id: "km_wiki_card_parse"
display_name: "KM Wiki 卡片機械解析"
category: "transform"
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: true       # 純轉換，不打網路
  no_filesystem_syscall: true    # 卡片全文由上游 http_request 餵入，不讀檔
  io_model: "stdin_stdout_json"
input_schema:
  type: object
  required: [content, rel_path]
  properties:
    content:
      type: string
      description: 卡片 Markdown 全文（上游 http_request 從 Gitea raw 抓）。
    rel_path:
      type: string
      description: 卡片相對 repo 根的路徑（如 system-dev/wiki/cards/notes/Xxx.md）。
    repo:
      type: string
      description: 來源 repo（如 Leo/notes），組 source.uri / page_name 用。預設 Leo/notes。
    budget:
      type: number
      description: 單 envelope subrequest 目標上限（預設 40，CF 硬頂 50）。超過則自動 anchor 分段。
    commit:
      type: string
      description: git commit sha（可追溯，寫進 source.commit）。選填。
output_schema:
  type: object
  properties:
    entry:
      type: object
      description: 卡片→base entry。含 page_name（冪等鍵）、entry_type、content、tags、metadata(embed=true, source, content_hash)。
    envelopes:
      type: array
      description: >
        卡片→graph triplet envelope 陣列（已分段、已符合 ingest-candidate.json 契約）。
        每個 envelope 附 _estSubrequests；planner 保證每段 ≤ budget。無邊的卡回空陣列。
    meta:
      type: object
      description: canonical / title / content_hash 等追溯資訊。
gherkin_tests:
  - scenario: "typed-edge 卡片"
    given: '{"content":"## 實體\n- **A** — a\n- **B** — b\n## 關聯\n### 內文知識關係\n- A >> 關係 >> B","rel_path":"system-dev/wiki/cards/notes/t.md"}'
    then_contains: '"subject":"A"'
  - scenario: "embed 打標"
    given: '{"content":"# t\n## 實體\n- **A** — a\n## 關聯\n### 內文知識關係\n- A >> r >> A","rel_path":"x/t.md"}'
    then_contains: '"embed":true'
tags: [transform, wiki, ingest, mechanical, kbdb, primitive]
description: |
  取代 kbdb-ingest-plugin 舊 raw→Haiku 路的機械版：讀「已精耕卡」的 ## 實體（節點）、
  ## 關聯 的 typed-edge（A >> 關係 >> B）與 [[wikilink]]，直接映射 entry + triplet，零 LLM、零 token。
  自動以 source_uri anchor 分段，保證每個 graph /triplets/ingest 呼叫壓在 CF subrequest 上限下。