feat(web): add vps plan calculator

Author: Dicklesworthstone

.beads/issues.jsonl

@@ -881,7 +881,7 @@
 {"id":"bd-oc5j","title":"Update flywheelDescription metrics for RU","description":"# Task: Update Flywheel Description Metrics\n\n## Location\nFile: apps/web/lib/flywheel.ts\nObject: flywheelDescription (~line 624)\n\n## Current Values\n```typescript\nexport const flywheelDescription = {\n  title: 'The Agentic Coding Flywheel',\n  subtitle: 'Ten tools plus utilities that create unheard-of velocity',\n  description: '...',\n  metrics: {\n    totalStars: '2K+',\n    toolCount: 8,  // ← WRONG - should be 9 with RU\n    languages: ['Go', 'Rust', 'TypeScript', 'Python'],  // ← Add 'Bash'\n    avgInstallTime: '< 30s each',\n    projectsSimultaneous: '8+',\n    agentsParallel: '6+',\n  },\n  keyInsight: '...',  // ← Consider mentioning RU\n};\n```\n\n## Updates Required\n\n### 1. Update toolCount\n```typescript\ntoolCount: 9,  // Now includes RU\n```\n\n### 2. Update languages array\n```typescript\nlanguages: ['Go', 'Rust', 'TypeScript', 'Python', 'Bash'],\n```\n\n### 3. Consider updating subtitle\nCurrent: 'Ten tools plus utilities that create unheard-of velocity'\nThis mentions 'ten tools' but toolCount was 8. With RU it's 9.\n\nOptions:\n- 'Nine tools plus utilities...' (accurate count)\n- 'Multiple tools plus utilities...' (no specific count)\n- Keep 'Ten' if dcg makes it 10 total\n\n### 4. Consider updating keyInsight\nCurrent doesn't mention RU. Could add:\n```typescript\nkeyInsight:\n  'The power comes from how these tools work together. RU keeps repos synced. ' +\n  'Agents figure out what to work on using BV, coordinate via Mail, ' +\n  'search past sessions with CASS, learn from CM, and stay protected by SLB. ' +\n  'NTM orchestrates everything.',\n```\n\n## Verification\n- /flywheel page shows updated metrics\n- Tool count matches actual flywheelTools.length\n- Languages include Bash","status":"closed","priority":2,"issue_type":"task","created_at":"2026-01-11T04:13:18.955838610Z","created_by":"ubuntu","updated_at":"2026-01-11T04:19:52.998005770Z","closed_at":"2026-01-11T04:19:52.998005770Z","close_reason":"Updated toolCount to 9, added Bash to languages, updated keyInsight","source_repo":".","compaction_level":0,"original_size":0,"dependencies":[{"issue_id":"bd-oc5j","depends_on_id":"bd-0iw7","type":"blocks","created_at":"2026-01-11T04:14:00.904793353Z","created_by":"ubuntu","metadata":"","thread_id":""}]}
 {"id":"bd-ofwh","title":"Wizard stepper: reflect markStepComplete updates without reload","description":"apps/web/lib/wizardSteps.ts has an imperative markStepComplete() that writes localStorage, but Stepper reads completion state via a React Query useQuery cache. Because the wizard layout stays mounted across routes, the query never refetches, so the Stepper can show stale completion state until reload. Fix by emitting an in-tab event when completed steps are saved and have useCompletedSteps listen + update query cache (and optionally listen to storage events for cross-tab sync).","status":"closed","priority":2,"issue_type":"bug","created_at":"2025-12-23T03:34:03.995739Z","updated_at":"2025-12-23T03:40:12.835421Z","closed_at":"2025-12-23T03:40:12.835421Z","close_reason":"Fixed: completed steps now dispatch event + useCompletedSteps listens to sync React Query cache (plus storage for cross-tab). Lint + type-check passed.","source_repo":".","compaction_level":0,"original_size":0}
 {"id":"bd-oggw","title":"[Phase 4] DCG Website Landing Page Integration","description":"## Phase 4: Website Landing Page Integration\n\nAdd DCG to the ACFS website landing page tools showcase.\n\n### Background\n\nThe landing page (apps/web/app/page.tsx) showcases the key tools in the ACFS stack. Currently, it features tools like NTM but doesn't mention DCG. For DCG to be a first-class citizen, it needs visibility on the primary marketing page.\n\n### Why This Matters\n\nThe landing page is the first thing users see. If DCG isn't featured there, users won't know about this critical safety feature. High visibility drives adoption.\n\n### Implementation Details\n\nAdd DCG to the tools section with:\n- Shield icon (representing protection)\n- Compelling description highlighting pre-execution blocking\n- Link to DCG tools page\n\n### Files to Modify\n\n- apps/web/app/page.tsx: Add DCG to tools showcase section\n\n### Acceptance Criteria\n\n- DCG appears in tools section on landing page\n- Has appropriate icon, description, and link\n- Fits visual style of existing tool cards","status":"closed","priority":2,"issue_type":"feature","created_at":"2026-01-11T03:48:06.508206712Z","created_by":"ubuntu","updated_at":"2026-01-11T06:22:43.400566790Z","closed_at":"2026-01-11T06:22:43.400566790Z","close_reason":"Landing page flywheel tool preview already includes DCG in FLYWHEEL_TOOLS","source_repo":".","compaction_level":0,"original_size":0,"dependencies":[{"issue_id":"bd-oggw","depends_on_id":"bd-7ifk","type":"blocks","created_at":"2026-01-11T03:52:39.817347357Z","created_by":"ubuntu","metadata":"","thread_id":""}]}
-{"id":"bd-oh3wa","title":"Add VPS provider plan calculator to wizard from capacity profiles","description":"## Parent program\n`bd-nlb8w`; depends on capacity model `bd-e63fl` and should reuse existing provider guidance instead of duplicating it.\n\n## What\nAdd a wizard/Learning Hub planning surface that maps desired agent count and workload intensity to recommended VPS specs and provider-plan guidance. It should explain RAM/CPU/storage tradeoffs and warn when the user chooses an undersized host.\n\n## Why\nThe README already argues for 48-64GB RAM, and there is provider guidance. Turning that into an interactive calculator makes the buying decision more concrete for beginners and ambitious swarm users.\n\n## How\nUse static plan/spec data checked into the repo or generated from existing provider docs. If live pricing research is ever used, keep it optional and cacheable; do not make the wizard dependent on external network calls.\n\n## Risks\nProvider pricing changes. Treat prices as approximate and specs as the durable recommendation. Avoid promising exact monthly costs.\n\n## Success criteria\n- User can choose target agent count/workload and receive clear minimum/recommended specs.\n- Calculator points to existing Contabo/OVH/Hetzner guidance without conflicting copy.\n- Web type-check/lint/build and focused UI tests cover the new surface.","status":"open","priority":2,"issue_type":"task","created_at":"2026-05-08T04:33:00.733402140Z","created_by":"ubuntu","updated_at":"2026-05-08T04:36:30.573000946Z","source_repo":".","compaction_level":0,"original_size":0,"labels":["capacity","idea-wizard","swarm","web"],"dependencies":[{"issue_id":"bd-oh3wa","depends_on_id":"bd-e63fl","type":"blocks","created_at":"2026-05-08T04:36:30.572528601Z","created_by":"ubuntu","metadata":"{}","thread_id":""}]}
+{"id":"bd-oh3wa","title":"Add VPS provider plan calculator to wizard from capacity profiles","description":"## Parent program\n`bd-nlb8w`; depends on capacity model `bd-e63fl` and should reuse existing provider guidance instead of duplicating it.\n\n## What\nAdd a wizard/Learning Hub planning surface that maps desired agent count and workload intensity to recommended VPS specs and provider-plan guidance. It should explain RAM/CPU/storage tradeoffs and warn when the user chooses an undersized host.\n\n## Why\nThe README already argues for 48-64GB RAM, and there is provider guidance. Turning that into an interactive calculator makes the buying decision more concrete for beginners and ambitious swarm users.\n\n## How\nUse static plan/spec data checked into the repo or generated from existing provider docs. If live pricing research is ever used, keep it optional and cacheable; do not make the wizard dependent on external network calls.\n\n## Risks\nProvider pricing changes. Treat prices as approximate and specs as the durable recommendation. Avoid promising exact monthly costs.\n\n## Success criteria\n- User can choose target agent count/workload and receive clear minimum/recommended specs.\n- Calculator points to existing Contabo/OVH/Hetzner guidance without conflicting copy.\n- Web type-check/lint/build and focused UI tests cover the new surface.","status":"closed","priority":2,"issue_type":"task","created_at":"2026-05-08T04:33:00.733402140Z","created_by":"ubuntu","updated_at":"2026-05-08T08:54:40.842008571Z","closed_at":"2026-05-08T08:54:40.841730520Z","close_reason":"Added wizard VPS plan calculator with capacity-model recommendations","source_repo":".","compaction_level":0,"original_size":0,"labels":["capacity","idea-wizard","swarm","web"],"dependencies":[{"issue_id":"bd-oh3wa","depends_on_id":"bd-e63fl","type":"blocks","created_at":"2026-05-08T04:36:30.572528601Z","created_by":"ubuntu","metadata":"{}","thread_id":""}]}
 {"id":"bd-ohcu","title":"Fix DCG hook cleanup for nested PreToolUse hooks","description":"remove dcg command hooks nested under hooks.PreToolUse[].hooks; avoid leaving stale hooks","status":"closed","priority":2,"issue_type":"bug","created_at":"2026-01-11T07:59:37.259580174Z","created_by":"ubuntu","updated_at":"2026-01-11T08:00:01.353135421Z","closed_at":"2026-01-11T08:00:01.353135421Z","close_reason":"Completed","source_repo":".","compaction_level":0,"original_size":0}
 {"id":"bd-oky34","title":"Add NTM swarm launch profiles generated from capacity tiers","description":"## Parent program\n`bd-nlb8w`; depends on capacity implementation `bd-ikwa8` and RCH policy `bd-2kncj`.\n\n## What\nAdd ACFS-maintained launch profiles for small, standard, and large agent swarms. Profiles should translate capacity tiers into NTM-friendly session/window counts, suggested agent roles, RCH expectations, and coordination reminders.\n\n## Why\nCapacity guidance is most useful when it produces an executable next step. Users should not have to invent a 25-agent launch pattern from scratch.\n\n## How\nDesign a simple profile format and expose it through docs, onboarding, or an `acfs swarm profile`/`capacity --recommend-ntm` surface. Include role mixes such as implementer, reviewer, test, docs, bug-hunt, and coordinator, while preserving existing NTM ownership.\n\n## Risks\nDo not hard-code a single magic swarm size. Profiles must remain advisory and adapt to host resource classes and available tools.\n\n## Success criteria\n- Profiles exist for at least 5, 10, 25, and 50-agent scenarios.\n- Output includes exact commands or copyable launch plans.\n- RCH/offload and Agent Mail reservation expectations are embedded in each plan.","status":"closed","priority":1,"issue_type":"task","created_at":"2026-05-08T04:32:33.329675710Z","created_by":"ubuntu","updated_at":"2026-05-08T06:36:09.404081916Z","closed_at":"2026-05-08T06:36:09.403822119Z","close_reason":"Completed by SilentPeak; launch-profile and capacity-test artifact evidence comments attached.","source_repo":".","compaction_level":0,"original_size":0,"labels":["capacity","idea-wizard","ntm","swarm"],"dependencies":[{"issue_id":"bd-oky34","depends_on_id":"bd-2kncj","type":"blocks","created_at":"2026-05-08T04:35:55.827029042Z","created_by":"ubuntu","metadata":"{}","thread_id":""},{"issue_id":"bd-oky34","depends_on_id":"bd-ikwa8","type":"blocks","created_at":"2026-05-08T04:35:45.314606111Z","created_by":"ubuntu","metadata":"{}","thread_id":""}],"comments":[{"id":90,"issue_id":"bd-oky34","author":"SilentPeak","text":"NTM launch profiles completed. Evidence: acfs capacity --recommend-ntm emits profiles for 5, 10, 25, and 50 agents with copyable ntm spawn commands, role mixes, RCH policy, Agent Mail reservation reminders, Beads/bv workflow reminders, and status based on host capacity. tests/unit/test_capacity.sh verifies the 25-agent pass and 50-agent warn profile cases.","created_at":"2026-05-08T06:35:21Z"}]}
 {"id":"bd-olqj","title":"[Phase E] Landing Page & Polish","description":"# Phase E: Landing Page & Polish\n\n## Purpose\nAdd RU visibility to high-traffic pages for discoverability.\n\n## Part 1: Terminal Animation\n\n### Location\nFile: apps/web/app/page.tsx\nArray: TERMINAL_LINES (~line 36)\n\n### Current Lines\n```typescript\nconst TERMINAL_LINES = [\n  { type: 'command', text: 'curl -fsSL https://agent-flywheel.com/install | bash' },\n  { type: 'output', text: '▸ Detecting Ubuntu 24.04... ✓' },\n  { type: 'output', text: '▸ Installing zsh + oh-my-zsh + powerlevel10k...' },\n  { type: 'output', text: '▸ Installing bun, uv, rust, go...' },\n  { type: 'output', text: '▸ Installing Claude Code, Codex CLI, Gemini CLI...' },\n  { type: 'output', text: '▸ Configuring tmux, ripgrep, lazygit...' },\n  { type: 'output', text: '▸ Setting up Dicklesworthstone stack...' },\n  { type: 'success', text: '✓ Setup complete\\! Run \\'onboard\\' to get started.' },\n];\n```\n\n### Change\nAdd RU-specific line after 'Setting up Dicklesworthstone stack':\n\n```typescript\n{ type: 'output', text: '▸ Configuring repo_updater (ru) for multi-repo sync...' },\n```\n\nOr make existing stack line more specific:\n```typescript\n{ type: 'output', text: '▸ Installing ntm, bv, cass, ru, ubs, slb...' },\n```\n\n## Part 2: Tool Count Update\n\n### Location\nFile: apps/web/lib/flywheel.ts\nObject: flywheelDescription.metrics (~line 652)\n\n### Current\n```typescript\nmetrics: {\n  totalStars: '2K+',\n  toolCount: 8,  // ← Update this\n  ...\n}\n```\n\n### Change\n```typescript\ntoolCount: 9,  // Now includes RU\n```\n\nAlso update subtitle if needed:\n```typescript\nsubtitle: 'Ten tools plus utilities that create unheard-of velocity',\n// Consider: 'Nine core tools plus utilities...'\n```\n\n## Part 3: Verify Tool Detail Page\n\n### Location\nFile: apps/web/app/learn/tools/[tool]/page.tsx\n\n### Verification\n- Visit /learn/tools/ru\n- Page should render RU info from flywheelTools\n- Install command should be copyable\n- Features list should display\n\n## Why This Matters\nThe landing page is first impression. Users should see RU\nmentioned as part of the complete stack they're getting.\n\n## Verification\n- Landing page terminal shows ru installation\n- Tool count is accurate\n- /learn/tools/ru works","status":"closed","priority":3,"issue_type":"task","created_at":"2026-01-11T04:04:24.456889471Z","created_by":"ubuntu","updated_at":"2026-01-11T04:34:26.211456520Z","closed_at":"2026-01-11T04:34:26.211456520Z","close_reason":"Added RU to FLYWHEEL_TOOLS array with indigo-blue gradient and 'Repo Sync' description","source_repo":".","compaction_level":0,"original_size":0,"dependencies":[{"issue_id":"bd-olqj","depends_on_id":"bd-pkvn","type":"blocks","created_at":"2026-01-11T04:05:52.728777674Z","created_by":"ubuntu","metadata":"","thread_id":""}]}