terminal-pilot 0.0.40 → 0.0.41

package/README.md

@@ -168,7 +168,10 @@ class TerminalSession {
   press(key: TerminalKey): Promise<void>;
   send(raw: string): Promise<void>; // raw bytes / escape sequences
   signal(signal: string): Promise<void>;
-  waitFor(pattern: string | RegExp, options?: WaitForOptions): Promise<string>;
+  waitFor(
+    pattern: string | RegExp,
+    options?: { timeout?: number; scope?: "history" | "screen" }
+  ): Promise<string>;
   waitForExit(options?: { timeout?: number }): Promise<number>; // throws on timeout
   waitForQuiet(ms: number): Promise<void>;
   screen(): Promise<TerminalScreen>;
@@ -249,6 +252,15 @@ Typical fixture workflow:
 4. Assert with `screen()` or `history()`
 5. `close()` the session
 
+`waitFor(...)` searches captured output history by default. Use
+`waitFor(pattern, { scope: "screen" })` when command echoes or previous output could match before
+the expected interactive screen is visible.
+
+When launching an interactive program through `npm run`, npm can buffer printable raw keys such as
+`q` until `Enter` is pressed. Prefer launching the underlying executable directly for raw-key tests.
+If the npm wrapper is part of the behavior under test, use `Control+c` for teardown and treat
+printable-key delivery as npm-wrapper behavior rather than application behavior.
+
 Example fixture-based test:
 
 ```ts

package/dist/cli.js

@@ -18995,10 +18995,13 @@ var TerminalSession = class {
   }
   async waitFor(pattern, opts) {
     const timeout = opts?.timeout ?? DEFAULT_TIMEOUT_MS;
+    const scope = opts?.scope ?? "history";
     assertTimeout(timeout);
+    assertWaitScope(scope);
     const startedAt = Date.now();
     while (Date.now() - startedAt <= timeout) {
-      const matched = matchPattern(this.rawBuffer, pattern);
+      const source = scope === "screen" ? (await this.screen()).text : this.rawBuffer;
+      const matched = matchPattern(source, pattern);
       if (matched !== null) {
         return matched;
       }
@@ -19119,6 +19122,11 @@ function assertTimeout(timeout) {
     throw new Error("Timeout must be a finite non-negative number.");
   }
 }
+function assertWaitScope(scope) {
+  if (scope !== "history" && scope !== "screen") {
+    throw new Error('Wait scope must be either "history" or "screen".');
+  }
+}
 function assertQuietPeriod(duration) {
   if (!Number.isFinite(duration) || duration < 0) {
     throw new Error("Quiet period must be a finite non-negative number.");
@@ -22819,6 +22827,11 @@ var params15 = S.Object({
   timeout: S.Optional(
     S.Number({ short: "t", description: "Maximum wait time in milliseconds", minimum: 0 })
   ),
+  scope: S.Optional(
+    S.Enum(["history", "screen"], {
+      description: "Search all captured output or only the current visible screen"
+    })
+  ),
   literal: S.Optional(
     S.Boolean({
       short: "l",
@@ -22842,7 +22855,11 @@ var waitFor = defineCommand({
       env
     );
     const pattern = params17.literal === true ? params17.pattern : new RegExp(params17.pattern);
-    const line = params17.timeout === void 0 ? await namedSession.session.waitFor(pattern) : await namedSession.session.waitFor(pattern, { timeout: params17.timeout });
+    const options = params17.timeout === void 0 && params17.scope === void 0 ? void 0 : {
+      ...params17.timeout === void 0 ? {} : { timeout: params17.timeout },
+      ...params17.scope === void 0 ? {} : { scope: params17.scope }
+    };
+    const line = await namedSession.session.waitFor(pattern, options);
     return { matched: true, line };
   }
 });
@@ -23308,7 +23325,7 @@ function sleep2(ms) {
 // src/cli.ts
 configureTheme({ brand: "green", label: "Terminal Pilot" });
 function getBundledPackageVersion() {
-  return true ? "0.0.40" : void 0;
+  return true ? "0.0.41" : void 0;
 }
 function normalizeArgv(argv) {
   if (argv.includes("--json") && !argv.some((argument) => argument === "--output" || argument.startsWith("--output="))) {