List recent emitted findings across all runs

v1.0.0

Return the team's recently emitted scout findings across every run, newest first — the cross-run counterpart to the per-run emissions action. Each row carries its run_id, so you can regroup by run without first listing runs and fanning out one emissions call each. Pass skill_name to scope to a single scout, and date_from / date_to (a half-open window on emitted_at) to bound or paginate — set date_to to the oldest emission's emitted_at to walk back past the limit. Pure Postgres, no ClickHouse round-trip. Capped at 200 rows (default 50).

Input

{
  "type": "object",
  "properties": {
    "date_from": {
      "type": "string",
      "format": "date-time"
    },
    "date_to": {
      "type": "string",
      "format": "date-time"
    },
    "limit": {
      "type": "integer"
    },
    "project_id": {
      "type": "string"
    },
    "skill_name": {
      "type": "string"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false
}

Output

{
  "type": "array",
  "items": {
    "type": "object",
    "description": "One finding a scout run emitted to the inbox — the persisted, queryable record of\n*what* the run surfaced, returned by `scout-runs-emissions-list`. The emitted text\nlives in `description`; `source_id` is the join key (`run:<run_id>:finding:<finding_id>`)\nback into the underlying signal store.",
    "required": [
      "confidence",
      "description",
      "emitted_at",
      "finding_id",
      "id",
      "run_id",
      "severity",
      "source_id",
      "tags",
      "weight"
    ],
    "properties": {
      "confidence": {
        "type": "number",
        "format": "double",
        "description": "Agent's confidence the finding is real in [0, 1]."
      },
      "description": {
        "type": "string",
        "description": "The emitted finding prose — the signal's `description` as surfaced to the inbox."
      },
      "emitted_at": {
        "type": "string",
        "format": "date-time",
        "description": "ISO-8601 timestamp the finding was emitted."
      },
      "finding_id": {
        "type": "string",
        "description": "Stable id the finding was emitted under; matches an entry in the run's `emitted_finding_ids`."
      },
      "id": {
        "type": "string",
        "format": "uuid"
      },
      "run_id": {
        "type": "string",
        "description": "UUID of the `SignalScoutRun` that emitted this finding."
      },
      "severity": {
        "description": "Optional severity tag — one of P0, P1, P2, P3, P4 — or null if the run didn't set one.\n\n* `P0` - P0\n* `P1` - P1\n* `P2` - P2\n* `P3` - P3\n* `P4` - P4",
        "type": "object"
      },
      "source_id": {
        "type": "string",
        "description": "Deterministic `run:<run_id>:finding:<finding_id>` — the join key into the underlying signal store."
      },
      "tags": {
        "type": "array",
        "description": "Slug tags the scout attached to this finding (lowercase kebab-case, e.g. `cost-spike`). Empty list when the run set none.",
        "items": {
          "type": "string"
        }
      },
      "weight": {
        "type": "number",
        "format": "double",
        "description": "Agent's weight for the signal in [0, 1]. Drives ranking in the inbox."
      }
    }
  }
}