awoooi/docs/operations/VTUBER-DEV-BASELINE-OWNER-DECISION-2026-06-24.md

VTuber Dev Baseline Owner Decision

• generated_at: 2026-06-24T14:08:41+08:00
• product_id: vtuber
• local_path: /Users/ogt/VTuber
• status: blocked, repository identity repair required

Readback

Gate	Result
local branch	main
local HEAD	invalid / no commit HEAD
local HEAD error	fatal: ambiguous argument 'HEAD'
Gitea repo	wooo/vtuber not found
tracked modified	0
tracked deleted	0
staged additions	2
untracked files	84
untracked porcelain entries	30

Staged additions already present in local repo:

• apps/admin/public/.gitkeep
• apps/web/public/.gitkeep

Untracked 分桶

Bucket	Count	判定
apps/web	33	source / asset candidates
apps/admin	15	source candidates
apps/api	13	source candidates
packages/db	5	DB schema / seed candidates
packages/ui	2	UI package candidates
deploy	4 plus env-like files	deploy / Nginx / compose candidates, env quarantine required
scripts	3	ops candidates
docs	2	product docs candidates
root	7	repo bootstrap candidates

Env-like paths observed but not read:

• .env.example
• apps/admin/.env.example
• apps/api/.env.example
• apps/web/.env.example
• deploy/.env.prod
• deploy/.env.prod.example

Quarantined by default:

• apps/web/tsconfig.tsbuildinfo
• deploy/.env.prod

判定

VTuber 不能進入 Gitea dev branch 流程。這不是一般 dirty worktree；它目前沒有有效 HEAD，遠端 wooo/vtuber 也不存在。這表示要先做 repo identity 決策：

1. 這是新產品 repo bootstrap。
2. 或者本地資料夾應該對應到另一個既有 Gitea repo。
3. 或者需要先修 local git history / initial commit。

在決策前，不可把 84 個 untracked files 直接推成產品基準。

Owner Decision

需要 owner 回覆：

1. VTuber 是否要建立全新 Gitea repo，或對應另一個既有 repo。
2. 兩個已 staged .gitkeep 要保留 staged、提交到初始 baseline，還是重置後重新 bootstrap。
3. deploy/.env.prod 一律不可讀、不可複製、不可進 source control。
4. env example 檔只能 metadata-only review，確認不含真實 secret 後才可納入。
5. VRM / GLB model assets 是否屬於 source artifact。
6. Nginx / compose / deploy scripts 是否屬於初始 baseline。
7. owner 接受 repo identity 與 source include list 後，才可建立 Gitea repo / branch / MacBook workspace。

安全邊界

• 未讀 env 檔內容。
• 未讀 secret value。
• 未修改 VTuber repo。
• 未建立 branch、commit、repo 或 push。
• 未同步 raw .git、runtime volume 或 raw Codex conversations。
• 未執行 deploy、Nginx、Docker、production smoke 或 runtime write。