roguelike-cli 1.2.0 → 1.2.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Creative Ventures
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -13,196 +13,284 @@
   '  '
 
 ╔═════════════════════════╗
-║    Roguelike CLI v1.1   ║
+║      Roguelike CLI      ║
 ╚═════════════════════════╝
 ```
 
-AI-powered interactive terminal for creating schemas, architectures and todo lists.
+## What is this?
 
-## Install
+**A new format for notes, schemas, and todo lists — where every task is a folder.**
 
-```bash
-npm i -g roguelike-cli
-```
+Instead of flat text files, your tasks become a **file system tree**. Nested tasks = nested folders. You can:
 
-## Usage
+- **Navigate** your todos like directories (`cd`, `ls`, `tree`)
+- **Attach files** directly to tasks (just put them in the folder)
+- **Track dependencies** and blockers between tasks
+- **Generate beautiful visualizations** — trees, block diagrams, and dungeon maps
+- Let **AI help** you structure complex projects
+
+## Why folders?
 
-```bash
-rlc
+```
+project/
+├── phase-1-research/
+│   ├── market-analysis/
+│   │   └── competitors.xlsx      <- attach files directly
+│   └── user-interviews/
+├── phase-2-development/
+│   ├── backend-api/
+│   ├── frontend-ui/
+│   └── database-schema/
+└── phase-3-launch/
+    ├── marketing/
+    └── deployment/
 ```
 
-First run will start the setup wizard to configure:
-- Storage path for your notes
-- AI provider (Claude, GPT, Gemini, Grok)
-- API key
+Your file manager becomes your task manager. Git tracks your progress. AI generates the structure.
 
-## Commands
+## Install
 
-| Command | Description |
-|---------|-------------|
-| `ls` | List all schemas, todos, and notes |
-| `tree` | Show directory tree structure |
-| `tree -A` | Show tree with files |
-| `tree --depth=N` | Limit tree depth |
-| `cd <node>` | Navigate into a node |
-| `cd ..` | Go back to parent |
-| `..` | Same as cd .. |
-| `pwd` | Show current path |
-| `open` | Open current folder in Finder |
-| `open <folder>` | Open specific folder in Finder |
-| `mkdir <name>` | Create new folder |
-| `cp <src> <dest>` | Copy file or folder |
-| `mv <src> <dest>` | Move/rename file or folder |
-| `rm <name>` | Delete file |
-| `rm -rf <name>` | Delete folder recursively |
-| `config` | Show configuration |
-| `config:apiKey=<key>` | Set API key |
-| `init` | Run setup wizard |
-| `help` | Show examples |
-| `clean` | Show items to delete |
-| `clean --yes` | Delete all items in current folder |
-| `exit` / `quit` | Exit the program |
+```bash
+npm i -g roguelike-cli
+rlc
+```
 
 ## Workflow
 
-1. Type description (e.g., `todo: deploy app`)
-2. AI generates schema preview
-3. Refine with more instructions if needed
-4. Type `save` to save or `cancel` to discard
-
-**Todo** creates folder structure, **Schema** saves as `.rlc.schema` file.
-
-## Clipboard
-
-Add `| pbcopy` (macOS), `| copy` or `| clip` (Windows) to any command:
-
 ```
-> ls | pbcopy
-> tree | pbcopy
-> config | copy
+> todo launch my startup
+
+├── Research
+│   ├── Market analysis
+│   ├── Competitor research
+│   └── User interviews
+├── Development
+│   ├── MVP features
+│   ├── Backend API
+│   └── Frontend UI
+├── Launch
+│   ├── Marketing campaign
+│   └── Press release
+└── Growth
+    ├── Metrics tracking
+    └── User feedback
+
+[Type "save" to create folder launch-my-startup/]
+> save
+Created todo folder: launch-my-startup/
+
+> cd launch-my-startup
+> tree
+├── research/
+│   ├── market-analysis/
+│   ├── competitor-research/
+│   └── user-interviews/
+├── development/
+│   ├── mvp-features/
+│   ├── backend-api/
+│   └── frontend-ui/
+├── launch/
+│   ├── marketing-campaign/
+│   └── press-release/
+└── growth/
+    ├── metrics-tracking/
+    └── user-feedback/
 ```
 
-## Examples
-
-### Todo List
+Now you can `cd development/backend-api` and drop your actual code files there!
 
-```
-> todo opening company in delaware
+## Visualizations
 
-├── register business name
-├── file incorporation papers
-├── get EIN number
-└── Branch: legal
-    └── open business bank account
+### Tree View (default)
 
-[Type "save" to create folder opening-company-in-delaware/]
+```
+├── Phase 1: Setup
+│   ├── Create repository
+│   ├── Setup CI/CD
+│   └── Configure environment
+├── Phase 2: Development
+│   ├── Backend API
+│   └── Frontend UI
+└── Phase 3: Deploy
 ```
 
-### Cloud Infrastructure Schema
+### Block Diagram (for architecture)
 
 ```
-> yandex cloud production infrastructure
+> schema kubernetes cluster
 
 ┌─────────────────────────────────────────────────────────────┐
-│                  Yandex Cloud                               │
+│                  Kubernetes Cluster                         │
 │                                                             │
-│  ┌──────────────────┐      ┌──────────────────┐           │
-│  │ back-fastapi     │      │ admin-next       │           │
-│  │ (VM)             │      │ (VM)             │           │
-│  └────────┬─────────┘      └──────────────────┘           │
-│           │                                                 │
-│           ├──────────────────┬─────────────────┐           │
-│           │                  │                 │           │
-│  ┌────────▼────────┐  ┌─────▼──────┐   ┌──────▼────────┐  │
-│  │   PostgreSQL    │  │   Redis    │   │  Cloudflare   │  │
-│  │  (Existing DB)  │  │  Cluster   │   │  R2 Storage   │  │
-│  └─────────────────┘  └────────────┘   └───────────────┘  │
+│  ┌──────────────┐      ┌──────────────┐                    │
+│  │   postgres   │      │    redis     │                    │
+│  │              │      │              │                    │
+│  │ primary-pod  │      │ cache-pod-1  │                    │
+│  │ replica-pod  │      │ cache-pod-2  │                    │
+│  └──────┬───────┘      └──────┬───────┘                    │
+│         └──────────┬───────────┘                            │
+│                    ▼                                        │
+│            ┌───────────────┐                                │
+│            │ worker-nodes  │                                │
+│            └───────────────┘                                │
 └─────────────────────────────────────────────────────────────┘
 ```
 
-### Web Application Architecture
+### Dungeon Map View
 
-```
-> architecture production redis web application
+Visualize your project as a dungeon map. Each room is a task, corridors show dependencies.
 
-├── load-balancer
-├── web-servers
-│   ├── app-server-1
-│   ├── app-server-2
-│   └── app-server-3
-├── redis
-│   ├── cache-cluster
-│   └── session-store
-└── database
-    ├── postgres-primary
-    └── postgres-replica
+```
+> map
+
+  ████████████████████████████████████████
+  █                    █                 █
+  █   [Research]       █   [Development] █
+  █   * Market         █   * Backend     █
+  █   * Users    ──────+───* Frontend    █
+  █                    █   * Database    █
+  █████████+███████████████████+██████████
+           │                   │
+  █████████+███████████████████+██████████
+  █                    █                 █
+  █   [Launch]         █   [Growth]      █
+  █   * Marketing      █   * Metrics     █
+  █   * Press    ──────+───* Feedback    █
+  █   @ BOSS: Ship it! █                 █
+  █                    █                 █
+  ████████████████████████████████████████
+
+Legend: * Task  @ Milestone  + Door  █ Wall
 ```
 
-### Kubernetes Cluster
+## Gamification (Roadmap)
 
-```
-> kubernetes cluster with postgres and redis
+- **XP System** — Earn experience for completing tasks
+- **Achievements** — "First Blood", "100 Tasks", "Deep Nesting"
+- **Boss Tasks** — Major milestones as boss fights
+- **Dungeon Maps** — Explore your project as a roguelike dungeon
+- **Stats** — Track velocity, streaks, completion rates
 
-┌─────────────────────────────────────────────────────────────┐
-│         Kubernetes cluster with clusters postgres          │
-│                                                             │
-│  ┌──────────────┐      ┌──────────────┐                  │
-│  │   postgres   │      │    redis     │                  │
-│  │              │      │              │                  │
-│  │ primary-pod  │      │ cache-pod-1  │                  │
-│  │ replica-pod-1│      │ cache-pod-2  │                  │
-│  │ replica-pod-2│      │              │                  │
-│  └──────┬───────┘      └──────┬───────┘                  │
-│         │                      │                           │
-│         └──────────┬───────────┘                           │
-│                    │                                         │
-│            ┌───────▼────────┐                              │
-│            │ worker-zones   │                              │
-│            │   zone-1       │                              │
-│            │   zone-2       │                              │
-│            └────────────────┘                              │
-└─────────────────────────────────────────────────────────────┘
-```
+## Commands
 
-### Recipe Steps
+| Command | Description |
+|---------|-------------|
+| `ls` | List tasks and files |
+| `tree` | Show task tree |
+| `tree -A` | Include files |
+| `map` | Dungeon map view |
+| `cd <task>` | Enter task |
+| `..` | Go back |
+| `mkdir <name>` | Create task |
+| `open` | Open in Finder |
+| `cp`, `mv`, `rm` | File operations |
+| `config` | Settings |
+| `help` | Examples |
+| `v`, `version` | Show version |
+
+## AI Integration
+
+Just describe what you need:
 
 ```
 > todo bake cookies
 
 ├── Prep
 │   ├── Gather ingredients
-│   └── Preheat oven (375°F)
+│   └── Preheat oven
 ├── Mix
 │   ├── Cream butter + sugar
-│   ├── Add eggs + vanilla
-│   └── Mix in flour
-├── Bake
-│   ├── Shape cookies
-│   └── Bake 8-10 min
+│   └── Add flour
+├── Bake (8-10 min)
 └── Cool & store
+
+> add deadline tomorrow for Bake
+> add blocker "buy flour" for Mix
+> shorter
+> more detailed
+> save
 ```
 
-### Project Planning
+AI understands context and refines until you're happy.
 
+## Examples
+
+### Software Project
+
+```
+> todo build saas app
+
+├── Planning
+│   ├── Define MVP scope
+│   ├── Create wireframes
+│   └── Tech stack decision
+├── Backend
+│   ├── Database schema
+│   ├── API endpoints
+│   ├── Authentication
+│   └── Payment integration
+├── Frontend
+│   ├── Components library
+│   ├── Pages
+│   └── State management
+├── DevOps
+│   ├── CI/CD pipeline
+│   ├── Staging environment
+│   └── Production deployment
+└── Launch
+    ├── Beta testing
+    ├── Marketing site
+    └── Product Hunt launch
 ```
-> todo launch startup
 
-├── Phase 1: Ideation
-│   ├── Market research
-│   ├── Define MVP
-│   └── Create business plan
-├── Phase 2: Development
-│   ├── Build prototype
-│   ├── User testing
-│   └── Iterate
-├── Phase 3: Launch
-│   ├── Marketing campaign
-│   ├── Press release
-│   └── Launch day
-└── Phase 4: Growth
-    ├── Gather feedback
-    ├── Scale infrastructure
-    └── Hire team
+### Life Goals
+
+```
+> todo learn japanese
+
+├── Basics (Month 1-2)
+│   ├── Hiragana
+│   ├── Katakana
+│   └── Basic grammar
+├── Foundation (Month 3-6)
+│   ├── Kanji (500)
+│   ├── Vocabulary (2000 words)
+│   └── Genki textbook
+├── Intermediate (Month 6-12)
+│   ├── JLPT N4 prep
+│   ├── Reading practice
+│   └── Conversation partner
+└── Advanced
+    ├── JLPT N3
+    ├── Watch anime without subs
+    └── Visit Japan
+```
+
+### Infrastructure
+
+```
+> schema cloud infrastructure
+
+┌─────────────────────────────────────────────────────────────┐
+│                     Production                              │
+│                                                             │
+│  ┌──────────────────┐      ┌──────────────────┐           │
+│  │ Load Balancer    │      │ CDN              │           │
+│  └────────┬─────────┘      └──────────────────┘           │
+│           │                                                 │
+│  ┌────────▼────────┐  ┌────────────┐   ┌────────────────┐ │
+│  │   App Servers   │  │   Redis    │   │   PostgreSQL   │ │
+│  │   (3 replicas)  │──│   Cache    │   │   (Primary +   │ │
+│  └─────────────────┘  └────────────┘   │    Replica)    │ │
+│                                         └────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Clipboard
+
+```
+> tree | pbcopy     # macOS
+> tree | clip       # Windows
 ```
 
 ## Website

package/dist/interactive/commands.js

@@ -93,6 +93,116 @@ function createFoldersFromTree(rootPath, treeContent) {
         stack.push({ path: folderPath, indent });
     }
 }
+// Generate dungeon map visualization from folder structure
+function generateDungeonMap(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        return 'Directory does not exist.';
+    }
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    const folders = entries.filter(e => e.isDirectory() && !e.name.startsWith('.'));
+    if (folders.length === 0) {
+        return 'No rooms to display. Create some tasks first.';
+    }
+    const lines = [];
+    const roomWidth = 20;
+    const roomsPerRow = 2;
+    const wall = '█';
+    const door = '+';
+    const task = '*';
+    const milestone = '@';
+    // Group folders into rows of 2
+    const rows = [];
+    for (let i = 0; i < folders.length; i += roomsPerRow) {
+        rows.push(folders.slice(i, i + roomsPerRow));
+    }
+    // Top border
+    lines.push('  ' + wall.repeat(roomWidth * roomsPerRow + 3));
+    rows.forEach((row, rowIndex) => {
+        // Room content
+        for (let line = 0; line < 6; line++) {
+            let rowStr = '  ' + wall;
+            row.forEach((folder, colIndex) => {
+                const name = folder.name.replace(/-/g, ' ');
+                const displayName = name.length > roomWidth - 4
+                    ? name.substring(0, roomWidth - 7) + '...'
+                    : name;
+                // Get sub-items
+                const subPath = path.join(dirPath, folder.name);
+                const subEntries = fs.existsSync(subPath)
+                    ? fs.readdirSync(subPath, { withFileTypes: true })
+                        .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+                    : [];
+                if (line === 0) {
+                    // Empty line
+                    rowStr += ' '.repeat(roomWidth - 1) + wall;
+                }
+                else if (line === 1) {
+                    // Room name
+                    const title = `[${displayName}]`;
+                    const padding = roomWidth - title.length - 1;
+                    rowStr += ' ' + title + ' '.repeat(Math.max(0, padding - 1)) + wall;
+                }
+                else if (line >= 2 && line <= 4) {
+                    // Sub-items
+                    const itemIndex = line - 2;
+                    if (itemIndex < subEntries.length) {
+                        const subName = subEntries[itemIndex].name.replace(/-/g, ' ');
+                        const shortName = subName.length > roomWidth - 6
+                            ? subName.substring(0, roomWidth - 9) + '...'
+                            : subName;
+                        const marker = subName.toLowerCase().includes('boss') ||
+                            subName.toLowerCase().includes('launch') ||
+                            subName.toLowerCase().includes('deploy')
+                            ? milestone : task;
+                        const itemStr = `${marker} ${shortName}`;
+                        const itemPadding = roomWidth - itemStr.length - 1;
+                        rowStr += ' ' + itemStr + ' '.repeat(Math.max(0, itemPadding - 1)) + wall;
+                    }
+                    else {
+                        rowStr += ' '.repeat(roomWidth - 1) + wall;
+                    }
+                }
+                else {
+                    // Empty line
+                    rowStr += ' '.repeat(roomWidth - 1) + wall;
+                }
+                // Add door between rooms
+                if (colIndex < row.length - 1 && line === 3) {
+                    rowStr = rowStr.slice(0, -1) + door + door + door;
+                }
+                else if (colIndex < row.length - 1) {
+                    rowStr = rowStr.slice(0, -1) + wall;
+                }
+            });
+            // Fill empty space if odd number of rooms
+            if (row.length < roomsPerRow) {
+                rowStr += ' '.repeat(roomWidth) + wall;
+            }
+            lines.push(rowStr);
+        }
+        // Bottom border with doors to next row
+        if (rowIndex < rows.length - 1) {
+            let borderStr = '  ' + wall.repeat(Math.floor(roomWidth / 2)) + door;
+            borderStr += wall.repeat(roomWidth - 1) + door;
+            borderStr += wall.repeat(Math.floor(roomWidth / 2) + 1);
+            lines.push(borderStr);
+            // Corridor
+            let corridorStr = '  ' + ' '.repeat(Math.floor(roomWidth / 2)) + '│';
+            corridorStr += ' '.repeat(roomWidth - 1) + '│';
+            lines.push(corridorStr);
+            borderStr = '  ' + wall.repeat(Math.floor(roomWidth / 2)) + door;
+            borderStr += wall.repeat(roomWidth - 1) + door;
+            borderStr += wall.repeat(Math.floor(roomWidth / 2) + 1);
+            lines.push(borderStr);
+        }
+    });
+    // Bottom border
+    lines.push('  ' + wall.repeat(roomWidth * roomsPerRow + 3));
+    // Legend
+    lines.push('');
+    lines.push(`Legend: ${task} Task  ${milestone} Milestone  ${door} Door  ${wall} Wall`);
+    return lines.join('\n');
+}
 // Global session state
 exports.sessionState = {
     pending: null,
@@ -168,6 +278,16 @@ async function processCommand(input, currentPath, config, signal) {
         }
         return result;
     };
+    // Version command
+    if (command === 'v' || command === 'version') {
+        const pkg = require('../../package.json');
+        return wrapResult({ output: `Roguelike CLI v${pkg.version}` });
+    }
+    // Map command - dungeon visualization
+    if (command === 'map') {
+        const dungeonMap = generateDungeonMap(currentPath);
+        return wrapResult({ output: dungeonMap });
+    }
     if (command === 'ls') {
         if (!fs.existsSync(currentPath)) {
             return wrapResult({ output: 'Directory does not exist.' });
@@ -432,6 +552,7 @@ Storage:      ${config.storagePath}
   tree                  - Show directory tree structure
   tree -A               - Show tree with files
   tree --depth=N        - Limit tree depth (e.g., --depth=2)
+  map                   - Dungeon map visualization
   cd <node>             - Navigate into a node
   cd ..                 - Go back to parent
   pwd                   - Show current path
@@ -444,6 +565,7 @@ Storage:      ${config.storagePath}
   rm -rf <name>         - Delete folder recursively
   config                - Show configuration
   config:apiKey=<key>   - Set API key
+  v, version            - Show version
   <description>         - Create schema/todo (AI generates preview)
   save                  - Save pending schema to disk
   cancel                - Discard pending schema

package/dist/interactive/startup.js

@@ -16,7 +16,7 @@ const ASCII_ART = [
     '  \'  \'',
     '',
     '╔═════════════════════════╗',
-    '║    Roguelike CLI v1.0   ║',
+    '║      Roguelike CLI      ║',
     '╚═════════════════════════╝',
     '',
     '  Commands: ls, cd, mkdir, open, cp, mv, rm, tree, pwd, clean',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roguelike-cli",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "AI-powered interactive terminal for creating schemas and todo lists",
   "main": "dist/index.js",
   "bin": {

package/src/interactive/commands.ts

@@ -69,6 +69,130 @@ function createFoldersFromTree(rootPath: string, treeContent: string): void {
   }
 }
 
+// Generate dungeon map visualization from folder structure
+function generateDungeonMap(dirPath: string): string {
+  if (!fs.existsSync(dirPath)) {
+    return 'Directory does not exist.';
+  }
+  
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+  const folders = entries.filter(e => e.isDirectory() && !e.name.startsWith('.'));
+  
+  if (folders.length === 0) {
+    return 'No rooms to display. Create some tasks first.';
+  }
+  
+  const lines: string[] = [];
+  const roomWidth = 20;
+  const roomsPerRow = 2;
+  const wall = '█';
+  const door = '+';
+  const task = '*';
+  const milestone = '@';
+  
+  // Group folders into rows of 2
+  const rows: typeof folders[] = [];
+  for (let i = 0; i < folders.length; i += roomsPerRow) {
+    rows.push(folders.slice(i, i + roomsPerRow));
+  }
+  
+  // Top border
+  lines.push('  ' + wall.repeat(roomWidth * roomsPerRow + 3));
+  
+  rows.forEach((row, rowIndex) => {
+    // Room content
+    for (let line = 0; line < 6; line++) {
+      let rowStr = '  ' + wall;
+      
+      row.forEach((folder, colIndex) => {
+        const name = folder.name.replace(/-/g, ' ');
+        const displayName = name.length > roomWidth - 4 
+          ? name.substring(0, roomWidth - 7) + '...' 
+          : name;
+        
+        // Get sub-items
+        const subPath = path.join(dirPath, folder.name);
+        const subEntries = fs.existsSync(subPath) 
+          ? fs.readdirSync(subPath, { withFileTypes: true })
+              .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+          : [];
+        
+        if (line === 0) {
+          // Empty line
+          rowStr += ' '.repeat(roomWidth - 1) + wall;
+        } else if (line === 1) {
+          // Room name
+          const title = `[${displayName}]`;
+          const padding = roomWidth - title.length - 1;
+          rowStr += ' ' + title + ' '.repeat(Math.max(0, padding - 1)) + wall;
+        } else if (line >= 2 && line <= 4) {
+          // Sub-items
+          const itemIndex = line - 2;
+          if (itemIndex < subEntries.length) {
+            const subName = subEntries[itemIndex].name.replace(/-/g, ' ');
+            const shortName = subName.length > roomWidth - 6 
+              ? subName.substring(0, roomWidth - 9) + '...' 
+              : subName;
+            const marker = subName.toLowerCase().includes('boss') || 
+                          subName.toLowerCase().includes('launch') ||
+                          subName.toLowerCase().includes('deploy')
+              ? milestone : task;
+            const itemStr = `${marker} ${shortName}`;
+            const itemPadding = roomWidth - itemStr.length - 1;
+            rowStr += ' ' + itemStr + ' '.repeat(Math.max(0, itemPadding - 1)) + wall;
+          } else {
+            rowStr += ' '.repeat(roomWidth - 1) + wall;
+          }
+        } else {
+          // Empty line
+          rowStr += ' '.repeat(roomWidth - 1) + wall;
+        }
+        
+        // Add door between rooms
+        if (colIndex < row.length - 1 && line === 3) {
+          rowStr = rowStr.slice(0, -1) + door + door + door;
+        } else if (colIndex < row.length - 1) {
+          rowStr = rowStr.slice(0, -1) + wall;
+        }
+      });
+      
+      // Fill empty space if odd number of rooms
+      if (row.length < roomsPerRow) {
+        rowStr += ' '.repeat(roomWidth) + wall;
+      }
+      
+      lines.push(rowStr);
+    }
+    
+    // Bottom border with doors to next row
+    if (rowIndex < rows.length - 1) {
+      let borderStr = '  ' + wall.repeat(Math.floor(roomWidth / 2)) + door;
+      borderStr += wall.repeat(roomWidth - 1) + door;
+      borderStr += wall.repeat(Math.floor(roomWidth / 2) + 1);
+      lines.push(borderStr);
+      
+      // Corridor
+      let corridorStr = '  ' + ' '.repeat(Math.floor(roomWidth / 2)) + '│';
+      corridorStr += ' '.repeat(roomWidth - 1) + '│';
+      lines.push(corridorStr);
+      
+      borderStr = '  ' + wall.repeat(Math.floor(roomWidth / 2)) + door;
+      borderStr += wall.repeat(roomWidth - 1) + door;
+      borderStr += wall.repeat(Math.floor(roomWidth / 2) + 1);
+      lines.push(borderStr);
+    }
+  });
+  
+  // Bottom border
+  lines.push('  ' + wall.repeat(roomWidth * roomsPerRow + 3));
+  
+  // Legend
+  lines.push('');
+  lines.push(`Legend: ${task} Task  ${milestone} Milestone  ${door} Door  ${wall} Wall`);
+  
+  return lines.join('\n');
+}
+
 export interface CommandResult {
   output?: string;
   newPath?: string;
@@ -181,6 +305,18 @@ export async function processCommand(
     return result;
   };
   
+  // Version command
+  if (command === 'v' || command === 'version') {
+    const pkg = require('../../package.json');
+    return wrapResult({ output: `Roguelike CLI v${pkg.version}` });
+  }
+  
+  // Map command - dungeon visualization
+  if (command === 'map') {
+    const dungeonMap = generateDungeonMap(currentPath);
+    return wrapResult({ output: dungeonMap });
+  }
+  
   if (command === 'ls') {
     if (!fs.existsSync(currentPath)) {
       return wrapResult({ output: 'Directory does not exist.' });
@@ -491,6 +627,7 @@ Storage:      ${config.storagePath}
   tree                  - Show directory tree structure
   tree -A               - Show tree with files
   tree --depth=N        - Limit tree depth (e.g., --depth=2)
+  map                   - Dungeon map visualization
   cd <node>             - Navigate into a node
   cd ..                 - Go back to parent
   pwd                   - Show current path
@@ -503,6 +640,7 @@ Storage:      ${config.storagePath}
   rm -rf <name>         - Delete folder recursively
   config                - Show configuration
   config:apiKey=<key>   - Set API key
+  v, version            - Show version
   <description>         - Create schema/todo (AI generates preview)
   save                  - Save pending schema to disk
   cancel                - Discard pending schema

package/src/interactive/startup.ts

@@ -14,7 +14,7 @@ const ASCII_ART = [
   '  \'  \'',
   '',
   '╔═════════════════════════╗',
-  '║    Roguelike CLI v1.0   ║',
+  '║      Roguelike CLI      ║',
   '╚═════════════════════════╝',
   '',
   '  Commands: ls, cd, mkdir, open, cp, mv, rm, tree, pwd, clean',