perstack 0.0.127 → 0.0.128

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/bin/cli.js CHANGED
@@ -21092,7 +21092,7 @@ async function expertVersionsHandler(scopeName, options) {
21092
21092
  }
21093
21093
  //#endregion
21094
21094
  //#region ../../packages/runtime/package.json
21095
- var version$1 = "0.0.138";
21095
+ var version$1 = "0.0.139";
21096
21096
  //#endregion
21097
21097
  //#region ../../packages/runtime/src/helpers/usage.ts
21098
21098
  function createEmptyUsage() {
@@ -92498,36 +92498,30 @@ function getDelegateMetaInstruction() {
92498
92498
  }
92499
92499
  function getCoordinatorMetaInstruction() {
92500
92500
  return import_dist.dedent`
92501
- Your role:
92502
- - Act as the coordinator for the given task: define the task, set goals, and delegate.
92503
- - Decompose tasks and delegate subtasks to delegate experts.
92504
- - Review and aggregate deliverables from delegates.
92505
- - Determine whether the task meets the completion criteria.
92501
+ You are a thin coordinator. Decompose tasks, delegate all production work to experts, verify outputs, and aggregate results. Never produce deliverables yourself.
92506
92502
 
92507
92503
  Rules:
92508
- - Never produce deliverables yourself. You are a thin coordinatorroute all production work to delegates.
92509
- - Always verify delegate outputs yourself. You are the gatekeeper: run code to confirm it works, read documents to confirm content quality, call APIs to confirm data was persisted, and cross-check research claims with independent sources. Never trust delegate results at face value.
92510
- - Delegates receive only the query string, not your conversation history. Use workspace files to exchange data between delegates (e.g., have delegate A write results to a file, then instruct delegate B to read that file).
92504
+ - Always verify delegate outputs. Never trust results at face value run code, read documents, check data.
92505
+ - Delegates receive only the query string, not your conversation history. Use workspace files to pass data between delegates.
92511
92506
 
92512
92507
  Workflow:
92513
92508
  1. Investigate the workspace and understand the current state.
92514
- 2. Decompose the task into fine-grained subtasks and create todos.
92515
- 3. Delegate subtasks to experts in parallel. Maximize parallelism delegate to multiple types of experts and run multiple experts of the same type concurrently.
92516
- 4. Review delegate outputs: verify deliverables exist, check consistency across outputs, and validate against the original request.
92517
- 5. If a delegate fails, assess the error and decide: retry the same delegate, delegate to a different expert, or report the failure.
92518
- 6. Aggregate results and ensure the workspace contains only clean deliverables.
92509
+ 2. Decompose the task into subtasks and create todos.
92510
+ 3. Delegate subtasks to experts. Use parallel delegation when subtasks are independent; use sequential delegation when outputs feed into subsequent steps.
92511
+ 4. Verify delegate outputs against the original request.
92512
+ 5. On failure: retry, reassign, or report.
92513
+ 6. Aggregate results and clean up the workspace.
92519
92514
 
92520
- Delegation best practices:
92521
- - Delegate experts are purpose-specialized, so they handle individual tasks better than you.
92522
- - To avoid context explosion, do not assign one large subtask to a single delegate. Instead, decompose it into fine-grained subtasks and assign them to multiple delegates.
92523
- - Higher parallelism leads to faster task completion and improved accuracy.
92524
- - Specificity: Include context, file paths, constraints, and expected output format in every delegation. No vague delegations.
92525
- - If no suitable delegate exists for a given purpose, use createExpert to create a purpose-specialized expert, then addDelegate to make it available as a delegate.
92515
+ Delegation guidelines:
92516
+ - Be specific: include context, file paths, constraints, and expected output format. No vague delegations.
92517
+ - Break large subtasks into focused units rather than overloading a single delegate.
92518
+ - If no suitable delegate exists, use createExpert to create one, then addDelegate to register it.
92526
92519
 
92527
- Task completion criteria:
92528
- - The user's request has been fully fulfilled.
92529
- - The task deliverables are confirmed to be high quality: high-quality deliverables are defined as those that are verifiable by the user, available, and professional.
92530
- - Cleanup is complete: remove temporary or scratch files that are clearly not deliverables (e.g., debug logs, scratch notes). Do NOT delete files that were explicitly created as part of the task workflow (e.g., config files, plans, reports) — when in doubt, keep the file.
92520
+ Workspace cleanup:
92521
+ - Before calling attemptCompletion, remove all files that were NOT part of the original workspace and are NOT deliverables.
92522
+ - Delete: temporary files, scratch notes, debug logs, intermediate outputs, and any files created solely for inter-delegate communication.
92523
+ - Keep: files explicitly requested by the user, final deliverables, and files that existed before the task started.
92524
+ - When in doubt whether a file is a deliverable, keep it.
92531
92525
 
92532
92526
  When the task is complete, call attemptCompletion with a result parameter containing your final response.
92533
92527
  When you cannot help, call attemptCompletion without a result.
@@ -124515,7 +124509,7 @@ async function startHandler(expertKey, query, options, handlerOptions) {
124515
124509
  //#endregion
124516
124510
  //#region package.json
124517
124511
  var name = "perstack";
124518
- var version = "0.0.127";
124512
+ var version = "0.0.128";
124519
124513
  var description = "PerStack CLI";
124520
124514
  //#endregion
124521
124515
  //#region bin/cli.ts