@prover-coder-ai/docker-git 1.0.21 → 1.0.23

package/.package.json.release.bak

@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/docker-git",
-  "version": "1.0.21",
+  "version": "1.0.23",
   "description": "Minimal Vite-powered TypeScript console starter using Effect",
   "main": "dist/src/docker-git/main.js",
   "bin": {
@@ -13,15 +13,17 @@
     "prebuild": "pnpm -C ../lib build",
     "build": "pnpm run build:app && pnpm run build:docker-git",
     "build:app": "vite build --ssr src/app/main.ts",
+    "prepack": "pnpm run build:docker-git",
     "dev": "vite build --watch --ssr src/app/main.ts",
     "prelint": "pnpm -C ../lib build",
     "lint": "PATH=../../scripts:$PATH vibecode-linter src/",
     "lint:tests": "PATH=../../scripts:$PATH vibecode-linter tests/",
     "lint:effect": "PATH=../../scripts:$PATH eslint --config eslint.effect-ts-check.config.mjs .",
     "prebuild:docker-git": "pnpm -C ../lib build",
-    "build:docker-git": "tsc -p tsconfig.build.json",
+    "build:docker-git": "vite build --config vite.docker-git.config.ts",
     "check": "pnpm run typecheck",
     "clone": "pnpm -C ../.. run clone",
+    "open": "pnpm -C ../.. run open",
     "docker-git": "node dist/src/docker-git/main.js",
     "list": "pnpm -C ../.. run list",
     "prestart": "pnpm run build",
@@ -53,7 +55,6 @@
   "homepage": "https://github.com/ProverCoderAI/docker-git#readme",
   "packageManager": "pnpm@10.28.0",
   "dependencies": {
-    "@effect-template/lib": "workspace:*",
     "@effect/cli": "^0.73.0",
     "@effect/cluster": "^0.56.1",
     "@effect/experimental": "^0.58.0",
@@ -73,6 +74,7 @@
     "ts-morph": "^27.0.2"
   },
   "devDependencies": {
+    "@effect-template/lib": "workspace:*",
     "@biomejs/biome": "^2.3.11",
     "@effect/eslint-plugin": "^0.3.2",
     "@effect/language-service": "latest",

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @prover-coder-ai/docker-git
 
+## 1.0.23
+
+### Patch Changes
+
+- chore: automated version bump
+
+## 1.0.22
+
+### Patch Changes
+
+- chore: automated version bump
+
 ## 1.0.21
 
 ### Patch Changes

package/README.md

@@ -1,6 +1,6 @@
 # docker-git
 
-`docker-git` generates a disposable Docker development environment per repository and stores it under a single projects root (default: `~/.docker-git`).
+`docker-git` generates a disposable Docker development environment per repository (or empty workspace) and stores it under a single projects root (default: `~/.docker-git`).
 
 Key goals:
 - Functional Core, Imperative Shell implementation (pure templates + typed orchestration).
@@ -18,12 +18,18 @@ pnpm install
 # Interactive TUI menu (default)
 pnpm run docker-git
 
+# Create an empty workspace container (no git clone)
+pnpm run docker-git create
+
 # Clone a repo into its own container (creates under ~/.docker-git)
 pnpm run docker-git clone https://github.com/agiens/crm/tree/vova-fork --force
 
 # Clone an issue URL (creates isolated workspace + issue branch)
 pnpm run docker-git clone https://github.com/agiens/crm/issues/123 --force
 
+# Open an existing docker-git project by repo/issue URL (runs up + tmux attach)
+pnpm run docker-git open https://github.com/agiens/crm/issues/123
+
 # Reset only project env defaults (keep workspace volume/data)
 pnpm run docker-git clone https://github.com/agiens/crm/issues/123 --force-env
 
@@ -122,6 +128,19 @@ Common toggles:
 - `NPM_CONFIG_CACHE=/home/dev/.docker-git/.cache/packages/npm` (default shared cache)
 - `YARN_CACHE_FOLDER=/home/dev/.docker-git/.cache/packages/yarn` (default shared cache)
 
+## Compose Network Mode
+
+Default mode is shared:
+- `--network-mode shared` (default)
+- Shared compose network name: `--shared-network docker-git-shared`
+
+Shared mode keeps one external Docker network for all docker-git projects, which reduces address pool pressure when many projects are created.
+
+If you need strict per-project isolation:
+- `--network-mode project`
+
+In project mode, each project uses `<service>-net` (Docker-managed bridge network).
+
 ## Troubleshooting
 
 MCP errors in `codex` UI:
@@ -158,6 +177,17 @@ Docker permission error (`/var/run/docker.sock`):
 - Note:
   - Do not run `pnpm run docker-git ...` with `sudo`.
 
+Docker network pool exhausted (`all predefined address pools have been fully subnetted`):
+- Symptom:
+  - `failed to create network ... all predefined address pools have been fully subnetted`
+- Quick recovery:
+  ```bash
+  docker network prune -f
+  ```
+- Long-term fix:
+  - Configure Docker daemon `default-address-pools` in `/etc/docker/daemon.json`.
+  - Prefer `docker-git` shared network mode (`--network-mode shared`).
+
 Clone auth error (`Invalid username or token`):
 - Symptom:
   - `remote: Invalid username or token. Password authentication is not supported for Git operations.`