percolation-inversion-compiler-ts 0.4.4

package/schemas/OperationalReadinessReport.schema.json

@@ -0,0 +1,216 @@
+{
+  "$defs": {
+    "CommercialReadinessSummary": {
+      "description": "Practical onboarding readiness summary for commercial and OSS users.",
+      "properties": {
+        "accepted": {
+          "default": false,
+          "title": "Accepted",
+          "type": "boolean"
+        },
+        "bounded_intake_default": {
+          "default": true,
+          "title": "Bounded Intake Default",
+          "type": "boolean"
+        },
+        "checks": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "title": "Checks",
+          "type": "object"
+        },
+        "connector_dependency_ready": {
+          "default": false,
+          "title": "Connector Dependency Ready",
+          "type": "boolean"
+        },
+        "curated_demo_available": {
+          "default": false,
+          "title": "Curated Demo Available",
+          "type": "boolean"
+        },
+        "identity_ready": {
+          "default": false,
+          "title": "Identity Ready",
+          "type": "boolean"
+        },
+        "install_mode": {
+          "default": "unknown",
+          "title": "Install Mode",
+          "type": "string"
+        },
+        "live_connector_opt_out_available": {
+          "default": true,
+          "title": "Live Connector Opt Out Available",
+          "type": "boolean"
+        },
+        "live_connectors_default_enabled": {
+          "title": "Live Connectors Default Enabled",
+          "type": "boolean"
+        },
+        "live_connectors_default_off": {
+          "default": false,
+          "title": "Live Connectors Default Off",
+          "type": "boolean"
+        },
+        "live_default_mode": {
+          "title": "Live Default Mode",
+          "type": "string"
+        },
+        "onboarding_status": {
+          "default": "diagnostic",
+          "title": "Onboarding Status",
+          "type": "string"
+        },
+        "operationally_usable": {
+          "default": false,
+          "title": "Operationally Usable",
+          "type": "boolean"
+        },
+        "package_version": {
+          "default": "",
+          "title": "Package Version",
+          "type": "string"
+        },
+        "production_identity_required": {
+          "default": false,
+          "title": "Production Identity Required",
+          "type": "boolean"
+        },
+        "provenance_verified": {
+          "default": false,
+          "title": "Provenance Verified",
+          "type": "boolean"
+        },
+        "reasons": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Reasons",
+          "type": "array"
+        },
+        "schema_count": {
+          "default": 0,
+          "title": "Schema Count",
+          "type": "integer"
+        },
+        "schema_registry_ready": {
+          "default": false,
+          "title": "Schema Registry Ready",
+          "type": "boolean"
+        },
+        "security_metadata_present": {
+          "default": false,
+          "title": "Security Metadata Present",
+          "type": "boolean"
+        },
+        "settled": {
+          "default": false,
+          "title": "Settled",
+          "type": "boolean"
+        },
+        "snapshot_bundle_ready": {
+          "default": false,
+          "title": "Snapshot Bundle Ready",
+          "type": "boolean"
+        },
+        "snapshot_count": {
+          "default": 0,
+          "title": "Snapshot Count",
+          "type": "integer"
+        },
+        "summary_id": {
+          "default": "pic-commercial-readiness",
+          "title": "Summary Id",
+          "type": "string"
+        },
+        "token_ready": {
+          "default": false,
+          "title": "Token Ready",
+          "type": "boolean"
+        }
+      },
+      "title": "CommercialReadinessSummary",
+      "type": "object"
+    },
+    "OperationalCheck": {
+      "description": "One deterministic operational readiness check.",
+      "properties": {
+        "check_id": {
+          "title": "Check Id",
+          "type": "string"
+        },
+        "details": {
+          "additionalProperties": true,
+          "title": "Details",
+          "type": "object"
+        },
+        "message": {
+          "title": "Message",
+          "type": "string"
+        },
+        "status": {
+          "title": "Status",
+          "type": "string"
+        }
+      },
+      "required": [
+        "check_id",
+        "status",
+        "message"
+      ],
+      "title": "OperationalCheck",
+      "type": "object"
+    }
+  },
+  "description": "Machine-readable environment report for CI and autonomous agents.",
+  "properties": {
+    "checks": {
+      "items": {
+        "$ref": "#/$defs/OperationalCheck"
+      },
+      "title": "Checks",
+      "type": "array"
+    },
+    "commercial_readiness": {
+      "$ref": "#/$defs/CommercialReadinessSummary"
+    },
+    "overall_status": {
+      "title": "Overall Status",
+      "type": "string"
+    },
+    "package_version": {
+      "title": "Package Version",
+      "type": "string"
+    },
+    "python_version": {
+      "title": "Python Version",
+      "type": "string"
+    },
+    "report_id": {
+      "default": "pic-operational-readiness",
+      "title": "Report Id",
+      "type": "string"
+    },
+    "safety_invariants": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Safety Invariants",
+      "type": "array"
+    },
+    "summary": {
+      "additionalProperties": true,
+      "title": "Summary",
+      "type": "object"
+    }
+  },
+  "required": [
+    "package_version",
+    "python_version",
+    "overall_status"
+  ],
+  "title": "OperationalReadinessReport",
+  "type": "object"
+}

package/schemas/OperatorAdoptionPacket.schema.json

@@ -0,0 +1,303 @@
+{
+  "$defs": {
+    "AdoptionFirstRunCommand": {
+      "description": "Command text for operator review; PIC does not execute it.",
+      "properties": {
+        "command": {
+          "title": "Command",
+          "type": "string"
+        },
+        "command_id": {
+          "title": "Command Id",
+          "type": "string"
+        },
+        "executed_by_pic": {
+          "default": false,
+          "title": "Executed By Pic",
+          "type": "boolean"
+        },
+        "expected_output": {
+          "default": "operator-reviewed command output",
+          "title": "Expected Output",
+          "type": "string"
+        },
+        "mutates_environment_if_operator_runs_it": {
+          "default": false,
+          "title": "Mutates Environment If Operator Runs It",
+          "type": "boolean"
+        },
+        "purpose": {
+          "title": "Purpose",
+          "type": "string"
+        },
+        "requires_operator_authority": {
+          "default": false,
+          "title": "Requires Operator Authority",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "command_id",
+        "command",
+        "purpose"
+      ],
+      "title": "AdoptionFirstRunCommand",
+      "type": "object"
+    },
+    "AdoptionReviewChecklist": {
+      "description": "Operator-facing checklist for deciding whether local use is allowed.",
+      "properties": {
+        "accepted": {
+          "default": true,
+          "title": "Accepted",
+          "type": "boolean"
+        },
+        "checklist_id": {
+          "default": "adoption-review-checklist",
+          "title": "Checklist Id",
+          "type": "string"
+        },
+        "interpretation_rules": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Interpretation Rules",
+          "type": "array"
+        },
+        "items": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Items",
+          "type": "array"
+        },
+        "settled": {
+          "default": false,
+          "title": "Settled",
+          "type": "boolean"
+        }
+      },
+      "title": "AdoptionReviewChecklist",
+      "type": "object"
+    },
+    "AdoptionSafetyBoundary": {
+      "description": "Non-authority boundary for operator-adoption sidecars.",
+      "properties": {
+        "affects_agent_accelerate": {
+          "default": false,
+          "title": "Affects Agent Accelerate",
+          "type": "boolean"
+        },
+        "affects_agent_check": {
+          "default": false,
+          "title": "Affects Agent Check",
+          "type": "boolean"
+        },
+        "affects_packet_promotion": {
+          "default": false,
+          "title": "Affects Packet Promotion",
+          "type": "boolean"
+        },
+        "affects_phase_plan": {
+          "default": false,
+          "title": "Affects Phase Plan",
+          "type": "boolean"
+        },
+        "affects_settled": {
+          "default": false,
+          "title": "Affects Settled",
+          "type": "boolean"
+        },
+        "approval_settles_truth": {
+          "default": false,
+          "title": "Approval Settles Truth",
+          "type": "boolean"
+        },
+        "boundary_id": {
+          "default": "adoption-safety-boundary",
+          "title": "Boundary Id",
+          "type": "string"
+        },
+        "calls_network": {
+          "default": false,
+          "title": "Calls Network",
+          "type": "boolean"
+        },
+        "clones_repository": {
+          "default": false,
+          "title": "Clones Repository",
+          "type": "boolean"
+        },
+        "creates_required_approval_state": {
+          "default": false,
+          "title": "Creates Required Approval State",
+          "type": "boolean"
+        },
+        "executes_shell_commands": {
+          "default": false,
+          "title": "Executes Shell Commands",
+          "type": "boolean"
+        },
+        "installs_package": {
+          "default": false,
+          "title": "Installs Package",
+          "type": "boolean"
+        },
+        "invariants": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Invariants",
+          "type": "array"
+        },
+        "modifies_config_files": {
+          "default": false,
+          "title": "Modifies Config Files",
+          "type": "boolean"
+        },
+        "mutates_runtime_state": {
+          "default": false,
+          "title": "Mutates Runtime State",
+          "type": "boolean"
+        },
+        "pure_output_generator": {
+          "default": true,
+          "title": "Pure Output Generator",
+          "type": "boolean"
+        },
+        "safe_commands_are_execution_authority": {
+          "default": false,
+          "title": "Safe Commands Are Execution Authority",
+          "type": "boolean"
+        },
+        "settled": {
+          "default": false,
+          "title": "Settled",
+          "type": "boolean"
+        },
+        "sidecar_only": {
+          "default": true,
+          "title": "Sidecar Only",
+          "type": "boolean"
+        }
+      },
+      "title": "AdoptionSafetyBoundary",
+      "type": "object"
+    }
+  },
+  "description": "Operator-facing overview packet for optional PIC adoption.",
+  "properties": {
+    "accepted": {
+      "default": true,
+      "title": "Accepted",
+      "type": "boolean"
+    },
+    "accepted_true_meaning": {
+      "default": "accepted=true means the finite checker accepted the report shape and routing record; it does not mean final truth or settled obligations.",
+      "title": "Accepted True Meaning",
+      "type": "string"
+    },
+    "candidate_work_rationale": {
+      "default": "AI-agent output is treated as candidate work until finite verifier, residual, identity, route, rollback, and promotion checks accept the scoped packet.",
+      "title": "Candidate Work Rationale",
+      "type": "string"
+    },
+    "compact_json_fields_to_inspect": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Compact Json Fields To Inspect",
+      "type": "array"
+    },
+    "distribution_modes": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Distribution Modes",
+      "type": "array"
+    },
+    "features_requiring_explicit_operator_permission": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Features Requiring Explicit Operator Permission",
+      "type": "array"
+    },
+    "first_run_commands": {
+      "items": {
+        "$ref": "#/$defs/AdoptionFirstRunCommand"
+      },
+      "title": "First Run Commands",
+      "type": "array"
+    },
+    "operationally_usable": {
+      "default": true,
+      "title": "Operationally Usable",
+      "type": "boolean"
+    },
+    "operator_adoption_status": {
+      "default": "not-recorded",
+      "title": "Operator Adoption Status",
+      "type": "string"
+    },
+    "packet_id": {
+      "default": "operator-adoption-packet",
+      "title": "Packet Id",
+      "type": "string"
+    },
+    "profile": {
+      "default": "development",
+      "title": "Profile",
+      "type": "string"
+    },
+    "reasons": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Reasons",
+      "type": "array"
+    },
+    "review_checklist": {
+      "$ref": "#/$defs/AdoptionReviewChecklist"
+    },
+    "safe_commands_meaning": {
+      "default": "safe_commands are deterministic hints to inspect or run only under operator authority.",
+      "title": "Safe Commands Meaning",
+      "type": "string"
+    },
+    "safety_boundary": {
+      "$ref": "#/$defs/AdoptionSafetyBoundary"
+    },
+    "settled": {
+      "default": false,
+      "title": "Settled",
+      "type": "boolean"
+    },
+    "settled_false_meaning": {
+      "default": "settled=false means unresolved obligations remain explicit; it is not command failure.",
+      "title": "Settled False Meaning",
+      "type": "string"
+    },
+    "what_pic_does": {
+      "items": {
+        "type": "string"
+      },
+      "title": "What Pic Does",
+      "type": "array"
+    },
+    "what_pic_does_not_do": {
+      "items": {
+        "type": "string"
+      },
+      "title": "What Pic Does Not Do",
+      "type": "array"
+    },
+    "workflow_usable": {
+      "default": true,
+      "title": "Workflow Usable",
+      "type": "boolean"
+    }
+  },
+  "title": "OperatorAdoptionPacket",
+  "type": "object"
+}

package/schemas/OpportunityMeasureContract.schema.json

@@ -0,0 +1,165 @@
+{
+  "$defs": {
+    "CoordinateKind": {
+      "enum": [
+        "benefit",
+        "burden",
+        "residual",
+        "tolerance",
+        "resource",
+        "metadata"
+      ],
+      "title": "CoordinateKind",
+      "type": "string"
+    },
+    "EvidenceStatus": {
+      "enum": [
+        "verified",
+        "declared",
+        "unknown"
+      ],
+      "title": "EvidenceStatus",
+      "type": "string"
+    },
+    "Ledger": {
+      "description": "A finite typed ledger with explicit coordinate kinds.",
+      "properties": {
+        "coordinates": {
+          "additionalProperties": {
+            "$ref": "#/$defs/LedgerCoordinate"
+          },
+          "title": "Coordinates",
+          "type": "object"
+        }
+      },
+      "title": "Ledger",
+      "type": "object"
+    },
+    "LedgerCoordinate": {
+      "description": "One typed coordinate in a finite certificate ledger.",
+      "properties": {
+        "description": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Description"
+        },
+        "evidence_refs": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Evidence Refs",
+          "type": "array"
+        },
+        "evidence_status": {
+          "$ref": "#/$defs/EvidenceStatus",
+          "default": "declared"
+        },
+        "kind": {
+          "$ref": "#/$defs/CoordinateKind",
+          "default": "burden"
+        },
+        "known": {
+          "default": true,
+          "title": "Known",
+          "type": "boolean"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "unit": {
+          "default": "dimensionless",
+          "title": "Unit",
+          "type": "string"
+        },
+        "value": {
+          "title": "Value",
+          "type": "number"
+        }
+      },
+      "required": [
+        "name",
+        "value"
+      ],
+      "title": "LedgerCoordinate",
+      "type": "object"
+    }
+  },
+  "description": "Declared finite opportunity measure used to value a token.",
+  "properties": {
+    "accepted": {
+      "default": false,
+      "title": "Accepted",
+      "type": "boolean"
+    },
+    "baseline_ref": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "default": null,
+      "title": "Baseline Ref"
+    },
+    "contract_id": {
+      "title": "Contract Id",
+      "type": "string"
+    },
+    "evidence_refs": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Evidence Refs",
+      "type": "array"
+    },
+    "horizon": {
+      "default": "finite",
+      "title": "Horizon",
+      "type": "string"
+    },
+    "mission_id": {
+      "title": "Mission Id",
+      "type": "string"
+    },
+    "reasons": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Reasons",
+      "type": "array"
+    },
+    "receiver_family": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Receiver Family",
+      "type": "array"
+    },
+    "residual_ledger": {
+      "$ref": "#/$defs/Ledger"
+    },
+    "task_portfolio_refs": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Task Portfolio Refs",
+      "type": "array"
+    }
+  },
+  "required": [
+    "contract_id",
+    "mission_id"
+  ],
+  "title": "OpportunityMeasureContract",
+  "type": "object"
+}