@bilalimamoglu/sift 0.4.0 → 0.4.1

package/README.md

@@ -8,9 +8,15 @@
 
 Your AI agent should not be reading 13,000 lines of test output.
 
-On the largest real fixture in the benchmark:
-**Before:** 128 failures, 198K raw-output tokens, agent reconstructs the failure shape from scratch.
-**After:** 6 lines, 129 `standard` tokens, agent acts on a grouped diagnosis immediately.
+If 125 tests fail for one reason, it should pay for that reason once.
+
+`sift` turns noisy command output into a short, structured diagnosis for coding agents, so they spend fewer tokens, cost less to run, and move through debug loops faster.
+
+Instead of feeding an agent thousands of lines of logs, you give it:
+- the root cause
+- where it happens
+- what to fix
+- what to do next
 
 ```bash
 sift exec --preset test-status -- pytest -q
@@ -28,13 +34,14 @@ sift exec --preset test-status -- pytest -q
 - Decision: stop and act.
 ```
 
-If 125 tests fail for one reason, the agent should pay for that reason once.
+On the largest real fixture in the benchmark:
+`198K` raw-output tokens -> `129` `standard` tokens.
 
-## What it is
+Same diagnosis. Far less work.
 
-Developers using coding agents — Claude Code, Codex, Cursor, Windsurf, Copilot, or any LLM-driven workflow that runs shell commands and reads the output.
+## What it is
 
-`sift` sits between the command and the agent. It captures noisy output, groups repeated failures into root-cause buckets, and returns a short diagnosis with an anchor, a likely fix, and a decision signal. The agent gets a map instead of a wall of text.
+`sift` sits between a noisy command and a coding agent. It captures output, groups repeated failures into root-cause buckets, and returns a short diagnosis with an anchor, a likely fix, and a decision signal.
 
 ## Install
 

package/dist/cli.js

@@ -7594,7 +7594,7 @@ function buildGenericRawSlice(args) {
 
 // src/core/run.ts
 var RETRY_DELAY_MS = 300;
-var PROVIDER_PENDING_NOTICE_DELAY_MS = 150;
+var PENDING_NOTICE_DELAY_MS = 150;
 function estimateTokenCount(text) {
   return Math.max(1, Math.ceil(text.length / 4));
 }
@@ -7675,17 +7675,16 @@ function buildDryRunOutput(args) {
 async function delay(ms) {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }
-function startProviderPendingNotice() {
-  if (!process.stderr.isTTY) {
+function startPendingNotice(message, enabled) {
+  if (!enabled) {
     return () => {
     };
   }
-  const message = "sift waiting for provider...";
   let shown = false;
   const timer = setTimeout(() => {
     shown = true;
     process.stderr.write(`${message}\r`);
-  }, PROVIDER_PENDING_NOTICE_DELAY_MS);
+  }, PENDING_NOTICE_DELAY_MS);
   return () => {
     clearTimeout(timer);
     if (!shown) {
@@ -7715,7 +7714,10 @@ async function generateWithRetry(args) {
     responseMode: args.responseMode,
     jsonResponseFormat: args.request.config.provider.jsonResponseFormat
   });
-  const stopPendingNotice = startProviderPendingNotice();
+  const stopPendingNotice = startPendingNotice(
+    "sift waiting for provider...",
+    Boolean(process.stderr.isTTY)
+  );
   try {
     try {
       return await generate();
@@ -9281,6 +9283,10 @@ async function runExec(request) {
     cwd: commandCwd,
     stdio: ["inherit", "pipe", "pipe"]
   });
+  const stopChildPendingNotice = startPendingNotice(
+    "sift waiting for child command...",
+    Boolean(process.stderr.isTTY) && !request.quiet
+  );
   const handleChunk = (chunk) => {
     const text = Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
     if (bypassed) {
@@ -9301,21 +9307,25 @@ async function runExec(request) {
   };
   child.stdout.on("data", handleChunk);
   child.stderr.on("data", handleChunk);
-  await new Promise((resolve, reject) => {
-    child.on("error", (error) => {
-      reject(error);
-    });
-    child.on("close", (status, signal) => {
-      childStatus = status;
-      childSignal = signal;
-      resolve();
+  try {
+    await new Promise((resolve, reject) => {
+      child.on("error", (error) => {
+        reject(error);
+      });
+      child.on("close", (status, signal) => {
+        childStatus = status;
+        childSignal = signal;
+        resolve();
+      });
     });
-  }).catch((error) => {
+  } catch (error) {
     if (error instanceof Error) {
       throw error;
     }
     throw new Error("Failed to start child process.");
-  });
+  } finally {
+    stopChildPendingNotice();
+  }
   const exitCode = normalizeChildExitCode(childStatus, childSignal);
   const capturedOutput = capture.render();
   const autoWatchDetected = !request.watch && looksLikeWatchStream(capturedOutput);

package/dist/index.d.ts

@@ -162,6 +162,7 @@ interface RunResult {
     stats: RunStats | null;
 }
 
+declare function startPendingNotice(message: string, enabled: boolean): () => void;
 declare function runSift(request: RunRequest): Promise<string>;
 declare function runSiftWithStats(request: RunRequest): Promise<RunResult>;
 
@@ -178,4 +179,4 @@ interface ResolveOptions {
 }
 declare function resolveConfig(options?: ResolveOptions): SiftConfig;
 
-export { BoundedCapture, type DetailLevel, type ExecRequest, type GenerateInput, type GenerateResult, type Goal, type InputConfig, type JsonResponseFormatMode, type LLMProvider, type NativeProviderName, type OutputFormat, type PartialSiftConfig, type PreparedInput, type PresetDefinition, type PromptPolicyName, type ProviderConfig, type ProviderName, type ProviderProfile, type ProviderProfiles, type RawSliceStrategy, type ResolveOptions, type ResponseMode, type RunRequest, type RuntimeConfig, type SiftConfig, type TestStatusRemainingMode, type UsageInfo, buildCommandPreview, getExecSuccessShortcut, looksInteractivePrompt, mergeDefined, normalizeChildExitCode, resolveConfig, runExec, runSift, runSiftWithStats };
+export { BoundedCapture, type DetailLevel, type ExecRequest, type GenerateInput, type GenerateResult, type Goal, type InputConfig, type JsonResponseFormatMode, type LLMProvider, type NativeProviderName, type OutputFormat, type PartialSiftConfig, type PreparedInput, type PresetDefinition, type PromptPolicyName, type ProviderConfig, type ProviderName, type ProviderProfile, type ProviderProfiles, type RawSliceStrategy, type ResolveOptions, type ResponseMode, type RunRequest, type RuntimeConfig, type SiftConfig, type TestStatusRemainingMode, type UsageInfo, buildCommandPreview, getExecSuccessShortcut, looksInteractivePrompt, mergeDefined, normalizeChildExitCode, resolveConfig, runExec, runSift, runSiftWithStats, startPendingNotice };

package/dist/index.js

@@ -5774,7 +5774,7 @@ function buildGenericRawSlice(args) {
 
 // src/core/run.ts
 var RETRY_DELAY_MS = 300;
-var PROVIDER_PENDING_NOTICE_DELAY_MS = 150;
+var PENDING_NOTICE_DELAY_MS = 150;
 function estimateTokenCount(text) {
   return Math.max(1, Math.ceil(text.length / 4));
 }
@@ -5855,17 +5855,16 @@ function buildDryRunOutput(args) {
 async function delay(ms) {
   await new Promise((resolve) => setTimeout(resolve, ms));
 }
-function startProviderPendingNotice() {
-  if (!process.stderr.isTTY) {
+function startPendingNotice(message, enabled) {
+  if (!enabled) {
     return () => {
     };
   }
-  const message = "sift waiting for provider...";
   let shown = false;
   const timer = setTimeout(() => {
     shown = true;
     process.stderr.write(`${message}\r`);
-  }, PROVIDER_PENDING_NOTICE_DELAY_MS);
+  }, PENDING_NOTICE_DELAY_MS);
   return () => {
     clearTimeout(timer);
     if (!shown) {
@@ -5895,7 +5894,10 @@ async function generateWithRetry(args) {
     responseMode: args.responseMode,
     jsonResponseFormat: args.request.config.provider.jsonResponseFormat
   });
-  const stopPendingNotice = startProviderPendingNotice();
+  const stopPendingNotice = startPendingNotice(
+    "sift waiting for provider...",
+    Boolean(process.stderr.isTTY)
+  );
   try {
     try {
       return await generate();
@@ -7293,6 +7295,10 @@ async function runExec(request) {
     cwd: commandCwd,
     stdio: ["inherit", "pipe", "pipe"]
   });
+  const stopChildPendingNotice = startPendingNotice(
+    "sift waiting for child command...",
+    Boolean(process.stderr.isTTY) && !request.quiet
+  );
   const handleChunk = (chunk) => {
     const text = Buffer.isBuffer(chunk) ? chunk.toString("utf8") : String(chunk);
     if (bypassed) {
@@ -7313,21 +7319,25 @@ async function runExec(request) {
   };
   child.stdout.on("data", handleChunk);
   child.stderr.on("data", handleChunk);
-  await new Promise((resolve, reject) => {
-    child.on("error", (error) => {
-      reject(error);
-    });
-    child.on("close", (status, signal) => {
-      childStatus = status;
-      childSignal = signal;
-      resolve();
+  try {
+    await new Promise((resolve, reject) => {
+      child.on("error", (error) => {
+        reject(error);
+      });
+      child.on("close", (status, signal) => {
+        childStatus = status;
+        childSignal = signal;
+        resolve();
+      });
     });
-  }).catch((error) => {
+  } catch (error) {
     if (error instanceof Error) {
       throw error;
     }
     throw new Error("Failed to start child process.");
-  });
+  } finally {
+    stopChildPendingNotice();
+  }
   const exitCode = normalizeChildExitCode(childStatus, childSignal);
   const capturedOutput = capture.render();
   const autoWatchDetected = !request.watch && looksLikeWatchStream(capturedOutput);
@@ -7853,5 +7863,6 @@ export {
   resolveConfig,
   runExec,
   runSift,
-  runSiftWithStats
+  runSiftWithStats,
+  startPendingNotice
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilalimamoglu/sift",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Agent-first command-output reduction layer for agents, CI, and automation.",
   "type": "module",
   "bin": {