@bilalimamoglu/sift 0.5.0 → 0.5.1

package/dist/cli.js

@@ -24,6 +24,9 @@ function getDefaultCodexGlobalSkillPath(homeDir = os.homedir()) {
 function getDefaultCursorGlobalSkillPath(homeDir = os.homedir()) {
   return path.join(homeDir, ".cursor", "skills", "sift", "SKILL.md");
 }
+function getDefaultCopilotInstructionsPath(cwd = process.cwd()) {
+  return path.join(cwd, ".github", "copilot-instructions.md");
+}
 function getDefaultClaudeGlobalInstructionsPath(homeDir = os.homedir()) {
   return path.join(homeDir, ".claude", "CLAUDE.md");
 }
@@ -762,6 +765,7 @@ function describeInsufficientBehavior(mode) {
 import { execFileSync } from "child_process";
 import { clearScreenDown, cursorTo, moveCursor } from "readline";
 import { stdin as defaultStdin } from "process";
+import stripAnsi from "strip-ansi";
 var PROMPT_BACK = "__sift_back__";
 var PROMPT_BACK_LABEL = "\u2190 Back";
 function color(text, rgb, args = {}) {
@@ -849,6 +853,16 @@ function styleOption(option, selected, colorize) {
     dim: !selected && Boolean(palette.dimWhenIdle)
   })}${trailing}`;
 }
+function getTerminalColumns(stream) {
+  return typeof stream.columns === "number" && stream.columns > 0 ? stream.columns : 80;
+}
+function getVisualLineCount(line, columns) {
+  const visibleLength = stripAnsi(line).length;
+  return Math.max(1, Math.ceil(visibleLength / columns));
+}
+function getVisualBlockHeight(lines, columns) {
+  return lines.reduce((total, line) => total + getVisualLineCount(line, columns), 0);
+}
 function setPosixEcho(enabled) {
   const command = enabled ? "echo" : "-echo";
   try {
@@ -902,7 +916,7 @@ async function promptSelect(args) {
     });
     output.write(`${lines.join("\n")}
 `);
-    previousLineCount = lines.length;
+    previousLineCount = getVisualBlockHeight(lines, getTerminalColumns(stream));
   };
   const cleanup = (selected) => {
     if (previousLineCount > 0) {
@@ -9629,11 +9643,11 @@ function buildSafetyStderrNotice(report) {
 }
 
 // src/core/sanitize.ts
-import stripAnsi from "strip-ansi";
+import stripAnsi2 from "strip-ansi";
 function sanitizeInput(input, stripAnsiEnabled) {
   let output = input;
   if (stripAnsiEnabled) {
-    output = stripAnsi(output);
+    output = stripAnsi2(output);
   }
   return output.replace(/\r\n/g, "\n").replace(/\r/g, "\n").replace(/\u0000/g, "").replace(/[ \t]+\n/g, "\n").replace(/\n{3,}/g, "\n\n").trim();
 }
@@ -12262,6 +12276,7 @@ async function runHook(args, deps = defaultHookDeps) {
 }
 
 // src/commands/install.ts
+import fs9 from "fs";
 import os5 from "os";
 import path10 from "path";
 import { emitKeypressEvents as emitKeypressEvents2 } from "readline";
@@ -12271,10 +12286,42 @@ import {
   stdin as defaultStdin4,
   stdout as defaultStdout3
 } from "process";
+
+// src/runtime-payloads/copilot-instructions.ts
+var COPILOT_INSTRUCTIONS_MARKER = "<!-- sift:generated copilot-instructions -->";
+function renderCopilotInstructions() {
+  return [
+    COPILOT_INSTRUCTIONS_MARKER,
+    "",
+    "# Sift",
+    "",
+    "Use `sift` as the first pass when command output is long, noisy, and non-interactive.",
+    "The goal is to turn failure walls into grouped issues, likely root causes, and the next useful step before reading raw logs.",
+    "",
+    "## Repository Guidance",
+    "",
+    "- Start with `sift exec` before reading raw logs when the output is long or noisy.",
+    "- For test failure walls, prefer `sift exec --preset test-status -- <test command>` first.",
+    "- If `standard` already shows the root cause, stop there and read the relevant source instead of chasing more output.",
+    "- After a fix, use `sift rerun` to refresh the same test suite and confirm what changed.",
+    "- Keep edits focused and update tests when behavior changes.",
+    "- Prefer the existing repo conventions in nearby code before introducing new patterns.",
+    "- Keep generated sift-owned files intact; do not hand-edit them unless you are intentionally changing the generator.",
+    "- Run `npm test` and `npm run typecheck` before handing off code changes.",
+    "",
+    "## Notes",
+    "",
+    "- This repository uses `sift` as the CLI runtime and `copilot-instructions.md` as a repo-wide guidance surface for Copilot.",
+    "- The instructions are intentionally short so they stay useful instead of becoming another wall of text."
+  ].join("\n");
+}
+
+// src/commands/install.ts
 var INSTALL_TITLES = {
   codex: "Codex",
   claude: "Claude",
-  cursor: "Cursor"
+  cursor: "Cursor",
+  copilot: "Copilot"
 };
 function createInstallTerminalIO() {
   let rl;
@@ -12321,10 +12368,10 @@ function normalizeInstallRuntime(value) {
   if (value === void 0 || value === null || value === "") {
     return void 0;
   }
-  if (value === "codex" || value === "claude" || value === "cursor" || value === "all") {
+  if (value === "codex" || value === "claude" || value === "cursor" || value === "copilot" || value === "all") {
     return value;
   }
-  throw new Error("Invalid runtime. Use codex, claude, cursor, or all.");
+  throw new Error("Invalid runtime. Use codex, claude, cursor, copilot, or all.");
 }
 function normalizeInstallScope(value) {
   if (value === void 0 || value === null || value === "") {
@@ -12375,15 +12422,43 @@ function getLocalTargetLabel(runtime, cwd = process.cwd()) {
   if (runtime === "claude") {
     return path10.join(cwd, "CLAUDE.md");
   }
+  if (runtime === "copilot") {
+    return getDefaultCopilotInstructionsPath(cwd);
+  }
   return path10.join(cwd, ".cursor", "skills", "sift", "SKILL.md");
 }
 function describeScopeChoice(args) {
   const targets = getInstallTargets(args.runtime);
   const labels = targets.map(
-    (agent) => args.scope === "global" ? getGlobalTargetLabel(agent, args.homeDir) : getLocalTargetLabel(agent, args.cwd)
+    (agent) => args.runtime === "copilot" ? getLocalTargetLabel("copilot", args.cwd) : args.scope === "global" ? getGlobalTargetLabel(agent, args.homeDir) : getLocalTargetLabel(agent, args.cwd)
   );
   return labels.join(" + ");
 }
+function getCopilotInstructionsTargetPath(cwd) {
+  return getDefaultCopilotInstructionsPath(cwd ?? process.cwd());
+}
+function inspectCopilotInstructionsOwnership(content) {
+  if (content === void 0) {
+    return "missing";
+  }
+  return content.includes("<!-- sift:generated copilot-instructions -->") ? "managed" : "custom";
+}
+function readOptionalFile2(targetPath) {
+  if (!fs9.existsSync(targetPath)) {
+    return void 0;
+  }
+  const stats = fs9.statSync(targetPath);
+  if (!stats.isFile()) {
+    throw new Error(`${targetPath} exists but is not a file.`);
+  }
+  return fs9.readFileSync(targetPath, "utf8");
+}
+function writeTextFileAtomic3(targetPath, content) {
+  fs9.mkdirSync(path10.dirname(targetPath), { recursive: true });
+  const tempPath = `${targetPath}.tmp-${process.pid}-${Date.now()}`;
+  fs9.writeFileSync(tempPath, content, "utf8");
+  fs9.renameSync(tempPath, targetPath);
+}
 async function promptWithMenu(args) {
   const defaultIndex = args.defaultIndex ?? 0;
   if (args.io.select) {
@@ -12449,6 +12524,10 @@ async function promptForRuntime(io) {
         label: "Cursor  (.cursor/skills/sift/SKILL.md / ~/.cursor/skills/sift/SKILL.md) - native skill path for Cursor without inventing a second runtime",
         value: "cursor"
       },
+      {
+        label: "Copilot (.github/copilot-instructions.md) - repository instructions for GitHub Copilot, repo-only by design",
+        value: "copilot"
+      },
       {
         label: "All      - Codex + Claude together if you refuse to pick favorites today",
         value: "all"
@@ -12522,12 +12601,6 @@ function writeSuccessSummary(args) {
   const ui = createPresentation(args.io.stdoutIsTTY);
   const targets = getInstallTargets(args.runtime);
   const scopeLabel = args.scope === "global" ? "global" : "local";
-  const targetLabel = describeScopeChoice({
-    runtime: args.runtime,
-    scope: args.scope,
-    cwd: args.cwd,
-    homeDir: args.homeDir
-  });
   if (args.io.stdoutIsTTY) {
     args.io.write(`
 ${ui.success("Installed runtime support.")}
@@ -12535,6 +12608,33 @@ ${ui.success("Installed runtime support.")}
   } else {
     args.io.write("Installed runtime support.\n");
   }
+  if (targets.includes("copilot")) {
+    const targetLabel2 = getCopilotInstructionsTargetPath(args.cwd);
+    args.io.write(`${ui.note("Copilot instructions installed for this repository.")}
+`);
+    args.io.write(`${ui.note(`Repo-local instructions live at ${targetLabel2}.`)}
+`);
+    args.io.write(`${ui.note("Copilot is repo-only here; there is no global install target.")}
+`);
+    args.io.write(`
+${ui.section("Try next")}
+`);
+    args.io.write(`  ${ui.command("sift exec --preset test-status -- pytest -q")}${ui.note("  # default first pass")}
+`);
+    args.io.write(`  ${ui.command("sift doctor")}${ui.note("  # verify the setup and see what happens on ambiguous cases")}
+`);
+    args.io.write(`${ui.note(getDefaultExecPathLine())}
+`);
+    args.io.write(`${ui.note(getHookBetaLine())}
+`);
+    return;
+  }
+  const targetLabel = describeScopeChoice({
+    runtime: args.runtime,
+    scope: args.scope,
+    cwd: args.cwd,
+    homeDir: args.homeDir
+  });
   args.io.write(
     `${ui.note(`Runtime instructions installed for ${targets.map((target) => INSTALL_TITLES[target]).join(" + ")} in ${scopeLabel} scope.`)}
 `
@@ -12589,6 +12689,21 @@ ${ui.section("Try next")}
 function writePreflightSummary(args) {
   const ui = createPresentation(args.io.stdoutIsTTY);
   const runtimeTargets = getInstallTargets(args.runtime);
+  if (runtimeTargets.includes("copilot")) {
+    const targetPath = getCopilotInstructionsTargetPath(args.cwd);
+    args.io.write(`
+${ui.section("Install preflight")}
+`);
+    args.io.write(`${ui.note("Will write repo-local instructions for GitHub Copilot:")}
+`);
+    args.io.write(`  ${ui.command(targetPath)}
+`);
+    args.io.write(`${ui.note("Will not write shell rc files, PATH entries, git hooks, or arbitrary repo files.")}
+`);
+    args.io.write(`${ui.note("Managed files update only when sift can prove ownership.")}
+`);
+    return;
+  }
   const writeTargets = runtimeTargets.flatMap((runtime) => {
     if (runtime === "codex") {
       return [
@@ -12636,6 +12751,7 @@ ${ui.section("Install preflight")}
 }
 async function installRuntimeSupport(options) {
   const io = options.io ?? createInstallTerminalIO();
+  const runtimeIsCopilot = options.runtime === "copilot";
   const getPreviousEditableStep = (step) => {
     if (step === "runtime") {
       return void 0;
@@ -12667,9 +12783,13 @@ async function installRuntimeSupport(options) {
     return void 0;
   };
   try {
-    if ((!io.stdinIsTTY || !io.stdoutIsTTY) && (!options.runtime || !options.scope || !options.yes)) {
+    if (runtimeIsCopilot && options.scope === "global") {
+      io.error("sift install copilot is repo-only. Use `sift install copilot --scope local` or omit --scope.\n");
+      return 1;
+    }
+    if ((!io.stdinIsTTY || !io.stdoutIsTTY) && (!options.runtime || !runtimeIsCopilot && !options.scope || !options.yes)) {
       io.error(
-        "sift install is interactive and requires a TTY. For non-interactive use `sift install codex --scope global --yes`.\n"
+        "sift install is interactive and requires a TTY. For non-interactive use `sift install codex --scope global --yes` or `sift install copilot --yes`.\n"
       );
       return 1;
     }
@@ -12681,17 +12801,24 @@ async function installRuntimeSupport(options) {
     let operationMode = options.operationMode;
     let scope = options.scope;
     let step;
+    if (runtime === "copilot") {
+      scope = "repo";
+      operationMode ??= "agent-escalation";
+    }
     if (!io.stdinIsTTY || !io.stdoutIsTTY) {
       runtime ??= options.runtime;
       operationMode ??= "agent-escalation";
+      if (runtime === "copilot") {
+        scope = "repo";
+      }
       step = void 0;
     } else if (!runtime) {
       step = "runtime";
-    } else if (!operationMode) {
+    } else if (runtime !== "copilot" && !operationMode) {
       step = "mode";
-    } else if (!scope) {
+    } else if (runtime !== "copilot" && !scope) {
       step = "scope";
-    } else if (operationMode === "provider-assisted") {
+    } else if (runtime !== "copilot" && operationMode === "provider-assisted") {
       step = "provider";
     }
     while (step) {
@@ -12704,6 +12831,12 @@ ${createPresentation(io.stdoutIsTTY).note("Install canceled before we touched an
           return 0;
         }
         runtime = runtimeChoice;
+        if (runtime === "copilot") {
+          scope = "repo";
+          operationMode ??= "agent-escalation";
+          step = void 0;
+          continue;
+        }
         step = !operationMode ? "mode" : !scope ? "scope" : operationMode === "provider-assisted" ? "provider" : void 0;
         continue;
       }
@@ -12754,41 +12887,81 @@ ${createPresentation(io.stdoutIsTTY).note("Install canceled before we touched an
         step = operationMode === "provider-assisted" ? "provider" : void 0;
         continue;
       }
-      if (scope === "repo") {
-        io.write(
-          `
+      if (step === "provider") {
+        if (scope === "repo") {
+          io.write(
+            `
 ${createPresentation(io.stdoutIsTTY).note("Local only applies to the runtime instructions in this repo. Provider fallback config is still machine-wide so sift can reuse it anywhere.")}
 `
-        );
-      }
-      io.write(`
+          );
+        }
+        io.write(`
 ${createPresentation(io.stdoutIsTTY).info("Next: provider setup. Press Esc at any step to go back.")}
 `);
-      const setupStatus = await configSetup({
-        io,
-        env: process.env,
-        embedded: true,
-        forcedMode: "provider-assisted",
-        targetPath: getDefaultGlobalConfigPath(options.homeDir)
-      });
-      if (setupStatus === CONFIG_SETUP_BACK) {
-        const previous = getPreviousEditableStep("provider");
-        if (!previous) {
-          io.write(`
+        const setupStatus = await configSetup({
+          io,
+          env: process.env,
+          embedded: true,
+          forcedMode: "provider-assisted",
+          targetPath: getDefaultGlobalConfigPath(options.homeDir)
+        });
+        if (setupStatus === CONFIG_SETUP_BACK) {
+          const previous = getPreviousEditableStep("provider");
+          if (!previous) {
+            io.write(`
 ${createPresentation(io.stdoutIsTTY).note("Install canceled before we touched anything.")}
 `);
-          return 0;
+            return 0;
+          }
+          step = previous;
+          continue;
+        }
+        if (setupStatus !== 0) {
+          return setupStatus;
         }
-        step = previous;
+        step = void 0;
         continue;
       }
-      if (setupStatus !== 0) {
-        return setupStatus;
-      }
-      step = void 0;
     }
     const nestedIo = createNestedInstallIO(io);
+    if (runtime === "copilot") {
+      const targetPath = getCopilotInstructionsTargetPath(options.cwd);
+      const existingContent = readOptionalFile2(targetPath);
+      const ownership = inspectCopilotInstructionsOwnership(existingContent);
+      if (ownership === "custom") {
+        io.error(
+          `Refusing to overwrite a custom copilot-instructions.md at ${targetPath}. Move it, remove it manually, or choose a different target path.
+`
+        );
+        return 1;
+      }
+      if (io.stdoutIsTTY) {
+        writePreflightSummary({
+          io,
+          runtime,
+          scope: "repo",
+          operationMode: operationMode ?? "agent-escalation",
+          cwd: options.cwd,
+          homeDir: options.homeDir
+        });
+      }
+      writeTextFileAtomic3(targetPath, `${renderCopilotInstructions()}
+`);
+      writeSuccessSummary({
+        io,
+        version: options.version,
+        runtime,
+        scope: "repo",
+        operationMode: operationMode ?? "agent-escalation",
+        cwd: options.cwd,
+        homeDir: options.homeDir
+      });
+      return 0;
+    }
     for (const runtimeTarget of getInstallTargets(runtime)) {
+      if (runtimeTarget === "copilot") {
+        continue;
+      }
       const status = runtimeTarget === "cursor" ? await installSkill({
         runtime: "cursor",
         scope,
@@ -13881,7 +14054,7 @@ function createCliApp(args = {}) {
     stdout.write(`${output}
 `);
   });
-  cli.command("install [runtime]", "Interactive runtime installer for Codex, Claude, and tiny Cursor packaging").usage("install [runtime] [options]").example("install").example("install codex").example("install cursor").example("install codex --scope global --yes").example("install all --scope local --yes").option("--scope <scope>", "Install scope: local | global").option("--yes", "Skip prompts when runtime and scope are already provided").action(async (runtime, options) => {
+  cli.command("install [runtime]", "Interactive runtime installer for Codex, Claude, Cursor, and Copilot repo instructions").usage("install [runtime] [options]").example("install").example("install codex").example("install cursor").example("install copilot").example("install codex --scope global --yes").example("install all --scope local --yes").option("--scope <scope>", "Install scope: local | global").option("--yes", "Skip prompts when runtime and scope are already provided").action(async (runtime, options) => {
     process.exitCode = await deps.installRuntimeSupport({
       runtime: normalizeInstallRuntime(runtime),
       scope: normalizeInstallScope(options.scope),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilalimamoglu/sift",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Local-first output guidance for coding agents working through noisy command output.",
   "type": "module",
   "bin": {