awoooi/docs/security/GITEA-INVENTORY-OWNER-ATTESTATION-RESPONSE.md

Gitea 清冊 Owner Attestation Response 收件包

項目	內容
日期	2026-06-04
狀態	草案，等待 owner response
資料契約	docs/schemas/gitea_inventory_owner_attestation_response_v1.schema.json
快照	docs/security/gitea-inventory-owner-attestation-response.snapshot.json
來源契約	gitea_inventory_coverage_attestation_v1
目標契約	gitea_repo_inventory_v1
模式	owner_response_intake_only
執行面授權	false

0. 核心結論

S4.9 補的是「owner 要怎麼回覆 S4.7 的 5 個 coverage attestation items」。

S4.7 已定義要問什麼，S4.8 已把它接到 AwoooP approval lane；S4.9 則把回覆欄位、驗收規則、拒收規則與允許輸出固定下來，避免 owner response 混入 token、DB dump、git object、repo 建立、refs sync 或 GitHub primary approval。

此文件不要求貼 token，不接受 raw secret，不寫 Gitea，不建立 GitHub repo，不 sync refs，也不把任何 attestation response 當成 migration approval。

1. Response 摘要

指標	值
owner response 狀態	waiting_owner_response
必要 response items	5
已收到 response	0
已接受 response	0
已拒收 response	0
response templates	5
owner response template statuses	5
owner response audit event templates	3
owner response redaction examples	5
owner response display sections	8
owner response request packet	1
owner response collection checks	6
intake preflight checks	6
intake outcome lanes	5
acceptance checks	8
rejection rules	10
允許收集 token value	false
允許 raw secret	false
允許 repo write / refs sync	false
授權切換 GitHub primary	false
允許 action button	false

1.1 2026-06-04 Current Intake Readiness

本段把 S4.9 從「已經有收件契約」再推進成「目前可直接照表收件與預檢」的狀態。這只代表收件準備度完成，不代表 request 已送出、owner 已回覆、response 已接受或任何執行授權。

指標	目前值	邊界
S4.9 收件準備度	100%	五個 templates、必填欄位、收件檢查、預檢、拒收規則與 outcome lanes 已可用
S4.9 owner response gate	0%	received_response_count=0、accepted_response_count=0、rejected_response_count=0
下一個收件焦點	S4.9 Gitea owner attestation response	S4.10 / S4.11 / S4.12 仍排隊，不可提前視為 accepted
可收資料	owner role / team、decision、decision reason、affected scope、redacted evidence refs、followup owner	只收脫敏 metadata 或 repo 內文件參照
不可收資料	token、secret、private key、cookie、session、DB dump、git object、repo archive、private URL credential、執行 payload	疑似敏感值先 quarantine，執行要求 hard reject
可更新結果	read-only coverage wording、migration matrix、decision table、readiness blocker	不寫 Gitea、不建 GitHub repo、不同步 refs、不切 primary、不開 runtime gate

1.1.1 五題缺口矩陣

順序	Template	目前缺口	合格回覆最小條件	失敗路由
1	response-public-only-vs-local-gitea-gap	wooo/clawbot-v5、wooo/wooo-aiops 是否屬本輪 scope 尚未由 owner 判定	逐 repo 填 owner、decision、reason、affected repos、redacted evidence refs、followup owner	缺 repo 粒度時 request_more_evidence；含 refs / repo 執行要求時 hard_reject
2	response-org-user-endpoint-identity	wooo 應以 user、org 或兩者盤點尚未確認	指定 canonical namespace 或要求管理者補脫敏 evidence	把 org 404 當完成時 request_more_evidence；要求 write/admin token 時 hard_reject
3	response-internal-110-adjacent-scope	110 adjacent sources 是否納入本輪 scope 尚未確認	逐 source 判定 in-scope / out-of-scope / legacy / external / follow-up	一句話排除全部時 request_more_evidence；要求 fetch / push / delete refs 時 hard_reject
4	response-repo-owner-canonical-scope	in-scope repo owner、canonical source、GitHub target 與 visibility review owner 尚未收齊	指定 repo owner、canonical source、GitHub target candidate、visibility review owner 與 evidence refs	缺 owner 或 canonical 時 request_more_evidence；把 target candidate 當 repo creation approval 時 hard_reject
5	response-legacy-or-inaccessible-disposition	legacy、inaccessible、external repo disposition 與後續 owner 尚未收齊	指定 disposition、理由、後續 owner 與脫敏 evidence refs	把 legacy candidate 當刪除 / 封存 approval 時 hard_reject

1.1.2 收件結果分流

Outcome	何時使用	計數影響
keep_waiting_owner_response	只有 request packet、template status 或空回覆	received / accepted 維持 0
request_more_evidence	欄位缺漏、repo/source 粒度不足、evidence refs 不足	不增加 accepted
quarantine_sensitive_payload	疑似含 token、secret、private key、cookie、session、未脫敏截圖或 private URL credential	不保存 raw payload
reject_execution_request	夾帶 repo / refs / workflow / secret / runner / Kali / primary 執行要求	不建立 action button、不進 runtime gate
ready_for_reviewer_validation	五題欄位完整、evidence 已脫敏、無執行要求	只進 reviewer checklist；仍非 accepted

2. Owner Response 必填欄位

每筆 response 至少要能回答：

1. owner_role_or_team：回覆者的角色或團隊，不要求個人敏感資訊。
2. decision：必須是該 S4.7 item 允許的決策值。
3. decision_reason：為什麼做此 scope / disposition 判定。
4. affected_repos、affected_sources 或 canonical_namespace：指出受影響 repo、namespace 或 110 adjacent source。
5. evidence_refs：只能指向 repo 內文件、snapshot 或 owner 提供的脫敏 metadata。
6. followup_owner：若需要補 evidence，需指定下一個負責角色或團隊。

2.0 Owner Response Request Packet

AwoooP 可顯示 owner_response_request_packet 給 owner，要求只回覆 S4.9 五個 templates：

1. response-public-only-vs-local-gitea-gap
2. response-org-user-endpoint-identity
3. response-internal-110-adjacent-scope
4. response-repo-owner-canonical-scope
5. response-legacy-or-inaccessible-disposition

允許填寫的內容只限 owner role/team、decision、decision reason、受影響 repo/source/namespace、canonical source、GitHub target candidate、visibility review owner、脫敏 evidence refs 與 followup owner。

禁止貼 token、secret、private key、cookie、session、DB dump、git object pack、repo archive、write/admin API request、repo/refs 執行要求或 workflow/secret/runner 執行要求。此 request packet 只是收件提示，不是 approval，也不授權 inventory、migration 或 primary。

2.0.1 Owner Response Collection Checklist

AwoooP 顯示 request packet 後，必須用 owner_response_collection_checks 維持 request / received / accepted 三種狀態分離：

順序	檢查	目的
1	collection-request-packet-displayed	只確認 request packet 已顯示，不代表 response 已收到
2	collection-read-only-submission-mode	限定 markdown response、redacted metadata pointer 或 request more evidence
3	collection-five-template-tracking	五個 templates 逐項追蹤，不接受整體口頭同意
4	collection-redacted-evidence-only	只收 repo 內路徑或脫敏 metadata pointer
5	collection-no-approval-language	不把「同意 / OK / 可進行」升級成 inventory、migration 或 primary approval
6	collection-audit-metadata-only	只記錄 audit metadata，不保存敏感值

這 6 個 checks 只幫 AwoooP 維持收件秩序。request 已顯示仍然是 waiting_owner_response；部分 response 到齊也只能進 preflight / outcome lane，不能直接變成 accepted。

2.0.2 Owner Response Template Status Ledger

AwoooP 可用 owner_response_template_statuses 顯示五個 templates 的逐項狀態：

順序	Template	目前狀態	Request 狀態	Received / Accepted / Rejected	下一步
1	response-public-only-vs-local-gitea-gap	waiting_owner_response	request_ready_not_sent	0 / 0 / 0	逐項判定 wooo/clawbot-v5、wooo/wooo-aiops 是否屬本輪 scope
2	response-org-user-endpoint-identity	waiting_owner_response	request_ready_not_sent	0 / 0 / 0	說明 wooo 應以 user、org 或兩者盤點
3	response-internal-110-adjacent-scope	waiting_owner_response	request_ready_not_sent	0 / 0 / 0	逐項判定 110 adjacent sources 是否納入
4	response-repo-owner-canonical-scope	waiting_owner_response	request_ready_not_sent	0 / 0 / 0	指定 owner、canonical source、GitHub target candidate 與 visibility review owner
5	response-legacy-or-inaccessible-disposition	waiting_owner_response	request_ready_not_sent	0 / 0 / 0	留下 legacy / inaccessible / external disposition、理由與後續 owner

這個 ledger 只顯示逐項狀態，不是 approval queue。request_ready_not_sent 只代表 AwoooP 有資料可顯示；在 owner 真的回覆前，received_response_count、accepted_response_count 與 rejected_response_count 都必須維持 0。

2.0.3 Owner Response Audit Event Templates

AwoooP 可用 owner_response_audit_event_templates 做未來 audit metadata 的格式參考：

順序	Event template	觸發點	允許記錄
1	audit-owner-response-request-shown	顯示 request packet 時	request id、template ids、target contract、顯示角色、台北時間與來源文件
2	audit-owner-response-received-metadata	收到 owner response metadata pointer 時	template id、attestation item、owner role/team、台北時間與脫敏 evidence refs
3	audit-owner-response-outcome-classified	完成 collection / preflight / outcome 分類時	template id、collection status、outcome lane、next owner action、分類角色與台北時間

這 3 個 event templates 目前都是 template_only_not_emitted，emitted_event_count=0。它們不代表 AwoooP production ingestion 已啟用，也不保存 owner response raw body、token、secret、private key、cookie、session、DB dump、git object pack、repo archive 或 execution request payload。

2.0.4 Owner Response Redaction Examples

AwoooP 可用 owner_response_redaction_examples 顯示 owner 回覆時應該怎麼引用 evidence，而不是貼 raw payload：

順序	Example	用途
1	redaction-existing-doc-ref	引用 repo 內既有文件或 snapshot，不貼 API raw body
2	redaction-owner-decision-metadata	只填角色、decision、理由與 followup owner，不貼密碼、session 或 token
3	redaction-private-url-metadata	私有 remote 只保留 host、namespace、repo slug 與 credential_present=true/false
4	redaction-api-export-summary	只保留匯出來源類型、count、redaction status 與 evidence ref
5	redaction-quarantine-pointer	不確定是否含敏感值時只留下 quarantine reason 與下一步，不保存原文

這 5 個 examples 全部都是 template_example_only，只供 AwoooP 顯示與 owner 填寫參考。它們不代表 response 已收到、不代表 response accepted、不啟用 production ingestion，也不允許保存 raw payload。

2.0.5 Owner Response Display Sections

AwoooP 顯示 S4.9 時，可依 owner_response_display_sections 固定 8 個只讀區塊：

順序	Section	顯示內容
1	display-owner-response-summary	waiting 狀態、0/0/0 計數與 false flags
2	display-owner-response-request-packet	五個 requested templates、允許欄位與 forbidden payloads
3	display-template-status-ledger	五個 template 的 waiting / request ready / 0 counts
4	display-audit-event-templates	0 emitted 的脫敏 audit metadata templates
5	display-redaction-examples	安全回覆形狀、必要脫敏與 forbidden raw values
6	display-collection-checks	request / received / accepted 分離與收件模式
7	display-preflight-and-outcome-lanes	可審、補證、隔離、拒收或等待的分類
8	display-acceptance-and-rejection-rules	acceptance checks、rejection rules 與 forbidden actions

這 8 個 sections 全部都是 display_contract_only。AwoooP 只能顯示區塊與禁止事項，不得藉由 section 顯示啟用 action button、標記 received / accepted、建立 GitHub repo、寫 Gitea、sync refs 或切 GitHub primary。

2.1 AwoooP 收件前 Preflight

順序	檢查	失敗處理
1	回覆必須對應 S4.7 已知 item	要求 owner 修正
2	必填欄位完整	要求補 evidence
3	decision 在模板允許值內	要求 owner 修正
4	只接受脫敏 evidence refs	進 mirror quarantine
5	不得夾帶執行要求	拒收 execution request
6	接受前需覆蓋五個 items	維持 waiting 或 request more evidence

這 6 個 preflight 只協助 AwoooP 判斷「可收、補證、隔離或拒收」。它們不授權 read-only inventory runtime、不建立 GitHub repo、不修改 Gitea、不 sync refs，也不切 GitHub primary。

2.2 AwoooP Outcome Lanes

Lane	何時顯示	AwoooP 動作
ready_for_owner_review	欄位完整、decision 合法、evidence 已脫敏且沒有執行要求	顯示可進 owner review
request_more_evidence	缺欄位、decision 不合法、scope 不明或 evidence 不完整	顯示補證需求
quarantine_sensitive_payload	含 token、secret、cookie、session、private key、DB dump、git object pack 或未脫敏截圖	只送 mirror quarantine
reject_execution_request	夾帶 repo、refs、workflow、secret、runner、scan 或 runtime 執行要求	拒收執行要求
keep_waiting_owner_response	五個 templates 未全部收到可驗收 response	維持等待 owner response

這些 lanes 只決定 AwoooP 顯示與稽核分類，不代表 accepted，也不會啟動 inventory、migration、refs、workflow、secret、runner 或 GitHub primary。

3. 五個 Response Template

Template	對應 S4.7 item	驗收重點
response-public-only-vs-local-gitea-gap	public_only_vs_local_gitea_gap	逐項判定 wooo/clawbot-v5、wooo/wooo-aiops 是否屬本輪 scope
response-org-user-endpoint-identity	org_user_endpoint_identity	說明 wooo 應以 user、org 或兩者盤點；不得把 404 視為完成
response-internal-110-adjacent-scope	internal_110_adjacent_scope	逐項判定 bitan-pharmacy、root/momo-pro-system、tsenyang-website、wooo/wooo-infra-config
response-repo-owner-canonical-scope	repo_owner_canonical_scope	為 in-scope repo 指定 owner、canonical source、GitHub target candidate 與 visibility review owner
response-legacy-or-inaccessible-disposition	legacy_or_inaccessible_repo_disposition	對 legacy / inaccessible / external repo 留下 disposition、理由與後續 owner

4. 驗收規則

1. response 必須對應 S4.7 的 5 個 item 之一。
2. decision 必須在該 item 的允許值內。
3. 必須有 owner 理由，不能只有「同意」或「排除」。
4. evidence_refs 必須已脫敏，不得包含 token、secret、cookie、session、private key 或私有 URL 憑證。
5. 必須列出受影響 repo、namespace 或 source。
6. 不得夾帶 runtime 或 source-control 執行要求。
7. 要把 S4.7 標示為 accepted 前，5 個 items 都必須有可驗收 response。
8. response 通過後，GitHub primary readiness 仍維持 blocked，primary_ready_count 不得因此大於 0。

5. 必須拒收

1. token value、PAT、cookie、session、CSRF token 或 partial token。
2. webhook secret、repository secret value、runner registration token 或 deploy key private key。
3. private key、DB dump、git object pack、裸 repo tarball 或可還原 credential 的 artifact。
4. 要求使用 write-capable token、admin token 或 secret scope token。
5. 要求建立、刪除、封存或修改 Gitea repo。
6. 要求建立 GitHub repo、修改 visibility、sync refs、delete refs 或 force push。
7. 未逐項對應 S4.7 attestation item。
8. 只提供口頭同意、截圖或不完整 repo metadata。
9. 把 owner attestation 當成 repo migration approval 或 GitHub primary approval。
10. 任何不確定是否含敏感值的回覆。

6. AwoooP 可做

1. 顯示 5 個 owner response templates。
2. 顯示 owner response request packet、template status ledger、audit event templates、redaction examples、display sections、6 個 collection checks、6 個 intake preflight checks、5 個 outcome lanes、acceptance checks 與 rejection rules。
3. 在 owner response 到來後，只更新 read-only snapshot、matrix、decision table、readiness gate 與 status rollup。
4. 將不完整或可疑 response 放進 mirror quarantine。
5. 持續顯示 received_response_count=0、accepted_response_count=0，直到真的收到脫敏 response。

7. AwoooP 不可做

1. 不要求使用者貼 token、secret、private key、cookie、session 或 DB dump。
2. 不把 response 當成 read-only inventory 已執行。
3. 不把 response 當成 repo migration approval。
4. 不建立 GitHub repo。
5. 不修改 Gitea repo。
6. 不 sync refs。
7. 不新增執行按鈕。

8. 階段定位

S4.9 是 S4.7 / S4.8 後面的安全收件包。

它讓 owner response 變得可審、可驗收、可拒收，但仍然停在框架期。真正讓 gitea_repo_inventory_v1.status=ok，仍必須等 S4.6 脫敏 payload 通過、S4.7 五個 owner response 全部接受、refs truth / workflow-secret parity / rollback ADR / runtime gate 都補齊後，才能進下一階段。