crewly 1.13.0 → 1.14.0

package/dist/cli/backend/src/services/v3/kr-tracking.service.js

@@ -0,0 +1,482 @@
+/**
+ * Key Result Tracking Service
+ *
+ * CRUD, measurement recording, progress aggregation, and WorkItem linkage
+ * for structured Key Results attached to Missions.
+ *
+ * Does NOT contain LLM logic — all status derivation is pure math.
+ * Agent reasoning happens in skills (review-mission, measure-kr).
+ *
+ * @module services/v3/kr-tracking.service
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { existsSync, mkdirSync } from 'fs';
+import { LoggerService } from '../core/logger.service.js';
+import { deriveLevel, } from '../../types/v2/mission.types.js';
+import { createKeyResult, computeKRProgress, deriveKRStatus, deriveCascadeChildStatus, deriveOKRRecommendation, computeRolledUpProgress, MAX_MEASUREMENT_HISTORY, validateCreateKeyResultInput, } from '../../types/v2/key-result.types.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Base directory for mission data. */
+function getMissionsDir() {
+    return path.join(process.cwd(), '.crewly', 'missions');
+}
+/** Directory for a mission's key results. */
+function getKRDir(missionId) {
+    return path.join(getMissionsDir(), missionId, 'key-results');
+}
+/** File path for a single key result. */
+function getKRPath(missionId, krId) {
+    return path.join(getKRDir(missionId), `${krId}.json`);
+}
+/** Proposal state that marks an approved (cascade-active) mission. */
+const APPROVED_STATE = 'approved';
+/** Stale-cycle fallback when a mission has no persisted `staleCycles`. */
+const NO_STALE_CYCLES = 0;
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * Service for managing Key Result lifecycle, measurements, and aggregation.
+ */
+export class KRTrackingService {
+    static instance = null;
+    logger;
+    constructor() {
+        this.logger = LoggerService.getInstance().createComponentLogger('KRTracking');
+    }
+    /**
+     * Get the singleton instance.
+     */
+    static getInstance() {
+        if (!KRTrackingService.instance) {
+            KRTrackingService.instance = new KRTrackingService();
+        }
+        return KRTrackingService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        KRTrackingService.instance = null;
+    }
+    // -------------------------------------------------------------------------
+    // CRUD
+    // -------------------------------------------------------------------------
+    /**
+     * Create a new Key Result for a mission.
+     *
+     * @param input - Validated creation input
+     * @returns The created KeyResult
+     */
+    async create(input) {
+        const errors = validateCreateKeyResultInput(input);
+        if (errors.length > 0) {
+            throw new Error(`Invalid KeyResult input: ${errors.join(', ')}`);
+        }
+        const kr = createKeyResult(input);
+        await this.persist(kr);
+        this.logger.info('Created KeyResult', { krId: kr.id, missionId: kr.missionId, title: kr.title });
+        return kr;
+    }
+    /**
+     * Get a Key Result by ID.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @returns The KeyResult, or null if not found
+     */
+    async get(missionId, krId) {
+        try {
+            const raw = await fs.readFile(getKRPath(missionId, krId), 'utf-8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * List all Key Results for a mission.
+     *
+     * @param missionId - Mission ID
+     * @returns Array of KeyResults
+     */
+    async listByMission(missionId) {
+        const dir = getKRDir(missionId);
+        try {
+            const files = (await fs.readdir(dir)).filter(f => f.endsWith('.json'));
+            const results = await Promise.all(files.map(async (f) => {
+                try {
+                    const raw = await fs.readFile(path.join(dir, f), 'utf-8');
+                    return JSON.parse(raw);
+                }
+                catch {
+                    return null;
+                }
+            }));
+            return results.filter((kr) => kr !== null);
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Update a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param update - Fields to update
+     * @returns Updated KeyResult, or null if not found
+     */
+    async update(missionId, krId, update) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return null;
+        if (update.current !== undefined)
+            kr.current = update.current;
+        if (update.target !== undefined)
+            kr.target = update.target;
+        if (update.status !== undefined)
+            kr.status = update.status;
+        if (update.measurementSource !== undefined)
+            kr.measurementSource = update.measurementSource;
+        if (update.measurementConfig !== undefined)
+            kr.measurementConfig = update.measurementConfig;
+        // Recompute status if current changed but status wasn't explicitly set
+        if (update.current !== undefined && update.status === undefined) {
+            const progress = computeKRProgress(kr);
+            kr.status = deriveKRStatus(progress, kr.current, kr.baseline);
+        }
+        kr.updatedAt = new Date().toISOString();
+        await this.persist(kr);
+        return kr;
+    }
+    /**
+     * Delete a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     */
+    async delete(missionId, krId) {
+        try {
+            await fs.unlink(getKRPath(missionId, krId));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Measurement
+    // -------------------------------------------------------------------------
+    /**
+     * Record a new measurement for a Key Result.
+     * Automatically updates current value, recomputes status,
+     * and appends to measurement history.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param value - Measured value
+     * @param source - Who/what took the measurement
+     * @param note - Optional context
+     * @returns The recorded measurement, or null if KR not found
+     */
+    async recordMeasurement(missionId, krId, value, source, note) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return null;
+        const measurement = {
+            value,
+            measuredAt: new Date().toISOString(),
+            source,
+            note,
+        };
+        // Update current value and recompute status
+        kr.current = value;
+        const progress = computeKRProgress(kr);
+        kr.status = deriveKRStatus(progress, kr.current, kr.baseline);
+        // Prepend to history, cap at MAX_MEASUREMENT_HISTORY
+        kr.measurements.unshift(measurement);
+        if (kr.measurements.length > MAX_MEASUREMENT_HISTORY) {
+            kr.measurements = kr.measurements.slice(0, MAX_MEASUREMENT_HISTORY);
+        }
+        kr.updatedAt = new Date().toISOString();
+        await this.persist(kr);
+        this.logger.info('Recorded KR measurement', {
+            krId,
+            value,
+            status: kr.status,
+            progress: Math.round(progress),
+        });
+        return measurement;
+    }
+    // -------------------------------------------------------------------------
+    // WorkItem Linkage
+    // -------------------------------------------------------------------------
+    /**
+     * Link a WorkItem to a Key Result.
+     *
+     * @param missionId - Parent mission ID
+     * @param krId - Key Result ID
+     * @param workItemId - WorkItem ID to link
+     */
+    async linkWorkItem(missionId, krId, workItemId) {
+        const kr = await this.get(missionId, krId);
+        if (!kr)
+            return;
+        if (!kr.linkedWorkItemIds.includes(workItemId)) {
+            kr.linkedWorkItemIds.push(workItemId);
+            kr.updatedAt = new Date().toISOString();
+            await this.persist(kr);
+        }
+    }
+    /**
+     * Handle WorkItem completion — auto-update KRs with task_completion source.
+     *
+     * For KRs measured by task completion, progress = completed linked items / total linked items.
+     *
+     * @param workItem - The completed WorkItem
+     */
+    async onWorkItemCompleted(workItem) {
+        const missionId = workItem.missionId;
+        const krId = workItem.metadata?.krId;
+        if (!missionId || !krId)
+            return;
+        const kr = await this.get(missionId, krId);
+        if (!kr || kr.measurementSource !== 'task_completion')
+            return;
+        // Count completed linked items using TaskPoolService
+        const { TaskPoolService } = await import('../task-pool/task-pool.service.js');
+        const pool = TaskPoolService.getInstance();
+        const allItems = await pool.getAllItems();
+        const linkedItems = allItems.filter(item => kr.linkedWorkItemIds.includes(item.id));
+        const completedCount = linkedItems.filter(item => item.status === 'done' || item.status === 'verified').length;
+        const totalLinked = kr.linkedWorkItemIds.length;
+        if (totalLinked === 0)
+            return;
+        // Map completion ratio to the KR's baseline→target range
+        const completionRatio = completedCount / totalLinked;
+        const range = kr.target - kr.baseline;
+        const newValue = kr.baseline + (range * completionRatio);
+        await this.recordMeasurement(missionId, krId, Math.round(newValue * 100) / 100, `task_completion:${workItem.id}`, `${completedCount}/${totalLinked} linked tasks completed`);
+    }
+    // -------------------------------------------------------------------------
+    // Aggregation
+    // -------------------------------------------------------------------------
+    /**
+     * Compute aggregated OKR progress for a mission.
+     *
+     * @param missionId - Mission ID
+     * @param staleCycles - Number of consecutive stale review cycles
+     * @returns Aggregated summary with recommendation
+     */
+    async computeMissionOKRProgress(missionId, staleCycles = 0) {
+        const krs = await this.listByMission(missionId);
+        const statuses = krs.map(kr => kr.status);
+        const counts = {
+            not_started: 0,
+            on_track: 0,
+            at_risk: 0,
+            off_track: 0,
+            achieved: 0,
+        };
+        for (const s of statuses)
+            counts[s]++;
+        // Weighted average progress
+        let overallProgress = 0;
+        if (krs.length > 0) {
+            const totalProgress = krs.reduce((sum, kr) => sum + computeKRProgress(kr), 0);
+            overallProgress = Math.round(totalProgress / krs.length);
+        }
+        const recommendation = deriveOKRRecommendation(statuses, staleCycles);
+        return {
+            missionId,
+            totalKRs: krs.length,
+            achieved: counts.achieved,
+            onTrack: counts.on_track,
+            atRisk: counts.at_risk,
+            offTrack: counts.off_track,
+            notStarted: counts.not_started,
+            overallProgress,
+            recommendation,
+        };
+    }
+    // -------------------------------------------------------------------------
+    // Cross-Level Roll-Up (cascade)
+    // -------------------------------------------------------------------------
+    /**
+     * List the cascade-active direct children of a mission.
+     *
+     * Reads every mission document and keeps those whose `parentMissionId`
+     * equals `parentId` AND that are cascade-active. A mission is cascade-active
+     * iff its `approval` is absent (legacy missions) OR
+     * `approval.state === 'approved'`. Draft / pending_approval / rejected
+     * children are excluded from the roll-up per spec §4.2.
+     *
+     * @param parentId - Parent mission ID
+     * @returns The approved direct-child missions (empty if none / on read error)
+     *
+     * @example
+     * ```ts
+     * const children = await KRTrackingService.getInstance().listChildMissions('team-1');
+     * ```
+     */
+    async listChildMissions(parentId) {
+        const all = await this.loadAllMissions();
+        return all.filter((m) => m.parentMissionId === parentId && this.isCascadeActive(m));
+    }
+    /**
+     * Compute cross-level cascade roll-up of OKR progress for a mission and its
+     * approved descendants (company → team → project).
+     *
+     * Recursively walks the `parentMissionId` tree. At each node it reuses
+     * {@link computeMissionOKRProgress} for that node's OWN KRs, then folds in the
+     * `rolledUpProgress` of each approved child:
+     *
+     * - `rolledUpProgress` = equal-weight average of this node's own
+     *   `overallProgress` and each approved child's `rolledUpProgress`
+     *   (see {@link computeRolledUpProgress}); a leaf equals its own progress.
+     * - The roll-up recommendation is derived over this node's own KR statuses
+     *   PLUS one synthetic status per child mapped from the child's
+     *   `rolledUpProgress` via {@link deriveCascadeChildStatus} — so "all children
+     *   off_track ⇒ parent escalates/replans" falls out naturally (including when
+     *   children are stalled at 0% progress).
+     *
+     * Orphans (a mission whose `parentMissionId` points at a missing or
+     * non-approved parent) are treated as roots of their own subtree and never
+     * crash. A `visited` set guards against cycles defensively (create/update
+     * already reject cycles).
+     *
+     * @param missionId - Root mission of the subtree to roll up
+     * @param staleCycles - Consecutive stale review cycles for the root node. When
+     *   omitted, the root's PERSISTED `staleCycles` is used so staleness-driven
+     *   replan/escalate is not silently suppressed at the queried node (spec §4.2).
+     *   Pass an explicit number to override the persisted value.
+     * @returns The recursive {@link CascadeOKRSummary} for the subtree
+     *
+     * @example
+     * ```ts
+     * const summary = await KRTrackingService.getInstance().computeCascadeOKRProgress('co-1');
+     * console.log(summary.rolledUpProgress, summary.children.length);
+     * ```
+     */
+    async computeCascadeOKRProgress(missionId, staleCycles) {
+        const all = await this.loadAllMissions();
+        const byId = new Map(all.map((m) => [m.id, m]));
+        const linkById = new Map(all.map((m) => [m.id, { id: m.id, parentMissionId: m.parentMissionId }]));
+        // Seed the root's stale cycles from its persisted value unless the caller
+        // explicitly overrides it. Children read their own persisted value below.
+        const rootStaleCycles = staleCycles ?? byId.get(missionId)?.staleCycles ?? NO_STALE_CYCLES;
+        return this.rollUp(missionId, rootStaleCycles, byId, linkById, new Set());
+    }
+    /**
+     * Recursive worker for {@link computeCascadeOKRProgress}.
+     *
+     * @param missionId - Current node
+     * @param staleCycles - Stale cycles applied to the current node only
+     * @param byId - All missions indexed by ID
+     * @param linkById - Lightweight parent-link map for level derivation
+     * @param visited - Cycle-guard set of already-walked mission IDs
+     * @returns The {@link CascadeOKRSummary} for this node's subtree
+     */
+    async rollUp(missionId, staleCycles, byId, linkById, visited) {
+        visited.add(missionId);
+        const own = await this.computeMissionOKRProgress(missionId, staleCycles);
+        const level = this.resolveLevel(missionId, byId, linkById);
+        // Approved direct children that have not already been visited (cycle guard).
+        const approvedChildren = [...byId.values()].filter((m) => m.parentMissionId === missionId &&
+            this.isCascadeActive(m) &&
+            !visited.has(m.id));
+        const children = [];
+        for (const child of approvedChildren) {
+            // Child stale cycles read from its own persisted value (independent node).
+            children.push(await this.rollUp(child.id, child.staleCycles ?? NO_STALE_CYCLES, byId, linkById, visited));
+        }
+        const childProgresses = children.map((c) => c.rolledUpProgress);
+        const rolledUpProgress = computeRolledUpProgress(own.overallProgress, childProgresses);
+        // Roll-up recommendation: own KR statuses + one synthetic status per child
+        // mapped from its rolled-up progress. Uses deriveCascadeChildStatus (no
+        // baseline-equality short-circuit) so a child stalled at 0% reads as
+        // off_track rather than not_started — otherwise an all-stalled parent would
+        // never escalate/replan (spec §4.2).
+        const ownStatuses = (await this.listByMission(missionId)).map((kr) => kr.status);
+        const childStatuses = children.map((c) => deriveCascadeChildStatus(c.rolledUpProgress));
+        const recommendation = deriveOKRRecommendation([...ownStatuses, ...childStatuses], staleCycles);
+        return {
+            ...own,
+            recommendation,
+            level,
+            childMissionCount: children.length,
+            rolledUpProgress,
+            children,
+        };
+    }
+    /**
+     * Whether a mission counts as cascade-active: approval absent (legacy) or
+     * explicitly approved.
+     *
+     * @param mission - Mission to test
+     * @returns `true` if the mission participates in the cascade roll-up
+     */
+    isCascadeActive(mission) {
+        return mission.approval === undefined || mission.approval.state === APPROVED_STATE;
+    }
+    /**
+     * Resolve a mission's cascade level: prefer its explicit `level`, else derive
+     * it from the parent chain via {@link deriveLevel}. Missing/orphan missions
+     * fall back to `company` (treated as a root).
+     *
+     * @param missionId - Mission whose level to resolve
+     * @param byId - All missions indexed by ID
+     * @param linkById - Lightweight parent-link map for derivation
+     * @returns The resolved {@link MissionLevel}
+     */
+    resolveLevel(missionId, byId, linkById) {
+        const mission = byId.get(missionId);
+        if (mission?.level)
+            return mission.level;
+        if (!mission)
+            return 'company';
+        return deriveLevel(missionId, linkById);
+    }
+    /**
+     * Load all mission documents from disk, skipping unreadable files.
+     *
+     * @returns Array of missions (empty on a missing directory)
+     */
+    async loadAllMissions() {
+        const dir = getMissionsDir();
+        let files = [];
+        try {
+            files = (await fs.readdir(dir)).filter((f) => f.endsWith('.json'));
+        }
+        catch {
+            return [];
+        }
+        const missions = await Promise.all(files.map(async (f) => {
+            try {
+                const raw = await fs.readFile(path.join(dir, f), 'utf-8');
+                return JSON.parse(raw);
+            }
+            catch {
+                return null;
+            }
+        }));
+        return missions.filter((m) => m !== null);
+    }
+    // -------------------------------------------------------------------------
+    // Persistence
+    // -------------------------------------------------------------------------
+    /**
+     * Persist a KeyResult to disk.
+     */
+    async persist(kr) {
+        const dir = getKRDir(kr.missionId);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        await fs.writeFile(getKRPath(kr.missionId, kr.id), JSON.stringify(kr, null, 2));
+    }
+}
+//# sourceMappingURL=kr-tracking.service.js.map

package/dist/cli/backend/src/services/v3/kr-tracking.service.js.map

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

package/dist/cli/backend/src/services/v3/mission-executor.service.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Mission Executor Service
+ *
+ * Lightweight orchestration service for Mission autonomous execution.
+ * Does NOT contain LLM logic — the agent runtime handles thinking
+ * via the decompose-mission skill. This service handles:
+ *
+ * - Processing decomposition results (skill output → WorkItems)
+ * - Mission lifecycle (start, pause, resume)
+ * - Progress tracking (aggregate WorkItem statuses)
+ * - Policy enforcement before creating tasks
+ *
+ * @module services/v3/mission-executor.service
+ */
+import { type Mission } from '../../types/v2/mission.types.js';
+/** A single task from the decomposition skill output. */
+export interface DecomposedTask {
+    title: string;
+    description: string;
+    type: 'delegate' | 'review' | 'check';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    suggestedRole?: string;
+    estimatedMinutes?: number;
+    dependsOn?: string[];
+    /** Key Result this task contributes to (OKR linkage) */
+    krId?: string;
+    /** How this task contributes to the KR */
+    krContribution?: 'direct' | 'indirect' | 'measurement';
+}
+/** Decomposition result submitted by the decompose-mission skill. */
+export interface DecompositionResult {
+    missionId: string;
+    phase: number;
+    tasks: DecomposedTask[];
+}
+/** Progress snapshot for a Mission. */
+export interface MissionProgress {
+    missionId: string;
+    status: string;
+    phase: number;
+    totalTasks: number;
+    completedTasks: number;
+    runningTasks: number;
+    queuedTasks: number;
+    blockedTasks: number;
+    failedTasks: number;
+    progressPercent: number;
+    totalCost: number;
+}
+export declare class MissionExecutorService {
+    private static instance;
+    private readonly logger;
+    /** Track which phase each mission is on */
+    private missionPhases;
+    private constructor();
+    static getInstance(): MissionExecutorService;
+    static resetInstance(): void;
+    /**
+     * Process decomposition output from the decompose-mission skill.
+     * Creates WorkItems in the TaskPool with dependency metadata.
+     *
+     * @param result - Decomposition result from the skill
+     * @param mission - The parent Mission
+     * @returns Created WorkItem IDs
+     */
+    processDecomposition(result: DecompositionResult, mission: Mission): Promise<string[]>;
+    /**
+     * Compute Mission progress from WorkItem statuses.
+     *
+     * @param missionId - The Mission to check
+     * @returns Progress snapshot
+     */
+    checkProgress(missionId: string): Promise<MissionProgress>;
+    /**
+     * Pause a Mission — freeze all queued tasks (prevent claiming).
+     * Running tasks continue until completion.
+     *
+     * @param missionId - The Mission to pause
+     */
+    pauseMission(missionId: string): Promise<number>;
+    /**
+     * Resume a paused Mission — unfreeze scheduled tasks back to queued.
+     *
+     * @param missionId - The Mission to resume
+     */
+    resumeMission(missionId: string): Promise<number>;
+    /** Result of a phase completion check. */
+    static readonly PHASE_RESULT: {
+        readonly NOT_COMPLETE: "not_complete";
+        readonly ADVANCED: "advanced";
+        readonly GATE_PENDING: "gate_pending";
+    };
+    /**
+     * Check if all WorkItems in the current phase are done/verified.
+     * If complete, advance to next phase based on phaseGateApproval policy.
+     *
+     * @param missionId - Mission to check
+     * @param phaseGateApproval - How phase transitions are approved
+     * @returns Phase advancement result
+     */
+    checkPhaseCompletion(missionId: string, phaseGateApproval?: 'none' | 'team_lead' | 'human'): Promise<{
+        result: string;
+        phase: number;
+    }>;
+    /**
+     * Cancel remaining queued/blocked tasks in current phase for replanning.
+     *
+     * @param missionId - Mission to replan
+     * @returns Number of cancelled tasks
+     */
+    cancelRemainingPhaseTasks(missionId: string): Promise<number>;
+    /**
+     * Derive a human-readable mission status from WorkItem counts.
+     */
+    private deriveMissionStatus;
+}
+//# sourceMappingURL=mission-executor.service.d.ts.map

package/dist/cli/backend/src/services/v3/mission-executor.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-executor.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/v3/mission-executor.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EACL,KAAK,OAAO,EAEb,MAAM,iCAAiC,CAAC;AAMzC,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;IACtC,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,wDAAwD;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,aAAa,CAAC;CACxD;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC,2CAA2C;IAC3C,OAAO,CAAC,aAAa,CAA6B;IAElD,OAAO;WAIO,WAAW,IAAI,sBAAsB;WAOrC,aAAa,IAAI,IAAI;IAQnC;;;;;;;OAOG;IACG,oBAAoB,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAoH5F;;;;;OAKG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAgDhE;;;;;OAKG;IACG,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBvD,0CAA0C;IAC1C,gBAAuB,YAAY;;;;MAIxB;IAEX;;;;;;;OAOG;IACG,oBAAoB,CACxB,SAAS,EAAE,MAAM,EACjB,iBAAiB,GAAE,MAAM,GAAG,WAAW,GAAG,OAAgB,GACzD,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAmC7C;;;;;OAKG;IACG,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA+BnE;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAQ5B"}