task-while 0.0.3 → 0.0.4

package/README.md

@@ -127,6 +127,8 @@ cd /path/to/workspace
 pnpm exec task-while batch --config ./batch.yaml
 ```
 
+This repository also includes a repo-local skill at `skills/generate-batch-yaml/` for generating batch configs from natural-language requirements.
+
 Batch config example:
 
 ```yaml
@@ -163,7 +165,7 @@ Batch behavior:
 - structured results are written beside the YAML file in `results.json`
 - internal harness state is written under `.while/harness/` beside the YAML file
 - result keys are relative to the directory that contains `batch.yaml`
-- `--verbose` streams direct provider details to `stderr` during batch execution, including Claude init/task/tool/result summaries and Codex thinking, commands, MCP tools, file updates, todo changes, messages, and final usage
+- `--verbose` streams batch-level progress and direct provider details to `stderr` during batch execution, including the current file, completion counts, Claude init/task/tool/result summaries, and Codex thinking, commands, MCP tools, file updates, todo changes, messages, and final usage
 - rerunning the command resumes unfinished work and skips files that already have accepted results
 - failed files are suspended and retried after all pending files are processed
 - file-level retries are limited by `maxRetries` (default 3); exhausted files are marked blocked

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "task-while",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "packageManager": "pnpm@10.32.1",
   "description": "Git-first task orchestrator for task-source workspaces",
   "author": "Zhang Yu",

package/src/commands/batch.ts

@@ -42,6 +42,38 @@ export interface RunBatchCommandResult {
   resultsFilePath: string
 }
 
+function writeBatchVerboseLine(verbose: boolean | undefined, line: string) {
+  if (!verbose) {
+    return
+  }
+  process.stderr.write(`[batch] ${line}\n`)
+}
+
+function readSessionProgress(detail: unknown) {
+  if (typeof detail !== 'object' || detail === null) {
+    return null
+  }
+  const progress = (detail as { progress?: unknown }).progress
+  if (typeof progress !== 'object' || progress === null) {
+    return null
+  }
+
+  const blocked =
+    typeof (progress as { blocked?: unknown }).blocked === 'number'
+      ? (progress as { blocked: number }).blocked
+      : 0
+  const completed =
+    typeof (progress as { completed?: unknown }).completed === 'number'
+      ? (progress as { completed: number }).completed
+      : 0
+  const suspended =
+    typeof (progress as { suspended?: unknown }).suspended === 'number'
+      ? (progress as { suspended: number }).suspended
+      : 0
+
+  return { blocked, completed, suspended }
+}
+
 async function readJsonFileIfExists(filePath: string) {
   const exists = await fsExtra.pathExists(filePath)
   if (!exists) {
@@ -138,6 +170,10 @@ export async function runBatchCommand(
   })
 
   const processedFiles: string[] = []
+  const totalFiles = discoveredFiles.length
+  let blockedCount = 0
+  let completedCount = 0
+  let suspendedCount = 0
 
   for await (const event of runSession({
     config: {},
@@ -153,8 +189,70 @@ export async function runBatchCommand(
         }),
     },
   })) {
+    if (event.type === SessionEventType.SessionStarted) {
+      const progress = readSessionProgress(event.detail)
+      if (progress) {
+        blockedCount = progress.blocked
+        completedCount = progress.completed
+        suspendedCount = progress.suspended
+      }
+      writeBatchVerboseLine(
+        input.verbose,
+        `resume total=${totalFiles} completed=${completedCount} blocked=${blockedCount} suspended=${suspendedCount}`,
+      )
+      continue
+    }
+
+    if (event.type === SessionEventType.SubjectStarted) {
+      writeBatchVerboseLine(
+        input.verbose,
+        `start completed=${completedCount}/${totalFiles} file=${event.subjectId}`,
+      )
+      continue
+    }
+
+    if (event.type === SessionEventType.SubjectResumed) {
+      suspendedCount = Math.max(0, suspendedCount - 1)
+      writeBatchVerboseLine(
+        input.verbose,
+        `resume-file completed=${completedCount}/${totalFiles} file=${event.subjectId}`,
+      )
+      continue
+    }
+
     if (event.type === SessionEventType.SubjectDone) {
+      completedCount += 1
       processedFiles.push(event.subjectId)
+      writeBatchVerboseLine(
+        input.verbose,
+        `done completed=${completedCount}/${totalFiles} file=${event.subjectId}`,
+      )
+      continue
+    }
+
+    if (event.type === SessionEventType.SubjectBlocked) {
+      blockedCount += 1
+      writeBatchVerboseLine(
+        input.verbose,
+        `blocked completed=${completedCount}/${totalFiles} file=${event.subjectId}`,
+      )
+      continue
+    }
+
+    if (event.type === SessionEventType.SubjectSuspended) {
+      suspendedCount += 1
+      writeBatchVerboseLine(
+        input.verbose,
+        `suspended completed=${completedCount}/${totalFiles} file=${event.subjectId}`,
+      )
+      continue
+    }
+
+    if (event.type === SessionEventType.SessionDone) {
+      writeBatchVerboseLine(
+        input.verbose,
+        `session-done total=${totalFiles} completed=${completedCount} blocked=${blockedCount} suspended=${suspendedCount}`,
+      )
     }
   }