clavix 4.2.0 → 4.3.2

package/LICENSE

@@ -1,21 +1,201 @@
-MIT License
-
-Copyright (c) 2025 Clavix
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Clavix
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -116,7 +116,7 @@ clavix prd
 - Build: `npm run build`
 
 ## License
-MIT
+Apache-2.0
 
 ## Star History
 

package/dist/cli/commands/deep.js

@@ -87,64 +87,13 @@ export default class Deep extends Command {
             console.log();
         }
         // ===== Enhanced Prompt =====
+        // Note: Pattern-generated content (Alternative Approaches, Edge Cases, Validation Checklist)
+        // is already embedded in result.enhanced by deep mode patterns
         console.log(chalk.bold.cyan('✨ Enhanced Prompt:\n'));
         console.log(chalk.dim('─'.repeat(80)));
         console.log(result.enhanced);
         console.log(chalk.dim('─'.repeat(80)));
         console.log();
-        // ===== DEEP MODE EXCLUSIVE FEATURES =====
-        // Alternative Approaches (TODO: when AlternativePhrasingGenerator pattern is implemented)
-        console.log(chalk.bold.cyan('🎨 Alternative Approaches:\n'));
-        console.log(chalk.cyan('  1. Functional Decomposition: Break the task into smaller, testable functions'));
-        console.log(chalk.cyan('  2. Test-Driven Approach: Write tests first, then implement to satisfy them'));
-        console.log(chalk.cyan('  3. Example-Driven: Start with concrete input/output examples'));
-        console.log(chalk.gray('  Note: Full alternative generation coming soon with deep mode patterns\n'));
-        // Alternative Structures (TODO: when StructureVariationGenerator pattern is implemented)
-        console.log(chalk.bold.cyan('📋 Alternative Structures:\n'));
-        console.log(chalk.cyan('  Step-by-step:'));
-        console.log(chalk.gray('    • Break complex task into sequential steps'));
-        console.log(chalk.gray('    • Each step has clear input/output'));
-        console.log(chalk.cyan('  Template-based:'));
-        console.log(chalk.gray('    • Provide code/document template to fill'));
-        console.log(chalk.gray('    • Reduces ambiguity with concrete structure'));
-        console.log(chalk.cyan('  Example-driven:'));
-        console.log(chalk.gray('    • Show concrete examples of desired output'));
-        console.log(chalk.gray('    • AI learns from patterns in examples\n'));
-        // Validation Checklist (TODO: when ValidationChecklistCreator pattern is implemented)
-        console.log(chalk.bold.yellow('✅ Validation Checklist:\n'));
-        console.log(chalk.yellow('  Before considering this task complete, verify:'));
-        console.log(chalk.yellow('    ☐ Requirements match the objective stated above'));
-        console.log(chalk.yellow('    ☐ All edge cases are handled (empty, null, invalid inputs)'));
-        console.log(chalk.yellow('    ☐ Error handling is appropriate for the context'));
-        console.log(chalk.yellow('    ☐ Output format matches specifications'));
-        console.log(chalk.yellow('    ☐ Performance is acceptable for expected input sizes'));
-        if (result.intent.primaryIntent === 'code-generation') {
-            console.log(chalk.yellow('    ☐ Code is testable and maintainable'));
-            console.log(chalk.yellow('    ☐ Security considerations addressed (injection, XSS, etc.)'));
-        }
-        console.log();
-        // Edge Cases (TODO: when EdgeCaseIdentifier pattern is implemented)
-        console.log(chalk.bold.yellow('⚠️  Edge Cases to Consider:\n'));
-        if (result.intent.primaryIntent === 'code-generation') {
-            console.log(chalk.yellow('  • Empty or null inputs'));
-            console.log(chalk.yellow('  • Very large inputs (performance implications)'));
-            console.log(chalk.yellow('  • Invalid or malformed data'));
-            console.log(chalk.yellow('  • Concurrent access (if applicable)'));
-            console.log(chalk.yellow('  • Network failures or timeouts (if I/O involved)'));
-        }
-        else if (result.intent.primaryIntent === 'planning') {
-            console.log(chalk.yellow('  • Scope creep during implementation'));
-            console.log(chalk.yellow('  • Technical constraints not identified upfront'));
-            console.log(chalk.yellow('  • Timeline assumptions that may not hold'));
-            console.log(chalk.yellow('  • Dependencies on external systems'));
-        }
-        else {
-            console.log(chalk.yellow('  • Unexpected user behavior'));
-            console.log(chalk.yellow('  • Error conditions and recovery'));
-            console.log(chalk.yellow('  • Resource limitations'));
-            console.log(chalk.yellow('  • Compatibility across environments'));
-        }
-        console.log();
         // Patterns Applied
         if (result.appliedPatterns.length > 0) {
             console.log(chalk.bold.blue('🧩 Patterns Applied:\n'));
@@ -168,7 +117,7 @@ export default class Deep extends Command {
             console.log(chalk.blue(`  ${recommendation}\n`));
         }
         console.log(chalk.gray(`⚡ Processed in ${result.processingTimeMs}ms\n`));
-        console.log(chalk.gray('💡 Tip: Use the enhanced prompt with the validation checklist and edge cases in mind\n'));
+        console.log(chalk.gray('💡 Tip: The enhanced prompt above includes alternative approaches, edge cases, and validation checklist\n'));
     }
     displayAnalysisOnly(result) {
         console.log(chalk.bold.cyan('🎯 Intent Analysis:\n'));
@@ -198,9 +147,6 @@ export default class Deep extends Command {
     async savePrompt(result) {
         try {
             const manager = new PromptManager();
-            const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, -5);
-            const hash = this.generateShortHash(result.original);
-            const filename = `deep-${timestamp}-${hash}`;
             // Format enhanced prompt as content
             const content = result.enhanced;
             await manager.savePrompt(content, 'deep', result.original);
@@ -215,7 +161,7 @@ export default class Deep extends Command {
         let hash = 0;
         for (let i = 0; i < text.length; i++) {
             const char = text.charCodeAt(i);
-            hash = ((hash << 5) - hash) + char;
+            hash = (hash << 5) - hash + char;
             hash = hash & hash;
         }
         return Math.abs(hash).toString(16).slice(0, 4);

package/dist/cli/commands/init.js

@@ -17,9 +17,7 @@ import { loadCommandTemplates } from '../../utils/template-loader.js';
 import { collectLegacyCommandFiles } from '../../utils/legacy-command-cleanup.js';
 export default class Init extends Command {
     static description = 'Initialize Clavix in the current project';
-    static examples = [
-        '<%= config.bin %> <%= command.id %>',
-    ];
+    static examples = ['<%= config.bin %> <%= command.id %>'];
     async run() {
         console.log(chalk.bold.cyan('\n🚀 Clavix Initialization\n'));
         try {
@@ -47,7 +45,7 @@ export default class Init extends Command {
                     const config = JSON.parse(configContent);
                     existingIntegrations = config.integrations || config.providers || [];
                 }
-                catch (error) {
+                catch {
                     // Ignore parse errors, will use empty array
                 }
             }
@@ -161,9 +159,10 @@ export default class Init extends Command {
                         },
                     ]);
                     if (!useNamespace) {
-                        adapter = adapter.name === 'gemini'
-                            ? new GeminiAdapter({ useNamespace: false })
-                            : new QwenAdapter({ useNamespace: false });
+                        adapter =
+                            adapter.name === 'gemini'
+                                ? new GeminiAdapter({ useNamespace: false })
+                                : new QwenAdapter({ useNamespace: false });
                         console.log(chalk.gray(`    → Using ${adapter.getCommandPath()} (no namespacing)`));
                     }
                 }
@@ -235,19 +234,17 @@ export default class Init extends Command {
         catch (error) {
             const { getErrorMessage, toError } = await import('../../utils/error-utils.js');
             console.error(chalk.red('\n✗ Initialization failed:'), getErrorMessage(error));
-            if (error && typeof error === 'object' && 'hint' in error && typeof error.hint === 'string') {
+            if (error &&
+                typeof error === 'object' &&
+                'hint' in error &&
+                typeof error.hint === 'string') {
                 console.error(chalk.yellow('  Hint:'), error.hint);
             }
             throw toError(error);
         }
     }
     async createDirectoryStructure() {
-        const dirs = [
-            '.clavix',
-            '.clavix/sessions',
-            '.clavix/outputs',
-            '.clavix/templates',
-        ];
+        const dirs = ['.clavix', '.clavix/sessions', '.clavix/outputs', '.clavix/templates'];
         for (const dir of dirs) {
             await FileSystem.ensureDir(dir);
         }
@@ -289,8 +286,8 @@ Welcome to Clavix! This directory contains your local Clavix configuration and d
 ## CLI Commands Reference
 
 ### Prompt Improvement
-- \`clavix fast "<prompt>"\` - Quick CLEAR (C/L/E) improvements with smart triage
-- \`clavix deep "<prompt>"\` - Comprehensive CLEAR (C/L/E/A/R) analysis with alternatives
+- \`clavix fast "<prompt>"\` - Quick Clavix Intelligence improvements with smart triage
+- \`clavix deep "<prompt>"\` - Comprehensive Clavix Intelligence analysis with alternatives
 - \`clavix execute [--latest]\` - Execute saved prompts from fast/deep optimization
 - \`clavix prompts list\` - View all saved prompts with status (NEW/EXECUTED/OLD/STALE)
 - \`clavix prompts clear\` - Cleanup prompts (\`--executed\`, \`--stale\`, \`--fast\`, \`--deep\`, \`--all\`)

package/dist/cli/commands/plan.js

@@ -80,7 +80,7 @@ export default class Plan extends Command {
             const resolvedProjectName = projectName ?? path.basename(prdPath);
             // Check if tasks.md already exists
             const tasksPath = path.join(prdPath, 'tasks.md');
-            if (await fs.pathExists(tasksPath) && !flags.overwrite) {
+            if ((await fs.pathExists(tasksPath)) && !flags.overwrite) {
                 console.log(chalk.yellow('Warning: tasks.md already exists.'));
                 console.log(chalk.gray(`Location: ${tasksPath}`));
                 console.log(chalk.gray('Use --overwrite to regenerate tasks.md.\n'));
@@ -151,7 +151,7 @@ export default class Plan extends Command {
             console.log(chalk.gray('  2. Edit if needed (add/remove/modify tasks)'));
             console.log(chalk.gray('  3. Run'), chalk.cyan('clavix implement'), chalk.gray('to start implementation'));
             console.log();
-            console.log(chalk.dim('Tip: Tasks follow CLEAR framework principles for optimal AI execution\n'));
+            console.log(chalk.dim('Tip: Tasks are optimized with Clavix Intelligence for optimal AI execution\n'));
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : 'An unexpected error occurred';

package/dist/core/conversation-quality-tracker.d.ts

@@ -0,0 +1,81 @@
+/**
+ * v4.3.2: Conversation Quality Tracker
+ *
+ * Implements the "Supportive Companion" UX pattern for conversational mode.
+ * Silently tracks quality, provides positive reinforcement, and gentle guidance.
+ */
+export interface TrackedTopic {
+    name: string;
+    confidence: number;
+    firstMentioned: number;
+}
+export interface ConversationQuality {
+    topics: TrackedTopic[];
+    overallCompleteness: number;
+    ambiguityLevel: number;
+    messageCount: number;
+}
+export interface NudgeResult {
+    shouldNudge: boolean;
+    message?: string;
+    gap?: string;
+}
+/**
+ * ConversationQualityTracker - "Supportive Companion" UX
+ *
+ * Design principles:
+ * - Silent tracking during normal flow
+ * - Celebrate progress, don't criticize gaps
+ * - Gentle nudge only for critical issues (max 1 per session)
+ * - Always reassure that Clavix will help
+ */
+export declare class ConversationQualityTracker {
+    private topics;
+    private messageCount;
+    private hasNudged;
+    private lastCheckpointAt;
+    private readonly TOPIC_KEYWORDS;
+    private readonly CRITICAL_TOPICS;
+    /**
+     * Track a new message (silent analysis)
+     */
+    trackMessage(content: string): void;
+    /**
+     * Get positive checkpoint message (call after ~5 messages or on "status")
+     * Returns null if not time for a checkpoint
+     */
+    getPositiveCheckpoint(): string | null;
+    /**
+     * Check if a gentle nudge is needed (max 1 per session, only for critical gaps)
+     */
+    shouldNudge(): NudgeResult;
+    /**
+     * Get reassuring end-of-session message
+     */
+    getEndMessage(): string;
+    /**
+     * Get current quality metrics (for internal use)
+     */
+    calculateQuality(): ConversationQuality;
+    /**
+     * Get list of covered topics (user-friendly names)
+     */
+    private getCoveredTopics;
+    /**
+     * Find a critical gap to nudge about
+     */
+    private findCriticalGap;
+    /**
+     * Analyze message content for topic coverage
+     */
+    private analyzeTopics;
+    /**
+     * Reset tracker for new session
+     */
+    reset(): void;
+    /**
+     * Get summary for debugging/logging
+     */
+    getSummary(): string;
+}
+//# sourceMappingURL=conversation-quality-tracker.d.ts.map