npm - neatlogs-cli - Versions diffs - 0.2.1 → 0.2.2 - Mend

neatlogs-cli 0.2.1 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/CHANGELOG.md +32 -7
package/README.md +148 -67
package/SECURITY.md +4 -0
package/dist/bin.js +105783 -80796
package/docs/command-reference.md +2214 -357
package/docs/execution-secret-custody.md +86 -0
package/docs/runtime-detection-reads.md +63 -0
package/package.json +2 -2

package/docs/command-reference.md CHANGED Viewed

@@ -456,7 +456,7 @@ None.
 ## `neatlogs api <operationId>`
-execute a release-embedded public operation
+execute a bundled public operation or a discovered read
 Usage: `neatlogs api [options] <operationId>`
@@ -473,6 +473,20 @@ Usage: `neatlogs api [options] <operationId>`
 | `--param <name=value...>` | Optional option | reviewed path parameters as name=value pairs | — |
 | `--query <name=value...>` | Optional option | reviewed query parameters as name=value pairs | — |
 | `--body-stdin` | Optional option | read one reviewed JSON request body from stdin | — |
+| `--catalog-version <version>` | Optional option | runtime reads (1 or 2), definitions (3), canonical execution (4) | 1 |
+| `--live` | Optional option | require fresh authenticated runtime discovery | — |
+| `--account` | Optional option | account-only discovery without a project (live catalog v2) | — |
+| `--service-account <uuid>` | Optional option | service-account resource target for live catalog v2 | — |
+| `--service-account-token <uuid>` | Optional option | token resource target for catalog v3 | — |
+| `--organization <uuid>` | Optional option | organization target for live catalog v2/v3 | — |
+| `--execution [uuid]` | Optional option | read durable compute status by UUID, or by --compute-key when omitted | — |
+| `--cancel-execution` | Optional option | request cancellation of --execution with explicit intent | — |
+| `--expected-version <number>` | Optional option | current compute version required for cancellation | — |
+| `--output <path>` | Optional option | save a binary response to a new private file | — |
+| `--compute-key <key>` | Optional option | stable high-entropy key for compute reads | — |
+| `--original-content-type <value>` | Optional option | original request media type for --result or --execution recovery | — |
+| `--result` | Optional option | read the saved result using the original action input and idempotency key | — |
+| `--confirm` | Optional option | confirm explicit intent for a discovered write or compute action | — |
 | `--idempotency-key <key>` | Optional option | stable key for an idempotent mutation | — |
 ## `neatlogs api-keys create`
@@ -633,6 +647,25 @@ Usage: `neatlogs billing subscription [options] <organization-id>`
 None.
+## `neatlogs classifiers candidates <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers candidates [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs classifiers create`
 No additional description.
@@ -688,6 +721,26 @@ Usage: `neatlogs classifiers datasets list [options] <classifier-id>`
 | `--after-id <id>` | Optional option | UUID nextId returned by the preceding page | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
+## `neatlogs classifiers delete <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers delete [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm <id>` | Required option | confirm the exact classifier UUID | — |
 ## `neatlogs classifiers get <classifier-id>`
 No additional description.
@@ -739,6 +792,26 @@ Usage: `neatlogs classifiers jobs get [options] <job-id>`
 None.
+## `neatlogs classifiers labels delete <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers labels delete [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read selected labelIds JSON | — |
+| `--confirm <id>` | Required option | confirm the exact classifier UUID | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs classifiers labels list <classifier-id>`
 No additional description.
@@ -777,6 +850,150 @@ Usage: `neatlogs classifiers labels save [options] <classifier-id>`
 | `--body-stdin` | Required option | read the bounded JSON request from stdin | — |
 | `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries of the same request | — |
+## `neatlogs classifiers library create`
+No additional description.
+Usage: `neatlogs classifiers library create [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs classifiers library delete <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library delete [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm <id>` | Required option | confirm the exact dataset UUID | — |
+## `neatlogs classifiers library examples delete <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library examples delete [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm <id>` | Required option | confirm the exact dataset UUID | — |
+## `neatlogs classifiers library examples list <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library examples list [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs classifiers library examples save <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library examples save [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs classifiers library get <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library get [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs classifiers library list`
+No additional description.
+Usage: `neatlogs classifiers library list [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--after-id <id>` | Optional option | — | — |
+| `--limit <number>` | Optional option | — | — |
+## `neatlogs classifiers library update <dataset-id>`
+No additional description.
+Usage: `neatlogs classifiers library update [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs classifiers list`
 No additional description.
@@ -794,6 +1011,25 @@ None.
 | `--after-id <id>` | Optional option | UUID nextId returned by the preceding page | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
+## `neatlogs classifiers predict <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers predict [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs classifiers publish <classifier-id>`
 No additional description.
@@ -813,6 +1049,79 @@ Usage: `neatlogs classifiers publish [options] <classifier-id>`
 | `--body-stdin` | Required option | read the bounded JSON request from stdin | — |
 | `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries of the same request | — |
+## `neatlogs classifiers ready <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers ready [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--trained-version <number>` | Required option | exact trained version | — |
+| `--method <method>` | Optional option | setfit or existing qlora version | setfit |
+## `neatlogs classifiers references <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers references [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs classifiers suggest-labels <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers suggest-labels [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs classifiers synthetic <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers synthetic [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs classifiers training list <classifier-id>`
 No additional description.
@@ -870,6 +1179,25 @@ Usage: `neatlogs classifiers unpublish [options] <classifier-id>`
 | `--confirm <id>` | Required option | confirm the exact target UUID | — |
 | `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs classifiers update <classifier-id>`
+No additional description.
+Usage: `neatlogs classifiers update [options] <classifier-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `classifier-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
 ## `neatlogs coding-tools connect`
 No additional description.
@@ -1255,9 +1583,223 @@ None.
 | `--body-stdin` | Required option | read 1-50 exact managed credential confirmations from stdin | — |
 | `--idempotency-key <key>` | Optional option | stable UUID for retrying revocation | — |
-## `neatlogs detections author`
+## `neatlogs datasets captures abort <job-id>`
-prepare, revise, retest or commit a service account's detector draft
+discard an unfinished SDK recording without publishing cases
+Usage: `neatlogs datasets captures abort [options] <job-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `job-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <job-id>` | Required option | repeat the exact capture job UUID | — |
+| `--body-stdin` | Required option | read the abort reason JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this abort | — |
+## `neatlogs datasets captures complete <job-id>`
+seal recorded SDK traces and queue dataset capture
+Usage: `neatlogs datasets captures complete [options] <job-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `job-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read bounded SDK trace and span IDs JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying completion | — |
+## `neatlogs datasets captures get <job-id>`
+No additional description.
+Usage: `neatlogs datasets captures get [options] <job-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `job-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--after <number>` | Optional option | failure ordinal (-1-2000) | — |
+| `--limit <number>` | Optional option | failure page size (1-100) | — |
+## `neatlogs datasets captures list`
+No additional description.
+Usage: `neatlogs datasets captures list [options]`
+### Arguments
+None.
+### Options
+None.
+## `neatlogs datasets captures start`
+register a capture before recording SDK traces
+Usage: `neatlogs datasets captures start [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read bounded SDK capture registration JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this capture | — |
+## `neatlogs datasets case <dataset-id> <case-id>`
+No additional description.
+Usage: `neatlogs datasets case [options] <dataset-id> <case-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+| `case-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--version-id <id>` | Optional option | published version UUID; defaults to latest | — |
+## `neatlogs datasets cases <dataset-id>`
+No additional description.
+Usage: `neatlogs datasets cases [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--version-id <id>` | Required option | pin the published version UUID | — |
+| `--offset <number>` | Optional option | case offset (0-2000) | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+## `neatlogs datasets create`
+No additional description.
+Usage: `neatlogs datasets create [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read bounded imported cases JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this creation | — |
+## `neatlogs datasets get <dataset-id>`
+No additional description.
+Usage: `neatlogs datasets get [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--version-id <id>` | Optional option | published version UUID; defaults to latest | — |
+## `neatlogs datasets list`
+No additional description.
+Usage: `neatlogs datasets list [options]`
+### Arguments
+None.
+### Options
+None.
+## `neatlogs datasets publish-edits <dataset-id>`
+No additional description.
+Usage: `neatlogs datasets publish-edits [options] <dataset-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `dataset-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read bounded immutable version edits JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this publication | — |
+## `neatlogs detections activity <detection-id>`
+No additional description.
+Usage: `neatlogs detections activity [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--ids <uuids>` | Required option | 1-100 unique finding UUIDs separated by commas | — |
+## `neatlogs detections author`
+prepare, revise, retest or commit a service account's detector draft
 Usage: `neatlogs detections author [options]`
@@ -1269,241 +1811,1425 @@ None.
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the authoring action JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this action | — |
+| `--request-stdin` | Required option | read the authoring action JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this action | — |
+## `neatlogs detections authoring commit`
+approve the exact revision and preview returned by authoring show
+Usage: `neatlogs detections authoring commit [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--draft-id <id>` | Required option | actor-bound draft UUID | — |
+| `--revision <number>` | Required option | exact reviewed revision | — |
+| `--fingerprint <hash>` | Required option | draft identity fingerprint | — |
+| `--approval-fingerprint <hash>` | Required option | exact reviewed source and preview fingerprint | — |
+| `--confirm <draft-id>` | Optional option | repeat the draft UUID to approve activation | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring context`
+read up to 100 project detection summaries
+Usage: `neatlogs detections authoring context [options]`
+### Arguments
+None.
+### Options
+None.
+## `neatlogs detections authoring conversations cancel`
+request cancellation of the exact running turn
+Usage: `neatlogs detections authoring conversations cancel [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--conversation-id <id>` | Required option | actor-owned conversation UUID | — |
+| `--run-id <id>` | Required option | exact run UUID from show | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring conversations show`
+read persisted status and the pending clarification
+Usage: `neatlogs detections authoring conversations show [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--conversation-id <id>` | Required option | actor-owned conversation UUID | — |
+## `neatlogs detections authoring conversations start`
+start a conversation from a goal
+Usage: `neatlogs detections authoring conversations start [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring conversations turn`
+send a follow-up or clarification answers
+Usage: `neatlogs detections authoring conversations turn [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read strict JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--conversation-id <id>` | Required option | actor-owned conversation UUID | — |
+## `neatlogs detections authoring helper`
+run one bounded detection authoring helper
+Usage: `neatlogs detections authoring helper [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read fixed helper action JSON from stdin | — |
+## `neatlogs detections authoring prepare`
+prepare and preview an inactive draft
+Usage: `neatlogs detections authoring prepare [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read draft proposal JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring retest`
+retest an inactive draft at an exact revision
+Usage: `neatlogs detections authoring retest [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--draft-id <id>` | Required option | your actor-bound draft | — |
+| `--request-stdin` | Required option | read revision, fingerprint and optional proposal JSON | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring revise`
+revise an inactive draft at an exact revision
+Usage: `neatlogs detections authoring revise [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--draft-id <id>` | Required option | your actor-bound draft | — |
+| `--request-stdin` | Required option | read revision, fingerprint and optional proposal JSON | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections authoring show`
+read your draft and exact reviewed evidence
+Usage: `neatlogs detections authoring show [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--draft-id <id>` | Required option | actor-bound draft UUID | — |
+## `neatlogs detections backfill <detection-id>`
+explicitly rescore a bounded historical trace set
+Usage: `neatlogs detections backfill [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read bounded backfill request JSON | — |
+| `--confirm <detection-id>` | Required option | confirm the exact detection whose historical results will be written | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections backfills cancel <detection-id> <job-id>`
+No additional description.
+Usage: `neatlogs detections backfills cancel [options] <detection-id> <job-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <job-id>` | Required option | confirm the exact backfill job UUID | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections backfills get <detection-id> <job-id>`
+No additional description.
+Usage: `neatlogs detections backfills get [options] <detection-id> <job-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs detections classifiers catalog`
+read current targets and policy defaults
+Usage: `neatlogs detections classifiers catalog [options]`
+### Arguments
+None.
+### Options
+None.
+## `neatlogs detections code repair`
+propose a bounded source repair that requires fresh validation
+Usage: `neatlogs detections code repair [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read bounded Code repair JSON from stdin | — |
+## `neatlogs detections code validate`
+validate exact source and one optional bounded sample
+Usage: `neatlogs detections code validate [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the bounded Code validation request JSON from stdin | — |
+## `neatlogs detections create`
+No additional description.
+Usage: `neatlogs detections create [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--group <uuid>` | Optional option | detection group UUID | — |
+| `--name <name>` | Optional option | display name | — |
+| `--type <type>` | Optional option | classifier, regex, conditional, pii, custom_trained, code, trace_rules, or decision | — |
+| `--config <json>` | Optional option | type-specific JSON configuration | — |
+| `--description <text>` | Optional option | description | — |
+| `--threshold <number>` | Optional option | flag threshold from 0 through 1 | — |
+| `--run-on <json>` | Optional option | bounded run-on JSON configuration | — |
+| `--batch-fields <json>` | Optional option | JSON array of span element fields | — |
+| `--inactive` | Optional option | create disabled | — |
+| `--body-stdin` | Optional option | read complete bounded JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs detections delete <detection-id>`
+No additional description.
+Usage: `neatlogs detections delete [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <detection-id>` | Optional option | repeat the exact detection ID | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs detections disable <detection-id>`
+No additional description.
+Usage: `neatlogs detections disable [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs detections draft <draft-id>`
+read this service account's draft, preview and monitoring state
+Usage: `neatlogs detections draft [options] <draft-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `draft-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs detections duplicate <detection-id>`
+No additional description.
+Usage: `neatlogs detections duplicate [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--name <name>` | Required option | display name for the new detection | — |
+| `--group <uuid>` | Optional option | destination group UUID | — |
+| `--inactive` | Optional option | create disabled | — |
+| `--idempotency-key <key>` | Optional option | fresh UUID for this duplicate | — |
+## `neatlogs detections enable <detection-id>`
+No additional description.
+Usage: `neatlogs detections enable [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs detections generate`
+No additional description.
+Usage: `neatlogs detections generate [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the bounded detection generation request JSON from stdin | — |
+## `neatlogs detections get <detection-id>`
+No additional description.
+Usage: `neatlogs detections get [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs detections history <detection-id>`
+No additional description.
+Usage: `neatlogs detections history [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs detections hits <detection-id>`
+No additional description.
+Usage: `neatlogs detections hits [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs detections list`
+No additional description.
+Usage: `neatlogs detections list [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--group <uuid>` | Optional option | filter by detection group UUID | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--status <status>` | Optional option | active, paused, disabled, inactive, or all | — |
+| `--search <text>` | Optional option | search detection names, descriptions, groups and engines | — |
+| `--sort-by <key>` | Optional option | name, sentiment, type, created_at, updated_at, or alerts | — |
+| `--sort-direction <direction>` | Optional option | asc or desc | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs detections pause <detection-id>`
+No additional description.
+Usage: `neatlogs detections pause [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs detections pending-suggestions accept`
+No additional description.
+Usage: `neatlogs detections pending-suggestions accept [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read the bounded selected Detection IDs or generation request from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm` | Required option | confirm the exact Detection IDs in the stdin request | — |
+## `neatlogs detections pending-suggestions dismiss`
+No additional description.
+Usage: `neatlogs detections pending-suggestions dismiss [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read the bounded selected Detection IDs or generation request from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm` | Required option | confirm the exact Detection IDs in the stdin request | — |
+## `neatlogs detections pending-suggestions generate`
+No additional description.
+Usage: `neatlogs detections pending-suggestions generate [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read the bounded selected Detection IDs or generation request from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+## `neatlogs detections pending-suggestions list`
+No additional description.
+Usage: `neatlogs detections pending-suggestions list [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--after-id <id>` | Optional option | — | — |
+| `--limit <number>` | Optional option | — | — |
+## `neatlogs detections preview`
+preview any supported detection engine within a bounded window
+Usage: `neatlogs detections preview [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the bounded detection preview request JSON from stdin | — |
+## `neatlogs detections results <detection-id>`
+No additional description.
+Usage: `neatlogs detections results [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--target-type <value>` | Optional option | span, trace, session, or all | all |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--from <timestamp>` | Optional option | inclusive UTC start timestamp | — |
+| `--to <timestamp>` | Optional option | exclusive UTC end timestamp | — |
+| `--min-score <number>` | Optional option | minimum finding score (0-1) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs detections suggestion-accept <suggestion-id>`
+No additional description.
+Usage: `neatlogs detections suggestion-accept [options] <suggestion-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `suggestion-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <suggestion-id>` | Required option | confirm the exact suggestion id | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying transition | — |
+## `neatlogs detections suggestion-dismiss <suggestion-id>`
+No additional description.
+Usage: `neatlogs detections suggestion-dismiss [options] <suggestion-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `suggestion-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <suggestion-id>` | Required option | confirm the exact suggestion id | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying transition | — |
+## `neatlogs detections suggestions-list`
+No additional description.
+Usage: `neatlogs detections suggestions-list [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-50) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs detections suggestions-run`
+No additional description.
+Usage: `neatlogs detections suggestions-run [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the bounded suggestion run request JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this run | — |
+## `neatlogs detections suggestions-run-cancel <run-id>`
+No additional description.
+Usage: `neatlogs detections suggestions-run-cancel [options] <run-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `run-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <run-id>` | Required option | confirm the exact run id | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying cancellation | — |
+## `neatlogs detections suggestions-run-status <run-id>`
+No additional description.
+Usage: `neatlogs detections suggestions-run-status [options] <run-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `run-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs detections trace <detection-id>`
+No additional description.
+Usage: `neatlogs detections trace [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--trace-id <id>` | Required option | selected trace identity | — |
+| `--mode <mode>` | Required option | inspect stored findings or evaluate this detector | — |
+## `neatlogs detections trace-rules validate`
+validate rules and optionally evaluate one bounded trace sample
+Usage: `neatlogs detections trace-rules validate [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read bounded Trace Rules validation JSON from stdin | — |
+## `neatlogs detections trends <detection-id>`
+No additional description.
+Usage: `neatlogs detections trends [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--from <timestamp>` | Required option | inclusive UTC start timestamp | — |
+| `--to <timestamp>` | Required option | exclusive UTC end timestamp | — |
+| `--granularity <value>` | Optional option | hour, day, or week | day |
+| `--target-type <value>` | Optional option | span (default), trace, session, or all | — |
+## `neatlogs detections trends-batch`
+No additional description.
+Usage: `neatlogs detections trends-batch [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--ids <uuids>` | Required option | 1-50 detection UUIDs separated by commas | — |
+| `--from <timestamp>` | Required option | inclusive UTC start timestamp | — |
+| `--to <timestamp>` | Required option | exclusive UTC end timestamp | — |
+| `--granularity <value>` | Optional option | hour, day, or week | day |
+| `--target-type <value>` | Optional option | span, trace, session, or all | span |
+## `neatlogs detections update <detection-id>`
+No additional description.
+Usage: `neatlogs detections update [options] <detection-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `detection-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--group <uuid>` | Optional option | new detection group UUID | — |
+| `--name <name>` | Optional option | new display name | — |
+| `--description <text>` | Optional option | new description | — |
+| `--clear-description` | Optional option | set description to null | — |
+| `--threshold <number>` | Optional option | flag threshold from 0 through 1 | — |
+| `--config <json>` | Optional option | type-specific JSON configuration | — |
+| `--run-on <json>` | Optional option | bounded run-on JSON configuration | — |
+| `--batch-fields <json>` | Optional option | JSON array of span element fields | — |
+| `--clear-batch-fields` | Optional option | set batch fields to null | — |
+| `--body-stdin` | Optional option | read complete bounded JSON body from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs evals activate <evaluation-id>`
+activate an owned evaluation for members and opted-in guest/AI reviewers
+Usage: `neatlogs evals activate [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--invite-guests` | Optional option | include retained guests and durably queue invitations for this and future dispatched batches | — |
+| `--body-stdin` | Required option | read reviewers, duration, bounds and optional reminderConfig/notifications as JSON | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same activation | — |
+## `neatlogs evals add-ai <evaluation-id>`
+attach active project AI evaluator definitions to the current or future roster
+Usage: `neatlogs evals add-ai [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | JSON containing distinct evaluatorDefinitionIds | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same assignment | — |
+## `neatlogs evals add-guests <evaluation-id>`
+assign guest emails without sending invitations
+Usage: `neatlogs evals add-guests [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | JSON containing distinct guest emails | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same assignment | — |
+## `neatlogs evals add-members <evaluation-id>`
+assign existing eligible members to the current or future roster
+Usage: `neatlogs evals add-members [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | JSON containing distinct reviewerUserIds | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same assignment | — |
+## `neatlogs evals ai-insights <evaluation-id>`
+read campaign runs and metrics for the returned page
+Usage: `neatlogs evals ai-insights [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor from the previous page | — |
+| `--limit <number>` | Optional option | page size (1-25, default 10) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs evals ai-metrics <evaluation-id>`
+read metrics across every campaign run; paginate evaluator definitions
+Usage: `neatlogs evals ai-metrics [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor from the previous definition page | — |
+| `--limit <number>` | Optional option | definitions per page (1-100, default 25) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs evals archive <evaluation-id>`
+archive an active or completed evaluation
+Usage: `neatlogs evals archive [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--confirm <evaluation-id>` | Required option | repeat the exact evaluation UUID to confirm archive | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical archive | — |
+## `neatlogs evals assignments list <evaluation-id> <item-id>`
+No additional description.
+Usage: `neatlogs evals assignments list [options] <evaluation-id> <item-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs evals assistant chat`
+start or continue a conversation; same-key recovery returns the frozen confirmed running/completed/failed response, not later native progress
+Usage: `neatlogs evals assistant chat [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read query/context and optional sessionId JSON | — |
+| `--idempotency-key <key>` | Optional option | stable UUID; recover the confirmed snapshot without polling native completion | — |
+## `neatlogs evals assistant decide <session-id> <message-id>`
+record suggestion acceptance/rejection; reuse the key to recover the original decision
+Usage: `neatlogs evals assistant decide [options] <session-id> <message-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `session-id` | Required argument | — | — |
+| `message-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read status and optional partial question selections JSON | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this decision | — |
+## `neatlogs evals assistant delete-session <session-id>`
+soft-delete an owned session; reuse the key to recover an uncertain response
+Usage: `neatlogs evals assistant delete-session [options] <session-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `session-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same deletion | — |
+## `neatlogs evals assistant messages <session-id>`
+read up to 100 visible messages from an owned session
+Usage: `neatlogs evals assistant messages [options] <session-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `session-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs evals assistant preview`
+preview AI-assisted form additions, edits or removals without saving
+Usage: `neatlogs evals assistant preview [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read query and current-form/selection context | — |
-## `neatlogs detections backfill <detection-id>`
+## `neatlogs evals assistant sessions`
-explicitly rescore a bounded historical trace set
+list the latest 20 sessions; inspect historyWindow.mayHaveMore
-Usage: `neatlogs detections backfill [options] <detection-id>`
+Usage: `neatlogs evals assistant sessions [options]`
+### Arguments
+None.
+### Options
+None.
+## `neatlogs evals batches close <evaluation-id> <batch-id>`
+No additional description.
+Usage: `neatlogs evals batches close [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--body-stdin` | Required option | read bounded backfill request JSON | — |
-| `--confirm <detection-id>` | Required option | confirm the exact detection whose historical results will be written | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--confirm <batch-id>` | Required option | repeat the exact batch UUID to confirm closure | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same closure | — |
-## `neatlogs detections backfills cancel <detection-id> <job-id>`
+## `neatlogs evals batches cube <evaluation-id> <batch-id>`
 No additional description.
-Usage: `neatlogs detections backfills cancel [options] <detection-id> <job-id>`
+Usage: `neatlogs evals batches cube [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
-| `job-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <job-id>` | Required option | confirm the exact backfill job UUID | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable UUID for retries | — |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs detections backfills get <detection-id> <job-id>`
+## `neatlogs evals batches dispatch <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections backfills get [options] <detection-id> <job-id>`
+Usage: `neatlogs evals batches dispatch [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
-| `job-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--invite-guests` | Optional option | durably queue invitations for this batch’s frozen guest reviewers | — |
+| `--max-items <number>` | Required option | acknowledged queued item ceiling (1-1000) | — |
+| `--max-assignments <number>` | Required option | acknowledged assignment ceiling (1-10000) | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same dispatch | — |
-## `neatlogs detections create`
+## `neatlogs evals batches export-report <evaluation-id> <batch-id>`
 No additional description.
-Usage: `neatlogs detections create [options]`
+Usage: `neatlogs evals batches export-report [options] <evaluation-id> <batch-id>`
 ### Arguments
-None.
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--group <uuid>` | Required option | detection group UUID | — |
-| `--name <name>` | Required option | display name | — |
-| `--type <type>` | Required option | classifier, regex, conditional, or pii | — |
-| `--config <json>` | Required option | type-specific JSON configuration | — |
-| `--description <text>` | Optional option | description | — |
-| `--threshold <number>` | Optional option | flag threshold from 0 through 1 | — |
-| `--run-on <json>` | Optional option | bounded run-on JSON configuration | — |
-| `--batch-fields <json>` | Optional option | JSON array of span element fields | — |
-| `--inactive` | Optional option | create disabled | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+| `--output <path>` | Optional option | create a private JSON file; use - or omit for stdout | — |
-## `neatlogs detections delete <detection-id>`
+## `neatlogs evals batches generate-report <evaluation-id> <batch-id>`
-No additional description.
+queue a report; reuse the key for retries, use a new key to regenerate
-Usage: `neatlogs detections delete [options] <detection-id>`
+Usage: `neatlogs evals batches generate-report [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <detection-id>` | Optional option | repeat the exact detection ID | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this report admission | — |
-## `neatlogs detections disable <detection-id>`
+## `neatlogs evals batches get <evaluation-id> <batch-id>`
 No additional description.
-Usage: `neatlogs detections disable [options] <detection-id>`
+Usage: `neatlogs evals batches get [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs evals batches list <evaluation-id>`
+No additional description.
+Usage: `neatlogs evals batches list [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs detections draft <draft-id>`
+## `neatlogs evals batches remind <evaluation-id> <batch-id>`
-read this service account's draft, preview and monitoring state
+queue a reminder for selected frozen member reviewers; retry with the same key
-Usage: `neatlogs detections draft [options] <draft-id>`
+Usage: `neatlogs evals batches remind [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `draft-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read evaluatorIds, channels and optional message JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same reminder | — |
-## `neatlogs detections enable <detection-id>`
+## `neatlogs evals batches report <evaluation-id> <batch-id>`
 No additional description.
-Usage: `neatlogs detections enable [options] <detection-id>`
+Usage: `neatlogs evals batches report [options] <evaluation-id> <batch-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs evals batches report-status <evaluation-id> <batch-id>`
+read the latest asynchronous report job status and safe error code
+Usage: `neatlogs evals batches report-status [options] <evaluation-id> <batch-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
+### Options
+None.
+## `neatlogs evals batches set-deadline <evaluation-id> <batch-id>`
+set a review deadline and apply its duration to selected batches
+Usage: `neatlogs evals batches set-deadline [options] <evaluation-id> <batch-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+| `--body-stdin` | Required option | read reviewDeadline and optional batchIds JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same deadline update | — |
-## `neatlogs detections generate`
+## `neatlogs evals batches summary <evaluation-id> <batch-id>`
 No additional description.
-Usage: `neatlogs detections generate [options]`
+Usage: `neatlogs evals batches summary [options] <evaluation-id> <batch-id>`
 ### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `batch-id` | Required argument | — | — |
+### Options
 None.
+## `neatlogs evals close <evaluation-id>`
+close an active evaluation
+Usage: `neatlogs evals close [options] <evaluation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded detection generation request JSON from stdin | — |
+| `--confirm <evaluation-id>` | Required option | repeat the exact evaluation UUID to confirm closure | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical closure | — |
-## `neatlogs detections get <detection-id>`
+## `neatlogs evals cohort add <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections get [options] <detection-id>`
+Usage: `neatlogs evals cohort add [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the bounded cohort mutation JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID when retrying the same logical mutation | — |
-## `neatlogs detections history <detection-id>`
+## `neatlogs evals cohort preview <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections history [options] <detection-id>`
+Usage: `neatlogs evals cohort preview [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-100) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--request-stdin` | Required option | read the bounded cohort preview JSON from stdin | — |
-## `neatlogs detections hits <detection-id>`
+## `neatlogs evals cohort remove <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections hits [options] <detection-id>`
+Usage: `neatlogs evals cohort remove [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-100) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--request-stdin` | Required option | read the bounded cohort mutation JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable UUID when retrying the same logical mutation | — |
-## `neatlogs detections list`
+## `neatlogs evals cohorts`
 No additional description.
-Usage: `neatlogs detections list [options]`
+Usage: `neatlogs evals cohorts [options]`
 ### Arguments
@@ -1514,189 +3240,207 @@ None.
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--group <uuid>` | Optional option | filter by detection group UUID | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
-| `--status <status>` | Optional option | active, paused, disabled, inactive, or all | — |
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs detections preview`
+## `neatlogs evals create`
 No additional description.
-Usage: `neatlogs detections preview [options]`
+Usage: `neatlogs evals create [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | read the bounded evaluation JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical creation | — |
+## `neatlogs evals discard <evaluation-id>`
+permanently discard a never-launched evaluation draft
+Usage: `neatlogs evals discard [options] <evaluation-id>`
 ### Arguments
-None.
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded detection preview request JSON from stdin | — |
+| `--confirm <evaluation-id>` | Required option | repeat the exact evaluation UUID to confirm draft discard | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical draft discard | — |
-## `neatlogs detections suggestion-accept <suggestion-id>`
+## `neatlogs evals dispatch-ai <evaluation-id>`
-No additional description.
+dispatch or retry bounded AI work for an active review window
-Usage: `neatlogs detections suggestion-accept [options] <suggestion-id>`
+Usage: `neatlogs evals dispatch-ai [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `suggestion-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <suggestion-id>` | Required option | confirm the exact suggestion id | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying transition | — |
+| `--body-stdin` | Required option | JSON with optional batchId, maxItems and maxAssignments | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same assignment | — |
-## `neatlogs detections suggestion-dismiss <suggestion-id>`
+## `neatlogs evals export <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections suggestion-dismiss [options] <suggestion-id>`
+Usage: `neatlogs evals export [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `suggestion-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <suggestion-id>` | Required option | confirm the exact suggestion id | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying transition | — |
+| `--from <timestamp>` | Required option | inclusive ISO 8601 start timestamp | — |
+| `--to <timestamp>` | Required option | exclusive ISO 8601 end timestamp | — |
+| `--limit <number>` | Optional option | maximum response rows (1-5000) | — |
+| `--output <path>` | Optional option | create a private JSON file; use - or omit for stdout | — |
-## `neatlogs detections suggestions-list`
+## `neatlogs evals exports cancel <evaluation-id> <job-id>`
 No additional description.
-Usage: `neatlogs detections suggestions-list [options]`
+Usage: `neatlogs evals exports cancel [options] <evaluation-id> <job-id>`
 ### Arguments
-None.
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-50) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--idempotency-key <uuid>` | Required option | Stable cancellation identity | — |
-## `neatlogs detections suggestions-run`
+## `neatlogs evals exports create <evaluation-id>`
 No additional description.
-Usage: `neatlogs detections suggestions-run [options]`
+Usage: `neatlogs evals exports create [options] <evaluation-id>`
 ### Arguments
-None.
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded suggestion run request JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this run | — |
+| `--format <format>` | Required option | csv or json | — |
+| `--idempotency-key <uuid>` | Required option | Stable admission identity | — |
-## `neatlogs detections suggestions-run-cancel <run-id>`
+## `neatlogs evals exports download <evaluation-id> <job-id>`
 No additional description.
-Usage: `neatlogs detections suggestions-run-cancel [options] <run-id>`
+Usage: `neatlogs evals exports download [options] <evaluation-id> <job-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `run-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <run-id>` | Required option | confirm the exact run id | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying cancellation | — |
+| `--output <path>` | Optional option | stream the artifact to a new private file; existing files are never overwritten | — |
+| `--max-bytes <bytes>` | Optional option | file limit, default 1 GiB and maximum 5 GiB | 1073741824 |
-## `neatlogs detections suggestions-run-status <run-id>`
+## `neatlogs evals exports resume <evaluation-id> <job-id>`
 No additional description.
-Usage: `neatlogs detections suggestions-run-status [options] <run-id>`
+Usage: `neatlogs evals exports resume [options] <evaluation-id> <job-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `run-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--wait` | Optional option | poll this existing handle until completed, failed or cancelled | — |
+| `--timeout-seconds <seconds>` | Optional option | wait budget, 1-3000 seconds | 3000 |
-## `neatlogs detections trends <detection-id>`
+## `neatlogs evals exports status <evaluation-id> <job-id>`
 No additional description.
-Usage: `neatlogs detections trends [options] <detection-id>`
+Usage: `neatlogs evals exports status [options] <evaluation-id> <job-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
+| `job-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--from <timestamp>` | Required option | inclusive UTC start timestamp | — |
-| `--to <timestamp>` | Required option | exclusive UTC end timestamp | — |
-| `--granularity <value>` | Optional option | hour, day, or week | day |
+| `--wait` | Optional option | poll this existing handle until completed, failed or cancelled | — |
+| `--timeout-seconds <seconds>` | Optional option | wait budget, 1-3000 seconds | 3000 |
-## `neatlogs detections update <detection-id>`
+## `neatlogs evals form generate <evaluation-id>`
-No additional description.
+generate an AI question preview without saving the form
-Usage: `neatlogs detections update [options] <detection-id>`
+Usage: `neatlogs evals form generate [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `detection-id` | Required argument | — | — |
+| `evaluation-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--group <uuid>` | Optional option | new detection group UUID | — |
-| `--name <name>` | Optional option | new display name | — |
-| `--description <text>` | Optional option | new description | — |
-| `--clear-description` | Optional option | set description to null | — |
-| `--threshold <number>` | Optional option | flag threshold from 0 through 1 | — |
-| `--config <json>` | Optional option | type-specific JSON configuration | — |
-| `--run-on <json>` | Optional option | bounded run-on JSON configuration | — |
-| `--batch-fields <json>` | Optional option | JSON array of span element fields | — |
-| `--clear-batch-fields` | Optional option | set batch fields to null | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+| `--body-stdin` | Required option | read prompt and optional questionCount from stdin | — |
-## `neatlogs evals activate <evaluation-id>`
+## `neatlogs evals form get <evaluation-id>`
-activate an owned evaluation for existing project reviewers
+No additional description.
-Usage: `neatlogs evals activate [options] <evaluation-id>`
+Usage: `neatlogs evals form get [options] <evaluation-id>`
 ### Arguments
@@ -1706,75 +3450,64 @@ Usage: `neatlogs evals activate [options] <evaluation-id>`
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--body-stdin` | Required option | read reviewer IDs, duration and bounds as JSON | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same activation | — |
+None.
-## `neatlogs evals assignments list <evaluation-id> <item-id>`
+## `neatlogs evals form management <evaluation-id>`
-No additional description.
+read the owned form version and reviewer-specific question routing
-Usage: `neatlogs evals assignments list [options] <evaluation-id> <item-id>`
+Usage: `neatlogs evals form management [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `item-id` | Required argument | — | — |
 ### Options
 None.
-## `neatlogs evals batches close <evaluation-id> <batch-id>`
+## `neatlogs evals form set <evaluation-id>`
-No additional description.
+replace a draft form or the future form of an active recurring evaluation
-Usage: `neatlogs evals batches close [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals form set [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <batch-id>` | Required option | repeat the exact batch UUID to confirm closure | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same closure | — |
+| `--body-stdin` | Required option | read the bounded evaluation form JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical form replacement | — |
-## `neatlogs evals batches cube <evaluation-id> <batch-id>`
+## `neatlogs evals generate-metadata`
-No additional description.
+generate an evaluation name and description without creating it
-Usage: `neatlogs evals batches cube [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals generate-metadata [options]`
 ### Arguments
-| Argument | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
+None.
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-100) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--body-stdin` | Required option | read questions, evaluator names and bounded selection context | — |
-## `neatlogs evals batches dispatch <evaluation-id>`
+## `neatlogs evals get <evaluation-id>`
 No additional description.
-Usage: `neatlogs evals batches dispatch [options] <evaluation-id>`
+Usage: `neatlogs evals get [options] <evaluation-id>`
 ### Arguments
@@ -1784,53 +3517,51 @@ Usage: `neatlogs evals batches dispatch [options] <evaluation-id>`
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--max-items <number>` | Required option | acknowledged queued item ceiling (1-1000) | — |
-| `--max-assignments <number>` | Required option | acknowledged assignment ceiling (1-10000) | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same dispatch | — |
+None.
-## `neatlogs evals batches export-report <evaluation-id> <batch-id>`
+## `neatlogs evals guest-invitations <evaluation-id>`
-No additional description.
+read queued/provider-accepted guest invitation states as the creator
-Usage: `neatlogs evals batches export-report [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals guest-invitations [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--output <path>` | Optional option | create a private JSON file; use - or omit for stdout | — |
+| `--cursor <cursor>` | Optional option | opaque cursor from the previous page | — |
+| `--limit <number>` | Optional option | invitations per page (1-100, default 25) | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals batches get <evaluation-id> <batch-id>`
+## `neatlogs evals items get <evaluation-id> <item-id>`
 No additional description.
-Usage: `neatlogs evals batches get [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals items get [options] <evaluation-id> <item-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
 ### Options
 None.
-## `neatlogs evals batches list <evaluation-id>`
+## `neatlogs evals items list <evaluation-id>`
 No additional description.
-Usage: `neatlogs evals batches list [options] <evaluation-id>`
+Usage: `neatlogs evals items list [options] <evaluation-id>`
 ### Arguments
@@ -1847,45 +3578,51 @@ Usage: `neatlogs evals batches list [options] <evaluation-id>`
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals batches report <evaluation-id> <batch-id>`
+## `neatlogs evals launch <evaluation-id>`
 No additional description.
-Usage: `neatlogs evals batches report [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals launch [options] <evaluation-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--assign-me` | Optional option | assign every evaluation item to the current user | — |
+| `--review-duration <duration>` | Optional option | review window (1h-8760h, 1d-365d, or 1w-52w) | 7d |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical launch | — |
-## `neatlogs evals batches summary <evaluation-id> <batch-id>`
+## `neatlogs evals list`
 No additional description.
-Usage: `neatlogs evals batches summary [options] <evaluation-id> <batch-id>`
+Usage: `neatlogs evals list [options]`
 ### Arguments
-| Argument | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-| `batch-id` | Required argument | — | — |
+None.
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
+| `--limit <number>` | Optional option | page size (1-100) | — |
+| `--status <status>` | Optional option | draft, active, completed, archived, or all | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals close <evaluation-id>`
+## `neatlogs evals progress <evaluation-id>`
-close an active evaluation
+No additional description.
-Usage: `neatlogs evals close [options] <evaluation-id>`
+Usage: `neatlogs evals progress [options] <evaluation-id>`
 ### Arguments
@@ -1895,76 +3632,74 @@ Usage: `neatlogs evals close [options] <evaluation-id>`
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--confirm <evaluation-id>` | Required option | repeat the exact evaluation UUID to confirm closure | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical closure | — |
+None.
-## `neatlogs evals cohort add <evaluation-id>`
+## `neatlogs evals remove-reviewer <evaluation-id> <reviewer-id>`
-No additional description.
+remove a current reviewer; recurring batch snapshots are preserved
-Usage: `neatlogs evals cohort add [options] <evaluation-id>`
+Usage: `neatlogs evals remove-reviewer [options] <evaluation-id> <reviewer-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `reviewer-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded cohort mutation JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable UUID when retrying the same logical mutation | — |
+| `--confirm <reviewer-id>` | Required option | confirm the exact reviewer assignment ID | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this removal | — |
-## `neatlogs evals cohort preview <evaluation-id>`
+## `neatlogs evals response <evaluation-id> <response-id>`
-No additional description.
+read full submitted answers with reviewer, item and saved question context
-Usage: `neatlogs evals cohort preview [options] <evaluation-id>`
+Usage: `neatlogs evals response [options] <evaluation-id> <response-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `response-id` | Required argument | — | — |
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded cohort preview JSON from stdin | — |
+None.
-## `neatlogs evals cohort remove <evaluation-id>`
+## `neatlogs evals response-insight <evaluation-id> <response-id> <question-id>`
-No additional description.
+read a submitted AI answer explanation using IDs from responses
-Usage: `neatlogs evals cohort remove [options] <evaluation-id>`
+Usage: `neatlogs evals response-insight [options] <evaluation-id> <response-id> <question-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `response-id` | Required argument | — | — |
+| `question-id` | Required argument | — | — |
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--request-stdin` | Required option | read the bounded cohort mutation JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable UUID when retrying the same logical mutation | — |
+None.
-## `neatlogs evals cohorts`
+## `neatlogs evals responses <evaluation-id>`
 No additional description.
-Usage: `neatlogs evals cohorts [options]`
+Usage: `neatlogs evals responses [options] <evaluation-id>`
 ### Arguments
-None.
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluation-id` | Required argument | — | — |
 ### Options
@@ -1975,103 +3710,93 @@ None.
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals create`
+## `neatlogs evals review draft <evaluation-id> <item-id>`
 No additional description.
-Usage: `neatlogs evals create [options]`
-### Arguments
-None.
-### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--body-stdin` | Required option | read the bounded evaluation JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical creation | — |
-## `neatlogs evals discard <evaluation-id>`
-permanently discard a never-launched evaluation draft
-Usage: `neatlogs evals discard [options] <evaluation-id>`
+Usage: `neatlogs evals review draft [options] <evaluation-id> <item-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--confirm <evaluation-id>` | Required option | repeat the exact evaluation UUID to confirm draft discard | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical draft discard | — |
+| `--body-stdin` | Required option | read the bounded answers JSON from stdin | — |
+| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable key when retrying the same logical mutation | — |
-## `neatlogs evals export <evaluation-id>`
+## `neatlogs evals review edit <evaluation-id> <item-id>`
 No additional description.
-Usage: `neatlogs evals export [options] <evaluation-id>`
+Usage: `neatlogs evals review edit [options] <evaluation-id> <item-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--from <timestamp>` | Required option | inclusive ISO 8601 start timestamp | — |
-| `--to <timestamp>` | Required option | exclusive ISO 8601 end timestamp | — |
-| `--limit <number>` | Optional option | maximum response rows (1-5000) | — |
-| `--output <path>` | Optional option | create a private JSON file; use - or omit for stdout | — |
+| `--body-stdin` | Required option | read the bounded answers JSON from stdin | — |
+| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable key when retrying the same logical mutation | — |
-## `neatlogs evals form get <evaluation-id>`
+## `neatlogs evals review get <evaluation-id> <item-id>`
 No additional description.
-Usage: `neatlogs evals form get [options] <evaluation-id>`
+Usage: `neatlogs evals review get [options] <evaluation-id> <item-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
-## `neatlogs evals form set <evaluation-id>`
+## `neatlogs evals review submit <evaluation-id> <item-id>`
 No additional description.
-Usage: `neatlogs evals form set [options] <evaluation-id>`
+Usage: `neatlogs evals review submit [options] <evaluation-id> <item-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `item-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--body-stdin` | Required option | read the bounded evaluation form JSON from stdin | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical form replacement | — |
+| `--body-stdin` | Required option | read the bounded answers JSON from stdin | — |
+| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
+| `--idempotency-key <key>` | Optional option | reuse a stable key when retrying the same logical mutation | — |
-## `neatlogs evals get <evaluation-id>`
+## `neatlogs evals reviewers <evaluation-id>`
-No additional description.
+list the current owned evaluation roster; batch snapshots are separate
-Usage: `neatlogs evals get [options] <evaluation-id>`
+Usage: `neatlogs evals reviewers [options] <evaluation-id>`
 ### Arguments
@@ -2081,71 +3806,71 @@ Usage: `neatlogs evals get [options] <evaluation-id>`
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--limit <number>` | Optional option | page size, 1 to 100 | — |
+| `--cursor <cursor>` | Optional option | continuation cursor | — |
+| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
+| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals items get <evaluation-id> <item-id>`
+## `neatlogs evals run-diagnostics <evaluation-id> <run-id>`
-No additional description.
+read safe persisted run status, timing, cost and tool counts
-Usage: `neatlogs evals items get [options] <evaluation-id> <item-id>`
+Usage: `neatlogs evals run-diagnostics [options] <evaluation-id> <run-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
-| `item-id` | Required argument | — | — |
+| `run-id` | Required argument | — | — |
 ### Options
 None.
-## `neatlogs evals items list <evaluation-id>`
+## `neatlogs evals run-trace <evaluation-id> <run-id>`
-No additional description.
+read bounded redacted replay steps, tool calls and results
-Usage: `neatlogs evals items list [options] <evaluation-id>`
+Usage: `neatlogs evals run-trace [options] <evaluation-id> <run-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
 | `evaluation-id` | Required argument | — | — |
+| `run-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-100) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--offset <number>` | Optional option | step offset (default 0) | — |
+| `--limit <number>` | Optional option | steps per page (1-100, default 25) | — |
-## `neatlogs evals launch <evaluation-id>`
+## `neatlogs evals schedules get <schedule-id>`
 No additional description.
-Usage: `neatlogs evals launch [options] <evaluation-id>`
+Usage: `neatlogs evals schedules get [options] <schedule-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
+| `schedule-id` | Required argument | — | — |
 ### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--assign-me` | Optional option | assign every evaluation item to the current user | — |
-| `--review-duration <duration>` | Optional option | review window (1h-8760h, 1d-365d, or 1w-52w) | 7d |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical launch | — |
+None.
-## `neatlogs evals list`
+## `neatlogs evals schedules list`
 No additional description.
-Usage: `neatlogs evals list [options]`
+Usage: `neatlogs evals schedules list [options]`
 ### Arguments
@@ -2161,125 +3886,98 @@ None.
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals progress <evaluation-id>`
-No additional description.
-Usage: `neatlogs evals progress [options] <evaluation-id>`
-### Arguments
-| Argument | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-### Options
-None.
-## `neatlogs evals responses <evaluation-id>`
+## `neatlogs evals schedules update <schedule-id>`
 No additional description.
-Usage: `neatlogs evals responses [options] <evaluation-id>`
+Usage: `neatlogs evals schedules update [options] <schedule-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
+| `schedule-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
-| `--limit <number>` | Optional option | page size (1-100) | — |
-| `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
-| `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+| `--batch-schedule <duration>` | Required option | recurrence duration from 1h to 8760h, 1d to 365d, or 1w to 52w | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical schedule update | — |
-## `neatlogs evals review draft <evaluation-id> <item-id>`
+## `neatlogs evals stats`
 No additional description.
-Usage: `neatlogs evals review draft [options] <evaluation-id> <item-id>`
+Usage: `neatlogs evals stats [options]`
 ### Arguments
-| Argument | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-| `item-id` | Required argument | — | — |
+None.
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--body-stdin` | Required option | read the bounded answers JSON from stdin | — |
-| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable key when retrying the same logical mutation | — |
+| `--period <period>` | Optional option | 24h, 7d, 30d, 90d, or all | — |
-## `neatlogs evals review get <evaluation-id> <item-id>`
+## `neatlogs evals templates create`
 No additional description.
-Usage: `neatlogs evals review get [options] <evaluation-id> <item-id>`
+Usage: `neatlogs evals templates create [options]`
 ### Arguments
-| Argument | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-| `item-id` | Required argument | — | — |
+None.
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
+| `--body-stdin` | Required option | read the bounded template JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this creation | — |
-## `neatlogs evals review submit <evaluation-id> <item-id>`
+## `neatlogs evals templates delete <template-id>`
 No additional description.
-Usage: `neatlogs evals review submit [options] <evaluation-id> <item-id>`
+Usage: `neatlogs evals templates delete [options] <template-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `evaluation-id` | Required argument | — | — |
-| `item-id` | Required argument | — | — |
+| `template-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--body-stdin` | Required option | read the bounded answers JSON from stdin | — |
-| `--assignment-id <assignment-id>` | Optional option | select one of multiple reviewer assignments | — |
-| `--idempotency-key <key>` | Optional option | reuse a stable key when retrying the same logical mutation | — |
+| `--confirm <template-id>` | Optional option | repeat the exact template ID | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this deletion | — |
-## `neatlogs evals schedules get <schedule-id>`
+## `neatlogs evals templates get <template-id>`
 No additional description.
-Usage: `neatlogs evals schedules get [options] <schedule-id>`
+Usage: `neatlogs evals templates get [options] <template-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `schedule-id` | Required argument | — | — |
+| `template-id` | Required argument | — | — |
 ### Options
 None.
-## `neatlogs evals schedules list`
+## `neatlogs evals templates list`
 No additional description.
-Usage: `neatlogs evals schedules list [options]`
+Usage: `neatlogs evals templates list [options]`
 ### Arguments
@@ -2291,44 +3989,27 @@ None.
 | --- | --- | --- | --- |
 | `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
-| `--status <status>` | Optional option | draft, active, completed, archived, or all | — |
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
-## `neatlogs evals schedules update <schedule-id>`
+## `neatlogs evals templates update <template-id>`
 No additional description.
-Usage: `neatlogs evals schedules update [options] <schedule-id>`
+Usage: `neatlogs evals templates update [options] <template-id>`
 ### Arguments
 | Argument | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `schedule-id` | Required argument | — | — |
-### Options
-| Option | Requirement | Description | Default |
-| --- | --- | --- | --- |
-| `--batch-schedule <duration>` | Required option | recurrence duration from 1h to 8760h, 1d to 365d, or 1w to 52w | — |
-| `--idempotency-key <key>` | Optional option | stable UUID for retrying the same logical schedule update | — |
-## `neatlogs evals stats`
-No additional description.
-Usage: `neatlogs evals stats [options]`
-### Arguments
-None.
+| `template-id` | Required argument | — | — |
 ### Options
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
-| `--period <period>` | Optional option | 24h, 7d, 30d, 90d, or all | — |
+| `--body-stdin` | Required option | read the bounded template patch from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this update | — |
 ## `neatlogs evals update <evaluation-id>`
@@ -2434,7 +4115,7 @@ None.
 | --- | --- | --- | --- |
 | `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
-| `--type <type>` | Optional option | llm_judge or agent_judge | — |
+| `--type <type>` | Optional option | llm_judge, agent_judge or code | — |
 | `--include-archived` | Optional option | include archived evaluator definitions | — |
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
@@ -2455,6 +4136,7 @@ Usage: `neatlogs evaluators playground [options] <evaluator-id>`
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
+| `--explanations` | Optional option | include bounded verdict reasoning and evidence | — |
 | `--request-stdin` | Required option | read the bounded evaluator playground request JSON from stdin | — |
 ## `neatlogs evaluators preview`
@@ -2471,6 +4153,7 @@ None.
 | Option | Requirement | Description | Default |
 | --- | --- | --- | --- |
+| `--explanations` | Optional option | include bounded verdict reasoning and evidence | — |
 | `--request-stdin` | Required option | read the bounded evaluator preview request JSON from stdin | — |
 ## `neatlogs evaluators restore <evaluator-id>`
@@ -2545,7 +4228,9 @@ Usage: `neatlogs evaluators run-status [options] <evaluator-id> <run-id>`
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--explanations` | Optional option | include bounded verdict reasoning and evidence | — |
 ## `neatlogs evaluators runs <evaluator-id>`
@@ -2565,9 +4250,29 @@ Usage: `neatlogs evaluators runs [options] <evaluator-id>`
 | --- | --- | --- | --- |
 | `--cursor <cursor>` | Optional option | opaque cursor returned by the previous page | — |
 | `--limit <number>` | Optional option | page size (1-100) | — |
+| `--kind <kind>` | Optional option | campaign (default), standalone or all; standalone requires OAuth | — |
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs evaluators set-skills <evaluator-id>`
+replace ordered immutable skill pins; an empty list removes all
+Usage: `neatlogs evaluators set-skills [options] <evaluator-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `evaluator-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | JSON with skills containing skillVersionId and optional position | — |
+| `--idempotency-key <key>` | Optional option | — | — |
 ## `neatlogs evaluators skills <evaluator-id>`
 No additional description.
@@ -2603,6 +4308,22 @@ Usage: `neatlogs evaluators update [options] <evaluator-id>`
 | `--body-stdin` | Required option | read the bounded evaluator patch from stdin | — |
 | `--idempotency-key <key>` | Optional option | stable UUID for retrying this update | — |
+## `neatlogs evaluators validate-code`
+No additional description.
+Usage: `neatlogs evaluators validate-code [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read language and source JSON from stdin | — |
 ## `neatlogs feedback bulk`
 No additional description.
@@ -3047,6 +4768,25 @@ None.
 | `--request-stdin` | Required option | read one bounded guest-link bulk revoke request from stdin | — |
 | `--idempotency-key <key>` | Optional option | stable UUID for retrying this mutation | — |
+## `neatlogs guest-links deliver <guest-link-id>`
+email an existing guest link to its bound recipient
+Usage: `neatlogs guest-links deliver [options] <guest-link-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `guest-link-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--body-stdin` | Required option | JSON with the previously minted token; never put it in command arguments | — |
+| `--idempotency-key <key>` | Optional option | — | — |
 ## `neatlogs guest-links export`
 No additional description.
@@ -3423,6 +5163,23 @@ None.
 | `--request-stdin` | Required option | read the incident snapshot JSON from stdin | — |
 | `--idempotency-key <key>` | Optional option | stable UUID for retrying this snapshot | — |
+## `neatlogs incidents publish-review`
+publish a scoped coordinated review as a service account
+Usage: `neatlogs incidents publish-review [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--request-stdin` | Required option | read the review JSON from stdin | — |
+| `--idempotency-key <key>` | Optional option | stable UUID for retrying this review | — |
 ## `neatlogs ingest-credentials create`
 No additional description.
@@ -3828,6 +5585,85 @@ None.
 | `--all` | Optional option | follow cursors for this list command (requires --max-items) | — |
 | `--max-items <number>` | Optional option | maximum items to collect with --all (1-1000) | — |
+## `neatlogs mcp login`
+No additional description.
+Usage: `neatlogs mcp login [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--endpoint <url>` | Required option | — | — |
+| `--issuer <url>` | Required option | — | — |
+| `--client-id <id>` | Required option | registered MCP client with loopback redirects enabled | — |
+| `--scope <scope...>` | Optional option | requested OAuth scopes | ["context:read","organization:read","billing:read","profile:read","observability:read","evaluation:read","configuration:read","sharing:read","access:read","offline_access"] |
+| `--allow-file-custody` | Optional option | allow protected-file credentials if keyring is unavailable | — |
+## `neatlogs mcp logout`
+revoke this MCP binding's stored OAuth session, then remove its local credential
+Usage: `neatlogs mcp logout [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--endpoint <url>` | Required option | registered regional /mcp/user resource | — |
+| `--issuer <url>` | Required option | — | — |
+| `--client-id <id>` | Required option | — | — |
+| `--allow-file-custody` | Optional option | explicitly permit the binding's protected-file credential store | — |
+## `neatlogs mcp proxy`
+No additional description.
+Usage: `neatlogs mcp proxy [options]`
+### Arguments
+None.
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--endpoint <url>` | Required option | registered regional /mcp/user resource | — |
+| `--issuer <url>` | Required option | — | — |
+| `--client-id <id>` | Required option | — | — |
+| `--allow-file-custody` | Optional option | explicitly use private files instead of the native keyring | — |
+## `neatlogs mcp reveal <invocation-id>`
+No additional description.
+Usage: `neatlogs mcp reveal [options] <invocation-id>`
+### Arguments
+| Argument | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `invocation-id` | Required argument | — | — |
+### Options
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--endpoint <url>` | Required option | — | — |
+| `--issuer <url>` | Required option | — | — |
+| `--client-id <id>` | Required option | — | — |
+| `--allow-file-custody` | Optional option | use the explicitly selected private-file store | — |
 ## `neatlogs mcp status`
 No additional description.
@@ -4838,7 +6674,14 @@ None.
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--account` | Optional option | account-only discovery without a project (live catalog v2) | — |
+| `--service-account <uuid>` | Optional option | service-account resource target for live catalog v2 | — |
+| `--service-account-token <uuid>` | Optional option | token resource target for catalog v3 | — |
+| `--organization <uuid>` | Optional option | organization target for live catalog v2/v3 | — |
+| `--catalog-version <version>` | Optional option | runtime reads (1 or 2), definitions (3), canonical execution (4) | 1 |
+| `--live` | Optional option | discover enabled reads from the authenticated host | — |
 ## `neatlogs schema search <query>`
@@ -4854,7 +6697,14 @@ Usage: `neatlogs schema search [options] <query>`
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--account` | Optional option | account-only discovery without a project (live catalog v2) | — |
+| `--service-account <uuid>` | Optional option | service-account resource target for live catalog v2 | — |
+| `--service-account-token <uuid>` | Optional option | token resource target for catalog v3 | — |
+| `--organization <uuid>` | Optional option | organization target for live catalog v2/v3 | — |
+| `--catalog-version <version>` | Optional option | runtime reads (1 or 2), definitions (3), canonical execution (4) | 1 |
+| `--live` | Optional option | search the fresh authenticated read catalog | — |
 ## `neatlogs schema show <operationId>`
@@ -4870,7 +6720,14 @@ Usage: `neatlogs schema show [options] <operationId>`
 ### Options
-None.
+| Option | Requirement | Description | Default |
+| --- | --- | --- | --- |
+| `--account` | Optional option | account-only discovery without a project (live catalog v2) | — |
+| `--service-account <uuid>` | Optional option | service-account resource target for live catalog v2 | — |
+| `--service-account-token <uuid>` | Optional option | token resource target for catalog v3 | — |
+| `--organization <uuid>` | Optional option | organization target for live catalog v2/v3 | — |
+| `--catalog-version <version>` | Optional option | runtime reads (1 or 2), definitions (3), canonical execution (4) | 1 |
+| `--live` | Optional option | inspect the fresh authenticated read descriptor | — |
 ## `neatlogs service-accounts audit list <service-account-id>`