@cleocode/core 2026.9.8 → 2026.9.10

package/dist/nexus/diff.js

@@ -8,6 +8,7 @@
  * @task T1473
  */
 import { engineError, engineSuccess } from '../engine-result.js';
+import { createParserExecutionPort } from '../resources/spawn-wrapper.js';
 /**
  * Diff the NEXUS index between two git commits.
  *
@@ -72,7 +73,7 @@ export async function diffNexusIndex(repoPath, opts = {}) {
     const pipelineResult = await runPipeline(repoPath, projectId, db, {
         nexusNodes: nexusSchema.nexusNodes,
         nexusRelations: nexusSchema.nexusRelations,
-    }, undefined, { incremental: true });
+    }, undefined, { incremental: true, parserExecution: createParserExecutionPort() });
     let relationsAfter = 0;
     let nodesAfter = 0;
     try {

package/dist/nexus/diff.js.map

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

package/dist/nexus/identity.d.ts

@@ -11,6 +11,7 @@
  * @task T9149
  * @module nexus/identity
  */
+import type { OperationExecutionContext } from '@cleocode/contracts/jobs';
 /** Components that make up the canonical project fingerprint. */
 export interface ProjectIdentityComponents {
     /** Absolute realpath of the git root (resolves symlinks). */
@@ -37,14 +38,32 @@ export interface CanonicalProjectIdResult {
  *
  * Returns `null` if the directory is not inside a git repo (non-fatal: allows
  * use outside git repos).
+ * @param fromPath - Explicit directory for Git discovery.
+ * @param execution - Optional original lifetime; cancellation/deadline are never absent-Git fallback.
+ * @returns Git root or null when Git is unavailable.
+ * @remarks An execution context bounds and cancels the actual child; omitted context
+ * retains the legacy unbounded lifetime. Synchronous scheduling is not preempted.
+ * @example
+ * ```ts
+ * const root = await findGitRoot(projectRoot, execution);
+ * ```
  */
-export declare function findGitRoot(fromPath: string): Promise<string | null>;
+export declare function findGitRoot(fromPath: string, execution?: OperationExecutionContext): Promise<string | null>;
 /**
  * Find the primary git remote URL (origin fetch URL).
  *
  * Returns `null` when there are no remotes or git is unavailable.
+ * @param fromPath - Explicit directory for remote lookup.
+ * @param execution - Optional original lifetime, shared with preceding discovery stages.
+ * @returns Remote URL, or null for an unavailable Git remote.
+ * @remarks Context cancellation and deadline failures propagate instead of producing
+ * a fallback fingerprint. Actual children receive the same signal and remaining timeout.
+ * @example
+ * ```ts
+ * const remote = await findGitRemoteUrl(projectRoot, execution);
+ * ```
  */
-export declare function findGitRemoteUrl(fromPath: string): Promise<string | null>;
+export declare function findGitRemoteUrl(fromPath: string, execution?: OperationExecutionContext): Promise<string | null>;
 /**
  * Compute the canonical project ID for a given repository path.
  *
@@ -59,11 +78,18 @@ export declare function findGitRemoteUrl(fromPath: string): Promise<string | nul
  * same remote) produce the same ID — resolving the 80,969-row pollution vector.
  *
  * @param repoPath - Absolute path to the project root (may be a symlink or bind-mount).
+ * @param execution - Optional captured caller lifetime, never renewed between stages.
+ * @remarks All started Git children settle before this operation finishes. Context
+ * cancellation/deadline failures cannot establish fallback identity or authority.
+ * @example
+ * ```ts
+ * const identity = await canonicalProjectId(projectRoot, execution);
+ * ```
  * @returns The canonical project ID result with components and hash.
  *
  * @task T9149
  */
-export declare function canonicalProjectId(repoPath: string): Promise<CanonicalProjectIdResult>;
+export declare function canonicalProjectId(repoPath: string, execution?: OperationExecutionContext): Promise<CanonicalProjectIdResult>;
 /**
  * Compute the legacy base64url(path) ID for a given path.
  *

package/dist/nexus/identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/nexus/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChD;AAMD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAS1E;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU/E;AAyBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC,CA0B5F;AAMD;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAO3F"}
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/nexus/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAS1E,iEAAiE;AACjE,MAAM,WAAW,yBAAyB;IACxC,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB;IACvC,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,CAAC,UAAU,EAAE,yBAAyB,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChD;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBxB;AAkCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,yBAAyB,GACpC,OAAO,CAAC,wBAAwB,CAAC,CA6BnC;AAMD;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAO3F"}

package/dist/nexus/identity.js

@@ -26,15 +26,31 @@ const execFileAsync = promisify(execFile);
  *
  * Returns `null` if the directory is not inside a git repo (non-fatal: allows
  * use outside git repos).
+ * @param fromPath - Explicit directory for Git discovery.
+ * @param execution - Optional original lifetime; cancellation/deadline are never absent-Git fallback.
+ * @returns Git root or null when Git is unavailable.
+ * @remarks An execution context bounds and cancels the actual child; omitted context
+ * retains the legacy unbounded lifetime. Synchronous scheduling is not preempted.
+ * @example
+ * ```ts
+ * const root = await findGitRoot(projectRoot, execution);
+ * ```
  */
-export async function findGitRoot(fromPath) {
+export async function findGitRoot(fromPath, execution) {
+    execution?.assertActive();
     try {
         const { stdout } = await execFileAsync('git', ['rev-parse', '--show-toplevel'], {
             cwd: resolve(fromPath),
+            signal: execution?.signal,
+            timeout: execution ? Math.max(1, execution.remainingMs()) : undefined,
+            killSignal: 'SIGKILL',
+            maxBuffer: 64 * 1024,
         });
+        execution?.assertActive();
         return resolve(stdout.trim());
     }
     catch {
+        execution?.assertActive();
         return null;
     }
 }
@@ -42,16 +58,32 @@ export async function findGitRoot(fromPath) {
  * Find the primary git remote URL (origin fetch URL).
  *
  * Returns `null` when there are no remotes or git is unavailable.
+ * @param fromPath - Explicit directory for remote lookup.
+ * @param execution - Optional original lifetime, shared with preceding discovery stages.
+ * @returns Remote URL, or null for an unavailable Git remote.
+ * @remarks Context cancellation and deadline failures propagate instead of producing
+ * a fallback fingerprint. Actual children receive the same signal and remaining timeout.
+ * @example
+ * ```ts
+ * const remote = await findGitRemoteUrl(projectRoot, execution);
+ * ```
  */
-export async function findGitRemoteUrl(fromPath) {
+export async function findGitRemoteUrl(fromPath, execution) {
+    execution?.assertActive();
     try {
         const { stdout } = await execFileAsync('git', ['remote', 'get-url', 'origin'], {
             cwd: resolve(fromPath),
+            signal: execution?.signal,
+            timeout: execution ? Math.max(1, execution.remainingMs()) : undefined,
+            killSignal: 'SIGKILL',
+            maxBuffer: 64 * 1024,
         });
+        execution?.assertActive();
         const url = stdout.trim();
         return url || null;
     }
     catch {
+        execution?.assertActive();
         return null;
     }
 }
@@ -62,14 +94,20 @@ export async function findGitRemoteUrl(fromPath) {
  * Read the project name from `.cleo/project-info.json` (if present).
  * Non-fatal on any I/O or parse error.
  */
-async function readProjectInfoName(repoRoot) {
+async function readProjectInfoName(repoRoot, execution) {
+    execution?.assertActive();
     try {
-        const raw = await readFile(join(repoRoot, '.cleo', 'project-info.json'), 'utf8');
+        const raw = await readFile(join(repoRoot, '.cleo', 'project-info.json'), {
+            encoding: 'utf8',
+            signal: execution?.signal,
+        });
+        execution?.assertActive();
         const parsed = JSON.parse(raw);
         const name = typeof parsed.name === 'string' ? parsed.name : undefined;
         return name || undefined;
     }
     catch {
+        execution?.assertActive();
         return undefined;
     }
 }
@@ -90,20 +128,33 @@ async function readProjectInfoName(repoRoot) {
  * same remote) produce the same ID — resolving the 80,969-row pollution vector.
  *
  * @param repoPath - Absolute path to the project root (may be a symlink or bind-mount).
+ * @param execution - Optional captured caller lifetime, never renewed between stages.
+ * @remarks All started Git children settle before this operation finishes. Context
+ * cancellation/deadline failures cannot establish fallback identity or authority.
+ * @example
+ * ```ts
+ * const identity = await canonicalProjectId(projectRoot, execution);
+ * ```
  * @returns The canonical project ID result with components and hash.
  *
  * @task T9149
  */
-export async function canonicalProjectId(repoPath) {
+export async function canonicalProjectId(repoPath, execution) {
+    execution?.assertActive();
     const realRepoPath = resolve(repoPath);
-    const [gitRoot, remoteUrl, projectName] = await Promise.all([
-        findGitRoot(realRepoPath),
-        findGitRemoteUrl(realRepoPath),
-        (async () => {
-            const gr = await findGitRoot(realRepoPath);
-            return gr ? readProjectInfoName(gr) : readProjectInfoName(realRepoPath);
-        })(),
+    // Await every owned child even when a sibling fails, so completion does not
+    // abandon another Git process. Both children use the same original deadline.
+    const results = await Promise.allSettled([
+        findGitRoot(realRepoPath, execution),
+        findGitRemoteUrl(realRepoPath, execution),
     ]);
+    for (const result of results)
+        if (result.status === 'rejected')
+            throw result.reason;
+    const gitRoot = results[0].status === 'fulfilled' ? results[0].value : null;
+    const remoteUrl = results[1].status === 'fulfilled' ? results[1].value : null;
+    const projectName = await readProjectInfoName(gitRoot ?? realRepoPath, execution);
+    execution?.assertActive();
     const effectiveRoot = gitRoot ?? realRepoPath;
     const fingerprint = [effectiveRoot, projectName ?? '', remoteUrl ?? ''].join('|');
     const id = createHash('sha256').update(fingerprint).digest('hex').substring(0, 12);

package/dist/nexus/identity.js.map

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

package/dist/nexus/impact.d.ts

@@ -7,9 +7,10 @@
  *
  * @task T1473
  */
+import type { NexusImpactResult as ImpactOperationResult, KnowledgeCoverage, NexusImpactParams, RiskTier } from '@cleocode/contracts';
 import { type EngineResult } from '../engine-result.js';
 /** Risk level classification for an impacted symbol. */
-export type NexusRiskLevel = 'NONE' | 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+export type NexusRiskLevel = RiskTier;
 /** A single impacted node at a given BFS depth. */
 export interface NexusImpactNode {
     /** Node ID. */
@@ -43,16 +44,18 @@ export interface NexusImpactOptions {
 export interface NexusImpactResult {
     /** Original symbol query. */
     query: string;
+    /** Coverage assessed independently of detected impact. */
+    coverage: KnowledgeCoverage;
     /** Project ID. */
     projectId: string;
     /** ID of the target node analyzed. */
-    targetNodeId: string;
+    targetNodeId: string | null;
     /** Name of the target node. */
-    targetName: unknown;
+    targetName: string | null;
     /** Kind of the target node. */
-    targetKind: unknown;
+    targetKind: string | null;
     /** File path of the target node. */
-    targetFilePath: unknown;
+    targetFilePath: string | null;
     /** Risk level classification. */
     riskLevel: NexusRiskLevel;
     /** Total impacted nodes (all depths). */
@@ -72,11 +75,11 @@ export interface NexusImpactResult {
  * breadth-first up to `maxDepth` levels. Returns per-depth layers with risk
  * classification.
  *
- * Throws with code `E_NOT_FOUND` when no symbol matches the query.
+ * Missing coverage returns UNKNOWN; ambiguous names return qualified candidates.
  *
  * @param symbolName - Symbol name to analyse (partial match).
  * @param projectId  - Nexus project ID.
- * @param _repoPath  - Absolute repository root path (reserved for future use).
+ * @param repoPath   - Absolute repository root path used for freshness checks.
  * @param opts       - Traversal options.
  * @returns Impact analysis result.
  *
@@ -84,24 +87,23 @@ export interface NexusImpactResult {
  * const impact = await getSymbolImpact('dispatchFromCli', projectId, repoPath);
  * console.log(impact.riskLevel, impact.totalImpactedNodes);
  */
-export declare function getSymbolImpact(symbolName: string, projectId: string, _repoPath: string, opts?: NexusImpactOptions): Promise<NexusImpactResult>;
+export declare function getSymbolImpact(symbolName: string, projectId: string, repoPath: string, opts?: NexusImpactOptions): Promise<NexusImpactResult>;
 /**
  * Analyze impact of changing a symbol (SQL BFS implementation).
  *
  * Runs BFS from the target symbol to find all symbols that would be affected
  * by changes to it, optionally with detailed reasons.
  *
+ * @param projectRoot - Explicit project root whose graph and coverage are assessed.
+ * @param params - Shared impact query, project identity, reasons, and depth options.
+ * @returns Impact result or structured symbol ambiguity/error details.
+ * @remarks Project binding is explicit and never falls back to the process working directory.
+ * @example
+ * ```ts
+ * const params: NexusImpactParams = { symbol: 'entryPoint', depth: 2 };
+ * const result = await nexusImpact('/workspace/project', params);
+ * ```
  * @task T1569
  */
-export declare function nexusImpact(symbol: string, _projectId?: string, why?: boolean): Promise<EngineResult<{
-    targetNodeId: string | null;
-    why: boolean;
-    affected: Array<{
-        nodeId: string;
-        label: string;
-        kind: string;
-        reasons: string[];
-    }>;
-    riskLevel: string;
-}>>;
+export declare function nexusImpact(projectRoot: string, params: NexusImpactParams): Promise<EngineResult<ImpactOperationResult>>;
 //# sourceMappingURL=impact.d.ts.map

package/dist/nexus/impact.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/nexus/impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AAIpF,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE7E,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,+BAA+B;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,cAAc,EAAE,OAAO,CAAC;IACxB,iCAAiC;IACjC,SAAS,EAAE,cAAc,CAAC;IAC1B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAC;IACb,+BAA+B;IAC/B,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAsK5B;AAMD;;;;;;;GAOG;AAEH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EAGd,UAAU,CAAC,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,OAAO,GACZ,OAAO,CACR,YAAY,CAAC;IACX,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACpF,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CACH,CA0JA"}
+{"version":3,"file":"impact.d.ts","sourceRoot":"","sources":["../../src/nexus/impact.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,iBAAiB,IAAI,qBAAqB,EAC1C,iBAAiB,EACjB,iBAAiB,EACjB,QAAQ,EACT,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,KAAK,YAAY,EAA8B,MAAM,qBAAqB,CAAC;AASpF,wDAAwD;AACxD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEtC,mDAAmD;AACnD,MAAM,WAAW,eAAe;IAC9B,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,2CAA2C;AAC3C,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,mDAAmD;AACnD,MAAM,WAAW,iBAAiB;IAChC,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+BAA+B;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iCAAiC;IACjC,SAAS,EAAE,cAAc,CAAC;IAC1B,yCAAyC;IACzC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,OAAO,CAAC;IACb,+BAA+B;IAC/B,aAAa,EAAE,gBAAgB,EAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CA4J5B;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,WAAW,CAC/B,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC,CAAC,CAkC9C"}