@planu/cli 1.1.1 → 1.2.0

package/dist/engine/tech-debt-manager.js

@@ -0,0 +1,152 @@
+// ---------------------------------------------------------------------------
+// ID generation
+// ---------------------------------------------------------------------------
+/** Generate a simple UUID-like ID for a tech debt item. */
+export function generateDebtId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).slice(2, 8);
+    return `debt-${timestamp}-${random}`;
+}
+// ---------------------------------------------------------------------------
+// Metrics
+// ---------------------------------------------------------------------------
+/** Compute summary metrics from a list of tech debt items. */
+export function computeTechDebtMetrics(items) {
+    const open = items.filter((i) => i.status === 'open');
+    const resolved = items.filter((i) => i.status === 'resolved');
+    const bySeverity = {};
+    const byCategory = {};
+    for (const item of open) {
+        bySeverity[item.severity] = (bySeverity[item.severity] ?? 0) + 1;
+        byCategory[item.category] = (byCategory[item.category] ?? 0) + 1;
+    }
+    return {
+        totalItems: items.length,
+        openItems: open.length,
+        resolvedItems: resolved.length,
+        totalOpenHours: open.reduce((acc, i) => acc + i.estimatedHours, 0),
+        bySeverity,
+        byCategory,
+    };
+}
+// ---------------------------------------------------------------------------
+// Forecast
+// ---------------------------------------------------------------------------
+/** Calculate weekly accumulation rate from historical items. */
+function weeklyRate(items) {
+    if (items.length === 0) {
+        return 0;
+    }
+    const sorted = [...items].sort((a, b) => new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime());
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    /* v8 ignore next 2 */
+    if (!first || !last) {
+        return 0;
+    }
+    const spanMs = new Date(last.createdAt).getTime() - new Date(first.createdAt).getTime();
+    const spanWeeks = Math.max(spanMs / (1000 * 60 * 60 * 24 * 7), 1);
+    return items.length / spanWeeks;
+}
+/** Forecast tech debt growth given current items and config. */
+export function forecastTechDebt(items, config) {
+    const open = items.filter((i) => i.status === 'open');
+    const currentOpenHours = open.reduce((acc, i) => acc + i.estimatedHours, 0);
+    const avgHoursPerItem = open.length > 0 ? currentOpenHours / open.length : 4;
+    const weeklyAccumulationRate = weeklyRate(items);
+    const weeklyHoursRate = weeklyAccumulationRate * avgHoursPerItem;
+    const projectedHoursIn4Weeks = currentOpenHours + weeklyHoursRate * 4;
+    const maxHours = config.maxHours ?? null;
+    let weeksUntilBudgetExceeded = null;
+    if (maxHours !== null && weeklyHoursRate > 0) {
+        const remainingCapacity = maxHours - currentOpenHours;
+        if (remainingCapacity <= 0) {
+            weeksUntilBudgetExceeded = 0;
+        }
+        else {
+            weeksUntilBudgetExceeded = Math.ceil(remainingCapacity / weeklyHoursRate);
+        }
+    }
+    return {
+        currentOpenHours,
+        weeklyAccumulationRate,
+        weeksUntilBudgetExceeded,
+        projectedHoursIn4Weeks,
+        budgetMaxHours: maxHours,
+    };
+}
+// ---------------------------------------------------------------------------
+// HTML report
+// ---------------------------------------------------------------------------
+/** Generate a simple HTML report of tech debt. */
+export function generateTechDebtReport(items, config) {
+    const metrics = computeTechDebtMetrics(items);
+    const forecast = forecastTechDebt(items, config);
+    const open = items.filter((i) => i.status === 'open');
+    const severityBadge = (s) => {
+        const colors = {
+            critical: '#dc2626',
+            high: '#ea580c',
+            medium: '#d97706',
+            low: '#16a34a',
+        };
+        const color = colors[s] ?? '#6b7280';
+        return `<span style="background:${color};color:#fff;padding:2px 6px;border-radius:4px;font-size:12px">${s}</span>`;
+    };
+    const rows = open
+        .map((i) => `
+    <tr>
+      <td>${i.id}</td>
+      <td>${i.description}</td>
+      <td>${severityBadge(i.severity)}</td>
+      <td>${i.category}</td>
+      <td>${String(i.estimatedHours)}h</td>
+      <td>${i.specId ?? '-'}</td>
+      <td>${i.createdAt.slice(0, 10)}</td>
+    </tr>`)
+        .join('');
+    return `<!DOCTYPE html>
+<html>
+<head><title>Tech Debt Report</title>
+<style>body{font-family:sans-serif;padding:20px}table{border-collapse:collapse;width:100%}
+th,td{border:1px solid #ddd;padding:8px;text-align:left}th{background:#f3f4f6}</style>
+</head>
+<body>
+<h1>Tech Debt Report</h1>
+<section>
+  <h2>Summary</h2>
+  <p>Open items: <strong>${String(metrics.openItems)}</strong> |
+     Total open hours: <strong>${String(metrics.totalOpenHours)}h</strong> |
+     Resolved: <strong>${String(metrics.resolvedItems)}</strong></p>
+  <p>Weekly accumulation rate: <strong>${forecast.weeklyAccumulationRate.toFixed(1)} items/week</strong></p>
+  ${forecast.weeksUntilBudgetExceeded !== null ? `<p>Budget exceeded in: <strong>${String(forecast.weeksUntilBudgetExceeded)} weeks</strong></p>` : ''}
+  ${forecast.budgetMaxHours !== null ? `<p>Budget max hours: <strong>${String(forecast.budgetMaxHours)}h</strong></p>` : ''}
+</section>
+<section>
+  <h2>Open Debt Items</h2>
+  <table>
+    <tr><th>ID</th><th>Description</th><th>Severity</th><th>Category</th><th>Est. Hours</th><th>Spec</th><th>Created</th></tr>
+    ${rows || '<tr><td colspan="7">No open debt items.</td></tr>'}
+  </table>
+</section>
+</body>
+</html>`;
+}
+// ---------------------------------------------------------------------------
+// Filter helpers
+// ---------------------------------------------------------------------------
+/** Filter tech debt items by status and/or severity and/or category. */
+export function filterDebtItems(items, status, severity, category) {
+    let result = items;
+    if (status && status !== 'all') {
+        result = result.filter((i) => i.status === status);
+    }
+    if (severity) {
+        result = result.filter((i) => i.severity === severity);
+    }
+    if (category) {
+        result = result.filter((i) => i.category === category);
+    }
+    return result;
+}
+//# sourceMappingURL=tech-debt-manager.js.map

package/dist/engine/tech-debt-manager.js.map

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

package/dist/engine/validation-loop.d.ts

@@ -0,0 +1,4 @@
+import type { Spec, SpecHealthScore, ValidationLoopResult } from '../types/index.js';
+export declare function computeSpecHealth(projectPath: string, spec: Spec | undefined): Promise<SpecHealthScore>;
+export declare function buildValidationPlan(specIds: string[], maxIterations: number, testCommand: string, autoFix: boolean): ValidationLoopResult;
+//# sourceMappingURL=validation-loop.d.ts.map

package/dist/engine/validation-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-loop.d.ts","sourceRoot":"","sources":["../../src/engine/validation-loop.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,IAAI,EACJ,eAAe,EACf,oBAAoB,EAErB,MAAM,mBAAmB,CAAC;AAyB3B,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,IAAI,GAAG,SAAS,GACrB,OAAO,CAAC,eAAe,CAAC,CAqF1B;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,GACf,oBAAoB,CA6BtB"}

package/dist/engine/validation-loop.js

@@ -0,0 +1,133 @@
+// engine/validation-loop.ts — SPEC-369: Test Automation Loop
+import { readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+const POINTS_SPEC_COMPLETE = 20;
+const POINTS_TESTS_EXIST = 20;
+const POINTS_TESTS_PASS = 20;
+const POINTS_COVERAGE_OK = 20;
+const POINTS_NO_DRIFT = 20;
+/**
+ * Check if a tests/ directory contains files mentioning the given spec or its tools.
+ */
+async function findTestsForSpec(projectPath, specId) {
+    const testsDir = join(projectPath, 'tests');
+    try {
+        const files = await readdir(testsDir, { recursive: true });
+        const specLower = specId.toLowerCase();
+        return files.some((f) => {
+            const name = typeof f === 'string' ? f : '';
+            return name.toLowerCase().includes(specLower);
+        });
+    }
+    catch {
+        return false;
+    }
+}
+export async function computeSpecHealth(projectPath, spec) {
+    const specId = spec?.id ?? 'unknown';
+    const breakdown = {
+        specComplete: 0,
+        testsExist: 0,
+        testsPass: 0,
+        coverageOk: 0,
+        noDrift: 0,
+    };
+    const details = {};
+    if (!spec) {
+        return { specId, total: 0, breakdown, details: { error: `Spec ${specId} not found` } };
+    }
+    // specComplete: has title + description + non-empty acceptanceCriteria
+    const specData = spec;
+    const hasTitle = typeof spec.title === 'string' && spec.title.trim().length > 0;
+    const hasDescription = typeof specData.description === 'string' && specData.description.trim().length > 0;
+    const hasCriteria = Array.isArray(specData.acceptanceCriteria) &&
+        specData.acceptanceCriteria.length > 0;
+    if (hasTitle && hasDescription && hasCriteria) {
+        breakdown.specComplete = POINTS_SPEC_COMPLETE;
+        details.specComplete = 'OK — title, description, and criteria present';
+    }
+    else {
+        const missing = [];
+        if (!hasTitle) {
+            missing.push('title');
+        }
+        if (!hasDescription) {
+            missing.push('description');
+        }
+        if (!hasCriteria) {
+            missing.push('acceptanceCriteria');
+        }
+        details.specComplete = `Missing: ${missing.join(', ')}`;
+    }
+    // testsExist: check tests/ dir for files mentioning specId
+    const testsFound = await findTestsForSpec(projectPath, specId);
+    if (testsFound) {
+        breakdown.testsExist = POINTS_TESTS_EXIST;
+        details.testsExist = `OK — test file found referencing ${specId}`;
+    }
+    else {
+        details.testsExist = `No test file found for ${specId}`;
+    }
+    // testsPass: 20 if last_validation was successful (not computable in real-time)
+    const lastValidation = specData.lastValidation;
+    if (lastValidation?.passed === true) {
+        breakdown.testsPass = POINTS_TESTS_PASS;
+        details.testsPass = 'OK — last validation passed';
+    }
+    else {
+        details.testsPass = 'No passing validation recorded';
+    }
+    // coverageOk: 20 if spec is done
+    if (spec.status === 'done') {
+        breakdown.coverageOk = POINTS_COVERAGE_OK;
+        details.coverageOk = 'OK — spec is done';
+    }
+    else {
+        details.coverageOk = `Spec status is '${spec.status}', not done`;
+    }
+    // noDrift: 20 if status is done or implementing (no drift registered)
+    const safeDrift = specData.driftScore;
+    const hasDrift = typeof safeDrift === 'number' && safeDrift > 0;
+    if (!hasDrift && (spec.status === 'done' || spec.status === 'implementing')) {
+        breakdown.noDrift = POINTS_NO_DRIFT;
+        details.noDrift = 'OK — no drift detected';
+    }
+    else {
+        details.noDrift = hasDrift ? `Drift score: ${safeDrift}` : `Status: ${spec.status}`;
+    }
+    const total = breakdown.specComplete +
+        breakdown.testsExist +
+        breakdown.testsPass +
+        breakdown.coverageOk +
+        breakdown.noDrift;
+    return { specId, total, breakdown, details };
+}
+export function buildValidationPlan(specIds, maxIterations, testCommand, autoFix) {
+    const plan = specIds.map((specId) => ({
+        specId,
+        steps: [
+            `Run: planu validate --specId ${specId}`,
+            `Run: ${testCommand} -- ${specId}`,
+            autoFix
+                ? `If failing: apply suggested fixes from validate output`
+                : `Review failures manually`,
+            `Re-run validate to confirm`,
+        ],
+        expectedOutcome: 'All acceptance criteria verified, tests green',
+    }));
+    const summary = [
+        `Validation loop plan for ${specIds.length} spec(s), max ${maxIterations} iteration(s).`,
+        `Test command: ${testCommand}`,
+        `Auto-fix: ${autoFix ? 'enabled' : 'disabled'}`,
+        ``,
+        `NOTE: Planu cannot execute shell commands directly. `,
+        `Copy the steps below and run them in your terminal.`,
+    ].join('\n');
+    return {
+        iterations: maxIterations,
+        finalStatus: 'partial',
+        summary,
+        plan,
+    };
+}
+//# sourceMappingURL=validation-loop.js.map

package/dist/engine/validation-loop.js.map

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

package/dist/engine/webhook-server.d.ts

@@ -0,0 +1,19 @@
+import { type IncomingMessage, type ServerResponse, type Server } from 'node:http';
+import type { RouteHandler } from '../types/index.js';
+/** Simple HTTP router for webhook endpoints */
+export declare class WebhookRouter {
+    private readonly routes;
+    add(method: string, path: string | RegExp, handler: RouteHandler): void;
+    handle(req: IncomingMessage, res: ServerResponse): Promise<void>;
+}
+/** Verify Bearer token from Authorization header */
+export declare function verifyBearerToken(req: IncomingMessage, secret: string): boolean;
+export declare function getActiveServer(): Server | null;
+export declare function setActiveServer(server: Server | null): void;
+/** Start the HTTP server on the given port with the provided router */
+export declare function startWebhookServer(port: number, router: WebhookRouter): Promise<Server>;
+/** Stop the active server */
+export declare function stopWebhookServer(): Promise<void>;
+/** Generate OpenAPI 3.0 YAML documentation for the webhook server */
+export declare function generateWebhookOpenApiYaml(port: number): string;
+//# sourceMappingURL=webhook-server.d.ts.map

package/dist/engine/webhook-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-server.d.ts","sourceRoot":"","sources":["../../src/engine/webhook-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAC;AACjG,OAAO,KAAK,EAAE,YAAY,EAAS,MAAM,mBAAmB,CAAC;AAE7D,+CAA+C;AAC/C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IAEtC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKjE,MAAM,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BvE;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAO/E;AAKD,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED,uEAAuE;AACvE,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB7F;AAED,6BAA6B;AAC7B,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAevD;AAED,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+E/D"}

package/dist/engine/webhook-server.js

@@ -0,0 +1,169 @@
+// engine/webhook-server.ts — Incoming HTTP webhook server for Planu (SPEC-359)
+import { createServer } from 'node:http';
+/** Simple HTTP router for webhook endpoints */
+export class WebhookRouter {
+    routes = [];
+    add(method, path, handler) {
+        const pattern = path instanceof RegExp ? path : new RegExp(`^${path}$`);
+        this.routes.push({ method: method.toUpperCase(), pathPattern: pattern, handler });
+    }
+    async handle(req, res) {
+        const url = req.url ?? '/';
+        const method = req.method ?? 'GET';
+        const path = url.split('?')[0] ?? url;
+        let body = '';
+        await new Promise((resolve) => {
+            req.on('data', (chunk) => {
+                body += chunk.toString();
+            });
+            req.on('end', resolve);
+        });
+        const route = this.routes.find((r) => r.method === method && r.pathPattern.test(path));
+        if (route === undefined) {
+            res.writeHead(404, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Not Found' }));
+            return;
+        }
+        try {
+            await route.handler(req, res, body);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: message }));
+        }
+    }
+}
+/** Verify Bearer token from Authorization header */
+export function verifyBearerToken(req, secret) {
+    const auth = req.headers.authorization;
+    if (auth === undefined || auth === '') {
+        return false;
+    }
+    const [scheme, token] = auth.split(' ');
+    return scheme === 'Bearer' && token === secret;
+}
+/** Singleton server instance */
+let activeServer = null;
+export function getActiveServer() {
+    return activeServer;
+}
+export function setActiveServer(server) {
+    activeServer = server;
+}
+/** Start the HTTP server on the given port with the provided router */
+export async function startWebhookServer(port, router) {
+    return new Promise((resolve, reject) => {
+        const server = createServer((req, res) => {
+            router.handle(req, res).catch((err) => {
+                const message = err instanceof Error ? err.message : String(err);
+                res.writeHead(500, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ error: message }));
+            });
+        });
+        server.on('error', reject);
+        server.listen(port, () => {
+            setActiveServer(server);
+            resolve(server);
+        });
+    });
+}
+/** Stop the active server */
+export async function stopWebhookServer() {
+    const server = getActiveServer();
+    if (server === null) {
+        return;
+    }
+    await new Promise((resolve, reject) => {
+        server.close((err) => {
+            if (err !== undefined) {
+                reject(err);
+                return;
+            }
+            resolve();
+        });
+    });
+    setActiveServer(null);
+}
+/** Generate OpenAPI 3.0 YAML documentation for the webhook server */
+export function generateWebhookOpenApiYaml(port) {
+    return [
+        'openapi: "3.0.3"',
+        'info:',
+        '  title: Planu Incoming Webhook API',
+        '  version: "1.0.0"',
+        '  description: REST API for creating and managing Planu specs via HTTP',
+        `servers:`,
+        `  - url: http://localhost:${port}`,
+        `    description: Local Planu webhook server`,
+        'components:',
+        '  securitySchemes:',
+        '    bearerAuth:',
+        '      type: http',
+        '      scheme: bearer',
+        'security:',
+        '  - bearerAuth: []',
+        'paths:',
+        '  /api/specs:',
+        '    get:',
+        '      summary: List all specs',
+        '      operationId: listSpecs',
+        '      responses:',
+        '        "200":',
+        '          description: Array of spec objects',
+        '        "401":',
+        '          description: Unauthorized',
+        '    post:',
+        '      summary: Create a new spec',
+        '      operationId: createSpec',
+        '      requestBody:',
+        '        required: true',
+        '        content:',
+        '          application/json:',
+        '            schema:',
+        '              type: object',
+        '              required: [projectPath, title]',
+        '              properties:',
+        '                projectPath:',
+        '                  type: string',
+        '                title:',
+        '                  type: string',
+        '                description:',
+        '                  type: string',
+        '      responses:',
+        '        "201":',
+        '          description: Spec created',
+        '        "400":',
+        '          description: Bad request',
+        '        "401":',
+        '          description: Unauthorized',
+        '  /api/specs/{id}:',
+        '    patch:',
+        '      summary: Update spec status',
+        '      operationId: updateSpecStatus',
+        '      parameters:',
+        '        - name: id',
+        '          in: path',
+        '          required: true',
+        '          schema:',
+        '            type: string',
+        '      requestBody:',
+        '        required: true',
+        '        content:',
+        '          application/json:',
+        '            schema:',
+        '              type: object',
+        '              required: [projectPath, status]',
+        '              properties:',
+        '                projectPath:',
+        '                  type: string',
+        '                status:',
+        '                  type: string',
+        '      responses:',
+        '        "200":',
+        '          description: Status updated',
+        '        "401":',
+        '          description: Unauthorized',
+    ].join('\n');
+}
+//# sourceMappingURL=webhook-server.js.map

package/dist/engine/webhook-server.js.map

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

package/dist/engine/workspace-manager.d.ts

@@ -0,0 +1,8 @@
+import type { WorkspaceOverviewResult, WorkspaceHealthMetrics, BulkOperationResult, BulkOperation, WorkspaceAlert, WorkspaceSearchResult } from '../types/index.js';
+export declare function buildWorkspaceOverview(healthThreshold?: number): Promise<WorkspaceOverviewResult>;
+export declare function buildWorkspaceHealth(healthThreshold?: number): Promise<WorkspaceHealthMetrics>;
+export declare function runBulkOperation(operation: BulkOperation, projectPaths: string[] | undefined, dryRun?: boolean): Promise<BulkOperationResult>;
+export declare function generateWorkspaceReport(): Promise<string>;
+export declare function searchWorkspace(query: string, maxResults?: number): Promise<WorkspaceSearchResult[]>;
+export declare function getWorkspaceAlerts(staleDaysThreshold?: number): Promise<WorkspaceAlert[]>;
+//# sourceMappingURL=workspace-manager.d.ts.map

package/dist/engine/workspace-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-manager.d.ts","sourceRoot":"","sources":["../../src/engine/workspace-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,qBAAqB,EAEtB,MAAM,mBAAmB,CAAC;AA0D3B,wBAAsB,sBAAsB,CAC1C,eAAe,SAAK,GACnB,OAAO,CAAC,uBAAuB,CAAC,CAYlC;AAMD,wBAAsB,oBAAoB,CAAC,eAAe,SAAK,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA2BhG;AAMD,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,aAAa,EACxB,YAAY,EAAE,MAAM,EAAE,GAAG,SAAS,EAClC,MAAM,UAAQ,GACb,OAAO,CAAC,mBAAmB,CAAC,CAoD9B;AAMD,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC,CAuC/D;AAMD,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,UAAU,SAAK,GACd,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAmClC;AAMD,wBAAsB,kBAAkB,CAAC,kBAAkB,SAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAgC3F"}