@pennyfarthing/core 10.4.0 → 11.0.0

package/packages/core/dist/server/api/git.js

@@ -0,0 +1,382 @@
+import { Router } from 'express';
+import { exec, execSync } from 'child_process';
+import { promisify } from 'util';
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+import { detectPennyfarthingProject } from '../pennyfarthing.js';
+const execAsync = promisify(exec);
+/**
+ * Per-repo mutex to prevent concurrent git operations that cause lock conflicts
+ * Maps repo path to a promise that resolves when the current operation completes
+ */
+const repoLocks = new Map();
+/**
+ * Per-repo git fetch cooldown to prevent frequent network calls during active sessions.
+ * Maps repo path to the timestamp of the last successful git fetch.
+ * Story 103-21
+ */
+const lastFetchTimes = new Map();
+/** Default cooldown between git fetch calls per repo (ms). */
+export const GIT_FETCH_COOLDOWN_MS = 60_000;
+/**
+ * Acquire a lock for a repo, ensuring only one git operation runs at a time
+ * Returns a release function to call when done
+ */
+async function acquireRepoLock(repoPath) {
+    // Wait for any existing operation to complete
+    const existingLock = repoLocks.get(repoPath);
+    if (existingLock) {
+        await existingLock;
+    }
+    // Create a new lock
+    let releaseLock;
+    const lockPromise = new Promise(resolve => {
+        releaseLock = resolve;
+    });
+    repoLocks.set(repoPath, lockPromise);
+    return () => {
+        releaseLock();
+        // Clean up the lock after a short delay to allow batched requests
+        setTimeout(() => {
+            if (repoLocks.get(repoPath) === lockPromise) {
+                repoLocks.delete(repoPath);
+            }
+        }, 100);
+    };
+}
+/**
+ * Get repos from repos.yaml
+ * Checks project root first, then .claude/project/ fallback.
+ * Returns array of repo configs, falls back to single repo (current dir) if none configured.
+ */
+export function getReposFromConfig(projectDir) {
+    // Check .pennyfarthing/ first (canonical runtime location), then project root fallback
+    const candidates = [
+        join(projectDir, '.pennyfarthing', 'repos.yaml'),
+        join(projectDir, 'repos.yaml'),
+    ];
+    const configPath = candidates.find(p => existsSync(p));
+    if (!configPath) {
+        const dirName = projectDir.split('/').pop() || 'project';
+        return [{ name: dirName, path: '.' }];
+    }
+    try {
+        const configContent = readFileSync(configPath, 'utf-8');
+        const config = parseYaml(configContent);
+        if (!config?.repos || typeof config.repos !== 'object') {
+            const dirName = projectDir.split('/').pop() || 'project';
+            return [{ name: dirName, path: '.' }];
+        }
+        const repos = [];
+        for (const [name, repoConfig] of Object.entries(config.repos)) {
+            const rc = repoConfig;
+            repos.push({
+                name,
+                path: rc?.path || name,
+            });
+        }
+        return repos.length > 0 ? repos : [{ name: projectDir.split('/').pop() || 'project', path: '.' }];
+    }
+    catch (err) {
+        console.warn('[Git API] Failed to parse repos.yaml:', err);
+        const dirName = projectDir.split('/').pop() || 'project';
+        return [{ name: dirName, path: '.' }];
+    }
+}
+/**
+ * Get git status for all configured repos (sync - blocks event loop, use getAllReposGitInfoAsync when possible)
+ */
+export function getAllReposGitInfo(projectDir) {
+    const repos = getReposFromConfig(projectDir);
+    return repos.map(repo => {
+        const repoPath = join(projectDir, repo.path);
+        const gitInfo = getGitInfo(repoPath);
+        return {
+            name: repo.name,
+            path: repo.path,
+            branch: gitInfo?.branch || 'unknown',
+            clean: gitInfo?.clean ?? true,
+            ahead: gitInfo?.ahead ?? null,
+            behind: gitInfo?.behind ?? null,
+            developBehind: gitInfo?.developBehind ?? null,
+            dirtyFiles: gitInfo?.dirtyFiles ?? [],
+        };
+    });
+}
+/**
+ * Get git status for all configured repos (async - does not block event loop)
+ */
+export async function getAllReposGitInfoAsync(projectDir) {
+    const repos = getReposFromConfig(projectDir);
+    const results = await Promise.all(repos.map(async (repo) => {
+        const repoPath = join(projectDir, repo.path);
+        const gitInfo = await getGitInfoAsync(repoPath);
+        return {
+            name: repo.name,
+            path: repo.path,
+            branch: gitInfo?.branch || 'unknown',
+            clean: gitInfo?.clean ?? true,
+            ahead: gitInfo?.ahead ?? null,
+            behind: gitInfo?.behind ?? null,
+            developBehind: gitInfo?.developBehind ?? null,
+            dirtyFiles: gitInfo?.dirtyFiles ?? [],
+        };
+    }));
+    return results;
+}
+// Get git status for project (sync - blocks event loop)
+export function getGitInfo(projectDir) {
+    try {
+        // Get current branch
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+        }).trim();
+        // Get dirty files using --porcelain for parseable output
+        let dirtyFiles = [];
+        let clean = true;
+        try {
+            const statusOutput = execSync('git status --porcelain', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+            }).trim();
+            if (statusOutput) {
+                clean = false;
+                dirtyFiles = statusOutput.split('\n').map(line => {
+                    const status = line.substring(0, 2).trim() || '?';
+                    const path = line.substring(3);
+                    return { status, path };
+                });
+            }
+        }
+        catch {
+            // Fall back to diff-index check if porcelain fails
+            try {
+                execSync('git diff-index --quiet HEAD --', {
+                    cwd: projectDir,
+                    encoding: 'utf-8',
+                });
+                clean = true;
+            }
+            catch {
+                clean = false;
+            }
+        }
+        // Get ahead/behind counts (suppress stderr for branches without upstream)
+        let ahead = null;
+        let behind = null;
+        try {
+            const aheadOutput = execSync('git rev-list --count @{u}..HEAD', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            ahead = parseInt(aheadOutput.trim(), 10);
+            const behindOutput = execSync('git rev-list --count HEAD..@{u}', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            behind = parseInt(behindOutput.trim(), 10);
+        }
+        catch {
+            // No upstream configured - leave as null
+        }
+        // Get commits that origin/develop has that current branch doesn't
+        let developBehind = null;
+        try {
+            const developBehindOutput = execSync('git rev-list --count HEAD..origin/develop', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            developBehind = parseInt(developBehindOutput.trim(), 10);
+        }
+        catch {
+            // origin/develop doesn't exist - leave as null
+        }
+        return { branch, clean, ahead, behind, dirtyFiles, developBehind };
+    }
+    catch (error) {
+        // Not a git repo or git command failed - return null gracefully
+        // Handles: not a git repository, EPIPE, ENOENT, etc.
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorCode = error?.code;
+        // Log non-trivial errors for debugging but don't crash
+        if (!errorMessage.includes('not a git repository')) {
+            console.warn(`getGitInfo failed (${errorCode || 'unknown'}): ${errorMessage}`);
+        }
+        return null;
+    }
+}
+/**
+ * Get git status for project (async - does not block event loop)
+ * This should be preferred over getGitInfo for WebSocket broadcasts and polling
+ * Uses a per-repo mutex to prevent git lock conflicts from concurrent operations
+ */
+export async function getGitInfoAsync(projectDir) {
+    // Acquire lock to prevent concurrent git operations on the same repo
+    const releaseLock = await acquireRepoLock(projectDir);
+    try {
+        // Fetch latest refs from remote (quiet, no output)
+        // Throttled: only fetch once per GIT_FETCH_COOLDOWN_MS per repo (Story 103-21)
+        const now = Date.now();
+        const lastFetch = lastFetchTimes.get(projectDir) ?? 0;
+        if (now - lastFetch >= GIT_FETCH_COOLDOWN_MS) {
+            try {
+                await execAsync('git fetch --quiet', {
+                    cwd: projectDir,
+                    encoding: 'utf-8',
+                    timeout: 10000, // 10s timeout for network operation
+                });
+                lastFetchTimes.set(projectDir, Date.now());
+            }
+            catch {
+                // Fetch failed (offline, no remote, etc.) - continue with local refs
+            }
+        }
+        // Get current branch
+        const { stdout: branchOutput } = await execAsync('git rev-parse --abbrev-ref HEAD', {
+            cwd: projectDir,
+            encoding: 'utf-8',
+        });
+        const branch = branchOutput.trim();
+        // Get dirty files using --porcelain for parseable output
+        let dirtyFiles = [];
+        let clean = true;
+        try {
+            const { stdout: statusOutput } = await execAsync('git status --porcelain', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+            });
+            if (statusOutput.trim()) {
+                clean = false;
+                dirtyFiles = statusOutput.trim().split('\n').map(line => {
+                    const status = line.substring(0, 2).trim() || '?';
+                    const path = line.substring(3);
+                    return { status, path };
+                });
+            }
+        }
+        catch {
+            // Fall back to diff-index check if porcelain fails
+            try {
+                await execAsync('git diff-index --quiet HEAD --', {
+                    cwd: projectDir,
+                    encoding: 'utf-8',
+                });
+                clean = true;
+            }
+            catch {
+                clean = false;
+            }
+        }
+        // Get ahead/behind counts vs tracking branch
+        let ahead = null;
+        let behind = null;
+        try {
+            const { stdout: aheadOutput } = await execAsync('git rev-list --count @{u}..HEAD', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+            });
+            ahead = parseInt(aheadOutput.trim(), 10);
+            const { stdout: behindOutput } = await execAsync('git rev-list --count HEAD..@{u}', {
+                cwd: projectDir,
+                encoding: 'utf-8',
+            });
+            behind = parseInt(behindOutput.trim(), 10);
+        }
+        catch {
+            // No upstream configured - leave as null
+        }
+        // Get commits that origin/develop has that current branch doesn't
+        // This alerts when develop has moved ahead (work done in another clone)
+        let developBehind = null;
+        try {
+            const { stdout: developBehindOutput } = await execAsync('git rev-list --count HEAD..origin/develop', { cwd: projectDir, encoding: 'utf-8' });
+            developBehind = parseInt(developBehindOutput.trim(), 10);
+        }
+        catch {
+            // origin/develop doesn't exist or other error - leave as null
+        }
+        releaseLock();
+        return { branch, clean, ahead, behind, dirtyFiles, developBehind };
+    }
+    catch (error) {
+        releaseLock();
+        // Not a git repo or git command failed - return null gracefully
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        const errorCode = error?.code;
+        // Log non-trivial errors for debugging but don't crash
+        if (!errorMessage.includes('not a git repository')) {
+            console.warn(`getGitInfoAsync failed (${errorCode || 'unknown'}): ${errorMessage}`);
+        }
+        return null;
+    }
+}
+/**
+ * Reset the fetch cooldown for a repo, allowing the next getGitInfoAsync call
+ * to perform a git fetch immediately. Used by force-refresh paths.
+ * Story 103-21
+ */
+export function resetFetchCooldown(projectDir) {
+    if (projectDir) {
+        lastFetchTimes.delete(projectDir);
+    }
+    else {
+        lastFetchTimes.clear();
+    }
+}
+// Callback for forcing git refresh (set by websocket.ts)
+let forceRefreshCallback = null;
+export function setForceRefreshCallback(callback) {
+    forceRefreshCallback = callback;
+}
+// Create git API router
+export function createGitRouter(getProjectDir) {
+    const router = Router();
+    // Git API - POST to force refresh (debugging/manual trigger)
+    router.post('/refresh', async (_req, res) => {
+        const projectDir = getProjectDir();
+        console.log('[Git API] POST /refresh called, projectDir:', projectDir);
+        if (!detectPennyfarthingProject(projectDir)) {
+            console.log('[Git API] Not a Pennyfarthing project');
+            return res.status(404).json({ error: 'Not a Pennyfarthing project' });
+        }
+        if (forceRefreshCallback) {
+            console.log('[Git API] Calling forceRefreshCallback...');
+            resetFetchCooldown(projectDir);
+            await forceRefreshCallback(projectDir);
+            console.log('[Git API] forceRefreshCallback complete');
+            res.json({ success: true, message: 'Git cache refreshed and broadcast sent' });
+        }
+        else {
+            console.log('[Git API] No forceRefreshCallback registered!');
+            res.status(500).json({ error: 'Refresh callback not registered' });
+        }
+    });
+    // Git API - GET current git status (async to avoid blocking event loop)
+    router.get('/', async (_req, res) => {
+        const projectDir = getProjectDir();
+        if (!detectPennyfarthingProject(projectDir)) {
+            return res.status(404).json({ error: 'Not a Pennyfarthing project' });
+        }
+        const gitInfo = await getGitInfoAsync(projectDir);
+        if (!gitInfo) {
+            return res.status(404).json({ error: 'Not a git repository' });
+        }
+        res.json(gitInfo);
+    });
+    // Git API - GET status for all configured repos (async to avoid blocking event loop)
+    router.get('/all', async (_req, res) => {
+        const projectDir = getProjectDir();
+        if (!detectPennyfarthingProject(projectDir)) {
+            return res.status(404).json({ error: 'Not a Pennyfarthing project' });
+        }
+        const allReposInfo = await getAllReposGitInfoAsync(projectDir);
+        res.json(allReposInfo);
+    });
+    return router;
+}
+//# sourceMappingURL=git.js.map

package/packages/core/dist/server/api/git.js.map

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

package/packages/core/dist/server/api/health-score.d.ts

@@ -0,0 +1,3 @@
+import { Router } from 'express';
+export declare function createHealthScoreRouter(getProjectDir: () => string): Router;
+//# sourceMappingURL=health-score.d.ts.map

package/packages/core/dist/server/api/health-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.d.ts","sourceRoot":"","sources":["../../../src/server/api/health-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAIjC,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,MAAM,GAAG,MAAM,CAgD3E"}

package/packages/core/dist/server/api/health-score.js

@@ -0,0 +1,47 @@
+import { Router } from 'express';
+import { execFile } from 'child_process';
+import { join } from 'path';
+export function createHealthScoreRouter(getProjectDir) {
+    const router = Router();
+    router.get('/', (req, res) => {
+        const projectDir = getProjectDir();
+        const args = ['-m', 'pennyfarthing_scripts.healthscore', 'analyze', '--format', 'json', '--no-cache'];
+        const pythonPath = join(projectDir, 'pennyfarthing');
+        console.log('[HealthScore] Starting analysis, cwd=%s, PYTHONPATH=%s', pythonPath, pythonPath);
+        execFile('python3', args, {
+            cwd: pythonPath,
+            env: { ...process.env, PYTHONPATH: pythonPath },
+            timeout: 60000,
+        }, (err, stdout, stderr) => {
+            // Always log stderr — it contains per-dimension probe logs
+            if (stderr) {
+                console.log('[HealthScore] Python stderr:\n%s', stderr);
+            }
+            if (err) {
+                console.error('[HealthScore] Analysis failed:', err.message);
+                res.status(500).json({
+                    success: false,
+                    error: stderr || err.message,
+                });
+                return;
+            }
+            try {
+                const data = JSON.parse(stdout);
+                const dims = data.dimensions || [];
+                const scored = dims.filter((d) => d.score !== null).length;
+                console.log('[HealthScore] Success: composite=%.1f, %d/%d dimensions scored', data.composite_score, scored, dims.length);
+                res.json(data);
+            }
+            catch (parseErr) {
+                console.error('[HealthScore] JSON parse failed:', parseErr);
+                console.error('[HealthScore] Raw stdout: %s', stdout.slice(0, 500));
+                res.status(500).json({
+                    success: false,
+                    error: 'Failed to parse health score output',
+                });
+            }
+        });
+    });
+    return router;
+}
+//# sourceMappingURL=health-score.js.map

package/packages/core/dist/server/api/health-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.js","sourceRoot":"","sources":["../../../src/server/api/health-score.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,MAAM,UAAU,uBAAuB,CAAC,aAA2B;IACjE,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;IAExB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QAC3B,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,mCAAmC,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QACtG,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,wDAAwD,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;QAE9F,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE;YACxB,GAAG,EAAE,UAAU;YACf,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE;YAC/C,OAAO,EAAE,KAAK;SACf,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACzB,2DAA2D;YAC3D,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,MAAM,CAAC,CAAC;YAC1D,CAAC;YAED,IAAI,GAAG,EAAE,CAAC;gBACR,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC7D,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,MAAM,IAAI,GAAG,CAAC,OAAO;iBAC7B,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBAChC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;gBACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAA2B,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC;gBACrF,OAAO,CAAC,GAAG,CAAC,gEAAgE,EAC1E,IAAI,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBAC7C,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;YAAC,OAAO,QAAQ,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,QAAQ,CAAC,CAAC;gBAC5D,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;gBACpE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;oBACnB,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,qCAAqC;iBAC7C,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/packages/core/dist/server/api/hook-request.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Hook Request API Router
+ *
+ * Handles approval requests from Claude Code hooks via WheelHub.
+ * Per ADR-0004: All communication converges through WheelHub.
+ *
+ * Flow:
+ * 1. Hook script sends POST /api/hook-request with tool data
+ * 2. WheelHub checks allowlist/grants for auto-approval
+ * 3. If manual approval needed, broadcasts to WebSocket clients
+ * 4. Client shows approval modal, user decides
+ * 5. Client sends decision back via WebSocket
+ * 6. WheelHub returns HTTP response to hook
+ *
+ * Story: MSSCI-12409 - Hook consistency and WheelHub consolidation
+ */
+import { Router } from 'express';
+import { WebSocket } from 'ws';
+export type HookSeverity = 'safe' | 'normal' | 'destructive';
+interface SeverityResult {
+    severity: HookSeverity;
+    warning?: string;
+}
+/**
+ * Classify the severity of a hook request server-side.
+ * Combines tool-name classification with dangerous-path detection.
+ */
+export declare function classifyHookSeverity(toolName: string, input: Record<string, unknown>): SeverityResult;
+export declare function getHookClients(): Set<WebSocket>;
+export declare function addHookClient(ws: WebSocket): void;
+/**
+ * Resolve a pending approval from client response
+ */
+export declare function resolveApproval(toolId: string, approved: boolean, data?: Record<string, unknown>): boolean;
+/**
+ * Handle WebSocket message from client
+ */
+export declare function handleHookWebSocketMessage(ws: WebSocket, message: string): void;
+export declare function createHookRequestRouter(): Router;
+export {};
+//# sourceMappingURL=hook-request.d.ts.map

package/packages/core/dist/server/api/hook-request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hook-request.d.ts","sourceRoot":"","sources":["../../../src/server/api/hook-request.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AA2E/B,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAE7D,UAAU,cAAc;IACtB,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAuBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,cAAc,CAkDhB;AAMD,wBAAgB,cAAc,IAAI,GAAG,CAAC,SAAS,CAAC,CAE/C;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,SAAS,GAAG,IAAI,CAGjD;AA+BD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAcT;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA6B/E;AAwFD,wBAAgB,uBAAuB,IAAI,MAAM,CAkBhD"}