@apralabs/apra-fleet 0.2.2

package/dist/tools/check-status.js

@@ -0,0 +1,247 @@
+import { z } from 'zod';
+import { getAllAgents } from '../services/registry.js';
+import { getStrategy } from '../services/strategy.js';
+import { getOsCommands } from '../os/index.js';
+import { getProvider } from '../providers/index.js';
+import { formatAgentHost, getAgentOS } from '../utils/agent-helpers.js';
+import { serverVersion } from '../version.js';
+import { DEFAULT_ICON } from '../services/icons.js';
+import { writeStatusline } from '../services/statusline.js';
+import { getStallDetector } from '../services/stall/index.js';
+import { fmtElapsed } from '../services/stall/time-utils.js';
+import { awsProvider } from '../services/cloud/aws.js';
+import { estimateCost, hourlyRate, formatUptimeDuration, uptimeHoursFromLaunch, costWarning } from '../services/cloud/cost.js';
+import { parseGpuUtilization } from '../utils/gpu-parser.js';
+import { getUpdateNotice } from '../services/update-check.js';
+import { getActiveLogFile } from '../utils/log-helpers.js';
+export const fleetStatusSchema = z.object({
+    format: z.enum(['compact', 'json']).default('compact').describe('Output format: "compact" (default, few lines) or "json" (structured data for detailed rendering)'),
+});
+/**
+ * Build the busy label for a member confirmed running via SSH process check.
+ * Uses the stall detector entry to show elapsed time since last log activity,
+ * or 'unknown' if the stall threshold has already fired.
+ */
+function busyLabel(agentId) {
+    const entry = getStallDetector().getEntry(agentId);
+    if (!entry)
+        return 'BUSY';
+    if (entry.stallReported)
+        return 'unknown';
+    if (!entry.provisional) {
+        return `BUSY(${fmtElapsed(Date.now() - entry.lastActivityAt)})`;
+    }
+    return 'BUSY';
+}
+function formatTimeAgo(isoDate) {
+    if (!isoDate)
+        return 'never';
+    const diff = Date.now() - new Date(isoDate).getTime();
+    const minutes = Math.floor(diff / 60000);
+    if (minutes < 1)
+        return 'just now';
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24)
+        return `${hours}h ago`;
+    const days = Math.floor(hours / 24);
+    return `${days}d ago`;
+}
+async function checkAgent(agent) {
+    const hostLabel = formatAgentHost(agent);
+    const row = {
+        icon: agent.icon ?? DEFAULT_ICON,
+        name: agent.friendlyName,
+        host: hostLabel,
+        status: 'OFFLINE',
+        busy: '-',
+        session: agent.sessionId ? agent.sessionId.substring(0, 8) + '...' : '(none)',
+        lastActivity: formatTimeAgo(agent.lastUsed),
+        lastLlmActivityAt: agent.lastLlmActivityAt,
+        branch: agent.lastBranch,
+        tokenUsage: agent.tokenUsage,
+    };
+    const strategy = getStrategy(agent);
+    // For cloud members: fetch instance details in parallel with SSH connection test
+    if (agent.cloud) {
+        const [detailsResult, connResult] = await Promise.allSettled([
+            awsProvider.getInstanceDetails(agent.cloud),
+            Promise.race([
+                strategy.testConnection(),
+                new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 10000)),
+            ]),
+        ]);
+        // Process cloud details
+        if (detailsResult.status === 'fulfilled') {
+            const details = detailsResult.value;
+            row.cloudInfo = {
+                state: details.state,
+                instanceType: details.instanceType,
+                launchTime: details.launchTime,
+            };
+            // If cloud is not running/pending, mark as off and skip SSH entirely
+            if (details.state !== 'running' && details.state !== 'pending') {
+                row.status = 'OFFLINE';
+                row.busy = 'OFF(cloud)';
+                return row;
+            }
+        }
+        // Process SSH connection result
+        if (connResult.status === 'fulfilled' && connResult.value.ok) {
+            row.status = 'online';
+            const cmds = getOsCommands(getAgentOS(agent));
+            const provider = getProvider(agent.llmProvider);
+            // Run fleet process check and GPU utilization in parallel
+            const [busyResult, gpuResult] = await Promise.allSettled([
+                strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000),
+                strategy.execCommand(cmds.gpuUtilization(), 10000),
+            ]);
+            if (busyResult.status === 'fulfilled') {
+                const output = busyResult.value.stdout.trim().toLowerCase();
+                if (output.includes('fleet-busy')) {
+                    row.busy = busyLabel(agent.id);
+                }
+                else if (output.includes('other-busy')) {
+                    row.busy = 'idle*';
+                }
+                else {
+                    row.busy = 'idle';
+                }
+            }
+            else {
+                row.busy = 'unknown';
+            }
+            if (gpuResult.status === 'fulfilled' && row.cloudInfo) {
+                const gpuNum = parseGpuUtilization(gpuResult.value.stdout);
+                if (gpuNum !== undefined) {
+                    row.cloudInfo.gpuUtil = gpuNum;
+                }
+            }
+        }
+        return row;
+    }
+    // Non-cloud members: original logic
+    try {
+        const conn = await Promise.race([
+            strategy.testConnection(),
+            new Promise((_, reject) => setTimeout(() => reject(new Error('timeout')), 10000)),
+        ]);
+        if (conn.ok) {
+            row.status = 'online';
+            try {
+                const cmds = getOsCommands(getAgentOS(agent));
+                const provider = getProvider(agent.llmProvider);
+                const busyCheck = await strategy.execCommand(cmds.fleetProcessCheck(agent.workFolder, agent.sessionId, provider.processName), 10000);
+                const output = busyCheck.stdout.trim().toLowerCase();
+                if (output.includes('fleet-busy')) {
+                    row.busy = 'BUSY';
+                }
+                else if (output.includes('other-busy')) {
+                    row.busy = 'idle*';
+                }
+                else {
+                    row.busy = 'idle';
+                }
+            }
+            catch {
+                row.busy = 'unknown';
+            }
+        }
+    }
+    catch {
+        row.status = 'OFFLINE';
+    }
+    return row;
+}
+export async function fleetStatus(input) {
+    const format = input?.format ?? 'compact';
+    const agents = getAllAgents();
+    if (agents.length === 0) {
+        return 'No members registered. Use register_member to add one.';
+    }
+    // Query all members in parallel
+    const results = await Promise.allSettled(agents.map(a => checkAgent(a)));
+    const rows = results.map((r, i) => {
+        if (r.status === 'fulfilled')
+            return r.value;
+        const hostLabel = formatAgentHost(agents[i]);
+        return {
+            icon: agents[i].icon ?? DEFAULT_ICON,
+            name: agents[i].friendlyName,
+            host: hostLabel,
+            status: 'OFFLINE',
+            busy: '-',
+            session: agents[i].sessionId ? agents[i].sessionId.substring(0, 8) + '...' : '(none)',
+            lastActivity: formatTimeAgo(agents[i].lastUsed),
+        };
+    });
+    // Count cloud-stopped members as offline for the summary
+    const online = rows.filter(r => r.status === 'online').length;
+    // Update statusline with connectivity state from this check.
+    // For busy/unknown members the stall detector owns the statusline (it writes
+    // busy(mm:ss) or unknown on each 30s poll); we only override offline and idle
+    // so we don't clobber the richer stall-detector state.
+    const statusOverrides = new Map();
+    for (let i = 0; i < agents.length; i++) {
+        const row = rows[i];
+        if (row.status === 'OFFLINE') {
+            statusOverrides.set(agents[i].id, 'offline');
+        }
+        else if (row.busy === 'idle' || row.busy === 'idle*') {
+            // SSH confirmed no fleet process running — clear any stale busy/unknown
+            statusOverrides.set(agents[i].id, 'idle');
+        }
+        // BUSY / BUSY(mm:ss) / unknown (stall fired but process still alive):
+        // stall detector already wrote the authoritative value — don't override
+    }
+    writeStatusline(statusOverrides);
+    const updateNotice = getUpdateNotice();
+    const logFile = getActiveLogFile();
+    if (format === 'json') {
+        const payload = {
+            version: serverVersion,
+            summary: { total: rows.length, online, offline: rows.length - online },
+            members: rows,
+        };
+        if (logFile)
+            payload.logFile = logFile;
+        if (updateNotice) {
+            const m = updateNotice.match(/apra-fleet (v[\d.]+) is available \(installed: (v[\d.]+)/);
+            if (m)
+                payload.updateAvailable = { latest: m[1], installed: m[2] };
+        }
+        return JSON.stringify(payload);
+    }
+    // Compact: 1 summary line + 1 line per member, multiple fields per line
+    let t = updateNotice ? `${updateNotice}\n` : '';
+    t += `Fleet ${serverVersion}: ${online}/${rows.length} online | `;
+    if (logFile)
+        t += `log=${logFile} | `;
+    t += rows.map(r => {
+        const st = r.status === 'online' ? r.busy : (r.busy === 'OFF(cloud)' ? 'OFF(cloud)' : 'OFF');
+        return `${r.icon} ${r.name}(${st})`;
+    }).join(', ');
+    t += '\n';
+    for (const r of rows) {
+        const branchStr = r.branch ? ` | branch=${r.branch}` : '';
+        const tokenStr = (r.tokenUsage && (r.tokenUsage.input > 0 || r.tokenUsage.output > 0))
+            ? ` | tokens=in:${r.tokenUsage.input} out:${r.tokenUsage.output}` : '';
+        let line = `  ${r.icon} ${r.name}: ${r.host} | session=${r.session} | ${r.lastActivity}${branchStr}${tokenStr}`;
+        if (r.cloudInfo) {
+            const ci = r.cloudInfo;
+            const uptimeHrs = uptimeHoursFromLaunch(ci.launchTime);
+            const uptime = ci.launchTime ? formatUptimeDuration(uptimeHrs) : '-';
+            const cost = estimateCost(ci.instanceType, uptimeHrs);
+            const rate = hourlyRate(ci.instanceType);
+            const warn = costWarning(ci.instanceType, uptimeHrs);
+            const gpuStr = ci.gpuUtil !== undefined ? ` GPU:${ci.gpuUtil}%` : '';
+            const typeStr = ci.instanceType ? ` ${ci.instanceType}` : '';
+            const warnStr = warn ? ' ⚠' : '';
+            line += ` | [cloud:${ci.state}${typeStr} ${uptime} ${cost} @${rate}${gpuStr}${warnStr}]`;
+        }
+        t += line + '\n';
+    }
+    return t;
+}
+//# sourceMappingURL=check-status.js.map

package/dist/tools/check-status.js.map

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

package/dist/tools/cloud-control.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+export declare const cloudControlSchema: z.ZodObject<{
+    action: z.ZodEnum<["start", "stop", "status"]>;
+    member_id: z.ZodOptional<z.ZodString>;
+    member_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    action: "start" | "status" | "stop";
+    member_id?: string | undefined;
+    member_name?: string | undefined;
+}, {
+    action: "start" | "status" | "stop";
+    member_id?: string | undefined;
+    member_name?: string | undefined;
+}>;
+export type CloudControlInput = z.infer<typeof cloudControlSchema>;
+export declare function cloudControl(input: CloudControlInput): Promise<string>;
+//# sourceMappingURL=cloud-control.d.ts.map

package/dist/tools/cloud-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloud-control.d.ts","sourceRoot":"","sources":["../../src/tools/cloud-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAK7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0F5E"}

package/dist/tools/cloud-control.js

@@ -0,0 +1,102 @@
+import { z } from 'zod';
+import { getAgentOS } from '../utils/agent-helpers.js';
+import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
+import { getStrategy } from '../services/strategy.js';
+import { getOsCommands } from '../os/index.js';
+import { ensureCloudReady } from '../services/cloud/lifecycle.js';
+import { awsProvider } from '../services/cloud/aws.js';
+import { estimateCost, hourlyRate, formatUptimeDuration, uptimeHoursFromLaunch, costWarning, uptimeWarning } from '../services/cloud/cost.js';
+import { parseGpuUtilization } from '../utils/gpu-parser.js';
+export const cloudControlSchema = z.object({
+    ...memberIdentifier,
+    action: z.enum(['start', 'stop', 'status']).describe('start: auto-start and wait for SSH ready | stop: stop instance immediately | status: return current state'),
+});
+export async function cloudControl(input) {
+    const agentOrError = resolveMember(input.member_id, input.member_name);
+    if (typeof agentOrError === 'string')
+        return agentOrError;
+    const agent = agentOrError;
+    if (!agent.cloud) {
+        return `Member "${agent.friendlyName}" is not a cloud member (no cloud config).`;
+    }
+    switch (input.action) {
+        case 'start': {
+            try {
+                const readyAgent = await ensureCloudReady(agent);
+                return `Started "${readyAgent.friendlyName}" — SSH ready at ${readyAgent.host ?? agent.host ?? '(unknown IP)'}.`;
+            }
+            catch (err) {
+                return `Failed to start "${agent.friendlyName}": ${err.message}`;
+            }
+        }
+        case 'stop': {
+            try {
+                await awsProvider.stopInstance(agent.cloud);
+                return `Stopped "${agent.friendlyName}" (${agent.cloud.instanceId}).`;
+            }
+            catch (err) {
+                return `Failed to stop "${agent.friendlyName}": ${err.message}`;
+            }
+        }
+        case 'status': {
+            try {
+                const details = await awsProvider.getInstanceDetails(agent.cloud);
+                const uptimeHrs = uptimeHoursFromLaunch(details.launchTime);
+                const uptime = details.launchTime ? formatUptimeDuration(uptimeHrs) : '-';
+                const cost = estimateCost(details.instanceType, uptimeHrs);
+                const rate = hourlyRate(details.instanceType);
+                const typeStr = details.instanceType ?? 'unknown type';
+                const ipStr = details.publicIp ?? 'no public IP';
+                const warn = costWarning(details.instanceType, uptimeHrs);
+                const uptimeWarn = uptimeWarning(uptimeHrs);
+                // Anomaly: running but no recent activity and uptime is long
+                const lastUsedMs = agent.lastUsed ? Date.now() - new Date(agent.lastUsed).getTime() : undefined;
+                const idleAnomalyWarn = (details.state === 'running' &&
+                    lastUsedMs !== undefined &&
+                    lastUsedMs > 2 * 3_600_000 && // >2h since last activity
+                    uptimeHrs > 2) ? '⚠ Instance running but no recent activity — idle manager may not be active' : null;
+                // GPU utilization check (only when running and SSH is available)
+                let gpuLine = '';
+                if (details.state === 'running') {
+                    try {
+                        const strategy = getStrategy(agent);
+                        const cmds = getOsCommands(getAgentOS(agent));
+                        const gpuResult = await strategy.execCommand(cmds.gpuUtilization(), 10000);
+                        const gpuUtil = parseGpuUtilization(gpuResult.stdout);
+                        if (gpuUtil !== undefined) {
+                            gpuLine = `\n  gpu:      ${gpuUtil}%`;
+                        }
+                        else {
+                            // Empty stdout: nvidia-smi not found (suppressed by 2>/dev/null)
+                            gpuLine = '\n  gpu:      n/a (nvidia-smi not found)';
+                        }
+                    }
+                    catch {
+                        gpuLine = '\n  gpu:      n/a (check failed)';
+                    }
+                }
+                let out = (`"${agent.friendlyName}" cloud status:\n` +
+                    `  state:    ${details.state}\n` +
+                    `  instance: ${agent.cloud.instanceId} (${typeStr})\n` +
+                    `  region:   ${agent.cloud.region}\n` +
+                    `  ip:       ${ipStr}\n` +
+                    `  uptime:   ${uptime}\n` +
+                    `  rate:     ${rate}\n` +
+                    `  est cost: ${cost}` +
+                    gpuLine +
+                    `\n  idle timeout: ${agent.cloud.idleTimeoutMin}min`);
+                if (warn)
+                    out += `\n  warning:  ${warn}`;
+                if (uptimeWarn)
+                    out += `\n  warning:  ⚠ ${uptimeWarn}`;
+                if (idleAnomalyWarn)
+                    out += `\n  warning:  ${idleAnomalyWarn}`;
+                return out;
+            }
+            catch (err) {
+                return `Failed to get status for "${agent.friendlyName}": ${err.message}`;
+            }
+        }
+    }
+}
+//# sourceMappingURL=cloud-control.js.map

package/dist/tools/cloud-control.js.map

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

package/dist/tools/compose-permissions.d.ts

@@ -0,0 +1,26 @@
+import { z } from 'zod';
+export declare const composePermissionsSchema: z.ZodObject<{
+    role: z.ZodEnum<["doer", "reviewer"]>;
+    project_folder: z.ZodOptional<z.ZodString>;
+    grant: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    grant_reason: z.ZodOptional<z.ZodString>;
+    member_id: z.ZodOptional<z.ZodString>;
+    member_name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    role: "doer" | "reviewer";
+    member_id?: string | undefined;
+    member_name?: string | undefined;
+    project_folder?: string | undefined;
+    grant?: string[] | undefined;
+    grant_reason?: string | undefined;
+}, {
+    role: "doer" | "reviewer";
+    member_id?: string | undefined;
+    member_name?: string | undefined;
+    project_folder?: string | undefined;
+    grant?: string[] | undefined;
+    grant_reason?: string | undefined;
+}>;
+export type ComposePermissionsInput = z.infer<typeof composePermissionsSchema>;
+export declare function composePermissions(input: ComposePermissionsInput): Promise<string>;
+//# sourceMappingURL=compose-permissions.d.ts.map

package/dist/tools/compose-permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose-permissions.d.ts","sourceRoot":"","sources":["../../src/tools/compose-permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAaxB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;EAMnC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AA8I/E,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFxF"}

package/dist/tools/compose-permissions.js

@@ -0,0 +1,217 @@
+import { z } from 'zod';
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+import { getStrategy } from '../services/strategy.js';
+import { memberIdentifier, resolveMember } from '../utils/resolve-member.js';
+import { getProvider } from '../providers/index.js';
+export const composePermissionsSchema = z.object({
+    ...memberIdentifier,
+    role: z.enum(['doer', 'reviewer']).describe('Role determines base profile (doer = broad build/test, reviewer = read + feedback + test)'),
+    project_folder: z.string().optional().describe('Local project folder containing permissions.json ledger. Omit to skip ledger merge.'),
+    grant: z.array(z.string()).optional().describe('Reactive mode: additional permissions to grant (e.g. ["Bash(docker:*)", "Bash(docker-compose:*)"]). Appended to current permissions and re-delivered.'),
+    grant_reason: z.string().optional().describe('Reason for the grant (stored in ledger)'),
+});
+// Stack marker files -> profile keys
+const STACK_MAP = {
+    'package.json': 'node',
+    'Cargo.toml': 'rust',
+    'requirements.txt': 'python',
+    'pyproject.toml': 'python',
+    'setup.py': 'python',
+    'go.mod': 'go',
+    'build.gradle': 'jvm',
+    'pom.xml': 'jvm',
+    'Makefile': 'cpp',
+    'CMakeLists.txt': 'cpp',
+    'composer.json': 'php',
+};
+// Co-occurrence: granting one tool often means needing related tools
+const CO_OCCURRENCE = {
+    'Bash(docker:*)': ['Bash(docker-compose:*)', 'Bash(docker buildx:*)'],
+    'Bash(kubectl:*)': ['Bash(helm:*)'],
+    'Bash(terraform:*)': ['Bash(terragrunt:*)'],
+    'Bash(pip:*)': ['Bash(pip3:*)'],
+    'Bash(python:*)': ['Bash(python3:*)'],
+};
+// Never auto-grant - require user escalation
+const NEVER_AUTO_GRANT = new Set([
+    'Bash(sudo:*)', 'Bash(su:*)', 'Bash(env:*)', 'Bash(printenv:*)',
+    'Bash(nc:*)', 'Bash(nmap:*)', 'Bash(chmod 777:*)',
+]);
+function findProfilesDir() {
+    // Installed: ~/.claude/skills/fleet/profiles/ (new location after skill split)
+    const installedFleet = path.join(os.homedir(), '.claude', 'skills', 'fleet', 'profiles');
+    if (fs.existsSync(installedFleet))
+        return installedFleet;
+    // Installed (legacy): ~/.claude/skills/pm/profiles/
+    const installedPm = path.join(os.homedir(), '.claude', 'skills', 'pm', 'profiles');
+    if (fs.existsSync(installedPm))
+        return installedPm;
+    // Dev: walk up from __dirname looking for skills/fleet/profiles/
+    let dir = __dirname;
+    for (let i = 0; i < 6; i++) {
+        const candidateFleet = path.join(dir, 'skills', 'fleet', 'profiles');
+        if (fs.existsSync(candidateFleet))
+            return candidateFleet;
+        const candidatePm = path.join(dir, 'skills', 'pm', 'profiles');
+        if (fs.existsSync(candidatePm))
+            return candidatePm;
+        dir = path.dirname(dir);
+    }
+    throw new Error('Cannot find profiles directory');
+}
+function loadProfile(profilesDir, name) {
+    const filePath = path.join(profilesDir, `${name}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+function loadLedger(projectFolder) {
+    const ledgerPath = path.join(projectFolder, 'permissions.json');
+    if (fs.existsSync(ledgerPath)) {
+        const raw = JSON.parse(fs.readFileSync(ledgerPath, 'utf-8'));
+        return { stacks: raw.stacks ?? [], granted: raw.granted ?? [] };
+    }
+    return { stacks: [], granted: [] };
+}
+function saveLedger(projectFolder, ledger) {
+    const ledgerPath = path.join(projectFolder, 'permissions.json');
+    fs.writeFileSync(ledgerPath, JSON.stringify(ledger, null, 2) + '\n');
+}
+async function detectStacks(agent, projectSubdir) {
+    const strategy = getStrategy(agent);
+    const markers = Object.keys(STACK_MAP).join(' ');
+    // Resolve the directory to check on the member: prefer <workFolder>/<projectSubdir>,
+    // fall back to workFolder root. Using an absolute cd ensures remote (SSH) members
+    // check the right directory instead of defaulting to their home directory.
+    const checkDir = projectSubdir
+        ? `${agent.workFolder}/${projectSubdir}`.replace(/\\/g, '/')
+        : agent.workFolder.replace(/\\/g, '/');
+    const result = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls ${markers} 2>/dev/null || true`, 10000);
+    const found = new Set();
+    for (const line of result.stdout.split('\n')) {
+        const file = line.trim();
+        if (STACK_MAP[file])
+            found.add(STACK_MAP[file]);
+    }
+    // .sln/.csproj need glob - check separately
+    const dotnetCheck = await strategy.execCommand(`cd "${checkDir}" 2>/dev/null && ls *.sln *.csproj 2>/dev/null || true`, 5000);
+    if (dotnetCheck.stdout.trim())
+        found.add('dotnet');
+    return [...found];
+}
+function compose(profilesDir, role, stacks, ledger) {
+    const baseName = role === 'doer' ? 'base-dev' : 'base-reviewer';
+    const base = loadProfile(profilesDir, baseName);
+    const perms = new Set(base?.permissions?.allow ?? []);
+    const roleKey = role === 'doer' ? 'dev' : 'reviewer';
+    for (const stack of stacks) {
+        const profile = loadProfile(profilesDir, stack);
+        if (profile?.[roleKey]) {
+            for (const p of profile[roleKey])
+                perms.add(p);
+        }
+    }
+    // Merge ledger grants
+    for (const entry of ledger.granted) {
+        perms.add(entry.permission);
+    }
+    return [...perms];
+}
+/** Deliver a single config file to the member.
+ *  Creates parent directory and writes the content (JSON object or TOML string). */
+async function deliverConfigFile(strategy, agentOs, filePath, content) {
+    const dir = filePath.split('/').slice(0, -1).join('/');
+    const mkdirCmd = agentOs === 'windows'
+        ? `New-Item -ItemType Directory -Force "${dir.replace(/\//g, '\\')}"`
+        : `mkdir -p ${dir}`;
+    await strategy.execCommand(mkdirCmd, 5000);
+    const contentStr = typeof content === 'string'
+        ? content
+        : JSON.stringify(content, null, 2);
+    const writeCmd = agentOs === 'windows'
+        ? `[System.IO.File]::WriteAllText("${filePath.replace(/\//g, '\\')}", '${contentStr.replace(/'/g, "''")}', (New-Object System.Text.UTF8Encoding($false)))`
+        : `cat > ${filePath} << 'FLEET_PERMS_EOF'\n${contentStr}\nFLEET_PERMS_EOF`;
+    await strategy.execCommand(writeCmd, 5000);
+}
+export async function composePermissions(input) {
+    const agentOrError = resolveMember(input.member_id, input.member_name);
+    if (typeof agentOrError === 'string')
+        return agentOrError;
+    const agent = agentOrError;
+    const provider = getProvider(agent.llmProvider);
+    const strategy = getStrategy(agent);
+    const profilesDir = findProfilesDir();
+    const ledger = input.project_folder ? loadLedger(input.project_folder) : { stacks: [], granted: [] };
+    // Reactive grant mode
+    if (input.grant?.length) {
+        const blocked = input.grant.filter(p => NEVER_AUTO_GRANT.has(p));
+        if (blocked.length) {
+            return `❌ Cannot auto-grant dangerous permissions: ${blocked.join(', ')}. Escalate to user.`;
+        }
+        // Expand co-occurrences
+        const expanded = new Set(input.grant);
+        for (const p of input.grant) {
+            for (const co of CO_OCCURRENCE[p] ?? [])
+                expanded.add(co);
+        }
+        let allow;
+        if (provider.name === 'claude') {
+            // Claude: read existing allow list and merge
+            const readResult = await strategy.execCommand('cat .claude/settings.local.json 2>/dev/null || echo "{}"', 5000);
+            let current;
+            try {
+                current = JSON.parse(readResult.stdout.trim());
+            }
+            catch {
+                current = { permissions: { allow: [] } };
+            }
+            const existingAllow = new Set(current?.permissions?.allow ?? []);
+            for (const p of expanded)
+                existingAllow.add(p);
+            allow = [...existingAllow];
+        }
+        else {
+            // Non-Claude: pass grants directly; provider incorporates into role-based config
+            allow = [...expanded];
+        }
+        const configs = provider.composePermissionConfig(input.role, allow);
+        const paths = provider.permissionConfigPaths();
+        for (let i = 0; i < paths.length; i++) {
+            await deliverConfigFile(strategy, agent.os ?? 'linux', paths[i], configs[i]);
+        }
+        // Update ledger
+        if (input.project_folder) {
+            const reason = input.grant_reason ?? 'granted mid-sprint';
+            const date = new Date().toISOString().slice(0, 10);
+            for (const p of expanded) {
+                if (!ledger.granted.some(e => e.permission === p)) {
+                    ledger.granted.push({ permission: p, reason, date });
+                }
+            }
+            saveLedger(input.project_folder, ledger);
+        }
+        return `✅ Granted ${[...expanded].length} permissions on "${agent.friendlyName}" (${provider.name}):\n  ${[...expanded].join('\n  ')}`;
+    }
+    // Proactive compose mode
+    const projectSubdir = input.project_folder ? path.basename(input.project_folder) : undefined;
+    const stacks = await detectStacks(agent, projectSubdir);
+    // Update ledger stacks
+    if (input.project_folder) {
+        ledger.stacks = stacks;
+        saveLedger(input.project_folder, ledger);
+    }
+    const allow = compose(profilesDir, input.role, stacks, ledger);
+    const configs = provider.composePermissionConfig(input.role, allow);
+    const paths = provider.permissionConfigPaths();
+    for (let i = 0; i < paths.length; i++) {
+        await deliverConfigFile(strategy, agent.os ?? 'linux', paths[i], configs[i]);
+    }
+    return `✅ Permissions composed for "${agent.friendlyName}" (${input.role}, ${provider.name}):\n  Stacks: ${stacks.join(', ') || 'none detected'}\n  Config: ${paths.join(', ')}\n  Ledger grants: ${ledger.granted.length}`;
+}
+//# sourceMappingURL=compose-permissions.js.map