@warpgogol/forge 1.2.2 → 2.1.0

package/dist/src/forge-module.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"forge-module.js","sourceRoot":"","sources":["../../src/forge-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;EAYE"}

package/dist/src/index.d.ts

@@ -1,36 +0,0 @@
-export type { ForgeCommandInput, ForgeCommandResult, ForgeCommandTiming, ForgeNextStep, ForgeFlagValue, ForgeFlagSpec, ForgeCommandMetadata, ForgeRegisteredCommandInfo, ForgeCommandDefinition, ForgeCommandScope, Diagnostic, DiagnosticSeverity, DiagnosticEvidence, CheckResult, ForgeLogger, CommandRegistry, ForgeRuntimeContext, ForgeSiteContext, ForgeOutputFormat, GateMetadata, GateSeverity, GatePhase, GateConditional, } from "./types.ts";
-export { writeFileAtomic, type WriteFileAtomicOptions, GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, type GeneratedHeaderInput, type StripGeneratedMarkerResult, toKebabCase, collectFiles, fileExists, type CollectFilesOptions, byteHash, } from "./utils/index.ts";
-export type { ForgeModule, ForgeModuleRegistry, ForgePipelineStep } from "./forge-module.ts";
-export { skillFrontmatterSchema, type SkillFrontmatter } from "./skill-schema.ts";
-export { FORGE_SKILLS, type ForgeSkillEntry } from "./registry.ts";
-export { forgeConfigSchema, forgeBindingsSchema, defaultForgeConfig, loadForgeConfig, resolveForgeRoot, resolveBinding, resolveTerminology, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults, resolvePackageManager, type ForgeConfig, type ForgeBindings, type ForgeCliBindingDefault, type ForgePackageManager, type ForgeMigrationAdapter, } from "./config/forge-config.ts";
-export { stackProfileSchema, loadStackProfile, listStackProfiles, detectStack, type StackProfile, type ProfileFile, } from "./profiles/stack-profile.ts";
-export { stackProfileDomainFieldsSchema, profileArtifactSchema, profileWorkspaceTypeSchema, profileInvariantSchema, UNIVERSAL_TERMINOLOGY_KEYS, TERMINOLOGY_DEFAULTS, type StackProfileDomainFields, type ProfileArtifact, type ProfileWorkspaceType, type ProfileInvariant, } from "./profiles/profile-schema.ts";
-export { parseKnowledgeFile, serializeKnowledgeFile, knowledgeEntryMetaSchema, type KnowledgeLayer, type KnowledgeEntryStatus, type KnowledgeEntryMeta, type KnowledgeEntry, type LegacySection, type ParseIssue, type ParsedKnowledgeFile, } from "./knowledge/index.ts";
-export { runSkillValidate } from "./validators/skill-validate.ts";
-export { runPortValidate } from "./validators/port-validate.ts";
-export { renderNextSteps, renderIdeRecommendation, generateHelp } from "./cli-output.ts";
-export { runInit } from "./onboarding/init.ts";
-export { runScaffold } from "./onboarding/scaffold.ts";
-export { runDoctor } from "./onboarding/doctor.ts";
-export { runAgentsGenerate } from "./onboarding/agents-generate.ts";
-export { runScaffoldProject } from "./onboarding/scaffold-project.ts";
-export { scaffoldMemoryLayer, type MemoryScaffoldResult } from "./onboarding/memory-scaffold.ts";
-export type { MigrationAdapter, AdapterAnalysis, MigrationResult, Conflict, } from "./migration-adapters/types.ts";
-export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./migration-adapters/types.ts";
-export { nodeTypescriptPnpmAdapter, phaserPnpmAdapter, getAdapters, detectAdapter, detectAdapters, } from "./migration-adapters/index.ts";
-export { forgeCoreModule } from "../os/core/core.module.ts";
-export { forgeRfcModule } from "../os/rfc/rfc.module.ts";
-export { forgeWorkflowModule } from "../os/workflow/workflow.module.ts";
-export { forgeNamingModule } from "../os/naming/naming.module.ts";
-export { forgeCompassModule } from "../os/compass/compass.module.ts";
-export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.ts";
-export { forgeSpecModule } from "../os/spec/spec.module.ts";
-export { forgeAdrModule } from "../os/adr/adr.module.ts";
-export { forgePlanModule } from "../os/plan/plan.module.ts";
-export { forgeAuditModule } from "../os/audit/audit.module.ts";
-export { forgeMissionModule } from "../os/mission/mission.module.ts";
-export { forgeExplorationModule } from "../os/exploration/exploration.module.ts";
-export { forgeNotesModule } from "../os/notes/notes.module.ts";
-export { forgeProgramModule } from "../os/program/program.module.ts";
-//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

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

package/dist/src/index.js

@@ -1,56 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Public entrypoint for @warpgogol/forge — exports ForgeModule types, canonical types, utilities, skill schema, registry, validators, onboarding, and OS modules.</purpose>
-<non-goals>
-  <item>Do not export internal implementation details — only public API.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0374: initial public exports for forge package.</item>
-  <item>Forge autonomy refactor: add canonical types and utils exports.</item>
-</CHANGE_SUMMARY>
-*/
-// Canonical utilities
-export { writeFileAtomic, GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, toKebabCase, collectFiles, fileExists, byteHash, } from "./utils/index.js";
-// Skill schema
-export { skillFrontmatterSchema } from "./skill-schema.js";
-// Skill registry
-export { FORGE_SKILLS } from "./registry.js";
-// Forge config (RFC-0391)
-export { forgeConfigSchema, forgeBindingsSchema, defaultForgeConfig, loadForgeConfig, resolveForgeRoot, resolveBinding, resolveTerminology, FORGE_CLI_BINDING_DEFAULTS, PM_RUNNER_MAP, resolvePmRunner, applyCliBindingDefaults, resolvePackageManager, } from "./config/forge-config.js";
-// Stack profiles (RFC-0392, RFC-0638)
-export { stackProfileSchema, loadStackProfile, listStackProfiles, detectStack, } from "./profiles/stack-profile.js";
-// Profile domain fields (RFC-0638)
-export { stackProfileDomainFieldsSchema, profileArtifactSchema, profileWorkspaceTypeSchema, profileInvariantSchema, UNIVERSAL_TERMINOLOGY_KEYS, TERMINOLOGY_DEFAULTS, } from "./profiles/profile-schema.js";
-// Knowledge module (RFC-0660)
-export { parseKnowledgeFile, serializeKnowledgeFile, knowledgeEntryMetaSchema, } from "./knowledge/index.js";
-// Validators
-export { runSkillValidate } from "./validators/skill-validate.js";
-export { runPortValidate } from "./validators/port-validate.js";
-// CLI output rendering (RFC-0542)
-export { renderNextSteps, renderIdeRecommendation, generateHelp } from "./cli-output.js";
-// Onboarding
-export { runInit } from "./onboarding/init.js";
-export { runScaffold } from "./onboarding/scaffold.js";
-export { runDoctor } from "./onboarding/doctor.js";
-export { runAgentsGenerate } from "./onboarding/agents-generate.js";
-export { runScaffoldProject } from "./onboarding/scaffold-project.js";
-export { scaffoldMemoryLayer } from "./onboarding/memory-scaffold.js";
-export { FORGE_PROTECTED_PATHS, DEFAULT_EXCLUDE_PATTERNS } from "./migration-adapters/types.js";
-export { nodeTypescriptPnpmAdapter, phaserPnpmAdapter, getAdapters, detectAdapter, detectAdapters, } from "./migration-adapters/index.js";
-// OS modules
-export { forgeCoreModule } from "../os/core/core.module.js";
-export { forgeRfcModule } from "../os/rfc/rfc.module.js";
-export { forgeWorkflowModule } from "../os/workflow/workflow.module.js";
-export { forgeNamingModule } from "../os/naming/naming.module.js";
-export { forgeCompassModule } from "../os/compass/compass.module.js";
-export { forgeWerkstattModule } from "../os/werkstatt/werkstatt.module.js";
-export { forgeSpecModule } from "../os/spec/spec.module.js";
-export { forgeAdrModule } from "../os/adr/adr.module.js";
-export { forgePlanModule } from "../os/plan/plan.module.js";
-export { forgeAuditModule } from "../os/audit/audit.module.js";
-export { forgeMissionModule } from "../os/mission/mission.module.js";
-export { forgeExplorationModule } from "../os/exploration/exploration.module.js";
-export { forgeNotesModule } from "../os/notes/notes.module.js";
-export { forgeProgramModule } from "../os/program/program.module.js";
-//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/knowledge/budgets.d.ts

@@ -1,38 +0,0 @@
-import type { ParsedKnowledgeFile, KnowledgeLayer } from "./schema.ts";
-export interface KnowledgeBudgets {
-    hot: number;
-    warm: number;
-}
-export interface LayerBudgetReport {
-    skill: string;
-    file: string;
-    layer: KnowledgeLayer;
-    activeChars: number;
-    budget: number;
-    exceededBy: number;
-    pack?: string;
-}
-export declare const DEFAULT_KNOWLEDGE_BUDGETS: KnowledgeBudgets;
-/**
- * Compute per-file budget reports for parsed knowledge files.
- *
- * - Counts only `status: active` entries (heading + metadata block + body).
- * - Uses `ParsedKnowledgeFile.layer` to determine which budget applies.
- * - Skips files with undeterminable layer (null) or L0 (cold, no budget).
- * - Skips files with parse issues (schema errors are already reported by SKILL-19).
- *
- * Pure: no filesystem side effects.
- */
-export declare function computeLayerBudgets(files: ParsedKnowledgeFile[], budgets: KnowledgeBudgets, skillNames: Map<string, string>): LayerBudgetReport[];
-/**
- * Read effective knowledge budgets from forge.yaml bindings.
- *
- * Falls back to defaults (hot: 4096, warm: 8192) when:
- * - forge.yaml is not found
- * - bindings.knowledge.budgets is absent
- * - override values are invalid (non-positive, non-integer)
- *
- * Does NOT validate the override shape — forge.doctor handles that separately.
- */
-export declare function resolveKnowledgeBudgets(workspaceRoot: string): KnowledgeBudgets;
-//# sourceMappingURL=budgets.d.ts.map

package/dist/src/knowledge/budgets.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"budgets.d.ts","sourceRoot":"","sources":["../../../src/knowledge/budgets.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAMvE,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,cAAc,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAMD,eAAO,MAAM,yBAAyB,EAAE,gBAGvC,CAAC;AAMF;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,gBAAgB,EACzB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,iBAAiB,EAAE,CA0DrB;AAMD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,gBAAgB,CA0B/E"}

package/dist/src/knowledge/budgets.js

@@ -1,157 +0,0 @@
-/*
-<MODULE_CONTRACT>
-<purpose>Knowledge layer character budget computation and resolution — pure functions for hot/warm budget enforcement (RFC-0661).</purpose>
-<non-goals>
-  <item>Do not emit warnings or violations — that is handled by SKILL-21 in skill-validate.ts.</item>
-  <item>Do not parse knowledge files — that is handled by parse.ts (RFC-0660).</item>
-  <item>Do not validate budget override shape — that is handled by forge.doctor.</item>
-</non-goals>
-</MODULE_CONTRACT>
-<CHANGE_SUMMARY>
-  <item>RFC-0661: initial budget module with KnowledgeBudgets, LayerBudgetReport, computeLayerBudgets, resolveKnowledgeBudgets.</item>
-</CHANGE_SUMMARY>
-*/
-import path from "node:path";
-import { readFileSync } from "node:fs";
-import { parse as parseYaml } from "yaml";
-// ---------------------------------------------------------------------------
-// Defaults
-// ---------------------------------------------------------------------------
-export const DEFAULT_KNOWLEDGE_BUDGETS = {
-    hot: 4096,
-    warm: 8192,
-};
-// ---------------------------------------------------------------------------
-// computeLayerBudgets — pure function
-// ---------------------------------------------------------------------------
-/**
- * Compute per-file budget reports for parsed knowledge files.
- *
- * - Counts only `status: active` entries (heading + metadata block + body).
- * - Uses `ParsedKnowledgeFile.layer` to determine which budget applies.
- * - Skips files with undeterminable layer (null) or L0 (cold, no budget).
- * - Skips files with parse issues (schema errors are already reported by SKILL-19).
- *
- * Pure: no filesystem side effects.
- */
-export function computeLayerBudgets(files, budgets, skillNames) {
-    const reports = [];
-    for (const file of files) {
-        // Skip files with undeterminable layer
-        if (file.layer === null) {
-            continue;
-        }
-        // Skip cold layer (L0) — no budget by design
-        if (file.layer === "L0") {
-            continue;
-        }
-        // Skip files with parse issues — SKILL-19 already reports those
-        if (file.parseIssues.length > 0) {
-            continue;
-        }
-        // Skip knowledge-adjacent files (no structured entries)
-        if (file.isKnowledgeAdjacent) {
-            continue;
-        }
-        const budget = file.layer === "L2" ? budgets.hot : budgets.warm;
-        const fileName = path.basename(file.path);
-        const skillName = skillNames.get(file.path) ?? path.basename(path.dirname(file.path));
-        // Count only active entries: heading + metadata block + body
-        let activeChars = 0;
-        for (const entry of file.entries) {
-            if (entry.meta.status !== "active") {
-                continue;
-            }
-            // Heading: "### K-XXXX: <title>\n"
-            activeChars += `### ${entry.meta.id}: ${entry.title}\n`.length;
-            // Metadata block: ```knowledge-entry\n<yaml>\n```\n
-            const metaYaml = approximateMetaCharCount(entry.meta);
-            activeChars += "```knowledge-entry\n".length;
-            activeChars += metaYaml.length;
-            activeChars += "```\n".length;
-            // Body
-            activeChars += entry.body.length;
-        }
-        const exceededBy = Math.max(0, activeChars - budget);
-        reports.push({
-            skill: skillName,
-            file: fileName,
-            layer: file.layer,
-            activeChars,
-            budget,
-            exceededBy,
-        });
-    }
-    return reports;
-}
-// ---------------------------------------------------------------------------
-// resolveKnowledgeBudgets — reads forge.yaml
-// ---------------------------------------------------------------------------
-/**
- * Read effective knowledge budgets from forge.yaml bindings.
- *
- * Falls back to defaults (hot: 4096, warm: 8192) when:
- * - forge.yaml is not found
- * - bindings.knowledge.budgets is absent
- * - override values are invalid (non-positive, non-integer)
- *
- * Does NOT validate the override shape — forge.doctor handles that separately.
- */
-export function resolveKnowledgeBudgets(workspaceRoot) {
-    try {
-        const forgeYamlPath = path.join(workspaceRoot, "forge.yaml");
-        const content = readFileSync(forgeYamlPath, "utf8");
-        const config = parseYaml(content);
-        const bindings = config?.bindings;
-        const knowledge = bindings?.knowledge;
-        const budgets = knowledge?.budgets;
-        if (!budgets) {
-            return { ...DEFAULT_KNOWLEDGE_BUDGETS };
-        }
-        const hot = typeof budgets.hot === "number" && budgets.hot > 0 && Number.isInteger(budgets.hot)
-            ? budgets.hot
-            : DEFAULT_KNOWLEDGE_BUDGETS.hot;
-        const warm = typeof budgets.warm === "number" && budgets.warm > 0 && Number.isInteger(budgets.warm)
-            ? budgets.warm
-            : DEFAULT_KNOWLEDGE_BUDGETS.warm;
-        return { hot, warm };
-    }
-    catch {
-        return { ...DEFAULT_KNOWLEDGE_BUDGETS };
-    }
-}
-// ---------------------------------------------------------------------------
-// Helper: approximate metadata character count for budget measurement
-// ---------------------------------------------------------------------------
-/**
- * Approximate metadata character count for budget purposes.
- *
- * This is NOT exact YAML serialization — it produces a line-per-field
- * approximation that is deterministic and sufficient for character budget
- * measurement. The RFC explicitly rejects tokenizer-accurate measurement;
- * this approximation is the documented proxy.
- */
-function approximateMetaCharCount(meta) {
-    const lines = [];
-    lines.push(`id: ${meta.id}`);
-    lines.push(`layer: ${meta.layer}`);
-    lines.push(`created: ${meta.created}`);
-    if (meta.lastConfirmedAt !== undefined) {
-        lines.push(`lastConfirmedAt: ${meta.lastConfirmedAt ?? "null"}`);
-    }
-    if (meta.confirmations !== undefined) {
-        lines.push(`confirmations: ${meta.confirmations}`);
-    }
-    if (meta.expiresAt !== undefined) {
-        lines.push(`expiresAt: ${meta.expiresAt ?? "null"}`);
-    }
-    if (meta.supersedes !== undefined) {
-        lines.push(`supersedes: [${meta.supersedes.join(", ")}]`);
-    }
-    if (meta.promotedTo !== undefined) {
-        lines.push(`promotedTo: ${meta.promotedTo ?? "null"}`);
-    }
-    lines.push(`status: ${meta.status}`);
-    return lines.join("\n") + "\n";
-}
-//# sourceMappingURL=budgets.js.map

package/dist/src/knowledge/budgets.js.map

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

package/dist/src/knowledge/compact.d.ts

@@ -1,47 +0,0 @@
-import type { ParsedKnowledgeFile } from "./schema.ts";
-export interface CompactOptions {
-    retentionDays: number;
-    staleDays: number;
-    today: string;
-}
-export type CompactActionKind = "archive-expired" | "archive-superseded" | "archive-l0-retention" | "mark-stale";
-export interface CompactAction {
-    kind: CompactActionKind;
-    file: string;
-    entryId: string;
-    reason: string;
-}
-export interface CompactFilePlan {
-    file: string;
-    archiveFile: string;
-    actions: CompactAction[];
-    legacySectionCount: number;
-}
-export interface CompactFileResult {
-    file: string;
-    archiveFile: string;
-    actions: CompactAction[];
-    legacySectionCount: number;
-    archived: number;
-    markedStale: number;
-    written: boolean;
-}
-export interface CompactReport {
-    command: string;
-    status: "pass" | "fail";
-    dryRun: boolean;
-    files: CompactFileResult[];
-    totals: {
-        archived: number;
-        markedStale: number;
-        legacyFiles: number;
-    };
-    errors?: string[];
-}
-export declare const DEFAULT_RETENTION_DAYS = 90;
-export declare const DEFAULT_STALE_DAYS = 90;
-export declare function planCompaction(files: ParsedKnowledgeFile[], options: CompactOptions): CompactFilePlan[];
-export declare function executeCompaction(plans: CompactFilePlan[], dryRun: boolean): CompactReport;
-export declare function resolveRetentionDays(workspaceRoot: string): number;
-export declare function resolveStaleDays(workspaceRoot: string): number;
-//# sourceMappingURL=compact.d.ts.map

package/dist/src/knowledge/compact.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"compact.d.ts","sourceRoot":"","sources":["../../../src/knowledge/compact.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,mBAAmB,EAAsC,MAAM,aAAa,CAAC;AAQ3F,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,iBAAiB,GAC3B,iBAAiB,GAAG,oBAAoB,GAAG,sBAAsB,GAAG,YAAY,CAAC;AAEnF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAMD,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,eAAO,MAAM,kBAAkB,KAAK,CAAC;AA+BrC,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAAE,EAC5B,OAAO,EAAE,cAAc,GACtB,eAAe,EAAE,CA+EnB;AAMD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,OAAO,GAAG,aAAa,CA8K1F;AAMD,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAelE;AAED,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAe9D"}