@prover-coder-ai/docker-git 1.0.5

package/.jscpd.json

@@ -0,0 +1,16 @@
+{
+	"threshold": 0,
+	"minTokens": 30,
+	"minLines": 5,
+	"ignore": [
+		"**/node_modules/**",
+		"**/build/**",
+		"**/dist/**",
+		"**/*.min.js",
+		"**/reports/**"
+	],
+	"skipComments": true,
+	"ignorePattern": [
+		"private readonly \\w+: \\w+;\\s*private readonly \\w+: \\w+;\\s*private \\w+: \\w+ \\| null = null;\\s*private \\w+: \\w+ \\| null = null;"
+	]
+}

package/.package.json.release.bak

@@ -0,0 +1,109 @@
+{
+  "name": "@prover-coder-ai/docker-git",
+  "version": "1.0.5",
+  "description": "Minimal Vite-powered TypeScript console starter using Effect",
+  "main": "dist/src/docker-git/main.js",
+  "bin": {
+    "docker-git": "dist/src/docker-git/main.js"
+  },
+  "directories": {
+    "doc": "doc"
+  },
+  "scripts": {
+    "prebuild": "pnpm -C ../lib build",
+    "build": "pnpm run build:app && pnpm run build:docker-git",
+    "build:app": "vite build --ssr src/app/main.ts",
+    "dev": "vite build --watch --ssr src/app/main.ts",
+    "prelint": "pnpm -C ../lib build",
+    "lint": "npx @ton-ai-core/vibecode-linter src/",
+    "lint:tests": "npx @ton-ai-core/vibecode-linter tests/",
+    "lint:effect": "npx eslint --config eslint.effect-ts-check.config.mjs .",
+    "prebuild:docker-git": "pnpm -C ../lib build",
+    "build:docker-git": "tsc -p tsconfig.build.json",
+    "check": "pnpm run typecheck",
+    "clone": "pnpm -C ../.. run clone",
+    "docker-git": "node dist/src/docker-git/main.js",
+    "list": "pnpm -C ../.. run list",
+    "prestart": "pnpm run build",
+    "start": "node dist/main.js",
+    "pretest": "pnpm -C ../lib build",
+    "test": "pnpm run lint:tests && vitest run",
+    "pretypecheck": "pnpm -C ../lib build",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ProverCoderAI/docker-git.git"
+  },
+  "keywords": [
+    "effect",
+    "typescript",
+    "vite",
+    "console"
+  ],
+  "author": "",
+  "license": "ISC",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/ProverCoderAI/docker-git/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "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",
+    "@effect/platform": "^0.94.1",
+    "@effect/platform-node": "^0.104.0",
+    "@effect/printer": "^0.47.0",
+    "@effect/printer-ansi": "^0.47.0",
+    "@effect/rpc": "^0.73.0",
+    "@effect/schema": "^0.75.5",
+    "@effect/sql": "^0.49.0",
+    "@effect/typeclass": "^0.38.0",
+    "@effect/workflow": "^0.16.0",
+    "effect": "^3.19.14",
+    "ink": "^5.0.1",
+    "react": "^18.3.1",
+    "react-reconciler": "^0.29.2",
+    "ts-morph": "^27.0.2"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.11",
+    "@effect/eslint-plugin": "^0.3.2",
+    "@effect/language-service": "latest",
+    "@effect/vitest": "^0.27.0",
+    "@eslint-community/eslint-plugin-eslint-comments": "^4.6.0",
+    "@eslint/compat": "2.0.1",
+    "@eslint/eslintrc": "3.3.3",
+    "@eslint/js": "9.39.2",
+    "@prover-coder-ai/eslint-plugin-suggest-members": "^0.0.13",
+    "@ton-ai-core/vibecode-linter": "^1.0.6",
+    "@types/node": "^24.10.9",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "typescript-eslint": "^8.53.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "eslint": "^9.39.2",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-codegen": "0.34.1",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-simple-import-sort": "^12.1.1",
+    "eslint-plugin-sonarjs": "^3.0.5",
+    "eslint-plugin-sort-destructure-keys": "^2.0.0",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "@vitest/eslint-plugin": "^1.6.6",
+    "@types/react": "^18.3.12",
+    "biome": "npm:@biomejs/biome@^2.3.11",
+    "globals": "^17.0.0",
+    "jscpd": "^4.0.7",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.1",
+    "vite-tsconfig-paths": "^6.0.4",
+    "vitest": "^4.0.17"
+  }
+}

package/CHANGELOG.md

@@ -0,0 +1,31 @@
+# @prover-coder-ai/docker-git
+
+## 1.0.5
+
+### Patch Changes
+
+- chore: automated version bump
+
+## 1.0.4
+
+### Patch Changes
+
+- chore: automated version bump
+
+## 1.0.3
+
+### Patch Changes
+
+- chore: automated version bump
+
+## 1.0.2
+
+### Patch Changes
+
+- chore: automated version bump
+
+## 1.0.1
+
+### Patch Changes
+
+- chore: automated version bump

package/README.md

@@ -0,0 +1,173 @@
+# docker-git
+
+`docker-git` generates a disposable Docker development environment per repository and stores it under a single projects root (default: `~/.docker-git`).
+
+Key goals:
+- Functional Core, Imperative Shell implementation (pure templates + typed orchestration).
+- Per-project `.orch/` directory (env + local state), while still allowing shared credentials across containers.
+- Optional Playwright MCP + Chromium sidecar so Codex can do browser automation.
+
+## Quickstart
+
+From this repo:
+
+```bash
+pnpm install
+
+# Interactive TUI menu (default)
+pnpm run docker-git
+
+# 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
+
+# Reset only project env defaults (keep workspace volume/data)
+pnpm run docker-git clone https://github.com/agiens/crm/issues/123 --force-env
+
+# Same, but also enable Playwright MCP + Chromium sidecar for Codex
+pnpm run docker-git clone https://github.com/agiens/crm/tree/vova-fork --force --mcp-playwright
+```
+
+## Parallel Issues / PRs
+
+When you clone GitHub issue or PR URLs, docker-git creates isolated project paths and container names:
+- `.../issues/123` -> `<projectsRoot>/<owner>/<repo>/issue-123` (branch `issue-123`)
+- `.../pull/45` -> `<projectsRoot>/<owner>/<repo>/pr-45` (ref `refs/pull/45/head`)
+
+This lets you run multiple issues/PRs for the same repository in parallel without container/path collisions.
+
+Force modes:
+- `--force`: overwrite managed files and wipe compose volumes (`docker compose down -v`).
+- `--force-env`: reset only project env defaults and recreate containers without wiping volumes.
+
+Agent context for issue workspaces:
+- Global `${CODEX_HOME}/AGENTS.md` includes workspace path + issue/PR context.
+- For `issue-*` workspaces, docker-git creates `${TARGET_DIR}/AGENTS.md` (if missing) with issue context and auto-adds it to `.git/info/exclude`.
+
+## Projects Root Layout
+
+The projects root is:
+- `~/.docker-git` by default
+- Override with `DOCKER_GIT_PROJECTS_ROOT=/some/path`
+
+Structure (simplified):
+
+```text
+~/.docker-git/
+  authorized_keys
+  .orch/
+    env/
+      global.env
+    auth/
+      codex/          # shared Codex auth cache (credentials)
+      gh/             # shared GitHub auth (optional)
+  <owner>/<repo>/
+    docker-compose.yml
+    Dockerfile
+    entrypoint.sh
+    docker-git.json
+    .orch/
+      env/
+        global.env    # copied/synced from root .orch/env/global.env
+        project.env   # per-project env knobs (see below)
+      auth/
+        codex/        # project-local Codex state (sessions/logs/tmp/etc)
+```
+
+## Codex Auth: Shared Credentials, Per-Project Sessions
+
+Default behavior:
+- Shared credentials live in `/home/dev/.codex-shared/auth.json` (mounted from projects root).
+- Each project keeps its own Codex state under `/home/dev/.codex/` (mounted from project `.orch/auth/codex`).
+- The entrypoint links `/home/dev/.codex/auth.json -> /home/dev/.codex-shared/auth.json`.
+
+This avoids `refresh_token` rotation issues that can happen when copying `auth.json` into every project while still keeping session state isolated per project.
+
+Disable sharing (per-project auth):
+- Set `CODEX_SHARE_AUTH=0` in `.orch/env/project.env`.
+
+## Playwright MCP (Chromium Sidecar)
+
+Enable during create/clone:
+- Add `--mcp-playwright`
+
+This will:
+- Create a Chromium sidecar container: `dg-<repo>-browser`
+- Configure Codex MCP server `playwright` inside the dev container
+- Provide a wrapper `docker-git-playwright-mcp` inside the dev container
+
+Concurrency (many Codex sessions):
+- Default is safe for many sessions: `MCP_PLAYWRIGHT_ISOLATED=1`
+- Each Codex session gets its own browser context (incognito) to reduce cross-session interference.
+- If you want a shared browser context (shared cookies/login), set `MCP_PLAYWRIGHT_ISOLATED=0` (not recommended with multiple concurrent sessions).
+
+## Runtime Env Knobs (per project)
+
+Edit: `<projectDir>/.orch/env/project.env`
+
+Common toggles:
+- `CODEX_SHARE_AUTH=1|0` (default: `1`)
+- `CODEX_AUTO_UPDATE=1|0` (default: `1`)
+- `DOCKER_GIT_ZSH_AUTOSUGGEST=1|0` (default: `1`)
+- `MCP_PLAYWRIGHT_ISOLATED=1|0` (default: `1`)
+- `MCP_PLAYWRIGHT_CDP_ENDPOINT=http://...` (override CDP endpoint if needed)
+
+## Troubleshooting
+
+MCP errors in `codex` UI:
+- `No such file or directory (os error 2)` for `playwright`:
+  - `~/.codex/config.toml` contains `[mcp_servers.playwright]`, but the container was created without `--mcp-playwright`.
+  - Fix: recreate with `--force --mcp-playwright` (or remove the block from `config.toml`).
+- `handshaking ... initialize response`:
+  - The configured MCP command is not a real MCP server (example: `command="echo"`).
+
+Docker permission error (`/var/run/docker.sock`):
+- Symptom:
+  - `permission denied while trying to connect to the docker API at unix:///var/run/docker.sock`
+- Check:
+  ```bash
+  id
+  ls -l /var/run/docker.sock
+  docker version
+  ```
+- Fix (works in `fish` and `bash`):
+  ```bash
+  sudo chgrp docker /var/run/docker.sock
+  sudo chmod 660 /var/run/docker.sock
+  sudo mkdir -p /etc/systemd/system/docker.socket.d
+  printf '[Socket]\nSocketGroup=docker\nSocketMode=0660\n' | sudo tee /etc/systemd/system/docker.socket.d/override.conf >/dev/null
+  sudo systemctl daemon-reload
+  sudo systemctl restart docker.socket docker
+  ```
+- Verify:
+  ```bash
+  ls -l /var/run/docker.sock
+  docker version
+  ```
+- Note:
+  - Do not run `pnpm run docker-git ...` with `sudo`.
+
+Clone auth error (`Invalid username or token`):
+- Symptom:
+  - `remote: Invalid username or token. Password authentication is not supported for Git operations.`
+- Check and fix token:
+  ```bash
+  pnpm run docker-git auth github status
+  pnpm run docker-git auth github logout
+  pnpm run docker-git auth github login --token '<GITHUB_TOKEN>'
+  pnpm run docker-git auth github status
+  ```
+- Token requirements:
+  - Token must have access to the target repository.
+  - For org repositories with SSO/SAML, authorize the token for that organization.
+  - Recommended scopes: `repo,workflow,read:org`.
+
+## Security Notes
+
+The generated Codex config uses:
+- `sandbox_mode = "danger-full-access"`
+- `approval_policy = "never"`
+
+This is intended for local disposable containers. Do not reuse these defaults for untrusted code.

package/biome.json

@@ -0,0 +1,34 @@
+{
+	"$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
+	"vcs": {
+		"enabled": false,
+		"clientKind": "git",
+		"useIgnoreFile": false
+	},
+	"files": {
+		"ignoreUnknown": false
+	},
+	"assist": {
+		"enabled": false
+	},
+	"formatter": {
+		"enabled": false,
+		"indentStyle": "tab"
+	},
+	"linter": {
+		"enabled": false,
+		"rules": {
+			"recommended": false,
+			"suspicious": {
+				"noExplicitAny": "off"
+			}
+		}
+	},
+	"javascript": {
+		"formatter": {
+			"enabled": false,
+			"quoteStyle": "double",
+			"semicolons": "asNeeded"
+		}
+	}
+}