@bradygaster/squad-cli 0.9.4 → 0.9.5-insider.2

package/dist/cli/commands/preset.d.ts

@@ -0,0 +1,24 @@
+/**
+ * squad preset — manage squad presets (curated agent collections)
+ *
+ * Presets are saved to SQUAD_HOME/presets/ (default: ~/.squad/presets/).
+ * Each preset is a directory with a preset.json manifest + agents/ charters.
+ *
+ * Subcommands:
+ *   squad preset list           — list available presets
+ *   squad preset show <name>    — show preset details
+ *   squad preset apply <name>   — install preset agents into current squad
+ *   squad preset save <name>    — save current project agents as a preset
+ *   squad preset init           — initialize presets directory in squad home
+ *
+ * Note: Presets capture agents only (charters). For full squad snapshots
+ * including casting state, skills, and routing rules — e.g. to share a
+ * configured squad or publish to an agent toolbox — use `squad export`.
+ *
+ * @module cli/commands/preset
+ */
+/**
+ * Entry point for `squad preset` subcommands.
+ */
+export declare function runPreset(cwd: string, subcommand: string, args: string[]): Promise<void>;
+//# sourceMappingURL=preset.d.ts.map

package/dist/cli/commands/preset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preset.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/preset.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAWH;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9F"}

package/dist/cli/commands/preset.js

@@ -0,0 +1,352 @@
+/**
+ * squad preset — manage squad presets (curated agent collections)
+ *
+ * Presets are saved to SQUAD_HOME/presets/ (default: ~/.squad/presets/).
+ * Each preset is a directory with a preset.json manifest + agents/ charters.
+ *
+ * Subcommands:
+ *   squad preset list           — list available presets
+ *   squad preset show <name>    — show preset details
+ *   squad preset apply <name>   — install preset agents into current squad
+ *   squad preset save <name>    — save current project agents as a preset
+ *   squad preset init           — initialize presets directory in squad home
+ *
+ * Note: Presets capture agents only (charters). For full squad snapshots
+ * including casting state, skills, and routing rules — e.g. to share a
+ * configured squad or publish to an agent toolbox — use `squad export`.
+ *
+ * @module cli/commands/preset
+ */
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import { ensureSquadHome, resolvePresetsDir } from '@bradygaster/squad-sdk/resolution';
+import { listPresets, loadPreset, applyPreset, savePreset, seedBuiltinPresets } from '@bradygaster/squad-sdk/presets';
+import { resolveSquad } from '@bradygaster/squad-sdk/resolution';
+import { success, warn, info, BOLD, RESET, DIM } from '../core/output.js';
+import { fatal } from '../core/errors.js';
+/**
+ * Entry point for `squad preset` subcommands.
+ */
+export async function runPreset(cwd, subcommand, args) {
+    switch (subcommand) {
+        case 'list':
+            await presetList();
+            break;
+        case 'show': {
+            const name = args[0];
+            if (!name) {
+                fatal('Usage: squad preset show <name>');
+            }
+            await presetShow(name);
+            break;
+        }
+        case 'apply': {
+            const name = args[0];
+            if (!name) {
+                fatal('Usage: squad preset apply <name> [--force]');
+            }
+            const force = args.includes('--force');
+            await presetApply(cwd, name, force);
+            break;
+        }
+        case 'init': {
+            const remote = args.includes('--remote');
+            await presetInit(remote);
+            break;
+        }
+        case 'save': {
+            const name = args[0];
+            if (!name) {
+                fatal('Usage: squad preset save <name> [--force] [--description "..."]');
+            }
+            const force = args.includes('--force');
+            const descIdx = args.indexOf('--description');
+            const description = descIdx >= 0 ? args[descIdx + 1] : undefined;
+            await presetSave(cwd, name, force, description);
+            break;
+        }
+        default:
+            fatal(`Unknown preset subcommand: ${subcommand}\n` +
+                `Usage:\n` +
+                `  squad preset list\n` +
+                `  squad preset show <name>\n` +
+                `  squad preset apply <name> [--force]\n` +
+                `  squad preset save <name>\n` +
+                `  squad preset init [--remote]`);
+    }
+}
+// ============================================================================
+// Subcommand: init
+// ============================================================================
+async function presetInit(remote) {
+    if (remote) {
+        await presetInitRemote();
+        return;
+    }
+    const homeDir = ensureSquadHome();
+    const presetsDir = path.join(homeDir, 'presets');
+    const seeded = seedBuiltinPresets();
+    success('Presets directory initialized');
+    info(`  Path: ${presetsDir}`);
+    if (seeded.length > 0) {
+        info(`  Built-in presets installed: ${seeded.join(', ')}`);
+    }
+    info(`  Run 'squad preset list' to see available presets.`);
+    console.log();
+    info(`${DIM}Tip: Run 'squad preset init --remote' to back your squad home`);
+    info(`with a private GitHub repo so presets roam across machines.${RESET}`);
+}
+async function presetInitRemote() {
+    // Check gh CLI is available
+    try {
+        execSync('gh --version', { stdio: 'pipe' });
+    }
+    catch {
+        fatal('GitHub CLI (gh) is required for --remote. Install it: https://cli.github.com');
+    }
+    // Check gh auth
+    try {
+        execSync('gh auth status', { stdio: 'pipe' });
+    }
+    catch {
+        fatal('Not logged in to GitHub CLI. Run: gh auth login');
+    }
+    const os = await import('node:os');
+    const envHome = process.env['SQUAD_HOME'];
+    const homeDir = envHome ? path.resolve(envHome) : path.join(os.homedir(), '.squad');
+    const repoName = 'squad-home';
+    // Get GitHub username
+    let ghUser;
+    try {
+        ghUser = execSync('gh api user --jq .login', { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    }
+    catch {
+        fatal('Could not determine GitHub username. Run: gh auth login');
+        return;
+    }
+    const repoFullName = `${ghUser}/${repoName}`;
+    // Check if SQUAD_HOME is already a git repo
+    if (fs.existsSync(path.join(homeDir, '.git'))) {
+        info(`Squad home is already a git repo: ${homeDir}`);
+        const seeded = seedBuiltinPresets();
+        if (seeded.length > 0) {
+            info(`  Built-in presets installed: ${seeded.join(', ')}`);
+        }
+        success('Squad home ready — presets roam via git push/pull.');
+        return;
+    }
+    // If ~/.squad/ doesn't exist yet, try to clone existing remote repo
+    if (!fs.existsSync(homeDir)) {
+        let repoExists = false;
+        try {
+            execSync(`gh repo view ${repoFullName} --json name`, { stdio: 'pipe' });
+            repoExists = true;
+        }
+        catch {
+            repoExists = false;
+        }
+        if (repoExists) {
+            // Second machine — clone existing squad home
+            info(`Found existing repo ${repoFullName} — cloning...`);
+            try {
+                execSync(`gh repo clone ${repoFullName} "${homeDir}"`, { stdio: 'inherit' });
+                const seeded = seedBuiltinPresets();
+                if (seeded.length > 0) {
+                    info(`  New built-in presets added: ${seeded.join(', ')}`);
+                    try {
+                        execSync(`git -C "${homeDir}" add -A && git -C "${homeDir}" commit -m "seed built-in presets" --allow-empty`, { stdio: 'pipe' });
+                    }
+                    catch { /* nothing new to commit */ }
+                }
+                success(`Squad home cloned from ${repoFullName}`);
+                info(`  Path: ${homeDir}`);
+                success('Presets synced — you\'re ready to go.');
+                return;
+            }
+            catch {
+                fatal(`Failed to clone ${repoFullName}. Check permissions.`);
+            }
+        }
+        // Repo doesn't exist — create fresh
+        info(`Creating private repo ${repoFullName}...`);
+        try {
+            fs.mkdirSync(homeDir, { recursive: true });
+            execSync(`git init`, { cwd: homeDir, stdio: 'pipe' });
+            execSync(`gh repo create ${repoName} --private --source "${homeDir}" --push --description "Squad home — presets and config"`, {
+                stdio: 'inherit',
+            });
+        }
+        catch {
+            fatal(`Failed to create repo. Try manually: gh repo create ${repoName} --private`);
+        }
+    }
+    else {
+        // ~/.squad/ exists but isn't a git repo — init and connect
+        info(`Initializing git in existing squad home: ${homeDir}`);
+        execSync(`git init`, { cwd: homeDir, stdio: 'pipe' });
+        let repoExists = false;
+        try {
+            execSync(`gh repo view ${repoFullName} --json name`, { stdio: 'pipe' });
+            repoExists = true;
+        }
+        catch {
+            repoExists = false;
+        }
+        if (!repoExists) {
+            info(`Creating private repo ${repoFullName}...`);
+            try {
+                execSync(`gh repo create ${repoName} --private --source "${homeDir}" --push --description "Squad home — presets and config"`, {
+                    stdio: 'inherit',
+                });
+            }
+            catch {
+                fatal(`Failed to create repo ${repoFullName}.`);
+            }
+        }
+        else {
+            info(`Connecting to existing repo ${repoFullName}...`);
+            try {
+                execSync(`git remote add origin https://github.com/${repoFullName}.git`, { cwd: homeDir, stdio: 'pipe' });
+                execSync(`git pull origin main --allow-unrelated-histories`, { cwd: homeDir, stdio: 'pipe' });
+            }
+            catch {
+                warn('Could not pull from remote. You may need to resolve manually.');
+            }
+        }
+    }
+    // Seed built-in presets and push
+    const seeded = seedBuiltinPresets();
+    try {
+        execSync(`git -C "${homeDir}" add -A`, { stdio: 'pipe' });
+        execSync(`git -C "${homeDir}" commit -m "Initialize squad home with presets"`, { stdio: 'pipe' });
+        execSync(`git -C "${homeDir}" push -u origin main`, { stdio: 'pipe' });
+    }
+    catch {
+        // May fail if nothing to commit or push
+    }
+    success(`Squad home initialized with private repo: ${repoFullName}`);
+    info(`  Path: ${homeDir}`);
+    if (seeded.length > 0) {
+        info(`  Built-in presets installed: ${seeded.join(', ')}`);
+    }
+    console.log();
+    info(`On another machine, run the same command to sync your presets:`);
+    info(`  ${BOLD}squad preset init --remote${RESET}`);
+}
+// ============================================================================
+// Subcommand: list
+// ============================================================================
+async function presetList() {
+    const presetsDir = resolvePresetsDir();
+    if (!presetsDir) {
+        info('No presets directory found.');
+        info('  Run `squad preset init --remote` to set up with a GitHub repo (recommended).');
+        info('  Or `squad preset init` for local-only setup.');
+        return;
+    }
+    const presets = listPresets();
+    if (presets.length === 0) {
+        info(`Presets directory exists at ${presetsDir} but contains no presets.`);
+        info('  Create a preset directory with a preset.json manifest.');
+        return;
+    }
+    console.log(`\n${BOLD}Available Presets${RESET} (${presets.length}):\n`);
+    const maxNameLen = Math.max(...presets.map(p => p.name.length), 4);
+    console.log(`  ${'Name'.padEnd(maxNameLen)}  ` +
+        `${'Agents'}  ` +
+        `Description`);
+    console.log(`  ${'─'.repeat(maxNameLen)}  ` +
+        `${'─'.repeat(6)}  ` +
+        `${'─'.repeat(40)}`);
+    for (const preset of presets) {
+        console.log(`  ${preset.name.padEnd(maxNameLen)}  ` +
+            `${String(preset.agents.length).padEnd(6)}  ` +
+            `${DIM}${preset.description}${RESET}`);
+    }
+    console.log();
+}
+// ============================================================================
+// Subcommand: show
+// ============================================================================
+async function presetShow(name) {
+    const preset = loadPreset(name);
+    if (!preset) {
+        fatal(`Preset '${name}' not found. Run 'squad preset list' to see available presets.`);
+    }
+    console.log(`\n${BOLD}${preset.name}${RESET} v${preset.version}`);
+    console.log(`  ${preset.description}`);
+    if (preset.author)
+        console.log(`  Author: ${preset.author}`);
+    if (preset.tags?.length)
+        console.log(`  Tags: ${preset.tags.join(', ')}`);
+    console.log(`\n  ${BOLD}Agents${RESET} (${preset.agents.length}):`);
+    for (const agent of preset.agents) {
+        console.log(`    • ${BOLD}${agent.name}${RESET} (${agent.role})${agent.description ? ` — ${DIM}${agent.description}${RESET}` : ''}`);
+    }
+    console.log();
+}
+// ============================================================================
+// Subcommand: apply
+// ============================================================================
+async function presetApply(cwd, name, force) {
+    // Find target squad directory
+    const squadDir = resolveSquad(cwd);
+    if (!squadDir) {
+        fatal('No .squad/ directory found. Run `squad init` first, or use from a repo with a squad.');
+    }
+    const targetAgentsDir = path.join(squadDir, 'agents');
+    const results = applyPreset(name, targetAgentsDir, { force });
+    if (results.length === 1 && results[0].status === 'error' && results[0].agent === name) {
+        fatal(results[0].reason ?? `Failed to apply preset '${name}'`);
+    }
+    let installed = 0;
+    let skipped = 0;
+    let errors = 0;
+    for (const result of results) {
+        switch (result.status) {
+            case 'installed':
+                success(`  ${result.agent}`);
+                installed++;
+                break;
+            case 'skipped':
+                warn(`  ${result.agent} — ${result.reason}`);
+                skipped++;
+                break;
+            case 'error':
+                console.error(`  ✗ ${result.agent} — ${result.reason}`);
+                errors++;
+                break;
+        }
+    }
+    console.log();
+    if (installed > 0)
+        success(`Applied preset '${name}': ${installed} agents installed`);
+    if (skipped > 0)
+        info(`  ${skipped} agents skipped (already exist)`);
+    if (errors > 0)
+        warn(`  ${errors} agents had errors`);
+}
+// ============================================================================
+// Subcommand: save
+// ============================================================================
+async function presetSave(cwd, name, force, description) {
+    const squadDir = resolveSquad(cwd);
+    if (!squadDir) {
+        fatal('No .squad/ directory found. Initialize a squad first with `squad init`.');
+    }
+    try {
+        const destDir = savePreset(name, squadDir, { force, description });
+        success(`Preset '${name}' saved`);
+        info(`  Location: ${destDir}`);
+        info(`  Use it in any project: squad preset apply ${name}`);
+        console.log();
+        info(`${DIM}Tip: Presets save agents only (charters). For a full squad snapshot`);
+        info(`including casting state, skills, and routing rules — e.g. to share`);
+        info(`a configured squad or publish to an agent toolbox — use 'squad export'.${RESET}`);
+    }
+    catch (err) {
+        fatal(String(err));
+    }
+}
+//# sourceMappingURL=preset.js.map

package/dist/cli/commands/preset.js.map

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

package/dist/cli-entry.js

@@ -139,6 +139,7 @@ async function main() {
         console.log(`                    --roles (use base roles)`);
         console.log(`                    --global (personal squad dir)`);
         console.log(`                    --no-workflows (skip CI setup)`);
+        console.log(`                    --preset <name> (apply a preset after init)`);
         console.log(`             Usage: init --mode remote <team-repo-path>`);
         console.log(`             Creates .squad/config.json pointing to an external team root`);
         console.log(`  ${BOLD}upgrade${RESET}    Update Squad-owned files to latest version`);
@@ -220,6 +221,10 @@ async function main() {
         console.log(`  ${BOLD}personal${RESET}   Manage your personal squad (ambient agents)`);
         console.log(`             Usage: personal init | list | add <name>`);
         console.log(`                    --role <role> | remove <name>`);
+        console.log(`  ${BOLD}preset${RESET}     Manage squad presets (curated agent collections)`);
+        console.log(`             Usage: preset list | show <name>`);
+        console.log(`                    apply <name> [--force] | save <name>`);
+        console.log(`                    init [--remote]`);
         console.log(`  ${BOLD}cast${RESET}       Show current session cast (project + personal agents)`);
         console.log(`  ${BOLD}rc${RESET}         Start Remote Control bridge (phone/browser → Copilot)`);
         console.log(`             Usage: rc [--tunnel] [--port <n>] [--path <dir>]`);
@@ -286,8 +291,41 @@ async function main() {
         const noWorkflows = args.includes('--no-workflows');
         const sdk = args.includes('--sdk');
         const roles = args.includes('--roles');
+        const presetIdx = args.indexOf('--preset');
+        const presetName = (presetIdx !== -1 && args[presetIdx + 1]) ? args[presetIdx + 1] : undefined;
         // Global init: suppress workflows (no GitHub CI in ~/.config/squad/) and bootstrap personal squad
-        runInit(dest, { includeWorkflows: !noWorkflows && !hasGlobal, sdk, roles, isGlobal: hasGlobal }).catch(err => {
+        runInit(dest, { includeWorkflows: !noWorkflows && !hasGlobal, sdk, roles, isGlobal: hasGlobal }).then(async () => {
+            if (presetName) {
+                const { seedBuiltinPresets, applyPreset } = await import('@bradygaster/squad-sdk/presets');
+                const { resolvePresetsDir, ensureSquadHome } = await import('@bradygaster/squad-sdk/resolution');
+                const nodePath = await import('node:path');
+                // Auto-initialize squad home + presets if they don't exist yet
+                if (!resolvePresetsDir()) {
+                    console.log(`\n⚙️  No presets found — setting up squad home...`);
+                    ensureSquadHome();
+                    seedBuiltinPresets();
+                    console.log(`✅ Squad home initialized at ${ensureSquadHome()}`);
+                    console.log(`   Built-in presets ready. Run 'squad preset init --remote' to back with a GitHub repo.\n`);
+                }
+                else {
+                    seedBuiltinPresets();
+                }
+                const targetAgentsDir = nodePath.join(dest, '.squad', 'agents');
+                const results = applyPreset(presetName, targetAgentsDir);
+                const installed = results.filter(r => r.status === 'installed');
+                const skipped = results.filter(r => r.status === 'skipped');
+                const errors = results.filter(r => r.status === 'error');
+                if (installed.length > 0) {
+                    console.log(`✅ Applied preset '${presetName}': ${installed.length} agents installed`);
+                }
+                if (skipped.length > 0) {
+                    console.log(`   ${skipped.length} agents skipped (already exist)`);
+                }
+                if (errors.length > 0 && installed.length === 0) {
+                    console.error(`❌ Preset '${presetName}' not found. Run 'squad preset list' to see available presets.`);
+                }
+            }
+        }).catch(err => {
             fatal(err.message);
         });
         return;
@@ -813,16 +851,17 @@ async function main() {
         await runPersonal(getSquadStartDir(), subcommand, args.slice(2));
         return;
     }
+    if (cmd === 'preset') {
+        const { runPreset } = await import('./cli/commands/preset.js');
+        const subcommand = args[1] || 'list';
+        await runPreset(getSquadStartDir(), subcommand, args.slice(2));
+        return;
+    }
     if (cmd === 'cast') {
         const { runCast } = await import('./cli/commands/cast.js');
         await runCast(getSquadStartDir());
         return;
     }
-    if (cmd === 'skill') {
-        const { runSkill } = await import('./cli/commands/skill.js');
-        await runSkill(getSquadStartDir(), args.slice(1));
-        return;
-    }
     if (cmd === 'upstream') {
         const { upstreamCommand } = await import('./cli/commands/upstream.js');
         await upstreamCommand(args.slice(1));