Build a BODS Jurisdictional Opacity and Layering Depth Evaluator — implementation

## Build
Measure corporate layering depth across multi-jurisdictional holding structures using BODS v0.4 data. Identify opaque disclosure regimes and formulate targeted evidence requests for entities lacking natural person resolution.

## User
Enhanced due diligence investigator

## Workflow
1. Ingest nested BODS v0.4 ownership statements representing multi-tier corporate hierarchies.
2. Calculate structural depth and flag offshore jurisdictions with non-public ownership registries.
3. Isolate ownership branches where beneficial owner identification terminates without reaching a natural person.
4. Formulate formal information request questionnaires for target entities in opaque regimes.

## Interface
Multi-tier hierarchy visualizer with node-specific risk tags and automated questionnaire generator panel.

## Data
Generate synthetic nested corporate graphs in BODS JSON format spanning multiple tax havens and holding tiers.
Starter examples below are synthetic. They are not downloaded records.

## Source
[Beneficial ownership modelling](https://standard.openownership.org/en/latest/standard/modelling/index.html)
Applies BODS v0.4 modeling requirements regarding real world identifiers and indirect beneficial ownership paths.

## Tools
pydantic-ai, fastapi, networkx.
Provides robust data validation for recursive ownership trees and guarantees schema conformity of evidence requests.
Local or hosted LLM to compose precise documentary request letters tailored to specific foreign jurisdictions.

## 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
- Traverses corporate holding chains up to ten layers deep to find terminal entities.
- Calculates cumulative effective interest through intermediate shareholding percentages.
- Flags opaque intermediary jurisdictions lacking public beneficial ownership registries.
- Produces structured JSON evidence request templates specifying required registry extracts.

## Starter Examples
```json
[
  {
    "input": {
      "root_entity": "Omega Trading PLC",
      "tree": [
        {
          "tier": 1,
          "entity": "Omega Trading PLC",
          "parent": "Seashell Capital Ltd",
          "share_pct": 100,
          "jurisdiction": "GB"
        },
        {
          "tier": 2,
          "entity": "Seashell Capital Ltd",
          "parent": "Tortola Trust Corp",
          "share_pct": 100,
          "jurisdiction": "VG"
        },
        {
          "tier": 3,
          "entity": "Tortola Trust Corp",
          "parent": null,
          "share_pct": 100,
          "jurisdiction": "VG"
        }
      ]
    },
    "expected_output": {
      "root_entity": "Omega Trading PLC",
      "layering_depth": 3,
      "has_opaque_jurisdiction": true,
      "terminal_unresolved_entity": "Tortola Trust Corp",
      "required_evidence": [
        {
          "entity": "Tortola Trust Corp",
          "jurisdiction": "VG",
          "document_type": "Deed of Trust and Register of Directors"
        }
      ],
      "diagram_summary": "Linear 3-tier chain ending in opaque BVI trust entity"
    }
  },
  {
    "input": {
      "root_entity": "Greenfield Transport Ltd",
      "tree": [
        {
          "tier": 1,
          "entity": "Greenfield Transport Ltd",
          "parent": "David Greenfield",
          "share_pct": 100,
          "jurisdiction": "GB"
        }
      ]
    },
    "expected_output": {
      "root_entity": "Greenfield Transport Ltd",
      "layering_depth": 1,
      "has_opaque_jurisdiction": false,
      "terminal_unresolved_entity": null,
      "required_evidence": [],
      "diagram_summary": "Direct ownership by verified natural person"
    }
  }
]
```

## Safety
Assists analytical research only; does not submit formal legal orders or communicate externally.
Use mock external writes. Require human review before any real deployment.