@oculum/cli 1.0.16 → 1.0.17

package/README.md

@@ -8,7 +8,7 @@ AI-native security scanner for detecting vulnerabilities in AI-generated code, B
 ## Features
 
 - 🤖 **AI-Native Security**: Specialized detection for AI-era risks (BYOK patterns, agent tools, AI-generated code)
-- ⚡ **Multiple Scan Depths**: Choose between cheap (fast), validated (AI-verified), or deep (comprehensive) scans
+- ⚡ **Multiple Scan Depths**: Choose between local (fast), verified (AI-verified), or deep (comprehensive) scans
 - 🎯 **Low False Positives**: AI validation reduces noise by ~70%
 - 📊 **Multiple Output Formats**: Terminal, JSON, SARIF, or Markdown
 - 🔄 **Incremental Scanning**: Scan only changed files for faster CI/CD
@@ -40,11 +40,11 @@ This will open a browser window for GitHub authentication. Follow the prompts to
 ### 2. Run Your First Scan
 
 ```bash
-# Quick scan (fast, local-only)
+# Local scan (fast, local-only)
 oculum scan .
 
-# Validated scan (AI-verified, recommended)
-oculum scan . --mode validated
+# Verified scan (AI-verified, recommended)
+oculum scan . --mode verified
 
 # Deep scan (comprehensive analysis)
 oculum scan . --mode deep
@@ -64,7 +64,7 @@ Scan a directory or file for security vulnerabilities.
 
 **Options:**
 
-- `-d, --depth <mode>` - Scan depth: `cheap`, `validated`, or `deep` (default: `cheap`)
+- `-d, --depth <mode>` - Scan depth: `local`, `verified`, or `deep` (default: `local`)
 - `-f, --format <format>` - Output format: `terminal`, `json`, `sarif`, or `markdown` (default: `terminal`)
 - `-o, --output <file>` - Write output to file instead of stdout
 - `--incremental` - Only scan files changed since last commit (git required)
@@ -73,14 +73,14 @@ Scan a directory or file for security vulnerabilities.
 **Examples:**
 
 ```bash
-# Scan current directory with validated mode
-oculum scan . --mode validated
+# Scan current directory with verified mode
+oculum scan . --mode verified
 
 # Scan specific file with JSON output
 oculum scan src/api/auth.ts --format json
 
 # Incremental scan for CI/CD
-oculum scan . --incremental --mode validated
+oculum scan . --incremental --mode verified
 
 # Save results to file
 oculum scan . --output results.sarif --format sarif
@@ -123,14 +123,14 @@ Remove stored credentials and log out.
 
 ## Scan Depth Modes
 
-### Cheap (Free)
+### Local (Free)
 
 - **Speed**: Very fast (~5-10s for 100 files)
 - **Cost**: Free, runs locally
 - **Detection**: Pattern-based detection (Layer 1 + Layer 2)
 - **Use Case**: Quick checks, pre-commit hooks, local development
 
-### Validated (Pro)
+### Verified (Pro)
 
 - **Speed**: Moderate (~30-60s for 100 files)
 - **Cost**: Paid, requires API key
@@ -150,7 +150,7 @@ Create `oculum.config.json` in your project root:
 
 ```json
 {
-  "depth": "validated",
+  "depth": "verified",
   "format": "terminal",
   "ignore": [
     "**/node_modules/**",
@@ -166,7 +166,7 @@ Create `oculum.config.json` in your project root:
 
 **Options:**
 
-- `depth` - Default scan depth (`cheap`, `validated`, `deep`)
+- `depth` - Default scan depth (`local`, `verified`, `deep`)
 - `format` - Default output format (`terminal`, `json`, `sarif`, `markdown`)
 - `ignore` - Glob patterns to exclude from scanning
 - `include` - Glob patterns to include in scanning (overrides ignore)
@@ -276,7 +276,7 @@ jobs:
         run: echo "${{ secrets.OCULUM_API_KEY }}" | oculum login --stdin
       
       - name: Scan
-        run: oculum scan . --mode validated --format sarif --output results.sarif
+        run: oculum scan . --mode verified --format sarif --output results.sarif
       
       - name: Upload SARIF
         uses: github/codeql-action/upload-sarif@v2
@@ -292,7 +292,7 @@ security_scan:
   script:
     - npm install -g @oculum/cli
     - echo "$OCULUM_API_KEY" | oculum login --stdin
-    - oculum scan . --mode validated --format json --output results.json
+    - oculum scan . --mode verified --format json --output results.json
   artifacts:
     reports:
       codequality: results.json
@@ -316,7 +316,7 @@ security_scan:
 **Solution**:
 - Check your usage: `oculum status`
 - Upgrade to Pro tier for higher limits
-- Use `--mode cheap` for unlimited local scans
+- Use `--mode local` for unlimited local scans
 
 **Problem**: Too many files being scanned
 
@@ -330,7 +330,7 @@ security_scan:
 **Problem**: Scans are slow
 
 **Solution**:
-- Use `--mode cheap` for faster local scans
+- Use `--mode local` for faster local scans
 - Enable incremental scanning: `--incremental`
 - Reduce scope with ignore patterns
 - Scan only changed files in CI/CD
@@ -364,14 +364,14 @@ export OCULUM_API_KEY="your-key-here"
 ## Pricing
 
 ### Free Tier
-- ✅ Unlimited cheap (local) scans
+- ✅ Unlimited local scans
 - ✅ Basic CLI access
 - ✅ All output formats
-- ❌ No validated/deep scans
+- ❌ No verified/deep scans
 
 ### Pro Tier
 - ✅ Everything in Free
-- ✅ Validated scans (AI-verified)
+- ✅ Verified scans (AI-verified)
 - ✅ Deep scans (semantic analysis)
 - ✅ API access
 - ✅ Priority support
@@ -386,7 +386,7 @@ export OCULUM_API_KEY="your-key-here"
 #!/bin/bash
 # .git/hooks/pre-commit
 
-oculum scan . --mode cheap --format terminal
+oculum scan . --mode local --format terminal
 if [ $? -ne 0 ]; then
   echo "Security issues found. Commit blocked."
   exit 1
@@ -397,7 +397,7 @@ fi
 
 ```bash
 # Scan on file changes
-oculum watch src/ --mode cheap
+oculum watch src/ --mode local
 ```
 
 ### Scan Specific File Types