mimetic-cli 0.1.2 → 0.1.4

package/AGENTS.md

@@ -0,0 +1,66 @@
+# AGENTS.md
+
+Agent instructions for `mimetic-cli`.
+
+## Public Boundary
+
+Assume this repository is public.
+
+Hard rule: never commit, paste, preserve, or generate PII, PHI, secrets, keys,
+tokens, raw private transcripts, private screenshots, private customer data,
+private patient data, or private source snippets.
+
+- Use synthetic personas, synthetic emails, synthetic screenshots, and redacted
+  proof examples only.
+- Do not copy `.env*`, credential files, hosted logs with identifiers, or
+  artifact bundles that may contain sensitive user data.
+- Do not let private upstream context leak into docs, examples, issue
+  bodies, fixtures, tests, Observer screenshots, or generated run bundles.
+- If an artifact might contain PII, PHI, credentials, or private operational
+  context, summarize the shape and keep the raw artifact outside this repo.
+- Public usefulness beats private convenience. When in doubt, redact,
+  synthesize, or stop and ask.
+
+## Mission
+
+- Build a reusable CLI and harness standard for persona simulation.
+- Keep reusable substrate in core code and product truth in adapters.
+- Make product feedback loops cheap: run manifests, scenario profiles, actor
+  traces, Observer views, review packets, and proof artifacts.
+- Treat run bundles as the source of truth and Observer as the projection.
+
+## Architecture Principles
+
+- Adapter-first, not config sprawl: product-specific apps, ports, env
+  allowlists, routes, scenarios, milestones, and review vocabulary belong in
+  adapters.
+- Core owns generic primitives: manifests, artifact layout, source packaging,
+  actor orchestration, lifecycle events, Observer rendering, run review, and
+  history indexing.
+- CLI JSON envelopes must be truthful. Unsupported capabilities fail closed
+  with structured errors.
+- Proof artifacts are API surface. Treat paths, schemas, and review packets as
+  durable contracts.
+- Prefer fixtures and contract tests over prose claims.
+
+## Development Rules
+
+- Keep `main` clean. Use scoped branches or worktrees for feature work.
+- Make small commits with explicit scope.
+- Before substantial work, read [`docs/ramp/README.md`](docs/ramp/README.md)
+  and [`docs/goals/current.md`](docs/goals/current.md).
+- Do not commit generated proof artifacts, local env files, E2B/runtime caches,
+  `.npmrc`, packed tarballs, or provider credentials.
+- Before extracting from any source project, classify the code as core, CLI
+  shell, Observer, adapter contract, or example adapter.
+- Before publishing, run the release gates in
+  [`docs/release/open-source-readiness.md`](docs/release/open-source-readiness.md).
+
+## Acceptance Bar
+
+- A change is not done until it has command-level proof.
+- Harness changes need tests or fixture artifacts that prove the contract.
+- Adapter changes need at least one safe dry-run path and one realistic path
+  where credentials allow it.
+- End substantial work with what changed, what was checked, and what remains
+  uncertain.

package/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing
+
+Thanks for helping make Mimetic better.
+
+## Ground Rules
+
+- Keep examples synthetic and public-safe.
+- Do not commit `.env*`, `.npmrc`, `.mimetic/`, generated run bundles, provider
+  credentials, private screenshots, raw transcripts, or customer data.
+- Prefer small PRs with explicit proof commands.
+- Keep product-specific route names, milestones, and vocabulary in adapters.
+- If a change touches credentials, provider spend, hosted execution, or GitHub
+  mutation, document the stop conditions and use dry-run proof first.
+
+## Local Setup
+
+```bash
+pnpm install
+pnpm check
+pnpm public-surface:scan
+```
+
+## Useful Commands
+
+```bash
+pnpm mimetic -- --help
+pnpm mimetic -- watch --json --no-open
+pnpm mimetic -- verify --run latest --json
+pnpm pack:dry-run
+```
+
+## Pull Requests
+
+PRs should include:
+
+- a concise summary;
+- proof commands and outcomes;
+- any remaining gaps;
+- confirmation that fixtures and examples are synthetic or redacted.

package/README.md

@@ -9,7 +9,7 @@ It creates committed simulation source under `mimetic/`, ignored run evidence
 under `.mimetic/`, a watchable Observer UI, verification gates, and public-safe
 feedback drafts.
 
-![Mimetic OSS Lab Observer showing four headed E2B desktops, each with a nested Mimetic Observer open](https://unpkg.com/mimetic-cli@0.1.2/docs/assets/mimetic-oss-lab-observer.png)
+![Mimetic Observer mission control: synthetic personas attempting first-run setup across browser, CLI, TUI, and Codex lanes, with blocked and failed lanes surfaced for review](https://unpkg.com/mimetic-cli@latest/docs/assets/mimetic-oss-lab-observer.png)
 
 ## Install
 
@@ -123,6 +123,8 @@ pnpm mimetic:feedback
 
 ## Docs
 
+- [Ramp for future contributors and agents](docs/ramp/README.md)
+- [Current goals](docs/goals/current.md)
 - [Project layout](docs/architecture/project-layout.md)
 - [Observer architecture](docs/architecture/observer.md)
 - [OSS lab POC](docs/architecture/oss-lab-poc.md)
@@ -131,6 +133,7 @@ pnpm mimetic:feedback
 - [Self-driving harness principles](docs/principles/self-driving-harness.md)
 - [World-class open-source v0 roadmap](docs/roadmap/world-class-open-source-v0.md)
 - [Open-source release readiness](docs/release/open-source-readiness.md)
+- [Public readiness standard](docs/release/public-readiness-standard.md)
 
 ## Release Status
 

package/SECURITY.md

@@ -0,0 +1,34 @@
+# Security Policy
+
+## Public-Safety Boundary
+
+Mimetic must not contain or emit PII, PHI, secrets, keys, tokens, raw private
+transcripts, private screenshots, private customer data, private patient data,
+or private source snippets.
+
+Do not file public issues that contain sensitive data. Redact the data and
+describe the class of problem instead.
+
+## Reporting A Vulnerability
+
+If you find a security issue, open a minimal public issue only when the report
+does not disclose exploitable details or sensitive data. Otherwise, contact the
+maintainer privately through the repository owner profile.
+
+Include:
+
+- affected version or commit;
+- command run;
+- safe reproduction steps;
+- redacted evidence path or synthetic fixture;
+- whether any generated `.mimetic/` artifact may contain sensitive data.
+
+## Maintainer Release Checks
+
+Before any public release, run:
+
+```bash
+pnpm check
+pnpm public-surface:scan
+pnpm pack:dry-run
+```

package/dist/core/git-state.d.ts

@@ -0,0 +1,31 @@
+export declare const GIT_STATE_SCHEMA = "mimetic.git-state.v1";
+export type GitStateStatus = "clean" | "dirty" | "missing" | "unavailable";
+export type GitRefState = "attached" | "detached" | "unborn" | "unknown";
+export interface GitStateChangeSummary {
+    staged: number;
+    unstaged: number;
+    untracked: number;
+    total: number;
+}
+export interface CapturedGitState {
+    schema: typeof GIT_STATE_SCHEMA;
+    status: GitStateStatus;
+    capturedAt: string;
+    head: {
+        shortSha: string | null;
+        refState: GitRefState;
+    };
+    changes: GitStateChangeSummary;
+    note: string;
+}
+export interface GitCommandResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+}
+export type GitCommandRunner = (args: string[], cwd: string) => Promise<GitCommandResult>;
+export declare function captureGitState(cwd: string, options?: {
+    capturedAt?: Date | string;
+    runner?: GitCommandRunner;
+}): Promise<CapturedGitState>;
+export declare function summarizePorcelainStatus(output: string): GitStateChangeSummary;

package/dist/core/git-state.js

@@ -0,0 +1,142 @@
+import { spawn } from "node:child_process";
+export const GIT_STATE_SCHEMA = "mimetic.git-state.v1";
+export async function captureGitState(cwd, options = {}) {
+    const capturedAt = toIsoString(options.capturedAt ?? new Date());
+    const runner = options.runner ?? runGitCommand;
+    const inside = await runner(["rev-parse", "--is-inside-work-tree"], cwd);
+    if (inside.exitCode === null) {
+        return unavailableState(capturedAt, "Git command could not be started.");
+    }
+    if (inside.exitCode !== 0 || inside.stdout.trim() !== "true") {
+        return {
+            schema: GIT_STATE_SCHEMA,
+            status: "missing",
+            capturedAt,
+            head: {
+                shortSha: null,
+                refState: "unknown"
+            },
+            changes: emptyChanges(),
+            note: "No git work tree was detected."
+        };
+    }
+    const statusOutput = await runner(["status", "--porcelain=v1"], cwd);
+    if (statusOutput.exitCode === null) {
+        return unavailableState(capturedAt, "Git status command could not be started.");
+    }
+    if (statusOutput.exitCode !== 0) {
+        return unavailableState(capturedAt, "Git status could not be captured.");
+    }
+    const headOutput = await runner(["rev-parse", "--short=12", "HEAD"], cwd);
+    const shortSha = headOutput.exitCode === 0 ? normalizeNullableText(headOutput.stdout) : null;
+    const refState = await captureRefState(runner, cwd, shortSha);
+    const changes = summarizePorcelainStatus(statusOutput.stdout);
+    const status = changes.total === 0 ? "clean" : "dirty";
+    return {
+        schema: GIT_STATE_SCHEMA,
+        status,
+        capturedAt,
+        head: {
+            shortSha,
+            refState
+        },
+        changes,
+        note: status === "clean"
+            ? "Git work tree was clean; branch names, remotes, paths, and file names were not captured."
+            : "Git work tree had changes; only counts were captured, not branch names, remotes, paths, or file names."
+    };
+}
+export function summarizePorcelainStatus(output) {
+    const lines = output.split(/\r?\n/).filter((line) => line.length > 0);
+    let staged = 0;
+    let unstaged = 0;
+    let untracked = 0;
+    for (const line of lines) {
+        const indexStatus = line[0] ?? " ";
+        const workTreeStatus = line[1] ?? " ";
+        if (indexStatus === "?" && workTreeStatus === "?") {
+            untracked += 1;
+            continue;
+        }
+        if (indexStatus !== " ") {
+            staged += 1;
+        }
+        if (workTreeStatus !== " ") {
+            unstaged += 1;
+        }
+    }
+    return {
+        staged,
+        unstaged,
+        untracked,
+        total: lines.length
+    };
+}
+async function captureRefState(runner, cwd, shortSha) {
+    const symbolicRef = await runner(["symbolic-ref", "--quiet", "HEAD"], cwd);
+    if (symbolicRef.exitCode === 0) {
+        return "attached";
+    }
+    return shortSha === null ? "unborn" : "detached";
+}
+async function runGitCommand(args, cwd) {
+    return await new Promise((resolve) => {
+        const child = spawn("git", args, {
+            cwd,
+            stdio: ["ignore", "pipe", "pipe"]
+        });
+        const stdout = [];
+        const stderr = [];
+        child.stdout.setEncoding("utf8");
+        child.stderr.setEncoding("utf8");
+        child.stdout.on("data", (chunk) => stdout.push(chunk));
+        child.stderr.on("data", (chunk) => stderr.push(chunk));
+        child.on("error", (error) => {
+            resolve({
+                exitCode: null,
+                stdout: stdout.join(""),
+                stderr: error.message
+            });
+        });
+        child.on("close", (exitCode) => {
+            resolve({
+                exitCode,
+                stdout: stdout.join(""),
+                stderr: stderr.join("")
+            });
+        });
+    });
+}
+function unavailableState(capturedAt, note) {
+    return {
+        schema: GIT_STATE_SCHEMA,
+        status: "unavailable",
+        capturedAt,
+        head: {
+            shortSha: null,
+            refState: "unknown"
+        },
+        changes: emptyChanges(),
+        note
+    };
+}
+function emptyChanges() {
+    return {
+        staged: 0,
+        unstaged: 0,
+        untracked: 0,
+        total: 0
+    };
+}
+function normalizeNullableText(value) {
+    const normalized = value.trim();
+    return normalized.length === 0 ? null : normalized;
+}
+function toIsoString(value) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error(`Invalid date: ${String(value)}`);
+    }
+    return date.toISOString();
+}
+//# sourceMappingURL=git-state.js.map

package/dist/core/git-state.js.map

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

package/dist/core/index.d.ts

@@ -0,0 +1,4 @@
+export { CORE_RUN_ID_PATTERN, HISTORY_ENTRY_SCHEMA, LATEST_POINTER_SCHEMA, assertRunId, buildArtifactLayout, buildRunId, createHistoryEntry, createLatestPointer, createLifecycleEvent, isValidRunId, summarizeTiming } from "./run-primitives.js";
+export type { ArtifactLayout, BuildRunIdOptions, CoreLifecycleEvent, CoreRunMode, LatestRunPointer, RunHistoryEntry, TimingSummary } from "./run-primitives.js";
+export { GIT_STATE_SCHEMA, captureGitState, summarizePorcelainStatus } from "./git-state.js";
+export type { CapturedGitState, GitCommandResult, GitCommandRunner, GitRefState, GitStateChangeSummary, GitStateStatus } from "./git-state.js";

package/dist/core/index.js

@@ -0,0 +1,3 @@
+export { CORE_RUN_ID_PATTERN, HISTORY_ENTRY_SCHEMA, LATEST_POINTER_SCHEMA, assertRunId, buildArtifactLayout, buildRunId, createHistoryEntry, createLatestPointer, createLifecycleEvent, isValidRunId, summarizeTiming } from "./run-primitives.js";
+export { GIT_STATE_SCHEMA, captureGitState, summarizePorcelainStatus } from "./git-state.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,WAAW,EACX,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAU7B,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACzB,MAAM,gBAAgB,CAAC"}

package/dist/core/run-primitives.d.ts

@@ -0,0 +1,66 @@
+export declare const CORE_RUN_ID_PATTERN: RegExp;
+export declare const LATEST_POINTER_SCHEMA = "mimetic.latest-run.v1";
+export declare const HISTORY_ENTRY_SCHEMA = "mimetic.run-history-entry.v1";
+export type CoreRunMode = "dry-run" | "live";
+export interface BuildRunIdOptions {
+    prefix: string;
+    createdAt: Date | string;
+    entropy: string;
+}
+export interface ArtifactLayout {
+    artifactRoot: string;
+    run: string;
+    reviewJson: string;
+    reviewMarkdown: string;
+    observerData: string;
+    events: string;
+    latestPointer: string;
+}
+export interface LatestRunPointer {
+    schema: typeof LATEST_POINTER_SCHEMA;
+    runId: string;
+    path: string;
+    updatedAt: string;
+}
+export interface RunHistoryEntry {
+    schema: typeof HISTORY_ENTRY_SCHEMA;
+    runId: string;
+    createdAt: string;
+    mode: CoreRunMode;
+    path: string;
+}
+export interface CoreLifecycleEvent {
+    at: string;
+    event: string;
+    message: string;
+}
+export interface TimingSummary {
+    startedAt: string;
+    endedAt: string | null;
+    durationMs: number | null;
+    status: "running" | "complete";
+}
+export declare function buildRunId(options: BuildRunIdOptions): string;
+export declare function isValidRunId(value: string): boolean;
+export declare function assertRunId(value: string): void;
+export declare function buildArtifactLayout(runId: string, runsRoot?: string): ArtifactLayout;
+export declare function createLatestPointer(options: {
+    runId: string;
+    artifactRoot: string;
+    updatedAt: Date | string;
+}): LatestRunPointer;
+export declare function createHistoryEntry(options: {
+    runId: string;
+    createdAt: Date | string;
+    mode: CoreRunMode;
+    artifactRoot: string;
+}): RunHistoryEntry;
+export declare function createLifecycleEvent(options: {
+    at: Date | string;
+    event: string;
+    message: string;
+}): CoreLifecycleEvent;
+export declare function summarizeTiming(options: {
+    startedAt: Date | string;
+    endedAt?: Date | string;
+}): TimingSummary;

package/dist/core/run-primitives.js

@@ -0,0 +1,120 @@
+export const CORE_RUN_ID_PATTERN = /^[a-z0-9][a-z0-9-]{0,127}$/;
+export const LATEST_POINTER_SCHEMA = "mimetic.latest-run.v1";
+export const HISTORY_ENTRY_SCHEMA = "mimetic.run-history-entry.v1";
+export function buildRunId(options) {
+    const prefix = toSafeSegment(options.prefix, "run");
+    const entropy = toSafeSegment(options.entropy, "proof");
+    const timestamp = toTimestampSegment(options.createdAt);
+    const runId = `${prefix}-${timestamp}-${entropy}`;
+    assertRunId(runId);
+    return runId;
+}
+export function isValidRunId(value) {
+    return CORE_RUN_ID_PATTERN.test(value) && !value.includes("--");
+}
+export function assertRunId(value) {
+    if (!isValidRunId(value)) {
+        throw new Error(`Invalid run id: ${value}`);
+    }
+}
+export function buildArtifactLayout(runId, runsRoot = ".mimetic/runs") {
+    assertRunId(runId);
+    const normalizedRoot = normalizeRelativePath(runsRoot);
+    const artifactRoot = `${normalizedRoot}/${runId}`;
+    return {
+        artifactRoot,
+        run: `${artifactRoot}/run.json`,
+        reviewJson: `${artifactRoot}/review.json`,
+        reviewMarkdown: `${artifactRoot}/review.md`,
+        observerData: `${artifactRoot}/observer/observer-data.json`,
+        events: `${artifactRoot}/events.ndjson`,
+        latestPointer: `${normalizedRoot}/latest.json`
+    };
+}
+export function createLatestPointer(options) {
+    assertRunId(options.runId);
+    return {
+        schema: LATEST_POINTER_SCHEMA,
+        runId: options.runId,
+        path: normalizeRelativePath(options.artifactRoot),
+        updatedAt: toIsoString(options.updatedAt)
+    };
+}
+export function createHistoryEntry(options) {
+    assertRunId(options.runId);
+    return {
+        schema: HISTORY_ENTRY_SCHEMA,
+        runId: options.runId,
+        createdAt: toIsoString(options.createdAt),
+        mode: options.mode,
+        path: normalizeRelativePath(options.artifactRoot)
+    };
+}
+export function createLifecycleEvent(options) {
+    const event = options.event.trim();
+    const message = options.message.trim();
+    if (event.length === 0) {
+        throw new Error("Lifecycle event is required.");
+    }
+    if (message.length === 0) {
+        throw new Error("Lifecycle message is required.");
+    }
+    return {
+        at: toIsoString(options.at),
+        event,
+        message
+    };
+}
+export function summarizeTiming(options) {
+    const startedAt = toIsoString(options.startedAt);
+    if (options.endedAt === undefined) {
+        return {
+            startedAt,
+            endedAt: null,
+            durationMs: null,
+            status: "running"
+        };
+    }
+    const endedAt = toIsoString(options.endedAt);
+    const durationMs = new Date(endedAt).getTime() - new Date(startedAt).getTime();
+    if (durationMs < 0) {
+        throw new Error("Timing summary endedAt must be after startedAt.");
+    }
+    return {
+        startedAt,
+        endedAt,
+        durationMs,
+        status: "complete"
+    };
+}
+function toTimestampSegment(value) {
+    return toIsoString(value).toLowerCase().replace(/[:.]/g, "-");
+}
+function toIsoString(value) {
+    const date = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        throw new Error(`Invalid date: ${String(value)}`);
+    }
+    return date.toISOString();
+}
+function toSafeSegment(value, fallback) {
+    const normalized = value
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 48);
+    return normalized.length > 0 ? normalized : fallback;
+}
+function normalizeRelativePath(value) {
+    const normalized = value.replace(/\\/g, "/");
+    if (normalized.startsWith("/") || /^[A-Za-z]:\//.test(normalized)) {
+        throw new Error(`Artifact paths must be relative: ${value}`);
+    }
+    const parts = normalized.split("/").filter((part) => part.length > 0);
+    if (parts.length === 0 || parts.some((part) => part === "." || part === "..")) {
+        throw new Error(`Artifact path contains an unsafe segment: ${value}`);
+    }
+    return parts.join("/");
+}
+//# sourceMappingURL=run-primitives.js.map

package/dist/core/run-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-primitives.js","sourceRoot":"","sources":["../../src/core/run-primitives.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,4BAA4B,CAAC;AAChE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,oBAAoB,GAAG,8BAA8B,CAAC;AAgDnE,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,kBAAkB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxD,MAAM,KAAK,GAAG,GAAG,MAAM,IAAI,SAAS,IAAI,OAAO,EAAE,CAAC;IAElD,WAAW,CAAC,KAAK,CAAC,CAAC;IACnB,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,QAAQ,GAAG,eAAe;IAC3E,WAAW,CAAC,KAAK,CAAC,CAAC;IAEnB,MAAM,cAAc,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,YAAY,GAAG,GAAG,cAAc,IAAI,KAAK,EAAE,CAAC;IAElD,OAAO;QACL,YAAY;QACZ,GAAG,EAAE,GAAG,YAAY,WAAW;QAC/B,UAAU,EAAE,GAAG,YAAY,cAAc;QACzC,cAAc,EAAE,GAAG,YAAY,YAAY;QAC3C,YAAY,EAAE,GAAG,YAAY,8BAA8B;QAC3D,MAAM,EAAE,GAAG,YAAY,gBAAgB;QACvC,aAAa,EAAE,GAAG,cAAc,cAAc;KAC/C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAInC;IACC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3B,OAAO;QACL,MAAM,EAAE,qBAAqB;QAC7B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC;QACjD,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAKlC;IACC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAE3B,OAAO;QACL,MAAM,EAAE,oBAAoB;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;QACzC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,OAIpC;IACC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAEvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IAED,OAAO;QACL,EAAE,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAG/B;IACC,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,SAAS;YACT,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAE/E,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,OAAO;QACL,SAAS;QACT,OAAO;QACP,UAAU;QACV,MAAM,EAAE,UAAU;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAoB;IAC9C,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7D,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,QAAgB;IACpD,MAAM,UAAU,GAAG,KAAK;SACrB,IAAI,EAAE;SACN,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC;AACvD,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,oCAAoC,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,6CAA6C,KAAK,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}