core-runtime-engine 11.5.1__py3-none-any.whl

core_runtime/data/schemas/core/template_promotion_candidate.v1.json

@@ -0,0 +1,83 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://core-runtime-engine.local/schemas/core/template_promotion_candidate.v1.json",
+  "title": "TemplatePromotionCandidate.v1",
+  "type": "object",
+  "additionalProperties": true,
+  "required": [
+    "schema_version",
+    "type",
+    "template_candidate_id",
+    "source_pattern_id",
+    "required_inputs",
+    "output_contract",
+    "expected_evidence",
+    "risk_tier",
+    "stop_conditions",
+    "human_approval_required"
+  ],
+  "properties": {
+    "schema_version": {
+      "type": "string",
+      "const": "core.template_promotion_candidate.v1"
+    },
+    "type": {
+      "type": "string",
+      "const": "template_promotion_candidate"
+    },
+    "template_candidate_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "source_pattern_id": {
+      "type": "string",
+      "minLength": 1
+    },
+    "required_inputs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "output_contract": {
+      "type": "string",
+      "minLength": 1
+    },
+    "expected_evidence": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "risk_tier": {
+      "type": "string",
+      "enum": ["low", "medium", "high"]
+    },
+    "stop_conditions": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "human_approval_required": {
+      "type": "boolean"
+    },
+    "source_refs": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    },
+    "notes": {
+      "type": "array",
+      "items": {
+        "type": "string",
+        "minLength": 1
+      }
+    }
+  }
+}

core_runtime/data/schemas/core/unsigned_rule_anchor_deployment.v1.json

@@ -0,0 +1,106 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://core.antillanca.dev/schemas/core/unsigned_rule_anchor_deployment.v1.json",
+  "title": "UnsignedRuleAnchorDeployment.v1",
+  "description": "An unsigned CoreRuleAnchor deployment request for external-wallet review.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "type",
+    "signing_mode",
+    "broadcast",
+    "contract_build_fingerprint",
+    "expected_runtime_bytecode_sha256",
+    "transaction",
+    "gas_reserve",
+    "readiness",
+    "warnings",
+    "fingerprint"
+  ],
+  "properties": {
+    "schema_version": {"const": "core.unsigned_rule_anchor_deployment.v1"},
+    "type": {"const": "unsigned_rule_anchor_deployment"},
+    "signing_mode": {"const": "external_wallet_only"},
+    "broadcast": {"const": false},
+    "contract_build_fingerprint": {"$ref": "#/definitions/fingerprint"},
+    "expected_runtime_bytecode_sha256": {"$ref": "#/definitions/fingerprint"},
+    "transaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to",
+        "chain_id",
+        "value_wei",
+        "data",
+        "nonce",
+        "gas_limit",
+        "max_fee_per_gas_wei",
+        "max_priority_fee_per_gas_wei",
+        "gas_price_wei"
+      ],
+      "properties": {
+        "from": {"$ref": "#/definitions/address"},
+        "to": {"type": "null"},
+        "chain_id": {"type": "integer", "minimum": 1},
+        "value_wei": {"const": 0},
+        "data": {"type": "string", "pattern": "^0x[a-f0-9]+$"},
+        "nonce": {"$ref": "#/definitions/nullable_integer"},
+        "gas_limit": {"$ref": "#/definitions/nullable_positive_integer"},
+        "max_fee_per_gas_wei": {"$ref": "#/definitions/nullable_integer"},
+        "max_priority_fee_per_gas_wei": {"$ref": "#/definitions/nullable_integer"},
+        "gas_price_wei": {"$ref": "#/definitions/nullable_integer"}
+      }
+    },
+    "gas_reserve": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "deployment_max_cost_wei",
+        "post_deployment_reserve_wei",
+        "required_balance_wei",
+        "observed_balance_wei",
+        "shortfall_wei",
+        "sufficient"
+      ],
+      "properties": {
+        "unit": {"const": "native_wei"},
+        "deployment_max_cost_wei": {"$ref": "#/definitions/nullable_integer"},
+        "post_deployment_reserve_wei": {"type": "integer", "minimum": 0},
+        "required_balance_wei": {"$ref": "#/definitions/nullable_integer"},
+        "observed_balance_wei": {"$ref": "#/definitions/nullable_integer"},
+        "shortfall_wei": {"$ref": "#/definitions/nullable_integer"},
+        "sufficient": {"type": ["boolean", "null"]}
+      }
+    },
+    "readiness": {
+      "enum": ["ready", "insufficient_balance", "offline_unpriced", "balance_unobserved"]
+    },
+    "warnings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string", "minLength": 1}
+    },
+    "fingerprint": {"$ref": "#/definitions/fingerprint"}
+  },
+  "definitions": {
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "address": {
+      "type": "string",
+      "pattern": "^0x[a-fA-F0-9]{40}$"
+    },
+    "nullable_integer": {
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
+    "nullable_positive_integer": {
+      "type": ["integer", "null"],
+      "minimum": 1
+    }
+  }
+}

core_runtime/data/schemas/core/unsigned_rule_anchor_transaction.v1.json

@@ -0,0 +1,116 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://core.antillanca.dev/schemas/core/unsigned_rule_anchor_transaction.v1.json",
+  "title": "UnsignedRuleAnchorTransaction.v1",
+  "description": "An unsigned transaction request for external-wallet review. It cannot contain wallet secrets and never broadcasts itself.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "type",
+    "signing_mode",
+    "broadcast",
+    "batch_manifest_fingerprint",
+    "rule_set_count",
+    "transaction",
+    "gas_reserve",
+    "contract_code_verified",
+    "readiness",
+    "warnings",
+    "fingerprint"
+  ],
+  "properties": {
+    "schema_version": {"const": "core.unsigned_rule_anchor_transaction.v1"},
+    "type": {"const": "unsigned_rule_anchor_transaction"},
+    "signing_mode": {"const": "external_wallet_only"},
+    "broadcast": {"const": false},
+    "batch_manifest_fingerprint": {"$ref": "#/definitions/fingerprint"},
+    "rule_set_count": {"type": "integer", "minimum": 1, "maximum": 4294967295},
+    "transaction": {"$ref": "#/definitions/transaction"},
+    "gas_reserve": {"$ref": "#/definitions/gas_reserve"},
+    "contract_code_verified": {"type": ["boolean", "null"]},
+    "readiness": {
+      "enum": [
+        "ready",
+        "insufficient_balance",
+        "contract_unverified",
+        "offline_unpriced",
+        "balance_unobserved"
+      ]
+    },
+    "warnings": {
+      "type": "array",
+      "minItems": 1,
+      "items": {"type": "string", "minLength": 1}
+    },
+    "fingerprint": {"$ref": "#/definitions/fingerprint"}
+  },
+  "definitions": {
+    "fingerprint": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$"
+    },
+    "address": {
+      "type": "string",
+      "pattern": "^0x[a-fA-F0-9]{40}$"
+    },
+    "nullable_integer": {
+      "type": ["integer", "null"],
+      "minimum": 0
+    },
+    "transaction": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "from",
+        "to",
+        "chain_id",
+        "value_wei",
+        "data",
+        "nonce",
+        "gas_limit",
+        "max_fee_per_gas_wei",
+        "max_priority_fee_per_gas_wei",
+        "gas_price_wei"
+      ],
+      "properties": {
+        "from": {"$ref": "#/definitions/address"},
+        "to": {"$ref": "#/definitions/address"},
+        "chain_id": {"type": "integer", "minimum": 1},
+        "value_wei": {"const": 0},
+        "data": {"type": "string", "pattern": "^0x[a-f0-9]{264}$"},
+        "nonce": {"$ref": "#/definitions/nullable_integer"},
+        "gas_limit": {"$ref": "#/definitions/nullable_integer"},
+        "max_fee_per_gas_wei": {"$ref": "#/definitions/nullable_integer"},
+        "max_priority_fee_per_gas_wei": {"$ref": "#/definitions/nullable_integer"},
+        "gas_price_wei": {"$ref": "#/definitions/nullable_integer"}
+      }
+    },
+    "gas_reserve": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "unit",
+        "reserve_batches",
+        "safety_multiplier_bps",
+        "per_batch_max_cost_wei",
+        "max_cost_per_rule_wei",
+        "required_balance_wei",
+        "observed_balance_wei",
+        "shortfall_wei",
+        "sufficient"
+      ],
+      "properties": {
+        "unit": {"const": "native_wei"},
+        "reserve_batches": {"type": "integer", "minimum": 1},
+        "safety_multiplier_bps": {"type": "integer", "minimum": 10000},
+        "per_batch_max_cost_wei": {"$ref": "#/definitions/nullable_integer"},
+        "max_cost_per_rule_wei": {"$ref": "#/definitions/nullable_integer"},
+        "required_balance_wei": {"$ref": "#/definitions/nullable_integer"},
+        "observed_balance_wei": {"$ref": "#/definitions/nullable_integer"},
+        "shortfall_wei": {"$ref": "#/definitions/nullable_integer"},
+        "sufficient": {"type": ["boolean", "null"]}
+      }
+    }
+  }
+}

core_runtime/tooling/__init__.py

@@ -0,0 +1,48 @@
+"""CORE Tooling - internal tooling package for CORE maintenance commands."""
+
+from __future__ import annotations
+
+from core_runtime.tooling.bump_version import BumpVersionPlanner, PlannedChange, ReplacementRule
+from core_runtime.tooling.diagnostics import (
+    Diagnostic,
+    DiagnosticCollection,
+    ExitCode,
+    Severity,
+)
+from core_runtime.tooling.file_inventory import FileInventory, REQUIRED_FILES, REQUIRED_DIRS
+from core_runtime.tooling.json_checks import JSONChecks
+from core_runtime.tooling.report_writer import ReportWriter
+from core_runtime.tooling.release_check import (
+    ReleaseCheckReport,
+    ReleaseCheckRunner,
+    SubprocessCapture,
+    normalize_release_target,
+    release_target_argument,
+    validate_release_target,
+)
+from core_runtime.tooling.safety_checks import SafetyChecks
+from core_runtime.tooling.version_inventory import VersionInventory, VersionSource
+
+__all__ = [
+    "BumpVersionPlanner",
+    "Diagnostic",
+    "DiagnosticCollection",
+    "ExitCode",
+    "PlannedChange",
+    "ReplacementRule",
+    "Severity",
+    "FileInventory",
+    "REQUIRED_FILES",
+    "REQUIRED_DIRS",
+    "JSONChecks",
+    "ReleaseCheckReport",
+    "ReleaseCheckRunner",
+    "SubprocessCapture",
+    "ReportWriter",
+    "normalize_release_target",
+    "release_target_argument",
+    "validate_release_target",
+    "SafetyChecks",
+    "VersionInventory",
+    "VersionSource",
+]