@bradygaster/squad-cli 0.8.1 → 0.8.3

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

@@ -0,0 +1,19 @@
+/**
+ * Aspire command — Launch .NET Aspire dashboard for Squad observability
+ * (Issue #265)
+ *
+ * Starts the Aspire dashboard and configures OTLP export so Squad
+ * traces and metrics flow into the dashboard automatically.
+ */
+export interface AspireOptions {
+    /** Use Docker even if dotnet is available */
+    docker?: boolean;
+    /** Custom OTLP endpoint port */
+    port?: number;
+}
+/**
+ * Run the `squad aspire` command.
+ * Launches the Aspire dashboard and configures OTLP export.
+ */
+export declare function runAspire(options?: AspireOptions): Promise<void>;
+//# sourceMappingURL=aspire.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aspire.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/aspire.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyFH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoE1E"}

package/dist/cli/commands/aspire.js

@@ -0,0 +1,151 @@
+/**
+ * Aspire command — Launch .NET Aspire dashboard for Squad observability
+ * (Issue #265)
+ *
+ * Starts the Aspire dashboard and configures OTLP export so Squad
+ * traces and metrics flow into the dashboard automatically.
+ */
+import { execSync, spawn } from 'node:child_process';
+import { BOLD, RESET, DIM, GREEN, RED, YELLOW } from '../core/output.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/** Default OTLP endpoint the Aspire dashboard listens on. */
+const ASPIRE_OTLP_ENDPOINT = 'http://localhost:18888';
+/** Default Aspire dashboard UI port. */
+const ASPIRE_DASHBOARD_PORT = 18888;
+/** Docker image for the Aspire dashboard. */
+const ASPIRE_DOCKER_IMAGE = 'mcr.microsoft.com/dotnet/aspire-dashboard:latest';
+// ============================================================================
+// Detection helpers
+// ============================================================================
+function commandExists(cmd) {
+    try {
+        execSync(`${cmd} --version`, { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isDotnetAspireAvailable() {
+    if (!commandExists('dotnet'))
+        return false;
+    try {
+        const output = execSync('dotnet tool list -g', { encoding: 'utf8' });
+        if (output.toLowerCase().includes('aspire'))
+            return true;
+    }
+    catch {
+        // Ignore
+    }
+    try {
+        const workloads = execSync('dotnet workload list', { encoding: 'utf8' });
+        if (workloads.toLowerCase().includes('aspire'))
+            return true;
+    }
+    catch {
+        // Ignore
+    }
+    return false;
+}
+function isDockerAvailable() {
+    return commandExists('docker');
+}
+// ============================================================================
+// Launch strategies
+// ============================================================================
+function launchWithDocker() {
+    console.log(`${DIM}Starting Aspire dashboard via Docker...${RESET}`);
+    const child = spawn('docker', [
+        'run', '--rm',
+        '-p', `${ASPIRE_DASHBOARD_PORT}:18888`,
+        '-p', '4317:18889',
+        '-e', 'DASHBOARD__FRONTEND__AUTHMODE=Unsecured',
+        '-e', 'DASHBOARD__OTLP__AUTHMODE=ApiKey',
+        '-e', 'DASHBOARD__OTLP__PRIMARYAPIKEY=squad-dev-key',
+        ASPIRE_DOCKER_IMAGE,
+    ], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: false,
+    });
+    return child;
+}
+function launchWithDotnet() {
+    console.log(`${DIM}Starting Aspire dashboard via dotnet...${RESET}`);
+    const child = spawn('dotnet', [
+        'run', '--project', 'aspire',
+        '--', '--dashboard-port', String(ASPIRE_DASHBOARD_PORT),
+    ], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        detached: false,
+    });
+    return child;
+}
+/**
+ * Run the `squad aspire` command.
+ * Launches the Aspire dashboard and configures OTLP export.
+ */
+export async function runAspire(options = {}) {
+    const port = options.port ?? ASPIRE_DASHBOARD_PORT;
+    const endpoint = `http://localhost:${port}`;
+    console.log(`\n${BOLD}🔭 Squad Aspire — OpenTelemetry Dashboard${RESET}\n`);
+    // Set OTLP environment so OTel providers pick it up
+    process.env['OTEL_EXPORTER_OTLP_ENDPOINT'] = endpoint;
+    console.log(`${DIM}OTLP endpoint: ${endpoint}${RESET}`);
+    // Determine launch strategy
+    const useDocker = options.docker || !isDotnetAspireAvailable();
+    let child;
+    if (useDocker && isDockerAvailable()) {
+        child = launchWithDocker();
+    }
+    else if (!useDocker && isDotnetAspireAvailable()) {
+        child = launchWithDotnet();
+    }
+    else if (isDockerAvailable()) {
+        child = launchWithDocker();
+    }
+    else {
+        console.log(`${RED}✗${RESET} Neither Docker nor .NET Aspire workload found.`);
+        console.log(`\n  Install options:`);
+        console.log(`    ${BOLD}Docker:${RESET}  https://docker.com/get-started`);
+        console.log(`    ${BOLD}Aspire:${RESET}  dotnet workload install aspire\n`);
+        return;
+    }
+    // Wire up output
+    child.stdout?.on('data', (data) => {
+        const text = data.toString().trim();
+        if (text)
+            console.log(`${DIM}[aspire]${RESET} ${text}`);
+    });
+    child.stderr?.on('data', (data) => {
+        const text = data.toString().trim();
+        if (text)
+            console.log(`${YELLOW}[aspire]${RESET} ${text}`);
+    });
+    child.on('error', (err) => {
+        console.error(`${RED}✗${RESET} Failed to start Aspire: ${err.message}`);
+    });
+    // Give the dashboard a moment to start
+    await new Promise((resolve) => setTimeout(resolve, 2000));
+    console.log(`\n${GREEN}✓${RESET} Aspire dashboard launching`);
+    console.log(`  ${BOLD}Dashboard:${RESET}  http://localhost:${port}`);
+    console.log(`  ${BOLD}OTLP gRPC:${RESET}  localhost:4317`);
+    console.log(`\n${DIM}Squad OTel will automatically export to this endpoint.${RESET}`);
+    console.log(`${DIM}Press Ctrl+C to stop.${RESET}\n`);
+    // Keep alive until Ctrl+C
+    return new Promise((resolve) => {
+        const shutdown = () => {
+            console.log(`\n${DIM}🔭 Aspire dashboard stopping...${RESET}`);
+            child?.kill();
+            resolve();
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        child?.on('close', () => {
+            console.log(`${DIM}Aspire process exited.${RESET}`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=aspire.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * squad doctor — setup validation diagnostic command.
+ *
+ * Inspects the .squad/ directory (or hub layout) and reports
+ * the health of every expected file / convention. Always exits 0
+ * because this is a diagnostic tool, not a gate.
+ *
+ * Inspired by @spboyer (Shayne Boyer)'s doctor command in PR bradygaster/squad#131.
+ *
+ * @module cli/commands/doctor
+ */
+/** Result of a single diagnostic check. */
+export interface DoctorCheck {
+    name: string;
+    status: 'pass' | 'fail' | 'warn';
+    message: string;
+}
+/** Detected squad layout mode. */
+export type DoctorMode = 'local' | 'remote' | 'hub';
+/**
+ * Run all doctor checks for the given working directory.
+ * Returns an array of check results — never throws for check failures.
+ */
+export declare function runDoctor(cwd?: string): Promise<DoctorCheck[]>;
+/**
+ * Detect the squad mode for the given working directory.
+ * Exported for tests and display.
+ */
+export declare function getDoctorMode(cwd?: string): DoctorMode;
+/**
+ * Print doctor results to stdout. Intended for CLI use.
+ */
+export declare function printDoctorReport(checks: DoctorCheck[], mode: DoctorMode): void;
+/**
+ * CLI entry point — run doctor and print results.
+ */
+export declare function doctorCommand(cwd?: string): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAkMpD;;;GAGG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CA+BpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,UAAU,CAEtD;AAUD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAc/E;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK/D"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,247 @@
+/**
+ * squad doctor — setup validation diagnostic command.
+ *
+ * Inspects the .squad/ directory (or hub layout) and reports
+ * the health of every expected file / convention. Always exits 0
+ * because this is a diagnostic tool, not a gate.
+ *
+ * Inspired by @spboyer (Shayne Boyer)'s doctor command in PR bradygaster/squad#131.
+ *
+ * @module cli/commands/doctor
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+// ── helpers ─────────────────────────────────────────────────────────
+function fileExists(p) {
+    return fs.existsSync(p);
+}
+function isDirectory(p) {
+    try {
+        return fs.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function tryReadJson(p) {
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf8'));
+    }
+    catch {
+        return undefined;
+    }
+}
+// ── mode detection ──────────────────────────────────────────────────
+function detectMode(cwd) {
+    const squadDir = path.join(cwd, '.squad');
+    const configPath = path.join(squadDir, 'config.json');
+    // Remote mode: config.json exists with teamRoot
+    if (fileExists(configPath)) {
+        const cfg = tryReadJson(configPath);
+        if (cfg && typeof cfg === 'object' && 'teamRoot' in cfg) {
+            const raw = cfg['teamRoot'];
+            if (typeof raw === 'string' && raw.length > 0) {
+                return { mode: 'remote', squadDir, teamRoot: raw };
+            }
+        }
+    }
+    // Hub mode: squad-hub.json in cwd
+    if (fileExists(path.join(cwd, 'squad-hub.json'))) {
+        return { mode: 'hub', squadDir };
+    }
+    // Default: local
+    return { mode: 'local', squadDir };
+}
+// ── individual checks ───────────────────────────────────────────────
+function checkSquadDir(squadDir) {
+    const exists = isDirectory(squadDir);
+    return {
+        name: '.squad/ directory exists',
+        status: exists ? 'pass' : 'fail',
+        message: exists ? 'directory present' : 'directory not found',
+    };
+}
+function checkConfigJson(squadDir) {
+    const configPath = path.join(squadDir, 'config.json');
+    if (!fileExists(configPath))
+        return undefined; // optional file — skip
+    const data = tryReadJson(configPath);
+    if (data === undefined) {
+        return {
+            name: 'config.json valid',
+            status: 'fail',
+            message: 'file exists but is not valid JSON',
+        };
+    }
+    if (typeof data === 'object' &&
+        data !== null &&
+        'teamRoot' in data &&
+        typeof data['teamRoot'] !== 'string') {
+        return {
+            name: 'config.json valid',
+            status: 'fail',
+            message: 'teamRoot must be a string',
+        };
+    }
+    return {
+        name: 'config.json valid',
+        status: 'pass',
+        message: 'parses as JSON, schema OK',
+    };
+}
+function checkAbsoluteTeamRoot(squadDir) {
+    const configPath = path.join(squadDir, 'config.json');
+    if (!fileExists(configPath))
+        return undefined;
+    const data = tryReadJson(configPath);
+    if (!data || typeof data['teamRoot'] !== 'string')
+        return undefined;
+    const teamRoot = data['teamRoot'];
+    if (path.isAbsolute(teamRoot)) {
+        return {
+            name: 'absolute path warning',
+            status: 'warn',
+            message: `teamRoot is absolute (${teamRoot}) — prefer relative paths for portability`,
+        };
+    }
+    return undefined;
+}
+function checkTeamRootResolves(squadDir, teamRoot) {
+    const resolved = path.isAbsolute(teamRoot)
+        ? teamRoot
+        : path.resolve(path.dirname(squadDir), teamRoot);
+    const exists = isDirectory(resolved);
+    return {
+        name: 'team root resolves',
+        status: exists ? 'pass' : 'fail',
+        message: exists ? `resolved to ${resolved}` : `directory not found: ${resolved}`,
+    };
+}
+function checkTeamMd(squadDir) {
+    const teamPath = path.join(squadDir, 'team.md');
+    if (!fileExists(teamPath)) {
+        return { name: 'team.md found with ## Members header', status: 'fail', message: 'file not found' };
+    }
+    const content = fs.readFileSync(teamPath, 'utf8');
+    if (!content.includes('## Members')) {
+        return { name: 'team.md found with ## Members header', status: 'warn', message: 'file exists but missing ## Members header' };
+    }
+    return { name: 'team.md found with ## Members header', status: 'pass', message: 'file present, header found' };
+}
+function checkRoutingMd(squadDir) {
+    const exists = fileExists(path.join(squadDir, 'routing.md'));
+    return {
+        name: 'routing.md found',
+        status: exists ? 'pass' : 'fail',
+        message: exists ? 'file present' : 'file not found',
+    };
+}
+function checkAgentsDir(squadDir) {
+    const agentsDir = path.join(squadDir, 'agents');
+    if (!isDirectory(agentsDir)) {
+        return { name: 'agents/ directory exists', status: 'fail', message: 'directory not found' };
+    }
+    let count = 0;
+    try {
+        for (const entry of fs.readdirSync(agentsDir, { withFileTypes: true })) {
+            if (entry.isDirectory())
+                count++;
+        }
+    }
+    catch { /* empty */ }
+    return {
+        name: 'agents/ directory exists',
+        status: 'pass',
+        message: `directory present (${count} agent${count === 1 ? '' : 's'})`,
+    };
+}
+function checkCastingRegistry(squadDir) {
+    const registryPath = path.join(squadDir, 'casting', 'registry.json');
+    if (!fileExists(registryPath)) {
+        return { name: 'casting/registry.json exists', status: 'fail', message: 'file not found' };
+    }
+    const data = tryReadJson(registryPath);
+    if (data === undefined) {
+        return { name: 'casting/registry.json exists', status: 'fail', message: 'file exists but is not valid JSON' };
+    }
+    return { name: 'casting/registry.json exists', status: 'pass', message: 'file present, valid JSON' };
+}
+function checkDecisionsMd(squadDir) {
+    const exists = fileExists(path.join(squadDir, 'decisions.md'));
+    return {
+        name: 'decisions.md exists',
+        status: exists ? 'pass' : 'fail',
+        message: exists ? 'file present' : 'file not found',
+    };
+}
+// ── public API ──────────────────────────────────────────────────────
+/**
+ * Run all doctor checks for the given working directory.
+ * Returns an array of check results — never throws for check failures.
+ */
+export async function runDoctor(cwd) {
+    const resolvedCwd = cwd ?? process.cwd();
+    const { mode, squadDir, teamRoot } = detectMode(resolvedCwd);
+    const checks = [];
+    // 1. .squad/ directory
+    checks.push(checkSquadDir(squadDir));
+    // 2. config.json (if present)
+    const configCheck = checkConfigJson(squadDir);
+    if (configCheck)
+        checks.push(configCheck);
+    // 3. Absolute path warning
+    const absWarn = checkAbsoluteTeamRoot(squadDir);
+    if (absWarn)
+        checks.push(absWarn);
+    // 4. Remote team root resolution
+    if (mode === 'remote' && teamRoot) {
+        checks.push(checkTeamRootResolves(squadDir, teamRoot));
+    }
+    // 5–9 standard files (only if .squad/ exists)
+    if (isDirectory(squadDir)) {
+        checks.push(checkTeamMd(squadDir));
+        checks.push(checkRoutingMd(squadDir));
+        checks.push(checkAgentsDir(squadDir));
+        checks.push(checkCastingRegistry(squadDir));
+        checks.push(checkDecisionsMd(squadDir));
+    }
+    return checks;
+}
+/**
+ * Detect the squad mode for the given working directory.
+ * Exported for tests and display.
+ */
+export function getDoctorMode(cwd) {
+    return detectMode(cwd ?? process.cwd()).mode;
+}
+// ── CLI output ──────────────────────────────────────────────────────
+const STATUS_ICON = {
+    pass: '✅',
+    fail: '❌',
+    warn: '⚠️',
+};
+/**
+ * Print doctor results to stdout. Intended for CLI use.
+ */
+export function printDoctorReport(checks, mode) {
+    console.log('\n🩺 Squad Doctor');
+    console.log('═══════════════\n');
+    console.log(`Mode: ${mode}\n`);
+    for (const c of checks) {
+        console.log(`${STATUS_ICON[c.status]}  ${c.name} — ${c.message}`);
+    }
+    const passed = checks.filter(c => c.status === 'pass').length;
+    const failed = checks.filter(c => c.status === 'fail').length;
+    const warned = checks.filter(c => c.status === 'warn').length;
+    console.log(`\nSummary: ${passed} passed, ${failed} failed, ${warned} warnings\n`);
+}
+/**
+ * CLI entry point — run doctor and print results.
+ */
+export async function doctorCommand(cwd) {
+    const resolvedCwd = cwd ?? process.cwd();
+    const mode = getDoctorMode(resolvedCwd);
+    const checks = await runDoctor(resolvedCwd);
+    printDoctorReport(checks, mode);
+}
+//# sourceMappingURL=doctor.js.map

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

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

package/dist/cli/commands/init-remote.d.ts

@@ -0,0 +1,18 @@
+/**
+ * squad init --mode remote — remote mode variant of the init command.
+ *
+ * Creates .squad/ with config.json pointing to an external team root.
+ * The standard init scaffolding still runs; this just adds the config link.
+ *
+ * Remote squad mode concept by @spboyer (Shayne Boyer), PR bradygaster/squad#131.
+ *
+ * @module cli/commands/init-remote
+ */
+/**
+ * Write `.squad/config.json` for remote mode.
+ *
+ * @param projectDir - Project root (where .squad/ lives or will be created).
+ * @param teamRepoPath - Absolute or relative path to the team repo.
+ */
+export declare function writeRemoteConfig(projectDir: string, teamRepoPath: string): void;
+//# sourceMappingURL=init-remote.d.ts.map

package/dist/cli/commands/init-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-remote.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAmBhF"}

package/dist/cli/commands/init-remote.js

@@ -0,0 +1,32 @@
+/**
+ * squad init --mode remote — remote mode variant of the init command.
+ *
+ * Creates .squad/ with config.json pointing to an external team root.
+ * The standard init scaffolding still runs; this just adds the config link.
+ *
+ * Remote squad mode concept by @spboyer (Shayne Boyer), PR bradygaster/squad#131.
+ *
+ * @module cli/commands/init-remote
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Write `.squad/config.json` for remote mode.
+ *
+ * @param projectDir - Project root (where .squad/ lives or will be created).
+ * @param teamRepoPath - Absolute or relative path to the team repo.
+ */
+export function writeRemoteConfig(projectDir, teamRepoPath) {
+    const squadDir = path.join(projectDir, '.squad');
+    fs.mkdirSync(squadDir, { recursive: true });
+    // Always store a relative path from the project root to the team repo
+    const absoluteTeam = path.resolve(projectDir, teamRepoPath);
+    const relativePath = path.relative(projectDir, absoluteTeam);
+    const config = {
+        version: 1,
+        teamRoot: relativePath,
+        projectKey: null,
+    };
+    fs.writeFileSync(path.join(squadDir, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+//# sourceMappingURL=init-remote.js.map

package/dist/cli/commands/init-remote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-remote.js","sourceRoot":"","sources":["../../../src/cli/commands/init-remote.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB,EAAE,YAAoB;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,sEAAsE;IACtE,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,YAAY;QACtB,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACtC,OAAO,CACR,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * squad link <team-repo-path> — link a project to a remote team root.
+ *
+ * Writes `.squad/config.json` with a relative `teamRoot` path so the
+ * dual-root resolver (resolveSquadPaths) can find the team identity dir.
+ *
+ * Remote squad mode concept by @spboyer (Shayne Boyer), PR bradygaster/squad#131.
+ *
+ * @module cli/commands/link
+ */
+/**
+ * Link the current project to a remote team root.
+ *
+ * @param projectDir - Project root (cwd or explicit).
+ * @param teamRepoPath - Path (relative or absolute) to the team repo.
+ */
+export declare function runLink(projectDir: string, teamRepoPath: string): void;
+//# sourceMappingURL=link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAwCtE"}

package/dist/cli/commands/link.js

@@ -0,0 +1,49 @@
+/**
+ * squad link <team-repo-path> — link a project to a remote team root.
+ *
+ * Writes `.squad/config.json` with a relative `teamRoot` path so the
+ * dual-root resolver (resolveSquadPaths) can find the team identity dir.
+ *
+ * Remote squad mode concept by @spboyer (Shayne Boyer), PR bradygaster/squad#131.
+ *
+ * @module cli/commands/link
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fatal } from '../core/errors.js';
+/**
+ * Link the current project to a remote team root.
+ *
+ * @param projectDir - Project root (cwd or explicit).
+ * @param teamRepoPath - Path (relative or absolute) to the team repo.
+ */
+export function runLink(projectDir, teamRepoPath) {
+    // Resolve the team repo path to an absolute path
+    const absoluteTeam = path.resolve(projectDir, teamRepoPath);
+    // Validate the target exists
+    if (!fs.existsSync(absoluteTeam)) {
+        fatal(`Target path does not exist: ${absoluteTeam}`);
+    }
+    if (!fs.statSync(absoluteTeam).isDirectory()) {
+        fatal(`Target path is not a directory: ${absoluteTeam}`);
+    }
+    // Validate the target contains a .squad/ or .ai-team/ directory
+    const hasSquad = fs.existsSync(path.join(absoluteTeam, '.squad'));
+    const hasAiTeam = fs.existsSync(path.join(absoluteTeam, '.ai-team'));
+    if (!hasSquad && !hasAiTeam) {
+        fatal(`Target does not contain a .squad/ directory: ${absoluteTeam}`);
+    }
+    // Ensure .squad/ exists locally
+    const squadDir = path.join(projectDir, '.squad');
+    fs.mkdirSync(squadDir, { recursive: true });
+    // Compute relative path from project root to team repo
+    const relativePath = path.relative(projectDir, absoluteTeam);
+    const config = {
+        version: 1,
+        teamRoot: relativePath,
+        projectKey: null,
+    };
+    fs.writeFileSync(path.join(squadDir, 'config.json'), JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    console.log(`✅ Linked to team root: ${relativePath}`);
+}
+//# sourceMappingURL=link.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/cli/commands/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,UAAkB,EAAE,YAAoB;IAC9D,iDAAiD;IACjD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,+BAA+B,YAAY,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;QAC7C,KAAK,CAAC,mCAAmC,YAAY,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,gEAAgE;IAChE,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,KAAK,CAAC,gDAAgD,YAAY,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,gCAAgC;IAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,uDAAuD;IACvD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG;QACb,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,YAAY;QACtB,UAAU,EAAE,IAAI;KACjB,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EAClC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACtC,OAAO,CACR,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAID,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgJ3E"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,WAAW,EAAE,CAAC;CAC7B;AAID,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgJ3E"}

package/dist/cli/commands/plugin.js

@@ -7,6 +7,7 @@ import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { execFile } from 'node:child_process';
 import { promisify } from 'node:util';
+import { TIMEOUTS } from '@bradygaster/squad-sdk';
 import { success, info, DIM, BOLD, RESET } from '../core/output.js';
 import { fatal } from '../core/errors.js';
 import { detectSquadDir } from '../core/detect-squad-dir.js';
@@ -112,7 +113,7 @@ export async function runPlugin(dest, args) {
         // Browse the marketplace repo for plugins using gh CLI
         let entries;
         try {
-            const { stdout } = await execFileAsync('gh', ['api', `repos/${marketplace.source}/contents`, '--jq', '[.[] | select(.type == "dir") | .name]'], { timeout: 15000 });
+            const { stdout } = await execFileAsync('gh', ['api', `repos/${marketplace.source}/contents`, '--jq', '[.[] | select(.type == "dir") | .name]'], { timeout: TIMEOUTS.PLUGIN_FETCH_MS });
             entries = JSON.parse(stdout.trim());
         }
         catch (err) {