From 54a06e227a859f1bf2037c52ef46d54cdb744c31 Mon Sep 17 00:00:00 2001
From: saravanakumardb1 <saravanakumardb1@users.noreply.github.com>
Date: Mon, 13 Apr 2026 00:02:55 -0700
Subject: [PATCH] refactor(scripts): move 5 Gitea scripts into scripts/gitea/
 subdirectory
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Moved:
  publish-local-gitea-packages.sh  → gitea/publish-local-packages.sh
  publish-outdated-gitea-packages.sh → gitea/publish-outdated-packages.sh
  release-gitea-packages.sh        → gitea/release-packages.sh
  run-registry-tests.sh            → gitea/run-registry-tests.sh
  harden-publish-config.sh         → gitea/harden-publish-config.sh

Dropped -gitea- infix (redundant with folder name).

Fixed in every moved script:
- REPO_ROOT: ../ → ../../ (one level deeper)
- Internal cross-reference comments

Updated all 10 referencing files:
- package.json (release script path)
- .gitea/workflows/ci.yml (publish step)
- 3 workflow .md files (publish-outdated usage)
- 3 devops docs (publish-local + registry-tests refs)
- 2 internal comment cross-references
---
 .gitea/workflows/ci.yml                       |  2 +-
 ...utdated-pnpm-packages-to-gitea-registry.md | 12 ++---
 ...ish-outdated-packages-to-gitea-registry.md | 12 ++---
 ...utdated-pnpm-packages-to-gitea-registry.md | 12 ++---
 docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md   |  8 +--
 docs/devops/SINGLE_VM_DEPLOYMENT.md           | 50 +++++++++----------
 docs/devops/single_azure_vm/docker/README.md  |  2 +-
 package.json                                  |  2 +-
 scripts/{ => gitea}/harden-publish-config.sh  |  2 +-
 .../publish-local-packages.sh}                |  2 +-
 .../publish-outdated-packages.sh}             | 10 ++--
 .../release-packages.sh}                      | 16 +++---
 scripts/{ => gitea}/run-registry-tests.sh     |  0
 13 files changed, 65 insertions(+), 65 deletions(-)
 rename scripts/{ => gitea}/harden-publish-config.sh (98%)
 rename scripts/{publish-local-gitea-packages.sh => gitea/publish-local-packages.sh} (98%)
 rename scripts/{publish-outdated-gitea-packages.sh => gitea/publish-outdated-packages.sh} (98%)
 rename scripts/{release-gitea-packages.sh => gitea/release-packages.sh} (96%)
 rename scripts/{ => gitea}/run-registry-tests.sh (100%)

diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index fc65238f..2cd3392b 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -72,4 +72,4 @@ jobs:
         run: pnpm -r --filter './packages/**' build
 
       - name: Publish to local Gitea registry
-        run: bash ./scripts/publish-local-gitea-packages.sh
+        run: bash ./scripts/gitea/publish-local-packages.sh
diff --git a/.windsurf/workflows/publish-outdated-pnpm-packages-to-gitea-registry.md b/.windsurf/workflows/publish-outdated-pnpm-packages-to-gitea-registry.md
index 003646fc..dffc5686 100644
--- a/.windsurf/workflows/publish-outdated-pnpm-packages-to-gitea-registry.md
+++ b/.windsurf/workflows/publish-outdated-pnpm-packages-to-gitea-registry.md
@@ -47,7 +47,7 @@ Run the script in `--dry-run` mode first to see which packages need publishing w
 // turbo
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --dry-run
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --dry-run
 ```
 
 Review the output:
@@ -62,7 +62,7 @@ Review the output:
 If the dry-run shows outdated packages, run the script without `--dry-run` to publish them.
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh
 ```
 
 The script will:
@@ -84,7 +84,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && git add packages/*/package
 ### 5. (Optional) Publish a single package
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --filter @bytelyst/errors
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --filter @bytelyst/errors
 ```
 
 ### 6. (Optional) Skip the build step
@@ -92,7 +92,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outda
 If you already ran `pnpm build`:
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --skip-build
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --skip-build
 ```
 
 ---
@@ -134,6 +134,6 @@ On both networks, the script:
 
 ## Script location
 
-`scripts/publish-outdated-gitea-packages.sh` in `learning_ai_common_plat`
+`scripts/gitea/publish-outdated-packages.sh` in `learning_ai_common_plat`
 
-Run `bash scripts/publish-outdated-gitea-packages.sh --help` for usage.
+Run `bash scripts/gitea/publish-outdated-packages.sh --help` for usage.
diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-packages-to-gitea-registry.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-packages-to-gitea-registry.md
index 480ff9a0..67141e2d 100644
--- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-packages-to-gitea-registry.md
+++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-packages-to-gitea-registry.md
@@ -47,7 +47,7 @@ Run the script in `--dry-run` mode first to see which packages need publishing w
 // turbo
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --dry-run
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --dry-run
 ```
 
 Review the output:
@@ -62,7 +62,7 @@ Review the output:
 If the dry-run shows outdated packages, run the script without `--dry-run` to publish them.
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh
 ```
 
 The script will:
@@ -84,7 +84,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && git add packages/*/package
 ### 5. (Optional) Publish a single package
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --filter @bytelyst/errors
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --filter @bytelyst/errors
 ```
 
 ### 6. (Optional) Skip the build step
@@ -92,7 +92,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outda
 If you already ran `pnpm build`:
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --skip-build
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --skip-build
 ```
 
 ---
@@ -134,6 +134,6 @@ On both networks, the script:
 
 ## Script location
 
-`scripts/publish-outdated-gitea-packages.sh` in `learning_ai_common_plat`
+`scripts/gitea/publish-outdated-packages.sh` in `learning_ai_common_plat`
 
-Run `bash scripts/publish-outdated-gitea-packages.sh --help` for usage.
+Run `bash scripts/gitea/publish-outdated-packages.sh --help` for usage.
diff --git a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-pnpm-packages-to-gitea-registry.md b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-pnpm-packages-to-gitea-registry.md
index 003646fc..dffc5686 100644
--- a/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-pnpm-packages-to-gitea-registry.md
+++ b/__LOCAL_LLMs/AI_IDE_CHAT_HISTORY/WINDSURF/repo_workflows/learning_ai_common_plat/publish-outdated-pnpm-packages-to-gitea-registry.md
@@ -47,7 +47,7 @@ Run the script in `--dry-run` mode first to see which packages need publishing w
 // turbo
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --dry-run
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --dry-run
 ```
 
 Review the output:
@@ -62,7 +62,7 @@ Review the output:
 If the dry-run shows outdated packages, run the script without `--dry-run` to publish them.
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh
 ```
 
 The script will:
@@ -84,7 +84,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && git add packages/*/package
 ### 5. (Optional) Publish a single package
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --filter @bytelyst/errors
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --filter @bytelyst/errors
 ```
 
 ### 6. (Optional) Skip the build step
@@ -92,7 +92,7 @@ cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outda
 If you already ran `pnpm build`:
 
 ```bash
-cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/publish-outdated-gitea-packages.sh --skip-build
+cd /Users/sd9235/code/mygh/learning_ai_common_plat && bash scripts/gitea/publish-outdated-packages.sh --skip-build
 ```
 
 ---
@@ -134,6 +134,6 @@ On both networks, the script:
 
 ## Script location
 
-`scripts/publish-outdated-gitea-packages.sh` in `learning_ai_common_plat`
+`scripts/gitea/publish-outdated-packages.sh` in `learning_ai_common_plat`
 
-Run `bash scripts/publish-outdated-gitea-packages.sh --help` for usage.
+Run `bash scripts/gitea/publish-outdated-packages.sh --help` for usage.
diff --git a/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md b/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
index 5809dc36..9428d5ad 100644
--- a/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
+++ b/docs/devops/GITEA_NPM_REGISTRY_MIGRATION.md
@@ -158,7 +158,7 @@ What worked:
 
 This is now codified in the local-only helper script:
 
-`scripts/publish-local-gitea-packages.sh`
+`scripts/gitea/publish-local-packages.sh`
 
 That script is currently the authoritative local rehearsal path for publishing `@bytelyst/*` packages to local Gitea.
 
@@ -335,14 +335,14 @@ Use the local-only helper script for this rehearsal:
 
 ```bash
 cd /Users/sd9235/code/mygh/learning_ai_common_plat
-GITEA_NPM_TOKEN='<local-token>' bash ./scripts/publish-local-gitea-packages.sh
+GITEA_NPM_TOKEN='<local-token>' bash ./scripts/gitea/publish-local-packages.sh
 ```
 
 For a single package:
 
 ```bash
 cd /Users/sd9235/code/mygh/learning_ai_common_plat
-GITEA_NPM_TOKEN='<local-token>' bash ./scripts/publish-local-gitea-packages.sh '@bytelyst/errors'
+GITEA_NPM_TOKEN='<local-token>' bash ./scripts/gitea/publish-local-packages.sh '@bytelyst/errors'
 ```
 
 ### 7.4 Start with a minimal package pilot set
@@ -526,7 +526,7 @@ No registry-side action is needed. The Gitea packages remain published and don't
 
 ### When rollback is NOT needed
 
-- If a package is missing from the registry → publish it with `scripts/publish-local-gitea-packages.sh`
+- If a package is missing from the registry → publish it with `scripts/gitea/publish-local-packages.sh`
 - If a transitive dep is missing → add it explicitly to `package.json` (this surfaced for `@expo/vector-icons` in NomGap)
 
 ---
diff --git a/docs/devops/SINGLE_VM_DEPLOYMENT.md b/docs/devops/SINGLE_VM_DEPLOYMENT.md
index 9d7d977b..362bad69 100644
--- a/docs/devops/SINGLE_VM_DEPLOYMENT.md
+++ b/docs/devops/SINGLE_VM_DEPLOYMENT.md
@@ -868,21 +868,21 @@ kubectl get pods -A
 
 ## 10. Dockerization Status
 
-| Repo               | Backend Dockerfile | Web Dockerfile      | `output:'standalone'` | Build Context  | Status    |
-| ------------------ | ------------------ | ------------------- | --------------------- | -------------- | --------- |
-| **LysnrAI**        | ✅                 | ✅ user-dashboard   | ✅ (conditional)      | repo root      | ✅ Ready  |
-| **MindLyst**       | ✅                 | ✅                  | ✅ (conditional)      | repo root      | ✅ Ready  |
-| **ChronoMind**     | ✅                 | ✅                  | ✅ (conditional)      | backend/       | ✅ Ready  |
-| **JarvisJr**       | ✅                 | ✅                  | ✅ (conditional)      | backend/       | ✅ Ready  |
-| **PeakPulse**      | ✅                 | — (no web)          | —                     | backend/       | ✅ Ready  |
-| **FlowMonk**       | ✅                 | ✅                  | ✅ (conditional)      | repo root      | ✅ Ready  |
-| **NomGap**         | ✅                 | ✅                  | ✅                    | backend/       | ✅ Ready  |
-| **NoteLett**       | ✅                 | ✅                  | ✅                    | backend/       | ✅ Ready  |
-| **ActionTrail**    | ✅                 | ✅                  | ✅                    | repo root      | ✅ Ready  |
-| **LocalMemGPT**    | ✅                 | ✅                  | ✅                    | repo root      | ✅ Ready  |
-| **admin-web**      | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready  |
-| **tracker-web**    | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready  |
-| **user-dashboard** | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready  |
+| Repo               | Backend Dockerfile | Web Dockerfile      | `output:'standalone'` | Build Context  | Status   |
+| ------------------ | ------------------ | ------------------- | --------------------- | -------------- | -------- |
+| **LysnrAI**        | ✅                 | ✅ user-dashboard   | ✅ (conditional)      | repo root      | ✅ Ready |
+| **MindLyst**       | ✅                 | ✅                  | ✅ (conditional)      | repo root      | ✅ Ready |
+| **ChronoMind**     | ✅                 | ✅                  | ✅ (conditional)      | backend/       | ✅ Ready |
+| **JarvisJr**       | ✅                 | ✅                  | ✅ (conditional)      | backend/       | ✅ Ready |
+| **PeakPulse**      | ✅                 | — (no web)          | —                     | backend/       | ✅ Ready |
+| **FlowMonk**       | ✅                 | ✅                  | ✅ (conditional)      | repo root      | ✅ Ready |
+| **NomGap**         | ✅                 | ✅                  | ✅                    | backend/       | ✅ Ready |
+| **NoteLett**       | ✅                 | ✅                  | ✅                    | backend/       | ✅ Ready |
+| **ActionTrail**    | ✅                 | ✅                  | ✅                    | repo root      | ✅ Ready |
+| **LocalMemGPT**    | ✅                 | ✅                  | ✅                    | repo root      | ✅ Ready |
+| **admin-web**      | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready |
+| **tracker-web**    | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready |
+| **user-dashboard** | —                  | ✅ (in common-plat) | ✅ (conditional)      | pnpm workspace | ✅ Ready |
 
 All repos use pnpm with Gitea npm registry. Docker builds use BuildKit secret mount for registry auth.
 
@@ -998,7 +998,7 @@ Gitea is a lightweight, self-hosted Git forge (~150 MB RAM) that provides three
 # Build and publish all @bytelyst/* packages to Gitea
 cd learning_ai_common_plat
 pnpm -r --filter './packages/**' build
-GITEA_NPM_TOKEN='<token>' bash ./scripts/publish-local-gitea-packages.sh
+GITEA_NPM_TOKEN='<token>' bash ./scripts/gitea/publish-local-packages.sh
 ```
 
 The publish helper uses `pnpm pack` first so `workspace:*` references are normalized before publishing to Gitea.
@@ -1127,14 +1127,14 @@ LocalMemGPT uses `OLLAMA_URL: 'http://host.docker.internal:11434'` — this work
 
 All audit findings have been resolved:
 
-| Priority | Item                                           | Status   |
-| -------- | ---------------------------------------------- | -------- |
-| **P0**   | All backend + web Dockerfiles created          | ✅ Done  |
-| **P0**   | `output: 'standalone'` in all web configs      | ✅ Done  |
-| **P0**   | Gitea npm registry for `@bytelyst/*` packages  | ✅ Done  |
-| **P1**   | `.env.ecosystem` template                      | ✅ Done  |
-| **P2**   | Standardize Node.js version to 22-alpine       | ✅ Done  |
-| **P2**   | `extra_hosts` for Linux VM Ollama access       | ✅ Done  |
+| Priority | Item                                          | Status  |
+| -------- | --------------------------------------------- | ------- |
+| **P0**   | All backend + web Dockerfiles created         | ✅ Done |
+| **P0**   | `output: 'standalone'` in all web configs     | ✅ Done |
+| **P0**   | Gitea npm registry for `@bytelyst/*` packages | ✅ Done |
+| **P1**   | `.env.ecosystem` template                     | ✅ Done |
+| **P2**   | Standardize Node.js version to 22-alpine      | ✅ Done |
+| **P2**   | `extra_hosts` for Linux VM Ollama access      | ✅ Done |
 
 ---
 
@@ -1172,6 +1172,6 @@ Use that document for:
 | **Self-hosted CI?**            | **Yes.** Gitea + act_runner (~250 MB combined). GitHub Actions–compatible workflows.                           |
 | **Package registry?**          | **Gitea npm registry** — 49 `@bytelyst/*` packages published. Also has Docker container registry.              |
 | **K8s practice on single VM?** | **Docker Desktop K8s** (Mac/Windows) or **K3s** (Linux). Same manifests scale to AKS/EKS/GKE.                  |
-| **Recommended VM?**            | 8 vCPU / 32 GB (min) or 16 vCPU / 64 GB (with Ollama). Hetzner ~€45/mo for dev.                               |
+| **Recommended VM?**            | 8 vCPU / 32 GB (min) or 16 vCPU / 64 GB (with Ollama). Hetzner ~€45/mo for dev.                                |
 | **Enhanced tooling?**          | See [`SINGLE_VM_ENHANCED_PLAN.md`](SINGLE_VM_ENHANCED_PLAN.md) — Coolify, Valkey, Uptime Kuma, SOPS.           |
 | **Time to production K8s?**    | Phase 1 (compose) → Phase 2 (Docker Desktop / K3s) → Phase 3 (multi-node) → Phase 4 (managed). Same manifests. |
diff --git a/docs/devops/single_azure_vm/docker/README.md b/docs/devops/single_azure_vm/docker/README.md
index f5d0c1e0..a2f10278 100644
--- a/docs/devops/single_azure_vm/docker/README.md
+++ b/docs/devops/single_azure_vm/docker/README.md
@@ -331,7 +331,7 @@ All optional — defaults work for most setups:
 - Keep backend ports closed publicly once DNS and NSG rules are aligned. Docker-internal service discovery remains unchanged.
 - `ollama.bytelyst.com` reverse proxies to the host Ollama listener on `172.17.0.1:11434`; keep it restricted to trusted cross-VM or internal clients.
 - **Network guard:** run `source scripts/switch-network.sh` and honor `NETWORK=corp|home` before running pnpm/npm or hitting gitea/api endpoints so proxy settings flip to the correct environment.
-- **Quick check:** use `scripts/run-registry-tests.sh` to install, test, and verify `https://api.bytelyst.com`, `https://gitea.bytelyst.com`, and `https://ollama.bytelyst.com`.
+- **Quick check:** use `scripts/gitea/run-registry-tests.sh` to install, test, and verify `https://api.bytelyst.com`, `https://gitea.bytelyst.com`, and `https://ollama.bytelyst.com`.
 
 ## Known Limitations
 
diff --git a/package.json b/package.json
index 1eecb228..cc863741 100644
--- a/package.json
+++ b/package.json
@@ -20,7 +20,7 @@
     "clean": "pnpm -r exec rm -rf dist",
     "dns:godaddy:bytelyst": "./scripts/godaddy-sync-bytelyst-dns.sh",
     "prototype:self-test": "./scripts/prototype-self-test.sh",
-    "release": "./scripts/release-gitea-packages.sh",
+    "release": "./scripts/gitea/release-packages.sh",
     "prepare": "husky"
   },
   "devDependencies": {
diff --git a/scripts/harden-publish-config.sh b/scripts/gitea/harden-publish-config.sh
similarity index 98%
rename from scripts/harden-publish-config.sh
rename to scripts/gitea/harden-publish-config.sh
index 468e46e7..bdbb6148 100755
--- a/scripts/harden-publish-config.sh
+++ b/scripts/gitea/harden-publish-config.sh
@@ -7,7 +7,7 @@ set -euo pipefail
 # ─────────────────────────────────────────────────────────────
 
 REGISTRY="https://gitea.bytelyst.com/api/packages/ByteLyst/npm/"
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 PACKAGES_DIR="$REPO_ROOT/packages"
 
 # Skip native SDKs (not published to npm)
diff --git a/scripts/publish-local-gitea-packages.sh b/scripts/gitea/publish-local-packages.sh
similarity index 98%
rename from scripts/publish-local-gitea-packages.sh
rename to scripts/gitea/publish-local-packages.sh
index 8b8ca8d2..f572b920 100644
--- a/scripts/publish-local-gitea-packages.sh
+++ b/scripts/gitea/publish-local-packages.sh
@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 PACKAGES_DIR="$REPO_ROOT/packages"
 TMP_DIR="${TMPDIR:-/tmp}/bytelyst-gitea-publish"
 REGISTRY_URL="${GITEA_NPM_REGISTRY_URL:-https://gitea.bytelyst.com/api/packages/ByteLyst/npm/}"
diff --git a/scripts/publish-outdated-gitea-packages.sh b/scripts/gitea/publish-outdated-packages.sh
similarity index 98%
rename from scripts/publish-outdated-gitea-packages.sh
rename to scripts/gitea/publish-outdated-packages.sh
index 49431be9..18b2234c 100755
--- a/scripts/publish-outdated-gitea-packages.sh
+++ b/scripts/gitea/publish-outdated-packages.sh
@@ -8,14 +8,14 @@ set -euo pipefail
 # Only publishes packages where the content has actually changed.
 #
 # Usage:
-#   ./scripts/publish-outdated-gitea-packages.sh           # detect + publish
-#   ./scripts/publish-outdated-gitea-packages.sh --dry-run  # detect only
-#   ./scripts/publish-outdated-gitea-packages.sh --filter @bytelyst/errors
+#   ./scripts/gitea/publish-outdated-packages.sh           # detect + publish
+#   ./scripts/gitea/publish-outdated-packages.sh --dry-run  # detect only
+#   ./scripts/gitea/publish-outdated-packages.sh --filter @bytelyst/errors
 #
 # Requires: GITEA_NPM_TOKEN env var (or ~/.gitea_npm_token)
 # ─────────────────────────────────────────────────────────────
 
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 PACKAGES_DIR="$REPO_ROOT/packages"
 
 # ── Network-aware Gitea resolution ─────────────────────────
@@ -186,7 +186,7 @@ bump_patch_version() {
   " "$pkg_json" "$published_versions"
 }
 
-# Publish a package using the same double-pack pattern as publish-local-gitea-packages.sh.
+# Publish a package using the same double-pack pattern as publish-local-packages.sh.
 publish_package() {
   local pkg_dir="$1"
   local pkg_name pkg_version safe_name
diff --git a/scripts/release-gitea-packages.sh b/scripts/gitea/release-packages.sh
similarity index 96%
rename from scripts/release-gitea-packages.sh
rename to scripts/gitea/release-packages.sh
index 91dd1006..86a5a47d 100755
--- a/scripts/release-gitea-packages.sh
+++ b/scripts/gitea/release-packages.sh
@@ -1,12 +1,12 @@
 #!/usr/bin/env bash
-# release-gitea-packages.sh — Version-bump + publish @bytelyst/* packages to Gitea npm registry
+# release-packages.sh — Version-bump + publish @bytelyst/* packages to Gitea npm registry
 #
 # Usage:
-#   ./scripts/release-gitea-packages.sh              # apply pending changesets + publish missing/outdated packages
-#   ./scripts/release-gitea-packages.sh --patch      # auto-bump all packages (patch) + publish
-#   ./scripts/release-gitea-packages.sh --minor      # auto-bump all packages (minor) + publish
-#   ./scripts/release-gitea-packages.sh --major      # auto-bump all packages (major) + publish
-#   ./scripts/release-gitea-packages.sh --dry-run    # show what would be published, no side effects
+#   ./scripts/gitea/release-packages.sh              # apply pending changesets + publish missing/outdated packages
+#   ./scripts/gitea/release-packages.sh --patch      # auto-bump all packages (patch) + publish
+#   ./scripts/gitea/release-packages.sh --minor      # auto-bump all packages (minor) + publish
+#   ./scripts/gitea/release-packages.sh --major      # auto-bump all packages (major) + publish
+#   ./scripts/gitea/release-packages.sh --dry-run    # show what would be published, no side effects
 #
 # Required env:
 #   GITEA_NPM_TOKEN — auth token for the Gitea npm registry (or ~/.gitea_npm_token file)
@@ -22,10 +22,10 @@ set -euo pipefail
 
 # ── Config ─────────────────────────────────────────────────────────────────────
 
-REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+REPO_ROOT="$(cd "$(dirname "$0")/../.." && pwd)"
 
 # ── Network-aware Gitea resolution ─────────────────────────────────────────────
-# Matches the pattern in publish-outdated-gitea-packages.sh
+# Matches the pattern in publish-outdated-packages.sh
 NETWORK_MODE="${NETWORK:-home}"
 
 if [ "$NETWORK_MODE" = "corp" ]; then
diff --git a/scripts/run-registry-tests.sh b/scripts/gitea/run-registry-tests.sh
similarity index 100%
rename from scripts/run-registry-tests.sh
rename to scripts/gitea/run-registry-tests.sh