Build a BODS Circular Control Graph and Nominee Profiler — implementation

## Build
Evaluate corporate officer registers against BODS v0.4 nominee guidance to detect circular control links. Draft tailored nominee evidence packages and isolate graph cycles.

## User
Enhanced Due Diligence Analyst

## Workflow
1. Ingest simplified company shareholder registers and officer appointments formatted in BODS v0.4 syntax.
2. Execute cycle-detection algorithms to isolate circular holding networks.
3. Identify officers holding nominee roles based on external directorship counts and BODS criteria.
4. Generate serialized control cycle graphs and tailored nominee documentary evidence requests.

## Interface
Interactive network graph viewer rendering isolated control loops and a panel for generated nominee evidence requests.

## Data
Assemble synthetic BODS v0.4 JSON datasets simulating offshore corporate registries with hidden control loops and known nominee profiles.
Starter examples below are synthetic. They are not downloaded records.

## Source
[Beneficial ownership modelling](https://standard.openownership.org/en/latest/standard/modelling/index.html)
Employs BODS v0.4 nominee arrangement modeling requirements to identify professional nominees and parse unverified control loops.

## Tools
dspy, networkx, pydantic.
DSPy compiles robust prompt assertions to extract opaque nominee relationships and isolate graph cycles accurately.
Requires multi-step logical deduction for graph cycle tracing; hosted Claude or local 32k context model.

## 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
- Accurately detects and isolates circular ownership loops within corporate holding structures.
- Flags officers matching known professional nominee patterns under BODS rules.
- Produces serialized Graphviz DOT code isolating the specific cycle paths.
- Generates customized nominee disclosure questionnaires specifying required proof of ultimate instruction.

## Starter Examples
```json
[
  {
    "input": {
      "target_company": "Alpha Holdings",
      "officers": [
        {
          "name": "Julian Vance",
          "external_directorship_count": 140
        }
      ],
      "shares": [
        {
          "holder": "Beta Group",
          "percentage": 100
        }
      ],
      "related_entities": [
        {
          "entity": "Beta Group",
          "shares": [
            {
              "holder": "Alpha Holdings",
              "percentage": 100
            }
          ]
        }
      ]
    },
    "expected_output": {
      "has_cycle": true,
      "flagged_nominees": [
        "Julian Vance"
      ],
      "cycle_diagram": "digraph { \"Alpha Holdings\" -> \"Beta Group\"; \"Beta Group\" -> \"Alpha Holdings\"; }",
      "requests": [
        "Nominee Director Service Agreement"
      ]
    }
  },
  {
    "input": {
      "target_company": "Solstice Energy Inc",
      "officers": [
        {
          "name": "Elena Rostova",
          "external_directorship_count": 1
        }
      ],
      "shares": [
        {
          "holder": "Elena Rostova",
          "percentage": 85
        }
      ],
      "related_entities": []
    },
    "expected_output": {
      "has_cycle": false,
      "flagged_nominees": [],
      "cycle_diagram": "digraph { \"Solstice Energy Inc\" -> \"Elena Rostova\"; }",
      "requests": []
    }
  }
]
```

## Safety
Provides advisory evidence gathering plans; does not execute regulatory enforcement actions or make formal legal accusations.
Use mock external writes. Require human review before any real deployment.