Reference
Roadmap
Sverka is pre-alpha. This page tracks what exists, what is planned, and what is deferred.
Sverka is pre-alpha. This page tracks what exists, what is planned, and what is deferred.
Implemented
- Construct API —
Project,Pipeline,ShellStep,Entryin@sverka/workflow - Definition Graph — provider-neutral IR, synthesis, validation
- Native engine — topological scheduling, parallel steps, host and Docker drivers
- CLI —
init,validate,plan,graph,run,compile,discover,check,policy,doctor,mcp-server - Compilers — GitHub Actions, GitLab CI, Temporal, Dagger, Inngest, Drone (code generation targets)
- MCP server —
sverka mcp-serverexposes 5 tools over stdio - MCP plugin —
@sverka/plugin-mcploads external MCP servers as Sverka plugins - AgentStep —
AgentStepin cdk,AgentDriverinterface, stub driver - Saga compensations — automatic rollback on failure (Spec 30)
- CacheStore — step-level caching (Spec 19)
- RetryPolicy — step-level retry (Spec 20)
- RunEvent — structured event protocol (Spec 21)
- Action pinning — GHA SHA pinning (Spec 22)
- Checks — built-in check IDs, SARIF extraction
- Findings — SARIF normalization, fingerprints, baselines
- Policy — rules, severities, enforcement
Planned
- Suspend/resume — snapshot-based pause and resume (Spec 29; suspend implemented, resume planned)
- SDK builder API —
sh,agent,suspendtagged templates (token-efficient authoring surface, Spec 03) - Agent drivers —
@sverka/agent-openai,@sverka/agent-anthropic(real LLM drivers forAgentStep) - Native CI lowering — one-job-per-step for GitHub Actions and GitLab CI (currently thin-wrapper mode)
- Markdown authoring —
.sverka.mdfiles with YAML frontmatter - Run audit —
sverka audit, per-step timings, AI cost estimation - Graph visualization —
sverka graph --format mermaid - HTTP/SSE MCP transport — MCP server over HTTP (currently stdio only)
- Streaming agent output — token-by-token agent step output
- Multi-turn agent steps — agent conversations within a step
- Benchmark harness — token/call/time comparison: agent with Sverka vs agent without, across workflow complexity levels
Deferred
- Decorator API —
@pipeline,@step,@entrydecorators (built artifact exists, source not shipped) - Schedule trigger — cron-based triggers (Spec F-05)
- Matrix builds — matrix strategy (Spec F-15)
- Reusable workflows — workflow composition (Spec F-31)
Run reporting (@sverka/reporter)
`@sverka/reporter` turns an engine `RunEvent` stream into human output: a vitest-style text renderer for the terminal, a self-contained HTML run report, and an
Verification package (@sverka/verification)
`@sverka/verification` is the findings engine in one package — check resolution (Spec 14), SARIF normalization and baselines (Spec 15), and policy evaluation