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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/docker-git",
-  "version": "1.0.21",
+  "version": "1.0.22",
   "description": "Minimal Vite-powered TypeScript console starter using Effect",
   "main": "dist/src/docker-git/main.js",
   "bin": {
@@ -35,8 +35,7 @@
     "@effect/schema": "^0.75.5",
     "effect": "^3.19.14",
     "ink": "^5.0.1",
-    "react": "^18.3.1",
-    "@effect-template/lib": "1.0.0"
+    "react": "^18.3.1"
   },
   "scripts": {
     "prebuild": "pnpm -C ../lib build",
@@ -48,7 +47,7 @@
     "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",
     "docker-git": "node dist/src/docker-git/main.js",

package/src/docker-git/cli/parser-options.ts

@@ -20,6 +20,8 @@ interface ValueOptionSpec {
     | "envProjectPath"
     | "codexAuthPath"
     | "codexHome"
+    | "dockerNetworkMode"
+    | "dockerSharedNetworkName"
     | "archivePath"
     | "scrapMode"
     | "label"
@@ -51,6 +53,8 @@ const valueOptionSpecs: ReadonlyArray<ValueOptionSpec> = [
   { flag: "--env-project", key: "envProjectPath" },
   { flag: "--codex-auth", key: "codexAuthPath" },
   { flag: "--codex-home", key: "codexHome" },
+  { flag: "--network-mode", key: "dockerNetworkMode" },
+  { flag: "--shared-network", key: "dockerSharedNetworkName" },
   { flag: "--archive", key: "archivePath" },
   { flag: "--mode", key: "scrapMode" },
   { flag: "--label", key: "label" },
@@ -102,6 +106,8 @@ const valueFlagUpdaters: { readonly [K in ValueKey]: (raw: RawOptions, value: st
   envProjectPath: (raw, value) => ({ ...raw, envProjectPath: value }),
   codexAuthPath: (raw, value) => ({ ...raw, codexAuthPath: value }),
   codexHome: (raw, value) => ({ ...raw, codexHome: value }),
+  dockerNetworkMode: (raw, value) => ({ ...raw, dockerNetworkMode: value }),
+  dockerSharedNetworkName: (raw, value) => ({ ...raw, dockerSharedNetworkName: value }),
   archivePath: (raw, value) => ({ ...raw, archivePath: value }),
   scrapMode: (raw, value) => ({ ...raw, scrapMode: value }),
   label: (raw, value) => ({ ...raw, label: value }),

package/src/docker-git/cli/usage.ts

@@ -3,7 +3,7 @@ import { Match } from "effect"
 import type { ParseError } from "@effect-template/lib/core/domain"
 
 export const usageText = `docker-git menu
-docker-git create --repo-url <url> [options]
+docker-git create [--repo-url <url>] [options]
 docker-git clone <url> [options]
 docker-git apply [<url>] [options]
 docker-git mcp-playwright [<url>] [options]
@@ -20,7 +20,7 @@ docker-git state <action> [options]
 
 Commands:
   menu                Interactive menu (default when no args)
-  create, init        Generate docker development environment
+  create, init        Generate docker development environment (repo URL optional)
   clone               Create + run container and clone repo
   apply               Apply docker-git config to an existing project/container (current dir by default)
   mcp-playwright      Enable Playwright MCP + Chromium sidecar for an existing project dir
@@ -34,6 +34,7 @@ Commands:
   state               Manage docker-git state directory via git (sync across machines)
 
 Options:
+  --repo-url <url>          Repository URL (create: optional; clone: required via positional arg or flag)
   --repo-ref <ref>          Git ref/branch (default: main)
   --branch, -b <ref>        Alias for --repo-ref
   --target-dir <path>       Target dir inside container (create default: /home/dev/app, clone default: ~/workspaces/<org>/<repo>[/issue-<id>|/pr-<id>])
@@ -47,6 +48,8 @@ Options:
   --env-project <path>      Host path to project env file (default: ./.orch/env/project.env)
   --codex-auth <path>       Host path for Codex auth cache (default: <projectsRoot>/.orch/auth/codex)
   --codex-home <path>       Container path for Codex auth (default: /home/dev/.codex)
+  --network-mode <mode>     Compose network mode: shared|project (default: shared)
+  --shared-network <name>   Shared Docker network name when network-mode=shared (default: docker-git-shared)
   --out-dir <path>          Output directory (default: <projectsRoot>/<org>/<repo>[/issue-<id>|/pr-<id>])
   --project-dir <path>      Project directory for attach (default: .)
   --archive <path>          Scrap snapshot directory (default: .orch/scrap/session)

package/src/docker-git/menu-actions.ts

@@ -9,6 +9,7 @@ import {
   listProjectStatus,
   listRunningProjectItems
 } from "@effect-template/lib/usecases/projects"
+import { gcProjectNetworkByTemplate } from "@effect-template/lib/usecases/docker-network-gc"
 import { runDockerComposeUpWithPortCheck } from "@effect-template/lib/usecases/projects-up"
 import { Effect, Match, pipe } from "effect"
 
@@ -149,8 +150,10 @@ const handleMenuAction = (
       withProjectConfig(state, setMessage, () =>
         runDockerComposeLogs(state.activeDir ?? state.cwd))),
     Match.when({ _tag: "Down" }, () =>
-      withProjectConfig(state, setMessage, () =>
-        runDockerComposeDown(state.activeDir ?? state.cwd))),
+      withProjectConfig(state, setMessage, (config) =>
+        runDockerComposeDown(state.activeDir ?? state.cwd).pipe(
+          Effect.zipRight(gcProjectNetworkByTemplate(state.activeDir ?? state.cwd, config.template))
+        ))),
     Match.when({ _tag: "DownAll" }, () =>
       pipe(
         downAllDockerGitProjects,

package/src/docker-git/menu-create.ts

@@ -46,11 +46,16 @@ type CreateReturnContext = CreateContext & {
 }
 
 export const buildCreateArgs = (input: CreateInputs): ReadonlyArray<string> => {
-  const args: Array<string> = ["create", "--repo-url", input.repoUrl]
+  const args: Array<string> = ["create"]
+  if (input.repoUrl.length > 0) {
+    args.push("--repo-url", input.repoUrl)
+  }
   if (input.repoRef.length > 0) {
     args.push("--repo-ref", input.repoRef)
   }
-  args.push("--out-dir", input.outDir)
+  if (input.outDir.length > 0) {
+    args.push("--out-dir", input.outDir)
+  }
   if (!input.runUp) {
     args.push("--no-up")
   }
@@ -106,8 +111,8 @@ export const resolveCreateInputs = (
   values: Partial<CreateInputs>
 ): CreateInputs => {
   const repoUrl = values.repoUrl ?? ""
-  const resolvedRepoRef = repoUrl.length > 0 ? resolveRepoInput(repoUrl).repoRef : undefined
-  const outDir = values.outDir ?? (repoUrl.length > 0 ? resolveDefaultOutDir(cwd, repoUrl) : "")
+  const resolvedRepoRef = resolveRepoInput(repoUrl).repoRef
+  const outDir = values.outDir ?? resolveDefaultOutDir(cwd, repoUrl)
 
   return {
     repoUrl,
@@ -179,10 +184,6 @@ const applyCreateStep = (input: {
 }): boolean =>
   Match.value(input.step).pipe(
     Match.when("repoUrl", () => {
-      if (input.buffer.length === 0) {
-        input.setMessage("Repo URL is required.")
-        return false
-      }
       input.nextValues.repoUrl = input.buffer
       input.nextValues.outDir = resolveDefaultOutDir(input.cwd, input.buffer)
       return true
@@ -222,11 +223,6 @@ const finalizeCreateFlow = (input: {
   readonly setActiveDir: (dir: string | null) => void
 }) => {
   const inputs = resolveCreateInputs(input.state.cwd, input.nextValues)
-  if (inputs.repoUrl.length === 0) {
-    input.setMessage("Repo URL is required.")
-    return
-  }
-
   const parsed = parseArgs(buildCreateArgs(inputs))
   if (Either.isLeft(parsed)) {
     input.setMessage(formatParseError(parsed.left))

package/src/docker-git/menu-render.ts

@@ -28,7 +28,7 @@ import { createSteps, menuItems } from "./menu-types.js"
 
 export const renderStepLabel = (step: CreateStep, defaults: CreateInputs): string =>
   Match.value(step).pipe(
-    Match.when("repoUrl", () => "Repo URL"),
+    Match.when("repoUrl", () => "Repo URL (optional for empty workspace)"),
     Match.when("repoRef", () => `Repo ref [${defaults.repoRef}]`),
     Match.when("outDir", () => `Output dir [${defaults.outDir}]`),
     Match.when("runUp", () => `Run docker compose up now? [${defaults.runUp ? "Y" : "n"}]`),

package/tests/docker-git/parser-network-options.test.ts

@@ -0,0 +1,47 @@
+import { describe, expect, it } from "@effect/vitest"
+import { Effect, Either } from "effect"
+
+import { parseArgs } from "../../src/docker-git/cli/parser.js"
+
+describe("parseArgs network options", () => {
+  it.effect("parses create network mode options", () =>
+    Effect.sync(() => {
+      const parsed = parseArgs([
+        "create",
+        "--repo-url",
+        "https://github.com/org/repo.git",
+        "--network-mode",
+        "project",
+        "--shared-network",
+        "ignored-shared-network"
+      ])
+      if (Either.isLeft(parsed)) {
+        throw new Error(`unexpected parse error: ${parsed.left._tag}`)
+      }
+      const command = parsed.right
+      if (command._tag !== "Create") {
+        throw new Error("expected Create command")
+      }
+      expect(command.config.dockerNetworkMode).toBe("project")
+      expect(command.config.dockerSharedNetworkName).toBe("ignored-shared-network")
+    }))
+
+  it.effect("fails on invalid network mode", () =>
+    Effect.sync(() => {
+      const command = parseArgs([
+        "create",
+        "--repo-url",
+        "https://github.com/org/repo.git",
+        "--network-mode",
+        "invalid"
+      ])
+      Either.match(command, {
+        onLeft: (error) => {
+          expect(error._tag).toBe("InvalidOption")
+        },
+        onRight: () => {
+          throw new Error("expected parse error")
+        }
+      })
+    }))
+})

package/tests/docker-git/parser.test.ts

@@ -71,6 +71,8 @@ const expectCreateDefaults = (command: CreateCommand) => {
   expect(command.outDir).toBe(".docker-git/org/repo")
   expect(command.runUp).toBe(true)
   expect(command.forceEnv).toBe(false)
+  expect(command.config.dockerNetworkMode).toBe("shared")
+  expect(command.config.dockerSharedNetworkName).toBe("docker-git-shared")
 }
 
 const expandDefaultTargetDir = (path: string): string => expandContainerHome(defaultTemplateConfig.sshUser, path)
@@ -99,7 +101,20 @@ describe("parseArgs", () => {
       expect(command.config.volumeName).toBe("dg-repo-issue-9-home")
     }))
 
-  it.effect("fails on missing repo url", () => expectParseErrorTag(["create"], "MissingRequiredOption"))
+  it.effect("parses create command without repo url into empty workspace defaults", () =>
+    expectCreateCommand(["create"], (command) => {
+      expect(command.config.repoUrl).toBe("")
+      expect(command.config.repoRef).toBe(defaultTemplateConfig.repoRef)
+      expect(command.outDir).toBe(".docker-git/app")
+      expect(command.openSsh).toBe(false)
+      expect(command.waitForClone).toBe(false)
+      expect(command.config.containerName).toBe("dg-app")
+      expect(command.config.serviceName).toBe("dg-app")
+      expect(command.config.volumeName).toBe("dg-app-home")
+      expect(command.config.targetDir).toBe(expandDefaultTargetDir(defaultTemplateConfig.targetDir))
+    }))
+
+  it.effect("fails clone when repo url is missing", () => expectParseErrorTag(["clone"], "MissingRequiredOption"))
 
   it.effect("parses clone command with positional repo url", () =>
     expectCreateCommand(["clone", "https://github.com/org/repo.git"], (command) => {

package/vite.docker-git.config.ts

@@ -0,0 +1,34 @@
+import path from "node:path"
+import { fileURLToPath } from "node:url"
+import { defineConfig } from "vite"
+import tsconfigPaths from "vite-tsconfig-paths"
+
+const __filename = fileURLToPath(import.meta.url)
+const __dirname = path.dirname(__filename)
+
+export default defineConfig({
+  plugins: [tsconfigPaths()],
+  publicDir: false,
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "src"),
+      "@effect-template/lib": path.resolve(__dirname, "../lib/src")
+    }
+  },
+  build: {
+    target: "node20",
+    outDir: "dist",
+    sourcemap: true,
+    ssr: "src/docker-git/main.ts",
+    rollupOptions: {
+      output: {
+        format: "es",
+        entryFileNames: "src/docker-git/main.js",
+        inlineDynamicImports: true
+      }
+    }
+  },
+  ssr: {
+    target: "node"
+  }
+})