assess_context

Category: intel
Access: write
Audience: advanced (ordinary users do not normally call this directly)

Purpose

Classifies one context chunk: scans signal markers, scores materiality and uncertainty, and advances its lifecycle state. Call it before extraction to make a chunk enrichable.

Arguments

Required: chunk_ref.

Optional: force, session_id.

chunk_ref.
force. Note: Re-assesses frozen chunks when true; without it frozen chunks return a blocked frozen payload.
session_id. Note: Attribution only; never authority.

Result

Object with chunk_id, state, previous_state, policy, materiality, uncertainty, should_skip, skip_reason, signals_detected, and annotations_created.

Boundaries

Operates inside the selected profile boundary. No conductor or project gate; unknown chunks answer as not-found with no existence oracle.

Lifecycle / side effects

Classifies signals, recomputes materiality/uncertainty, moves chunk state where the transition is legal, and records a run-history entry plus a history event on state change. Frozen and awaiting_human-skip paths still record the run entry.

Errors

Missing chunk_ref rejected by validation; unknown argument rejected. Unknown chunk returns a normal not-found error payload. Frozen chunks and unchanged awaiting_human sources return skip payloads, not errors.

Example

{
  "chunk_ref": "<uuid>"
}

Result shape:

{
  "materiality": 0.8,
  "policy": "manual",
  "previous_state": "no_enrich",
  "signals_detected": [
    "ENRICH_OK"
  ],
  "state": "enrichable",
  "uncertainty": 0.2
}