Skip to content

Conversation

@mergify
Copy link

@mergify mergify bot commented Nov 20, 2025

✨ Pull request #207 which was ahead in the queue has been dequeued (for the following reason: checks failed). ✨

Branch main (9542f1d) and #207 are embarked together for merge.

This pull request has been created by Mergify to speculatively check the mergeability of #207.
You don't need to do anything. Mergify will close this pull request automatically when it is complete.

Required conditions of queue default for merge:

  • any of [🛡 GitHub branch protection]:
    • check-neutral = PR Status Check
    • check-skipped = PR Status Check
    • check-success = PR Status Check
  • any of [🛡 GitHub repository ruleset rule]:
    • check-neutral = PR Status Check
    • check-skipped = PR Status Check
    • check-success = PR Status Check
  • #review-threads-unresolved = 0 [🛡 GitHub repository ruleset rule]

Required conditions to stay in the queue:

---
checking_base_sha: 9542f1d0bda8681a95310000299a93b3be250fde
previous_failed_batches: []
pull_requests:
  - number: 207
...

jrepp and others added 9 commits October 16, 2025 22:51
…rchestration

User request: "let's make a nomad setup memo - look at the current local binary testing setup and think about how to convert it to nomad - we still want it to be easy to run"

Created comprehensive Nomad setup guide covering:

1. **Why Nomad for Local Development**
   - Production parity (same orchestrator dev → prod)
   - Automatic supervision, health checks, service discovery
   - Resource limits, restart policies, rolling deployments
   - Comparison table: prismctl local vs prismctl nomad

2. **Easy-to-Use Wrapper: prismctl nomad**
   - `prismctl nomad start` - One-command stack startup
   - `prismctl nomad status` - Job and allocation status
   - `prismctl nomad logs <task>` - View task logs
   - `prismctl nomad ui` - Open Nomad web UI
   - `prismctl nomad stop` - Clean shutdown

3. **Nomad Job Specifications**
   - Complete job spec with 3 groups (admin, launcher, keyvalue)
   - Resource limits (CPU/memory), health checks, restart policies
   - Service discovery via Consul integration
   - Alternative Docker-based job spec for containers

4. **Implementation Guide**
   - Install instructions (macOS, Linux)
   - Job file structure and syntax
   - Go code for prismctl nomad command wrapper
   - Service dependency handling with templates

5. **Advanced Features**
   - Rolling deployments with auto-revert
   - Canary deployments for gradual rollouts
   - Multi-region setup for distributed deployments
   - Vault integration for secrets management

6. **Migration Path**
   - Phase 1: Hybrid (both local and nomad)
   - Phase 2: Nomad by default
   - Phase 3: Production deployment with same job files

7. **Troubleshooting Guide**
   - Nomad not starting, job allocation failures
   - Consul service discovery issues
   - Health check failures, resource constraints
   - Performance tuning recommendations

Key design goals:
- Maintain same ease of use as prismctl local start
- Enable production-like orchestration locally
- Support smooth migration from direct process execution
- Provide path from dev → staging → production

Benefits over current setup:
- Automatic process supervision and restart
- Built-in health checks and service discovery
- Resource isolation and limits
- Rolling deployments and canary releases
- Better matches production environment

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
… service selection

User request: "evaluate @docs-cms/memos/MEMO-035-nomad-local-development-setup.md for simplicity and time to value for a developer, we want to make it configurable at install time and runtime easily by any developer. rewrite as necessary - be creative to make multi-service flexible and fun"

Complete transformation focusing on developer experience:

**Time to Value: 30+ minutes → 60 seconds**
- Replaced manual Nomad/Consul installation with auto-installer
- Eliminated 470+ lines of static HCL with dynamic job generation
- Added `prismctl dev init` for one-time setup
- Added `prismctl dev start` with interactive service picker

**Interactive Configuration System**
- TUI service picker with live preview (fzf-style)
- Profile system: save/load/share favorite configurations
- Built-in presets: minimal, redis, messaging, postgres, full
- Configuration hierarchy: CLI flags → Interactive → Profiles → Presets
- Real-time estimates for startup time and memory usage

**Beautiful Developer Experience**
- Live TUI dashboard with real-time metrics (RPS, memory, health)
- Log streaming with one-key service selection
- Quick actions: restart, scale, open UIs with keyboard shortcuts
- Color-coded health status (green/yellow/red)
- Auto-troubleshooting with helpful error messages

**Runtime Flexibility**
- Hot add/remove services without full restart
- Dynamic scaling: `prismctl dev scale redis 3`
- Extensible service catalog (add ClickHouse, Grafana, custom tools)
- Watch mode for auto-reload on code changes
- CI mode with `--no-dashboard` flag

**Fun Extras**
- Easter eggs: random preset, chaos mode, demo data
- ASCII art on startup
- Stats tracking with achievements
- Startup time leaderboard

**Implementation Roadmap**
- 8-week plan with 6 phases (core CLI → dashboard → profiles → polish)
- Detailed CLI reference with all commands
- Extensibility guide for custom services

Document stats:
- 1107 lines → 780 lines (29% reduction despite more features)
- Setup complexity: High → Zero
- Fun factor: 😐 → 🚀

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
User request: "resolve conflicts on jrepp/nomad-dev-cluster and push updates to the branch"

Resolved conflict in MEMO-035-nomad-local-development-setup.md by keeping the enhanced
"Zero to Hero in 60 Seconds" version with interactive service picker, TUI dashboard,
and profile system (from jrepp/nomad-dev-cluster branch).

Changes from main:
- Remove build artifacts from git tracking (#7)
- Optimize prismctl local start with health checks and parallel startup (#5)
- Updated .gitignore to exclude docs/ build output
- Enhanced cmd/prismctl/cmd/local.go with improved local start functionality

The merged MEMO-035 focuses on developer experience with one-command setup,
interactive service selection, and production-like orchestration using Nomad.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
User request: "resolve conflicts on jrepp/nomad-dev-cluster and push updates to the branch"

Additional cleanup after merge:
- Truncated MEMO-035 to remove duplicate content from old version
- Removed docs/.nojekyll (build artifact)

The file now properly ends at Revision History section with the enhanced
"Zero to Hero in 60 Seconds" content.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
@mergify
Copy link
Author

mergify bot commented Nov 21, 2025

🧪 CI Insights

Here's what we observed from your CI run for d8f25f9.

🟢 All jobs passed!

But CI Insights is watching 👀

@mergify mergify bot closed this Nov 21, 2025
@mergify mergify bot deleted the mergify/merge-queue/9c0f4e6a2f branch November 21, 2025 01:24
@mergify mergify bot mentioned this pull request Nov 21, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants