clavix 2.8.2 → 3.0.1

package/dist/templates/slash-commands/_canonical/summarize.md

@@ -1,11 +1,11 @@
 ---
 name: "Clavix: Summarize"
-description: Extract and CLEAR-optimize requirements from conversation
+description: Extract and optimize requirements from conversation
 ---
 
-# Clavix Conversation Summarization - CLEAR Framework Enhanced
+# Clavix Conversation Summarization
 
-You are analyzing the conversation history and extracting optimized requirements. **Extracted prompts are automatically enhanced using the CLEAR Framework** (Concise, Logical, Explicit) for optimal AI consumption.
+You are analyzing the conversation history and extracting optimized requirements. **Extracted prompts are automatically enhanced using universal prompt intelligence** for optimal AI consumption.
 
 ## Instructions
 
@@ -72,18 +72,20 @@ You are analyzing the conversation history and extracting optimized requirements
    [Success criteria and any important context]
    ```
 
-3. **CLEAR Framework Optimization** (automatic with labeled improvements):
-   - After extracting the optimized prompt, analyze using CLEAR framework
-   - Apply Conciseness, Logic, and Explicitness enhancements
-   - **Label all improvements** with CLEAR component tags:
-     - **[C]**: "Removed 12 conversational words, reduced from 45 to 28 words"
-     - **[L]**: "Restructured flow: context → requirements → constraints → success criteria"
-     - **[E]**: "Added explicit output format (React component), persona (senior dev), success metrics (load time < 2s)"
-   - Display both raw extraction and CLEAR-enhanced version
-   - Show CLEAR scores (before/after) and labeled improvements
+3. **Universal Optimization** (automatic with labeled improvements):
+   - After extracting the prompt, analyze using universal prompt intelligence
+   - Apply optimizations for Clarity, Efficiency, Structure, Completeness, and Actionability
+   - **Label all improvements** with quality dimension tags:
+     - **[Efficiency]**: "Removed 12 conversational words, reduced from 45 to 28 words"
+     - **[Structure]**: "Reorganized flow: context → requirements → constraints → success criteria"
+     - **[Clarity]**: "Added explicit output format (React component), persona (senior dev)"
+     - **[Completeness]**: "Added missing success metrics (load time < 2s, user adoption rate)"
+     - **[Actionability]**: "Converted vague goals into specific, measurable requirements"
+   - Display both raw extraction and optimized version
+   - Show quality scores (before/after) and labeled improvements
    - Save both versions:
-     - `optimized-prompt.md` (raw extraction)
-     - `clear-optimized-prompt.md` (CLEAR-enhanced with improvement notes)
+     - `original-prompt.md` (raw extraction from conversation)
+     - `optimized-prompt.md` (enhanced with improvements)
 
 4. Highlight key insights discovered during the conversation.
 
@@ -91,16 +93,19 @@ You are analyzing the conversation history and extracting optimized requirements
 
 6. If anything is still unclear or missing, point it out and suggest areas for further discussion.
 
-## CLEAR Enhancement
+## Quality Enhancement
 
 **What gets optimized:**
-- **[C] Concise**: Remove any verbosity from extracted requirements
-- **[L] Logical**: Ensure coherent flow (context → requirements → constraints → output)
-- **[E] Explicit**: Add missing specifications, formats, success criteria
+- **Clarity**: Remove ambiguity from extracted requirements
+- **Efficiency**: Remove verbosity and conversational fluff
+- **Structure**: Ensure logical flow (context → requirements → constraints → output)
+- **Completeness**: Add missing specifications, formats, success criteria
+- **Actionability**: Make requirements specific and executable
 
 **Output files:**
-- `optimized-prompt.md` - Raw extraction from conversation
-- `clear-optimized-prompt.md` - CLEAR-enhanced version (recommended for AI agents)
+- `original-prompt.md` - Raw extraction from conversation
+- `optimized-prompt.md` - Enhanced version (recommended for AI agents)
+- `mini-prd.md` - Structured requirements document
 
 ## Quality Checks
 
@@ -109,14 +114,14 @@ You are analyzing the conversation history and extracting optimized requirements
 - Technical constraints identified
 - Success criteria defined
 - User needs considered
-- CLEAR framework applied for AI consumption
+- Universal prompt intelligence applied for AI consumption
 
 ## Workflow Navigation
 
 **You are here:** Summarize (Conversation Extraction)
 
 **Common workflows:**
-- **Standard flow**: `/clavix:start` → [conversation] → `/clavix:summarize` → Use CLEAR-optimized prompt
+- **Standard flow**: `/clavix:start` → [conversation] → `/clavix:summarize` → Use optimized prompt
 - **To implementation**: `/clavix:summarize` → `/clavix:plan` → `/clavix:implement` → `/clavix:archive`
 - **Standalone use**: [Any conversation] → `/clavix:summarize` → Extract and optimize
 
@@ -129,6 +134,11 @@ You are analyzing the conversation history and extracting optimized requirements
 
 From conversation about "analytics dashboard for sales team"...
 
+**Original Extraction**:
+```
+We discussed building a dashboard for the sales team that shows analytics. They want to see revenue trends and who's performing well. It should update in real-time and help managers spot problems. We talked about using React and connecting to Salesforce.
+```
+
 **Optimized Prompt**:
 ```
 Build a real-time sales analytics dashboard for the sales team showing revenue trends, top performers, pipeline status, and conversion rates. The dashboard should update live as deals progress, support filtering by date range/region/rep, and display key metrics prominently. Users need to quickly identify at-risk deals and celebrate wins.
@@ -138,6 +148,13 @@ Technical stack: React + TypeScript frontend, integrate with existing Salesforce
 Success: Sales managers can identify issues within 30 seconds of opening, dashboard loads in <2 seconds, 90% of team uses it daily within first month.
 ```
 
+**Improvements Applied**:
+- **[Efficiency]**: Removed 8 conversational phrases, increased information density
+- **[Structure]**: Organized into objective → requirements → technical → success
+- **[Clarity]**: Specified exact features (filtering, metrics display) instead of vague "shows analytics"
+- **[Completeness]**: Added performance requirements (10K+ deals, <2s load), success metrics (30s to identify issues, 90% adoption)
+- **[Actionability]**: Converted "help managers spot problems" into specific, measurable outcome
+
 ## Troubleshooting
 
 ### Issue: Pre-extraction validation fails (missing objective/requirements)
@@ -156,12 +173,12 @@ Success: Sales managers can identify issues within 30 seconds of opening, dashbo
 - Mark multi-topic extraction with [MULTI-TOPIC] indicator
 - Suggest breaking into separate PRDs for each topic
 
-### Issue: CLEAR optimization doesn't significantly improve extracted prompt
+### Issue: Optimization doesn't significantly improve extracted prompt
 **Cause**: Conversation was already well-structured and detailed
 **Solution**:
 - Minor improvements are normal for good conversations
-- Show CLEAR scores (should be high: >80%)
-- Still provide both versions but note that original extraction was already CLEAR
+- Show quality scores (should be high: >80%)
+- Still provide both versions but note that original extraction was already high quality
 
 ### Issue: Low confidence indicators across all extracted elements
 **Cause**: Conversation was too vague or high-level

package/dist/utils/error-utils.d.ts

@@ -32,5 +32,12 @@ interface NodeJSError extends Error {
  * Type guard to check if error is a NodeJS error with code property
  */
 export declare function isNodeError(error: unknown): error is NodeJSError;
+/**
+ * Handles CLI errors, formatting OCLIF errors nicely and falling back to default handler.
+ * @param error The error to handle
+ * @param defaultHandler The default handler function (usually handle from @oclif/core)
+ * @param exitFn Optional exit function (defaults to process.exit)
+ */
+export declare function handleCliError(error: any, defaultHandler: (err: any) => Promise<void>, exitFn?: (code: number) => void): Promise<void>;
 export {};
 //# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.js

@@ -65,4 +65,21 @@ export function isNodeError(error) {
         'code' in error &&
         typeof error.code === 'string');
 }
+/**
+ * Handles CLI errors, formatting OCLIF errors nicely and falling back to default handler.
+ * @param error The error to handle
+ * @param defaultHandler The default handler function (usually handle from @oclif/core)
+ * @param exitFn Optional exit function (defaults to process.exit)
+ */
+export async function handleCliError(error, defaultHandler, exitFn = process.exit) {
+    // For CLIError, show only the formatted message
+    if (error && error.oclif && error.oclif.exit !== undefined) {
+        // Format error message (hints are now included in error.message)
+        console.error(' ›   Error: ' + error.message);
+        exitFn(error.oclif.exit);
+        return;
+    }
+    // For other errors, use default handler
+    return defaultHandler(error);
+}
 //# sourceMappingURL=error-utils.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "clavix",
-  "version": "2.8.2",
-  "description": "Transform vague ideas into production-ready prompts. AI agent tool with CLI interface using the CLEAR framework to analyze, improve, and generate PRDs for AI coding assistants (Claude Code, Cursor, Windsurf, and more)",
+  "version": "3.0.1",
+  "description": "Universal prompt intelligence for AI coding. Automatically optimizes prompts with intent detection, quality assessment, and adaptive patterns—no framework to learn. Works with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,12 +17,12 @@
     "build:prod": "npm run build && npm run remove-sourcemaps",
     "copy-templates": "copyfiles -u 1 \"src/templates/**/*\" dist/",
     "remove-sourcemaps": "find dist -name '*.map' -type f -delete",
-    "dev": "ts-node src/index.ts",
-    "test": "NODE_OPTIONS=\"--experimental-vm-modules\" jest",
-    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
-    "test:coverage": "NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "test": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest",
+    "test:watch": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --watch",
+    "test:coverage": "NODE_OPTIONS=\"--experimental-vm-modules --no-warnings\" jest --coverage",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
     "format": "prettier --write \"src/**/*.ts\"",
     "format:check": "prettier --check \"src/**/*.ts\"",
     "prepublishOnly": "npm run build:prod"
@@ -35,14 +35,21 @@
     "cli",
     "ai",
     "prompt",
+    "prompt-optimization",
+    "prompt-intelligence",
+    "intent-detection",
+    "quality-assessment",
     "prd",
     "claude",
     "claude-code",
+    "cursor",
+    "windsurf",
     "developer-tools",
     "prompt-engineering",
+    "ai-coding-tools",
     "requirements"
   ],
-  "author": "Bob5k",
+  "author": "ClavixDev",
   "license": "MIT",
   "bugs": {
     "url": "https://github.com/ClavixDev/Clavix/issues"
@@ -62,6 +69,7 @@
     "uuid": "^9.0.1"
   },
   "devDependencies": {
+    "@eslint/js": "^9.17.0",
     "@oclif/test": "^4.1.15",
     "@types/fs-extra": "^11.0.4",
     "@types/handlebars": "^4.0.40",
@@ -72,12 +80,13 @@
     "@typescript-eslint/eslint-plugin": "^8.46.4",
     "@typescript-eslint/parser": "^8.46.4",
     "copyfiles": "^2.4.1",
-    "eslint": "^8.57.0",
-    "jest": "^30.2.0",
+    "eslint": "^9.17.0",
+    "jest": "^29.7.0",
     "prettier": "^3.6.2",
     "ts-jest": "^29.4.5",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.4"
   },
   "oclif": {
     "bin": "clavix",