@warpgogol/forge 0.3.1

package/dist/os/audit/handlers/archive.js

@@ -0,0 +1,167 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Audit archive handler — moves audit files whose parent RFC has terminal status
+into status-specific subdirectories under docs/audits/archive/ and moves
+non-terminal files found in subdirectories back to the root. Standalone audit
+files (not matching audit-rfc-XXXX-*) are silently excluded.
+</purpose>
+<non-goals>
+  <item>Does not validate audit content.</item>
+  <item>Does not change audit frontmatter — only moves files on disk.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: implement audit.archive command.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import path from "node:path";
+import { listAuditFiles, extractRfcIdFromAuditFile } from "../frontmatter-io.js";
+import { loadRfcStatusMap } from "../../rfc/frontmatter-io.js";
+import { AUDIT_DIR } from "../types.js";
+const TERMINAL_STATUSES = ["implemented", "rejected", "superseded"];
+export async function runAuditArchive(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    const auditDirPath = path.join(workspaceRoot, AUDIT_DIR);
+    const rfcDirPath = path.join(workspaceRoot, "docs", "rfcs");
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    const statusFilter = input.flags["status"];
+    if (statusFilter && !TERMINAL_STATUSES.includes(statusFilter)) {
+        throw new Error(`Invalid --status "${statusFilter}". Must be one of: ${TERMINAL_STATUSES.join(", ")}`);
+    }
+    const files = await listAuditFiles(auditDirPath);
+    const rfcStatusMap = await loadRfcStatusMap(rfcDirPath);
+    const moved = [];
+    const skipped = [];
+    for (const fileName of files) {
+        const rfcId = extractRfcIdFromAuditFile(fileName);
+        const relFile = path.join(AUDIT_DIR, fileName);
+        const basename = path.basename(fileName);
+        if (!rfcId) {
+            skipped.push({ id: "UNKNOWN", file: relFile, reason: "no RFC id in filename" });
+            continue;
+        }
+        const rfcStatus = rfcStatusMap.get(rfcId);
+        if (!rfcStatus) {
+            skipped.push({ id: rfcId, file: relFile, reason: "parent RFC not found" });
+            continue;
+        }
+        const isTerminal = rfcStatus === "implemented" || rfcStatus === "rejected" || rfcStatus === "superseded";
+        const isInArchive = fileName.includes("/");
+        if (statusFilter && rfcStatus !== statusFilter) {
+            skipped.push({
+                id: rfcId,
+                file: relFile,
+                reason: `parent RFC status ${rfcStatus} does not match --status ${statusFilter}`,
+            });
+            continue;
+        }
+        if (isTerminal && !isInArchive) {
+            const targetDir = path.join(auditDirPath, "archive", rfcStatus);
+            const targetPath = path.join(targetDir, basename);
+            const targetRel = path.join(AUDIT_DIR, "archive", rfcStatus, basename);
+            try {
+                await fs.access(targetPath);
+                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
+                continue;
+            }
+            catch {
+                // destination doesn't exist — proceed
+            }
+            if (!dryRun) {
+                await fs.mkdir(targetDir, { recursive: true });
+                try {
+                    await fs.rename(path.join(auditDirPath, fileName), targetPath);
+                }
+                catch (err) {
+                    if (err.code === "ENOENT") {
+                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+            moved.push({
+                id: rfcId,
+                file: targetRel,
+                status: rfcStatus,
+                from: relFile,
+                to: targetRel,
+                direction: "into-archive",
+            });
+        }
+        else if (!isTerminal && isInArchive) {
+            const targetPath = path.join(auditDirPath, basename);
+            const targetRel = path.join(AUDIT_DIR, basename);
+            try {
+                await fs.access(targetPath);
+                skipped.push({ id: rfcId, file: relFile, reason: "destination exists" });
+                continue;
+            }
+            catch {
+                // destination doesn't exist — proceed
+            }
+            if (!dryRun) {
+                try {
+                    await fs.rename(path.join(auditDirPath, fileName), targetPath);
+                }
+                catch (err) {
+                    if (err.code === "ENOENT") {
+                        skipped.push({ id: rfcId, file: relFile, reason: "already moved by another process" });
+                        continue;
+                    }
+                    throw err;
+                }
+            }
+            moved.push({
+                id: rfcId,
+                file: targetRel,
+                status: rfcStatus,
+                from: relFile,
+                to: targetRel,
+                direction: "out-of-archive",
+            });
+        }
+        else if (isTerminal && isInArchive) {
+            skipped.push({ id: rfcId, file: relFile, reason: `already archived (${rfcStatus})` });
+        }
+        else {
+            skipped.push({
+                id: rfcId,
+                file: relFile,
+                reason: `parent RFC status ${rfcStatus} is non-terminal`,
+            });
+        }
+    }
+    if (outputFormat === "pretty") {
+        if (dryRun) {
+            logger.info(`[dry-run] audit.archive: would move ${moved.length} file(s), skip ${skipped.length}`);
+        }
+        else {
+            logger.success(`audit.archive: moved ${moved.length} file(s), skipped ${skipped.length}`);
+        }
+        for (const m of moved) {
+            logger.info(`  ${m.direction}: ${m.id} (${m.status}) ${m.from} → ${m.to}`);
+        }
+    }
+    return {
+        data: {
+            command: "audit.archive",
+            status: "ok",
+            moved,
+            skipped,
+            dryRun,
+        },
+        summary: dryRun
+            ? `[dry-run] Would move ${moved.length} file(s), skip ${skipped.length}`
+            : `Moved ${moved.length} file(s), skipped ${skipped.length}`,
+        nextSteps: [
+            {
+                action: "Run: pnpm exec site-kernel run audit.list --json to verify archive status",
+                kind: "optional",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=archive.js.map

package/dist/os/audit/handlers/archive.js.map

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

package/dist/os/audit/index.d.ts

@@ -0,0 +1,6 @@
+export { forgeAuditModule } from "./audit.module.ts";
+export { runAuditArchive } from "./handlers/archive.ts";
+export { listAuditFiles, parseAuditFile, readAndParseAudit, extractRfcIdFromAuditFile, type ParsedAudit, } from "./frontmatter-io.ts";
+export type { AuditArchiveResult, AuditArchiveMove, AuditArchiveSkip } from "./types.ts";
+export { AUDIT_DIR, AUDIT_RFC_FILE_PATTERN } from "./types.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/os/audit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/audit/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,KAAK,WAAW,GACjB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/audit/index.js

@@ -0,0 +1,16 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Barrel export for the audit domain — types, module, and handlers.</purpose>
+<non-goals>
+  <item>Do not implement audit logic here; delegate to handlers/ and audit.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial audit module barrel.</item>
+</CHANGE_SUMMARY>
+*/
+export { forgeAuditModule } from "./audit.module.js";
+export { runAuditArchive } from "./handlers/archive.js";
+export { listAuditFiles, parseAuditFile, readAndParseAudit, extractRfcIdFromAuditFile, } from "./frontmatter-io.js";
+export { AUDIT_DIR, AUDIT_RFC_FILE_PATTERN } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/os/audit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/audit/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EACL,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,yBAAyB,GAE1B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC"}

package/dist/os/audit/types.d.ts

@@ -0,0 +1,12 @@
+import type { ArchiveMove, ArchiveSkip } from "../rfc/handlers/archive.ts";
+export declare const AUDIT_DIR = "docs/audits";
+export declare const AUDIT_RFC_FILE_PATTERN: RegExp;
+export interface AuditArchiveResult {
+    command: "audit.archive";
+    status: "ok";
+    moved: ArchiveMove[];
+    skipped: ArchiveSkip[];
+    dryRun: boolean;
+}
+export type { ArchiveMove as AuditArchiveMove, ArchiveSkip as AuditArchiveSkip };
+//# sourceMappingURL=types.d.ts.map

package/dist/os/audit/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../os/audit/types.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE3E,eAAO,MAAM,SAAS,gBAAgB,CAAC;AACvC,eAAO,MAAM,sBAAsB,QAAsB,CAAC;AAE1D,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,IAAI,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,YAAY,EAAE,WAAW,IAAI,gBAAgB,EAAE,WAAW,IAAI,gBAAgB,EAAE,CAAC"}

package/dist/os/audit/types.js

@@ -0,0 +1,17 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+Type definitions for the audit archive domain — audit file discovery, parsing,
+and archive result shapes.
+</purpose>
+<non-goals>
+  <item>Do not define archive handler logic here — that lives in handlers/archive.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0521: initial audit archive types.</item>
+</CHANGE_SUMMARY>
+*/
+export const AUDIT_DIR = "docs/audits";
+export const AUDIT_RFC_FILE_PATTERN = /^audit-rfc-\d{4}-/;
+//# sourceMappingURL=types.js.map

package/dist/os/audit/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../os/audit/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;EAaE;AAIF,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC;AACvC,MAAM,CAAC,MAAM,sBAAsB,GAAG,mBAAmB,CAAC"}

package/dist/os/compass/compass.module.d.ts

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare const forgeCompassModule: ForgeModule;
+//# sourceMappingURL=compass.module.d.ts.map

package/dist/os/compass/compass.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass.module.d.ts","sourceRoot":"","sources":["../../../os/compass/compass.module.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAyB7D,eAAO,MAAM,kBAAkB,EAAE,WA6IhC,CAAC"}

package/dist/os/compass/compass.module.js

@@ -0,0 +1,162 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the forge Compass command family against the Site OS kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement compass handler logic — delegate to handlers/ inlined by RFC-0556.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0374: initial forgeCompassModule registering 12 compass commands.</item>
+  <item>RFC-0538: renamed compass.changesummary.tidy to compass.summary.trim, removed compass.annotate, compass.clear, compass.markup.migrate, compass.invariant.add.</item>
+  <item>RFC-0556: removed dynamic import of @warpgogol/site-kernel-checks, all handlers now inlined in forge/os/compass/handlers/.</item>
+</CHANGE_SUMMARY>
+*/
+import { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.js";
+import { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, } from "./handlers/compass-audit-handler.js";
+import { runCompassChangeSummaryValidate, runCompassSummaryTrim, } from "./handlers/compass-change-summary-handler.js";
+const compassScanFlags = {
+    packages: {
+        kind: "boolean",
+        description: "Scan packages/ instead of the inferred app or default workspace scope.",
+    },
+    package: {
+        kind: "string",
+        description: "With --packages, scan one package by directory/name.",
+    },
+};
+export const forgeCompassModule = {
+    name: "forge-compass",
+    version: "0.1.0",
+    async register(registry) {
+        registry.registerCommand({
+            name: "compass.inventory",
+            description: "Generate the repository-wide Compass source inventory XML report.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: ["packages/**/*.{ts,tsx,md}", "apps/**/*.{ts,tsx,md}", "services/**/*.{ts,tsx,md}"],
+            execute: runCompassInventory,
+        });
+        registry.registerCommand({
+            name: "compass.validate",
+            description: "Validate authored source files against current Compass scaffolding requirements.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: [
+                "packages/**/*.{ts,tsx,md}",
+                "apps/**/*.{ts,tsx,md}",
+                "services/**/*.{ts,tsx,md}",
+                "docs/source-markup.xml",
+            ],
+            execute: runCompassValidation,
+        });
+        registry.registerCommand({
+            name: "compass.changesummary.validate",
+            description: "Validate CHANGE_SUMMARY blocks for boilerplate items and over-cap unprotected items (RFC-0349).",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: { ...compassScanFlags },
+            reads: ["packages/**/*.{ts,tsx,md}", "apps/**/*.{ts,tsx,md}", "services/**/*.{ts,tsx,md}"],
+            execute: runCompassChangeSummaryValidate,
+        });
+        registry.registerCommand({
+            name: "compass.summary.trim",
+            description: "Deterministically trim CHANGE_SUMMARY blocks: remove boilerplate, cap total items to 30, preserve protected items (RFC-0538).",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: [
+                "apps/**/*.{astro,ts,tsx,md}",
+                "packages/**/*.{astro,ts,tsx,md}",
+                "services/**/*.{ts,tsx,md}",
+            ],
+            reads: ["packages/**/*.{ts,tsx,md}", "apps/**/*.{ts,tsx,md}", "services/**/*.{ts,tsx,md}"],
+            cacheable: false,
+            flags: { ...compassScanFlags },
+            execute: runCompassSummaryTrim,
+        });
+        registry.registerCommand({
+            name: "compass.audit.plan",
+            description: "Emit a deterministic work-order of files whose revision has advanced past the threshold since their last Compass audit (RFC-0352). Read-only, no LLM.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: {
+                ...compassScanFlags,
+                threshold: {
+                    kind: "string",
+                    description: "Revision distance that makes a file audit-overdue.",
+                },
+            },
+            reads: [
+                "packages/**/*.{ts,tsx,md}",
+                "apps/**/*.{ts,tsx,md}",
+                "services/**/*.{ts,tsx,md}",
+                "docs/compass-audit-ledger.generated.yaml",
+            ],
+            execute: runCompassAuditPlan,
+        });
+        registry.registerCommand({
+            name: "compass.audit.record",
+            description: "Stamp a file's audit verdict and current revision into the compass-audit ledger (RFC-0352). Mutating.",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: ["docs/compass-audit-ledger.generated.yaml"],
+            reads: ["docs/compass-audit-ledger.generated.yaml"],
+            cacheable: false,
+            flags: {
+                file: { kind: "string", required: true, description: "Authored file path to stamp." },
+                verdict: {
+                    kind: "string",
+                    required: true,
+                    description: "Audit verdict: pass, repaired, or baseline.",
+                },
+                agent: { kind: "string", description: "Agent identity to record in the ledger." },
+            },
+            execute: runCompassAuditRecord,
+        });
+        registry.registerCommand({
+            name: "compass.audit.baseline",
+            description: "Seed the compass-audit ledger for every authored file at its current revision with verdict=baseline (RFC-0352). One-time bootstrap.",
+            scope: "workspace",
+            mutatesState: true,
+            supportsAllSites: true,
+            writes: ["docs/compass-audit-ledger.generated.yaml"],
+            reads: ["packages/**/*.{ts,tsx,md}", "apps/**/*.{ts,tsx,md}", "services/**/*.{ts,tsx,md}"],
+            cacheable: false,
+            flags: { ...compassScanFlags },
+            execute: runCompassAuditBaseline,
+        });
+        registry.registerCommand({
+            name: "compass.audit.validate",
+            description: "Validate that no authored file is audit-overdue per the revision threshold (RFC-0352). Warns by default, fails with --strict.",
+            scope: "workspace",
+            supportsAllSites: true,
+            flags: {
+                ...compassScanFlags,
+                strict: {
+                    kind: "boolean",
+                    description: "Fail when audit-overdue authored files are found.",
+                },
+            },
+            reads: [
+                "packages/**/*.{ts,tsx,md}",
+                "apps/**/*.{ts,tsx,md}",
+                "services/**/*.{ts,tsx,md}",
+                "docs/compass-audit-ledger.generated.yaml",
+            ],
+            execute: runCompassAuditValidate,
+            gate: {
+                severity: "mixed",
+                phase: "author",
+                conditional: {
+                    kind: "flag",
+                    ref: "--strict",
+                    description: "Warns by default, fails with --strict",
+                },
+            },
+        });
+    },
+};
+//# sourceMappingURL=compass.module.js.map

package/dist/os/compass/compass.module.js.map

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

package/dist/os/compass/handlers/compass-audit-handler.d.ts

@@ -0,0 +1,36 @@
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+interface CompassAuditWorkOrderItem {
+    path: string;
+    currentRevision: number;
+    auditedRevision: number | null;
+    reason: "never-audited" | "revision-threshold-crossed";
+    moduleContract: string;
+    changeSummary: string;
+}
+export declare function isAuditDue(current: number, audited: number | null, threshold: number): boolean;
+export declare function runCompassAuditPlan(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    threshold: number;
+    dueCount: number;
+    items: CompassAuditWorkOrderItem[];
+}>>;
+export declare function runCompassAuditRecord(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    path: string;
+    action: "recorded";
+}>>;
+export declare function runCompassAuditBaseline(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    seeded: number;
+    total: number;
+}>>;
+export declare function runCompassAuditValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    strict: boolean;
+    dueCount: number;
+    diagnostics: Array<{
+        ruleId: string;
+        severity: string;
+        file: string;
+        message: string;
+        fix: string;
+    }>;
+}>>;
+export {};
+//# sourceMappingURL=compass-audit-handler.d.ts.map

package/dist/os/compass/handlers/compass-audit-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-audit-handler.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-audit-handler.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA8B/B,UAAU,yBAAyB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,MAAM,EAAE,eAAe,GAAG,4BAA4B,CAAC;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAG9F;AAuDD,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,yBAAyB,EAAE,CAAC;CACpC,CAAC,CACH,CAoDA;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB,CAAC,CACH,CAuDA;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CACH,CA8CA;AAED,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ,CAAC,CACH,CAsDA"}