Home

percolation-inversion-compiler-ts Wiki

percolation-inversion-compiler-ts is an AI agent output checker and workflow report generator for Node.js.

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?

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.5.0 Highlights

• Follows the public JSON, CLI, schema, conformance, and safety semantics of Python percolation-inversion-compiler==0.5.0.
• Adds Phase Ecology Lab records for local JSON/JSONL observation windows.
• Adds effective packet graph, closure, executable path, threshold, and certificate reports.
• Adds diagnostic CLI and SDK surfaces for BIT, SQOT, ALT, TRC, and ecology records.
• Adds npm subpath exports for ./phase-lab, ./bit-engine, ./sqot-controller, ./alt-lift, and ./trc-adapter.
• Strengthens cross-OS installed package smoke tests for Windows, macOS, and Linux.

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.
• 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.

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, ASI-proxy workflow loop.