@warpgogol/forge 2.1.0 → 2.2.0

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

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

package/dist/src/index.d.ts

@@ -0,0 +1,36 @@
+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

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

package/dist/src/index.js

@@ -0,0 +1,56 @@
+/*
+<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

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

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

@@ -0,0 +1,38 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,157 @@
+/*
+<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

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

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

@@ -0,0 +1,47 @@
+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

@@ -0,0 +1 @@
+{"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"}