@flyingrobots/graft 0.4.0 → 0.6.0

package/dist/cli/main.js

@@ -0,0 +1,126 @@
+import { CAPABILITY_REGISTRY, cliCommandKey, cliCommandPath, } from "../contracts/capabilities.js";
+import { cliCommandMcpTool, } from "../contracts/output-schemas.js";
+import { startDaemonServer } from "../mcp/daemon-server.js";
+import { startStdioServer } from "../mcp/stdio-server.js";
+import { parseCommand, parseDaemonCommand, parseGlobalOptions, } from "./command-parser.js";
+import { describeCliFailure, writeCliError } from "./cli-error.js";
+import { runIndex } from "./index-cmd.js";
+import { runInit } from "./init.js";
+import { runLocalHistoryDag } from "./local-history-dag.js";
+import { runMigrateLocalHistory } from "./migrate-local-history.js";
+import { emitPeerCommand, invokePeerCommand, writeLine } from "./peer-command.js";
+export { resolveEntrypointArgs } from "./command-parser.js";
+function renderHelp(writer) {
+    writeLine(writer, "graft CLI");
+    writeLine(writer);
+    writeLine(writer, "No args prints help.");
+    writeLine(writer);
+    writeLine(writer, "Global options:");
+    writeLine(writer, "  --cwd <path>    Run a command against another repo root");
+    writeLine(writer, "  help            Show this help");
+    writeLine(writer, "  serve           Start the MCP stdio server");
+    writeLine(writer, "  daemon          Start the local MCP daemon");
+    writeLine(writer);
+    const grouped = new Map();
+    for (const capability of CAPABILITY_REGISTRY) {
+        if (capability.cliPath === undefined)
+            continue;
+        const section = capability.cliPath.length > 1 ? capability.cliPath[0] : "project";
+        const bucket = grouped.get(section) ?? [];
+        bucket.push({ path: capability.cliPath, description: capability.description });
+        grouped.set(section, bucket);
+    }
+    for (const section of ["project", "migrate", "read", "struct", "symbol", "diag"]) {
+        const entries = grouped.get(section);
+        if (entries === undefined)
+            continue;
+        writeLine(writer, `${section}:`);
+        for (const entry of entries) {
+            writeLine(writer, `  ${entry.path.join(" ")}    ${entry.description}`);
+        }
+        writeLine(writer);
+    }
+}
+export async function runCli(options = {}) {
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const baseCwd = options.cwd ?? process.cwd();
+    let cwd;
+    let argv;
+    try {
+        ({ cwd, argv } = parseGlobalOptions(baseCwd, options.args ?? process.argv.slice(2)));
+    }
+    catch (err) {
+        process.exitCode = 1;
+        writeCliError(stderr, err instanceof Error ? err.message : String(err), {
+            usage: "graft [--cwd <path>] <command> ...",
+            nextSteps: ["Run `graft help` to see the grouped command surface."],
+        });
+        return;
+    }
+    if (argv.length === 0 || argv[0] === "help" || argv[0] === "--help") {
+        renderHelp(stdout);
+        return;
+    }
+    if (argv[0] === "init") {
+        runInit({ cwd, args: argv.slice(1), stdout, stderr });
+        return;
+    }
+    if (argv[0] === "index") {
+        await runIndex({ cwd, args: argv.slice(1), stdout, stderr });
+        return;
+    }
+    if (argv[0] === "serve") {
+        if (argv.length > 1) {
+            process.exitCode = 1;
+            writeCliError(stderr, `Unexpected arguments: ${argv.slice(1).join(" ")}`, describeCliFailure(argv));
+            return;
+        }
+        await (options.startServer ?? startStdioServer)(cwd);
+        return;
+    }
+    if (argv[0] === "daemon") {
+        try {
+            const daemon = await (options.startDaemon ?? startDaemonServer)(parseDaemonCommand(cwd, argv.slice(1)));
+            writeLine(stdout, `Daemon listening on ${daemon.socketPath}`);
+        }
+        catch (err) {
+            process.exitCode = 1;
+            writeCliError(stderr, err instanceof Error ? err.message : String(err), describeCliFailure(argv));
+        }
+        return;
+    }
+    try {
+        const parsed = parseCommand([...argv]);
+        if (parsed.command === "migrate_local_history") {
+            await runMigrateLocalHistory({
+                cwd,
+                json: parsed.json,
+                stdout,
+                stderr,
+            });
+            return;
+        }
+        if (parsed.command === "diag_local_history_dag") {
+            await runLocalHistoryDag({
+                cwd,
+                limit: typeof parsed.args["limit"] === "number" ? parsed.args["limit"] : 12,
+                json: parsed.json,
+                stdout,
+                stderr,
+            });
+            return;
+        }
+        const tool = cliCommandMcpTool(parsed.command);
+        if (tool === null) {
+            throw new Error(`Command ${cliCommandKey(cliCommandPath(parsed.command))} has no MCP peer`);
+        }
+        const result = await invokePeerCommand(cwd, tool, parsed.args);
+        emitPeerCommand(parsed.command, result, parsed.json, stdout);
+    }
+    catch (err) {
+        process.exitCode = 1;
+        writeCliError(stderr, err instanceof Error ? err.message : String(err), describeCliFailure(argv));
+    }
+}
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

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

package/dist/cli/migrate-local-history.d.ts

@@ -0,0 +1,12 @@
+interface Writer {
+    write(chunk: string): unknown;
+}
+export interface RunMigrateLocalHistoryOptions {
+    readonly cwd: string;
+    readonly json: boolean;
+    readonly stdout?: Writer | undefined;
+    readonly stderr?: Writer | undefined;
+}
+export declare function runMigrateLocalHistory(options: RunMigrateLocalHistoryOptions): Promise<void>;
+export {};
+//# sourceMappingURL=migrate-local-history.d.ts.map

package/dist/cli/migrate-local-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate-local-history.d.ts","sourceRoot":"","sources":["../../src/cli/migrate-local-history.ts"],"names":[],"mappings":"AASA,UAAU,MAAM;IACd,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC;AAgDD,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAmDlG"}

package/dist/cli/migrate-local-history.js

@@ -0,0 +1,82 @@
+import * as path from "node:path";
+import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
+import { nodeFs } from "../adapters/node-fs.js";
+import { attachCliSchemaMeta, validateCliOutput } from "../contracts/output-schemas.js";
+import { migrateLegacyPersistedLocalHistoryToGraph } from "../mcp/persisted-local-history.js";
+import { openWarp } from "../warp/open.js";
+const codec = new CanonicalJsonCodec();
+function writeLine(writer, line = "") {
+    writer.write(`${line}\n`);
+}
+function emitJson(payload, writer) {
+    writer.write(`${codec.encode(validateCliOutput("migrate_local_history", attachCliSchemaMeta("migrate_local_history", payload)))}\n`);
+}
+function renderHuman(payload) {
+    return [
+        "Local History Migration",
+        `cwd: ${payload.cwd}`,
+        `graftDir: ${payload.graftDir}`,
+        `legacy artifacts discovered: ${String(payload.discoveredArtifacts)}`,
+        `legacy artifacts migrated: ${String(payload.migratedArtifacts)}`,
+        `malformed artifacts: ${String(payload.malformedArtifacts)}`,
+        `continuity records imported: ${String(payload.importedContinuityRecords)}`,
+        `read events imported: ${String(payload.importedReadEvents)}`,
+        `stage events imported: ${String(payload.importedStageEvents)}`,
+        `transition events imported: ${String(payload.importedTransitionEvents)}`,
+        `continuity records skipped: ${String(payload.skippedContinuityRecords)}`,
+        `read events skipped: ${String(payload.skippedReadEvents)}`,
+        `stage events skipped: ${String(payload.skippedStageEvents)}`,
+        `transition events skipped: ${String(payload.skippedTransitionEvents)}`,
+    ].join("\n");
+}
+export async function runMigrateLocalHistory(options) {
+    const stdout = options.stdout ?? process.stdout;
+    const stderr = options.stderr ?? process.stderr;
+    const graftDir = path.join(options.cwd, ".graft");
+    try {
+        const warp = await openWarp({ cwd: options.cwd });
+        const payload = {
+            cwd: options.cwd,
+            ...await migrateLegacyPersistedLocalHistoryToGraph({
+                fs: nodeFs,
+                codec,
+                graftDir,
+                graph: {
+                    warp,
+                    worktreeRoot: options.cwd,
+                },
+            }),
+        };
+        if (options.json) {
+            emitJson(payload, stdout);
+            return;
+        }
+        writeLine(stdout, renderHuman(payload));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.exitCode = 1;
+        const payload = {
+            cwd: options.cwd,
+            graftDir,
+            discoveredArtifacts: 0,
+            migratedArtifacts: 0,
+            malformedArtifacts: 0,
+            importedContinuityRecords: 0,
+            importedReadEvents: 0,
+            importedStageEvents: 0,
+            importedTransitionEvents: 0,
+            skippedContinuityRecords: 0,
+            skippedReadEvents: 0,
+            skippedStageEvents: 0,
+            skippedTransitionEvents: 0,
+            error: message,
+        };
+        if (options.json) {
+            emitJson(payload, stdout);
+            return;
+        }
+        writeLine(stderr, `Error: ${message}`);
+    }
+}
+//# sourceMappingURL=migrate-local-history.js.map

package/dist/cli/migrate-local-history.js.map

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

package/dist/cli/peer-command.d.ts

@@ -0,0 +1,9 @@
+import type { CliCommandName, McpToolName } from "../contracts/capabilities.js";
+import { type JsonObject } from "../contracts/json-object.js";
+export interface Writer {
+    write(chunk: string): unknown;
+}
+export declare function writeLine(writer: Writer, line?: string): void;
+export declare function emitPeerCommand(command: CliCommandName, data: JsonObject, json: boolean, writer: Writer): void;
+export declare function invokePeerCommand(cwd: string, tool: McpToolName, args: JsonObject): Promise<JsonObject>;
+//# sourceMappingURL=peer-command.d.ts.map

package/dist/cli/peer-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-command.d.ts","sourceRoot":"","sources":["../../src/cli/peer-command.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,EAAE,KAAK,UAAU,EAAuB,MAAM,6BAA6B,CAAC;AAUnF,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAUD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,SAAK,GAAG,IAAI,CAEzD;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,IAAI,CAYN;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,UAAU,CAAC,CAMrB"}

package/dist/cli/peer-command.js

@@ -0,0 +1,38 @@
+import * as path from "node:path";
+import { CanonicalJsonCodec } from "../adapters/canonical-json.js";
+import { parseJsonTextObject } from "../contracts/json-object.js";
+import { attachCliSchemaMeta, validateCliOutput, } from "../contracts/output-schemas.js";
+import { createGraftServer } from "../mcp/server.js";
+import { renderActivityView } from "./activity-render.js";
+const codec = new CanonicalJsonCodec();
+function parseToolResult(result) {
+    const payload = result.content.find((item) => item.type === "text");
+    if (payload === undefined) {
+        throw new Error("Tool result did not contain a text payload");
+    }
+    return parseJsonTextObject(payload.text, "Tool result");
+}
+export function writeLine(writer, line = "") {
+    writer.write(`${line}\n`);
+}
+export function emitPeerCommand(command, data, json, writer) {
+    const { _schema: _mcpSchema, ...rest } = data;
+    const validated = validateCliOutput(command, attachCliSchemaMeta(command, rest));
+    if (json) {
+        writer.write(`${codec.encode(validated)}\n`);
+        return;
+    }
+    if (command === "diag_activity") {
+        writer.write(`${renderActivityView(validated)}\n`);
+        return;
+    }
+    writer.write(`${JSON.stringify(validated, null, 2)}\n`);
+}
+export async function invokePeerCommand(cwd, tool, args) {
+    const server = createGraftServer({
+        projectRoot: cwd,
+        graftDir: path.join(cwd, ".graft"),
+    });
+    return parseToolResult(await server.callTool(tool, args));
+}
+//# sourceMappingURL=peer-command.js.map

package/dist/cli/peer-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-command.js","sourceRoot":"","sources":["../../src/cli/peer-command.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,OAAO,EAAmB,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACnF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAsB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,KAAK,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAMvC,SAAS,eAAe,CAAC,MAAqB;IAC5C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACpE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,mBAAmB,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,MAAc,EAAE,IAAI,GAAG,EAAE;IACjD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,OAAuB,EACvB,IAAgB,EAChB,IAAa,EACb,MAAc;IAEd,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;IAC9C,MAAM,SAAS,GAAG,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IACjF,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IACD,IAAI,OAAO,KAAK,eAAe,EAAE,CAAC;QAChC,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAkB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACnD,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,GAAW,EACX,IAAiB,EACjB,IAAgB;IAEhB,MAAM,MAAM,GAAG,iBAAiB,CAAC;QAC/B,WAAW,EAAE,GAAG;QAChB,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC;KACnC,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/dist/contracts/capabilities.d.ts

@@ -0,0 +1,44 @@
+export declare const MCP_TOOL_NAMES: readonly ["safe_read", "file_outline", "read_range", "changed_since", "graft_diff", "graft_since", "graft_map", "code_show", "code_find", "code_refs", "daemon_repos", "daemon_status", "daemon_sessions", "daemon_monitors", "monitor_start", "monitor_pause", "monitor_resume", "monitor_stop", "workspace_authorize", "workspace_authorizations", "workspace_revoke", "workspace_bind", "workspace_status", "activity_view", "causal_status", "causal_attach", "workspace_rebind", "run_capture", "state_save", "state_load", "set_budget", "explain", "doctor", "stats"];
+export type McpToolName = typeof MCP_TOOL_NAMES[number];
+export declare const CLI_COMMAND_NAMES: readonly ["init", "index", "migrate_local_history", "read_safe", "read_outline", "read_range", "read_changed", "struct_diff", "struct_since", "struct_map", "symbol_show", "symbol_find", "diag_doctor", "diag_activity", "diag_local_history_dag", "diag_explain", "diag_stats", "diag_capture"];
+export type CliCommandName = typeof CLI_COMMAND_NAMES[number];
+export declare const ENTRYPOINT_SURFACES: readonly ["api", "cli", "mcp"];
+export type EntrypointSurface = typeof ENTRYPOINT_SURFACES[number];
+export type ApiExposure = "tool_bridge" | "repo_workspace" | "structured_buffer";
+export type CliMcpParity = "peer" | "cli_only" | "mcp_only" | "not_applicable";
+export interface CapabilityMatrixRow {
+    readonly id: string;
+    readonly api: "Yes" | "No";
+    readonly cli: "Yes" | "No";
+    readonly mcp: "Yes" | "No";
+    readonly apiExposure: ApiExposure | "-";
+    readonly cliMcpParity: CliMcpParity;
+    readonly cliPath: string;
+    readonly mcpTool: McpToolName | "-";
+}
+export interface ThreeSurfaceCapabilityBaseline {
+    readonly cliOnly: number;
+    readonly apiCliMcp: number;
+    readonly apiMcp: number;
+    readonly apiOnly: number;
+}
+export interface CapabilityDefinition {
+    readonly id: string;
+    readonly description: string;
+    readonly mcpTool?: McpToolName | undefined;
+    readonly cliCommand?: CliCommandName | undefined;
+    readonly cliPath?: readonly [string, ...string[]] | undefined;
+    readonly apiExposure?: ApiExposure | undefined;
+    readonly surfaces: readonly EntrypointSurface[];
+    readonly cliMcpParity: CliMcpParity;
+}
+export declare const CAPABILITY_REGISTRY: readonly CapabilityDefinition[];
+export declare const API_EXPOSED_CAPABILITIES: readonly CapabilityDefinition[];
+export declare const CLI_COMMAND_PATHS: Readonly<Record<"read_range" | "init" | "index" | "migrate_local_history" | "read_safe" | "read_outline" | "read_changed" | "struct_diff" | "struct_since" | "struct_map" | "symbol_show" | "symbol_find" | "diag_doctor" | "diag_activity" | "diag_local_history_dag" | "diag_explain" | "diag_stats" | "diag_capture", readonly [string, ...string[]]>>;
+export declare const CLI_COMMAND_TO_MCP_TOOL: Readonly<Partial<Record<"read_range" | "init" | "index" | "migrate_local_history" | "read_safe" | "read_outline" | "read_changed" | "struct_diff" | "struct_since" | "struct_map" | "symbol_show" | "symbol_find" | "diag_doctor" | "diag_activity" | "diag_local_history_dag" | "diag_explain" | "diag_stats" | "diag_capture", "safe_read" | "file_outline" | "read_range" | "changed_since" | "graft_diff" | "graft_since" | "graft_map" | "code_show" | "code_find" | "code_refs" | "daemon_repos" | "daemon_status" | "daemon_sessions" | "daemon_monitors" | "monitor_start" | "monitor_pause" | "monitor_resume" | "monitor_stop" | "workspace_authorize" | "workspace_authorizations" | "workspace_revoke" | "workspace_bind" | "workspace_status" | "activity_view" | "causal_status" | "causal_attach" | "workspace_rebind" | "run_capture" | "state_save" | "state_load" | "set_budget" | "explain" | "doctor" | "stats">>>;
+export declare const CLI_ONLY_COMMANDS: readonly ("read_range" | "init" | "index" | "migrate_local_history" | "read_safe" | "read_outline" | "read_changed" | "struct_diff" | "struct_since" | "struct_map" | "symbol_show" | "symbol_find" | "diag_doctor" | "diag_activity" | "diag_local_history_dag" | "diag_explain" | "diag_stats" | "diag_capture")[];
+export declare function cliCommandPath(command: CliCommandName): readonly [string, ...string[]];
+export declare function cliCommandKey(path: readonly string[]): string;
+export declare function buildCapabilityMatrixRows(): readonly CapabilityMatrixRow[];
+export declare function buildThreeSurfaceCapabilityBaseline(): ThreeSurfaceCapabilityBaseline;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/contracts/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../../src/contracts/capabilities.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,8iBAmCjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAExD,eAAO,MAAM,iBAAiB,mSAmBpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE9D,eAAO,MAAM,mBAAmB,gCAAiC,CAAC;AAElE,MAAM,MAAM,iBAAiB,GAAG,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,GAAG,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,GAAG,CAAC;CACrC;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AA+BD,eAAO,MAAM,mBAAmB,EAAE,SAAS,oBAAoB,EA+QrD,CAAC;AAEX,eAAO,MAAM,wBAAwB,iCAEpC,CAAC;AAEF,eAAO,MAAM,iBAAiB,2VAI8B,CAAC;AAE7D,eAAO,MAAM,uBAAuB,w4BAIc,CAAC;AAEnD,eAAO,MAAM,iBAAiB,sTAE7B,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAEtF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAE7D;AAED,wBAAgB,yBAAyB,IAAI,SAAS,mBAAmB,EAAE,CAW1E;AAED,wBAAgB,mCAAmC,IAAI,8BAA8B,CAOpF"}