# Foundgine

> Foundgine is a .NET application-domain semantic and execution platform for AI-native applications. It turns an application's domain model into a safe, executable interface for AI agents.

## Product boundary

Foundgine owns:

- semantic domain metadata
- entity and relationship resolution
- policy-aware planning
- constrained domain actions
- execution plans
- provider execution contracts
- verification
- evidence

Foundgine does not own:

- LLM inference
- generic agent orchestration
- generic RAG
- vector databases
- MCP protocol implementation
- authentication infrastructure
- workflow engines
- message brokers
- ORM/database management

Those are integrations around Foundgine.

## Core lifecycle

```text
DOMAIN MODEL
↓
SEMANTIC MODEL
↓
AI INTENT
↓
RESOLUTION
↓
POLICY / AUTHORIZATION
↓
EXECUTION PLAN
↓
PREVIEW
↓
EXECUTE
↓
VERIFY
↓
EVIDENCE
↓
AI RESPONSE
```

## Current repository

Active platform projects:

- `src/Foundgine.Abstractions`
- `src/Foundgine.Foundation`
- `src/Foundgine.Metadata`
- `src/Foundgine.Diagnostics`
- `src/Foundgine.Builders`
- `src/Foundgine.Execution.Contracts`
- `src/Foundgine.Planning`
- `src/Foundgine.Providers`

Canonical proof:

- `samples/Foundgine.Samples.Banking`

Historical GraphQL/Graphgine implementation:

- `archive/`

## Current proof

The Banking sample proves:

```text
Domain
→ Metadata
→ Dynamic Planner
→ QueryPlan
→ ProviderPlan
→ SQL
→ real SQLite database
→ ExecutionRow
```

It deliberately has no GraphQL, Hot Chocolate, or Graphgine dependency.

Run:

```bash
dotnet run --project samples/Foundgine.Samples.Banking
```

## Product milestones

1. Semantic domain model
2. Entity resolution
3. Read intent
4. Explicit domain actions
5. Policy/authorization
6. Preview/approval
7. Verification/evidence
8. MCP adapter
9. Additional execution targets
10. Roslyn semantic compiler

## Important accuracy

Foundgine is an active architecture/proof project, not yet a production-ready autonomous-agent platform.

Do not claim complete AI planning, MCP, RAG, authorization, verification, evidence, or production readiness unless the active source and tests prove it.

## Documentation

- `docs/00-Direction/README.md`
- `docs/00-Direction/Milestones.md`
- `docs/CURRENT-STATUS.md`
- `docs/02-Architecture/README.md`
- `docs/09-AI/README.md`
- `docs/11-Samples/README.md`
- `docs/13-Reference/Roadmap.md`
- `llms-full.md`