Skip to content
SHAMPOO

Tool catalogue

deliberate_settle

Write · Ordinary · Intel and knowledge tiers

deliberate_settle

  • Category: intel
  • Access: write
  • Audience: ordinary (an ordinary user normally calls this directly)

Purpose

Settle a deliberation with a decision (optionally mints a claim).

Arguments

Required: deliberation_id, decision.

Optional: locale, mint_claim, rationale.

  • deliberation_id. Note: Target deliberation.
  • decision. Note: Required decision text.
  • locale.
  • mint_claim. Note: Mint a backing chunk + candidate claim (default false).
  • rationale. Note: Optional rationale.

Result

JSON object with deliberation_id, status settled and optional claim_id.

Boundaries

Thinker-private: owner credential only, no star bypass. Misses and foreign rows read as not found.

Lifecycle / side effects

Open -> settled (+optional outcome) -> archived; lifecycle only, never physical DELETE.

Errors

Bad ids/transitions rejected. Failures move nothing (atomic).

Example

{
  "decision": "Ship Friday",
  "deliberation_id": "..."
}

Result shape:

{
  "status": "settled"
}

See also

deliberate_outcome, deliberate_archive.

On this page