@run402/sdk 4.97.0 → 4.98.0

package/dist/node/buzz-doctor-contract.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The frozen Buzz setup preflight contract (`run402.buzz-doctor.v1`) and the
+ * released Buzz CLI v0.5.2 capability fixture `r.buzz.doctor()` probes
+ * against. The objects below are the published fixtures verbatim
+ * (`buzz/fixtures/run402-buzz-doctor-v1-contract.json` and
+ * `buzz/fixtures/buzz-v0.5.2-cli-capabilities.json`, shipped with the
+ * `run402-buzz` skill); `buzz-doctor-contract.test.ts` fails when they drift.
+ * The validators are what a consumer of a doctor report (the Buzz setup
+ * helper) applies before trusting it.
+ */
+/** `run402-buzz-doctor-v1-contract.json`, verbatim. */
+export declare const BUZZ_DOCTOR_CONTRACT: {
+    readonly schema_version: 1;
+    readonly contract_id: "run402.buzz-doctor.v1";
+    readonly mode: "buzz";
+    readonly canonical_invocation: readonly ["run402", "--wallet", "<profile>", "doctor", "--buzz", "--buzz-agent", "<npub-or-hex>"];
+    readonly flags: {
+        readonly mode: "--buzz";
+        readonly agent: "--buzz-agent";
+        readonly profile: "--wallet";
+    };
+    readonly check_order: readonly ["session_shell", "node_runtime", "run402_cli", "buzz_cli", "buzz_agent_target", "run402_api", "run402_console", "buzz_relay", "wallet_profile"];
+    readonly statuses: readonly ["ok", "warning", "blocked"];
+    readonly codes_by_check: {
+        readonly session_shell: readonly ["BUZZ_PREFLIGHT_SHELL_UNAVAILABLE"];
+        readonly node_runtime: readonly ["BUZZ_PREFLIGHT_NODE_UNAVAILABLE", "BUZZ_PREFLIGHT_NODE_INCOMPATIBLE"];
+        readonly run402_cli: readonly ["BUZZ_PREFLIGHT_RUN402_UNAVAILABLE", "BUZZ_PREFLIGHT_RUN402_INCOMPATIBLE", "BUZZ_PREFLIGHT_RUN402_UPDATE_AVAILABLE"];
+        readonly buzz_cli: readonly ["BUZZ_PREFLIGHT_BUZZ_CLI_UNAVAILABLE", "BUZZ_PREFLIGHT_BUZZ_CLI_INCOMPATIBLE"];
+        readonly buzz_agent_target: readonly ["BUZZ_AGENT_TARGET_REQUIRED", "BUZZ_AGENT_TARGET_UNVERIFIED", "BUZZ_AGENT_TARGET_MISMATCH"];
+        readonly run402_api: readonly ["BUZZ_PREFLIGHT_API_UNREACHABLE"];
+        readonly run402_console: readonly ["BUZZ_PREFLIGHT_CONSOLE_UNREACHABLE"];
+        readonly buzz_relay: readonly ["BUZZ_PREFLIGHT_RELAY_UNSAFE", "BUZZ_PREFLIGHT_RELAY_UNREACHABLE"];
+        readonly wallet_profile: readonly ["BUZZ_PREFLIGHT_WALLET_PROFILE_REQUIRED", "BUZZ_PREFLIGHT_WALLET_PROFILE_NOT_FOUND", "BUZZ_PREFLIGHT_WALLET_PROFILE_MISMATCH"];
+    };
+    readonly next_action: {
+        readonly required_fields: readonly ["type", "surface", "command", "why", "safe_to_auto_execute", "requires_approval", "destructive", "idempotent", "spend_impact"];
+        readonly surfaces: readonly ["shell", "buzz_chat", "buzz_settings"];
+        readonly shell_required_fields: readonly ["argv"];
+        readonly non_shell_forbidden_fields: readonly ["argv", "cwd"];
+        readonly cardinality_per_actionable_check: 1;
+    };
+    readonly exit_behavior: {
+        readonly passed_or_warning_only: 0;
+        readonly completed_with_blocked_checks: 1;
+        readonly usage_error: 1;
+        readonly completed_report_stream: "stdout";
+        readonly usage_error_stream: "stderr";
+    };
+    readonly freshness: {
+        readonly max_age_seconds: 60;
+        readonly binding_fields: readonly ["contract_id", "expected_subject_hex", "wallet_profile", "node_executable", "run402_executable", "relay_origin"];
+    };
+    readonly setup_rejection_codes: readonly ["BUZZ_PREFLIGHT_REPORT_INVALID", "BUZZ_PREFLIGHT_REPORT_STALE", "BUZZ_PREFLIGHT_REPORT_MISMATCH"];
+    readonly zero_mutation: {
+        readonly mutation_state: "not_started";
+        readonly forbidden: readonly ["buzz_event_publish", "buzz_arbitrary_sign", "run402_profile_create_or_select", "run402_wallet_create", "run402_identity_link_mutation", "run402_faucet", "run402_tier_mutation", "run402_project_mutation", "run402_deploy"];
+        readonly allowed_lossy_local_writes: readonly ["cli_update_cache", "redacted_diagnostic_queue"];
+    };
+};
+/** `buzz-v0.5.2-cli-capabilities.json`, verbatim. */
+export declare const BUZZ_CLI_CAPABILITIES: {
+    readonly fixture_version: 1;
+    readonly fixture_id: "buzz-cli-v0.5.2-capabilities";
+    readonly purpose: "released_buzz_cli_capability_first_compatibility";
+    readonly buzz_release: {
+        readonly version: "0.5.2";
+        readonly release_tag: "v0.5.2";
+        readonly release_tag_commit: "3e48f1b2365d326ee1c9582448d86a99b44ecd5d";
+        readonly run402_change_required: false;
+    };
+    readonly help_probes: readonly [{
+        readonly argv: readonly ["buzz", "--help"];
+        readonly exit_code: 0;
+        readonly stdout_contains: readonly ["Buzz CLI — interact with a Buzz relay", "users", "social", "Errors are JSON on stderr"];
+    }, {
+        readonly argv: readonly ["buzz", "users", "get", "--help"];
+        readonly exit_code: 0;
+        readonly stdout_contains: readonly ["users get [OPTIONS]", "--pubkey", "Omit for your own profile"];
+    }, {
+        readonly argv: readonly ["buzz", "social", "publish", "--help"];
+        readonly exit_code: 0;
+        readonly stdout_contains: readonly ["social publish [OPTIONS]", "--content"];
+    }, {
+        readonly argv: readonly ["buzz", "social", "event", "--help"];
+        readonly exit_code: 0;
+        readonly stdout_contains: readonly ["social event --event"];
+    }];
+    readonly version_probe: {
+        readonly argv: readonly ["buzz", "--version"];
+        readonly supported: false;
+        readonly exit_code: 1;
+        readonly stderr_json: {
+            readonly error: "user_error";
+            readonly retryable: false;
+        };
+        readonly message_contains: "unexpected argument '--version'";
+    };
+    readonly json_contract: {
+        readonly default_output_format: "json";
+        readonly users_get_success_stdout: {
+            readonly type: "array";
+            readonly empty_array_means: "public_self_profile_unverified";
+            readonly profile_pubkey_field: "pubkey";
+        };
+        readonly social_event_success_stdout: {
+            readonly type: "array";
+            readonly event_pubkey_field: "pubkey";
+        };
+        readonly error_stderr: {
+            readonly type: "object";
+            readonly required_fields: readonly ["error", "message", "retryable"];
+            readonly stdout_is_empty: true;
+        };
+    };
+    readonly managed_sidecar: {
+        readonly distribution: "bundled_with_buzz_desktop";
+        readonly session_discovery: "managed_agent_path";
+        readonly public_package_manager_install: false;
+        readonly repair_surface: "buzz_settings";
+        readonly repair_destination: "Buzz Desktop > Settings > Updates";
+        readonly repair_instruction: "Open Buzz Desktop > Settings > Updates, install the available Buzz update or reinstall Buzz Desktop if no update is offered, then restart this agent and rerun setup.";
+    };
+    readonly public_self_observation: {
+        readonly argv: readonly ["buzz", "users", "get"];
+        readonly requires_private_key_value_inspection: false;
+        readonly empty_or_malformed_result: "BUZZ_AGENT_TARGET_UNVERIFIED";
+    };
+    readonly write_surface_policy: {
+        readonly capability_probes_use_help_only: true;
+        readonly publish_is_never_invoked_by_doctor: true;
+        readonly event_read_requires_explicit_event_id_and_is_not_used_for_self_discovery: true;
+    };
+};
+export declare const BUZZ_DOCTOR_CONTRACT_ID: string;
+export declare const BUZZ_DOCTOR_CHECK_ORDER: readonly string[];
+export declare const BUZZ_DOCTOR_STATUSES: ReadonlySet<string>;
+export declare const BUZZ_DOCTOR_ACTION_SURFACES: ReadonlySet<string>;
+export declare const BUZZ_DOCTOR_MAX_AGE_MS: number;
+/** The reason an action violates the contract, or null. */
+export declare function validateBuzzDoctorAction(action: any, { surface }?: {
+    surface?: string;
+}): string | null;
+/** Whether a report honours the contract and is bound to the expected session, fresh. */
+export declare function validateBuzzDoctorReport(report: any, { expectedSubjectHex, walletProfile, nodeExecutable, run402Executable, relayOrigin, now, }?: {
+    expectedSubjectHex?: string | null;
+    walletProfile?: string;
+    nodeExecutable?: string | null;
+    run402Executable?: string | null;
+    relayOrigin?: string | null;
+    now?: number;
+}): {
+    valid: boolean;
+    reason: string | null;
+};
+//# sourceMappingURL=buzz-doctor-contract.d.ts.map

package/dist/node/buzz-doctor-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buzz-doctor-contract.d.ts","sourceRoot":"","sources":["../../src/node/buzz-doctor-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,uDAAuD;AACvD,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ItB,CAAC;AAEZ,qDAAqD;AACrD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwHvB,CAAC;AAEZ,eAAO,MAAM,uBAAuB,EAAE,MAAyC,CAAC;AAChF,eAAO,MAAM,uBAAuB,EAAE,SAAS,MAAM,EAAqC,CAAC;AAC3F,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAA0C,CAAC;AAChG,eAAO,MAAM,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAsD,CAAC;AACnH,eAAO,MAAM,sBAAsB,EAAE,MAA8D,CAAC;AAEpG,2DAA2D;AAC3D,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,MAAM,GAAG,IAAI,CA0B3G;AAED,yFAAyF;AACzF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,GAAG,EAAE,EACpD,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,GAAgB,GACjB,GAAE;IACD,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CA4CjD"}

package/dist/node/buzz-doctor-contract.js

@@ -0,0 +1,385 @@
+/**
+ * The frozen Buzz setup preflight contract (`run402.buzz-doctor.v1`) and the
+ * released Buzz CLI v0.5.2 capability fixture `r.buzz.doctor()` probes
+ * against. The objects below are the published fixtures verbatim
+ * (`buzz/fixtures/run402-buzz-doctor-v1-contract.json` and
+ * `buzz/fixtures/buzz-v0.5.2-cli-capabilities.json`, shipped with the
+ * `run402-buzz` skill); `buzz-doctor-contract.test.ts` fails when they drift.
+ * The validators are what a consumer of a doctor report (the Buzz setup
+ * helper) applies before trusting it.
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+function deepFreeze(value) {
+    if (!value || typeof value !== "object" || Object.isFrozen(value))
+        return value;
+    Object.freeze(value);
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return value;
+}
+/** `run402-buzz-doctor-v1-contract.json`, verbatim. */
+export const BUZZ_DOCTOR_CONTRACT = deepFreeze({
+    "schema_version": 1,
+    "contract_id": "run402.buzz-doctor.v1",
+    "mode": "buzz",
+    "canonical_invocation": [
+        "run402",
+        "--wallet",
+        "<profile>",
+        "doctor",
+        "--buzz",
+        "--buzz-agent",
+        "<npub-or-hex>"
+    ],
+    "flags": {
+        "mode": "--buzz",
+        "agent": "--buzz-agent",
+        "profile": "--wallet"
+    },
+    "check_order": [
+        "session_shell",
+        "node_runtime",
+        "run402_cli",
+        "buzz_cli",
+        "buzz_agent_target",
+        "run402_api",
+        "run402_console",
+        "buzz_relay",
+        "wallet_profile"
+    ],
+    "statuses": [
+        "ok",
+        "warning",
+        "blocked"
+    ],
+    "codes_by_check": {
+        "session_shell": [
+            "BUZZ_PREFLIGHT_SHELL_UNAVAILABLE"
+        ],
+        "node_runtime": [
+            "BUZZ_PREFLIGHT_NODE_UNAVAILABLE",
+            "BUZZ_PREFLIGHT_NODE_INCOMPATIBLE"
+        ],
+        "run402_cli": [
+            "BUZZ_PREFLIGHT_RUN402_UNAVAILABLE",
+            "BUZZ_PREFLIGHT_RUN402_INCOMPATIBLE",
+            "BUZZ_PREFLIGHT_RUN402_UPDATE_AVAILABLE"
+        ],
+        "buzz_cli": [
+            "BUZZ_PREFLIGHT_BUZZ_CLI_UNAVAILABLE",
+            "BUZZ_PREFLIGHT_BUZZ_CLI_INCOMPATIBLE"
+        ],
+        "buzz_agent_target": [
+            "BUZZ_AGENT_TARGET_REQUIRED",
+            "BUZZ_AGENT_TARGET_UNVERIFIED",
+            "BUZZ_AGENT_TARGET_MISMATCH"
+        ],
+        "run402_api": [
+            "BUZZ_PREFLIGHT_API_UNREACHABLE"
+        ],
+        "run402_console": [
+            "BUZZ_PREFLIGHT_CONSOLE_UNREACHABLE"
+        ],
+        "buzz_relay": [
+            "BUZZ_PREFLIGHT_RELAY_UNSAFE",
+            "BUZZ_PREFLIGHT_RELAY_UNREACHABLE"
+        ],
+        "wallet_profile": [
+            "BUZZ_PREFLIGHT_WALLET_PROFILE_REQUIRED",
+            "BUZZ_PREFLIGHT_WALLET_PROFILE_NOT_FOUND",
+            "BUZZ_PREFLIGHT_WALLET_PROFILE_MISMATCH"
+        ]
+    },
+    "next_action": {
+        "required_fields": [
+            "type",
+            "surface",
+            "command",
+            "why",
+            "safe_to_auto_execute",
+            "requires_approval",
+            "destructive",
+            "idempotent",
+            "spend_impact"
+        ],
+        "surfaces": [
+            "shell",
+            "buzz_chat",
+            "buzz_settings"
+        ],
+        "shell_required_fields": [
+            "argv"
+        ],
+        "non_shell_forbidden_fields": [
+            "argv",
+            "cwd"
+        ],
+        "cardinality_per_actionable_check": 1
+    },
+    "exit_behavior": {
+        "passed_or_warning_only": 0,
+        "completed_with_blocked_checks": 1,
+        "usage_error": 1,
+        "completed_report_stream": "stdout",
+        "usage_error_stream": "stderr"
+    },
+    "freshness": {
+        "max_age_seconds": 60,
+        "binding_fields": [
+            "contract_id",
+            "expected_subject_hex",
+            "wallet_profile",
+            "node_executable",
+            "run402_executable",
+            "relay_origin"
+        ]
+    },
+    "setup_rejection_codes": [
+        "BUZZ_PREFLIGHT_REPORT_INVALID",
+        "BUZZ_PREFLIGHT_REPORT_STALE",
+        "BUZZ_PREFLIGHT_REPORT_MISMATCH"
+    ],
+    "zero_mutation": {
+        "mutation_state": "not_started",
+        "forbidden": [
+            "buzz_event_publish",
+            "buzz_arbitrary_sign",
+            "run402_profile_create_or_select",
+            "run402_wallet_create",
+            "run402_identity_link_mutation",
+            "run402_faucet",
+            "run402_tier_mutation",
+            "run402_project_mutation",
+            "run402_deploy"
+        ],
+        "allowed_lossy_local_writes": [
+            "cli_update_cache",
+            "redacted_diagnostic_queue"
+        ]
+    }
+});
+/** `buzz-v0.5.2-cli-capabilities.json`, verbatim. */
+export const BUZZ_CLI_CAPABILITIES = deepFreeze({
+    "fixture_version": 1,
+    "fixture_id": "buzz-cli-v0.5.2-capabilities",
+    "purpose": "released_buzz_cli_capability_first_compatibility",
+    "buzz_release": {
+        "version": "0.5.2",
+        "release_tag": "v0.5.2",
+        "release_tag_commit": "3e48f1b2365d326ee1c9582448d86a99b44ecd5d",
+        "run402_change_required": false
+    },
+    "help_probes": [
+        {
+            "argv": [
+                "buzz",
+                "--help"
+            ],
+            "exit_code": 0,
+            "stdout_contains": [
+                "Buzz CLI \u2014 interact with a Buzz relay",
+                "users",
+                "social",
+                "Errors are JSON on stderr"
+            ]
+        },
+        {
+            "argv": [
+                "buzz",
+                "users",
+                "get",
+                "--help"
+            ],
+            "exit_code": 0,
+            "stdout_contains": [
+                "users get [OPTIONS]",
+                "--pubkey",
+                "Omit for your own profile"
+            ]
+        },
+        {
+            "argv": [
+                "buzz",
+                "social",
+                "publish",
+                "--help"
+            ],
+            "exit_code": 0,
+            "stdout_contains": [
+                "social publish [OPTIONS]",
+                "--content"
+            ]
+        },
+        {
+            "argv": [
+                "buzz",
+                "social",
+                "event",
+                "--help"
+            ],
+            "exit_code": 0,
+            "stdout_contains": [
+                "social event --event"
+            ]
+        }
+    ],
+    "version_probe": {
+        "argv": [
+            "buzz",
+            "--version"
+        ],
+        "supported": false,
+        "exit_code": 1,
+        "stderr_json": {
+            "error": "user_error",
+            "retryable": false
+        },
+        "message_contains": "unexpected argument '--version'"
+    },
+    "json_contract": {
+        "default_output_format": "json",
+        "users_get_success_stdout": {
+            "type": "array",
+            "empty_array_means": "public_self_profile_unverified",
+            "profile_pubkey_field": "pubkey"
+        },
+        "social_event_success_stdout": {
+            "type": "array",
+            "event_pubkey_field": "pubkey"
+        },
+        "error_stderr": {
+            "type": "object",
+            "required_fields": [
+                "error",
+                "message",
+                "retryable"
+            ],
+            "stdout_is_empty": true
+        }
+    },
+    "managed_sidecar": {
+        "distribution": "bundled_with_buzz_desktop",
+        "session_discovery": "managed_agent_path",
+        "public_package_manager_install": false,
+        "repair_surface": "buzz_settings",
+        "repair_destination": "Buzz Desktop > Settings > Updates",
+        "repair_instruction": "Open Buzz Desktop > Settings > Updates, install the available Buzz update or reinstall Buzz Desktop if no update is offered, then restart this agent and rerun setup."
+    },
+    "public_self_observation": {
+        "argv": [
+            "buzz",
+            "users",
+            "get"
+        ],
+        "requires_private_key_value_inspection": false,
+        "empty_or_malformed_result": "BUZZ_AGENT_TARGET_UNVERIFIED"
+    },
+    "write_surface_policy": {
+        "capability_probes_use_help_only": true,
+        "publish_is_never_invoked_by_doctor": true,
+        "event_read_requires_explicit_event_id_and_is_not_used_for_self_discovery": true
+    }
+});
+export const BUZZ_DOCTOR_CONTRACT_ID = BUZZ_DOCTOR_CONTRACT.contract_id;
+export const BUZZ_DOCTOR_CHECK_ORDER = BUZZ_DOCTOR_CONTRACT.check_order;
+export const BUZZ_DOCTOR_STATUSES = new Set(BUZZ_DOCTOR_CONTRACT.statuses);
+export const BUZZ_DOCTOR_ACTION_SURFACES = new Set(BUZZ_DOCTOR_CONTRACT.next_action.surfaces);
+export const BUZZ_DOCTOR_MAX_AGE_MS = BUZZ_DOCTOR_CONTRACT.freshness.max_age_seconds * 1000;
+/** The reason an action violates the contract, or null. */
+export function validateBuzzDoctorAction(action, { surface } = {}) {
+    if (!action || typeof action !== "object" || Array.isArray(action))
+        return "action_not_object";
+    for (const field of BUZZ_DOCTOR_CONTRACT.next_action.required_fields) {
+        if (!(field in action))
+            return `action_missing_${field}`;
+    }
+    if (!BUZZ_DOCTOR_ACTION_SURFACES.has(action.surface))
+        return "action_surface_invalid";
+    if (surface && action.surface !== surface)
+        return "action_surface_mismatch";
+    if (typeof action.type !== "string" || action.type.length === 0)
+        return "action_type_invalid";
+    if (typeof action.command !== "string" || action.command.length === 0)
+        return "action_command_invalid";
+    if (typeof action.why !== "string" || action.why.length === 0)
+        return "action_why_invalid";
+    for (const field of ["safe_to_auto_execute", "requires_approval", "destructive", "idempotent"]) {
+        if (typeof action[field] !== "boolean")
+            return `action_${field}_invalid`;
+    }
+    if (!action.spend_impact || action.spend_impact.currency !== "USD" || action.spend_impact.max_amount !== "0") {
+        return "action_spend_impact_invalid";
+    }
+    if (action.surface === "shell") {
+        if (!Array.isArray(action.argv) || action.argv.length === 0 || action.argv.some((part) => typeof part !== "string")) {
+            return "action_argv_invalid";
+        }
+    }
+    else {
+        for (const field of BUZZ_DOCTOR_CONTRACT.next_action.non_shell_forbidden_fields) {
+            if (field in action)
+                return `action_${field}_forbidden`;
+        }
+    }
+    return null;
+}
+/** Whether a report honours the contract and is bound to the expected session, fresh. */
+export function validateBuzzDoctorReport(report, { expectedSubjectHex, walletProfile, nodeExecutable, run402Executable, relayOrigin, now = Date.now(), } = {}) {
+    if (!report || typeof report !== "object" || Array.isArray(report))
+        return { valid: false, reason: "report_not_object" };
+    if (report.contract_id !== BUZZ_DOCTOR_CONTRACT_ID || report.mode !== "buzz")
+        return { valid: false, reason: "contract_mismatch" };
+    if (!Array.isArray(report.checks))
+        return { valid: false, reason: "checks_not_array" };
+    if (report.checks.length !== BUZZ_DOCTOR_CHECK_ORDER.length)
+        return { valid: false, reason: "check_count_mismatch" };
+    for (let index = 0; index < BUZZ_DOCTOR_CHECK_ORDER.length; index += 1) {
+        const check = report.checks[index];
+        const expectedName = BUZZ_DOCTOR_CHECK_ORDER[index];
+        if (!check || check.name !== expectedName)
+            return { valid: false, reason: "check_order_mismatch" };
+        if (!BUZZ_DOCTOR_STATUSES.has(check.status))
+            return { valid: false, reason: "check_status_invalid" };
+        const codes = BUZZ_DOCTOR_CONTRACT.codes_by_check[expectedName];
+        if (check.status === "blocked" && !codes?.includes(check.code)) {
+            return { valid: false, reason: "check_code_invalid" };
+        }
+        const actionable = check.status === "blocked" || (check.status === "warning" && Array.isArray(check.next_actions));
+        if (actionable) {
+            if (!Array.isArray(check.next_actions) || check.next_actions.length !== 1)
+                return { valid: false, reason: "action_cardinality_invalid" };
+            const actionReason = validateBuzzDoctorAction(check.next_actions[0]);
+            if (actionReason)
+                return { valid: false, reason: actionReason };
+        }
+        else if ("next_actions" in check) {
+            return { valid: false, reason: "passing_action_forbidden" };
+        }
+    }
+    const generatedAt = Date.parse(report.generated_at);
+    if (!Number.isFinite(generatedAt) || generatedAt > now || now - generatedAt > BUZZ_DOCTOR_MAX_AGE_MS) {
+        return { valid: false, reason: "report_stale" };
+    }
+    const binding = report.binding;
+    if (!binding || typeof binding !== "object")
+        return { valid: false, reason: "binding_missing" };
+    const expected = {
+        contract_id: BUZZ_DOCTOR_CONTRACT_ID,
+        expected_subject_hex: expectedSubjectHex,
+        wallet_profile: walletProfile,
+        node_executable: nodeExecutable,
+        run402_executable: run402Executable,
+        relay_origin: relayOrigin,
+    };
+    for (const field of BUZZ_DOCTOR_CONTRACT.freshness.binding_fields) {
+        if (expected[field] !== undefined && binding[field] !== expected[field])
+            return { valid: false, reason: `binding_${field}_mismatch` };
+    }
+    const computedOk = report.checks.every((check) => check.status !== "blocked");
+    if (report.ok !== computedOk)
+        return { valid: false, reason: "verdict_mismatch" };
+    if (report.mutation_state !== BUZZ_DOCTOR_CONTRACT.zero_mutation.mutation_state)
+        return { valid: false, reason: "mutation_state_invalid" };
+    return { valid: true, reason: null };
+}
+//# sourceMappingURL=buzz-doctor-contract.js.map

package/dist/node/buzz-doctor-contract.js.map

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