@warpgogol/forge 4.1.6 → 4.2.1

package/dist/os/spec/spec-validate.js

@@ -0,0 +1,438 @@
+/*
+<MODULE_CONTRACT>
+<purpose>spec.validate handler — validates vendored spec packages under docs/specs/ (RFC-0394).</purpose>
+<non-goals>
+  <item>Do not modify spec files — validate is read-only.</item>
+  <item>Do not implement materialization — that is RFC-0396.</item>
+  <item>Do not implement amendment validation — that is RFC-0397.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0394: initial spec.validate handler with SPEC-01..07 rules.</item>
+  <item>Gap fix: resolve materialized RFCs recursively so terminal RFC archival does not invalidate accepted specs.</item>
+</CHANGE_SUMMARY>
+*/
+import fs from "node:fs/promises";
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { parse as parseYaml } from "yaml";
+import { byteHash } from "../../src/utils/hash.js";
+import { collectFiles } from "../../src/utils/fs.js";
+import { loadForgeConfig } from "../../src/config/forge-config.js";
+import { listRfcFiles } from "../rfc/frontmatter-io.js";
+import { forgeSpecSchema, specIntegritySchema, specAmendmentSchema, } from "./spec-schema.js";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+async function readYaml(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf8");
+        return parseYaml(content);
+    }
+    catch {
+        return null;
+    }
+}
+async function listSpecDirs(specsDir) {
+    if (!existsSync(specsDir))
+        return [];
+    const entries = await fs.readdir(specsDir, { withFileTypes: true });
+    return entries.filter((e) => e.isDirectory()).map((e) => e.name);
+}
+async function listSnapshotFiles(specDir, exclude) {
+    const files = await collectFiles(specDir, {
+        ignore: (name) => exclude.has(name),
+    });
+    return files.map((abs) => path.relative(specDir, abs).replace(/\\/g, "/"));
+}
+// ---------------------------------------------------------------------------
+// SPEC-01: Integrity check
+// ---------------------------------------------------------------------------
+async function checkIntegrity(specDir, violations) {
+    const integrityPath = path.join(specDir, "integrity.yaml");
+    const integrity = await readYaml(integrityPath);
+    if (!integrity) {
+        violations.push({ rule: "SPEC-01", message: "integrity.yaml not found" });
+        return;
+    }
+    const parsed = specIntegritySchema.safeParse(integrity);
+    if (!parsed.success) {
+        violations.push({
+            rule: "SPEC-01",
+            message: `integrity.yaml schema violation: ${parsed.error.message}`,
+        });
+        return;
+    }
+    const manifest = parsed.data;
+    const exclude = new Set(["forge-spec.yaml", "integrity.yaml", "amendments"]);
+    for (const [relPath, expectedHash] of Object.entries(manifest.files)) {
+        const fullPath = path.join(specDir, relPath);
+        try {
+            const content = await fs.readFile(fullPath);
+            const actualHash = byteHash(content);
+            if (actualHash !== expectedHash) {
+                violations.push({
+                    rule: "SPEC-01",
+                    message: `integrity mismatch: ${relPath}`,
+                });
+            }
+        }
+        catch {
+            violations.push({
+                rule: "SPEC-01",
+                message: `file in manifest not found: ${relPath}`,
+            });
+        }
+    }
+    // Check for files in snapshot not in manifest
+    const snapshotFiles = await listSnapshotFiles(specDir, exclude);
+    for (const file of snapshotFiles) {
+        if (!(file in manifest.files)) {
+            violations.push({
+                rule: "SPEC-01",
+                message: `file not in integrity manifest: ${file}`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-02: Schema validation
+// ---------------------------------------------------------------------------
+function checkSchema(raw, violations) {
+    const parsed = forgeSpecSchema.safeParse(raw);
+    if (!parsed.success) {
+        violations.push({
+            rule: "SPEC-02",
+            message: `forge-spec.yaml schema violation: ${parsed.error.issues.map((i) => i.message).join("; ")}`,
+        });
+        return null;
+    }
+    return parsed.data;
+}
+// ---------------------------------------------------------------------------
+// SPEC-03: Dependency cycle detection
+// ---------------------------------------------------------------------------
+function checkCycles(spec, violations) {
+    const nodes = new Map();
+    for (const node of spec.rfcs) {
+        nodes.set(node.id, node.dependsOn);
+    }
+    const visited = new Set();
+    const stack = new Set();
+    function dfs(id, path) {
+        if (stack.has(id)) {
+            const cycle = [...path, id].join(" -> ");
+            violations.push({
+                rule: "SPEC-03",
+                message: `dependency cycle: ${cycle}`,
+            });
+            return true;
+        }
+        if (visited.has(id))
+            return false;
+        visited.add(id);
+        stack.add(id);
+        const deps = nodes.get(id) ?? [];
+        for (const dep of deps) {
+            if (dfs(dep, [...path, id]))
+                return true;
+        }
+        stack.delete(id);
+        return false;
+    }
+    for (const node of spec.rfcs) {
+        if (!visited.has(node.id)) {
+            dfs(node.id, []);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-04: Unresolvable references
+// ---------------------------------------------------------------------------
+function checkReferences(spec, violations) {
+    const nodeIds = new Set(spec.rfcs.map((n) => n.id));
+    const docNames = new Set(Object.keys(spec.documents));
+    for (const node of spec.rfcs) {
+        for (const dep of node.dependsOn) {
+            if (!nodeIds.has(dep)) {
+                violations.push({
+                    rule: "SPEC-04",
+                    message: `dependsOn reference does not resolve: ${dep} (in node ${node.id})`,
+                });
+            }
+        }
+        for (const source of node.sources) {
+            const docName = source.split("#")[0];
+            if (!docNames.has(docName)) {
+                violations.push({
+                    rule: "SPEC-04",
+                    message: `source reference does not resolve: ${source} (in node ${node.id})`,
+                });
+            }
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-05: Roadmap node without a wave
+// ---------------------------------------------------------------------------
+function checkWaveCoverage(spec, violations) {
+    const waveIds = new Set(spec.waves.map((w) => w.id));
+    for (const node of spec.rfcs) {
+        if (!waveIds.has(node.wave)) {
+            violations.push({
+                rule: "SPEC-05",
+                message: `node ${node.id} references wave ${node.wave} which does not exist`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-06: Duplicate node or decision id
+// ---------------------------------------------------------------------------
+function checkDuplicates(spec, violations) {
+    const nodeIds = new Set();
+    for (const node of spec.rfcs) {
+        if (nodeIds.has(node.id)) {
+            violations.push({
+                rule: "SPEC-06",
+                message: `duplicate node id: ${node.id}`,
+            });
+        }
+        nodeIds.add(node.id);
+    }
+    const decisionIds = new Set();
+    for (const decision of spec.decisions) {
+        if (decisionIds.has(decision.id)) {
+            violations.push({
+                rule: "SPEC-06",
+                message: `duplicate decision id: ${decision.id}`,
+            });
+        }
+        decisionIds.add(decision.id);
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-07: materializedAs points to missing RFC file
+// ---------------------------------------------------------------------------
+async function checkMaterializedAs(spec, rfcDir, violations) {
+    const rfcFiles = await listRfcFiles(rfcDir);
+    for (const node of spec.rfcs) {
+        if (!node.materializedAs)
+            continue;
+        const rfcId = node.materializedAs;
+        const prefix = rfcId.toLowerCase().replace(/^rfc-/, "rfc-");
+        const found = rfcFiles.some((file) => path.basename(file).startsWith(prefix));
+        if (!found) {
+            violations.push({
+                rule: "SPEC-07",
+                message: `materializedAs ${rfcId} for node ${node.id} not found in ${rfcDir}`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-08..11: Amendment validation (RFC-0397)
+// ---------------------------------------------------------------------------
+async function loadAmendments(specDir) {
+    const amendmentsDir = path.join(specDir, "amendments");
+    if (!existsSync(amendmentsDir))
+        return [];
+    const entries = await fs.readdir(amendmentsDir);
+    const amendments = [];
+    for (const entry of entries) {
+        if (!entry.endsWith(".md"))
+            continue;
+        try {
+            const content = await fs.readFile(path.join(amendmentsDir, entry), "utf8");
+            const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+            if (!fmMatch)
+                continue;
+            const raw = parseYaml(fmMatch[1]);
+            const parsed = specAmendmentSchema.safeParse(raw);
+            if (parsed.success) {
+                amendments.push(parsed.data);
+            }
+        }
+        catch {
+            // skip unreadable files
+        }
+    }
+    return amendments;
+}
+function checkAmendments(spec, amendments, violations) {
+    const nodeIds = new Set(spec.rfcs.map((n) => n.id));
+    const decisionIds = new Set(spec.decisions.map((d) => d.id));
+    const docNames = new Set(Object.keys(spec.documents));
+    const seenIds = new Set();
+    for (const amendment of amendments) {
+        // SPEC-08: schema/id violations
+        if (seenIds.has(amendment.id)) {
+            violations.push({
+                rule: "SPEC-08",
+                message: `duplicate amendment id: ${amendment.id}`,
+            });
+        }
+        seenIds.add(amendment.id);
+        // SPEC-09: unresolvable targets
+        for (const target of amendment.targets) {
+            if (target.kind === "section") {
+                if (!docNames.has(target.document)) {
+                    violations.push({
+                        rule: "SPEC-09",
+                        message: `amendment ${amendment.id} targets document not found: ${target.document}`,
+                    });
+                }
+            }
+            else if (target.kind === "decision") {
+                if (!decisionIds.has(target.id)) {
+                    violations.push({
+                        rule: "SPEC-09",
+                        message: `amendment ${amendment.id} targets decision not found: ${target.id}`,
+                    });
+                }
+            }
+            else if (target.kind === "node") {
+                if (!nodeIds.has(target.id)) {
+                    violations.push({
+                        rule: "SPEC-09",
+                        message: `amendment ${amendment.id} targets node not found: ${target.id}`,
+                    });
+                }
+            }
+        }
+        // SPEC-11: accepted amendment without reviewers
+        if (amendment.status === "accepted" && amendment.reviewers.length === 0) {
+            violations.push({
+                rule: "SPEC-11",
+                message: `accepted amendment ${amendment.id} has no reviewers`,
+            });
+        }
+    }
+    // SPEC-10: two accepted amendments target the same anchor with conflicting Becomes
+    const acceptedAmendments = amendments.filter((a) => a.status === "accepted");
+    const targetCounts = new Map();
+    for (const amendment of acceptedAmendments) {
+        for (const target of amendment.targets) {
+            const key = target.kind === "section"
+                ? `section:${target.document}:${target.anchor}`
+                : target.kind === "decision"
+                    ? `decision:${target.id}`
+                    : `node:${target.id}`;
+            targetCounts.set(key, (targetCounts.get(key) ?? 0) + 1);
+        }
+    }
+    for (const [key, count] of targetCounts) {
+        if (count > 1) {
+            violations.push({
+                rule: "SPEC-10",
+                message: `conflicting accepted amendments targeting ${key} — manual review required`,
+            });
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Main handler
+// ---------------------------------------------------------------------------
+export async function runSpecValidate(input, context) {
+    const { workspaceRoot, logger, outputFormat } = context;
+    // Resolve specs directory from forge.yaml
+    let specsDir = "docs/specs";
+    try {
+        const config = loadForgeConfig(workspaceRoot);
+        specsDir = config.paths.specsDir;
+    }
+    catch {
+        // Use default
+    }
+    const specsRoot = path.join(workspaceRoot, specsDir);
+    const filterSpec = input.flags["spec"];
+    let specDirs = await listSpecDirs(specsRoot);
+    if (filterSpec) {
+        if (!specDirs.includes(filterSpec)) {
+            return {
+                data: {
+                    command: "spec.validate",
+                    status: "fail",
+                    specs: [],
+                },
+                exitCode: 1,
+                summary: `spec.validate: spec '${filterSpec}' not found. Available: ${specDirs.join(", ") || "(none)"}`,
+            };
+        }
+        specDirs = [filterSpec];
+    }
+    const rfcDir = path.join(workspaceRoot, "docs", "rfcs");
+    const results = [];
+    for (const specId of specDirs) {
+        const specDir = path.join(specsRoot, specId);
+        const violations = [];
+        // Load forge-spec.yaml
+        const forgeSpecPath = path.join(specDir, "forge-spec.yaml");
+        const rawSpec = await readYaml(forgeSpecPath);
+        if (!rawSpec) {
+            results.push({
+                id: specId,
+                status: "unknown",
+                violations: [{ rule: "SPEC-02", message: "forge-spec.yaml not found" }],
+            });
+            continue;
+        }
+        // SPEC-02: Schema
+        const spec = checkSchema(rawSpec, violations);
+        if (!spec) {
+            results.push({ id: specId, status: "unknown", violations });
+            continue;
+        }
+        // SPEC-01: Integrity
+        await checkIntegrity(specDir, violations);
+        // SPEC-03: Cycles
+        checkCycles(spec, violations);
+        // SPEC-04: References
+        checkReferences(spec, violations);
+        // SPEC-05: Wave coverage
+        checkWaveCoverage(spec, violations);
+        // SPEC-06: Duplicates
+        checkDuplicates(spec, violations);
+        // SPEC-07: materializedAs
+        await checkMaterializedAs(spec, rfcDir, violations);
+        // SPEC-08..11: Amendments (RFC-0397)
+        const amendments = await loadAmendments(specDir);
+        checkAmendments(spec, amendments, violations);
+        results.push({
+            id: spec.id,
+            status: spec.status,
+            violations,
+        });
+    }
+    const hasFailures = results.some((r) => r.violations.length > 0);
+    if (outputFormat === "pretty") {
+        if (results.length === 0) {
+            logger.info("No vendored specs found.");
+        }
+        else {
+            for (const result of results) {
+                if (result.violations.length === 0) {
+                    logger.success(`spec.validate: ${result.id} — pass`);
+                }
+                else {
+                    logger.error(`spec.validate: ${result.id} — ${result.violations.length} violation${result.violations.length === 1 ? "" : "s"}`);
+                    for (const v of result.violations) {
+                        logger.error(`  ${v.rule}: ${v.message}`);
+                    }
+                }
+            }
+        }
+    }
+    return {
+        data: {
+            command: "spec.validate",
+            status: hasFailures ? "fail" : "pass",
+            specs: results,
+        },
+        exitCode: hasFailures ? 1 : 0,
+        summary: hasFailures
+            ? `spec.validate: ${results.filter((r) => r.violations.length > 0).length} spec(s) with violations`
+            : `spec.validate: all ${results.length} spec(s) pass`,
+    };
+}
+//# sourceMappingURL=spec-validate.js.map

package/dist/os/spec/spec-validate.js.map

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

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

@@ -0,0 +1,3 @@
+import type { ForgeModule } from "../../src/forge-module.ts";
+export declare function createForgeSpecModule(): Promise<ForgeModule>;
+//# sourceMappingURL=spec.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spec.module.d.ts","sourceRoot":"","sources":["../../../os/spec/spec.module.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,WAAW,CAAC,CAyHlE"}

package/dist/os/spec/spec.module.js

@@ -0,0 +1,129 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Register the forge spec module — spec.validate (RFC-0394), spec.status + spec.materialize (RFC-0396), spec.live.merge/list/show/validate (RFC-0711).</purpose>
+<non-goals>
+  <item>Do not implement skill logic — skills live in skills/.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-0394: initial forgeSpecModule registering spec.validate.</item>
+  <item>RFC-0396: added spec.status and spec.materialize commands.</item>
+  <item>RFC-0711: added spec.live.merge, spec.live.list, spec.live.show, spec.live.validate commands.</item>
+</CHANGE_SUMMARY>
+*/
+export async function createForgeSpecModule() {
+    const { runSpecValidate } = await import("./spec-validate.js");
+    const { runSpecStatus } = await import("./spec-status.js");
+    const { runSpecMaterialize } = await import("./spec-materialize.js");
+    const { runSpecLiveMerge } = await import("./live-spec-merge.js");
+    const { runSpecLiveList } = await import("./live-spec-list.js");
+    const { runSpecLiveShow } = await import("./live-spec-show.js");
+    const { runSpecLiveValidate } = await import("./live-spec-validate.js");
+    return {
+        name: "forge-spec",
+        version: "0.2.0",
+        runtime: "autonomous",
+        declarations: [],
+        commands: [
+            {
+                name: "spec.validate",
+                contract: "spec",
+                rules: [],
+                description: "Validate vendored spec packages under docs/specs/. " +
+                    "Checks integrity (SHA-256), schema, dependency graph (acyclic), " +
+                    "reference resolution, wave coverage, duplicate ids, and materializedAs links. " +
+                    "Use --spec=<id> to validate a single spec.",
+                scope: "workspace",
+                flags: {
+                    spec: {
+                        kind: "string",
+                        description: "Validate only the named spec.",
+                    },
+                },
+                reads: ["docs/specs/**/*"],
+                execute: runSpecValidate,
+            },
+            {
+                name: "spec.status",
+                description: "Show roadmap progress for vendored specs. " +
+                    "Without --spec, summarizes all specs; with it, full per-node table + computed front.",
+                scope: "workspace",
+                flags: {
+                    spec: {
+                        kind: "string",
+                        description: "Show status for a single spec.",
+                    },
+                },
+                reads: ["docs/specs/**/*", "docs/rfcs/**/*.md"],
+                execute: runSpecStatus,
+            },
+            {
+                name: "spec.materialize",
+                description: "Scaffold RFC files for the next N front nodes of a spec roadmap. " +
+                    "Requires --spec=<id>. Optional: --next=<N> (default 8, max 12), --nodes=<id,id> explicit selection.",
+                scope: "workspace",
+                mutatesState: true,
+                writes: ["docs/rfcs/rfc-*.md", "docs/specs/*/forge-spec.yaml"],
+                reads: ["docs/specs/**/*", "docs/rfcs/**/*.md"],
+                flags: {
+                    spec: { kind: "string", required: true, description: "Spec id to materialize from." },
+                    next: { kind: "string", description: "Number of front nodes to materialize (default 8, max 12)." },
+                    nodes: { kind: "string", description: "Comma-separated explicit node ids to materialize." },
+                },
+                execute: runSpecMaterialize,
+            },
+            {
+                name: "spec.live.merge",
+                description: "Merge deltas from an implemented RFC's ## Design section into a living feature spec " +
+                    "under docs/specs/live/<domain>.md. Requires --id=<RFC-XXXX>. " +
+                    "Domain is auto-derived from packagesImpacted[0] when liveSpec: true, or uses " +
+                    "the string value when liveSpec: <domain>. " +
+                    "All-or-nothing: aborts on any heading conflict without writing. " +
+                    "Use --dry-run to preview deltas without writing.",
+                scope: "workspace",
+                mutatesState: true,
+                writes: ["docs/specs/live/*.md"],
+                reads: ["docs/rfcs/**/*.md", "docs/specs/live/*.md"],
+                flags: {
+                    id: { kind: "string", required: true, description: "RFC id to merge (e.g. RFC-0711)." },
+                    "dry-run": { kind: "boolean", description: "Preview deltas without writing files." },
+                },
+                execute: runSpecLiveMerge,
+            },
+            {
+                name: "spec.live.list",
+                description: "List all living feature specs in docs/specs/live/. " +
+                    "Returns domain, title, lastMergedRfc, updatedAt, and historyCount for each spec.",
+                scope: "workspace",
+                reads: ["docs/specs/live/*.md"],
+                execute: runSpecLiveList,
+            },
+            {
+                name: "spec.live.show",
+                description: "Show a single living feature spec by domain. " +
+                    "Requires --domain=<name>. Returns full frontmatter and body content.",
+                scope: "workspace",
+                reads: ["docs/specs/live/*.md"],
+                flags: {
+                    domain: { kind: "string", required: true, description: "Domain name (filename without .md)." },
+                },
+                execute: runSpecLiveShow,
+            },
+            {
+                name: "spec.live.validate",
+                contract: "spec",
+                rules: [],
+                description: "Validate all living feature specs in docs/specs/live/. " +
+                    "Checks V-LS-01 (frontmatter), V-LS-02 (domain/filename match), " +
+                    "V-LS-03 (lastMergedRfc is archived), V-LS-04 (history entries are archived), " +
+                    "V-LS-05 (no duplicate domains).",
+                scope: "workspace",
+                reads: ["docs/specs/live/*.md", "docs/rfcs/**/*.md"],
+                execute: runSpecLiveValidate,
+            }
+        ],
+        pipelines: []
+    };
+}
+;
+//# sourceMappingURL=spec.module.js.map

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

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

package/dist/os/werkstatt/handlers/lock.d.ts

@@ -0,0 +1,10 @@
+import { type WerkstattLock } from "./schema.ts";
+export declare function isLockStale(lock: WerkstattLock, now?: Date): boolean;
+export declare function acquireLock(workspaceRoot: string, scope: string, operationId: string, command: string, owner: string, timeoutSeconds?: number): Promise<WerkstattLock>;
+export declare function releaseLock(workspaceRoot: string, scope: string): Promise<void>;
+export declare function heartbeatLock(workspaceRoot: string, scope: string): Promise<void>;
+export declare function readAllLocks(workspaceRoot: string): Promise<Array<WerkstattLock & {
+    stale: boolean;
+}>>;
+export declare function removeStaleLock(workspaceRoot: string, scope: string): Promise<boolean>;
+//# sourceMappingURL=lock.d.ts.map

package/dist/os/werkstatt/handlers/lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.d.ts","sourceRoot":"","sources":["../../../../os/werkstatt/handlers/lock.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAuBtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,GAAE,IAAiB,GAAG,OAAO,CAIhF;AAED,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,cAAc,GAAE,MAAgC,GAC/C,OAAO,CAAC,aAAa,CAAC,CAgDxB;AAED,wBAAsB,WAAW,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBrF;AAED,wBAAsB,aAAa,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF;AAED,wBAAsB,YAAY,CAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,CAmBpD;AAED,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQ5F"}