@pome-sh/cli 0.3.0 → 0.4.0

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,sEAAsE;AACtE,oEAAoE;AACpE,wEAAwE;AACxE,+CAA+C;AAE/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGvB;IACA;IAHX,YACE,OAAe,EACN,MAAc,EACd,MAAkB;QAE3B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHN,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAY;QAG3B,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IACxB;IAArB,YAAqB,IAAY,EAAE,MAAM,GAAG,GAAG;QAC7C,KAAK,CAAC,iBAAiB,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;QADpB,SAAI,GAAJ,IAAI,CAAQ;QAE/B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAOD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;SACpF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAChC,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE;gBACJ,OAAO,EAAE,mBAAmB;gBAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;oBACnC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC3B,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,OAAO,EAAE,KAAK,CAAC,OAAO;iBACvB,CAAC,CAAC;aACJ;SACF,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,YAAY,WAAW,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE,EAAE,CAAC;IACrE,CAAC;IACD,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,EAAE;KACpF,CAAC;AACJ,CAAC"}

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/failure-injection.d.ts

@@ -0,0 +1,43 @@
+import type { MiddlewareHandler } from "hono";
+import { z } from "zod";
+import type { RecorderEvent } from "@pome-sh/shared-types";
+export declare const FAILURE_INJECTION_OVERRIDE_KEY = "failureInjectionOverride";
+export type FailureInjectionOverride = {
+    status: number;
+    body: unknown;
+};
+export type FailureInjectionMode = "before_handler" | "after_handler";
+export type FailureInjectionRule = {
+    method: string;
+    path: string;
+    attempt: number;
+    mode: FailureInjectionMode;
+    status: number;
+    body: unknown;
+};
+export declare const failureInjectionRuleSchema: z.ZodObject<{
+    method: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    path: z.ZodString;
+    attempt: z.ZodNumber;
+    mode: z.ZodDefault<z.ZodEnum<{
+        before_handler: "before_handler";
+        after_handler: "after_handler";
+    }>>;
+    status: z.ZodNumber;
+    body: z.ZodUnknown;
+}, z.core.$strip>;
+export type FailureInjectionStore = {
+    setRules(rules: FailureInjectionRule[]): void;
+    clear(): void;
+    matchAndConsume(accountId: string, method: string, path: string): FailureInjectionRule | null;
+};
+export declare function createFailureInjectionStore(): FailureInjectionStore;
+export interface FailureInjectionMiddlewareOptions {
+    /** Sink for before_handler events. Optional — a recorderless app still injects. */
+    recorder?: {
+        record(event: RecorderEvent): void;
+    };
+    runId: string;
+    twin: string;
+}
+export declare function failureInjectionMiddleware(store: FailureInjectionStore, options: FailureInjectionMiddlewareOptions): MiddlewareHandler;

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/failure-injection.js

@@ -0,0 +1,160 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// Scenario-level failure injection (FDRS-339), graduated from twin-stripe
+// into the engine by the F-684 port ruling: making a twin fail on attempt N
+// of a (method, path) tuple is a generic twin capability — any provider
+// double needs "the server processed it but the client never saw the
+// response" to reproduce lost-response retry bugs. Only the rule *payloads*
+// (status + error envelope) are twin-domain; they ride in via the seed.
+//
+// Two modes:
+//
+//   - `before_handler` → the matched request never reaches the route
+//     handler; the middleware returns the configured envelope directly and
+//     records a `state_mutation: false`, `state_delta: null` event.
+//   - `after_handler` → the handler is invoked normally (state mutation
+//     and `state_delta` capture proceed). The middleware parks the override
+//     on the context under `FAILURE_INJECTION_OVERRIDE_KEY`; the twin's
+//     response path substitutes status + body on the way out, so the
+//     recorded event and the wire agree. This models a "server processed
+//     but response delivery failed" failure — required to reproduce the
+//     FDRS-316 hero scenario.
+//
+// Counters live per `(account_id, method, path)` so successive POSTs from
+// the same account to the same path resolve to `attempt: 1`, `attempt: 2`,
+// …, deterministically. Other routes don't influence the counter — only
+// requests to a tuple that has at least one registered rule are counted.
+import { randomUUID } from "node:crypto";
+import { z } from "zod";
+export const FAILURE_INJECTION_OVERRIDE_KEY = "failureInjectionOverride";
+export const failureInjectionRuleSchema = z.object({
+    method: z.string().min(1).transform((s) => s.toUpperCase()),
+    path: z.string().min(1),
+    attempt: z.number().int().positive(),
+    mode: z
+        .enum(["before_handler", "after_handler"])
+        .default("after_handler"),
+    status: z.number().int().min(100).max(599),
+    body: z.unknown(),
+});
+export function createFailureInjectionStore() {
+    // The store is intentionally global across accounts. The (account_id,
+    // method, path) counter keys keep accounts independent for matching;
+    // rules themselves apply to whichever account issues the matching
+    // request. Single-account scenarios (the common case, including the
+    // FDRS-316 hero) don't need to express scope per rule.
+    let rules = [];
+    const counters = new Map();
+    const tuplesWithRules = new Set();
+    function tupleKey(method, path) {
+        return `${method.toUpperCase()}\0${path}`;
+    }
+    function counterKey(accountId, method, path) {
+        return `${accountId}\0${method.toUpperCase()}\0${path}`;
+    }
+    function rebuildIndex() {
+        tuplesWithRules.clear();
+        for (const r of rules)
+            tuplesWithRules.add(tupleKey(r.method, r.path));
+    }
+    return {
+        setRules(next) {
+            rules = next.slice();
+            counters.clear();
+            rebuildIndex();
+        },
+        clear() {
+            rules = [];
+            counters.clear();
+            tuplesWithRules.clear();
+        },
+        matchAndConsume(accountId, method, path) {
+            const tk = tupleKey(method, path);
+            if (!tuplesWithRules.has(tk))
+                return null;
+            const ck = counterKey(accountId, method, path);
+            const count = (counters.get(ck) ?? 0) + 1;
+            counters.set(ck, count);
+            return (rules.find((r) => r.method.toUpperCase() === method.toUpperCase() &&
+                r.path === path &&
+                r.attempt === count) ?? null);
+        },
+    };
+}
+export function failureInjectionMiddleware(store, options) {
+    return async (c, next) => {
+        const session = c.get("session");
+        // Auth runs first; if it failed there's no session and we shouldn't
+        // shadow that with a manufactured failure.
+        if (!session) {
+            await next();
+            return;
+        }
+        const accountId = typeof session.account_id === "string" ? session.account_id : String(session.sid ?? "_anon");
+        const method = c.req.method.toUpperCase();
+        const rawPath = new URL(c.req.url).pathname;
+        // Rules are written against the canonical provider path
+        // (e.g., "/v1/refunds"). Strip the session prefix when present so
+        // path-mounted (`/s/:sid/v1/refunds`) and root-mounted (`/v1/refunds`,
+        // stripe F3 SDK compat) requests both match.
+        const path = stripSessionPrefix(rawPath);
+        const rule = store.matchAndConsume(accountId, method, path);
+        if (!rule) {
+            await next();
+            return;
+        }
+        if (rule.mode === "before_handler") {
+            const started = Date.now();
+            let requestBody = null;
+            try {
+                requestBody = await c.req.raw.clone().text();
+            }
+            catch {
+                requestBody = null;
+            }
+            const requestId = `req_${randomUUID()}`;
+            const stepId = c.req.header("x-pome-scenario-step-id") ?? null;
+            options.recorder?.record({
+                ts: new Date().toISOString(),
+                run_id: options.runId,
+                twin: options.twin,
+                request_id: requestId,
+                correlation_id: c.req.header("x-pome-correlation-id") ?? requestId,
+                task_step_id: stepId,
+                scenario_step_id: stepId,
+                step_id: null,
+                tool_call_id: null,
+                method,
+                path: rawPath,
+                request_body: requestBody,
+                status: rule.status,
+                response_body: rule.body,
+                latency_ms: Date.now() - started,
+                fidelity: "semantic",
+                state_mutation: false,
+                state_delta: null,
+                error: rule.status >= 400 ? errorMessage(rule.body) : null,
+            });
+            return c.json(rule.body, rule.status);
+        }
+        // after_handler: let the handler run, but stash the override so the
+        // twin's response path can substitute status + body on the way out.
+        // state_mutation + state_delta keep the real-handler truth.
+        const override = { status: rule.status, body: rule.body };
+        c.set(FAILURE_INJECTION_OVERRIDE_KEY, override);
+        await next();
+    };
+}
+function stripSessionPrefix(path) {
+    const match = path.match(/^\/s\/[^/]+(\/.*)$/);
+    return match?.[1] ?? path;
+}
+function errorMessage(body) {
+    if (body && typeof body === "object" && "error" in body) {
+        const err = body.error;
+        if (err && typeof err.message === "string")
+            return err.message;
+    }
+    return "request failed";
+}
+//# sourceMappingURL=failure-injection.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/failure-injection.js.map

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

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity-inventory.d.ts

@@ -0,0 +1,121 @@
+import { z } from "zod";
+export declare const heatTierSchema: z.ZodEnum<{
+    hot: "hot";
+    warm: "warm";
+    cold: "cold";
+    unclassified: "unclassified";
+}>;
+export type HeatTier = z.infer<typeof heatTierSchema>;
+export declare const fidelitySurfaceSchema: z.ZodObject<{
+    name: z.ZodString;
+    heat: z.ZodEnum<{
+        hot: "hot";
+        warm: "warm";
+        cold: "cold";
+        unclassified: "unclassified";
+    }>;
+    fidelity: z.ZodEnum<{
+        semantic: "semantic";
+        unsupported: "unsupported";
+        shape: "shape";
+    }>;
+    justification: z.ZodString;
+}, z.core.$strict>;
+export type FidelitySurface = z.infer<typeof fidelitySurfaceSchema>;
+export declare const fidelityDocDriftSchema: z.ZodObject<{
+    kind: z.ZodEnum<{
+        tool: "tool";
+        rest: "rest";
+    }>;
+    name: z.ZodString;
+    reason: z.ZodString;
+    ticket: z.ZodString;
+}, z.core.$strict>;
+export type FidelityDocDrift = z.infer<typeof fidelityDocDriftSchema>;
+export declare const fidelityInventorySchema: z.ZodObject<{
+    twin: z.ZodString;
+    package: z.ZodString;
+    updated: z.ZodString;
+    notes: z.ZodOptional<z.ZodString>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        heat: z.ZodEnum<{
+            hot: "hot";
+            warm: "warm";
+            cold: "cold";
+            unclassified: "unclassified";
+        }>;
+        fidelity: z.ZodEnum<{
+            semantic: "semantic";
+            unsupported: "unsupported";
+            shape: "shape";
+        }>;
+        justification: z.ZodString;
+    }, z.core.$strict>>;
+    rest: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        heat: z.ZodEnum<{
+            hot: "hot";
+            warm: "warm";
+            cold: "cold";
+            unclassified: "unclassified";
+        }>;
+        fidelity: z.ZodEnum<{
+            semantic: "semantic";
+            unsupported: "unsupported";
+            shape: "shape";
+        }>;
+        justification: z.ZodString;
+    }, z.core.$strict>>;
+    doc_drift: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            tool: "tool";
+            rest: "rest";
+        }>;
+        name: z.ZodString;
+        reason: z.ZodString;
+        ticket: z.ZodString;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type FidelityInventory = z.infer<typeof fidelityInventorySchema>;
+export declare function loadFidelityInventory(path: string): FidelityInventory;
+export interface FidelityDocRow {
+    name: string;
+    fidelity: string;
+    /** Present only when the table carries the optional Heat column. */
+    heat?: string;
+}
+export interface FidelityDocSource {
+    /** Shown in lint problems, e.g. "FIDELITY.md". */
+    label: string;
+    kind: "tool" | "rest";
+    markdown: string;
+}
+/**
+ * Expand one name cell into surface names. Backticked spans are the names;
+ * a span with no `.`, `/`, or space is shorthand for a sibling of the first
+ * span (Slack-style `` `reactions.add` / `remove` / `get` ``) and inherits
+ * its dotted prefix. Cells with no backticks name the surface verbatim
+ * (e.g. "Any unsupported path").
+ */
+export declare function expandSurfaceCell(cell: string): string[];
+/**
+ * Parse every markdown table whose header names surfaces of `kind` + Tier.
+ * The Heat column (ENDPOINT-TIERS.md) is optional: parsed when the header
+ * names it, omitted otherwise, so pre-heat tables stay legal.
+ */
+export declare function parseFidelityDocRows(markdown: string, kind: "tool" | "rest"): FidelityDocRow[];
+/**
+ * 1:1-lint the inventory against the FIDELITY doc tables. Returns human-
+ * readable problems (empty = clean). Directions checked per kind:
+ * every doc row must be in the inventory with the same fidelity tier, and
+ * every inventory entry must be documented unless a `doc_drift` entry
+ * (with its owning ticket) declares the gap. A drift declaration whose
+ * name IS documented is stale and reported, so drift entries self-expire.
+ */
+export declare function lintFidelityInventory(inventory: FidelityInventory, docs: FidelityDocSource[]): string[];
+/** Set-compare tool names: inventory vs the live `listTools()` surface. */
+export declare function compareToolNames(inventoryNames: string[], liveNames: string[]): {
+    missing: string[];
+    extra: string[];
+};

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity-inventory.js

@@ -0,0 +1,204 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// Structured fidelity inventory (F-730). Each twin ships a machine-readable
+// surface list — `fidelity.inventory.json` — carrying, per MCP tool and REST
+// surface, the heat tier (how deep the endpoint SHOULD be, ruled by the
+// F-729 rubric) orthogonal to the fidelity tier (how deep it IS, per
+// `fidelityTierSchema`), plus a justification for the classification.
+//
+// The FIDELITY doc tables are 1:1-linted against this inventory instead of
+// the old soft "docs mention the tool name" checks (which let twin-stripe's
+// implemented-but-undocumented refunds drift by silently). Known, ticketed
+// doc gaps are declared in `doc_drift`: the lint accepts exactly those
+// gaps and fails loudly once the docs catch up, so a declaration can never
+// outlive the drift it describes.
+import { readFileSync } from "node:fs";
+import { z } from "zod";
+import { fidelityTierSchema } from "./index.js";
+export const heatTierSchema = z.enum(["hot", "warm", "cold", "unclassified"]);
+export const fidelitySurfaceSchema = z.strictObject({
+    /** MCP tool name, or the REST surface string exactly as documented. */
+    name: z.string().min(1),
+    heat: heatTierSchema,
+    fidelity: fidelityTierSchema,
+    justification: z.string().min(1),
+});
+export const fidelityDocDriftSchema = z.strictObject({
+    kind: z.enum(["tool", "rest"]),
+    /** Must match an inventory entry of the same kind. */
+    name: z.string().min(1),
+    reason: z.string().min(1),
+    /** The Linear ticket that owns reconciling the docs. */
+    ticket: z.string().regex(/^F-\d+$/),
+});
+export const fidelityInventorySchema = z.strictObject({
+    twin: z.string().min(1),
+    package: z.string().min(1),
+    /** ISO date (YYYY-MM-DD) of the last human review of this inventory. */
+    updated: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    notes: z.string().optional(),
+    tools: z.array(fidelitySurfaceSchema).min(1),
+    rest: z.array(fidelitySurfaceSchema),
+    doc_drift: z.array(fidelityDocDriftSchema).default([]),
+});
+export function loadFidelityInventory(path) {
+    return fidelityInventorySchema.parse(JSON.parse(readFileSync(path, "utf8")));
+}
+const TOOL_NAME_HEADERS = new Set(["tool"]);
+const REST_NAME_HEADERS = new Set(["route", "endpoint", "surface"]);
+function splitTableRow(line) {
+    return line
+        .replace(/^\s*\|/, "")
+        .replace(/\|\s*$/, "")
+        .split("|")
+        .map((cell) => cell.trim());
+}
+function isSeparatorRow(cells) {
+    return cells.every((cell) => /^:?-{3,}:?$/.test(cell));
+}
+/**
+ * Expand one name cell into surface names. Backticked spans are the names;
+ * a span with no `.`, `/`, or space is shorthand for a sibling of the first
+ * span (Slack-style `` `reactions.add` / `remove` / `get` ``) and inherits
+ * its dotted prefix. Cells with no backticks name the surface verbatim
+ * (e.g. "Any unsupported path").
+ */
+export function expandSurfaceCell(cell) {
+    const spans = [...cell.matchAll(/`([^`]+)`/g)].map((match) => match[1].trim());
+    if (spans.length === 0) {
+        const text = cell.trim();
+        return text.length > 0 ? [text] : [];
+    }
+    const [first, ...rest] = spans;
+    const lastDot = first.lastIndexOf(".");
+    const prefix = lastDot >= 0 ? first.slice(0, lastDot + 1) : "";
+    return [
+        first,
+        ...rest.map((span) => /[./ ]/.test(span) || prefix === "" ? span : `${prefix}${span}`),
+    ];
+}
+/**
+ * Parse every markdown table whose header names surfaces of `kind` + Tier.
+ * The Heat column (ENDPOINT-TIERS.md) is optional: parsed when the header
+ * names it, omitted otherwise, so pre-heat tables stay legal.
+ */
+export function parseFidelityDocRows(markdown, kind) {
+    const nameHeaders = kind === "tool" ? TOOL_NAME_HEADERS : REST_NAME_HEADERS;
+    const rows = [];
+    const lines = markdown.split("\n");
+    let nameIdx = -1;
+    let tierIdx = -1;
+    let heatIdx = -1;
+    let inTable = false;
+    for (const line of lines) {
+        if (!line.trimStart().startsWith("|")) {
+            inTable = false;
+            nameIdx = -1;
+            tierIdx = -1;
+            heatIdx = -1;
+            continue;
+        }
+        const cells = splitTableRow(line);
+        if (!inTable) {
+            const headers = cells.map((cell) => cell.toLowerCase());
+            nameIdx = headers.findIndex((header) => nameHeaders.has(header));
+            tierIdx = headers.findIndex((header) => header === "tier");
+            heatIdx = headers.findIndex((header) => header === "heat");
+            inTable = true;
+            continue;
+        }
+        if (isSeparatorRow(cells) || nameIdx < 0 || tierIdx < 0)
+            continue;
+        const fidelity = cells[tierIdx] ?? "";
+        const heat = heatIdx >= 0 ? { heat: cells[heatIdx] ?? "" } : {};
+        for (const name of expandSurfaceCell(cells[nameIdx] ?? "")) {
+            rows.push({ name, fidelity, ...heat });
+        }
+    }
+    return rows;
+}
+// ─── Lint: inventory ⇔ docs, both directions ─────────────────────────────────
+/**
+ * 1:1-lint the inventory against the FIDELITY doc tables. Returns human-
+ * readable problems (empty = clean). Directions checked per kind:
+ * every doc row must be in the inventory with the same fidelity tier, and
+ * every inventory entry must be documented unless a `doc_drift` entry
+ * (with its owning ticket) declares the gap. A drift declaration whose
+ * name IS documented is stale and reported, so drift entries self-expire.
+ */
+export function lintFidelityInventory(inventory, docs) {
+    const problems = [];
+    for (const kind of ["tool", "rest"]) {
+        const sources = docs.filter((doc) => doc.kind === kind);
+        if (sources.length === 0)
+            continue;
+        const labels = sources.map((doc) => doc.label).join(", ");
+        const entries = kind === "tool" ? inventory.tools : inventory.rest;
+        const drift = new Map(inventory.doc_drift.filter((d) => d.kind === kind).map((d) => [d.name, d]));
+        const inventoryByName = new Map();
+        for (const entry of entries) {
+            if (inventoryByName.has(entry.name)) {
+                problems.push(`inventory ${kind} '${entry.name}' is listed twice`);
+            }
+            inventoryByName.set(entry.name, entry);
+        }
+        const documented = new Map();
+        for (const source of sources) {
+            for (const row of parseFidelityDocRows(source.markdown, kind)) {
+                const existing = documented.get(row.name);
+                if (existing && existing.fidelity !== row.fidelity) {
+                    problems.push(`${labels}: ${kind} '${row.name}' is documented twice with conflicting tiers ('${existing.fidelity}' vs '${row.fidelity}')`);
+                    continue;
+                }
+                if (existing &&
+                    existing.heat !== undefined &&
+                    row.heat !== undefined &&
+                    existing.heat !== row.heat) {
+                    problems.push(`${labels}: ${kind} '${row.name}' is documented twice with conflicting heat ('${existing.heat}' vs '${row.heat}')`);
+                    continue;
+                }
+                documented.set(row.name, row);
+            }
+        }
+        for (const [name, row] of documented) {
+            const entry = inventoryByName.get(name);
+            if (!entry) {
+                problems.push(`${labels}: ${kind} '${name}' documented but missing from fidelity.inventory.json`);
+                continue;
+            }
+            if (entry.fidelity !== row.fidelity) {
+                problems.push(`${kind} '${name}': inventory says fidelity '${entry.fidelity}' but ${labels} says '${row.fidelity}'`);
+            }
+            if (row.heat !== undefined && entry.heat !== row.heat) {
+                problems.push(`${kind} '${name}': inventory says heat '${entry.heat}' but ${labels} says '${row.heat}'`);
+            }
+        }
+        for (const entry of entries) {
+            if (documented.has(entry.name))
+                continue;
+            const declared = drift.get(entry.name);
+            if (!declared) {
+                problems.push(`${kind} '${entry.name}' is in fidelity.inventory.json but undocumented in ${labels}; add the row or declare doc_drift`);
+            }
+        }
+        for (const declared of drift.values()) {
+            if (!inventoryByName.has(declared.name)) {
+                problems.push(`doc_drift ${kind} '${declared.name}' (${declared.ticket}) matches no inventory entry`);
+            }
+            if (documented.has(declared.name)) {
+                problems.push(`doc_drift ${kind} '${declared.name}' (${declared.ticket}) is stale — ${labels} now documents it; remove the declaration`);
+            }
+        }
+    }
+    return problems;
+}
+/** Set-compare tool names: inventory vs the live `listTools()` surface. */
+export function compareToolNames(inventoryNames, liveNames) {
+    const inventory = new Set(inventoryNames);
+    const live = new Set(liveNames);
+    return {
+        missing: [...live].filter((name) => !inventory.has(name)).sort(),
+        extra: [...inventory].filter((name) => !live.has(name)).sort(),
+    };
+}
+//# sourceMappingURL=fidelity-inventory.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity-inventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fidelity-inventory.js","sourceRoot":"","sources":["../src/fidelity-inventory.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,qEAAqE;AACrE,sEAAsE;AACtE,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,2EAA2E;AAC3E,kCAAkC;AAElC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AAG9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,YAAY,CAAC;IAClD,uEAAuE;IACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,kBAAkB;IAC5B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,YAAY,CAAC;IACnD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,sDAAsD;IACtD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,wDAAwD;IACxD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;CACpC,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,YAAY,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,wEAAwE;IACxE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;IACpC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,uBAAuB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;AAC/E,CAAC;AAkBD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5C,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAEpE,SAAS,aAAa,CAAC,IAAY;IACjC,OAAO,IAAI;SACR,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,cAAc,CAAC,KAAe;IACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvC,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,OAAO;QACL,KAAK;QACL,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACnB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAChE;KACF,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAgB,EAAE,IAAqB;IAC1E,MAAM,WAAW,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAC5E,MAAM,IAAI,GAAqB,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,GAAG,KAAK,CAAC;YAChB,OAAO,GAAG,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,CAAC,CAAC,CAAC;YACb,OAAO,GAAG,CAAC,CAAC,CAAC;YACb,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACxD,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACjE,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC3D,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;YAC3D,OAAO,GAAG,IAAI,CAAC;YACf,SAAS;QACX,CAAC;QACD,IAAI,cAAc,CAAC,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC;YAAE,SAAS;QAClE,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,KAAK,MAAM,IAAI,IAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;YAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAEhF;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CACnC,SAA4B,EAC5B,IAAyB;IAEzB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,CAAU,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACxD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACnC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAC3E,CAAC;QAEF,MAAM,eAAe,GAAG,IAAI,GAAG,EAA2B,CAAC;QAC3D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,aAAa,IAAI,KAAK,KAAK,CAAC,IAAI,mBAAmB,CAAC,CAAC;YACrE,CAAC;YACD,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAA0B,CAAC;QACrD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,KAAK,MAAM,GAAG,IAAI,oBAAoB,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC9D,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1C,IAAI,QAAQ,IAAI,QAAQ,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;oBACnD,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,kDAAkD,QAAQ,CAAC,QAAQ,SAAS,GAAG,CAAC,QAAQ,IAAI,CAC5H,CAAC;oBACF,SAAS;gBACX,CAAC;gBACD,IACE,QAAQ;oBACR,QAAQ,CAAC,IAAI,KAAK,SAAS;oBAC3B,GAAG,CAAC,IAAI,KAAK,SAAS;oBACtB,QAAQ,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAC1B,CAAC;oBACD,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,iDAAiD,QAAQ,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,IAAI,CACnH,CAAC;oBACF,SAAS;gBACX,CAAC;gBACD,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,IAAI,KAAK,IAAI,uDAAuD,CAAC,CAAC;gBAClG,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,KAAK,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,KAAK,IAAI,+BAA+B,KAAK,CAAC,QAAQ,SAAS,MAAM,UAAU,GAAG,CAAC,QAAQ,GAAG,CACtG,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC;gBACtD,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,KAAK,IAAI,2BAA2B,KAAK,CAAC,IAAI,SAAS,MAAM,UAAU,GAAG,CAAC,IAAI,GAAG,CAC1F,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAAE,SAAS;YACzC,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,CAAC,IAAI,CACX,GAAG,IAAI,KAAK,KAAK,CAAC,IAAI,uDAAuD,MAAM,oCAAoC,CACxH,CAAC;YACJ,CAAC;QACH,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CACX,aAAa,IAAI,KAAK,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,MAAM,8BAA8B,CACvF,CAAC;YACJ,CAAC;YACD,IAAI,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CACX,aAAa,IAAI,KAAK,QAAQ,CAAC,IAAI,MAAM,QAAQ,CAAC,MAAM,gBAAgB,MAAM,2CAA2C,CAC1H,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAC9B,cAAwB,EACxB,SAAmB;IAEnB,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO;QACL,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;QAChE,KAAK,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE;KAC/D,CAAC;AACJ,CAAC"}

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity.d.ts

@@ -0,0 +1,8 @@
+import type { TwinDefinition } from "./index.js";
+export interface EmitFidelityOptions {
+    /** ISO date (YYYY-MM-DD) embedded in "Last verified". Defaults to today. */
+    lastVerified?: string;
+    /** Optional trailing notes section appended after the table. */
+    notes?: string;
+}
+export declare function emitFidelityMarkdown<TDb, TSeed, TDomain>(definition: TwinDefinition<TDb, TSeed, TDomain>, options?: EmitFidelityOptions): string;

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity.js

@@ -0,0 +1,39 @@
+// SPDX-License-Identifier: Apache-2.0
+//
+// FIDELITY.md emitter. Generates the Tools × Tier × Backing surface × Tests
+// × Deviations table from a `TwinDefinition`. Per-tool fidelity metadata
+// lives on `ToolSpec.fidelity` (optional); when missing, the row falls back
+// to the manifest's `fidelity.default` tier and em-dash placeholders.
+export function emitFidelityMarkdown(definition, options = {}) {
+    const lastVerified = options.lastVerified ?? new Date().toISOString().slice(0, 10);
+    const lines = [];
+    lines.push(`# ${definition.id} Twin Fidelity`);
+    lines.push("");
+    lines.push(`Auto-generated by \`@pome-sh/sdk\` for twin \`${definition.id}\` v${definition.version}.`);
+    lines.push("");
+    lines.push(`Last verified: ${lastVerified}.`);
+    lines.push("");
+    lines.push("## MCP Tools");
+    lines.push("");
+    lines.push("| Tool | Backing surface | Tier | Tests | Known deviations |");
+    lines.push("| --- | --- | --- | --- | --- |");
+    for (const tool of definition.tools) {
+        const fid = tool.fidelity ?? {};
+        const tier = fid.tier ?? definition.fidelity.default;
+        const surface = fid.backingSurface ?? "—";
+        const tests = (fid.tests ?? []).length
+            ? (fid.tests ?? []).map((t) => `\`${t}\``).join(", ")
+            : "—";
+        const deviations = (fid.deviations ?? "—").replace(/\r?\n/g, " ");
+        lines.push(`| \`${tool.name}\` | ${surface} | ${tier} | ${tests} | ${deviations} |`);
+    }
+    if (options.notes) {
+        lines.push("");
+        lines.push("## Notes");
+        lines.push("");
+        lines.push(options.notes);
+    }
+    lines.push("");
+    return lines.join("\n");
+}
+//# sourceMappingURL=fidelity.js.map

package/node_modules/@pome-sh/twin-github/node_modules/@pome-sh/sdk/dist/fidelity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fidelity.js","sourceRoot":"","sources":["../src/fidelity.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,4EAA4E;AAC5E,sEAAsE;AAWtE,MAAM,UAAU,oBAAoB,CAClC,UAA+C,EAC/C,UAA+B,EAAE;IAEjC,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnF,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,KAAK,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,iDAAiD,UAAU,CAAC,EAAE,OAAO,UAAU,CAAC,OAAO,GAAG,CAC3F,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,kBAAkB,YAAY,GAAG,CAAC,CAAC;IAC9C,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,8DAA8D,CAAC,CAAC;IAC3E,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IAE9C,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QACrD,MAAM,OAAO,GAAG,GAAG,CAAC,cAAc,IAAI,GAAG,CAAC;QAC1C,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM;YACpC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACrD,CAAC,CAAC,GAAG,CAAC;QACR,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAClE,KAAK,CAAC,IAAI,CACR,OAAO,IAAI,CAAC,IAAI,QAAQ,OAAO,MAAM,IAAI,MAAM,KAAK,MAAM,UAAU,IAAI,CACzE,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}