clavix 5.3.0 → 5.4.0

package/dist/cli/commands/update.js

@@ -55,7 +55,7 @@ export default class Update extends Command {
         const updateDocs = flags['docs-only'] || (!flags['docs-only'] && !flags['commands-only']);
         const updateCommands = flags['commands-only'] || (!flags['docs-only'] && !flags['commands-only']);
         let updatedCount = 0;
-        // Update for each provider
+        // Update for each integration
         for (const integrationName of integrations) {
             // Handle AGENTS.md separately
             if (integrationName === 'agents-md') {

package/dist/core/adapters/base-adapter.js

@@ -85,6 +85,17 @@ export class BaseAdapter {
                 console.warn(`Failed to remove ${filePath}: ${error}`);
             }
         }
+        // Also remove clavix/ subdirectory if it exists (legacy cleanup)
+        const clavixSubdir = path.join(commandPath, 'clavix');
+        if (await FileSystem.exists(clavixSubdir)) {
+            try {
+                await FileSystem.remove(clavixSubdir);
+                removed++;
+            }
+            catch (error) {
+                console.warn(`Failed to remove ${clavixSubdir}: ${error}`);
+            }
+        }
         return removed;
     }
     /**

package/dist/templates/agents/warp.md

@@ -20,8 +20,8 @@ Clavix helps Warp developers turn rough ideas into quality, AI-ready prompts and
 - ❌ DO NOT implement features during these workflows
 
 **IMPLEMENTATION workflows** (CODE ALLOWED):
-- Only after user runs execute/implement commands
-- Your role: Write code, execute tasks, implement features
+- Only after user runs `/clavix:implement`
+- Your role: Write code, implement tasks, build features
 - ✅ DO implement code during these workflows
 
 See `.clavix/instructions/core/clavix-mode.md` for complete mode documentation.

package/dist/templates/instructions/README.md

@@ -270,9 +270,11 @@ npm run validate:consistency
 - `implement.md` - Task and prompt execution workflow
 
 ### Agent Protocols
-- `_components/agent-protocols/decision-rules.md` - Decision logic
+- `_components/agent-protocols/AGENT_MANUAL.md` - Universal agent protocols
+- `_components/agent-protocols/cli-reference.md` - CLI command reference
 - `_components/agent-protocols/state-awareness.md` - Workflow state tracking
-- `_components/agent-protocols/error-handling.md` - Error recovery patterns
+- `_components/agent-protocols/supportive-companion.md` - Conversational guidance
+- `_components/agent-protocols/task-blocking.md` - Blocked task handling
 
 ### Validation
 - `scripts/validate-consistency.ts` - TypeScript ↔ Template validator
@@ -280,6 +282,6 @@ npm run validate:consistency
 
 ---
 
-**Last updated:** v5.1.0
+**Last updated:** v5.4.0
 
 **Validation:** Run `npm run validate:consistency` before committing changes.

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

@@ -21,6 +21,34 @@ When you run `/clavix:archive`, I:
 
 ---
 
+## State Assertion (REQUIRED)
+
+Before ANY action, output this confirmation:
+
+```
+**CLAVIX MODE: Archival**
+Mode: management
+Purpose: Organizing completed projects
+Implementation: BLOCKED (file operations only)
+```
+
+---
+
+## Self-Correction Protocol
+
+If you catch yourself doing any of these, STOP and correct:
+
+1. **Deleting Without Confirmation** - Must get explicit user confirmation for deletes
+2. **Archiving Incomplete Projects** - Should warn if tasks.md has unchecked items
+3. **Wrong Directory Operations** - Operating on wrong project directory
+4. **Skipping Safety Checks** - Not verifying project exists before operations
+5. **Silent Failures** - Not reporting when operations fail
+6. **Capability Hallucination** - Claiming Clavix can do things it cannot
+
+**DETECT → STOP → CORRECT → RESUME**
+
+---
+
 ## CLAVIX MODE: Archival
 
 **I'm in archival mode. Organizing your completed work.**

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

@@ -44,6 +44,35 @@ Override auto-detection when needed:
 
 ---
 
+## State Assertion (REQUIRED)
+
+Before ANY action, output this confirmation:
+
+```
+**CLAVIX MODE: Implementation**
+Mode: implementation
+Purpose: Executing tasks or prompts with code generation
+Source: [tasks.md | prompts/ | user request]
+Implementation: AUTHORIZED
+```
+
+---
+
+## Self-Correction Protocol
+
+If you catch yourself doing any of these, STOP and correct:
+
+1. **Skipping Auto-Detection** - Not checking for tasks.md and prompts/ before asking
+2. **Implementing Without Reading** - Starting code before reading the full task/prompt
+3. **Skipping Verification** - Not running tests after implementation
+4. **Batch Task Completion** - Marking multiple tasks done without implementing each
+5. **Ignoring Blocked Tasks** - Not reporting when a task cannot be completed
+6. **Capability Hallucination** - Claiming Clavix can do things it cannot
+
+**DETECT → STOP → CORRECT → RESUME**
+
+---
+
 ## CLAVIX MODE: Implementation
 
 **I'm in implementation mode. Building your tasks!**

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

@@ -1,61 +1,49 @@
 ---
-name: "Clavix: Optimize Your Prompt"
-description: Analyze and optimize prompts with auto-detected depth
+name: "Clavix: Improve Your Prompt"
+description: Analyze and improve prompts with auto-detected depth
 ---
 
-# Clavix: Optimize Your Prompt
+# Clavix: Improve Your Prompt
 
-## STOP: OPTIMIZATION MODE - NOT IMPLEMENTATION
+## Important: This is Planning Mode
 
-**THIS IS A PROMPT OPTIMIZATION WORKFLOW. YOU MUST NOT IMPLEMENT ANYTHING.**
+This is a prompt improvement workflow. Your job is to ANALYZE and IMPROVE the prompt, then STOP.
 
-## Critical Understanding
+**What this mode does:**
+- Analyze the user's prompt for quality
+- Apply improvement patterns
+- Generate an optimized version
+- Save to `.clavix/outputs/prompts/`
 
-This template exists because agents (including you) tend to "help" by doing work immediately.
-**That's the wrong behavior here.** Your job is to ANALYZE and IMPROVE the prompt, then STOP.
+**What this mode does NOT do:**
+- Write application code
+- Implement features described in the prompt
+- Modify files outside `.clavix/`
+- Explore the codebase
 
-## What "Implementation" Looks Like (ALL FORBIDDEN)
-- Reading project files to "understand context" before showing analysis
-- Writing any code files (functions, classes, components)
-- Creating components, features, or API endpoints
-- Running build/test commands on the user's project
-- Making git commits
-- ANY action that modifies files outside `.clavix/`
-- Exploring the codebase before outputting your analysis
-
-## The ONLY Actions Allowed
-1. Read the user's prompt text (the `{{ARGS}}` provided)
-2. Analyze it using the workflow below
-3. Output the analysis (intent, quality, optimized prompt)
-4. Save to `.clavix/outputs/prompts/`
-5. STOP and wait for `/clavix:implement`
-
-## IF USER WANTS TO IMPLEMENT:
-Tell them: **"Run `/clavix:implement --latest` to implement this prompt."**
-
-**DO NOT IMPLEMENT YOURSELF. YOUR JOB ENDS AFTER SHOWING THE OPTIMIZED PROMPT.**
+**After improving the prompt:** Tell the user to run `/clavix:implement --latest` when ready to build.
 
 ---
 
-## CLAVIX MODE: Prompt Optimization Only
+## CLAVIX MODE: Prompt Improvement
 
-**You are in Clavix prompt optimization mode. You help analyze and optimize PROMPTS, NOT implement features.**
+**You are in prompt improvement mode. You help analyze and improve PROMPTS, not implement features.**
 
-**YOUR ROLE:**
+**Your role:**
 - Analyze prompts for quality
-- Apply optimization patterns
+- Apply improvement patterns
 - Generate improved versions
 - Provide quality assessments
 - Save the optimized prompt
-- **STOP** after optimization
+- **STOP** after improvement
 
-**DO NOT IMPLEMENT. DO NOT IMPLEMENT. DO NOT IMPLEMENT.**
-- DO NOT write application code for the feature
-- DO NOT implement what the prompt/PRD describes
-- DO NOT generate actual components/functions
-- DO NOT continue after showing the optimized prompt
+**Mode boundaries:**
+- Do not write application code for the feature
+- Do not implement what the prompt describes
+- Do not generate actual components/functions
+- Do not continue after showing the improved prompt
 
-**You are optimizing prompts, not building what they describe.**
+**You are improving prompts, not building what they describe.**
 
 ---
 

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

@@ -27,6 +27,34 @@ My job is just to check. If something needs fixing, I'll tell you what and you d
 
 ---
 
+## State Assertion (REQUIRED)
+
+Before ANY action, output this confirmation:
+
+```
+**CLAVIX MODE: Verification**
+Mode: verification
+Purpose: Checking implementation against requirements
+Implementation: BLOCKED (verification only)
+```
+
+---
+
+## Self-Correction Protocol
+
+If you catch yourself doing any of these, STOP and correct:
+
+1. **Implementing Fixes** - This is verification mode, not implementation mode
+2. **Skipping Automated Checks** - Not running available tests/build/lint
+3. **Guessing Results** - Reporting pass/fail without actually checking
+4. **Incomplete Reports** - Not covering all verification dimensions
+5. **Missing Confidence Levels** - Not indicating HIGH/MEDIUM/LOW confidence
+6. **Capability Hallucination** - Claiming Clavix can do things it cannot
+
+**DETECT → STOP → CORRECT → RESUME**
+
+---
+
 ## CLAVIX MODE: Verification
 
 **I'm in verification mode. I check your work, not change it.**

package/dist/types/config.d.ts

@@ -36,7 +36,6 @@ export interface OutputConfig {
 export interface PreferencesConfig {
     autoOpenOutputs: boolean;
     verboseLogging: boolean;
-    preserveSessions: boolean;
 }
 export declare const DEFAULT_CONFIG: ClavixConfig;
 /**

package/dist/types/config.js

@@ -17,7 +17,6 @@ export const DEFAULT_CONFIG = {
     preferences: {
         autoOpenOutputs: false,
         verboseLogging: false,
-        preserveSessions: true,
     },
 };
 /**

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

@@ -77,11 +77,6 @@ export declare class AgentErrorMessages {
      * Used by: implement workflow
      */
     static invalidTaskIdFormat(taskId: string): string;
-    /**
-     * Error: Session not found
-     * Used by: Commands using --session flag
-     */
-    static sessionNotFound(sessionId: string): string;
     /**
      * Warning: Task already completed
      * Used by: implement workflow when marking already-done task

package/dist/utils/agent-error-messages.js

@@ -16,8 +16,7 @@ export class AgentErrorMessages {
         return ('No PRD artifacts found in .clavix/outputs/\n\n' +
             'Agent recovery options:\n' +
             '  1. Execute /clavix:prd to generate comprehensive PRD\n' +
-            '  2. Execute /clavix:summarize if conversation exists\n' +
-            '  3. Check .clavix/sessions/ if saved session available\n\n' +
+            '  2. Execute /clavix:summarize if conversation exists\n\n' +
             'Select option and execute, then retry this command.');
     }
     /**
@@ -179,19 +178,6 @@ export class AgentErrorMessages {
             '  • phase-3-api-integration-1\n\n' +
             'Check tasks.md for correct task IDs and retry.');
     }
-    /**
-     * Error: Session not found
-     * Used by: Commands using --session flag
-     */
-    static sessionNotFound(sessionId) {
-        return (`Session not found: ${sessionId}\n\n` +
-            'Agent recovery options:\n' +
-            '  1. Verify session ID is correct\n' +
-            '  2. List available sessions (if supported)\n' +
-            '  3. Use --active-session flag for current session\n' +
-            '  4. Or generate PRD without session\n\n' +
-            'Session may have expired or never existed.');
-    }
     /**
      * Warning: Task already completed
      * Used by: implement workflow when marking already-done task

package/dist/utils/legacy-command-cleanup.d.ts

@@ -5,10 +5,12 @@
  * Clavix versions. It identifies files using deprecated naming conventions
  * and assists in migration to the current standard.
  *
- * @deprecated This module is scheduled for removal in v6.0.0.
- * By that version, all legacy naming patterns should be fully migrated.
- * After v6.0.0, the cleanup functionality will no longer be needed as
- * the transition period will be complete.
+ * Handles cleanup of:
+ * - fast.md, deep.md (replaced by improve.md in v4.11+)
+ * - Old naming patterns (clavix-{name} vs {name})
+ * - Subdirectory migration for Cline and Claude Code
+ *
+ * This module will be removed when v4->v5 migration support ends.
  *
  * @since v4.12.0
  */

package/dist/utils/legacy-command-cleanup.js

@@ -5,10 +5,12 @@
  * Clavix versions. It identifies files using deprecated naming conventions
  * and assists in migration to the current standard.
  *
- * @deprecated This module is scheduled for removal in v6.0.0.
- * By that version, all legacy naming patterns should be fully migrated.
- * After v6.0.0, the cleanup functionality will no longer be needed as
- * the transition period will be complete.
+ * Handles cleanup of:
+ * - fast.md, deep.md (replaced by improve.md in v4.11+)
+ * - Old naming patterns (clavix-{name} vs {name})
+ * - Subdirectory migration for Cline and Claude Code
+ *
+ * This module will be removed when v4->v5 migration support ends.
  *
  * @since v4.12.0
  */

package/dist/utils/toml-templates.d.ts

@@ -6,5 +6,5 @@ export interface ParsedTomlTemplate {
  * Parse TOML-based slash command templates (Gemini/Qwen) and extract metadata.
  * Ensures the resulting prompt body does not include duplicated frontmatter.
  */
-export declare function parseTomlSlashCommand(content: string, templateName: string, providerName: string): ParsedTomlTemplate;
+export declare function parseTomlSlashCommand(content: string, templateName: string, integrationName: string): ParsedTomlTemplate;
 //# sourceMappingURL=toml-templates.d.ts.map

package/dist/utils/toml-templates.js

@@ -2,7 +2,7 @@
  * Parse TOML-based slash command templates (Gemini/Qwen) and extract metadata.
  * Ensures the resulting prompt body does not include duplicated frontmatter.
  */
-export function parseTomlSlashCommand(content, templateName, providerName) {
+export function parseTomlSlashCommand(content, templateName, integrationName) {
     let normalized = content.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
     if (normalized.charCodeAt(0) === 0xfeff) {
         normalized = normalized.slice(1);
@@ -10,13 +10,13 @@ export function parseTomlSlashCommand(content, templateName, providerName) {
     const descriptionMatch = normalized.match(/^\s*description\s*=\s*(['"])(.*?)\1\s*$/m);
     const promptHeaderMatch = normalized.match(/^\s*prompt\s*=\s*"""/m);
     if (!promptHeaderMatch || promptHeaderMatch.index === undefined) {
-        throw new Error(`Template ${templateName}.toml for ${providerName} is missing a prompt = """ ... """ block.`);
+        throw new Error(`Template ${templateName}.toml for ${integrationName} is missing a prompt = """ ... """ block.`);
     }
     const bodyStart = promptHeaderMatch.index + promptHeaderMatch[0].length;
     const bodyRemainder = normalized.slice(bodyStart);
     const closingIndex = bodyRemainder.indexOf('"""');
     if (closingIndex === -1) {
-        throw new Error(`Template ${templateName}.toml for ${providerName} does not terminate its prompt = """ ... """ block.`);
+        throw new Error(`Template ${templateName}.toml for ${integrationName} does not terminate its prompt = """ ... """ block.`);
     }
     let promptBody = bodyRemainder.slice(0, closingIndex);
     const promptLines = promptBody.split('\n');

package/oclif.manifest.json

@@ -126,5 +126,5 @@
       ]
     }
   },
-  "version": "5.2.1"
+  "version": "5.4.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clavix",
-  "version": "5.3.0",
+  "version": "5.4.0",
   "description": "Agentic-first prompt workflows. Markdown templates that teach AI agents how to optimize prompts, create PRDs, and manage implementation.\n\nSLASH COMMANDS (in your AI assistant):\n  /clavix:improve    Optimize prompts with auto-depth\n  /clavix:prd        Generate PRD through questions\n  /clavix:plan       Create task breakdown from PRD\n  /clavix:implement  Execute tasks with progress tracking\n  /clavix:start      Begin conversational session\n  /clavix:summarize  Extract requirements from conversation\n\nWorks with Claude Code, Cursor, Windsurf, and 19+ other AI coding tools.",
   "type": "module",
   "main": "dist/index.js",