plc_program_history
List tracked PLC programs or retrieve one program's snapshot history from a local baseline store to review change-control evidence without parsing files or touching devices.
Instructions
[READ][risk=low] Tracked programs, or one program's snapshot history.
Local read of the program-baseline store — no file is parsed and no device is
touched. Nothing is ever pruned automatically: a change-control history that
quietly drops last quarter's baseline is worse than one that grows, and a
stored row is block names, hashes and counts rather than source. Removing history is a
deliberate act and is CLI-only (`iaiops program forget`) — deleting
change-control evidence should not be one tool call away.
Args:
name: Tracked program name. Omit for the list of every tracked program.
Returns dict (listing): {store, program_count, programs:[{program,
snapshot_count, latest, latest_taken_at}]}; (one program): {store,
program, snapshot_count, snapshots:[{snapshot_id, taken_at, source_file,
content_sha256, label, note}]}.
Example: plc_program_history(name="Line3").
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "plc_program_history"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No |