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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (71) hide show
  1. package/.package.json.release.bak +4 -3
  2. package/CHANGELOG.md +12 -0
  3. package/README.md +28 -1
  4. package/dist/src/docker-git/main.js +10256 -12
  5. package/dist/src/docker-git/main.js.map +1 -0
  6. package/package.json +3 -4
  7. package/src/docker-git/cli/parser-apply.ts +28 -0
  8. package/src/docker-git/cli/parser-clone.ts +3 -9
  9. package/src/docker-git/cli/parser-options.ts +71 -22
  10. package/src/docker-git/cli/parser.ts +2 -0
  11. package/src/docker-git/cli/usage.ts +11 -3
  12. package/src/docker-git/menu-actions.ts +5 -2
  13. package/src/docker-git/menu-create.ts +9 -13
  14. package/src/docker-git/menu-render.ts +1 -1
  15. package/src/docker-git/program.ts +2 -0
  16. package/tests/docker-git/entrypoint-auth.test.ts +14 -3
  17. package/tests/docker-git/parser-network-options.test.ts +47 -0
  18. package/tests/docker-git/parser.test.ts +105 -18
  19. package/vite.docker-git.config.ts +34 -0
  20. package/dist/main.js +0 -905
  21. package/dist/main.js.map +0 -1
  22. package/dist/src/app/main.js +0 -15
  23. package/dist/src/app/program.js +0 -61
  24. package/dist/src/docker-git/cli/input.js +0 -21
  25. package/dist/src/docker-git/cli/parser-attach.js +0 -19
  26. package/dist/src/docker-git/cli/parser-auth.js +0 -90
  27. package/dist/src/docker-git/cli/parser-clone.js +0 -41
  28. package/dist/src/docker-git/cli/parser-create.js +0 -1
  29. package/dist/src/docker-git/cli/parser-mcp-playwright.js +0 -18
  30. package/dist/src/docker-git/cli/parser-options.js +0 -109
  31. package/dist/src/docker-git/cli/parser-panes.js +0 -19
  32. package/dist/src/docker-git/cli/parser-scrap.js +0 -74
  33. package/dist/src/docker-git/cli/parser-sessions.js +0 -69
  34. package/dist/src/docker-git/cli/parser-shared.js +0 -26
  35. package/dist/src/docker-git/cli/parser-state.js +0 -62
  36. package/dist/src/docker-git/cli/parser.js +0 -46
  37. package/dist/src/docker-git/cli/read-command.js +0 -17
  38. package/dist/src/docker-git/cli/usage.js +0 -108
  39. package/dist/src/docker-git/menu-actions.js +0 -135
  40. package/dist/src/docker-git/menu-auth-data.js +0 -90
  41. package/dist/src/docker-git/menu-auth-helpers.js +0 -20
  42. package/dist/src/docker-git/menu-auth.js +0 -159
  43. package/dist/src/docker-git/menu-buffer-input.js +0 -9
  44. package/dist/src/docker-git/menu-create.js +0 -199
  45. package/dist/src/docker-git/menu-input-handler.js +0 -109
  46. package/dist/src/docker-git/menu-input-utils.js +0 -47
  47. package/dist/src/docker-git/menu-input.js +0 -2
  48. package/dist/src/docker-git/menu-labeled-env.js +0 -33
  49. package/dist/src/docker-git/menu-menu.js +0 -46
  50. package/dist/src/docker-git/menu-project-auth-claude.js +0 -43
  51. package/dist/src/docker-git/menu-project-auth-data.js +0 -165
  52. package/dist/src/docker-git/menu-project-auth.js +0 -124
  53. package/dist/src/docker-git/menu-render-auth.js +0 -45
  54. package/dist/src/docker-git/menu-render-common.js +0 -26
  55. package/dist/src/docker-git/menu-render-layout.js +0 -14
  56. package/dist/src/docker-git/menu-render-project-auth.js +0 -37
  57. package/dist/src/docker-git/menu-render-select.js +0 -129
  58. package/dist/src/docker-git/menu-render.js +0 -137
  59. package/dist/src/docker-git/menu-select-actions.js +0 -66
  60. package/dist/src/docker-git/menu-select-connect.js +0 -6
  61. package/dist/src/docker-git/menu-select-load.js +0 -12
  62. package/dist/src/docker-git/menu-select-order.js +0 -21
  63. package/dist/src/docker-git/menu-select-runtime.js +0 -82
  64. package/dist/src/docker-git/menu-select-view.js +0 -15
  65. package/dist/src/docker-git/menu-select.js +0 -98
  66. package/dist/src/docker-git/menu-shared.js +0 -180
  67. package/dist/src/docker-git/menu-startup.js +0 -57
  68. package/dist/src/docker-git/menu-types.js +0 -21
  69. package/dist/src/docker-git/menu.js +0 -226
  70. package/dist/src/docker-git/program.js +0 -42
  71. package/dist/src/docker-git/tmux.js +0 -176
@@ -1,41 +0,0 @@
1
- import { Either } from "effect";
2
- import { buildCreateCommand, nonEmpty } from "@effect-template/lib/core/command-builders";
3
- import { defaultTemplateConfig, resolveRepoInput } from "@effect-template/lib/core/domain";
4
- import { parseRawOptions } from "./parser-options.js";
5
- import { resolveWorkspaceRepoPath, splitPositionalRepo } from "./parser-shared.js";
6
- const applyCloneDefaults = (raw, rawRepoUrl, resolvedRepo) => {
7
- const repoPath = resolveWorkspaceRepoPath(resolvedRepo);
8
- const sshUser = raw.sshUser?.trim() ?? defaultTemplateConfig.sshUser;
9
- const homeDir = `/home/${sshUser}`;
10
- return {
11
- ...raw,
12
- repoUrl: rawRepoUrl,
13
- outDir: raw.outDir ?? `.docker-git/${repoPath}`,
14
- targetDir: raw.targetDir ?? `${homeDir}/${repoPath}`
15
- };
16
- };
17
- // CHANGE: parse clone command with positional repo url
18
- // WHY: allow "docker-git clone <url>" to build + run a container
19
- // QUOTE(ТЗ): "docker-git clone url"
20
- // REF: user-request-2026-01-27
21
- // SOURCE: n/a
22
- // FORMAT THEOREM: forall argv: parseClone(argv) = cmd -> deterministic(cmd)
23
- // PURITY: CORE
24
- // EFFECT: Effect<Command, ParseError, never>
25
- // INVARIANT: first positional arg is treated as repo url
26
- // COMPLEXITY: O(n) where n = |argv|
27
- export const parseClone = (args) => {
28
- const { positionalRepoUrl, restArgs } = splitPositionalRepo(args);
29
- return Either.gen(function* (_) {
30
- const raw = yield* _(parseRawOptions(restArgs));
31
- const rawRepoUrl = yield* _(nonEmpty("--repo-url", raw.repoUrl ?? positionalRepoUrl));
32
- const resolvedRepo = resolveRepoInput(rawRepoUrl);
33
- const withDefaults = applyCloneDefaults(raw, rawRepoUrl, resolvedRepo);
34
- const withRef = resolvedRepo.repoRef !== undefined && raw.repoRef === undefined
35
- ? { ...withDefaults, repoRef: resolvedRepo.repoRef }
36
- : withDefaults;
37
- const openSsh = raw.openSsh ?? true;
38
- const create = yield* _(buildCreateCommand(withRef));
39
- return { ...create, waitForClone: true, openSsh };
40
- });
41
- };
@@ -1 +0,0 @@
1
- export { buildCreateCommand, nonEmpty } from "@effect-template/lib/core/command-builders";
@@ -1,18 +0,0 @@
1
- import { Either } from "effect";
2
- import {} from "@effect-template/lib/core/domain";
3
- import { parseProjectDirWithOptions } from "./parser-shared.js";
4
- // CHANGE: parse "mcp-playwright" command for existing docker-git projects
5
- // WHY: allow enabling Playwright MCP in an already created container/project dir
6
- // QUOTE(ТЗ): "Добавить возможность поднимать MCP Playrgiht в контейнере который уже создан"
7
- // REF: issue-29
8
- // SOURCE: n/a
9
- // FORMAT THEOREM: forall argv: parseMcpPlaywright(argv) = cmd -> deterministic(cmd)
10
- // PURITY: CORE
11
- // EFFECT: Effect<McpPlaywrightUpCommand, ParseError, never>
12
- // INVARIANT: projectDir is never empty
13
- // COMPLEXITY: O(n) where n = |argv|
14
- export const parseMcpPlaywright = (args) => Either.map(parseProjectDirWithOptions(args), ({ projectDir, raw }) => ({
15
- _tag: "McpPlaywrightUp",
16
- projectDir,
17
- runUp: raw.up ?? true
18
- }));
@@ -1,109 +0,0 @@
1
- import { Either } from "effect";
2
- const valueOptionSpecs = [
3
- { flag: "--repo-url", key: "repoUrl" },
4
- { flag: "--repo-ref", key: "repoRef" },
5
- { flag: "--branch", key: "repoRef" },
6
- { flag: "-b", key: "repoRef" },
7
- { flag: "--target-dir", key: "targetDir" },
8
- { flag: "--ssh-port", key: "sshPort" },
9
- { flag: "--ssh-user", key: "sshUser" },
10
- { flag: "--container-name", key: "containerName" },
11
- { flag: "--service-name", key: "serviceName" },
12
- { flag: "--volume-name", key: "volumeName" },
13
- { flag: "--secrets-root", key: "secretsRoot" },
14
- { flag: "--authorized-keys", key: "authorizedKeysPath" },
15
- { flag: "--env-global", key: "envGlobalPath" },
16
- { flag: "--env-project", key: "envProjectPath" },
17
- { flag: "--codex-auth", key: "codexAuthPath" },
18
- { flag: "--codex-home", key: "codexHome" },
19
- { flag: "--archive", key: "archivePath" },
20
- { flag: "--mode", key: "scrapMode" },
21
- { flag: "--label", key: "label" },
22
- { flag: "--token", key: "token" },
23
- { flag: "--scopes", key: "scopes" },
24
- { flag: "--message", key: "message" },
25
- { flag: "-m", key: "message" },
26
- { flag: "--out-dir", key: "outDir" },
27
- { flag: "--project-dir", key: "projectDir" },
28
- { flag: "--lines", key: "lines" }
29
- ];
30
- const valueOptionSpecByFlag = new Map(valueOptionSpecs.map((spec) => [spec.flag, spec]));
31
- const booleanFlagUpdaters = {
32
- "--up": (raw) => ({ ...raw, up: true }),
33
- "--no-up": (raw) => ({ ...raw, up: false }),
34
- "--ssh": (raw) => ({ ...raw, openSsh: true }),
35
- "--no-ssh": (raw) => ({ ...raw, openSsh: false }),
36
- "--force": (raw) => ({ ...raw, force: true }),
37
- "--force-env": (raw) => ({ ...raw, forceEnv: true }),
38
- "--mcp-playwright": (raw) => ({ ...raw, enableMcpPlaywright: true }),
39
- "--no-mcp-playwright": (raw) => ({ ...raw, enableMcpPlaywright: false }),
40
- "--wipe": (raw) => ({ ...raw, wipe: true }),
41
- "--no-wipe": (raw) => ({ ...raw, wipe: false }),
42
- "--web": (raw) => ({ ...raw, authWeb: true }),
43
- "--include-default": (raw) => ({ ...raw, includeDefault: true })
44
- };
45
- const valueFlagUpdaters = {
46
- repoUrl: (raw, value) => ({ ...raw, repoUrl: value }),
47
- repoRef: (raw, value) => ({ ...raw, repoRef: value }),
48
- targetDir: (raw, value) => ({ ...raw, targetDir: value }),
49
- sshPort: (raw, value) => ({ ...raw, sshPort: value }),
50
- sshUser: (raw, value) => ({ ...raw, sshUser: value }),
51
- containerName: (raw, value) => ({ ...raw, containerName: value }),
52
- serviceName: (raw, value) => ({ ...raw, serviceName: value }),
53
- volumeName: (raw, value) => ({ ...raw, volumeName: value }),
54
- secretsRoot: (raw, value) => ({ ...raw, secretsRoot: value }),
55
- authorizedKeysPath: (raw, value) => ({ ...raw, authorizedKeysPath: value }),
56
- envGlobalPath: (raw, value) => ({ ...raw, envGlobalPath: value }),
57
- envProjectPath: (raw, value) => ({ ...raw, envProjectPath: value }),
58
- codexAuthPath: (raw, value) => ({ ...raw, codexAuthPath: value }),
59
- codexHome: (raw, value) => ({ ...raw, codexHome: value }),
60
- archivePath: (raw, value) => ({ ...raw, archivePath: value }),
61
- scrapMode: (raw, value) => ({ ...raw, scrapMode: value }),
62
- label: (raw, value) => ({ ...raw, label: value }),
63
- token: (raw, value) => ({ ...raw, token: value }),
64
- scopes: (raw, value) => ({ ...raw, scopes: value }),
65
- message: (raw, value) => ({ ...raw, message: value }),
66
- outDir: (raw, value) => ({ ...raw, outDir: value }),
67
- projectDir: (raw, value) => ({ ...raw, projectDir: value }),
68
- lines: (raw, value) => ({ ...raw, lines: value })
69
- };
70
- export const applyCommandBooleanFlag = (raw, token) => {
71
- const updater = booleanFlagUpdaters[token];
72
- return updater ? updater(raw) : null;
73
- };
74
- export const applyCommandValueFlag = (raw, token, value) => {
75
- const valueSpec = valueOptionSpecByFlag.get(token);
76
- if (valueSpec === undefined) {
77
- return Either.left({ _tag: "UnknownOption", option: token });
78
- }
79
- const update = valueFlagUpdaters[valueSpec.key];
80
- return Either.right(update(raw, value));
81
- };
82
- export const parseRawOptions = (args) => {
83
- let index = 0;
84
- let raw = {};
85
- while (index < args.length) {
86
- const token = args[index] ?? "";
87
- const booleanApplied = applyCommandBooleanFlag(raw, token);
88
- if (booleanApplied !== null) {
89
- raw = booleanApplied;
90
- index += 1;
91
- continue;
92
- }
93
- if (!token.startsWith("-")) {
94
- return Either.left({ _tag: "UnexpectedArgument", value: token });
95
- }
96
- const value = args[index + 1];
97
- if (value === undefined) {
98
- return Either.left({ _tag: "MissingOptionValue", option: token });
99
- }
100
- const nextRaw = applyCommandValueFlag(raw, token, value);
101
- if (Either.isLeft(nextRaw)) {
102
- return Either.left(nextRaw.left);
103
- }
104
- raw = nextRaw.right;
105
- index += 2;
106
- }
107
- return Either.right(raw);
108
- };
109
- export {} from "@effect-template/lib/core/command-options";
@@ -1,19 +0,0 @@
1
- import { Either } from "effect";
2
- import {} from "@effect-template/lib/core/domain";
3
- import { parseProjectDirArgs } from "./parser-shared.js";
4
- // CHANGE: parse panes command into a project selection
5
- // WHY: allow listing tmux panes without attaching
6
- // QUOTE(ТЗ): "покажи команду ... отобразит терминалы"
7
- // REF: user-request-2026-02-02-panes
8
- // SOURCE: n/a
9
- // FORMAT THEOREM: forall argv: parsePanes(argv) = cmd -> deterministic(cmd)
10
- // PURITY: CORE
11
- // EFFECT: Effect<PanesCommand, ParseError, never>
12
- // INVARIANT: projectDir is never empty
13
- // COMPLEXITY: O(n) where n = |argv|
14
- export const parsePanes = (args) => {
15
- return Either.map(parseProjectDirArgs(args), ({ projectDir }) => ({
16
- _tag: "Panes",
17
- projectDir
18
- }));
19
- };
@@ -1,74 +0,0 @@
1
- import { Either, Match } from "effect";
2
- import { parseProjectDirWithOptions } from "./parser-shared.js";
3
- const missingRequired = (option) => ({
4
- _tag: "MissingRequiredOption",
5
- option
6
- });
7
- const invalidScrapAction = (value) => ({
8
- _tag: "InvalidOption",
9
- option: "scrap",
10
- reason: `unknown action: ${value}`
11
- });
12
- const defaultSessionArchiveDir = ".orch/scrap/session";
13
- const invalidScrapMode = (value) => ({
14
- _tag: "InvalidOption",
15
- option: "--mode",
16
- reason: `unknown value: ${value} (expected session)`
17
- });
18
- const parseScrapMode = (raw) => {
19
- const value = raw?.trim();
20
- if (!value || value.length === 0) {
21
- return Either.right("session");
22
- }
23
- if (value === "session") {
24
- return Either.right("session");
25
- }
26
- if (value === "recipe") {
27
- // Backwards/semantic alias: "recipe" behaves like "session" (git state + rebuildable deps).
28
- return Either.right("session");
29
- }
30
- return Either.left(invalidScrapMode(value));
31
- };
32
- const makeScrapExportCommand = (projectDir, archivePath, mode) => ({
33
- _tag: "ScrapExport",
34
- projectDir,
35
- archivePath,
36
- mode
37
- });
38
- const makeScrapImportCommand = (projectDir, archivePath, wipe, mode) => ({
39
- _tag: "ScrapImport",
40
- projectDir,
41
- archivePath,
42
- wipe,
43
- mode
44
- });
45
- // CHANGE: parse scrap session export/import commands
46
- // WHY: store a small reproducible snapshot (git state + secrets) instead of large caches like node_modules
47
- // QUOTE(ТЗ): "не должно быть старого режима где он качает весь шлак типо node_modules"
48
- // REF: user-request-2026-02-15
49
- // SOURCE: n/a
50
- // FORMAT THEOREM: forall argv: parseScrap(argv) = cmd -> deterministic(cmd)
51
- // PURITY: CORE
52
- // EFFECT: Effect<Command, ParseError, never>
53
- // INVARIANT: export/import always resolves a projectDir
54
- // COMPLEXITY: O(n) where n = |argv|
55
- export const parseScrap = (args) => {
56
- const action = args[0]?.trim();
57
- if (!action || action.length === 0) {
58
- return Either.left(missingRequired("scrap <action>"));
59
- }
60
- const rest = args.slice(1);
61
- return Match.value(action).pipe(Match.when("export", () => Either.flatMap(parseProjectDirWithOptions(rest), ({ projectDir, raw }) => Either.map(parseScrapMode(raw.scrapMode), (mode) => {
62
- const archivePathRaw = raw.archivePath?.trim();
63
- if (archivePathRaw && archivePathRaw.length > 0) {
64
- return makeScrapExportCommand(projectDir, archivePathRaw, mode);
65
- }
66
- return makeScrapExportCommand(projectDir, defaultSessionArchiveDir, mode);
67
- }))), Match.when("import", () => Either.flatMap(parseProjectDirWithOptions(rest), ({ projectDir, raw }) => {
68
- const archivePath = raw.archivePath?.trim();
69
- if (!archivePath || archivePath.length === 0) {
70
- return Either.left(missingRequired("--archive"));
71
- }
72
- return Either.map(parseScrapMode(raw.scrapMode), (mode) => makeScrapImportCommand(projectDir, archivePath, raw.wipe ?? true, mode));
73
- })), Match.orElse(() => Either.left(invalidScrapAction(action))));
74
- };
@@ -1,69 +0,0 @@
1
- import { Either, Match } from "effect";
2
- import {} from "@effect-template/lib/core/domain";
3
- import { parseProjectDirWithOptions } from "./parser-shared.js";
4
- const defaultLines = 200;
5
- const parsePositiveInt = (option, raw) => {
6
- const value = Number.parseInt(raw, 10);
7
- if (!Number.isFinite(value) || value <= 0) {
8
- const error = {
9
- _tag: "InvalidOption",
10
- option,
11
- reason: "expected positive integer"
12
- };
13
- return Either.left(error);
14
- }
15
- return Either.right(value);
16
- };
17
- const parseList = (args) => Either.map(parseProjectDirWithOptions(args), ({ projectDir, raw }) => ({
18
- _tag: "SessionsList",
19
- projectDir,
20
- includeDefault: raw.includeDefault === true
21
- }));
22
- const parsePidContext = (args) => Either.gen(function* (_) {
23
- const pidRaw = args[0];
24
- if (!pidRaw) {
25
- const error = { _tag: "MissingRequiredOption", option: "pid" };
26
- return yield* _(Either.left(error));
27
- }
28
- const pid = yield* _(parsePositiveInt("pid", pidRaw));
29
- const { projectDir, raw } = yield* _(parseProjectDirWithOptions(args.slice(1)));
30
- return { pid, projectDir, raw };
31
- });
32
- const parseKill = (args) => Either.map(parsePidContext(args), ({ pid, projectDir }) => ({
33
- _tag: "SessionsKill",
34
- projectDir,
35
- pid
36
- }));
37
- const parseLogs = (args) => Either.gen(function* (_) {
38
- const { pid, projectDir, raw } = yield* _(parsePidContext(args));
39
- const lines = raw.lines ? yield* _(parsePositiveInt("--lines", raw.lines)) : defaultLines;
40
- return { _tag: "SessionsLogs", projectDir, pid, lines };
41
- });
42
- // CHANGE: parse sessions command into list/kill/logs actions
43
- // WHY: surface container terminal sessions and background processes from CLI
44
- // QUOTE(ТЗ): "CLI команду которая из докера вернёт запущенные терминал сессии"
45
- // REF: user-request-2026-02-04-terminal-sessions
46
- // SOURCE: n/a
47
- // FORMAT THEOREM: forall argv: parseSessions(argv) = cmd -> deterministic(cmd)
48
- // PURITY: CORE
49
- // EFFECT: Effect<SessionsCommand, ParseError, never>
50
- // INVARIANT: pid/lines must be positive integers
51
- // COMPLEXITY: O(n) where n = |argv|
52
- export const parseSessions = (args) => {
53
- if (args.length === 0) {
54
- return parseList(args);
55
- }
56
- const first = args[0] ?? "";
57
- if (first.startsWith("-")) {
58
- return parseList(args);
59
- }
60
- const rest = args.slice(1);
61
- return Match.value(first).pipe(Match.when("list", () => parseList(rest)), Match.when("kill", () => parseKill(rest)), Match.when("stop", () => parseKill(rest)), Match.when("logs", () => parseLogs(rest)), Match.when("log", () => parseLogs(rest)), Match.orElse(() => {
62
- const error = {
63
- _tag: "InvalidOption",
64
- option: "sessions",
65
- reason: `unknown action ${first}`
66
- };
67
- return Either.left(error);
68
- }));
69
- };
@@ -1,26 +0,0 @@
1
- import { Either } from "effect";
2
- import { deriveRepoPathParts, resolveRepoInput } from "@effect-template/lib/core/domain";
3
- import { parseRawOptions } from "./parser-options.js";
4
- export const resolveWorkspaceRepoPath = (resolvedRepo) => {
5
- const baseParts = deriveRepoPathParts(resolvedRepo.repoUrl).pathParts;
6
- const projectParts = resolvedRepo.workspaceSuffix ? [...baseParts, resolvedRepo.workspaceSuffix] : baseParts;
7
- return projectParts.join("/");
8
- };
9
- export const splitPositionalRepo = (args) => {
10
- const first = args[0];
11
- const positionalRepoUrl = first !== undefined && !first.startsWith("-") ? first : undefined;
12
- const restArgs = positionalRepoUrl ? args.slice(1) : args;
13
- return { positionalRepoUrl, restArgs };
14
- };
15
- export const parseProjectDirWithOptions = (args, defaultProjectDir = ".") => Either.gen(function* (_) {
16
- const { positionalRepoUrl, restArgs } = splitPositionalRepo(args);
17
- const raw = yield* _(parseRawOptions(restArgs));
18
- const rawRepoUrl = raw.repoUrl ?? positionalRepoUrl;
19
- const repoPath = rawRepoUrl ? resolveWorkspaceRepoPath(resolveRepoInput(rawRepoUrl)) : null;
20
- const projectDir = raw.projectDir ??
21
- (repoPath
22
- ? `.docker-git/${repoPath}`
23
- : defaultProjectDir);
24
- return { projectDir, raw };
25
- });
26
- export const parseProjectDirArgs = (args, defaultProjectDir = ".") => Either.map(parseProjectDirWithOptions(args, defaultProjectDir), ({ projectDir }) => ({ projectDir }));
@@ -1,62 +0,0 @@
1
- import { Either, Match } from "effect";
2
- import { parseRawOptions } from "./parser-options.js";
3
- const invalidStateAction = (value) => ({
4
- _tag: "InvalidOption",
5
- option: "state",
6
- reason: `unknown action: ${value}`
7
- });
8
- const unexpectedArgs = (value) => Either.left({ _tag: "UnexpectedArgument", value });
9
- const parseStateInit = (args) => Either.flatMap(parseRawOptions(args), (raw) => {
10
- const repoUrl = raw.repoUrl?.trim();
11
- if (!repoUrl || repoUrl.length === 0) {
12
- return Either.left({ _tag: "MissingRequiredOption", option: "--repo-url" });
13
- }
14
- return Either.right({
15
- _tag: "StateInit",
16
- repoUrl,
17
- repoRef: raw.repoRef?.trim() && raw.repoRef.trim().length > 0 ? raw.repoRef.trim() : "main"
18
- });
19
- });
20
- const parseStateCommit = (args) => Either.flatMap(parseRawOptions(args), (raw) => {
21
- const message = raw.message?.trim();
22
- if (!message || message.length === 0) {
23
- return Either.left({ _tag: "MissingRequiredOption", option: "--message" });
24
- }
25
- return Either.right({ _tag: "StateCommit", message });
26
- });
27
- const parseStateSync = (args) => Either.map(parseRawOptions(args), (raw) => {
28
- const message = raw.message?.trim();
29
- return { _tag: "StateSync", message: message && message.length > 0 ? message : null };
30
- });
31
- export const parseState = (args) => {
32
- const action = args[0]?.trim();
33
- if (!action || action.length === 0) {
34
- return Either.left({ _tag: "MissingRequiredOption", option: "state <action>" });
35
- }
36
- const rest = args.slice(1);
37
- return Match.value(action).pipe(Match.when("path", () => {
38
- if (rest.length > 0) {
39
- return unexpectedArgs(rest[0] ?? "");
40
- }
41
- const command = { _tag: "StatePath" };
42
- return Either.right(command);
43
- }), Match.when("init", () => parseStateInit(rest)), Match.when("pull", () => {
44
- if (rest.length > 0) {
45
- return unexpectedArgs(rest[0] ?? "");
46
- }
47
- const command = { _tag: "StatePull" };
48
- return Either.right(command);
49
- }), Match.when("push", () => {
50
- if (rest.length > 0) {
51
- return unexpectedArgs(rest[0] ?? "");
52
- }
53
- const command = { _tag: "StatePush" };
54
- return Either.right(command);
55
- }), Match.when("status", () => {
56
- if (rest.length > 0) {
57
- return unexpectedArgs(rest[0] ?? "");
58
- }
59
- const command = { _tag: "StateStatus" };
60
- return Either.right(command);
61
- }), Match.when("commit", () => parseStateCommit(rest)), Match.when("sync", () => parseStateSync(rest)), Match.orElse(() => Either.left(invalidStateAction(action))));
62
- };
@@ -1,46 +0,0 @@
1
- import { Either, Match } from "effect";
2
- import {} from "@effect-template/lib/core/domain";
3
- import { parseAttach } from "./parser-attach.js";
4
- import { parseAuth } from "./parser-auth.js";
5
- import { parseClone } from "./parser-clone.js";
6
- import { buildCreateCommand } from "./parser-create.js";
7
- import { parseMcpPlaywright } from "./parser-mcp-playwright.js";
8
- import { parseRawOptions } from "./parser-options.js";
9
- import { parsePanes } from "./parser-panes.js";
10
- import { parseScrap } from "./parser-scrap.js";
11
- import { parseSessions } from "./parser-sessions.js";
12
- import { parseState } from "./parser-state.js";
13
- import { usageText } from "./usage.js";
14
- const isHelpFlag = (token) => token === "--help" || token === "-h";
15
- const helpCommand = { _tag: "Help", message: usageText };
16
- const menuCommand = { _tag: "Menu" };
17
- const statusCommand = { _tag: "Status" };
18
- const downAllCommand = { _tag: "DownAll" };
19
- const parseCreate = (args) => Either.flatMap(parseRawOptions(args), (raw) => buildCreateCommand(raw));
20
- // CHANGE: parse CLI arguments into a typed command
21
- // WHY: enforce deterministic, pure parsing before any effects run
22
- // QUOTE(ТЗ): "Надо написать CLI команду с помощью которой мы будем создавать докер образы"
23
- // REF: user-request-2026-01-07
24
- // SOURCE: n/a
25
- // FORMAT THEOREM: forall argv: parse(argv) = cmd -> deterministic(cmd)
26
- // PURITY: CORE
27
- // EFFECT: Effect<Command, ParseError, never>
28
- // INVARIANT: parse does not perform IO and returns the same result for same argv
29
- // COMPLEXITY: O(n) where n = |argv|
30
- export const parseArgs = (args) => {
31
- if (args.length === 0) {
32
- return Either.right(menuCommand);
33
- }
34
- if (args.some((arg) => isHelpFlag(arg))) {
35
- return Either.right(helpCommand);
36
- }
37
- const command = args[0];
38
- const rest = args.slice(1);
39
- const unknownCommandError = {
40
- _tag: "UnknownCommand",
41
- command: command ?? ""
42
- };
43
- return Match.value(command)
44
- .pipe(Match.when("create", () => parseCreate(rest)), Match.when("init", () => parseCreate(rest)), Match.when("clone", () => parseClone(rest)), Match.when("attach", () => parseAttach(rest)), Match.when("tmux", () => parseAttach(rest)), Match.when("panes", () => parsePanes(rest)), Match.when("terms", () => parsePanes(rest)), Match.when("terminals", () => parsePanes(rest)), Match.when("sessions", () => parseSessions(rest)), Match.when("scrap", () => parseScrap(rest)), Match.when("mcp-playwright", () => parseMcpPlaywright(rest)), Match.when("help", () => Either.right(helpCommand)), Match.when("ps", () => Either.right(statusCommand)), Match.when("status", () => Either.right(statusCommand)), Match.when("down-all", () => Either.right(downAllCommand)), Match.when("stop-all", () => Either.right(downAllCommand)), Match.when("kill-all", () => Either.right(downAllCommand)), Match.when("menu", () => Either.right(menuCommand)), Match.when("ui", () => Either.right(menuCommand)), Match.when("auth", () => parseAuth(rest)))
45
- .pipe(Match.when("state", () => parseState(rest)), Match.orElse(() => Either.left(unknownCommandError)));
46
- };
@@ -1,17 +0,0 @@
1
- import { Effect, Either, pipe } from "effect";
2
- import {} from "@effect-template/lib/core/domain";
3
- import { parseArgs } from "./parser.js";
4
- // CHANGE: read and parse CLI arguments from process.argv
5
- // WHY: keep IO at the boundary and delegate parsing to CORE
6
- // QUOTE(ТЗ): "Надо написать CLI команду"
7
- // REF: user-request-2026-01-07
8
- // SOURCE: n/a
9
- // FORMAT THEOREM: forall argv: read(argv) -> parse(argv)
10
- // PURITY: SHELL
11
- // EFFECT: Effect<Command, ParseError, never>
12
- // INVARIANT: errors are typed as ParseError
13
- // COMPLEXITY: O(n) where n = |argv|
14
- export const readCommand = pipe(Effect.sync(() => process.argv.slice(2)), Effect.map((args) => parseArgs(args)), Effect.flatMap((result) => Either.match(result, {
15
- onLeft: (error) => Effect.fail(error),
16
- onRight: (command) => Effect.succeed(command)
17
- })));
@@ -1,108 +0,0 @@
1
- import { Match } from "effect";
2
- export const usageText = `docker-git menu
3
- docker-git create --repo-url <url> [options]
4
- docker-git clone <url> [options]
5
- docker-git mcp-playwright [<url>] [options]
6
- docker-git attach [<url>] [options]
7
- docker-git panes [<url>] [options]
8
- docker-git scrap <action> [<url>] [options]
9
- docker-git sessions [list] [<url>] [options]
10
- docker-git sessions kill <pid> [<url>] [options]
11
- docker-git sessions logs <pid> [<url>] [options]
12
- docker-git ps
13
- docker-git down-all
14
- docker-git auth <provider> <action> [options]
15
- docker-git state <action> [options]
16
-
17
- Commands:
18
- menu Interactive menu (default when no args)
19
- create, init Generate docker development environment
20
- clone Create + run container and clone repo
21
- mcp-playwright Enable Playwright MCP + Chromium sidecar for an existing project dir
22
- attach, tmux Open tmux workspace for a docker-git project
23
- panes, terms List tmux panes for a docker-git project
24
- scrap Export/import project scrap (session snapshot + rebuildable deps)
25
- sessions List/kill/log container terminal processes
26
- ps, status Show docker compose status for all docker-git projects
27
- down-all Stop all docker-git containers (docker compose down)
28
- auth Manage GitHub/Codex/Claude Code auth for docker-git
29
- state Manage docker-git state directory via git (sync across machines)
30
-
31
- Options:
32
- --repo-ref <ref> Git ref/branch (default: main)
33
- --branch, -b <ref> Alias for --repo-ref
34
- --target-dir <path> Target dir inside container (create default: /home/dev/app, clone default: /home/dev/<org>/<repo>[/issue-<id>|/pr-<id>])
35
- --ssh-port <port> Local SSH port (default: 2222)
36
- --ssh-user <user> SSH user inside container (default: dev)
37
- --container-name <name> Docker container name (default: dg-<repo>)
38
- --service-name <name> Compose service name (default: dg-<repo>)
39
- --volume-name <name> Docker volume name (default: dg-<repo>-home)
40
- --authorized-keys <path> Host path to authorized_keys (default: <projectsRoot>/authorized_keys)
41
- --env-global <path> Host path to shared env file (default: <projectsRoot>/.orch/env/global.env)
42
- --env-project <path> Host path to project env file (default: ./.orch/env/project.env)
43
- --codex-auth <path> Host path for Codex auth cache (default: <projectsRoot>/.orch/auth/codex)
44
- --codex-home <path> Container path for Codex auth (default: /home/dev/.codex)
45
- --out-dir <path> Output directory (default: <projectsRoot>/<org>/<repo>[/issue-<id>|/pr-<id>])
46
- --project-dir <path> Project directory for attach (default: .)
47
- --archive <path> Scrap snapshot directory (default: .orch/scrap/session)
48
- --mode <session> Scrap mode (default: session)
49
- --wipe | --no-wipe Wipe workspace before scrap import (default: --wipe)
50
- --lines <n> Tail last N lines for sessions logs (default: 200)
51
- --include-default Show default/system processes in sessions list
52
- --up | --no-up Run docker compose up after init (default: --up)
53
- --ssh | --no-ssh Auto-open SSH after create/clone (default: clone=--ssh, create=--no-ssh)
54
- --mcp-playwright | --no-mcp-playwright Enable Playwright MCP + Chromium sidecar (default: --no-mcp-playwright)
55
- --force Overwrite existing files and wipe compose volumes (docker compose down -v)
56
- --force-env Reset project env defaults only (keep workspace volume/data)
57
- -h, --help Show this help
58
-
59
- Container runtime env (set via .orch/env/project.env):
60
- CODEX_SHARE_AUTH=1|0 Share Codex auth.json across projects (default: 1)
61
- CODEX_AUTO_UPDATE=1|0 Auto-update Codex CLI on container start (default: 1)
62
- DOCKER_GIT_ZSH_AUTOSUGGEST=1|0 Enable zsh-autosuggestions (default: 1)
63
- DOCKER_GIT_ZSH_AUTOSUGGEST_STYLE=... zsh-autosuggestions highlight style (default: fg=8,italic)
64
- DOCKER_GIT_ZSH_AUTOSUGGEST_STRATEGY=... Suggestion sources (default: history completion)
65
- MCP_PLAYWRIGHT_ISOLATED=1|0 Isolated browser contexts (recommended for many Codex; default: 1)
66
- MCP_PLAYWRIGHT_CDP_ENDPOINT=http://... Override CDP endpoint (default: http://dg-<repo>-browser:9223)
67
-
68
- Auth providers:
69
- github, gh GitHub CLI auth (tokens saved to env file)
70
- codex Codex CLI auth (stored under .orch/auth/codex)
71
- claude, cc Claude Code CLI auth (OAuth cache stored under .orch/auth/claude)
72
-
73
- Auth actions:
74
- login Run login flow and store credentials
75
- status Show current auth status
76
- logout Remove stored credentials
77
-
78
- Auth options:
79
- --label <label> Account label (default: default)
80
- --token <token> GitHub token override (login only; useful for non-interactive/CI)
81
- --web Force OAuth web flow (login only; ignores --token)
82
- --scopes <scopes> GitHub scopes (login only, default: repo,workflow,read:org)
83
- --env-global <path> Env file path for GitHub tokens (default: <projectsRoot>/.orch/env/global.env)
84
- --codex-auth <path> Codex auth root path (default: <projectsRoot>/.orch/auth/codex)
85
-
86
- State actions:
87
- state path Print current projects root (default: ~/.docker-git; override via DOCKER_GIT_PROJECTS_ROOT)
88
- state init --repo-url <url> [-b] Init / bind state dir to a git remote (use a private repo)
89
- state status Show git status for the state dir
90
- state pull git pull (state dir)
91
- state commit -m <message> Commit all changes in the state dir
92
- state sync [-m <message>] Commit (if needed) + fetch/rebase + push (state dir); on conflict pushes a PR branch
93
- state push git push (state dir)
94
-
95
- State options:
96
- --message, -m <message> Commit message for state commit
97
- `;
98
- // CHANGE: normalize parse errors into user-facing messages
99
- // WHY: keep formatting deterministic and centralized
100
- // QUOTE(ТЗ): "Надо написать CLI команду"
101
- // REF: user-request-2026-01-07
102
- // SOURCE: n/a
103
- // FORMAT THEOREM: forall e: format(e) = s -> deterministic(s)
104
- // PURITY: CORE
105
- // EFFECT: Effect<string, never, never>
106
- // INVARIANT: each ParseError maps to exactly one message
107
- // COMPLEXITY: O(1)
108
- export const formatParseError = (error) => Match.value(error).pipe(Match.when({ _tag: "UnknownCommand" }, ({ command }) => `Unknown command: ${command}`), Match.when({ _tag: "UnknownOption" }, ({ option }) => `Unknown option: ${option}`), Match.when({ _tag: "MissingOptionValue" }, ({ option }) => `Missing value for option: ${option}`), Match.when({ _tag: "MissingRequiredOption" }, ({ option }) => `Missing required option: ${option}`), Match.when({ _tag: "InvalidOption" }, ({ option, reason }) => `Invalid option ${option}: ${reason}`), Match.when({ _tag: "UnexpectedArgument" }, ({ value }) => `Unexpected argument: ${value}`), Match.exhaustive);