extract_candidate_claims

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

Purpose

Extracts typed subject-predicate-object-scope claims from a context chunk. Call it on enrichable chunks to stage governance candidates; nothing becomes canonical until promote_candidate.

Arguments

Required: chunk_ref.

Optional: scope_hint.

chunk_ref.
scope_hint. Note: Overrides scope detection; one of memory, bridge, mapping, validation, export.

Result

Object with chunk_id, claims_extracted count, scope, and claims array (claim_id, subject, predicate, object, scope, confidence, requires_human). Predicates come from uses, depends_on, is, requires, produces, validates, contains, replaces.

Boundaries

Operates inside the selected profile boundary. Only enrichable or uncertain chunks qualify; all other states answer blocked.

Lifecycle / side effects

Persists one candidate claim plus its source-chunk evidence and provenance per extracted triple, with a history event each, then a run-history entry. All-or-nothing per call.

Errors

Missing chunk_ref rejected by validation. Unknown chunk returns not-found. Non-enrichable states return an invalid-state error naming the current state.

Example

{
  "chunk_ref": "<uuid>"
}

Result shape:

{
  "chunk_id": "<uuid>",
  "claims": [
    {
      "claim_id": "<uuid>",
      "confidence": 0.7,
      "object": "validation",
      "predicate": "validates",
      "scope": "memory",
      "subject": "pack builder"
    }
  ],
  "claims_extracted": 1,
  "scope": "memory"
}