Skip to main content

Documentation Index

Fetch the complete documentation index at: https://wuweism.com/llms.txt

Use this file to discover all available pages before exploring further.

Every time Wu-Weism produces a hypothesis, observation, or counterfactual finding, it writes a record to the Claim Ledger — automatically, without any action on your part. This page explains what that record contains, how to navigate and filter your claims, and how to export them.

​
The Claim Ledger

The Claim Ledger is a persistent, append-only log of every claim produced during your sessions. You cannot silently overwrite or discard a claim — you can only reconcile it with newer evidence. This design ensures that your reasoning trail is always auditable, even when your conclusions change.
The Claim Ledger records claims from all three Wu-Weism surfaces: Causal Workbench, Hybrid Synthesis, and Legal Causation. Each claim carries a source_feature field so you always know where it originated.
To open the Claim Ledger, navigate to /claims in the workbench. Claims are shown in reverse chronological order by default.

​
Claim structure

Each claim in the ledger exposes the following fields. 
{
  "id": "clm_01j9k2rz4m8xp7qw3n5vb6",
  "claim_text": "Increasing advertising spend by 20% in Q3 would have increased revenue by 8–12%, holding production costs constant.",
  "claim_kind": "counterfactual",
  "status": "active",
  "confidence_score": 0.74,
  "uncertainty_label": "medium",
  "source_feature": "chat",
  "trace_id": "trc_9xm2pq7kl4rz8w1n3v5b",
  "session_id": "ses_4kw9l2pz7m1xqr3n5v8b",
  "evidence_links": [
    { "type": "pdf", "ref": "smith2021_advertising_elasticity.pdf" },
    { "type": "web", "ref": "https://example.com/study" }
  ],
  "gate_decisions": [
    {
      "gateName": "falsifiability",
      "decision": "pass",
      "rationale": "Claim specifies measurable outcome (revenue %) and a testable intervention (ad spend %).",
      "score": 0.91
    },
    {
      "gateName": "identifiability",
      "decision": "pass",
      "rationale": "Causal effect is identifiable given the provided confounder adjustment set.",
      "score": 0.88
    }
  ],
  "created_at": "2026-03-14T11:42:07Z"
}

​
Field reference

FieldDescription
claim_textThe full hypothesis, observation, or finding as a natural-language statement.
claim_kindOne of hypothesis, observation, or counterfactual. Reflects where on Pearl’s causal ladder the claim sits.
statusactive means the claim stands. reconciled means newer evidence has updated or superseded it.
confidence_scoreA value from 0.0 to 1.0 representing the model’s confidence in the claim given available evidence and the SCM structure.
uncertainty_labelA human-readable summary of confidence: low (score < 0.4), medium (0.4–0.74), or high (≥ 0.75).
source_featureThe surface that produced the claim: chat (Causal Workbench), hybrid (Hybrid Synthesis), or legal (Legal Causation).
trace_idLinks this claim to the counterfactual trace that produced it. Follow this ID in Provenance to see the full reasoning chain.
session_idThe workbench session that produced this claim. Use this to group all claims from a single research session.
evidence_linksThe sources backing the claim — PDFs you uploaded, company data, or web sources extracted during analysis.
gate_decisionsThe pass/fail outcomes of the falsifiability, identifiability, and novelty gates for this claim. See The Falsifiability Gate.

​
Navigating your claims

Open /claims in the workbench to see your full claim history. Each row shows the claim text, kind, status, confidence score, and source.

​
Filtering by source

Use the Source filter to narrow claims by the surface that produced them:
  • Chat — claims from structured causal dialogue sessions in the Causal Workbench.
  • Hybrid — claims from Hybrid Synthesis multi-document analysis.
  • Legal — claims from Legal Causation sessions.

​
Filtering by session

If you want to review all claims from a single research session, use the Session filter or pass a sessionId query parameter to the API (see Exporting claims below).

​
Filtering by status

Toggle the Status filter to show only active claims, or include reconciled ones to see the full history including superseded findings.

​
Claim reconciliation

When new evidence challenges a previous claim — for example, a new PDF upload contradicts an earlier finding — Wu-Weism can flag the drift.
1

New evidence is processed

You upload a new document or run a new analysis that produces a claim conflicting with an existing active claim.
2

Drift is detected

Wu-Weism compares the new claim against existing active claims in the same session. If the new claim materially contradicts an earlier one, both claims are annotated with a drift warning.
3

You review and reconcile

In the Claim Ledger, claims flagged for drift appear with a Reconcile prompt. You can mark the older claim as reconciled, which preserves it in the ledger but marks it as superseded by the newer finding.
4

Ledger is updated

The reconciled claim retains its original record (including its original confidence score and evidence links) alongside a reference to the claim that superseded it. Nothing is deleted.
Reconciliation changes a claim’s status to reconciled but never deletes the original record. Your audit trail is always complete.

​
Exporting claims

Retrieve claims programmatically via the REST API. 
GET /api/claims

​
Query parameters

ParameterTypeDescription
limitintegerNumber of claims to return. Range: 1–100. Default: 20.
sourceFeaturestringFilter by source: chat, hybrid, or legal.
sessionIdstringReturn only claims from a specific session.
traceIdstringReturn only claims linked to a specific counterfactual trace.

​
Example request

curl -X GET "https://wuweism.com/api/claims?sourceFeature=hybrid&limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Example response

{
  "claims": [
    {
      "id": "clm_01j9k2rz4m8xp7qw3n5vb6",
      "source_feature": "hybrid",
      "claim_kind": "hypothesis",
      "status": "active",
      "confidence_score": 0.82,
      "uncertainty_label": "high",
      "trace_id": "trc_9xm2pq7kl4rz8w1n3v5b",
      "session_id": "ses_4kw9l2pz7m1xqr3n5v8b",
      "created_at": "2026-03-14T11:42:07Z"
    }
  ],
  "total": 1
}
The GET /api/claims endpoint returns: id, source_feature, claim_kind, status, confidence_score, uncertainty_label, trace_id, session_id, and created_at. To retrieve full claim detail including claim_text, evidence_links, and gate_decisions, fetch an individual claim by ID.
Yes. Omit the sessionId parameter to retrieve claims across all sessions, subject to the limit. For large exports, paginate using the limit parameter and filter by created_at on your side.
No. The Claim Ledger is append-only. You can reconcile a claim (marking it as reconciled) but you cannot delete records. This preserves the integrity of your audit trail.
Claims are scoped to your account. Session isolation and team-level sharing depend on your plan configuration. Contact support for workspace sharing options.

​
Related

Provenance and audit trails

Understand how every claim traces back to its SCM model, intervention, and evidence sources.

The Falsifiability Gate

Learn how Wu-Weism evaluates whether your claims are scientifically valid before recording them.