@codeledger/harness 0.1.1

package/dist/worktree.js

@@ -0,0 +1,171 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readdirSync, rmSync, symlinkSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { validateGitRef } from '@codeledger/instrument';
+const SAFE_PREFIX = /^[a-zA-Z0-9_-]+$/;
+export function createWorktree(spec) {
+    // Validate inputs — no shell interpolation needed with execFileSync
+    validateGitRef(spec.commit);
+    if (spec.prefix && !SAFE_PREFIX.test(spec.prefix)) {
+        throw new Error(`Invalid worktree prefix: "${spec.prefix}" contains disallowed characters`);
+    }
+    const id = randomUUID().slice(0, 8);
+    const branchName = `codeledger-sandbox-${spec.prefix ?? 'run'}-${id}`;
+    const worktreePath = join(spec.worktreeRoot, branchName);
+    if (!existsSync(spec.worktreeRoot)) {
+        mkdirSync(spec.worktreeRoot, { recursive: true });
+    }
+    // Create detached worktree using argument-array form (no shell)
+    execFileSync('git', ['worktree', 'add', '--detach', worktreePath, '--', spec.commit], {
+        cwd: spec.repoRoot,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    // Provision dependencies based on configured mode
+    const depMode = spec.dependencyMode ?? 'symlink';
+    provisionDependencies(depMode, spec.repoRoot, worktreePath, spec.installCmd);
+    const cleanup = async () => {
+        try {
+            execFileSync('git', ['worktree', 'remove', '--force', worktreePath], {
+                cwd: spec.repoRoot,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+        }
+        catch {
+            // Best effort cleanup
+        }
+    };
+    return {
+        path: worktreePath,
+        branch: branchName,
+        commit: spec.commit,
+        cleanup,
+    };
+}
+function provisionDependencies(mode, repoRoot, worktreePath, installCmd) {
+    if (mode === 'none')
+        return;
+    if (mode === 'install') {
+        const cmd = installCmd ?? (existsSync(join(repoRoot, 'pnpm-lock.yaml')) ? 'pnpm install --frozen-lockfile' : 'npm ci');
+        const [bin, ...args] = cmd.split(' ');
+        execFileSync(bin, args, {
+            cwd: worktreePath,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return;
+    }
+    // Default: symlink
+    mirrorDependencyInstall(repoRoot, worktreePath);
+}
+function mirrorDependencyInstall(repoRoot, worktreePath) {
+    linkDependencyDir(join(repoRoot, 'node_modules'), join(worktreePath, 'node_modules'));
+    const repoPackagesRoot = join(repoRoot, 'packages');
+    const worktreePackagesRoot = join(worktreePath, 'packages');
+    if (!existsSync(repoPackagesRoot))
+        return;
+    for (const entry of readdirSync(repoPackagesRoot, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const name = entry.name;
+        linkDependencyDir(join(repoPackagesRoot, name, 'node_modules'), join(worktreePackagesRoot, name, 'node_modules'));
+    }
+}
+function linkDependencyDir(from, to) {
+    if (!existsSync(from) || existsSync(to))
+        return;
+    try {
+        symlinkSync(from, to, 'junction');
+    }
+    catch {
+        // Non-fatal: acceptance commands may still run if they don't need dependencies.
+    }
+}
+/**
+ * Remove all orphaned codeledger sandbox worktrees.
+ *
+ * 1. Runs `git worktree prune` to clean stale bookkeeping entries.
+ * 2. Lists remaining worktrees via `git worktree list --porcelain`.
+ * 3. Removes any whose path contains `codeledger-sandbox-`.
+ * 4. Deletes leftover sandbox directories under `worktreeRoot` that git
+ *    no longer tracks (e.g. from a hard kill where the entry was never
+ *    registered or was already pruned but the directory survived).
+ *
+ * Returns the number of worktrees removed.
+ */
+export function cleanupAllWorktrees(repoRoot, worktreeRoot) {
+    let removed = 0;
+    // Step 1: prune stale bookkeeping
+    try {
+        execFileSync('git', ['worktree', 'prune'], {
+            cwd: repoRoot,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch {
+        // git worktree prune failure is non-fatal
+    }
+    // Step 2: list registered worktrees and remove codeledger sandboxes
+    const registeredPaths = new Set();
+    try {
+        const listOutput = execFileSync('git', ['worktree', 'list', '--porcelain'], { cwd: repoRoot, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        for (const line of listOutput.split('\n')) {
+            if (!line.startsWith('worktree '))
+                continue;
+            const wtPath = resolve(line.slice('worktree '.length).trim());
+            registeredPaths.add(wtPath);
+            if (!wtPath.includes('codeledger-sandbox-'))
+                continue;
+            try {
+                execFileSync('git', ['worktree', 'remove', '--force', wtPath], {
+                    cwd: repoRoot,
+                    stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                removed++;
+            }
+            catch {
+                // If git remove fails, try manual directory cleanup + re-prune
+                try {
+                    rmSync(wtPath, { recursive: true, force: true });
+                    execFileSync('git', ['worktree', 'prune'], {
+                        cwd: repoRoot,
+                        stdio: ['pipe', 'pipe', 'pipe'],
+                    });
+                    removed++;
+                }
+                catch {
+                    // Best effort
+                }
+            }
+        }
+    }
+    catch {
+        // git worktree list failure — fall through to directory scan
+    }
+    // Step 3: remove leftover sandbox directories that git no longer tracks
+    const root = worktreeRoot ?? join(repoRoot, '.codeledger', 'worktrees');
+    if (existsSync(root)) {
+        try {
+            for (const entry of readdirSync(root, { withFileTypes: true })) {
+                if (!entry.isDirectory())
+                    continue;
+                if (!entry.name.startsWith('codeledger-sandbox-'))
+                    continue;
+                const dirPath = resolve(root, entry.name);
+                if (registeredPaths.has(dirPath))
+                    continue; // already handled above
+                try {
+                    rmSync(dirPath, { recursive: true, force: true });
+                    removed++;
+                }
+                catch {
+                    // Best effort
+                }
+            }
+        }
+        catch {
+            // readdir failure is non-fatal
+        }
+    }
+    return removed;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/worktree.js.map

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

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@codeledger/harness",
+  "version": "0.1.1",
+  "type": "module",
+  "description": "Benchmark execution and A/B comparison for CodeLedger",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codeledgerECF/codeledger-blackbox.git",
+    "directory": "packages/harness"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@codeledger/types": "0.1.1",
+    "@codeledger/core": "0.1.1",
+    "@codeledger/core-engine": "0.1.1",
+    "@codeledger/instrument": "0.1.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}