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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prover-coder-ai/docker-git",
-  "version": "1.0.22",
+  "version": "1.0.23",
   "description": "Minimal Vite-powered TypeScript console starter using Effect",
   "main": "dist/src/docker-git/main.js",
   "bin": {
@@ -50,6 +50,7 @@
     "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",

package/src/app/program.ts

@@ -1,17 +1,17 @@
-import { listProjects, readCloneRequest, runDockerGitClone } from "@effect-template/lib"
+import { listProjects, readCloneRequest, runDockerGitClone, runDockerGitOpen } from "@effect-template/lib"
 import { Console, Effect, Match, pipe } from "effect"
 
 /**
  * Compose the CLI program as a single effect.
  *
- * @returns Effect that either runs docker-git clone or prints usage.
+ * @returns Effect that either runs docker-git clone/open or prints usage.
  *
- * @pure false - uses Console output and spawns commands when cloning
+ * @pure false - uses Console output and spawns commands when running shortcuts
  * @effect Console, CommandExecutor, Path
- * @invariant forall args in Argv: clone(args) -> docker_git_invoked(args)
+ * @invariant forall args in Argv: shortcut(args) -> docker_git_invoked(args)
  * @precondition true
- * @postcondition clone(args) -> docker_git_invoked(args); otherwise usage printed
- * @complexity O(build + clone)
+ * @postcondition shortcut(args) -> docker_git_invoked(args); otherwise usage printed
+ * @complexity O(build + shortcut)
  * @throws Never - all errors are typed in the Effect error channel
  */
 // CHANGE: replace greeting demo with deterministic usage text
@@ -28,32 +28,35 @@ const usageText = [
   "Usage:",
   "  pnpm docker-git",
   "  pnpm clone <repo-url> [ref]",
+  "  pnpm open <repo-url>",
   "  pnpm list",
   "",
   "Notes:",
   "  - docker-git is the interactive TUI.",
-  "  - clone builds + runs docker-git clone for you."
+  "  - clone builds + runs docker-git clone for you.",
+  "  - open builds + runs docker-git open for existing projects."
 ].join("\n")
 
 // PURITY: SHELL
 // EFFECT: Effect<void, never, Console>
 const runHelp = Console.log(usageText)
 
-// CHANGE: route between clone runner and help based on CLI context
-// WHY: allow pnpm run clone <url> while keeping a single entrypoint
-// QUOTE(ТЗ): "pnpm run clone <url>"
+// CHANGE: route between shortcut runners and help based on CLI context
+// WHY: allow pnpm run clone/open <url> while keeping a single entrypoint
+// QUOTE(ТЗ): "Добавить команду open."
 // REF: user-request-2026-01-27
 // SOURCE: n/a
-// FORMAT THEOREM: forall argv: clone(argv) -> docker_git_invoked(argv)
+// FORMAT THEOREM: forall argv: shortcut(argv) -> docker_git_invoked(argv)
 // PURITY: SHELL
 // EFFECT: Effect<void, Error, Console | CommandExecutor | Path>
-// INVARIANT: help is printed when clone is not requested
-// COMPLEXITY: O(build + clone)
+// INVARIANT: help is printed when shortcut is not requested
+// COMPLEXITY: O(build + shortcut)
 const runDockerGit = pipe(
   readCloneRequest,
   Effect.flatMap((request) =>
     Match.value(request).pipe(
       Match.when({ _tag: "Clone" }, ({ args }) => runDockerGitClone(args)),
+      Match.when({ _tag: "Open" }, ({ args }) => runDockerGitOpen(args)),
       Match.when({ _tag: "None" }, () => runHelp),
       Match.exhaustive
     )

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

@@ -75,6 +75,7 @@ export const parseArgs = (args: ReadonlyArray<string>): Either.Either<Command, P
       Match.when("auth", () => parseAuth(rest))
     )
     .pipe(
+      Match.when("open", () => parseAttach(rest)),
       Match.when("apply", () => parseApply(rest)),
       Match.when("state", () => parseState(rest)),
       Match.orElse(() => Either.left(unknownCommandError))

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

@@ -5,6 +5,7 @@ import type { ParseError } from "@effect-template/lib/core/domain"
 export const usageText = `docker-git menu
 docker-git create [--repo-url <url>] [options]
 docker-git clone <url> [options]
+docker-git open [<url>] [options]
 docker-git apply [<url>] [options]
 docker-git mcp-playwright [<url>] [options]
 docker-git attach [<url>] [options]
@@ -22,9 +23,10 @@ Commands:
   menu                Interactive menu (default when no args)
   create, init        Generate docker development environment (repo URL optional)
   clone               Create + run container and clone repo
+  open                Open existing docker-git project workspace
   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
-  attach, tmux        Open tmux workspace for a docker-git project
+  attach, tmux        Alias for open
   panes, terms        List tmux panes for a docker-git project
   scrap               Export/import project scrap (session snapshot + rebuildable deps)
   sessions            List/kill/log container terminal processes
@@ -51,7 +53,7 @@ Options:
   --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: .)
+  --project-dir <path>      Project directory for open/attach (default: .)
   --archive <path>          Scrap snapshot directory (default: .orch/scrap/session)
   --mode <session>          Scrap mode (default: session)
   --git-token <label>       Token label for clone/create (maps to GITHUB_TOKEN__<LABEL>, example: agiens)

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

@@ -0,0 +1,76 @@
+import { expect } from "@effect/vitest"
+import { Effect, Either } from "effect"
+
+import type { Command } from "@effect-template/lib/core/domain"
+import { parseArgs } from "../../src/docker-git/cli/parser.js"
+
+export type CreateCommand = Extract<Command, { _tag: "Create" }>
+type ProjectDirRunUpCommand = Extract<Command, { readonly projectDir: string; readonly runUp: boolean }>
+
+export const expectParseErrorTag = (
+  args: ReadonlyArray<string>,
+  expectedTag: string
+) =>
+  Effect.sync(() => {
+    const parsed = parseArgs(args)
+    Either.match(parsed, {
+      onLeft: (error) => {
+        expect(error._tag).toBe(expectedTag)
+      },
+      onRight: () => {
+        throw new Error("expected parse error")
+      }
+    })
+  })
+
+export const parseOrThrow = (args: ReadonlyArray<string>): Command => {
+  const parsed = parseArgs(args)
+  return Either.match(parsed, {
+    onLeft: (error) => {
+      throw new Error(`unexpected error ${error._tag}`)
+    },
+    onRight: (command) => command
+  })
+}
+
+export const expectProjectDirRunUpCommand = (
+  args: ReadonlyArray<string>,
+  expectedTag: ProjectDirRunUpCommand["_tag"],
+  expectedProjectDir: string,
+  expectedRunUp: boolean
+) =>
+  Effect.sync(() => {
+    const command = parseOrThrow(args)
+    if (command._tag !== expectedTag) {
+      throw new Error(`expected ${expectedTag} command`)
+    }
+    if (!("projectDir" in command) || !("runUp" in command)) {
+      throw new Error("expected command with projectDir and runUp")
+    }
+    expect(command.projectDir).toBe(expectedProjectDir)
+    expect(command.runUp).toBe(expectedRunUp)
+  })
+
+export const expectAttachProjectDirCommand = (
+  args: ReadonlyArray<string>,
+  expectedProjectDir: string
+) =>
+  Effect.sync(() => {
+    const command = parseOrThrow(args)
+    if (command._tag !== "Attach") {
+      throw new Error("expected Attach command")
+    }
+    expect(command.projectDir).toBe(expectedProjectDir)
+  })
+
+export const expectCreateCommand = (
+  args: ReadonlyArray<string>,
+  onRight: (command: CreateCommand) => void
+) =>
+  Effect.sync(() => {
+    const command = parseOrThrow(args)
+    if (command._tag !== "Create") {
+      throw new Error("expected Create command")
+    }
+    onRight(command)
+  })

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

@@ -1,69 +1,16 @@
 import { describe, expect, it } from "@effect/vitest"
-import { Effect, Either } from "effect"
+import { Effect } from "effect"
 
-import { type Command, defaultTemplateConfig } from "@effect-template/lib/core/domain"
+import { defaultTemplateConfig } from "@effect-template/lib/core/domain"
 import { expandContainerHome } from "@effect-template/lib/usecases/scrap-path"
-import { parseArgs } from "../../src/docker-git/cli/parser.js"
-
-type CreateCommand = Extract<Command, { _tag: "Create" }>
-
-const expectParseErrorTag = (
-  args: ReadonlyArray<string>,
-  expectedTag: string
-) =>
-  Effect.sync(() => {
-    const parsed = parseArgs(args)
-    Either.match(parsed, {
-      onLeft: (error) => {
-        expect(error._tag).toBe(expectedTag)
-      },
-      onRight: () => {
-        throw new Error("expected parse error")
-      }
-    })
-  })
-
-const parseOrThrow = (args: ReadonlyArray<string>): Command => {
-  const parsed = parseArgs(args)
-  return Either.match(parsed, {
-    onLeft: (error) => {
-      throw new Error(`unexpected error ${error._tag}`)
-    },
-    onRight: (command) => command
-  })
-}
-
-type ProjectDirRunUpCommand = Extract<Command, { readonly projectDir: string; readonly runUp: boolean }>
-
-const expectProjectDirRunUpCommand = (
-  args: ReadonlyArray<string>,
-  expectedTag: ProjectDirRunUpCommand["_tag"],
-  expectedProjectDir: string,
-  expectedRunUp: boolean
-) =>
-  Effect.sync(() => {
-    const command = parseOrThrow(args)
-    if (command._tag !== expectedTag) {
-      throw new Error(`expected ${expectedTag} command`)
-    }
-    if (!("projectDir" in command) || !("runUp" in command)) {
-      throw new Error("expected command with projectDir and runUp")
-    }
-    expect(command.projectDir).toBe(expectedProjectDir)
-    expect(command.runUp).toBe(expectedRunUp)
-  })
-
-const expectCreateCommand = (
-  args: ReadonlyArray<string>,
-  onRight: (command: CreateCommand) => void
-) =>
-  Effect.sync(() => {
-    const command = parseOrThrow(args)
-    if (command._tag !== "Create") {
-      throw new Error("expected Create command")
-    }
-    onRight(command)
-  })
+import {
+  type CreateCommand,
+  expectAttachProjectDirCommand,
+  expectCreateCommand,
+  expectParseErrorTag,
+  expectProjectDirRunUpCommand,
+  parseOrThrow
+} from "./parser-helpers.js"
 
 const expectCreateDefaults = (command: CreateCommand) => {
   expect(command.config.repoUrl).toBe("https://github.com/org/repo.git")
@@ -209,13 +156,10 @@ describe("parseArgs", () => {
     }))
 
   it.effect("parses attach with GitHub issue url into issue workspace", () =>
-    Effect.sync(() => {
-      const command = parseOrThrow(["attach", "https://github.com/org/repo/issues/7"])
-      if (command._tag !== "Attach") {
-        throw new Error("expected Attach command")
-      }
-      expect(command.projectDir).toBe(".docker-git/org/repo/issue-7")
-    }))
+    expectAttachProjectDirCommand(["attach", "https://github.com/org/repo/issues/7"], ".docker-git/org/repo/issue-7"))
+
+  it.effect("parses open with GitHub issue url into issue workspace", () =>
+    expectAttachProjectDirCommand(["open", "https://github.com/org/repo/issues/7"], ".docker-git/org/repo/issue-7"))
 
   it.effect("parses mcp-playwright command in current directory", () =>
     expectProjectDirRunUpCommand(["mcp-playwright"], "McpPlaywrightUp", ".", true))