# Socrata · Phase 0 Validation Harness

Validation experiment for the Socrata project. Runs a corpus of seed ideas through:
seed → SysML model generation → PlantUML render → Socrates analysis (assumptions, risks, inconsistencies) → conversation → scoring.

See [../docs/phase-0-validation.md](../docs/phase-0-validation.md) and [../docs/phase-0-plan.md](../docs/phase-0-plan.md) for context.

## Setup

```bash
pnpm install
cp .env.example .env.local      # then fill in your LM Studio config
```

LM Studio must be running locally with a model loaded. Default endpoint: `http://localhost:1234/v1`.

## Usage

```bash
pnpm phase0 hello                          # smoke test — round-trip a chat to LM Studio
pnpm phase0 render-test                    # render the Aristotle reference model as PlantUML PNG
pnpm phase0 run <seed-id>                  # full pipeline on one seed
pnpm phase0 corpus                         # all seeds (excluding holdouts)
```

## Layout

```
src/
  cli.ts                   entrypoint
  types.ts                 shared types
  llm/                     LM Studio client + messages helper
  generate/                seed → SysML model
  socrates/                detect / converse / propose
  render/                  PlantUML serialization + rendering
  eval/                    rubric scoring + reports
  prompts/                 versioned prompt files (.md)
seeds/                     corpus of test seed ideas (JSON)
outputs/                   generated artifacts (gitignored)
reports/                   committed run reports
```