percolation-inversion-compiler-ts 0.4.4

package/fixtures/python_v044_cli/agent_manifest.json

@@ -0,0 +1,373 @@
+{
+  "clone_recommended_for": [
+    "canonical TeX audits",
+    "development fixtures",
+    "release engineering",
+    "editing examples and docs"
+  ],
+  "clone_recommended_for_full_use": false,
+  "clone_url": "https://github.com/kadubon/percolation-inversion-compiler.git",
+  "deployment_surfaces": [
+    "cli",
+    "python-sdk",
+    "github-actions",
+    "runtime-service",
+    "external-intake",
+    "agent-messages",
+    "alt-foundry",
+    "agent-autonomy-audit",
+    "canonical-implementation-readiness",
+    "operator-adoption-sidecar",
+    "packet-exchange-sidecar",
+    "phase-dashboard-sidecar"
+  ],
+  "full_feature_stages": [
+    "orient",
+    "inspect snapshots",
+    "run intake",
+    "derive identity context",
+    "external communication readiness",
+    "general web/feed intake",
+    "agent-to-agent packet exchange",
+    "live metadata ingest",
+    "phase acceleration planning",
+    "verify evidence/routes",
+    "promote packets",
+    "run/store loop",
+    "inspect Psi/SQOT",
+    "collective certify",
+    "ALT abstraction-liquidity foundry admission",
+    "preserve residuals/provenance"
+  ],
+  "important_schemas": [
+    "RuntimeStepInput",
+    "RuntimeStepReport",
+    "CapabilityPacketCandidate",
+    "VerifiedCapabilityPacket",
+    "PacketPromotionReport",
+    "SybilResistanceLedger",
+    "RuntimeIdentityContext",
+    "CollectivePhaseCertificate",
+    "AgentIntakeRequest",
+    "AgentIntakeReport",
+    "AgentCheckReport",
+    "AgentCommandInvocation",
+    "AgentAutonomyAuditReport",
+    "CanonicalImplementationReadinessReport",
+    "CanonicalTheorySnapshotSummary",
+    "AgentWorkflowGuide",
+    "AgentNextActionReport",
+    "AgentFeatureReadinessReport",
+    "PhaseAccelerationRequest",
+    "PhaseAccelerationPlan",
+    "PhaseGapVector",
+    "PhaseComponentGap",
+    "BottleneckCandidate",
+    "SafePhaseAction",
+    "PhaseTrajectoryReport",
+    "PhaseAccelerationBenchmarkReport",
+    "ProtocolRelativeBenchmarkMetric",
+    "PhaseBenchmarkTask",
+    "PhaseBenchmarkCaseResult",
+    "PhaseBenchmarkSuiteReport",
+    "PhaseDashboardReport",
+    "PhaseObservationReport",
+    "OperatorAdoptionPacket",
+    "AgentToOperatorRequest",
+    "AdoptionSafetyBoundary",
+    "AdoptionFirstRunCommand",
+    "AdoptionReviewChecklist",
+    "PacketExchangeEnvelope",
+    "PacketImportInspectionReport",
+    "PacketMergeReport",
+    "PacketLineageDigest",
+    "ResidualCarryForwardReport",
+    "AgentCommunicationPolicy",
+    "AgentCommunicationGuide",
+    "AgentNetworkReadinessReport",
+    "GeneralIntakeProfile",
+    "GeneralIntakePolicy",
+    "GeneralIntakePolicyDecision",
+    "GeneralIntakeSource",
+    "GeneralIntakeReport",
+    "GeneralIntakeRuntimeBridgeReport",
+    "ExternalCandidateClassification",
+    "AgentMessageContractReport",
+    "IntakeProvenanceRecord",
+    "WebFetchPolicy",
+    "WebFetchReport",
+    "RobotsDecision",
+    "WebDiscoveryReport",
+    "AgentMessageEnvelope",
+    "AgentMessageVerificationContext",
+    "AgentMessageNonceLedger",
+    "AgentInboxRecord",
+    "AgentPacketExchangeReport",
+    "AbstractionToken",
+    "LiquidityCertificate",
+    "NegativeLiquidityCertificate",
+    "ALTDeprecationRecord",
+    "ALTResurrectionRecord",
+    "BaselineRefreshCertificate",
+    "OpportunityMeasureContract",
+    "RootFinalityCertificate",
+    "TelemetryCostCertificate",
+    "HazardEnvelopeCertificate",
+    "ReproductionMatrixCertificate",
+    "ALTAdmissionDecision",
+    "ALTCARACertificate",
+    "ALTKernelTransitionReport",
+    "FoundryControlDashboard",
+    "CertifiedAbstractionCapital"
+  ],
+  "install_modes": [
+    {
+      "command": "python -m pip install percolation-inversion-compiler",
+      "does_not_include": [
+        "root examples tree",
+        "canonical TeX files",
+        "release engineering fixtures"
+      ],
+      "intended_for": [
+        "practical agent output checking",
+        "curated installed workflow",
+        "bundled snapshots",
+        "schema export",
+        "library and CLI runtime checks",
+        "ALT admission smoke with bundled data"
+      ],
+      "mode": "pip"
+    },
+    {
+      "command": "python -m pip install \"percolation-inversion-compiler[agent-full]\"",
+      "does_not_include": [
+        "science/OT/LP research dependencies",
+        "root examples tree",
+        "canonical TeX files"
+      ],
+      "intended_for": [
+        "bounded explicit-source live connector readiness",
+        "cryptographic identity verification",
+        "local runtime service dependencies"
+      ],
+      "mode": "pip-agent-full-extra"
+    },
+    {
+      "command": "git clone https://github.com/kadubon/percolation-inversion-compiler.git",
+      "intended_for": [
+        "examples-backed commands",
+        "canonical TeX audits",
+        "development tests",
+        "release engineering"
+      ],
+      "mode": "source-checkout"
+    }
+  ],
+  "machine_contract": {
+    "adoption_required_for_core": false,
+    "agent_full_extra_available": true,
+    "approval_gate_present": false,
+    "approval_persistence_created": false,
+    "arbitrary_shell_execution": false,
+    "benchmark_dashboard_and_packet_exchange_are_diagnostic_only": true,
+    "candidate_only_closure_execution_and_basin_paths_do_not_improve_phase_status": true,
+    "command_execution_allowed_by_pic": false,
+    "compact_mode_available": true,
+    "curated_demo_bundle_in_wheel": true,
+    "examples_path_requires_source_checkout": true,
+    "external_candidate_volume_cannot_improve_phase_status": true,
+    "external_content_is_candidate_only": true,
+    "feed_and_inbox_entry_counts_are_bounded": true,
+    "general_intake_is_bounded_candidate_only_by_default": true,
+    "general_intake_reports_sanitized_fetch_provenance": true,
+    "general_intake_requires_explicit_source": true,
+    "installed_package_smoke_commands_available": true,
+    "live_connectors_default_enabled": true,
+    "live_connectors_opt_out_available": true,
+    "live_discovery_fetches_each_resource_once": true,
+    "local_staged_intake_uses_byte_limits": true,
+    "local_web_discovery_disallows_seed_directory_escape": true,
+    "operator_adoption_sidecar_optional": true,
+    "pip_core_workflow_available": true,
+    "production_requires_identity_context": true,
+    "redirect_chain_urls_are_policy_validated": true,
+    "residuals_are_not_failures": true,
+    "rss_atom_uses_defused_xml": true,
+    "safe_commands_executable_by_pic": false,
+    "sanitized_outputs_only": true,
+    "settled_false_is_expected": true,
+    "shell_expansion_required_for_sidecars": false,
+    "sidecar_absence_is_not_failure": true,
+    "source_checkout_required_for_core": false
+  },
+  "name": "percolation-inversion-compiler",
+  "non_goals": [
+    "real ASI detection",
+    "real ASI creation",
+    "model self-rewrite",
+    "model weight update",
+    "legal identity proof",
+    "global Sybil resistance",
+    "oracle or simulator truth settlement",
+    "unbounded web crawling",
+    "arbitrary shell execution"
+  ],
+  "pip_boundary": {
+    "agent_full_extra": "percolation-inversion-compiler[agent-full]",
+    "clone_required_for": [
+      "commands that reference examples/...",
+      "canonical TeX/PDF audits through local source files",
+      "release checks and provenance/SBOM asset generation"
+    ],
+    "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_supports": [
+      "pic agent explain",
+      "pic agent check",
+      "pic agent autonomy-audit",
+      "pic demo installed-smoke",
+      "pic demo bootstrap",
+      "pic runtime step with bootstrapped demo files",
+      "pic phase benchmark-suite",
+      "pic phase dashboard",
+      "pic audit canonical-readiness",
+      "pic packet inspect/merge/lineage with bootstrapped packet files",
+      "pic snapshot list/show",
+      "pic schema export",
+      "Python SDK imports"
+    ],
+    "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"
+    ]
+  },
+  "primary_use_cases": [
+    "AI agent workflow verification",
+    "evidence routing",
+    "capability packet promotion",
+    "residual ledger preservation",
+    "SQOT queue scheduling",
+    "identity and Sybil resistance",
+    "explicit opt-in live metadata ingestion",
+    "bounded general web intake",
+    "agent-to-agent packet exchange",
+    "general intake SQOT runtime bridging",
+    "collective phase certificate generation",
+    "abstraction-token candidate certification",
+    "ALT reusable abstraction capital foundry dashboards",
+    "ALT negative-liquidity deprecation and resurrection",
+    "ALT-CARA protocol-relative acceleration certification",
+    "CLI AI agent output checking",
+    "Python SDK agent runtime embedding",
+    "read-only GitHub Actions audit artifact generation",
+    "bounded default-live explicit-source intake",
+    "deterministic phase acceleration planning"
+  ],
+  "purpose": "AI agent runtime verification and ECPT ASI-proxy collective phase acceleration",
+  "recommended_docs": [
+    "README.md",
+    "AGENTS.md",
+    "docs/for-agents.md",
+    "docs/integrations/README.md",
+    "docs/agent-external-communication.md",
+    "docs/integrations/github-actions.md",
+    "docs/operator-adoption.md",
+    "docs/agent-to-operator-request.md",
+    "docs/integrations/packet-exchange.md",
+    "docs/phase-dashboard.md",
+    "docs/benchmarks/phase-benchmark-suite.md",
+    "docs/canonical-implementation-readiness.md",
+    "docs/pypi-distribution.md",
+    "docs/01-quickstart.md",
+    "docs/identity-and-sybil-resistance.md",
+    "docs/04-collective-phase-certificate.md",
+    "examples/cli_agent_output_check/README.md",
+    "examples/python_sdk_agent_output_check/README.md",
+    "examples/github_action_agent_output_check/README.md"
+  ],
+  "safe_cli_entrypoints": [
+    "python -m pip install percolation-inversion-compiler",
+    "pic agent explain",
+    "pic agent check --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 agent intake --text \"Candidate packet: preserve residuals.\" --profile development",
+    "uv run pic agent intake --text-file examples/cli_agent_output_check/agent_output.txt --profile development --output cli-agent-output-report.json",
+    "uv run python examples/python_sdk_agent_output_check/check_agent_output.py",
+    "pic snapshot list",
+    "pic schema --type AgentIntakeReport",
+    "pic schema --type PhaseAccelerationPlan",
+    "pic schema --type PhaseAccelerationBenchmarkReport",
+    "pic agent autonomy-audit --profile development --format json",
+    "pic adoption request --format markdown",
+    "pic adoption packet --format markdown",
+    "pic phase benchmark-suite --profile development --format json",
+    "pic phase dashboard --profile development --format json",
+    "pic audit canonical-readiness --profile development --format json",
+    "pic schema --type OperatorAdoptionPacket",
+    "pic schema --type CanonicalImplementationReadinessReport",
+    "pic schema --type PacketExchangeEnvelope",
+    "pic schema --type PhaseDashboardReport",
+    "uv run pic --help",
+    "uv run pic agent explain",
+    "uv run pic agent communication-guide --profile development",
+    "uv run pic agent network-readiness --profile development",
+    "uv run pic ecology ingest-general --source examples/agent_network/feed.xml --kind rss",
+    "uv run pic ecology ingest-general --source examples/agent_network/page.html --kind web-page",
+    "uv run pic ecology policy explain --profile controlled_web",
+    "uv run pic ecology bridge-runtime --report general-intake-report.json",
+    "uv run pic alt admit --packet examples/alt/admission_packet.json",
+    "uv run pic alt negative-certify --certificate examples/alt/negative_liquidity_certificate.json",
+    "uv run pic alt refresh-baseline --certificate examples/alt/baseline_refresh_certificate.json",
+    "uv run pic alt check-cara --certificate examples/alt/alt_cara_certificate.json",
+    "uv run pic alt foundry-dashboard --state examples/alt/foundry_state.json",
+    "uv run pic agent message contract --message examples/agent_network/agent_message.json",
+    "uv run pic agent message ingest --message examples/agent_network/agent_message.json",
+    "uv run pic agent relay-readiness --profile development",
+    "uv run pic agent message send --inbox inbox.json --sender agent:alice --text \"Candidate packet: preserve residuals.\"",
+    "uv run pic agent message receive --inbox inbox.json",
+    "uv run pic schema --type IntakeProvenanceRecord",
+    "uv run pic runtime health --state examples/runtime_state.json --profile development",
+    "uv run pic runtime step --state examples/runtime_state.json --input examples/runtime_step_input.json --profile development",
+    "uv run pic identity explain-profile --profile research",
+    "uv run pic identity derive-context --population examples/agent_population_signed.json --profile production --output identity-context.json"
+  ],
+  "uv_install_commands": {
+    "macos_linux": "curl -LsSf https://astral.sh/uv/install.sh | sh",
+    "pypi_fallback": "python -m pip install uv",
+    "windows_powershell": "powershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\""
+  },
+  "version": "0.4.4"
+}

package/fixtures/python_v044_cli/agent_runbook.json

@@ -0,0 +1,115 @@
+{
+  "accepted": true,
+  "commands": [
+    "pic agent check --compact --text \"Candidate packet: preserve residuals.\"",
+    "pic agent autonomy-audit --profile development --format json",
+    "pic audit canonical-readiness --profile development --format json",
+    "pic agent runbook --profile development",
+    "pic schema --type AgentCheckReport",
+    "pic schema --type AgentAutonomyAuditReport",
+    "pic schema --type CanonicalImplementationReadinessReport",
+    "pic schema --type RuntimeStepReport",
+    "pic schema --type PhaseAccelerationPlan",
+    "pic phase plan --compact --profile development",
+    "pic agent readiness --profile production"
+  ],
+  "entrypoint": "pic agent check --compact",
+  "fields_to_inspect": [
+    "accepted",
+    "workflow_usable",
+    "settled",
+    "unresolved_obligations",
+    "residual_summary",
+    "next_safe_actions",
+    "intake_report.runtime_report.phase_control_audit",
+    "intake_report.runtime_report.frontier_debt_report",
+    "intake_report.runtime_report.bottleneck_witness_reports",
+    "phase_gap_vector.limiting_components",
+    "cannot_promote_because",
+    "candidate_only_reasons"
+  ],
+  "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"
+  ],
+  "profile": "development",
+  "reasons": [],
+  "report_id": "agent-runbook",
+  "runbook_steps": [
+    "Run pic agent check --compact on candidate agent output.",
+    "Read accepted, workflow_usable, settled, unresolved_obligations, and residual_summary.",
+    "Inspect next_safe_actions before promoting any reusable work item.",
+    "Read RuntimeStepReport phase_control_audit, frontier_debt_report, and bottleneck_witness_reports when theory fidelity matters.",
+    "Use production identity context before production packet promotion.",
+    "Run pic phase plan --compact when an agent needs ranked finite bottlenecks.",
+    "Use profile=development consistently across intake, runtime, and readiness commands."
+  ],
+  "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"
+  ],
+  "schemas_to_inspect": [
+    "AgentCheckReport",
+    "AgentIntakeReport",
+    "RuntimeStepReport",
+    "PhaseControlAuditSummary",
+    "FrontierDebtReport",
+    "BottleneckWitnessReport",
+    "SalienceScheduleReport",
+    "ALTAdmissionDecision",
+    "PhaseAccelerationPlan",
+    "PhaseGapVector",
+    "BottleneckCandidate",
+    "SafePhaseAction",
+    "AgentCommandInvocation",
+    "AgentAutonomyAuditReport",
+    "CanonicalImplementationReadinessReport"
+  ],
+  "settled": 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"
+  ]
+}