@pruddiman/hem 0.0.1-beta-5671db0

package/dist/worktree.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Git worktree utilities for the --worktree flag.
+ *
+ * Creates an isolated git worktree under `.hem/worktree/` on a fresh branch,
+ * runs the pipeline there, then commits and pushes the branch for review.
+ *
+ * All functions use execSync (same pattern as changelog.ts).
+ */
+/**
+ * Returns the absolute path to the root of the git repository containing `cwd`.
+ *
+ * @throws If `cwd` is not inside a git repository.
+ */
+export declare function getRepoRoot(cwd: string): string;
+/**
+ * Returns the name of the currently checked-out branch.
+ *
+ * @param repoRoot - Absolute path to the git repository root.
+ * @throws If the repo is in a detached HEAD state or git is unavailable.
+ */
+export declare function getCurrentBranch(repoRoot: string): string;
+/**
+ * Generates a unique worktree branch name based on the current branch and a
+ * timestamp.
+ *
+ * Format: `hem/<sanitized-base>-<YYYYMMDD-HHmmss>`
+ *
+ * The base branch name is sanitized to be a valid git ref component:
+ * slashes and non-alphanumeric characters (except `-`) are replaced with `-`,
+ * and leading/trailing dashes are removed.
+ *
+ * @param baseBranch - The currently checked-out branch name.
+ */
+export declare function generateWorktreeBranch(baseBranch: string): string;
+/**
+ * Ensures `pattern` appears in `<repoRoot>/.gitignore`.
+ *
+ * If the file does not exist it is created. If the pattern is already present
+ * (exact line match) this is a no-op.
+ *
+ * @param repoRoot - Absolute path to the git repository root.
+ * @param pattern  - The gitignore pattern to add (e.g. `.hem/worktree/`).
+ */
+export declare function ensureGitignored(repoRoot: string, pattern: string): Promise<void>;
+/**
+ * Creates a git worktree at `.hem/worktree/` inside `repoRoot` checked out on
+ * a new branch `branchName`.
+ *
+ * If `.hem/worktree/` already exists (from a previous interrupted run), it is
+ * forcibly removed first.
+ *
+ * @param repoRoot   - Absolute path to the git repository root.
+ * @param branchName - New branch name to create (e.g. `hem/main-20260322-143000`).
+ * @returns Absolute path to the created worktree directory.
+ */
+export declare function setupWorktree(repoRoot: string, branchName: string): string;
+/**
+ * Stages all changes in the worktree and creates a commit.
+ *
+ * If there are no changes to commit (clean working tree) this is a no-op.
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @param message      - Commit message.
+ */
+export declare function commitWorktree(worktreePath: string, message: string): void;
+/**
+ * Pushes `branchName` from the worktree to `origin`.
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @param branchName   - Branch to push (e.g. `hem/main-20260322-143000`).
+ */
+export declare function pushWorktree(worktreePath: string, branchName: string): void;
+/**
+ * Removes the worktree at `worktreePath` from the git worktree list and deletes
+ * its directory.
+ *
+ * This is best-effort — errors are swallowed so cleanup never aborts the run.
+ *
+ * @param repoRoot     - Absolute path to the git repository root.
+ * @param worktreePath - Absolute path to the worktree directory.
+ */
+export declare function cleanupWorktree(repoRoot: string, worktreePath: string): void;

package/dist/worktree.js

@@ -0,0 +1,187 @@
+/**
+ * Git worktree utilities for the --worktree flag.
+ *
+ * Creates an isolated git worktree under `.hem/worktree/` on a fresh branch,
+ * runs the pipeline there, then commits and pushes the branch for review.
+ *
+ * All functions use execSync (same pattern as changelog.ts).
+ */
+import { join } from "node:path";
+import { readFile, writeFile } from "node:fs/promises";
+import { execSync } from "node:child_process";
+// ── Repo helpers ───────────────────────────────────────────────────────
+/**
+ * Returns the absolute path to the root of the git repository containing `cwd`.
+ *
+ * @throws If `cwd` is not inside a git repository.
+ */
+export function getRepoRoot(cwd) {
+    return execSync("git rev-parse --show-toplevel", {
+        cwd,
+        encoding: "utf-8",
+        timeout: 5_000,
+    }).trim();
+}
+/**
+ * Returns the name of the currently checked-out branch.
+ *
+ * @param repoRoot - Absolute path to the git repository root.
+ * @throws If the repo is in a detached HEAD state or git is unavailable.
+ */
+export function getCurrentBranch(repoRoot) {
+    return execSync("git rev-parse --abbrev-ref HEAD", {
+        cwd: repoRoot,
+        encoding: "utf-8",
+        timeout: 5_000,
+    }).trim();
+}
+// ── Branch naming ──────────────────────────────────────────────────────
+/**
+ * Generates a unique worktree branch name based on the current branch and a
+ * timestamp.
+ *
+ * Format: `hem/<sanitized-base>-<YYYYMMDD-HHmmss>`
+ *
+ * The base branch name is sanitized to be a valid git ref component:
+ * slashes and non-alphanumeric characters (except `-`) are replaced with `-`,
+ * and leading/trailing dashes are removed.
+ *
+ * @param baseBranch - The currently checked-out branch name.
+ */
+export function generateWorktreeBranch(baseBranch) {
+    const sanitized = baseBranch
+        .replace(/[^a-zA-Z0-9-]/g, "-")
+        .replace(/-+/g, "-")
+        .replace(/^-|-$/g, "");
+    const now = new Date();
+    const pad = (n) => String(n).padStart(2, "0");
+    const datePart = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}`;
+    const timePart = `${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
+    return `hem/${sanitized}-${datePart}-${timePart}`;
+}
+// ── .gitignore ─────────────────────────────────────────────────────────
+/**
+ * Ensures `pattern` appears in `<repoRoot>/.gitignore`.
+ *
+ * If the file does not exist it is created. If the pattern is already present
+ * (exact line match) this is a no-op.
+ *
+ * @param repoRoot - Absolute path to the git repository root.
+ * @param pattern  - The gitignore pattern to add (e.g. `.hem/worktree/`).
+ */
+export async function ensureGitignored(repoRoot, pattern) {
+    const gitignorePath = join(repoRoot, ".gitignore");
+    let content = "";
+    try {
+        content = await readFile(gitignorePath, "utf-8");
+    }
+    catch {
+        // File doesn't exist — will be created below
+    }
+    const lines = content.split("\n");
+    if (lines.some((line) => line.trim() === pattern)) {
+        return; // Already present
+    }
+    const newContent = content.length > 0 && !content.endsWith("\n")
+        ? `${content}\n${pattern}\n`
+        : `${content}${pattern}\n`;
+    await writeFile(gitignorePath, newContent, "utf-8");
+}
+// ── Worktree lifecycle ─────────────────────────────────────────────────
+/**
+ * Creates a git worktree at `.hem/worktree/` inside `repoRoot` checked out on
+ * a new branch `branchName`.
+ *
+ * If `.hem/worktree/` already exists (from a previous interrupted run), it is
+ * forcibly removed first.
+ *
+ * @param repoRoot   - Absolute path to the git repository root.
+ * @param branchName - New branch name to create (e.g. `hem/main-20260322-143000`).
+ * @returns Absolute path to the created worktree directory.
+ */
+export function setupWorktree(repoRoot, branchName) {
+    const worktreePath = join(repoRoot, ".hem", "worktree");
+    // Remove stale worktree if present
+    try {
+        execSync(`git worktree remove "${worktreePath}" --force`, {
+            cwd: repoRoot,
+            encoding: "utf-8",
+            timeout: 15_000,
+            stdio: "pipe",
+        });
+    }
+    catch {
+        // Didn't exist — that's fine
+    }
+    execSync(`git worktree add "${worktreePath}" -b "${branchName}"`, {
+        cwd: repoRoot,
+        encoding: "utf-8",
+        timeout: 30_000,
+    });
+    return worktreePath;
+}
+/**
+ * Stages all changes in the worktree and creates a commit.
+ *
+ * If there are no changes to commit (clean working tree) this is a no-op.
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @param message      - Commit message.
+ */
+export function commitWorktree(worktreePath, message) {
+    // Stage everything
+    execSync("git add -A", {
+        cwd: worktreePath,
+        encoding: "utf-8",
+        timeout: 15_000,
+    });
+    // Check if there's anything to commit
+    const status = execSync("git status --porcelain", {
+        cwd: worktreePath,
+        encoding: "utf-8",
+        timeout: 10_000,
+    }).trim();
+    if (status.length === 0) {
+        return; // Nothing to commit
+    }
+    execSync(`git commit -m "${message.replace(/"/g, '\\"')}"`, {
+        cwd: worktreePath,
+        encoding: "utf-8",
+        timeout: 30_000,
+    });
+}
+/**
+ * Pushes `branchName` from the worktree to `origin`.
+ *
+ * @param worktreePath - Absolute path to the worktree directory.
+ * @param branchName   - Branch to push (e.g. `hem/main-20260322-143000`).
+ */
+export function pushWorktree(worktreePath, branchName) {
+    execSync(`git push origin "${branchName}"`, {
+        cwd: worktreePath,
+        encoding: "utf-8",
+        timeout: 60_000,
+    });
+}
+/**
+ * Removes the worktree at `worktreePath` from the git worktree list and deletes
+ * its directory.
+ *
+ * This is best-effort — errors are swallowed so cleanup never aborts the run.
+ *
+ * @param repoRoot     - Absolute path to the git repository root.
+ * @param worktreePath - Absolute path to the worktree directory.
+ */
+export function cleanupWorktree(repoRoot, worktreePath) {
+    try {
+        execSync(`git worktree remove "${worktreePath}" --force`, {
+            cwd: repoRoot,
+            encoding: "utf-8",
+            timeout: 15_000,
+            stdio: "pipe",
+        });
+    }
+    catch {
+        // Best-effort — ignore errors
+    }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@pruddiman/hem",
+  "version": "0.0.1-beta-5671db0",
+  "type": "module",
+  "bin": {
+    "hem": "./dist/index.js"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "tsc && node ./dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "publish:beta": "node scripts/publish-beta.mjs"
+  },
+  "dependencies": {
+    "@github/copilot-sdk": "^0.2.2",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "@opencode-ai/sdk": "^1.14.19",
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "fast-glob": "^3.3.3",
+    "ink": "^6.7.0",
+    "ink-spinner": "^5.0.0",
+    "p-limit": "^7.3.0",
+    "react": "^19.2.4",
+    "vectra": "^0.12.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.2.3",
+    "@types/react": "^19.2.14",
+    "@vitest/coverage-v8": "^4.0.18",
+    "ink-testing-library": "^4.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}