@qianxude/tem 0.4.5 → 0.4.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qianxude/tem",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "A lightweight task execution engine for IO-bound workloads with SQLite persistence, retry, and rate limiting",
   "module": "src/index.ts",
   "type": "module",

package/src/cli/README.md

@@ -138,12 +138,12 @@ tem watch <db-path> [batch-code]
 - `--latest` - Watch the most recently created batch
 - `--interval N` - Refresh interval in seconds (default: 5)
 - `--timeout N` - Maximum watch time in seconds (default: 3600)
-- `--no-clear` - Don't clear screen between updates
+- `--append` - Append reports instead of clearing screen (creates scrollable history)
 
 **Examples:**
 
 ```sh
-# Watch the latest batch
+# Watch the latest batch (single report mode)
 tem watch ./tem.db --latest
 
 # Watch specific batch with 10-second refresh
@@ -152,8 +152,8 @@ tem watch ./tem.db my-batch-code --interval 10
 # Watch for up to 5 minutes
 tem watch ./tem.db --latest --timeout 300
 
-# Watch without clearing screen (for logging)
-tem watch ./tem.db --latest --no-clear
+# Watch with appended reports (scrollable history)
+tem watch ./tem.db --latest --append
 ```
 
 **Watch display includes:**

package/src/cli/commands/watch.ts

@@ -33,7 +33,7 @@ interface RecentError {
 interface WatchOptions {
   interval: number;
   timeout: number;
-  noClear: boolean;
+  append: boolean;
   latest: boolean;
 }
 
@@ -422,7 +422,7 @@ export async function watchCommand(
   const options: WatchOptions = {
     interval: (parseInt(String(flags['interval'] || '5'), 10) || 5) * 1000,
     timeout: (parseInt(String(flags['timeout'] || '3600'), 10) || 3600) * 1000,
-    noClear: flags['no-clear'] === true,
+    append: flags['append'] === true,
     latest: flags['latest'] === true,
   };
 
@@ -499,7 +499,7 @@ export async function watchCommand(
     });
 
     // Initial render
-    if (!options.noClear) clearScreen();
+    if (!options.append) clearScreen();
     const timing = getTaskTiming(db, batchId);
     const recentErrors = getRecentErrors(db, batchId, 3);
     const stuckCount = getStuckTaskCount(db, batchId);
@@ -511,7 +511,7 @@ export async function watchCommand(
         // Check timeout
         if (Date.now() - state.startTime > options.timeout) {
           clearInterval(intervalId);
-          if (!options.noClear) clearScreen();
+          if (!options.append) clearScreen();
           console.error('Watch timeout reached');
           db.close();
           process.exit(1);
@@ -520,7 +520,7 @@ export async function watchCommand(
         // Check if should exit
         if (state.shouldExit) {
           clearInterval(intervalId);
-          if (!options.noClear) clearScreen();
+          if (!options.append) clearScreen();
           console.log('\nWatch interrupted by user');
           db.close();
           process.exit(state.exitCode);
@@ -536,7 +536,12 @@ export async function watchCommand(
         }
 
         // Render update
-        if (!options.noClear) clearScreen();
+        if (options.append) {
+          // Print separator between reports in append mode
+          console.log('\n' + '─'.repeat(70));
+        } else {
+          clearScreen();
+        }
         const timing = getTaskTiming(db, batchId);
         const recentErrors = getRecentErrors(db, batchId, 3);
         const stuckCount = getStuckTaskCount(db, batchId);
@@ -545,7 +550,11 @@ export async function watchCommand(
         // Check if batch is done
         if (!shouldContinueWatching(summary)) {
           clearInterval(intervalId);
-          if (!options.noClear) clearScreen();
+          if (options.append) {
+            console.log('\n' + '═'.repeat(70));
+          } else {
+            clearScreen();
+          }
           console.log(renderFinalReport(summary, timing, recentErrors, stuckCount, state));
           db.close();
           process.exit(0);

package/src/cli/index.ts

@@ -29,7 +29,7 @@ Watch command options:
   --latest                       Use the most recently created batch
   --interval N                   Refresh interval in seconds (default: 5)
   --timeout N                    Maximum watch time in seconds (default: 3600)
-  --no-clear                     Don't clear screen between updates
+  --append                       Append reports instead of clearing screen
 
 Examples:
   tem report ./test.db                    # Summary of all batches

package/src/index.ts

@@ -6,7 +6,9 @@ export {
   ConcurrencyController,
   RateLimiter,
   printDetectedConfig,
+  waitForBatch,
   type RateLimitConfig,
+  type WaitForBatchOptions,
 } from './utils/index.js';
 export {
   TEM,