clavix 4.11.2 → 5.0.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 (162) hide show
  1. package/README.md +72 -60
  2. package/dist/cli/commands/update.js +9 -10
  3. package/dist/templates/agents/agents.md +14 -8
  4. package/dist/templates/agents/copilot-instructions.md +1 -1
  5. package/dist/templates/instructions/core/verification.md +2 -2
  6. package/dist/templates/slash-commands/_canonical/archive.md +83 -121
  7. package/dist/templates/slash-commands/_canonical/execute.md +32 -42
  8. package/dist/templates/slash-commands/_canonical/implement.md +32 -44
  9. package/dist/templates/slash-commands/_canonical/improve.md +14 -53
  10. package/dist/templates/slash-commands/_canonical/start.md +1 -1
  11. package/dist/templates/slash-commands/_canonical/summarize.md +8 -8
  12. package/dist/templates/slash-commands/_components/agent-protocols/cli-reference.md +84 -180
  13. package/dist/templates/slash-commands/_components/agent-protocols/error-handling.md +2 -2
  14. package/dist/templates/slash-commands/_components/agent-protocols/file-formats.md +41 -59
  15. package/dist/templates/slash-commands/_components/agent-protocols/state-assertion.md +1 -1
  16. package/dist/templates/slash-commands/_components/references/intent-types.md +1 -1
  17. package/dist/templates/slash-commands/_components/sections/file-saving-protocol.md +20 -27
  18. package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +29 -46
  19. package/dist/templates/slash-commands/_components/troubleshooting/file-not-saved.md +4 -5
  20. package/dist/types/config.d.ts +57 -0
  21. package/dist/utils/legacy-command-cleanup.js +31 -4
  22. package/package.json +5 -4
  23. package/dist/cli/commands/analyze.d.ts +0 -17
  24. package/dist/cli/commands/analyze.js +0 -133
  25. package/dist/cli/commands/archive.d.ts +0 -36
  26. package/dist/cli/commands/archive.js +0 -266
  27. package/dist/cli/commands/deep.d.ts +0 -17
  28. package/dist/cli/commands/deep.js +0 -170
  29. package/dist/cli/commands/execute.d.ts +0 -15
  30. package/dist/cli/commands/execute.js +0 -168
  31. package/dist/cli/commands/fast.d.ts +0 -18
  32. package/dist/cli/commands/fast.js +0 -219
  33. package/dist/cli/commands/implement.d.ts +0 -24
  34. package/dist/cli/commands/implement.js +0 -289
  35. package/dist/cli/commands/improve.d.ts +0 -32
  36. package/dist/cli/commands/improve.js +0 -250
  37. package/dist/cli/commands/list.d.ts +0 -17
  38. package/dist/cli/commands/list.js +0 -217
  39. package/dist/cli/commands/plan.d.ts +0 -21
  40. package/dist/cli/commands/plan.js +0 -297
  41. package/dist/cli/commands/prd.d.ts +0 -24
  42. package/dist/cli/commands/prd.js +0 -321
  43. package/dist/cli/commands/prompts/clear.d.ts +0 -16
  44. package/dist/cli/commands/prompts/clear.js +0 -222
  45. package/dist/cli/commands/prompts/list.d.ts +0 -8
  46. package/dist/cli/commands/prompts/list.js +0 -88
  47. package/dist/cli/commands/show.d.ts +0 -21
  48. package/dist/cli/commands/show.js +0 -191
  49. package/dist/cli/commands/start.d.ts +0 -40
  50. package/dist/cli/commands/start.js +0 -210
  51. package/dist/cli/commands/summarize.d.ts +0 -17
  52. package/dist/cli/commands/summarize.js +0 -196
  53. package/dist/cli/commands/task-complete.d.ts +0 -27
  54. package/dist/cli/commands/task-complete.js +0 -269
  55. package/dist/cli/commands/verify.d.ts +0 -28
  56. package/dist/cli/commands/verify.js +0 -349
  57. package/dist/core/archive-manager.d.ts +0 -100
  58. package/dist/core/archive-manager.js +0 -302
  59. package/dist/core/basic-checklist-generator.d.ts +0 -35
  60. package/dist/core/basic-checklist-generator.js +0 -344
  61. package/dist/core/checklist-parser.d.ts +0 -48
  62. package/dist/core/checklist-parser.js +0 -238
  63. package/dist/core/config-manager.d.ts +0 -149
  64. package/dist/core/config-manager.js +0 -230
  65. package/dist/core/conversation-analyzer.d.ts +0 -86
  66. package/dist/core/conversation-analyzer.js +0 -387
  67. package/dist/core/conversation-quality-tracker.d.ts +0 -81
  68. package/dist/core/conversation-quality-tracker.js +0 -195
  69. package/dist/core/git-manager.d.ts +0 -126
  70. package/dist/core/git-manager.js +0 -282
  71. package/dist/core/intelligence/confidence-calculator.d.ts +0 -93
  72. package/dist/core/intelligence/confidence-calculator.js +0 -124
  73. package/dist/core/intelligence/index.d.ts +0 -11
  74. package/dist/core/intelligence/index.js +0 -15
  75. package/dist/core/intelligence/intent-detector.d.ts +0 -54
  76. package/dist/core/intelligence/intent-detector.js +0 -723
  77. package/dist/core/intelligence/pattern-library.d.ts +0 -104
  78. package/dist/core/intelligence/pattern-library.js +0 -339
  79. package/dist/core/intelligence/patterns/actionability-enhancer.d.ts +0 -27
  80. package/dist/core/intelligence/patterns/actionability-enhancer.js +0 -192
  81. package/dist/core/intelligence/patterns/alternative-phrasing-generator.d.ts +0 -29
  82. package/dist/core/intelligence/patterns/alternative-phrasing-generator.js +0 -239
  83. package/dist/core/intelligence/patterns/ambiguity-detector.d.ts +0 -22
  84. package/dist/core/intelligence/patterns/ambiguity-detector.js +0 -196
  85. package/dist/core/intelligence/patterns/assumption-explicitizer.d.ts +0 -30
  86. package/dist/core/intelligence/patterns/assumption-explicitizer.js +0 -296
  87. package/dist/core/intelligence/patterns/base-pattern.d.ts +0 -192
  88. package/dist/core/intelligence/patterns/base-pattern.js +0 -103
  89. package/dist/core/intelligence/patterns/completeness-validator.d.ts +0 -27
  90. package/dist/core/intelligence/patterns/completeness-validator.js +0 -221
  91. package/dist/core/intelligence/patterns/conciseness-filter.d.ts +0 -20
  92. package/dist/core/intelligence/patterns/conciseness-filter.js +0 -92
  93. package/dist/core/intelligence/patterns/context-precision.d.ts +0 -32
  94. package/dist/core/intelligence/patterns/context-precision.js +0 -389
  95. package/dist/core/intelligence/patterns/conversation-summarizer.d.ts +0 -30
  96. package/dist/core/intelligence/patterns/conversation-summarizer.js +0 -277
  97. package/dist/core/intelligence/patterns/dependency-identifier.d.ts +0 -23
  98. package/dist/core/intelligence/patterns/dependency-identifier.js +0 -166
  99. package/dist/core/intelligence/patterns/domain-context-enricher.d.ts +0 -21
  100. package/dist/core/intelligence/patterns/domain-context-enricher.js +0 -198
  101. package/dist/core/intelligence/patterns/edge-case-identifier.d.ts +0 -30
  102. package/dist/core/intelligence/patterns/edge-case-identifier.js +0 -269
  103. package/dist/core/intelligence/patterns/error-tolerance-enhancer.d.ts +0 -22
  104. package/dist/core/intelligence/patterns/error-tolerance-enhancer.js +0 -179
  105. package/dist/core/intelligence/patterns/implicit-requirement-extractor.d.ts +0 -24
  106. package/dist/core/intelligence/patterns/implicit-requirement-extractor.js +0 -259
  107. package/dist/core/intelligence/patterns/objective-clarifier.d.ts +0 -22
  108. package/dist/core/intelligence/patterns/objective-clarifier.js +0 -126
  109. package/dist/core/intelligence/patterns/output-format-enforcer.d.ts +0 -22
  110. package/dist/core/intelligence/patterns/output-format-enforcer.js +0 -151
  111. package/dist/core/intelligence/patterns/prd-structure-enforcer.d.ts +0 -23
  112. package/dist/core/intelligence/patterns/prd-structure-enforcer.js +0 -183
  113. package/dist/core/intelligence/patterns/prerequisite-identifier.d.ts +0 -23
  114. package/dist/core/intelligence/patterns/prerequisite-identifier.js +0 -221
  115. package/dist/core/intelligence/patterns/requirement-prioritizer.d.ts +0 -24
  116. package/dist/core/intelligence/patterns/requirement-prioritizer.js +0 -134
  117. package/dist/core/intelligence/patterns/scope-definer.d.ts +0 -26
  118. package/dist/core/intelligence/patterns/scope-definer.js +0 -236
  119. package/dist/core/intelligence/patterns/step-decomposer.d.ts +0 -31
  120. package/dist/core/intelligence/patterns/step-decomposer.js +0 -242
  121. package/dist/core/intelligence/patterns/structure-organizer.d.ts +0 -31
  122. package/dist/core/intelligence/patterns/structure-organizer.js +0 -218
  123. package/dist/core/intelligence/patterns/success-criteria-enforcer.d.ts +0 -22
  124. package/dist/core/intelligence/patterns/success-criteria-enforcer.js +0 -165
  125. package/dist/core/intelligence/patterns/success-metrics-enforcer.d.ts +0 -24
  126. package/dist/core/intelligence/patterns/success-metrics-enforcer.js +0 -165
  127. package/dist/core/intelligence/patterns/technical-context-enricher.d.ts +0 -25
  128. package/dist/core/intelligence/patterns/technical-context-enricher.js +0 -165
  129. package/dist/core/intelligence/patterns/topic-coherence-analyzer.d.ts +0 -26
  130. package/dist/core/intelligence/patterns/topic-coherence-analyzer.js +0 -300
  131. package/dist/core/intelligence/patterns/user-persona-enricher.d.ts +0 -24
  132. package/dist/core/intelligence/patterns/user-persona-enricher.js +0 -141
  133. package/dist/core/intelligence/patterns/validation-checklist-creator.d.ts +0 -31
  134. package/dist/core/intelligence/patterns/validation-checklist-creator.js +0 -242
  135. package/dist/core/intelligence/quality-assessor.d.ts +0 -51
  136. package/dist/core/intelligence/quality-assessor.js +0 -505
  137. package/dist/core/intelligence/types.d.ts +0 -111
  138. package/dist/core/intelligence/types.js +0 -3
  139. package/dist/core/intelligence/universal-optimizer.d.ts +0 -84
  140. package/dist/core/intelligence/universal-optimizer.js +0 -371
  141. package/dist/core/prd-generator.d.ts +0 -76
  142. package/dist/core/prd-generator.js +0 -173
  143. package/dist/core/prompt-manager.d.ts +0 -110
  144. package/dist/core/prompt-manager.js +0 -274
  145. package/dist/core/prompt-optimizer.d.ts +0 -268
  146. package/dist/core/prompt-optimizer.js +0 -959
  147. package/dist/core/question-engine.d.ts +0 -167
  148. package/dist/core/question-engine.js +0 -356
  149. package/dist/core/session-manager.d.ts +0 -139
  150. package/dist/core/session-manager.js +0 -365
  151. package/dist/core/task-manager.d.ts +0 -211
  152. package/dist/core/task-manager.js +0 -981
  153. package/dist/core/verification-hooks.d.ts +0 -67
  154. package/dist/core/verification-hooks.js +0 -309
  155. package/dist/core/verification-manager.d.ts +0 -107
  156. package/dist/core/verification-manager.js +0 -415
  157. package/dist/index 2.js +0 -13
  158. package/dist/index.d 2.ts +0 -4
  159. package/dist/types/session.d.ts +0 -78
  160. package/dist/types/session.js +0 -8
  161. package/dist/types/verification.d.ts +0 -205
  162. package/dist/types/verification.js +0 -9
@@ -1,268 +0,0 @@
1
- /**
2
- * PromptOptimizer - Analyzes and improves prompts using the CLEAR Framework
3
- * CLEAR Framework: Concise, Logical, Explicit, Adaptive, Reflective
4
- * Developed by Dr. Leo Lo, University of New Mexico
5
- * Reference: https://guides.library.tamucc.edu/prompt-engineering/clear
6
- */
7
- export type OptimizerMode = 'fast' | 'deep';
8
- export interface PromptAnalysis {
9
- gaps: string[];
10
- ambiguities: string[];
11
- strengths: string[];
12
- suggestions: string[];
13
- }
14
- export interface ConciseAnalysis {
15
- score: number;
16
- verbosityCount: number;
17
- pleasantriesCount: number;
18
- signalToNoiseRatio: number;
19
- issues: string[];
20
- suggestions: string[];
21
- }
22
- export interface LogicAnalysis {
23
- score: number;
24
- hasCoherentFlow: boolean;
25
- sequencingIssues: string[];
26
- suggestedOrder: string[];
27
- issues: string[];
28
- suggestions: string[];
29
- }
30
- export interface ExplicitAnalysis {
31
- score: number;
32
- hasPersona: boolean;
33
- hasOutputFormat: boolean;
34
- hasToneStyle: boolean;
35
- hasSuccessCriteria: boolean;
36
- hasExamples: boolean;
37
- issues: string[];
38
- suggestions: string[];
39
- }
40
- export interface AdaptiveAnalysis {
41
- score: number;
42
- alternativePhrasings: string[];
43
- alternativeStructures: Array<{
44
- name: string;
45
- structure: string;
46
- benefits: string;
47
- }>;
48
- temperatureRecommendation: number;
49
- issues: string[];
50
- suggestions: string[];
51
- }
52
- export interface ReflectiveAnalysis {
53
- score: number;
54
- validationChecklist: string[];
55
- edgeCases: string[];
56
- potentialIssues: string[];
57
- factCheckingSteps: string[];
58
- qualityCriteria: string[];
59
- issues: string[];
60
- suggestions: string[];
61
- }
62
- export interface CLEARResult {
63
- conciseness: ConciseAnalysis;
64
- logic: LogicAnalysis;
65
- explicitness: ExplicitAnalysis;
66
- adaptiveness?: AdaptiveAnalysis;
67
- reflectiveness?: ReflectiveAnalysis;
68
- overallScore: number;
69
- improvedPrompt: string;
70
- changesSummary: Array<{
71
- component: 'C' | 'L' | 'E' | 'A' | 'R';
72
- change: string;
73
- }>;
74
- }
75
- export interface CLEARScore {
76
- overall: number;
77
- conciseness: number;
78
- logic: number;
79
- explicitness: number;
80
- adaptiveness?: number;
81
- reflectiveness?: number;
82
- rating: 'excellent' | 'good' | 'needs-improvement' | 'poor';
83
- }
84
- export interface TriageResult {
85
- needsDeepAnalysis: boolean;
86
- reasons: string[];
87
- }
88
- export interface QualityAssessment {
89
- isAlreadyGood: boolean;
90
- criteriaMetCount: number;
91
- totalCriteria: number;
92
- criteriaResults: {
93
- clearGoal: boolean;
94
- sufficientContext: boolean;
95
- actionableLanguage: boolean;
96
- reasonableScope: boolean;
97
- };
98
- }
99
- export interface ChangesSummary {
100
- changes: string[];
101
- }
102
- export interface ImprovedPrompt {
103
- original: string;
104
- analysis: PromptAnalysis;
105
- improved: string;
106
- changesSummary?: ChangesSummary;
107
- triageResult?: TriageResult;
108
- qualityAssessment?: QualityAssessment;
109
- alternativePhrasings?: string[];
110
- edgeCases?: string[];
111
- implementationExamples?: {
112
- good: string[];
113
- bad: string[];
114
- };
115
- alternativeStructures?: Array<{
116
- structure: string;
117
- benefits: string;
118
- }>;
119
- potentialIssues?: string[];
120
- }
121
- export declare class PromptOptimizer {
122
- /**
123
- * Analyze a prompt and identify issues
124
- */
125
- analyze(prompt: string): PromptAnalysis;
126
- /**
127
- * Perform smart triage to determine if deep analysis is recommended
128
- */
129
- performTriage(prompt: string): TriageResult;
130
- /**
131
- * Assess prompt quality
132
- */
133
- assessQuality(prompt: string): QualityAssessment;
134
- /**
135
- * Generate an improved version of the prompt
136
- */
137
- improve(prompt: string, mode?: OptimizerMode): ImprovedPrompt;
138
- /**
139
- * Apply CLEAR Framework analysis to a prompt
140
- * C = Concise, L = Logical, E = Explicit, A = Adaptive (deep only), R = Reflective (deep only)
141
- */
142
- applyCLEARFramework(prompt: string, mode?: OptimizerMode): CLEARResult;
143
- /**
144
- * Analyze Conciseness (C): Brevity and clarity
145
- */
146
- analyzeConciseness(prompt: string): ConciseAnalysis;
147
- /**
148
- * Analyze Logic (L): Structured and coherent prompts
149
- */
150
- analyzeLogic(prompt: string): LogicAnalysis;
151
- /**
152
- * Analyze Explicitness (E): Clear output specifications
153
- */
154
- analyzeExplicitness(prompt: string): ExplicitAnalysis;
155
- /**
156
- * Analyze Adaptiveness (A): Flexibility and customization
157
- */
158
- analyzeAdaptiveness(prompt: string): AdaptiveAnalysis;
159
- /**
160
- * Analyze Reflectiveness (R): Continuous evaluation and improvement
161
- */
162
- analyzeReflectiveness(prompt: string): ReflectiveAnalysis;
163
- /**
164
- * Calculate overall CLEAR score with weighted components
165
- */
166
- calculateCLEARScore(analysis: {
167
- conciseness: ConciseAnalysis;
168
- logic: LogicAnalysis;
169
- explicitness: ExplicitAnalysis;
170
- adaptiveness?: AdaptiveAnalysis;
171
- reflectiveness?: ReflectiveAnalysis;
172
- }): CLEARScore;
173
- /**
174
- * Generate improved prompt using CLEAR framework insights
175
- */
176
- private generateCLEARImprovedPrompt;
177
- /**
178
- * Generate CLEAR-labeled changes summary
179
- */
180
- private generateCLEARChangesSummary;
181
- /**
182
- * Map CLEAR result to legacy PromptAnalysis format for backward compatibility
183
- */
184
- mapCLEARToLegacy(clearResult: CLEARResult): PromptAnalysis;
185
- /**
186
- * Extract strengths from CLEAR analysis
187
- */
188
- private extractCLEARStrengths;
189
- /**
190
- * Find gaps in the prompt
191
- */
192
- private findGaps;
193
- /**
194
- * Find ambiguities in the prompt
195
- */
196
- private findAmbiguities;
197
- /**
198
- * Find strengths in the prompt
199
- */
200
- private findStrengths;
201
- /**
202
- * Generate improvement suggestions
203
- */
204
- private generateSuggestions;
205
- /**
206
- * Generate improved prompt with structure
207
- */
208
- private generateImprovedPrompt;
209
- private hasContext;
210
- private hasSuccessCriteria;
211
- private hasTechnicalDetails;
212
- private hasUserNeeds;
213
- private hasExpectedOutput;
214
- private extractOrInferObjective;
215
- private extractOrInferRequirements;
216
- private extractOrInferTechnical;
217
- private extractOrInferOutput;
218
- private extractOrInferSuccess;
219
- /**
220
- * Count missing critical elements
221
- */
222
- private countMissingCriticalElements;
223
- /**
224
- * Check for vague scope words without sufficient context
225
- */
226
- private hasVagueScopeWithoutContext;
227
- /**
228
- * Check if prompt has a clear goal
229
- */
230
- private hasClearGoal;
231
- /**
232
- * Check if prompt uses actionable language
233
- */
234
- private hasActionableLanguage;
235
- /**
236
- * Check if prompt has reasonable scope
237
- */
238
- private hasReasonableScope;
239
- /**
240
- * Generate changes summary
241
- */
242
- private generateChangesSummary;
243
- /**
244
- * Generate alternative phrasings (deep mode)
245
- */
246
- private generateAlternativePhrasings;
247
- /**
248
- * Identify edge cases in requirements (deep mode)
249
- */
250
- private identifyEdgeCases;
251
- /**
252
- * Generate implementation examples (deep mode)
253
- */
254
- private generateImplementationExamples;
255
- /**
256
- * Suggest alternative prompt structures (deep mode)
257
- */
258
- private suggestAlternativeStructures;
259
- /**
260
- * Identify potential issues with the prompt (deep mode)
261
- */
262
- private identifyPotentialIssues;
263
- /**
264
- * Extract core requirement from prompt
265
- */
266
- private extractCoreRequirement;
267
- }
268
- //# sourceMappingURL=prompt-optimizer.d.ts.map