@jamesaphoenix/tx-cli 0.4.3

package/dist/commands/hooks.js

@@ -0,0 +1,365 @@
+/**
+ * Git hooks commands: hooks:install, hooks:uninstall, hooks:status
+ *
+ * Integrates tx with git post-commit hooks for automatic actions
+ * after commits (e.g., auto-sync).
+ */
+import { Effect } from "effect";
+import { existsSync, mkdirSync, writeFileSync, readFileSync, unlinkSync, chmodSync } from "node:fs";
+import { resolve, dirname } from "node:path";
+import { toJson } from "../output.js";
+import { flag, opt, parseIntOpt } from "../utils/parse.js";
+/** Default high-value file patterns */
+const DEFAULT_HIGH_VALUE_FILES = [
+    "package.json",
+    "tsconfig.json",
+    "*.config.ts",
+    "*.config.js",
+    "src/index.ts",
+    "src/index.js",
+];
+/** Default file change threshold for triggering verification */
+const DEFAULT_FILE_THRESHOLD = 10;
+/**
+ * Allowlist regex for file patterns safe to embed in bash scripts.
+ * Permits: alphanumeric, dots, underscores, hyphens, slashes, stars,
+ * question marks, and square brackets (for glob character classes).
+ * Rejects: quotes, backticks, $, ;, |, &, (), newlines, spaces, backslashes.
+ */
+const SAFE_PATTERN_RE = /^[a-zA-Z0-9._/*?\-[\]]+$/;
+/**
+ * Validate a file pattern for safe embedding in generated bash scripts.
+ * Rejects patterns containing shell metacharacters that could enable
+ * command injection when interpolated into grep -qE '...' expressions.
+ */
+export function isValidHookPattern(pattern) {
+    return pattern.length > 0 && SAFE_PATTERN_RE.test(pattern);
+}
+/**
+ * Validate that a file threshold is a safe positive integer.
+ * Returns the validated value or the default if invalid.
+ */
+function safeFileThreshold(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value > 0) {
+        return Math.floor(value);
+    }
+    return DEFAULT_FILE_THRESHOLD;
+}
+/**
+ * Read .txrc configuration file.
+ * Returns default config if file doesn't exist.
+ */
+export function readTxrc(projectDir) {
+    const txrcPath = resolve(projectDir, ".txrc");
+    const txrcJsonPath = resolve(projectDir, ".txrc.json");
+    let configPath;
+    if (existsSync(txrcJsonPath)) {
+        configPath = txrcJsonPath;
+    }
+    else if (existsSync(txrcPath)) {
+        configPath = txrcPath;
+    }
+    if (!configPath) {
+        return {};
+    }
+    try {
+        const content = readFileSync(configPath, "utf-8");
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Write .txrc configuration file.
+ */
+export function writeTxrc(projectDir, config) {
+    const txrcPath = resolve(projectDir, ".txrc.json");
+    const dir = dirname(txrcPath);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(txrcPath, JSON.stringify(config, null, 2) + "\n");
+}
+/**
+ * Find git root directory from current directory.
+ */
+export function findGitRoot(startDir) {
+    let dir = startDir;
+    while (dir !== "/") {
+        if (existsSync(resolve(dir, ".git"))) {
+            return dir;
+        }
+        dir = dirname(dir);
+    }
+    return null;
+}
+/**
+ * Generate the post-commit hook script content.
+ */
+export function generatePostCommitHook(config) {
+    const fileThreshold = safeFileThreshold(config.hooks?.fileThreshold);
+    const highValueFiles = config.hooks?.highValueFiles ?? DEFAULT_HIGH_VALUE_FILES;
+    // Filter out unsafe patterns to prevent command injection via grep -qE '...'
+    const safePatterns = highValueFiles.filter(pattern => {
+        if (!isValidHookPattern(pattern)) {
+            console.error(`[tx] Warning: Skipping unsafe hook pattern: "${pattern}"`);
+            return false;
+        }
+        return true;
+    });
+    // Generate the high-value file pattern matching
+    const highValuePatterns = safePatterns
+        .map(pattern => {
+        // Convert glob pattern to grep pattern
+        const grepPattern = pattern
+            .replace(/\./g, "\\.")
+            .replace(/\*/g, ".*");
+        return `echo "$CHANGED_FILES" | grep -qE '${grepPattern}'`;
+    })
+        .join(" || ");
+    return `#!/bin/bash
+# tx post-commit hook - Automatic sync after commits
+# Installed by: tx hooks:install
+# Documentation: https://github.com/tx/tx#git-hooks
+
+set -e
+
+# Skip if tx is not available
+if ! command -v tx &> /dev/null; then
+  exit 0
+fi
+
+# Skip if .txrc has hooks.enabled = false
+if [ -f ".txrc.json" ]; then
+  ENABLED=$(cat .txrc.json 2>/dev/null | grep -o '"enabled"[[:space:]]*:[[:space:]]*\\(true\\|false\\)' | grep -o '\\(true\\|false\\)' || echo "true")
+  if [ "$ENABLED" = "false" ]; then
+    exit 0
+  fi
+fi
+if [ -f ".txrc" ]; then
+  ENABLED=$(cat .txrc 2>/dev/null | grep -o '"enabled"[[:space:]]*:[[:space:]]*\\(true\\|false\\)' | grep -o '\\(true\\|false\\)' || echo "true")
+  if [ "$ENABLED" = "false" ]; then
+    exit 0
+  fi
+fi
+
+# Get changed files from the commit
+CHANGED_FILES=$(git diff-tree --no-commit-id --name-only -r HEAD 2>/dev/null || echo "")
+FILE_COUNT=$(echo "$CHANGED_FILES" | grep -c . 2>/dev/null || echo "0")
+
+# Check if we should trigger post-commit actions
+SHOULD_TRIGGER=false
+
+# Condition 1: More than ${fileThreshold} files changed
+if [ "$FILE_COUNT" -gt ${fileThreshold} ]; then
+  SHOULD_TRIGGER=true
+  echo "[tx] Large commit detected ($FILE_COUNT files)."
+fi
+
+# Condition 2: High-value files modified
+if [ "$SHOULD_TRIGGER" = "false" ] && [ -n "$CHANGED_FILES" ]; then
+  if ${highValuePatterns}; then
+    SHOULD_TRIGGER=true
+    echo "[tx] High-value files modified."
+  fi
+fi
+
+# Run auto-sync in background if conditions are met
+if [ "$SHOULD_TRIGGER" = "true" ]; then
+  echo "[tx] Running auto-sync in background..."
+  (tx sync export 2>/dev/null || true) &
+fi
+
+exit 0
+`;
+}
+/**
+ * tx hooks:install [--force] [--threshold <n>] [--high-value <patterns>]
+ * Install post-commit hook for anchor verification
+ */
+export const hooksInstall = (_pos, flags) => Effect.sync(() => {
+    const projectDir = process.cwd();
+    const gitRoot = findGitRoot(projectDir);
+    const jsonOutput = flag(flags, "json");
+    if (!gitRoot) {
+        if (jsonOutput) {
+            console.log(toJson({ success: false, error: "Not a git repository (or any parent up to mount point)" }));
+            return;
+        }
+        console.error("Error: Not a git repository (or any parent up to mount point)");
+        process.exit(1);
+    }
+    const hooksDir = resolve(gitRoot, ".git", "hooks");
+    const hookPath = resolve(hooksDir, "post-commit");
+    // Check if hook already exists
+    if (existsSync(hookPath) && !flag(flags, "force", "f")) {
+        const content = readFileSync(hookPath, "utf-8");
+        if (content.includes("tx post-commit hook")) {
+            if (jsonOutput) {
+                console.log(toJson({ success: false, error: "already_installed", message: "tx post-commit hook is already installed. Use --force to reinstall." }));
+                return;
+            }
+            console.log("tx post-commit hook is already installed.");
+            console.log("Use --force to reinstall.");
+            return;
+        }
+        if (jsonOutput) {
+            console.log(toJson({ success: false, error: "hook_exists", message: "A post-commit hook already exists. Use --force to overwrite." }));
+            return;
+        }
+        console.error("Error: A post-commit hook already exists.");
+        console.error("Use --force to overwrite, or manually integrate tx verification.");
+        process.exit(1);
+    }
+    // Read existing config or create default
+    let config = readTxrc(projectDir);
+    // Apply CLI options
+    const thresholdVal = parseIntOpt(flags, "threshold", "threshold", "t");
+    const highValue = opt(flags, "high-value", "h");
+    if (!config.hooks) {
+        config.hooks = {};
+    }
+    if (thresholdVal !== undefined && thresholdVal > 0) {
+        config.hooks.fileThreshold = thresholdVal;
+    }
+    if (highValue) {
+        const patterns = highValue.split(",").map(s => s.trim());
+        const invalid = patterns.filter(p => !isValidHookPattern(p));
+        if (invalid.length > 0) {
+            if (jsonOutput) {
+                console.log(toJson({ success: false, error: "invalid_patterns", message: `Unsafe patterns rejected: ${invalid.join(", ")}. Only alphanumeric, dots, slashes, stars, hyphens, underscores, question marks, and brackets are allowed.` }));
+                return;
+            }
+            console.error(`Error: Unsafe patterns rejected: ${invalid.join(", ")}`);
+            console.error("Patterns may only contain: a-z A-Z 0-9 . _ / * ? - [ ]");
+            process.exit(1);
+        }
+        config.hooks.highValueFiles = patterns;
+    }
+    config.hooks.enabled = true;
+    config.hooks.verifyOnCommit = true;
+    // Ensure hooks directory exists
+    if (!existsSync(hooksDir)) {
+        mkdirSync(hooksDir, { recursive: true });
+    }
+    // Generate and write the hook
+    const hookContent = generatePostCommitHook(config);
+    writeFileSync(hookPath, hookContent);
+    chmodSync(hookPath, 0o755);
+    // Save config to .txrc.json
+    writeTxrc(projectDir, config);
+    if (jsonOutput) {
+        console.log(toJson({
+            success: true,
+            hookPath,
+            config: {
+                fileThreshold: config.hooks.fileThreshold ?? DEFAULT_FILE_THRESHOLD,
+                highValueFiles: config.hooks.highValueFiles ?? DEFAULT_HIGH_VALUE_FILES,
+                enabled: true,
+                verifyOnCommit: true,
+            }
+        }));
+        return;
+    }
+    console.log("tx post-commit hook installed successfully!");
+    console.log();
+    console.log("Configuration:");
+    console.log(`  File threshold: ${config.hooks.fileThreshold ?? DEFAULT_FILE_THRESHOLD} files`);
+    console.log(`  High-value files: ${(config.hooks.highValueFiles ?? DEFAULT_HIGH_VALUE_FILES).join(", ")}`);
+    console.log();
+    console.log("The hook will automatically verify anchors when:");
+    console.log(`  - More than ${config.hooks.fileThreshold ?? DEFAULT_FILE_THRESHOLD} files are changed in a commit`);
+    console.log("  - Any high-value configuration files are modified");
+    console.log();
+    console.log("To disable, set hooks.enabled = false in .txrc.json");
+});
+/**
+ * tx hooks:uninstall
+ * Remove post-commit hook
+ */
+export const hooksUninstall = (_pos, flags) => Effect.sync(() => {
+    const projectDir = process.cwd();
+    const gitRoot = findGitRoot(projectDir);
+    const jsonOutput = flag(flags, "json");
+    if (!gitRoot) {
+        if (jsonOutput) {
+            console.log(toJson({ success: false, error: "Not a git repository (or any parent up to mount point)" }));
+            return;
+        }
+        console.error("Error: Not a git repository (or any parent up to mount point)");
+        process.exit(1);
+    }
+    const hookPath = resolve(gitRoot, ".git", "hooks", "post-commit");
+    if (!existsSync(hookPath)) {
+        if (jsonOutput) {
+            console.log(toJson({ success: false, error: "not_found", message: "No post-commit hook found." }));
+            return;
+        }
+        console.log("No post-commit hook found.");
+        return;
+    }
+    const content = readFileSync(hookPath, "utf-8");
+    if (!content.includes("tx post-commit hook")) {
+        if (jsonOutput) {
+            console.log(toJson({ success: false, error: "not_tx_hook", message: "Existing post-commit hook was not installed by tx." }));
+            return;
+        }
+        console.error("Error: Existing post-commit hook was not installed by tx.");
+        console.error("Please manually remove the hook if desired.");
+        process.exit(1);
+    }
+    unlinkSync(hookPath);
+    // Update config
+    const config = readTxrc(projectDir);
+    if (config.hooks) {
+        config.hooks.enabled = false;
+        config.hooks.verifyOnCommit = false;
+        writeTxrc(projectDir, config);
+    }
+    if (jsonOutput) {
+        console.log(toJson({ success: true, hookPath, message: "tx post-commit hook uninstalled." }));
+        return;
+    }
+    console.log("tx post-commit hook uninstalled.");
+});
+/**
+ * tx hooks:status [--json]
+ * Show current hook status
+ */
+export const hooksStatus = (_pos, flags) => Effect.sync(() => {
+    const projectDir = process.cwd();
+    const gitRoot = findGitRoot(projectDir);
+    const status = {
+        gitRoot,
+        hookInstalled: false,
+        hookPath: null,
+        config: readTxrc(projectDir),
+        enabled: false
+    };
+    if (gitRoot) {
+        const hookPath = resolve(gitRoot, ".git", "hooks", "post-commit");
+        status.hookPath = hookPath;
+        if (existsSync(hookPath)) {
+            const content = readFileSync(hookPath, "utf-8");
+            status.hookInstalled = content.includes("tx post-commit hook");
+        }
+    }
+    status.enabled = status.hookInstalled && (status.config.hooks?.enabled !== false);
+    if (flag(flags, "json")) {
+        console.log(toJson(status));
+        return;
+    }
+    console.log("tx Git Hook Status");
+    console.log();
+    console.log(`  Git root:       ${status.gitRoot ?? "Not found"} `);
+    console.log(`  Hook installed: ${status.hookInstalled ? "Yes" : "No"}`);
+    console.log(`  Hook enabled:   ${status.enabled ? "Yes" : "No"}`);
+    if (status.config.hooks) {
+        console.log();
+        console.log("Configuration (.txrc.json):");
+        console.log(`  File threshold:   ${status.config.hooks.fileThreshold ?? DEFAULT_FILE_THRESHOLD}`);
+        console.log(`  High-value files: ${(status.config.hooks.highValueFiles ?? DEFAULT_HIGH_VALUE_FILES).join(", ")}`);
+    }
+});
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

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

package/dist/commands/invariant.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Invariant commands: invariant list, invariant show, invariant record, invariant sync
+ */
+import { Effect } from "effect";
+import { DocService } from "@jamesaphoenix/tx-core";
+import { type Flags } from "../utils/parse.js";
+/** Dispatch invariant subcommands. */
+export declare const invariant: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").InvalidDocYamlError | import("@jamesaphoenix/tx-core").DocNotFoundError, DocService> | Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").InvariantNotFoundError, DocService>;
+//# sourceMappingURL=invariant.d.ts.map

package/dist/commands/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../../src/commands/invariant.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,EAAE,KAAK,KAAK,EAAa,MAAM,mBAAmB,CAAA;AAEzD,sCAAsC;AACtC,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,2UAgBpD,CAAA"}

package/dist/commands/invariant.js

@@ -0,0 +1,126 @@
+/**
+ * Invariant commands: invariant list, invariant show, invariant record, invariant sync
+ */
+import { Effect } from "effect";
+import { DocService } from "@jamesaphoenix/tx-core";
+import { toJson } from "../output.js";
+import { flag, opt } from "../utils/parse.js";
+/** Dispatch invariant subcommands. */
+export const invariant = (pos, flags) => {
+    const sub = pos[0];
+    const rest = pos.slice(1);
+    switch (sub) {
+        case "list": return invariantList(rest, flags);
+        case "show": return invariantShow(rest, flags);
+        case "record": return invariantRecord(rest, flags);
+        case "sync": return invariantSync(rest, flags);
+        default:
+            return Effect.sync(() => {
+                console.error(`Unknown invariant subcommand: ${sub ?? "(none)"}`);
+                console.error("Run 'tx invariant --help' for usage information");
+                process.exit(1);
+            });
+    }
+};
+const invariantList = (_pos, flags) => Effect.gen(function* () {
+    const subsystem = opt(flags, "subsystem", "s") ?? undefined;
+    const enforcement = opt(flags, "enforcement", "e") ?? undefined;
+    const svc = yield* DocService;
+    const invariants = yield* svc.listInvariants({ subsystem, enforcement });
+    if (flag(flags, "json")) {
+        console.log(toJson(invariants));
+    }
+    else {
+        if (invariants.length === 0) {
+            console.log("No invariants found");
+        }
+        else {
+            console.log(`${invariants.length} invariant(s):`);
+            for (const inv of invariants) {
+                const sub = inv.subsystem ? ` [${inv.subsystem}]` : " [system]";
+                const statusIcon = inv.status === "active" ? "●" : "○";
+                console.log(`  ${statusIcon} ${inv.id}${sub} (${inv.enforcement})`);
+                console.log(`    ${inv.rule}`);
+            }
+        }
+    }
+});
+const invariantShow = (pos, flags) => Effect.gen(function* () {
+    const id = pos[0];
+    if (!id) {
+        console.error("Usage: tx invariant show <id>");
+        process.exit(1);
+    }
+    const svc = yield* DocService;
+    // Find invariant by listing all and filtering (no direct get in service)
+    const all = yield* svc.listInvariants();
+    const inv = all.find(i => i.id === id);
+    if (!inv) {
+        console.error(`Invariant not found: ${id}`);
+        process.exit(1);
+    }
+    if (flag(flags, "json")) {
+        console.log(toJson(inv));
+    }
+    else {
+        console.log(`Invariant: ${inv.id}`);
+        console.log(`  Rule: ${inv.rule}`);
+        console.log(`  Enforcement: ${inv.enforcement}`);
+        console.log(`  Status: ${inv.status}`);
+        console.log(`  Subsystem: ${inv.subsystem ?? "system"}`);
+        if (inv.testRef)
+            console.log(`  Test ref: ${inv.testRef}`);
+        if (inv.lintRule)
+            console.log(`  Lint rule: ${inv.lintRule}`);
+        if (inv.promptRef)
+            console.log(`  Prompt ref: ${inv.promptRef}`);
+        console.log(`  Created: ${inv.createdAt.toISOString()}`);
+    }
+});
+const invariantRecord = (pos, flags) => Effect.gen(function* () {
+    const id = pos[0];
+    if (!id) {
+        console.error("Usage: tx invariant record <id> --passed|--failed [--details <text>]");
+        process.exit(1);
+    }
+    const passed = flag(flags, "passed");
+    const failed = flag(flags, "failed");
+    if (!passed && !failed) {
+        console.error("Must specify --passed or --failed");
+        process.exit(1);
+    }
+    const details = opt(flags, "details", "d") ?? undefined;
+    const svc = yield* DocService;
+    const check = yield* svc.recordInvariantCheck(id, passed, details);
+    if (flag(flags, "json")) {
+        console.log(toJson(check));
+    }
+    else {
+        const icon = check.passed ? "✓" : "✗";
+        console.log(`${icon} Recorded check for ${id}: ${check.passed ? "PASSED" : "FAILED"}`);
+        if (check.details)
+            console.log(`  Details: ${check.details}`);
+        console.log(`  Checked at: ${check.checkedAt.toISOString()}`);
+    }
+});
+const invariantSync = (_pos, flags) => Effect.gen(function* () {
+    const docName = opt(flags, "doc") ?? undefined;
+    const svc = yield* DocService;
+    const synced = yield* svc.syncInvariants(docName);
+    if (flag(flags, "json")) {
+        console.log(toJson({ synced: synced.length, invariants: synced }));
+    }
+    else {
+        if (synced.length === 0) {
+            console.log("No invariants found in doc YAML files");
+        }
+        else {
+            console.log(`Synced ${synced.length} invariant(s):`);
+            for (const inv of synced) {
+                const sub = inv.subsystem ? ` [${inv.subsystem}]` : " [system]";
+                console.log(`  ${inv.id}${sub} (${inv.enforcement}) ${inv.rule.slice(0, 60)}`);
+            }
+        }
+    }
+});
+//# sourceMappingURL=invariant.js.map

package/dist/commands/invariant.js.map

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

package/dist/commands/learning.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Learning commands: learning:add, learning:search, learning:recent, learning:helpful, context, learn, recall
+ */
+import { Effect } from "effect";
+import { LearningService, FileLearningService, TaskService, RetrievalError } from "@jamesaphoenix/tx-core";
+import { type Flags } from "../utils/parse.js";
+export declare const learningAdd: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").ValidationError | import("@jamesaphoenix/tx-core").DatabaseError, LearningService>;
+export declare const learningSearch: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | RetrievalError | import("@jamesaphoenix/tx-core").EmbeddingDimensionMismatchError, LearningService>;
+export declare const learningRecent: (_pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, LearningService>;
+export declare const learningHelpful: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").ValidationError | import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").LearningNotFoundError, LearningService>;
+export declare const context: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError | import("@jamesaphoenix/tx-core").TaskNotFoundError | RetrievalError | import("@jamesaphoenix/tx-core").EmbeddingDimensionMismatchError, TaskService | LearningService>;
+export declare const learn: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").ValidationError | import("@jamesaphoenix/tx-core").DatabaseError, FileLearningService>;
+export declare const recall: (pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, FileLearningService>;
+export declare const learningEmbed: (_pos: string[], flags: Flags) => Effect.Effect<void, import("@jamesaphoenix/tx-core").DatabaseError, LearningService>;
+export declare const learningHelp: (subcommand: string) => Effect.Effect<void, never, never>;
+//# sourceMappingURL=learning.d.ts.map

package/dist/commands/learning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"learning.d.ts","sourceRoot":"","sources":["../../src/commands/learning.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAS,MAAM,QAAQ,CAAA;AAItC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAoB,WAAW,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAK5H,OAAO,EAAE,KAAK,KAAK,EAAsD,MAAM,mBAAmB,CAAA;AAElG,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,4IAkCnD,CAAA;AAEJ,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,6KA4BtD,CAAA;AAEJ,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,yFAqBvD,CAAA;AAEJ,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,qMA2BvD,CAAA;AA4BJ,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,gPA0F/C,CAAA;AAEJ,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,gJAwB7C,CAAA;AAEJ,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,EAAE,OAAO,KAAK,6FA0C9C,CAAA;AAKJ,eAAO,MAAM,aAAa,GAAI,MAAM,MAAM,EAAE,EAAE,OAAO,KAAK,yFA2DtD,CAAA;AAGJ,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,sCAe3C,CAAA"}