@bradygaster/squad-cli 0.6.2 → 0.8.0

package/dist/cli/commands/plugin.js

@@ -0,0 +1,134 @@
+/**
+ * Plugin marketplace commands — add/remove/list/browse
+ * Port from beta index.js lines 716-833
+ */
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { success, info, DIM, BOLD, RESET } from '../core/output.js';
+import { fatal } from '../core/errors.js';
+import { detectSquadDir } from '../core/detect-squad-dir.js';
+import { ghAvailable, ghAuthenticated } from '../core/gh-cli.js';
+const execFileAsync = promisify(execFile);
+// --- Main command handler ---
+export async function runPlugin(dest, args) {
+    const subCmd = args[0];
+    const action = args[1];
+    if (subCmd !== 'marketplace' || !action) {
+        fatal('Usage: squad plugin marketplace add|remove|list|browse');
+    }
+    const squadDirInfo = detectSquadDir(dest);
+    const pluginsDir = join(squadDirInfo.path, 'plugins');
+    const marketplacesFile = join(pluginsDir, 'marketplaces.json');
+    async function readMarketplaces() {
+        if (!existsSync(marketplacesFile)) {
+            return { marketplaces: [] };
+        }
+        try {
+            const content = await readFile(marketplacesFile, 'utf8');
+            return JSON.parse(content);
+        }
+        catch {
+            return { marketplaces: [] };
+        }
+    }
+    async function writeMarketplaces(data) {
+        await mkdir(pluginsDir, { recursive: true });
+        await writeFile(marketplacesFile, JSON.stringify(data, null, 2) + '\n', 'utf8');
+    }
+    // --- Add marketplace ---
+    if (action === 'add') {
+        const source = args[2];
+        if (!source || !source.includes('/')) {
+            fatal('Usage: squad plugin marketplace add <owner/repo>');
+        }
+        const data = await readMarketplaces();
+        const name = source.split('/').pop();
+        if (data.marketplaces.some(m => m.source === source)) {
+            info(`${DIM}${source} is already registered${RESET}`);
+            return;
+        }
+        data.marketplaces.push({
+            name,
+            source,
+            added_at: new Date().toISOString()
+        });
+        await writeMarketplaces(data);
+        success(`Registered marketplace: ${BOLD}${name}${RESET} (${source})`);
+        return;
+    }
+    // --- Remove marketplace ---
+    if (action === 'remove') {
+        const name = args[2];
+        if (!name) {
+            fatal('Usage: squad plugin marketplace remove <name>');
+        }
+        const data = await readMarketplaces();
+        const before = data.marketplaces.length;
+        data.marketplaces = data.marketplaces.filter(m => m.name !== name);
+        if (data.marketplaces.length === before) {
+            fatal(`Marketplace "${name}" not found`);
+        }
+        await writeMarketplaces(data);
+        success(`Removed marketplace: ${BOLD}${name}${RESET}`);
+        return;
+    }
+    // --- List marketplaces ---
+    if (action === 'list') {
+        const data = await readMarketplaces();
+        if (data.marketplaces.length === 0) {
+            info(`${DIM}No marketplaces registered${RESET}`);
+            console.log(`\nAdd one with: ${BOLD}squad plugin marketplace add <owner/repo>${RESET}`);
+            return;
+        }
+        console.log(`\n${BOLD}Registered marketplaces:${RESET}\n`);
+        for (const m of data.marketplaces) {
+            const date = m.added_at ? ` ${DIM}(added ${m.added_at.split('T')[0]})${RESET}` : '';
+            console.log(`  ${BOLD}${m.name}${RESET}  →  ${m.source}${date}`);
+        }
+        console.log();
+        return;
+    }
+    // --- Browse marketplace ---
+    if (action === 'browse') {
+        const name = args[2];
+        if (!name) {
+            fatal('Usage: squad plugin marketplace browse <name>');
+        }
+        const data = await readMarketplaces();
+        const marketplace = data.marketplaces.find(m => m.name === name);
+        if (!marketplace) {
+            fatal(`Marketplace "${name}" not found. Run "squad plugin marketplace list" to see registered marketplaces.`);
+        }
+        // Check gh CLI availability
+        if (!(await ghAvailable())) {
+            fatal('GitHub CLI (gh) is required but not found. Install from https://cli.github.com/');
+        }
+        if (!(await ghAuthenticated())) {
+            fatal('GitHub CLI is not authenticated. Run "gh auth login" first.');
+        }
+        // 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 });
+            entries = JSON.parse(stdout.trim());
+        }
+        catch (err) {
+            fatal(`Could not browse ${marketplace.source} — ${err.message}`);
+        }
+        if (!entries || entries.length === 0) {
+            info(`${DIM}No plugins found in ${marketplace.source}${RESET}`);
+            return;
+        }
+        console.log(`\n${BOLD}Plugins in ${marketplace.name}${RESET} (${marketplace.source}):\n`);
+        for (const entry of entries) {
+            console.log(`  📦 ${entry}`);
+        }
+        console.log(`\n${DIM}${entries.length} plugin(s) available${RESET}\n`);
+        return;
+    }
+    fatal(`Unknown action: ${action}. Usage: squad plugin marketplace add|remove|list|browse`);
+}
+//# sourceMappingURL=plugin.js.map

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

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

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

@@ -0,0 +1,8 @@
+/**
+ * Watch command — Ralph's standalone polling process
+ */
+/**
+ * Run watch command — Ralph's local polling process
+ */
+export declare function runWatch(dest: string, intervalMinutes: number): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2JH;;GAEG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DnF"}

package/dist/cli/commands/watch.js

@@ -0,0 +1,178 @@
+/**
+ * Watch command — Ralph's standalone polling process
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { detectSquadDir } from '../core/detect-squad-dir.js';
+import { fatal } from '../core/errors.js';
+import { GREEN, RED, DIM, BOLD, RESET, YELLOW } from '../core/output.js';
+import { ghAvailable, ghAuthenticated, ghIssueList, ghIssueEdit } from '../core/gh-cli.js';
+/**
+ * Parse team members from team.md roster
+ */
+function parseMembers(text) {
+    const lines = text.split('\n');
+    const members = [];
+    let inMembersTable = false;
+    for (const line of lines) {
+        if (line.startsWith('## Members')) {
+            inMembersTable = true;
+            continue;
+        }
+        if (inMembersTable && line.startsWith('## '))
+            break;
+        if (inMembersTable && line.startsWith('|') && !line.includes('---') && !line.includes('Name')) {
+            const cells = line.split('|').map(c => c.trim()).filter(Boolean);
+            if (cells.length >= 2 && !['Scribe', 'Ralph'].includes(cells[0])) {
+                members.push({
+                    name: cells[0],
+                    role: cells[1],
+                    label: `squad:${cells[0].toLowerCase()}`
+                });
+            }
+        }
+    }
+    return members;
+}
+/**
+ * Auto-triage an issue based on content and team roster
+ */
+function triageIssue(issue, members) {
+    const issueText = issue.title.toLowerCase();
+    // Domain-based routing
+    for (const member of members) {
+        const role = member.role.toLowerCase();
+        // Frontend/UI
+        if ((role.includes('frontend') || role.includes('ui')) &&
+            (issueText.includes('ui') || issueText.includes('frontend') || issueText.includes('css'))) {
+            return { member, reason: 'frontend/UI domain' };
+        }
+        // Backend/API
+        if ((role.includes('backend') || role.includes('api') || role.includes('server')) &&
+            (issueText.includes('api') || issueText.includes('backend') || issueText.includes('database'))) {
+            return { member, reason: 'backend/API domain' };
+        }
+        // Test/QA
+        if ((role.includes('test') || role.includes('qa')) &&
+            (issueText.includes('test') || issueText.includes('bug') || issueText.includes('fix'))) {
+            return { member, reason: 'testing/QA domain' };
+        }
+    }
+    // Fall back to Lead if no match
+    const lead = members.find(m => m.role.toLowerCase().includes('lead') || m.role.toLowerCase().includes('architect'));
+    if (lead) {
+        return { member: lead, reason: 'no domain match — routed to Lead' };
+    }
+    return null;
+}
+/**
+ * Run a single check cycle
+ */
+async function runCheck(members, hasCopilot, autoAssign) {
+    const timestamp = new Date().toLocaleTimeString();
+    try {
+        // Fetch open issues with squad label
+        const issues = await ghIssueList({ label: 'squad', state: 'open', limit: 20 });
+        // Find untriaged issues (no squad:{member} label)
+        const memberLabels = members.map(m => m.label);
+        const untriaged = issues.filter(issue => {
+            const issueLabels = issue.labels.map(l => l.name);
+            return !memberLabels.some(ml => issueLabels.includes(ml));
+        });
+        // Find unassigned squad:copilot issues
+        let unassignedCopilot = [];
+        if (hasCopilot && autoAssign) {
+            try {
+                const copilotIssues = await ghIssueList({ label: 'squad:copilot', state: 'open', limit: 10 });
+                unassignedCopilot = copilotIssues.filter(i => !i.assignees || i.assignees.length === 0);
+            }
+            catch {
+                // Label may not exist yet
+            }
+        }
+        if (untriaged.length === 0 && unassignedCopilot.length === 0) {
+            console.log(`${DIM}[${timestamp}]${RESET} 📋 Board is clear — no pending work`);
+            return;
+        }
+        // Triage untriaged issues
+        for (const issue of untriaged) {
+            const triage = triageIssue(issue, members);
+            if (triage) {
+                try {
+                    await ghIssueEdit(issue.number, { addLabel: triage.member.label });
+                    console.log(`${GREEN}✓${RESET} [${timestamp}] Triaged #${issue.number} "${issue.title}" → ${triage.member.name} (${triage.reason})`);
+                }
+                catch (e) {
+                    const err = e;
+                    console.error(`${RED}✗${RESET} [${timestamp}] Failed to label #${issue.number}: ${err.message}`);
+                }
+            }
+        }
+        // Assign @copilot to unassigned copilot issues
+        for (const issue of unassignedCopilot) {
+            try {
+                await ghIssueEdit(issue.number, { addAssignee: 'copilot-swe-agent' });
+                console.log(`${GREEN}✓${RESET} [${timestamp}] Assigned @copilot to #${issue.number} "${issue.title}"`);
+            }
+            catch (e) {
+                const err = e;
+                console.error(`${RED}✗${RESET} [${timestamp}] Failed to assign @copilot to #${issue.number}: ${err.message}`);
+            }
+        }
+    }
+    catch (e) {
+        const err = e;
+        console.error(`${RED}✗${RESET} [${timestamp}] Check failed: ${err.message}`);
+    }
+}
+/**
+ * Run watch command — Ralph's local polling process
+ */
+export async function runWatch(dest, intervalMinutes) {
+    // Validate interval
+    if (isNaN(intervalMinutes) || intervalMinutes < 1) {
+        fatal('--interval must be a positive number of minutes');
+    }
+    // Detect squad directory
+    const squadDirInfo = detectSquadDir(dest);
+    const teamMd = path.join(squadDirInfo.path, 'team.md');
+    if (!fs.existsSync(teamMd)) {
+        fatal('No squad found — run init first.');
+    }
+    // Verify gh CLI
+    if (!(await ghAvailable())) {
+        fatal('gh CLI not found — install from https://cli.github.com');
+    }
+    if (!(await ghAuthenticated())) {
+        console.error(`${YELLOW}⚠️${RESET} gh CLI not authenticated`);
+        console.error(`   Run: ${BOLD}gh auth login${RESET}\n`);
+        fatal('gh authentication required');
+    }
+    // Parse team.md
+    const content = fs.readFileSync(teamMd, 'utf8');
+    const members = parseMembers(content);
+    if (members.length === 0) {
+        fatal('No squad members found in team.md');
+    }
+    const hasCopilot = content.includes('🤖 Coding Agent') || content.includes('@copilot');
+    const autoAssign = content.includes('<!-- copilot-auto-assign: true -->');
+    // Print startup banner
+    console.log(`\n${BOLD}🔄 Ralph — Watch Mode${RESET}`);
+    console.log(`${DIM}Polling every ${intervalMinutes} minute(s) for squad work. Ctrl+C to stop.${RESET}\n`);
+    // Run immediately, then on interval
+    await runCheck(members, hasCopilot, autoAssign);
+    return new Promise((resolve) => {
+        const intervalId = setInterval(async () => {
+            await runCheck(members, hasCopilot, autoAssign);
+        }, intervalMinutes * 60 * 1000);
+        // Graceful shutdown
+        const shutdown = () => {
+            clearInterval(intervalId);
+            console.log(`\n${DIM}🔄 Ralph — Watch stopped${RESET}`);
+            resolve();
+        };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    });
+}
+//# sourceMappingURL=watch.js.map

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

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

package/dist/cli/copilot-install.d.ts

@@ -0,0 +1,73 @@
+/**
+ * In-Copilot Installation Path (M4-6, Issue #106)
+ *
+ * Detects the Copilot runtime environment and provides
+ * platform-specific installation + scaffolding instructions.
+ * Wires into initSquad() from M2-6 for project creation.
+ *
+ * @module cli/copilot-install
+ */
+/** Recognised Copilot environments. */
+export type CopilotEnvironment = 'cli' | 'vscode' | 'web' | 'unknown';
+/** Configuration for in-Copilot installation. */
+export interface InstallConfig {
+    /** Project name */
+    projectName?: string;
+    /** Project description */
+    projectDescription?: string;
+    /** Agent names to scaffold */
+    agents?: string[];
+    /** Config format */
+    configFormat?: 'typescript' | 'json';
+}
+/** Result of an in-Copilot installation. */
+export interface CopilotInstallResult {
+    /** Whether the installation succeeded */
+    success: boolean;
+    /** Detected environment */
+    environment: CopilotEnvironment;
+    /** Files created during installation */
+    createdFiles: string[];
+    /** Human-readable installation instructions that were applied */
+    instructions: string[];
+}
+/** Single install instruction step. */
+export interface InstallStep {
+    /** Step description */
+    description: string;
+    /** Shell command to run (if applicable) */
+    command?: string;
+}
+/** Indicators used for environment detection. */
+export interface EnvironmentIndicators {
+    env: Record<string, string | undefined>;
+    argv: string[];
+}
+/**
+ * Detect which Copilot environment is active.
+ *
+ * Heuristics (checked in order):
+ * 1. `VSCODE_PID` or `VSCODE_IPC_HOOK` → vscode
+ * 2. `CODESPACES` or `GITHUB_CODESPACE_TOKEN` → web
+ * 3. `COPILOT_CLI` env var → cli
+ * 4. `--copilot-cli` argv flag → cli
+ * 5. Otherwise → unknown
+ */
+export declare function detectCopilotEnvironment(indicators?: EnvironmentIndicators): CopilotEnvironment;
+/**
+ * Return platform-specific install steps for a detected environment.
+ */
+export declare function getInstallInstructions(env: CopilotEnvironment): InstallStep[];
+/**
+ * Run a full "install Squad from inside Copilot" flow.
+ *
+ * Generates `.squad/` scaffolding via initSquad() from M2-6
+ * and returns environment-aware instructions.
+ *
+ * @param env - Detected Copilot environment
+ * @param projectDir - Root directory of the project
+ * @param config - Optional install configuration
+ * @returns CopilotInstallResult
+ */
+export declare function installFromCopilot(env: CopilotEnvironment, projectDir: string, config?: InstallConfig): Promise<CopilotInstallResult>;
+//# sourceMappingURL=copilot-install.d.ts.map

package/dist/cli/copilot-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot-install.d.ts","sourceRoot":"","sources":["../../src/cli/copilot-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH,uCAAuC;AACvC,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtE,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,oBAAoB;IACpB,YAAY,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC;CACtC;AAED,4CAA4C;AAC5C,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,2BAA2B;IAC3B,WAAW,EAAE,kBAAkB,CAAC;IAChC,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,iEAAiE;IACjE,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD,iDAAiD;AACjD,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,CAAC,EAAE,qBAAqB,GACjC,kBAAkB,CAcpB;AAMD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,kBAAkB,GAAG,WAAW,EAAE,CA4B7E;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,kBAAkB,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAmC/B"}

package/dist/cli/copilot-install.js

@@ -0,0 +1,117 @@
+/**
+ * In-Copilot Installation Path (M4-6, Issue #106)
+ *
+ * Detects the Copilot runtime environment and provides
+ * platform-specific installation + scaffolding instructions.
+ * Wires into initSquad() from M2-6 for project creation.
+ *
+ * @module cli/copilot-install
+ */
+import { initSquad } from '@bradygaster/squad-sdk/config';
+/**
+ * Detect which Copilot environment is active.
+ *
+ * Heuristics (checked in order):
+ * 1. `VSCODE_PID` or `VSCODE_IPC_HOOK` → vscode
+ * 2. `CODESPACES` or `GITHUB_CODESPACE_TOKEN` → web
+ * 3. `COPILOT_CLI` env var → cli
+ * 4. `--copilot-cli` argv flag → cli
+ * 5. Otherwise → unknown
+ */
+export function detectCopilotEnvironment(indicators) {
+    const env = indicators?.env ?? process.env;
+    const argv = indicators?.argv ?? process.argv;
+    if (env['VSCODE_PID'] || env['VSCODE_IPC_HOOK']) {
+        return 'vscode';
+    }
+    if (env['CODESPACES'] === 'true' || env['GITHUB_CODESPACE_TOKEN']) {
+        return 'web';
+    }
+    if (env['COPILOT_CLI'] || argv.includes('--copilot-cli')) {
+        return 'cli';
+    }
+    return 'unknown';
+}
+// ============================================================================
+// Install Instructions
+// ============================================================================
+/**
+ * Return platform-specific install steps for a detected environment.
+ */
+export function getInstallInstructions(env) {
+    switch (env) {
+        case 'cli':
+            return [
+                { description: 'Install the Squad SDK globally', command: 'npm install -g @bradygaster/squad' },
+                { description: 'Initialise a new Squad project', command: 'npx create-squad' },
+                { description: 'Start the Squad orchestrator', command: 'squad start' },
+            ];
+        case 'vscode':
+            return [
+                { description: 'Install Squad SDK as a project dependency', command: 'npm install @bradygaster/squad' },
+                { description: 'Run Squad init via the VS Code terminal', command: 'npx create-squad' },
+                { description: 'Reload the VS Code window to activate Squad agents' },
+            ];
+        case 'web':
+            return [
+                { description: 'Install Squad SDK in the Codespace', command: 'npm install @bradygaster/squad' },
+                { description: 'Initialise Squad scaffolding', command: 'npx create-squad' },
+                { description: 'Squad agents are available in the Codespace Copilot Chat' },
+            ];
+        case 'unknown':
+        default:
+            return [
+                { description: 'Install Node.js 20+ if not already installed' },
+                { description: 'Install the Squad SDK', command: 'npm install @bradygaster/squad' },
+                { description: 'Initialise a new Squad project', command: 'npx create-squad' },
+            ];
+    }
+}
+// ============================================================================
+// In-Copilot Install
+// ============================================================================
+/**
+ * Run a full "install Squad from inside Copilot" flow.
+ *
+ * Generates `.squad/` scaffolding via initSquad() from M2-6
+ * and returns environment-aware instructions.
+ *
+ * @param env - Detected Copilot environment
+ * @param projectDir - Root directory of the project
+ * @param config - Optional install configuration
+ * @returns CopilotInstallResult
+ */
+export async function installFromCopilot(env, projectDir, config) {
+    const projectName = config?.projectName ?? 'my-squad-project';
+    const agents = (config?.agents ?? ['lead', 'developer']).map((name) => ({
+        name,
+        role: name,
+    }));
+    const initOptions = {
+        teamRoot: projectDir,
+        projectName,
+        projectDescription: config?.projectDescription,
+        agents,
+        configFormat: config?.configFormat ?? (env === 'web' ? 'json' : 'typescript'),
+    };
+    let initResult;
+    try {
+        initResult = await initSquad(initOptions);
+    }
+    catch (err) {
+        return {
+            success: false,
+            environment: env,
+            createdFiles: [],
+            instructions: [`Installation failed: ${err.message}`],
+        };
+    }
+    const instructions = getInstallInstructions(env).map((s) => s.description);
+    return {
+        success: true,
+        environment: env,
+        createdFiles: initResult.createdFiles,
+        instructions,
+    };
+}
+//# sourceMappingURL=copilot-install.js.map

package/dist/cli/copilot-install.js.map

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

package/dist/cli/core/detect-squad-dir.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Squad directory detection — zero dependencies
+ */
+export interface SquadDirInfo {
+    path: string;
+    name: '.squad' | '.ai-team';
+    isLegacy: boolean;
+}
+/**
+ * Detect squad directory — .squad/ first, fall back to .ai-team/
+ */
+export declare function detectSquadDir(dest: string): SquadDirInfo;
+//# sourceMappingURL=detect-squad-dir.d.ts.map

package/dist/cli/core/detect-squad-dir.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-squad-dir.d.ts","sourceRoot":"","sources":["../../../src/cli/core/detect-squad-dir.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAYzD"}

package/dist/cli/core/detect-squad-dir.js

@@ -0,0 +1,21 @@
+/**
+ * Squad directory detection — zero dependencies
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Detect squad directory — .squad/ first, fall back to .ai-team/
+ */
+export function detectSquadDir(dest) {
+    const squadDir = path.join(dest, '.squad');
+    const aiTeamDir = path.join(dest, '.ai-team');
+    if (fs.existsSync(squadDir)) {
+        return { path: squadDir, name: '.squad', isLegacy: false };
+    }
+    if (fs.existsSync(aiTeamDir)) {
+        return { path: aiTeamDir, name: '.ai-team', isLegacy: true };
+    }
+    // Default for new installations
+    return { path: squadDir, name: '.squad', isLegacy: false };
+}
+//# sourceMappingURL=detect-squad-dir.js.map

package/dist/cli/core/detect-squad-dir.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-squad-dir.js","sourceRoot":"","sources":["../../../src/cli/core/detect-squad-dir.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE9C,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IACD,gCAAgC;IAChC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7D,CAAC"}

package/dist/cli/core/email-scrub.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Email scrubbing utility — removes PII from Squad state files
+ * @module cli/core/email-scrub
+ */
+/**
+ * Scrub email addresses from all files in a directory
+ * Returns count of files scrubbed
+ */
+export declare function scrubEmails(dir: string): Promise<number>;
+//# sourceMappingURL=email-scrub.d.ts.map

package/dist/cli/core/email-scrub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-scrub.d.ts","sourceRoot":"","sources":["../../../src/cli/core/email-scrub.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;GAGG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD9D"}