crewly 1.5.18 → 1.5.20

package/dist/backend/backend/src/services/v3/request.service.js

@@ -0,0 +1,310 @@
+/**
+ * Request Service — CRUD operations for V3 Request entities
+ *
+ * Requests represent user-level goals. They are stored as JSON files
+ * in `{projectPath}/.crewly/requests/{id}.json`.
+ *
+ * @module services/v3/request.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { LoggerService } from '../core/logger.service.js';
+import { ensureDir, atomicWriteJson, safeReadJson } from '../../utils/file-io.utils.js';
+import { isRequest, isValidRequestTransition, validateCreateRequestInput, createRequest, } from '../../types/v2/index.js';
+import { planTasksFromObjective } from './v3-data.service.js';
+/** Directory name under .crewly for request storage. */
+const REQUESTS_DIR = 'requests';
+/**
+ * Service for managing Request entities on disk.
+ *
+ * Uses singleton pattern for consistent state across the backend.
+ * All persistence is file-based (one JSON file per Request).
+ *
+ * @example
+ * ```typescript
+ * const service = RequestService.getInstance('/path/to/project');
+ * const req = await service.create({ title: 'Deploy staging', ... });
+ * ```
+ */
+export class RequestService {
+    projectPath;
+    static instance = null;
+    logger = LoggerService.getInstance().createComponentLogger('RequestService');
+    requestsDir;
+    /**
+     * Creates a new RequestService.
+     *
+     * @param projectPath - Absolute path to the project root
+     */
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.requestsDir = path.join(projectPath, '.crewly', REQUESTS_DIR);
+    }
+    /**
+     * Gets the singleton instance.
+     *
+     * @param projectPath - Absolute path to the project root
+     * @returns The singleton RequestService instance
+     */
+    static getInstance(projectPath) {
+        if (!RequestService.instance) {
+            const resolvedPath = projectPath || process.env.CREWLY_PROJECT_PATH || process.cwd();
+            RequestService.instance = new RequestService(resolvedPath);
+        }
+        return RequestService.instance;
+    }
+    /**
+     * Resets the singleton instance. For test isolation only.
+     */
+    static resetInstance() {
+        RequestService.instance = null;
+    }
+    // ---------------------------------------------------------------------------
+    // File helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Returns the file path for a request JSON file.
+     *
+     * @param requestId - The request ID
+     * @returns Absolute path to the request JSON file
+     */
+    getFilePath(requestId) {
+        return path.join(this.requestsDir, `${requestId}.json`);
+    }
+    /**
+     * Loads a single Request from disk.
+     *
+     * @param requestId - The request ID
+     * @returns The Request or null if not found
+     */
+    async load(requestId) {
+        const data = await safeReadJson(this.getFilePath(requestId), null);
+        if (!data || !isRequest(data))
+            return null;
+        return data;
+    }
+    /**
+     * Saves a Request to disk atomically.
+     *
+     * @param request - The Request to persist
+     */
+    async save(request) {
+        await ensureDir(this.requestsDir);
+        await atomicWriteJson(this.getFilePath(request.id), request);
+    }
+    // ---------------------------------------------------------------------------
+    // Public API
+    // ---------------------------------------------------------------------------
+    /**
+     * Creates a new Request.
+     *
+     * @param input - Creation input
+     * @returns The created Request
+     * @throws Error if validation fails
+     */
+    async create(input) {
+        const errors = validateCreateRequestInput(input);
+        if (errors.length > 0) {
+            throw new Error(`Invalid CreateRequestInput: ${errors.join('; ')}`);
+        }
+        const request = createRequest(input);
+        await this.save(request);
+        this.logger.debug('Request created', { id: request.id, title: request.title });
+        return request;
+    }
+    /**
+     * Gets a Request by ID.
+     *
+     * @param id - Request ID
+     * @returns The Request or null
+     */
+    async getById(id) {
+        return this.load(id);
+    }
+    /**
+     * Lists all Requests.
+     *
+     * @returns Array of all Requests, sorted by createdAt descending
+     */
+    async listAll() {
+        await ensureDir(this.requestsDir);
+        let files;
+        try {
+            files = await fs.readdir(this.requestsDir);
+        }
+        catch {
+            return [];
+        }
+        const jsonFiles = files.filter((f) => f.endsWith('.json'));
+        const requests = [];
+        for (const file of jsonFiles) {
+            const filePath = path.join(this.requestsDir, file);
+            const data = await safeReadJson(filePath, null);
+            if (data && isRequest(data)) {
+                requests.push(data);
+            }
+        }
+        requests.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        return requests;
+    }
+    /**
+     * Updates a Request with partial fields.
+     *
+     * @param id - Request ID
+     * @param updates - Fields to update
+     * @returns The updated Request
+     * @throws Error if not found or invalid transition
+     */
+    async update(id, updates) {
+        const request = await this.load(id);
+        if (!request) {
+            throw new Error(`Request not found: ${id}`);
+        }
+        // Validate status transition if status is being updated
+        if (updates.status && updates.status !== request.status) {
+            if (!isValidRequestTransition(request.status, updates.status)) {
+                throw new Error(`Invalid status transition: ${request.status} -> ${updates.status}`);
+            }
+            request.status = updates.status;
+            if (updates.status === 'done' || updates.status === 'cancelled') {
+                request.completedAt = new Date().toISOString();
+            }
+        }
+        // Apply other updates
+        if (updates.title !== undefined)
+            request.title = updates.title;
+        if (updates.description !== undefined)
+            request.description = updates.description;
+        if (updates.priority !== undefined)
+            request.priority = updates.priority;
+        if (updates.requiresConfirmation !== undefined)
+            request.requiresConfirmation = updates.requiresConfirmation;
+        if (updates.confirmationReason !== undefined)
+            request.confirmationReason = updates.confirmationReason;
+        if (updates.missionId !== undefined)
+            request.missionId = updates.missionId;
+        if (updates.projectTaskId !== undefined)
+            request.projectTaskId = updates.projectTaskId;
+        if (updates.result !== undefined)
+            request.result = updates.result;
+        if (updates.tags !== undefined)
+            request.tags = updates.tags;
+        if (updates.totalInputTokens !== undefined)
+            request.totalInputTokens = updates.totalInputTokens;
+        if (updates.totalOutputTokens !== undefined)
+            request.totalOutputTokens = updates.totalOutputTokens;
+        if (updates.totalCost !== undefined)
+            request.totalCost = updates.totalCost;
+        if (updates.ownerAgent !== undefined)
+            request.ownerAgent = updates.ownerAgent;
+        request.updatedAt = new Date().toISOString();
+        await this.save(request);
+        this.logger.debug('Request updated', { id, status: request.status });
+        return request;
+    }
+    /**
+     * Deletes a Request from disk. Used for purging old completed Requests.
+     *
+     * @param id - The Request ID to delete
+     */
+    async delete(id) {
+        const filePath = this.getFilePath(id);
+        try {
+            await fs.unlink(filePath);
+            this.logger.debug('Request deleted', { id });
+        }
+        catch {
+            // File may not exist — ignore
+        }
+    }
+    /**
+     * Adds a WorkItem ID to a Request's workItemIds array.
+     *
+     * @param requestId - The Request ID
+     * @param workItemId - The WorkItem ID to link
+     * @returns The updated Request, or null if Request not found
+     */
+    async linkWorkItem(requestId, workItemId) {
+        const request = await this.load(requestId);
+        if (!request)
+            return null;
+        if (!request.workItemIds.includes(workItemId)) {
+            request.workItemIds.push(workItemId);
+            request.updatedAt = new Date().toISOString();
+            await this.save(request);
+            this.logger.debug('WorkItem linked to Request', { requestId, workItemId });
+        }
+        return request;
+    }
+    /**
+     * Finds a Request by its source conversation item ID.
+     * Used for deduplication — avoids creating duplicate Requests for the same message.
+     *
+     * @param sourceConversationItemId - The conversation item ID
+     * @returns The matching Request, or null
+     */
+    async findBySourceConversationItemId(sourceConversationItemId) {
+        const all = await this.listAll();
+        return all.find((r) => r.sourceConversationItemId === sourceConversationItemId) ?? null;
+    }
+    // ---------------------------------------------------------------------------
+    // Planning — Request → Task Decomposition
+    // ---------------------------------------------------------------------------
+    /**
+     * Decomposes a user message into a proposed list of ProjectTasks.
+     *
+     * This is the "TodoWrite-style" planning phase: given a raw user message,
+     * it classifies the intent and returns structured tasks that can be
+     * reviewed, approved, and then executed.
+     *
+     * Currently uses keyword-based decomposition (same logic as Mission
+     * decomposition in V3DataService). Can be upgraded to AI-based planning
+     * in the future without changing the API contract.
+     *
+     * @param message - The raw user message text
+     * @param options - Optional planning configuration
+     * @returns A RequestPlan with proposed tasks and metadata
+     *
+     * @example
+     * ```typescript
+     * const plan = await requestService.plan('Build a new auth system');
+     * // plan.tasks → [{ title: 'Design...', ... }, { title: 'Implement...', ... }, ...]
+     * ```
+     */
+    async plan(message, options) {
+        if (!message || message.trim().length < 2) {
+            return {
+                message,
+                tasks: [],
+                reasoning: 'Message too short to decompose into tasks.',
+                strategy: 'none',
+            };
+        }
+        const trimmed = message.trim();
+        const tasks = planTasksFromObjective(trimmed);
+        // Determine which strategy was selected (English + Chinese keywords)
+        const lower = trimmed.toLowerCase();
+        let strategy;
+        if (/\b(build|create|implement|add|feature|develop|write|ship)\b/.test(lower) || /创建|实现|添加|开发|编写|搭建|新增/.test(trimmed)) {
+            strategy = 'build';
+        }
+        else if (/\b(fix|debug|resolve|repair|patch|broken|bug|error|crash)\b/.test(lower) || /修复|修|调试|解决|修补|bug|报错|崩溃/.test(trimmed)) {
+            strategy = 'fix';
+        }
+        else {
+            strategy = 'generic';
+        }
+        this.logger.debug('Request planned', {
+            messageLength: trimmed.length,
+            strategy,
+            taskCount: tasks.length,
+        });
+        return {
+            message: trimmed,
+            tasks,
+            reasoning: `Decomposed using "${strategy}" strategy into ${tasks.length} tasks.`,
+            strategy,
+        };
+    }
+}
+//# sourceMappingURL=request.service.js.map

package/dist/backend/backend/src/services/v3/request.service.js.map

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

package/dist/backend/backend/src/services/v3/service-contract-gate.service.d.ts

@@ -0,0 +1,88 @@
+/**
+ * ServiceContractGate — runtime enforcement of team `ServiceContract`s.
+ *
+ * Cross-team requests must pass through the gate before a WorkItem is
+ * enqueued on the target team's pool. The gate makes a pure-function
+ * decision by matching the requested `requestType` string against the
+ * target team's `serviceContract.accepts` and `serviceContract.avoids`
+ * phrases.
+ *
+ * Design choices:
+ * - **No LLM.** Plain case-insensitive substring match — predictable and
+ *   cheap enough to run on every dispatch.
+ * - **Fail closed.** If `accepts` is missing, empty, or matches nothing,
+ *   the request is rejected. Teams must explicitly declare what they take.
+ * - **`avoids` beats `accepts`.** An avoided phrase wins even if the
+ *   request also matches an accepted phrase — the negative signal is
+ *   assumed stronger (e.g. "frontend bugfix" is accepted but "production
+ *   frontend bugfix" is avoided).
+ * - **Same-team requests skip the gate.** Teams don't contract with
+ *   themselves; internal work flows normally.
+ *
+ * Wiring this into the Request / delegate-task path is a separate step
+ * (see follow-up). This service is standalone and stateless so it can
+ * be called from controllers, skills, or future ServiceGateway layers.
+ *
+ * @module services/v3/service-contract-gate.service
+ */
+import type { Team } from '../../types/index.js';
+/**
+ * Reason codes for a rejected request. Callers use these to produce a
+ * targeted error message (e.g. "out of scope" vs "ambiguous, please
+ * specify a supported service type").
+ */
+export type GateRejectionReason = 'missing_target' | 'no_contract' | 'empty_contract' | 'in_avoids' | 'no_match';
+/**
+ * The decision returned by the gate.
+ */
+export type GateDecision = {
+    outcome: 'accept';
+    /** The accepts[] phrase that matched the request. */
+    matchedRule: string;
+} | {
+    outcome: 'reject';
+    reason: GateRejectionReason;
+    /** Which rule matched (only populated for `in_avoids`). */
+    matchedRule?: string;
+    /** Human-readable explanation suitable for surfacing to the requester. */
+    message: string;
+};
+/**
+ * Inputs the gate needs to make a decision.
+ */
+export interface GateRequest {
+    /** Team making the request. Optional — undefined means "external/user". */
+    fromTeamId?: string;
+    /** Team that would receive the work. */
+    toTeam: Team | undefined;
+    /** Free-text description of the requested service type (short phrase). */
+    requestType: string;
+}
+/**
+ * Stateless gate that evaluates a cross-team request against the target's
+ * `ServiceContract`. Safe to instantiate once and reuse, or to call
+ * {@link check} via an ad-hoc instance.
+ *
+ * @example
+ * ```typescript
+ * const gate = new ServiceContractGate();
+ * const decision = gate.check({
+ *   fromTeamId: 'marketing',
+ *   toTeam: engineeringTeam,
+ *   requestType: 'frontend bugfix',
+ * });
+ * if (decision.outcome === 'reject') {
+ *   throw new Error(decision.message);
+ * }
+ * ```
+ */
+export declare class ServiceContractGate {
+    /**
+     * Decide whether the target team may accept this request.
+     *
+     * @param req - Request details (from, to, type)
+     * @returns Structured decision with outcome + reason + message
+     */
+    check(req: GateRequest): GateDecision;
+}
+//# sourceMappingURL=service-contract-gate.service.d.ts.map

package/dist/backend/backend/src/services/v3/service-contract-gate.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-contract-gate.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/service-contract-gate.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAOjD;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,aAAa,GACb,gBAAgB,GAChB,WAAW,GACX,UAAU,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,OAAO,EAAE,QAAQ,CAAC;IAClB,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAC;CACrB,GACD;IACE,OAAO,EAAE,QAAQ,CAAC;IAClB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,MAAM,EAAE,IAAI,GAAG,SAAS,CAAC;IACzB,0EAA0E;IAC1E,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,mBAAmB;IAC9B;;;;;OAKG;IACH,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,YAAY;CAsDtC"}

package/dist/backend/backend/src/services/v3/service-contract-gate.service.js

@@ -0,0 +1,138 @@
+/**
+ * ServiceContractGate — runtime enforcement of team `ServiceContract`s.
+ *
+ * Cross-team requests must pass through the gate before a WorkItem is
+ * enqueued on the target team's pool. The gate makes a pure-function
+ * decision by matching the requested `requestType` string against the
+ * target team's `serviceContract.accepts` and `serviceContract.avoids`
+ * phrases.
+ *
+ * Design choices:
+ * - **No LLM.** Plain case-insensitive substring match — predictable and
+ *   cheap enough to run on every dispatch.
+ * - **Fail closed.** If `accepts` is missing, empty, or matches nothing,
+ *   the request is rejected. Teams must explicitly declare what they take.
+ * - **`avoids` beats `accepts`.** An avoided phrase wins even if the
+ *   request also matches an accepted phrase — the negative signal is
+ *   assumed stronger (e.g. "frontend bugfix" is accepted but "production
+ *   frontend bugfix" is avoided).
+ * - **Same-team requests skip the gate.** Teams don't contract with
+ *   themselves; internal work flows normally.
+ *
+ * Wiring this into the Request / delegate-task path is a separate step
+ * (see follow-up). This service is standalone and stateless so it can
+ * be called from controllers, skills, or future ServiceGateway layers.
+ *
+ * @module services/v3/service-contract-gate.service
+ */
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Stateless gate that evaluates a cross-team request against the target's
+ * `ServiceContract`. Safe to instantiate once and reuse, or to call
+ * {@link check} via an ad-hoc instance.
+ *
+ * @example
+ * ```typescript
+ * const gate = new ServiceContractGate();
+ * const decision = gate.check({
+ *   fromTeamId: 'marketing',
+ *   toTeam: engineeringTeam,
+ *   requestType: 'frontend bugfix',
+ * });
+ * if (decision.outcome === 'reject') {
+ *   throw new Error(decision.message);
+ * }
+ * ```
+ */
+export class ServiceContractGate {
+    /**
+     * Decide whether the target team may accept this request.
+     *
+     * @param req - Request details (from, to, type)
+     * @returns Structured decision with outcome + reason + message
+     */
+    check(req) {
+        // Internal work bypasses the contract entirely.
+        if (req.fromTeamId && req.toTeam && req.fromTeamId === req.toTeam.id) {
+            return { outcome: 'accept', matchedRule: '<internal>' };
+        }
+        if (!req.toTeam) {
+            return {
+                outcome: 'reject',
+                reason: 'missing_target',
+                message: 'Target team could not be resolved.',
+            };
+        }
+        const contract = req.toTeam.serviceContract;
+        if (!contract) {
+            return {
+                outcome: 'reject',
+                reason: 'no_contract',
+                message: `Team "${req.toTeam.name}" has no service contract — cross-team requests are not accepted until one is declared.`,
+            };
+        }
+        // `avoids` wins over `accepts` — fail closed on negative signal.
+        const avoidHit = matchAny(req.requestType, contract.avoids ?? []);
+        if (avoidHit) {
+            return {
+                outcome: 'reject',
+                reason: 'in_avoids',
+                matchedRule: avoidHit,
+                message: `Team "${req.toTeam.name}" explicitly avoids requests matching "${avoidHit}".`,
+            };
+        }
+        const accepts = contract.accepts ?? [];
+        if (accepts.length === 0) {
+            return {
+                outcome: 'reject',
+                reason: 'empty_contract',
+                message: `Team "${req.toTeam.name}" has a service contract with no accepted task types.`,
+            };
+        }
+        const acceptHit = matchAny(req.requestType, accepts);
+        if (acceptHit) {
+            return { outcome: 'accept', matchedRule: acceptHit };
+        }
+        return {
+            outcome: 'reject',
+            reason: 'no_match',
+            message: buildNoMatchMessage(req.toTeam.name, req.requestType, contract),
+        };
+    }
+}
+// ---------------------------------------------------------------------------
+// Matching helpers
+// ---------------------------------------------------------------------------
+/**
+ * Case-insensitive substring match. Accepts either direction — a rule
+ * matches if either string contains the other. This tolerates both tightly
+ * scoped rules ("bugfix") and verbose request phrasing ("urgent frontend
+ * bugfix in checkout").
+ */
+function matchAny(requestType, rules) {
+    const needle = requestType.trim().toLowerCase();
+    if (!needle)
+        return null;
+    for (const rule of rules) {
+        const hay = rule.trim().toLowerCase();
+        if (!hay)
+            continue;
+        if (needle.includes(hay) || hay.includes(needle)) {
+            return rule;
+        }
+    }
+    return null;
+}
+/**
+ * Build a helpful rejection message that lists what the team does accept,
+ * so the caller can reframe or re-route.
+ */
+function buildNoMatchMessage(teamName, requestType, contract) {
+    const accepts = (contract.accepts ?? []).filter((a) => a.trim()).join(', ');
+    return accepts
+        ? `Team "${teamName}" does not accept "${requestType}". Accepted services: ${accepts}.`
+        : `Team "${teamName}" does not accept "${requestType}" and has no listed services.`;
+}
+//# sourceMappingURL=service-contract-gate.service.js.map

package/dist/backend/backend/src/services/v3/service-contract-gate.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-contract-gate.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/service-contract-gate.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAmDH,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;;;;OAKG;IACH,KAAK,CAAC,GAAgB;QACpB,gDAAgD;QAChD,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,KAAK,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACrE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC;QAC1D,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,gBAAgB;gBACxB,OAAO,EAAE,oCAAoC;aAC9C,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,aAAa;gBACrB,OAAO,EAAE,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,yFAAyF;aAC3H,CAAC;QACJ,CAAC;QAED,iEAAiE;QACjE,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QAClE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,WAAW;gBACnB,WAAW,EAAE,QAAQ;gBACrB,OAAO,EAAE,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,0CAA0C,QAAQ,IAAI;aACxF,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,OAAO,EAAE,QAAQ;gBACjB,MAAM,EAAE,gBAAgB;gBACxB,OAAO,EAAE,SAAS,GAAG,CAAC,MAAM,CAAC,IAAI,uDAAuD;aACzF,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QACvD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,QAAQ;YACjB,MAAM,EAAE,UAAU;YAClB,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC;SACzE,CAAC;IACJ,CAAC;CACF;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,WAAmB,EAAE,KAAwB;IAC7D,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,QAAgB,EAChB,WAAmB,EACnB,QAAyB;IAEzB,MAAM,OAAO,GAAG,CAAC,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5E,OAAO,OAAO;QACZ,CAAC,CAAC,SAAS,QAAQ,sBAAsB,WAAW,yBAAyB,OAAO,GAAG;QACvF,CAAC,CAAC,SAAS,QAAQ,sBAAsB,WAAW,+BAA+B,CAAC;AACxF,CAAC"}