rename package to @hoangsonw/forge and point URLs at hoangsonw/Forge-Agentic-Coding-CLI

- package.json: @forge/cli → @hoangsonw/forge, updated homepage/repo/bugs
- bin/forge cleaned per npm pkg fix
- README, ARCHITECTURE, INSTALL, SETUP, CLAUDE.md, index.html,
  Dockerfile, scripts, workflows: all refs rewritten to the new names
- ghcr.io image: ghcr.io/hoangsonw/forge-agentic-coding-cli (lowercase)
- config set: friendlier zod-error path (no raw stack trace dump)
- add test/fixtures (typed loaders + JSONL + config fixtures)
- add integration tests (persistence round-trip, sandbox+shell, memory-learning)
- add e2e test: cli-smoke spawns bin/forge.js
- docs: drop stale LoC refs, sync test counts to 249 / 43 files

Author: hoangsonww

CLAUDE.md

@@ -15,8 +15,8 @@ coding agents) working on the Forge repository.
 **Forge** — a local-first, multi-agent, programmable software-engineering
 CLI runtime. Written in TypeScript, targets Node 20+. Ships as:
 
-- `@forge/cli` (npm)
-- `ghcr.io/forge/forge` (Docker image, multi-arch)
+- `@hoangsonw/forge` (npm)
+- `ghcr.io/hoangsonw/forge-agentic-coding-cli` (Docker image, multi-arch)
 - `docker/docker-compose.yml` for the full stack with Ollama + UI
 
 **It is not** a chat wrapper, a VS Code extension, or a web app. The

README.md

@@ -11,7 +11,7 @@ permission system, state machine, agentic loop, memory layers, and
 plugin ecosystem. You pick the model. You approve the actions. Everything
 is inspectable, replayable, and yours.
 
-**[Install](docs/INSTALL.md) · [Dev setup](docs/SETUP.md) · [Architecture](docs/ARCHITECTURE.md) · [AGENTS.md](AGENTS.md) · [CLAUDE.md](CLAUDE.md) · [Landing](index.html)**
+**[Install](docs/INSTALL.md) · [Dev setup](docs/SETUP.md) · [Architecture](docs/ARCHITECTURE.md) · [Wiki Page](index.html) · [License](LICENSE)**
 
 </div>
 
@@ -60,7 +60,7 @@ Forge is a local-first, multi-agent, programmable software-engineering runtime.
 | 🎛 **Modes** | **9** | fast · balanced · heavy · plan · execute · audit · debug · architect · offline-safe |
 | ✅ **Tests** | **249 / 43 files** · 100% passing · ~3.3 s wall-clock | `npx vitest run` |
 | 🐳 **CI jobs · release stages** | **9 · 6** | [`.github/workflows/`](.github/workflows) |
-| 📦 **Container image** | ~355 MB · multi-arch · non-root · HEALTHCHECK | `docker pull ghcr.io/forge/forge:latest` |
+| 📦 **Container image** | ~355 MB · multi-arch · non-root · HEALTHCHECK | `docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest` |
 
 </div>
 
@@ -214,20 +214,23 @@ mindmap
 - **Open source.** MIT license. No telemetry, no phoning home, no hidden
   backdoors. You get the whole stack. Unlike hosted assistants, Forge is fully inspectable, replayable, and yours.
 
+> [!TIP]
+> Unlike Claude Code or OpenAI Codex, Forge is not a hosted assistant. It's local-first infrastructure. You pick & host the model. You approve the actions. Everything is inspectable, replayable, and yours.
+
 ---
 
 ## Quick start
 
 ```bash
 # Option 1 — npm (global):
-npm install -g @forge/cli
+npm install -g @hoangsonw/forge
 forge doctor             # green checks + role→model mapping
 forge run "explain this repo"
 
 # Option 2 — Docker:
 docker run --rm -it \
   -v forge-home:/data -v "$PWD:/workspace" \
-  ghcr.io/forge/forge:latest forge run "explain this repo"
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest forge run "explain this repo"
 
 # Option 3 — full stack (forge + ollama + dashboard):
 docker compose -f docker/docker-compose.yml up -d
@@ -698,15 +701,15 @@ serves both CLI and UI.
 
 ```bash
 # Pull (multi-arch: linux/amd64 + linux/arm64):
-docker pull ghcr.io/forge/forge:latest
+docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 
 # One-shot CLI:
 docker run --rm -it -v forge-home:/data -v "$PWD:/workspace" \
-  ghcr.io/forge/forge:latest forge run "explain this repo"
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest forge run "explain this repo"
 
 # Dashboard:
 docker run --rm -p 7823:7823 -v forge-home:/data \
-  ghcr.io/forge/forge:latest forge ui start --bind 0.0.0.0
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest forge ui start --bind 0.0.0.0
 
 # Full stack (forge + ollama + UI):
 docker compose -f docker/docker-compose.yml up -d
@@ -855,7 +858,7 @@ xychart-beta
 ## Development
 
 ```bash
-git clone https://github.com/forge/forge && cd forge
+git clone https://github.com/hoangsonw/Forge-Agentic-Coding-CLI && cd forge
 npm install
 npm run build             # tsc + copy-assets
 npm test                  # 249 tests across 43 files; all must pass

docker/Dockerfile

@@ -53,7 +53,7 @@ LABEL org.opencontainers.image.title="Forge" \
       org.opencontainers.image.version="${FORGE_VERSION}" \
       org.opencontainers.image.revision="${FORGE_COMMIT}" \
       org.opencontainers.image.created="${BUILD_DATE}" \
-      org.opencontainers.image.source="https://github.com/forge/forge" \
+      org.opencontainers.image.source="https://github.com/hoangsonw/Forge-Agentic-Coding-CLI" \
       org.opencontainers.image.licenses="MIT"
 
 ENV NODE_ENV=production \

docs/ARCHITECTURE.md

@@ -513,7 +513,7 @@ Measured with reproducible commands. No synthetic benchmarks.
 | UI `app.js` uncompressed | **89 KB** (zero CDN fetches) | `wc -c src/ui/public/app.js` |
 | Full test suite | **~3.3 s** wall-clock | `npx vitest run` |
 | Tests | **249 / 43 files** · 100% passing | — |
-| Container image | **~355 MB** multi-arch non-root | `docker images ghcr.io/forge/forge` |
+| Container image | **~355 MB** multi-arch non-root | `docker images ghcr.io/hoangsonw/forge-agentic-coding-cli` |
 
 Executor turn budget per mode (hard runtime cap, from
 `src/core/mode-policy.ts`):

docs/INSTALL.md

@@ -29,9 +29,9 @@ flowchart TD
   START --> Q1{Prefer isolation?}:::q
   Q1 -->|yes| Q2{Docker or Podman installed?}:::q
   Q2 -->|yes| COMPOSE["§5 · compose stack<br/>forge + ollama + UI"]:::r
-  Q2 -->|no| NPM1["§2 · npm -g @forge/cli"]:::r
+  Q2 -->|no| NPM1["§2 · npm -g @hoangsonw/forge"]:::r
   Q1 -->|no| Q3{Node 20+ on path?}:::q
-  Q3 -->|yes| NPM2["§2 · npm -g @forge/cli"]:::r
+  Q3 -->|yes| NPM2["§2 · npm -g @hoangsonw/forge"]:::r
   Q3 -->|no| DOCK["§3 · one-shot docker run"]:::r
 ```
 
@@ -47,7 +47,7 @@ flowchart TD
 ## 2. npm (global)
 
 ```bash
-npm install -g @forge/cli
+npm install -g @hoangsonw/forge
 forge doctor       # verify
 forge init         # create ~/.forge
 forge run "explain this repo"
@@ -79,13 +79,13 @@ sequenceDiagram
 Upgrade:
 
 ```bash
-npm update -g @forge/cli
+npm update -g @hoangsonw/forge
 ```
 
 Local install from a checkout (for PR testing):
 
 ```bash
-git clone https://github.com/forge/forge && cd forge
+git clone https://github.com/hoangsonw/Forge-Agentic-Coding-CLI && cd forge
 npm install
 npm run build
 npm link              # adds `forge` to PATH
@@ -124,7 +124,7 @@ flowchart LR
 Pull:
 
 ```bash
-docker pull ghcr.io/forge/forge:latest
+docker pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 ```
 
 One-shot invocation (your CWD → `/workspace`):
@@ -133,7 +133,7 @@ One-shot invocation (your CWD → `/workspace`):
 docker run --rm -it \
   -v forge-home:/data \
   -v "$PWD:/workspace" \
-  ghcr.io/forge/forge:latest \
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest \
   forge run "explain this repo"
 ```
 
@@ -142,7 +142,7 @@ Dashboard:
 ```bash
 docker run --rm -p 7823:7823 \
   -v forge-home:/data \
-  ghcr.io/forge/forge:latest \
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest \
   forge ui start --bind 0.0.0.0
 # open http://127.0.0.1:7823
 ```
@@ -168,11 +168,11 @@ docker build -f docker/Dockerfile -t forge/core:dev .
 Everything in §3 works by swapping `docker` for `podman`:
 
 ```bash
-podman pull ghcr.io/forge/forge:latest
+podman pull ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 podman run --rm -it \
   -v forge-home:/data \
   -v "$PWD:/workspace" \
-  ghcr.io/forge/forge:latest
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 ```
 
 Rootless mode is supported — the image uses a static uid (10001) so
@@ -183,7 +183,7 @@ volume ownership is predictable across hosts.
 ## 5. Compose (Forge + Ollama + UI)
 
 ```bash
-git clone https://github.com/forge/forge && cd forge
+git clone https://github.com/hoangsonw/Forge-Agentic-Coding-CLI && cd forge
 docker compose -f docker/docker-compose.yml up -d
 # or:
 podman-compose -f docker/docker-compose.yml up -d
@@ -245,7 +245,7 @@ docker compose -f docker/docker-compose.yml down
 
 - PowerShell:
   ```powershell
-  npm install -g @forge/cli
+  npm install -g @hoangsonw/forge
   forge doctor
   ```
 - WSL 2: preferred for shell-intensive workflows (ripgrep, git).
@@ -313,8 +313,8 @@ what to start and which env vars unlock cloud fallback.
 ## 9. Uninstall
 
 ```bash
-npm uninstall -g @forge/cli    # or remove the image:
-docker rmi ghcr.io/forge/forge:latest
+npm uninstall -g @hoangsonw/forge    # or remove the image:
+docker rmi ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 
 # optional — wipe state:
 rm -rf ~/.forge                # global
@@ -333,10 +333,10 @@ docker compose -f docker/docker-compose.yml down --volumes --remove-orphans
 
 | Symptom | Likely cause | Fix |
 |---------|--------------|-----|
-| `forge: command not found` | npm global bin not on PATH | add `$(npm bin -g)` to PATH, or use `npx @forge/cli` |
+| `forge: command not found` | npm global bin not on PATH | add `$(npm bin -g)` to PATH, or use `npx @hoangsonw/forge` |
 | `No model provider is reachable` | nothing running on default ports | start Ollama / LM Studio / vLLM / llama.cpp, or export `ANTHROPIC_API_KEY` |
 | `adapter: substituted model` warning | your configured model isn't pulled | either `ollama pull <id>` or accept the substitution (Forge picked the best-fit) |
-| Container exits immediately | default CMD is `forge --help` | pass a subcommand: `docker run … ghcr.io/forge/forge:latest forge run "…"` |
+| Container exits immediately | default CMD is `forge --help` | pass a subcommand: `docker run … ghcr.io/hoangsonw/forge-agentic-coding-cli:latest forge run "…"` |
 | Permission prompts every single call | strict mode on, or no flags | `--skip-permissions` for routine tools, or `--allow-shell` / `--allow-files` |
 | UI can't reach backend services | bind address wrong | `forge ui start --bind 0.0.0.0 --port 7823` |
 | SQLite locked | daemon + REPL both writing | Forge handles this with O_APPEND; if you see this, file an issue with the full log |

docs/SETUP.md

@@ -37,7 +37,7 @@ local model. Hosted `ANTHROPIC_API_KEY` / `OPENAI_API_KEY` also works.
 ## 2. Clone, install, verify
 
 ```bash
-git clone https://github.com/forge/forge && cd forge
+git clone https://github.com/hoangsonw/Forge-Agentic-Coding-CLI && cd forge
 npm install
 npm run build
 npm test              # 249 tests across 43 files; all must pass

index.html

@@ -35,7 +35,7 @@
       <a href="#cicd">CI/CD</a>
       <a href="#numbers">Metrics</a>
     </nav>
-    <a class="nav-gh" href="https://github.com/forge/forge">
+    <a class="nav-gh" href="https://github.com/hoangsonw/Forge-Agentic-Coding-CLI">
       <svg viewBox="0 0 24 24" aria-hidden="true"><path d="M12 .5A12 12 0 0 0 0 12.7a12 12 0 0 0 8.2 11.5c.6.1.8-.3.8-.6v-2.1c-3.3.7-4-1.6-4-1.6-.6-1.4-1.4-1.8-1.4-1.8-1.1-.8.1-.8.1-.8 1.2.1 1.9 1.3 1.9 1.3 1.1 2 3 1.4 3.7 1 .1-.8.4-1.4.8-1.7-2.7-.3-5.5-1.3-5.5-6 0-1.3.5-2.4 1.3-3.2-.1-.3-.6-1.6.1-3.2 0 0 1-.3 3.3 1.2a11 11 0 0 1 6 0c2.3-1.5 3.3-1.2 3.3-1.2.7 1.6.2 2.9.1 3.2.8.8 1.3 1.9 1.3 3.2 0 4.6-2.8 5.7-5.5 6 .4.4.8 1.1.8 2.2v3.3c0 .3.2.7.8.6A12 12 0 0 0 24 12.7 12 12 0 0 0 12 .5z"/></svg>
       <span>GitHub</span>
     </a>
@@ -63,7 +63,7 @@ <h1>
     <div class="cta">
       <a class="btn primary" href="#install">Install Forge →</a>
       <a class="btn" href="#loop">Read the wiki</a>
-      <a class="btn" href="https://github.com/forge/forge">GitHub</a>
+      <a class="btn" href="https://github.com/hoangsonw/Forge-Agentic-Coding-CLI">GitHub</a>
     </div>
     <div class="hero-stats">
       <div class="hero-stat"><div class="n"><span class="cu" data-to="173">0</span> ms</div><div class="l">doctor cold-start</div></div>
@@ -630,7 +630,7 @@ <h2>Three paths. <em>Pick one.</em></h2>
         <h4>01 / npm</h4>
         <div class="code-win">
           <div class="titlebar"><div class="traffic"><i></i><i></i><i></i></div><span class="ttl">global install</span><span class="lang">bash</span></div>
-<pre><span class="prompt"></span>npm i -g @forge/cli
+<pre><span class="prompt"></span>npm i -g @hoangsonw/forge
 <span class="prompt"></span>forge doctor
 <span class="prompt"></span>forge run <span class="str">"…"</span>
 </pre>
@@ -643,7 +643,7 @@ <h4>02 / Docker</h4>
 <pre><span class="prompt"></span>docker run --rm -it \
   -v forge-home:/data \
   -v <span class="str">"$PWD:/workspace"</span> \
-  ghcr.io/forge/forge:latest
+  ghcr.io/hoangsonw/forge-agentic-coding-cli:latest
 </pre>
         </div>
       </div>
@@ -844,7 +844,7 @@ <h3>UI shell asset sizes</h3>
           <tr><td><code>forge --help</code> cold-start</td><td class="y">238 ms</td><td><code>time node bin/forge.js --help</code></td></tr>
           <tr><td>full test suite</td><td class="y">~3.3 s</td><td><code>npx vitest run</code></td></tr>
           <tr><td>UI app.js uncompressed</td><td class="y">89 KB</td><td><code>wc -c src/ui/public/app.js</code></td></tr>
-          <tr><td>container image</td><td class="y">~355 MB</td><td><code>docker images ghcr.io/forge/forge</code></td></tr>
+          <tr><td>container image</td><td class="y">~355 MB</td><td><code>docker images ghcr.io/hoangsonw/forge-agentic-coding-cli</code></td></tr>
           <tr><td>CDN fetches at runtime</td><td class="y">0</td><td>inspect <code>app.js</code> · no external URLs</td></tr>
           <tr><td>provider probe timeout</td><td class="y">1.5 s</td><td><code>src/models/openai.ts#isAvailable</code></td></tr>
         </tbody>
@@ -884,7 +884,7 @@ <h3>Ready to install?</h3>
       </p>
       <div class="cta" style="margin-top:20px">
         <a class="btn primary" href="docs/INSTALL.md">Install Forge →</a>
-        <a class="btn" href="https://github.com/forge/forge">GitHub</a>
+        <a class="btn" href="https://github.com/hoangsonw/Forge-Agentic-Coding-CLI">GitHub</a>
         <a class="btn" href="docs/ARCHITECTURE.md">Architecture</a>
       </div>
     </div>
@@ -895,7 +895,7 @@ <h3>Ready to install?</h3>
   <div class="container row">
     <span>© Forge contributors · MIT</span>
     <span>TypeScript · Node 20+</span>
-    <span><a href="https://github.com/forge/forge">GitHub</a> · <a href="docs/ARCHITECTURE.md">Architecture</a> · <a href="docs/INSTALL.md">Install</a></span>
+    <span><a href="https://github.com/hoangsonw/Forge-Agentic-Coding-CLI">GitHub</a> · <a href="docs/ARCHITECTURE.md">Architecture</a> · <a href="docs/INSTALL.md">Install</a></span>
   </div>
 </footer>
 

package.json

@@ -1,19 +1,19 @@
 {
-  "name": "@forge/cli",
+  "name": "@hoangsonw/forge",
   "version": "0.1.0",
   "description": "Forge - a local-first, multi-agent, programmable software-engineering runtime",
   "license": "MIT",
-  "author": "Forge contributors",
-  "homepage": "https://github.com/forge/forge#readme",
+  "author": "Son Nguyen (hoangsonw)",
+  "homepage": "https://github.com/hoangsonw/Forge-Agentic-Coding-CLI#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/forge/forge.git"
+    "url": "git+https://github.com/hoangsonw/Forge-Agentic-Coding-CLI.git"
   },
   "bugs": {
-    "url": "https://github.com/forge/forge/issues"
+    "url": "https://github.com/hoangsonw/Forge-Agentic-Coding-CLI/issues"
   },
   "bin": {
-    "forge": "./bin/forge.js"
+    "forge": "bin/forge.js"
   },
   "main": "./dist/cli/index.js",
   "type": "commonjs",

scripts/link.sh

@@ -38,7 +38,7 @@ else
   say "dist/ is fresh — skipping build."
 fi
 
-say "Linking @forge/cli into $(npm prefix -g)/bin ..."
+say "Linking @hoangsonw/forge into $(npm prefix -g)/bin ..."
 npm link --silent
 
 GLOBAL_BIN="$(npm prefix -g)/bin"

scripts/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 'use strict';
 /**
- * Post-install hook for `npm install -g @forge/cli`.
+ * Post-install hook for `npm install -g @hoangsonw/forge`.
  *
  * 1. Creates the ~/.forge skeleton (idempotent).
  * 2. If FORGE_BINARY_PATH is set, stops there — treat Forge as "run from