@closedloop-ai/cli 0.2.3 → 0.2.4

package/README.md

@@ -48,20 +48,30 @@ npm install -g @closedloop-ai/cli
 cl config set --api-key your-api-key-here
 ```
 
-### Submit Your First Customer Feedback
+### Set Your Product Website (Important!)
+
+Configure your product's website URL to help ClosedLoop understand your product context:
 
 ```bash
-# Submit raw customer feedback for AI analysis
-cl input "The new dashboard is confusing and hard to navigate. I can't find the settings menu and the layout is cluttered."
+cl team website "https://yourproduct.com/feature"
+```
+
+**Why this matters:** ClosedLoop AI uses your product URL to learn about your product features, competitors, pricing, and positioning. This enables more accurate feedback attribution and product-specific insights. For example, if you're working on iPhone, use `https://apple.com/iphone` - this helps ClosedLoop AI understand that "camera quality" feedback is about iPhone cameras, not just any camera.
+
+### Ingest Your First Customer Feedback
+
+```bash
+# Ingest raw customer feedback for AI analysis
+cl ingest "The new dashboard is confusing and hard to navigate. I can't find the settings menu and the layout is cluttered."
 
 # Wait for AI to analyze and generate structured insights
-cl input "Customer complaint about performance issues" --wait
+cl ingest "Customer complaint about performance issues" --wait
 
 # View all AI-generated customer product feedback
-cl feedback
+cl insight
 
 # Get detailed analysis of a specific insight
-cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d
+cl insight 2ea8f556-052b-4f5c-bf86-833780b3d00d
 ```
 
 ## 🎯 Perfect For
@@ -86,14 +96,14 @@ cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d
 
 ## 📖 CLI Commands
 
-### Submit Customer Feedback
+### Ingest Customer Feedback
 
 ```bash
-# Basic submission
-cl input "The app crashes when I try to upload large files"
+# Basic ingestion
+cl ingest "The app crashes when I try to upload large files"
 
 # With metadata for better analysis
-cl input "Great product, love the new features!" \
+cl ingest "Great product, love the new features!" \
   --title "Positive Feedback" \
   --customer "customer-456" \
   --name "Jane Smith" \
@@ -101,33 +111,33 @@ cl input "Great product, love the new features!" \
   --url "https://support.example.com/ticket/789"
 
 # Wait for AI analysis to complete
-cl input "Customer complaint about performance" --wait
+cl ingest "Customer complaint about performance" --wait
 ```
 
 ### View AI-Generated Customer Product Feedback
 
 ```bash
 # List all structured insights
-cl feedback
+cl insight
 
 # View specific insight details
-cl feedback <insight-id>
+cl insight <insight-id>
 
 # Get JSON output for scripting
-cl feedback --json | jq '.data[0].title'
+cl insight --json | jq '.data[0].title'
 ```
 
 ### Manage Your Data
 
 ```bash
-# List all customer feedback submitted
-cl input
+# List all customer feedback ingested
+cl ingest
 
 # View specific feedback details
-cl input <feedback-id>
+cl ingest <feedback-id>
 
 # Check processing status
-cl input <feedback-id> --status
+cl ingest <feedback-id> --status
 ```
 
 ## 🔧 Configuration
@@ -140,48 +150,52 @@ The CLI stores configuration in `~/.closedloop/config.json`:
 }
 ```
 
-### Environment Variables
+### Environment Variables (Advanced)
+
+**For developers and CI/CD systems**, you can also set your API key as an environment variable instead of using the config file:
 
 ```bash
+# Set the API key as an environment variable
 export CLOSEDLOOP_API_KEY="your-api-key-here"
+
+# Now you can use the CLI without running 'cl config set'
+cl input "Customer feedback here"
 ```
 
-## 💡 Real-World Examples
+**When to use this:**
+- **CI/CD pipelines**: Set the API key in your deployment environment
+- **Docker containers**: Pass the API key as an environment variable
+- **Server scripts**: When running automated scripts on servers
+- **Multiple users**: When different users need different API keys on the same machine
 
-### Customer Success Team
-```bash
-# Process support ticket feedback
-cl input "Customer can't find the export feature in the new UI" \
-  --title "Export Feature Missing" \
-  --customer "enterprise-123" \
-  --source "zendesk-ticket-456"
-
-# Get AI insights on customer satisfaction trends
-cl feedback --severity high
-```
+**Note:** The CLI will automatically use the environment variable if it's set, otherwise it falls back to the config file.
 
-### Product Manager
-```bash
-# Submit user research findings
-cl input "Users want better mobile experience - 80% of complaints are mobile-related" \
-  --title "Mobile UX Research" \
-  --customer "research-participant-789"
+## 💡 Simple Workflow
 
-# Analyze feature request patterns
-cl feedback --category "feature-request"
-```
+Here's how to get started with ClosedLoop AI CLI:
 
-### Business Analyst
 ```bash
-# Process survey responses
-cl input "NPS score dropped 15 points this quarter due to performance issues" \
-  --title "Q3 NPS Analysis" \
-  --customer "survey-respondent-101"
+# 1. Set your API key
+cl config set --api-key your-api-key-here
+
+# 2. Set your product website (helps AI understand your product)
+cl team website "https://yourproduct.com/feature"
 
-# Get strategic insights for leadership
-cl feedback --priority high
+# 3. Ingest customer feedback
+cl ingest "The new dashboard is confusing and hard to navigate"
+
+# 4. Check what feedback you've ingested
+cl ingest
+
+# 5. View AI analysis of your feedback
+cl insight
+
+# 6. Get details on specific feedback
+cl insight <insight-id>
 ```
 
+That's it! ClosedLoop AI will automatically analyze your feedback and provide actionable insights.
+
 ## 📚 Documentation
 
 - **[Complete CLI Commands Reference](docs/CLI_COMMANDS.md)** - All commands, parameters, and examples

package/docs/CLI_COMMANDS.md

@@ -9,6 +9,7 @@ Complete reference for all CLI commands, parameters, and user experience.
 - [How to Use API Keys](#how-to-use-api-keys)
 - [Input Commands](#input-commands)
 - [Feedback Commands](#feedback-commands)
+- [Team Commands](#team-commands)
 - [General Commands](#general-commands)
 - [Error Handling](#error-handling)
 - [Examples](#examples)
@@ -69,18 +70,18 @@ export CLOSEDLOOP_API_KEY="your-api-key-here"
 cl config  # Will use environment variable
 ```
 
-## Input Commands
+## Ingest Commands
 
-### Submit Customer Product Feedback
+### Ingest Customer Product Feedback
 
-#### Basic Submission
+#### Basic Ingestion
 ```bash
-cl input "Your customer product feedback here"
+cl ingest "Your customer product feedback here"
 ```
 
 #### With Metadata
 ```bash
-cl input "The dashboard is confusing and hard to navigate" \
+cl ingest "The dashboard is confusing and hard to navigate" \
   --title "Dashboard UX Issues" \
   --customer "customer-123" \
   --name "John Doe" \
@@ -90,51 +91,51 @@ cl input "The dashboard is confusing and hard to navigate" \
 
 #### Wait for Processing
 ```bash
-cl input "Customer complaint about performance" --wait
+cl ingest "Customer complaint about performance" --wait
 # Shows real-time processing status
 ```
 
 #### JSON Output
 ```bash
-cl input "Great product, love the new features!" --json
+cl ingest "Great product, love the new features!" --json
 # Output: {"id":"74e3dd87-878f-41cf-8e5a-87527bbf7770","status":"submitted"}
 ```
 
-### List Customer Inputs
+### List Ingested Feedback
 
 #### Basic List
 ```bash
-cl input
-# Shows table of recent inputs
+cl ingest
+# Shows table of recent ingests
 ```
 
 #### With Pagination
 ```bash
-cl input --page 2 --limit 10
+cl ingest --page 2 --limit 10
 # Shows page 2 with 10 items per page
 ```
 
 #### JSON Output
 ```bash
-cl input --json
+cl ingest --json
 # Output: {"data":[...],"pagination":{...}}
 ```
 
-### View Specific Input
+### View Specific Ingest
 
 #### By ID
 ```bash
-cl input 74e3dd87-878f-41cf-8e5a-87527bbf7770
-# Shows detailed input information
+cl ingest 74e3dd87-878f-41cf-8e5a-87527bbf7770
+# Shows detailed ingest information
 ```
 
 #### JSON Output
 ```bash
-cl input 74e3dd87-878f-41cf-8e5a-87527bbf7770 --json
+cl ingest 74e3dd87-878f-41cf-8e5a-87527bbf7770 --json
 # Output: {"id":"...","content":"...","status":"..."}
 ```
 
-### Input Parameters
+### Ingest Parameters
 
 | Parameter | Type | Required | Description | Example |
 |-----------|------|----------|-------------|---------|
@@ -149,25 +150,25 @@ cl input 74e3dd87-878f-41cf-8e5a-87527bbf7770 --json
 | `--page` | number | No | Page number for listing | `--page 2` |
 | `--limit` | number | No | Items per page (max 100) | `--limit 20` |
 
-## Feedback Commands
+## Insight Commands
 
 ### List AI-Generated Insights
 
 #### Basic List
 ```bash
-cl feedback
+cl insight
 # Shows table of AI-generated insights
 ```
 
 #### With Pagination
 ```bash
-cl feedback --page 2 --limit 5
+cl insight --page 2 --limit 5
 # Shows page 2 with 5 items per page
 ```
 
 #### JSON Output
 ```bash
-cl feedback --json
+cl insight --json
 # Output: {"data":[...],"pagination":{...}}
 ```
 
@@ -175,17 +176,17 @@ cl feedback --json
 
 #### By ID
 ```bash
-cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d
+cl insight 2ea8f556-052b-4f5c-bf86-833780b3d00d
 # Shows detailed insight information
 ```
 
 #### JSON Output
 ```bash
-cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d --json
+cl insight 2ea8f556-052b-4f5c-bf86-833780b3d00d --json
 # Output: {"id":"...","title":"...","content":"..."}
 ```
 
-### Feedback Parameters
+### Insight Parameters
 
 | Parameter | Type | Required | Description | Example |
 |-----------|------|----------|-------------|---------|
@@ -198,24 +199,36 @@ cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d --json
 
 ## Team Commands
 
-### Update Team Website
+### Team Website Management
 
-#### Basic Update
+**Why set your product website?** ClosedLoop AI uses your product URL to learn about your product features, competitors, pricing, and positioning. This enables more accurate feedback attribution and product-specific insights. For example, if you're working on iPhone, use `https://apple.com/iphone` - this helps ClosedLoop AI understand that "camera quality" feedback is about iPhone cameras, not just any camera.
+
+#### Show Current Website
 ```bash
-cl team website update "https://example.com"
-# Output: Team website updated successfully
-# Website: https://example.com
+cl team website
+# Output: Website: https://example.com
 # Updated: 2024-01-15T10:30:00Z
 ```
 
-#### With Validation
+#### Set Team Website
 ```bash
-cl team website update "https://mycompany.com"
+cl team website "https://example.com"
 # Output: Team website updated successfully
-# Website: https://mycompany.com
+# Website: https://example.com
 # Updated: 2024-01-15T10:30:00Z
 ```
 
+#### JSON Output
+```bash
+# Show website in JSON format
+cl team website --json
+# Output: {"success": true, "data": {"website": "https://example.com", "updated_at": "2024-01-15T10:30:00Z"}}
+
+# Set website in JSON format
+cl team website "https://example.com" --json
+# Output: {"success": true, "data": {"website": "https://example.com", "updated_at": "2024-01-15T10:30:00Z"}}
+```
+
 ### Team Management
 ```bash
 cl team
@@ -226,19 +239,20 @@ cl team
 
 | Parameter | Type | Required | Description | Example |
 |-----------|------|----------|-------------|---------|
-| `website` | string | Yes | Team website URL (must include http:// or https://) | `"https://example.com"` |
+| `website` | string | No | Team website URL (must include http:// or https://) | `"https://example.com"` |
+| `--json` | flag | No | Output in JSON format | `--json` |
 
 ### Team Error Handling
 
 #### Invalid Website URL
 ```bash
-cl team website update "invalid-url"
+cl team website "invalid-url"
 # Error: Invalid website URL format. Must include protocol (http:// or https://) and domain
 ```
 
 #### Missing API Key
 ```bash
-cl team website update "https://example.com"
+cl team website "https://example.com"
 # Error: API key not configured. Run: cl config set --api-key <key>
 ```
 
@@ -327,52 +341,52 @@ cl input "Test feedback"
 # 1. Configure API key
 cl config set --api-key your-api-key-here
 
-# 2. Submit customer product feedback
-cl input "The new dashboard is confusing and hard to navigate"
+# 2. Ingest customer product feedback
+cl ingest "The new dashboard is confusing and hard to navigate"
 
 # 3. Wait for AI analysis
-cl input "Customer complaint about performance" --wait
+cl ingest "Customer complaint about performance" --wait
 
 # 4. View AI-generated insights
-cl feedback
+cl insight
 
 # 5. Get detailed insight
-cl feedback 2ea8f556-052b-4f5c-bf86-833780b3d00d
+cl insight 2ea8f556-052b-4f5c-bf86-833780b3d00d
 ```
 
 ### Advanced Workflow
 ```bash
-# 1. Submit with full metadata
-cl input "Great product, love the new features!" \
+# 1. Ingest with full metadata
+cl ingest "Great product, love the new features!" \
   --title "Positive Feedback" \
   --customer "enterprise-123" \
   --name "Jane Smith" \
   --email "jane@example.com" \
   --url "https://support.example.com/ticket/789"
 
-# 2. List all inputs with pagination
-cl input --page 1 --limit 20
+# 2. List all ingests with pagination
+cl ingest --page 1 --limit 20
 
 # 3. Get JSON output for scripting
-cl feedback --json | jq '.data[0].title'
+cl insight --json | jq '.data[0].title'
 
-# 4. View specific input details
-cl input 74e3dd87-878f-41cf-8e5a-87527bbf7770 --json
+# 4. View specific ingest details
+cl ingest 74e3dd87-878f-41cf-8e5a-87527bbf7770 --json
 ```
 
 ### Scripting Examples
 ```bash
 #!/bin/bash
-# submit-feedback.sh
+# ingest-feedback.sh
 
-# Submit feedback and get ID
-ID=$(cl input "$1" --json | jq -r '.id')
+# Ingest feedback and get ID
+ID=$(cl ingest "$1" --json | jq -r '.id')
 
 # Wait for processing
-cl input "$ID" --wait
+cl ingest "$ID" --wait
 
 # Show results
-cl feedback
+cl insight
 ```
 
 ```bash
@@ -380,7 +394,7 @@ cl feedback
 # get-insights.sh
 
 # Get all insights in JSON format
-cl feedback --json | jq '.data[] | {id: .id, title: .title, status: .status}'
+cl insight --json | jq '.data[] | {id: .id, title: .title, status: .status}'
 ```
 
 ## Output Formats
@@ -421,35 +435,35 @@ cl feedback --json | jq '.data[] | {id: .id, title: .title, status: .status}'
 ### 1. Use Descriptive Titles
 ```bash
 # Good
-cl input "The app crashes when uploading files" --title "File Upload Crash"
+cl ingest "The app crashes when uploading files" --title "File Upload Crash"
 
 # Bad
-cl input "App broken" --title "Issue"
+cl ingest "App broken" --title "Issue"
 ```
 
 ### 2. Include Customer Context
 ```bash
 # Good
-cl input "Feature request" --customer "enterprise-123" --name "John Doe"
+cl ingest "Feature request" --customer "enterprise-123" --name "John Doe"
 
 # Bad
-cl input "Feature request"
+cl ingest "Feature request"
 ```
 
 ### 3. Use JSON for Scripting
 ```bash
 # Good
-cl feedback --json | jq '.data[0].title'
+cl insight --json | jq '.data[0].title'
 
 # Bad
-cl feedback | grep "Title"
+cl insight | grep "Title"
 ```
 
 ### 4. Handle Errors Gracefully
 ```bash
 #!/bin/bash
-if ! cl input "$1" --wait; then
-  echo "Failed to submit feedback"
+if ! cl ingest "$1" --wait; then
+  echo "Failed to ingest feedback"
   exit 1
 fi
 ```
@@ -457,13 +471,13 @@ fi
 ### 5. Use Pagination for Large Datasets
 ```bash
 # Good - increase limit for larger datasets
-cl input --page 1 --limit 50
+cl ingest --page 1 --limit 50
 
 # Also good - use default pagination
-cl input --page 2  # Shows 20 items per page (default)
+cl ingest --page 2  # Shows 20 items per page (default)
 
 # Bad - trying to show too many at once
-cl input --limit 200  # Will be capped at 100 (max limit)
+cl ingest --limit 200  # Will be capped at 100 (max limit)
 ```
 
 ## Troubleshooting

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@closedloop-ai/cli",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "ClosedLoop AI CLI - AI-powered customer product feedback analysis tool",
   "bin": {
     "cl": "./packages/cli/dist/cli.js"