Quickstart

Quickstart

This page gives the shortest safe path to useful output from npm.

Install

npm install percolation-inversion-compiler-ts

For one-off use, run the CLI through npx.

Recommended CLI Name

Use pic-ts for this npm package.

The package also installs pic as a compatibility alias. If the Python package is installed on the same machine, pic may refer to either implementation depending on your PATH.

First Node-Only Loop

npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts runtime step --state .pic-demo/runtime_state.json --input .pic-demo/runtime_step_input.json --output .pic-demo/runtime_step_report.generated.json
npx pic-ts packet export --report .pic-demo/runtime_step_report.generated.json --output .pic-demo/packet.json
npx pic-ts packet inspect --packet .pic-demo/packet.json
npx pic-ts phase plan --request .pic-demo/asi_proxy_phase_request.json --compact

This works without Python. It creates a runtime report, exports it as packet data, inspects the packet without running embedded text, and returns a phase plan.

First Agent Check

npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development
npx pic-ts agent accelerate --compact --text "Candidate packet: preserve residuals." --profile development

First v0.9.0 Token Loop Check

npx pic-ts token extract-pipeline --trace trace.json --compact
npx pic-ts token admissibility --token token.json --compact
npx pic-ts token dedup --tokens tokens.jsonl
npx pic-ts performance report
npx pic-ts cache status

Token extraction is not settlement. Token admissibility is not capital admission.

First v0.8.0 CARA Check

From a repository checkout or packaged examples path:

npx pic-ts phase acceleration-report --target examples/asi_proxy_acceleration_bundle/target.json --baseline examples/asi_proxy_acceleration_bundle/baseline_upper_envelope.json --capital examples/asi_proxy_acceleration_bundle/capital_witnesses.jsonl

certified_acceleration_candidate=true means the scoped v0.8 target/baseline/capital comparison passed. It is not real ASI proof and not permission to act in the world.

First MCP And A2A Check

npx pic-ts mcp descriptor-check --descriptor examples/asi_proxy_acceleration_bundle/mcp_descriptor.good.json --profile development
npx pic-ts mcp invocation-preflight --descriptor examples/asi_proxy_acceleration_bundle/mcp_descriptor.good.json --call examples/asi_proxy_acceleration_bundle/mcp_call.good.json --profile development
npx pic-ts a2a handoff-check --handoff examples/asi_proxy_acceleration_bundle/a2a_handoff.good.json --profile development

First CCR Handoff

npx pic-ts phase plan --request .pic-demo/asi_proxy_phase_request.json --compact --emit ccr-tasks --output tasks.jsonl
npx pic-ts phase gap --request .pic-demo/asi_proxy_phase_request.json --compact --emit ccr-residuals --output residuals.jsonl

The JSONL files are candidate handoff records for Collective Capability Runtime or another scheduler. They do not authorize command execution.

First TRC Operation Candidate Check

npx pic-ts trc trace-normalize --input examples/asi_proxy_benchmark_bundle/trc_agent_trace.json --output trace_nf.json
npx pic-ts trc trace-check --trace trace_nf.json --output trace_check.json
npx pic-ts trc operation-gate --trace trace_nf.json --provider-profile examples/asi_proxy_benchmark_bundle/provider_profile.json --output operation_gate.json
npx pic-ts trc trace-to-packet --trace trace_nf.json --output trace_packet.json

operation_ready=true means the scoped trace declares authority, resources, rollback or escrow, witnesses, schedule, and tolerance data. It still does not mean the action was executed or settled.

Read These Fields First

• accepted
• workflow_usable
• operationally_usable
• ok
• certified_acceleration_candidate
• certified_acceleration_interval_candidate
• operation_ready
• provider_dispatch_ready
• physical_dispatch_ready
• settled
• missing_obligations
• residual_ledger
• candidate_only_reasons
• candidate_only_until_checked
• settled_blockers

settled=false is not a command failure. It means unfinished work is still visible.