@vkenliu/adit-cloud 0.2.0

package/dist/project-link/cache.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Local SQLite cache for project link state.
+ *
+ * Tracks the server-confirmed project ID, last-synced commit SHA,
+ * document content hashes, and qualification status. Stored in the
+ * existing adit database ($projectRoot/.adit/adit.sqlite).
+ */
+import type Database from "better-sqlite3";
+import type { ProjectLinkCache } from "./types.js";
+/** Get cached state for a project link */
+export declare function getProjectLinkCache(db: Database.Database, projectId: string, serverUrl: string): ProjectLinkCache | null;
+/** Create or update project link cache */
+export declare function upsertProjectLinkCache(db: Database.Database, cache: ProjectLinkCache): void;
+/** Clear cache for a project link (used by --force) */
+export declare function clearProjectLinkCache(db: Database.Database, projectId: string, serverUrl: string): void;
+/** Update the last-synced commit SHA after upload */
+export declare function updateCachedCommitSha(db: Database.Database, projectId: string, serverUrl: string, sha: string): void;
+/** Update cached document hashes after upload */
+export declare function updateCachedDocHashes(db: Database.Database, projectId: string, serverUrl: string, hashes: Record<string, string>): void;
+/** Mark as qualified or not */
+export declare function updateCachedQualified(db: Database.Database, projectId: string, serverUrl: string, qualified: boolean): void;
+//# sourceMappingURL=cache.d.ts.map

package/dist/project-link/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/project-link/cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgBnD,0CAA0C;AAC1C,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,gBAAgB,GAAG,IAAI,CA0BzB;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,gBAAgB,GACtB,IAAI,CA2BN;AAED,uDAAuD;AACvD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,CAGN;AAED,qDAAqD;AACrD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,GACV,IAAI,CAMN;AAED,iDAAiD;AACjD,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,IAAI,CAYN;AAED,+BAA+B;AAC/B,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,OAAO,GACjB,IAAI,CAMN"}

package/dist/project-link/cache.js

@@ -0,0 +1,82 @@
+/**
+ * Local SQLite cache for project link state.
+ *
+ * Tracks the server-confirmed project ID, last-synced commit SHA,
+ * document content hashes, and qualification status. Stored in the
+ * existing adit database ($projectRoot/.adit/adit.sqlite).
+ */
+/** Get cached state for a project link */
+export function getProjectLinkCache(db, projectId, serverUrl) {
+    const row = db
+        .prepare("SELECT * FROM project_link_cache WHERE project_id = ? AND server_url = ?")
+        .get(projectId, serverUrl);
+    if (!row)
+        return null;
+    let docHashes = {};
+    try {
+        docHashes = JSON.parse(row.doc_hashes_json);
+    }
+    catch {
+        // Corrupted JSON — treat as empty (documents will be re-uploaded)
+    }
+    return {
+        projectId: row.project_id,
+        serverUrl: row.server_url,
+        confirmedProjectId: row.confirmed_project_id,
+        lastCommitSha: row.last_commit_sha,
+        lastBranchSyncAt: row.last_branch_sync_at,
+        lastDocSyncAt: row.last_doc_sync_at,
+        docHashes,
+        qualified: row.qualified === 1,
+        initializedAt: row.initialized_at,
+        updatedAt: row.updated_at,
+    };
+}
+/** Create or update project link cache */
+export function upsertProjectLinkCache(db, cache) {
+    db.prepare(`
+    INSERT INTO project_link_cache (
+      project_id, server_url, confirmed_project_id,
+      last_commit_sha, last_branch_sync_at, last_doc_sync_at,
+      doc_hashes_json, qualified, initialized_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT (project_id, server_url) DO UPDATE SET
+      confirmed_project_id = excluded.confirmed_project_id,
+      last_commit_sha = excluded.last_commit_sha,
+      last_branch_sync_at = excluded.last_branch_sync_at,
+      last_doc_sync_at = excluded.last_doc_sync_at,
+      doc_hashes_json = excluded.doc_hashes_json,
+      qualified = excluded.qualified,
+      updated_at = excluded.updated_at
+  `).run(cache.projectId, cache.serverUrl, cache.confirmedProjectId, cache.lastCommitSha, cache.lastBranchSyncAt, cache.lastDocSyncAt, JSON.stringify(cache.docHashes), cache.qualified ? 1 : 0, cache.initializedAt, cache.updatedAt);
+}
+/** Clear cache for a project link (used by --force) */
+export function clearProjectLinkCache(db, projectId, serverUrl) {
+    db.prepare("DELETE FROM project_link_cache WHERE project_id = ? AND server_url = ?")
+        .run(projectId, serverUrl);
+}
+/** Update the last-synced commit SHA after upload */
+export function updateCachedCommitSha(db, projectId, serverUrl, sha) {
+    db.prepare(`
+    UPDATE project_link_cache
+    SET last_commit_sha = ?, updated_at = ?
+    WHERE project_id = ? AND server_url = ?
+  `).run(sha, new Date().toISOString(), projectId, serverUrl);
+}
+/** Update cached document hashes after upload */
+export function updateCachedDocHashes(db, projectId, serverUrl, hashes) {
+    db.prepare(`
+    UPDATE project_link_cache
+    SET doc_hashes_json = ?, last_doc_sync_at = ?, updated_at = ?
+    WHERE project_id = ? AND server_url = ?
+  `).run(JSON.stringify(hashes), new Date().toISOString(), new Date().toISOString(), projectId, serverUrl);
+}
+/** Mark as qualified or not */
+export function updateCachedQualified(db, projectId, serverUrl, qualified) {
+    db.prepare(`
+    UPDATE project_link_cache
+    SET qualified = ?, updated_at = ?
+    WHERE project_id = ? AND server_url = ?
+  `).run(qualified ? 1 : 0, new Date().toISOString(), projectId, serverUrl);
+}
+//# sourceMappingURL=cache.js.map

package/dist/project-link/cache.js.map

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

package/dist/project-link/doc-discovery.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Project document discovery for project link.
+ *
+ * Scans the project root for markdown documents matching configurable
+ * glob patterns, computes content hashes, and classifies each document
+ * as new, changed, or unchanged relative to cached hashes.
+ */
+import type { DiscoveredDocument } from "./types.js";
+/** Options for document discovery */
+export interface DocDiscoveryOptions {
+    /** Override default include patterns (replaces, does not merge) */
+    patterns?: string[];
+    /** Override default exclude patterns (replaces, does not merge) */
+    excludePatterns?: string[];
+}
+/**
+ * Discover project documents by scanning the project root.
+ *
+ * Returns documents sorted: new first, then changed, then unchanged.
+ * Files > 500KB or containing null bytes (binary) are skipped with
+ * a warning to stderr.
+ */
+export declare function discoverDocuments(projectRoot: string, cachedHashes: Record<string, string>, options?: DocDiscoveryOptions): DiscoveredDocument[];
+/**
+ * Load custom document discovery settings from the project's settings.json.
+ *
+ * The settings file is at `{projectRoot}/settings.json` and may contain:
+ * ```json
+ * { "projectLink": { "docPatterns": [...], "excludePatterns": [...] } }
+ * ```
+ *
+ * Returns undefined if no custom settings are found.
+ */
+export declare function loadDocSettings(projectRoot: string): DocDiscoveryOptions | undefined;
+//# sourceMappingURL=doc-discovery.d.ts.map

package/dist/project-link/doc-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-discovery.d.ts","sourceRoot":"","sources":["../../src/project-link/doc-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAmJrD,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,OAAO,CAAC,EAAE,mBAAmB,GAC5B,kBAAkB,EAAE,CA8EtB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,GAClB,mBAAmB,GAAG,SAAS,CAqBjC"}

package/dist/project-link/doc-discovery.js

@@ -0,0 +1,260 @@
+/**
+ * Project document discovery for project link.
+ *
+ * Scans the project root for markdown documents matching configurable
+ * glob patterns, computes content hashes, and classifies each document
+ * as new, changed, or unchanged relative to cached hashes.
+ */
+import { readdirSync, readFileSync, existsSync } from "node:fs";
+import { join, basename, relative } from "node:path";
+import { createHash } from "node:crypto";
+/** Maximum file size for document upload (500 KB) */
+const MAX_DOC_SIZE = 500 * 1024;
+/** Default glob patterns for project documents */
+const DEFAULT_DOC_PATTERNS = [
+    // Root-level documentation files (case-insensitive matching handled by glob)
+    "*.md",
+    // Common documentation directories
+    "docs/**/*.md",
+    "doc/**/*.md",
+    "documentation/**/*.md",
+    "specs/**/*.md",
+    "design/**/*.md",
+    "wiki/**/*.md",
+    "guides/**/*.md",
+    "rfcs/**/*.md",
+    "adrs/**/*.md",
+];
+/** Default patterns to exclude from document discovery */
+const DEFAULT_EXCLUDE_PATTERNS = [
+    "node_modules/**",
+    ".git/**",
+    "vendor/**",
+    "dist/**",
+    "build/**",
+    "out/**",
+    "coverage/**",
+    ".adit/**",
+    "**/CHANGELOG.md",
+    "**/changelog.md",
+];
+/** Check if a relative path contains any hidden (dot-prefixed) directory or file */
+function isInHiddenPath(relativePath) {
+    return relativePath.split("/").some((segment) => segment.startsWith("."));
+}
+/**
+ * Convert a simple glob pattern to a RegExp.
+ *
+ * Supports:
+ * - `*` matches any non-separator characters
+ * - `**` matches any path segment(s), including nested directories
+ * - `?` matches a single non-separator character
+ * - `{a,b}` alternation (one level, no nesting)
+ */
+function globToRegex(pattern) {
+    let re = "";
+    let i = 0;
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === "*") {
+            if (pattern[i + 1] === "*") {
+                // ** matches everything including path separators
+                if (pattern[i + 2] === "/") {
+                    re += "(?:.+/)?"; // **/ matches zero or more directories
+                    i += 3;
+                }
+                else {
+                    re += ".*";
+                    i += 2;
+                }
+            }
+            else {
+                re += "[^/]*"; // * matches within a single segment
+                i += 1;
+            }
+        }
+        else if (ch === "?") {
+            re += "[^/]";
+            i += 1;
+        }
+        else if (ch === "{") {
+            const close = pattern.indexOf("}", i);
+            if (close !== -1) {
+                const alternatives = pattern.slice(i + 1, close).split(",");
+                re += "(?:" + alternatives.map(escapeRegex).join("|") + ")";
+                i = close + 1;
+            }
+            else {
+                re += escapeRegex(ch);
+                i += 1;
+            }
+        }
+        else {
+            re += escapeRegex(ch);
+            i += 1;
+        }
+    }
+    return new RegExp("^" + re + "$");
+}
+/** Escape a character for use in a RegExp */
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * List all files under projectRoot recursively, returning POSIX-style
+ * relative paths. Uses `readdirSync({ recursive: true })` which is
+ * stable since Node 18.17.
+ */
+function listAllFiles(projectRoot) {
+    try {
+        const entries = readdirSync(projectRoot, { recursive: true, withFileTypes: true });
+        const files = [];
+        for (const entry of entries) {
+            if (!entry.isFile())
+                continue;
+            // Build relative path from the dirent. parentPath is stable since Node 20.12.
+            const fullPath = join(entry.parentPath, entry.name);
+            const rel = relative(projectRoot, fullPath).split("\\").join("/");
+            files.push(rel);
+        }
+        return files;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Match files against include/exclude glob patterns.
+ *
+ * Replaces `node:fs` experimental `globSync` with stable
+ * `readdirSync({ recursive: true })` + pattern matching, ensuring
+ * compatibility with Node >= 20.
+ */
+function matchFiles(projectRoot, includePatterns, excludePatterns) {
+    const allFiles = listAllFiles(projectRoot);
+    const includeRegexes = includePatterns.map(globToRegex);
+    const excludeRegexes = excludePatterns.map(globToRegex);
+    const matched = new Set();
+    for (const file of allFiles) {
+        // Check if file matches any include pattern
+        const included = includeRegexes.some((re) => re.test(file));
+        if (!included)
+            continue;
+        // Check if file matches any exclude pattern
+        const excluded = excludeRegexes.some((re) => re.test(file));
+        if (excluded)
+            continue;
+        matched.add(file);
+    }
+    return matched;
+}
+/**
+ * Discover project documents by scanning the project root.
+ *
+ * Returns documents sorted: new first, then changed, then unchanged.
+ * Files > 500KB or containing null bytes (binary) are skipped with
+ * a warning to stderr.
+ */
+export function discoverDocuments(projectRoot, cachedHashes, options) {
+    const patterns = options?.patterns ?? DEFAULT_DOC_PATTERNS;
+    const excludePatterns = options?.excludePatterns ?? DEFAULT_EXCLUDE_PATTERNS;
+    // Collect matching files via recursive directory listing + pattern matching.
+    // Uses readdirSync({ recursive: true }) which is stable since Node 18.17,
+    // avoiding the experimental node:fs globSync (Node 22+).
+    const matchedPaths = matchFiles(projectRoot, patterns, excludePatterns);
+    const documents = [];
+    const skipped = [];
+    for (const sourcePath of matchedPaths) {
+        // Skip files in hidden (dot-prefixed) directories or hidden files
+        if (isInHiddenPath(sourcePath))
+            continue;
+        const fullPath = join(projectRoot, sourcePath);
+        if (!existsSync(fullPath))
+            continue;
+        // Read file and check constraints
+        let content;
+        let sizeBytes;
+        try {
+            const buffer = readFileSync(fullPath);
+            sizeBytes = buffer.length;
+            // Skip files exceeding size limit
+            if (sizeBytes > MAX_DOC_SIZE) {
+                const sizeMB = (sizeBytes / (1024 * 1024)).toFixed(1);
+                skipped.push(`Skipping ${sourcePath} (${sizeMB} MB) — exceeds 500KB limit`);
+                continue;
+            }
+            // Skip binary files (null byte check)
+            if (buffer.includes(0)) {
+                skipped.push(`Skipping ${sourcePath} — binary file`);
+                continue;
+            }
+            content = buffer.toString("utf-8");
+        }
+        catch {
+            continue; // Unreadable file — skip silently
+        }
+        // Compute content hash
+        const contentHash = createHash("sha256").update(content).digest("hex");
+        // Classify relative to cache
+        const cachedHash = cachedHashes[sourcePath];
+        let status;
+        if (!cachedHash) {
+            status = "new";
+        }
+        else if (cachedHash !== contentHash) {
+            status = "changed";
+        }
+        else {
+            status = "unchanged";
+        }
+        documents.push({
+            fileName: basename(sourcePath),
+            sourcePath,
+            content,
+            contentHash,
+            sizeBytes,
+            status,
+        });
+    }
+    // Report skipped files
+    for (const msg of skipped) {
+        process.stderr.write(`[adit] ${msg}\n`);
+    }
+    // Sort: new first, then changed, then unchanged
+    const order = { new: 0, changed: 1, unchanged: 2 };
+    documents.sort((a, b) => order[a.status] - order[b.status]);
+    return documents;
+}
+/**
+ * Load custom document discovery settings from the project's settings.json.
+ *
+ * The settings file is at `{projectRoot}/settings.json` and may contain:
+ * ```json
+ * { "projectLink": { "docPatterns": [...], "excludePatterns": [...] } }
+ * ```
+ *
+ * Returns undefined if no custom settings are found.
+ */
+export function loadDocSettings(projectRoot) {
+    const settingsPath = join(projectRoot, "settings.json");
+    if (!existsSync(settingsPath))
+        return undefined;
+    try {
+        const raw = JSON.parse(readFileSync(settingsPath, "utf-8"));
+        const projectLink = raw.projectLink;
+        if (!projectLink)
+            return undefined;
+        const opts = {};
+        if (Array.isArray(projectLink.docPatterns)) {
+            opts.patterns = projectLink.docPatterns;
+        }
+        if (Array.isArray(projectLink.excludePatterns)) {
+            opts.excludePatterns = projectLink.excludePatterns;
+        }
+        return Object.keys(opts).length > 0 ? opts : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=doc-discovery.js.map

package/dist/project-link/doc-discovery.js.map

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

package/dist/project-link/git-collector.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Git metadata collection for project link.
+ *
+ * Collects remote URL, branches, commit logs, and default branch
+ * using the existing @vkenliu/adit-engine git runner. All functions are
+ * fail-safe — they throw on critical errors (no git repo, no remote)
+ * but return empty arrays for non-critical failures.
+ */
+import type { GitBranch, GitCommit } from "./types.js";
+/** Collect the remote origin URL. Throws if no remote is configured. */
+export declare function collectRemoteUrl(cwd: string): Promise<string>;
+/**
+ * Detect the default branch name.
+ *
+ * Tries `git symbolic-ref refs/remotes/origin/HEAD` first (reliable
+ * if the remote HEAD is set). Falls back to checking for `main` then
+ * `master` branch existence.
+ */
+export declare function collectDefaultBranch(cwd: string): Promise<string | null>;
+/**
+ * Get the currently checked-out branch name.
+ *
+ * Uses `git branch --show-current` which returns an empty string
+ * in detached HEAD state. Returns null if not on a branch or if
+ * the command fails.
+ */
+export declare function collectCurrentBranch(cwd: string): Promise<string | null>;
+/**
+ * Collect all branches (local + remote) with their HEAD SHAs.
+ *
+ * Remote branches are included and deduplicated — if a local branch
+ * name matches a remote tracking branch, the local version is kept.
+ */
+export declare function collectBranches(cwd: string): Promise<GitBranch[]>;
+/**
+ * Options for collecting commit logs.
+ */
+export interface CollectCommitOptions {
+    /** Only return commits after this SHA (incremental sync). */
+    sinceCommitSha?: string | null;
+    /** Branch name to tag on each returned commit (legacy — prefer resolveCommitBranches). */
+    branch?: string | null;
+}
+/**
+ * Collect commit logs, optionally since a specific commit SHA.
+ *
+ * When `sinceCommitSha` is provided, only commits after that SHA
+ * are returned (incremental sync). Otherwise, all commits are returned.
+ * Commits are ordered newest-first (git log default).
+ *
+ * When `branch` is provided, each returned commit will have its
+ * `branch` field set to that value. For accurate per-commit branch
+ * assignment, use `resolveCommitBranches()` after collecting commits
+ * instead of this option.
+ *
+ * Format uses NUL (\x00) as record delimiter and SOH (\x01) as field
+ * delimiter so that pipe characters and newlines inside commit messages
+ * (%B = subject + body, multi-line) are preserved without ambiguity.
+ */
+export declare function collectCommitLogs(cwd: string, sinceCommitShaOrOptions?: string | null | CollectCommitOptions): Promise<GitCommit[]>;
+/**
+ * Resolve per-commit branch assignments for a set of commits.
+ *
+ * For each known branch, runs `git log <branch> --format=%H` to collect
+ * the SHAs reachable from that branch. Commits are assigned to the most
+ * specific branch (non-default branches take priority over the default
+ * branch, so a commit on `feature/x` that was later merged into `main`
+ * is attributed to `feature/x`).
+ *
+ * Only SHAs present in `commitShas` are assigned — this avoids building
+ * a map for the entire repository history when doing incremental sync.
+ *
+ * Mutates the `branch` field of each commit in `commits` in-place and
+ * also returns the same array for chaining convenience.
+ */
+export declare function resolveCommitBranches(cwd: string, commits: GitCommit[], branches: GitBranch[], defaultBranch: string | null): Promise<GitCommit[]>;
+/** Count total commits reachable from HEAD. */
+export declare function collectCommitCount(cwd: string): Promise<number>;
+/**
+ * Extract a project name from a git remote URL.
+ *
+ * Examples:
+ *   "https://github.com/user/my-repo.git" → "my-repo"
+ *   "git@github.com:user/my-repo.git"     → "my-repo"
+ *   "https://github.com/user/my-repo"     → "my-repo"
+ */
+export declare function projectNameFromRemoteUrl(url: string): string;
+//# sourceMappingURL=git-collector.d.ts.map

package/dist/project-link/git-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-collector.d.ts","sourceRoot":"","sources":["../../src/project-link/git-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,wEAAwE;AACxE,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAMnE;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmB9E;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAM9E;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAmCvE;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,oBAAoB,GAC7D,OAAO,CAAC,SAAS,EAAE,CAAC,CA6DtB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,SAAS,EAAE,EACpB,QAAQ,EAAE,SAAS,EAAE,EACrB,aAAa,EAAE,MAAM,GAAG,IAAI,GAC3B,OAAO,CAAC,SAAS,EAAE,CAAC,CA6CtB;AAED,+CAA+C;AAC/C,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIrE;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAmB5D"}