> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentlinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# agentlinkops citation sweep

> Run a bounded panel epoch and freeze its retained evidence.

```bash theme={null}
agentlinkops citation sweep PANEL.json --max-usd USD --out INVENTORY.json [--dir DIR]
```

## Behavior and output

Requires an explicit positive estimated USD reservation ceiling. Uses the [run](/reference/local/citation-run) engines, budget rules and separate browser egress journal. Reserves the output path before any measurement. Partial budget-aborted evidence is retained with exit 2. Select a mock panel for an offline run.

The frozen inventory checks retained envelopes against their observation references, digest, cell, prompt, engine and recorded sample range. Changed, missing or unreferenced envelopes remain invalid or missing; they do not establish citation absence. Unknown observations stay unknown. Conflicting observation identities stop the operation. The inventory keeps the historical local evidence digest separate from its checksum of the exact retained bytes. Existing files are not rewritten. The historical digest does not authenticate screenshot pixels.

## Arguments

PANEL.json, --max-usd and --out required; --dir defaults to .agentlinkops.

## Exit status

0 on success; 1 for a sweep with a measured decline; 2 on invalid input, existing output, configuration failure or budget abort.

Read [configuration and file ownership](/reference/local/configuration) before automating this command. Read [local file contracts](/reference/local/artifacts) for artifact fields. Browse the [local command index](/reference/local/index) for related commands.

<Note>Check the selected environment and workspace access before calling hosted operations. See [capability status](/capability-status).</Note>
