codmir 0.3.2 → 0.4.0

package/LICENSE

@@ -0,0 +1,55 @@
+Copyright (c) 2024-2025 codmir, Inc. All Rights Reserved.
+
+PROPRIETARY SOFTWARE LICENSE AGREEMENT
+
+codmir CLI & SDK
+
+This command-line interface, software development kit, and associated files 
+(the "Software") are the proprietary and confidential information of codmir, Inc.
+
+ALL RIGHTS RESERVED.
+
+USAGE TERMS:
+
+1. This Software is provided to users with a valid codmir account.
+
+2. Licensed users may:
+   - Install the CLI globally on their development machines
+   - Use the SDK in their projects with a valid API key
+   - Access codmir services according to their subscription tier
+
+3. You may NOT:
+   - Redistribute, sublicense, or sell the Software
+   - Modify or create derivative works
+   - Reverse engineer or decompile
+   - Remove proprietary notices
+   - Use without a valid codmir account and API key
+   - Exceed usage limits of your subscription tier
+
+4. This Software connects to codmir's proprietary services which require:
+   - A valid account (free tier available)
+   - API key for authentication
+   - Compliance with Terms of Service
+
+SUBSCRIPTION TIERS:
+
+- Free: Limited features and usage
+- Pro: Full features with usage-based billing
+- Enterprise: Custom pricing and private deployment
+
+DATA & PRIVACY:
+
+- All data transmitted is encrypted
+- Usage data is collected for billing
+- See Privacy Policy at https://codmir.com/privacy
+
+DISCLAIMER:
+
+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.
+
+For licensing inquiries: sales@codmir.com
+For support: support@codmir.com
+Website: https://codmir.com
+Terms of Service: https://codmir.com/terms

package/README.md

@@ -3,18 +3,36 @@
 > TypeScript SDK for codmir API - **the AI that prevents wasted engineering time**.
 
 [![npm version](https://badge.fury.io/js/codmir.svg)](https://www.npmjs.com/package/codmir)
-[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## Features
+We've massively expanded the SDK with game-changing AI features:
 
-- ✅ **Full TypeScript support** with complete type definitions
-- 🎫 **Tickets API** - Create and manage project tickets
-- 🧪 **Test Cases API** - Create, update, and manage test cases
-- 🔐 **API Key authentication** 
-- ⚡ **Promise-based** async/await API
-- 🌐 **Works in Node.js and browsers**
-- 📦 **Zero dependencies**
+- **Codebase Analysis** - Analyze your project in 1-5 seconds, understand structure, dependencies, and patterns
+- **Knowledge Base** - Auto-generated project knowledge for AI context
+- **AI Task Replication** - Save, clone, and resume AI tasks anywhere (like VM snapshots for AI)
+- **Usage Tracking** - Track AI costs per API key with detailed billing
+- **Multi-Agent Support** - Coordinate TARS, Cascade, Overseer agents
+- **Observability** - Session replay and error tracking (separate @codmir/observe package)
+- **IDE Integration** - VSCode extension with project graph visualization
+
+## Core Features
+
+### AI & Automation
+- **AI Assistant** - Interactive AI chat with project context
+- **Codebase Analysis** - Local (fast) or Railway (deep) analysis
+- **Knowledge Base** - Structured project understanding for AI
+- **Task DNA** - Snapshot and replicate AI tasks
+- **Cost Tracking** - Monitor AI usage and costs
+
+### Project Management
+- **Projects** - Create and manage projects
+- **Tickets** - Full ticket lifecycle with AI integration
+- **Tasks** - Track and automate tasks
+
+### Development Tools
+- **Authentication** - Secure API key management
+- **REST API** - Comprehensive API client
+- **TypeScript** - Full type safety
+- **CLI** - Powerful command-line interface
 
 ## Installation
 
@@ -39,11 +57,17 @@ yarn add codmir
 ### As a CLI (Global)
 
 ```bash
-npm install -g codmir
-# or
 pnpm add -g codmir
 ```
 
+**New CLI Commands:**
+- `codmir analyze` - Analyze codebase and generate knowledge base
+- `codmir ai` - Interactive AI assistant with project context
+- `codmir usage` - View API usage and billing stats
+- `codmir task` - Manage AI task snapshots and replication
+
+See [CLI Documentation](./CLI.md) for all commands.
+
 Then authenticate and link your project:
 
 ```bash
@@ -52,7 +76,154 @@ codmir link     # Link current directory to a project
 codmir init     # Initialize with examples
 ```
 
-See [CLI Documentation](./CLI.md) for more details.
+### AI Agent Mode
+
+The CLI includes a powerful AI assistant that understands YOUR codebase:
+
+```bash
+# Interactive agent session
+codmir ai
+
+# With full project context (uses knowledge base)
+codmir ai --context
+
+# Quick query
+codmir ask "How do I setup authentication?"
+```
+
+**Enhanced Features:**
+- 🤖 **Context-Aware AI** - Uses project knowledge base
+- 📋 **Clipboard Support** - Attach images automatically
+- 🔗 **Execution Context** - Knows if you're in a linked project
+- 🖼️ **Media Upload** - Screenshots, diagrams, error messages
+- 💰 **Cost Tracking** - See token usage after each query
+- 🎯 **Smart Responses** - AI follows YOUR code patterns
+
+### Codebase Analysis
+
+Analyze your project to enable context-aware AI:
+
+```bash
+# Link project (auto-prompts to analyze)
+codmir link
+
+# Manual analysis
+codmir analyze
+
+# Deep analysis on Railway
+codmir analyze --mode railway
+
+# Force re-analysis
+codmir analyze --force
+```
+
+**What Gets Analyzed:**
+- 📁 File structure and organization
+- 🔗 Dependencies and imports
+- ⚙️ Tech stack (frameworks, libraries, tools)
+- 📄 Entry points and scripts
+- 📚 Documentation (README, etc.)
+- 🎯 Code patterns and best practices
+
+**Knowledge Base Location:** `.codmir/knowledge/`
+
+### Usage Tracking & Billing
+
+Monitor AI costs and usage per API key:
+
+```bash
+# View current month usage
+codmir usage
+
+# Detailed breakdown by provider
+codmir usage --detailed
+
+# Specific month
+codmir usage --month 2025-12
+```
+
+**Tracks:**
+- 🤖 AI calls per agent (TARS, Cascade, Overseer)
+- 🎟️ Token usage (prompt + completion)
+- 💰 Cost breakdown by provider (OpenAI, Anthropic)
+- 📊 Monthly aggregation
+- 🎯 ROI calculation (time saved)
+
+### AI Task Replication (Coming Soon)
+
+Snapshot and clone AI tasks like VM snapshots:
+
+```bash
+# Create task
+codmir task create "Implement feature X"
+
+# Snapshot current state (50% done)
+codmir task snapshot task_123
+
+# Clone for testing
+codmir task clone task_123 --count 3
+
+# Restore anywhere
+codmir task restore task_123.dna
+
+# Resume from checkpoint
+codmir task resume task_123
+```
+
+**Benefits:**
+- 💾 Save AI progress anytime
+- 🔄 Resume on different infrastructure
+- 🧬 Clone for parallel execution
+- ☁️ Migrate between services (Railway → Lambda → Local)
+- 📦 Share AI states with team
+
+See [AI Task Replication Docs](../../AI_TASK_REPLICATION_FRAMEWORK.md) for details.
+
+See [Agent Mode Quick Start](./AGENT_MODE_QUICK_START.md) and [CLI Documentation](./CLI.md) for more details.
+
+## The codmir Ecosystem
+
+### Complete Platform
+
+codmir is more than just an SDK - it's a complete AI-powered development platform:
+
+```
+┌──────────────────────────────────────────────┐
+│         codmir Platform                      │
+├──────────────────────────────────────────────┤
+│                                              │
+│  📦 @codmir/sdk                              │
+│  └─ CLI & SDK (this package)                │
+│                                              │
+│  🔍 @codmir/observe                          │
+│  └─ Session replay & error tracking         │
+│                                              │
+│  🎨 VSCode Extension                         │
+│  └─ IDE integration with project graph      │
+│                                              │
+│  🤖 AI Agents                                │
+│  ├─ TARS (code generation)                  │
+│  ├─ Cascade (code review)                   │
+│  └─ Overseer (monitoring)                   │
+│                                              │
+│  🌐 Web Dashboard                            │
+│  └─ Projects, tickets, reports, analytics   │
+│                                              │
+└──────────────────────────────────────────────┘
+```
+
+### Related Packages
+
+- **@codmir/observe** - Observability SDK for session replay and error tracking
+- **codmir-vscode** - VSCode extension with project graph visualization
+
+### Documentation
+
+- [Complete System Integration](../../COMPLETE_SYSTEM_INTEGRATION.md)
+- [Codebase Analysis Architecture](../../CODEBASE_ANALYSIS_ARCHITECTURE.md)
+- [AI Task Replication Framework](../../AI_TASK_REPLICATION_FRAMEWORK.md)
+- [Observability Platform](../../OBSERVABILITY_PLATFORM_ARCHITECTURE.md)
+- [AI Orchestration Vision](../../AI_ORCHESTRATION_VISION.md)
 
 ## Quick Start
 
@@ -317,10 +488,34 @@ import type {
 } from 'codmir';
 ```
 
+## What Makes codmir Different?
+
+### vs Traditional Tools
+
+| Feature | codmir | Sentry | Datadog | GitHub |
+|---------|--------|--------|---------|--------|
+| Codebase Understanding | ✅ AI-powered | ❌ | ❌ | ❌ |
+| Usage-Based Billing | ✅ Transparent | ✅ | ✅ | ❌ |
+| Session Replay | ✅ 10KB/min | ✅ 50KB/min | ✅ 100KB/min | ❌ |
+| AI Task Cloning | ✅ Unique | ❌ | ❌ | ❌ |
+| Multi-Agent System | ✅ Built-in | ❌ | ❌ | ❌ |
+| Cost Tracking | ✅ Per AI call | ❌ | ❌ | ❌ |
+| IDE Integration | ✅ VSCode | ❌ | ❌ | ❌ |
+| Knowledge Base | ✅ Auto-generated | ❌ | ❌ | ❌ |
+
+### Key Differentiators
+
+1. **AI Understands YOUR Code** - Not generic responses, context from your actual codebase
+2. **Task Replication** - Save and clone AI states (no other platform does this)
+3. **Complete Visibility** - Track every AI call, token, and cost
+4. **3-10x More Efficient** - Smaller bundle, less data, better performance
+5. **Unified Platform** - One tool for everything (no juggling multiple services)
+
 ## Requirements
 
 - Node.js >= 18.0.0
 - TypeScript >= 5.0.0 (if using TypeScript)
+- codmir account (free tier available)
 
 ## Browser Support
 
@@ -328,7 +523,17 @@ This package uses the Fetch API which is available in all modern browsers and No
 
 ## License
 
-MIT
+**Proprietary - All Rights Reserved**
+
+Copyright © 2024-2025 codmir, Inc.
+
+This software is proprietary and confidential. Unauthorized copying, distribution, or use is strictly prohibited.
+
+- Requires valid codmir account
+- Subject to Terms of Service
+- Commercial use requires paid subscription
+
+For licensing inquiries: sales@codmir.com
 
 ## Links
 

package/dist/analyze-LULBI4ZC.mjs

@@ -0,0 +1,7 @@
+import {
+  analyzeCommand
+} from "./chunk-ASGAT3Z5.mjs";
+import "./chunk-EBO3CZXG.mjs";
+export {
+  analyzeCommand
+};