@weavelogic/knowledge-graph-agent 0.12.0 → 0.12.1
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/dist/node_modules/@typescript-eslint/project-service/dist/index.js +1 -1
- package/dist/node_modules/tinyglobby/dist/index.js +1 -1
- package/dist/sparc/sparc-planner.d.ts +194 -30
- package/dist/sparc/sparc-planner.d.ts.map +1 -1
- package/dist/sparc/sparc-planner.js +1144 -341
- package/dist/sparc/sparc-planner.js.map +1 -1
- package/package.json +1 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { __exports as dist } from "../../../../_virtual/
|
|
1
|
+
import { __exports as dist } from "../../../../_virtual/index7.js";
|
|
2
2
|
import { __require as requireCreateProjectService } from "./createProjectService.js";
|
|
3
3
|
var hasRequiredDist;
|
|
4
4
|
function requireDist() {
|
|
@@ -2,12 +2,38 @@
|
|
|
2
2
|
* SPARC Planner
|
|
3
3
|
*
|
|
4
4
|
* Main orchestrator for creating comprehensive SPARC plans.
|
|
5
|
-
*
|
|
5
|
+
* Reads and analyzes documentation to build real development plans.
|
|
6
6
|
*
|
|
7
7
|
* @module sparc/sparc-planner
|
|
8
8
|
*/
|
|
9
9
|
import { DecisionLogManager } from './decision-log.js';
|
|
10
10
|
import type { SPARCPlan } from './types.js';
|
|
11
|
+
/**
|
|
12
|
+
* Parsed documentation file
|
|
13
|
+
*/
|
|
14
|
+
interface ParsedDoc {
|
|
15
|
+
path: string;
|
|
16
|
+
filename: string;
|
|
17
|
+
title: string;
|
|
18
|
+
content: string;
|
|
19
|
+
frontmatter: Record<string, unknown>;
|
|
20
|
+
headings: Array<{
|
|
21
|
+
level: number;
|
|
22
|
+
text: string;
|
|
23
|
+
line: number;
|
|
24
|
+
}>;
|
|
25
|
+
sections: Array<{
|
|
26
|
+
heading: string;
|
|
27
|
+
content: string;
|
|
28
|
+
level: number;
|
|
29
|
+
}>;
|
|
30
|
+
codeBlocks: Array<{
|
|
31
|
+
language: string;
|
|
32
|
+
code: string;
|
|
33
|
+
}>;
|
|
34
|
+
links: string[];
|
|
35
|
+
type: 'feature' | 'requirement' | 'architecture' | 'api' | 'guide' | 'spec' | 'unknown';
|
|
36
|
+
}
|
|
11
37
|
/**
|
|
12
38
|
* Planner options
|
|
13
39
|
*/
|
|
@@ -20,6 +46,8 @@ export interface SPARCPlannerOptions {
|
|
|
20
46
|
name: string;
|
|
21
47
|
/** Plan description */
|
|
22
48
|
description: string;
|
|
49
|
+
/** Docs directory to analyze */
|
|
50
|
+
docsDir?: string;
|
|
23
51
|
/** Enable parallel research */
|
|
24
52
|
parallelResearch?: boolean;
|
|
25
53
|
/** Number of review passes */
|
|
@@ -34,13 +62,14 @@ export interface SPARCPlannerOptions {
|
|
|
34
62
|
/**
|
|
35
63
|
* SPARC Planner
|
|
36
64
|
*
|
|
37
|
-
* Orchestrates the full SPARC planning process.
|
|
65
|
+
* Orchestrates the full SPARC planning process by reading and analyzing documentation.
|
|
38
66
|
*/
|
|
39
67
|
export declare class SPARCPlanner {
|
|
40
68
|
private readonly options;
|
|
41
69
|
private plan;
|
|
42
70
|
private decisionLog;
|
|
43
71
|
private consensusBuilder;
|
|
72
|
+
private parsedDocs;
|
|
44
73
|
constructor(options: SPARCPlannerOptions);
|
|
45
74
|
/**
|
|
46
75
|
* Initialize a new plan
|
|
@@ -51,49 +80,181 @@ export declare class SPARCPlanner {
|
|
|
51
80
|
*/
|
|
52
81
|
executePlanning(): Promise<SPARCPlan>;
|
|
53
82
|
/**
|
|
54
|
-
* Execute research phase
|
|
83
|
+
* Execute research phase - read and parse all documentation
|
|
55
84
|
*/
|
|
56
85
|
private executeResearchPhase;
|
|
57
86
|
/**
|
|
58
|
-
*
|
|
87
|
+
* Read all documentation files from a directory
|
|
59
88
|
*/
|
|
60
|
-
private
|
|
89
|
+
private readDocsDirectory;
|
|
90
|
+
/**
|
|
91
|
+
* Parse a markdown documentation file
|
|
92
|
+
*/
|
|
93
|
+
private parseDocFile;
|
|
94
|
+
/**
|
|
95
|
+
* Extract headings from markdown content
|
|
96
|
+
*/
|
|
97
|
+
private extractHeadings;
|
|
98
|
+
/**
|
|
99
|
+
* Extract sections from markdown content based on headings
|
|
100
|
+
*/
|
|
101
|
+
private extractSections;
|
|
102
|
+
/**
|
|
103
|
+
* Extract code blocks from markdown
|
|
104
|
+
*/
|
|
105
|
+
private extractCodeBlocks;
|
|
61
106
|
/**
|
|
62
|
-
*
|
|
107
|
+
* Extract links from markdown
|
|
63
108
|
*/
|
|
64
|
-
private
|
|
109
|
+
private extractLinks;
|
|
65
110
|
/**
|
|
66
|
-
*
|
|
111
|
+
* Classify document type based on content and path
|
|
67
112
|
*/
|
|
68
|
-
private
|
|
113
|
+
private classifyDocument;
|
|
69
114
|
/**
|
|
70
|
-
*
|
|
115
|
+
* Create a research finding from a parsed document
|
|
116
|
+
*/
|
|
117
|
+
private createFindingFromDoc;
|
|
118
|
+
/**
|
|
119
|
+
* Summarize document content
|
|
120
|
+
*/
|
|
121
|
+
private summarizeDocContent;
|
|
122
|
+
/**
|
|
123
|
+
* Execute specification phase - extract requirements and features from docs
|
|
71
124
|
*/
|
|
72
125
|
private executeSpecificationPhase;
|
|
126
|
+
/**
|
|
127
|
+
* Extract requirements from documentation
|
|
128
|
+
*/
|
|
129
|
+
private extractRequirementsFromDocs;
|
|
130
|
+
/**
|
|
131
|
+
* Extract bullet point requirements from content
|
|
132
|
+
*/
|
|
133
|
+
private extractBulletRequirements;
|
|
134
|
+
/**
|
|
135
|
+
* Create a requirement object
|
|
136
|
+
*/
|
|
137
|
+
private createRequirement;
|
|
138
|
+
/**
|
|
139
|
+
* Extract acceptance criteria from text
|
|
140
|
+
*/
|
|
141
|
+
private extractAcceptanceCriteria;
|
|
142
|
+
/**
|
|
143
|
+
* Infer priority from text
|
|
144
|
+
*/
|
|
145
|
+
private inferPriority;
|
|
146
|
+
/**
|
|
147
|
+
* Extract features from documentation
|
|
148
|
+
*/
|
|
149
|
+
private extractFeaturesFromDocs;
|
|
150
|
+
/**
|
|
151
|
+
* Create a feature from a document
|
|
152
|
+
*/
|
|
153
|
+
private createFeatureFromDoc;
|
|
154
|
+
/**
|
|
155
|
+
* Extract user stories from text
|
|
156
|
+
*/
|
|
157
|
+
private extractUserStories;
|
|
158
|
+
/**
|
|
159
|
+
* Infer complexity from content
|
|
160
|
+
*/
|
|
161
|
+
private inferComplexity;
|
|
162
|
+
/**
|
|
163
|
+
* Extract dependencies from document links
|
|
164
|
+
*/
|
|
165
|
+
private extractDependencies;
|
|
166
|
+
/**
|
|
167
|
+
* Extract problem statement from docs
|
|
168
|
+
*/
|
|
169
|
+
private extractProblemStatement;
|
|
170
|
+
/**
|
|
171
|
+
* Extract goals from docs
|
|
172
|
+
*/
|
|
173
|
+
private extractGoals;
|
|
174
|
+
/**
|
|
175
|
+
* Extract constraints from docs
|
|
176
|
+
*/
|
|
177
|
+
private extractConstraints;
|
|
178
|
+
/**
|
|
179
|
+
* Extract assumptions from docs
|
|
180
|
+
*/
|
|
181
|
+
private extractAssumptions;
|
|
182
|
+
/**
|
|
183
|
+
* Extract success metrics from docs
|
|
184
|
+
*/
|
|
185
|
+
private extractSuccessMetrics;
|
|
73
186
|
/**
|
|
74
187
|
* Execute pseudocode phase
|
|
75
188
|
*/
|
|
76
189
|
private executePseudocodePhase;
|
|
190
|
+
/**
|
|
191
|
+
* Create algorithm design from document
|
|
192
|
+
*/
|
|
193
|
+
private createAlgorithmFromDoc;
|
|
77
194
|
/**
|
|
78
195
|
* Execute architecture phase
|
|
79
196
|
*/
|
|
80
197
|
private executeArchitecturePhase;
|
|
81
198
|
/**
|
|
82
|
-
*
|
|
199
|
+
* Extract components from documentation
|
|
83
200
|
*/
|
|
84
|
-
private
|
|
201
|
+
private extractComponentsFromDocs;
|
|
85
202
|
/**
|
|
86
|
-
*
|
|
203
|
+
* Infer component type
|
|
87
204
|
*/
|
|
88
|
-
private
|
|
205
|
+
private inferComponentType;
|
|
89
206
|
/**
|
|
90
|
-
*
|
|
207
|
+
* Extract responsibilities from content
|
|
91
208
|
*/
|
|
92
|
-
private
|
|
209
|
+
private extractResponsibilities;
|
|
210
|
+
/**
|
|
211
|
+
* Extract technologies mentioned
|
|
212
|
+
*/
|
|
213
|
+
private extractTechnologies;
|
|
214
|
+
/**
|
|
215
|
+
* Extract patterns from documentation
|
|
216
|
+
*/
|
|
217
|
+
private extractPatternsFromDocs;
|
|
218
|
+
/**
|
|
219
|
+
* Extract architecture overview
|
|
220
|
+
*/
|
|
221
|
+
private extractArchitectureOverview;
|
|
222
|
+
/**
|
|
223
|
+
* Extract data flow description
|
|
224
|
+
*/
|
|
225
|
+
private extractDataFlow;
|
|
226
|
+
/**
|
|
227
|
+
* Extract security considerations
|
|
228
|
+
*/
|
|
229
|
+
private extractSecurityConsiderations;
|
|
230
|
+
/**
|
|
231
|
+
* Execute refinement phase - generate development tasks
|
|
232
|
+
*/
|
|
233
|
+
private executeRefinementPhase;
|
|
93
234
|
/**
|
|
94
235
|
* Create a SPARC task
|
|
95
236
|
*/
|
|
96
237
|
private createTask;
|
|
238
|
+
/**
|
|
239
|
+
* Map complexity to priority
|
|
240
|
+
*/
|
|
241
|
+
private mapComplexityToPriority;
|
|
242
|
+
/**
|
|
243
|
+
* Map requirement priority to task priority
|
|
244
|
+
*/
|
|
245
|
+
private mapPriorityToTaskPriority;
|
|
246
|
+
/**
|
|
247
|
+
* Estimate design hours based on complexity
|
|
248
|
+
*/
|
|
249
|
+
private estimateDesignHours;
|
|
250
|
+
/**
|
|
251
|
+
* Estimate implementation hours based on complexity
|
|
252
|
+
*/
|
|
253
|
+
private estimateImplementationHours;
|
|
254
|
+
/**
|
|
255
|
+
* Estimate test hours based on complexity
|
|
256
|
+
*/
|
|
257
|
+
private estimateTestHours;
|
|
97
258
|
/**
|
|
98
259
|
* Calculate parallel task groups
|
|
99
260
|
*/
|
|
@@ -102,6 +263,18 @@ export declare class SPARCPlanner {
|
|
|
102
263
|
* Calculate critical path
|
|
103
264
|
*/
|
|
104
265
|
private calculateCriticalPath;
|
|
266
|
+
/**
|
|
267
|
+
* Analyze existing code in src directory
|
|
268
|
+
*/
|
|
269
|
+
private analyzeExistingCode;
|
|
270
|
+
/**
|
|
271
|
+
* Execute review phase
|
|
272
|
+
*/
|
|
273
|
+
private executeReviewPhase;
|
|
274
|
+
/**
|
|
275
|
+
* Add a decision to the log
|
|
276
|
+
*/
|
|
277
|
+
private addDecision;
|
|
105
278
|
/**
|
|
106
279
|
* Update plan statistics
|
|
107
280
|
*/
|
|
@@ -114,20 +287,6 @@ export declare class SPARCPlanner {
|
|
|
114
287
|
* Generate markdown summary
|
|
115
288
|
*/
|
|
116
289
|
private generateMarkdownSummary;
|
|
117
|
-
private extractProblemStatement;
|
|
118
|
-
private extractGoals;
|
|
119
|
-
private generateRequirements;
|
|
120
|
-
private generateFeatures;
|
|
121
|
-
private extractConstraints;
|
|
122
|
-
private generateSuccessMetrics;
|
|
123
|
-
private generateAlgorithmDesign;
|
|
124
|
-
private generateArchitectureOverview;
|
|
125
|
-
private identifyArchitecturePatterns;
|
|
126
|
-
private generateComponents;
|
|
127
|
-
private describeDataFlow;
|
|
128
|
-
private identifySecurityConsiderations;
|
|
129
|
-
private getComponentPriority;
|
|
130
|
-
private estimateComponentHours;
|
|
131
290
|
/**
|
|
132
291
|
* Get the current plan
|
|
133
292
|
*/
|
|
@@ -136,9 +295,14 @@ export declare class SPARCPlanner {
|
|
|
136
295
|
* Get decision log manager
|
|
137
296
|
*/
|
|
138
297
|
getDecisionLog(): DecisionLogManager;
|
|
298
|
+
/**
|
|
299
|
+
* Get parsed documentation
|
|
300
|
+
*/
|
|
301
|
+
getParsedDocs(): ParsedDoc[];
|
|
139
302
|
}
|
|
140
303
|
/**
|
|
141
304
|
* Create a SPARC planner
|
|
142
305
|
*/
|
|
143
306
|
export declare function createSPARCPlanner(options: SPARCPlannerOptions): SPARCPlanner;
|
|
307
|
+
export {};
|
|
144
308
|
//# sourceMappingURL=sparc-planner.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sparc-planner.d.ts","sourceRoot":"","sources":["../../src/sparc/sparc-planner.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;
|
|
1
|
+
{"version":3,"file":"sparc-planner.d.ts","sourceRoot":"","sources":["../../src/sparc/sparc-planner.ts"],"names":[],"mappings":"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"}
|