@locusai/sdk 0.11.6 → 0.11.7

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.
@@ -5017,78 +5017,6 @@ init_config();
5017
5017
  init_knowledge_base();
5018
5018
  var import_node_fs10 = require("node:fs");
5019
5019
 
5020
- // src/planning/agents/architect.ts
5021
- function buildArchitectPrompt(input) {
5022
- let prompt = `# Role: Software Architect
5023
-
5024
- You are a Software Architect participating in an async sprint planning meeting. The Tech Lead has produced an initial task breakdown. Your job is to refine it.
5025
-
5026
- ## CEO Directive
5027
- > ${input.directive}
5028
- `;
5029
- if (input.feedback) {
5030
- prompt += `
5031
- ## CEO Feedback on Previous Plan
5032
- > ${input.feedback}
5033
-
5034
- IMPORTANT: Ensure the refined plan addresses this feedback.
5035
- `;
5036
- }
5037
- prompt += `
5038
- ## Project Context
5039
- ${input.projectContext || "No project context available."}
5040
-
5041
- ## Tech Lead's Task Breakdown
5042
- ${input.techLeadOutput}
5043
-
5044
- ## Your Task
5045
-
5046
- Review and refine the Tech Lead's breakdown:
5047
-
5048
- 1. **Ordering** — Order tasks so that foundational work comes first. Tasks that produce outputs consumed by later tasks must appear earlier in the list. Foundation tasks (schemas, config, shared code) must be listed before tasks that build on them. The array index IS the execution order.
5049
- 2. **Risk Assessment** — Flag tasks that are risky, underestimated, or have unknowns.
5050
- 3. **Task Merging** — If two tasks are trivially small and related, merge them.
5051
- 4. **Complexity Scoring** — Rate each task 1-5 (1=trivial, 5=very complex).
5052
- 5. **Missing Tasks** — Add any tasks the Tech Lead missed (database migrations, configuration, testing, etc.).
5053
- 6. **Description Quality** — Review and improve each task description to be a clear, actionable implementation guide. Each description must tell the executing agent exactly what to do, where to do it (specific files/modules), how to do it (patterns, utilities, data flow), and what is NOT in scope. Vague descriptions like "Add authentication" must be rewritten with specific file paths, implementation approach, and boundaries.
5054
-
5055
- ## CRITICAL: Task Ordering & Dependencies
5056
-
5057
- Tasks are executed SEQUENTIALLY by a single agent on ONE branch. The agent works through tasks in array order. Each completed task's changes are available to subsequent tasks. You MUST enforce these rules:
5058
-
5059
- 1. **Order tasks by dependency.** Foundation tasks (schemas, config, shared code) must come first. Tasks that build on earlier work must appear later in the list.
5060
- 2. **Each task must be self-contained for its scope.** A task can depend on earlier tasks (they run sequentially), but must include all changes needed for its own goal.
5061
- 3. **Split tasks at logical boundaries.** Since tasks run sequentially on the same branch, splitting is safe — later tasks see earlier changes. Split when it improves clarity and reviewability.
5062
- 4. **Flag risks.** In your risk assessment, call out tasks that are complex or have unknowns.
5063
-
5064
- ## Output Format
5065
-
5066
- Your entire response must be a single JSON object — no text before it, no text after it, no markdown code blocks, no explanation. Start your response with the "{" character:
5067
-
5068
- {
5069
- "tasks": [
5070
- {
5071
- "title": "string",
5072
- "description": "string (detailed implementation guide: what to do, where to do it, how to do it, and boundaries)",
5073
- "assigneeRole": "BACKEND | FRONTEND | QA | PM | DESIGN",
5074
- "priority": "HIGH | MEDIUM | LOW | CRITICAL",
5075
- "labels": ["string"],
5076
- "acceptanceCriteria": ["string"],
5077
- "complexity": 3
5078
- }
5079
- ],
5080
- "risks": [
5081
- {
5082
- "description": "string",
5083
- "mitigation": "string",
5084
- "severity": "low | medium | high"
5085
- }
5086
- ],
5087
- "architectureNotes": "string (notes for the Sprint Organizer about parallelism opportunities and constraints)"
5088
- }`;
5089
- return prompt;
5090
- }
5091
-
5092
5020
  // src/planning/agents/cross-task-reviewer.ts
5093
5021
  function buildCrossTaskReviewerPrompt(input) {
5094
5022
  let prompt = `# Role: Cross-Task Reviewer (Architect + Engineer + Planner)
@@ -5124,7 +5052,7 @@ IMPORTANT: Ensure the reviewed plan still addresses this feedback.
5124
5052
  ${input.projectContext || "No project context available."}
5125
5053
 
5126
5054
  ## Sprint Plan to Review
5127
- ${input.sprintOrganizerOutput}
5055
+ ${input.plannerOutput}
5128
5056
 
5129
5057
  ## Your Review Checklist
5130
5058
 
@@ -5203,11 +5131,11 @@ IMPORTANT:
5203
5131
  return prompt;
5204
5132
  }
5205
5133
 
5206
- // src/planning/agents/sprint-organizer.ts
5207
- function buildSprintOrganizerPrompt(input) {
5208
- let prompt = `# Role: Sprint Organizer
5134
+ // src/planning/agents/planner.ts
5135
+ function buildPlannerPrompt(input) {
5136
+ let prompt = `# Role: Sprint Planner
5209
5137
 
5210
- You are a Sprint Organizer finalizing the sprint plan from a planning meeting. The Architect has refined the task breakdown. Your job is to produce the final sprint plan document.
5138
+ You are a Sprint Planner an expert engineer, architect, and project organizer rolled into one. Your job is to take a CEO directive and produce a complete, ready-to-execute sprint plan in a single pass.
5211
5139
 
5212
5140
  ## CEO Directive
5213
5141
  > ${input.directive}
@@ -5217,40 +5145,64 @@ You are a Sprint Organizer finalizing the sprint plan from a planning meeting. T
5217
5145
  ## CEO Feedback on Previous Plan
5218
5146
  > ${input.feedback}
5219
5147
 
5220
- IMPORTANT: The final plan must address this feedback.
5148
+ IMPORTANT: Incorporate this feedback into your plan. The CEO has reviewed a previous plan and wants changes.
5221
5149
  `;
5222
5150
  }
5223
5151
  prompt += `
5224
- ## Architect's Refined Task Breakdown
5225
- ${input.architectOutput}
5152
+ ## Project Context
5153
+ ${input.projectContext || "No project context available."}
5154
+
5155
+ ## Codebase Structure
5156
+ ${input.codebaseIndex || "No codebase index available."}
5226
5157
 
5227
5158
  ## Your Task
5228
5159
 
5229
- Produce the final sprint plan:
5160
+ Analyze the directive and produce a **complete sprint plan** with the following:
5230
5161
 
5231
- 1. **Sprint Name** — A concise, memorable name for this sprint (e.g., "User Authentication", "Payment Integration")
5162
+ 1. **Sprint Name** — A concise, memorable name (2-4 words)
5232
5163
  2. **Sprint Goal** — One paragraph describing what this sprint delivers
5233
- 3. **Task Ordering** — Final ordering so that foundational work comes first. The position in the array IS the execution order — task at index 0 runs first, index 1 runs second, etc. Tasks are executed SEQUENTIALLY by a single agent on one branch.
5234
- 4. **Duration Estimate** — How many days this sprint will take with a single agent working sequentially
5235
- 5. **Final Task List** — Each task with all fields filled in, ordered by execution priority
5236
- 6. **Description Quality Check** — Ensure every task description is a clear, actionable implementation guide. Each description must specify: what to do, where to do it (specific files/modules/directories), how to do it (implementation approach, patterns to follow, existing utilities to use), and what is NOT in scope. If any description is vague or generic, rewrite it with specifics. Remember: an independent agent will receive ONLY the task title, description, and acceptance criteria — the description is its primary instruction.
5237
-
5238
- Guidelines:
5239
- - The order of tasks in the array determines execution order. Tasks are dispatched sequentially from first to last.
5240
- - Foundation tasks (schemas, config, shared code) must appear before tasks that build on them
5241
- - Since tasks execute sequentially on one branch, later tasks can depend on earlier tasks' outputs
5242
- - Ensure acceptance criteria are specific and testable
5243
- - Keep the sprint focused if it's too large (>12 tasks), consider reducing scope
5244
- - Ensure every task description reads as a standalone implementation brief — not a summary
5164
+ 3. **Duration Estimate** — How many days this sprint will take with a single agent working sequentially
5165
+ 4. **Task Breakdown** — An ordered list of tasks that fully implement the directive
5166
+ 5. **Risk Assessment** — Potential risks with mitigations
5167
+
5168
+ ### Task Requirements
5169
+
5170
+ For each task, provide:
5171
+ - **Title** Clear, action-oriented (e.g., "Implement user registration API endpoint")
5172
+ - **Description** A detailed, actionable implementation guide (see below)
5173
+ - **Assignee Role** BACKEND, FRONTEND, QA, PM, or DESIGN
5174
+ - **Priority**CRITICAL, HIGH, MEDIUM, or LOW
5175
+ - **Complexity** 1 (trivial) to 5 (very complex)
5176
+ - **Labels** — Relevant tags (e.g., "api", "database", "ui", "auth")
5177
+ - **Acceptance Criteria** — Specific, testable conditions for completion
5178
+
5179
+ ### CRITICAL: Task Description Requirements
5180
+
5181
+ Each task description will be handed to an INDEPENDENT agent as its primary instruction. The agent will have access to the codebase but NO context about the planning meeting. Each description MUST include:
5182
+
5183
+ 1. **What to do** — Clearly state the goal and expected behavior/outcome
5184
+ 2. **Where to do it** — List specific files, modules, or directories to modify or create. Reference existing code paths when extending functionality
5185
+ 3. **How to do it** — Key implementation details: which patterns to follow, which existing utilities or services to use, what the data flow looks like
5186
+ 4. **Boundaries** — What is NOT in scope for this task to prevent overlap with other tasks
5245
5187
 
5246
- ## CRITICAL: Task Ordering Validation
5188
+ Bad example: "Add authentication to the API."
5189
+ Good example: "Implement JWT-based authentication middleware in src/middleware/auth.ts. Create a verifyToken middleware that extracts the Bearer token from the Authorization header, validates it using the existing JWT_SECRET from env config, and attaches the decoded user payload to req.user. Apply this middleware to all routes in src/routes/protected/. This task does NOT include user registration or password reset — those are handled separately."
5190
+
5191
+ ### CRITICAL: Task Ordering Rules
5192
+
5193
+ Tasks are executed SEQUENTIALLY by a single agent on ONE branch. The agent works through tasks in array order. Therefore:
5194
+
5195
+ 1. **Foundation first.** Place foundational tasks (schemas, config, shared code) at the beginning. Later tasks can build on earlier ones since they run in sequence.
5196
+ 2. **No forward dependencies.** A task must NOT depend on a task that appears later in the list.
5197
+ 3. **Each task is self-contained for its scope.** A task can depend on earlier tasks but must include all changes needed for its own goal.
5198
+ 4. **Keep tasks focused.** Each task should do one logical unit of work. Avoid trivially small or overly large tasks.
5199
+ 5. **Merge related trivial work.** If two pieces of work are trivially small and tightly related, combine them into one task.
5247
5200
 
5248
- Before finalizing, validate that tasks are in the correct execution order:
5201
+ ### Sprint Scope Guidelines
5249
5202
 
5250
- 1. **No forward dependencies.** A task must NOT depend on a task that appears later in the list.
5251
- 2. **Foundation first.** Config, schemas, and shared code must come before implementation tasks.
5252
- 3. **Each task is independently executable given prior tasks.** An agent working on task N must be able to complete it assuming tasks 1 through N-1 are already done.
5253
- 4. **Prefer focused, well-scoped tasks.** Each task should do one logical unit of work.
5203
+ - If the sprint would exceed 12 tasks, reduce scope or merge related tasks
5204
+ - Ensure acceptance criteria are specific and testable
5205
+ - Keep the sprint focused on the directive avoid scope creep
5254
5206
 
5255
5207
  ## Output Format
5256
5208
 
@@ -5263,7 +5215,7 @@ Your entire response must be a single JSON object — no text before it, no text
5263
5215
  "tasks": [
5264
5216
  {
5265
5217
  "title": "string",
5266
- "description": "string (detailed implementation guide: what to do, where to do it, how to do it, and boundaries)",
5218
+ "description": "string (detailed implementation guide: what, where, how, boundaries)",
5267
5219
  "assigneeRole": "BACKEND | FRONTEND | QA | PM | DESIGN",
5268
5220
  "priority": "CRITICAL | HIGH | MEDIUM | LOW",
5269
5221
  "labels": ["string"],
@@ -5284,89 +5236,6 @@ IMPORTANT: Tasks are executed sequentially by a single agent. The array order IS
5284
5236
  return prompt;
5285
5237
  }
5286
5238
 
5287
- // src/planning/agents/tech-lead.ts
5288
- function buildTechLeadPrompt(input) {
5289
- let prompt = `# Role: Senior Tech Lead
5290
-
5291
- You are a Senior Tech Lead participating in an async sprint planning meeting. Your job is to take the CEO's directive and produce an initial task breakdown.
5292
-
5293
- ## CEO Directive
5294
- > ${input.directive}
5295
- `;
5296
- if (input.feedback) {
5297
- prompt += `
5298
- ## CEO Feedback on Previous Plan
5299
- > ${input.feedback}
5300
-
5301
- IMPORTANT: Incorporate this feedback into your task breakdown. The CEO has reviewed a previous plan and wants changes.
5302
- `;
5303
- }
5304
- prompt += `
5305
- ## Project Context
5306
- ${input.projectContext || "No project context available."}
5307
-
5308
- ## Codebase Structure
5309
- ${input.codebaseIndex || "No codebase index available."}
5310
-
5311
- ## Your Task
5312
-
5313
- Analyze the CEO's directive and produce a detailed task breakdown. For each task:
5314
-
5315
- 1. **Title** — Clear, action-oriented (e.g., "Implement user registration API endpoint")
5316
- 2. **Description** — A detailed, actionable implementation guide (see description requirements below)
5317
- 3. **Assignee Role** — Who should work on this: BACKEND, FRONTEND, QA, PM, or DESIGN
5318
- 4. **Priority** — HIGH, MEDIUM, or LOW based on business impact
5319
- 5. **Labels** — Relevant tags (e.g., "api", "database", "ui", "auth")
5320
- 6. **Acceptance Criteria** — Specific, testable conditions for completion
5321
-
5322
- Think about:
5323
- - What existing code can be reused or extended
5324
- - Which tasks are independent vs. dependent
5325
- - What the right granularity is (not too big, not too small)
5326
- - What risks or unknowns exist
5327
-
5328
- ## CRITICAL: Task Description Requirements
5329
-
5330
- Each task description will be handed to an INDEPENDENT agent as its primary instruction. The agent will have access to the codebase but NO context about the planning meeting. Descriptions must be clear enough for the agent to execute the task without ambiguity.
5331
-
5332
- Each description MUST include:
5333
- 1. **What to do** — Clearly state the goal and what needs to be implemented, changed, or created. Be specific about the expected behavior or outcome.
5334
- 2. **Where to do it** — List the specific files, modules, or directories that need to be modified or created. Reference existing code paths when extending functionality.
5335
- 3. **How to do it** — Provide key implementation details: which patterns to follow, which existing utilities or services to use, what the data flow looks like.
5336
- 4. **Boundaries** — Clarify what is NOT in scope for this task to prevent overlap with other tasks.
5337
-
5338
- Bad example: "Add authentication to the API."
5339
- Good example: "Implement JWT-based authentication middleware in src/middleware/auth.ts. Create a verifyToken middleware that extracts the Bearer token from the Authorization header, validates it using the existing JWT_SECRET from env config, and attaches the decoded user payload to req.user. Apply this middleware to all routes in src/routes/protected/. Add a POST /auth/login endpoint in src/routes/auth.ts that accepts {email, password}, validates credentials against the users table, and returns a signed JWT. This task does NOT include user registration or password reset — those are handled separately."
5340
-
5341
- ## CRITICAL: Task Ordering Rules
5342
-
5343
- Tasks are executed SEQUENTIALLY by a single agent on ONE branch. The agent works through tasks in the order they appear in the array. Therefore:
5344
-
5345
- 1. **Foundation first.** Place foundational tasks (schemas, config, shared code) at the beginning of the list. Later tasks can build on earlier ones since they run in sequence on the same branch.
5346
- 2. **Each task must be self-contained.** A task must include ALL the code changes it needs to work — from config to implementation to tests. A task CAN depend on earlier tasks in the list since they will have already been completed.
5347
- 3. **Logical ordering matters.** Tasks are dispatched in the order they appear. Ensure dependent tasks come after their prerequisites.
5348
- 4. **Keep tasks focused.** Each task should do one logical unit of work. Since there are no parallel execution conflicts, tasks can be more granular — but avoid tasks that are too small or trivial.
5349
-
5350
- ## Output Format
5351
-
5352
- Your entire response must be a single JSON object — no text before it, no text after it, no markdown code blocks, no explanation. Start your response with the "{" character:
5353
-
5354
- {
5355
- "tasks": [
5356
- {
5357
- "title": "string",
5358
- "description": "string (detailed implementation guide: what to do, where to do it, how to do it, and boundaries — see description requirements above)",
5359
- "assigneeRole": "BACKEND | FRONTEND | QA | PM | DESIGN",
5360
- "priority": "HIGH | MEDIUM | LOW",
5361
- "labels": ["string"],
5362
- "acceptanceCriteria": ["string"]
5363
- }
5364
- ],
5365
- "technicalNotes": "string (brief notes on architecture decisions, risks, or considerations for the Architect phase)"
5366
- }`;
5367
- return prompt;
5368
- }
5369
-
5370
5239
  // src/planning/planning-meeting.ts
5371
5240
  class PlanningMeeting {
5372
5241
  projectPath;
@@ -5382,52 +5251,33 @@ class PlanningMeeting {
5382
5251
  async run(directive, feedback) {
5383
5252
  const projectContext = this.getProjectContext();
5384
5253
  const codebaseIndex = this.getCodebaseIndex();
5385
- this.log("Phase 1/4: Tech Lead analyzing directive...", "info");
5386
- const techLeadPrompt = buildTechLeadPrompt({
5254
+ this.log("Phase 1/2: Planner building sprint plan...", "info");
5255
+ const plannerPrompt = buildPlannerPrompt({
5387
5256
  directive,
5388
5257
  projectContext,
5389
5258
  codebaseIndex,
5390
5259
  feedback
5391
5260
  });
5392
- const techLeadOutput = await this.aiRunner.run(techLeadPrompt);
5393
- this.log("Tech Lead phase complete.", "success");
5394
- this.log("Phase 2/4: Architect refining task breakdown...", "info");
5395
- const architectPrompt = buildArchitectPrompt({
5396
- directive,
5397
- projectContext,
5398
- techLeadOutput,
5399
- feedback
5400
- });
5401
- const architectOutput = await this.aiRunner.run(architectPrompt);
5402
- this.log("Architect phase complete.", "success");
5403
- this.log("Phase 3/4: Sprint Organizer finalizing plan...", "info");
5404
- const sprintOrganizerPrompt = buildSprintOrganizerPrompt({
5405
- directive,
5406
- architectOutput,
5407
- feedback
5408
- });
5409
- const sprintOrganizerOutput = await this.aiRunner.run(sprintOrganizerPrompt);
5410
- this.log("Sprint Organizer phase complete.", "success");
5411
- this.log("Phase 4/4: Cross-Task Review checking for conflicts and overlaps...", "info");
5261
+ const plannerOutput = await this.aiRunner.run(plannerPrompt);
5262
+ this.log("Planner phase complete.", "success");
5263
+ this.log("Phase 2/2: Reviewer checking for conflicts and quality...", "info");
5412
5264
  const crossTaskReviewerPrompt = buildCrossTaskReviewerPrompt({
5413
5265
  directive,
5414
5266
  projectContext,
5415
- sprintOrganizerOutput,
5267
+ plannerOutput,
5416
5268
  feedback
5417
5269
  });
5418
- const crossTaskReviewOutput = await this.aiRunner.run(crossTaskReviewerPrompt);
5419
- this.log("Cross-Task Review phase complete.", "success");
5420
- const plan = parseSprintPlanFromAI(crossTaskReviewOutput, directive);
5270
+ const reviewOutput = await this.aiRunner.run(crossTaskReviewerPrompt);
5271
+ this.log("Review phase complete.", "success");
5272
+ const plan = parseSprintPlanFromAI(reviewOutput, directive);
5421
5273
  if (feedback) {
5422
5274
  plan.feedback = feedback;
5423
5275
  }
5424
5276
  return {
5425
5277
  plan,
5426
5278
  phaseOutputs: {
5427
- techLead: techLeadOutput,
5428
- architect: architectOutput,
5429
- sprintOrganizer: sprintOrganizerOutput,
5430
- crossTaskReview: crossTaskReviewOutput
5279
+ planner: plannerOutput,
5280
+ review: reviewOutput
5431
5281
  }
5432
5282
  };
5433
5283
  }
@@ -1,15 +1 @@
1
- /**
2
- * Architect Agent Persona
3
- *
4
- * Phase 2 of the planning meeting. Reviews the Tech Lead's task
5
- * breakdown and refines it with dependency analysis, risk assessment,
6
- * and task splitting/merging recommendations.
7
- */
8
- export interface ArchitectInput {
9
- directive: string;
10
- projectContext: string;
11
- techLeadOutput: string;
12
- feedback?: string;
13
- }
14
- export declare function buildArchitectPrompt(input: ArchitectInput): string;
15
1
  //# sourceMappingURL=architect.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/architect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CAwElE"}
1
+ {"version":3,"file":"architect.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/architect.ts"],"names":[],"mappings":""}
@@ -1,14 +1,14 @@
1
1
  /**
2
2
  * Cross-Task Reviewer Agent Persona
3
3
  *
4
- * Phase 4 (final) of the planning meeting. Reviews the Sprint Organizer's
5
- * finalized plan for task ordering issues, dependency correctness,
4
+ * Phase 2 (final) of the planning meeting. Reviews the Planner's
5
+ * sprint plan for task ordering issues, dependency correctness,
6
6
  * description quality, and overall plan coherence.
7
7
  */
8
8
  export interface CrossTaskReviewerInput {
9
9
  directive: string;
10
10
  projectContext: string;
11
- sprintOrganizerOutput: string;
11
+ plannerOutput: string;
12
12
  feedback?: string;
13
13
  }
14
14
  export declare function buildCrossTaskReviewerPrompt(input: CrossTaskReviewerInput): string;
@@ -1 +1 @@
1
- {"version":3,"file":"cross-task-reviewer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/cross-task-reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAkHR"}
1
+ {"version":3,"file":"cross-task-reviewer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/cross-task-reviewer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAkHR"}
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Planner Agent Persona
3
+ *
4
+ * Phase 1 of the simplified planning meeting. Combines the responsibilities
5
+ * of the former Tech Lead, Architect, and Sprint Organizer into a single
6
+ * pass that produces a complete, ordered sprint plan from the CEO directive.
7
+ */
8
+ export interface PlannerInput {
9
+ directive: string;
10
+ projectContext: string;
11
+ codebaseIndex: string;
12
+ feedback?: string;
13
+ }
14
+ export declare function buildPlannerPrompt(input: PlannerInput): string;
15
+ //# sourceMappingURL=planner.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/planner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAyG9D"}
@@ -1,14 +1 @@
1
- /**
2
- * Sprint Organizer Agent Persona
3
- *
4
- * Phase 3 of the planning meeting. Takes the Architect's
5
- * refined task list and produces the final sprint plan with
6
- * name, goal, estimated duration, and organized task assignments.
7
- */
8
- export interface SprintOrganizerInput {
9
- directive: string;
10
- architectOutput: string;
11
- feedback?: string;
12
- }
13
- export declare function buildSprintOrganizerPrompt(input: SprintOrganizerInput): string;
14
1
  //# sourceMappingURL=sprint-organizer.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"sprint-organizer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/sprint-organizer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,oBAAoB,GAC1B,MAAM,CAiFR"}
1
+ {"version":3,"file":"sprint-organizer.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/sprint-organizer.ts"],"names":[],"mappings":""}
@@ -1,15 +1 @@
1
- /**
2
- * Tech Lead Agent Persona
3
- *
4
- * Phase 1 of the planning meeting. Reads the CEO directive,
5
- * project context, and codebase structure to produce an initial
6
- * task breakdown with technical approach for each task.
7
- */
8
- export interface TechLeadInput {
9
- directive: string;
10
- projectContext: string;
11
- codebaseIndex: string;
12
- feedback?: string;
13
- }
14
- export declare function buildTechLeadPrompt(input: TechLeadInput): string;
15
1
  //# sourceMappingURL=tech-lead.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tech-lead.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/tech-lead.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAmFhE"}
1
+ {"version":3,"file":"tech-lead.d.ts","sourceRoot":"","sources":["../../../src/planning/agents/tech-lead.ts"],"names":[],"mappings":""}
@@ -1,6 +1,6 @@
1
1
  import type { AiRunner } from "../ai/runner.js";
2
2
  import { type SprintPlan } from "./sprint-plan.js";
3
- export type PlanningPhase = "tech-lead" | "architect" | "sprint-organizer" | "cross-task-review" | "complete";
3
+ export type PlanningPhase = "planner" | "review" | "complete";
4
4
  export interface PlanningMeetingConfig {
5
5
  projectPath: string;
6
6
  aiRunner: AiRunner;
@@ -10,17 +10,15 @@ export interface PlanningMeetingResult {
10
10
  plan: SprintPlan;
11
11
  /** Raw outputs from each phase for debugging/transparency */
12
12
  phaseOutputs: {
13
- techLead: string;
14
- architect: string;
15
- sprintOrganizer: string;
16
- crossTaskReview: string;
13
+ planner: string;
14
+ review: string;
17
15
  };
18
16
  }
19
17
  /**
20
- * Orchestrates a multi-phase planning meeting where AI agent personas
18
+ * Orchestrates a two-phase planning meeting where AI agent personas
21
19
  * collaborate to produce a sprint plan.
22
20
  *
23
- * Flow: CEO Directive → Tech Lead Architect → Sprint Organizer → Cross-Task Review → Sprint Plan
21
+ * Flow: CEO Directive → Planner → Cross-Task Review → Sprint Plan
24
22
  */
25
23
  export declare class PlanningMeeting {
26
24
  private projectPath;
@@ -1 +1 @@
1
- {"version":3,"file":"planning-meeting.d.ts","sourceRoot":"","sources":["../../src/planning/planning-meeting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOhD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,WAAW,GACX,kBAAkB,GAClB,mBAAmB,GACnB,UAAU,CAAC;AAEf,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,eAAe,EAAE,MAAM,CAAC;QACxB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAGD;gBAEE,MAAM,EAAE,qBAAqB;IAMzC;;OAEG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC;IAyEjC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;CA8BzB"}
1
+ {"version":3,"file":"planning-meeting.d.ts","sourceRoot":"","sources":["../../src/planning/planning-meeting.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAKhD,OAAO,EAAyB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE1E,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,CAAC,EAAE,CACJ,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,KAC1C,IAAI,CAAC;CACX;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,6DAA6D;IAC7D,YAAY,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,GAAG,CAGD;gBAEE,MAAM,EAAE,qBAAqB;IAMzC;;OAEG;IACG,GAAG,CACP,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,qBAAqB,CAAC;IA6CjC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,gBAAgB;CA8BzB"}
@@ -1 +1 @@
1
- {"version":3,"file":"sprint-plan.d.ts","sourceRoot":"","sources":["../../src/planning/sprint-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAmE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAgBd;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,UAAU,CA0CZ"}
1
+ {"version":3,"file":"sprint-plan.d.ts","sourceRoot":"","sources":["../../src/planning/sprint-plan.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EAElB,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiE7D;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,CAgBd;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,UAAU,CA0CZ"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@locusai/sdk",
3
- "version": "0.11.6",
3
+ "version": "0.11.7",
4
4
  "type": "module",
5
5
  "main": "./src/index.ts",
6
6
  "types": "./src/index.ts",
@@ -30,7 +30,7 @@
30
30
  "clean": "rm -rf node_modules"
31
31
  },
32
32
  "dependencies": {
33
- "@locusai/shared": "^0.11.6",
33
+ "@locusai/shared": "^0.11.7",
34
34
  "axios": "^1.13.2",
35
35
  "events": "^3.3.0",
36
36
  "globby": "^14.0.2"