@hizliemre/horse-code 0.3.1 → 0.5.0

package/dist/research-WQYDF53R.js

@@ -0,0 +1,111 @@
+import {
+  createWebFetchTool,
+  readOnlyRegistry
+} from "./chunk-C3AOCIS2.js";
+import "./chunk-ZSQ24YDJ.js";
+import "./chunk-MZM24M5M.js";
+import {
+  defaultGitRunner
+} from "./chunk-LPQU436C.js";
+import "./chunk-LLJWUHI6.js";
+import "./chunk-PTOFSTLL.js";
+import "./chunk-63E73TGI.js";
+import "./chunk-6S4WWQMN.js";
+import {
+  runToCompletion
+} from "./chunk-FNUGG2FG.js";
+import "./chunk-ZPJP2VH5.js";
+import "./chunk-4M6LXNG2.js";
+import "./chunk-6W4UH2BQ.js";
+
+// src/engine/research.ts
+import { mkdir, writeFile } from "fs/promises";
+import { dirname, join, relative } from "path";
+import { existsSync } from "fs";
+var RESEARCH_MAX_TURNS = 120;
+function researchDir(trackedFiles2) {
+  const known = [/^docs\/research\//i, /^docs\/adr\//i, /^docs\/decisions\//i, /^research\//i, /^\.planning\//i];
+  for (const re of known) {
+    const hit = trackedFiles2.find((f) => re.test(f.replace(/\\/g, "/")));
+    if (hit) return dirname(hit.replace(/\\/g, "/"));
+  }
+  return "docs/research";
+}
+function reportName(title, now = /* @__PURE__ */ new Date()) {
+  const slug = (title || "research").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "").slice(0, 60);
+  const day = now.toISOString().slice(0, 10);
+  return `${day}-${slug || "research"}.md`;
+}
+var researchRule = "You are researching a question and writing ONE document. You are not changing this project: you have no tool that writes a file, and the report is your final answer \u2014 horse-code writes it down.\n\nGround the answer in THIS repository before anything else. Read the code that the question is about; a recommendation that ignores what is already here is a recommendation for a different project.\n\nThe document must contain, in this order:\n1. The question, restated in one or two sentences as you understood it.\n2. What this project does today in the area concerned, with file paths \u2014 the starting position.\n3. The options, one section each. For every option: how it would work here, what it costs, and what it rules out. An option nobody would pick is still worth a paragraph saying why not.\n4. A comparison table across the dimensions that actually decide this one. Choose the dimensions from the question rather than from habit.\n5. A recommendation, with the condition that would change it. A recommendation that nothing could overturn is a preference wearing a suit.\n6. What you could not establish, and what it would take to settle. Say it plainly \u2014 an unexamined assumption presented as a finding is the one failure this document cannot recover from.\n\nWrite markdown. Cite file paths for claims about this project and URLs for claims about the world. Where you are reasoning from your own knowledge rather than from something you read, say so.";
+async function runResearch(opts) {
+  const { deps, workdir } = opts;
+  const dir = researchDir(opts.trackedFiles ?? await trackedFiles(workdir));
+  const rel = join(dir, reportName(opts.title));
+  const tools = readOnlyRegistry(deps, { remember: true });
+  tools.register(createWebFetchTool());
+  const language = opts.language ? `
+
+Write the document in ${opts.language}. Keep file paths, identifiers and URLs exactly as they are.` : "";
+  const rules = deps.roleRegistry.ruleSuffix();
+  const last = await runToCompletion({
+    ...deps.roleRegistry.fallbackOpts("analyst"),
+    systemPrompt: researchRule + language + rules,
+    messages: [{ role: "user", content: opts.prompt }],
+    tools,
+    maxTurns: RESEARCH_MAX_TURNS,
+    provider: deps.provider,
+    permission: deps.permission,
+    approve: deps.approve,
+    cwd: workdir,
+    signal: deps.signal,
+    onActivity: deps.onActivity,
+    onLiveActivity: deps.onLiveActivity,
+    inbox: deps.inbox,
+    ...opts.note ? { onSay: opts.note } : {}
+  });
+  const body = (last.content ?? "").trim();
+  if (!body) return { reportPath: rel, written: false, committed: false };
+  const abs = join(workdir, rel);
+  await mkdir(dirname(abs), { recursive: true });
+  await writeFile(abs, `${body}
+`, "utf8");
+  return { reportPath: rel, written: true, committed: await commitReport(workdir, rel, opts.title) };
+}
+async function trackedFiles(cwd) {
+  try {
+    const r = await defaultGitRunner(["ls-files"], cwd);
+    return r.code === 0 ? r.stdout.split("\n").filter(Boolean) : [];
+  } catch {
+    return [];
+  }
+}
+async function commitReport(workdir, rel, title) {
+  if (!existsSync(join(workdir, ".git")) && !existsSync(join(workdir, rel))) return false;
+  const add = await defaultGitRunner(["add", "--", rel], workdir);
+  if (add.code !== 0) return false;
+  const staged = await defaultGitRunner(["diff", "--cached", "--quiet", "--", rel], workdir);
+  if (staged.code === 0) return false;
+  const r = await defaultGitRunner(["commit", "-m", `docs(research): ${title || "findings"}`, "--", rel], workdir);
+  return r.code === 0;
+}
+function describeResearch(r, branch) {
+  if (!r.written) return "The research produced no document \u2014 nothing was written.";
+  const where = r.committed ? `Committed on \`${branch}\`.` : "Written, but not committed \u2014 it is in the working tree.";
+  return `\u{1F4C4} **Research report:** \`${r.reportPath}\`
+${where}
+
+_No code was changed: the lane runs without a write tool at all._`;
+}
+function plannedPath(title, trackedFiles2) {
+  return relative(".", join(researchDir(trackedFiles2), reportName(title))).replace(/\\/g, "/");
+}
+export {
+  RESEARCH_MAX_TURNS,
+  commitReport,
+  describeResearch,
+  plannedPath,
+  reportName,
+  researchDir,
+  researchRule,
+  runResearch
+};

package/dist/{save-skills-NPKTYNAF.js → save-skills-7M3XUKMK.js}

@@ -3,9 +3,9 @@ import {
   saveMcpServer,
   saveRoleSkills,
   saveSkillSource
-} from "./chunk-JR2JLRE3.js";
+} from "./chunk-KFB5H4HX.js";
 import "./chunk-H2FDGPVW.js";
-import "./chunk-G45RWL7S.js";
+import "./chunk-PEAZQPEZ.js";
 export {
   removeSkillSource,
   saveMcpServer,

package/dist/{trace-run-CZWEZ4R6.js → trace-run-YJNCJPU4.js}

@@ -1,4 +1,5 @@
 import {
+  ColdStartGate,
   SpentSources,
   TRACE_CONCURRENCY,
   buildBrief,
@@ -7,15 +8,17 @@ import {
   planFor,
   runTraces,
   traceableFiles
-} from "./chunk-YULQ4URQ.js";
-import "./chunk-G45RWL7S.js";
+} from "./chunk-UKIIQD6Q.js";
+import "./chunk-MZM24M5M.js";
+import "./chunk-PEAZQPEZ.js";
 import "./chunk-LPQU436C.js";
 import "./chunk-6S4WWQMN.js";
-import "./chunk-JLWQCA7B.js";
+import "./chunk-FNUGG2FG.js";
 import "./chunk-ZPJP2VH5.js";
 import "./chunk-4M6LXNG2.js";
 import "./chunk-6W4UH2BQ.js";
 export {
+  ColdStartGate,
   SpentSources,
   TRACE_CONCURRENCY,
   buildBrief,

package/dist/{triage-IFCVL5MA.js → triage-ELDGP3JC.js}

@@ -8,12 +8,12 @@ import {
   describeSizeDoubt,
   sizeRequest,
   triageFinding
-} from "./chunk-372X5HHU.js";
-import "./chunk-BFIZMM4G.js";
+} from "./chunk-J6P3CXUR.js";
+import "./chunk-LLJWUHI6.js";
+import "./chunk-PTOFSTLL.js";
 import "./chunk-63E73TGI.js";
-import "./chunk-CYLPQWIF.js";
 import "./chunk-6S4WWQMN.js";
-import "./chunk-JLWQCA7B.js";
+import "./chunk-FNUGG2FG.js";
 import "./chunk-ZPJP2VH5.js";
 import "./chunk-4M6LXNG2.js";
 import "./chunk-6W4UH2BQ.js";

package/dist/{verify-HWZBTK5X.js → verify-5CSN24AE.js}

@@ -3,41 +3,44 @@ import {
   describeFix,
   dirtyPaths,
   runFix
-} from "./chunk-3ACDNDCG.js";
+} from "./chunk-ST6LIEPZ.js";
 import {
   respondIn
 } from "./chunk-M2RKCIGV.js";
+import {
+  askInUserLanguage,
+  inUserLanguage
+} from "./chunk-DCK2QQ2S.js";
 import {
   buildAskUserTool,
+  editFileTool,
+  refreshAfterChange,
+  shellTool,
+  writeFileTool
+} from "./chunk-M2RP2AGC.js";
+import {
   buildRememberTool,
   constitutionNote,
   createWebFetchTool,
   deferMcp,
-  editFileTool,
   featureSlugFor,
   gitTool,
-  refreshAfterChange,
-  shellTool,
   specsDir,
-  verifyPaths,
-  writeFileTool
-} from "./chunk-27F44PBD.js";
-import {
-  askInUserLanguage,
-  inUserLanguage
-} from "./chunk-UTHLEW5V.js";
+  verifyPaths
+} from "./chunk-C3AOCIS2.js";
 import "./chunk-ZSQ24YDJ.js";
+import "./chunk-UKIIQD6Q.js";
 import {
   buildSkillTool
-} from "./chunk-YULQ4URQ.js";
-import "./chunk-G45RWL7S.js";
+} from "./chunk-MZM24M5M.js";
+import "./chunk-PEAZQPEZ.js";
 import {
   defaultGitRunner
 } from "./chunk-LPQU436C.js";
 import {
   describeEscalation,
   triageFinding
-} from "./chunk-372X5HHU.js";
+} from "./chunk-J6P3CXUR.js";
 import {
   BATCH_TOOLS_NOTE,
   contextTools,
@@ -47,16 +50,16 @@ import {
   projectToolsNote,
   readFileTool,
   reinforceUsed
-} from "./chunk-BFIZMM4G.js";
-import "./chunk-63E73TGI.js";
+} from "./chunk-LLJWUHI6.js";
 import {
   ToolRegistry
-} from "./chunk-CYLPQWIF.js";
+} from "./chunk-PTOFSTLL.js";
+import "./chunk-63E73TGI.js";
 import "./chunk-6S4WWQMN.js";
 import {
   handedOver,
   runToCompletion
-} from "./chunk-JLWQCA7B.js";
+} from "./chunk-FNUGG2FG.js";
 import "./chunk-ZPJP2VH5.js";
 import {
   loadGraphSync

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hizliemre/horse-code",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "description": "Terminal coding agent: one sentence to reviewed, committed code — in its own git worktree",
   "license": "MIT",
   "author": "Emre Hızlı <hizliemre@gmail.com>",

package/dist/{chunk-JLWQCA7B.js → chunk-FNUGG2FG.js}

@@ -2,86 +2,6 @@ import {
   sessionBase
 } from "./chunk-6W4UH2BQ.js";
 
-// src/tui/format.ts
-function fmtTokens(n) {
-  if (n >= 1e9) return `${(n / 1e9).toFixed(1)}B`;
-  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
-  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
-  return String(n);
-}
-function fmtDuration(ms) {
-  const s = Math.max(0, Math.round(ms / 1e3));
-  if (s < 60) return `${s}s`;
-  return `${Math.floor(s / 60)}m ${String(s % 60).padStart(2, "0")}s`;
-}
-function relTime(then, now = Date.now()) {
-  const s = Math.max(0, Math.round((now - then) / 1e3));
-  if (s < 60) return "just now";
-  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
-  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
-  return `${Math.floor(s / 86400)}d ago`;
-}
-function stripThinking(text) {
-  let out = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
-  const lastClose = out.toLowerCase().lastIndexOf("</think>");
-  if (lastClose !== -1 && !/<think>/i.test(out.slice(0, lastClose))) {
-    out = out.slice(lastClose + "</think>".length);
-  }
-  const open = out.toLowerCase().lastIndexOf("<think>");
-  if (open !== -1) out = out.slice(0, open).trimEnd();
-  return out.trimStart();
-}
-
-// src/agent/attach.ts
-import { readFileSync, statSync } from "fs";
-import { isAbsolute, resolve } from "path";
-import { homedir } from "os";
-var IMAGE_EXT = {
-  png: "image/png",
-  jpg: "image/jpeg",
-  jpeg: "image/jpeg",
-  gif: "image/gif",
-  webp: "image/webp"
-};
-var MAX_IMAGE_BYTES = 5e6;
-var CANDIDATE = /(?:"([^"\n]+?\.(?:png|jpe?g|gif|webp))"|'([^'\n]+?\.(?:png|jpe?g|gif|webp))'|((?:~|\.{0,2}\/|[A-Za-z0-9_.-]+\/)[^\n"'`]*?\.(?:png|jpe?g|gif|webp)))/gi;
-function expand(p, cwd) {
-  const t = p.trim();
-  if (t.startsWith("~/")) return resolve(homedir(), t.slice(2));
-  return isAbsolute(t) ? t : resolve(cwd, t);
-}
-function attachedImages(text, cwd) {
-  const out = [];
-  const seen = /* @__PURE__ */ new Set();
-  for (const m of text.matchAll(CANDIDATE)) {
-    const raw = m[1] ?? m[2] ?? m[3];
-    if (!raw) continue;
-    if (/^[a-z]+:\/\//i.test(raw)) continue;
-    const abs = expand(raw, cwd);
-    if (seen.has(abs)) continue;
-    const ext = abs.slice(abs.lastIndexOf(".") + 1).toLowerCase();
-    const mime = IMAGE_EXT[ext];
-    if (!mime) continue;
-    try {
-      const st = statSync(abs);
-      if (!st.isFile() || st.size > MAX_IMAGE_BYTES || st.size === 0) continue;
-      out.push(`data:${mime};base64,${readFileSync(abs).toString("base64")}`);
-      seen.add(abs);
-    } catch {
-    }
-  }
-  return out;
-}
-var OWN_PASTE = /\S*[\\/]\.horsecode[\\/]pastes[\\/][^\s"'`)\]]+\.(?:png|jpe?g|gif|webp)/gi;
-var HANDED_OVER = "[screenshot pasted by the developer]";
-function withoutPastePaths(text) {
-  return text.replace(OWN_PASTE, HANDED_OVER);
-}
-function handedOver(text, cwd) {
-  const images = attachedImages(text, cwd);
-  return { content: withoutPastePaths(text), ...images.length ? { images } : {} };
-}
-
 // src/obs/telemetry.ts
 import { AsyncLocalStorage } from "async_hooks";
 import { randomBytes } from "crypto";
@@ -227,6 +147,86 @@ function telemetry() {
   return active;
 }
 
+// src/tui/format.ts
+function fmtTokens(n) {
+  if (n >= 1e9) return `${(n / 1e9).toFixed(1)}B`;
+  if (n >= 1e6) return `${(n / 1e6).toFixed(1)}M`;
+  if (n >= 1e3) return `${(n / 1e3).toFixed(1)}k`;
+  return String(n);
+}
+function fmtDuration(ms) {
+  const s = Math.max(0, Math.round(ms / 1e3));
+  if (s < 60) return `${s}s`;
+  return `${Math.floor(s / 60)}m ${String(s % 60).padStart(2, "0")}s`;
+}
+function relTime(then, now = Date.now()) {
+  const s = Math.max(0, Math.round((now - then) / 1e3));
+  if (s < 60) return "just now";
+  if (s < 3600) return `${Math.floor(s / 60)}m ago`;
+  if (s < 86400) return `${Math.floor(s / 3600)}h ago`;
+  return `${Math.floor(s / 86400)}d ago`;
+}
+function stripThinking(text) {
+  let out = text.replace(/<think>[\s\S]*?<\/think>/gi, "");
+  const lastClose = out.toLowerCase().lastIndexOf("</think>");
+  if (lastClose !== -1 && !/<think>/i.test(out.slice(0, lastClose))) {
+    out = out.slice(lastClose + "</think>".length);
+  }
+  const open = out.toLowerCase().lastIndexOf("<think>");
+  if (open !== -1) out = out.slice(0, open).trimEnd();
+  return out.trimStart();
+}
+
+// src/agent/attach.ts
+import { readFileSync, statSync } from "fs";
+import { isAbsolute, resolve } from "path";
+import { homedir } from "os";
+var IMAGE_EXT = {
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp"
+};
+var MAX_IMAGE_BYTES = 5e6;
+var CANDIDATE = /(?:"([^"\n]+?\.(?:png|jpe?g|gif|webp))"|'([^'\n]+?\.(?:png|jpe?g|gif|webp))'|((?:~|\.{0,2}\/|[A-Za-z0-9_.-]+\/)[^\n"'`]*?\.(?:png|jpe?g|gif|webp)))/gi;
+function expand(p, cwd) {
+  const t = p.trim();
+  if (t.startsWith("~/")) return resolve(homedir(), t.slice(2));
+  return isAbsolute(t) ? t : resolve(cwd, t);
+}
+function attachedImages(text, cwd) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const m of text.matchAll(CANDIDATE)) {
+    const raw = m[1] ?? m[2] ?? m[3];
+    if (!raw) continue;
+    if (/^[a-z]+:\/\//i.test(raw)) continue;
+    const abs = expand(raw, cwd);
+    if (seen.has(abs)) continue;
+    const ext = abs.slice(abs.lastIndexOf(".") + 1).toLowerCase();
+    const mime = IMAGE_EXT[ext];
+    if (!mime) continue;
+    try {
+      const st = statSync(abs);
+      if (!st.isFile() || st.size > MAX_IMAGE_BYTES || st.size === 0) continue;
+      out.push(`data:${mime};base64,${readFileSync(abs).toString("base64")}`);
+      seen.add(abs);
+    } catch {
+    }
+  }
+  return out;
+}
+var OWN_PASTE = /\S*[\\/]\.horsecode[\\/]pastes[\\/][^\s"'`)\]]+\.(?:png|jpe?g|gif|webp)/gi;
+var HANDED_OVER = "[screenshot pasted by the developer]";
+function withoutPastePaths(text) {
+  return text.replace(OWN_PASTE, HANDED_OVER);
+}
+function handedOver(text, cwd) {
+  const images = attachedImages(text, cwd);
+  return { content: withoutPastePaths(text), ...images.length ? { images } : {} };
+}
+
 // src/agent/recall.ts
 var RECALLABLE = /* @__PURE__ */ new Set(["read_file", "grep", "glob", "graph_trace", "graph_find", "graph_context"]);
 var INVALIDATING = /* @__PURE__ */ new Set(["write_file", "edit_file"]);
@@ -1161,12 +1161,6 @@ async function runToCompletion(opts) {
 }
 
 export {
-  fmtTokens,
-  fmtDuration,
-  relTime,
-  stripThinking,
-  handedOver,
-  truncateSafe,
   Telemetry,
   sampleMemory,
   estimateFreezeSeconds,
@@ -1174,6 +1168,12 @@ export {
   clearPerfMarks,
   setTelemetry,
   telemetry,
+  fmtTokens,
+  fmtDuration,
+  relTime,
+  stripThinking,
+  handedOver,
+  truncateSafe,
   redactSecrets,
   runRoleAgent,
   runToCompletion