@cleocode/core 2026.3.59 → 2026.3.60

package/dist/tasks/pipeline-stage.js

@@ -0,0 +1,248 @@
+/**
+ * Pipeline stage binding for tasks (RCASD-IVTR+C).
+ *
+ * Implements auto-assignment of pipeline stages on task creation and
+ * forward-only stage transition validation on task update.
+ *
+ * Stages (in order):
+ *   1. research
+ *   2. consensus
+ *   3. architecture_decision
+ *   4. specification
+ *   5. decomposition
+ *   6. implementation
+ *   7. validation
+ *   8. testing
+ *   9. release
+ *  10. contribution  (cross-cutting, treated as terminal)
+ *
+ * @task T060
+ * @epic T056
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+/**
+ * Ordered pipeline stages (RCASD-IVTR+C).
+ * This matches lifecycle/stages.ts PIPELINE_STAGES but is kept local to avoid
+ * a circular dependency — tasks/ must not import from lifecycle/.
+ *
+ * @task T060
+ */
+export const TASK_PIPELINE_STAGES = [
+    'research',
+    'consensus',
+    'architecture_decision',
+    'specification',
+    'decomposition',
+    'implementation',
+    'validation',
+    'testing',
+    'release',
+    'contribution',
+];
+/** Order map for fast index lookups (1-based). */
+const STAGE_ORDER = {
+    research: 1,
+    consensus: 2,
+    architecture_decision: 3,
+    specification: 4,
+    decomposition: 5,
+    implementation: 6,
+    validation: 7,
+    testing: 8,
+    release: 9,
+    contribution: 10,
+};
+// =============================================================================
+// VALIDATION
+// =============================================================================
+/**
+ * Check whether a string is a valid pipeline stage name.
+ *
+ * @remarks
+ * Uses a type-narrowing signature so callers can safely use the value
+ * as {@link TaskPipelineStage} after a truthy check.
+ *
+ * @param stage - Raw string to test
+ * @returns True if it is a valid stage name
+ *
+ * @example
+ * ```ts
+ * isValidPipelineStage('research');       // => true
+ * isValidPipelineStage('not_a_stage');    // => false
+ * ```
+ *
+ * @task T060
+ */
+export function isValidPipelineStage(stage) {
+    return TASK_PIPELINE_STAGES.includes(stage);
+}
+/**
+ * Validate a pipeline stage name and throw a CleoError on failure.
+ *
+ * @remarks
+ * Uses an assertion signature — after a successful call the compiler
+ * narrows `stage` to {@link TaskPipelineStage}.
+ *
+ * @param stage - Stage name to validate
+ * @returns void (assertion function — narrows type on success)
+ * @throws CleoError(VALIDATION_ERROR) if invalid
+ *
+ * @example
+ * ```ts
+ * validatePipelineStage('implementation'); // passes
+ * validatePipelineStage('invalid');        // throws CleoError
+ * ```
+ *
+ * @task T060
+ */
+export function validatePipelineStage(stage) {
+    if (!isValidPipelineStage(stage)) {
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Invalid pipeline stage: "${stage}". Valid stages: ${TASK_PIPELINE_STAGES.join(', ')}`, { fix: `Use one of: ${TASK_PIPELINE_STAGES.join(', ')}` });
+    }
+}
+// =============================================================================
+// AUTO-ASSIGNMENT
+// =============================================================================
+/**
+ * Determine the default pipeline stage for a new task.
+ *
+ * Rules (in priority order):
+ * 1. If an explicit stage is provided and valid, use it.
+ * 2. If the task has a parent, inherit the parent's pipelineStage.
+ * 3. If the task type is 'epic', default to 'research'.
+ * 4. Otherwise default to 'implementation'.
+ *
+ * @remarks
+ * Priority order ensures explicit caller intent wins, then parent
+ * inheritance, then type-based defaults. This avoids surprising
+ * overrides when parent stages differ from the default.
+ *
+ * @param options - Resolution inputs
+ * @param options.explicitStage - Stage explicitly provided by the caller
+ * @param options.taskType      - Type of the task being created
+ * @param options.parentTask    - Parent task (if any), for inheritance
+ * @returns The resolved pipeline stage name
+ *
+ * @example
+ * ```ts
+ * resolveDefaultPipelineStage({ taskType: 'epic' });
+ * // => 'research'
+ *
+ * resolveDefaultPipelineStage({ taskType: 'task' });
+ * // => 'implementation'
+ * ```
+ *
+ * @task T060
+ */
+export function resolveDefaultPipelineStage(options) {
+    const { explicitStage, taskType, parentTask } = options;
+    // 1. Caller-supplied explicit stage (validated upstream)
+    if (explicitStage && isValidPipelineStage(explicitStage)) {
+        return explicitStage;
+    }
+    // 2. Inherit from parent
+    if (parentTask?.pipelineStage && isValidPipelineStage(parentTask.pipelineStage)) {
+        return parentTask.pipelineStage;
+    }
+    // 3. Epic → research
+    if (taskType === 'epic') {
+        return 'research';
+    }
+    // 4. Default
+    return 'implementation';
+}
+// =============================================================================
+// TRANSITION VALIDATION
+// =============================================================================
+/**
+ * Get the numeric order of a pipeline stage (1-based).
+ *
+ * @remarks
+ * Returns -1 for unrecognised stage names so callers can distinguish
+ * "unknown" from a valid low-order stage.
+ *
+ * @param stage - Stage name (must be valid)
+ * @returns Numeric order (1–10), or -1 if not found
+ *
+ * @example
+ * ```ts
+ * getPipelineStageOrder('research');       // => 1
+ * getPipelineStageOrder('implementation'); // => 6
+ * getPipelineStageOrder('unknown');        // => -1
+ * ```
+ *
+ * @task T060
+ */
+export function getPipelineStageOrder(stage) {
+    return isValidPipelineStage(stage) ? STAGE_ORDER[stage] : -1;
+}
+/**
+ * Check whether transitioning from `currentStage` to `newStage` is forward-only.
+ *
+ * "Forward" means the new stage's order is greater than or equal to the current
+ * stage's order (same stage is a no-op and is considered valid).
+ *
+ * @remarks
+ * Unknown stages are treated as valid to avoid blocking tasks with
+ * legacy or custom stage names that predate the standard set.
+ *
+ * @param currentStage - The task's current pipeline stage
+ * @param newStage     - The requested new pipeline stage
+ * @returns True if the transition is allowed (forward or same)
+ *
+ * @example
+ * ```ts
+ * isPipelineTransitionForward('research', 'implementation'); // => true
+ * isPipelineTransitionForward('testing', 'research');        // => false
+ * ```
+ *
+ * @task T060
+ */
+export function isPipelineTransitionForward(currentStage, newStage) {
+    const currentOrder = getPipelineStageOrder(currentStage);
+    const newOrder = getPipelineStageOrder(newStage);
+    if (currentOrder === -1 || newOrder === -1)
+        return true; // unknown stages: allow
+    return newOrder >= currentOrder;
+}
+/**
+ * Validate a pipeline stage transition and throw if it would move backward.
+ *
+ * @remarks
+ * Validates the new stage name first via {@link validatePipelineStage},
+ * then checks directionality. A null/undefined current stage accepts any
+ * valid new stage (first assignment).
+ *
+ * @param currentStage - The task's current pipeline stage (may be null/undefined)
+ * @param newStage     - The new stage being requested
+ * @throws CleoError(VALIDATION_ERROR) if the transition is backward
+ *
+ * @example
+ * ```ts
+ * validatePipelineTransition(null, 'research');              // passes (first assignment)
+ * validatePipelineTransition('research', 'implementation');   // passes (forward)
+ * validatePipelineTransition('testing', 'research');          // throws (backward)
+ * ```
+ *
+ * @task T060
+ */
+export function validatePipelineTransition(currentStage, newStage) {
+    // Validate the new stage name first
+    validatePipelineStage(newStage);
+    if (!currentStage) {
+        // No current stage — any valid stage is allowed
+        return;
+    }
+    if (!isPipelineTransitionForward(currentStage, newStage)) {
+        const currentOrder = getPipelineStageOrder(currentStage);
+        const newOrder = getPipelineStageOrder(newStage);
+        throw new CleoError(ExitCode.VALIDATION_ERROR, `Pipeline stage transition rejected: cannot move backward from "${currentStage}" (order ${currentOrder}) to "${newStage}" (order ${newOrder}). Tasks can only move forward through pipeline stages.`, {
+            fix: `Specify a stage at or after "${currentStage}". Valid forward stages: ${TASK_PIPELINE_STAGES.filter((s) => STAGE_ORDER[s] >= currentOrder).join(', ')}`,
+        });
+    }
+}
+//# sourceMappingURL=pipeline-stage.js.map

package/dist/tasks/pipeline-stage.js.map

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

package/dist/tasks/plan.js

@@ -0,0 +1,268 @@
+/**
+ * Composite planning view - aggregates multiple task queries for planning.
+ * @task T4914
+ * @epic T4454
+ */
+import { getAccessor } from '../store/data-accessor.js';
+import { depsReady } from './deps-ready.js';
+const PRIORITY_SCORE = {
+    critical: 100,
+    high: 75,
+    medium: 50,
+    low: 25,
+};
+async function loadAllTasks(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const { tasks } = await accessor.queryTasks({});
+    return tasks;
+}
+/**
+ * Calculate leverage score for a task based on how many other tasks depend on it.
+ */
+function calculateLeverage(taskId, taskMap) {
+    let leverage = 0;
+    for (const task of taskMap.values()) {
+        if (task.depends?.includes(taskId)) {
+            leverage++;
+        }
+    }
+    return leverage;
+}
+/**
+ * Find the epic ID for a task (parent epic, not immediate parent).
+ */
+function findEpicId(task, taskMap) {
+    let current = task;
+    const visited = new Set();
+    while (current?.parentId && !visited.has(current.id)) {
+        visited.add(current.id);
+        const parent = taskMap.get(current.parentId);
+        if (!parent)
+            break;
+        if (parent.type === 'epic') {
+            return parent.id;
+        }
+        current = parent;
+    }
+    // If task itself is an epic
+    if (task.type === 'epic') {
+        return task.id;
+    }
+    // Return parentId as fallback, or task's own id
+    return task.parentId ?? task.id;
+}
+/**
+ * Get current phase from tasks.
+ */
+async function getCurrentPhase(projectRoot) {
+    const accessor = await getAccessor(projectRoot);
+    const meta = await accessor.getMetaValue('project_meta');
+    return meta?.currentPhase ?? null;
+}
+/**
+ * Calculate completion percentage for an epic.
+ */
+function calculateEpicCompletion(epicId, taskMap) {
+    let totalTasks = 0;
+    let completedTasks = 0;
+    let activeTasks = 0;
+    // Count direct children and their descendants
+    const collectTasks = (parentId) => {
+        for (const task of taskMap.values()) {
+            if (task.parentId === parentId) {
+                totalTasks++;
+                if (task.status === 'done' || task.status === 'cancelled') {
+                    completedTasks++;
+                }
+                if (task.status === 'active') {
+                    activeTasks++;
+                }
+                // Recursively count descendants
+                collectTasks(task.id);
+            }
+        }
+    };
+    collectTasks(epicId);
+    const completionPercent = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+    return { activeTasks, completionPercent };
+}
+/**
+ * Build composite planning view.
+ * @task T4914
+ */
+export async function coreTaskPlan(projectRoot) {
+    const allTasks = await loadAllTasks(projectRoot);
+    const taskMap = new Map(allTasks.map((t) => [t.id, t]));
+    const currentPhase = await getCurrentPhase(projectRoot);
+    // ========================================================================
+    // 1. In-Progress Epics (epics with active status)
+    // ========================================================================
+    const inProgressEpics = [];
+    for (const task of allTasks) {
+        if (task.type === 'epic' && task.status === 'active') {
+            const { activeTasks, completionPercent } = calculateEpicCompletion(task.id, taskMap);
+            inProgressEpics.push({
+                epicId: task.id,
+                epicTitle: task.title,
+                activeTasks,
+                completionPercent,
+            });
+        }
+    }
+    // ========================================================================
+    // 2. Ready Tasks (pending tasks with deps satisfied)
+    // ========================================================================
+    const readyTasks = [];
+    const pendingTasks = allTasks.filter((t) => t.status === 'pending');
+    for (const task of pendingTasks) {
+        if (depsReady(task.depends, taskMap)) {
+            const leverage = calculateLeverage(task.id, taskMap);
+            const epicId = findEpicId(task, taskMap);
+            // Calculate score using same logic as tasks.next
+            const reasons = [];
+            let score = 0;
+            score += PRIORITY_SCORE[task.priority] ?? 50;
+            reasons.push(`priority: ${task.priority} (+${PRIORITY_SCORE[task.priority] ?? 50})`);
+            if (currentPhase && task.phase === currentPhase) {
+                score += 20;
+                reasons.push(`phase alignment: ${currentPhase} (+20)`);
+            }
+            score += 10;
+            reasons.push('all dependencies satisfied (+10)');
+            if (task.createdAt) {
+                const ageMs = Date.now() - new Date(task.createdAt).getTime();
+                const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                if (ageDays > 7) {
+                    const ageBonus = Math.min(15, Math.floor(ageDays / 7));
+                    score += ageBonus;
+                    reasons.push(`age: ${Math.floor(ageDays)} days (+${ageBonus})`);
+                }
+            }
+            // Add leverage bonus to score
+            if (leverage > 0) {
+                score += leverage * 5;
+                reasons.push(`leverage: unblocks ${leverage} task(s) (+${leverage * 5})`);
+            }
+            readyTasks.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+                leverage,
+                score,
+                reasons,
+            });
+        }
+    }
+    // Sort by score descending
+    readyTasks.sort((a, b) => b.score - a.score);
+    // ========================================================================
+    // 3. Blocked Tasks
+    // ========================================================================
+    const blockedTasks = [];
+    // Tasks with blocked status
+    for (const task of allTasks) {
+        if (task.status === 'blocked') {
+            const blockedBy = [];
+            if (task.blockedBy) {
+                blockedBy.push(task.blockedBy);
+            }
+            if (task.depends) {
+                for (const depId of task.depends) {
+                    const dep = taskMap.get(depId);
+                    if (dep && dep.status !== 'done' && dep.status !== 'cancelled') {
+                        blockedBy.push(depId);
+                    }
+                }
+            }
+            // Calculate how many tasks this blocks
+            let blocksCount = 0;
+            for (const t of allTasks) {
+                if (t.depends?.includes(task.id)) {
+                    blocksCount++;
+                }
+            }
+            blockedTasks.push({
+                id: task.id,
+                title: task.title,
+                blockedBy,
+                blocksCount,
+            });
+        }
+    }
+    // Tasks with unresolved dependencies (pending + has incomplete deps)
+    for (const task of allTasks) {
+        if (task.status === 'pending' && task.depends && task.depends.length > 0) {
+            const hasUnresolvedDeps = task.depends.some((depId) => {
+                const dep = taskMap.get(depId);
+                return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+            });
+            if (hasUnresolvedDeps && !blockedTasks.some((b) => b.id === task.id)) {
+                const blockedBy = task.depends.filter((depId) => {
+                    const dep = taskMap.get(depId);
+                    return dep && dep.status !== 'done' && dep.status !== 'cancelled';
+                });
+                // Calculate how many tasks this blocks
+                let blocksCount = 0;
+                for (const t of allTasks) {
+                    if (t.depends?.includes(task.id)) {
+                        blocksCount++;
+                    }
+                }
+                blockedTasks.push({
+                    id: task.id,
+                    title: task.title,
+                    blockedBy,
+                    blocksCount,
+                });
+            }
+        }
+    }
+    // ========================================================================
+    // 4. Open Bugs (origin:bug-report OR label:bug)
+    // ========================================================================
+    const openBugs = [];
+    for (const task of allTasks) {
+        const isBug = task.origin === 'bug-report' || task.labels?.includes('bug');
+        const isOpen = task.status !== 'done' && task.status !== 'cancelled';
+        if (isBug && isOpen) {
+            const epicId = findEpicId(task, taskMap);
+            openBugs.push({
+                id: task.id,
+                title: task.title,
+                priority: task.priority,
+                epicId,
+            });
+        }
+    }
+    // ========================================================================
+    // 5. Metrics
+    // ========================================================================
+    const epics = allTasks.filter((t) => t.type === 'epic');
+    const activeEpics = epics.filter((t) => t.status === 'active').length;
+    const actionable = allTasks.filter((t) => (t.status === 'pending' || t.status === 'active') && !blockedTasks.some((b) => b.id === t.id)).length;
+    const blocked = blockedTasks.length;
+    // Calculate average leverage across all tasks
+    let totalLeverage = 0;
+    for (const task of allTasks) {
+        totalLeverage += calculateLeverage(task.id, taskMap);
+    }
+    const avgLeverage = allTasks.length > 0 ? Math.round((totalLeverage / allTasks.length) * 100) / 100 : 0;
+    const metrics = {
+        totalEpics: epics.length,
+        activeEpics,
+        totalTasks: allTasks.length,
+        actionable,
+        blocked,
+        openBugs: openBugs.length,
+        avgLeverage,
+    };
+    return {
+        inProgress: inProgressEpics,
+        ready: readyTasks,
+        blocked: blockedTasks,
+        openBugs,
+        metrics,
+    };
+}
+//# sourceMappingURL=plan.js.map

package/dist/tasks/plan.js.map

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

package/dist/tasks/relates.js

@@ -0,0 +1,89 @@
+/**
+ * Task relationship management core module.
+ * @task T4538
+ * @epic T4454
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+import { getAccessor } from '../store/data-accessor.js';
+/** Suggest related tasks based on shared attributes. */
+export async function suggestRelated(taskId, opts, accessor) {
+    const acc = accessor ?? (await getAccessor(opts.cwd));
+    const { tasks: allTasks } = await acc.queryTasks({});
+    const task = allTasks.find((t) => t.id === taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    const suggestions = [];
+    for (const other of allTasks) {
+        if (other.id === taskId)
+            continue;
+        let score = 0;
+        const reasons = [];
+        // Shared labels
+        const sharedLabels = (task.labels ?? []).filter((l) => (other.labels ?? []).includes(l));
+        if (sharedLabels.length > 0) {
+            score += sharedLabels.length * 20;
+            reasons.push(`Shared labels: ${sharedLabels.join(', ')}`);
+        }
+        // Same phase
+        if (task.phase && task.phase === other.phase) {
+            score += 15;
+            reasons.push(`Same phase: ${task.phase}`);
+        }
+        // Same parent
+        if (task.parentId && task.parentId === other.parentId) {
+            score += 25;
+            reasons.push('Same parent');
+        }
+        const threshold = opts.threshold ?? 50;
+        if (score >= threshold) {
+            suggestions.push({
+                id: other.id,
+                title: other.title,
+                score: Math.min(score, 100),
+                reason: reasons.join('; '),
+            });
+        }
+    }
+    return {
+        taskId,
+        suggestions: suggestions.sort((a, b) => b.score - a.score).slice(0, 10),
+        count: suggestions.length,
+    };
+}
+/** Add a relation between tasks. */
+export async function addRelation(from, to, type, reason, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const fromExists = await acc.taskExists(from);
+    if (!fromExists) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${from} not found`);
+    }
+    const toExists = await acc.taskExists(to);
+    if (!toExists) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${to} not found`);
+    }
+    // Persist to task_relations table via accessor (T5168 fix)
+    await acc.addRelation(from, to, type, reason);
+    return { from, to, type, reason, added: true };
+}
+/** Discover related tasks using various methods. */
+export async function discoverRelated(taskId, cwd, accessor) {
+    return suggestRelated(taskId, { threshold: 30, cwd }, accessor);
+}
+/** List existing relations for a task. */
+export async function listRelations(taskId, cwd, accessor) {
+    const acc = accessor ?? (await getAccessor(cwd));
+    const task = await acc.loadSingleTask(taskId);
+    if (!task) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Task ${taskId} not found`);
+    }
+    // task.relates is populated from task_relations table by loadSingleTask
+    const relates = task.relates ?? [];
+    return {
+        taskId,
+        relations: relates,
+        count: relates.length,
+    };
+}
+//# sourceMappingURL=relates.js.map

package/dist/tasks/relates.js.map

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

package/dist/tasks/reparent.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Canonical reparent logic — move a task to a different parent in the hierarchy.
+ * Both CLI (reparent command) and core (updateTask) delegate here.
+ *
+ * This module operates on an in-memory TaskFile. The caller is responsible
+ * for loading and saving the data (via DataAccessor or direct JSON I/O).
+ *
+ * @task T4807
+ * @epic T4454
+ */
+import type { TaskFile } from '@cleocode/contracts';
+import type { HierarchyPolicy } from './hierarchy-policy.js';
+/** Options for reparenting a task. */
+export interface ReparentOptions {
+    taskId: string;
+    /** New parent ID, or null to promote to root. */
+    newParentId: string | null;
+    /** Optional resolved hierarchy policy. If not provided, uses llm-agent-first defaults. */
+    policy?: HierarchyPolicy;
+}
+/** Result of a reparent operation. */
+export interface ReparentResult {
+    oldParent: string | null;
+    newParent: string | null;
+    newType: string;
+}
+/**
+ * Reparent a task within a TaskFile.
+ *
+ * Mutates the task in-place within `data.tasks`. Updates `parentId`, `type`,
+ * and `updatedAt` on the target task, and `lastUpdated` on the TaskFile.
+ *
+ * @param data  The loaded TaskFile (mutated in place)
+ * @param opts  Reparent options (taskId, newParentId)
+ * @returns     Result with old/new parent and new type
+ */
+export declare function reparentTask(data: TaskFile, opts: ReparentOptions): Promise<ReparentResult>;
+//# sourceMappingURL=reparent.d.ts.map

package/dist/tasks/reparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reparent.d.ts","sourceRoot":"","sources":["../../src/tasks/reparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAKpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,sCAAsC;AACtC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,eAAe,CAAC;CAC1B;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAwFjG"}