wooo/awoooi
1
1
Fork 0
Code Issues 2 Pull Requests 1 Actions 2 Packages Projects Releases Wiki Activity

docs(ops): record codex workstation gitea dev readback [skip ci]

Browse Source
This commit is contained in:
Your Name
2026-06-24 11:43:28 +08:00
parent dff3658947
commit 7026fc2f64
2 changed files with 110 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/LOGBOOK.md
View File

@@ -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 變更或服務回歸。

90
docs/operations/CODEX-WORKSTATION-GITEA-DEV-READBACK.md Normal file
View File

@@ -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.