@memnexus-ai/mx-agent-cli 0.1.1

package/dist/commands/create.d.ts

@@ -0,0 +1,12 @@
+/**
+ * mx-agent create --roleguide <path> [--name <slug>]
+ *
+ * Creates a new agent team worktree, initialises team memories, and
+ * creates a catalog entry.
+ */
+export interface CreateOptions {
+    roleguide: string;
+    name?: string;
+}
+export declare function runCreate(options: CreateOptions): Promise<void>;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+BH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA2JrE"}

package/dist/commands/create.js

@@ -0,0 +1,169 @@
+/**
+ * mx-agent create --roleguide <path> [--name <slug>]
+ *
+ * Creates a new agent team worktree, initialises team memories, and
+ * creates a catalog entry.
+ */
+import { existsSync, mkdirSync } from 'fs';
+import { join, basename } from 'path';
+import chalk from 'chalk';
+import { findProjectRoot, assignSlot, getCurrentBranch, fetchOrigin, createGitWorktree, addToGitSafeDirectory, generateBranchName, generateWorktreeDirName, } from '../lib/worktree.js';
+import { deployClaudeMd, writeClaudeLocal, logSuccess, logWarning, logDim } from '../lib/claude.js';
+import { writeTeamCatalog, slugToDisplayName } from '../lib/catalog.js';
+import { isMxAvailable, bootstrapTeamMemories, logMemoryResult } from '../lib/memory.js';
+/**
+ * Infer a team slug from a roleguide filename.
+ * e.g. "retrieval-leader.md" → "retrieval"
+ *      "devops-pipeline-leader.md" → "devops-pipeline"
+ *      "marketing.md" → "marketing"
+ */
+function inferSlugFromRoleguide(roleguide) {
+    const filename = basename(roleguide, '.md');
+    // Strip common suffixes
+    return filename.replace(/-leader$/, '').replace(/-roleguide$/, '');
+}
+export async function runCreate(options) {
+    const { roleguide } = options;
+    // Resolve team slug
+    const slug = options.name ?? inferSlugFromRoleguide(roleguide);
+    if (!slug) {
+        console.error(chalk.red('Error: Could not determine team slug. Use --name to specify it explicitly.'));
+        process.exit(1);
+    }
+    // Defense-in-depth: validate slug before use in any shell command or file path
+    const SLUG_RE = /^[a-z][a-z0-9-]{0,48}[a-z0-9]$/;
+    if (!SLUG_RE.test(slug)) {
+        console.error(chalk.red(`Error: Invalid team slug "${slug}".`));
+        console.error(chalk.dim('  Slug must match ^[a-z][a-z0-9-]{0,48}[a-z0-9]$ (lowercase, digits, hyphens; 2–50 chars).'));
+        process.exit(1);
+    }
+    const displayName = slugToDisplayName(slug);
+    let projectRoot;
+    try {
+        projectRoot = findProjectRoot();
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(chalk.cyan.bold('Creating Agent Team'));
+    console.log(chalk.dim('─'.repeat(50)));
+    console.log(`  ${chalk.bold('Team:')}      ${slug}`);
+    console.log(`  ${chalk.bold('Display:')}   ${displayName}`);
+    console.log(`  ${chalk.bold('Roleguide:')} ${roleguide}`);
+    console.log(`  ${chalk.bold('Root:')}      ${projectRoot}`);
+    console.log();
+    // ── 1. Slot allocation ─────────────────────────────────────────────
+    let slot;
+    try {
+        slot = assignSlot(projectRoot, slug);
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    // ── 2. Worktree path ───────────────────────────────────────────────
+    const worktreeDirName = generateWorktreeDirName(slug);
+    const worktreePath = join(projectRoot, '.worktrees', worktreeDirName);
+    const branch = generateBranchName(slug);
+    console.log(`  ${chalk.bold('Worktree:')}  ${worktreePath}`);
+    console.log(`  ${chalk.bold('Branch:')}    ${branch}`);
+    console.log(`  ${chalk.bold('Slot:')}      ${slot}`);
+    console.log();
+    if (existsSync(worktreePath)) {
+        console.error(chalk.red(`Error: Worktree already exists at ${worktreePath}`));
+        console.error(chalk.dim('  Remove it first, or use a different --name.'));
+        process.exit(1);
+    }
+    // Ensure .worktrees/ directory exists
+    const worktreesDir = join(projectRoot, '.worktrees');
+    if (!existsSync(worktreesDir)) {
+        mkdirSync(worktreesDir, { recursive: true });
+    }
+    // ── 3. Fetch origin ────────────────────────────────────────────────
+    logDim('Fetching latest from remote...');
+    fetchOrigin(projectRoot);
+    // ── 4. Create git worktree ─────────────────────────────────────────
+    console.log(chalk.dim('  Creating git worktree...'));
+    try {
+        createGitWorktree(worktreePath, branch, 'main', projectRoot);
+        logSuccess('Git worktree created');
+    }
+    catch (err) {
+        console.error(chalk.red(`Error creating worktree: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    addToGitSafeDirectory(worktreePath);
+    // ── 5. Deploy CLAUDE.md ────────────────────────────────────────────
+    deployClaudeMd(projectRoot, worktreePath);
+    // ── 6. Generate CLAUDE.local.md ────────────────────────────────────
+    const currentBranch = getCurrentBranch(worktreePath) || branch;
+    writeClaudeLocal({
+        projectRoot,
+        worktreePath,
+        worktreeName: worktreeDirName,
+        branch: currentBranch,
+        slot,
+    });
+    // ── 7. Initialise named memories via mx ───────────────────────────
+    let memoriesOk = false;
+    console.log();
+    console.log(chalk.bold('  Initialising team memories:'));
+    if (!isMxAvailable()) {
+        logWarning('mx CLI not found — skipping memory initialisation. Run manually:');
+        console.log(chalk.dim(`    mx memories create --name "${slug}-leader-state" --conversation-id NEW --content "..."`));
+        console.log(chalk.dim(`    mx memories create --name "${slug}-iteration-log" --conversation-id NEW --content "..."`));
+        console.log(chalk.dim(`    mx memories create --name "${slug}-known-issues" --conversation-id NEW --content "..."`));
+    }
+    else {
+        const results = bootstrapTeamMemories(slug, displayName, roleguide);
+        logMemoryResult(`${slug}-leader-state`, results.leaderState);
+        logMemoryResult(`${slug}-iteration-log`, results.iterationLog);
+        logMemoryResult(`${slug}-known-issues`, results.knownIssues);
+        memoriesOk = results.leaderState.ok && results.iterationLog.ok && results.knownIssues.ok;
+    }
+    // ── 8. Write catalog entry ─────────────────────────────────────────
+    console.log();
+    console.log(chalk.bold('  Writing catalog entry:'));
+    try {
+        writeTeamCatalog(projectRoot, {
+            slug,
+            displayName,
+            roleguide,
+            namedMemories: [
+                `${slug}-leader-state`,
+                `${slug}-iteration-log`,
+                `${slug}-known-issues`,
+            ],
+        });
+        logSuccess(`mx-agent-system/teams/${slug}.md`);
+    }
+    catch (err) {
+        logWarning(`Could not write catalog entry: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // ── 9. Completion summary ──────────────────────────────────────────
+    console.log();
+    console.log(chalk.green.bold('Team Created!'));
+    console.log(chalk.dim('─'.repeat(50)));
+    console.log();
+    console.log(chalk.bold('  Definition of Done checklist:'));
+    console.log(chalk.green(`  [✓] Git worktree: ${worktreePath}`));
+    console.log(chalk.green(`  [✓] Branch: ${branch}`));
+    console.log(chalk.green(`  [✓] CLAUDE.md deployed from template`));
+    console.log(chalk.green(`  [✓] CLAUDE.local.md generated (slot ${slot})`));
+    const memoriesLabel = `${slug}-leader-state, ${slug}-iteration-log, ${slug}-known-issues`;
+    if (memoriesOk) {
+        console.log(chalk.green(`  [✓] Named memories: ${memoriesLabel}`));
+    }
+    else {
+        console.log(chalk.yellow(`  [⚠] Named memories: ${memoriesLabel} (create manually — see above)`));
+    }
+    console.log(chalk.green(`  [✓] Catalog entry: mx-agent-system/teams/${slug}.md`));
+    console.log();
+    console.log(chalk.bold('  Next steps:'));
+    console.log(`  Start this team:  ${chalk.cyan(`mx-agent start ${slug}`)}`);
+    console.log(`  Check status:     ${chalk.cyan(`mx-agent status ${slug}`)}`);
+    console.log();
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACtC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzF;;;;;GAKG;AACH,SAAS,sBAAsB,CAAC,SAAiB;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAC5C,wBAAwB;IACxB,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;AACrE,CAAC;AAOD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;IAE9B,oBAAoB;IACpB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4EAA4E,CAAC,CAAC,CAAC;QACvG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,+EAA+E;IAC/E,MAAM,OAAO,GAAG,gCAAgC,CAAC;IACjD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAC,CAAC,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4FAA4F,CAAC,CAAC,CAAC;QACvH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE5C,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,eAAe,EAAE,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,SAAS,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,WAAW,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,sEAAsE;IACtE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,sEAAsE;IACtE,MAAM,eAAe,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC;IACtE,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAExC,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,MAAM,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,YAAY,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,+CAA+C,CAAC,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,sCAAsC;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,sEAAsE;IACtE,MAAM,CAAC,gCAAgC,CAAC,CAAC;IACzC,WAAW,CAAC,WAAW,CAAC,CAAC;IAEzB,sEAAsE;IACtE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC,CAAC;IACrD,IAAI,CAAC;QACH,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC7D,UAAU,CAAC,sBAAsB,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAEpC,sEAAsE;IACtE,cAAc,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAE1C,sEAAsE;IACtE,MAAM,aAAa,GAAG,gBAAgB,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC;IAC/D,gBAAgB,CAAC;QACf,WAAW;QACX,YAAY;QACZ,YAAY,EAAE,eAAe;QAC7B,MAAM,EAAE,aAAa;QACrB,IAAI;KACL,CAAC,CAAC;IAEH,qEAAqE;IACrE,IAAI,UAAU,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACzD,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,UAAU,CAAC,kEAAkE,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,IAAI,sDAAsD,CAAC,CAAC,CAAC;QACrH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,IAAI,uDAAuD,CAAC,CAAC,CAAC;QACtH,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kCAAkC,IAAI,sDAAsD,CAAC,CAAC,CAAC;IACvH,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GAAG,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;QACpE,eAAe,CAAC,GAAG,IAAI,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7D,eAAe,CAAC,GAAG,IAAI,gBAAgB,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QAC/D,eAAe,CAAC,GAAG,IAAI,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;QAC7D,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;IAC3F,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACpD,IAAI,CAAC;QACH,gBAAgB,CAAC,WAAW,EAAE;YAC5B,IAAI;YACJ,WAAW;YACX,SAAS;YACT,aAAa,EAAE;gBACb,GAAG,IAAI,eAAe;gBACtB,GAAG,IAAI,gBAAgB;gBACvB,GAAG,IAAI,eAAe;aACvB;SACF,CAAC,CAAC;QACH,UAAU,CAAC,yBAAyB,IAAI,KAAK,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,UAAU,CAAC,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,sEAAsE;IACtE,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,uBAAuB,YAAY,EAAE,CAAC,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,MAAM,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yCAAyC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC3E,MAAM,aAAa,GAAG,GAAG,IAAI,kBAAkB,IAAI,mBAAmB,IAAI,eAAe,CAAC;IAC1F,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,yBAAyB,aAAa,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,yBAAyB,aAAa,gCAAgC,CAAC,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,8CAA8C,IAAI,KAAK,CAAC,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC5E,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/commands/list.d.ts

@@ -0,0 +1,7 @@
+/**
+ * agent list
+ *
+ * Lists all teams from the catalog with their worktree status.
+ */
+export declare function runList(): Promise<void>;
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../src/commands/list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CA8D7C"}

package/dist/commands/list.js

@@ -0,0 +1,58 @@
+/**
+ * agent list
+ *
+ * Lists all teams from the catalog with their worktree status.
+ */
+import chalk from 'chalk';
+import { findProjectRoot, findWorktreePath } from '../lib/worktree.js';
+import { listTeams } from '../lib/catalog.js';
+export async function runList() {
+    let projectRoot;
+    try {
+        projectRoot = findProjectRoot();
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    const teams = listTeams(projectRoot);
+    console.log();
+    console.log(chalk.cyan.bold('Agent Teams'));
+    console.log(chalk.dim('─'.repeat(70)));
+    if (teams.length === 0) {
+        console.log(chalk.dim('  No teams found.'));
+        console.log(chalk.dim('  Create one with: agent create --roleguide <path>'));
+        console.log();
+        return;
+    }
+    // Header row
+    const colW = { name: 18, display: 24, status: 12, roleguide: 40 };
+    console.log(chalk.bold(`  ${'Team'.padEnd(colW.name)}${'Display Name'.padEnd(colW.display)}${'Status'.padEnd(colW.status)}Roleguide`));
+    console.log(chalk.dim('  ' + '─'.repeat(colW.name + colW.display + colW.status + colW.roleguide)));
+    for (const team of teams) {
+        const worktreePath = findWorktreePath(projectRoot, team.slug);
+        let statusText;
+        let statusColor;
+        if (!worktreePath) {
+            statusText = 'not created';
+            statusColor = chalk.dim;
+        }
+        else {
+            // A simple heuristic: if the worktree path exists, it's "stopped" unless
+            // we can detect a running process (which is complex — just report "ready").
+            statusText = 'ready';
+            statusColor = chalk.green;
+        }
+        const roleguideDisplay = team.roleguide.length > colW.roleguide - 2
+            ? '...' + team.roleguide.slice(-(colW.roleguide - 5))
+            : team.roleguide;
+        console.log(`  ${chalk.white(team.slug.padEnd(colW.name))}` +
+            `${team.displayName.padEnd(colW.display)}` +
+            `${statusColor(statusText.padEnd(colW.status))}` +
+            chalk.dim(roleguideDisplay));
+    }
+    console.log();
+    console.log(chalk.dim(`  ${teams.length} team(s) in catalog.`));
+    console.log();
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/list.js.map

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

package/dist/commands/start.d.ts

@@ -0,0 +1,10 @@
+/**
+ * agent start <name>
+ *
+ * Starts an isolated Claude session for a named team in its worktree.
+ */
+export interface StartOptions {
+    name: string;
+}
+export declare function runStart(options: StartOptions): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/commands/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/commands/start.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA8FnE"}

package/dist/commands/start.js

@@ -0,0 +1,93 @@
+/**
+ * agent start <name>
+ *
+ * Starts an isolated Claude session for a named team in its worktree.
+ */
+import chalk from 'chalk';
+import { findProjectRoot, findWorktreePath, getSlot, getCurrentBranch, } from '../lib/worktree.js';
+import { syncClaudeConfig, deployClaudeMd, writeClaudeLocal, launchClaudeSession } from '../lib/claude.js';
+import { getTeam } from '../lib/catalog.js';
+export async function runStart(options) {
+    const { name } = options;
+    let projectRoot;
+    try {
+        projectRoot = findProjectRoot();
+    }
+    catch (err) {
+        console.error(chalk.red(`Error: ${err instanceof Error ? err.message : String(err)}`));
+        process.exit(1);
+    }
+    // ── 1. Locate the worktree ─────────────────────────────────────────
+    const worktreePath = findWorktreePath(projectRoot, name);
+    if (!worktreePath) {
+        console.error(chalk.red(`Team '${name}' not found.`));
+        console.error(chalk.dim(`  No worktree found in ${projectRoot}/.worktrees/ matching '${name}' or '${name}-*'`));
+        console.error(chalk.dim(`  Run: agent create --roleguide <path> --name ${name}`));
+        process.exit(1);
+    }
+    // ── 2. Resolve slot ────────────────────────────────────────────────
+    // The slot key in .slots.json may be the full dir name (e.g. "retrieval-20260222")
+    // or just the team slug. Try both.
+    const { basename } = await import('path');
+    const worktreeDirName = basename(worktreePath);
+    let slot = getSlot(projectRoot, worktreeDirName);
+    if (slot === null) {
+        // Try the short name
+        slot = getSlot(projectRoot, name);
+    }
+    if (slot === null) {
+        slot = 0; // fallback — won't break anything
+    }
+    // ── 3. Resolve roleguide from catalog ─────────────────────────────
+    const team = getTeam(projectRoot, name);
+    let roleguide;
+    if (team?.roleguide) {
+        roleguide = team.roleguide;
+    }
+    else {
+        // Fallback convention
+        roleguide = `mx-agent-system/roleguides/${name}-leader.md`;
+    }
+    const branch = getCurrentBranch(worktreePath);
+    console.log();
+    console.log(chalk.cyan.bold('Starting Agent Team'));
+    console.log(chalk.dim('─'.repeat(50)));
+    console.log(`  ${chalk.bold('Team:')}      ${name}`);
+    console.log(`  ${chalk.bold('Path:')}      ${worktreePath}`);
+    console.log(`  ${chalk.bold('Branch:')}    ${branch || 'unknown'}`);
+    console.log(`  ${chalk.bold('Slot:')}      ${slot}`);
+    console.log(`  ${chalk.bold('Roleguide:')} ${roleguide}`);
+    console.log();
+    // ── 4. Sync Claude config from origin/main ────────────────────────
+    syncClaudeConfig(worktreePath);
+    // ── 5. Deploy fresh CLAUDE.md ─────────────────────────────────────
+    deployClaudeMd(projectRoot, worktreePath);
+    // ── 6. Regenerate CLAUDE.local.md ────────────────────────────────
+    writeClaudeLocal({
+        projectRoot,
+        worktreePath,
+        worktreeName: worktreeDirName,
+        branch,
+        slot,
+    });
+    // ── 7. Print isolation summary ─────────────────────────────────────
+    console.log();
+    console.log(chalk.bold.green('  Isolation Enabled:'));
+    console.log(chalk.dim('  ─────────────────────────────────────────────'));
+    console.log(`  ${chalk.green('✓')} Directory restricted to worktree`);
+    console.log(`  ${chalk.green('✓')} git checkout/switch to main blocked`);
+    console.log(`  ${chalk.green('✓')} git push origin main blocked`);
+    console.log();
+    // ── 8. Build initial prompt ────────────────────────────────────────
+    const initialPrompt = `You are assuming the role of team lead per this roleguide - ${roleguide} ` +
+        `read the doc and get familiar. then check your memories and get up to speed.`;
+    // ── 9. Launch Claude ───────────────────────────────────────────────
+    launchClaudeSession({
+        worktreePath,
+        worktreeName: worktreeDirName,
+        branch,
+        slot,
+        initialPrompt,
+    });
+}
+//# sourceMappingURL=start.js.map

package/dist/commands/start.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,10 @@
+/**
+ * agent status <name>
+ *
+ * Fetches and displays the team's leader-state named memory.
+ */
+export interface StatusOptions {
+    name: string;
+}
+export declare function runStatus(options: StatusOptions): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BrE"}

package/dist/commands/status.js

@@ -0,0 +1,32 @@
+/**
+ * agent status <name>
+ *
+ * Fetches and displays the team's leader-state named memory.
+ */
+import chalk from 'chalk';
+import { isMxAvailable, getNamedMemory } from '../lib/memory.js';
+export async function runStatus(options) {
+    const { name } = options;
+    if (!isMxAvailable()) {
+        console.error(chalk.red('Error: mx CLI not found. Install it and ensure it is on your PATH.'));
+        process.exit(1);
+    }
+    const memoryName = `${name}-leader-state`;
+    console.log();
+    console.log(chalk.cyan.bold(`Team Status: ${name}`));
+    console.log(chalk.dim('─'.repeat(50)));
+    console.log(chalk.dim(`  Memory key: ${memoryName}`));
+    console.log();
+    const result = getNamedMemory(memoryName);
+    if (!result.ok || !result.output) {
+        console.log(chalk.yellow(`  No state found for team '${name}'. Has the team been started yet?`));
+        console.log(chalk.dim(`  Expected named memory: ${memoryName}`));
+        console.log(chalk.dim(`  Run: agent create --roleguide <path> --name ${name}`));
+        console.log();
+        return;
+    }
+    // Print the raw output — the mx CLI renders it already
+    console.log(result.output);
+    console.log();
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAMjE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACpD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAEzB,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;QAC/F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,GAAG,IAAI,eAAe,CAAC;IAC1C,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,UAAU,EAAE,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IAE1C,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,8BAA8B,IAAI,mCAAmC,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,UAAU,EAAE,CAAC,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iDAAiD,IAAI,EAAE,CAAC,CAAC,CAAC;QAChF,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO;IACT,CAAC;IAED,uDAAuD;IACvD,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * mx-agent-cli — CLI for creating and managing AI agent teams.
+ *
+ * Commands:
+ *   mx-agent create --roleguide <path> [--name <slug>]
+ *   mx-agent start <name>
+ *   mx-agent list
+ *   mx-agent status <name>
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG"}

package/dist/index.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+/**
+ * mx-agent-cli — CLI for creating and managing AI agent teams.
+ *
+ * Commands:
+ *   mx-agent create --roleguide <path> [--name <slug>]
+ *   mx-agent start <name>
+ *   mx-agent list
+ *   mx-agent status <name>
+ */
+import { Command } from 'commander';
+import { runCreate } from './commands/create.js';
+import { runStart } from './commands/start.js';
+import { runList } from './commands/list.js';
+import { runStatus } from './commands/status.js';
+const program = new Command();
+program
+    .name('mx-agent')
+    .description('CLI for creating and managing AI agent teams')
+    .version('0.1.0');
+// ── create ─────────────────────────────────────────────────────────────
+program
+    .command('create')
+    .description('Create a new agent team: worktree + memories + catalog entry')
+    .requiredOption('--roleguide <path>', 'Path to the team roleguide markdown file')
+    .option('--name <slug>', 'Team slug (kebab-case). Inferred from roleguide filename if omitted.')
+    .action((opts) => {
+    runCreate(opts).catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+});
+// ── start ──────────────────────────────────────────────────────────────
+program
+    .command('start')
+    .description('Start an isolated Claude session for a team')
+    .argument('<name>', 'Team slug (e.g. retrieval)')
+    .action((name) => {
+    runStart({ name }).catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+});
+// ── list ───────────────────────────────────────────────────────────────
+program
+    .command('list')
+    .description('List all teams and their worktree status')
+    .action(() => {
+    runList().catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+});
+// ── status ─────────────────────────────────────────────────────────────
+program
+    .command('status')
+    .description("Show a team's current leader-state memory")
+    .argument('<name>', 'Team slug (e.g. retrieval)')
+    .action((name) => {
+    runStatus({ name }).catch((err) => {
+        console.error(err instanceof Error ? err.message : String(err));
+        process.exit(1);
+    });
+});
+program.parse(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/catalog.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Reads and writes team catalog entries from mx-agent-system/teams/*.md.
+ */
+export interface TeamEntry {
+    /** Kebab-case slug, e.g. "retrieval" */
+    slug: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Path to the roleguide markdown file */
+    roleguide: string;
+    /** Named memory keys allocated for this team */
+    namedMemories: string[];
+}
+/**
+ * Derive a display name from the slug.
+ * e.g. "retrieval" → "Retrieval"
+ */
+export declare function slugToDisplayName(slug: string): string;
+/**
+ * Serialise a TeamEntry to markdown (matches the format of pipeline.md).
+ */
+export declare function serializeTeamEntry(entry: TeamEntry): string;
+/**
+ * Parse a team catalog file into a TeamEntry.
+ * Returns null if the file cannot be parsed.
+ */
+export declare function parseTeamEntry(filePath: string): TeamEntry | null;
+/**
+ * Return the path to the teams catalog directory.
+ */
+export declare function getTeamsCatalogDir(projectRoot: string): string;
+/**
+ * Return the path to a specific team's catalog file.
+ */
+export declare function getTeamCatalogPath(projectRoot: string, slug: string): string;
+/**
+ * List all teams from the catalog directory.
+ * Skips README.md.
+ */
+export declare function listTeams(projectRoot: string): TeamEntry[];
+/**
+ * Look up a single team entry by slug.
+ */
+export declare function getTeam(projectRoot: string, slug: string): TeamEntry | null;
+/**
+ * Write a team catalog entry (creates the file).
+ */
+export declare function writeTeamCatalog(projectRoot: string, entry: TeamEntry): void;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/lib/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/lib/catalog.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AASD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAW3D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CA+BjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAW1D;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI3E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAK5E"}