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

24 Releases 30 Tags

RSS Feed
  • v0.1.2 dda9569b80
    Compare

    v0.1.2 — AI Service Scaffolding (Phase 1) Stable

    coreci-bot released this 2026-09-11 15:40:30 +00:00 | 69 commits to main since this release

    Nextcraft v0.1.2 — v0.2 Phase 1

    apps/ai-service stands up: a Python FastAPI application hosting the AI tutor agents behind a provider-agnostic LLM layer.

    Delivered (REQ-2-001, REQ-2-002, REQ-2-003)

    • FastAPI app — lifespan-managed httpx pool (10s connect / 300s read for cloud TTFT), localhost-only CORS, /health
    • Provider-agnostic LLM layer — LLMProvider protocol; OpenAICompatProvider (ollama-cloud + local endpoints, raw httpx, no SDK); deterministic MockProvider (failure injection, abort recording); factory selection
    • SSE chat streaming — POST /v1/chat/stream with the D-016 envelope: meta event → content deltas → done → [DONE]; in-band error events on failure
    • Monorepo integration — zero-dep package shim, turbo passthrough tasks, root pnpm ai:dev/ai:test/ai:lint/ai:bootstrap
    • Quality gates — ruff clean, 20/20 pytest green (mock provider only, mechanically enforced cloud-free guard), live smoke verified meta→delta→done→[DONE]

    Next

    Phase 2: agent framework (BaseAgent, session store, registry, structured outputs).

    Downloads
  • v0.1.1 e58b027a57
    Compare

    v0.1.1 — v0.2 Pre-Execution Stable

    coreci-bot released this 2026-09-11 15:16:02 +00:00 | 71 commits to main since this release

    Nextcraft v0.1.1 — v0.2 Pre-Execution (Phase 0)

    Milestone v0.2 (AI Tutor Architecture) phase 0 complete. This patch ships the full specification, research, and plan for the six AI tutor agents (Coach, Tutor, Lab, Assessor, Proctor, Mentor) as a Python FastAPI apps/ai-service.

    What's in this release

    • SPECIFY — REQ-2-001..012 activated; decisions D-013 (v0.1 founder-agreed, business logic unlocked), D-014 (provider-agnostic LLM, ollama-cloud default), D-015 (all six agents, engines mocked)
    • CLARIFY — 10 ambiguities auto-resolved (A-001..A-010)
    • RESEARCH — FastAPI 0.141 + pydantic v2 + httpx + sse-starlette stack; D-016..D-023 design decisions; ai-engineer persona added, backend-engineer reactivated
    • PLAN — 6 execution phases, 39 tasks, 18 waves, persona-assigned with must-have checklists
    • GRILL — adversarial review: GO-WITH-CHANGES (0.82); binding decisions G-1..G-5 applied
    • MVP/UX gate — passed (User-Facing Surface, Happy Path, UX Acceptance Criteria)

    Next

    Execution phases P1-P6 (apps/ai-service scaffolding → agent framework → Coach+Tutor → Lab+Assessor → Proctor+Mentor → learner surface integration), shipping as v0.1.2..v0.1.7. Milestone release: v0.2.0.

    Downloads
  • v0.1.0 810485ecc8
    Compare

    Pre-Release

    coreci-bot released this 2026-09-10 22:48:00 +00:00 | 74 commits to main since this release

    Nextcraft v0.1.0 — UI/UX Prototype Milestone Release

    What This Is

    High-fidelity interactive prototype of all 4 Nextcraft surfaces with realistic mock data, navigation flows, responsive layouts, and a shared component library. No backend, no business logic — everything static/mocked.

    Surfaces (4)

    Learner Surface (7 pages)

    • Landing page with hero, Byte→Build→Demonstrate→Defend flow, program highlights, testimonials
    • Program catalog with 5 competency stacks (70 total competencies)
    • Competency stack view with status indicators, progress bars, microcredential badges
    • Learner dashboard with 6 panels including AI tutor chat mockup and recharts progress graph
    • Byte tutorial viewer with concept panel and tabbed worked examples
    • Build sandbox mockup with IDE layout (toolbar, file explorer, editor, telemetry)
    • Assessment/defense mockup with rubric, AI reviewer, oral defense, process trace timeline

    Marketplace Surface (5 pages)

    • Job board with 20 mock AI-era job listings, match scores, skill tags
    • Client-side search and filter (skills, seniority, remote, salary range)
    • Job detail with competencies, AI-matched skills breakdown, employer info, related jobs
    • Employer profiles with culture section and open positions
    • Pricing page with 6 tiers and feature comparison table

    Employer Dashboard (4 pages)

    • Dashboard overview: 4 metric cards, applicant pipeline (5 columns), 3 recharts analytics charts
    • Talent search: 15 candidate cards with client-side filtering
    • Candidate profiles: artifact gallery, process trace, defense transcripts, microcredential verification
    • Posting management: posting list + detail form + applicant table

    Admin Surface (4 pages)

    • Admin overview: 5 platform metrics, activity feed (10 events), system health (6 services)
    • Learner management: searchable table with detail panel (15 mock learners)
    • Competency graph viewer: interactive @xyflow/react graph (20 nodes, clickable, minimap)
    • Marketplace moderation: 3 tabbed queues with action buttons

    Tech Stack

    • Next.js 15 (App Router, Server Components)
    • Tailwind CSS v4 (@theme, dark mode via @custom-variant)
    • TypeScript 5.x (strict)
    • pnpm 12 + turborepo (monorepo)
    • lucide-react (icons)
    • recharts (charts)
    • @xyflow/react (competency graph viewer)
    • Inter font (next/font)
    • Storybook 10 (6 stories)

    Structure

    nextcraft/
  apps/web/          # Next.js app (19 routes)
  packages/ui/       # Shared component library (5 primitives + tokens)
  packages/types/    # Shared TypeScript types
  packages/mock-data/ # Typed mock data (5 stacks, 20 jobs, 15 candidates, 10 employers)

    Requirements: 28/28 complete

    • Infrastructure: REQ-001 to REQ-005 ✅
    • Learner Surface: REQ-006 to REQ-012 ✅
    • Marketplace Surface: REQ-013 to REQ-017 ✅
    • Employer Dashboard: REQ-018 to REQ-021 ✅
    • Admin Surface: REQ-022 to REQ-025 ✅
    • Polish & Integration: REQ-026 to REQ-028 ✅

    Phases (7)

    • P0 Pre-execution → v0.0.1
    • P1 Project Scaffolding → v0.0.2
    • P2 Learner Surface → v0.0.3
    • P3 Marketplace Surface → v0.0.4
    • P4 Employer Dashboard → v0.0.5
    • P5 Admin Surface → v0.0.6
    • P6 Polish + Integration → v0.0.7
    • P7 Final Review + Ship → v0.1.0 (this release)

    Verification

    • ✅ pnpm build: 4/4 packages, 19 routes
    • ✅ pnpm typecheck: 7/7 tasks
    • ✅ storybook build: all stories compile
    • ✅ 104 TypeScript files, 19,536 lines of code
    • ✅ 26 decisions logged (D-001 through D-026)
    • ✅ Dark mode on all surfaces
    • ✅ Breadcrumbs on all 20 routes
    • ✅ Responsive (375px / 768px / 1280px)
    • ✅ WCAG AA contrast verified
    Downloads
  • v0.0.1 9d530dd4d3
    Compare

    Pre-Release

    coreci-bot released this 2026-09-10 21:31:49 +00:00 | 74 commits to main since this release

    Nextcraft v0.0.1 — Pre-execution Phase

    Completed Stages

    • SPECIFY: Specification validated against PROJECT.md and REQUIREMENTS.md (28 REQ-IDs)
    • CLARIFY: 8 ambiguities auto-resolved (D-013 through D-020)
    • RESEARCH: Tech stack confirmed — Next.js, Tailwind CSS v4, lucide-react, recharts, @xyflow/react. Personas assessed.
    • PLAN: 6 execution phases, 20 tasks, wave-ordered with persona assignments
    • MVP/UX CHECK: Passed — user-facing surface, 14-step happy path, 12 acceptance criteria

    Files Created

    • .ciagent/config.json
    • .ciagent/PROJECT.md
    • .ciagent/REQUIREMENTS.md
    • .ciagent/ARCHITECTURE.md
    • .ciagent/ROADMAP.md
    • .ciagent/PLAN.md
    • .ciagent/PERSONAS.md
    • .ciagent/CHECKPOINT.json
    • .gitignore

    Decisions

    26 decisions logged (D-001 through D-026)

    Next Steps

    Phase 1: Project Scaffolding — monorepo setup, component library, mock data, routing

    Downloads