gencode-ai 0.1.3 → 0.3.0

package/docs/memory-system.md

@@ -6,11 +6,11 @@ GenCode implements a hierarchical memory system compatible with Claude Code's CL
 
 | Level | Primary (GenCode) | Fallback (Claude Code) |
 |-------|-------------------|------------------------|
-| User | `~/.gencode/AGENT.md` | `~/.claude/CLAUDE.md` |
-| User Rules | `~/.gencode/rules/*.md` | `~/.claude/rules/*.md` |
-| Project | `./AGENT.md` or `./.gencode/AGENT.md` | `./CLAUDE.md` or `./.claude/CLAUDE.md` |
-| Project Rules | `./.gencode/rules/*.md` | `./.claude/rules/*.md` |
-| Local | `./.gencode/AGENT.local.md` | `./.claude/CLAUDE.local.md` |
+| User | `~/.gen/GEN.md` | `~/.claude/CLAUDE.md` |
+| User Rules | `~/.gen/rules/*.md` | `~/.claude/rules/*.md` |
+| Project | `./GEN.md` or `./.gen/GEN.md` | `./CLAUDE.md` or `./.claude/CLAUDE.md` |
+| Project Rules | `./.gen/rules/*.md` | `./.claude/rules/*.md` |
+| Local | `./.gen/GEN.local.md` | `./.claude/CLAUDE.local.md` |
 
 **Loading Logic**: Primary path is checked first; if not found, fallback path is used.
 
@@ -61,24 +61,24 @@ GenCode implements a hierarchical memory system compatible with Claude Code's CL
                                   ▼
 ┌─────────────────────────────────────────────────────────────────────┐
 │ 1. User Level                                                        │
-│    Primary:  ~/.gencode/AGENT.md                                     │
+│    Primary:  ~/.gen/GEN.md                                     │
 │    Fallback: ~/.claude/CLAUDE.md                                     │
-│    Rules:    ~/.gencode/rules/*.md → ~/.claude/rules/*.md            │
+│    Rules:    ~/.gen/rules/*.md → ~/.claude/rules/*.md            │
 └─────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
 ┌─────────────────────────────────────────────────────────────────────┐
 │ 2. Project Level                                                     │
-│    Primary:  ./AGENT.md or ./.gencode/AGENT.md                       │
+│    Primary:  ./GEN.md or ./.gen/GEN.md                       │
 │    Fallback: ./CLAUDE.md or ./.claude/CLAUDE.md                      │
-│    Rules:    ./.gencode/rules/*.md → ./.claude/rules/*.md            │
+│    Rules:    ./.gen/rules/*.md → ./.claude/rules/*.md            │
 │              (with paths: frontmatter for scoping)                   │
 └─────────────────────────────────────────────────────────────────────┘
                                   │
                                   ▼
 ┌─────────────────────────────────────────────────────────────────────┐
 │ 3. Local Level (gitignored)                                          │
-│    Primary:  ./.gencode/AGENT.local.md                               │
+│    Primary:  ./.gen/GEN.local.md                               │
 │    Fallback: ./.claude/CLAUDE.local.md                               │
 └─────────────────────────────────────────────────────────────────────┘
                                   │
@@ -102,34 +102,127 @@ GenCode implements a hierarchical memory system compatible with Claude Code's CL
 
 | Feature | Claude Code | GenCode |
 |---------|-------------|---------|
-| Primary filename | CLAUDE.md | AGENT.md |
+| Primary filename | CLAUDE.md | GEN.md |
 | Fallback support | No | Yes (→ CLAUDE.md) |
-| User directory | ~/.claude/ | ~/.gencode/ → ~/.claude/ |
-| Project directory | .claude/ | .gencode/ → .claude/ |
-| Rules directory | .claude/rules/ | .gencode/rules/ → .claude/rules/ |
+| User directory | ~/.claude/ | ~/.gen/ → ~/.claude/ |
+| Project directory | .claude/ | .gen/ → .claude/ |
+| Rules directory | .claude/rules/ | .gen/rules/ → .claude/rules/ |
 | Path scoping | Yes (paths: frontmatter) | Yes (paths: frontmatter) |
 | @import syntax | Yes | Yes (max 5 levels) |
-| Local files | CLAUDE.local.md | AGENT.local.md |
+| Local files | CLAUDE.local.md | GEN.local.md |
 | Directory-specific | Yes (on-demand) | Not in v1 |
 
+## Memory Merge Strategies
+
+GenCode supports multiple strategies for loading memory files when both CLAUDE.md and GEN.md exist at the same level. This allows you to optimize context size and control which files are loaded.
+
+### Available Strategies
+
+| Strategy | Behavior | Use Case |
+|----------|----------|----------|
+| `fallback` (default) | Load GEN.md if exists, else CLAUDE.md | **Recommended**: Reduces context size while maintaining flexibility |
+| `both` | Load both CLAUDE.md and GEN.md | Maximum context, useful when you need both file's content |
+| `gencode-only` | Only load .gen/GEN.md files | Strict GenCode-only mode |
+| `claude-only` | Only load .claude/CLAUDE.md files | Strict Claude Code compatibility mode |
+
+### How Fallback Works
+
+At each level (user, project, local), the system:
+1. Checks for `.gen/GEN.md` (or `./GEN.md` at project root)
+2. If found: Load GEN.md only, skip CLAUDE.md
+3. If not found: Load `.claude/CLAUDE.md` (or `./CLAUDE.md`) as fallback
+
+**Example:**
+```
+~/.claude/CLAUDE.md exists (global instructions)
+~/.gen/GEN.md does NOT exist
+./project1/.gen/GEN.md exists (project-specific)
+./project2/ has no GEN.md
+
+Loading for project1 (fallback mode):
+- User level: ~/.claude/CLAUDE.md (no ~/.gen/GEN.md)
+- Project level: ./project1/.gen/GEN.md (skip ./CLAUDE.md)
+= Result: Global + Project configs, ~50% context reduction
+
+Loading for project2 (fallback mode):
+- User level: ~/.claude/CLAUDE.md (no ~/.gen/GEN.md)
+- Project level: Nothing found
+= Result: Only global config, maximum context reduction
+```
+
+### Configuring the Strategy
+
+#### 1. Environment Variable (Highest Priority)
+
+```bash
+export GEN_MEMORY_STRATEGY=fallback  # or both, gencode-only, claude-only
+gencode "help me with this code"
+```
+
+#### 2. Settings File (User or Project Level)
+
+Add to `~/.gen/settings.json` or `./.gen/settings.json`:
+
+```json
+{
+  "memoryMergeStrategy": "fallback"
+}
+```
+
+#### 3. Default Behavior
+
+If not specified, defaults to `fallback` mode.
+
+### Verbose Mode
+
+See which files were loaded and skipped:
+
+```bash
+# Set verbose in config
+{
+  "verbose": true,
+  "memoryMergeStrategy": "fallback"
+}
+
+# Output shows:
+[Memory] Strategy: fallback
+[Memory] user: ~/.gen/GEN.md (0.1 KB)
+[Memory] project: ./GEN.md (3.2 KB)
+[Memory] Skipped: ~/.claude/CLAUDE.md
+[Memory] Total: 3.3 KB (2 files loaded, 1 skipped)
+```
+
+### Context Size Comparison
+
+Real-world example with both user and project memory:
+
+| Strategy | Files Loaded | Total Size | Savings |
+|----------|--------------|------------|---------|
+| `both` (old default) | CLAUDE.md + GEN.md (both levels) | 8.9 KB | Baseline |
+| `fallback` (new default) | GEN.md (user) + CLAUDE.md (project) | 3.4 KB | **61% reduction** |
+| `gencode-only` | GEN.md only | 0.1 KB | **99% reduction** |
+| `claude-only` | CLAUDE.md only | 8.7 KB | 2% reduction |
+
+**Recommendation**: Use `fallback` mode (default) for best balance between context size and flexibility. Only use `both` if you specifically need content from both files at the same level.
+
 ## Commands
 
 ### /init
 
-Analyzes your codebase and generates an AGENT.md file:
+Analyzes your codebase and generates an GEN.md file:
 
 ```
 > /init
 
 Analyzing codebase...
 Found 3 context file(s): package.json, README.md, tsconfig.json
-Generating AGENT.md...
+Generating GEN.md...
 ```
 
 The command:
 1. Scans for package.json, README.md, Makefile, etc.
 2. Builds a prompt asking the AI to generate project instructions
-3. Creates or updates AGENT.md via the Write tool
+3. Creates or updates GEN.md via the Write tool
 
 ### /memory
 
@@ -139,11 +232,11 @@ Shows all loaded memory files:
 > /memory
 
 Loaded Memory Files:
-  [1] ~/.gencode/AGENT.md (user, 1.2KB)
-  [2] ./AGENT.md (project, 856B)
+  [1] ~/.gen/GEN.md (user, 1.2KB)
+  [2] ./GEN.md (project, 856B)
 
 Loaded Rules:
-  [1] .gencode/rules/api.md (project-rules, 234B)
+  [1] .gen/rules/api.md (project-rules, 234B)
 ```
 
 ### # Quick Add
@@ -152,10 +245,10 @@ Add notes to memory directly:
 
 ```
 # Always use 2-space indentation
-Added to project memory: ./AGENT.md
+Added to project memory: ./GEN.md
 
 ## Prefer async/await over callbacks
-Added to user memory: ~/.gencode/AGENT.md
+Added to user memory: ~/.gen/GEN.md
 ```
 
 - `# note` → adds to project memory
@@ -163,12 +256,12 @@ Added to user memory: ~/.gencode/AGENT.md
 
 ## Rules Directory
 
-Create path-scoped rules in `.gencode/rules/`:
+Create path-scoped rules in `.gen/rules/`:
 
 ```
 your-project/
-├── .gencode/
-│   ├── AGENT.md           # Main project instructions
+├── .gen/
+│   ├── GEN.md           # Main project instructions
 │   └── rules/
 │       ├── code-style.md  # Always loaded
 │       ├── testing.md     # Always loaded
@@ -197,7 +290,7 @@ Rules with `paths:` frontmatter only load when working with matching files.
 Include other files in your memory files:
 
 ```markdown
-# AGENT.md
+# GEN.md
 
 @./docs/architecture.md
 @./docs/conventions.md
@@ -219,13 +312,13 @@ Memory content is injected into the system prompt:
 <claudeMd>
 Codebase and user instructions are shown below...
 
-Contents of ~/.gencode/AGENT.md (user's private global instructions):
+Contents of ~/.gen/GEN.md (user's private global instructions):
 [user memory content]
 
-Contents of ./AGENT.md (project instructions):
+Contents of ./GEN.md (project instructions):
 [project memory content]
 
-Rule from .gencode/rules/api.md (applies to: src/api/**):
+Rule from .gen/rules/api.md (applies to: src/api/**):
 [rule content]
 </claudeMd>
 ```
@@ -233,6 +326,6 @@ Rule from .gencode/rules/api.md (applies to: src/api/**):
 ## Best Practices
 
 1. **Keep memory concise** - Memory files are loaded every session
-2. **Use rules for path-specific guidance** - Avoid cluttering main AGENT.md
+2. **Use rules for path-specific guidance** - Avoid cluttering main GEN.md
 3. **Use local files for personal notes** - .gitignore automatically includes them
 4. **Leverage fallback for Claude Code users** - Existing CLAUDE.md files work automatically

package/docs/operating-modes.md

@@ -0,0 +1,96 @@
+# Operating Modes
+
+> Reference: [Claude Code](https://claude.ai/code) operating modes
+
+GenCode has **3 operating modes** that can be cycled with `Shift+Tab`:
+
+```
+Normal (default)
+    ↓ Shift+Tab
+Plan (⏸ plan mode on)
+    ↓ Shift+Tab
+Accept (⏵⏵ accept edits on)
+    ↓ Shift+Tab
+Normal
+    ...
+```
+
+## Mode Comparison
+
+| Mode | Status Indicator | Edit Confirmation | Available Tools |
+|------|------------------|-------------------|-----------------|
+| **Normal** | _(none)_ | Required | All |
+| **Plan** | `⏸ plan mode on (shift+tab to cycle)` | N/A (edits blocked) | Read-only |
+| **Accept** | `⏵⏵ accept edits on (shift+tab to cycle)` | Auto-approved | All |
+
+## Mode Details
+
+### 1. Normal Mode (Default)
+
+- Normal execution mode
+- Every Write/Edit operation requires user confirmation
+- All tools available
+- Default mode when GenCode starts
+
+### 2. Plan Mode
+
+- Read-only exploration mode for designing implementation approaches
+- Write, Edit, and Bash tools are blocked
+- Used for understanding codebase and creating implementation plans
+
+**Allowed Tools:** Read, Glob, Grep, WebFetch, WebSearch, TodoWrite, AskUserQuestion
+
+**Blocked Tools:** Write, Edit, Bash
+
+### 3. Auto-accept Mode
+
+- Automatic edit acceptance mode
+- Write/Edit operations are automatically approved without confirmation
+- Useful when trusting the agent or after approving a plan
+- **Caution**: May cause unintended file changes
+
+## Plan Mode Workflow
+
+When in Plan mode, the agent goes through 5 phases:
+
+```
+EnterPlanMode
+     ↓
+┌─────────────┐
+│Understanding│ ← Explore codebase
+└──────┬──────┘
+       ↓
+┌─────────────┐
+│   Design    │ ← Design approach
+└──────┬──────┘
+       ↓
+┌─────────────┐
+│   Review    │ ← (Optional) Clarify requirements
+└──────┬──────┘
+       ↓
+┌─────────────┐
+│   Final     │ ← Write plan to file
+└──────┬──────┘
+       ↓
+ExitPlanMode
+       ↓
+┌─────────────┐
+│  Approval   │ ← User approves/modifies/cancels
+└─────────────┘
+```
+
+## Plan Approval Options
+
+When exiting Plan mode:
+
+| Option | Description | Next Mode |
+|--------|-------------|-----------|
+| **approve** | Accept plan, auto-accept edits | Accept |
+| **approve_manual** | Accept plan, manually approve each edit | Normal |
+| **modify** | Return to modify the plan | Plan |
+| **cancel** | Cancel plan entirely | Normal |
+
+## References
+
+- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices)
+- [Plan Mode Proposal](./proposals/0004-plan-mode.md)

package/docs/permissions.md

@@ -165,7 +165,7 @@ GenCode uses a multi-level configuration system (Claude Code compatible):
 | Project | `.claude/settings.json` | Project settings (tracked in git) |
 | Project local | `.claude/settings.local.json` | Project settings (gitignored) |
 
-**Fallback**: If `.claude/` doesn't exist, GenCode falls back to `.gencode/` directories.
+**Fallback**: If `.claude/` doesn't exist, GenCode falls back to `.gen/` directories.
 
 **Loading order**: User → Project → Project local (later overrides earlier for scalar values, arrays are concatenated)
 
@@ -231,7 +231,7 @@ When a tool requires confirmation, you can choose:
 2. **Yes, and don't ask again** - Add a persistent rule to project settings
 3. **No** - Block this operation
 
-When you select "don't ask again", the rule is saved to `.claude/settings.local.json` (or `.gencode/settings.local.json` if using GenCode directories).
+When you select "don't ask again", the rule is saved to `.claude/settings.local.json` (or `.gen/settings.local.json` if using GenCode directories).
 
 ## Prompt-Based Permissions
 

package/docs/proposals/0006-memory-system.md

@@ -1,4 +1,4 @@
-# Proposal: Memory System (AGENT.md) with /init Command
+# Proposal: Memory System (GEN.md) with /init Command
 
 - **Proposal ID**: 0006
 - **Author**: mycode team
@@ -10,13 +10,13 @@
 ## Summary
 
 Implement a comprehensive memory system inspired by Claude Code, including:
-1. **AGENT.md files** - Project-specific context that persists across sessions (with CLAUDE.md fallback for compatibility)
+1. **GEN.md files** - Project-specific context that persists across sessions (with CLAUDE.md fallback for compatibility)
 2. **Hierarchical memory loading** - User → Project → Local with rules directories
-3. **/init command** - Automatic project analysis and AGENT.md generation
+3. **/init command** - Automatic project analysis and GEN.md generation
 4. **# prefix** - Quick memory adds during sessions (`# note` for project, `## note` for user)
 5. **/memory command** - View loaded memory files
 6. **@import syntax** - Include other files into memory (max 5 levels)
-7. **.gencode/rules/ directory** - Modular, path-scoped rules with frontmatter
+7. **.gen/rules/ directory** - Modular, path-scoped rules with frontmatter
 
 ## Motivation
 

package/docs/proposals/0008-checkpointing.md

@@ -2,9 +2,9 @@
 
 - **Proposal ID**: 0008
 - **Author**: mycode team
-- **Status**: Draft
+- **Status**: Partially Implemented
 - **Created**: 2025-01-15
-- **Updated**: 2025-01-15
+- **Updated**: 2025-01-17
 
 ## Summary
 
@@ -325,3 +325,110 @@ No breaking changes to existing functionality.
 
 - [Claude Code Checkpointing](https://code.claude.com/docs/en/checkpointing)
 - [Git Reset and Revert](https://git-scm.com/docs/git-reset)
+
+## Implementation Status
+
+### ✅ Implemented (Phase 1-2)
+
+**Core Checkpointing System**:
+- ✅ `CheckpointManager` class with full API
+  - `recordChange()` - Record file changes
+  - `getCheckpoints()` - Get all checkpoints
+  - `getFileHistory()` - Get file-specific history
+  - `rewind()` - Rewind with multiple options (checkpointId, path, all, count)
+  - `getSummary()` - Get change summary
+  - `clearCheckpoints()` - Clear checkpoints
+  - `formatCheckpointList()` - Format for display
+
+**Tool Integration**:
+- ✅ Automatic tracking in `ToolRegistry`
+  - Pre-execution file state capture
+  - Post-execution checkpoint recording
+  - Support for Write and Edit tools
+  - Automatic detection of create/modify/delete operations
+
+**CLI Commands**:
+- ✅ `/changes` - List all file changes in session
+- ✅ `/rewind [n]` - Rewind specific checkpoint by index
+- ✅ `/rewind all` - Rewind all changes
+- ✅ `/rewind` - Show changes list with usage info
+
+**Type System**:
+- ✅ Complete type definitions (`src/checkpointing/types.ts`)
+- ✅ All interfaces from the proposal
+
+**Testing**:
+- ✅ Test example (`examples/test-checkpointing.ts`)
+
+### ❌ Not Implemented (Phase 3-5)
+
+**Session Persistence**:
+- ❌ Checkpoints not saved to session files
+- ❌ No checkpoint restoration when resuming sessions
+- ❌ Session type doesn't include checkpoint data
+- **Impact**: Checkpoints are lost when the session ends
+
+**User Experience Enhancements**:
+- ❌ Confirmation prompt for `/rewind all`
+  - Currently executes immediately without confirmation
+  - Proposal shows interactive confirmation UI
+- ❌ Inline change indicators
+  - Proposal shows checkpoint saved message after each file modification
+  - Currently no visual feedback when checkpoint is created
+- ❌ Formatted change list UI with boxes/borders
+  - Current implementation uses simple text list
+  - Proposal shows fancy bordered display
+
+**Git Integration** (Phase 3):
+- ❌ Optional git-based versioning
+- ❌ Git commits as checkpoints
+- ❌ Integration with git workflow
+
+**Advanced Features** (Phase 4-5):
+- ❌ Selective rewind by time range
+- ❌ Checkpoint browsing UI
+- ❌ Diff viewing between checkpoints
+- ❌ Storage limits and cleanup policies
+- ❌ Large file optimization
+
+### 📋 Remaining Work
+
+To complete this proposal, the following tasks are needed:
+
+1. **Session Persistence** (High Priority):
+   - Add `checkpoints` field to `SessionMetadata` or `Session` type
+   - Save/load checkpoints in `SessionManager`
+   - Restore checkpoint manager state when resuming sessions
+
+2. **Confirmation UI** (Medium Priority):
+   - Add confirmation prompt for `/rewind all` command
+   - Show list of files that will be affected
+   - Allow user to confirm or cancel
+
+3. **Visual Feedback** (Medium Priority):
+   - Show checkpoint saved message after Write/Edit operations
+   - Improve `/changes` display with better formatting
+   - Add color coding for different change types
+
+4. **Git Integration** (Low Priority):
+   - Optional: Use git for checkpoint storage
+   - Optional: Create git commits as checkpoints
+   - Optional: Integrate with existing git workflow
+
+5. **Advanced Features** (Future):
+   - Time-based rewind
+   - Diff viewing
+   - Storage optimization
+
+### 📁 Implementation Files
+
+| File | Status | Notes |
+|------|--------|-------|
+| `src/checkpointing/types.ts` | ✅ Complete | All types defined |
+| `src/checkpointing/checkpoint-manager.ts` | ✅ Complete | Core logic implemented |
+| `src/checkpointing/index.ts` | ✅ Complete | Module exports |
+| `src/tools/registry.ts` | ✅ Modified | Checkpoint tracking added |
+| `src/cli/components/App.tsx` | ✅ Modified | `/changes` and `/rewind` commands |
+| `examples/test-checkpointing.ts` | ✅ Complete | Test coverage |
+| `src/session/types.ts` | ❌ Not Modified | Missing checkpoint fields |
+| `src/session/manager.ts` | ❌ Not Modified | No persistence logic |

package/docs/proposals/0011-custom-commands.md

@@ -3,8 +3,9 @@
 - **Proposal ID**: 0011
 - **Author**: mycode team
 - **Status**: Draft
+- **Priority**: P2 (Enhanced Feature)
 - **Created**: 2025-01-15
-- **Updated**: 2025-01-15
+- **Updated**: 2025-01-17
 
 ## Summary
 

package/docs/proposals/0021-skills-system.md

@@ -3,8 +3,9 @@
 - **Proposal ID**: 0021
 - **Author**: mycode team
 - **Status**: Draft
+- **Priority**: P1 (Core Feature)
 - **Created**: 2025-01-15
-- **Updated**: 2025-01-15
+- **Updated**: 2025-01-17
 
 ## Summary
 

package/docs/proposals/0023-permission-enhancements.md

@@ -487,7 +487,7 @@ Backward compatible with existing rules.
 
 1. **Pattern-Based Rules**: Supports Claude Code format like `Bash(git add:*)` with glob-style wildcards
 2. **Prompt-Based Permissions**: ExitPlanMode style with semantic matching for common operations (run tests, install dependencies, etc.)
-3. **Multi-Scope Permissions**: Session (in-memory), Project (.gencode/permissions.json), Global (~/.gencode/permissions.json)
+3. **Multi-Scope Permissions**: Session (in-memory), Project (.gen/permissions.json), Global (~/.gen/permissions.json)
 4. **Approval Options**: Allow once, Allow for session, Always allow (persistent), Deny
 5. **Audit Logging**: In-memory audit trail with optional file persistence
 6. **CLI Commands**: `/permissions` shows rules, `/permissions audit` shows decision history, `/permissions stats` shows statistics
@@ -507,7 +507,7 @@ Backward compatible with existing rules.
 
 ### Settings Configuration
 
-Add to `~/.gencode/settings.json`:
+Add to `~/.gen/settings.json`:
 ```json
 {
   "permissions": {

package/docs/proposals/0025-cost-tracking.md

@@ -2,9 +2,10 @@
 
 - **Proposal ID**: 0025
 - **Author**: mycode team
-- **Status**: Draft
+- **Status**: Implemented
 - **Created**: 2025-01-15
-- **Updated**: 2025-01-15
+- **Updated**: 2026-01-16
+- **Implemented**: 2026-01-16
 
 ## Summary
 
@@ -439,6 +440,63 @@ Only show costs after session ends.
 
 No breaking changes.
 
+## Implementation Notes
+
+### Phase 1 Complete (2026-01-16)
+
+Implemented core cost tracking functionality with real-time display in CLI.
+
+### Files Created
+
+| File | Description |
+|------|-------------|
+| `src/pricing/types.ts` | Type definitions for pricing and costs |
+| `src/pricing/models.ts` | Model pricing database (updated Jan 2025) |
+| `src/pricing/calculator.ts` | Cost calculation and formatting utilities |
+| `src/pricing/index.ts` | Module exports |
+| `examples/test-cost-tracking.ts` | Test script for cost tracking |
+| `docs/cost-tracking-comparison.md` | Detailed comparison with OpenCode |
+
+### Files Modified
+
+| File | Changes |
+|------|---------|
+| `src/providers/types.ts` | Added `cost?: CostEstimate` to `CompletionResponse` |
+| `src/providers/anthropic.ts` | Calculate and return cost in responses |
+| `src/providers/openai.ts` | Calculate and return cost in responses |
+| `src/providers/gemini.ts` | Calculate and return cost in responses |
+| `src/providers/vertex-ai.ts` | Calculate and return cost in responses |
+| `src/agent/types.ts` | Added `usage` and `cost` to `AgentEventDone` |
+| `src/agent/agent.ts` | Pass usage and cost to done event |
+| `src/cli/components/App.tsx` | Pass cost data to CompletionMessage |
+| `src/cli/components/Messages.tsx` | Display cost and token usage |
+
+### Key Implementation Details
+
+1. **Pricing Database**: Comprehensive pricing for all major models (Anthropic, OpenAI, Google Gemini/Vertex AI) as of January 2025
+
+2. **Cost Calculation**: Simple formula `(tokens / 1M) * pricePerMillion` for each token type
+
+3. **CLI Display Format**: `✻ Done for 2.3s • Tokens: 1.2K in / 567 out • (~$0.02)`
+
+4. **Provider Integration**: All 4 providers (Anthropic, OpenAI, Gemini, Vertex AI) calculate cost when usage data is available
+
+5. **Graceful Degradation**: Cost displays only when provider returns usage data (some stream modes may not include it)
+
+### Testing
+
+- Tested cost calculation with sample data
+- Verified correct pricing for all providers
+- Confirmed CLI display formatting
+
+### Future Enhancements (Phase 2+)
+
+- Session cost aggregation
+- Budget system with alerts
+- Cost reporting (`/costs` command)
+- Multi-provider cost comparison
+- Advanced token types (reasoning, cache)
+
 ## References
 
 - [Anthropic Pricing](https://www.anthropic.com/pricing)

package/docs/proposals/0033-enterprise-deployment.md

@@ -179,7 +179,7 @@ Enterprise Mode: Acme Corp
 Authenticating via SSO...
 
 Opening browser for authentication...
-✓ Authenticated as john.doe@acme.com
+✓ Authenticated as user@company.com
 
 Session policies:
 - Allowed providers: anthropic, openai