pi-long-task 0.3.9 → 0.3.10

package/src/types.ts

@@ -6,18 +6,80 @@ import type { SessionOutcome } from "./worker_session.ts";
 
 export const PiLongTaskParams = Type.Object(
   {
-    inputText: Type.String({
-      description: "TODO file content or the user's long-task instructions to process.",
-    }),
+    inputText: Type.Optional(
+      Type.String({
+        description:
+          "Optional TODO file content or the user's long-task instructions to process. Natural-language routing parses commit and goal separately.",
+      }),
+    ),
     commit: Type.Boolean({
       description:
         "Whether Pi Long Task may commit completed worker changes. Use true when the user asks for commits or committing as work progresses; otherwise use false.",
     }),
+    goal: Type.Optional(
+      Type.String({
+        description: "Optional high-level goal or desired outcome for the long-task run.",
+      }),
+    ),
+  },
+  { additionalProperties: false },
+);
+
+export const PiGoalTaskParams = Type.Object(
+  {
+    goal: Type.String({
+      description:
+        "High-level goal to achieve through repeated TODO generation, long-task execution, and reviewer iterations until complete or stopped by limits.",
+    }),
+    commit: Type.Optional(
+      Type.Boolean({
+        description:
+          "Whether worker long tasks may commit completed TODO work during the goal loop. Defaults to true for goal loops.",
+      }),
+    ),
+    maxIterations: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description: "Maximum number of generate → execute → review iterations before stopping. Defaults to 50.",
+      }),
+    ),
+    timeoutMs: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description: "Overall goal-loop timeout in milliseconds. Defaults to 172800000 (48 hours).",
+      }),
+    ),
+    iterationTimeoutMs: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description:
+          "Timeout budget in milliseconds for each generated TODO worker iteration. Defaults to 10800000 (3 hours).",
+      }),
+    ),
+    reviewerTimeoutMs: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description: "Timeout budget in milliseconds for each reviewer session. Defaults to 1800000 (30 minutes).",
+      }),
+    ),
+    maxAttemptsPerTask: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description: "Maximum attempts for each TODO inside worker long-task runs.",
+      }),
+    ),
+    maxBashTimeoutMs: Type.Optional(
+      Type.Integer({
+        minimum: 1,
+        description: "Maximum bash command timeout in milliseconds allowed in worker sessions.",
+      }),
+    ),
   },
   { additionalProperties: false },
 );
 
 export type PiLongTaskInput = Static<typeof PiLongTaskParams>;
+export type PiGoalTaskInput = Static<typeof PiGoalTaskParams>;
 
 export type CoordinatorStatus = "done" | "partial" | "blocked" | "failed";
 
@@ -64,5 +126,6 @@ export interface PiLongTaskResult {
   taskProgress: TaskProgressModel;
   workerCostTotal: number;
   commit: boolean;
+  goal?: string;
   error?: string;
 }

package/src/worker_session.ts

@@ -1,3 +1,4 @@
+import { coverageGoalAction, coverageGoalVerification, parseCoverageGoal } from "./coverage_goal.ts";
 import { hasTaskResult, hasTaskResultStatus, isDoneStatus, parseReportedStatus } from "./result_writer.ts";
 import type { Task } from "./todo_parser.ts";
 
@@ -8,6 +9,7 @@ export interface WorkerTaskPromptOptions {
   commitRequested: boolean;
   previousAttempts?: string;
   globalInstructions?: string;
+  goal?: string;
   maxBashTimeoutSeconds: number;
 }
 
@@ -22,7 +24,7 @@ export function taskLabel(task: Pick<Task, "taskId" | "title">): string {
 
 export function buildTaskPrompt(options: WorkerTaskPromptOptions): string {
   const commitText = options.commitRequested
-    ? "Pi Long Task will commit after your session if needed. Do not run git commit."
+    ? "Commit mode is enabled: complete your assigned work and report status accurately; Pi Long Task will commit eligible completed work after your session if needed. Do not run git commit."
     : "Do not run git commit. Pi Long Task was started with commits disabled.";
 
   const previousAttempts = (options.previousAttempts || "").trim();
@@ -47,11 +49,30 @@ ${globalInstructions}
 `
     : "";
 
+  const goal = (options.goal || "").trim();
+  const coverageGoal = parseCoverageGoal(goal);
+  const coverageGoalText = coverageGoal
+    ? `
+
+Coverage goal guidance:
+- ${coverageGoalAction(coverageGoal)}
+- ${coverageGoalVerification(coverageGoal)} Prefer the project-specific coverage script when available (for example, \`npm run test:coverage\`, \`npm run coverage\`, or \`npm test -- --coverage\`).`
+    : "";
+  const goalText = goal
+    ? `
+
+Long task goal:
+
+\`\`\`text
+${goal}
+\`\`\`${coverageGoalText}`
+    : "";
+
   return `You are one Pi SDK worker session assigned to exactly one TODO task.
 
 Assigned TODO file path: \`${options.todoPath}\`
 Assigned task: \`${taskLabel(options.task)}\`
-Attempt: ${options.attempt}
+Attempt: ${options.attempt}${goalText}
 
 Rules:
 - Work only on the assigned task below. Do not start or fix other TODO tasks.