@ridit/lens 0.3.4 → 0.3.6

package/LENS.md

@@ -1,41 +1,48 @@
 # Lens
-> Generated: 2026-03-24T12:54:30.944Z
+> Generated: 2026-03-24T15:21:42.840Z
 
 ## Overview
-Lens is an AI-powered CLI tool built with React and Ink that lets users explore, understand, and modify codebases through natural language. It provides chat functionality, code reviews, commit message generation, and timeline exploration of repositories. The tool connects to multiple LLM providers and gives AI direct access to the filesystem, shell, and web.
+Lens is an AI-powered CLI tool built with React and Ink that enables natural language interaction with codebases. It provides chat-based exploration, code modification, repository analysis, timeline viewing, and smart commit generation. The tool connects to multiple LLM providers (Anthropic, OpenAI, Gemini, Ollama) and gives AI access to filesystem operations, shell commands, and web tools through a plugin system.
 
 ## Architecture
-The system uses a command-based architecture where each major feature (chat, review, commit, timeline) is implemented as a separate command component. These components use React with Ink for terminal rendering and manage complex multi-step interactions through state machines. The AI provider system in src/utils/ai.ts provides a unified interface to multiple LLM APIs, while the tool system allows the AI to interact with the filesystem and execute commands.
+The architecture follows a command-based structure with Ink components for terminal UI rendering. Each CLI command (chat, commit, review, task, timeline) has a corresponding React component in src/commands/ that handles the specific workflow. The system uses discriminated union types for state management across multi-step processes. Tool execution is managed through a centralized registry system that supports plugins via @ridit/lens-sdk.
 
 ## Tooling & Conventions
 - **packageManager**: bun
 - **language**: TypeScript
 - **runtime**: Node.js
-- **bundler**: tsup
-- **framework**: React + Ink
+- **bundler**: bun build
+- **framework**: Ink + React
+- **testRunner**: jest (configured but not actively used)
+- **linter**: TypeScript compiler with strict settings
 
 ## Important Folders
-- src/commands: Contains chat.tsx, commit.tsx, review.tsx, timeline.tsx - each exports an Ink component that is the top-level renderer for that CLI command
-- src/utils: Contains ai.ts with callModel abstraction supporting Anthropic/Gemini/Ollama/OpenAI providers via a unified Provider type
-- src/components: Contains React components for terminal UI rendering using Ink
+- src/commands: Contains CLI command entry points (chat.tsx, commit.tsx, review.tsx, task.tsx, timeline.tsx) that render Ink components
+- src/components: Houses reusable UI components organized by feature (chat/, repo/, timeline/, task/) with associated hooks
+- src/utils: Core utilities including AI integration (ai.ts), configuration management (config.ts), git operations (git.ts), and tool registry (tools/)
+- src/tools: Filesystem, shell, web, and PDF tools that the AI can call through the tool registry system
 
 ## Key Files
-- src/utils/ai.ts: callModel abstraction supporting anthropic/gemini/ollama/openai providers via a unified Provider type
-- src/commands/chat.tsx: Main chat interface component with session management
-- src/commands/commit.tsx: Commit message generation from staged changes
-- src/commands/review.tsx: Code review functionality for repositories
-- src/commands/timeline.tsx: Commit history exploration interface
+- src/index.tsx: Main CLI entry point that sets up Commander.js with all command handlers and loads built-in tools
+- src/utils/tools/registry.ts: Central tool registry implementing the @ridit/lens-sdk interface for tool management and system prompt generation
+- src/utils/ai.ts: Provider-agnostic AI integration with support for Anthropic, OpenAI, Ollama, and custom providers through unified interfaces
+- src/types/chat.ts: Core type definitions for chat messages, tool calls, and state management using discriminated unions
+- src/components/chat/ChatRunner.tsx: Main chat interface component handling tool execution, permission prompts, and clone operations
 
 ## Patterns & Idioms
-- Discriminated union state machines (type + stage fields) for multi-step UI flows in every command component
-- Provider abstraction pattern in ai.ts that handles multiple AI APIs through a unified interface
-- React hooks combined with Ink components for terminal rendering management
+- Discriminated union state machines (type + stage fields) for multi-step UI flows in every command component (ChatStage, AnalysisStage, etc)
+- Centralized tool registry pattern with plugin system support through @ridit/lens-sdk interface
+- Provider abstraction layer that supports multiple LLM backends with consistent interfaces
+- File-based memory system that persists chat history and context across sessions per repository
+- Ink component composition with hooks for input handling and state management
 
 ## Suggestions
-- In src/utils/ai.ts, callModel has no retry logic - adding exponential backoff would improve reliability for Ollama which can be slow to start
-- The provider configuration system could benefit from validation and error handling for malformed API keys or endpoints
-- Consider adding tests for the AI provider abstraction to ensure consistent behavior across different providers
+- In src/utils/ai.ts, callModel has no retry logic — adding exponential backoff would improve reliability for ollama which can be slow to start
+- The tool registry in src/utils/tools/registry.ts lacks validation for tool name conflicts during registration
+- src/utils/git.ts uses simple execSync for git operations which could benefit from proper error handling and timeout management
+- The discriminated union types in src/types/chat.ts could use branded types for better type safety
+- The build process in package.json uses a postbuild script to add node shebang which could be replaced with bun's native --target=binary option
 
 <!--lens-json
-{"overview":"Lens is an AI-powered CLI tool built with React and Ink that lets users explore, understand, and modify codebases through natural language. It provides chat functionality, code reviews, commit message generation, and timeline exploration of repositories. The tool connects to multiple LLM providers and gives AI direct access to the filesystem, shell, and web.","importantFolders":["src/commands: Contains chat.tsx, commit.tsx, review.tsx, timeline.tsx - each exports an Ink component that is the top-level renderer for that CLI command","src/utils: Contains ai.ts with callModel abstraction supporting Anthropic/Gemini/Ollama/OpenAI providers via a unified Provider type","src/components: Contains React components for terminal UI rendering using Ink"],"tooling":{"packageManager":"bun","language":"TypeScript","runtime":"Node.js","bundler":"tsup","framework":"React + Ink"},"keyFiles":["src/utils/ai.ts: callModel abstraction supporting anthropic/gemini/ollama/openai providers via a unified Provider type","src/commands/chat.tsx: Main chat interface component with session management","src/commands/commit.tsx: Commit message generation from staged changes","src/commands/review.tsx: Code review functionality for repositories","src/commands/timeline.tsx: Commit history exploration interface"],"patterns":["Discriminated union state machines (type + stage fields) for multi-step UI flows in every command component","Provider abstraction pattern in ai.ts that handles multiple AI APIs through a unified interface","React hooks combined with Ink components for terminal rendering management"],"architecture":"The system uses a command-based architecture where each major feature (chat, review, commit, timeline) is implemented as a separate command component. These components use React with Ink for terminal rendering and manage complex multi-step interactions through state machines. The AI provider system in src/utils/ai.ts provides a unified interface to multiple LLM APIs, while the tool system allows the AI to interact with the filesystem and execute commands.","suggestions":["In src/utils/ai.ts, callModel has no retry logic - adding exponential backoff would improve reliability for Ollama which can be slow to start","The provider configuration system could benefit from validation and error handling for malformed API keys or endpoints","Consider adding tests for the AI provider abstraction to ensure consistent behavior across different providers"],"generatedAt":"2026-03-24T12:54:30.944Z","lastUpdated":"2026-03-24T12:54:30.944Z"}
+{"overview":"Lens is an AI-powered CLI tool built with React and Ink that enables natural language interaction with codebases. It provides chat-based exploration, code modification, repository analysis, timeline viewing, and smart commit generation. The tool connects to multiple LLM providers (Anthropic, OpenAI, Gemini, Ollama) and gives AI access to filesystem operations, shell commands, and web tools through a plugin system.","importantFolders":["src/commands: Contains CLI command entry points (chat.tsx, commit.tsx, review.tsx, task.tsx, timeline.tsx) that render Ink components","src/components: Houses reusable UI components organized by feature (chat/, repo/, timeline/, task/) with associated hooks","src/utils: Core utilities including AI integration (ai.ts), configuration management (config.ts), git operations (git.ts), and tool registry (tools/)","src/tools: Filesystem, shell, web, and PDF tools that the AI can call through the tool registry system"],"tooling":{"packageManager":"bun","language":"TypeScript","runtime":"Node.js","bundler":"bun build","framework":"Ink + React","testRunner":"jest (configured but not actively used)","linter":"TypeScript compiler with strict settings"},"keyFiles":["src/index.tsx: Main CLI entry point that sets up Commander.js with all command handlers and loads built-in tools","src/utils/tools/registry.ts: Central tool registry implementing the @ridit/lens-sdk interface for tool management and system prompt generation","src/utils/ai.ts: Provider-agnostic AI integration with support for Anthropic, OpenAI, Ollama, and custom providers through unified interfaces","src/types/chat.ts: Core type definitions for chat messages, tool calls, and state management using discriminated unions","src/components/chat/ChatRunner.tsx: Main chat interface component handling tool execution, permission prompts, and clone operations"],"patterns":["Discriminated union state machines (type + stage fields) for multi-step UI flows in every command component (ChatStage, AnalysisStage, etc)","Centralized tool registry pattern with plugin system support through @ridit/lens-sdk interface","Provider abstraction layer that supports multiple LLM backends with consistent interfaces","File-based memory system that persists chat history and context across sessions per repository","Ink component composition with hooks for input handling and state management"],"architecture":"The architecture follows a command-based structure with Ink components for terminal UI rendering. Each CLI command (chat, commit, review, task, timeline) has a corresponding React component in src/commands/ that handles the specific workflow. The system uses discriminated union types for state management across multi-step processes. Tool execution is managed through a centralized registry system that supports plugins via @ridit/lens-sdk.","suggestions":["In src/utils/ai.ts, callModel has no retry logic — adding exponential backoff would improve reliability for ollama which can be slow to start","The tool registry in src/utils/tools/registry.ts lacks validation for tool name conflicts during registration","src/utils/git.ts uses simple execSync for git operations which could benefit from proper error handling and timeout management","The discriminated union types in src/types/chat.ts could use branded types for better type safety","The build process in package.json uses a postbuild script to add node shebang which could be replaced with bun's native --target=binary option"],"generatedAt":"2026-03-24T15:21:42.840Z","lastUpdated":"2026-03-24T15:21:42.840Z"}
 lens-json-->

package/README.md

@@ -30,26 +30,28 @@ npm install -g @ridit/lens
 ## CLI Commands
 
 ```
-lens chat / vibe                        chat with your codebase
+lens chat                               chat with your codebase
 lens chat -p /path/to/repo              chat in a specific repo
 
-lens review / judge                     AI review of the current directory
+lens review                             AI review of the current directory
 lens review /path/to/repo               AI review of a specific repo
 
-lens repo / stalk <url>                 analyze a remote GitHub repository
+lens repo <url>                         analyze a remote GitHub repository
 
-lens task / cook <text>                 apply a natural language change to the codebase
-lens task / cook <text> -p /path        apply change to a specific repo
+lens task <text>                        apply a natural language change to the codebase
+lens task <text> -p /path               apply change to a specific repo
 
-lens commit / crimes                    generate a smart commit message from staged changes
-lens commit / crimes [files...]         stage specific files and generate a commit message
-lens commit / crimes --auto             stage all changes and commit without confirmation
-lens commit / crimes --confirm          show preview before committing when using --auto
-lens commit / crimes --preview          show the generated message without committing
-lens commit / crimes --push             push to remote after committing
+lens commit                             generate a smart commit message from staged changes
+lens commit [files...]                  stage specific files and generate a commit message
+lens commit --auto                      stage all changes and commit without confirmation
+lens commit --confirm                   show preview before committing when using --auto
+lens commit --preview                   show the generated message without committing
+lens commit  --push                     push to remote after committing
 
-lens timeline / history                 explore commit history
-lens timeline / history -p /path        explore history of a specific repo
+lens timeline                           explore commit history
+lens timeline -p /path                  explore history of a specific repo
+
+lens run                                Run your dev server. Lens detects and fixes errors automatically
 
 lens provider                           configure AI providers
 ```
@@ -88,4 +90,4 @@ Custom tools can be built and registered using `[@ridit/lens-sdk](https://www.np
 
 ## License
 
-MIT
+MIT