@mc1global/opencode-jarvis 0.1.0

package/dist/domain/vault/document.js

@@ -0,0 +1,244 @@
+/**
+ * Vault MarkdownDocument Entity
+ *
+ * Aggregate root for markdown document operations within the vault.
+ * Owns frontmatter, section tree, and raw content. Provides query
+ * methods for sections, tables, checkboxes, wikilinks, and mutation
+ * methods that return new content strings (immutable pattern).
+ *
+ * DDD: Entity / Aggregate Root - the document is the consistency boundary
+ * SOLID: SRP - document structure and content manipulation
+ * SOLID: OCP - new query/mutation methods extend without modifying existing
+ */
+import { VaultPath, WIKILINK_PATTERN, CHECKBOX_PATTERN } from "./value-objects.js";
+import { Section } from "./section.js";
+import { MarkdownTable } from "./table.js";
+// ── Entity ────────────────────────────────────────────────────────────
+export class MarkdownDocument {
+    path;
+    frontmatter;
+    rawFrontmatter;
+    sections;
+    rawContent;
+    constructor(props) {
+        this.path = props.path;
+        this.frontmatter = props.frontmatter;
+        this.rawFrontmatter = props.rawFrontmatter;
+        this.sections = props.sections;
+        this.rawContent = props.rawContent;
+    }
+    /** Reconstitute from parsed components. */
+    static reconstitute(props) {
+        return new MarkdownDocument(props);
+    }
+    // ── Derived Getters ───────────────────────────────────────────────
+    /** Document title from frontmatter, first H1, or filename. */
+    get title() {
+        if (typeof this.frontmatter["title"] === "string" &&
+            this.frontmatter["title"].length > 0) {
+            return this.frontmatter["title"];
+        }
+        for (const section of this.sections) {
+            if (section.level === 1)
+                return section.heading;
+        }
+        return this.path.filename;
+    }
+    /** Tags from frontmatter (normalized to string array). */
+    get tags() {
+        const raw = this.frontmatter["tags"];
+        if (Array.isArray(raw)) {
+            return raw.filter((t) => typeof t === "string");
+        }
+        if (typeof raw === "string") {
+            return raw.split(",").map((t) => t.trim()).filter((t) => t.length > 0);
+        }
+        return [];
+    }
+    /** Status from frontmatter. */
+    get status() {
+        const s = this.frontmatter["status"];
+        return typeof s === "string" ? s : undefined;
+    }
+    /** Created date from frontmatter. */
+    get created() {
+        const c = this.frontmatter["created"];
+        return typeof c === "string" ? c : undefined;
+    }
+    /** Updated date from frontmatter. */
+    get updated() {
+        const u = this.frontmatter["updated"];
+        return typeof u === "string" ? u : undefined;
+    }
+    // ── Section Queries ───────────────────────────────────────────────
+    /** Find a section by heading text (case-insensitive). */
+    getSection(heading) {
+        return findSectionRecursive(this.sections, heading);
+    }
+    /**
+     * Find a section by heading path (e.g., "Quality Gates > Sub-gate A").
+     * The first segment is searched recursively through the entire tree.
+     * Subsequent segments are searched within the found section's subsections.
+     */
+    getSectionByPath(headingPath) {
+        const parts = headingPath.split(">").map((p) => p.trim());
+        if (parts.length === 0)
+            return null;
+        // First segment: search recursively through entire tree
+        let found = findSectionRecursive(this.sections, parts[0]);
+        if (found === null)
+            return null;
+        // Remaining segments: traverse subsections
+        for (let i = 1; i < parts.length; i++) {
+            const next = found.findSubsection(parts[i]);
+            if (next === null)
+                return null;
+            found = next;
+        }
+        return found;
+    }
+    // ── Inline Element Queries ────────────────────────────────────────
+    /** Extract all checkboxes from the document body. */
+    getCheckboxes() {
+        const lines = this.rawContent.split("\n");
+        const checkboxes = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const match = line.match(CHECKBOX_PATTERN);
+            if (match !== null) {
+                const indent = match[1];
+                const checkChar = match[2];
+                const text = match[3];
+                checkboxes.push({
+                    text,
+                    checked: checkChar === "x" || checkChar === "X",
+                    line: i,
+                    indentLevel: indent.length,
+                });
+            }
+        }
+        return checkboxes;
+    }
+    /** Extract all wikilinks from the document. */
+    getWikilinks() {
+        const lines = this.rawContent.split("\n");
+        const wikilinks = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            // Reset regex state for each line
+            const regex = new RegExp(WIKILINK_PATTERN.source, WIKILINK_PATTERN.flags);
+            let match;
+            while ((match = regex.exec(line)) !== null) {
+                wikilinks.push({
+                    target: match[1],
+                    alias: match[2],
+                    line: i,
+                });
+            }
+        }
+        return wikilinks;
+    }
+    /** Extract all tables from the document body. */
+    getTables() {
+        const lines = this.rawContent.split("\n");
+        const tables = [];
+        let i = 0;
+        while (i < lines.length) {
+            const line = lines[i];
+            // A table starts with a pipe-containing line followed by a separator
+            if (line.includes("|") && i + 1 < lines.length) {
+                const nextLine = lines[i + 1];
+                if (/^\s*\|?[\s:|-]+\|?\s*$/.test(nextLine)) {
+                    // Collect table lines
+                    const tableLines = [];
+                    let j = i;
+                    while (j < lines.length && lines[j].includes("|")) {
+                        tableLines.push(lines[j]);
+                        j++;
+                    }
+                    const table = MarkdownTable.parse(tableLines, i);
+                    if (table !== null) {
+                        tables.push(table);
+                        i = j;
+                        continue;
+                    }
+                }
+            }
+            i++;
+        }
+        return tables;
+    }
+    // ── Content Mutation (returns new string) ─────────────────────────
+    /**
+     * Return new document content with replaced frontmatter.
+     * Receives pre-serialized YAML string (without --- delimiters).
+     */
+    withFrontmatter(serializedYaml) {
+        const lines = this.rawContent.split("\n");
+        const fmBounds = findFrontmatterBounds(lines);
+        if (fmBounds !== null) {
+            // Replace existing frontmatter
+            const before = lines.slice(0, fmBounds.start);
+            const after = lines.slice(fmBounds.end + 1);
+            return [
+                ...before,
+                "---",
+                serializedYaml.trimEnd(),
+                "---",
+                ...after,
+            ].join("\n");
+        }
+        // No frontmatter exists — prepend
+        return ["---", serializedYaml.trimEnd(), "---", this.rawContent].join("\n");
+    }
+    /**
+     * Return new document content with a section's content replaced or appended.
+     * Finds the section by heading text (case-insensitive).
+     */
+    withSectionContent(heading, content, mode) {
+        const section = this.getSection(heading);
+        if (section === null) {
+            throw new Error(`Section not found: "${heading}"`);
+        }
+        const lines = this.rawContent.split("\n");
+        // Section line numbers are rawContent-relative (offset applied at parse time).
+        const contentStart = section.startLine + 1;
+        const contentEnd = section.endLine;
+        if (mode === "replace") {
+            const before = lines.slice(0, contentStart);
+            const after = lines.slice(contentEnd + 1);
+            return [...before, content, ...after].join("\n");
+        }
+        // Append mode: insert after the end of the section
+        const before = lines.slice(0, contentEnd + 1);
+        const after = lines.slice(contentEnd + 1);
+        return [...before, content, ...after].join("\n");
+    }
+}
+// ── Private Helpers ───────────────────────────────────────────────────
+function findSectionRecursive(sections, heading) {
+    for (const section of sections) {
+        if (section.matchesHeading(heading))
+            return section;
+        const found = findSectionRecursive(section.subsections, heading);
+        if (found !== null)
+            return found;
+    }
+    return null;
+}
+/** Find the line range of YAML frontmatter (inclusive of --- delimiters). */
+function findFrontmatterBounds(lines) {
+    if (lines.length < 3)
+        return null;
+    if (lines[0].trim() !== "---")
+        return null;
+    for (let i = 1; i < lines.length; i++) {
+        if (lines[i].trim() === "---") {
+            return { start: 0, end: i };
+        }
+    }
+    return null;
+}
+// Re-export key types for consumer convenience
+export { VaultPath, Section, MarkdownTable };
+//# sourceMappingURL=document.js.map

package/dist/domain/vault/document.js.map

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

package/dist/domain/vault/repositories.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Vault Repository Interface
+ *
+ * Persistence abstraction for vault filesystem operations.
+ * Infrastructure layer implements this with actual file I/O.
+ *
+ * DDD: Repository pattern - persistence abstraction in domain layer
+ * SOLID: DIP - domain defines interface, infrastructure implements
+ * SOLID: ISP - single interface for vault document operations
+ */
+import type { VaultPath } from "./value-objects.js";
+export interface VaultSearchResult {
+    readonly path: VaultPath;
+    readonly line: number;
+    readonly match: string;
+}
+export interface VaultRepository {
+    /** List all document paths, optionally filtered by folder prefix. */
+    listDocuments(folder?: string): Promise<readonly VaultPath[]>;
+    /** Read document content. Returns null if file doesn't exist. */
+    readDocument(path: VaultPath): Promise<string | null>;
+    /** Write document content. Creates parent directories if needed. */
+    writeDocument(path: VaultPath, content: string): Promise<void>;
+    /** Delete a document. */
+    deleteDocument(path: VaultPath): Promise<void>;
+    /** Check if a document exists. */
+    exists(path: VaultPath): Promise<boolean>;
+    /** Read .canvas file content. Returns null if file doesn't exist. */
+    readCanvas(path: VaultPath): Promise<string | null>;
+    /** Write .canvas file content. Creates parent directories if needed. */
+    writeCanvas(path: VaultPath, content: string): Promise<void>;
+    /** Search for text across vault documents. Returns matching lines. */
+    search(query: string, folder?: string): Promise<readonly VaultSearchResult[]>;
+}
+//# sourceMappingURL=repositories.d.ts.map

package/dist/domain/vault/repositories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.d.ts","sourceRoot":"","sources":["../../../src/domain/vault/repositories.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAID,MAAM,WAAW,eAAe;IAC9B,qEAAqE;IACrE,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,SAAS,EAAE,CAAC,CAAC;IAE9D,iEAAiE;IACjE,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEtD,oEAAoE;IACpE,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/D,yBAAyB;IACzB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C,kCAAkC;IAClC,MAAM,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1C,qEAAqE;IACrE,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEpD,wEAAwE;IACxE,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,sEAAsE;IACtE,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAAC;CAC1C"}

package/dist/domain/vault/repositories.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=repositories.js.map

package/dist/domain/vault/repositories.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repositories.js","sourceRoot":"","sources":["../../../src/domain/vault/repositories.ts"],"names":[],"mappings":""}

package/dist/domain/vault/section.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Vault Section Value Object
+ *
+ * Represents a heading-delimited section within a markdown document.
+ * Sections form a tree: an H2 section can contain H3 subsections, etc.
+ * Immutable — any modification produces a new content string.
+ *
+ * DDD: Value Object - compared by content, no identity
+ * SOLID: SRP - section structure only
+ */
+import type { HeadingLevel } from "./value-objects.js";
+export declare class Section {
+    readonly heading: string;
+    readonly level: HeadingLevel;
+    readonly content: string;
+    readonly startLine: number;
+    readonly endLine: number;
+    readonly subsections: readonly Section[];
+    private constructor();
+    static create(params: {
+        readonly heading: string;
+        readonly level: HeadingLevel;
+        readonly content: string;
+        readonly startLine: number;
+        readonly endLine: number;
+        readonly subsections?: readonly Section[];
+    }): Section;
+    /** Check if this section's heading matches (case-insensitive). */
+    matchesHeading(heading: string): boolean;
+    /** Find a direct subsection by heading text (case-insensitive). */
+    findSubsection(heading: string): Section | null;
+}
+//# sourceMappingURL=section.d.ts.map

package/dist/domain/vault/section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.d.ts","sourceRoot":"","sources":["../../../src/domain/vault/section.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qBAAa,OAAO;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,SAAS,OAAO,EAAE,CAAC;IAEzC,OAAO;IAgBP,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE;QACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;QAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;KAC3C,GAAG,OAAO;IAWX,kEAAkE;IAClE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIxC,mEAAmE;IACnE,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;CAMhD"}

package/dist/domain/vault/section.js

@@ -0,0 +1,39 @@
+export class Section {
+    heading;
+    level;
+    content;
+    startLine;
+    endLine;
+    subsections;
+    constructor(params) {
+        this.heading = params.heading;
+        this.level = params.level;
+        this.content = params.content;
+        this.startLine = params.startLine;
+        this.endLine = params.endLine;
+        this.subsections = params.subsections;
+    }
+    static create(params) {
+        return new Section({
+            heading: params.heading,
+            level: params.level,
+            content: params.content,
+            startLine: params.startLine,
+            endLine: params.endLine,
+            subsections: params.subsections ?? [],
+        });
+    }
+    /** Check if this section's heading matches (case-insensitive). */
+    matchesHeading(heading) {
+        return this.heading.toLowerCase().trim() === heading.toLowerCase().trim();
+    }
+    /** Find a direct subsection by heading text (case-insensitive). */
+    findSubsection(heading) {
+        for (const sub of this.subsections) {
+            if (sub.matchesHeading(heading))
+                return sub;
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=section.js.map

package/dist/domain/vault/section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"section.js","sourceRoot":"","sources":["../../../src/domain/vault/section.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,OAAO;IACT,OAAO,CAAS;IAChB,KAAK,CAAe;IACpB,OAAO,CAAS;IAChB,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,WAAW,CAAqB;IAEzC,YAAoB,MAOnB;QACC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,MAOb;QACC,OAAO,IAAI,OAAO,CAAC;YACjB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,EAAE;SACtC,CAAC,CAAC;IACL,CAAC;IAED,kEAAkE;IAClE,cAAc,CAAC,OAAe;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC5E,CAAC;IAED,mEAAmE;IACnE,cAAc,CAAC,OAAe;QAC5B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC;gBAAE,OAAO,GAAG,CAAC;QAC9C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/domain/vault/services.d.ts

@@ -0,0 +1,48 @@
+import { Section } from "./section.js";
+import { MarkdownTable } from "./table.js";
+import type { Checkbox, Wikilink } from "./table.js";
+import type { MarkdownDocument } from "./document.js";
+import type { VaultPath } from "./value-objects.js";
+/**
+ * Parses markdown content into structural elements.
+ * Stateless — all methods are pure functions on input data.
+ */
+export declare class MarkdownParserService {
+    /**
+     * Parse body text (without frontmatter) into a section tree.
+     * Returns top-level sections; each may contain subsections.
+     */
+    parseSections(bodyLines: readonly string[]): readonly Section[];
+    /** Extract all checkboxes from lines. */
+    extractCheckboxes(lines: readonly string[]): readonly Checkbox[];
+    /** Extract all wikilinks from content string. */
+    extractWikilinks(content: string): readonly Wikilink[];
+    /** Extract all tables from lines. */
+    extractTables(lines: readonly string[]): readonly MarkdownTable[];
+}
+/**
+ * Analyzes wikilink relationships across a collection of documents.
+ * All methods are pure — they receive document collections as parameters.
+ */
+export declare class LinkGraphService {
+    /** Get all outgoing wikilinks from a document. */
+    getOutgoingLinks(doc: MarkdownDocument): readonly Wikilink[];
+    /** Find all documents that link to a target path. */
+    getIncomingLinks(target: VaultPath, allDocs: readonly MarkdownDocument[]): readonly {
+        readonly source: VaultPath;
+        readonly link: Wikilink;
+    }[];
+    /** Find documents with no incoming links (orphans). Excludes HOME.md. */
+    getOrphanDocuments(allDocs: readonly MarkdownDocument[]): readonly VaultPath[];
+    /** Compute graph statistics across all documents. */
+    getGraphStats(allDocs: readonly MarkdownDocument[]): {
+        readonly totalDocs: number;
+        readonly totalLinks: number;
+        readonly orphans: number;
+        readonly mostLinked: readonly {
+            readonly path: string;
+            readonly count: number;
+        }[];
+    };
+}
+//# sourceMappingURL=services.d.ts.map

package/dist/domain/vault/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../../src/domain/vault/services.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAIpD;;;GAGG;AACH,qBAAa,qBAAqB;IAChC;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,OAAO,EAAE;IAsB/D,yCAAyC;IACzC,iBAAiB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,QAAQ,EAAE;IAiBhE,iDAAiD;IACjD,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,QAAQ,EAAE;IAoBtD,qCAAqC;IACrC,aAAa,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,aAAa,EAAE;CA4BlE;AAID;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,kDAAkD;IAClD,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,SAAS,QAAQ,EAAE;IAI5D,qDAAqD;IACrD,gBAAgB,CACd,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAAE;IAwBrE,yEAAyE;IACzE,kBAAkB,CAChB,OAAO,EAAE,SAAS,gBAAgB,EAAE,GACnC,SAAS,SAAS,EAAE;IAwCvB,qDAAqD;IACrD,aAAa,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG;QACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,UAAU,EAAE,SAAS;YAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;YACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;SACxB,EAAE,CAAC;KACL;CA4BF"}