Skip to content

feat: add YAML-based devnet management with enhanced CLI commands#21

Merged
qj0r9j0vc2 merged 28 commits into
mainfrom
feat/enhanced-cli-yaml-devnet
Jan 26, 2026
Merged

feat: add YAML-based devnet management with enhanced CLI commands#21
qj0r9j0vc2 merged 28 commits into
mainfrom
feat/enhanced-cli-yaml-devnet

Conversation

@qj0r9j0vc2

@qj0r9j0vc2 qj0r9j0vc2 commented Jan 26, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Summary

Adds YAML-based declarative devnet management with enhanced CLI commands for improved developer experience.

Features

YAML-Based Devnet Definitions

  • Kubernetes-style resource format (apiVersion, kind, metadata, spec)
  • Multi-document YAML support for managing multiple devnets
  • Validation and proto conversion

New Commands

Command Description
apply -f <file> Apply devnet configuration from YAML
diff -f <file> Compare YAML definition against current state
exec <node> -- <cmd> Execute commands inside node containers
port-forward <node> <ports> Forward local ports to container ports
ports [node] List exposed ports for nodes
events Stream Docker container events
logs Enhanced with --level, --stats, --json flags
daemon start/stop/status Manage the devnetd daemon

Reconciliation Engine

  • State comparison between desired (YAML) and current state
  • Detects CREATE, DELETE, SCALE, UPGRADE, UPDATE actions
  • Dry-run support for previewing changes

Log Infrastructure

  • Parser for Cosmos SDK log formats (JSON + plain text)
  • Ring buffer for in-memory storage
  • Persistent bbolt-based log store
  • Level filtering and statistics

Usage

See docs/yaml-devnet-guide.md for detailed usage and examples.

Test Plan

  • Unit tests pass for all new packages
  • Manual test apply --dry-run with sample YAML
  • Manual test diff command
  • Manual test logs with level filtering
  • Manual test exec, port-forward, events commands
  • Manual test daemon commands

@qj0r9j0vc2
fix(transaction): resolve signature encoding, concurrency, and memo p…
6e94164 
…ropagation bugs
@qj0r9j0vc2
fix(transaction): resolve signature encoding, concurrency, and memo p…
51c487a 
…ropagation bugs (#19)
@qj0r9j0vc2
docs: Add v2 docs
9bdf154
@qj0r9j0vc2
Merge pull request #20 from altuslabsxyz/docs/add-v2
08a187c
@qj0r9j0vc2
feat(config): add YAML devnet type definitions
fb8328b
@qj0r9j0vc2
chore(deps): mark yaml.v3 as direct dependency
1044016
@qj0r9j0vc2
feat(config): add YAML validation for devnet definitions
3988fed
@qj0r9j0vc2
feat(config): add YAML loader with multi-document support
47ec7b9
@qj0r9j0vc2
feat(config): add YAML to protobuf conversion functions
0948bf3
@qj0r9j0vc2
feat(cmd): add apply command with dry-run support
aa98d1b
@qj0r9j0vc2
feat(cmd): register apply command in root
5eb4574
@qj0r9j0vc2
feat(cmd): add diff command for YAML comparison
506063c
@qj0r9j0vc2
feat(reconciler): add reconciliation types and plan structure
e706977
@qj0r9j0vc2
feat(reconciler): add diff calculator for state comparison
56d18d1
@qj0r9j0vc2
feat(logs): add log parser for Cosmos SDK format
61bad5d
@qj0r9j0vc2
feat(logs): add thread-safe ring buffer for log entries
b79a55f
@qj0r9j0vc2
feat(logs): add log collector for streaming log aggregation
d5ddac1
@qj0r9j0vc2
feat(logs): add level filtering, stats, and JSON output
3e0b792
@qj0r9j0vc2
feat(cmd): add exec command for container shell access
fd10396
@qj0r9j0vc2
feat(cmd): add port-forward and ports commands
599b11b
@qj0r9j0vc2
feat(cmd): add daemon management commands
680e5ae
@qj0r9j0vc2
feat(cmd): add events command for container event streaming
238310f
@qj0r9j0vc2
feat(logs): add bbolt-based persistent log store
b83d1cd
@qj0r9j0vc2 qj0r9j0vc2 self-assigned this Jan 26, 2026
@qj0r9j0vc2
docs: add YAML-based devnet management guide
6334672
@qj0r9j0vc2
fix: check error return values in log store prune
ab659fd
@qj0r9j0vc2
fix: resolve golangci-lint warnings
1cae65b 
- Fix errcheck: add error handling for Delete() calls in store.go
- Fix appendCombine: combine sequential appends in events.go
- Fix rangeValCopy: use indexing/pointers in apply.go, diff.go, reconciler/diff.go
- Fix gofmt: format events.go, buffer.go, store.go
@qj0r9j0vc2
fix: resolve CI test failures with race condition and isolation fixes
4b01a8c
@qj0r9j0vc2 qj0r9j0vc2 force-pushed the feat/enhanced-cli-yaml-devnet branch from aefbc55 to 4b01a8c Compare January 26, 2026 06:44
@qj0r9j0vc2 qj0r9j0vc2 merged commit 5c5e56c into main Jan 26, 2026
14 checks passed
qj0r9j0vc2 added a commit that referenced this pull request Jan 27, 2026
@qj0r9j0vc2
Merge pull request #21 from altuslabsxyz/feat/enhanced-cli-yaml-devnet
6dd4954
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

@qj0r9j0vc2 qj0r9j0vc2

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@qj0r9j0vc2