Build the application

## Build
Evaluate BODS v0.4 beneficial ownership statements to flag declared nominees lacking corresponding ultimate principal disclosures. Package anomalous equity chains into triage packets for enhanced due diligence.

## User
An investigator evidence redaction and disclosure packager with field-level mock disclosure policies.

## Workflow
1. Parse beneficial ownership statements formatted according to the BODS v0.4 JSON schema.
2. Scan entity relationship statements to identify registered nominees without linked principal declarations.
3. Compute total unallocated equity controlled by unresolved nominee vehicles.
4. Output an investigator triage card outlining flagged proxy nodes and missing disclosures.

## Interface
An interactive graph and discrepancy queue detailing corporate ownership chains and nominee disclosure flags.

## Data
Generate synthetic corporate ownership networks using the BODS v0.4 schema definitions and examples.
Starter examples below are synthetic. They are not downloaded records.

## Source
[Beneficial ownership modelling](https://standard.openownership.org/en/latest/standard/modelling/index.html)
Apply BODS v0.4 nominee arrangement modelling requirements and real-world identifier guidance from source 4.

## Tools
langgraph, pydantic, networkx.
LangGraph manages stateful traversal of recursive corporate control graphs and multi-step investigation flows.
Standard fast hosted model to summarize complex ownership topology via API.

## Deliverables
Submit runnable source, pinned dependencies, setup commands, a working interface, example outputs, and a recorded end-to-end demo. Include tests and an action log.

## Acceptance
- Validates input payloads against BODS v0.4 relationship statements.
- Detects registered nominees without linked principal declarations.
- Produces a structured investigation dossier isolating anomalous holding entities with missing disclosures.

## Starter Examples
```json
[
  {
    "input": {
      "target_entity": "entity-901",
      "statements": [
        {
          "statement_id": "st-1",
          "subject": "entity-901",
          "interested_party": "person-101",
          "interest_type": "shareholding",
          "share_exact": 75,
          "is_nominee": true
        }
      ]
    },
    "expected_output": {
      "target_entity": "entity-901",
      "nominee_flag": true,
      "unlinked_nominee_equity": 75,
      "triage_priority": "high",
      "summary": "Nominee shareholder detected controlling 75% interest without underlying natural principal. Note: these are simplified synthetic app records."
    }
  },
  {
    "input": {
      "target_entity": "entity-905",
      "statements": [
        {
          "statement_id": "st-9",
          "subject": "entity-905",
          "interested_party": "person-105",
          "interest_type": "shareholding",
          "share_exact": 100,
          "is_nominee": false
        }
      ]
    },
    "expected_output": {
      "target_entity": "entity-905",
      "nominee_flag": false,
      "unlinked_nominee_equity": 0,
      "triage_priority": "low",
      "summary": "Direct ownership transparently attributed to single natural person. Note: these are simplified synthetic app records."
    }
  }
]
```

## Safety
Simulates corporate ownership analysis on synthetic graph models without making legal determinations of wrongdoing.
Use mock external writes. Require human review before any real deployment.