Diagnostic Commands

Diagnostic Commands

PIC-TS v0.5.0 adds diagnostic command families for local agent workflow inspection.

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

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

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

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.