@proletariat/cli 0.3.105 → 0.3.109

package/dist/lib/workspace-resolution.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Workspace Resolution for Ticketless Work
+ *
+ * Auto-detects the directory type and resolves the appropriate working
+ * directory for an agent. Handles git repos, non-git directories, and
+ * headless (no directory) mode.
+ *
+ * Resolution rules:
+ *   1. Git repo (default)     → create worktree for isolation
+ *   2. Git repo + noWorktree  → work in-place
+ *   3. Non-git directory      → work in-place (auto-detected)
+ *   4. No directory specified  → create temp workspace (headless mode)
+ *   5. --repo URL             → clone into temp dir (handled by caller)
+ *
+ * The caller should not need to specify a mode — this module detects
+ * git vs non-git and does the right thing.
+ */
+export type WorkspaceMode = 'worktree' | 'in-place' | 'headless';
+export interface ResolvedWorkspace {
+    /** Actual directory the agent will work in */
+    workDir: string;
+    /** Original source directory (same as workDir for in-place/headless) */
+    sourceDir: string;
+    /** Whether the directory is inside a git repository */
+    isGitRepo: boolean;
+    /** Current git branch (null if not a git repo) */
+    branch: string | null;
+    /** How the workspace was resolved */
+    mode: WorkspaceMode;
+    /** Whether the workspace is a temporary directory (should be cleaned up) */
+    isTemp: boolean;
+}
+/**
+ * Check if a directory is inside a git repository.
+ */
+export declare function isGitRepo(dir: string): boolean;
+/**
+ * Get the git root directory for a path.
+ */
+export declare function getGitRoot(dir: string): string | null;
+/**
+ * Get the current git branch.
+ */
+export declare function getCurrentBranch(dir: string): string | null;
+/**
+ * Create a git worktree for isolated agent work.
+ * Returns the path to the new worktree directory.
+ */
+export declare function createWorktree(repoDir: string, agentName: string): string;
+/**
+ * Create a temporary workspace directory for headless work.
+ * Used when no --dir or --repo is specified (research, thinking, non-code tasks).
+ */
+export declare function createTempWorkspace(agentName: string): string;
+/**
+ * Resolve the workspace for a ticketless work run.
+ *
+ * Auto-detects git vs non-git and chooses the appropriate strategy:
+ * - Git repo → worktree (default) or in-place (--no-worktree)
+ * - Non-git dir → in-place
+ * - No dir → temp workspace (headless)
+ *
+ * @param options Resolution options
+ * @returns Resolved workspace info
+ */
+export declare function resolveWorkspace(options: {
+    /** Explicit directory (--dir flag) */
+    dir?: string;
+    /** Agent name (for worktree/temp naming) */
+    agentName: string;
+    /** Skip worktree creation even for git repos (--no-worktree) */
+    noWorktree?: boolean;
+}): ResolvedWorkspace;

package/dist/lib/workspace-resolution.js

@@ -0,0 +1,188 @@
+/**
+ * Workspace Resolution for Ticketless Work
+ *
+ * Auto-detects the directory type and resolves the appropriate working
+ * directory for an agent. Handles git repos, non-git directories, and
+ * headless (no directory) mode.
+ *
+ * Resolution rules:
+ *   1. Git repo (default)     → create worktree for isolation
+ *   2. Git repo + noWorktree  → work in-place
+ *   3. Non-git directory      → work in-place (auto-detected)
+ *   4. No directory specified  → create temp workspace (headless mode)
+ *   5. --repo URL             → clone into temp dir (handled by caller)
+ *
+ * The caller should not need to specify a mode — this module detects
+ * git vs non-git and does the right thing.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { execSync } from 'node:child_process';
+// =============================================================================
+// Git Detection
+// =============================================================================
+/**
+ * Check if a directory is inside a git repository.
+ */
+export function isGitRepo(dir) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: dir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            encoding: 'utf-8',
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get the git root directory for a path.
+ */
+export function getGitRoot(dir) {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            cwd: dir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the current git branch.
+ */
+export function getCurrentBranch(dir) {
+    try {
+        return execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: dir,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+// =============================================================================
+// Worktree Management
+// =============================================================================
+/**
+ * Create a git worktree for isolated agent work.
+ * Returns the path to the new worktree directory.
+ */
+export function createWorktree(repoDir, agentName) {
+    const gitRoot = getGitRoot(repoDir);
+    if (!gitRoot) {
+        throw new Error(`Not a git repository: ${repoDir}`);
+    }
+    // Create worktree in a sibling directory to avoid polluting the repo
+    const worktreeBase = path.join(os.tmpdir(), 'prlt-worktrees');
+    fs.mkdirSync(worktreeBase, { recursive: true });
+    const worktreeDir = path.join(worktreeBase, `${agentName}-${Date.now()}`);
+    const branchName = `prlt-run/${agentName}-${Date.now()}`;
+    // Get the current HEAD as the base for the worktree
+    const baseRef = getCurrentBranch(gitRoot) || 'HEAD';
+    execSync(`git worktree add "${worktreeDir}" -b "${branchName}" "${baseRef}"`, {
+        cwd: gitRoot,
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    return worktreeDir;
+}
+// =============================================================================
+// Temp Workspace (Headless Mode)
+// =============================================================================
+/**
+ * Create a temporary workspace directory for headless work.
+ * Used when no --dir or --repo is specified (research, thinking, non-code tasks).
+ */
+export function createTempWorkspace(agentName) {
+    const tmpBase = path.join(os.tmpdir(), 'prlt-workspaces');
+    fs.mkdirSync(tmpBase, { recursive: true });
+    const tmpDir = path.join(tmpBase, `${agentName}-${Date.now()}`);
+    fs.mkdirSync(tmpDir, { recursive: true });
+    return tmpDir;
+}
+// =============================================================================
+// Resolve Workspace
+// =============================================================================
+/**
+ * Resolve the workspace for a ticketless work run.
+ *
+ * Auto-detects git vs non-git and chooses the appropriate strategy:
+ * - Git repo → worktree (default) or in-place (--no-worktree)
+ * - Non-git dir → in-place
+ * - No dir → temp workspace (headless)
+ *
+ * @param options Resolution options
+ * @returns Resolved workspace info
+ */
+export function resolveWorkspace(options) {
+    const { dir, agentName, noWorktree = false } = options;
+    // ─── No directory: headless mode ──────────────────────────────
+    if (!dir) {
+        const tmpDir = createTempWorkspace(agentName);
+        return {
+            workDir: tmpDir,
+            sourceDir: tmpDir,
+            isGitRepo: false,
+            branch: null,
+            mode: 'headless',
+            isTemp: true,
+        };
+    }
+    // ─── Explicit directory ───────────────────────────────────────
+    const resolvedDir = path.resolve(dir);
+    const gitRepo = isGitRepo(resolvedDir);
+    if (!gitRepo) {
+        // Non-git directory: work in-place (auto-detected)
+        return {
+            workDir: resolvedDir,
+            sourceDir: resolvedDir,
+            isGitRepo: false,
+            branch: null,
+            mode: 'in-place',
+            isTemp: false,
+        };
+    }
+    // Git repo
+    if (noWorktree) {
+        // User opted out of worktree isolation
+        return {
+            workDir: resolvedDir,
+            sourceDir: resolvedDir,
+            isGitRepo: true,
+            branch: getCurrentBranch(resolvedDir),
+            mode: 'in-place',
+            isTemp: false,
+        };
+    }
+    // Default: create worktree for isolation
+    try {
+        const worktreeDir = createWorktree(resolvedDir, agentName);
+        return {
+            workDir: worktreeDir,
+            sourceDir: resolvedDir,
+            isGitRepo: true,
+            branch: getCurrentBranch(worktreeDir),
+            mode: 'worktree',
+            isTemp: true,
+        };
+    }
+    catch {
+        // Worktree creation failed — fall back to in-place
+        return {
+            workDir: resolvedDir,
+            sourceDir: resolvedDir,
+            isGitRepo: true,
+            branch: getCurrentBranch(resolvedDir),
+            mode: 'in-place',
+            isTemp: false,
+        };
+    }
+}
+//# sourceMappingURL=workspace-resolution.js.map

package/dist/lib/workspace-resolution.js.map

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