@bradygaster/squad-cli 0.9.5-insider.1 → 0.9.6-insider.1

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/commands/sync.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Squad Sync — synchronizes squad-state branches and git notes with a remote.
+ *
+ * Used directly (`squad sync`) or invoked by git hooks (pre-push, post-merge, post-rewrite).
+ * Handles both orphan and two-layer backends transparently.
+ *
+ * Design:
+ * - Fetches remote squad-state branch(es) and fast-forwards local refs
+ * - Pushes local squad-state branch(es) to remote
+ * - For two-layer, also syncs refs/notes/squad* namespaces
+ * - Uses fast-forward-only semantics to avoid data loss on divergence
+ * - Recursion guard via SQUAD_SYNC_ACTIVE env var
+ */
+export interface SyncOptions {
+    direction: 'push' | 'pull' | 'both';
+    remote?: string;
+    cwd?: string;
+    quiet?: boolean;
+}
+/**
+ * Main sync entrypoint.
+ */
+export declare function runSync(options: SyncOptions): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AASH,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AA2MD;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BjE"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,257 @@
+/**
+ * Squad Sync — synchronizes squad-state branches and git notes with a remote.
+ *
+ * Used directly (`squad sync`) or invoked by git hooks (pre-push, post-merge, post-rewrite).
+ * Handles both orphan and two-layer backends transparently.
+ *
+ * Design:
+ * - Fetches remote squad-state branch(es) and fast-forwards local refs
+ * - Pushes local squad-state branch(es) to remote
+ * - For two-layer, also syncs refs/notes/squad* namespaces
+ * - Uses fast-forward-only semantics to avoid data loss on divergence
+ * - Recursion guard via SQUAD_SYNC_ACTIVE env var
+ */
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+const SQUAD_SYNC_ENV = 'SQUAD_SYNC_ACTIVE';
+const STATE_BRANCH_PREFIX = 'squad-state';
+/**
+ * Detect the configured state backend from .squad/config.json
+ */
+function detectBackend(cwd) {
+    try {
+        const configPath = path.join(cwd, '.squad', 'config.json');
+        const raw = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(raw);
+        return config.stateBackend || null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get git repo root for the given working directory.
+ */
+function getRepoRoot(cwd) {
+    return execFileSync('git', ['rev-parse', '--show-toplevel'], {
+        cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+}
+/**
+ * Discover all local squad-state branches (supports subsquads).
+ * Uses strict prefix matching: squad-state or squad-state/<name>
+ */
+function discoverStateBranches(cwd) {
+    try {
+        const output = execFileSync('git', ['for-each-ref', '--format=%(refname:short)', `refs/heads/${STATE_BRANCH_PREFIX}`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const exact = output ? output.split('\n').filter(Boolean) : [];
+        // Also find squad-state/* (subsquad branches)
+        const subOutput = execFileSync('git', ['for-each-ref', '--format=%(refname:short)', `refs/heads/${STATE_BRANCH_PREFIX}/`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const subs = subOutput ? subOutput.split('\n').filter(Boolean) : [];
+        return [...exact, ...subs];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover remote squad-state branches.
+ */
+function discoverRemoteStateBranches(cwd, remote) {
+    try {
+        const output = execFileSync('git', ['for-each-ref', '--format=%(refname:short)', `refs/remotes/${remote}/${STATE_BRANCH_PREFIX}`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const exact = output ? output.split('\n').filter(Boolean) : [];
+        const subOutput = execFileSync('git', ['for-each-ref', '--format=%(refname:short)', `refs/remotes/${remote}/${STATE_BRANCH_PREFIX}/`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const subs = subOutput ? subOutput.split('\n').filter(Boolean) : [];
+        return [...exact, ...subs];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Resolve the default remote for the current branch (or fallback to 'origin').
+ */
+function resolveRemote(cwd) {
+    try {
+        const branch = execFileSync('git', ['symbolic-ref', '--short', 'HEAD'], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        const remote = execFileSync('git', ['config', `branch.${branch}.remote`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return remote || 'origin';
+    }
+    catch {
+        return 'origin';
+    }
+}
+/**
+ * Pull: fetch remote state branches and fast-forward local refs.
+ */
+function syncPull(cwd, remote, backend, quiet) {
+    // Fetch squad-state refs from remote
+    try {
+        execFileSync('git', ['fetch', remote, `+refs/heads/${STATE_BRANCH_PREFIX}:refs/remotes/${remote}/${STATE_BRANCH_PREFIX}`, `+refs/heads/${STATE_BRANCH_PREFIX}/*:refs/remotes/${remote}/${STATE_BRANCH_PREFIX}/*`], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch {
+        // Remote may not have these refs yet — not an error
+        if (!quiet)
+            console.log('  No remote squad-state refs found (first push will create them).');
+        return;
+    }
+    // Fast-forward local branches from remote-tracking refs
+    const remoteBranches = discoverRemoteStateBranches(cwd, remote);
+    for (const remoteBranch of remoteBranches) {
+        // remoteBranch is like "origin/squad-state" — extract local name
+        const localName = remoteBranch.replace(`${remote}/`, '');
+        const localRef = `refs/heads/${localName}`;
+        const remoteRef = `refs/remotes/${remoteBranch}`;
+        try {
+            // Check if local branch exists
+            execFileSync('git', ['rev-parse', '--verify', localRef], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            // Local exists — try fast-forward
+            const localSha = execFileSync('git', ['rev-parse', localRef], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            const remoteSha = execFileSync('git', ['rev-parse', remoteRef], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            if (localSha === remoteSha)
+                continue; // Already up-to-date
+            // Check if fast-forward is possible (local is ancestor of remote)
+            try {
+                execFileSync('git', ['merge-base', '--is-ancestor', localSha, remoteSha], {
+                    cwd, stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                // Fast-forward: update local ref
+                execFileSync('git', ['update-ref', localRef, remoteSha], {
+                    cwd, stdio: ['pipe', 'pipe', 'pipe'],
+                });
+                if (!quiet)
+                    console.log(`  ✓ ${localName}: fast-forwarded`);
+            }
+            catch {
+                // Diverged — cannot fast-forward
+                if (!quiet)
+                    console.log(`  ⚠ ${localName}: diverged from remote (manual merge needed)`);
+            }
+        }
+        catch {
+            // Local branch doesn't exist — create it tracking the remote
+            const remoteSha = execFileSync('git', ['rev-parse', remoteRef], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            execFileSync('git', ['update-ref', localRef, remoteSha], {
+                cwd, stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            if (!quiet)
+                console.log(`  ✓ ${localName}: created from remote`);
+        }
+    }
+    // For two-layer: also fetch notes
+    if (backend === 'two-layer') {
+        try {
+            execFileSync('git', ['fetch', remote, '+refs/notes/squad*:refs/notes/squad*'], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            if (!quiet)
+                console.log('  ✓ notes synced');
+        }
+        catch {
+            // Notes may not exist yet
+        }
+    }
+}
+/**
+ * Push: push local state branches to remote.
+ */
+function syncPush(cwd, remote, backend, quiet) {
+    const branches = discoverStateBranches(cwd);
+    if (branches.length === 0) {
+        if (!quiet)
+            console.log('  No local squad-state branches to push.');
+        return;
+    }
+    // Build refspecs for all state branches
+    const refspecs = branches.map(b => `refs/heads/${b}:refs/heads/${b}`);
+    try {
+        execFileSync('git', ['push', '--no-verify', remote, ...refspecs], {
+            cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (!quiet)
+            console.log(`  ✓ pushed: ${branches.join(', ')}`);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.stderr || err.message : String(err);
+        if (msg.includes('non-fast-forward')) {
+            if (!quiet)
+                console.log(`  ⚠ push rejected (non-fast-forward). Run 'squad sync --pull' first.`);
+        }
+        else {
+            if (!quiet)
+                console.log(`  ⚠ push failed: ${msg}`);
+        }
+    }
+    // For two-layer: also push notes
+    if (backend === 'two-layer') {
+        try {
+            execFileSync('git', ['push', '--no-verify', remote, 'refs/notes/squad*:refs/notes/squad*'], {
+                cwd, encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            if (!quiet)
+                console.log('  ✓ notes pushed');
+        }
+        catch {
+            // Notes may not exist yet — not an error
+        }
+    }
+}
+/**
+ * Main sync entrypoint.
+ */
+export async function runSync(options) {
+    // Recursion guard — prevent re-entry when our push triggers pre-push
+    if (process.env[SQUAD_SYNC_ENV]) {
+        return;
+    }
+    process.env[SQUAD_SYNC_ENV] = '1';
+    try {
+        const cwd = options.cwd || process.cwd();
+        const repoRoot = getRepoRoot(cwd);
+        const remote = options.remote || resolveRemote(repoRoot);
+        const backend = detectBackend(repoRoot);
+        const quiet = options.quiet ?? false;
+        // Skip sync for backends that don't need it
+        if (backend === 'local' || backend === 'external' || backend === null) {
+            if (!quiet)
+                console.log(`squad sync: backend is '${backend || 'local'}' — no remote sync needed.`);
+            return;
+        }
+        if (!quiet)
+            console.log(`squad sync: ${options.direction} (remote: ${remote}, backend: ${backend || 'orphan'})`);
+        if (options.direction === 'pull' || options.direction === 'both') {
+            syncPull(repoRoot, remote, backend, quiet);
+        }
+        if (options.direction === 'push' || options.direction === 'both') {
+            syncPush(repoRoot, remote, backend, quiet);
+        }
+    }
+    finally {
+        delete process.env[SQUAD_SYNC_ENV];
+    }
+}
+//# sourceMappingURL=sync.js.map