feat: add multi-panel dashboard with commitments, goals, and status bar

- Add dashboard.py with Table.grid() + Panel pattern for auto-alignment
- Implement format_progress_bar() with colored progress indicators
- Add format_commitments_panel() showing status icons and due dates
- Add format_goals_panel() with progress bars and review warnings
- Add format_status_bar() with integrity, streak, and triage counts
- Add DisplayLevel enum for adaptive display (MINIMAL/COMPACT/STANDARD/FULL)
- Add get_dashboard_commitments() and get_dashboard_goals() queries
- Extend Session with dashboard cache fields and DashboardCacheUpdate
- Replace single-line summary with full dashboard in REPL loop
- Add 28 unit tests for dashboard module
- Update README with dashboard visual and new features

All 1598 tests passing.

Author: JRedeker

CHANGELOG.md

@@ -20,6 +20,7 @@ When a feature spec is archived, it should be added here and removed from `ROADM
 - **add-ai-driven-uat** (2025-12-19): AI-driven UAT framework with scenario definitions and mock agent testing
 
 #### AI Integration
+- **improve-ai-credential-usage**: Explicit API credential passing to PydanticAI providers, credential validation, structured logging, CLI auth commands (`jdo auth set`, `jdo auth status`), improved error messages with recovery hints
 - **wire-ai-to-chat** (2025-12-19): Connected PydanticAI agent to ChatScreen with streaming responses and tool invocation
 - **persist-handler-results** (2025-12-19): Wired command handlers to database persistence with confirmation flow
 - **add-ai-coaching-time-management** (2025-12-19): AI time coaching with /hours command and task duration tracking
@@ -28,6 +29,9 @@ When a feature spec is archived, it should be added here and removed from `ROADM
 - **add-commitment-guardrails** (2025-12-19): Validation guardrails for commitment creation with stakeholder and timeline requirements
 - **add-reliability-compliance** (2025-12-19): Command timeout handling, retry logic, and reliability patterns
 
+#### Authentication & CLI
+- **improve-ai-credential-usage**: Added `jdo auth set` and `jdo auth status` CLI commands, credential storage in auth.json with 0600 permissions, explicit provider initialization with `OpenRouterProvider`/`OpenAIProvider`, comprehensive credential error handling with `MissingCredentialsError`, `InvalidCredentialsError`, `UnsupportedProviderError`
+
 ## [0.1.0] - 2025-12-17
 
 Initial development release with core functionality.

README.md

@@ -55,11 +55,12 @@ Tell it in plain language. The AI extracts goals, milestones, commitments, and t
 |---|---|
 | **Conversational Interface** | Chat naturally—the AI structures your goals for you |
 | **Flexible Hierarchy** | Visions, Goals, Milestones, Commitments, Tasks |
+| **Live Dashboard** | Multi-panel display with commitments, goals, progress bars, and status |
 | **Streaming AI Responses** | Responses appear token-by-token with markdown rendering |
 | **Hybrid Input** | Natural language primary, slash commands for power users |
-| **Visual Polish** | Animated spinner, tab completion, status bar, rounded tables |
+| **Visual Polish** | Animated spinner, tab completion, status bar, rounded panels |
 | **Recurring Commitments** | Set it once, generate instances automatically |
-| **Multiple AI Providers** | OpenAI or OpenRouter—your choice |
+| **Multiple AI Providers** | OpenAI, OpenRouter, Anthropic, or Google—your choice |
 | **Local-First Storage** | Your data stays on your machine, always |
 
 ---
@@ -99,8 +100,16 @@ powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | ie
 
 **1. Configure your AI provider**
 
+Using environment variables:
 ```bash
-export OPENAI_API_KEY="sk-..."
+export OPENROUTER_API_KEY="sk-or-..."
+export JDO_AI_PROVIDER="openrouter"
+export JDO_AI_MODEL="gpt-5.1-mini"
+```
+
+Or using the interactive auth command:
+```bash
+jdo auth set openrouter
 ```
 
 <details>
@@ -111,6 +120,12 @@ export OPENROUTER_API_KEY="sk-or-..."
 export JDO_AI_PROVIDER="openrouter"
 ```
 
+Or interactively:
+```bash
+jdo auth set openrouter
+jdo set JDO_AI_PROVIDER=openrouter
+```
+
 </details>
 
 **2. Launch**
@@ -123,6 +138,33 @@ uv run jdo
 
 ---
 
+## The Dashboard
+
+When you launch jdo, you see a live dashboard showing your current state at a glance:
+
+```
+╭─ 📋 Commitments (3 active, 1 at-risk) ───────────────────────────────────────────────────────────╮
+│                                                                                                  │
+│  ●    Send invoice to Client                           Client                  OVERDUE (2 days)  │
+│  ●    Submit Q1 report                                 Finance                     Today 5:00pm  │
+│  ○    Review PR #234                                   Team                            Tomorrow  │
+│                                                                                                  │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ 🎯 Goals (2 active) ────────────────────────────────────────────────────────────────────────────╮
+│                                                                                                  │
+│  Launch MVP                                        ████████████████░░░░     80%        4/5 done  │
+│  Health & Fitness                                  ████████████░░░░░░░░     60%        review ⚠  │
+│                                                                                                  │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭──────────────────────────────────────────────────────────────────────────────────────────────────╮
+│      📊 Integrity: A- (91%) ↑          🔥 Streak: 3 weeks                📥 Triage: 5            │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+```
+
+The dashboard adapts to your data—showing only what's relevant, from a minimal status bar to a full three-panel view.
+
+---
+
 ## Example Conversation
 
 ```
@@ -169,6 +211,7 @@ For power users who prefer instant, deterministic actions:
 | `/list goals` | List all goals |
 | `/list visions` | List all visions |
 | `/commit "..."` | Create a new commitment |
+| `/complete <id>` | Mark a commitment as complete |
 | `/review` | Review visions due for quarterly review |
 
 Or just type naturally—the AI understands plain English.
@@ -181,6 +224,8 @@ Or just type naturally—the AI understands plain English.
 |---------|-------------|
 | `jdo` | Launch the conversational REPL |
 | `jdo capture "text"` | Quick capture for later triage |
+| `jdo auth status` | Show credential status for all providers |
+| `jdo auth set <provider>` | Set API key for an AI provider |
 | `jdo db status` | Show database migration status |
 | `jdo db upgrade` | Apply pending migrations |
 
@@ -212,8 +257,8 @@ Vision ─────────────── "Become financially indepen
 
 | Variable | Default | Description |
 |:---------|:--------|:------------|
-| `JDO_AI_PROVIDER` | `openai` | Provider: `openai`, `openrouter` |
-| `JDO_AI_MODEL` | `gpt-4o` | Model identifier |
+| `JDO_AI_PROVIDER` | `openrouter` | Provider: `openai`, `openrouter` |
+| `JDO_AI_MODEL` | `gpt-5.1-mini` | Model identifier (OpenRouter format for best pricing) |
 | `JDO_TIMEZONE` | `America/New_York` | Your local timezone |
 | `JDO_DATABASE_PATH` | *(platform default)* | Custom database location |
 
@@ -231,6 +276,38 @@ All data is stored locally using platform-appropriate directories:
 - `jdo.db` — SQLite database containing all your data
 - `auth.json` — API credentials storage
 
+### Credential Management
+
+JDO supports storing API credentials securely in a local credentials file. This is the recommended approach over environment variables.
+
+**Interactive setup:**
+```bash
+jdo auth set openai      # Configure OpenAI
+jdo auth set openrouter  # Configure OpenRouter
+jdo auth set anthropic   # Configure Anthropic
+jdo auth set google      # Configure Google AI
+```
+
+**Check status:**
+```bash
+jdo auth status          # Show credential status for all providers
+```
+
+**Credentials are stored in:**
+- Linux: `~/.local/share/jdo/auth.json`
+- macOS: `~/Library/Application Support/jdo/auth.json`
+- Windows: `%LOCALAPPDATA%\jdo\auth.json`
+
+Alternatively, you can use environment variables:
+```bash
+export OPENAI_API_KEY="sk-..."
+export OPENROUTER_API_KEY="sk-or-..."
+export ANTHROPIC_API_KEY="sk-ant-..."
+export GOOGLE_API_KEY="your-google-key"
+export JDO_AI_PROVIDER="openrouter"
+export JDO_AI_MODEL="gpt-5.1-mini"
+```
+
 ---
 
 ## Development
@@ -265,10 +342,10 @@ src/jdo/
 ├── auth/       API key management
 ├── commands/   Command parsing and handlers
 ├── config/     Settings, paths
-├── db/         SQLite engine, migrations
+├── db/         SQLite engine, migrations, queries
 ├── models/     SQLModel entities
-├── output/     Rich formatters for CLI output
-├── repl/       REPL loop and session management
+├── output/     Rich formatters, dashboard panels
+├── repl/       REPL loop, session, dashboard display
 └── cli.py      CLI entry point
 ```
 

coverage.json

@@ -17,6 +17,8 @@
 
 # Import all models to ensure they're registered with SQLModel.metadata
 # This is required for autogenerate to detect model changes
+# Get settings for database path
+from jdo.config.settings import get_settings  # noqa: E402
 from jdo.models import (  # noqa: E402, F401
     CleanupPlan,
     Commitment,
@@ -29,9 +31,6 @@
     Vision,
 )
 
-# Get settings for database path
-from jdo.config.settings import get_settings  # noqa: E402
-
 # Alembic Config object for access to .ini file values
 config = context.config
 

migrations/env.py

@@ -0,0 +1,165 @@
+# Design: Commitment Summary Panel
+
+## Context
+
+Users lose context of their active commitments while using the REPL. This design adds a compact visual summary that appears before each prompt.
+
+## Goals / Non-Goals
+
+**Goals:**
+- Keep users informed of commitment status without explicit queries
+- Minimal visual noise - compact, single-line where possible
+- Consistent with existing Rich styling patterns
+- No interruption to conversational flow
+
+**Non-Goals:**
+- Full-screen dashboard (use `/list` for detailed view)
+- Real-time updates during AI streaming
+- Persistent display that doesn't scroll away
+
+## Research Findings
+
+### Rich Panel vs Layout/Live
+
+**Decision:** Use `Panel.fit()` with `console.print()` - NOT Layout/Live
+
+**Rationale:**
+- Rich Layout is explicitly for "full-screen applications" per Rich docs
+- Rich Live is for animated/updating displays, not static output
+- Panel with sequential print is the correct pattern for REPLs
+- Already proven by 70+ existing `console.print()` calls in codebase
+
+**Sources:**
+- Rich Panel docs: https://rich.readthedocs.io/en/stable/panel.html
+- Rich Live docs: https://rich.readthedocs.io/en/stable/live.html
+- Rich Layout docs: https://rich.readthedocs.io/en/stable/layout.html
+
+### Box Style Selection
+
+**Decision:** Use `box.ROUNDED` for rounded corners (╭─╮╰─╯)
+
+**Rationale:**
+- `box.SIMPLE` has NO visible borders - only horizontal separator lines
+- `box.ROUNDED` produces the rounded corner aesthetic from the visual concept
+- Consistent with existing tables in codebase that use `box.ROUNDED`
+
+**Available box styles:**
+| Style | Appearance | Best For |
+|-------|------------|----------|
+| `ROUNDED` | ╭─╮╰─╯ | Modern, friendly UI ✓ |
+| `SQUARE` | ┌─┐└─┘ | Classic, structured |
+| `DOUBLE` | ╔═╗╚═╝ | Emphasis |
+| `HEAVY` | ┏━┓┗━┛ | Strong emphasis |
+| `MINIMAL` | Light lines | Clean, minimal |
+| `SIMPLE` | Horizontal only | NO visible border |
+
+**Source:** Rich box.py source code
+
+### Relative Date Formatting
+
+**Decision:** Custom ~15-line implementation, not external library
+
+**Rationale:**
+- `humanize.naturalday()` returns "Jun 05" format, not weekday names
+- `arrow.humanize()` outputs "in 3 days" but not "Fri" for same-week dates
+- Exact format needed: "Today", "Tomorrow", "Fri", "in X days"
+- Adding 132KB dependency for single function is overkill
+- Custom implementation is easy to test and maintain
+
+**Implementation:**
+```python
+def format_relative_date(d: date, today: date | None = None) -> str:
+    today = today or date.today()
+    delta = (d - today).days
+    if delta == 0:
+        return "Today"
+    if delta == 1:
+        return "Tomorrow"
+    if 2 <= delta <= 6:
+        return d.strftime("%a")  # Mon, Tue, etc.
+    if delta > 6:
+        return f"in {delta} days"
+    return d.strftime("%Y-%m-%d")  # Past dates: fallback
+```
+
+**Source:** PyPI humanize, arrow, pendulum docs
+
+### Session Caching Strategy
+
+**Decision:** Keep existing caching pattern with rate-limited updates
+
+**Rationale:**
+- SQLite queries are fast (~0.01ms) but toolbar callback runs every keystroke
+- Existing pattern caches `commitment_count` and `triage_count`
+- Extend to cache `at_risk_count` and `next_due` info
+- Update cache only when commitments change (create/complete)
+
+**Trade-off accepted:**
+- Cache may be stale if DB modified externally
+- Acceptable for single-user CLI app
+- Simplifies implementation vs rate-limited live queries
+
+**Source:** prompt_toolkit bottom_toolbar docs, SQLite isolation docs
+
+## Decisions
+
+### Panel Content Structure
+
+Using `Text.assemble()` for inline styled segments:
+
+```python
+content = Text.assemble(
+    ("📋 ", ""),           # Clipboard emoji
+    ("3", "bold"),          # Count in bold
+    (" active ", "dim"),    # Label dimmed
+    ("(", "dim"),
+    ("1", "bold yellow"),   # At-risk count in yellow
+    (" ⚠️)", ""),           # Warning emoji
+    ("  │  ", "dim"),       # Separator
+    ("Next: ", "dim"),      # Label dimmed
+    ("Report", "cyan"),     # Deliverable in cyan
+    (" → ", "dim"),         # Arrow separator
+    ("Fri", "bold cyan"),   # Date in bold cyan
+)
+```
+
+### Color Semantics
+
+Consistent with existing codebase patterns:
+
+| Status | Color | Emoji |
+|--------|-------|-------|
+| Active/Normal | `cyan` / `bold` | 📋 |
+| At-risk | `bold yellow` | ⚠️ 🟡 |
+| Overdue | `bold red` | ❗ 🔴 |
+| Labels | `dim` | - |
+| Success | `green` | ✅ 🟢 |
+
+### Panel Styling
+
+```python
+Panel.fit(
+    content,
+    box=box.ROUNDED,      # Rounded corners
+    border_style="dim",   # Subtle border
+    padding=(0, 1),       # Minimal padding
+)
+```
+
+## Risks / Trade-offs
+
+| Risk | Mitigation |
+|------|------------|
+| Panel adds visual noise | Use `border_style="dim"` for subtle appearance |
+| Cache staleness from external changes | Acceptable for single-user CLI; `/list` shows live data |
+| Emoji rendering on older terminals | Emoji are informational only; text is primary |
+
+## Open Questions
+
+1. **Should panel appear after EVERY command or only commitment-related ones?**
+   - Current decision: After every command for consistent positioning
+   - Can revisit if users find it noisy
+
+2. **What if terminal is narrow?**
+   - `Panel.fit()` will wrap content
+   - Could add `max_width` parameter if needed