feat(cli): use figlet ANSI Shadow for banner instead of hardcoded Unicode escapes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: maystudios

.planning/ROADMAP.md

@@ -20,6 +20,10 @@ Decimal phases appear between their surrounding integers in numeric order.
 - [x] **Phase 6: Test Migration** - Port all 8 test files from node:test to Vitest 4 with correct timeout and coverage config (completed 2026-02-23)
 - [ ] **Phase 7: Wire Hooks into CLI Package** - Add @maxsim/hooks to CLI dependencies/bundledDependencies, fix hooksSrc resolution, validate tarball includes hooks
 - [x] **Phase 8: Fix commands/maxsim/ Path Resolution** - Restructure packages/templates/commands/ to include maxsim/ subdirectory, fixing install.ts ENOENT crash for all runtimes (completed 2026-02-24)
+- [x] **Phase 9: End-to-end install and publish test loop** - Self-contained e2e test script with auto-bump-publish-retry loop (completed 2026-02-24)
+- [x] **Phase 10: CLI UX — chalk, ora spinners, @inquirer/prompts** - Replace raw ANSI codes with chalk, add ora spinners, replace readline prompts with @inquirer/prompts (completed 2026-02-24)
+- [ ] **Phase 11: Remove Discord command and deploy website via GitHub Pages** - Remove `/maxsim:join-discord` from shipped command set, set up GitHub Actions deploy workflow for GitHub Pages
+- [x] **Phase 12: UX Polish + Core Hardening** - ASCII progress bars in `/maxsim:progress`, new `/maxsim:roadmap` read command, sanity check guard at workflow start, centralized `getPhasePattern()` helper, atomic ROADMAP.md writes, and zero silent `catch {}` blocks in `packages/core/src/` (completed 2026-02-24)
 
 ## Phase Details
 
@@ -175,7 +179,7 @@ Plans:
 ## Progress
 
 **Execution Order:**
-Phases execute in dependency order: 1 → 2 → 3 → 4 → 5, with Phase 6 executable after Phase 2 completes. Phases 3 and 4 are independent of each other and can run in any order after Phase 2.
+Phases execute in dependency order: 1 → 2 → 3 → 4 → 5, with Phase 6 executable after Phase 2 completes. Phases 3 and 4 are independent of each other and can run in any order after Phase 2. Phases 7–12 execute sequentially in dependency order.
 
 | Phase | Plans Complete | Status | Completed |
 |-------|----------------|--------|-----------|
@@ -189,7 +193,8 @@ Phases execute in dependency order: 1 → 2 → 3 → 4 → 5, with Phase 6 exec
 | 8. Fix commands/maxsim/ Path Resolution | 1/1 | Complete   | 2026-02-24 |
 | 9. End-to-end install and publish test loop | 2/2 | Complete   | 2026-02-24 |
 | 10. CLI UX — chalk, ora, @inquirer/prompts | 2/2 | Complete | 2026-02-24 |
-| 11. Remove Discord command and deploy website via GitHub Pages | 0/2 | Not started | - |
+| 11. Remove Discord command and deploy website via GitHub Pages | 2/2 | Complete | 2026-02-24 |
+| 12. UX Polish + Core Hardening | 1/3 | In Progress | - |
 
 ### Phase 10: CLI UX — chalk, ora spinners, @inquirer/prompts
 
@@ -227,3 +232,23 @@ Plans:
 Plans:
 - [ ] 11-01-PLAN.md — Remove join-discord.md from templates; update "31" count references in CLAUDE.md, website Docs.tsx, and docs/USER-GUIDE.md; remove from help.md workflow
 - [ ] 11-02-PLAN.md — Add packages/website/project.json NX build target; create CNAME file; create .github/workflows/deploy-website.yml
+
+### Phase 12: UX Polish + Core Hardening
+
+**Goal:** Improve developer-facing UX of the `/maxsim:progress` command (ASCII phase progress bars), add a dedicated `/maxsim:roadmap` read command, add a sanity check guard at workflow start, centralize all phase regex patterns into a single `getPhasePattern()` helper in `packages/core/src/core.ts`, make all ROADMAP.md write operations atomic (build in memory, single write), and eliminate all silent `catch {}` blocks across `packages/core/src/`.
+**Depends on:** Phase 11
+**Requirements:** None new — internal quality and UX improvements
+**Success Criteria** (what must be TRUE):
+  1. `/maxsim:progress` output shows ASCII progress bars per phase (e.g. `[██████░░░░] 60%`)
+  2. `/maxsim:roadmap` command exists and renders ROADMAP.md with status icons in a readable format
+  3. A sanity check runs at the start of execute/plan workflows and warns if `.planning/` is missing or corrupt
+  4. A single `getPhasePattern(phaseNum?: string)` function in `packages/core/src/core.ts` replaces all inline phase regex literals across the codebase
+  5. ROADMAP.md updates in `phase.ts` and `roadmap.ts` use a read-modify-write helper that writes once per operation
+  6. Zero silent `catch {}` blocks remain in `packages/core/src/` — each has either a comment or a `logger.debug()` call
+  7. `nx build core` passes with 0 TypeScript errors
+**Plans:** 3 plans
+
+Plans:
+- [ ] 12-01-PLAN.md — Add `getPhasePattern()` to core.ts; replace all inline phase regex in phase.ts, roadmap.ts, verify.ts; atomic write helper; fix silent catch blocks; build green
+- [ ] 12-02-PLAN.md — Update `/maxsim:progress` workflow to render ASCII progress bars; add `/maxsim:roadmap` command file; add sanity check guard to execute/plan workflows
+- [ ] 12-03-PLAN.md — Integration validation — nx build clean, run tests, verify progress/roadmap commands render correctly

.planning/STATE.md

@@ -5,14 +5,14 @@
 See: .planning/PROJECT.md (updated 2026-02-23)
 
 **Core value:** Users run `npx maxsim@latest` and everything works — the monorepo restructure is invisible to end users
-**Current focus:** Phase 11 — Remove Discord command + GitHub Pages deployment
+**Current focus:** Phase 12 complete — milestone 1 complete
 
 ## Current Position
 
-Phase: 11 of 11 (Remove Discord command and deploy website via GitHub Pages)
-Plan: 2 of 2 in current phase
-Status: Phase 11 plan 02 complete
-Last activity: 2026-02-24 — GitHub Pages deployment setup for packages/website
+Phase: 12 of 12 (UX Polish + Core Hardening) — COMPLETE
+Plan: 3 of 3 in current phase
+Status: ALL PHASES COMPLETE — milestone ready for archive
+Last activity: 2026-02-24 — phase 12 integration validation passed, ROADMAP.md updated
 
 Progress: [██████████] 100%
 
@@ -67,6 +67,8 @@ Progress: [██████████] 100%
 | Phase 10 P01 | 10min | 3 tasks | 3 files |
 | Phase 10 P02 | 20min | 7 tasks | 1 files |
 | Phase 11 P02 | 1min | 2 tasks | 3 files |
+| Phase 12 P02 | 3min | 4 tasks | 12 files |
+| Phase 12 P03 | 4min | 3 tasks | 2 files |
 
 ## Accumulated Context
 
@@ -128,13 +130,18 @@ Recent decisions affecting current work:
 - [10-02]: ora .start()/.succeed()/.fail() are synchronous — install() function stays synchronous
 - [11-02]: CNAME placed in public/ — Vite copies public/ contents to dist/ root automatically during build
 - [11-02]: Two-job workflow (build + deploy) required by actions/deploy-pages pattern; deploy job needs needs: build dependency
+- [12-02]: chalk added to packages/core dependencies (not devDependencies) — used at runtime in cmdProgressRender output
+- [12-02]: phase-bars branch inserted between bar and JSON else branches for clean fallthrough ordering
+- [12-02]: sanity_check inserted before <purpose> tag as first content in each workflow file
+- [12-03]: init.ts and milestone.ts comment-only catches missed by 12-01 scope; fixed during integration validation
 
 ### Roadmap Evolution
 
 - Phase 9 added: End-to-end install and publish test loop
 - Phase 10 added: Wir wollen auf eine richtige CLI Ui beim install und etc. wechseln mithilfe von chalk, ora (Spinner) und @inquirer/prompts
 - Phase 11 added: Remove join-discord command; deploy packages/website to GitHub Pages via GitHub Actions
 - Phase 11 added: Remove Discord command and deploy website via GitHub Actions to GitHub Pages
+- Phase 12 added: UX Polish + Core Hardening
 
 ### Pending Todos
 
@@ -149,5 +156,5 @@ None yet.
 ## Session Continuity
 
 Last session: 2026-02-24
-Stopped at: Completed 11-02-PLAN.md (GitHub Pages deployment: project.json + CNAME + deploy-website.yml)
-Resume file: .planning/phases/11-remove-discord-command-github-pages-deploy/11-02-SUMMARY.md
+Stopped at: Completed 12-03-PLAN.md (integration validation — builds green, phase-bars verified, roadmap files confirmed, catch blocks cleaned up)
+Resume file: .planning/phases/12-ux-polish-core-hardening/12-03-SUMMARY.md

packages/cli/dist/.tsbuildinfo

@@ -1,3 +1,20 @@
+## 1.0.11 (2026-02-24)
+
+### 🚀 Features
+
+- **core:** add chalk dependency and phase-bars format to cmdProgressRender ([121f17c](https://github.com/maystudios/maxsim/commit/121f17c))
+- **templates:** add /maxsim:roadmap command and workflow ([372c8a3](https://github.com/maystudios/maxsim/commit/372c8a3))
+- **templates:** update progress workflow to use phase-bars format ([c9672ee](https://github.com/maystudios/maxsim/commit/c9672ee))
+- **templates:** add sanity_check guard to five major workflow files ([fca2b19](https://github.com/maystudios/maxsim/commit/fca2b19))
+
+### ❤️ Thank You
+
+- Sven
+
+## 1.0.10 (2026-02-24)
+
+This was a version bump only, there were no code changes.
+
 ## 1.0.1 (2026-02-24)
 
 This was a version bump only, there were no code changes.

packages/cli/dist/assets/CHANGELOG.md

@@ -0,0 +1,19 @@
+---
+name: maxsim:roadmap
+description: Display the project roadmap with phase status icons, plan counts, and milestone summary
+allowed-tools:
+  - Read
+  - Bash
+  - Glob
+---
+<objective>
+Render the project roadmap in a human-readable format with phase status icons (✓ DONE, ► IN PROGRESS, □ PLANNED), plan progress counts per phase, and a milestone summary header.
+</objective>
+
+<execution_context>
+@./workflows/roadmap.md
+</execution_context>
+
+<process>
+Execute the roadmap workflow from @./workflows/roadmap.md end-to-end.
+</process>

packages/cli/dist/assets/templates/commands/maxsim/roadmap.md

@@ -1,3 +1,9 @@
+<sanity_check>
+Before executing any step in this workflow, verify:
+1. The current directory contains a `.planning/` folder — if not, stop and tell the user to run `/maxsim:new-project` first.
+2. `.planning/ROADMAP.md` exists — if not, stop and tell the user to initialize the project.
+</sanity_check>
+
 <purpose>
 Extract implementation decisions that downstream agents need. Analyze the phase to identify gray areas, let the user choose what to discuss, then deep-dive each selected area until satisfied.
 

packages/cli/dist/assets/templates/workflows/discuss-phase.md

@@ -1,3 +1,9 @@
+<sanity_check>
+Before executing any step in this workflow, verify:
+1. The current directory contains a `.planning/` folder — if not, stop and tell the user to run `/maxsim:new-project` first.
+2. `.planning/ROADMAP.md` exists — if not, stop and tell the user to initialize the project.
+</sanity_check>
+
 <purpose>
 Execute all plans in a phase using wave-based parallel execution. Orchestrator stays lean — delegates plan execution to subagents.
 </purpose>

packages/cli/dist/assets/templates/workflows/execute-phase.md

@@ -1,3 +1,9 @@
+<sanity_check>
+Before executing any step in this workflow, verify:
+1. The current directory contains a `.planning/` folder — if not, stop and tell the user to run `/maxsim:new-project` first.
+2. `.planning/ROADMAP.md` exists — if not, stop and tell the user to initialize the project.
+</sanity_check>
+
 <purpose>
 Create executable phase prompts (PLAN.md files) for a roadmap phase with integrated research and verification. Default flow: Research (if needed) -> Plan -> Verify -> Done. Orchestrates maxsim-phase-researcher, maxsim-planner, and maxsim-plan-checker agents with a revision loop (max 3 iterations).
 </purpose>

packages/cli/dist/assets/templates/workflows/plan-phase.md

@@ -88,7 +88,7 @@ Use this instead of manually reading/parsing ROADMAP.md.
 
 ```bash
 # Get formatted progress bar
-PROGRESS_BAR=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs progress bar --raw)
+PROGRESS_BAR=$(node ~/.claude/maxsim/bin/maxsim-tools.cjs progress phase-bars --raw)
 ```
 
 Present:

packages/cli/dist/assets/templates/workflows/progress.md

@@ -1,3 +1,9 @@
+<sanity_check>
+Before executing any step in this workflow, verify:
+1. The current directory contains a `.planning/` folder — if not, stop and tell the user to run `/maxsim:new-project` first.
+2. `.planning/ROADMAP.md` exists — if not, stop and tell the user to initialize the project.
+</sanity_check>
+
 <purpose>
 Execute small, ad-hoc tasks with MAXSIM guarantees (atomic commits, STATE.md tracking). Quick mode spawns maxsim-planner (quick mode) + maxsim-executor(s), tracks tasks in `.planning/quick/`, and updates STATE.md's "Quick Tasks Completed" table.