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.
- package/README.md +72 -60
- package/dist/cli/commands/update.js +9 -10
- package/dist/templates/agents/agents.md +14 -8
- package/dist/templates/agents/copilot-instructions.md +1 -1
- package/dist/templates/instructions/core/verification.md +2 -2
- package/dist/templates/slash-commands/_canonical/archive.md +83 -121
- package/dist/templates/slash-commands/_canonical/execute.md +32 -42
- package/dist/templates/slash-commands/_canonical/implement.md +32 -44
- package/dist/templates/slash-commands/_canonical/improve.md +14 -53
- package/dist/templates/slash-commands/_canonical/start.md +1 -1
- package/dist/templates/slash-commands/_canonical/summarize.md +8 -8
- package/dist/templates/slash-commands/_components/agent-protocols/cli-reference.md +84 -180
- package/dist/templates/slash-commands/_components/agent-protocols/error-handling.md +2 -2
- package/dist/templates/slash-commands/_components/agent-protocols/file-formats.md +41 -59
- package/dist/templates/slash-commands/_components/agent-protocols/state-assertion.md +1 -1
- package/dist/templates/slash-commands/_components/references/intent-types.md +1 -1
- package/dist/templates/slash-commands/_components/sections/file-saving-protocol.md +20 -27
- package/dist/templates/slash-commands/_components/sections/pattern-visibility.md +29 -46
- package/dist/templates/slash-commands/_components/troubleshooting/file-not-saved.md +4 -5
- package/dist/types/config.d.ts +57 -0
- package/dist/utils/legacy-command-cleanup.js +31 -4
- package/package.json +5 -4
- package/dist/cli/commands/analyze.d.ts +0 -17
- package/dist/cli/commands/analyze.js +0 -133
- package/dist/cli/commands/archive.d.ts +0 -36
- package/dist/cli/commands/archive.js +0 -266
- package/dist/cli/commands/deep.d.ts +0 -17
- package/dist/cli/commands/deep.js +0 -170
- package/dist/cli/commands/execute.d.ts +0 -15
- package/dist/cli/commands/execute.js +0 -168
- package/dist/cli/commands/fast.d.ts +0 -18
- package/dist/cli/commands/fast.js +0 -219
- package/dist/cli/commands/implement.d.ts +0 -24
- package/dist/cli/commands/implement.js +0 -289
- package/dist/cli/commands/improve.d.ts +0 -32
- package/dist/cli/commands/improve.js +0 -250
- package/dist/cli/commands/list.d.ts +0 -17
- package/dist/cli/commands/list.js +0 -217
- package/dist/cli/commands/plan.d.ts +0 -21
- package/dist/cli/commands/plan.js +0 -297
- package/dist/cli/commands/prd.d.ts +0 -24
- package/dist/cli/commands/prd.js +0 -321
- package/dist/cli/commands/prompts/clear.d.ts +0 -16
- package/dist/cli/commands/prompts/clear.js +0 -222
- package/dist/cli/commands/prompts/list.d.ts +0 -8
- package/dist/cli/commands/prompts/list.js +0 -88
- package/dist/cli/commands/show.d.ts +0 -21
- package/dist/cli/commands/show.js +0 -191
- package/dist/cli/commands/start.d.ts +0 -40
- package/dist/cli/commands/start.js +0 -210
- package/dist/cli/commands/summarize.d.ts +0 -17
- package/dist/cli/commands/summarize.js +0 -196
- package/dist/cli/commands/task-complete.d.ts +0 -27
- package/dist/cli/commands/task-complete.js +0 -269
- package/dist/cli/commands/verify.d.ts +0 -28
- package/dist/cli/commands/verify.js +0 -349
- package/dist/core/archive-manager.d.ts +0 -100
- package/dist/core/archive-manager.js +0 -302
- package/dist/core/basic-checklist-generator.d.ts +0 -35
- package/dist/core/basic-checklist-generator.js +0 -344
- package/dist/core/checklist-parser.d.ts +0 -48
- package/dist/core/checklist-parser.js +0 -238
- package/dist/core/config-manager.d.ts +0 -149
- package/dist/core/config-manager.js +0 -230
- package/dist/core/conversation-analyzer.d.ts +0 -86
- package/dist/core/conversation-analyzer.js +0 -387
- package/dist/core/conversation-quality-tracker.d.ts +0 -81
- package/dist/core/conversation-quality-tracker.js +0 -195
- package/dist/core/git-manager.d.ts +0 -126
- package/dist/core/git-manager.js +0 -282
- package/dist/core/intelligence/confidence-calculator.d.ts +0 -93
- package/dist/core/intelligence/confidence-calculator.js +0 -124
- package/dist/core/intelligence/index.d.ts +0 -11
- package/dist/core/intelligence/index.js +0 -15
- package/dist/core/intelligence/intent-detector.d.ts +0 -54
- package/dist/core/intelligence/intent-detector.js +0 -723
- package/dist/core/intelligence/pattern-library.d.ts +0 -104
- package/dist/core/intelligence/pattern-library.js +0 -339
- package/dist/core/intelligence/patterns/actionability-enhancer.d.ts +0 -27
- package/dist/core/intelligence/patterns/actionability-enhancer.js +0 -192
- package/dist/core/intelligence/patterns/alternative-phrasing-generator.d.ts +0 -29
- package/dist/core/intelligence/patterns/alternative-phrasing-generator.js +0 -239
- package/dist/core/intelligence/patterns/ambiguity-detector.d.ts +0 -22
- package/dist/core/intelligence/patterns/ambiguity-detector.js +0 -196
- package/dist/core/intelligence/patterns/assumption-explicitizer.d.ts +0 -30
- package/dist/core/intelligence/patterns/assumption-explicitizer.js +0 -296
- package/dist/core/intelligence/patterns/base-pattern.d.ts +0 -192
- package/dist/core/intelligence/patterns/base-pattern.js +0 -103
- package/dist/core/intelligence/patterns/completeness-validator.d.ts +0 -27
- package/dist/core/intelligence/patterns/completeness-validator.js +0 -221
- package/dist/core/intelligence/patterns/conciseness-filter.d.ts +0 -20
- package/dist/core/intelligence/patterns/conciseness-filter.js +0 -92
- package/dist/core/intelligence/patterns/context-precision.d.ts +0 -32
- package/dist/core/intelligence/patterns/context-precision.js +0 -389
- package/dist/core/intelligence/patterns/conversation-summarizer.d.ts +0 -30
- package/dist/core/intelligence/patterns/conversation-summarizer.js +0 -277
- package/dist/core/intelligence/patterns/dependency-identifier.d.ts +0 -23
- package/dist/core/intelligence/patterns/dependency-identifier.js +0 -166
- package/dist/core/intelligence/patterns/domain-context-enricher.d.ts +0 -21
- package/dist/core/intelligence/patterns/domain-context-enricher.js +0 -198
- package/dist/core/intelligence/patterns/edge-case-identifier.d.ts +0 -30
- package/dist/core/intelligence/patterns/edge-case-identifier.js +0 -269
- package/dist/core/intelligence/patterns/error-tolerance-enhancer.d.ts +0 -22
- package/dist/core/intelligence/patterns/error-tolerance-enhancer.js +0 -179
- package/dist/core/intelligence/patterns/implicit-requirement-extractor.d.ts +0 -24
- package/dist/core/intelligence/patterns/implicit-requirement-extractor.js +0 -259
- package/dist/core/intelligence/patterns/objective-clarifier.d.ts +0 -22
- package/dist/core/intelligence/patterns/objective-clarifier.js +0 -126
- package/dist/core/intelligence/patterns/output-format-enforcer.d.ts +0 -22
- package/dist/core/intelligence/patterns/output-format-enforcer.js +0 -151
- package/dist/core/intelligence/patterns/prd-structure-enforcer.d.ts +0 -23
- package/dist/core/intelligence/patterns/prd-structure-enforcer.js +0 -183
- package/dist/core/intelligence/patterns/prerequisite-identifier.d.ts +0 -23
- package/dist/core/intelligence/patterns/prerequisite-identifier.js +0 -221
- package/dist/core/intelligence/patterns/requirement-prioritizer.d.ts +0 -24
- package/dist/core/intelligence/patterns/requirement-prioritizer.js +0 -134
- package/dist/core/intelligence/patterns/scope-definer.d.ts +0 -26
- package/dist/core/intelligence/patterns/scope-definer.js +0 -236
- package/dist/core/intelligence/patterns/step-decomposer.d.ts +0 -31
- package/dist/core/intelligence/patterns/step-decomposer.js +0 -242
- package/dist/core/intelligence/patterns/structure-organizer.d.ts +0 -31
- package/dist/core/intelligence/patterns/structure-organizer.js +0 -218
- package/dist/core/intelligence/patterns/success-criteria-enforcer.d.ts +0 -22
- package/dist/core/intelligence/patterns/success-criteria-enforcer.js +0 -165
- package/dist/core/intelligence/patterns/success-metrics-enforcer.d.ts +0 -24
- package/dist/core/intelligence/patterns/success-metrics-enforcer.js +0 -165
- package/dist/core/intelligence/patterns/technical-context-enricher.d.ts +0 -25
- package/dist/core/intelligence/patterns/technical-context-enricher.js +0 -165
- package/dist/core/intelligence/patterns/topic-coherence-analyzer.d.ts +0 -26
- package/dist/core/intelligence/patterns/topic-coherence-analyzer.js +0 -300
- package/dist/core/intelligence/patterns/user-persona-enricher.d.ts +0 -24
- package/dist/core/intelligence/patterns/user-persona-enricher.js +0 -141
- package/dist/core/intelligence/patterns/validation-checklist-creator.d.ts +0 -31
- package/dist/core/intelligence/patterns/validation-checklist-creator.js +0 -242
- package/dist/core/intelligence/quality-assessor.d.ts +0 -51
- package/dist/core/intelligence/quality-assessor.js +0 -505
- package/dist/core/intelligence/types.d.ts +0 -111
- package/dist/core/intelligence/types.js +0 -3
- package/dist/core/intelligence/universal-optimizer.d.ts +0 -84
- package/dist/core/intelligence/universal-optimizer.js +0 -371
- package/dist/core/prd-generator.d.ts +0 -76
- package/dist/core/prd-generator.js +0 -173
- package/dist/core/prompt-manager.d.ts +0 -110
- package/dist/core/prompt-manager.js +0 -274
- package/dist/core/prompt-optimizer.d.ts +0 -268
- package/dist/core/prompt-optimizer.js +0 -959
- package/dist/core/question-engine.d.ts +0 -167
- package/dist/core/question-engine.js +0 -356
- package/dist/core/session-manager.d.ts +0 -139
- package/dist/core/session-manager.js +0 -365
- package/dist/core/task-manager.d.ts +0 -211
- package/dist/core/task-manager.js +0 -981
- package/dist/core/verification-hooks.d.ts +0 -67
- package/dist/core/verification-hooks.js +0 -309
- package/dist/core/verification-manager.d.ts +0 -107
- package/dist/core/verification-manager.js +0 -415
- package/dist/index 2.js +0 -13
- package/dist/index.d 2.ts +0 -4
- package/dist/types/session.d.ts +0 -78
- package/dist/types/session.js +0 -8
- package/dist/types/verification.d.ts +0 -205
- 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
|