@memnexus-ai/mx-agent-cli 0.1.1

package/dist/lib/worktree.js

@@ -0,0 +1,209 @@
+/**
+ * Git worktree operations for the agent CLI.
+ * Borrowed and simplified from dev-tools/worktree-cli/src/git.ts and config.ts.
+ */
+import { execSync } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync } from 'fs';
+import { join, dirname } from 'path';
+// ── Project root detection ────────────────────────────────────────────
+/**
+ * Walk up from cwd to find the repo root (directory containing .git).
+ *
+ * Strategy:
+ * 1. Walk up from cwd looking for a directory with both .git AND mx-agent-system/ or worktree.toml.
+ *    This finds the actual "agent platform" project root even when running from inside a
+ *    nested .worktrees/ sub-path.
+ * 2. If no such directory found, any directory with .git qualifies.
+ */
+/**
+ * Returns true when the .git entry at `dir` is a real git directory (main
+ * worktree), not a gitfile (linked worktree).  In a linked worktree `.git`
+ * is a plain file containing "gitdir: …".
+ */
+function isMainWorktree(dir) {
+    const gitPath = join(dir, '.git');
+    try {
+        return statSync(gitPath).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export function findProjectRoot() {
+    let candidate = process.cwd();
+    // Walk up looking for the main worktree (where .git is a directory, not a
+    // gitfile) that also contains our canonical marker.  This correctly skips
+    // linked worktrees, which have .git as a file.
+    let firstMainGit = null;
+    while (candidate !== dirname(candidate)) {
+        if (isMainWorktree(candidate)) {
+            if (firstMainGit === null)
+                firstMainGit = candidate;
+            if (existsSync(join(candidate, 'mx-agent-system')) ||
+                existsSync(join(candidate, 'worktree.toml'))) {
+                return candidate;
+            }
+        }
+        candidate = dirname(candidate);
+    }
+    if (firstMainGit !== null)
+        return firstMainGit;
+    throw new Error('Could not find project root (no .git directory found)');
+}
+// ── Slot management (mirrors dev-tools/worktree-cli/src/ports.ts) ─────
+const SLOTS_FILENAME = '.slots.json';
+function getSlotsPath(projectRoot) {
+    return join(projectRoot, '.worktrees', SLOTS_FILENAME);
+}
+export function loadSlots(projectRoot) {
+    const filePath = getSlotsPath(projectRoot);
+    if (!existsSync(filePath))
+        return {};
+    try {
+        return JSON.parse(readFileSync(filePath, 'utf-8'));
+    }
+    catch {
+        return {};
+    }
+}
+function saveSlots(projectRoot, slots) {
+    const dir = join(projectRoot, '.worktrees');
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(getSlotsPath(projectRoot), JSON.stringify(slots, null, 2));
+}
+export function assignSlot(projectRoot, worktreeName, maxWorktrees = 25) {
+    const slots = loadSlots(projectRoot);
+    if (slots[worktreeName] !== undefined)
+        return slots[worktreeName];
+    const used = new Set(Object.values(slots));
+    for (let i = 1; i <= maxWorktrees; i++) {
+        if (!used.has(i)) {
+            slots[worktreeName] = i;
+            saveSlots(projectRoot, slots);
+            return i;
+        }
+    }
+    throw new Error(`No available slots (max: ${maxWorktrees}). Remove a worktree first.`);
+}
+export function getSlot(projectRoot, worktreeName) {
+    const slots = loadSlots(projectRoot);
+    return slots[worktreeName] ?? null;
+}
+// ── Git helpers ───────────────────────────────────────────────────────
+export function getCurrentBranch(cwd) {
+    try {
+        return execSync('git branch --show-current', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim() || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function fetchOrigin(cwd) {
+    try {
+        execSync('git fetch origin', { cwd, stdio: 'pipe' });
+    }
+    catch {
+        // Non-fatal — continue anyway
+    }
+}
+/**
+ * Check if a branch already exists (local or remote).
+ */
+function branchExists(branch, cwd) {
+    try {
+        const local = execSync(`git branch --list ${branch}`, { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim();
+        const remote = execSync(`git branch -r --list origin/${branch}`, { cwd, encoding: 'utf-8', stdio: 'pipe' }).trim();
+        return Boolean(local || remote);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Create a git worktree at `worktreePath` on `branch` (branched from `baseBranch`).
+ */
+export function createGitWorktree(worktreePath, branch, baseBranch, cwd) {
+    if (branchExists(branch, cwd)) {
+        execSync(`git worktree add "${worktreePath}" "${branch}"`, { cwd, stdio: 'inherit' });
+    }
+    else {
+        try {
+            execSync(`git worktree add "${worktreePath}" -b "${branch}" "origin/${baseBranch}"`, { cwd, stdio: 'inherit' });
+        }
+        catch {
+            // Fall back to local branch if origin doesn't have it
+            execSync(`git worktree add "${worktreePath}" -b "${branch}" "${baseBranch}"`, { cwd, stdio: 'inherit' });
+        }
+    }
+}
+/**
+ * Add the worktree path to git safe.directory (so git works inside it).
+ */
+export function addToGitSafeDirectory(worktreePath) {
+    try {
+        const dirs = execSync('git config --global --get-all safe.directory 2>/dev/null || true', {
+            encoding: 'utf-8',
+        }).trim().split('\n').filter(Boolean);
+        if (!dirs.includes(worktreePath)) {
+            execSync(`git config --global --add safe.directory "${worktreePath}"`, { stdio: 'pipe' });
+        }
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/**
+ * Generate a datestamped branch name for a team worktree.
+ * e.g. "retrieval" → "worktree/retrieval-20260222"
+ */
+export function generateBranchName(teamSlug) {
+    const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    return `worktree/${teamSlug}-${date}`;
+}
+/**
+ * Generate the worktree directory name.
+ * e.g. "retrieval" + "20260222" → "retrieval-20260222"
+ */
+export function generateWorktreeDirName(teamSlug) {
+    const date = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    return `${teamSlug}-${date}`;
+}
+/**
+ * Find the worktree directory for a team.
+ * Looks for an exact match `<name>` or a prefix match `<name>-*` under .worktrees/.
+ */
+export function findWorktreePath(projectRoot, teamName) {
+    const worktreesDir = join(projectRoot, '.worktrees');
+    if (!existsSync(worktreesDir))
+        return null;
+    // Try exact match first
+    const exact = join(worktreesDir, teamName);
+    if (existsSync(exact))
+        return exact;
+    // Prefix match: teamName-YYYYMMDD
+    try {
+        const entries = execSync(`ls "${worktreesDir}"`, { encoding: 'utf-8', stdio: 'pipe' })
+            .trim()
+            .split('\n')
+            .filter(Boolean);
+        for (const entry of entries) {
+            if (entry === teamName || entry.startsWith(`${teamName}-`)) {
+                const candidate = join(worktreesDir, entry);
+                // Confirm it's actually a git worktree (has .git file)
+                if (existsSync(join(candidate, '.git'))) {
+                    return candidate;
+                }
+            }
+        }
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+//# sourceMappingURL=worktree.js.map

package/dist/lib/worktree.js.map

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@memnexus-ai/mx-agent-cli",
+  "version": "0.1.1",
+  "description": "CLI for creating and managing AI agent teams",
+  "type": "module",
+  "bin": {
+    "mx-agent": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "keywords": [
+    "memnexus",
+    "agent",
+    "cli",
+    "internal"
+  ],
+  "author": "MemNexus Team",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/memnexus-ai/memnexus.git",
+    "directory": "mx-agent-system/cli"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}