@optima-chat/bi-cli 0.3.0 → 0.3.2

package/README.md

@@ -0,0 +1,144 @@
+# @optima-chat/bi-cli
+
+Optima BI CLI - AI-friendly business intelligence tool for e-commerce analytics.
+
+## Installation
+
+```bash
+npm install -g @optima-chat/bi-cli
+```
+
+## Authentication
+
+bi-cli uses unified authentication via `~/.optima/token.json`, shared with `commerce-cli` and `optima-agent`.
+
+### Login
+
+```bash
+# Login to production (default)
+bi-cli auth login
+
+# Login to stage environment
+bi-cli auth login --env stage
+
+# Login to development environment
+bi-cli auth login --env development
+```
+
+### Check Status
+
+```bash
+# Show current user
+bi-cli auth whoami
+
+# Show authentication status
+bi-cli auth status
+
+# Logout
+bi-cli auth logout
+```
+
+### Environment Configuration
+
+| Environment | Auth URL | Backend URL |
+|-------------|----------|-------------|
+| production | auth.optima.onl | bi-api.optima.onl |
+| stage | auth.stage.optima.onl | bi-api.stage.optima.onl |
+| development | auth.optima.chat | bi-api.optima.chat |
+
+### Token Priority
+
+1. `BI_CLI_TOKEN` environment variable
+2. `OPTIMA_TOKEN` environment variable
+3. `~/.optima/token.json` file
+
+### Environment Variables
+
+```bash
+# Override token
+export BI_CLI_TOKEN="your-access-token"
+
+# Override URLs
+export BI_CLI_BACKEND_URL="https://custom-api.example.com"
+export BI_CLI_AUTH_URL="https://custom-auth.example.com"
+
+# Override environment
+export BI_CLI_ENV="stage"
+```
+
+## Commands
+
+### Sales Analytics
+
+```bash
+# Get sales data
+bi-cli sales get
+bi-cli sales get --days 30
+```
+
+### Product Analytics
+
+```bash
+# Best selling products
+bi-cli product best-sellers
+bi-cli product best-sellers --limit 10
+
+# ABC inventory analysis
+bi-cli product abc-analysis
+
+# Price point analysis
+bi-cli product price-analysis
+
+# Product performance
+bi-cli product performance
+```
+
+### Trend Analytics
+
+```bash
+# Revenue trends
+bi-cli trends revenue
+bi-cli trends revenue --days 30
+
+# Orders heatmap
+bi-cli trends heatmap
+
+# Seasonal patterns
+bi-cli trends seasonality
+
+# Revenue forecast
+bi-cli trends forecast
+```
+
+### Advanced Analytics
+
+```bash
+# Compare periods
+bi-cli analytics compare
+bi-cli analytics compare --days 30
+
+# Growth trends
+bi-cli analytics growth
+
+# Customer cohort analysis
+bi-cli analytics cohort
+
+# Order funnel analysis
+bi-cli analytics funnel
+```
+
+## JSON Output
+
+All commands output JSON by default, making it easy to integrate with AI agents and other tools.
+
+```bash
+# Pipe to jq for formatting
+bi-cli sales get | jq .
+
+# Use with AI agents
+bi-cli product best-sellers --limit 5 | your-ai-tool
+```
+
+## License
+
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/bi-cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "type": "module",
   "description": "Optima BI CLI - AI-friendly business intelligence tool",
   "main": "dist/index.js",
@@ -19,7 +19,6 @@
     "axios": "^1.6.5",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
-    "conf": "^12.0.0",
     "open": "^8.4.2",
     "ora": "^5.4.1",
     "table": "^6.8.1"