@bilalimamoglu/sift 0.4.3 → 0.4.5

package/dist/index.d.ts

@@ -13,6 +13,7 @@ type RawSliceStrategy = "none" | "bucket_evidence" | "traceback_window" | "head_
 type TestStatusRemainingMode = "none" | "subset_rerun" | "full_rerun_diff";
 type ResponseMode = "text" | "json";
 type JsonResponseFormatMode = "auto" | "on" | "off";
+type OperationMode = "agent-escalation" | "provider-assisted" | "local-only";
 type PromptPolicyName = "test-status" | "audit-critical" | "diff-summary" | "build-failure" | "log-errors" | "infra-risk" | "typecheck-summary" | "lint-failures";
 interface ProviderConfig {
     provider: ProviderName;
@@ -34,6 +35,7 @@ interface InputConfig {
     tailChars: number;
 }
 interface RuntimeConfig {
+    operationMode: OperationMode;
     rawFallback: boolean;
     verbose: boolean;
 }
@@ -143,10 +145,16 @@ interface ExecRequest extends Omit<RunRequest, "stdin"> {
     watch?: boolean;
 }
 declare function buildCommandPreview(request: ExecRequest): string;
+type PackageManagerScriptKind = "npm" | "pnpm" | "yarn" | "bun";
+declare function detectPackageManagerScriptKind(commandPreview: string): PackageManagerScriptKind | null;
+declare function normalizeScriptWrapperOutput(args: {
+    commandPreview: string;
+    capturedOutput: string;
+}): string;
 declare function getExecSuccessShortcut(args: {
     presetName?: string;
     exitCode: number;
-    capturedOutput: string;
+    normalizedOutput: string;
 }): string | null;
 declare function runExec(request: ExecRequest): Promise<number>;
 
@@ -178,5 +186,6 @@ interface ResolveOptions {
     cliOverrides?: PartialSiftConfig;
 }
 declare function resolveConfig(options?: ResolveOptions): SiftConfig;
+declare function resolveEffectiveOperationMode(config: SiftConfig): OperationMode;
 
-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 };
+export { BoundedCapture, type DetailLevel, type ExecRequest, type GenerateInput, type GenerateResult, type Goal, type InputConfig, type JsonResponseFormatMode, type LLMProvider, type NativeProviderName, type OperationMode, type OutputFormat, type PackageManagerScriptKind, 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, detectPackageManagerScriptKind, getExecSuccessShortcut, looksInteractivePrompt, mergeDefined, normalizeChildExitCode, normalizeScriptWrapperOutput, resolveConfig, resolveEffectiveOperationMode, runExec, runSift, runSiftWithStats, startPendingNotice };

package/dist/index.js

@@ -4,8 +4,10 @@ import { constants as osConstants } from "os";
 import pc3 from "picocolors";
 
 // src/constants.ts
+import fs from "fs";
 import os from "os";
 import path from "path";
+import crypto from "crypto";
 function getDefaultGlobalConfigPath(homeDir = os.homedir()) {
   return path.join(homeDir, ".config", "sift", "config.yaml");
 }
@@ -15,6 +17,26 @@ function getDefaultGlobalStateDir(homeDir = os.homedir()) {
 function getDefaultTestStatusStatePath(homeDir = os.homedir()) {
   return path.join(getDefaultGlobalStateDir(homeDir), "last-test-status.json");
 }
+function getDefaultScopedTestStatusStateDir(homeDir = os.homedir()) {
+  return path.join(getDefaultGlobalStateDir(homeDir), "test-status", "by-cwd");
+}
+function getScopedTestStatusStatePath(cwd, homeDir = os.homedir()) {
+  const normalizedCwd = normalizeScopedCacheCwd(cwd);
+  const baseName = slugCachePathSegment(path.basename(normalizedCwd)) || "root";
+  const shortHash = crypto.createHash("sha256").update(normalizedCwd).digest("hex").slice(0, 10);
+  return path.join(getDefaultScopedTestStatusStateDir(homeDir), `${baseName}-${shortHash}.json`);
+}
+function slugCachePathSegment(value) {
+  return value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function normalizeScopedCacheCwd(cwd) {
+  const absoluteCwd = path.resolve(cwd);
+  try {
+    return fs.realpathSync.native(absoluteCwd);
+  } catch {
+    return absoluteCwd;
+  }
+}
 function getDefaultConfigSearchPaths() {
   return [
     path.resolve(process.cwd(), "sift.config.yaml"),
@@ -4741,6 +4763,7 @@ var OpenAIProvider = class {
         signal: controller.signal,
         headers: {
           "content-type": "application/json",
+          connection: "close",
           ...this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}
         },
         body: JSON.stringify({
@@ -4841,6 +4864,7 @@ var OpenAICompatibleProvider = class {
         signal: controller.signal,
         headers: {
           "content-type": "application/json",
+          connection: "close",
           ...this.apiKey ? { authorization: `Bearer ${this.apiKey}` } : {}
         },
         body: JSON.stringify({
@@ -5137,7 +5161,7 @@ function buildPrompt(args) {
     "If per-test or per-module mapping is unclear, fall back to the focused grouped-cause view instead of guessing."
   ] : [];
   const prompt = [
-    "You are Sift, a CLI output reduction assistant for downstream agents and automation.",
+    "You are Sift, a CLI output-guidance and reduction assistant for downstream agents and automation.",
     "Hard rules:",
     ...policy.sharedRules.map((rule) => `- ${rule}`),
     "",
@@ -6413,7 +6437,7 @@ function emitStatsFooter(args) {
 }
 
 // src/core/testStatusState.ts
-import fs from "fs";
+import fs2 from "fs";
 import path2 from "path";
 import { z as z2 } from "zod";
 var detailSchema = z2.enum(["standard", "focused", "verbose"]);
@@ -6863,7 +6887,7 @@ function migrateCachedTestStatusRun(state) {
 function readCachedTestStatusRun(statePath = getDefaultTestStatusStatePath()) {
   let raw = "";
   try {
-    raw = fs.readFileSync(statePath, "utf8");
+    raw = fs2.readFileSync(statePath, "utf8");
   } catch (error) {
     if (error.code === "ENOENT") {
       throw new MissingCachedTestStatusRunError();
@@ -6884,10 +6908,10 @@ function tryReadCachedTestStatusRun(statePath = getDefaultTestStatusStatePath())
   }
 }
 function writeCachedTestStatusRun(state, statePath = getDefaultTestStatusStatePath()) {
-  fs.mkdirSync(path2.dirname(statePath), {
+  fs2.mkdirSync(path2.dirname(statePath), {
     recursive: true
   });
-  fs.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}
+  fs2.writeFileSync(statePath, `${JSON.stringify(state, null, 2)}
 `, "utf8");
 }
 function buildTargetDelta(args) {
@@ -7255,13 +7279,97 @@ function buildCommandPreview(request) {
   }
   return (request.command ?? []).join(" ");
 }
+function detectPackageManagerScriptKind(commandPreview) {
+  const trimmed = commandPreview.trim();
+  if (/^npm(?:\s+--?[^\s]+(?:[=\s][^\s]+)?)?\s+run\s+\S+/i.test(trimmed)) {
+    return "npm";
+  }
+  if (/^pnpm(?:\s+--?[^\s]+(?:[=\s][^\s]+)?)?\s+run\s+\S+/i.test(trimmed)) {
+    return "pnpm";
+  }
+  if (/^yarn(?:\s+--?[^\s]+(?:[=\s][^\s]+)?)?\s+run\s+\S+/i.test(trimmed)) {
+    return "yarn";
+  }
+  if (/^bun(?:\s+--?[^\s]+(?:[=\s][^\s]+)?)?\s+run\s+\S+/i.test(trimmed)) {
+    return "bun";
+  }
+  return null;
+}
+function normalizeScriptWrapperOutput(args) {
+  const kind = detectPackageManagerScriptKind(args.commandPreview);
+  if (!kind) {
+    return args.capturedOutput;
+  }
+  const lines = args.capturedOutput.split(/\r?\n/);
+  const trimBlankEdges = () => {
+    while (lines.length > 0 && lines[0].trim() === "") {
+      lines.shift();
+    }
+    while (lines.length > 0 && lines.at(-1).trim() === "") {
+      lines.pop();
+    }
+  };
+  const stripLeadingWrapperNoise = () => {
+    let removed = false;
+    while (lines.length > 0) {
+      const line = lines[0];
+      const trimmed = line.trim();
+      if (trimmed === "") {
+        lines.shift();
+        removed = true;
+        continue;
+      }
+      if (/^(?:npm|pnpm)\s+warn\s+unknown user config\b/i.test(trimmed) || /^(?:npm|pnpm)\s+warn\s+unknown env config\b/i.test(trimmed) || /^npm\s+warn\s+config\b/i.test(trimmed) || /^yarn\s+warning\b/i.test(trimmed) || /^bun\s+warn\b/i.test(trimmed)) {
+        lines.shift();
+        removed = true;
+        continue;
+      }
+      break;
+    }
+    if (removed) {
+      trimBlankEdges();
+    }
+  };
+  trimBlankEdges();
+  stripLeadingWrapperNoise();
+  if (kind === "npm" || kind === "pnpm") {
+    let removed = 0;
+    while (lines.length > 0 && removed < 2 && /^\s*>\s+/.test(lines[0])) {
+      lines.shift();
+      removed += 1;
+    }
+    trimBlankEdges();
+  }
+  if (kind === "yarn") {
+    if (lines[0] && /^\s*yarn run v/i.test(lines[0])) {
+      lines.shift();
+    }
+    if (lines[0] && /^\s*\$\s+/.test(lines[0])) {
+      lines.shift();
+    }
+    trimBlankEdges();
+    if (lines.at(-1) && /^\s*Done in\b/i.test(lines.at(-1))) {
+      lines.pop();
+    }
+  }
+  if (kind === "bun") {
+    if (lines[0] && /^\s*\$\s+/.test(lines[0])) {
+      lines.shift();
+    }
+  }
+  trimBlankEdges();
+  return lines.join("\n");
+}
 function getExecSuccessShortcut(args) {
   if (args.exitCode !== 0) {
     return null;
   }
-  if (args.presetName === "typecheck-summary" && args.capturedOutput.trim() === "") {
+  if (args.presetName === "typecheck-summary" && args.normalizedOutput.trim() === "") {
     return "No type errors.";
   }
+  if (args.presetName === "lint-failures" && args.normalizedOutput.trim() === "") {
+    return "No lint failures.";
+  }
   return null;
 }
 async function runExec(request) {
@@ -7273,10 +7381,11 @@ async function runExec(request) {
   const shellPath = process.env.SHELL || "/bin/bash";
   const commandPreview = buildCommandPreview(request);
   const commandCwd = request.cwd ?? process.cwd();
+  const scopedStatePath = getScopedTestStatusStatePath(commandCwd);
   const isTestStatusPreset = request.presetName === "test-status";
   const readCachedBaseline = isTestStatusPreset && (request.readCachedBaseline ?? true);
   const writeCachedBaselineRequested = isTestStatusPreset && (request.writeCachedBaseline ?? (request.skipCacheWrite ? false : true));
-  const previousCachedRun = readCachedBaseline ? tryReadCachedTestStatusRun() : null;
+  const previousCachedRun = readCachedBaseline ? tryReadCachedTestStatusRun(scopedStatePath) : null;
   if (request.config.runtime.verbose) {
     process.stderr.write(
       `${pc3.dim("sift")} exec mode=${hasShellCommand ? "shell" : "argv"} command=${commandPreview}
@@ -7340,6 +7449,10 @@ async function runExec(request) {
   }
   const exitCode = normalizeChildExitCode(childStatus, childSignal);
   const capturedOutput = capture.render();
+  const normalizedOutput = normalizeScriptWrapperOutput({
+    commandPreview,
+    capturedOutput
+  });
   const autoWatchDetected = !request.watch && looksLikeWatchStream(capturedOutput);
   const useWatchFlow = Boolean(request.watch) || autoWatchDetected;
   const shouldBuildTestStatusState = isTestStatusPreset && !useWatchFlow;
@@ -7365,7 +7478,7 @@ async function runExec(request) {
     const execSuccessShortcut = useWatchFlow ? null : getExecSuccessShortcut({
       presetName: request.presetName,
       exitCode,
-      capturedOutput
+      normalizedOutput
     });
     if (execSuccessShortcut && !request.dryRun) {
       if (request.config.runtime.verbose) {
@@ -7391,15 +7504,15 @@ async function runExec(request) {
     if (useWatchFlow) {
       let output2 = await runWatch({
         ...request,
-        stdin: capturedOutput
+        stdin: normalizedOutput
       });
       if (isInsufficientSignalOutput(output2)) {
         output2 = buildInsufficientSignalOutput({
           presetName: request.presetName,
-          originalLength: capture.getTotalChars(),
+          originalLength: normalizedOutput.length > 0 ? normalizedOutput.length : capture.getTotalChars(),
           truncatedApplied: capture.wasTruncated(),
           exitCode,
-          recognizedRunner: detectTestRunner(capturedOutput)
+          recognizedRunner: detectTestRunner(normalizedOutput)
         });
       }
       process.stdout.write(`${output2}
@@ -7438,7 +7551,7 @@ async function runExec(request) {
     }) : null;
     const result = await runSiftWithStats({
       ...request,
-      stdin: capturedOutput,
+      stdin: normalizedOutput,
       analysisContext: request.testStatusContext?.remainingMode && request.testStatusContext.remainingMode !== "none" && request.presetName === "test-status" ? [
         request.analysisContext,
         "Zoom context:",
@@ -7461,10 +7574,10 @@ async function runExec(request) {
       if (isInsufficientSignalOutput(output)) {
         output = buildInsufficientSignalOutput({
           presetName: request.presetName,
-          originalLength: capture.getTotalChars(),
+          originalLength: normalizedOutput.length > 0 ? normalizedOutput.length : capture.getTotalChars(),
           truncatedApplied: capture.wasTruncated(),
           exitCode,
-          recognizedRunner: detectTestRunner(capturedOutput)
+          recognizedRunner: detectTestRunner(normalizedOutput)
         });
       }
       if (request.diff && !request.dryRun && previousCachedRun && currentCachedRun) {
@@ -7479,7 +7592,7 @@ ${output}`;
       }
       if (currentCachedRun && shouldWriteCachedBaseline) {
         try {
-          writeCachedTestStatusRun(currentCachedRun);
+          writeCachedTestStatusRun(currentCachedRun, scopedStatePath);
         } catch (error) {
           if (request.config.runtime.verbose) {
             const reason = error instanceof Error ? error.message : "unknown_error";
@@ -7491,10 +7604,10 @@ ${output}`;
     } else if (isInsufficientSignalOutput(output)) {
       output = buildInsufficientSignalOutput({
         presetName: request.presetName,
-        originalLength: capture.getTotalChars(),
+        originalLength: normalizedOutput.length > 0 ? normalizedOutput.length : capture.getTotalChars(),
         truncatedApplied: capture.wasTruncated(),
         exitCode,
-        recognizedRunner: detectTestRunner(capturedOutput)
+        recognizedRunner: detectTestRunner(normalizedOutput)
       });
     }
     process.stdout.write(`${output}
@@ -7535,6 +7648,7 @@ var defaultConfig = {
     tailChars: 2e4
   },
   runtime: {
+    operationMode: "agent-escalation",
     rawFallback: true,
     verbose: false
   },
@@ -7585,19 +7699,19 @@ var defaultConfig = {
 };
 
 // src/config/load.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import path3 from "path";
 import YAML from "yaml";
 function findConfigPath(explicitPath) {
   if (explicitPath) {
     const resolved = path3.resolve(explicitPath);
-    if (!fs2.existsSync(resolved)) {
+    if (!fs3.existsSync(resolved)) {
       throw new Error(`Config file not found: ${resolved}`);
     }
     return resolved;
   }
   for (const candidate of getDefaultConfigSearchPaths()) {
-    if (fs2.existsSync(candidate)) {
+    if (fs3.existsSync(candidate)) {
       return candidate;
     }
   }
@@ -7608,10 +7722,54 @@ function loadRawConfig(explicitPath) {
   if (!configPath) {
     return {};
   }
-  const content = fs2.readFileSync(configPath, "utf8");
+  const content = fs3.readFileSync(configPath, "utf8");
   return YAML.parse(content) ?? {};
 }
 
+// src/config/provider-models.ts
+var OPENAI_MODELS = [
+  {
+    model: "gpt-5-nano",
+    label: "gpt-5-nano",
+    note: "default, cheapest, fast enough for most fallback passes",
+    isDefault: true
+  },
+  {
+    model: "gpt-5.4-nano",
+    label: "gpt-5.4-nano",
+    note: "newer nano backup, a touch smarter, a touch pricier"
+  },
+  {
+    model: "gpt-5-mini",
+    label: "gpt-5-mini",
+    note: "smarter fallback, still saner than the expensive stuff"
+  }
+];
+var OPENROUTER_MODELS = [
+  {
+    model: "openrouter/free",
+    label: "openrouter/free",
+    note: "default, free, a little slower sometimes, still hard to argue with free",
+    isDefault: true
+  },
+  {
+    model: "qwen/qwen3-coder:free",
+    label: "qwen/qwen3-coder:free",
+    note: "free, code-focused, good when you want a named coding fallback"
+  },
+  {
+    model: "deepseek/deepseek-r1:free",
+    label: "deepseek/deepseek-r1:free",
+    note: "free, stronger reasoning, usually slower"
+  }
+];
+function getProviderModelOptions(provider) {
+  return provider === "openrouter" ? OPENROUTER_MODELS : OPENAI_MODELS;
+}
+function getDefaultProviderModel(provider) {
+  return getProviderModelOptions(provider).find((option) => option.isDefault)?.model ?? getProviderModelOptions(provider)[0]?.model ?? "";
+}
+
 // src/config/provider-api-key.ts
 var OPENAI_COMPATIBLE_BASE_URL_ENV = [
   { prefix: "https://api.openai.com/", envName: "OPENAI_API_KEY" },
@@ -7666,6 +7824,11 @@ function resolveProviderApiKey(provider, baseUrl, env) {
 
 // src/config/schema.ts
 import { z as z3 } from "zod";
+var operationModeSchema = z3.enum([
+  "agent-escalation",
+  "provider-assisted",
+  "local-only"
+]);
 var providerNameSchema = z3.enum([
   "openai",
   "openai-compatible",
@@ -7718,6 +7881,7 @@ var inputConfigSchema = z3.object({
   tailChars: z3.number().int().positive()
 });
 var runtimeConfigSchema = z3.object({
+  operationMode: operationModeSchema,
   rawFallback: z3.boolean(),
   verbose: z3.boolean()
 });
@@ -7740,7 +7904,7 @@ var siftConfigSchema = z3.object({
 var PROVIDER_DEFAULT_OVERRIDES = {
   openrouter: {
     provider: {
-      model: "openrouter/free",
+      model: getDefaultProviderModel("openrouter"),
       baseUrl: "https://openrouter.ai/api/v1"
     }
   }
@@ -7780,13 +7944,16 @@ function stripApiKey(overrides) {
 }
 function buildNonCredentialEnvOverrides(env) {
   const overrides = {};
-  if (env.SIFT_PROVIDER || env.SIFT_MODEL || env.SIFT_BASE_URL || env.SIFT_TIMEOUT_MS) {
+  if (env.SIFT_PROVIDER || env.SIFT_MODEL || env.SIFT_BASE_URL || env.SIFT_TIMEOUT_MS || env.SIFT_OPERATION_MODE) {
     overrides.provider = {
       provider: env.SIFT_PROVIDER,
       model: env.SIFT_MODEL,
       baseUrl: env.SIFT_BASE_URL,
       timeoutMs: env.SIFT_TIMEOUT_MS ? Number(env.SIFT_TIMEOUT_MS) : void 0
     };
+    overrides.runtime = {
+      operationMode: env.SIFT_OPERATION_MODE
+    };
   }
   if (env.SIFT_MAX_INPUT_CHARS || env.SIFT_MAX_CAPTURE_CHARS) {
     overrides.input = {
@@ -7853,14 +8020,26 @@ function resolveConfig(options = {}) {
   );
   return siftConfigSchema.parse(merged);
 }
+function hasUsableProvider(config) {
+  return config.provider.apiKey !== void 0 && config.provider.apiKey.trim().length > 0;
+}
+function resolveEffectiveOperationMode(config) {
+  if (config.runtime.operationMode === "provider-assisted") {
+    return hasUsableProvider(config) ? "provider-assisted" : "agent-escalation";
+  }
+  return config.runtime.operationMode;
+}
 export {
   BoundedCapture,
   buildCommandPreview,
+  detectPackageManagerScriptKind,
   getExecSuccessShortcut,
   looksInteractivePrompt,
   mergeDefined,
   normalizeChildExitCode,
+  normalizeScriptWrapperOutput,
   resolveConfig,
+  resolveEffectiveOperationMode,
   runExec,
   runSift,
   runSiftWithStats,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bilalimamoglu/sift",
-  "version": "0.4.3",
-  "description": "Agent-first command-output reduction layer for agents, CI, and automation.",
+  "version": "0.4.5",
+  "description": "Local-first output guidance for coding agents working through noisy command output.",
   "type": "module",
   "bin": {
     "sift": "dist/cli.js"
@@ -17,6 +17,7 @@
   "engines": {
     "node": ">=20"
   },
+  "packageManager": "npm@11.8.0",
   "scripts": {
     "build": "tsup",
     "bench:history": "node --import tsx scripts/bench/generate-version-history.ts --since v0.3.0",
@@ -25,10 +26,17 @@
     "bench:report": "node --import tsx scripts/bench/generate-progress-report.ts",
     "dev": "tsx src/cli.ts",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
+    "test": "vitest run --config vitest.config.ts",
+    "test:smoke": "vitest run --config vitest.config.ts test/*.smoke.test.ts",
+    "test:e2e": "vitest run --config vitest.e2e.config.ts test/*.e2e.test.ts",
+    "test:coverage": "vitest run --config vitest.config.ts --coverage --exclude=\"test/**/*.smoke.test.ts\" --exclude=\"test/**/*.e2e.test.ts\"",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run typecheck && npm run test:coverage && npm run build"
+    "setup:hooks": "git config core.hooksPath .githooks",
+    "verify:release": "node scripts/release-gate.mjs --tier full",
+    "verify:release:clean": "node scripts/release-gate.mjs --tier clean",
+    "verify:release:core": "node scripts/release-gate.mjs --tier core",
+    "verify:release:e2e": "node scripts/release-gate.mjs --tier e2e",
+    "prepublishOnly": "node scripts/release-gate.mjs --tier full"
   },
   "keywords": [
     "cli",
@@ -37,6 +45,10 @@
     "automation",
     "terminal",
     "logs",
+    "debugging",
+    "heuristics",
+    "root-cause",
+    "test-failures",
     "ci",
     "json"
   ],