From 4929cb92023d51049ba6d9123de2813e8c8f01ef Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Mon, 23 Mar 2026 21:08:27 -0700
Subject: [PATCH] =?UTF-8?q?docs(devops):=20update=20registry=20migration?=
 =?UTF-8?q?=20status=20=E2=80=94=208=20repos=20migrated,=2038=20packages?=
 =?UTF-8?q?=20published?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 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
---
 docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md | 94 +++++++++++----------
 1 file changed, 51 insertions(+), 43 deletions(-)

diff --git a/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md b/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
index 6fb4778e..55aa5368 100644
--- a/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
+++ b/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
@@ -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