@orgloop/agentctl 1.0.1 → 1.2.0

package/dist/utils/partial-read.js

@@ -0,0 +1,66 @@
+import * as fs from "node:fs/promises";
+/**
+ * Read the first N lines of a file by reading only `maxBytes` from the start.
+ * Avoids allocating the entire file into memory for large JSONL files.
+ *
+ * @param filePath - Path to the file
+ * @param maxLines - Maximum number of lines to return
+ * @param maxBytes - Maximum bytes to read from the start (default 8192)
+ * @returns Array of complete lines (up to maxLines)
+ */
+export async function readHead(filePath, maxLines, maxBytes = 8192) {
+    const fh = await fs.open(filePath, "r");
+    try {
+        const stat = await fh.stat();
+        const bytesToRead = Math.min(maxBytes, stat.size);
+        if (bytesToRead === 0)
+            return [];
+        const buf = Buffer.alloc(bytesToRead);
+        const { bytesRead } = await fh.read(buf, 0, bytesToRead, 0);
+        if (bytesRead === 0)
+            return [];
+        const text = buf.subarray(0, bytesRead).toString("utf-8");
+        const lines = text.split("\n");
+        // If we didn't read the whole file, the last chunk may be incomplete — drop it
+        if (bytesRead < stat.size) {
+            lines.pop();
+        }
+        return lines.filter((l) => l.length > 0).slice(0, maxLines);
+    }
+    finally {
+        await fh.close();
+    }
+}
+/**
+ * Read the last N lines of a file by reading only `maxBytes` from the end.
+ * Avoids allocating the entire file into memory for large JSONL files.
+ *
+ * @param filePath - Path to the file
+ * @param maxLines - Maximum number of lines to return
+ * @param maxBytes - Maximum bytes to read from the end (default 65536)
+ * @returns Array of complete lines (up to maxLines, in order)
+ */
+export async function readTail(filePath, maxLines, maxBytes = 65536) {
+    const fh = await fs.open(filePath, "r");
+    try {
+        const stat = await fh.stat();
+        if (stat.size === 0)
+            return [];
+        const bytesToRead = Math.min(maxBytes, stat.size);
+        const offset = Math.max(0, stat.size - bytesToRead);
+        const buf = Buffer.alloc(bytesToRead);
+        const { bytesRead } = await fh.read(buf, 0, bytesToRead, offset);
+        if (bytesRead === 0)
+            return [];
+        const text = buf.subarray(0, bytesRead).toString("utf-8");
+        const lines = text.split("\n");
+        // If we didn't start from the beginning, the first chunk may be a partial line — drop it
+        if (offset > 0) {
+            lines.shift();
+        }
+        return lines.filter((l) => l.length > 0).slice(-maxLines);
+    }
+    finally {
+        await fh.close();
+    }
+}

package/dist/worktree.d.ts

@@ -22,3 +22,25 @@ export declare function createWorktree(opts: WorktreeCreateOpts): Promise<Worktr
  * Remove a git worktree.
  */
 export declare function removeWorktree(repo: string, worktreePath: string): Promise<void>;
+/** Info about an existing worktree from `git worktree list` */
+export interface WorktreeListEntry {
+    path: string;
+    branch: string;
+    head: string;
+    /** Whether this is the bare/main worktree */
+    bare: boolean;
+}
+/**
+ * List all git worktrees for a repo.
+ * Parses `git worktree list --porcelain` output.
+ */
+export declare function listWorktrees(repo: string): Promise<WorktreeListEntry[]>;
+/**
+ * Remove a worktree and optionally delete its branch.
+ */
+export declare function cleanWorktree(repo: string, worktreePath: string, opts?: {
+    deleteBranch?: boolean;
+}): Promise<{
+    removedPath: string;
+    deletedBranch?: string;
+}>;

package/dist/worktree.js

@@ -63,3 +63,71 @@ export async function removeWorktree(repo, worktreePath) {
         cwd: repoResolved,
     });
 }
+/**
+ * List all git worktrees for a repo.
+ * Parses `git worktree list --porcelain` output.
+ */
+export async function listWorktrees(repo) {
+    const repoResolved = path.resolve(repo);
+    const { stdout } = await execFileAsync("git", ["worktree", "list", "--porcelain"], { cwd: repoResolved });
+    const entries = [];
+    let current = {};
+    for (const line of stdout.split("\n")) {
+        if (line.startsWith("worktree ")) {
+            if (current.path)
+                entries.push(current);
+            current = { path: line.replace("worktree ", ""), bare: false };
+        }
+        else if (line.startsWith("HEAD ")) {
+            current.head = line.replace("HEAD ", "");
+        }
+        else if (line.startsWith("branch ")) {
+            current.branch = line.replace("branch refs/heads/", "");
+        }
+        else if (line === "bare") {
+            current.bare = true;
+        }
+        else if (line === "" && current.path) {
+            // End of entry
+        }
+    }
+    if (current.path)
+        entries.push(current);
+    return entries;
+}
+/**
+ * Remove a worktree and optionally delete its branch.
+ */
+export async function cleanWorktree(repo, worktreePath, opts) {
+    const repoResolved = path.resolve(repo);
+    // Get the branch name before removing
+    let branch;
+    if (opts?.deleteBranch) {
+        try {
+            const { stdout } = await execFileAsync("git", ["rev-parse", "--abbrev-ref", "HEAD"], { cwd: worktreePath });
+            branch = stdout.trim();
+        }
+        catch {
+            // Worktree might be broken — still try to remove
+        }
+    }
+    await execFileAsync("git", ["worktree", "remove", "--force", worktreePath], {
+        cwd: repoResolved,
+    });
+    const result = {
+        removedPath: worktreePath,
+    };
+    // Delete the branch if requested
+    if (branch && opts?.deleteBranch) {
+        try {
+            await execFileAsync("git", ["branch", "-D", branch], {
+                cwd: repoResolved,
+            });
+            result.deletedBranch = branch;
+        }
+        catch {
+            // Branch might already be gone
+        }
+    }
+    return result;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orgloop/agentctl",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "Universal agent supervision interface — monitor and control AI coding agents from a single CLI",
   "type": "module",
   "bin": {
@@ -49,7 +49,8 @@
     "commander": "^14.0.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "yaml": "^2.8.2"
   },
   "devDependencies": {
     "@biomejs/biome": "^2.4.2"