@rpamis/comet 0.3.9 → 0.4.0-beta.1

package/dist/domains/bundle/factory-compose.js

@@ -0,0 +1,309 @@
+import { promises as fs } from 'fs';
+import path from 'path';
+import { parse } from 'yaml';
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function stepShapeError(filePath, index) {
+    return new Error(`${filePath}: steps[${index}] must be {use: string} or {choose: {id: string, options: string[]}}`);
+}
+function narrowFlowDocument(document, filePath) {
+    if (!isRecord(document)) {
+        throw new Error(`${filePath}: document must be an object`);
+    }
+    const topLevelKeys = Object.keys(document);
+    const unknownTopLevelKey = topLevelKeys.find((key) => key !== 'steps');
+    if (unknownTopLevelKey) {
+        throw new Error(`${filePath}: unknown top-level field ${unknownTopLevelKey}`);
+    }
+    const steps = document.steps;
+    if (!Array.isArray(steps)) {
+        throw new Error(`${filePath}: steps must be an array`);
+    }
+    return steps.map((step, index) => {
+        if (!isRecord(step)) {
+            throw new Error(`${filePath}: steps[${index}] must be an object`);
+        }
+        const keys = Object.keys(step);
+        if ('use' in step) {
+            if (keys.length !== 1)
+                throw stepShapeError(filePath, index);
+            if (typeof step.use !== 'string') {
+                throw new Error(`${filePath}: steps[${index}].use must be a string`);
+            }
+            return { use: step.use };
+        }
+        if ('choose' in step) {
+            if (keys.length !== 1)
+                throw stepShapeError(filePath, index);
+            if (!isRecord(step.choose)) {
+                throw new Error(`${filePath}: steps[${index}].choose must be an object`);
+            }
+            const choose = step.choose;
+            const chooseKeys = Object.keys(choose);
+            if (!chooseKeys.includes('id')) {
+                throw new Error(`${filePath}: steps[${index}].choose.id must be a string`);
+            }
+            if (typeof choose.id !== 'string') {
+                throw new Error(`${filePath}: steps[${index}].choose.id must be a string`);
+            }
+            if (!chooseKeys.includes('options')) {
+                throw new Error(`${filePath}: steps[${index}].choose.options must be a string array`);
+            }
+            if (!Array.isArray(choose.options)) {
+                throw new Error(`${filePath}: steps[${index}].choose.options must be a string array`);
+            }
+            const invalidOptionIndex = choose.options.findIndex((option) => typeof option !== 'string');
+            if (invalidOptionIndex !== -1) {
+                throw new Error(`${filePath}: steps[${index}].choose.options[${invalidOptionIndex}] must be a string`);
+            }
+            if (chooseKeys.some((key) => key !== 'id' && key !== 'options')) {
+                throw new Error(`${filePath}: steps[${index}].choose must contain only id and options`);
+            }
+            return { choose: { id: choose.id, options: choose.options } };
+        }
+        throw stepShapeError(filePath, index);
+    });
+}
+async function readFlowSteps(root) {
+    const flowPath = path.join(root, 'comet', 'flow.yaml');
+    let source;
+    try {
+        source = await fs.readFile(flowPath, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return null;
+        throw error;
+    }
+    let document;
+    try {
+        document = parse(source);
+    }
+    catch (error) {
+        throw new Error(`${flowPath}: ${error.message}`, { cause: error });
+    }
+    return narrowFlowDocument(document, flowPath);
+}
+function buildAvailableSkills(resolvedSkills) {
+    const available = new Map();
+    for (const resolved of resolvedSkills) {
+        if (resolved.status !== 'available' || resolved.sources.length !== 1)
+            continue;
+        const source = resolved.sources[0];
+        const value = { resolved, source };
+        available.set(resolved.query, value);
+        if (!available.has(source.name))
+            available.set(source.name, value);
+    }
+    return available;
+}
+function buildResolvedSkills(resolvedSkills, availableSkills) {
+    const resolvedBySkill = new Map();
+    for (const resolved of resolvedSkills) {
+        resolvedBySkill.set(resolved.query, resolved);
+    }
+    for (const [skill, available] of availableSkills) {
+        if (!resolvedBySkill.has(skill))
+            resolvedBySkill.set(skill, available.resolved);
+    }
+    return resolvedBySkill;
+}
+export async function composeBundleFactoryPlan(input) {
+    const preferredIndex = new Map(input.preferredSkills.map((skill, index) => [skill, index]));
+    const availableSkills = buildAvailableSkills(input.resolvedSkills);
+    const resolvedBySkill = buildResolvedSkills(input.resolvedSkills, availableSkills);
+    const callChain = [];
+    const steps = [];
+    const choices = [];
+    const issues = [];
+    const entrySkills = [];
+    const seenCallChain = new Set();
+    const expandedSkills = new Set();
+    const referencedSkills = new Set();
+    const cycleIssues = new Set();
+    const duplicateIssues = new Set();
+    function preferenceIndexFor(skill) {
+        const resolvedIndex = resolvedBySkill.get(skill)?.preferenceIndex;
+        if (resolvedIndex !== undefined && resolvedIndex !== null)
+            return resolvedIndex;
+        return preferredIndex.get(skill) ?? null;
+    }
+    function addFinalStep(skill, context) {
+        if (seenCallChain.has(skill)) {
+            recordDuplicate(skill);
+            return;
+        }
+        seenCallChain.add(skill);
+        const preferenceIndex = preferenceIndexFor(skill);
+        callChain.push({ skill, preferenceIndex });
+        steps.push({
+            id: `step-${steps.length + 1}`,
+            skill,
+            source: context.source,
+            ...(context.fromSkill ? { fromSkill: context.fromSkill } : {}),
+            ...(context.choiceId ? { choiceId: context.choiceId } : {}),
+            preferenceIndex,
+        });
+    }
+    function recordCycle(pathItems) {
+        const key = pathItems.join('\0');
+        if (cycleIssues.has(key))
+            return;
+        cycleIssues.add(key);
+        issues.push({
+            type: 'cycle',
+            message: `Factory Skill composition contains a cycle: ${pathItems.join(' -> ')}`,
+            path: pathItems,
+        });
+    }
+    function recordDuplicate(skill) {
+        if (duplicateIssues.has(skill))
+            return;
+        duplicateIssues.add(skill);
+        issues.push({
+            type: 'duplicate-step',
+            message: `Factory Skill composition contains duplicate final step: ${skill}`,
+            skill,
+        });
+    }
+    function recordDuplicateFlow(skill) {
+        const key = `flow:${skill}`;
+        if (duplicateIssues.has(key))
+            return;
+        duplicateIssues.add(key);
+        issues.push({
+            type: 'duplicate-flow',
+            message: `Factory Skill composition contains duplicate flow reference: ${skill}`,
+            skill,
+        });
+    }
+    function selectChoiceOption(options) {
+        const availableOptions = options.filter((option) => availableSkills.has(option));
+        if (availableOptions.length === 0) {
+            return { selected: null, reason: 'No options are available in resolved Skills.' };
+        }
+        if (availableOptions.length === 1) {
+            return {
+                selected: availableOptions[0],
+                reason: 'Only one option is available in resolved Skills.',
+            };
+        }
+        let selected = availableOptions[0];
+        let selectedRank = preferredIndex.get(selected) ?? Number.POSITIVE_INFINITY;
+        let hasPreferredRank = Number.isFinite(selectedRank);
+        for (const option of availableOptions.slice(1)) {
+            const rank = preferredIndex.get(option) ?? Number.POSITIVE_INFINITY;
+            if (Number.isFinite(rank))
+                hasPreferredRank = true;
+            if (rank < selectedRank) {
+                selected = option;
+                selectedRank = rank;
+            }
+        }
+        if (!hasPreferredRank) {
+            return {
+                selected,
+                reason: `Selected the first available option in flow order: ${selected}.`,
+            };
+        }
+        return {
+            selected,
+            reason: `Selected the available option with the earliest preferredSkills rank: ${selected}.`,
+        };
+    }
+    async function expandChoice(fromSkill, choice, stack) {
+        const selected = selectChoiceOption(choice.options);
+        choices.push({
+            id: choice.id,
+            fromSkill,
+            options: [...choice.options],
+            selectedSkill: selected.selected,
+            reason: selected.reason,
+        });
+        if (!selected.selected) {
+            issues.push({
+                type: 'unresolved-choice',
+                message: `Choice ${choice.id} from ${fromSkill} has no available options.`,
+                choiceId: choice.id,
+            });
+            return;
+        }
+        await expandSkill(selected.selected, { source: 'choice', fromSkill, choiceId: choice.id }, stack);
+    }
+    async function expandSkill(skill, context, stack) {
+        const cycleIndex = stack.indexOf(skill);
+        if (cycleIndex !== -1) {
+            recordCycle([...stack.slice(cycleIndex), skill]);
+            return;
+        }
+        if (seenCallChain.has(skill)) {
+            recordDuplicate(skill);
+            return;
+        }
+        if (expandedSkills.has(skill)) {
+            recordDuplicateFlow(skill);
+            return;
+        }
+        expandedSkills.add(skill);
+        const available = availableSkills.get(skill);
+        if (!available) {
+            if (context.source === 'flow' && context.fromSkill) {
+                issues.push({
+                    type: 'unavailable-use',
+                    message: `Flow ${context.fromSkill} uses unavailable Skill ${skill}.`,
+                    fromSkill: context.fromSkill,
+                    skill,
+                });
+            }
+            return;
+        }
+        const flowSteps = await readFlowSteps(available.source.root);
+        if (!flowSteps) {
+            addFinalStep(skill, context);
+            return;
+        }
+        if (flowSteps.length === 0) {
+            issues.push({
+                type: 'empty-flow',
+                message: `Factory Skill composition source ${available.source.name} has an empty flow.yaml.`,
+                skill: available.source.name,
+            });
+            return;
+        }
+        const nextStack = [...stack, skill];
+        const fromSkill = available.source.name;
+        for (const step of flowSteps) {
+            if ('use' in step) {
+                referencedSkills.add(step.use);
+                await expandSkill(step.use, { source: 'flow', fromSkill }, nextStack);
+            }
+            else {
+                for (const option of step.choose.options) {
+                    referencedSkills.add(option);
+                }
+                await expandChoice(fromSkill, step.choose, nextStack);
+            }
+        }
+    }
+    const attemptedEntries = new Set();
+    for (const skill of input.entrySkills ?? input.preferredSkills) {
+        if (attemptedEntries.has(skill) || expandedSkills.has(skill) || referencedSkills.has(skill)) {
+            continue;
+        }
+        attemptedEntries.add(skill);
+        entrySkills.push(skill);
+        await expandSkill(skill, { source: 'atomic' }, []);
+    }
+    return {
+        callChain,
+        composition: {
+            schemaVersion: 1,
+            entrySkills,
+            steps,
+            choices,
+            issues,
+        },
+    };
+}
+//# sourceMappingURL=factory-compose.js.map

package/dist/domains/bundle/factory-compose.js.map

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

package/dist/domains/bundle/factory-guide.d.ts

@@ -0,0 +1,37 @@
+import { type SkillInventoryItem } from '../skill/inventory.js';
+import { type BundleResumeSummary } from './next-action.js';
+export interface BundleFactoryGuide {
+    schemaVersion: 1;
+    projectRoot: string;
+    firstRun: boolean;
+    preference: {
+        state: 'missing' | 'present' | 'invalid';
+        path: string;
+        mode: 'advisory' | 'strict' | null;
+        hash: string | null;
+        prefer: string[];
+        require: string[];
+        warnings: unknown[];
+        error: string | null;
+    };
+    inventory: {
+        total: number;
+        recommended: SkillInventoryItem[];
+        ambiguous: SkillInventoryItem[];
+        duplicateInstalls: SkillInventoryItem[];
+        groups: Record<string, string[]>;
+    };
+    resumable: BundleResumeSummary[];
+    nextQuestions: string[];
+    userMessage: {
+        title: string;
+        summary: string;
+        nextStep: string;
+    };
+}
+export declare function buildBundleFactoryGuide(options: {
+    projectRoot: string;
+    homeDir?: string;
+    builtinRoot?: string;
+}): Promise<BundleFactoryGuide>;
+//# sourceMappingURL=factory-guide.d.ts.map

package/dist/domains/bundle/factory-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-guide.d.ts","sourceRoot":"","sources":["../../../domains/bundle/factory-guide.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAMrF,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,MAAM,WAAW,kBAAkB;IACjC,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE;QACV,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAAC;QACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;KACtB,CAAC;IACF,SAAS,EAAE;QACT,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,kBAAkB,EAAE,CAAC;QAClC,SAAS,EAAE,kBAAkB,EAAE,CAAC;QAChC,iBAAiB,EAAE,kBAAkB,EAAE,CAAC;QACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;KAClC,CAAC;IACF,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAoBD,wBAAsB,uBAAuB,CAAC,OAAO,EAAE;IACrD,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAgF9B"}

package/dist/domains/bundle/factory-guide.js

@@ -0,0 +1,96 @@
+import path from 'path';
+import { buildSkillInventory } from '../skill/inventory.js';
+import { readProjectSkillPreferences, skillPreferencesPath, } from '../skill/preferences.js';
+import { buildBundleResumeSummary } from './next-action.js';
+import { listBundleAuthoringStatesReadOnly } from './state.js';
+function groups(items) {
+    return items.reduce((acc, item) => {
+        acc[item.capabilityGroup] = [...(acc[item.capabilityGroup] ?? []), item.name];
+        return acc;
+    }, {});
+}
+async function readPreferencesSafely(projectRoot) {
+    try {
+        return { value: await readProjectSkillPreferences(projectRoot), error: null };
+    }
+    catch (error) {
+        return { value: null, error: error.message };
+    }
+}
+export async function buildBundleFactoryGuide(options) {
+    const projectRoot = path.resolve(options.projectRoot);
+    const [preferencesResult, inventory, states] = await Promise.all([
+        readPreferencesSafely(projectRoot),
+        buildSkillInventory({
+            projectRoot,
+            homeDir: options.homeDir,
+            builtinRoot: options.builtinRoot,
+        }),
+        listBundleAuthoringStatesReadOnly(projectRoot),
+    ]);
+    const preferences = preferencesResult.value;
+    const resumable = states
+        .filter((state) => Boolean(state.factory) && !state.ready)
+        .map((state) => buildBundleResumeSummary(state, {
+        currentPreferenceHash: preferences?.hash ?? null,
+    }));
+    const recommended = inventory.filter((item) => item.recommended);
+    const ambiguous = inventory.filter((item) => item.status === 'ambiguous');
+    const duplicateInstalls = inventory.filter((item) => item.duplicateInstall);
+    const hasPreferences = Boolean(preferences);
+    const hasInvalidPreferences = Boolean(preferencesResult.error);
+    const hasResumable = resumable.length > 0;
+    return {
+        schemaVersion: 1,
+        projectRoot,
+        firstRun: !hasPreferences && !hasInvalidPreferences && !hasResumable,
+        preference: {
+            state: hasInvalidPreferences ? 'invalid' : hasPreferences ? 'present' : 'missing',
+            path: preferences?.path ?? skillPreferencesPath(projectRoot),
+            mode: preferences?.preferences.mode ?? null,
+            hash: preferences?.hash ?? null,
+            prefer: preferences?.preferences.prefer ?? [],
+            require: preferences?.preferences.require ?? [],
+            warnings: preferences?.warnings ?? [],
+            error: preferencesResult.error,
+        },
+        inventory: {
+            total: inventory.length,
+            recommended,
+            ambiguous,
+            duplicateInstalls,
+            groups: groups(inventory),
+        },
+        resumable,
+        nextQuestions: [
+            'What Skill do you want to create or optimize?',
+            'Which discovered Skills should Comet prefer?',
+            'Should Comet save these preferences to .comet/skill-preferences.yaml?',
+            'May Comet generate scripts, rules, and hooks as the control plane?',
+        ],
+        userMessage: hasInvalidPreferences
+            ? {
+                title: 'Fix project Skill preferences',
+                summary: `Saved project preferences in .comet/skill-preferences.yaml are invalid: ${preferencesResult.error}`,
+                nextStep: 'Open .comet/skill-preferences.yaml, fix the error, then run /comet-any again.',
+            }
+            : hasResumable
+                ? {
+                    title: 'Resume /comet-any',
+                    summary: `Found ${resumable.length} unfinished Skill creation flow(s).`,
+                    nextStep: 'Resume one flow before starting a new Skill unless the user explicitly starts over.',
+                }
+                : hasPreferences
+                    ? {
+                        title: 'Start with saved project preferences',
+                        summary: `Using ${preferences.preferences.prefer.length + preferences.preferences.require.length} saved Skill preference(s).`,
+                        nextStep: 'Ask for the Skill goal, then build a composition proposal.',
+                    }
+                    : {
+                        title: 'Start with /comet-any',
+                        summary: 'No project Skill preferences are saved yet.',
+                        nextStep: 'Show discovered recommended Skills and ask whether to save project preferences.',
+                    },
+    };
+}
+//# sourceMappingURL=factory-guide.js.map

package/dist/domains/bundle/factory-guide.js.map

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

package/dist/domains/bundle/factory-plan.d.ts

@@ -0,0 +1,48 @@
+import type { BundleAuthoringState, BundleFactoryCallChainItem, BundleFactoryMetadata, BundleFactoryOrderDeviation } from './types.js';
+import type { SkillCreatorIntent } from './user-facing.js';
+import { type WorkflowDefinitionInput, type WorkflowProtocol } from '../workflow-contract/index.js';
+export interface BundleFactoryPlanFile {
+    goal: string;
+    preferredSkills?: string[];
+    skillCreatorIntent?: SkillCreatorIntent;
+    workflow: WorkflowDefinitionInput;
+    deviations?: BundleFactoryOrderDeviation[];
+    engineMode?: BundleFactoryMetadata['engineMode'];
+    runnerMode?: BundleFactoryMetadata['runnerMode'];
+    mode?: BundleAuthoringState['mode'];
+    sourceRoot?: string;
+    defaultLocale?: string;
+    locales?: string[];
+    engineEnabled?: boolean;
+}
+export interface NormalizedBundleFactoryPlan {
+    goal: string;
+    skillCreatorIntent: SkillCreatorIntent;
+    preferredSkills: string[];
+    callChain: BundleFactoryCallChainItem[];
+    workflowDefinition: WorkflowDefinitionInput;
+    workflowProtocol: WorkflowProtocol;
+    deviations: BundleFactoryOrderDeviation[];
+    engineMode: BundleFactoryMetadata['engineMode'];
+    runnerMode: BundleFactoryMetadata['runnerMode'];
+    mode: BundleAuthoringState['mode'];
+    sourceRoot?: string;
+    defaultLocale: string;
+    locales: string[];
+    engineEnabled: boolean;
+}
+export declare function hashBundleFactoryPlan(plan: NormalizedBundleFactoryPlan): string;
+export declare function readBundleFactoryPlan(filePath: string): Promise<BundleFactoryPlanFile>;
+export declare function normalizeBundleFactoryPlan(options: {
+    plan: BundleFactoryPlanFile;
+    projectPreferredSkills?: string[] | null;
+}): NormalizedBundleFactoryPlan;
+export declare function writeBundleFactoryPlanArtifact(options: {
+    projectRoot: string;
+    name: string;
+    plan: NormalizedBundleFactoryPlan;
+}): Promise<{
+    planPath: string;
+    planHash: string;
+}>;
+//# sourceMappingURL=factory-plan.d.ts.map

package/dist/domains/bundle/factory-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory-plan.d.ts","sourceRoot":"","sources":["../../../domains/bundle/factory-plan.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,qBAAqB,EACrB,2BAA2B,EAC5B,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EACtB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,UAAU,CAAC,EAAE,2BAA2B,EAAE,CAAC;IAC3C,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,IAAI,CAAC,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,kBAAkB,CAAC;IACvC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,SAAS,EAAE,0BAA0B,EAAE,CAAC;IACxC,kBAAkB,EAAE,uBAAuB,CAAC;IAC5C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,UAAU,EAAE,2BAA2B,EAAE,CAAC;IAC1C,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAChD,UAAU,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AA0CD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,2BAA2B,GAAG,MAAM,CAI/E;AA8DD,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAuB5F;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE;IAClD,IAAI,EAAE,qBAAqB,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1C,GAAG,2BAA2B,CAuC9B;AASD,wBAAsB,8BAA8B,CAAC,OAAO,EAAE;IAC5D,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,2BAA2B,CAAC;CACnC,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlD"}