Skip to content

Triage Orchestrator

SecOpsAI includes a native triage orchestrator that can investigate open findings, auto-apply low-risk dispositions, and queue higher-risk actions for analyst confirmation.

What It Automates

The orchestrator can:

  • fetch open findings from the local SOC store
  • move findings to in_review
  • run the native investigation workflow
  • auto-close low-risk cases such as expected_behavior
  • auto-close already-allowlisted false positives
  • queue actions that require human approval
  • write JSON and Markdown run summaries

It does not silently change broad policy by default.

Core Commands

Review a single run across open findings:

secopsai triage orchestrate --search-root ~/secopsai

Inspect queued actions:

secopsai triage queue

Apply a queued action after review:

secopsai triage apply-action ACT-0001 --yes

Generate a compact current-state summary:

secopsai triage summary

Action Model

The orchestrator uses a guarded action model.

Auto-applied by default:

  • move finding to in_review
  • close as expected_behavior
  • close as false_positive when the package is already allowlisted

Queued for analyst action:

  • add a package to the allowlist
  • tune rule weights
  • disable or enable rules
  • tune thresholds
  • close as needs_review
  • close as tune_policy

Configuration

Default policy lives in:

  • config/triage_orchestrator.toml

Current knobs:

  • safety.auto_close_expected_behavior
  • safety.auto_close_allowlisted_false_positive
  • safety.auto_start_in_review
  • safety.reconcile_on_policy_change
  • limits.max_findings_per_run

Scheduled Operation

Use the provided helpers for unattended runs:

bash scripts/run_triage_orchestrator.sh
bash scripts/install_triage_orchestrator_launchd.sh

The runner executes the orchestrator, writes queue state, and emits reports under:

  • reports/triage/orchestrator/
  1. Run detection and correlation:
secopsai refresh
secopsai correlate
  1. Let the orchestrator process the open queue:
secopsai triage orchestrate --search-root ~/secopsai
  1. Review any queued actions:
secopsai triage queue
  1. Apply the specific changes you approve:
secopsai triage apply-action ACT-0001 --yes