git-codex 0.1.0

package/dist/lib/fs-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-utils.js","sourceRoot":"","sources":["../../src/lib/fs-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/lib/git.d.ts

@@ -0,0 +1,20 @@
+export declare function runGitCapture(args: string[], cwd: string): Promise<string>;
+export declare function runGitStream(args: string[], cwd: string): Promise<void>;
+export interface RunGitStreamOptions {
+    quiet?: boolean;
+}
+export declare function runGitStreamWithOptions(args: string[], cwd: string, options: RunGitStreamOptions): Promise<void>;
+export interface GitStatusResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}
+export declare function runGitStatus(args: string[], cwd: string): Promise<GitStatusResult>;
+export declare function doesLocalBranchExist(cwd: string, branchName: string): Promise<boolean>;
+export declare function doesRemoteBranchExist(cwd: string, branchName: string, remote?: string): Promise<boolean>;
+export interface RemoteBranchState {
+    trackingRefExists: boolean;
+    exists: boolean;
+}
+export declare function getRemoteBranchState(cwd: string, branchName: string, remote?: string): Promise<RemoteBranchState>;
+export declare function fetchRemoteTrackingBranch(cwd: string, branchName: string, remote: string, options: RunGitStreamOptions): Promise<void>;

package/dist/lib/git.js

@@ -0,0 +1,82 @@
+import { execa } from "execa";
+export async function runGitCapture(args, cwd) {
+    const result = await execa("git", args, { cwd });
+    return result.stdout.trimEnd();
+}
+export async function runGitStream(args, cwd) {
+    await runGitStreamWithOptions(args, cwd, {
+        quiet: false,
+    });
+}
+export async function runGitStreamWithOptions(args, cwd, options) {
+    if (options.quiet) {
+        const result = await execa("git", args, {
+            cwd,
+            reject: false,
+        });
+        if (result.exitCode === 0) {
+            return;
+        }
+        const detail = [result.stderr, result.stdout]
+            .filter(Boolean)
+            .join("\n")
+            .trim();
+        throw new Error(detail
+            ? `Command failed: git ${args.join(" ")}\n${detail}`
+            : `Command failed: git ${args.join(" ")}`);
+    }
+    await execa("git", args, {
+        cwd,
+        stdio: "inherit",
+    });
+}
+export async function runGitStatus(args, cwd) {
+    const result = await execa("git", args, {
+        cwd,
+        reject: false,
+    });
+    return {
+        exitCode: result.exitCode ?? -1,
+        stdout: result.stdout,
+        stderr: result.stderr,
+    };
+}
+export async function doesLocalBranchExist(cwd, branchName) {
+    const result = await execa("git", ["show-ref", "--verify", "--quiet", `refs/heads/${branchName}`], {
+        cwd,
+        reject: false,
+    });
+    return result.exitCode === 0;
+}
+export async function doesRemoteBranchExist(cwd, branchName, remote = "origin") {
+    const state = await getRemoteBranchState(cwd, branchName, remote);
+    return state.exists;
+}
+export async function getRemoteBranchState(cwd, branchName, remote = "origin") {
+    const localRefResult = await execa("git", ["show-ref", "--verify", "--quiet", `refs/remotes/${remote}/${branchName}`], {
+        cwd,
+        reject: false,
+    });
+    if (localRefResult.exitCode === 0) {
+        return {
+            trackingRefExists: true,
+            exists: true,
+        };
+    }
+    const remoteResult = await execa("git", ["ls-remote", "--exit-code", "--heads", remote, branchName], {
+        cwd,
+        reject: false,
+    });
+    return {
+        trackingRefExists: false,
+        exists: remoteResult.exitCode === 0,
+    };
+}
+export async function fetchRemoteTrackingBranch(cwd, branchName, remote, options) {
+    await runGitStreamWithOptions([
+        "fetch",
+        remote,
+        `+refs/heads/${branchName}:refs/remotes/${remote}/${branchName}`,
+    ], cwd, options);
+}
+//# sourceMappingURL=git.js.map

package/dist/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/lib/git.ts"],"names":[],"mappings":"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"}

package/dist/lib/output.d.ts

@@ -0,0 +1,18 @@
+export interface OutputOptions {
+    quiet?: boolean;
+    json?: boolean;
+}
+export interface OutputSink {
+    stdout: (chunk: string) => void;
+    stderr: (chunk: string) => void;
+}
+export interface Output {
+    quiet: boolean;
+    json: boolean;
+    info: (message: string, fields?: Record<string, unknown>) => void;
+    warn: (message: string, fields?: Record<string, unknown>) => void;
+    error: (message: string, fields?: Record<string, unknown>) => void;
+    print: (message: string) => void;
+    event: (event: string, fields?: Record<string, unknown>) => void;
+}
+export declare function createOutput(options?: OutputOptions, sink?: OutputSink): Output;

package/dist/lib/output.js

@@ -0,0 +1,78 @@
+const defaultSink = {
+    stdout: (chunk) => {
+        process.stdout.write(chunk);
+    },
+    stderr: (chunk) => {
+        process.stderr.write(chunk);
+    },
+};
+export function createOutput(options = {}, sink = defaultSink) {
+    const json = Boolean(options.json);
+    const quiet = json ? false : Boolean(options.quiet);
+    const writeStructured = (channel, payload) => {
+        sink[channel](`${JSON.stringify(payload)}\n`);
+    };
+    const writeText = (channel, message) => {
+        sink[channel](`${message}\n`);
+    };
+    const log = (level, message, fields) => {
+        const alwaysEmit = level === "error";
+        if (!alwaysEmit && quiet) {
+            return;
+        }
+        if (json) {
+            writeStructured(level === "error" ? "stderr" : "stdout", {
+                level,
+                message,
+                ...(fields ?? {}),
+            });
+            return;
+        }
+        writeText(level === "error" ? "stderr" : "stdout", message);
+    };
+    return {
+        quiet,
+        json,
+        info(message, fields) {
+            log("info", message, fields);
+        },
+        warn(message, fields) {
+            log("warn", message, fields);
+        },
+        error(message, fields) {
+            log("error", message, fields);
+        },
+        print(message) {
+            if (quiet) {
+                return;
+            }
+            if (json) {
+                writeStructured("stdout", {
+                    level: "info",
+                    message,
+                });
+                return;
+            }
+            writeText("stdout", message);
+        },
+        event(event, fields) {
+            if (quiet && !json) {
+                return;
+            }
+            if (json) {
+                writeStructured("stdout", {
+                    event,
+                    ...(fields ?? {}),
+                });
+                return;
+            }
+            if (fields && Object.keys(fields).length > 0) {
+                writeText("stdout", `${event}: ${JSON.stringify(fields)}`);
+            }
+            else {
+                writeText("stdout", event);
+            }
+        },
+    };
+}
+//# sourceMappingURL=output.js.map

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"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"}

package/dist/lib/prompt.d.ts

@@ -0,0 +1,8 @@
+export interface TaskPromptInput {
+    task: string;
+    taskSlug: string;
+    branch: string;
+    worktreePath: string;
+    message: string;
+}
+export declare function buildTaskPrompt(input: TaskPromptInput): string;

package/dist/lib/prompt.js

@@ -0,0 +1,14 @@
+export function buildTaskPrompt(input) {
+    const normalizedMessage = input.message.trim();
+    const body = normalizedMessage.length > 0 ? normalizedMessage : "(no message)";
+    return [
+        `Task: ${input.task}`,
+        `Task Slug: ${input.taskSlug}`,
+        `Branch: ${input.branch}`,
+        `Worktree: ${input.worktreePath}`,
+        "",
+        "Prompt:",
+        body,
+    ].join("\n");
+}
+//# sourceMappingURL=prompt.js.map

package/dist/lib/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/lib/prompt.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,iBAAiB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,IAAI,GACR,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,cAAc,CAAC;IAEpE,OAAO;QACL,SAAS,KAAK,CAAC,IAAI,EAAE;QACrB,cAAc,KAAK,CAAC,QAAQ,EAAE;QAC9B,WAAW,KAAK,CAAC,MAAM,EAAE;QACzB,aAAa,KAAK,CAAC,YAAY,EAAE;QACjC,EAAE;QACF,SAAS;QACT,IAAI;KACL,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/lib/repo.d.ts

@@ -0,0 +1,8 @@
+export interface RepoContext {
+    repoRoot: string;
+    repoName: string;
+    parentDir: string;
+}
+export declare function resolveRepoContext(cwd?: string): Promise<RepoContext>;
+export declare function resolveWorktreeParentDir(repoRoot: string, dirOverride?: string): string;
+export declare function resolveWorktreePath(repoRoot: string, repoName: string, taskSlug: string, dirOverride?: string): string;

package/dist/lib/repo.js

@@ -0,0 +1,24 @@
+import path from "node:path";
+import { runGitCapture } from "./git.js";
+export async function resolveRepoContext(cwd = process.cwd()) {
+    const repoRootRaw = await runGitCapture(["rev-parse", "--show-toplevel"], cwd);
+    const repoRoot = path.resolve(repoRootRaw.trim());
+    return {
+        repoRoot,
+        repoName: path.basename(repoRoot),
+        parentDir: path.dirname(repoRoot),
+    };
+}
+export function resolveWorktreeParentDir(repoRoot, dirOverride) {
+    if (!dirOverride) {
+        return path.dirname(repoRoot);
+    }
+    return path.isAbsolute(dirOverride)
+        ? path.resolve(dirOverride)
+        : path.resolve(repoRoot, dirOverride);
+}
+export function resolveWorktreePath(repoRoot, repoName, taskSlug, dirOverride) {
+    const parentDir = resolveWorktreeParentDir(repoRoot, dirOverride);
+    return path.resolve(parentDir, `${repoName}-${taskSlug}`);
+}
+//# sourceMappingURL=repo.js.map

package/dist/lib/repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo.js","sourceRoot":"","sources":["../../src/lib/repo.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAQzC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAEnB,MAAM,WAAW,GAAG,MAAM,aAAa,CACrC,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAChC,GAAG,CACJ,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;IAElD,OAAO;QACL,QAAQ;QACR,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACjC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC;KAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,WAAoB;IAEpB,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QAC3B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,QAAgB,EAChB,QAAgB,EAChB,WAAoB;IAEpB,MAAM,SAAS,GAAG,wBAAwB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClE,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC;AAC5D,CAAC"}

package/dist/lib/task-utils.d.ts

@@ -0,0 +1,3 @@
+export declare function toTaskSlug(task: string): string;
+export declare function normalizeBranchPrefix(prefix: string): string;
+export declare function buildBranchName(prefix: string, taskSlug: string): string;

package/dist/lib/task-utils.js

@@ -0,0 +1,24 @@
+const UNSAFE_TASK_CHARACTERS = /[^a-zA-Z0-9._-]+/g;
+export function toTaskSlug(task) {
+    const normalized = task
+        .trim()
+        .toLowerCase()
+        .replace(UNSAFE_TASK_CHARACTERS, "-")
+        .replace(/-+/g, "-")
+        .replace(/^[.-]+|[.-]+$/g, "");
+    if (!normalized) {
+        throw new Error("Task cannot be empty");
+    }
+    return normalized;
+}
+export function normalizeBranchPrefix(prefix) {
+    const trimmed = prefix.trim();
+    if (!trimmed) {
+        return "";
+    }
+    return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
+}
+export function buildBranchName(prefix, taskSlug) {
+    return `${normalizeBranchPrefix(prefix)}${taskSlug}`;
+}
+//# sourceMappingURL=task-utils.js.map

package/dist/lib/task-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-utils.js","sourceRoot":"","sources":["../../src/lib/task-utils.ts"],"names":[],"mappings":"AAAA,MAAM,sBAAsB,GAAG,mBAAmB,CAAC;AAEnD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,UAAU,GAAG,IAAI;SACpB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,sBAAsB,EAAE,GAAG,CAAC;SACpC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,QAAgB;IAC9D,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;AACvD,CAAC"}

package/dist/lib/template.d.ts

@@ -0,0 +1,22 @@
+export type TaskTemplateType = "default" | "bugfix" | "feature";
+export interface TaskTemplateVariables {
+    task: string;
+    taskSlug: string;
+    branch: string;
+    worktreePath: string;
+}
+export interface WriteTaskTemplateOptions {
+    worktreePath: string;
+    variables: TaskTemplateVariables;
+    templateType: TaskTemplateType;
+    templateSource?: string;
+    overwrite: boolean;
+}
+export interface WriteTaskTemplateResult {
+    templatePath: string;
+    created: boolean;
+    overwritten: boolean;
+}
+export declare function normalizeTemplateType(type: string | undefined): TaskTemplateType;
+export declare function renderTaskTemplate(variables: TaskTemplateVariables, templateSource?: string, templateType?: TaskTemplateType): string;
+export declare function writeTaskTemplate(options: WriteTaskTemplateOptions): Promise<WriteTaskTemplateResult>;

package/dist/lib/template.js

@@ -0,0 +1,111 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { pathExists } from "./fs-utils.js";
+const DEFAULT_TASK_TEMPLATE = `# Codex Task Instructions
+
+Task: {{task}}
+Task Slug: {{taskSlug}}
+Branch: {{branch}}
+Worktree: {{worktreePath}}
+
+## Goals
+- Clarify scope and assumptions before coding.
+- Implement the smallest safe change first.
+- Validate with focused tests before completion.
+
+## Notes
+- Capture key decisions and tradeoffs here as you work.
+`;
+const BUGFIX_TASK_TEMPLATE = `# Codex Bugfix Instructions
+
+Task: {{task}}
+Task Slug: {{taskSlug}}
+Branch: {{branch}}
+Worktree: {{worktreePath}}
+
+## Reproduction
+- Document exact failing behavior and where it occurs.
+- Capture error messages, stack traces, and triggering inputs.
+
+## Root Cause
+- Identify the precise source of the bug (not just symptom).
+- Note why existing checks/tests missed it.
+
+## Fix Plan
+- Implement the smallest safe fix at the source.
+- Add regression coverage for this exact failure mode.
+
+## Validation
+- Run focused tests first, then broader suite.
+- Confirm no behavioral regressions in adjacent paths.
+`;
+const FEATURE_TASK_TEMPLATE = `# Codex Feature Instructions
+
+Task: {{task}}
+Task Slug: {{taskSlug}}
+Branch: {{branch}}
+Worktree: {{worktreePath}}
+
+## Feature Scope
+- Define explicit in-scope and out-of-scope behavior.
+- List required interfaces, UX/API changes, and data impacts.
+
+## Implementation Plan
+- Break implementation into small, testable increments.
+- Favor backward-compatible changes when possible.
+
+## Validation
+- Add/extend tests for happy path and edge cases.
+- Verify error handling and observability paths.
+
+## Rollout Notes
+- Document migration, flags, or release sequencing needs.
+`;
+const BUILT_IN_TEMPLATES = {
+    default: DEFAULT_TASK_TEMPLATE,
+    bugfix: BUGFIX_TASK_TEMPLATE,
+    feature: FEATURE_TASK_TEMPLATE,
+};
+export function normalizeTemplateType(type) {
+    const candidate = (type ?? "default").trim().toLowerCase();
+    if (candidate === "default" ||
+        candidate === "bugfix" ||
+        candidate === "feature") {
+        return candidate;
+    }
+    throw new Error(`Invalid template type "${type}". Expected one of: default, bugfix, feature.`);
+}
+export function renderTaskTemplate(variables, templateSource, templateType = "default") {
+    const source = templateSource ?? BUILT_IN_TEMPLATES[templateType];
+    const replacements = {
+        task: variables.task,
+        taskSlug: variables.taskSlug,
+        branch: variables.branch,
+        worktreePath: variables.worktreePath,
+    };
+    return source.replace(/\{\{\s*(task|taskSlug|branch|worktreePath)\s*\}\}/g, (_, key) => {
+        const value = replacements[key];
+        return value ?? "";
+    });
+}
+export async function writeTaskTemplate(options) {
+    const codexDir = path.join(options.worktreePath, ".codex");
+    const templatePath = path.join(codexDir, "INSTRUCTIONS.md");
+    const exists = await pathExists(templatePath);
+    if (exists && !options.overwrite) {
+        return {
+            templatePath,
+            created: false,
+            overwritten: false,
+        };
+    }
+    await mkdir(codexDir, { recursive: true });
+    const rendered = renderTaskTemplate(options.variables, options.templateSource, options.templateType);
+    await writeFile(templatePath, rendered, "utf8");
+    return {
+        templatePath,
+        created: true,
+        overwritten: exists,
+    };
+}
+//# sourceMappingURL=template.js.map

package/dist/lib/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/lib/template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAyB3C,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;CAc7B,CAAC;AAEF,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsB5B,CAAC;AAEF,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqB7B,CAAC;AAEF,MAAM,kBAAkB,GAAqC;IAC3D,OAAO,EAAE,qBAAqB;IAC9B,MAAM,EAAE,oBAAoB;IAC5B,OAAO,EAAE,qBAAqB;CAC/B,CAAC;AAEF,MAAM,UAAU,qBAAqB,CACnC,IAAwB;IAExB,MAAM,SAAS,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE3D,IACE,SAAS,KAAK,SAAS;QACvB,SAAS,KAAK,QAAQ;QACtB,SAAS,KAAK,SAAS,EACvB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CACb,0BAA0B,IAAI,+CAA+C,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,SAAgC,EAChC,cAAuB,EACvB,eAAiC,SAAS;IAE1C,MAAM,MAAM,GAAG,cAAc,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAClE,MAAM,YAAY,GAA2B;QAC3C,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,YAAY,EAAE,SAAS,CAAC,YAAY;KACrC,CAAC;IAEF,OAAO,MAAM,CAAC,OAAO,CACnB,oDAAoD,EACpD,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE;QACT,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAChC,OAAO,KAAK,IAAI,EAAE,CAAC;IACrB,CAAC,CACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC;IAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC;IAC5D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;IAE9C,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACjC,OAAO;YACL,YAAY;YACZ,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;SACnB,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,kBAAkB,CACjC,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,cAAc,EACtB,OAAO,CAAC,YAAY,CACrB,CAAC;IACF,MAAM,SAAS,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAEhD,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,IAAI;QACb,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC"}

package/dist/lib/vscode.d.ts

@@ -0,0 +1 @@
+export declare function openInVSCode(worktreePath: string): Promise<void>;

package/dist/lib/vscode.js

@@ -0,0 +1,8 @@
+import { execa } from "execa";
+export async function openInVSCode(worktreePath) {
+    await execa("code", ["-n", worktreePath], {
+        stdio: "ignore",
+        windowsHide: true,
+    });
+}
+//# sourceMappingURL=vscode.js.map

package/dist/lib/vscode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vscode.js","sourceRoot":"","sources":["../../src/lib/vscode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE9B,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,YAAoB;IACrD,MAAM,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE;QACxC,KAAK,EAAE,QAAQ;QACf,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/worktrees.d.ts

@@ -0,0 +1,11 @@
+export interface WorktreeEntry {
+    worktree: string;
+    head?: string;
+    branch?: string;
+    detached: boolean;
+    bare: boolean;
+    locked: boolean;
+    prunable?: string;
+}
+export declare function parseWorktreeListPorcelain(output: string): WorktreeEntry[];
+export declare function stripHeadsRef(branchRef: string): string;

package/dist/lib/worktrees.js

@@ -0,0 +1,59 @@
+export function parseWorktreeListPorcelain(output) {
+    const entries = [];
+    let current;
+    const pushCurrent = () => {
+        if (current) {
+            entries.push(current);
+            current = undefined;
+        }
+    };
+    for (const line of output.split(/\r?\n/)) {
+        if (!line.trim()) {
+            pushCurrent();
+            continue;
+        }
+        const [rawKey, ...rest] = line.split(" ");
+        const value = rest.join(" ");
+        if (rawKey === "worktree") {
+            pushCurrent();
+            current = {
+                worktree: value,
+                detached: false,
+                bare: false,
+                locked: false,
+            };
+            continue;
+        }
+        if (!current) {
+            continue;
+        }
+        switch (rawKey) {
+            case "HEAD":
+                current.head = value;
+                break;
+            case "branch":
+                current.branch = value;
+                break;
+            case "detached":
+                current.detached = true;
+                break;
+            case "bare":
+                current.bare = true;
+                break;
+            case "locked":
+                current.locked = true;
+                break;
+            case "prunable":
+                current.prunable = value;
+                break;
+            default:
+                break;
+        }
+    }
+    pushCurrent();
+    return entries;
+}
+export function stripHeadsRef(branchRef) {
+    return branchRef.replace(/^refs\/heads\//, "");
+}
+//# sourceMappingURL=worktrees.js.map

package/dist/lib/worktrees.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktrees.js","sourceRoot":"","sources":["../../src/lib/worktrees.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,0BAA0B,CAAC,MAAc;IACvD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,OAAkC,CAAC;IAEvC,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACjB,WAAW,EAAE,CAAC;YACd,SAAS;QACX,CAAC;QAED,MAAM,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,MAAM,KAAK,UAAU,EAAE,CAAC;YAC1B,WAAW,EAAE,CAAC;YACd,OAAO,GAAG;gBACR,QAAQ,EAAE,KAAK;gBACf,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,KAAK;aACd,CAAC;YACF,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS;QACX,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC;gBACrB,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC;gBACvB,MAAM;YACR,KAAK,UAAU;gBACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;gBACxB,MAAM;YACR,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;gBACtB,MAAM;YACR,KAAK,UAAU;gBACb,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACzB,MAAM;YACR;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,WAAW,EAAE,CAAC;IACd,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,SAAS,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "git-codex",
+  "version": "0.1.0",
+  "description": "Git subcommand for task-oriented worktrees and multi-agent parallel workflows.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "codex-wt": "dist/cli.js",
+    "git-codex": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "commander": "^14.0.1",
+    "execa": "^9.6.0",
+    "fast-glob": "^3.3.3"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.29.8",
+    "@types/node": "^24.6.0",
+    "eslint": "^9.39.2",
+    "prettier": "3.8.1",
+    "prettier-plugin-organize-imports": "4.3.0",
+    "prettier-plugin-packagejson": "3.0.0",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "changeset": "changeset",
+    "clean": "node -e \"import('node:fs/promises').then(fs=>fs.rm('dist',{recursive:true,force:true}))\"",
+    "dev": "tsx src/cli.ts",
+    "lint": "eslint \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "pack:dry-run": "pnpm pack --dry-run",
+    "release": "pnpm build && changeset publish",
+    "release:check": "pnpm lint && pnpm typecheck && pnpm test && pnpm build && pnpm pack --dry-run",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "version-packages": "changeset version"
+  }
+}