Roadmap

Kyku’s refinement tracks three themes: BDD testing (✅ done), feature completeness (in progress), and documentation + agent tooling (✅ done).

Current State

Area	Status
Core engine	✅ DAG, diff, plan, apply, state, crypto, outputs, state locking, plan files
Providers	✅ AWS, GCP, Hetzner, DigitalOcean, Kubernetes
Resources	✅ 32 first-class types (incl. full K8s workload set)
CLI	✅ 14 commands: init, validate, plan, apply, destroy, output, refresh, graph, import, state list/show/rm
Testing	✅ Unit tests + BDD suite (30 scenarios)
Docs	✅ This site (82 pages), llms.txt artifacts, docs MCP server

Completed Milestones

Phase A — Foundation ✅

• BDD harness — Vitest + vitest-cucumber, 30 scenarios across engine, plan, apply, destroy, crypto, graph, and provider parity
• kyku validate — static config validation without cloud calls
• State subcommands — state list, state show, state rm
• kyku refresh — re-read cloud state, update state file

Phase B — Import & Plan Files ✅

• kyku import <resourceType> <cloudId> — adopt existing cloud resources
• Plan files — kyku plan --out=plan.json + kyku apply --plan plan.json
• State locking — file lock with stale detection and timeout

Documentation & Agent Tooling ✅

• This docs site — Astro Starlight, 82 pages, full-text search
• LLM artifacts — /llms.txt, /llms-full.txt, /llms-small.txt
• Docs MCP server — search_docs, get_page, list_resources, list_providers tools for AI agents

Phase C — Operational Maturity (next)

1. Drift detection flag — --detailed-exitcode on plan; fail CI on unexpected drift
2. Remote state backends — S3, GCS, Spaces, and HTTP
3. --target / --exclude — scoped plan/apply (id, glob, or tags.key=value; resource + ancestors)
4. Rollback — failed apply restores the pre-apply state backup; --rollback-destroy optionally destroys leftovers
5. Plan diff as JSON — kyku plan --json plus plan-file serial/hash checks

Deliverable: Team CI/CD workflows fully supported.

Phase D — Ecosystem

1. kyku test — typed TypeScript policy assertions against the offline plan
2. Modules — convention: factories return BaseResource[] (see Config → TypeScript modules)
3. New resource types — Container Registry, Static IP, CDN/WAF
4. DX polish — doctor, version, completion (no fmt yet)
5. New providers — Scaleway/Azure based on demand

Success Metrics

Metric	Target	Current
BDD coverage	≥30 scenarios	✅ 30
CLI parity	12+ subcommands	✅ 14
Resource coverage	12+ types	✅ 32
Docs coverage	All resources/providers/CLI	✅ 82 pages
Remote state	S3 / GCS / Spaces / HTTP	✅ shipped
Drift detection	--detailed-exitcode	✅ shipped