PIC-TS v1.1.0 - Cross-Language Runtime

PIC-TS v1.1.0 brings the Python PIC v1.1 meaning and safety contract to Node.js agents.

Quick start

npm install percolation-inversion-compiler-ts@1.1.0
npx pic-ts agent check --compact

Typed runtime APIs are also available from the dedicated subpath:

import {
  compareRuntimeRuns,
  certifyRuntimeAcceleration,
} from "percolation-inversion-compiler-ts/runtime";

What is new

• runtime compare and runtime certify-acceleration now perform the same resource-matched, direction-aware metric checks as Python PIC.
• Typed AccelerationMetricComparison results explain improvement, regression, tolerance, and rejection reasons for every metric.
• AFST freshness, authority, consent, profile gates, residual ordering, and non-execution flags are aligned with Python.
• Unknown phase coordinates remain unknown; BIT gains need witnesses; SQOT uses measured costs; ALT revalidates evidence; TRC uses finite traces.
• Approval-bound operations expose adapter-check -> plan -> preflight -> approve -> dispatch -> verify -> reconcile with Ed25519/JCS compatibility, replay protection, SSRF controls, bounded I/O, and independent verification.
• Canonical CamelCase schemas are pinned to Python PIC v1.1.0 main commit 61c4fa77b163791d510006ccaea9de238f70149b; legacy TypeScript schema IDs remain available for compatibility.
• Schema metadata generation is now independent of CRLF/LF line endings, and the package is tested on Node 20/22 across Linux, Windows, and macOS.

Safety boundary

PIC-TS does not prove real ASI, consciousness, legal authority, consent, or a physical outcome. Ordinary checks and AFST commands never dispatch side effects. physical_outcome_proven remains false; only a separately validated verifier report with matching scope and observation window can set physical_outcome_verified=true.

Compatibility

v1.1.0 is additive and keeps the v1 CLI and public entry points. Strict CLI and interop boundaries reject coerced numeric strings, string booleans, non-finite values, and ambiguous timestamps. Node.js 20 or newer is required.

See the README, docs/migration-v1.1.md, docs/resource-matched-measurement.md, docs/cross-language-contract.md, and docs/operation-security.md.

PIC-TS v1.0.0

PIC-TS v1.0.0 brings the TypeScript package up to the Python PIC v1.0.0 public surface for AFST and agent workflow checks.

What is new:

• New AFST commands: pic-ts afst check, pic-ts afst buffer, pic-ts afst handover, pic-ts afst balance, and pic-ts afst emit-ccr-tasks.
• New percolation-inversion-compiler-ts/afst export and AFST JSON schemas.
• AFST checks proposed satisfaction-flux transfers with authority, consent, refusal, resource balance, stabilization buffer, handover, lifecycle, and residual checks.
• Missing AFST fields are reported as explicit residuals such as missing_certified_abundance_cell_id; missing values are not treated as zero.
• Installed demos now include .pic-demo/afst/... examples, and docs distinguish installed npm paths from source checkout paths.

Safety boundary:

• accepted=true means the finite local checker accepted the JSON record.
• AFST reports stay non-executing: settled=false, operation_ready=false, provider_dispatch_ready=false, and physical_dispatch_ready=false.
• The release does not claim provider dispatch, physical outcome proof, consent bypass, refusal suppression, resource creation, ALT capital admission, ECPT phase promotion, or real ASI proof.

Try it:

npm install percolation-inversion-compiler-ts
npx pic-ts demo bootstrap --output-dir .pic-demo --overwrite
npx pic-ts afst check --case .pic-demo/afst/minimal_accepted.json --compact
npx pic-ts afst check --case .pic-demo/afst/blocked_refusal.json --output .pic-demo/afst-report.json
npx pic-ts afst emit-ccr-tasks --report .pic-demo/afst-report.json

Validation:

• GitHub CI passed Node 20 and Node 22 tests.
• Cross-OS smoke passed on Linux, Windows, and macOS.
• Package checks passed typecheck, lint, format, tests, conformance, pack safety, publint, are-the-types-wrong, installed smoke, and npm audit.

PIC-TS v0.9.0 - ASI-proxy loop parity

v0.9.0 - TypeScript ASI-proxy loop parity

This release brings the TypeScript package up to the PIC v0.9.0 public report and schema surface for JavaScript and npm-based agent runtimes.

For first-time agents

• Start with docs/asi-proxy-loop.md and examples/asi_proxy_loop_bundle/.
• Use the pic-ts CLI or package exports to produce token, operation, SQOT, BIT, performance, and cache reports.
• All reports remain protocol-relative. They do not execute providers, settle claims, admit capital, or prove physical outcomes.

Highlights

• Adds v0.9 token extraction/admissibility/dedup, TRC observation, ECPT/SQOT/BIT, performance, and cache report parity.
• Adds schemas, example bundles, docs, and conformance tests aligned with Python PIC v0.9.0 and CCR v1.4.0.
• Publishes AGENTS.md, CHALLENGE.md, and INTEROP_PIC.md in the npm package for agent discovery.
• Hardens npm publish safety and GitHub Actions security with pinned actions and least-privilege checkout.

Verification

Local and GitHub CI passed for format, lint, typecheck, tests, conformance, pack safety, installed smoke, publint, Are The Types Wrong, npm audit, and zizmor.

PIC-TS v0.8.0 - TypeScript ASI-proxy parity layer

v0.8.0 - TypeScript ASI-proxy parity layer

This release brings the Python PIC v0.8.0 public JSON, CLI, schema, and safety semantics to npm and JavaScript agent runtimes.

Highlights:

• Adds TypeScript parity for CARA/phase acceleration, target validity, baseline, capital witness, TRC operation-gate, MCP, A2A, SQOT, BIT, and ECPT reports.
• Strengthens fail-closed behavior for descriptor rug-pulls, unaccepted target law/status evidence, proxy-only capital, stale or negative liquidity, and missing baseline controls.
• Adds CCR interop fixtures for phase-response control steps and allocation simulation.
• Keeps cross-platform npm conformance coverage for Linux, Windows, and macOS.

Safety boundary:
The npm package emits diagnostics and candidate/advisory reports. It does not grant authority for physical or external-world action. Real dispatch remains gated by TRC authority, hazard, rollback, lifecycle, logging, and explicit approval checks.

percolation-inversion-compiler-ts v0.7.0

What changed

percolation-inversion-compiler-ts v0.7.0 mirrors the Python PIC v0.7.0 TRC operation-gate model for TypeScript agents.

Use:

pic-ts trc operation-gate --trace trace_nf.json --provider-profile provider.json

Agent-readable safety model

• Authority gates check active status, expiry, scope, and trusted issuer policy.
• Fixture dry-run traces are explicitly non-executable with fixture_only_authority_non_executable.
• The report separates operation_ready, provider_dispatch_ready, and physical_dispatch_ready.
• These flags do not claim execution, dispatch, or physical outcome proof.
• ALT interop now separates report acceptance from capital_admitted.

Interop

The TypeScript package now exports operationGateReport and ships pic.trc_operation_gate_report.v1 schema support for CCR-style preflight planning.

Validation

CI passed on Node 20 and 22 across Linux, macOS, and Windows, including typecheck, lint, format, tests, conformance, pack checks, installed smoke, and npm audit.

v0.6.0 - CCR interop and TRC operation readiness for Node.js agents

What changed

PIC-TS v0.6.0 syncs the npm/TypeScript package with the Python percolation-inversion-compiler v0.6.0 public surfaces for JavaScript and TypeScript agent runtimes.

• Adds CCR interop helpers and JSONL emissions so Node.js agents can route PIC phase bottlenecks, residuals, BIT witness gaps, and SQOT queue repairs into CCR-style work queues.
• Adds TRC trace-normalize, trace-check, and trace-to-packet commands. The operation gate checks scoped authority, resource, rollback, witness, schedule, and tolerance data while keeping executed=false and settled=false.
• Adds the ASI-proxy benchmark bundle, PIC-to-CCR roundtrip examples, interop schemas, and beginner-readable audit/interop docs.
• Adds the SDK subpath percolation-inversion-compiler-ts/interop/ccr for direct Node.js imports.

Safety boundary

The new outputs are inert JSON or JSONL. They do not execute packet content, shell commands, provider calls, or repository mutations. operation_ready means the required planning fields are present for a scoped handoff; it is not execution, settlement, physical truth, model mutation, or real ASI evidence.

Validation

• Local prepublishOnly passed: typecheck, lint, format, test, conformance, pack safety, publint, attw, installed smoke, npm audit.
• PR CI and main CI passed on Node 20/22 across Ubuntu, Windows, and macOS.
• GitGuardian security check passed on the PR.

v0.5.0 - Phase Ecology Lab for Node.js agents

percolation-inversion-compiler-ts v0.5.0

This release updates the TypeScript and npm package to follow the public JSON, CLI, schema, conformance, and safety semantics of the canonical Python package percolation-inversion-compiler==0.5.0.

The package is for JavaScript and TypeScript agent runtimes. It helps an agent check local JSON reports, keep unfinished work visible, export and inspect inert packets, and plan the next workflow step without needing Python at runtime.

What is new

• Added Phase Ecology Lab support for Node.js with a local JSON/JSONL store.
• Added effective packet graph records for accepted packets, candidate-only packets, blockers, missing evidence, and residual work.
• Added diagnostic CLI and SDK surfaces for BIT, SQOT, ALT, TRC, and ecology records.
• Added v0.5.0 schemas, examples, portability fixtures, snapshot fixtures, and audit documentation.
• Added npm subpath exports for ./phase-lab, ./bit-engine, ./sqot-controller, ./alt-lift, and ./trc-adapter.
• Strengthened installed-package smoke tests for Windows, macOS, and Linux.

Quick start

npm install percolation-inversion-compiler-ts
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 pic command is also provided as a compatibility alias, but it can be ambiguous on machines that also install the Python package.

Safety boundary

PIC-TS checks and routes JSON data. It does not execute packet content, shell commands, trace content, or suggested commands. It does not mutate repositories, crawl in the background, or prove real-world truth.

The status fields stay separate:

• accepted means the input passed the bounded check for that command.
• workflow_usable means the report can guide a next workflow step.
• operationally_usable means the runtime result can be used under the selected profile.
• settled is only true when scoped finite obligations have actually been discharged.

Candidate-only and diagnostic routes keep residual work, blockers, missing obligations, and safety limits visible. They do not grant execution authority.

Compatibility

The canonical implementation remains the Python package:

• Repository: https://github.com/kadubon/percolation-inversion-compiler
• Wiki: https://github.com/kadubon/percolation-inversion-compiler/wiki

This TypeScript package is a runtime-facing npm companion. It targets the same public JSON meaning and safety contract, while using a Node-friendly local JSON/JSONL store for Phase Ecology Lab records.

Validation

Before this release, the following checks passed locally and in GitHub Actions:

• TypeScript type check
• ESLint
• Prettier format check
• Vitest test suite
• conformance tests
• npm pack safety scan
• installed tarball smoke test
• publint
• Are The Types Wrong
• npm audit at high severity
• cross-OS smoke tests on Ubuntu, Windows, and macOS with Node 20 and 22

This release is intended for npm users and JavaScript agent runtime workflows that need Python-free JSON checking, packet inspection, workflow report generation, and Phase Ecology Lab diagnostics.

percolation-inversion-compiler-ts v0.4.5

percolation-inversion-compiler-ts v0.4.5

percolation-inversion-compiler-ts is a Node.js and npm package for checking AI agent outputs, validating JSON workflow reports, and keeping unresolved work visible instead of silently treating it as complete. It is a TypeScript-compatible port of the public JSON, CLI, schema, conformance, and safety semantics from the canonical Python implementation.

Canonical Python project: https://github.com/kadubon/percolation-inversion-compiler
Canonical documentation and wiki: https://github.com/kadubon/percolation-inversion-compiler/wiki
Python compatibility target: percolation-inversion-compiler==0.4.4

What this package does

• Checks AI agent output and returns machine-readable JSON reports.
• Separates useful candidate work from completed verified work.
• Preserves blockers, missing obligations, residual notes, and candidate-only reasons.
• Provides a Node.js CLI and JavaScript/TypeScript SDK for agent runtime workflows.
• Supports schema validation, packet inspection, phase planning reports, runtime-step reports, adoption reports, and conformance fixtures.

Recommended npm CLI: pic-ts
Compatibility alias: pic

Install and quick start

npm install percolation-inversion-compiler-ts
npx pic-ts agent check --compact --text "Candidate packet: preserve residuals." --profile development

For local agent loops, use pic-ts from npm scripts or npm exec -- pic-ts ... so the same commands work on Windows, macOS, and Linux.

Changes in v0.4.5

• Runtime report digests now use a real SHA-256 digest in the form sha256:<64 hex characters>.
• Markdown output is more useful for adoption reports, phase reports, dashboards, observation reports, and autonomy audits.
• --format markdown --output <path> now writes Markdown to the requested file while JSON output behavior remains unchanged.
• Packet inspection now detects common Node.js, npm, package-manager, cloud, container, and shell-like command strings such as npm install, npx, node, docker run, and kubectl.
• Packet inspection remains inert: detected command-like text is reported only and is never executed.
• Documentation now recommends pic-ts for npm and explains that pic is a compatibility alias that may be confused with the Python CLI.
• Publish safety checks were hardened to reject unqualified overclaims and package-leak risks.
• A CHANGELOG.md was added for release tracking.

Safety boundary

This package is a deterministic report generator and validation helper. It does not prove real-world truth, physical outcomes, or artificial superintelligence. It does not grant shell, repository, network, cloud, browser, or model-execution authority.

Important output fields are intentionally separate:

• accepted: the input passed the relevant public checker for that route.
• workflow_usable: the result may help a workflow continue.
• operationally_usable: the result is usable under the selected operational profile.
• settled: all scoped finite verifier obligations were discharged.

In this package, useful candidate work, adoption readiness, benchmark scores, dashboard metrics, packet inspection, and safe_commands do not imply settled=true. safe_commands are recommendations or display data only; they are not executed automatically.

Compatibility scope

The Python package remains canonical. This TypeScript package targets Python v0.4.4 public behavior for fixture-backed JSON contracts, schema, conformance data, CLI semantics, and safety boundaries. Python-only heavy routes are handled as safe diagnostic compatibility routes that fail closed and preserve residual obligations instead of inventing new TypeScript semantics.

Validation before release

This release candidate passed the local and GitHub Actions release gates:

• TypeScript typecheck
• ESLint and Prettier format check
• Vitest unit and semantic tests
• Conformance fixtures
• npm pack safety scan
• Installed-package smoke tests without Python
• publint
• Are The Types Wrong
• npm audit with high-severity threshold
• GitHub Actions CI on Node.js 20 and 22
• Cross-platform installed smoke on Windows, macOS, and Linux

Search terms

Node.js AI agent output checker, npm AI workflow report generator, TypeScript JSON schema validation, LLM output validation, AI agent safety boundary, residual ledger, missing obligations, packet inspection, phase planning, runtime step report, Python compatibility port, conformance fixtures, deterministic certificate service.

percolation-inversion-compiler-ts v0.4.4

What this is

percolation-inversion-compiler-ts is the npm / Node.js version of percolation-inversion-compiler v0.4.4. It helps AI agent runtimes check agent output, produce structured JSON reports, keep unfinished verification work visible, and route the next safe workflow step.

The Python package remains the canonical implementation:

• https://github.com/kadubon/percolation-inversion-compiler
• https://github.com/kadubon/percolation-inversion-compiler/wiki

Install

Use it from npm with Node.js 20 or newer:

npm install percolation-inversion-compiler-ts
npx pic-ts agent check --compact

The package also provides a pic bin for CLI compatibility with the Python package name, and pic-ts as the recommended npm-specific command name.

What you can do with it

• Run pic-ts agent check --compact to inspect agent output.
• Run pic-ts runtime step with local JSON state/input files.
• Export and inspect packet sidecars with pic-ts packet export and pic-ts packet inspect.
• Build workflow repair plans with pic-ts phase plan --compact.
• Import the SDK from JavaScript or TypeScript, including ./schema, ./agent/messages, and ./packet subpaths.

Safety model

This release separates accepted, workflow_usable, operationally_usable, and settled. A report can be useful for a workflow while still keeping settled=false and listing missing obligations. The package does not execute arbitrary shell commands, mutate repositories, crawl in the background, or promote candidate data into completed work.

Compatibility

This TypeScript package targets Python percolation-inversion-compiler==0.4.4 public behavior for CLI JSON, schemas, conformance fixtures, status semantics, residual ledgers, obligations, phase planner output, and safety boundaries. Python-only heavy routes are exposed as fail-closed diagnostic compatibility routes.

Validation

Before this release, the repository passed:

• local typecheck, lint, format, tests, conformance, pack safety, installed smoke, publint, Are The Types Wrong, npm audit, prepack, and prepublishOnly
• GitHub Actions CI on Node 20 and Node 22
• cross-OS installed smoke on Ubuntu, Windows, and macOS
• npm registry install smoke for version 0.4.4