percolation-inversion-compiler 0.4.2__tar.gz → 0.4.4__tar.gz

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/.github/workflows/ci.yml

@@ -21,7 +21,7 @@ jobs:
         python-version: ["3.11", "3.12", "3.13", "3.14"]
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/.github/workflows/pypi-publish.yml

@@ -20,7 +20,7 @@ jobs:
       id-token: write
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/.github/workflows/release.yml

@@ -17,7 +17,7 @@ jobs:
       UV_PYTHON: "3.11"
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/.github/workflows/security.yml

@@ -18,7 +18,7 @@ jobs:
       UV_PYTHON: "3.11"
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
 
@@ -65,7 +65,7 @@ jobs:
       pull-requests: read
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - name: Dependency review
@@ -78,7 +78,7 @@ jobs:
       security-events: write
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - name: Initialize CodeQL
@@ -92,18 +92,22 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           fetch-depth: 0
           persist-credentials: false
       - name: Gitleaks
-        uses: gitleaks/gitleaks-action@e0c47f4f8be36e29cdc102c57e68cb5cbf0e8d1e # v3.0.0
+        run: |
+          docker run --rm \
+            -v "${PWD}:/repo" \
+            ghcr.io/gitleaks/gitleaks:v8.23.0@sha256:b4b81841085b4060054a71155500a340e3d2e2a5995c186546649e3efd80b84e \
+            detect --source /repo --redact --verbose
 
   workflow-lint:
     runs-on: ubuntu-latest
     steps:
       - name: Check out repository
-        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
           persist-credentials: false
       - name: Set up uv

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/AGENTS.md

@@ -6,8 +6,9 @@ This repository is an AI agent runtime verification and ECPT collective phase ac
 
 It is not an ASI detector, a real ASI proof system, or a self-modifying AI system. It does not require self-rewrite, fine-tuning, or model-weight changes.
 
-v0.4.2 is the PyPI practical runtime snapshot with a beta API surface. The PyPI
+v0.4.3 is the PyPI practical runtime snapshot with a beta API surface. The PyPI
 package is enough for `pic agent explain`, `pic agent check --text "..."`,
+`pic phase plan --compact --text "..."`, `pic agent accelerate --compact`,
 `pic demo installed-smoke`, `pic demo bootstrap`, `pic agent intake --text "..."`,
 `pic snapshot list`, and `pic schema --all --output-dir schemas`. Clone this
 repository when commands need the root `examples/...` tree, canonical TeX
@@ -20,6 +21,8 @@ Installed package path:
 ```powershell
 python -m pip install percolation-inversion-compiler
 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
@@ -72,6 +75,10 @@ uv run pic --help
 uv run pic agent explain
 uv run pic agent check --compact --text "Candidate packet: preserve residuals." --profile development
 uv run pic agent runbook --profile development
+uv run pic phase plan --compact --profile development
+uv run pic phase plan --request examples/phase_acceleration/phase_acceleration_request.json --compact
+uv run pic phase runbook --profile development
+uv run pic agent accelerate --compact --text "Candidate packet: preserve residuals." --profile development
 uv run pic agent guide --profile development
 uv run pic agent readiness --profile production
 uv run pic identity explain-profile --profile research
@@ -99,6 +106,8 @@ python -m pip install percolation-inversion-compiler
 pic agent explain
 pic agent check --compact --text "Candidate packet: preserve residuals." --profile development
 pic agent runbook --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
@@ -126,6 +135,14 @@ contract: `accepted`, `workflow_usable`, `settled`, unresolved obligations,
 residual summary, next safe actions, schema refs, and safety invariants. Use
 `pic agent runbook` when an agent needs deterministic command/schema/field
 guidance without execution authority.
+Use `pic phase plan --compact` or `pic agent accelerate --compact` after the
+first check when the agent needs ranked phase gaps, bottlenecks, candidate-only
+reasons, and promotion blockers. These commands return recommendation-only JSON
+and do not execute routes, shells, network connectors, or repository mutation.
+When using `pic phase plan --request`, treat the request file as the runtime
+input source; do not also pass `--state`, `--input`, `--runtime-report`,
+`--text`, or `--text-file`. `--profile` and `--identity-context` are explicit
+operator overrides.
 
 External intake, agent-to-agent message checks, and ALT foundry admission are
 separate workflows from basic output checking. Start with
@@ -159,6 +176,8 @@ uv run pic runtime step --state examples/runtime_state.json --input examples/run
 ## Python API Entrypoints
 
 - `percolation_inversion_compiler.agent.run_agent_intake`
+- `percolation_inversion_compiler.agent.accelerate_agent_phase`
+- `percolation_inversion_compiler.acceleration.build_phase_acceleration_plan`
 - `percolation_inversion_compiler.agent.build_agent_workflow_guide`
 - `percolation_inversion_compiler.agent.agent_feature_readiness`
 - `percolation_inversion_compiler.agent.recommend_agent_next_actions`
@@ -185,6 +204,8 @@ uv run pic runtime step --state examples/runtime_state.json --input examples/run
 - Do not execute arbitrary shell commands.
 - Preserve residual ledgers.
 - Production profile requires stronger identity and packet issuer context.
+- Accepted production identity context removes only identity-readiness blockers; it does not
+  promote unresolved route, residual, or phase-gap work to `settled`.
 - Keep live connectors bounded and candidate-only by default when an explicit source is supplied.
 - Use `--no-allow-live-connectors` for local-only dry runs.
 - For general intake, live HTTP(S) requires an explicit source and live-enabled intake/runtime

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/CHANGELOG.md

@@ -1,5 +1,50 @@
 # Changelog
 
+## v0.4.4 - 2026-06-20
+
+- Adds optional adoption sidecars for operator-facing packets and agent-to-operator
+  requests without gating `pic agent check`, `pic phase plan`, or
+  `pic agent accelerate`.
+- Adds sidecar contract documentation for compact agent output, phase plans, and
+  adoption handoff semantics.
+- Adds protocol-relative diagnostic benchmark reporting for obligation
+  visibility, residual preservation, false-promotion prevention, and next-action
+  specificity.
+- Adds packet exchange sidecar utilities for candidate packet inspection, merge,
+  lineage, duplicate diagnostics, and residual carry-forward.
+- Adds diagnostic phase dashboard reports for candidate, accepted,
+  workflow-usable, settled, residual, blocker, queue, and phase-gap metrics.
+- Adds `pic agent autonomy-audit`, argv-safe invocation records,
+  OS-independent sidecar glob expansion, bundled sidecar demo assets,
+  `agent-full` pip extra, and localized Markdown renderers for Japanese
+  operator-facing output.
+- Adds `pic audit canonical-readiness` and schema-exported readiness records so
+  pip-installed agents can inspect bundled ECPT/BIT/TRC/SQOT/ALT implementation
+  coverage, residual categories, finite upgrade candidates, and argv-safe next
+  actions without local TeX sources.
+- Preserves the safety boundary: sidecars, adoption status, benchmark scores,
+  dashboard metrics, packet exchange, canonical readiness, identity readiness,
+  external volume, `accepted`, and `workflow_usable` do not imply `settled=true`
+  or real ASI/physical/oracle truth.
+
+## v0.4.3 - 2026-06-20
+
+- Adds the public v0.4.3 hardening pass for the recommendation-only phase
+  acceleration planner, including request-file UX, compact agent/CI output,
+  production identity blocker handling, and explicit non-promotion semantics.
+- Improves portability and schema discoverability for the phase acceleration
+  contract by exposing planner, gap, bottleneck, action, trajectory, benchmark,
+  and component schemas through manifests, examples, and docs.
+- Reworks phase acceleration examples so the positive request-file fixture is
+  directly executable while the skeletal request remains a clearly labeled
+  shape reference for ports.
+- Tightens release-readiness checks around version consistency, canonical/fidelity
+  theory audits, publish-safety, distribution artifacts, and generated-cache
+  cleanup.
+- Preserves the safety boundary: v0.4.3 remains protocol-relative and does not
+  prove real ASI, physical/oracle truth, or hidden promotion from `accepted`,
+  `workflow_usable`, external volume, or identity readiness to `settled`.
+
 ## v0.4.2 - 2026-06-19
 
 - Makes explicit-source live communication bounded and candidate-only by
@@ -13,6 +58,11 @@
 - Extends ECPT, BIT, TRC, SQOT, and ALT theory-fidelity reports with finite
   phase-control, bottleneck witness, frontier debt, scheduler diagnostic, and
   value-bridge summaries.
+- Adds the recommendation-only phase acceleration planner with `pic phase plan`,
+  `pic phase gap`, `pic phase trajectory`, `pic phase runbook`,
+  `pic phase benchmark`, and `pic agent accelerate` for ranked finite
+  bottlenecks, safe next commands, promotion blockers, and portable
+  trajectory/benchmark schemas.
 - Expands portability conformance examples, schema exports, and bundled demo
   data for installed-package agent checks, runtime steps, ALT admission, schema
   validation, and local relay workflows.

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/CITATION.cff

@@ -1,14 +1,14 @@
 cff-version: 1.2.0
 message: "If you use this software, cite the software package and the referenced theory papers."
 title: "Percolation Inversion Compiler"
-version: "0.4.2"
+version: "0.4.4"
 doi: "10.5281/zenodo.20569166"
 authors:
   - family-names: "Takahashi"
     given-names: "K."
 license: "Apache-2.0"
 repository-code: "https://github.com/kadubon/percolation-inversion-compiler"
-date-released: "2026-06-19"
+date-released: "2026-06-20"
 abstract: "ECPT collective phase certificate runtime and finite verifier-routing SDK for ECPT, BIT, TRC, SQOT, and ALT, with abstraction-liquidity foundry support, fixed-population/no-self-rewrite ledgers, productive packet closure witnesses, execution-available path certificates, hidden-injection checks, semantic edge verification, resource-matched acceleration certificates, salience queues, proof obligations, residual ledgers, provenance, SBOMs, and optional local HTTP service integration."
 references:
   - type: article

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: percolation-inversion-compiler
-Version: 0.4.2
+Version: 0.4.4
 Summary: ECPT collective phase certificate runtime and finite verifier-routing SDK with ALT abstraction-liquidity foundry, ASI-proxy packet percolation, semantic edge checks, residual ledgers, provenance, and agent integration.
 Project-URL: Homepage, https://github.com/kadubon/percolation-inversion-compiler
 Project-URL: Repository, https://github.com/kadubon/percolation-inversion-compiler
@@ -33,6 +33,11 @@ Requires-Dist: pydantic>=2.8
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: rich>=13.7
 Requires-Dist: typer>=0.12
+Provides-Extra: agent-full
+Requires-Dist: cryptography>=42; extra == 'agent-full'
+Requires-Dist: fastapi>=0.115; extra == 'agent-full'
+Requires-Dist: httpx>=0.27; extra == 'agent-full'
+Requires-Dist: uvicorn>=0.32; extra == 'agent-full'
 Provides-Extra: all
 Requires-Dist: cryptography>=42; extra == 'all'
 Requires-Dist: fastapi>=0.115; extra == 'all'
@@ -48,7 +53,9 @@ Provides-Extra: connectors
 Requires-Dist: httpx>=0.27; extra == 'connectors'
 Provides-Extra: dev
 Requires-Dist: bandit[toml]>=1.7; extra == 'dev'
+Requires-Dist: build>=1.2; extra == 'dev'
 Requires-Dist: hypothesis>=6.100; extra == 'dev'
+Requires-Dist: msgpack>=1.2.1; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pip-audit>=2.7; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0; extra == 'dev'
@@ -80,11 +87,11 @@ Description-Content-Type: text/markdown
 
 The abbreviations refer to the five source theories used by the repository: **ECPT** is Executable Capability Percolation Theory, the collective capability-packet phase model; **BIT** is Bottleneck Inversion Theory, the witness calculus for unlockable potential and frontier extraction; **TRC** is Typed Reality Compilation, the typed trace and tolerance-ledger compiler for cyber-physical frontiers; **SQOT** is Salience-Queue Occupation Theory, the salience scheduling and attention-occupation layer; and **ALT** is Abstraction Liquidity Theory, the reusable abstraction capital and foundry valuation layer.
 
-Search terms: ECPT, BIT, TRC, SQOT, ALT, abstraction liquidity, reusable abstraction capital, ASI-proxy collective phase, protocol-relative ASI-proxy phase-control, certificate compiler, proof obligations, residual ledgers, salience queue, packet ecology, semantic edge verification, typed trace normal forms, frontier extraction, AI agent integration, verifier SDK.
+Search terms: ECPT, BIT, TRC, SQOT, ALT, abstraction liquidity, reusable abstraction capital, ASI-proxy collective phase, protocol-relative ASI-proxy phase-control, phase acceleration planner, bottleneck ranking, certificate compiler, proof obligations, residual ledgers, salience queue, packet ecology, semantic edge verification, typed trace normal forms, frontier extraction, AI agent integration, verifier SDK.
 
 New to PIC? Start with the [GitHub Wiki](https://github.com/kadubon/percolation-inversion-compiler/wiki) for a plain-language guide to what PIC does, why AI agent output is treated as candidate work, getting started, use cases, core concepts, and agent-safe interpretation of `accepted=true` and `settled=false`.
 
-Distribution status: v0.4.2 is a practical runtime snapshot with a beta API
+Distribution status: v0.4.4 is a practical runtime snapshot with a beta API
 surface. Install the core package from PyPI with `pip install
 percolation-inversion-compiler`; use `pip install
 "percolation-inversion-compiler[identity,connectors,server]"` when you need
@@ -99,7 +106,9 @@ Common-language glossary: capability packet = checked reusable work item;
 residual ledger = explicit unresolved-work ledger; SQOT = finite attention/task
 scheduler; ALT = reusable abstraction value checker; ECPT = workflow graph and
 collective phase-control model; BIT = bottleneck/witness calculus; TRC = typed
-trace and real-world frontier compiler. See [Glossary](docs/glossary.md).
+trace and real-world frontier compiler; phase acceleration planner = ranked
+safe next-step planner for verified work reuse and bottleneck removal. See
+[Glossary](docs/glossary.md).
 
 ## What It Does Not Do
 
@@ -125,10 +134,11 @@ trace and real-world frontier compiler. See [Glossary](docs/glossary.md).
 | 9 | **Action results** | Execution reports, ALT admission decisions, and route resolutions that are applied back into the runtime state. |
 | 10 | **Runtime store** | Persistent event logs, verified packets, route batches, abstraction capital lineage, and residual ledgers. |
 | 11 | **Collective phase certificate** | A fail-closed certificate over fixed population, no self-rewrite, no hidden injection, closure, execution availability, Psi thresholds, certified liquidity, and resource-matched baseline. |
+| 12 | **Phase acceleration plan** | Recommendation-only JSON that ranks phase gaps, bottlenecks, safe commands, schemas, candidate-only reasons, and settlement blockers. |
 
 The runtime is fail-closed: planning can recommend finite ASI-proxy actions, but `settled` remains false unless scoped verifier rules discharge the required finite obligations. In production, signed identities and Sybil-resistance ledgers can prevent duplicate-key, clone-fanout, revoked, expired, or unsigned agent populations from producing accepted collective certificates. Residual external obligations remain explicit.
 
-v0.4.2 keeps ALT abstraction-liquidity foundry support so external knowledge and agent traces can become reusable abstraction-token candidates, then certified abstraction capital only after lower-bound surplus, calibrated proxy or causal value evidence, transport, root-of-trust, telemetry, lifecycle, and hazard checks pass. ALT also adds negative-liquidity, deprecation/resurrection, baseline refresh, reproduction diagnostics, and ALT-CARA acceleration certificates so stale or unsafe abstraction claims remain repairable residual work rather than silent capital. Use `development`, `research`, `controlled`, `federated`, `production`, or `adversarial` profiles to choose how communication policy, cryptographic identities, homogeneous fleets, signed packet issuers, and Sybil-resistance ledgers affect packet promotion and collective certificates.
+v0.4.4 preserves the v0.4.3 ALT abstraction-liquidity foundry support so external knowledge and agent traces can become reusable abstraction-token candidates, then certified abstraction capital only after lower-bound surplus, calibrated proxy or causal value evidence, transport, root-of-trust, telemetry, lifecycle, and hazard checks pass. ALT also adds negative-liquidity, deprecation/resurrection, baseline refresh, reproduction diagnostics, and ALT-CARA acceleration certificates so stale or unsafe abstraction claims remain repairable residual work rather than silent capital. Use `development`, `research`, `controlled`, `federated`, `production`, or `adversarial` profiles to choose how communication policy, cryptographic identities, homogeneous fleets, signed packet issuers, and Sybil-resistance ledgers affect packet promotion and collective certificates.
 
 Core contract: registry is metadata, not evidence. Use `pic doctor` and structured checker outputs to distinguish declared status, finite certificate results, proof obligations, and residual ledgers.
 
@@ -146,16 +156,36 @@ Start with [AGENTS.md](AGENTS.md) and [For AI agents](docs/for-agents.md). The f
 uv run pic agent explain
 uv run pic agent check --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent runbook --profile development
+uv run pic phase plan --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
+uv run pic agent accelerate --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent guide --profile development
 uv run pic agent check --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent intake --text "Candidate packet: route evidence and preserve residuals." --profile development
 ```
 
+## Optional Sidecars
+
+These commands help operators, maintainers, and agent frameworks inspect PIC
+adoption, canonical implementation readiness, packet exchange, benchmarks, and
+phase metrics. They do not gate the main workflow and do not change `settled`
+semantics.
+
+```powershell
+pic adoption request --format markdown
+pic adoption packet --format markdown
+pic audit canonical-readiness --profile development --format json
+pic phase benchmark-suite --profile development --format json
+pic packet inspect --packet packet.json
+pic phase dashboard --profile development --format json
+```
+
 Command choice:
 
 - Use `pic agent check --compact` when a human, CI job, or first-time agent needs the shortest practical JSON contract.
 - Use `pic agent runbook` when an agent needs deterministic next commands, schemas, and fields to inspect.
+- Use `pic phase plan --compact` or `pic agent accelerate --compact` when an agent needs ranked phase gaps, bottlenecks, safe next commands, and promotion blockers.
 - Use `pic agent intake` or `pic runtime step` when the caller needs the full nested runtime report.
+- Use `pic audit canonical-readiness` from pip when an agent needs canonical ECPT/BIT/TRC/SQOT/ALT implementation coverage without local TeX files.
 - Use `pic audit fidelity` from a source checkout when canonical TeX theory-fidelity and finite-upgrade candidates matter.
 
 Production packet promotion requires identity context:
@@ -181,6 +211,7 @@ message checker, or an ALT abstraction-capital foundry.
 - External intake: treat web, feed, repository, and message inputs as candidate packets.
 - Agent-to-agent messages: inspect signatures, nonces, identity context, and residuals.
 - ALT foundry: check whether traces or outputs can become reusable abstraction capital.
+- Phase acceleration planner: rank finite bottlenecks and safe next actions without executing them.
 
 Start with [For AI agents](docs/for-agents.md). For the full integration map,
 see [Integration Examples](docs/integrations/README.md). For the CI pattern, see
@@ -211,6 +242,39 @@ Raw external packet volume, including candidate-only closure or execution-path r
 not improve positive Psi components or collective certificates until downstream promotion checks
 accept the packet as finite-scope capital.
 
+## Phase Acceleration Planner
+
+The phase planner is the practical bridge from the theory reports to agent
+action. It reads existing runtime output and adjacent ALT/SQOT/external-intake
+reports, then returns a deterministic `PhaseAccelerationPlan` with:
+
+- `phase_gap_vector`: finite Psi component gaps against thresholds.
+- `bottlenecks`: ranked verifier, packet repair, SQOT queue, ALT capital, identity, and residual-ledger work.
+- `safe_commands` and `sdk_calls`: next commands and APIs to inspect, not authority to execute.
+- `cannot_promote_because`, `candidate_only_reasons`, and `settled_blockers`: why the current state is useful but not settled.
+
+```powershell
+uv run pic phase plan --compact --profile development
+uv run pic phase plan --request examples/phase_acceleration/phase_acceleration_request.json --compact
+uv run pic phase gap --compact --profile development
+uv run pic phase runbook --profile development
+uv run pic phase benchmark --profile development
+uv run pic phase benchmark-suite --profile development --format json
+uv run pic phase dashboard --profile development --format json
+uv run pic schema --type PhaseAccelerationPlan
+```
+
+For first-time agents, `pic agent check --compact` is still the first command.
+Run `pic phase plan --compact` next when the agent must choose finite bottleneck
+work. The planner can help a network of agents preserve reusable work and route
+verification, but it does not prove real ASI, physical outcomes, or oracle truth.
+With `--request`, use a self-contained `PhaseAccelerationRequest` file and do
+not also pass `--state`, `--input`, `--runtime-report`, `--text`, or
+`--text-file`; `--profile` and `--identity-context` are explicit operator
+overrides. In production/adversarial profiles, accepted identity context removes
+only the identity-readiness blocker. `settled=false` remains correct while
+residual obligations, route work, or phase gaps remain.
+
 ## Quickstart
 
 ### Path A: Pip Install For Immediate Practical Checks
@@ -222,13 +286,32 @@ curated workflow.
 ```powershell
 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: route evidence and preserve residuals." --profile development
 pic agent runbook --profile development
+pic phase plan --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
+pic agent accelerate --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 pic agent check --text "Candidate packet: route evidence and preserve residuals." --profile development
 pic demo installed-smoke --profile development
 pic demo bootstrap --output-dir pic-demo
 pic agent intake --text "Candidate packet: route evidence and preserve residuals." --profile development
 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 --runtime-report pic-demo/runtime_step_report.json --profile development
+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 audit canonical-readiness --profile development --format json
+```
+
+For connector, identity, and local runtime-service dependencies without the
+science/OT/LP research stack:
+
+```powershell
+python -m pip install "percolation-inversion-compiler[agent-full]"
+pic agent network-readiness --profile development
+pic agent communication-guide --profile development
 ```
 
 ### Path B: Clone For Canonical Audits And Development
@@ -273,6 +356,7 @@ uv run pic snapshot show --artifact ecpt
 uv run pic snapshot show --artifact sqot
 uv run pic snapshot show --artifact alt
 uv run pic snapshot routes
+uv run pic audit canonical-readiness --profile development --format json
 ```
 
 ### 2. Run One Runtime Step

{percolation_inversion_compiler-0.4.2 → percolation_inversion_compiler-0.4.4}/README.md

@@ -4,11 +4,11 @@
 
 The abbreviations refer to the five source theories used by the repository: **ECPT** is Executable Capability Percolation Theory, the collective capability-packet phase model; **BIT** is Bottleneck Inversion Theory, the witness calculus for unlockable potential and frontier extraction; **TRC** is Typed Reality Compilation, the typed trace and tolerance-ledger compiler for cyber-physical frontiers; **SQOT** is Salience-Queue Occupation Theory, the salience scheduling and attention-occupation layer; and **ALT** is Abstraction Liquidity Theory, the reusable abstraction capital and foundry valuation layer.
 
-Search terms: ECPT, BIT, TRC, SQOT, ALT, abstraction liquidity, reusable abstraction capital, ASI-proxy collective phase, protocol-relative ASI-proxy phase-control, certificate compiler, proof obligations, residual ledgers, salience queue, packet ecology, semantic edge verification, typed trace normal forms, frontier extraction, AI agent integration, verifier SDK.
+Search terms: ECPT, BIT, TRC, SQOT, ALT, abstraction liquidity, reusable abstraction capital, ASI-proxy collective phase, protocol-relative ASI-proxy phase-control, phase acceleration planner, bottleneck ranking, certificate compiler, proof obligations, residual ledgers, salience queue, packet ecology, semantic edge verification, typed trace normal forms, frontier extraction, AI agent integration, verifier SDK.
 
 New to PIC? Start with the [GitHub Wiki](https://github.com/kadubon/percolation-inversion-compiler/wiki) for a plain-language guide to what PIC does, why AI agent output is treated as candidate work, getting started, use cases, core concepts, and agent-safe interpretation of `accepted=true` and `settled=false`.
 
-Distribution status: v0.4.2 is a practical runtime snapshot with a beta API
+Distribution status: v0.4.4 is a practical runtime snapshot with a beta API
 surface. Install the core package from PyPI with `pip install
 percolation-inversion-compiler`; use `pip install
 "percolation-inversion-compiler[identity,connectors,server]"` when you need
@@ -23,7 +23,9 @@ Common-language glossary: capability packet = checked reusable work item;
 residual ledger = explicit unresolved-work ledger; SQOT = finite attention/task
 scheduler; ALT = reusable abstraction value checker; ECPT = workflow graph and
 collective phase-control model; BIT = bottleneck/witness calculus; TRC = typed
-trace and real-world frontier compiler. See [Glossary](docs/glossary.md).
+trace and real-world frontier compiler; phase acceleration planner = ranked
+safe next-step planner for verified work reuse and bottleneck removal. See
+[Glossary](docs/glossary.md).
 
 ## What It Does Not Do
 
@@ -49,10 +51,11 @@ trace and real-world frontier compiler. See [Glossary](docs/glossary.md).
 | 9 | **Action results** | Execution reports, ALT admission decisions, and route resolutions that are applied back into the runtime state. |
 | 10 | **Runtime store** | Persistent event logs, verified packets, route batches, abstraction capital lineage, and residual ledgers. |
 | 11 | **Collective phase certificate** | A fail-closed certificate over fixed population, no self-rewrite, no hidden injection, closure, execution availability, Psi thresholds, certified liquidity, and resource-matched baseline. |
+| 12 | **Phase acceleration plan** | Recommendation-only JSON that ranks phase gaps, bottlenecks, safe commands, schemas, candidate-only reasons, and settlement blockers. |
 
 The runtime is fail-closed: planning can recommend finite ASI-proxy actions, but `settled` remains false unless scoped verifier rules discharge the required finite obligations. In production, signed identities and Sybil-resistance ledgers can prevent duplicate-key, clone-fanout, revoked, expired, or unsigned agent populations from producing accepted collective certificates. Residual external obligations remain explicit.
 
-v0.4.2 keeps ALT abstraction-liquidity foundry support so external knowledge and agent traces can become reusable abstraction-token candidates, then certified abstraction capital only after lower-bound surplus, calibrated proxy or causal value evidence, transport, root-of-trust, telemetry, lifecycle, and hazard checks pass. ALT also adds negative-liquidity, deprecation/resurrection, baseline refresh, reproduction diagnostics, and ALT-CARA acceleration certificates so stale or unsafe abstraction claims remain repairable residual work rather than silent capital. Use `development`, `research`, `controlled`, `federated`, `production`, or `adversarial` profiles to choose how communication policy, cryptographic identities, homogeneous fleets, signed packet issuers, and Sybil-resistance ledgers affect packet promotion and collective certificates.
+v0.4.4 preserves the v0.4.3 ALT abstraction-liquidity foundry support so external knowledge and agent traces can become reusable abstraction-token candidates, then certified abstraction capital only after lower-bound surplus, calibrated proxy or causal value evidence, transport, root-of-trust, telemetry, lifecycle, and hazard checks pass. ALT also adds negative-liquidity, deprecation/resurrection, baseline refresh, reproduction diagnostics, and ALT-CARA acceleration certificates so stale or unsafe abstraction claims remain repairable residual work rather than silent capital. Use `development`, `research`, `controlled`, `federated`, `production`, or `adversarial` profiles to choose how communication policy, cryptographic identities, homogeneous fleets, signed packet issuers, and Sybil-resistance ledgers affect packet promotion and collective certificates.
 
 Core contract: registry is metadata, not evidence. Use `pic doctor` and structured checker outputs to distinguish declared status, finite certificate results, proof obligations, and residual ledgers.
 
@@ -70,16 +73,36 @@ Start with [AGENTS.md](AGENTS.md) and [For AI agents](docs/for-agents.md). The f
 uv run pic agent explain
 uv run pic agent check --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent runbook --profile development
+uv run pic phase plan --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
+uv run pic agent accelerate --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent guide --profile development
 uv run pic agent check --text "Candidate packet: route evidence and preserve residuals." --profile development
 uv run pic agent intake --text "Candidate packet: route evidence and preserve residuals." --profile development
 ```
 
+## Optional Sidecars
+
+These commands help operators, maintainers, and agent frameworks inspect PIC
+adoption, canonical implementation readiness, packet exchange, benchmarks, and
+phase metrics. They do not gate the main workflow and do not change `settled`
+semantics.
+
+```powershell
+pic adoption request --format markdown
+pic adoption packet --format markdown
+pic audit canonical-readiness --profile development --format json
+pic phase benchmark-suite --profile development --format json
+pic packet inspect --packet packet.json
+pic phase dashboard --profile development --format json
+```
+
 Command choice:
 
 - Use `pic agent check --compact` when a human, CI job, or first-time agent needs the shortest practical JSON contract.
 - Use `pic agent runbook` when an agent needs deterministic next commands, schemas, and fields to inspect.
+- Use `pic phase plan --compact` or `pic agent accelerate --compact` when an agent needs ranked phase gaps, bottlenecks, safe next commands, and promotion blockers.
 - Use `pic agent intake` or `pic runtime step` when the caller needs the full nested runtime report.
+- Use `pic audit canonical-readiness` from pip when an agent needs canonical ECPT/BIT/TRC/SQOT/ALT implementation coverage without local TeX files.
 - Use `pic audit fidelity` from a source checkout when canonical TeX theory-fidelity and finite-upgrade candidates matter.
 
 Production packet promotion requires identity context:
@@ -105,6 +128,7 @@ message checker, or an ALT abstraction-capital foundry.
 - External intake: treat web, feed, repository, and message inputs as candidate packets.
 - Agent-to-agent messages: inspect signatures, nonces, identity context, and residuals.
 - ALT foundry: check whether traces or outputs can become reusable abstraction capital.
+- Phase acceleration planner: rank finite bottlenecks and safe next actions without executing them.
 
 Start with [For AI agents](docs/for-agents.md). For the full integration map,
 see [Integration Examples](docs/integrations/README.md). For the CI pattern, see
@@ -135,6 +159,39 @@ Raw external packet volume, including candidate-only closure or execution-path r
 not improve positive Psi components or collective certificates until downstream promotion checks
 accept the packet as finite-scope capital.
 
+## Phase Acceleration Planner
+
+The phase planner is the practical bridge from the theory reports to agent
+action. It reads existing runtime output and adjacent ALT/SQOT/external-intake
+reports, then returns a deterministic `PhaseAccelerationPlan` with:
+
+- `phase_gap_vector`: finite Psi component gaps against thresholds.
+- `bottlenecks`: ranked verifier, packet repair, SQOT queue, ALT capital, identity, and residual-ledger work.
+- `safe_commands` and `sdk_calls`: next commands and APIs to inspect, not authority to execute.
+- `cannot_promote_because`, `candidate_only_reasons`, and `settled_blockers`: why the current state is useful but not settled.
+
+```powershell
+uv run pic phase plan --compact --profile development
+uv run pic phase plan --request examples/phase_acceleration/phase_acceleration_request.json --compact
+uv run pic phase gap --compact --profile development
+uv run pic phase runbook --profile development
+uv run pic phase benchmark --profile development
+uv run pic phase benchmark-suite --profile development --format json
+uv run pic phase dashboard --profile development --format json
+uv run pic schema --type PhaseAccelerationPlan
+```
+
+For first-time agents, `pic agent check --compact` is still the first command.
+Run `pic phase plan --compact` next when the agent must choose finite bottleneck
+work. The planner can help a network of agents preserve reusable work and route
+verification, but it does not prove real ASI, physical outcomes, or oracle truth.
+With `--request`, use a self-contained `PhaseAccelerationRequest` file and do
+not also pass `--state`, `--input`, `--runtime-report`, `--text`, or
+`--text-file`; `--profile` and `--identity-context` are explicit operator
+overrides. In production/adversarial profiles, accepted identity context removes
+only the identity-readiness blocker. `settled=false` remains correct while
+residual obligations, route work, or phase gaps remain.
+
 ## Quickstart
 
 ### Path A: Pip Install For Immediate Practical Checks
@@ -146,13 +203,32 @@ curated workflow.
 ```powershell
 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: route evidence and preserve residuals." --profile development
 pic agent runbook --profile development
+pic phase plan --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
+pic agent accelerate --compact --text "Candidate packet: route evidence and preserve residuals." --profile development
 pic agent check --text "Candidate packet: route evidence and preserve residuals." --profile development
 pic demo installed-smoke --profile development
 pic demo bootstrap --output-dir pic-demo
 pic agent intake --text "Candidate packet: route evidence and preserve residuals." --profile development
 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 --runtime-report pic-demo/runtime_step_report.json --profile development
+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 audit canonical-readiness --profile development --format json
+```
+
+For connector, identity, and local runtime-service dependencies without the
+science/OT/LP research stack:
+
+```powershell
+python -m pip install "percolation-inversion-compiler[agent-full]"
+pic agent network-readiness --profile development
+pic agent communication-guide --profile development
 ```
 
 ### Path B: Clone For Canonical Audits And Development
@@ -197,6 +273,7 @@ uv run pic snapshot show --artifact ecpt
 uv run pic snapshot show --artifact sqot
 uv run pic snapshot show --artifact alt
 uv run pic snapshot routes
+uv run pic audit canonical-readiness --profile development --format json
 ```
 
 ### 2. Run One Runtime Step