Changelog
Zakardo has completed 8 implementation phases, building a comprehensive agent-native framework from the ground up.
Current Status: v0.1.0
Section titled “Current Status: v0.1.0”All 8 phases complete. 1,140+ tests passing across all packages with zero regressions.
Phase Summary
Section titled “Phase Summary”| Phase | Name | What Was Built | Tests |
|---|---|---|---|
| 1 | Core Primitives | Type system, capability system, Plan IR, enrichment pipeline, validator | 330 |
| 2 | Execution Runtime | Execution engine, policy engine, trace system, data layer, gate/interaction/retry handlers, outbox | 517 |
| 3 | Planning Intelligence | LLM provider abstraction (OpenAI, Anthropic, Gemini, Ollama, Mock), prompt architecture, planner pipeline, plan library | — |
| 4 | Runtime API + SDK | Config system, runtime bootstrap, Hono server, REST + SSE endpoints, @zakardo/client SDK | 750 |
| 5 | Developer Experience | CLI package (@zakardo/cli), scaffolding tool (create-zakardo), dev server, validation pipeline | — |
| 6 | A2UI Composition | A2UI composition engine, standard component catalog, framework-agnostic core (@zakardo/a2ui), React renderer (@zakardo/a2ui-react) | — |
| 7 | Training & Validation | Training datasets (JSONL), output comparison (exact/subset/schema/custom), regression detection, lifecycle management, training mode | 1,068 |
| 8 | Studio + Polish | @zakardo/studio (9 panels), enhanced @zakardo/testing, reference CRM app, documentation site, production hardening | 1,140 |
Packages
Section titled “Packages”| Package | Version | Description |
|---|---|---|
@zakardo/core | 0.1.0 | Core runtime — types through server |
@zakardo/client | 0.1.0 | Zero-dep typed TypeScript client SDK |
@zakardo/studio | 0.0.1 | Visual development tool |
@zakardo/testing | 0.0.1 | Test utilities and factories |
Phase 8: Studio + Polish (Latest)
Section titled “Phase 8: Studio + Polish (Latest)”@zakardo/studio — Visual development tool:
- Dashboard with runtime health, capability count, plan count, training pass rate
- Capability Browser with search, filter by effect class, schema inspection
- Intent Playground with 8-stage pipeline visualization and response panel
- Plan Explorer with lifecycle state filter, trust score display, step visualization
- Trace Viewer with timeline view and step-by-step event inspection
- Policy Inspector with condition viewer and effect display
- Training Dashboard with pass rate bars and summary cards
- Config Viewer with sectioned JSON display
- Light/dark/system theme with localStorage persistence
mountStudio middleware in @zakardo/core:
- Serves Studio SPA from Hono server
- MIME type handling, SPA fallback for client-side routing
- Dev/production mode switching
Enhanced @zakardo/testing:
createTestRuntime()— fully wired in-memory runtime with mock LLMtestIntent(),testCapability(),testPlan(),testPolicy()— high-level test helpers- 5 custom Vitest matchers:
toContainCapability,toHaveStepCount,toHaveVerdict,toHavePassRate,toMatchSubset
Reference CRM Application (examples/crm/):
- 10 capabilities across contacts, deals, notes, email, and analytics
- 2 governance policies
- Training dataset with 3 test scenarios
- Full Hono server with runtime + Studio
Phase 7: Training & Validation
Section titled “Phase 7: Training & Validation”- Training dataset format and validation
- Output comparison strategies (exact, subset, schema, custom)
- Test case scoring and verdict assignment
- Training runner with parallel execution
- Regression detection against previous runs
- Lifecycle manager (auto-promote/quarantine plans)
TRAININGexecution mode
Phase 6: A2UI Composition
Section titled “Phase 6: A2UI Composition”- A2UI composition engine (surface updates, data model updates)
- Standard component catalog (DataTable, DetailCard, StatusBadge, etc.)
- Anchored view resolution and ephemeral view composition
- Interaction view composition for mid-plan user input
- Framework-agnostic core and React renderer
Phase 5: Developer Experience
Section titled “Phase 5: Developer Experience”- CLI package with
zakardo dev,build,validatecommands create-zakardoproject scaffolding- Dev server with hot reload
- Validation pipeline integration
Phase 4: Runtime API + SDK
Section titled “Phase 4: Runtime API + SDK”ZakardoConfiganddefineConfigtype-safe helperscreateRuntime()factory andZakardoRuntimecontainercreateZakardoApp()Hono server factory- Auth, error, validation middleware
- 20+ REST endpoints for intents, executions, capabilities, plans, traces, health
- SSE streaming with 27 event types
@zakardo/client— zero-dependency typed SDK with HTTP + SSE clients
Phase 3: Planning Intelligence
Section titled “Phase 3: Planning Intelligence”LLMProviderinterface with 4 provider implementations + mockLLMRouterwith per-call-type routing and fallback chains- 6-layer prompt architecture with 9 Zod response schemas
- Intent classification, goal extraction, capability scoring, backward chaining
LLMPlannerorchestrating GENERATE/CLARIFY/CONVERSE modes- Plan library with 5-state lifecycle and trust scoring
Phase 2: Execution Runtime
Section titled “Phase 2: Execution Runtime”SQLiteZakardoStorewith 5 sub-storesExecutionEnginedurable state machinePolicyEnginewith 3 evaluation pointsTraceWriterandTraceReader- Gate, interaction, and retry handlers
OutboxManagerwith deferred commit pattern
Phase 1: Core Primitives
Section titled “Phase 1: Core Primitives”- JSON Schema validation with
x-zakardoextensions - Structural compatibility checking
CapabilityRegistrywith register, resolve, queryCapabilityDefinitionValidator- Plan Draft and Full Plan IR type definitions
- Path expressions and data binding system
- 8-step enrichment pipeline
- 10-check validation pipeline