> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alphaengine.trade/llms.txt
> Use this file to discover all available pages before exploring further.

# Repo Map

> AlphaEngine module ownership and local development entry points.

AlphaEngine is a multi-repo system. The docs should point to module owners
instead of inventing a single local workflow.

<CardGroup cols={3}>
  <Card title="Replay path" icon="route">
    Data capture, simulation, and ranking own the reproducible evidence chain.
  </Card>

  <Card title="Public boundary" icon="server">
    `api-router` owns the public HTTP contract and thin-client route surface.
  </Card>

  <Card title="On-chain boundary" icon="blocks">
    `alphaengine-contracts` owns intents, vault contracts, and deployments.
  </Card>
</CardGroup>

## Core backend flow

<Steps>
  <Step title="data-pipeline">
    Capture deterministic market data and snapshot artifacts.
  </Step>

  <Step title="simulation-service">
    Orchestrate strategy simulation, invariant checks, reports, and artifacts.
  </Step>

  <Step title="ranking-evaluation">
    Score utility, CapitalScore, eligibility, contest logic, and evaluation
    reports.
  </Step>
</Steps>

## Module ownership

<AccordionGroup>
  <Accordion title="Replay-critical backend">
    `data-pipeline` owns deterministic market capture and snapshot artifacts.
    `simulation-service` owns orchestration, invariants, reports, and artifacts.
    `ranking-evaluation` owns utility scoring, CapitalScore, eligibility,
    contest scoring, and reports.
  </Accordion>

  <Accordion title="Strategy and execution math">
    `strategies-ts/spot-strategies` owns Pendle strategy signals, features, and
    parameter semantics. `amm-math` owns deterministic AMM execution adjustment.
  </Accordion>

  <Accordion title="Public API">
    `api-router` owns the public HTTP contract, auth, request validation, and
    family dispatch.
  </Accordion>

  <Accordion title="Contracts and private runtime">
    `alphaengine-contracts` owns Solidity intent contracts, vault contracts,
    events, storage, and deployments. `listener-service` and `cofhe` own
    private operator-side infrastructure.
  </Accordion>

  <Accordion title="Docs">
    `mintlify-docs` owns this documentation site.
  </Accordion>
</AccordionGroup>

## Local commands

Each repo has its own README and agent instructions. Use the module README as
the local source of truth.

Common backend commands include:

```bash theme={null}
bun run lint
bun run typecheck
bun run test:fast
bun run ci:pr
```

Contracts use Foundry:

```bash theme={null}
forge fmt
forge build
forge test
forge coverage
```

Docs preview:

```bash theme={null}
npm install
npm run dev
```

## Boundary rules

<AccordionGroup>
  <Accordion title="Public access">
    Public access terminates at `api-router`. Internal AlphaEngine packages
    communicate by imports in the MVP.
  </Accordion>

  <Accordion title="Private runtime">
    `listener-service` and operator-side `cofhe` are internal infrastructure.
  </Accordion>

  <Accordion title="Dependency direction">
    `ranking-evaluation` must not orchestrate `simulation-service` in production
    flow.
  </Accordion>

  <Accordion title="Capital separation">
    ContestScore must stay independent from capital allocation ranking.
  </Accordion>
</AccordionGroup>

## Related pages

<CardGroup cols={2}>
  <Card title="System architecture" icon="network" href="/architecture/system-architecture">
    Public beta flow, encrypted intent flow, and module boundaries.
  </Card>

  <Card title="API overview" icon="file-check" href="/api/overview">
    Implemented public Strategy Arena routes.
  </Card>

  <Card title="Privacy model" icon="lock" href="/trust/privacy-model">
    Hidden inputs, public evidence, metadata leakage, and trust assumptions.
  </Card>
</CardGroup>