pi-gentic 0.1.0

package/dist/worktrees.d.ts

@@ -0,0 +1 @@
+export declare function prepareWorktree({ repoCwd, repo, cwd, worktree, message, }: AnyRecord): Promise<string>;

package/dist/worktrees.js

@@ -0,0 +1,86 @@
+/**
+ * Git worktree preparation for delegated agent sessions.
+ *
+ * The agents tool treats cwd as the worktree folder when worktree is set.
+ * The repo option selects the source repository for that worktree.
+ */
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+export async function prepareWorktree({ repoCwd, repo, cwd, worktree, message, }) {
+    const repoRoot = await repositoryRoot(repoCwd, repo);
+    const branchInput = stringOrUndefined(worktree);
+    const fallbackName = worktreeSlug(branchInput ?? stringOrUndefined(cwd) ?? stringOrUndefined(message));
+    const worktreePath = path.resolve(repoRoot, cwd
+        ? String(cwd)
+        : path.join(".agentfiles", "worktrees", fallbackName));
+    const branch = gitBranchName(branchInput ?? path.basename(worktreePath) ?? fallbackName);
+    await ensureGitWorktree(repoRoot, worktreePath, branch);
+    return worktreePath;
+}
+async function repositoryRoot(repoCwd, repo) {
+    const base = String(repoCwd || process.cwd());
+    const source = stringOrUndefined(repo);
+    const repositoryPath = source ? path.resolve(base, source) : base;
+    try {
+        return await gitOutput(repositoryPath, ["rev-parse", "--show-toplevel"]);
+    }
+    catch (error) {
+        throw new Error(`Worktree repository must be a git repository: ${repositoryPath}`, { cause: error });
+    }
+}
+async function ensureGitWorktree(repoRoot, worktreePath, branch) {
+    if (existsSync(path.join(worktreePath, ".git")))
+        return;
+    try {
+        await gitOutput(repoRoot, ["worktree", "add", worktreePath, branch]);
+    }
+    catch {
+        await gitOutput(repoRoot, [
+            "worktree",
+            "add",
+            "-b",
+            branch,
+            worktreePath,
+            "HEAD",
+        ]);
+    }
+}
+async function gitOutput(cwd, args) {
+    const { stdout } = await execFileAsync("git", args, {
+        cwd,
+        timeout: 30_000,
+        windowsHide: true,
+    });
+    return stdout.trim();
+}
+function stringOrUndefined(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function worktreeSlug(value) {
+    const source = String(value ?? "agent-worktree");
+    const base = source
+        .toLowerCase()
+        .replace(/[^a-z0-9._/-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60);
+    return `${base || "agent-worktree"}-${hashText(source)}`;
+}
+function gitBranchName(value) {
+    return (String(value ?? "agent-worktree")
+        .replace(/\\/g, "/")
+        .split("/")
+        .map((part) => part
+        .replace(/[^A-Za-z0-9._-]+/g, "-")
+        .replace(/^[-.]+|[-.]+$/g, ""))
+        .filter(Boolean)
+        .join("/") || "agent-worktree");
+}
+function hashText(value) {
+    let hash = 5381;
+    for (const char of value)
+        hash = ((hash << 5) + hash) ^ char.charCodeAt(0);
+    return Math.abs(hash >>> 0).toString(36).slice(0, 6);
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "pi-gentic",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Pi extension for orchestrating durable agent sessions, delegation, and worktrees.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CodeByPeete/pi-gentic.git"
+  },
+  "homepage": "https://github.com/CodeByPeete/pi-gentic#readme",
+  "bugs": {
+    "url": "https://github.com/CodeByPeete/pi-gentic/issues"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "agents",
+    "orchestration",
+    "session-management",
+    "worktrees"
+  ],
+  "files": [
+    "dist",
+    "docs/assets",
+    "README.md"
+  ],
+  "exports": "./dist/extension.js",
+  "types": "./dist/extension.d.ts",
+  "pi": {
+    "extensions": [
+      "./dist/extension.js"
+    ],
+    "image": "https://raw.githubusercontent.com/CodeByPeete/pi-gentic/main/docs/assets/orchestration-tree.png"
+  },
+  "scripts": {
+    "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test test/*.test.js",
+    "test:ui": "npm run build && node test-ui/capture-ui.mjs",
+    "test:e2e": "npm run build && python test-e2e/capture-terminal-ui.py",
+    "prepack": "npm run build",
+    "pack:dry": "npm pack --dry-run"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3",
+    "typescript": "6.0.3"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  }
+}