@kmugalkhod/lightcode 0.4.0 → 0.5.0

package/README.md

@@ -6,6 +6,19 @@ permission-gated tool suite (files, shell, git, web, MCP), and tiered context
 optimization that keeps long sessions inside the model's context window
 without ever losing history.
 
+## Install
+
+```bash
+npm install -g @kmugalkhod/lightcode
+lightcode
+```
+
+Works on macOS (Apple Silicon and Intel), Linux, and Windows. Bun ships with
+the package, so there's nothing else to install — the first `lightcode` run
+uses the bundled runtime automatically (and reuses a system Bun if you already
+have one). The published package is scoped as `@kmugalkhod/lightcode`; the
+command it installs is `lightcode`.
+
 ## Quick start (from source)
 
 ```bash
@@ -13,6 +26,11 @@ bun install
 bun run cli:dev        # starts the TUI; it boots the server automatically
 ```
 
+Lightcode is aware of the directory you launch it in: each turn it reads the
+project's shape (top-level files, git branch/status) and any `AGENTS.md` /
+`CLAUDE.md` / `README.md`, so "review my code" or "explain this" inspects your
+actual files instead of asking you to paste them.
+
 On first run Lightcode walks you through provider setup (Anthropic,
 OpenRouter, OpenCode Zen, or any OpenAI-compatible endpoint) and stores the
 API key in `~/.lightcode/credentials.json`. Environment variables such as
@@ -44,7 +62,8 @@ variables. Notable keys:
 | `context.pruneAtFraction` | Tool-output pruning threshold (default 0.6) |
 | `context.contextWindowOverride` | Override the model context window |
 | `maxRetries` | Provider-call retries for transient errors (default 5) |
-| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default 180) |
+| `autoContinue.stallTimeoutSeconds` | Abort+retry a byte-silent stream (default 300; raise for very slow reasoning models) |
+| `autoContinue.maxErrorRetries` | Auto-resends before surfacing a stream error (default 8) |
 
 The local companion server listens on `127.0.0.1:4983` (uncommon on purpose —
 port 3000 belongs to the apps you build). Override with `PORT` for the server

package/cli.js

@@ -124,7 +124,7 @@ var init_logger = __esm(() => {
 });
 
 // packages/shared/src/version.ts
-var lightcodeVersion = "0.4.0";
+var lightcodeVersion = "0.5.0";
 
 // packages/shared/src/index.ts
 var productName = "Lightcode";
@@ -226,7 +226,8 @@ async function ensureServerRunning() {
     stderr: logFile,
     env: {
       ...process.env,
-      PORT: port
+      PORT: port,
+      LIGHTCODE_PARENT_PID: String(process.pid)
     }
   });
   for (let attempt = 0;attempt < startupPollAttempts; attempt += 1) {
@@ -2466,7 +2467,8 @@ var init_agent_tools = __esm(() => {
     permissionMode: permissionModeSchema.optional(),
     allowedTools: z21.array(codingAgentToolNameSchema).optional(),
     permissionRules: permissionRulesSchema.optional(),
-    sandbox: sandboxConfigSchema.optional()
+    sandbox: sandboxConfigSchema.optional(),
+    environmentContext: z21.string().optional()
   });
 });
 
@@ -2841,7 +2843,8 @@ function buildCodingAgentSystemPrompt({
   cwd,
   override,
   mode = defaultCodingAgentMode,
-  includeToolDiscipline = false
+  includeToolDiscipline = false,
+  environmentContext
 }) {
   const promptTemplate = override?.trim() ? override : defaultCodingAgentSystemPrompt;
   const normalizedPrompt = normalizePromptTemplate(promptTemplate, cwd);
@@ -2852,12 +2855,14 @@ function buildCodingAgentSystemPrompt({
 ` + `Mode purpose: ${modeDefinition.purpose}
 ` + `${modeDefinition.instructions}` + (includeToolDiscipline ? `
 
-${toolCallingDisciplineAddendum}` : "");
+${toolCallingDisciplineAddendum}` : "") + (environmentContext?.trim() ? `
+
+${environmentContext.trim()}` : "");
 }
 var cwdPromptPlaceholder = "{cwd}", defaultCodingAgentSystemPrompt, toolCallingDisciplineAddendum;
 var init_coding_agent_prompt = __esm(() => {
   init_coding_agent_modes();
-  defaultCodingAgentSystemPrompt = "You are a coding agent. Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under this working directory: {cwd}. " + "Prefer dedicated tools \u2014 glob_search for paths, grep for text search, structured git tools for repository inspection \u2014 and bash only when those are not enough. " + `Use todo_write to keep multi-step work visible and current, inspect context before risky operations, and emit a brief, natural progress note before major tool actions and after important findings.
+  defaultCodingAgentSystemPrompt = "You are a coding agent working inside the user's project at this working directory: {cwd}. " + 'You can already see the project \u2014 proactively read it. When the user asks you to review, explain, or work on "my code"/"this", inspect the working directory yourself with list_files, glob_search, grep, and read_file; NEVER ask the user to paste or share code that lives in this directory \u2014 open it. ' + "Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under the working directory. " + "Prefer dedicated tools \u2014 glob_search for paths, grep for text search, structured git tools for repository inspection \u2014 and bash only when those are not enough. " + `Use todo_write to keep multi-step work visible and current, inspect context before risky operations, and emit a brief, natural progress note before major tool actions and after important findings.
 
 ` + `You are an agent \u2014 keep working until the request is fully resolved. Never stop with a partial answer; if you say you will do something, do it in the same turn by calling a tool. Do not finish while any todo is pending or in_progress \u2014 end your turn only when the task is complete or you are blocked on input that only the user can provide.
 
@@ -3180,6 +3185,17 @@ function selectCodingAgentIntentTools({
     return [];
   }
   const selectedTools = [];
+  const hasContinuationIntent = includesAny(normalizedText, [
+    "continue",
+    "proceed",
+    "go on",
+    "go ahead",
+    "keep going",
+    "carry on",
+    "resume",
+    "finish",
+    "next step"
+  ]);
   const hasCodeIntent = includesAny(normalizedText, [
     "file",
     "folder",
@@ -3226,7 +3242,44 @@ function selectCodingAgentIntentTools({
     "analyze",
     "check"
   ]);
-  const hasWriteIntent = mode === "build" && includesAny(normalizedText, [
+  const workspaceReferents = [
+    "this",
+    "these",
+    "that",
+    "here",
+    "code",
+    "codebase",
+    "repo",
+    "repository",
+    "project",
+    "file",
+    "files",
+    "directory",
+    "folder",
+    "app",
+    "application",
+    "module",
+    "my"
+  ];
+  const strongReviewIntent = includesAny(normalizedText, [
+    "review",
+    "audit",
+    "walk through",
+    "walkthrough",
+    "code review"
+  ]);
+  const softReviewIntent = includesAny(normalizedText, [
+    "explain",
+    "understand",
+    "summarize",
+    "summarise",
+    "overview",
+    "describe",
+    "explore",
+    "look at"
+  ]) && includesAny(normalizedText, workspaceReferents);
+  const hasReviewIntent = strongReviewIntent || softReviewIntent;
+  const hasWriteIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "write",
     "edit",
     "change",
@@ -3237,8 +3290,8 @@ function selectCodingAgentIntentTools({
     "delete",
     "remove",
     "rename"
-  ]);
-  const hasShellIntent = mode === "build" && includesAny(normalizedText, [
+  ]));
+  const hasShellIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "run",
     "command",
     "terminal",
@@ -3250,7 +3303,7 @@ function selectCodingAgentIntentTools({
     "run test",
     "run tests",
     "typecheck"
-  ]);
+  ]));
   const hasGitIntent = includesAny(normalizedText, [
     "git",
     "diff",
@@ -3298,7 +3351,7 @@ function selectCodingAgentIntentTools({
     "mcp tool",
     "mcp server"
   ]);
-  if (hasCodeIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
+  if (hasCodeIntent || hasContinuationIntent || hasReviewIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
     for (const toolName of baseReadTools) {
       pushUniqueTool(selectedTools, toolName);
     }
@@ -3552,7 +3605,8 @@ function createCodingAgent({
           cwd: options.cwd,
           override: promptOverride,
           mode,
-          includeToolDiscipline
+          includeToolDiscipline,
+          environmentContext: options.environmentContext
         })
       };
     }
@@ -4461,8 +4515,8 @@ var init_lightcode_config = __esm(() => {
   defaultAutoContinueConfig = {
     enabled: true,
     maxAutoContinues: 50,
-    maxErrorRetries: 5,
-    stallTimeoutSeconds: 180
+    maxErrorRetries: 8,
+    stallTimeoutSeconds: 300
   };
   headroomConfigSchema = z28.object({
     enabled: z28.boolean().optional(),
@@ -13598,7 +13652,12 @@ function OnboardingScreen() {
         ...finalBaseUrl ? { baseUrl: finalBaseUrl } : {}
       });
       const restarted = await restartOwnedServer();
-      setServerRestarted(restarted);
+      let reloaded = false;
+      try {
+        const response = await client.config.reload.$post();
+        reloaded = response.ok;
+      } catch {}
+      setServerRestarted(restarted || reloaded);
       bumpConfigRefresh();
       setStep("done");
     } catch (error) {
@@ -13809,6 +13868,7 @@ var providerChoices;
 var init_onboarding_screen = __esm(() => {
   init_src2();
   init_chat_text_area();
+  init_client();
   init_server_launcher();
   init_app_state();
   init_cli_theme();
@@ -14773,10 +14833,19 @@ var renderer = await createCliRenderer({
 });
 if (serverLaunch.ownedProcess) {
   const ownedProcess = serverLaunch.ownedProcess;
-  process.on("exit", () => {
+  const killOwnedServer = () => {
     try {
       ownedProcess.kill();
     } catch {}
+  };
+  process.on("exit", killOwnedServer);
+  process.on("SIGINT", () => {
+    killOwnedServer();
+    process.exit(0);
+  });
+  process.on("SIGTERM", () => {
+    killOwnedServer();
+    process.exit(0);
   });
 }
 createRoot(renderer).render(/* @__PURE__ */ jsxDEV33(App2, {}, undefined, false, undefined, this));

package/lightcode.cjs

@@ -8,22 +8,67 @@ const path = require("path");
 const fs = require("fs");
 const os = require("os");
 
-// Check if Bun is available
-try {
-  const result = spawnSync("bun", ["--version"], { encoding: "utf8" });
-  if (result.status !== 0) {
-    throw new Error("Bun not found");
+// Resolve a usable Bun (>= 1.3.0). Prefer the Bun bundled as a dependency of
+// this package (so a plain `npm install -g` works with no separate Bun
+// install), then fall back to a Bun already on PATH.
+function isUsableBun(bunCmd) {
+  try {
+    const result = spawnSync(bunCmd, ["--version"], { encoding: "utf8" });
+    if (result.status !== 0 || !result.stdout) {
+      return false;
+    }
+    const [major, minor] = result.stdout.trim().split(".").map(Number);
+    return major > 1 || (major === 1 && minor >= 3);
+  } catch {
+    return false;
+  }
+}
+
+function resolveBun() {
+  // __dirname is the realpath of this launcher even when invoked via npm's
+  // global bin symlink (process.argv[1] would be the symlink path on macOS/Linux).
+  const launcherDir = __dirname;
+  const candidates = [];
+
+  // Bun shipped as a dependency, inside this package's own node_modules. The
+  // npm "bun" package names its executable bin/bun.exe on EVERY platform
+  // (macOS and Linux included), so read the real path from its "bin" field
+  // rather than guessing a filename.
+  try {
+    const bunPkgPath = require.resolve("bun/package.json", {
+      paths: [launcherDir],
+    });
+    const bunDir = path.dirname(bunPkgPath);
+    const bin = JSON.parse(fs.readFileSync(bunPkgPath, "utf8")).bin;
+    const rel = typeof bin === "string" ? bin : bin && bin.bun;
+    if (rel) {
+      candidates.push(path.join(bunDir, rel));
+    }
+  } catch {}
+
+  // npm's bin shim (symlink) and conventional names, as fallbacks.
+  const shim = process.platform === "win32" ? "bun.exe" : "bun";
+  candidates.push(path.join(launcherDir, "node_modules", ".bin", shim));
+  candidates.push(path.join(launcherDir, "node_modules", "bun", "bin", "bun.exe"));
+  candidates.push(path.join(launcherDir, "node_modules", "bun", "bin", "bun"));
+
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate) && isUsableBun(candidate)) {
+      return candidate;
+    }
   }
-  const version = result.stdout.trim();
-  const [major, minor] = version.split(".").map(Number);
-  // Accept Bun >= 1.3.0
-  if (major < 1 || (major === 1 && minor < 3)) {
-    console.error("Lightcode requires Bun >= 1.3.0. Found: " + version);
-    console.error("Install the latest Bun from https://bun.sh");
-    process.exit(1);
+
+  // Fall back to a system Bun on PATH.
+  if (isUsableBun("bun")) {
+    return "bun";
   }
-} catch {
-  console.error("Lightcode requires Bun >= 1.3.0, which is not installed.");
+
+  return null;
+}
+
+const bunPath = resolveBun();
+if (!bunPath) {
+  console.error("Lightcode requires Bun >= 1.3.0, which could not be found.");
   console.error("Install Bun from https://bun.sh or:");
   console.error("  curl -fsSL https://bun.sh/install | bash");
   console.error("  # on Windows (PowerShell):");
@@ -84,9 +129,9 @@ if (process.platform === "win32" && !process.env.NODE_EXTRA_CA_CERTS) {
   }
 }
 
-// Get the directory of this launcher and find cli.js next to it
-const launcherDir = path.dirname(process.argv[1]);
-const cliPath = path.join(launcherDir, "cli.js");
+// Get the directory of this launcher and find cli.js next to it. Use __dirname
+// (realpath-resolved) so this works when run via npm's global bin symlink.
+const cliPath = path.join(__dirname, "cli.js");
 
 // Ensure cli.js exists
 if (!fs.existsSync(cliPath)) {
@@ -97,7 +142,7 @@ if (!fs.existsSync(cliPath)) {
 // Exec Bun with the cli.js script using spawnSync for proper argument handling
 try {
   const args = process.argv.slice(2);
-  const result = spawnSync("bun", [cliPath, ...args], {
+  const result = spawnSync(bunPath, [cliPath, ...args], {
     stdio: "inherit",
     env: process.env,
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kmugalkhod/lightcode",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Lightcode — a personal AI coding agent with a terminal UI and local session storage.",
   "type": "module",
   "license": "MIT",
@@ -18,6 +18,7 @@
     "LICENSE"
   ],
   "dependencies": {
+    "bun": "1.3.13",
     "@ai-sdk/anthropic": "3.0.77",
     "@ai-sdk/openai-compatible": "2.0.48",
     "@ai-sdk/react": "3.0.184",

package/server.js

@@ -1549,7 +1549,8 @@ var init_agent_tools = __esm(() => {
     permissionMode: permissionModeSchema.optional(),
     allowedTools: z21.array(codingAgentToolNameSchema).optional(),
     permissionRules: permissionRulesSchema.optional(),
-    sandbox: sandboxConfigSchema.optional()
+    sandbox: sandboxConfigSchema.optional(),
+    environmentContext: z21.string().optional()
   });
 });
 
@@ -1883,7 +1884,8 @@ function buildCodingAgentSystemPrompt({
   cwd,
   override,
   mode = defaultCodingAgentMode,
-  includeToolDiscipline = false
+  includeToolDiscipline = false,
+  environmentContext
 }) {
   const promptTemplate = override?.trim() ? override : defaultCodingAgentSystemPrompt;
   const normalizedPrompt = normalizePromptTemplate(promptTemplate, cwd);
@@ -1894,12 +1896,14 @@ function buildCodingAgentSystemPrompt({
 ` + `Mode purpose: ${modeDefinition.purpose}
 ` + `${modeDefinition.instructions}` + (includeToolDiscipline ? `
 
-${toolCallingDisciplineAddendum}` : "");
+${toolCallingDisciplineAddendum}` : "") + (environmentContext?.trim() ? `
+
+${environmentContext.trim()}` : "");
 }
 var cwdPromptPlaceholder = "{cwd}", defaultCodingAgentSystemPrompt, toolCallingDisciplineAddendum;
 var init_coding_agent_prompt = __esm(() => {
   init_coding_agent_modes();
-  defaultCodingAgentSystemPrompt = "You are a coding agent. Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under this working directory: {cwd}. " + "Prefer dedicated tools \u2014 glob_search for paths, grep for text search, structured git tools for repository inspection \u2014 and bash only when those are not enough. " + `Use todo_write to keep multi-step work visible and current, inspect context before risky operations, and emit a brief, natural progress note before major tool actions and after important findings.
+  defaultCodingAgentSystemPrompt = "You are a coding agent working inside the user's project at this working directory: {cwd}. " + 'You can already see the project \u2014 proactively read it. When the user asks you to review, explain, or work on "my code"/"this", inspect the working directory yourself with list_files, glob_search, grep, and read_file; NEVER ask the user to paste or share code that lives in this directory \u2014 open it. ' + "Use tools for filesystem and codebase tasks instead of guessing, and only interact with files under the working directory. " + "Prefer dedicated tools \u2014 glob_search for paths, grep for text search, structured git tools for repository inspection \u2014 and bash only when those are not enough. " + `Use todo_write to keep multi-step work visible and current, inspect context before risky operations, and emit a brief, natural progress note before major tool actions and after important findings.
 
 ` + `You are an agent \u2014 keep working until the request is fully resolved. Never stop with a partial answer; if you say you will do something, do it in the same turn by calling a tool. Do not finish while any todo is pending or in_progress \u2014 end your turn only when the task is complete or you are blocked on input that only the user can provide.
 
@@ -2222,6 +2226,17 @@ function selectCodingAgentIntentTools({
     return [];
   }
   const selectedTools = [];
+  const hasContinuationIntent = includesAny(normalizedText, [
+    "continue",
+    "proceed",
+    "go on",
+    "go ahead",
+    "keep going",
+    "carry on",
+    "resume",
+    "finish",
+    "next step"
+  ]);
   const hasCodeIntent = includesAny(normalizedText, [
     "file",
     "folder",
@@ -2268,7 +2283,44 @@ function selectCodingAgentIntentTools({
     "analyze",
     "check"
   ]);
-  const hasWriteIntent = mode === "build" && includesAny(normalizedText, [
+  const workspaceReferents = [
+    "this",
+    "these",
+    "that",
+    "here",
+    "code",
+    "codebase",
+    "repo",
+    "repository",
+    "project",
+    "file",
+    "files",
+    "directory",
+    "folder",
+    "app",
+    "application",
+    "module",
+    "my"
+  ];
+  const strongReviewIntent = includesAny(normalizedText, [
+    "review",
+    "audit",
+    "walk through",
+    "walkthrough",
+    "code review"
+  ]);
+  const softReviewIntent = includesAny(normalizedText, [
+    "explain",
+    "understand",
+    "summarize",
+    "summarise",
+    "overview",
+    "describe",
+    "explore",
+    "look at"
+  ]) && includesAny(normalizedText, workspaceReferents);
+  const hasReviewIntent = strongReviewIntent || softReviewIntent;
+  const hasWriteIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "write",
     "edit",
     "change",
@@ -2279,8 +2331,8 @@ function selectCodingAgentIntentTools({
     "delete",
     "remove",
     "rename"
-  ]);
-  const hasShellIntent = mode === "build" && includesAny(normalizedText, [
+  ]));
+  const hasShellIntent = mode === "build" && (hasContinuationIntent || includesAny(normalizedText, [
     "run",
     "command",
     "terminal",
@@ -2292,7 +2344,7 @@ function selectCodingAgentIntentTools({
     "run test",
     "run tests",
     "typecheck"
-  ]);
+  ]));
   const hasGitIntent = includesAny(normalizedText, [
     "git",
     "diff",
@@ -2340,7 +2392,7 @@ function selectCodingAgentIntentTools({
     "mcp tool",
     "mcp server"
   ]);
-  if (hasCodeIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
+  if (hasCodeIntent || hasContinuationIntent || hasReviewIntent || hasReadIntent && !hasGitIntent && !hasWebIntent && !explicitToolSearch) {
     for (const toolName of baseReadTools) {
       pushUniqueTool(selectedTools, toolName);
     }
@@ -2594,7 +2646,8 @@ function createCodingAgent({
           cwd: options.cwd,
           override: promptOverride,
           mode,
-          includeToolDiscipline
+          includeToolDiscipline,
+          environmentContext: options.environmentContext
         })
       };
     }
@@ -3486,8 +3539,8 @@ var init_lightcode_config = __esm(() => {
   defaultAutoContinueConfig = {
     enabled: true,
     maxAutoContinues: 50,
-    maxErrorRetries: 5,
-    stallTimeoutSeconds: 180
+    maxErrorRetries: 8,
+    stallTimeoutSeconds: 300
   };
   headroomConfigSchema = z28.object({
     enabled: z28.boolean().optional(),
@@ -6169,6 +6222,112 @@ var init_runtime8 = __esm(() => {
 // packages/ai/src/git/runtime.ts
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify3 } from "util";
+function isRecord7(value) {
+  return typeof value === "object" && value !== null;
+}
+function getStringProperty(record, key) {
+  const value = record[key];
+  return typeof value === "string" ? value : "";
+}
+function getExitCode(error) {
+  const code = error.code;
+  return typeof code === "number" ? code : null;
+}
+async function runGit(args, workspaceContext, maxBuffer = 10 * 1024 * 1024) {
+  try {
+    const result = await execFileAsync2("git", args, {
+      cwd: workspaceContext.root,
+      maxBuffer,
+      windowsHide: true
+    });
+    return {
+      ok: true,
+      stdout: result.stdout,
+      stderr: result.stderr,
+      exitCode: 0
+    };
+  } catch (error) {
+    const record = isRecord7(error) ? error : {};
+    const code = record.code;
+    const codeText = typeof code === "string" ? code : "git_failed";
+    const message = getStringProperty(record, "message") || "Git command failed.";
+    return {
+      ok: false,
+      error: {
+        code: codeText,
+        message,
+        exitCode: getExitCode(record),
+        stdout: getStringProperty(record, "stdout"),
+        stderr: getStringProperty(record, "stderr")
+      }
+    };
+  }
+}
+function parseBranchLine(line) {
+  const branchLine = line.replace(/^##\s*/, "");
+  const [branchSegment, trackingSegment] = branchLine.split("...");
+  const branch = branchSegment && branchSegment !== "No commits yet on " ? branchSegment.replace(/^No commits yet on\s+/, "") : null;
+  const trackingMatch = trackingSegment?.match(/^([^\s]+)(?:\s+\[(.*)\])?/);
+  const upstream = trackingMatch?.[1] ?? null;
+  const trackingDetails = trackingMatch?.[2] ?? "";
+  const aheadMatch = trackingDetails.match(/ahead\s+(\d+)/);
+  const behindMatch = trackingDetails.match(/behind\s+(\d+)/);
+  return {
+    branch,
+    upstream,
+    ahead: aheadMatch ? Number(aheadMatch[1]) : 0,
+    behind: behindMatch ? Number(behindMatch[1]) : 0
+  };
+}
+function parseStatusEntries(stdout, maxEntries) {
+  const lines = stdout.split(/\r?\n/).filter((line) => line.length > 0);
+  const branchInfo = lines[0]?.startsWith("##") ? parseBranchLine(lines[0]) : { branch: null, upstream: null, ahead: 0, behind: 0 };
+  const statusLines = lines.filter((line) => !line.startsWith("##"));
+  const entries = statusLines.slice(0, maxEntries).map((line) => {
+    const indexStatus = line[0] === " " ? "" : line[0] ?? "";
+    const workingTreeStatus = line[1] === " " ? "" : line[1] ?? "";
+    const rawPath = line.slice(3);
+    const renameParts = rawPath.split(" -> ");
+    const originalPath = renameParts.length > 1 ? renameParts[0] : null;
+    const filePath = renameParts.length > 1 ? renameParts[1] : rawPath;
+    return {
+      path: filePath,
+      indexStatus,
+      workingTreeStatus,
+      originalPath
+    };
+  });
+  return {
+    ...branchInfo,
+    entries,
+    totalEntries: statusLines.length,
+    truncated: statusLines.length > entries.length
+  };
+}
+async function executeGitStatus(input, workspaceContext = getDefaultWorkspaceContext()) {
+  const parsedInput = gitStatusInputSchema.parse(input);
+  const result = await runGit(["status", "--porcelain=v1", "-b", "--untracked-files=all", "--", "."], workspaceContext);
+  if (!result.ok) {
+    return gitStatusOutputSchema.parse({
+      ok: false,
+      cwd: workspaceContext.root,
+      branch: null,
+      upstream: null,
+      ahead: 0,
+      behind: 0,
+      entries: [],
+      totalEntries: 0,
+      truncated: false,
+      error: result.error
+    });
+  }
+  return gitStatusOutputSchema.parse({
+    ok: true,
+    cwd: workspaceContext.root,
+    ...parseStatusEntries(result.stdout, parsedInput.maxEntries),
+    error: null
+  });
+}
 var execFileAsync2;
 var init_runtime9 = __esm(() => {
   init_resolve_within_workspace();
@@ -6939,6 +7098,7 @@ var init_provider_registry = __esm(() => {
 var exports_runtime_config = {};
 __export(exports_runtime_config, {
   resolvedProviderModel: () => resolvedProviderModel,
+  reloadRuntimeConfig: () => reloadRuntimeConfig,
   lightcodeConfigResult: () => lightcodeConfigResult,
   initializeModelCapabilities: () => initializeModelCapabilities,
   disableHeadroomRouting: () => disableHeadroomRouting,
@@ -6999,6 +7159,31 @@ function applyModelSelection({
   });
   return configStatus;
 }
+function reloadRuntimeConfig() {
+  const nextConfigResult = loadLightcodeConfig({
+    cwd: process.cwd(),
+    env: Bun.env
+  });
+  const nextResolved = resolveConfiguredProviderModel({
+    config: nextConfigResult.config,
+    env: Bun.env
+  });
+  const nextAgent = buildCodingAgent(nextConfigResult.config, nextResolved);
+  lightcodeConfigResult = nextConfigResult;
+  resolvedProviderModel = nextResolved;
+  chatModelId = nextResolved.resolvedModelId;
+  codingAgent = nextAgent;
+  configStatus = createConfigStatus({
+    config: nextConfigResult.config,
+    loadedFiles: nextConfigResult.loadedFiles,
+    resolvedProviderModel: nextResolved
+  });
+  logger5.info("runtime_config_reloaded", {
+    provider: nextConfigResult.config.provider,
+    model: nextConfigResult.config.model
+  });
+  return configStatus;
+}
 function disableHeadroomRouting() {
   if (!lightcodeConfigResult.config.headroom?.enabled) {
     return;
@@ -7134,11 +7319,122 @@ var init_session_auto_title = __esm(() => {
   logger6 = createLogger("session-auto-title");
 });
 
+// apps/server/src/lib/workspace-context.ts
+import { readFile as readFile2, readdir } from "fs/promises";
+import { platform as platform3 } from "os";
+import path11 from "path";
+function describePlatform() {
+  const map = {
+    darwin: "macOS",
+    win32: "Windows",
+    linux: "Linux"
+  };
+  return map[platform3()] ?? platform3();
+}
+async function buildDirectoryListing(cwd) {
+  try {
+    const dirents = await readdir(cwd, { withFileTypes: true });
+    const names = dirents.filter((entry) => entry.name !== ".git").map((entry) => entry.isDirectory() ? `${entry.name}/` : entry.name).sort((a, b) => a.localeCompare(b));
+    const shown = names.slice(0, maxListedEntries);
+    const suffix = names.length > shown.length ? `
+\u2026 and ${names.length - shown.length} more` : "";
+    return shown.length > 0 ? shown.join(`
+`) + suffix : "(empty directory)";
+  } catch (error) {
+    logger7.warn("workspace_listing_failed", { cwd, error: getErrorMessage(error) });
+    return "(unable to list directory)";
+  }
+}
+async function buildGitSummary(cwd) {
+  try {
+    const context2 = createWorkspaceContext(cwd);
+    const status = await executeGitStatus({}, context2);
+    if (!status.ok) {
+      return "Not a git repository.";
+    }
+    const header = [
+      `branch: ${status.branch ?? "(detached)"}`,
+      status.ahead || status.behind ? `ahead ${status.ahead}, behind ${status.behind}` : null
+    ].filter(Boolean).join(" | ");
+    if (status.totalEntries === 0) {
+      return `${header}
+working tree clean`;
+    }
+    const lines = status.entries.slice(0, maxListedEntries).map((entry) => `${entry.indexStatus}${entry.workingTreeStatus} ${entry.path}`.trim());
+    const more = status.totalEntries > lines.length ? `
+\u2026 and ${status.totalEntries - lines.length} more` : "";
+    return `${header}
+changes:
+${lines.join(`
+`)}${more}`;
+  } catch (error) {
+    logger7.warn("workspace_git_summary_failed", { cwd, error: getErrorMessage(error) });
+    return "Not a git repository.";
+  }
+}
+async function buildProjectDocs(cwd) {
+  const sections = [];
+  for (const name of projectDocNames) {
+    try {
+      const content = (await readFile2(path11.join(cwd, name), "utf8")).trim();
+      if (!content) {
+        continue;
+      }
+      const truncated = content.length > maxDocChars ? `${content.slice(0, maxDocChars)}
+\u2026 (truncated)` : content;
+      sections.push(`### ${name}
+${truncated}`);
+    } catch {}
+  }
+  return sections.join(`
+
+`);
+}
+async function buildWorkspaceContext({
+  cwd
+}) {
+  const [listing, git, docs] = await Promise.all([
+    buildDirectoryListing(cwd),
+    buildGitSummary(cwd),
+    buildProjectDocs(cwd)
+  ]);
+  const today = new Date().toISOString().slice(0, 10);
+  const parts = [
+    "<environment>",
+    `Working directory: ${cwd}`,
+    `Platform: ${describePlatform()}`,
+    `Date: ${today}`,
+    "",
+    "Git:",
+    git,
+    "",
+    "Top-level entries:",
+    listing,
+    docs ? `
+Project instructions:
+${docs}` : "",
+    "</environment>"
+  ];
+  const block = parts.join(`
+`);
+  return block.length > maxBlockChars ? `${block.slice(0, maxBlockChars)}
+\u2026 (environment truncated)
+</environment>` : block;
+}
+var logger7, projectDocNames, maxListedEntries = 40, maxDocChars = 1500, maxBlockChars = 8000;
+var init_workspace_context = __esm(() => {
+  init_runtime17();
+  init_src();
+  logger7 = createLogger("workspace-context");
+  projectDocNames = ["AGENTS.md", "CLAUDE.md", "README.md"];
+});
+
 // apps/server/src/lib/chat-stream.ts
 import {
   createAgentUIStreamResponse,
   consumeStream,
   generateId as generateId3,
+  isToolUIPart as isToolUIPart2,
   safeValidateUIMessages as safeValidateUIMessages2,
   streamText
 } from "ai";
@@ -7158,6 +7454,9 @@ function buildFastChatModelMessages(messages) {
     content: collectMessageText(message)
   })).filter((message) => message.content.length > 0).slice(-fastChatRecentMessageCount);
 }
+function messagesHaveToolActivity(messages) {
+  return messages.some((message) => message.parts?.some((part) => isToolUIPart2(part)));
+}
 function shouldUseFastChatPath({
   messages,
   mode,
@@ -7166,6 +7465,9 @@ function shouldUseFastChatPath({
   if (allowedTools && allowedTools.length > 0) {
     return false;
   }
+  if (messagesHaveToolActivity(messages)) {
+    return false;
+  }
   return selectCodingAgentIntentTools({
     mode,
     prompt: "",
@@ -7180,7 +7482,7 @@ async function countPendingChatInteractions(sessionId) {
     });
     return pendingInteractions.interactions.length;
   } catch (error) {
-    logger7.warn("context_compaction_pending_interactions_unavailable", {
+    logger8.warn("context_compaction_pending_interactions_unavailable", {
       sessionId,
       error: getErrorMessage(error)
     });
@@ -7191,7 +7493,7 @@ async function loadSessionContextStateSafe(sessionId) {
   try {
     return await getSessionContextState(sessionId);
   } catch (error) {
-    logger7.warn("context_state_unavailable", {
+    logger8.warn("context_state_unavailable", {
       sessionId,
       error: getErrorMessage(error)
     });
@@ -7240,7 +7542,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
       staleSkip: false
     });
   } catch (error) {
-    logger7.error("chat_pre_stream_persist_failed", {
+    logger8.error("chat_pre_stream_persist_failed", {
       sessionId,
       error: getErrorMessage(error)
     });
@@ -7283,7 +7585,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         pendingInteractionCount,
         cacheActive
       });
-      logger7.info("context_auto_compacted", {
+      logger8.info("context_auto_compacted", {
         sessionId,
         tier: compaction.state.tier,
         usedFallback: compaction.usedFallback,
@@ -7292,7 +7594,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         estimatedTokensAfter: view.estimate.tokens
       });
     } catch (error) {
-      logger7.error("context_compaction_failed", {
+      logger8.error("context_compaction_failed", {
         sessionId,
         error: getErrorMessage(error)
       });
@@ -7334,7 +7636,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         pendingInteractionCount: 0,
         cacheActive
       });
-      logger7.info("context_overflow_recovery", {
+      logger8.info("context_overflow_recovery", {
         sessionId,
         preserveRecentMessages: overflowConfig.preserveRecentMessages,
         estimatedTokens: view.estimate.tokens,
@@ -7343,7 +7645,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         compactedMessages: view.coveredMessages.length
       });
     } catch (error) {
-      logger7.error("context_overflow_recovery_failed", {
+      logger8.error("context_overflow_recovery_failed", {
         sessionId,
         error: getErrorMessage(error)
       });
@@ -7379,14 +7681,14 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
     });
     const normalizedMessages = removeTrailingEmptyAssistantMessages(fullHistory);
     if (normalizedMessages.length !== fullHistory.length) {
-      logger7.warn("chat_finish_empty_assistant_skipped", { sessionId });
+      logger8.warn("chat_finish_empty_assistant_skipped", { sessionId });
       return;
     }
     const validatedFinishResult = await safeValidateUIMessages2({
       messages: normalizedMessages
     });
     if (!validatedFinishResult.success) {
-      logger7.warn("chat_invalid_finish_payload", {
+      logger8.warn("chat_invalid_finish_payload", {
         sessionId,
         message: validatedFinishResult.error.message
       });
@@ -7420,7 +7722,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         messages: validatedFinishResult.data
       });
     } catch (error) {
-      logger7.error("chat_finish_persist_failed", {
+      logger8.error("chat_finish_persist_failed", {
         sessionId,
         error: getErrorMessage(error)
       });
@@ -7446,19 +7748,22 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
       finishReason: part.finishReason
     };
   };
+  const environmentContext = await buildWorkspaceContext({ cwd });
   try {
     if (shouldUseFastChatPath({
       messages: providerMessages,
       mode,
       allowedTools
     })) {
-      logger7.info("chat_fast_path", {
+      logger8.info("chat_fast_path", {
         sessionId,
         model: chatModelId
       });
       const result = streamText({
         model: resolvedProviderModel.model,
-        system: fastChatSystemPrompt,
+        system: `${fastChatSystemPrompt}
+
+${environmentContext}`,
         messages: buildFastChatModelMessages(providerMessages),
         maxOutputTokens: Math.min(lightcodeConfigResult.config.maxOutputTokens, fastChatMaxOutputTokens),
         maxRetries: lightcodeConfigResult.config.maxRetries,
@@ -7528,7 +7833,8 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
         permissionMode,
         allowedTools,
         permissionRules,
-        sandbox
+        sandbox,
+        environmentContext
       },
       abortSignal: c.req.raw.signal,
       generateMessageId: generateId3,
@@ -7588,7 +7894,7 @@ async function streamSessionChat(c, sessionIdentifier, messagesPayload, cwd, mod
     }, 500);
   }
 }
-var logger7, recoverableDisconnectMessage = "Connection interrupted. Please retry or regenerate your last message.", providerBillingOrQuotaMessage, fastChatSystemPrompt, fastChatMaxOutputTokens = 512, fastChatRecentMessageCount = 6;
+var logger8, recoverableDisconnectMessage = "Connection interrupted. Please retry or regenerate your last message.", providerBillingOrQuotaMessage, fastChatSystemPrompt, fastChatMaxOutputTokens = 512, fastChatRecentMessageCount = 6;
 var init_chat_stream = __esm(() => {
   init_src2();
   init_src();
@@ -7600,10 +7906,11 @@ var init_chat_stream = __esm(() => {
   init_sse_heartbeat();
   init_context_state_store();
   init_session_auto_title();
+  init_workspace_context();
   init_runtime_config();
-  logger7 = createLogger("chat-stream");
+  logger8 = createLogger("chat-stream");
   providerBillingOrQuotaMessage = "The configured model provider rejected this request due to billing or quota limits. " + "Update provider credits/quota and retry.";
-  fastChatSystemPrompt = "You are Lightcode's friendly coding assistant. For casual conversation, reply briefly and naturally. " + "If the user asks for coding work, say you can help and ask them what they want to change.";
+  fastChatSystemPrompt = "You are Lightcode's coding assistant, running inside the user's project. " + "For casual conversation, reply briefly and naturally. " + "If the user asks about or wants work on their code, do not ask them to paste it \u2014 you can read the project files directly; offer to look and proceed.";
 });
 
 // apps/server/src/routes/route-helpers.ts
@@ -7612,16 +7919,16 @@ function internalErrorResponse(c, {
   message,
   error
 }) {
-  logger8.error(event, { error: getErrorMessage(error) });
+  logger9.error(event, { error: getErrorMessage(error) });
   return c.json({
     error: message,
     details: Bun.env.NODE_ENV === "production" ? undefined : getErrorMessage(error)
   }, 500);
 }
-var logger8;
+var logger9;
 var init_route_helpers = __esm(() => {
   init_src();
-  logger8 = createLogger("routes");
+  logger9 = createLogger("routes");
 });
 
 // apps/server/src/routes/chat-routes.ts
@@ -7916,7 +8223,7 @@ var init_config_routes = __esm(() => {
     provider: lightcodeProviderSchema,
     model: z35.string().min(1).max(240)
   });
-  configRoutes = new Hono2().get("/status", (c) => c.json(configStatus)).get("/models", async (c) => {
+  configRoutes = new Hono2().get("/status", (c) => c.json(configStatus)).post("/reload", (c) => c.json({ ok: true, configStatus: reloadRuntimeConfig() })).get("/models", async (c) => {
     const provider = c.req.query("provider") ?? "openrouter";
     if (provider !== "openrouter") {
       return c.json({ error: `Model listing is not supported for provider "${provider}".` }, 400);
@@ -7987,7 +8294,7 @@ var init_extension_runtime = __esm(() => {
 
 // apps/server/src/routes/diagnostics-routes.ts
 import { existsSync as existsSync9, readdirSync as readdirSync4 } from "fs";
-import path11 from "path";
+import path12 from "path";
 import { Hono as Hono3 } from "hono";
 function combineStatuses(statuses) {
   if (statuses.includes("error")) {
@@ -8309,7 +8616,7 @@ async function buildLogsTailPayload(requestedLines) {
       lines: []
     };
   }
-  const filePath = path11.join(directory, latestFile);
+  const filePath = path12.join(directory, latestFile);
   const content = await Bun.file(filePath).text();
   const lines = content.split(`
 `).filter((line) => line.length > 0);
@@ -8432,36 +8739,36 @@ async function ensureHeadroomRouting() {
     health = await checkHeadroomHealth(headroom.proxyUrl);
   } catch (error) {
     health = "down";
-    logger9.warn("headroom_health_probe_failed", {
+    logger10.warn("headroom_health_probe_failed", {
       proxyUrl: headroom.proxyUrl,
       error: getErrorMessage(error)
     });
   }
   if (health === "healthy") {
-    logger9.info("headroom_routing_active", { proxyUrl: headroom.proxyUrl });
+    logger10.info("headroom_routing_active", { proxyUrl: headroom.proxyUrl });
     return;
   }
   if (headroom.failOpen) {
-    logger9.warn("headroom_unreachable_failing_open", {
+    logger10.warn("headroom_unreachable_failing_open", {
       proxyUrl: headroom.proxyUrl
     });
     disableHeadroomRouting();
     return;
   }
-  logger9.error("headroom_unreachable_fail_closed", {
+  logger10.error("headroom_unreachable_fail_closed", {
     proxyUrl: headroom.proxyUrl
   });
 }
-var logger9, healthCheckTimeoutMs = 1500;
+var logger10, healthCheckTimeoutMs = 1500;
 var init_headroom_proxy = __esm(() => {
   init_src();
   init_runtime_config();
-  logger9 = createLogger("headroom-proxy");
+  logger10 = createLogger("headroom-proxy");
 });
 
 // apps/server/src/index.ts
 init_src();
-var logger10 = createLogger("server");
+var logger11 = createLogger("server");
 var httpIdleTimeoutSeconds = 30;
 var shutdownForceExitMs = 5000;
 function isChatStreamingRoute(request) {
@@ -8474,7 +8781,7 @@ function isChatStreamingRoute(request) {
 async function startServer() {
   const logDirectory = enableFileLogSink(Bun.env);
   if (logDirectory) {
-    logger10.info("file_log_sink_enabled", { directory: logDirectory });
+    logger11.info("file_log_sink_enabled", { directory: logDirectory });
   }
   const port = Number(Bun.env.PORT ?? 4983);
   const hostname = Bun.env.LIGHTCODE_HOST ?? "127.0.0.1";
@@ -8495,12 +8802,12 @@ async function startServer() {
     process.exit(1);
   }
   Promise.resolve().then(() => (init_runtime_config(), exports_runtime_config)).then((runtime19) => runtime19.initializeModelCapabilities()).catch((error) => {
-    logger10.warn("model_capability_init_failed", {
+    logger11.warn("model_capability_init_failed", {
       error: getErrorMessage(error)
     });
   });
   Promise.resolve().then(() => (init_headroom_proxy(), exports_headroom_proxy)).then((headroom) => headroom.ensureHeadroomRouting()).catch((error) => {
-    logger10.warn("headroom_init_failed", {
+    logger11.warn("headroom_init_failed", {
       error: getErrorMessage(error)
     });
   });
@@ -8536,7 +8843,7 @@ async function startServer() {
       return;
     }
     shuttingDown = true;
-    logger10.info("server_shutdown", { signal });
+    logger11.info("server_shutdown", { signal });
     const forceExitTimer = setTimeout(() => {
       server.stop(true);
       process.exit(0);
@@ -8551,6 +8858,17 @@ async function startServer() {
   };
   process.on("SIGINT", () => void shutdown("SIGINT"));
   process.on("SIGTERM", () => void shutdown("SIGTERM"));
+  const parentPid = Number(Bun.env.LIGHTCODE_PARENT_PID);
+  if (Number.isInteger(parentPid) && parentPid > 0) {
+    const parentWatch = setInterval(() => {
+      try {
+        process.kill(parentPid, 0);
+      } catch {
+        shutdown("parent-exit");
+      }
+    }, 2000);
+    parentWatch.unref();
+  }
   console.log(`Server listening on http://${hostname}:${port}`);
 }
 if (import.meta.main) {