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.
- package/LICENSE +201 -21
- package/README.md +1 -1
- package/dist/core/conversation-quality-tracker.d.ts +81 -0
- package/dist/core/conversation-quality-tracker.js +195 -0
- package/dist/core/intelligence/intent-detector.js +3 -0
- package/dist/core/intelligence/pattern-library.d.ts +33 -1
- package/dist/core/intelligence/pattern-library.js +168 -0
- package/dist/core/intelligence/patterns/conversation-summarizer.d.ts +28 -0
- package/dist/core/intelligence/patterns/conversation-summarizer.js +253 -0
- package/dist/core/intelligence/patterns/dependency-identifier.d.ts +21 -0
- package/dist/core/intelligence/patterns/dependency-identifier.js +149 -0
- package/dist/core/intelligence/patterns/implicit-requirement-extractor.d.ts +22 -0
- package/dist/core/intelligence/patterns/implicit-requirement-extractor.js +236 -0
- package/dist/core/intelligence/patterns/requirement-prioritizer.d.ts +22 -0
- package/dist/core/intelligence/patterns/requirement-prioritizer.js +117 -0
- package/dist/core/intelligence/patterns/success-metrics-enforcer.d.ts +22 -0
- package/dist/core/intelligence/patterns/success-metrics-enforcer.js +142 -0
- package/dist/core/intelligence/patterns/topic-coherence-analyzer.d.ts +24 -0
- package/dist/core/intelligence/patterns/topic-coherence-analyzer.js +282 -0
- package/dist/core/intelligence/patterns/user-persona-enricher.d.ts +22 -0
- package/dist/core/intelligence/patterns/user-persona-enricher.js +124 -0
- package/dist/core/intelligence/quality-assessor.js +2 -0
- package/dist/core/intelligence/types.d.ts +7 -2
- package/dist/core/intelligence/universal-optimizer.d.ts +27 -2
- package/dist/core/intelligence/universal-optimizer.js +65 -5
- package/dist/templates/slash-commands/_canonical/deep.md +2 -1
- package/dist/templates/slash-commands/_canonical/execute.md +1 -1
- package/dist/templates/slash-commands/_canonical/fast.md +2 -1
- package/dist/templates/slash-commands/_canonical/implement.md +1 -1
- package/dist/templates/slash-commands/_canonical/plan.md +1 -1
- package/dist/templates/slash-commands/_canonical/prd.md +1 -1
- package/dist/templates/slash-commands/_canonical/start.md +21 -1
- package/dist/templates/slash-commands/_canonical/summarize.md +43 -2
- package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +26 -2
- package/dist/types/config.d.ts +24 -0
- 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.
|
|
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
|
-
**
|
|
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.
|
|
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 |
|
|
119
|
-
| Deep |
|
|
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 |
|
package/dist/types/config.d.ts
CHANGED
|
@@ -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
|
+
"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": "
|
|
57
|
+
"license": "Apache-2.0",
|
|
58
58
|
"bugs": {
|
|
59
59
|
"url": "https://github.com/ClavixDev/Clavix/issues"
|
|
60
60
|
},
|