Console & fleet

Incidents and audit in the console

In cloud mode every quarantine and audit entry is reported to the console as a decision record. This page lists what each record carries: its fields, the status it moves through, the outcome of a held change, and the fidelity of the stored diff.

~7 min read · Console & fleet

This is a cloud-mode capability. A private device records the same decisions locally but reports nothing; see cloud or private.

The decision record

Each incident is one record. These are its core fields:

FieldMeaningValues
pathThe file that changedPath only, never content
reasonA short reason string for the outcomeText, length-capped
dangerThe graded danger value, when numericA number, or absent
threatLevelSeverity tierlow, medium, high
categoryThe attack category, when setFrom a fixed taxonomy
redactedDiffThe judged change, redacted and added-onlyCapped projection, never full content
originalHashHash of the file before the changeSHA-256
platform, displayNameThe device the incident came fromCopied onto the record so it survives device deletion
The redactedDiff is a projection, not the file: added lines only, secrets and PII replaced, size-capped. Removed-line text never leaves the device.

Status: the review lifecycle

The status tracks a case from report to resolution:

StatusMeaning
pendingReported, waiting for a decision
supersededReplaced by a newer case on the same path
approvedThe reviewer released the change
discardedThe reviewer rejected the change
appliedThe device confirmed an approved change was applied
staleApproved, but the file had changed in the meantime
expiredThe quarantine blob passed its retention window and was deleted; the case is no longer restorable
A resolution is a two-step handshake: a reviewer approves or discards, then the device confirms the result back as applied or stale.

Kept candidates

A special status marks a middle-band change the user kept on the device:

  • kept_candidate: a user confirmation-prompt change the human chose to keep.
  • No review case: there is no quarantine blob and no restore or discard. The kept content becomes the new reference point and is recorded as approved by a human, visible in the console.
  • Training candidate: it is recorded as a false-alarm candidate, not a case to action.

Outcomes of a held change

For a change that went through the user confirmation-prompt hold, the outcome names how it ended:

OutcomeMeaning
keptThe human kept the change; recorded as a false-alarm candidate
rejectedThe human rejected it; the change was rolled back
timed_outThe answer deadline elapsed; the change was rolled back
cappedThe absolute hold limit elapsed; the change was rolled back
Outcome and status are two axes: the status is the review lifecycle of a reported case, the outcome is how a held change ended. Every path that is not an explicit keep rolls the change back.

Diff fidelity

A fidelity marker records whether the stored diff is byte-faithful to what was judged:

diffFidelityMeaning
exactThe stored text hashes to the judged text: byte-faithful evidence
projectionThe stored text is provably a reduced projection of the judged text
absentNo judged-text hash was reported: not treated as verified
There is deliberately no default to exact: a record from an older device without a hash appears as unverified, never as byte-faithful.

Feedback candidates

A reviewer can attach an after-the-fact judgment to an incident:

  • feedbackCandidate: set when a reviewer records a verdict, attack or legitimate, on an incident.
  • No device action: feedback does not change the status and triggers nothing on the device.
  • Training signal, not truth: it marks the incident as a candidate for the improvement pipeline, gated by diff fidelity.

Why a private device shows none of this: cloud or private. The bytes behind redactedDiff: what Cloud mode sends. How long a case is kept and when it turns expired: storage, retention and cleanup.

Was this helpful?

Every decision, on the record.

Path, reason, threat level and a reversible outcome, per incident, reviewable in the console. Free for Linux, macOS and Windows.

Sign me up