Home

percolation-inversion-compiler-ts Wiki

percolation-inversion-compiler-ts is an AI agent output checker and workflow report generator for Node.js. The current npm release is v0.6.0 CCR interop and TRC operation readiness.

It helps JavaScript and TypeScript agents turn draft text, local runtime files, messages, packet files, and Phase Ecology Lab records into structured JSON reports. These reports show what was accepted, what can guide the next workflow step, what still needs checking, and what must not be treated as completed work.

The npm package is Python-free at runtime. The canonical implementation remains the Python project.

• TypeScript repository: https://github.com/kadubon/percolation-inversion-compiler-ts
• npm package: https://www.npmjs.com/package/percolation-inversion-compiler-ts
• Canonical Python repository: https://github.com/kadubon/percolation-inversion-compiler
• Canonical Python wiki: https://github.com/kadubon/percolation-inversion-compiler/wiki

What It Does

PIC-TS answers practical workflow questions:

• What did the agent claim?
• Was the JSON envelope accepted by the checker?
• Can this report guide the next safe workflow step?
• What evidence, identity, or verification work is still missing?
• Which packet, trace, or phase records are only candidates?
• Which bottlenecks should be routed to finite checks?
• Which command-like strings must stay inert data?
• Which Phase Ecology Lab records show accepted packets, missing evidence, and blocked execution paths?
• Which finite tasks and residuals can be handed to CCR as JSONL?
• Which TRC traces are structured enough to review as operation candidates?

Useful output often has workflow_usable=true and settled=false. That is normal. It means unfinished work is still visible.

Fastest Start

Install the package:

npm install percolation-inversion-compiler-ts

Create demo files and run a 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

Use pic-ts for npm and Node.js projects. The package also provides pic as a compatibility alias, but that name can be confused with the Python CLI.

v0.6.0 Highlights

• Follows the public JSON, CLI, schema, conformance, CCR interop, and safety semantics of Python percolation-inversion-compiler==0.6.0.
• Emits CCR task JSONL and residual JSONL from phase plans and phase gaps.
• Adds pic-ts bit extract-registry, verify-witnesses, and emit-ccr-tasks for witness repair workflows.
• Adds pic-ts sqot diagnose-queue --emit ccr-tasks.
• Adds pic-ts trc trace-normalize, trace-check, and trace-to-packet.
• Adds SDK helpers under percolation-inversion-compiler-ts/interop/ccr.
• Keeps Phase Ecology Lab, BIT, SQOT, ALT, TRC, and ecology diagnostics from v0.5.0 available for Node.js runtimes.

All new v0.6.0 outputs are inert JSON or JSONL. They do not execute embedded commands, provider calls, packet text, or trace content.

What To Read First

• Quickstart: the shortest useful command path.
• Getting Started: install, run, and verify the package.
• Node Only Agent Loop: a Python-free local workflow.
• Phase Ecology Lab: local packet graph and phase reports.
• CCR Interop: Node.js handoff records for CCR.
• ASI Proxy Acceleration: protocol-relative phase acceleration and TRC operation readiness.
• How To Read The JSON: field meanings in practical terms.
• CLI Recipes: common command patterns.
• JavaScript SDK: root and subpath imports.
• Diagnostic Commands: BIT, SQOT, ALT, TRC, and ecology helpers.
• Safety and Limits: what the package does not authorize or prove.
• Compatibility With Python: how the npm package relates to the canonical Python project.

The Short Mental Model

agent output or runtime file
-> structured JSON report
-> accepted or rejected envelope
-> residual ledger and missing obligations
-> recommended next workflow step
-> no hidden promotion to completed work

PIC-TS checks and routes JSON data. It does not execute packet content, shell commands, trace content, or suggested commands.

operation_ready=true means a trace has required planning fields for a scoped candidate. It does not mean PIC-TS executed the operation or proved the external result.

Search Terms

Node.js AI agent output checker, npm AI workflow report generator, TypeScript JSON schema validation, LLM output validation, AI workflow verification, residual ledger, missing obligations, packet inspection, packet exchange, phase planning, runtime step report, JavaScript agent runtime, safe reuse checks, Python compatibility port, conformance fixtures, PIC, ECPT, BIT, TRC, SQOT, ALT, Phase Ecology Lab, effective packet graph, execution available paths, bottleneck inversion, salience queue, typed runtime trace, CCR task JSONL, CCR residual JSONL, TRC operation readiness, TraceNF, operation_ready, trace-to-packet, ASI-proxy workflow loop, pic-ts phase plan --emit ccr-tasks, pic-ts trc trace-check.