@horizon-ai-dev/shokunin 0.1.0-alpha.1

package/dist/lib/smart-merge.js

@@ -0,0 +1,368 @@
+/**
+ * Smart-merge utilities for config files.
+ *
+ * Provides functions for merging plugin configuration into user's
+ * opencode.json without overwriting existing settings.
+ *
+ * Used by /sn-configure and /sn-update commands.
+ */
+// ============================================================================
+// Internal helpers
+// ============================================================================
+/**
+ * Check if a value is a plain object (not array, null, etc.)
+ */
+function isPlainObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        Object.prototype.toString.call(value) === "[object Object]");
+}
+/**
+ * Stringify a value for comparison purposes.
+ */
+function stringify(value) {
+    if (value === null || value === undefined) {
+        return JSON.stringify(value);
+    }
+    if (typeof value !== "object") {
+        return JSON.stringify(value);
+    }
+    return JSON.stringify(value, Object.keys(value).sort());
+}
+/**
+ * Deep equality check for two values.
+ */
+function deepEqual(a, b) {
+    return stringify(a) === stringify(b);
+}
+/**
+ * Deep clone a value using JSON serialization.
+ */
+function deepClone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+/**
+ * Build a path string from parent and key.
+ */
+function buildPath(parentPath, key) {
+    return parentPath ? `${parentPath}.${key}` : key;
+}
+// ============================================================================
+// Array merge
+// ============================================================================
+/**
+ * Merge arrays, adding only unique items from additions.
+ *
+ * Uses JSON.stringify for deep equality comparison of objects.
+ *
+ * @param existing - The existing array
+ * @param additions - Items to potentially add
+ * @returns New array with unique items from both
+ *
+ * @example
+ * ```ts
+ * mergeArrayUnique([1, 2, 3], [2, 3, 4]);
+ * // => [1, 2, 3, 4]
+ *
+ * mergeArrayUnique([{ a: 1 }], [{ a: 1 }, { b: 2 }]);
+ * // => [{ a: 1 }, { b: 2 }]
+ * ```
+ */
+export function mergeArrayUnique(existing, additions) {
+    const result = [...existing];
+    const existingSet = new Set(existing.map((item) => stringify(item)));
+    for (const item of additions) {
+        const key = stringify(item);
+        if (!existingSet.has(key)) {
+            result.push(item);
+            existingSet.add(key);
+        }
+    }
+    return result;
+}
+/**
+ * Handle the case when a key doesn't exist in existing object.
+ */
+function handleNewKey(ctx, key, newValue) {
+    ctx.merged[key] = deepClone(newValue);
+    ctx.hasChanges = true;
+}
+/**
+ * Handle merging two arrays.
+ */
+function handleArrayMerge(ctx, key, existingArray, newArray) {
+    const mergedArray = mergeArrayUnique(existingArray, newArray);
+    if (mergedArray.length !== existingArray.length) {
+        ctx.hasChanges = true;
+    }
+    ctx.merged[key] = mergedArray;
+}
+/**
+ * Handle merging two nested objects.
+ */
+function handleNestedObjectMerge(params) {
+    const { ctx, key, path, existingObj, newObj } = params;
+    const nestedResult = mergeObjectInternal(existingObj, newObj, path);
+    ctx.merged[key] = nestedResult.merged;
+    ctx.conflicts.push(...nestedResult.conflicts);
+    if (nestedResult.hasChanges) {
+        ctx.hasChanges = true;
+    }
+}
+/**
+ * Handle value conflicts (different primitive values).
+ */
+function handleConflict(ctx, path, existingValue, newValue) {
+    ctx.conflicts.push({
+        path,
+        existingValue,
+        newValue,
+    });
+    // Keep existing value on conflict
+}
+/**
+ * Internal merge implementation with lower complexity.
+ */
+function mergeObjectInternal(existing, additions, parentPath) {
+    const ctx = {
+        merged: { ...existing },
+        conflicts: [],
+        hasChanges: false,
+    };
+    for (const key of Object.keys(additions)) {
+        const path = buildPath(parentPath, key);
+        const existingValue = existing[key];
+        const newValue = additions[key];
+        if (!(key in existing)) {
+            handleNewKey(ctx, key, newValue);
+            continue;
+        }
+        if (Array.isArray(existingValue) && Array.isArray(newValue)) {
+            handleArrayMerge(ctx, key, existingValue, newValue);
+            continue;
+        }
+        const bothObjects = isPlainObject(existingValue) && isPlainObject(newValue);
+        if (bothObjects) {
+            handleNestedObjectMerge({
+                ctx,
+                key,
+                path,
+                existingObj: existingValue,
+                newObj: newValue,
+            });
+            continue;
+        }
+        if (!deepEqual(existingValue, newValue)) {
+            handleConflict(ctx, path, existingValue, newValue);
+        }
+    }
+    return ctx;
+}
+/**
+ * Deep merge two objects, detecting value conflicts.
+ *
+ * - For arrays: merges using mergeArrayUnique
+ * - For objects: recursively merges nested objects
+ * - For primitives: detects conflicts when values differ
+ *
+ * @param existing - The existing object
+ * @param additions - Object with values to merge in
+ * @returns Merged object and any conflicts detected
+ *
+ * @example
+ * ```ts
+ * mergeObject(
+ *   { a: 1, b: { c: 2 } },
+ *   { b: { d: 3 }, e: 4 }
+ * );
+ * // => { merged: { a: 1, b: { c: 2, d: 3 }, e: 4 }, conflicts: [] }
+ *
+ * mergeObject({ a: 1 }, { a: 2 });
+ * // => { merged: { a: 1 }, conflicts: [{ path: 'a', existingValue: 1, newValue: 2 }] }
+ * ```
+ */
+export function mergeObject(existing, additions) {
+    return mergeObjectInternal(existing, additions, "");
+}
+// ============================================================================
+// Change collection - helpers for reduced complexity
+// ============================================================================
+/**
+ * Handle new key addition in change collection.
+ */
+function recordAddition(changes, path, newValue) {
+    changes.push({ type: "added", path, value: newValue });
+}
+/**
+ * Handle array modification in change collection.
+ */
+function recordArrayChange(changes, path, existingArray, newArray) {
+    const existingSet = new Set(existingArray.map((item) => stringify(item)));
+    const newItems = newArray.filter((item) => !existingSet.has(stringify(item)));
+    if (newItems.length > 0) {
+        changes.push({
+            type: "modified",
+            path,
+            value: newItems,
+            previousValue: `(array with ${existingArray.length} items)`,
+        });
+    }
+}
+/**
+ * Record a value conflict in change collection.
+ */
+function recordConflict(changes, path, existingValue, newValue) {
+    changes.push({
+        type: "conflict",
+        path,
+        value: newValue,
+        previousValue: existingValue,
+    });
+}
+/**
+ * Recursively collect changes between original and additions.
+ */
+function collectChanges(original, additions, parentPath, changes) {
+    for (const key of Object.keys(additions)) {
+        const path = buildPath(parentPath, key);
+        const existingValue = original[key];
+        const newValue = additions[key];
+        if (!(key in original)) {
+            recordAddition(changes, path, newValue);
+            continue;
+        }
+        if (Array.isArray(existingValue) && Array.isArray(newValue)) {
+            recordArrayChange(changes, path, existingValue, newValue);
+            continue;
+        }
+        const bothObjects = isPlainObject(existingValue) && isPlainObject(newValue);
+        if (bothObjects) {
+            collectChanges(existingValue, newValue, path, changes);
+            continue;
+        }
+        if (!deepEqual(existingValue, newValue)) {
+            recordConflict(changes, path, existingValue, newValue);
+        }
+    }
+}
+// ============================================================================
+// Summary formatting - helpers for reduced complexity
+// ============================================================================
+/**
+ * Format added changes for summary.
+ */
+function formatAddedChanges(added) {
+    if (added.length === 0) {
+        return "";
+    }
+    let result = "Added:\n";
+    for (const change of added) {
+        result += `  + ${change.path}\n`;
+    }
+    return result;
+}
+/**
+ * Format modified changes for summary.
+ */
+function formatModifiedChanges(modified) {
+    if (modified.length === 0) {
+        return "";
+    }
+    let result = "Modified:\n";
+    for (const change of modified) {
+        result += `  ~ ${change.path}\n`;
+    }
+    return result;
+}
+/**
+ * Format conflict changes for summary.
+ */
+function formatConflictChanges(conflicts) {
+    if (conflicts.length === 0) {
+        return "";
+    }
+    let result = "Conflicts (existing value kept):\n";
+    for (const change of conflicts) {
+        const existing = JSON.stringify(change.previousValue);
+        const newVal = JSON.stringify(change.value);
+        result += `  ! ${change.path}: existing=${existing}, new=${newVal}\n`;
+    }
+    return result;
+}
+/**
+ * Build summary header with counts.
+ */
+function buildSummaryHeader(added, modified, conflicts) {
+    const parts = [];
+    if (added.length > 0) {
+        parts.push(`${added.length} addition${added.length > 1 ? "s" : ""}`);
+    }
+    if (modified.length > 0) {
+        parts.push(`${modified.length} modification${modified.length > 1 ? "s" : ""}`);
+    }
+    if (conflicts.length > 0) {
+        parts.push(`${conflicts.length} conflict${conflicts.length > 1 ? "s" : ""}`);
+    }
+    return `Changes: ${parts.join(", ")}.\n\n`;
+}
+/**
+ * Format changes into a human-readable summary.
+ */
+function formatChangesSummary(changes) {
+    if (changes.length === 0) {
+        return "No changes needed.";
+    }
+    const added = changes.filter((c) => c.type === "added");
+    const modified = changes.filter((c) => c.type === "modified");
+    const conflicts = changes.filter((c) => c.type === "conflict");
+    let summary = buildSummaryHeader(added, modified, conflicts);
+    summary += formatAddedChanges(added);
+    summary += formatModifiedChanges(modified);
+    summary += formatConflictChanges(conflicts);
+    return summary.trim();
+}
+// ============================================================================
+// Public API - preview and dry run
+// ============================================================================
+/**
+ * Preview the changes that would be made by merging additions into existing.
+ *
+ * @param original - The original object
+ * @param additions - Object with values to merge in
+ * @returns Preview with list of changes and human-readable summary
+ *
+ * @example
+ * ```ts
+ * const preview = previewChanges(
+ *   { a: 1, b: 2 },
+ *   { b: 3, c: 4 }
+ * );
+ * // preview.changes = [
+ * //   { type: 'conflict', path: 'b', value: 3, previousValue: 2 },
+ * //   { type: 'added', path: 'c', value: 4 }
+ * // ]
+ * ```
+ */
+export function previewChanges(original, additions) {
+    const changes = [];
+    collectChanges(original, additions, "", changes);
+    const summary = formatChangesSummary(changes);
+    return { changes, summary };
+}
+/**
+ * Perform a merge operation in dry-run mode.
+ *
+ * Returns the merge result without modifying anything,
+ * along with a preview of what would change.
+ *
+ * @param original - The original object
+ * @param additions - Object with values to merge in
+ * @returns Merge result and preview
+ */
+export function dryRunMerge(original, additions) {
+    const result = mergeObject(original, additions);
+    const preview = previewChanges(original, additions);
+    return { result, preview };
+}
+//# sourceMappingURL=smart-merge.js.map

package/dist/lib/smart-merge.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Shokunin Plugin
+ *
+ * Wraps and extends the opencode-beads plugin with additional
+ * Shokunin-specific functionality.
+ *
+ * Inherited from opencode-beads:
+ * - Context injection via `bd prime` on session start and after compaction
+ * - Commands parsed from beads command definitions
+ * - beads-task-agent for autonomous issue completion
+ *
+ * Shokunin agents (sn- prefix):
+ * - sn-code-reviewer (primary) - Comprehensive code review
+ * - sn-code-simplifier (subagent) - Code simplification
+ * - sn-comment-analyzer (subagent) - Comment quality analysis
+ * - sn-pr-test-analyzer (subagent) - Test coverage analysis
+ * - sn-silent-failure-hunter (subagent) - Error handling analysis
+ * - sn-type-design-analyzer (subagent) - TypeScript type design
+ * - sn-skill-reviewer (subagent) - OpenCode skill review
+ */
+import type { Plugin } from "@opencode-ai/plugin";
+/**
+ * The main Shokunin plugin export.
+ *
+ * Wraps BeadsPlugin and merges any additional Shokunin-specific hooks.
+ * This allows extending the plugin functionality while maintaining
+ * full compatibility with opencode-beads.
+ */
+export declare const ShokuninPlugin: Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAS,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAkDzD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,MA4E5B,CAAC"}

package/dist/plugin.js

@@ -0,0 +1,133 @@
+/**
+ * Shokunin Plugin
+ *
+ * Wraps and extends the opencode-beads plugin with additional
+ * Shokunin-specific functionality.
+ *
+ * Inherited from opencode-beads:
+ * - Context injection via `bd prime` on session start and after compaction
+ * - Commands parsed from beads command definitions
+ * - beads-task-agent for autonomous issue completion
+ *
+ * Shokunin agents (sn- prefix):
+ * - sn-code-reviewer (primary) - Comprehensive code review
+ * - sn-code-simplifier (subagent) - Code simplification
+ * - sn-comment-analyzer (subagent) - Comment quality analysis
+ * - sn-pr-test-analyzer (subagent) - Test coverage analysis
+ * - sn-silent-failure-hunter (subagent) - Error handling analysis
+ * - sn-type-design-analyzer (subagent) - TypeScript type design
+ * - sn-skill-reviewer (subagent) - OpenCode skill review
+ */
+import { BeadsPlugin } from "opencode-beads";
+// Shokunin agents
+import { snCodeReviewerAgent } from "./agents/sn-code-reviewer.js";
+import { snCodeSimplifierAgent } from "./agents/sn-code-simplifier.js";
+import { snCommentAnalyzerAgent } from "./agents/sn-comment-analyzer.js";
+import { snPrTestAnalyzerAgent } from "./agents/sn-pr-test-analyzer.js";
+import { snSilentFailureHunterAgent } from "./agents/sn-silent-failure-hunter.js";
+import { snSkillReviewerAgent } from "./agents/sn-skill-reviewer.js";
+import { snTypeDesignAnalyzerAgent } from "./agents/sn-type-design-analyzer.js";
+// Shokunin commands
+import { snCheckConfigCommand } from "./commands/sn-check-config.js";
+import { snConfigureCommand } from "./commands/sn-configure.js";
+import { snReviewPrCommand } from "./commands/sn-review-pr.js";
+import { snUpdateCommand } from "./commands/sn-update.js";
+// Shokunin context
+import { looksLikeCompaction, SHOKUNIN_RULES, } from "./context/shokunin-rules.js";
+// Shokunin tools
+import { shokuninTools } from "./tools/emergency-stop.js";
+/**
+ * All Shokunin commands merged together.
+ */
+const shokuninCommands = {
+    ...snCheckConfigCommand,
+    ...snConfigureCommand,
+    ...snReviewPrCommand,
+    ...snUpdateCommand,
+};
+/**
+ * All Shokunin agents merged together.
+ */
+const shokuninAgents = {
+    ...snCodeReviewerAgent,
+    ...snCodeSimplifierAgent,
+    ...snCommentAnalyzerAgent,
+    ...snPrTestAnalyzerAgent,
+    ...snSilentFailureHunterAgent,
+    ...snTypeDesignAnalyzerAgent,
+    ...snSkillReviewerAgent,
+};
+/**
+ * The main Shokunin plugin export.
+ *
+ * Wraps BeadsPlugin and merges any additional Shokunin-specific hooks.
+ * This allows extending the plugin functionality while maintaining
+ * full compatibility with opencode-beads.
+ */
+export const ShokuninPlugin = async (input) => {
+    const { client } = input;
+    // Get hooks from BeadsPlugin
+    const beadsHooks = await BeadsPlugin(input);
+    // Track sessions that have received shokunin-rules context
+    const injectedSessions = new Set();
+    // Shokunin-specific hooks
+    const shokuninHooks = {
+        config: async (config) => {
+            // Inject Shokunin agents
+            config.agent = {
+                ...config.agent,
+                ...shokuninAgents,
+            };
+            // Inject Shokunin commands
+            config.command = {
+                ...config.command,
+                ...shokuninCommands,
+            };
+            // Call beads config hook if it exists
+            if (beadsHooks.config) {
+                await beadsHooks.config(config);
+            }
+        },
+        // Register Shokunin tools
+        tool: shokuninTools,
+        // Inject shokunin-rules context on first message and after compaction
+        "chat.message": async (hookInput, output) => {
+            const sessionID = hookInput.sessionID;
+            // Get the first text part from the message
+            const textPart = output.parts.find((p) => p.type === "text");
+            const messageText = textPart?.type === "text" ? textPart.text : "";
+            // Check if this is a new session or post-compaction
+            const isNewSession = !injectedSessions.has(sessionID);
+            const isPostCompaction = looksLikeCompaction(messageText);
+            // Inject context if needed
+            if (isNewSession || isPostCompaction) {
+                try {
+                    await client.session.prompt({
+                        path: { id: sessionID },
+                        body: {
+                            noReply: true,
+                            model: hookInput.model,
+                            agent: hookInput.agent,
+                            parts: [{ type: "text", text: SHOKUNIN_RULES, synthetic: true }],
+                        },
+                    });
+                    injectedSessions.add(sessionID);
+                }
+                catch {
+                    // Silent skip if injection fails
+                }
+            }
+            // Call beads chat.message hook if it exists
+            if (beadsHooks["chat.message"]) {
+                await beadsHooks["chat.message"](hookInput, output);
+            }
+        },
+    };
+    // Merge hooks - shokunin hooks override beads hooks when both exist
+    // This ensures our config hook runs and then calls beads' config hook
+    return {
+        ...beadsHooks,
+        ...shokuninHooks,
+    };
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

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

package/dist/tools/emergency-stop.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Emergency Stop Tool
+ *
+ * Plays terminal bell to alert users when the LLM needs human input.
+ * Works through SSH and VS Code Remote by using the terminal bell character.
+ */
+import type { Hooks } from "@opencode-ai/plugin";
+/**
+ * Emergency stop tool for the Shokunin plugin.
+ *
+ * Plays terminal bell to alert users when human input is required.
+ * Returns the tool definition directly - TypeScript will infer the Hooks["tool"] type.
+ */
+export declare const shokuninTools: Hooks["tool"];
+//# sourceMappingURL=emergency-stop.d.ts.map

package/dist/tools/emergency-stop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emergency-stop.d.ts","sourceRoot":"","sources":["../../src/tools/emergency-stop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AA2DjD;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,MAAM,CAkDvC,CAAC"}

package/dist/tools/emergency-stop.js

@@ -0,0 +1,97 @@
+/**
+ * Emergency Stop Tool
+ *
+ * Plays terminal bell to alert users when the LLM needs human input.
+ * Works through SSH and VS Code Remote by using the terminal bell character.
+ */
+import { tool } from "@opencode-ai/plugin";
+/**
+ * Number of bells to play based on urgency level.
+ */
+const URGENCY_BELLS = {
+    low: 1,
+    medium: 3,
+    high: 5,
+};
+/**
+ * Plays the terminal bell character the specified number of times.
+ * The bell character (\x07) works through SSH and VS Code Remote.
+ */
+function playBells(count) {
+    for (let i = 0; i < count; i++) {
+        process.stdout.write("\x07");
+    }
+}
+/**
+ * Formats the alert message for the LLM context window.
+ */
+function formatAlertMessage(reason, urgency, context) {
+    const timestamp = new Date().toISOString();
+    const urgencyLabel = urgency.toUpperCase();
+    const bellCount = URGENCY_BELLS[urgency];
+    let message = `
+## EMERGENCY STOP ALERT
+
+**Timestamp:** ${timestamp}
+**Urgency:** ${urgencyLabel} (${bellCount} bell${bellCount > 1 ? "s" : ""})
+**Reason:** ${reason}
+`;
+    if (context) {
+        message += `
+**Context:**
+${context}
+`;
+    }
+    message += `
+---
+*Alert sound played. Waiting for human input.*
+`;
+    return message.trim();
+}
+/**
+ * Emergency stop tool for the Shokunin plugin.
+ *
+ * Plays terminal bell to alert users when human input is required.
+ * Returns the tool definition directly - TypeScript will infer the Hooks["tool"] type.
+ */
+export const shokuninTools = {
+    emergency_stop: tool({
+        description: "Play an alert sound (terminal bell) to notify the user that their attention is required. " +
+            "Use when: (1) you encounter a critical decision that requires human judgment, " +
+            "(2) you find a potential security issue that needs review, " +
+            "(3) you're blocked and cannot proceed without clarification, " +
+            "(4) you've completed a significant milestone and need review, or " +
+            "(5) you encounter an error you cannot resolve autonomously.",
+        args: {
+            reason: tool.schema
+                .string()
+                .describe("The reason why human input is needed"),
+            urgency: tool.schema
+                .enum(["low", "medium", "high"])
+                .optional()
+                .default("medium")
+                .describe("Urgency level: low (1 bell), medium (3 bells), high (5 bells). Defaults to medium."),
+            context: tool.schema
+                .string()
+                .optional()
+                .describe("Additional context about the situation"),
+            repeat_interval_seconds: tool.schema
+                .number()
+                .optional()
+                .describe("If provided, repeat the alert at this interval until user responds (not implemented in initial version)"),
+            max_repeats: tool.schema
+                .number()
+                .optional()
+                .describe("Maximum number of times to repeat the alert (not implemented in initial version)"),
+        },
+        execute(args, _context) {
+            const urgency = (args.urgency ?? "medium");
+            const bellCount = URGENCY_BELLS[urgency];
+            // Play terminal bells
+            playBells(bellCount);
+            // Return formatted message for LLM context
+            return Promise.resolve(formatAlertMessage(args.reason, urgency, args.context));
+        },
+    }),
+};
+//# sourceMappingURL=emergency-stop.js.map

package/dist/tools/emergency-stop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emergency-stop.js","sourceRoot":"","sources":["../../src/tools/emergency-stop.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C;;GAEG;AACH,MAAM,aAAa,GAAG;IACpB,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;CACC,CAAC;AAIX;;;GAGG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CACzB,MAAc,EACd,OAAqB,EACrB,OAAgB;IAEhB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IAEzC,IAAI,OAAO,GAAG;;;iBAGC,SAAS;eACX,YAAY,KAAK,SAAS,QAAQ,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE;cAC3D,MAAM;CACnB,CAAC;IAEA,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,IAAI;;EAEb,OAAO;CACR,CAAC;IACA,CAAC;IAED,OAAO,IAAI;;;CAGZ,CAAC;IAEA,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,cAAc,EAAE,IAAI,CAAC;QACnB,WAAW,EACT,2FAA2F;YAC3F,gFAAgF;YAChF,6DAA6D;YAC7D,+DAA+D;YAC/D,mEAAmE;YACnE,6DAA6D;QAC/D,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;iBAChB,MAAM,EAAE;iBACR,QAAQ,CAAC,sCAAsC,CAAC;YACnD,OAAO,EAAE,IAAI,CAAC,MAAM;iBACjB,IAAI,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;iBAC/B,QAAQ,EAAE;iBACV,OAAO,CAAC,QAAQ,CAAC;iBACjB,QAAQ,CACP,oFAAoF,CACrF;YACH,OAAO,EAAE,IAAI,CAAC,MAAM;iBACjB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,wCAAwC,CAAC;YACrD,uBAAuB,EAAE,IAAI,CAAC,MAAM;iBACjC,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,yGAAyG,CAC1G;YACH,WAAW,EAAE,IAAI,CAAC,MAAM;iBACrB,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,kFAAkF,CACnF;SACJ;QACD,OAAO,CAAC,IAAI,EAAE,QAAQ;YACpB,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAiB,CAAC;YAC3D,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;YAEzC,sBAAsB;YACtB,SAAS,CAAC,SAAS,CAAC,CAAC;YAErB,2CAA2C;YAC3C,OAAO,OAAO,CAAC,OAAO,CACpB,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CACvD,CAAC;QACJ,CAAC;KACF,CAAC;CACH,CAAC"}