diff --git a/docs/LOGBOOK.md b/docs/LOGBOOK.md index 2cfa40b28..af230f9ff 100644 --- a/docs/LOGBOOK.md +++ b/docs/LOGBOOK.md @@ -1,3 +1,23 @@ +## 2026-06-24|Codex 雙工作站 / Gitea dev 環境只讀盤點 + +**背景**:完成重啟恢復 readback 後,接續使用者排定的第 2 / 3 步:把 Mac Mini / MacBook Pro 的開發工作收攏到 Gitea dev workspace,讓外出時可用 MacBook Pro 開 Codex 繼續開發。這一段只做只讀盤點與文件化,不建立 remote branch、不推產品 repo、不複製 raw `.git`、不同步 raw Codex / ChatGPT conversations。 + +**Readback**: +- `~/.codex/CODEX-START-HERE.md`:overall `38.6%`,`can_start_awoooi_controlled_dev=True`,`can_start_all_products_dev=False`,`raw_history_sync=False`。 +- Workstation dashboard:products `11`,registry ready `1`,registry blocked `10`,latest dev on Gitea `1`,production on Gitea `4`,workstation ready projects `2`,blocked projects `13`。 +- AWOOOI controlled dev workspace 已 ready:Mac Mini / MacBook Pro 都有 `awoooi-dev`,branch `dev`,dirty `0`。 +- Gitea refs readback:`2026FIFAWorldCup`、`agent-bounty-protocol`、`ewoooc`、`AwoooGo`、`stockplatform-v2` 目前都只有 `main`,沒有 `dev`。 +- Mac Mini local repo 快照:MOMO Pro 與 AwoooGo tree clean;ClawBot dirty `2`;Agent Bounty dirty `40`;VibeWork dirty `180`;StockPlatform v2 dirty `117`;Tsenyang dirty `7`;Bitan dirty `279`;2026FIFA full status 太重,需 narrow drift;VTuber `HEAD` readback abnormal。 + +**新增文件**: +- `docs/operations/CODEX-WORKSTATION-GITEA-DEV-READBACK.md` 記錄目前雙工作站 / Gitea dev readiness、產品矩陣、硬 gates 與下一步。 + +**判定**: +- 不能宣稱全產品都可直接雙機同步開發;目前只有 AWOOOI controlled dev ready。 +- MOMO Pro / AwoooGo 是下一批較安全候選,因本機 tree clean;但仍需 owner/preflight 決定 `dev` branch 策略。 +- dirty 專案不可直接 push;必須先做 drift review / owner pick list。 +- raw Codex 工作視窗不會也不應同步;可同步的是 Start Here、LOGBOOK、runbook、handoff snapshot 與 Gitea source。 + ## 2026-06-24|11:35 post-commit recovery readback **背景**:`7db7800e docs(ops): record momo source freshness blocker [skip ci]` 推上 `gitea/main` 後,重新做一次只讀 readback,確認文件 baseline 已被 ArgoCD 讀到,且沒有造成 runtime 變更或服務回歸。 diff --git a/docs/operations/CODEX-WORKSTATION-GITEA-DEV-READBACK.md b/docs/operations/CODEX-WORKSTATION-GITEA-DEV-READBACK.md new file mode 100644 index 000000000..afe5c9d5d --- /dev/null +++ b/docs/operations/CODEX-WORKSTATION-GITEA-DEV-READBACK.md @@ -0,0 +1,90 @@ +# Codex 雙工作站 / Gitea 開發環境 Readback + +> Last updated: 2026-06-24 11:45 Asia/Taipei +> Scope: Mac Mini、MacBook Pro、Gitea dev workspace、全產品專案收攏。 + +--- + +## 1. 目前判定 + +```text +Overall workstation / Gitea dev readiness: 38.6%, orange. +AWOOOI controlled dev: ready. +All-products Codex dev: not ready. +Raw Codex / ChatGPT conversation sync: forbidden. +Safe shared context: Gitea, docs, LOGBOOK, handoff snapshots, Start Here, runbooks. +Forbidden sync targets: auth.json, *.sqlite, sessions, raw conversations, .env, runtime volumes, raw .git directories. +``` + +目前不能把「所有專案直接推到 Gitea」當成一個單步操作。原因是多數專案本機工作樹不是乾淨狀態、部分 Gitea refs 讀不到或沒有 `dev` branch、部分是 internal repo,需要 owner export / authenticated inventory。直接推送會把半成品、未審核刪檔、local-only runtime artifact 或不該公開的檔案混進 source control。 + +## 2. Start Here / Dashboard Readback + +| Source | Readback | +|--------|----------| +| `~/.codex/CODEX-START-HERE.md` | generated_at `2026-06-24T03:36:26+00:00`; overall `38.6%`; `can_start_awoooi_controlled_dev=True`; `can_start_all_products_dev=False`; `raw_history_sync=False` | +| `~/.codex/codex-workstation-sync-dashboard.snapshot.json` | products `11`; registry ready `1`; registry blocked `10`; latest dev on Gitea `1`; production on Gitea `4`; workstation ready projects `2`; workstation blocked projects `13` | +| `~/.codex/product-runtime-governance-completion-scorecard.snapshot.json` | overall `38.6%`; topic dual-mac Codex `84%`; Gitea / GitHub / CI-CD `35%`; portability cloud VM `15%` | + +## 3. Gitea Product Registry Snapshot + +| Product | Gitea repo | Registry | Main | Dev | Current blocker | +|---------|------------|----------|------|-----|-----------------| +| AWOOOI | `wooo/awoooi` | ready | yes | yes | none | +| 2026FIFA | `wooo/2026FIFAWorldCup` | blocked | yes | no | owner preflight / dev branch missing; local status is heavy and requires narrow drift review | +| Agent Bounty | `wooo/agent-bounty-protocol` | blocked | yes | no | dirty tree and owner preflight required | +| MOMO Pro | `wooo/ewoooc` | blocked | yes | no | local tree clean, but dev branch creation still needs owner / preflight gate | +| AwoooGo | `wooo/AwoooGo` | blocked | yes | no | local tree clean, but registry still says refs / production baseline need formal closure | +| StockPlatform v2 | `wooo/stockplatform-v2` | blocked | yes | no | dirty tree, no dev branch | +| VibeWork | `wooo/vibework` | blocked | unknown from public registry | no | dirty tree, refs inventory gap | +| ClawBot / OpenClaw | `wooo/clawbot-v5` | blocked | unknown from public registry | no | dirty tree and refs inventory gap | +| Bitan | `internal:bitan-pharmacy` | blocked | no | no | internal repo requires owner export / authenticated inventory; dirty tree | +| Tsenyang Website | `internal:tsenyang-website` | blocked | no | no | internal repo requires owner export / authenticated inventory; dirty tree | +| VTuber | `wooo/vtuber` | blocked | no | no | local HEAD / revision readback abnormal; must repair inventory before any push | + +## 4. Mac Mini Local Repo Readback + +| Local path | Branch | Commit | Dirty count | Remote readback | Safe next action | +|------------|--------|--------|------------:|-----------------|------------------| +| `/Users/ogt/codex-workspaces/awoooi-dev` | `dev` | `25889d4` in Start Here | `0` in Start Here | external HTTPS Gitea | controlled AWOOOI dev work can start from `dev` | +| `/Users/ogt/awoooi` | active ops worktree | not used for dev baseline | dirty by design | Gitea main active | do not use for cross-device dev bootstrap | +| `/Users/ogt/momo-pro-system` | `main` | `76a89a7` | `0` | `https://gitea.wooo.work/wooo/ewoooc.git` | candidate for owner-reviewed `dev` branch bootstrap | +| `/Users/ogt/Documents/AwoooGo` | `main` | `86c96a2` | `0` | `http://192.168.0.110:3001/wooo/AwoooGo.git` | candidate after registry / remote URL normalization | +| `/Users/ogt/clawbot-v5` | `main` | `f4b84d7` | `2` | Gitea + GitHub | needs dirty review before dev bootstrap | +| `/Users/ogt/Documents/agent-bounty-protocol` | `main` | `0601df8` | `40` | Gitea | needs dirty review / owner pick | +| `/Users/ogt/Documents/VibeWork` | `main` | `48275cc` | `180` | Gitea SSH | needs dirty review / owner pick | +| `/Users/ogt/stockplatform-v2` | `main` | `1ef097e` | `117` | Gitea | needs dirty review / owner pick | +| `/Users/ogt/tsenyang-website` | `main` | `b369ed8` | `7` | SSH internal repo | needs internal repo export / dirty review | +| `/Users/ogt/bitan-pharmacy` | `main` | `e122c8c` | `279` | SSH internal repo | needs internal repo export / dirty review | +| `/Users/ogt/Documents/2026FIFAWorldCup` | `main` | `118954e` | status heavy | Gitea + GitHub | requires narrow drift tool; do not run broad status in routine gate | +| `/Users/ogt/VTuber` | abnormal | no valid `HEAD` | `32` observed before HEAD failure | not reasserted | repair repository state / inventory only | + +## 5. Priority Order + +| Priority | Goal | Current completion | Gate | +|----------|------|-------------------:|------| +| P0 | Keep AWOOOI controlled dev usable on both Macs | 84% topic-level, AWOOOI ready | verify MacBook Pro artifact sync when reachable | +| P0 | Create safe all-product Gitea dev baseline | 38.6% overall | product-by-product owner/preflight, no raw `.git` sync | +| P1 | MOMO Pro dev baseline | candidate | tree clean; needs explicit owner-approved `dev` branch policy | +| P1 | AwoooGo dev baseline | candidate | tree clean; normalize repo naming / external URL / registry | +| P1 | Dirty product drift review | blocked | VibeWork, StockPlatform, Bitan, Agent Bounty, Tsenyang, ClawBot need local change triage | +| P2 | External MacBook Pro Codex operation | partial | use Gitea + docs + Start Here; never raw conversation/session sync | +| P3 | Raw work-window sync | forbidden | replace with summaries, handoff docs, LOGBOOK, snapshots | + +## 6. Hard Gates + +- Do not copy `~/.codex/auth.json`, SQLite DB, sessions, raw Codex / ChatGPT conversations, `.env`, runtime volumes, or raw `.git` directories. +- Do not create remote `dev` branches for products whose owner preflight is blocked. +- Do not push dirty worktrees as "latest" without a drift review and owner-selected include/exclude list. +- Do not treat MacBook Pro being reachable as proof that all project state is synchronized. +- Do not treat Gitea `main` existing as proof that production runtime is latest. +- Use Gitea as source of truth for code; use backup / DB / route / runtime readback as source of truth for service state. + +## 7. Next Safe Actions + +1. Refresh MacBook Pro reachability and artifact sync readback without copying raw sessions. +2. For MOMO Pro and AwoooGo, prepare owner-reviewed `dev` branch bootstrap because both Mac Mini local trees are currently clean. +3. For VibeWork / StockPlatform / Agent Bounty / Bitan / Tsenyang / ClawBot, run narrow dirty-tree summaries and prepare owner pick lists. +4. For 2026FIFA, build a narrow drift command that avoids full untracked scan. +5. For VTuber, repair local repository HEAD / inventory before any Gitea action. +6. Update Start Here / dashboard snapshots only after readback, not by assumption.