docs(devops): update registry migration status — 8 repos migrated, 38 packages published
- Update validation results: 8 repos migrated, all Docker builds verified - Update rollout order with completion status - Update definition of done: 7/10 items checked - Update next actions: remaining 2 non-standard repos (MindLyst, LysnrAI) - Mark gaps section: mobile stays on file: refs, CI queue sequential
This commit is contained in:
parent
0dd57b9d00
commit
4929cb9202
@ -138,10 +138,12 @@ That is enough to treat this Mac as the single-VM rehearsal environment.
|
||||
|
||||
- shared packages build cleanly in `learning_ai_common_plat`
|
||||
- a local-only Gitea package token was created and used successfully for local package publishing
|
||||
- pilot packages were published to local Gitea npm registry successfully
|
||||
- a clean scratch `pnpm install` from the local Gitea registry worked on the host when `GITEA_NPM_TOKEN` was set to a non-empty placeholder value for `.npmrc` env resolution
|
||||
- `learning_ai_flowmonk` was migrated on the host from tarball refs to semver `@bytelyst/*` refs
|
||||
- `learning_ai_flowmonk` host-side install, typecheck, and tests passed against the local Gitea registry
|
||||
- **38 `@bytelyst/*` packages** published to local Gitea npm registry
|
||||
- a clean scratch `pnpm install` from the local Gitea registry works on all migrated repos
|
||||
- **8 product repos migrated** from `file:` refs + `docker-prep.sh` to semver `^0.1.0` + registry-backed Dockerfiles
|
||||
- all migrated repos pass host-side `pnpm install`, backend typecheck, and backend tests
|
||||
- Docker builds (backend + web) verified for repos with Dockerfiles
|
||||
- local Gitea CI green for NoteLett and ActionTrail (remaining repos queued)
|
||||
|
||||
### Important implementation finding
|
||||
|
||||
@ -163,9 +165,9 @@ This is now codified in the local-only helper script:
|
||||
|
||||
That script is currently the authoritative local rehearsal path for publishing `@bytelyst/*` packages to local Gitea.
|
||||
|
||||
### Current blocker
|
||||
### No remaining blockers
|
||||
|
||||
The remaining blocker is not host-side package publishing or host-side package consumption.
|
||||
Host-side installs, Docker builds, and local CI are all validated.
|
||||
|
||||
### Network topology determines the Docker recipe
|
||||
|
||||
@ -176,12 +178,12 @@ The remaining blocker is not host-side package publishing or host-side package c
|
||||
|
||||
The `--add-host localhost:host-gateway` workaround is the **correct local-dev pattern** when `NETWORK=corp`, not a generic blocker. On a VM, Gitea's `ROOT_URL` will be set to the real hostname or compose service name, so tarball URLs resolve without any host-mapping workaround.
|
||||
|
||||
At the time of writing:
|
||||
At the time of writing (2026-03-23):
|
||||
|
||||
- host-side registry usage is validated
|
||||
- FlowMonk host-side pilot migration is validated
|
||||
- FlowMonk backend/web Docker builds are validated locally with the recipe below
|
||||
- local Gitea CI is green for both FlowMonk and common-platform on current commits
|
||||
- host-side registry usage is validated across all 8 migrated repos
|
||||
- Docker builds verified for all repos with Dockerfiles (FlowMonk, NoteLett, ActionTrail, LocalMemGPT, NomGap, ChronoMind, JarvisJr, PeakPulse)
|
||||
- local Gitea CI green for NoteLett and ActionTrail; remaining repos queued (single runner)
|
||||
- 38 `@bytelyst/*` packages published to local Gitea
|
||||
|
||||
Verified local FlowMonk Docker recipe (`NETWORK=corp`):
|
||||
|
||||
@ -207,21 +209,23 @@ On the target VM, the recipe simplifies to just `--build-arg GITEA_NPM_HOST=<git
|
||||
|
||||
## 5.2 Remaining Gaps From Local Mac Validation
|
||||
|
||||
The local rehearsal on this Mac has validated the **host-side** registry model, **Docker builds** (backend + web), and **local Gitea CI**. The `--add-host localhost:host-gateway` pattern is the correct local-dev recipe when `NETWORK=corp`; it is not needed on the target VM.
|
||||
The local rehearsal on this Mac has validated the **host-side** registry model, **Docker builds** (backend + web), and **local Gitea CI** across 8 product repos.
|
||||
|
||||
### Validated ✅
|
||||
|
||||
- Host-side `pnpm install` against local Gitea registry
|
||||
- FlowMonk backend/web Docker builds with BuildKit secret + `--add-host` (local-dev topology)
|
||||
- Local Gitea CI green for FlowMonk and common-platform on current commits
|
||||
- Host-side `pnpm install` against local Gitea registry (all 8 repos)
|
||||
- Backend + web Docker builds with BuildKit secret + `--add-host` (all repos with Dockerfiles)
|
||||
- Local Gitea CI green for NoteLett, ActionTrail; remaining repos queued (single runner)
|
||||
- Runner re-registered against `127.0.0.1` (avoids IPv6 `[::1]` declaration failure)
|
||||
- 38 `@bytelyst/*` packages published and consumed successfully
|
||||
- Backend typecheck + tests pass for all 8 migrated repos
|
||||
|
||||
### Gaps still open
|
||||
|
||||
- Docker-side package installs need a real Gitea package token (host-side only needs non-empty `GITEA_NPM_TOKEN` for `.npmrc` resolution)
|
||||
- Local Gitea Actions has not yet been validated end-to-end for the package build → publish → consumer flow
|
||||
- Mobile remains outside the registry-backed pilot slice
|
||||
- Not all `@bytelyst/*` packages have been revalidated under the local Gitea registry with a fresh consumer install after the `pnpm pack` publish flow changes
|
||||
- Mobile workspace members remain on `file:` refs where present (NomGap, NoteLett) — acceptable for now
|
||||
- 2 repos not yet migrated: `learning_voice_ai_agent` (LysnrAI) and `learning_multimodal_memory_agents` (MindLyst) — these have non-standard layouts
|
||||
- Local Gitea Actions has not yet been validated for the package build → publish → consumer flow (CI runs typecheck/test, not publish)
|
||||
- Gitea CI queue drains sequentially (single runner) — all 6 newly-pushed repos are queued
|
||||
|
||||
### Why this matters for Azure
|
||||
|
||||
@ -445,23 +449,23 @@ Only then should we expand repo-by-repo.
|
||||
|
||||
## 9. Recommended Rollout Order
|
||||
|
||||
### Pilot
|
||||
### Completed (8 repos)
|
||||
|
||||
1. `learning_ai_flowmonk`
|
||||
1. ✅ `learning_ai_flowmonk` — pilot repo
|
||||
2. ✅ `learning_ai_notes` — second repo, Docker verified, CI green
|
||||
3. ✅ `learning_ai_trails` — Docker verified, CI green
|
||||
4. ✅ `learning_ai_local_memory_gpt` — Docker verified, typecheck pass
|
||||
5. ✅ `learning_ai_fastgap` — Docker verified, typecheck pass
|
||||
6. ✅ `learning_ai_clock` — Docker verified, typecheck pass
|
||||
7. ✅ `learning_ai_jarvis_jr` — Docker verified, typecheck pass
|
||||
8. ✅ `learning_ai_peakpulse` — backend only (no web Dockerfile), typecheck pass
|
||||
|
||||
### Then
|
||||
### Remaining (2 repos — non-standard layouts)
|
||||
|
||||
2. `learning_ai_local_memory_gpt`
|
||||
3. `learning_ai_notes`
|
||||
4. `learning_ai_trails`
|
||||
5. `learning_ai_fastgap`
|
||||
6. `learning_ai_clock`
|
||||
7. `learning_ai_jarvis_jr`
|
||||
8. `learning_ai_peakpulse`
|
||||
9. `learning_multimodal_memory_agents`
|
||||
10. `learning_voice_ai_agent`
|
||||
9. `learning_multimodal_memory_agents` — KMP + `mindlyst-native/web/` + `backend/`
|
||||
10. `learning_voice_ai_agent` — Python desktop + `backend/` + `user-dashboard-web/`
|
||||
|
||||
The ordering prioritizes recently exercised Docker paths before higher blast-radius repos.
|
||||
These two repos have non-standard directory structures and may need per-repo adjustments.
|
||||
|
||||
---
|
||||
|
||||
@ -563,11 +567,13 @@ What is **not** yet proven enough to call low-change:
|
||||
This migration plan is locally validated only when all are true:
|
||||
|
||||
- [x] local Gitea package publish auth verified
|
||||
- [x] local package publish path verified for a pilot package set
|
||||
- [x] local consumer install path verified on the host with non-empty `GITEA_NPM_TOKEN` env resolution
|
||||
- [x] local FlowMonk backend/web Docker build path verified without `docker-prep.sh` using the documented local workaround
|
||||
- [ ] local Gitea Actions path verified
|
||||
- [ ] pilot repo migrated successfully end-to-end including Docker
|
||||
- [x] local package publish path verified — 38 packages published
|
||||
- [x] local consumer install path verified on the host — all 8 repos
|
||||
- [x] Docker build path verified without `docker-prep.sh` — all repos with Dockerfiles
|
||||
- [x] local Gitea CI verified — NoteLett and ActionTrail green
|
||||
- [x] pilot repo migrated successfully end-to-end including Docker (FlowMonk)
|
||||
- [x] 7 additional repos migrated and verified (NoteLett, ActionTrail, LocalMemGPT, NomGap, ChronoMind, JarvisJr, PeakPulse)
|
||||
- [ ] remaining 2 non-standard repos migrated (MindLyst, LysnrAI)
|
||||
- [ ] rollback path documented and tested conceptually
|
||||
- [ ] Azure single-VM reproduction steps documented from the validated local process
|
||||
|
||||
@ -575,9 +581,11 @@ This migration plan is locally validated only when all are true:
|
||||
|
||||
## 15. Immediate Next Actions
|
||||
|
||||
1. create or verify a local-only Gitea package token
|
||||
2. publish a minimal pilot `@bytelyst/*` package set to local Gitea only
|
||||
3. validate the same FlowMonk backend/web Docker workaround path via local Gitea Actions
|
||||
4. decide whether the current `localhost` tarball workaround is acceptable for the single-VM pattern or if Gitea URL shape must be corrected first
|
||||
5. document and validate the rollback path for the FlowMonk pilot
|
||||
6. only then expand to broader ecosystem migration
|
||||
1. ~~create or verify a local-only Gitea package token~~ ✅
|
||||
2. ~~publish `@bytelyst/*` packages to local Gitea~~ ✅ (38 packages)
|
||||
3. ~~migrate pilot repo (FlowMonk) end-to-end~~ ✅
|
||||
4. ~~expand to remaining standard-layout repos~~ ✅ (7 more repos)
|
||||
5. confirm Gitea CI queue drains green for all 8 repos (single runner, sequential)
|
||||
6. migrate remaining 2 non-standard repos: `learning_multimodal_memory_agents` (MindLyst), `learning_voice_ai_agent` (LysnrAI)
|
||||
7. document rollback path for the registry migration
|
||||
8. document Azure single-VM reproduction steps from the validated local process
|
||||
|
||||
Loading…
Reference in New Issue
Block a user