coreci/nextcraft
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 24 Wiki Activity

24 Releases 30 Tags

RSS Feed
  • v0.2.0 88a1dab810
    Compare

    v0.2.0 — AI Tutor Architecture (Milestone Release) Stable

    coreci-bot released this 2026-09-11 17:35:00 +00:00 | 71 commits to main since this release

    Nextcraft v0.2.0 — AI Tutor Architecture

    The six AI tutor agents are live: a Python FastAPI service (apps/ai-service) hosting Coach, Tutor, Lab, Assessor, Proctor, and Mentor behind a provider-agnostic LLM layer, wired into the v0.1 learner surface with real streaming.

    Honesty note (per D-015 and G-5)

    Lab, Assessor, and Proctor operate on mock engine inputs — simulated telemetry timelines and pre-baked artifacts/transcripts. Their real engines (sandbox fabric, process-trace assessment, identity verification) are v0.3+. All six agents make real LLM calls; only the inputs to three of them are mocked.

    The Six Agents

    • Coach — pacing, motivation, retrieval practice; ends every reply with exactly one next action
    • Tutor — one concept per reply, worked example, Socratic check
    • Lab — in-flow feedback on build-session telemetry (mock inputs)
    • Assessor — rubric grading of artifacts + defense transcripts with structured, evidence-cited scores (mock inputs)
    • Proctor — integrity signals with coaching-shaped interventions; never punitive (mock inputs)
    • Mentor — long-horizon career narrative, session-backed

    Architecture

    • Provider-agnostic LLM layer — OpenAI-compatible httpx client: ollama-cloud (default, gemma4:31b), local endpoint, deterministic mock (tests/CI — the suite never calls the cloud)
    • D-016 SSE envelope — meta → deltas → done → [DONE], in-band errors, ping keep-alive immunity
    • 4-layer structured output defense — response_format auto-degrade → prompt-embedded schema → defensive parse → bounded retry
    • Session store — agent-scoped, 20-message windows, LRU cap, DB-migration-ready

    Learner Surface (all streaming, all with error+retry states)

    • Dashboard: Coach ↔ Tutor switcher chat + Mentor career panel
    • Byte viewer: Tutor concept walkthroughs · Sandbox: Lab feedback panel · Defense: Assessor rubric bars + Proctor integrity banner

    Phases (all shipped)

    P0 pre-execution → v0.1.1 · P1 scaffolding → v0.1.2 · P2 agent framework → v0.1.3 · P3 Coach+Tutor → v0.1.4 · P4 Lab+Assessor → v0.1.5 · P5 Proctor+Mentor → v0.1.6 · P6 learner surface → v0.1.7 · P7 final review → v0.2.0

    Quality

    134/134 tests green (mock provider only) · ruff clean · tsc green across workspaces · next build 15/15 pages · E2E smoke 7/7 · final adversarial review: GO (after CRLF wire-format and disconnect-handling P0 fixes, regression-covered) · project health audit: PASS 7/7 · secrets never in code/logs/commits/history

    Escalation record

    P1 executor delegation failed twice (empty subagent results); auto-resolved at full autonomy to inline execution with identical plan fidelity (commit 3271373, reflog-only after squash-delete — recorded here durably per audit remediation).

    Requirements

    All 12 v0.2 requirements complete (REQ-2-001..012). 40 requirements complete across v0.1+v0.2.

    Next (roadmap candidates, v0.3+)

    Assessment engine (process-trace grading, per-learner variants) · sandbox fabric · identity verification & age-gating · payments

    Downloads