clavix 4.3.1 → 4.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (36) hide show
  1. package/LICENSE +201 -21
  2. package/README.md +1 -1
  3. package/dist/core/conversation-quality-tracker.d.ts +81 -0
  4. package/dist/core/conversation-quality-tracker.js +195 -0
  5. package/dist/core/intelligence/intent-detector.js +3 -0
  6. package/dist/core/intelligence/pattern-library.d.ts +33 -1
  7. package/dist/core/intelligence/pattern-library.js +168 -0
  8. package/dist/core/intelligence/patterns/conversation-summarizer.d.ts +28 -0
  9. package/dist/core/intelligence/patterns/conversation-summarizer.js +253 -0
  10. package/dist/core/intelligence/patterns/dependency-identifier.d.ts +21 -0
  11. package/dist/core/intelligence/patterns/dependency-identifier.js +149 -0
  12. package/dist/core/intelligence/patterns/implicit-requirement-extractor.d.ts +22 -0
  13. package/dist/core/intelligence/patterns/implicit-requirement-extractor.js +236 -0
  14. package/dist/core/intelligence/patterns/requirement-prioritizer.d.ts +22 -0
  15. package/dist/core/intelligence/patterns/requirement-prioritizer.js +117 -0
  16. package/dist/core/intelligence/patterns/success-metrics-enforcer.d.ts +22 -0
  17. package/dist/core/intelligence/patterns/success-metrics-enforcer.js +142 -0
  18. package/dist/core/intelligence/patterns/topic-coherence-analyzer.d.ts +24 -0
  19. package/dist/core/intelligence/patterns/topic-coherence-analyzer.js +282 -0
  20. package/dist/core/intelligence/patterns/user-persona-enricher.d.ts +22 -0
  21. package/dist/core/intelligence/patterns/user-persona-enricher.js +124 -0
  22. package/dist/core/intelligence/quality-assessor.js +2 -0
  23. package/dist/core/intelligence/types.d.ts +7 -2
  24. package/dist/core/intelligence/universal-optimizer.d.ts +27 -2
  25. package/dist/core/intelligence/universal-optimizer.js +65 -5
  26. package/dist/templates/slash-commands/_canonical/deep.md +2 -1
  27. package/dist/templates/slash-commands/_canonical/execute.md +1 -1
  28. package/dist/templates/slash-commands/_canonical/fast.md +2 -1
  29. package/dist/templates/slash-commands/_canonical/implement.md +1 -1
  30. package/dist/templates/slash-commands/_canonical/plan.md +1 -1
  31. package/dist/templates/slash-commands/_canonical/prd.md +1 -1
  32. package/dist/templates/slash-commands/_canonical/start.md +21 -1
  33. package/dist/templates/slash-commands/_canonical/summarize.md +43 -2
  34. package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +26 -2
  35. package/dist/types/config.d.ts +24 -0
  36. package/package.json +2 -2
@@ -190,7 +190,27 @@ The goal is natural exploration of requirements, not a rigid questionnaire. Foll
190
190
 
191
191
  ---
192
192
 
193
- ## Agent Transparency (v4.1)
193
+ ## Agent Transparency (v4.4)
194
+
195
+ ### Enhanced Conversational Analysis (v4.4)
196
+
197
+ Clavix Intelligence™ now includes enhanced conversational pattern recognition:
198
+
199
+ **Topic Detection** (~15 topic areas):
200
+ - Automatically detects: User Interface, Backend/API, Database, Authentication, Performance, Testing, Deployment, User Experience, Business Logic, Integration, Security, Analytics, Error Handling, Documentation, State Management
201
+ - Groups related keywords for more accurate multi-topic detection
202
+ - Triggers focus suggestions when 3+ distinct topics detected
203
+
204
+ **Conversational Markers** (~30 patterns):
205
+ - Intent expressions: "i want", "we need", "should be able to"
206
+ - Thinking/exploring: "thinking about", "what if", "how about"
207
+ - Informal markers: "basically", "kind of like", "something like"
208
+ - Collaborative: "can we", "could we", "shall we"
209
+
210
+ **Implicit Requirement Detection**:
211
+ - Surfaces unstated requirements from context
212
+ - Categories: Infrastructure, Security, Performance, UX, Integration
213
+ - Examples: "mobile" → responsive design, "real-time" → WebSocket infrastructure
194
214
 
195
215
  ### Agent Decision Rules
196
216
  {{INCLUDE:agent-protocols/decision-rules.md}}
@@ -104,7 +104,15 @@ Implementation: BLOCKED - I will extract requirements, not implement them
104
104
  - **Success Criteria** [confidence]: How will success be measured?
105
105
  - **Context** [confidence]: Any important background or constraints?
106
106
 
107
- **CHECKPOINT:** Extracted [N] requirements, [M] constraints from conversation
107
+ **Calculate Extraction Confidence (v4.4):**
108
+ - Start with 50% base (conversational content detected)
109
+ - Add 20% if concrete requirements extracted
110
+ - Add 15% if clear goals identified
111
+ - Add 15% if constraints defined
112
+ - Display: "*Extraction confidence: X%*"
113
+ - If confidence < 80%, include verification prompt in output
114
+
115
+ **CHECKPOINT:** Extracted [N] requirements, [M] constraints from conversation (confidence: X%)
108
116
 
109
117
  3. **CREATE OUTPUT FILES (REQUIRED)** - You MUST create three files. This is not optional.
110
118
 
@@ -156,6 +164,12 @@ Implementation: BLOCKED - I will extract requirements, not implement them
156
164
  - [Edge case 1 and how it should be handled]
157
165
  - [Open question 1 - needs clarification]
158
166
 
167
+ ## Implicit Requirements (v4.4)
168
+ *Inferred from conversation context - please verify:*
169
+ - [Category] [Requirement inferred from discussion]
170
+ - [Category] [Another requirement]
171
+ > **Note:** These requirements were surfaced by analyzing conversation patterns.
172
+
159
173
  ## Success Criteria
160
174
  How we know this is complete and working:
161
175
  - ✓ [Specific success criterion 1]
@@ -344,7 +358,34 @@ Implementation: BLOCKED - I will extract requirements, not implement them
344
358
 
345
359
  ---
346
360
 
347
- ## Agent Transparency (v4.1)
361
+ ## Agent Transparency (v4.4)
362
+
363
+ ### Enhanced Extraction Capabilities (v4.4)
364
+
365
+ Clavix Intelligence™ now includes enhanced extraction with confidence scoring:
366
+
367
+ **Extraction Confidence** (auto-calculated):
368
+ - Base confidence: 50% (conversational content detected)
369
+ - +20% if concrete requirements extracted
370
+ - +15% if clear goals identified
371
+ - +15% if constraints defined
372
+ - Display: "Extraction confidence: X%"
373
+ - If <80%, add verification prompt to output
374
+
375
+ **Implicit Requirements** (auto-surfaced):
376
+ - Inferred from conversation context, grouped by category:
377
+ - **Infrastructure**: Mobile-responsive, real-time, scalability, offline, multi-tenant
378
+ - **Security**: Audit compliance, data privacy, encryption
379
+ - **Performance**: Speed optimization, low-latency
380
+ - **UX**: Simplicity focus, accessibility (WCAG)
381
+ - **Integration**: Notifications, search, analytics, APIs, data import/export
382
+ - Up to 10 implicit requirements per extraction
383
+ - Always marked with verification note
384
+
385
+ **Topic Organization**:
386
+ - Detects 15 topic categories with expanded keyword matching
387
+ - Groups multi-topic extractions by area
388
+ - Suggests separate PRDs for 3+ distinct topics
348
389
 
349
390
  ### Quality Output Format
350
391
  {{INCLUDE:agent-protocols/quality-output.md}}
@@ -75,6 +75,21 @@ Patterns: 7 applied (deep mode)
75
75
  | SuccessCriteriaEnforcer | 6 | Adds measurable success criteria |
76
76
  | DomainContextEnricher | 5 | Adds domain-specific best practices |
77
77
 
78
+ **v4.3.2 PRD Mode Patterns (deep mode):**
79
+ | Pattern | Priority | What It Does |
80
+ |---------|----------|--------------|
81
+ | RequirementPrioritizer | 7 | Separates must-have from nice-to-have requirements |
82
+ | UserPersonaEnricher | 6 | Adds missing user context and personas |
83
+ | SuccessMetricsEnforcer | 7 | Ensures measurable success criteria exist |
84
+ | DependencyIdentifier | 5 | Identifies technical and external dependencies |
85
+
86
+ **v4.3.2 Conversational Mode Patterns (deep mode):**
87
+ | Pattern | Priority | What It Does |
88
+ |---------|----------|--------------|
89
+ | ConversationSummarizer | 8 | Extracts structured requirements from messages |
90
+ | TopicCoherenceAnalyzer | 6 | Detects topic shifts and multi-topic conversations |
91
+ | ImplicitRequirementExtractor | 7 | Surfaces requirements mentioned indirectly |
92
+
78
93
  ### Pattern Selection Logic
79
94
 
80
95
  Patterns are selected based on:
@@ -109,11 +124,20 @@ Deep mode only:
109
124
  AlternativePhrasingGenerator, EdgeCaseIdentifier, ValidationChecklistCreator,
110
125
  AssumptionExplicitizer, ScopeDefiner, PRDStructureEnforcer,
111
126
  ErrorToleranceEnhancer, PrerequisiteIdentifier
127
+
128
+ v4.3.2 PRD mode (deep):
129
+ RequirementPrioritizer, UserPersonaEnricher, SuccessMetricsEnforcer,
130
+ DependencyIdentifier
131
+
132
+ v4.3.2 Conversational mode (deep):
133
+ ConversationSummarizer, TopicCoherenceAnalyzer, ImplicitRequirementExtractor
112
134
  ```
113
135
 
114
136
  ### Pattern Count by Mode
115
137
 
116
138
  | Mode | Patterns Available | Typical Applied |
117
139
  |------|-------------------|-----------------|
118
- | Fast | 14 core patterns | 4-7 patterns |
119
- | Deep | 20 total patterns | 8-14 patterns |
140
+ | Fast | 21 core patterns | 4-7 patterns |
141
+ | Deep | 27 total patterns | 8-14 patterns |
142
+ | PRD | 15 patterns | 10-15 patterns |
143
+ | Conversational | 11 patterns | 6-11 patterns |
@@ -7,8 +7,32 @@ export interface ClavixConfig {
7
7
  templates: TemplateConfig;
8
8
  outputs: OutputConfig;
9
9
  preferences: PreferencesConfig;
10
+ intelligence?: IntelligenceConfig;
10
11
  experimental?: Record<string, unknown>;
11
12
  }
13
+ /**
14
+ * v4.4 Intelligence Configuration
15
+ * Configure pattern behavior, enable/disable patterns, adjust priorities
16
+ */
17
+ export interface IntelligenceConfig {
18
+ /** Pattern-specific settings */
19
+ patterns?: PatternSettingsConfig;
20
+ /** Default mode for optimization */
21
+ defaultMode?: 'fast' | 'deep';
22
+ /** Enable verbose pattern logging */
23
+ verbosePatternLogs?: boolean;
24
+ }
25
+ /**
26
+ * Pattern-specific settings
27
+ */
28
+ export interface PatternSettingsConfig {
29
+ /** Disabled pattern IDs (won't run even if applicable) */
30
+ disabled?: string[];
31
+ /** Priority overrides (pattern-id → new priority 1-10) */
32
+ priorityOverrides?: Record<string, number>;
33
+ /** Custom pattern parameters (pattern-id → settings) */
34
+ customSettings?: Record<string, Record<string, unknown>>;
35
+ }
12
36
  /**
13
37
  * Legacy config format (pre-v3.5.0)
14
38
  * Supports migration from:
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "clavix",
3
- "version": "4.3.1",
3
+ "version": "4.4.0",
4
4
  "description": "Clavix 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.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -54,7 +54,7 @@
54
54
  "requirements"
55
55
  ],
56
56
  "author": "ClavixDev",
57
- "license": "MIT",
57
+ "license": "Apache-2.0",
58
58
  "bugs": {
59
59
  "url": "https://github.com/ClavixDev/Clavix/issues"
60
60
  },