@bradygaster/squad-sdk 0.8.4 → 0.8.16

package/dist/ralph/triage.js

@@ -0,0 +1,310 @@
+import { normalizeEol } from '../utils/normalize-eol.js';
+/** Parse routing rules from routing.md content */
+export function parseRoutingRules(routingMd) {
+    const table = parseTableSection(routingMd, /^##\s*work\s*type\s*(?:→|->)\s*agent\b/i);
+    if (!table)
+        return [];
+    const workTypeIndex = findColumnIndex(table.headers, ['work type', 'type']);
+    const agentIndex = findColumnIndex(table.headers, ['agent', 'route to', 'route']);
+    const examplesIndex = findColumnIndex(table.headers, ['examples', 'example']);
+    if (workTypeIndex < 0 || agentIndex < 0)
+        return [];
+    const rules = [];
+    for (const row of table.rows) {
+        const workType = cleanCell(row[workTypeIndex] ?? '');
+        const agentName = cleanCell(row[agentIndex] ?? '');
+        const keywords = splitKeywords(examplesIndex >= 0 ? row[examplesIndex] : '');
+        if (!workType || !agentName)
+            continue;
+        rules.push({ workType, agentName, keywords });
+    }
+    return rules;
+}
+/** Parse module ownership from routing.md content */
+export function parseModuleOwnership(routingMd) {
+    const table = parseTableSection(routingMd, /^##\s*module\s*ownership\b/i);
+    if (!table)
+        return [];
+    const moduleIndex = findColumnIndex(table.headers, ['module', 'path']);
+    const primaryIndex = findColumnIndex(table.headers, ['primary']);
+    const secondaryIndex = findColumnIndex(table.headers, ['secondary']);
+    if (moduleIndex < 0 || primaryIndex < 0)
+        return [];
+    const modules = [];
+    for (const row of table.rows) {
+        const modulePath = normalizeModulePath(row[moduleIndex] ?? '');
+        const primary = cleanCell(row[primaryIndex] ?? '');
+        const secondaryRaw = cleanCell(secondaryIndex >= 0 ? row[secondaryIndex] ?? '' : '');
+        const secondary = normalizeOptionalOwner(secondaryRaw);
+        if (!modulePath || !primary)
+            continue;
+        modules.push({ modulePath, primary, secondary });
+    }
+    return modules;
+}
+/** Parse team roster from team.md content */
+export function parseRoster(teamMd) {
+    const table = parseTableSection(teamMd, /^##\s*members\b/i) ??
+        parseTableSection(teamMd, /^##\s*team\s*roster\b/i);
+    if (!table)
+        return [];
+    const nameIndex = findColumnIndex(table.headers, ['name']);
+    const roleIndex = findColumnIndex(table.headers, ['role']);
+    if (nameIndex < 0 || roleIndex < 0)
+        return [];
+    const excluded = new Set(['scribe', 'ralph']);
+    const members = [];
+    for (const row of table.rows) {
+        const name = cleanCell(row[nameIndex] ?? '');
+        const role = cleanCell(row[roleIndex] ?? '');
+        if (!name || !role)
+            continue;
+        if (excluded.has(name.toLowerCase()))
+            continue;
+        members.push({
+            name,
+            role,
+            label: `squad:${name.toLowerCase()}`,
+        });
+    }
+    return members;
+}
+/**
+ * Triage an issue using routing rules, module ownership, and roster.
+ * Priority order:
+ * 1. Module path match — issue mentions a file path matching module ownership
+ * 2. Work type keyword — issue content matches routing rule keywords
+ * 3. Role keyword — fallback to generic role-based matching (frontend/backend/test)
+ * 4. Lead fallback — assign to Lead/Architect if no match
+ */
+export function triageIssue(issue, rules, modules, roster) {
+    const issueText = `${issue.title}\n${issue.body ?? ''}`.toLowerCase();
+    const normalizedIssueText = normalizeTextForPathMatch(issueText);
+    const bestModule = findBestModuleMatch(normalizedIssueText, modules);
+    if (bestModule) {
+        const primaryMember = findMember(bestModule.primary, roster);
+        if (primaryMember) {
+            return {
+                agent: primaryMember,
+                reason: `Matched module path "${bestModule.modulePath}" to primary owner "${bestModule.primary}"`,
+                source: 'module-ownership',
+                confidence: 'high',
+            };
+        }
+        if (bestModule.secondary) {
+            const secondaryMember = findMember(bestModule.secondary, roster);
+            if (secondaryMember) {
+                return {
+                    agent: secondaryMember,
+                    reason: `Matched module path "${bestModule.modulePath}" to secondary owner "${bestModule.secondary}"`,
+                    source: 'module-ownership',
+                    confidence: 'medium',
+                };
+            }
+        }
+    }
+    const bestRule = findBestRuleMatch(issueText, rules);
+    if (bestRule) {
+        const agent = findMember(bestRule.rule.agentName, roster);
+        if (agent) {
+            return {
+                agent,
+                reason: `Matched routing keyword(s): ${bestRule.matchedKeywords.join(', ')}`,
+                source: 'routing-rule',
+                confidence: bestRule.matchedKeywords.length >= 2 ? 'high' : 'medium',
+            };
+        }
+    }
+    const roleMatch = findRoleKeywordMatch(issueText, roster);
+    if (roleMatch) {
+        return {
+            agent: roleMatch.agent,
+            reason: roleMatch.reason,
+            source: 'role-keyword',
+            confidence: 'medium',
+        };
+    }
+    const lead = findLeadFallback(roster);
+    if (!lead)
+        return null;
+    return {
+        agent: lead,
+        reason: 'No module, routing, or role keyword match — routed to Lead/Architect',
+        source: 'lead-fallback',
+        confidence: 'low',
+    };
+}
+function parseTableSection(markdown, sectionHeader) {
+    const lines = normalizeEol(markdown).split('\n');
+    let inSection = false;
+    const tableLines = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!inSection && sectionHeader.test(trimmed)) {
+            inSection = true;
+            continue;
+        }
+        if (inSection && /^##\s+/.test(trimmed)) {
+            break;
+        }
+        if (inSection && trimmed.startsWith('|')) {
+            tableLines.push(trimmed);
+        }
+    }
+    if (tableLines.length === 0)
+        return null;
+    let headers = null;
+    const rows = [];
+    for (const line of tableLines) {
+        const cells = parseTableLine(line);
+        if (cells.length === 0)
+            continue;
+        if (cells.every((cell) => /^:?-{2,}:?$/.test(cell)))
+            continue;
+        if (!headers) {
+            headers = cells;
+            continue;
+        }
+        rows.push(cells);
+    }
+    if (!headers)
+        return null;
+    return { headers, rows };
+}
+function parseTableLine(line) {
+    return line
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split('|')
+        .map((cell) => cell.trim());
+}
+function findColumnIndex(headers, candidates) {
+    const normalizedHeaders = headers.map((header) => cleanCell(header).toLowerCase());
+    for (const candidate of candidates) {
+        const index = normalizedHeaders.findIndex((header) => header.includes(candidate));
+        if (index >= 0)
+            return index;
+    }
+    return -1;
+}
+function cleanCell(value) {
+    return value
+        .replace(/`/g, '')
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, '$1')
+        .trim();
+}
+function splitKeywords(examplesCell) {
+    if (!examplesCell)
+        return [];
+    return examplesCell
+        .split(',')
+        .map((keyword) => cleanCell(keyword))
+        .filter((keyword) => keyword.length > 0);
+}
+function normalizeOptionalOwner(owner) {
+    if (!owner)
+        return null;
+    if (/^[-—–]+$/.test(owner))
+        return null;
+    return owner;
+}
+function normalizeModulePath(modulePath) {
+    return cleanCell(modulePath).replace(/\\/g, '/').toLowerCase();
+}
+function normalizeTextForPathMatch(text) {
+    return text.replace(/\\/g, '/').replace(/`/g, '');
+}
+function normalizeName(value) {
+    return cleanCell(value)
+        .toLowerCase()
+        .replace(/[^\w@\s-]/g, '')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function findMember(target, roster) {
+    const normalizedTarget = normalizeName(target);
+    if (!normalizedTarget)
+        return null;
+    for (const member of roster) {
+        if (normalizeName(member.name) === normalizedTarget)
+            return member;
+    }
+    for (const member of roster) {
+        if (normalizeName(member.role) === normalizedTarget)
+            return member;
+    }
+    for (const member of roster) {
+        const memberName = normalizeName(member.name);
+        if (normalizedTarget.includes(memberName) || memberName.includes(normalizedTarget)) {
+            return member;
+        }
+    }
+    for (const member of roster) {
+        const memberRole = normalizeName(member.role);
+        if (normalizedTarget.includes(memberRole) || memberRole.includes(normalizedTarget)) {
+            return member;
+        }
+    }
+    return null;
+}
+function findBestModuleMatch(issueText, modules) {
+    let best = null;
+    let bestLength = -1;
+    for (const module of modules) {
+        const modulePath = normalizeModulePath(module.modulePath);
+        if (!modulePath)
+            continue;
+        if (!issueText.includes(modulePath))
+            continue;
+        if (modulePath.length > bestLength) {
+            best = module;
+            bestLength = modulePath.length;
+        }
+    }
+    return best;
+}
+function findBestRuleMatch(issueText, rules) {
+    let best = null;
+    let bestScore = 0;
+    for (const rule of rules) {
+        const matchedKeywords = rule.keywords
+            .map((keyword) => keyword.toLowerCase())
+            .filter((keyword) => keyword.length > 0 && issueText.includes(keyword));
+        if (matchedKeywords.length === 0)
+            continue;
+        const score = matchedKeywords.length * 100 + matchedKeywords.reduce((sum, keyword) => sum + keyword.length, 0);
+        if (score > bestScore) {
+            best = {
+                rule,
+                matchedKeywords,
+            };
+            bestScore = score;
+        }
+    }
+    return best;
+}
+function findRoleKeywordMatch(issueText, roster) {
+    for (const member of roster) {
+        const role = member.role.toLowerCase();
+        if ((role.includes('frontend') || role.includes('ui')) &&
+            (issueText.includes('ui') || issueText.includes('frontend') || issueText.includes('css'))) {
+            return { agent: member, reason: 'Matched frontend/UI role keywords' };
+        }
+        if ((role.includes('backend') || role.includes('api') || role.includes('server')) &&
+            (issueText.includes('api') || issueText.includes('backend') || issueText.includes('database'))) {
+            return { agent: member, reason: 'Matched backend/API role keywords' };
+        }
+        if ((role.includes('test') || role.includes('qa')) &&
+            (issueText.includes('test') || issueText.includes('bug') || issueText.includes('fix'))) {
+            return { agent: member, reason: 'Matched testing/QA role keywords' };
+        }
+    }
+    return null;
+}
+function findLeadFallback(roster) {
+    return (roster.find((member) => {
+        const role = member.role.toLowerCase();
+        return role.includes('lead') || role.includes('architect');
+    }) ?? null);
+}
+//# sourceMappingURL=triage.js.map

package/dist/ralph/triage.js.map

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

package/dist/remote/bridge.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Squad Remote Control — RemoteBridge
+ *
+ * WebSocket server that bridges Squad's EventBus to remote PWA clients.
+ * Maintains message history, broadcasts events, handles incoming commands.
+ */
+import http from 'node:http';
+import { type RCMessage, type RCAgent } from './protocol.js';
+import type { RemoteBridgeConfig, RemoteConnection, ConnectionState } from './types.js';
+export declare class RemoteBridge {
+    private config;
+    private server;
+    private wss;
+    private connections;
+    private messages;
+    private agents;
+    private state;
+    private messageIdCounter;
+    private staticHandler?;
+    private acpEventLog;
+    private wsRateLimit;
+    private ipConnections;
+    private httpRateLimits;
+    private sessionToken;
+    private tickets;
+    private readonly SESSION_TTL;
+    private readonly sessionCreatedAt;
+    private auditLogDir;
+    private auditLogPath;
+    private auditLog;
+    constructor(config: RemoteBridgeConfig);
+    /** Set a handler to serve static PWA files */
+    setStaticHandler(handler: (req: http.IncomingMessage, res: http.ServerResponse) => void): void;
+    /** Get the session token for WebSocket authentication */
+    getSessionToken(): string;
+    /** Get the audit log file path */
+    getAuditLogPath(): string;
+    /** Get the session expiry timestamp */
+    getSessionExpiry(): number;
+    /** Start the HTTP + WebSocket server */
+    start(): Promise<number>;
+    /** Stop the server and clean up */
+    stop(): Promise<void>;
+    /** Get the actual port the server is listening on */
+    getPort(): number;
+    getState(): ConnectionState;
+    getConnectionCount(): number;
+    getConnections(): RemoteConnection[];
+    /** Add a message to history and broadcast to clients */
+    addMessage(role: 'user' | 'agent' | 'system', content: string, agentName?: string): RCMessage;
+    getMessageHistory(): RCMessage[];
+    /** Send a streaming delta to all clients */
+    sendDelta(sessionId: string, agentName: string, content: string): void;
+    /** Update the agent roster and broadcast */
+    updateAgents(agents: RCAgent[]): void;
+    /** Update a single agent's status */
+    updateAgentStatus(name: string, status: RCAgent['status']): void;
+    sendToolCall(agentName: string, tool: string, args: Record<string, unknown>, status: 'running' | 'completed' | 'error'): void;
+    sendPermissionRequest(id: string, agentName: string, tool: string, args: Record<string, unknown>, description: string): void;
+    sendUsage(model: string, inputTokens: number, outputTokens: number, cost: number): void;
+    sendError(message: string, agentName?: string): void;
+    private handleSessionsAPI;
+    private handleDeleteSession;
+    /** Redact secrets from text before replay */
+    private redactSecrets;
+    private passthroughWrite;
+    /** Set a passthrough pipe — raw WebSocket messages go to this writer,
+     *  and call passthroughFromAgent() to send agent responses back */
+    setPassthrough(writer: (msg: string) => void): void;
+    /** Forward a raw message from the agent (copilot stdout) to all clients + record */
+    passthroughFromAgent(line: string): void;
+    private handleConnection;
+    private handleClientCommand;
+    private broadcast;
+    private send;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/remote/bridge.d.ts.map

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