---
milestone: v2
name: Frontend MVP
audited: 2026-04-26
status: tech_debt
scores:
  requirements: 8/8
  phases: 3/3
  integration: 4/4
  flows: 3/3
gaps:
  requirements: []
  integration: []
  flows: []
tech_debt:
  - phase: "007-web-app-shell-diagnostic-start"
    items:
      - "UI was initially verified with HTTP/API smoke rather than browser screenshots."
  - phase: "008-learning-progress-view"
    items:
      - "Progress view has no charts or historical readiness timeline."
  - phase: "009-material-asset-workspace"
    items:
      - "Chrome DevTools MCP timed out during local browser screenshot attempt."
      - "Material and asset workspace is still prompt-only and has no real image generation."
nyquist:
  compliant_phases: []
  partial_phases: []
  missing_phases:
    - "007-web-app-shell-diagnostic-start"
    - "008-learning-progress-view"
    - "009-material-asset-workspace"
  overall: missing
---

# v2 Frontend MVP Audit

## Verdict

TECH_DEBT

All v2 Frontend MVP requirements are satisfied. The Go service now serves a
working browser UI for diagnostic practice, progress review, material
ingestion, ontology inspection, and teaching asset prompt generation.

The milestone remains `tech_debt` rather than `passed` because visual browser
screenshot validation could not be completed: Chrome DevTools MCP timed out
while opening the local page. HTTP/API smoke, static asset inspection, Go tests,
and OpenSpec validation all passed.

## Requirements Coverage

| Requirement | Status | Evidence |
|-------------|--------|----------|
| WEB-01 | Satisfied | Web app served at `/`. |
| WEB-02 | Satisfied | Diagnostic session creation wired from app script to API. |
| WEB-03 | Satisfied | Answer submission and rubric feedback rendering implemented. |
| WEB-04 | Satisfied | Learner memory, readiness, and next challenge APIs wired and rendered. |
| WEB-05 | Satisfied | Material ingestion UI calls `POST /api/v1/materials`. |
| WEB-06 | Satisfied | Ontology concept, edge, and gap summary rendering implemented. |
| WEB-07 | Satisfied | Teaching asset prompt generation UI implemented. |
| WEB-08 | Satisfied | Loading, empty, and error states exist across MVP flows. |

Total: 8/8 v2 requirements satisfied.

## Cross-Phase Integration

| Integration | Result |
|-------------|--------|
| Go backend static serving to web app | PASS |
| Diagnostic UI to backend diagnostic APIs | PASS |
| Answer grading to learner progress UI | PASS |
| Material ingestion to ontology to teaching asset prompt UI | PASS |

## E2E Smoke Evidence

```json
{
  "HtmlStatus": 200,
  "HtmlHasWorkspace": true,
  "JsHasAllApis": true,
  "SessionID": "diag-1",
  "Readiness": 75,
  "OntologyConcepts": 4,
  "AssetPromptID": "asset-prompt-1",
  "VerifyGuard": true
}
```

## Validation Evidence

- `go test ./...` passed.
- `openspec validate frontend-mvp --strict` passed.
- `openspec validate bootstrap-job-tutor-platform --strict` passed.
- Source line-count check passed.

## Recommended Next Milestone

Recommended next milestone: Persistence and Runtime Hardening.

Rationale:

- The browser MVP now proves the user journey.
- The biggest product risk is data loss from in-memory stores.
- Real `third-one` / internalized `agent-farm-go` runtime integration should be
  added after durable state boundaries are in place.

Candidate phases:

1. Durable persistence for sessions, learner memory, ontology, and asset
   prompts.
2. Runtime configuration and workflow package execution.
3. Browser visual regression and UI hardening.