Skip to content

Changelog

Zakardo has completed 8 implementation phases, building a comprehensive agent-native framework from the ground up.

All 8 phases complete. 1,140+ tests passing across all packages with zero regressions.

PhaseNameWhat Was BuiltTests
1Core PrimitivesType system, capability system, Plan IR, enrichment pipeline, validator330
2Execution RuntimeExecution engine, policy engine, trace system, data layer, gate/interaction/retry handlers, outbox517
3Planning IntelligenceLLM provider abstraction (OpenAI, Anthropic, Gemini, Ollama, Mock), prompt architecture, planner pipeline, plan library—
4Runtime API + SDKConfig system, runtime bootstrap, Hono server, REST + SSE endpoints, @zakardo/client SDK750
5Developer ExperienceCLI package (@zakardo/cli), scaffolding tool (create-zakardo), dev server, validation pipeline—
6A2UI CompositionA2UI composition engine, standard component catalog, framework-agnostic core (@zakardo/a2ui), React renderer (@zakardo/a2ui-react)—
7Training & ValidationTraining datasets (JSONL), output comparison (exact/subset/schema/custom), regression detection, lifecycle management, training mode1,068
8Studio + Polish@zakardo/studio (9 panels), enhanced @zakardo/testing, reference CRM app, documentation site, production hardening1,140
PackageVersionDescription
@zakardo/core0.1.0Core runtime — types through server
@zakardo/client0.1.0Zero-dep typed TypeScript client SDK
@zakardo/studio0.0.1Visual development tool
@zakardo/testing0.0.1Test utilities and factories

@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 LLM
  • testIntent(), 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
  • 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)
  • TRAINING execution mode
  • 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
  • CLI package with zakardo dev, build, validate commands
  • create-zakardo project scaffolding
  • Dev server with hot reload
  • Validation pipeline integration
  • ZakardoConfig and defineConfig type-safe helpers
  • createRuntime() factory and ZakardoRuntime container
  • createZakardoApp() 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
  • LLMProvider interface with 4 provider implementations + mock
  • LLMRouter with per-call-type routing and fallback chains
  • 6-layer prompt architecture with 9 Zod response schemas
  • Intent classification, goal extraction, capability scoring, backward chaining
  • LLMPlanner orchestrating GENERATE/CLARIFY/CONVERSE modes
  • Plan library with 5-state lifecycle and trust scoring
  • SQLiteZakardoStore with 5 sub-stores
  • ExecutionEngine durable state machine
  • PolicyEngine with 3 evaluation points
  • TraceWriter and TraceReader
  • Gate, interaction, and retry handlers
  • OutboxManager with deferred commit pattern
  • JSON Schema validation with x-zakardo extensions
  • Structural compatibility checking
  • CapabilityRegistry with register, resolve, query
  • CapabilityDefinitionValidator
  • Plan Draft and Full Plan IR type definitions
  • Path expressions and data binding system
  • 8-step enrichment pipeline
  • 10-check validation pipeline