@cluesmith/codev 3.0.0-rc.0 → 3.0.0-rc.10

package/dist/lib/config.js

@@ -0,0 +1,165 @@
+/**
+ * Unified configuration loader for Codev.
+ *
+ * Loads and merges config from three layers (lowest → highest priority):
+ *   1. Hardcoded defaults
+ *   2. ~/.codev/config.json  (global)
+ *   3. .codev/config.json    (project)
+ *
+ * af-config.json is no longer supported — its presence triggers a hard error
+ * directing the user to run `codev update` to migrate.
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { getFrameworkCacheDir as _getFrameworkCacheDir } from './skeleton.js';
+import { validateCustomHarnessConfig } from '../agent-farm/utils/harness.js';
+// ---------------------------------------------------------------------------
+// Defaults
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    shell: {
+        architect: 'claude',
+        builder: 'claude',
+        shell: 'bash',
+    },
+    porch: {
+        consultation: {
+            models: ['gemini', 'codex', 'claude'],
+        },
+    },
+    framework: {
+        source: 'local',
+    },
+};
+// ---------------------------------------------------------------------------
+// Deep merge
+// ---------------------------------------------------------------------------
+/**
+ * Deep-merge `override` into `base`.
+ *
+ * Semantics (per spec):
+ *  - Objects: recursively merged.
+ *  - Arrays: replaced, not concatenated.
+ *  - null value: deletes the key from the result.
+ */
+export function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        const overrideVal = override[key];
+        // null means "delete this key"
+        if (overrideVal === null) {
+            delete result[key];
+            continue;
+        }
+        const baseVal = result[key];
+        // Both objects (and not arrays) → recurse
+        if (typeof baseVal === 'object' && baseVal !== null && !Array.isArray(baseVal) &&
+            typeof overrideVal === 'object' && overrideVal !== null && !Array.isArray(overrideVal)) {
+            result[key] = deepMerge(baseVal, overrideVal);
+            continue;
+        }
+        // Everything else (arrays, primitives): replace
+        result[key] = overrideVal;
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// File reading helpers
+// ---------------------------------------------------------------------------
+function readJsonFile(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    let content;
+    try {
+        content = readFileSync(filePath, 'utf-8');
+    }
+    catch (err) {
+        // Permission errors: warn and fall back to defaults (per spec)
+        const code = err.code;
+        if (code === 'EACCES' || code === 'EPERM') {
+            console.warn(`Warning: Cannot read ${filePath} (${code}). Using defaults.`);
+            return null;
+        }
+        throw err;
+    }
+    try {
+        const parsed = JSON.parse(content);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new Error(`Expected a JSON object, got ${Array.isArray(parsed) ? 'array' : typeof parsed}`);
+        }
+        return parsed;
+    }
+    catch (err) {
+        throw new Error(`Failed to parse ${filePath}: ${err.message}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the project-level config path.
+ *
+ * Returns .codev/config.json if it exists, otherwise null.
+ * Hard error if legacy af-config.json is detected — user must run
+ * `codev update` to migrate.
+ */
+export function resolveProjectConfigPath(workspaceRoot) {
+    const newPath = resolve(workspaceRoot, '.codev', 'config.json');
+    const legacyPath = resolve(workspaceRoot, 'af-config.json');
+    if (existsSync(legacyPath)) {
+        throw new Error(`af-config.json is no longer supported. Run 'codev update' to migrate to .codev/config.json.`);
+    }
+    if (existsSync(newPath))
+        return newPath;
+    return null;
+}
+/**
+ * Load the full merged config for a workspace.
+ *
+ * Layer order (lowest → highest priority):
+ *   1. Hardcoded defaults
+ *   2. <cache>/config.json (remote framework base config)
+ *   3. ~/.codev/config.json (global)
+ *   4. .codev/config.json (project)
+ */
+export function loadConfig(workspaceRoot) {
+    let merged = structuredClone(DEFAULT_CONFIG);
+    // Layer 2: remote framework base config (if cached)
+    const cacheDir = _getFrameworkCacheDir();
+    if (cacheDir) {
+        const cacheConfigPath = resolve(cacheDir, 'config.json');
+        const cacheConfig = readJsonFile(cacheConfigPath);
+        if (cacheConfig) {
+            merged = deepMerge(merged, cacheConfig);
+        }
+    }
+    // Layer 3: global config
+    const globalPath = resolve(homedir(), '.codev', 'config.json');
+    const globalConfig = readJsonFile(globalPath);
+    if (globalConfig) {
+        merged = deepMerge(merged, globalConfig);
+    }
+    // Layer 4: project config (also checks for legacy af-config.json)
+    const projectPath = resolveProjectConfigPath(workspaceRoot);
+    if (projectPath) {
+        const projectConfig = readJsonFile(projectPath);
+        if (projectConfig) {
+            merged = deepMerge(merged, projectConfig);
+        }
+    }
+    // Validate custom harness definitions at load time
+    if (merged.harness) {
+        for (const [name, def] of Object.entries(merged.harness)) {
+            validateCustomHarnessConfig(name, def);
+        }
+    }
+    return merged;
+}
+/**
+ * Get the default config (useful for init/adopt to write a starter config).
+ */
+export function getDefaultConfig() {
+    return structuredClone(DEFAULT_CONFIG);
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

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

package/dist/lib/forge-contracts.d.ts

@@ -0,0 +1,100 @@
+/**
+ * TypeScript interfaces for forge concept command JSON output contracts.
+ *
+ * Default `gh`-based commands produce output conforming to these interfaces.
+ * Custom commands for other forges should match these shapes where possible.
+ *
+ * **Provider presets (gitlab, gitea) are best-effort.** Their CLI tools may
+ * output different schemas than GitHub's. Consumers that parse concept output
+ * must handle `null` returns gracefully — a non-conforming response from a
+ * preset command is treated the same as a command failure.
+ *
+ * @see codev/specs/589-non-github-repository-support.md
+ */
+/** Output of the `issue-view` concept command. */
+export interface IssueViewResult {
+    title: string;
+    body: string;
+    state: string;
+    comments: Array<{
+        body: string;
+        createdAt: string;
+        author: {
+            login: string;
+        };
+    }>;
+}
+/** Single item in `issue-list` concept output. */
+export interface IssueListItem {
+    number: number;
+    title: string;
+    url: string;
+    labels: Array<{
+        name: string;
+    }>;
+    createdAt: string;
+    closedAt?: string;
+    author?: {
+        login: string;
+    };
+}
+/** Output of the `issue-list` concept command. */
+export type IssueListResult = IssueListItem[];
+/** Output of the `recently-closed` concept command. */
+export type RecentlyClosedResult = IssueListItem[];
+/** Output of the `issue-comment` concept command: exit code only, no JSON. */
+/** Single item in `pr-list` concept output. */
+export interface PrListItem {
+    number: number;
+    title: string;
+    url: string;
+    reviewDecision: string;
+    body: string;
+    createdAt: string;
+    mergedAt?: string;
+    author?: {
+        login: string;
+    };
+}
+/** Output of the `pr-list` concept command. */
+export type PrListResult = PrListItem[];
+/** Output of the `pr-exists` concept command: JSON boolean on stdout. */
+/** Single item in `recently-merged` concept output. */
+export interface MergedPrItem {
+    number: number;
+    title: string;
+    url?: string;
+    body: string;
+    createdAt: string;
+    mergedAt: string;
+    headRefName: string;
+}
+/** Output of the `recently-merged` concept command. */
+export type RecentlyMergedResult = MergedPrItem[];
+/** Single item in `pr-search` concept output. */
+export interface PrSearchItem {
+    number: number;
+    headRefName: string;
+}
+/** Output of the `pr-search` concept command. */
+export type PrSearchResult = PrSearchItem[];
+/** Output of the `pr-view` concept command. */
+export interface PrViewResult {
+    title: string;
+    body: string;
+    state: string;
+    author: {
+        login: string;
+    };
+    baseRefName: string;
+    headRefName: string;
+    additions: number;
+    deletions: number;
+}
+/** Output of the `pr-diff` concept command: raw diff text, not JSON. */
+/** Output of the `pr-merge` concept command: exit code only, no JSON. */
+/** Output of the `user-identity` concept command: plain string (username). */
+/** Output of the `team-activity` concept command: raw GraphQL response. */
+/** Output of the `on-it-timestamps` concept command: raw GraphQL response. */
+/** Output of the `auth-status` concept command: exit code only. */
+//# sourceMappingURL=forge-contracts.d.ts.map

package/dist/lib/forge-contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-contracts.d.ts","sourceRoot":"","sources":["../../src/lib/forge-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,kDAAkD;AAClD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,aAAa,EAAE,CAAC;AAE9C,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,aAAa,EAAE,CAAC;AAEnD,8EAA8E;AAO9E,+CAA+C;AAC/C,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B;AAED,+CAA+C;AAC/C,MAAM,MAAM,YAAY,GAAG,UAAU,EAAE,CAAC;AAExC,yEAAyE;AAGzE,uDAAuD;AACvD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,uDAAuD;AACvD,MAAM,MAAM,oBAAoB,GAAG,YAAY,EAAE,CAAC;AAElD,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,iDAAiD;AACjD,MAAM,MAAM,cAAc,GAAG,YAAY,EAAE,CAAC;AAE5C,+CAA+C;AAC/C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AAGxE,yEAAyE;AAOzE,8EAA8E;AAG9E,2EAA2E;AAI3E,8EAA8E;AAQ9E,mEAAmE"}

package/dist/lib/forge-contracts.js

@@ -0,0 +1,35 @@
+/**
+ * TypeScript interfaces for forge concept command JSON output contracts.
+ *
+ * Default `gh`-based commands produce output conforming to these interfaces.
+ * Custom commands for other forges should match these shapes where possible.
+ *
+ * **Provider presets (gitlab, gitea) are best-effort.** Their CLI tools may
+ * output different schemas than GitHub's. Consumers that parse concept output
+ * must handle `null` returns gracefully — a non-conforming response from a
+ * preset command is treated the same as a command failure.
+ *
+ * @see codev/specs/589-non-github-repository-support.md
+ */
+export {};
+/** Output of the `pr-diff` concept command: raw diff text, not JSON. */
+// Returns diff text on stdout. Use `raw: true` option.
+/** Output of the `pr-merge` concept command: exit code only, no JSON. */
+// No interface needed — success is determined by exit code 0.
+// =============================================================================
+// Identity & team concepts
+// =============================================================================
+/** Output of the `user-identity` concept command: plain string (username). */
+// Returns username string on stdout. Not JSON.
+/** Output of the `team-activity` concept command: raw GraphQL response. */
+// Returns the raw GraphQL JSON response. Codev handles parsing via
+// parseTeamGraphQLResponse in team-github.ts.
+/** Output of the `on-it-timestamps` concept command: raw GraphQL response. */
+// Returns the raw GraphQL JSON response. Codev handles parsing to extract
+// "On it!" comment timestamps per issue.
+// =============================================================================
+// Auth concepts
+// =============================================================================
+/** Output of the `auth-status` concept command: exit code only. */
+// Exit code 0 = authenticated, non-zero = not authenticated.
+//# sourceMappingURL=forge-contracts.js.map

package/dist/lib/forge-contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-contracts.js","sourceRoot":"","sources":["../../src/lib/forge-contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;;AA+FH,wEAAwE;AACxE,uDAAuD;AAEvD,yEAAyE;AACzE,8DAA8D;AAE9D,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,8EAA8E;AAC9E,+CAA+C;AAE/C,2EAA2E;AAC3E,mEAAmE;AACnE,8CAA8C;AAE9C,8EAA8E;AAC9E,0EAA0E;AAC1E,yCAAyC;AAEzC,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAEhF,mEAAmE;AACnE,6DAA6D"}

package/dist/lib/forge.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Forge concept command dispatcher.
+ *
+ * Routes forge operations (issue fetch, PR list, etc.) through configurable
+ * external commands. Default commands wrap the `gh` CLI for GitHub repos.
+ * Projects override commands via the `forge` section in .codev/config.json.
+ *
+ * Concept commands are executed via shell (`sh -c`) to support pipes,
+ * redirects, and variable expansion in user-configured commands.
+ * Environment variables (CODEV_*) are set before invocation.
+ *
+ * @see codev/specs/589-non-github-repository-support.md
+ */
+/** Forge config from .codev/config.json `forge` section (concept overrides + optional provider). */
+export type ForgeConfig = Record<string, string | null> & {
+    provider?: string;
+};
+/** Options for forge command execution. */
+export interface ForgeCommandOptions {
+    /** Working directory for command execution. */
+    cwd?: string;
+    /** Workspace root for loading .codev/config.json (only used if forgeConfig not provided). */
+    workspaceRoot?: string;
+    /** Pre-loaded forge config. Avoids repeated .codev/config.json reads. */
+    forgeConfig?: ForgeConfig | null;
+    /** If true, return stdout as raw string instead of parsing as JSON. */
+    raw?: boolean;
+    /** Maximum stdout buffer size in bytes. Defaults to 10MB. */
+    maxBuffer?: number;
+}
+/** Get known provider names. */
+export declare function getKnownProviders(): string[];
+/** Resolution source for a concept command. */
+export type ConceptSource = 'override' | 'preset' | 'default' | 'disabled';
+export interface ConceptResolution {
+    concept: string;
+    command: string | null;
+    source: ConceptSource;
+    executable: string | null;
+}
+/**
+ * Resolve all 15 concepts with their source and executable.
+ * Used by `codev doctor` for full concept reporting.
+ */
+export declare function resolveAllConcepts(forgeConfig?: ForgeConfig | null): ConceptResolution[];
+/**
+ * Load forge configuration from .codev/config.json (via unified config loader).
+ * Returns the forge section or null if not configured.
+ *
+ * Prefer passing forge config directly via ForgeCommandOptions.forgeConfig
+ * when config is already loaded (e.g., from loadConfig in lib/config.ts).
+ */
+export declare function loadForgeConfig(workspaceRoot: string): ForgeConfig | null;
+/**
+ * Get the command string for a concept.
+ * Resolution order: manual concept override > provider preset > default (github).
+ * Returns null if concept is explicitly disabled (set to null in config).
+ */
+export declare function getForgeCommand(concept: string, forgeConfig?: ForgeConfig | null): string | null;
+/**
+ * Check if a concept is explicitly disabled (set to null in config).
+ */
+export declare function isConceptDisabled(concept: string, forgeConfig?: ForgeConfig | null): boolean;
+/**
+ * Execute a forge concept command asynchronously.
+ *
+ * Sets CODEV_* environment variables, executes the configured command
+ * via shell, and parses stdout as JSON. Returns null on failure.
+ *
+ * @param concept - The concept name (e.g., 'issue-view', 'pr-list')
+ * @param env - Additional environment variables to set (CODEV_* prefix recommended)
+ * @param options - Execution options
+ * @returns Parsed JSON from stdout, raw string for non-JSON concepts, or null on failure
+ */
+export declare function executeForgeCommand(concept: string, env?: Record<string, string>, options?: ForgeCommandOptions): Promise<unknown | null>;
+/**
+ * Execute a forge concept command synchronously.
+ *
+ * Same as executeForgeCommand but blocks until completion.
+ * Use sparingly — prefer the async variant.
+ */
+export declare function executeForgeCommandSync(concept: string, env?: Record<string, string>, options?: ForgeCommandOptions): unknown | null;
+/**
+ * Get the list of all known concept names.
+ */
+export declare function getKnownConcepts(): string[];
+/**
+ * Get the default command for a concept (ignoring user config).
+ * Useful for documentation and doctor checks.
+ */
+export declare function getDefaultCommand(concept: string): string | null;
+/**
+ * Validate forge configuration.
+ * Returns an array of diagnostic messages.
+ * Used by `codev doctor`.
+ */
+export declare function validateForgeConfig(forgeConfig: ForgeConfig): {
+    concept: string;
+    status: 'ok' | 'disabled' | 'unknown_concept' | 'empty_command' | 'provider';
+    message: string;
+}[];
+//# sourceMappingURL=forge.d.ts.map

package/dist/lib/forge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge.d.ts","sourceRoot":"","sources":["../../src/lib/forge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA8BH,oGAAoG;AACpG,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,2CAA2C;AAC3C,MAAM,WAAW,mBAAmB;IAClC,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,6FAA6F;IAC7F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,uEAAuE;IACvE,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6ED,gCAAgC;AAChC,wBAAgB,iBAAiB,IAAI,MAAM,EAAE,CAE5C;AAED,+CAA+C;AAC/C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE3E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,iBAAiB,EAAE,CA4BxF;AAmDD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAGzE;AAUD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC/B,MAAM,GAAG,IAAI,CAgBf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,WAAW,GAAG,IAAI,GAC/B,OAAO,CAGT;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAqBzB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,GAAG,IAAI,CAuBhB;AAmCD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAE3C;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEhE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,WAAW,GACvB;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,IAAI,GAAG,UAAU,GAAG,iBAAiB,GAAG,eAAe,GAAG,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CA2BtH"}