tutor-service/.planning/v2-FRONTEND-MVP-AUDIT.md

milestone, name, audited, status, scores, gaps, tech_debt, nyquist

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

{
  "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.