Diagnostic Commands

Diagnostic Commands

PIC-TS includes diagnostic command families for local agent workflow inspection. v0.6.0 adds CCR handoff and TRC operation-readiness surfaces on top of the v0.5.0 Phase Ecology Lab diagnostics.

These commands produce JSON reports. They are recommendation or diagnostic routes. They do not execute packet content, trace content, shell commands, or cloud commands.

BIT: Bottleneck Inversion

BIT commands help describe blockers and possible enabling conditions.

npx pic-ts bit diagnose --graph examples/phase_lab/effective_graph.example.json
npx pic-ts bit invert --bottlenecks bottlenecks.json
npx pic-ts bit mec --bottlenecks bottlenecks.json --bottleneck bottleneck:missing
npx pic-ts bit certificate --candidate inversion_candidates.json
npx pic-ts bit compare-baseline --baseline baseline.json --candidate candidate.json
npx pic-ts bit extract-registry --source "Bottleneck Inversion Theory.tex" --output bit_registry.jsonl
npx pic-ts bit verify-witnesses --registry bit_registry.jsonl --output bit_witnesses.json
npx pic-ts bit emit-ccr-tasks --registry bit_registry.jsonl --output bit_witness_tasks.jsonl

BIT output is diagnostic. A bottleneck candidate is not a settled fix.

SQOT: Queue And Salience

SQOT commands inspect queue pressure, salience obstruction, quarantine, and reserve checks.

npx pic-ts sqot diagnose-queue --graph examples/phase_lab/effective_graph.example.json
npx pic-ts sqot diagnose-queue --state phase_report.json --emit ccr-tasks --output sqot_repair_tasks.jsonl
npx pic-ts sqot salience-obstruction --graph examples/phase_lab/effective_graph.example.json
npx pic-ts sqot rebalance --graph examples/phase_lab/effective_graph.example.json
npx pic-ts sqot quarantine --graph examples/phase_lab/effective_graph.example.json
npx pic-ts sqot reserve-check --graph examples/phase_lab/effective_graph.example.json

SQOT output is recommendation-only. Quarantine is a bounded diagnostic record, not deletion or automatic settlement.

ALT: Abstraction Liquidity

ALT commands inspect whether reusable abstraction records can help ECPT-style capability routing.

npx pic-ts alt ecpt-lift --packets examples/alt_lift/alt_ecpt_lift.example.json --graph examples/phase_lab/effective_graph.example.json
npx pic-ts alt bridge-ecpt --packet alt_packet.json --output alt_bridge.json
npx pic-ts alt receiver-lift --packet packet.json --receiver-context context.json
npx pic-ts alt liquidity-to-paths --packet packet.json --graph graph.json
npx pic-ts alt capital-impact --reports alt_reports.json

ALT output does not automatically become accepted capital. Missing bridges, hazards, and finality obligations remain visible.

TRC: Typed Runtime Trace

TRC commands adapt tool and action traces into typed records.

npx pic-ts trc trace-adapter --input examples/trc_adapter/tool_trace_input.example.json
npx pic-ts trc tool-trace --events examples/trc_adapter/tool_trace_input.example.json
npx pic-ts trc action-boundary --report runtime_step_report.json
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 trace-to-packet --trace trace_nf.json --output trace_packet.json

Trace content is inert data. Embedded npm, node, docker, kubectl, curl, bash, or powershell text is not executed.

operation_ready=true means the trace is structured enough for scoped review. It is not execution or physical proof.

Ecology

Ecology commands build graph and execution-path reports from local JSON.

npx pic-ts ecology effective-graph --reports report_1.json --reports report_2.json --output effective_graph.json
npx pic-ts ecology execution-available-paths --graph effective_graph.json

Execution-available paths are detected as data. They do not grant execution authority.