@bilalimamoglu/sift 0.4.4 → 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

@@ -5161,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}`),
     "",
@@ -7279,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) {
@@ -7365,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;
@@ -7390,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) {
@@ -7416,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}
@@ -7463,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:",
@@ -7486,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) {
@@ -7516,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}
@@ -7560,6 +7648,7 @@ var defaultConfig = {
     tailChars: 2e4
   },
   runtime: {
+    operationMode: "agent-escalation",
     rawFallback: true,
     verbose: false
   },
@@ -7637,6 +7726,50 @@ function loadRawConfig(explicitPath) {
   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" },
@@ -7691,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",
@@ -7743,6 +7881,7 @@ var inputConfigSchema = z3.object({
   tailChars: z3.number().int().positive()
 });
 var runtimeConfigSchema = z3.object({
+  operationMode: operationModeSchema,
   rawFallback: z3.boolean(),
   verbose: z3.boolean()
 });
@@ -7765,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"
     }
   }
@@ -7805,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 = {
@@ -7878,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.4",
-  "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",
@@ -30,7 +31,12 @@
     "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",
@@ -39,6 +45,10 @@
     "automation",
     "terminal",
     "logs",
+    "debugging",
+    "heuristics",
+    "root-cause",
+    "test-failures",
     "ci",
     "json"
   ],