percolation-inversion-compiler-ts 0.4.4

package/fixtures/portability_conformance/salience_schedule_report.json

@@ -0,0 +1,100 @@
+{
+  "accepted": true,
+  "adversarial_transfer_charge": 0.0,
+  "aggregation_group_counts": {},
+  "aggregation_group_occupation": {},
+  "audit_recursion_violations": [],
+  "decisions": [
+    {
+      "decision": "run",
+      "operationally_usable": true,
+      "priority_score": 1.2,
+      "reasons": [],
+      "record_id": "packet:sqot-reserve",
+      "residual_ledger": {
+        "coordinates": {}
+      },
+      "settled": false,
+      "status": "provisional"
+    },
+    {
+      "decision": "rollback",
+      "operationally_usable": false,
+      "priority_score": 0.15,
+      "reasons": [
+        "queue record evidence hash is invalid"
+      ],
+      "record_id": "packet:hash-invalid",
+      "residual_ledger": {
+        "coordinates": {
+          "sqot:packet:hash-invalid:rollback": {
+            "description": null,
+            "evidence_refs": [],
+            "evidence_status": "declared",
+            "kind": "residual",
+            "known": true,
+            "name": "sqot:packet:hash-invalid:rollback",
+            "unit": "dimensionless",
+            "value": 0.25
+          }
+        }
+      },
+      "settled": false,
+      "status": "diagnostic"
+    }
+  ],
+  "diagnostic_reserve": {
+    "audit_depth": 1,
+    "minimum_reserve": 0.0,
+    "reserve_fraction": 0.1
+  },
+  "distributed_origin_count": 0,
+  "effective_diagnostic_reserve": 0.0,
+  "false_liquidity_rate": 0.5,
+  "label_laundering_suspicions": [],
+  "latency_deadline_loss": 0.0,
+  "low_contribution_occupation": 0.0,
+  "occupation_ledger": {
+    "attention_budget": 1.0,
+    "occupied": 0.19999999999999996,
+    "occupied_by_class": {
+      "diagnostic": 0.2
+    },
+    "unknown_occupation": []
+  },
+  "privacy_rejoin_refs": [],
+  "profile": "development",
+  "protocol_integrity_refs": [],
+  "quarantine_ledger": {
+    "quarantined_items": [],
+    "reasons": {
+      "packet:hash-invalid": [
+        "queue record evidence hash is invalid"
+      ]
+    },
+    "rollback_items": [
+      "packet:hash-invalid"
+    ]
+  },
+  "report_id": "sqot-salience-schedule",
+  "residual_debt_growth": 0.25,
+  "risk_ledger": {
+    "risk_budget": 1.0,
+    "risk_charges": {
+      "packet:sqot-reserve": 0.0
+    }
+  },
+  "rollback_class_summary": {
+    "none": 2
+  },
+  "safety_invariants": [
+    "queue priority never promotes obligations to settled status",
+    "stale, hash-invalid, authority-invalid, or unsafe-route items fail closed",
+    "diagnostic reserve is preserved before non-diagnostic work is scheduled"
+  ],
+  "sovereignty_kernel_refs": [],
+  "stale_packet_ratio": 0.0,
+  "thermodynamic_discharge_charge": 0.0,
+  "unresolved_obligation_backlog": 1,
+  "verifier_latency_proxy": 0.09999999999999998
+}

package/fixtures/portability_conformance/theory_fidelity_report.json

@@ -0,0 +1,53 @@
+{
+  "accepted": true,
+  "canonical_dir": "canonical-suite",
+  "external_obligation_totals": {
+    "alt": 54,
+    "bit": 0,
+    "ecpt": 30,
+    "sqot": 15,
+    "trc": 32
+  },
+  "finite_upgrade_candidates": {
+    "alt": [
+      "alt:common-estimand-bridge"
+    ],
+    "ecpt": [
+      "ecpt:proxy-target-grounding"
+    ],
+    "sqot": [
+      "sqot:reserve-adequacy"
+    ],
+    "trc": [
+      "trc:frontier-debt"
+    ]
+  },
+  "operationally_usable": true,
+  "partial_total": 0,
+  "report_id": "pic-theory-fidelity",
+  "settled": false,
+  "snapshot_health": {
+    "alt": true,
+    "bit": true,
+    "ecpt": true,
+    "sqot": true,
+    "trc": true
+  },
+  "strict_grammar_accepted": {
+    "alt": true,
+    "bit": true,
+    "ecpt": true,
+    "sqot": true,
+    "trc": true
+  },
+  "suite_status": "pass",
+  "theory_summaries": {
+    "ecpt": {
+      "external_obligation_total": 30,
+      "finite_upgrade_candidate_count": 1,
+      "snapshot_healthy": true,
+      "strict_grammar_accepted": true
+    }
+  },
+  "unsupported_total": 0
+}

package/fixtures/portability_conformance/value_bridge_report.json

@@ -0,0 +1,17 @@
+{
+  "accepted": true,
+  "calibrated_proxy_bridge_ready": true,
+  "causal_effect_ready": false,
+  "common_estimand_ready": true,
+  "common_estimand_refs": [
+    "estimand:shared-cost-reduction"
+  ],
+  "operationally_usable": true,
+  "proxy_bridge_refs": [
+    "bridge:proxy-to-value"
+  ],
+  "proxy_only": false,
+  "report_id": "alt-value-bridge:portability",
+  "settled": false,
+  "value_evidence_level": "calibrated-proxy"
+}

package/fixtures/python_v044_cli/adoption_packet.json

@@ -0,0 +1,131 @@
+{
+  "accepted": true,
+  "accepted_true_meaning": "accepted=true means the finite checker accepted the report shape and routing record; it does not mean final truth or settled obligations.",
+  "candidate_work_rationale": "AI-agent output is treated as candidate work until finite verifier, residual, identity, route, rollback, and promotion checks accept the scoped packet.",
+  "compact_json_fields_to_inspect": [
+    "accepted",
+    "workflow_usable",
+    "settled",
+    "unresolved_obligations",
+    "residual_summary",
+    "safe_commands",
+    "cannot_promote_because",
+    "candidate_only_reasons",
+    "settled_blockers",
+    "safety_invariants"
+  ],
+  "distribution_modes": [
+    "PyPI install: practical agent checks, bundled snapshots, schema export, demo bootstrap",
+    "source checkout: root examples, canonical TeX audits, development fixtures",
+    "Wiki: human-oriented conceptual guide",
+    "ClawHub skill: external agent skill packaging surface when separately provided",
+    "full development checkout: tests, release checks, and local implementation work"
+  ],
+  "features_requiring_explicit_operator_permission": [
+    "installing the PyPI package",
+    "cloning a source checkout",
+    "running commands that mutate local environments or repositories",
+    "enabling live network connectors for explicit sources",
+    "executing verifier routes or shell commands outside PIC documentation output"
+  ],
+  "first_run_commands": [
+    {
+      "command": "python -m pip install percolation-inversion-compiler",
+      "command_id": "minimal-pypi-install",
+      "executed_by_pic": false,
+      "expected_output": "PIC package installed in the selected Python environment",
+      "mutates_environment_if_operator_runs_it": true,
+      "purpose": "Install PIC from PyPI when the operator has chosen to allow local use.",
+      "requires_operator_authority": true
+    },
+    {
+      "command": "pic agent check --compact --text \"Candidate packet: route evidence and preserve residuals.\" --profile development",
+      "command_id": "minimal-first-check",
+      "executed_by_pic": false,
+      "expected_output": "compact JSON with accepted, workflow_usable, settled, residuals, and blockers",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Run the shortest compact agent-output contract after installation.",
+      "requires_operator_authority": false
+    },
+    {
+      "command": "pic phase plan --compact --text \"Candidate packet: route evidence and preserve residuals.\" --profile development",
+      "command_id": "minimal-next-phase-plan",
+      "executed_by_pic": false,
+      "expected_output": "compact PhaseAccelerationPlan JSON with settled=false when obligations remain",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Inspect ranked phase gaps and promotion blockers after the first check.",
+      "requires_operator_authority": false
+    }
+  ],
+  "operationally_usable": true,
+  "operator_adoption_status": "not-recorded",
+  "packet_id": "operator-adoption-packet",
+  "profile": "development",
+  "reasons": [
+    "operator adoption sidecar is optional documentation and does not gate PIC core commands"
+  ],
+  "review_checklist": {
+    "accepted": true,
+    "checklist_id": "adoption-review-checklist",
+    "interpretation_rules": [
+      "if adoption_sidecar is absent: continue normal checking and planning",
+      "if adoption_sidecar is present: treat it as operator-facing documentation only",
+      "if operator_adoption is approved: this may authorize local use in that environment",
+      "operator adoption does not settle external obligations",
+      "operator adoption does not promote packets"
+    ],
+    "items": [
+      "Confirm the agent has authority only to request use, not to self-install.",
+      "Confirm PIC output will be treated as candidate work, not final truth.",
+      "Confirm safe_commands will be inspected before any execution.",
+      "Confirm live connectors, repository mutation, and shell execution require explicit authority.",
+      "Confirm accepted=true and workflow_usable=true do not imply settled=true."
+    ],
+    "settled": false
+  },
+  "safe_commands_meaning": "safe_commands are deterministic hints to inspect or run only under operator authority.",
+  "safety_boundary": {
+    "affects_agent_accelerate": false,
+    "affects_agent_check": false,
+    "affects_packet_promotion": false,
+    "affects_phase_plan": false,
+    "affects_settled": false,
+    "approval_settles_truth": false,
+    "boundary_id": "adoption-safety-boundary",
+    "calls_network": false,
+    "clones_repository": false,
+    "creates_required_approval_state": false,
+    "executes_shell_commands": false,
+    "installs_package": false,
+    "invariants": [
+      "adoption sidecars are optional operator-facing documentation",
+      "absence of an adoption sidecar is normal and is not a blocker",
+      "operator adoption does not settle runtime obligations",
+      "operator adoption does not prove real ASI, physical truth, or oracle truth",
+      "operator adoption does not promote packet candidates",
+      "agents without install authority should generate an operator request instead"
+    ],
+    "modifies_config_files": false,
+    "mutates_runtime_state": false,
+    "pure_output_generator": true,
+    "safe_commands_are_execution_authority": false,
+    "settled": false,
+    "sidecar_only": true
+  },
+  "settled": false,
+  "settled_false_meaning": "settled=false means unresolved obligations remain explicit; it is not command failure.",
+  "what_pic_does": [
+    "Checks AI-agent output as capability packet candidates.",
+    "Preserves evidence, proof obligations, residual ledgers, and settlement blockers.",
+    "Routes finite verifier work and phase-planning diagnostics.",
+    "Emits machine-readable JSON contracts for agent and CI workflows."
+  ],
+  "what_pic_does_not_do": [
+    "It does not execute proposed actions from agent output.",
+    "It does not bypass operator approval policy.",
+    "It does not prove real ASI, physical truth, simulator truth, or oracle truth.",
+    "It does not silently promote accepted or workflow_usable outputs to settled.",
+    "It does not require adoption approval for agent check, phase plan, or accelerate."
+  ],
+  "workflow_usable": true
+}

package/fixtures/python_v044_cli/adoption_request.json

@@ -0,0 +1,60 @@
+{
+  "accepted": true,
+  "operationally_usable": true,
+  "operator_adoption_status": "not-recorded",
+  "plain_english_message": "I found PIC.\nPIC treats AI-agent output as candidate work.\nPIC preserves evidence, proof obligations, residual ledgers, and settlement blockers.\nPIC does not execute my proposed actions.\nPIC does not bypass your approval policy.\nPIC does not prove real ASI or real-world truth.\nPlease review and decide whether I may use it.",
+  "profile": "development",
+  "reasons": [
+    "agent lacks install authority and should request operator review"
+  ],
+  "request_id": "agent-to-operator-request",
+  "safety_boundary": {
+    "affects_agent_accelerate": false,
+    "affects_agent_check": false,
+    "affects_packet_promotion": false,
+    "affects_phase_plan": false,
+    "affects_settled": false,
+    "approval_settles_truth": false,
+    "boundary_id": "adoption-safety-boundary",
+    "calls_network": false,
+    "clones_repository": false,
+    "creates_required_approval_state": false,
+    "executes_shell_commands": false,
+    "installs_package": false,
+    "invariants": [
+      "adoption sidecars are optional operator-facing documentation",
+      "absence of an adoption sidecar is normal and is not a blocker",
+      "operator adoption does not settle runtime obligations",
+      "operator adoption does not prove real ASI, physical truth, or oracle truth",
+      "operator adoption does not promote packet candidates",
+      "agents without install authority should generate an operator request instead"
+    ],
+    "modifies_config_files": false,
+    "mutates_runtime_state": false,
+    "pure_output_generator": true,
+    "safe_commands_are_execution_authority": false,
+    "settled": false,
+    "sidecar_only": true
+  },
+  "settled": false,
+  "suggested_first_command": {
+    "command": "python -m pip install percolation-inversion-compiler\npic agent check --compact --text \"Candidate packet: route evidence and preserve residuals.\" --profile development",
+    "command_id": "operator-request-first-command",
+    "executed_by_pic": false,
+    "expected_output": "installed package plus compact agent check JSON",
+    "mutates_environment_if_operator_runs_it": true,
+    "purpose": "Install PIC and run the first compact check if the operator approves use.",
+    "requires_operator_authority": true
+  },
+  "suggested_next_command": {
+    "command": "pic phase plan --compact --text \"Candidate packet: route evidence and preserve residuals.\" --profile development",
+    "command_id": "operator-request-next-command",
+    "executed_by_pic": false,
+    "expected_output": "compact PhaseAccelerationPlan JSON",
+    "mutates_environment_if_operator_runs_it": false,
+    "purpose": "Inspect phase-planning diagnostics after the first check.",
+    "requires_operator_authority": false
+  },
+  "warning": "Agents without install authority should not self-install PIC. They should generate an operator request instead.",
+  "workflow_usable": true
+}

package/fixtures/python_v044_cli/agent_autonomy_audit.json

@@ -0,0 +1,254 @@
+{
+  "accepted": true,
+  "adoption_required_for_core": false,
+  "agent_full_extra_available": true,
+  "approval_gate_present": false,
+  "approval_persistence_created": false,
+  "autonomy_enablers": [
+    "compact reports keep the first workflow machine-readable",
+    "operator adoption sidecars are optional documentation",
+    "packet exchange, dashboard, and benchmark sidecars are diagnostic-only",
+    "canonical readiness is available from pip through bundled snapshot metadata",
+    "argv arrays avoid shell-specific quoting and glob expansion",
+    "agent-full extra exposes connector, identity, and service dependencies via pip"
+  ],
+  "background_crawling_allowed": false,
+  "command_execution_allowed_by_pic": false,
+  "compact_mode_available": true,
+  "operationally_usable": true,
+  "pip_agent_full_commands": [
+    "python -m pip install \"percolation-inversion-compiler[agent-full]\"",
+    "pic agent network-readiness --profile development",
+    "pic agent communication-guide --profile development",
+    "pic agent communication-guide --profile development --no-allow-live-connectors",
+    "pic agent relay-readiness --profile development"
+  ],
+  "pip_core_commands": [
+    "python -m pip install percolation-inversion-compiler",
+    "pic agent explain",
+    "pic agent autonomy-audit --profile development --format json",
+    "pic agent check --compact --text \"Candidate packet: preserve residuals.\" --profile development",
+    "pic phase plan --compact --text \"Candidate packet: preserve residuals.\" --profile development",
+    "pic agent accelerate --compact --text \"Candidate packet: preserve residuals.\" --profile development",
+    "pic demo installed-smoke --profile development",
+    "pic demo bootstrap --output-dir pic-demo",
+    "pic runtime step --state pic-demo/runtime_state.json --input pic-demo/runtime_step_input.json --profile development",
+    "pic phase benchmark-suite --profile development --format json",
+    "pic phase dashboard --profile development --format json",
+    "pic packet inspect --packet pic-demo/packet_envelope.json",
+    "pic packet merge --packets pic-demo/packet*.json --output pic-demo/merged-packets.json",
+    "pic packet lineage --packet pic-demo/merged-packets.json",
+    "pic phase observe --reports pic-demo/phase_dashboard.json --output pic-demo/observation.json",
+    "pic snapshot list",
+    "pic audit canonical-readiness --profile development --format json",
+    "pic schema --type AgentAutonomyAuditReport",
+    "pic schema --type CanonicalImplementationReadinessReport"
+  ],
+  "pip_core_workflow_available": true,
+  "profile": "development",
+  "reasons": [
+    "core PIC activity is not gated by operator adoption state",
+    "autonomy is increased through portable records and sidecar diagnostics"
+  ],
+  "recommended_next_invocations": [
+    {
+      "argv": [
+        "python",
+        "-m",
+        "pip",
+        "install",
+        "percolation-inversion-compiler"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "pip-core-install",
+      "mutates_environment_if_operator_runs_it": true,
+      "purpose": "Install the bare package when local environment mutation is authorized.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": true,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "python -m pip install percolation-inversion-compiler"
+    },
+    {
+      "argv": [
+        "pic",
+        "agent",
+        "check",
+        "--compact",
+        "--text",
+        "Candidate packet: preserve residuals.",
+        "--profile",
+        "development"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "compact-agent-check",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Run the shortest compact candidate-output check.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": false,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "pic agent check --compact --text \"Candidate packet: preserve residuals.\" --profile development"
+    },
+    {
+      "argv": [
+        "pic",
+        "phase",
+        "plan",
+        "--compact",
+        "--text",
+        "Candidate packet: preserve residuals.",
+        "--profile",
+        "development"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "compact-phase-plan",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Rank phase gaps and bottlenecks without adoption state.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": false,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "pic phase plan --compact --text \"Candidate packet: preserve residuals.\" --profile development"
+    },
+    {
+      "argv": [
+        "pic",
+        "agent",
+        "accelerate",
+        "--compact",
+        "--text",
+        "Candidate packet: preserve residuals.",
+        "--profile",
+        "development"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "compact-agent-accelerate",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Build an agent-facing acceleration plan without changing settled semantics.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": false,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "pic agent accelerate --compact --text \"Candidate packet: preserve residuals.\" --profile development"
+    },
+    {
+      "argv": [
+        "pic",
+        "audit",
+        "canonical-readiness",
+        "--profile",
+        "development",
+        "--format",
+        "json"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "canonical-readiness",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Inspect canonical implementation coverage from bundled snapshots without TeX files.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": false,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "pic audit canonical-readiness --profile development --format json"
+    },
+    {
+      "argv": [
+        "pic",
+        "packet",
+        "merge",
+        "--packets",
+        "pic-demo/packet*.json",
+        "--output",
+        "pic-demo/merged-packets.json"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "sidecar-packet-merge",
+      "mutates_environment_if_operator_runs_it": false,
+      "purpose": "Merge bootstrapped packet sidecars with Python-side glob expansion.",
+      "requires_agent_full_extra": false,
+      "requires_operator_authority": false,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "pic packet merge --packets pic-demo/packet*.json --output pic-demo/merged-packets.json"
+    },
+    {
+      "argv": [
+        "python",
+        "-m",
+        "pip",
+        "install",
+        "percolation-inversion-compiler[agent-full]"
+      ],
+      "executes_shell_commands_by_pic": false,
+      "invocation_id": "agent-full-install",
+      "mutates_environment_if_operator_runs_it": true,
+      "purpose": "Install connector, identity, and service extras when that capability is needed.",
+      "requires_agent_full_extra": true,
+      "requires_operator_authority": true,
+      "requires_source_checkout": false,
+      "safety_notes": [
+        "argv is the portable invocation; shell_command is display text",
+        "PIC emits this command as data and does not execute it"
+      ],
+      "shell_command": "python -m pip install \"percolation-inversion-compiler[agent-full]\""
+    }
+  ],
+  "remaining_friction_points": [
+    "installing packages still mutates the selected Python environment",
+    "canonical source-file audits and repository fixtures still require a source checkout",
+    "production packet promotion still requires accepted protocol-relative identity context"
+  ],
+  "report_id": "agent-autonomy-audit",
+  "safe_commands_executable_by_pic": false,
+  "safety_invariants": [
+    "settled=false is expected unless scoped finite verifier rules settle obligations",
+    "residual ledgers and missing obligations must be preserved",
+    "this package does not prove real ASI, physical, simulator, oracle, or policy outcomes",
+    "this package does not require self-rewrite, fine-tuning, or model-weight changes",
+    "agent-facing commands are recommendation-only and do not execute arbitrary shell commands",
+    "production packet promotion requires accepted identity context",
+    "live connectors are bounded and candidate-only by default when an explicit source is supplied",
+    "no background crawling",
+    "no autonomous polling",
+    "no arbitrary shell execution",
+    "no repository mutation",
+    "no hidden promotion from accepted or workflow_usable to settled",
+    "external metadata packets remain candidates until downstream checks pass",
+    "candidate-only external intake cannot improve Psi, BR, AC, or collective certificates",
+    "general web intake is bounded and does not execute scripts, forms, or repo mutation",
+    "agent-to-agent messages are packet candidates, not proof of external-world truth",
+    "adoption approval is not a phase input or settled blocker",
+    "safe_commands are not executable authority",
+    "PIC does not persist approval state"
+  ],
+  "settled": false,
+  "shell_expansion_required_for_sidecars": false,
+  "source_checkout_commands": [
+    "uv run pic ecology ingest-general --source examples/agent_network/feed.xml --kind rss",
+    "uv run pic ecology bridge-runtime --report examples/agent_network/general_intake_report.example.json",
+    "uv run pic alt admit --packet examples/alt/admission_packet.json",
+    "uv run pic agent message contract --message examples/agent_network/agent_message.json",
+    "uv run pic phase plan --request examples/phase_acceleration/phase_acceleration_request.json --compact --profile development"
+  ],
+  "source_checkout_required_for_core": false,
+  "workflow_usable": true
+}