@locusai/cli 0.14.5 → 0.15.1

package/bin/locus.js

@@ -7077,6 +7077,7 @@ class ClaudeRunner {
   currentToolName;
   activeTools = new Map;
   activeProcess = null;
+  aborted = false;
   timeoutMs;
   constructor(projectPath, model = DEFAULT_MODEL[PROVIDER.CLAUDE], log, timeoutMs) {
     this.model = model;
@@ -7089,6 +7090,7 @@ class ClaudeRunner {
   }
   abort() {
     if (this.activeProcess && !this.activeProcess.killed) {
+      this.aborted = true;
       this.activeProcess.kill("SIGTERM");
       this.activeProcess = null;
     }
@@ -7147,6 +7149,7 @@ class ClaudeRunner {
     return args;
   }
   async* runStream(prompt) {
+    this.aborted = false;
     const args = this.buildCliArgs();
     const env = getAugmentedEnv({
       FORCE_COLOR: "1",
@@ -7241,7 +7244,7 @@ class ClaudeRunner {
         process.stderr.write(`${stderrBuffer}
 `);
       }
-      if (code !== 0 && !errorMessage) {
+      if (code !== 0 && !errorMessage && !this.aborted) {
         const detail = stderrFull.trim() || lastResultContent.trim();
         errorMessage = this.createExecutionError(code, detail).message;
         this.eventEmitter?.emitErrorOccurred(errorMessage, `EXIT_${code}`);
@@ -7386,6 +7389,7 @@ class ClaudeRunner {
     return null;
   }
   executeRun(prompt) {
+    this.aborted = false;
     return new Promise((resolve2, reject) => {
       const args = this.buildCliArgs();
       const env = getAugmentedEnv({
@@ -7438,7 +7442,7 @@ class ClaudeRunner {
         }
         process.stdout.write(`
 `);
-        if (code === 0) {
+        if (code === 0 || this.aborted) {
           resolve2(finalResult);
         } else {
           const detail = errorOutput.trim() || finalResult.trim();
@@ -7509,6 +7513,7 @@ class CodexRunner {
   log;
   reasoningEffort;
   activeProcess = null;
+  aborted = false;
   eventEmitter;
   currentToolName;
   timeoutMs;
@@ -7524,11 +7529,13 @@ class CodexRunner {
   }
   abort() {
     if (this.activeProcess && !this.activeProcess.killed) {
+      this.aborted = true;
       this.activeProcess.kill("SIGTERM");
       this.activeProcess = null;
     }
   }
   async run(prompt) {
+    this.aborted = false;
     const maxRetries = 3;
     let lastError = null;
     for (let attempt = 1;attempt <= maxRetries; attempt++) {
@@ -7644,7 +7651,7 @@ class CodexRunner {
     });
     codex.on("close", (code) => {
       this.activeProcess = null;
-      if (code === 0) {
+      if (code === 0 || this.aborted) {
         const result = this.readOutput(outputPath, finalOutput);
         this.cleanupTempFile(outputPath);
         if (result && finalContent.trim().length === 0) {
@@ -7757,7 +7764,7 @@ class CodexRunner {
       });
       codex.on("close", (code) => {
         this.activeProcess = null;
-        if (code === 0) {
+        if (code === 0 || this.aborted) {
           const result = this.readOutput(outputPath, output);
           this.cleanupTempFile(outputPath);
           resolve2(result);
@@ -23345,6 +23352,29 @@ var init_sprints = __esm(() => {
   };
 });
 
+// ../sdk/src/modules/suggestions.ts
+var SuggestionsModule;
+var init_suggestions = __esm(() => {
+  SuggestionsModule = class SuggestionsModule extends BaseModule {
+    async create(workspaceId, data) {
+      const { data: res } = await this.api.post(`/workspaces/${workspaceId}/suggestions`, data);
+      return res.suggestion;
+    }
+    async list(workspaceId, params) {
+      const { data } = await this.api.get(`/workspaces/${workspaceId}/suggestions`, { params });
+      return data.suggestions;
+    }
+    async get(workspaceId, id) {
+      const { data } = await this.api.get(`/workspaces/${workspaceId}/suggestions/${id}`);
+      return data.suggestion;
+    }
+    async updateStatus(workspaceId, id, status) {
+      const { data } = await this.api.patch(`/workspaces/${workspaceId}/suggestions/${id}/status`, status);
+      return data.suggestion;
+    }
+  };
+});
+
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v4/core/core.js
 function $constructor(name, initializer, params) {
   function init(inst, def) {
@@ -37660,6 +37690,75 @@ var init_auth2 = __esm(() => {
   });
 });
 
+// ../shared/src/models/autonomy.ts
+var RiskLevel, ChangeCategory, AutonomyRuleSchema, DEFAULT_AUTONOMY_RULES;
+var init_autonomy = __esm(() => {
+  init_zod();
+  ((RiskLevel2) => {
+    RiskLevel2["LOW"] = "LOW";
+    RiskLevel2["HIGH"] = "HIGH";
+  })(RiskLevel ||= {});
+  ((ChangeCategory2) => {
+    ChangeCategory2["FIX"] = "FIX";
+    ChangeCategory2["REFACTOR"] = "REFACTOR";
+    ChangeCategory2["STYLE"] = "STYLE";
+    ChangeCategory2["DEPENDENCY"] = "DEPENDENCY";
+    ChangeCategory2["FEATURE"] = "FEATURE";
+    ChangeCategory2["ARCHITECTURE"] = "ARCHITECTURE";
+    ChangeCategory2["DATABASE"] = "DATABASE";
+    ChangeCategory2["AUTH"] = "AUTH";
+    ChangeCategory2["API"] = "API";
+  })(ChangeCategory ||= {});
+  AutonomyRuleSchema = exports_external.object({
+    category: exports_external.enum(ChangeCategory),
+    riskLevel: exports_external.enum(RiskLevel),
+    autoExecute: exports_external.boolean()
+  });
+  DEFAULT_AUTONOMY_RULES = [
+    { category: "FIX" /* FIX */, riskLevel: "LOW" /* LOW */, autoExecute: true },
+    {
+      category: "REFACTOR" /* REFACTOR */,
+      riskLevel: "LOW" /* LOW */,
+      autoExecute: true
+    },
+    {
+      category: "STYLE" /* STYLE */,
+      riskLevel: "LOW" /* LOW */,
+      autoExecute: true
+    },
+    {
+      category: "DEPENDENCY" /* DEPENDENCY */,
+      riskLevel: "LOW" /* LOW */,
+      autoExecute: true
+    },
+    {
+      category: "FEATURE" /* FEATURE */,
+      riskLevel: "HIGH" /* HIGH */,
+      autoExecute: false
+    },
+    {
+      category: "ARCHITECTURE" /* ARCHITECTURE */,
+      riskLevel: "HIGH" /* HIGH */,
+      autoExecute: false
+    },
+    {
+      category: "DATABASE" /* DATABASE */,
+      riskLevel: "HIGH" /* HIGH */,
+      autoExecute: false
+    },
+    {
+      category: "AUTH" /* AUTH */,
+      riskLevel: "HIGH" /* HIGH */,
+      autoExecute: false
+    },
+    {
+      category: "API" /* API */,
+      riskLevel: "HIGH" /* HIGH */,
+      autoExecute: false
+    }
+  ];
+});
+
 // ../shared/src/models/aws-instance.ts
 var InstanceAction, AwsCredentialsSchema, IntegrationSchema, AwsInstanceSchema, CreateAwsInstanceSchema, UpdateAwsInstanceSchema, SaveAwsCredentialsSchema, ProvisionAwsInstanceSchema, InstanceActionBodySchema, InstanceIdParamSchema, CIDR_REGEX, UpdateSecurityRulesSchema;
 var init_aws_instance = __esm(() => {
@@ -37978,6 +38077,49 @@ var init_sprint = __esm(() => {
   });
 });
 
+// ../shared/src/models/suggestion.ts
+var SuggestionStatus, SuggestionType, SuggestionSchema, CreateSuggestionSchema, UpdateSuggestionStatusSchema;
+var init_suggestion = __esm(() => {
+  init_zod();
+  ((SuggestionStatus2) => {
+    SuggestionStatus2["NEW"] = "NEW";
+    SuggestionStatus2["NOTIFIED"] = "NOTIFIED";
+    SuggestionStatus2["ACTED_ON"] = "ACTED_ON";
+    SuggestionStatus2["SKIPPED"] = "SKIPPED";
+    SuggestionStatus2["EXPIRED"] = "EXPIRED";
+  })(SuggestionStatus ||= {});
+  ((SuggestionType2) => {
+    SuggestionType2["CODE_FIX"] = "CODE_FIX";
+    SuggestionType2["DEPENDENCY_UPDATE"] = "DEPENDENCY_UPDATE";
+    SuggestionType2["NEXT_STEP"] = "NEXT_STEP";
+    SuggestionType2["REFACTOR"] = "REFACTOR";
+    SuggestionType2["TEST_FIX"] = "TEST_FIX";
+  })(SuggestionType ||= {});
+  SuggestionSchema = exports_external.object({
+    id: exports_external.string(),
+    type: exports_external.enum(SuggestionType),
+    status: exports_external.enum(SuggestionStatus),
+    title: exports_external.string(),
+    description: exports_external.string(),
+    jobRunId: exports_external.string().optional(),
+    workspaceId: exports_external.string(),
+    createdAt: exports_external.string(),
+    expiresAt: exports_external.string(),
+    metadata: exports_external.record(exports_external.string(), exports_external.any()).optional()
+  });
+  CreateSuggestionSchema = exports_external.object({
+    type: exports_external.enum(SuggestionType),
+    title: exports_external.string().min(1, "Title is required"),
+    description: exports_external.string().min(1, "Description is required"),
+    jobRunId: exports_external.string().uuid().optional(),
+    metadata: exports_external.record(exports_external.string(), exports_external.any()).optional(),
+    expiresAt: exports_external.string().optional()
+  });
+  UpdateSuggestionStatusSchema = exports_external.object({
+    status: exports_external.enum(SuggestionStatus)
+  });
+});
+
 // ../shared/src/models/task.ts
 var AcceptanceItemSchema, TaskSchema, CreateTaskSchema, UpdateTaskSchema, AddCommentSchema, DispatchTaskSchema, TaskIdParamSchema, TaskQuerySchema, TaskResponseSchema, TasksResponseSchema;
 var init_task = __esm(() => {
@@ -38117,6 +38259,7 @@ var init_models = __esm(() => {
   init_activity();
   init_agent();
   init_auth2();
+  init_autonomy();
   init_aws_instance();
   init_ci2();
   init_doc();
@@ -38124,6 +38267,7 @@ var init_models = __esm(() => {
   init_invitation();
   init_organization();
   init_sprint();
+  init_suggestion();
   init_task();
   init_user();
   init_workspace();
@@ -38846,6 +38990,7 @@ class LocusClient {
   docs;
   ci;
   instances;
+  suggestions;
   constructor(config2) {
     this.emitter = new LocusEmitter;
     this.api = axios_default.create({
@@ -38866,6 +39011,7 @@ class LocusClient {
     this.docs = new DocsModule(this.api, this.emitter);
     this.ci = new CiModule(this.api, this.emitter);
     this.instances = new InstancesModule(this.api, this.emitter);
+    this.suggestions = new SuggestionsModule(this.api, this.emitter);
     if (config2.retryOptions) {
       this.setupRetryInterceptor(config2.retryOptions);
     }
@@ -38935,6 +39081,7 @@ var init_src2 = __esm(() => {
   init_invitations();
   init_organizations();
   init_sprints();
+  init_suggestions();
   init_tasks();
   init_workspaces();
   init_discussion_types();
@@ -38946,6 +39093,7 @@ var init_src2 = __esm(() => {
   init_invitations();
   init_organizations();
   init_sprints();
+  init_suggestions();
   init_tasks();
   init_workspaces();
 });
@@ -41888,6 +42036,22 @@ var init_planning = __esm(() => {
   init_sprint_plan();
 });
 
+// ../sdk/src/proposals/context-gatherer.ts
+var init_context_gatherer = () => {};
+
+// ../sdk/src/proposals/proposal-engine.ts
+var init_proposal_engine = __esm(() => {
+  init_src();
+  init_factory();
+  init_context_gatherer();
+});
+
+// ../sdk/src/proposals/index.ts
+var init_proposals = __esm(() => {
+  init_context_gatherer();
+  init_proposal_engine();
+});
+
 // ../sdk/src/index-node.ts
 var init_index_node = __esm(() => {
   init_prompt_builder();
@@ -41902,6 +42066,7 @@ var init_index_node = __esm(() => {
   init_git();
   init_src2();
   init_planning();
+  init_proposals();
 });
 
 // src/utils/version.ts
@@ -42340,9 +42505,22 @@ class SettingsManager {
   exists() {
     return existsSync15(getSettingsPath(this.projectPath));
   }
+  getAutonomyRules() {
+    const settings = this.load();
+    const userRules = settings.autonomy?.rules ?? [];
+    if (userRules.length === 0) {
+      return DEFAULT_AUTONOMY_RULES;
+    }
+    const ruleMap = new Map(DEFAULT_AUTONOMY_RULES.map((r) => [r.category, r]));
+    for (const rule of userRules) {
+      ruleMap.set(rule.category, rule);
+    }
+    return Array.from(ruleMap.values());
+  }
 }
 var init_settings_manager = __esm(() => {
   init_index_node();
+  init_src();
 });
 
 // src/workspace-resolver.ts
@@ -43283,6 +43461,430 @@ var init_progress_renderer = __esm(() => {
   SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 });
 
+// src/repl/image-detect.ts
+import { copyFileSync, existsSync as existsSync18, mkdirSync as mkdirSync8 } from "node:fs";
+import { homedir as homedir2, tmpdir as tmpdir2 } from "node:os";
+import { basename as basename2, join as join18 } from "node:path";
+function hasImageExtension(p) {
+  const dot = p.lastIndexOf(".");
+  if (dot === -1)
+    return false;
+  return IMAGE_EXTENSIONS.has(p.slice(dot).toLowerCase());
+}
+function resolvePath(raw) {
+  let p = raw.replace(/\\ /g, " ").trim();
+  if (p.startsWith("'") && p.endsWith("'") || p.startsWith('"') && p.endsWith('"')) {
+    p = p.slice(1, -1);
+  }
+  if (p.startsWith("~/")) {
+    p = homedir2() + p.slice(1);
+  }
+  return p;
+}
+function copyToStable(srcPath) {
+  try {
+    mkdirSync8(STABLE_IMAGE_DIR, { recursive: true });
+    const ts = Date.now();
+    const name = `${ts}-${basename2(srcPath)}`;
+    const destPath = join18(STABLE_IMAGE_DIR, name);
+    copyFileSync(srcPath, destPath);
+    return destPath;
+  } catch {
+    return null;
+  }
+}
+function detectImages(input) {
+  const seen = new Set;
+  const images = [];
+  const tryAdd = (raw) => {
+    const normalized = resolvePath(raw);
+    if (!normalized || seen.has(normalized))
+      return;
+    if (!hasImageExtension(normalized))
+      return;
+    seen.add(normalized);
+    let exists = false;
+    let stablePath = normalized;
+    try {
+      exists = existsSync18(normalized);
+    } catch {}
+    if (exists) {
+      const copied = copyToStable(normalized);
+      if (copied) {
+        stablePath = copied;
+      }
+    }
+    images.push({ path: normalized, stablePath, raw: raw.trim(), exists });
+  };
+  for (const line of input.split(`
+`)) {
+    const trimmed = line.trim();
+    const unquoted = trimmed.replace(/^['"]|['"]$/g, "");
+    if (unquoted.startsWith("/") || unquoted.startsWith("~/")) {
+      tryAdd(trimmed);
+    }
+  }
+  const escapedRe = /(?:~\/|\/)[^\s]*(?:\\ [^\s]*)*\.(png|jpe?g|gif|webp|bmp|svg|tiff?)\b/gi;
+  for (const match of input.matchAll(escapedRe)) {
+    tryAdd(match[0]);
+  }
+  const simpleRe = /(?:~\/|\/)\S+\.(png|jpe?g|gif|webp|bmp|svg|tiff?)\b/gi;
+  for (const match of input.matchAll(simpleRe)) {
+    tryAdd(match[0]);
+  }
+  return images;
+}
+function imageDisplayName(imagePath) {
+  return basename2(imagePath);
+}
+function stripImagePaths(input, images) {
+  if (images.length === 0)
+    return input;
+  let result = input;
+  for (const img of images) {
+    result = result.replace(img.raw, "");
+    if (img.raw !== img.path) {
+      result = result.replace(img.path, "");
+    }
+  }
+  return result.split(`
+`).map((line) => line.trim()).filter((line) => line.length > 0).join(`
+`).trim();
+}
+function buildImageContext(images) {
+  if (images.length === 0)
+    return "";
+  const existingImages = images.filter((img) => img.exists);
+  if (existingImages.length === 0)
+    return "";
+  const pathList = existingImages.map((img) => `- ${img.stablePath}`).join(`
+`);
+  const noun = existingImages.length === 1 ? "an image" : "images";
+  const pronoun = existingImages.length === 1 ? "it" : "them";
+  return `
+
+[The user has attached ${noun}. Use the Read tool to view ${pronoun}:
+${pathList}
+]`;
+}
+var IMAGE_EXTENSIONS, STABLE_IMAGE_DIR;
+var init_image_detect = __esm(() => {
+  IMAGE_EXTENSIONS = new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".webp",
+    ".bmp",
+    ".svg",
+    ".tif",
+    ".tiff"
+  ]);
+  STABLE_IMAGE_DIR = join18(tmpdir2(), "locus-images");
+});
+
+// src/repl/input-handler.ts
+class InputHandler {
+  buffer = "";
+  isPasting = false;
+  locked = false;
+  active = false;
+  displayedLines = 0;
+  prompt;
+  continuationPrompt;
+  onSubmit;
+  onInterrupt;
+  onClose;
+  constructor(options) {
+    this.prompt = options.prompt ?? "> ";
+    this.continuationPrompt = options.continuationPrompt ?? "… ";
+    this.onSubmit = options.onSubmit;
+    this.onInterrupt = options.onInterrupt;
+    this.onClose = options.onClose;
+  }
+  start() {
+    if (this.active)
+      return;
+    if (!process.stdin.isTTY)
+      return;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");
+    process.stdout.write(ENABLE_BRACKETED_PASTE);
+    this.active = true;
+    process.stdin.on("data", this.handleData);
+  }
+  stop() {
+    if (!this.active)
+      return;
+    process.stdout.write(DISABLE_BRACKETED_PASTE);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(false);
+    }
+    process.stdin.removeListener("data", this.handleData);
+    process.stdin.pause();
+    this.active = false;
+  }
+  lock() {
+    this.locked = true;
+  }
+  showPrompt() {
+    this.locked = false;
+    this.buffer = "";
+    this.displayedLines = 0;
+    process.stdout.write(this.prompt);
+    this.displayedLines = 1;
+  }
+  handleData = (data) => {
+    if (this.locked) {
+      if (data.includes("\x03")) {
+        this.onInterrupt();
+      }
+      return;
+    }
+    if (data.includes(PASTE_START) || this.isPasting) {
+      this.handleBracketedPaste(data);
+      return;
+    }
+    if (this.looksLikePaste(data)) {
+      this.handleHeuristicPaste(data);
+      return;
+    }
+    this.processKeystrokes(data);
+  };
+  handleBracketedPaste(data) {
+    let remaining = data;
+    const startIdx = remaining.indexOf(PASTE_START);
+    if (startIdx !== -1) {
+      if (startIdx > 0) {
+        this.processKeystrokes(remaining.slice(0, startIdx));
+      }
+      this.isPasting = true;
+      remaining = remaining.slice(startIdx + PASTE_START.length);
+    }
+    const endIdx = remaining.indexOf(PASTE_END);
+    if (endIdx !== -1) {
+      this.appendPasteContent(remaining.slice(0, endIdx));
+      this.isPasting = false;
+      const afterPaste = remaining.slice(endIdx + PASTE_END.length);
+      if (afterPaste.length > 0) {
+        this.processKeystrokes(afterPaste);
+      }
+      return;
+    }
+    if (this.isPasting) {
+      this.appendPasteContent(remaining);
+    }
+  }
+  appendPasteContent(content) {
+    const normalized = content.replace(/\r\n/g, `
+`).replace(/\r/g, `
+`);
+    this.buffer += normalized;
+    this.fullRender();
+  }
+  looksLikePaste(data) {
+    const crIdx = data.indexOf("\r");
+    if (crIdx === -1)
+      return false;
+    let afterIdx = crIdx + 1;
+    if (afterIdx < data.length && data[afterIdx] === `
+`)
+      afterIdx++;
+    return afterIdx < data.length && data.charCodeAt(afterIdx) >= 32;
+  }
+  handleHeuristicPaste(data) {
+    const normalized = data.replace(/\r\n/g, `
+`).replace(/\r/g, `
+`);
+    this.buffer += normalized;
+    this.fullRender();
+  }
+  processKeystrokes(data) {
+    let i = 0;
+    while (i < data.length) {
+      if (this.locked)
+        break;
+      const ch = data[i];
+      if (ch === "\x03") {
+        if (this.buffer.length > 0) {
+          this.buffer = "";
+          process.stdout.write(`\r
+${CLEAR_SCREEN_DOWN}${this.prompt}`);
+          this.displayedLines = 1;
+        } else {
+          this.onInterrupt();
+        }
+        i++;
+        continue;
+      }
+      if (ch === "\x04") {
+        if (this.buffer.length === 0) {
+          process.stdout.write(`
+`);
+          this.onClose();
+        }
+        i++;
+        continue;
+      }
+      if (ch === "\r") {
+        i++;
+        if (i < data.length && data[i] === `
+`)
+          i++;
+        this.submit();
+        continue;
+      }
+      if (ch === `
+`) {
+        this.insertNewline();
+        i++;
+        continue;
+      }
+      if (ch === "\x1B") {
+        const consumed = this.processEscapeSequence(data, i);
+        i += consumed;
+        continue;
+      }
+      if (ch === "" || ch === "\b") {
+        this.deleteLastChar();
+        i++;
+        continue;
+      }
+      if (ch === "\x15") {
+        this.buffer = "";
+        this.fullRender();
+        i++;
+        continue;
+      }
+      if (ch === "\x17") {
+        this.deleteLastWord();
+        i++;
+        continue;
+      }
+      if (ch === "\t") {
+        i++;
+        continue;
+      }
+      if (ch.charCodeAt(0) < 32) {
+        i++;
+        continue;
+      }
+      this.buffer += ch;
+      this.fullRender();
+      i++;
+    }
+  }
+  processEscapeSequence(data, pos) {
+    if (pos + 1 >= data.length)
+      return 1;
+    const next = data[pos + 1];
+    if (next === "\r") {
+      this.insertNewline();
+      if (pos + 2 < data.length && data[pos + 2] === `
+`)
+        return 3;
+      return 2;
+    }
+    if (next === "[") {
+      return this.processCSI(data, pos);
+    }
+    if (next === "O") {
+      return pos + 2 < data.length ? 3 : 2;
+    }
+    return 2;
+  }
+  processCSI(data, pos) {
+    let j = pos + 2;
+    while (j < data.length && data.charCodeAt(j) >= 48 && data.charCodeAt(j) <= 63)
+      j++;
+    while (j < data.length && data.charCodeAt(j) >= 32 && data.charCodeAt(j) <= 47)
+      j++;
+    if (j < data.length)
+      j++;
+    const seq = data.slice(pos, j);
+    if (seq === "\x1B[13;2u") {
+      this.insertNewline();
+    }
+    return j - pos;
+  }
+  insertNewline() {
+    this.buffer += `
+`;
+    this.fullRender();
+  }
+  deleteLastChar() {
+    if (this.buffer.length === 0)
+      return;
+    this.buffer = this.buffer.slice(0, -1);
+    this.fullRender();
+  }
+  deleteLastWord() {
+    if (this.buffer.length === 0)
+      return;
+    const prev = this.buffer;
+    this.buffer = this.buffer.replace(/\S*\s*$/, "");
+    if (this.buffer !== prev) {
+      this.fullRender();
+    }
+  }
+  submit() {
+    const input = this.buffer;
+    this.buffer = "";
+    this.displayedLines = 0;
+    process.stdout.write(`
+`);
+    this.locked = true;
+    this.onSubmit(input);
+  }
+  visualLength(str) {
+    const ESC2 = String.fromCharCode(27);
+    return str.replace(new RegExp(`${ESC2}\\[[0-9;]*m`, "g"), "").length;
+  }
+  calculatePhysicalLines() {
+    const cols = process.stdout.columns || 80;
+    const lines = this.buffer.split(`
+`);
+    let total = 0;
+    for (let i = 0;i < lines.length; i++) {
+      const prefix = i === 0 ? this.prompt : this.continuationPrompt;
+      const len = this.visualLength(prefix) + lines[i].length;
+      total += len === 0 ? 1 : Math.ceil(len / cols) || 1;
+    }
+    return total;
+  }
+  fullRender() {
+    let output = "";
+    if (this.displayedLines > 0) {
+      if (this.displayedLines > 1) {
+        output += `\r${CSI}${this.displayedLines - 1}A`;
+      } else {
+        output += "\r";
+      }
+      output += CLEAR_SCREEN_DOWN;
+    }
+    const lines = this.buffer.split(`
+`);
+    for (let idx = 0;idx < lines.length; idx++) {
+      const p = idx === 0 ? this.prompt : this.continuationPrompt;
+      if (idx > 0)
+        output += `\r
+`;
+      output += p + lines[idx];
+    }
+    process.stdout.write(output);
+    this.displayedLines = this.calculatePhysicalLines();
+  }
+}
+var CSI = "\x1B[", PASTE_START, PASTE_END, ENABLE_BRACKETED_PASTE, DISABLE_BRACKETED_PASTE, CLEAR_SCREEN_DOWN;
+var init_input_handler = __esm(() => {
+  PASTE_START = `${CSI}200~`;
+  PASTE_END = `${CSI}201~`;
+  ENABLE_BRACKETED_PASTE = `${CSI}?2004h`;
+  DISABLE_BRACKETED_PASTE = `${CSI}?2004l`;
+  CLEAR_SCREEN_DOWN = `${CSI}J`;
+});
+
 // src/display/execution-stats.ts
 class ExecutionStatsTracker {
   startTime;
@@ -43404,6 +44006,15 @@ function showHelp() {
   ${c.success("history")} / ${c.dim("hist")}       List recent sessions
   ${c.success("session")} / ${c.dim("sid")}        Show current session ID
 
+  ${c.primary("Key Bindings")}
+
+  ${c.success("Enter")}              Send message
+  ${c.success("Shift+Enter")}        Insert newline (also: Alt+Enter, Ctrl+J)
+  ${c.success("Ctrl+C")}             Interrupt running agent / clear input / exit
+  ${c.success("Ctrl+D")}             Exit (on empty input)
+  ${c.success("Ctrl+U")}             Clear current input
+  ${c.success("Ctrl+W")}             Delete last word
+
   ${c.dim("Any other input will be sent as a prompt to the AI.")}
 `);
 }
@@ -43492,23 +44103,20 @@ var exports_interactive_session = {};
 __export(exports_interactive_session, {
   InteractiveSession: () => InteractiveSession
 });
-import * as readline2 from "node:readline";
 
 class InteractiveSession {
-  readline = null;
+  inputHandler = null;
   aiRunner;
   promptBuilder;
   renderer;
   isProcessing = false;
+  interrupted = false;
   conversationHistory = [];
   historyManager;
   currentSession;
   projectPath;
   model;
   provider;
-  inputBuffer = [];
-  inputDebounceTimer = null;
-  static PASTE_DEBOUNCE_MS = 50;
   constructor(options) {
     this.aiRunner = createAiRunner(options.provider, {
       projectPath: options.projectPath,
@@ -43538,49 +44146,38 @@ class InteractiveSession {
   }
   async start() {
     this.printWelcome();
-    this.readline = readline2.createInterface({
-      input: process.stdin,
-      output: process.stdout,
-      terminal: true
-    });
-    this.readline.setPrompt(c.cyan("> "));
-    this.readline.prompt();
-    this.readline.on("line", (input) => this.handleLine(input));
-    this.readline.on("close", () => this.shutdown());
-    process.on("SIGINT", () => {
-      if (this.inputDebounceTimer) {
-        clearTimeout(this.inputDebounceTimer);
-        this.inputDebounceTimer = null;
-      }
-      this.inputBuffer = [];
-      if (this.isProcessing) {
-        this.renderer.stopThinkingAnimation();
-        console.log(c.dim(`
+    this.inputHandler = new InputHandler({
+      prompt: c.cyan("> "),
+      continuationPrompt: c.dim("… "),
+      onSubmit: (input) => {
+        this.handleSubmit(input).catch((err) => {
+          console.error(c.error(`Error: ${err instanceof Error ? err.message : String(err)}`));
+          this.inputHandler?.showPrompt();
+        });
+      },
+      onInterrupt: () => {
+        if (this.isProcessing) {
+          this.interrupted = true;
+          this.renderer.stopThinkingAnimation();
+          this.aiRunner.abort();
+          console.log(c.dim(`
 [Interrupted]`));
-        this.isProcessing = false;
-        this.readline?.prompt();
-      } else {
-        this.shutdown();
-      }
+          this.isProcessing = false;
+          this.inputHandler?.showPrompt();
+        } else {
+          this.shutdown();
+        }
+      },
+      onClose: () => this.shutdown()
     });
+    this.inputHandler.start();
+    this.inputHandler.showPrompt();
   }
-  handleLine(input) {
-    this.inputBuffer.push(input);
-    if (this.inputDebounceTimer) {
-      clearTimeout(this.inputDebounceTimer);
-    }
-    this.inputDebounceTimer = setTimeout(() => {
-      this.processBufferedInput();
-    }, InteractiveSession.PASTE_DEBOUNCE_MS);
-  }
-  async processBufferedInput() {
-    const fullInput = this.inputBuffer.join(`
-`);
-    this.inputBuffer = [];
-    this.inputDebounceTimer = null;
-    const trimmed = fullInput.trim();
+  async handleSubmit(input) {
+    this.interrupted = false;
+    const trimmed = input.trim();
     if (trimmed === "") {
-      this.readline?.prompt();
+      this.inputHandler?.showPrompt();
       return;
     }
     if (!trimmed.includes(`
@@ -43588,19 +44185,30 @@ class InteractiveSession {
       const command = parseCommand(trimmed);
       if (command) {
         await command.execute(this, trimmed.slice(command.name.length).trim());
-        if (this.readline)
-          this.readline.prompt();
+        this.inputHandler?.showPrompt();
         return;
       }
     }
     await this.executePrompt(trimmed);
-    this.readline?.prompt();
+    if (!this.interrupted) {
+      this.inputHandler?.showPrompt();
+    }
   }
   async executePrompt(prompt) {
     this.isProcessing = true;
     const statsTracker = new ExecutionStatsTracker;
     try {
-      const fullPrompt = await this.buildPromptWithHistory(prompt);
+      const images = detectImages(prompt);
+      if (images.length > 0) {
+        for (const img of images) {
+          const status = img.exists ? c.success("attached") : c.warning("not found");
+          process.stdout.write(`  ${c.cyan(`[Image: ${imageDisplayName(img.path)}]`)} ${status}\r
+`);
+        }
+      }
+      const cleanedPrompt = stripImagePaths(prompt, images);
+      const effectivePrompt = cleanedPrompt + buildImageContext(images);
+      const fullPrompt = await this.buildPromptWithHistory(effectivePrompt);
       const stream4 = this.aiRunner.runStream(fullPrompt);
       let responseContent = "";
       this.renderer.showThinkingStarted();
@@ -43698,15 +44306,11 @@ ${userInput}`;
     this.historyManager.pruneSessions();
   }
   shutdown() {
-    if (this.inputDebounceTimer) {
-      clearTimeout(this.inputDebounceTimer);
-      this.inputDebounceTimer = null;
-    }
     this.renderer.stopThinkingAnimation();
     this.aiRunner.abort();
     console.log(c.dim(`
 Goodbye!`));
-    this.readline?.close();
+    this.inputHandler?.stop();
     process.exit(0);
   }
   printWelcome() {
@@ -43716,6 +44320,7 @@ Goodbye!`));
   ${c.primary("Locus Interactive Mode")}
   ${sessionInfo}
   ${c.dim("Type your prompt, or 'help' for commands")}
+  ${c.dim("Enter to send, Shift+Enter for newline")}
   ${c.dim("Use 'exit' or Ctrl+D to quit")}
 `);
   }
@@ -43724,6 +44329,8 @@ var init_interactive_session = __esm(() => {
   init_index_node();
   init_progress_renderer();
   init_commands();
+  init_image_detect();
+  init_input_handler();
 });
 
 // src/cli.ts
@@ -44190,9 +44797,10 @@ async function configCommand(args) {
 // src/commands/discuss.ts
 init_index_node();
 init_progress_renderer();
+init_image_detect();
+init_input_handler();
 init_settings_manager();
 init_utils3();
-import * as readline from "node:readline";
 import { parseArgs as parseArgs3 } from "node:util";
 async function discussCommand(args) {
   const { values, positionals } = parseArgs3({
@@ -44278,16 +44886,11 @@ async function discussCommand(args) {
 `);
     process.exit(1);
   }
-  console.log(`  ${c.dim("Type your response, or 'help' for commands. Use 'exit' or Ctrl+C to quit.")}
+  console.log(`  ${c.dim("Type your response, or 'help' for commands.")}`);
+  console.log(`  ${c.dim("Enter to send, Shift+Enter for newline. Use 'exit' or Ctrl+D to quit.")}
 `);
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    terminal: true
-  });
-  rl.setPrompt(c.cyan("> "));
-  rl.prompt();
   let isProcessing = false;
+  let interrupted = false;
   const shutdown = () => {
     if (isProcessing) {
       aiRunner.abort();
@@ -44297,83 +44900,83 @@ async function discussCommand(args) {
     console.log(c.dim(`
   Goodbye!
 `));
-    rl.close();
+    inputHandler.stop();
     process.exit(0);
   };
-  process.on("SIGINT", () => {
-    if (isProcessing) {
-      aiRunner.abort();
-      isProcessing = false;
-      console.log(c.dim(`
-[Interrupted]`));
-      rl.prompt();
-    } else {
-      shutdown();
-    }
-  });
-  rl.on("close", () => {
-    shutdown();
-  });
-  rl.on("line", async (input) => {
+  const handleSubmit = async (input) => {
+    interrupted = false;
     const trimmed = input.trim();
-    if (trimmed === "" || isProcessing) {
-      rl.prompt();
-      return;
-    }
-    const lowerInput = trimmed.toLowerCase();
-    if (lowerInput === "help") {
-      showReplHelp();
-      rl.prompt();
-      return;
-    }
-    if (lowerInput === "exit" || lowerInput === "quit") {
-      shutdown();
-      return;
-    }
-    if (lowerInput === "insights") {
-      showCurrentInsights(discussionManager, discussionId);
-      rl.prompt();
+    if (trimmed === "") {
+      inputHandler.showPrompt();
       return;
     }
-    if (lowerInput === "summary") {
-      isProcessing = true;
-      const summaryRenderer = new ProgressRenderer({ animated: true });
-      try {
-        summaryRenderer.showThinkingStarted();
-        const summary = await facilitator.summarizeDiscussion(discussionId);
-        summaryRenderer.showThinkingStopped();
-        process.stdout.write(`
+    if (!trimmed.includes(`
+`)) {
+      const lowerInput = trimmed.toLowerCase();
+      if (lowerInput === "help") {
+        showReplHelp();
+        inputHandler.showPrompt();
+        return;
+      }
+      if (lowerInput === "exit" || lowerInput === "quit") {
+        shutdown();
+        return;
+      }
+      if (lowerInput === "insights") {
+        showCurrentInsights(discussionManager, discussionId);
+        inputHandler.showPrompt();
+        return;
+      }
+      if (lowerInput === "summary") {
+        isProcessing = true;
+        const summaryRenderer = new ProgressRenderer({ animated: true });
+        try {
+          summaryRenderer.showThinkingStarted();
+          const summary = await facilitator.summarizeDiscussion(discussionId);
+          summaryRenderer.showThinkingStopped();
+          process.stdout.write(`
 `);
-        process.stdout.write(summary);
-        process.stdout.write(`
+          process.stdout.write(summary);
+          process.stdout.write(`
 `);
-        summaryRenderer.finalize();
-        const discussion2 = discussionManager.load(discussionId);
-        if (discussion2) {
-          console.log(`
+          summaryRenderer.finalize();
+          const discussion2 = discussionManager.load(discussionId);
+          if (discussion2) {
+            console.log(`
   ${c.success("✔")} ${c.success("Discussion completed!")}
 `);
-          console.log(`  ${c.dim("Messages:")} ${discussion2.messages.length}  ${c.dim("Insights:")} ${discussion2.insights.length}
+            console.log(`  ${c.dim("Messages:")} ${discussion2.messages.length}  ${c.dim("Insights:")} ${discussion2.insights.length}
 `);
-        }
-        console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
-        console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
+          }
+          console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
+          console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
 `);
-      } catch (error48) {
-        summaryRenderer.finalize();
-        console.error(`
+        } catch (error48) {
+          summaryRenderer.finalize();
+          console.error(`
   ${c.error("✖")} ${c.red("Failed to summarize:")} ${error48 instanceof Error ? error48.message : String(error48)}
+`);
+        }
+        inputHandler.stop();
+        process.exit(0);
+        return;
+      }
+    }
+    const images = detectImages(trimmed);
+    if (images.length > 0) {
+      for (const img of images) {
+        const status = img.exists ? c.success("attached") : c.warning("not found");
+        process.stdout.write(`  ${c.cyan(`[Image: ${imageDisplayName(img.path)}]`)} ${status}\r
 `);
       }
-      rl.close();
-      process.exit(0);
-      return;
     }
+    const cleanedInput = stripImagePaths(trimmed, images);
+    const effectiveInput = cleanedInput + buildImageContext(images);
     isProcessing = true;
     const chunkRenderer = new ProgressRenderer({ animated: true });
     try {
       chunkRenderer.showThinkingStarted();
-      const stream4 = facilitator.continueDiscussionStream(discussionId, trimmed);
+      const stream4 = facilitator.continueDiscussionStream(discussionId, effectiveInput);
       let result = {
         response: "",
         insights: []
@@ -44401,8 +45004,37 @@ async function discussCommand(args) {
 `);
     }
     isProcessing = false;
-    rl.prompt();
+    if (!interrupted) {
+      inputHandler.showPrompt();
+    }
+  };
+  const inputHandler = new InputHandler({
+    prompt: c.cyan("> "),
+    continuationPrompt: c.dim("… "),
+    onSubmit: (input) => {
+      handleSubmit(input).catch((err) => {
+        console.error(`
+  ${c.error("✖")} ${c.red(err instanceof Error ? err.message : String(err))}
+`);
+        inputHandler.showPrompt();
+      });
+    },
+    onInterrupt: () => {
+      if (isProcessing) {
+        interrupted = true;
+        aiRunner.abort();
+        isProcessing = false;
+        console.log(c.dim(`
+[Interrupted]`));
+        inputHandler.showPrompt();
+      } else {
+        shutdown();
+      }
+    },
+    onClose: () => shutdown()
   });
+  inputHandler.start();
+  inputHandler.showPrompt();
 }
 function listDiscussions(discussionManager) {
   const discussions = discussionManager.list();
@@ -44507,6 +45139,14 @@ function showReplHelp() {
     ${c.cyan("exit")}        Save and exit without generating a summary
     ${c.cyan("help")}        Show this help message
 
+  ${c.header(" KEY BINDINGS ")}
+
+    ${c.cyan("Enter")}              Send message
+    ${c.cyan("Shift+Enter")}        Insert newline (also: Alt+Enter, Ctrl+J)
+    ${c.cyan("Ctrl+C")}             Interrupt / clear input / exit
+    ${c.cyan("Ctrl+U")}             Clear current input
+    ${c.cyan("Ctrl+W")}             Delete last word
+
   ${c.dim("Type anything else to continue the discussion.")}
 `);
 }
@@ -45214,6 +45854,10 @@ function showHelp2() {
               ${c.dim("sessions show <id> Show session messages")}
               ${c.dim("sessions delete <id> Delete a session")}
               ${c.dim("sessions clear     Clear all sessions")}
+    ${c.success("service")}   Manage the Locus system service
+              ${c.dim("install           Install as systemd/launchd service")}
+              ${c.dim("uninstall         Remove the system service")}
+              ${c.dim("status            Check if service is running")}
     ${c.success("artifacts")} List and manage knowledge artifacts
               ${c.dim("show <name>        Show artifact content")}
               ${c.dim("plan <name>        Convert artifact to a plan")}
@@ -45229,10 +45873,10 @@ function showHelp2() {
   ${c.header(" GETTING STARTED ")}
     ${c.dim("$")} ${c.primary("locus init")}
     ${c.dim("$")} ${c.primary("locus config setup")}
-    ${c.dim("$")} ${c.primary("locus run")}
+    ${c.dim("$")} ${c.primary("locus telegram setup")}
+    ${c.dim("$")} ${c.primary("locus service install")}
 
   ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus config show")}
     ${c.dim("$")} ${c.primary("locus run")}
     ${c.dim("$")} ${c.primary("locus docs sync")}
     ${c.dim("$")} ${c.primary("locus review")}
@@ -45241,7 +45885,7 @@ function showHelp2() {
     ${c.dim("$")} ${c.primary('locus discuss "how should we design the auth system?"')}
     ${c.dim("$")} ${c.primary("locus exec sessions list")}
     ${c.dim("$")} ${c.primary("locus artifacts")}
-    ${c.dim("$")} ${c.primary("locus artifacts show reduce-cli-terminal-output")}
+    ${c.dim("$")} ${c.primary("locus service install")}
 
   For more information, visit: ${c.underline("https://docs.locusai.dev")}
 `);
@@ -45386,8 +46030,8 @@ init_config_manager();
 init_settings_manager();
 init_utils3();
 init_workspace_resolver();
-import { existsSync as existsSync18, mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join18 } from "node:path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync9, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join19 } from "node:path";
 import { parseArgs as parseArgs7 } from "node:util";
 async function reviewCommand(args) {
   const subcommand = args[0];
@@ -45526,12 +46170,12 @@ async function reviewLocalCommand(args) {
 `);
     return;
   }
-  const reviewsDir = join18(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
-  if (!existsSync18(reviewsDir)) {
-    mkdirSync8(reviewsDir, { recursive: true });
+  const reviewsDir = join19(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
+  if (!existsSync19(reviewsDir)) {
+    mkdirSync9(reviewsDir, { recursive: true });
   }
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const reportPath = join18(reviewsDir, `review-${timestamp}.md`);
+  const reportPath = join19(reviewsDir, `review-${timestamp}.md`);
   writeFileSync8(reportPath, report, "utf-8");
   console.log(`
   ${c.success("✔")} ${c.success("Review complete!")}`);
@@ -45625,15 +46269,376 @@ ${c.info(`Received ${signal}. Stopping agent and cleaning up...`)}`);
   console.log(`  ${c.dim("A PR will be opened when all tasks are done")}`);
   await orchestrator.start();
 }
-// src/commands/telegram.ts
+// src/commands/service.ts
 init_index_node();
 init_settings_manager();
+init_utils3();
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync19 } from "node:fs";
-import { join as join19 } from "node:path";
-import { createInterface as createInterface4 } from "node:readline";
+import { existsSync as existsSync20, writeFileSync as writeFileSync9 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join20 } from "node:path";
+var SERVICE_NAME = "locus";
+var SYSTEMD_UNIT_PATH = `/etc/systemd/system/${SERVICE_NAME}.service`;
+var PLIST_LABEL = "com.locus.agent";
+function getPlistPath() {
+  return join20(homedir3(), "Library/LaunchAgents", `${PLIST_LABEL}.plist`);
+}
+function showServiceHelp() {
+  console.log(`
+  ${c.header(" SERVICE ")}
+    ${c.primary("locus service")} ${c.dim("<subcommand>")}
+
+  ${c.header(" SUBCOMMANDS ")}
+    ${c.success("install")}           Install Locus as a system service
+                      ${c.dim("Sets up systemd (Linux) or launchd (macOS)")}
+                      ${c.dim("to run the Telegram bot + proposal scheduler")}
+    ${c.success("uninstall")}         Remove the system service
+    ${c.success("status")}            Check if the service is running
+
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus service install")}
+    ${c.dim("$")} ${c.primary("locus service status")}
+    ${c.dim("$")} ${c.primary("locus service uninstall")}
+`);
+}
+function runShell(cmd, args) {
+  return new Promise((resolve2) => {
+    const proc = spawn4(cmd, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    proc.stdout?.on("data", (d) => {
+      stdout += d.toString();
+    });
+    proc.stderr?.on("data", (d) => {
+      stderr += d.toString();
+    });
+    proc.on("close", (exitCode) => resolve2({ exitCode, stdout, stderr }));
+    proc.on("error", (err) => resolve2({ exitCode: 1, stdout, stderr: err.message }));
+  });
+}
+function generateSystemdUnit(projectPath, user2, binaryPath) {
+  return `[Unit]
+Description=Locus AI Agent (Telegram bot + proposal scheduler)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=${user2}
+WorkingDirectory=${projectPath}
+ExecStart=${binaryPath}
+Restart=on-failure
+RestartSec=10
+Environment=PATH=/usr/local/bin:/usr/bin:/bin:${homedir3()}/.bun/bin:${homedir3()}/.nvm/current/bin:${homedir3()}/.local/bin
+Environment=HOME=${homedir3()}
+
+[Install]
+WantedBy=multi-user.target
+`;
+}
+async function installSystemd(projectPath) {
+  const user2 = process.env.USER || "root";
+  const monorepoEntry = join20(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync20(monorepoEntry);
+  let binaryPath;
+  if (isMonorepo) {
+    const bunPath = (await runShell("which", ["bun"])).stdout.trim() || join20(homedir3(), ".bun/bin/bun");
+    binaryPath = `${bunPath} run ${monorepoEntry}`;
+  } else {
+    const npmGlobalBin = (await runShell("npm", ["bin", "-g"])).stdout.trim();
+    const telegramBin = join20(npmGlobalBin, "locus-telegram");
+    binaryPath = existsSync20(telegramBin) ? telegramBin : "locus-telegram";
+  }
+  const unit = generateSystemdUnit(projectPath, user2, binaryPath);
+  console.log(`
+  ${c.info("▶")} Writing systemd unit to ${c.dim(SYSTEMD_UNIT_PATH)}`);
+  writeFileSync9(SYSTEMD_UNIT_PATH, unit, "utf-8");
+  console.log(`  ${c.info("▶")} Reloading systemd daemon...`);
+  await runShell("systemctl", ["daemon-reload"]);
+  console.log(`  ${c.info("▶")} Enabling and starting ${SERVICE_NAME}...`);
+  await runShell("systemctl", ["enable", SERVICE_NAME]);
+  const startResult = await runShell("systemctl", ["start", SERVICE_NAME]);
+  if (startResult.exitCode !== 0) {
+    console.error(`
+  ${c.error("✖")} Failed to start service: ${startResult.stderr.trim()}`);
+    console.error(`  ${c.dim("Check logs with:")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}`);
+    return;
+  }
+  console.log(`
+  ${c.success("✔")} ${c.bold("Locus service installed and running!")}
+
+  ${c.bold("Service:")} ${SERVICE_NAME}
+  ${c.bold("Unit file:")} ${SYSTEMD_UNIT_PATH}
+
+  ${c.bold("Useful commands:")}
+    ${c.dim("$")} ${c.primary(`sudo systemctl status ${SERVICE_NAME}`)}
+    ${c.dim("$")} ${c.primary(`sudo systemctl restart ${SERVICE_NAME}`)}
+    ${c.dim("$")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}
+`);
+}
+async function uninstallSystemd() {
+  if (!existsSync20(SYSTEMD_UNIT_PATH)) {
+    console.log(`
+  ${c.dim("No systemd service found. Nothing to remove.")}
+`);
+    return;
+  }
+  console.log(`  ${c.info("▶")} Stopping and disabling ${SERVICE_NAME}...`);
+  await runShell("systemctl", ["stop", SERVICE_NAME]);
+  await runShell("systemctl", ["disable", SERVICE_NAME]);
+  const { unlinkSync: unlinkSync6 } = await import("node:fs");
+  unlinkSync6(SYSTEMD_UNIT_PATH);
+  await runShell("systemctl", ["daemon-reload"]);
+  console.log(`
+  ${c.success("✔")} ${c.bold("Locus service removed.")}
+`);
+}
+async function statusSystemd() {
+  const result = await runShell("systemctl", ["is-active", SERVICE_NAME]);
+  const state = result.stdout.trim();
+  if (state === "active") {
+    console.log(`
+  ${c.success("●")} ${c.bold("Locus service is running")} ${c.dim("(systemd)")}
+`);
+  } else if (existsSync20(SYSTEMD_UNIT_PATH)) {
+    console.log(`
+  ${c.secondary("●")} ${c.bold(`Locus service is ${state}`)} ${c.dim("(systemd)")}
+`);
+    console.log(`  ${c.dim("Start with:")} ${c.primary(`sudo systemctl start ${SERVICE_NAME}`)}
+`);
+  } else {
+    console.log(`
+  ${c.secondary("●")} ${c.bold("Locus service is not installed")}
+`);
+    console.log(`  ${c.dim("Install with:")} ${c.primary("locus service install")}
+`);
+  }
+}
+function generatePlist(projectPath, binaryPath, binaryArgs) {
+  const argsXml = [binaryPath, ...binaryArgs].map((a) => `    <string>${a}</string>`).join(`
+`);
+  const logDir = join20(homedir3(), "Library/Logs/Locus");
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argsXml}
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${projectPath}</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${join20(logDir, "locus.log")}</string>
+  <key>StandardErrorPath</key>
+  <string>${join20(logDir, "locus-error.log")}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/usr/bin:/bin:${homedir3()}/.bun/bin:${homedir3()}/.nvm/current/bin:${homedir3()}/.local/bin</string>
+  </dict>
+</dict>
+</plist>
+`;
+}
+async function installLaunchd(projectPath) {
+  const plistPath = getPlistPath();
+  if (existsSync20(plistPath)) {
+    await runShell("launchctl", ["unload", plistPath]);
+  }
+  const monorepoEntry = join20(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync20(monorepoEntry);
+  let binaryPath;
+  let binaryArgs;
+  if (isMonorepo) {
+    const bunPath = (await runShell("which", ["bun"])).stdout.trim() || join20(homedir3(), ".bun/bin/bun");
+    binaryPath = bunPath;
+    binaryArgs = ["run", monorepoEntry];
+  } else {
+    const npmGlobalBin = (await runShell("npm", ["bin", "-g"])).stdout.trim();
+    const telegramBin = join20(npmGlobalBin, "locus-telegram");
+    binaryPath = existsSync20(telegramBin) ? telegramBin : "locus-telegram";
+    binaryArgs = [];
+  }
+  const logDir = join20(homedir3(), "Library/Logs/Locus");
+  const { mkdirSync: mkdirSync10 } = await import("node:fs");
+  mkdirSync10(logDir, { recursive: true });
+  const launchAgentsDir = join20(homedir3(), "Library/LaunchAgents");
+  mkdirSync10(launchAgentsDir, { recursive: true });
+  const plist = generatePlist(projectPath, binaryPath, binaryArgs);
+  console.log(`
+  ${c.info("▶")} Writing plist to ${c.dim(plistPath)}`);
+  writeFileSync9(plistPath, plist, "utf-8");
+  console.log(`  ${c.info("▶")} Loading service...`);
+  const loadResult = await runShell("launchctl", ["load", plistPath]);
+  if (loadResult.exitCode !== 0) {
+    console.error(`
+  ${c.error("✖")} Failed to load service: ${loadResult.stderr.trim()}`);
+    return;
+  }
+  const logPath = join20(logDir, "locus.log");
+  console.log(`
+  ${c.success("✔")} ${c.bold("Locus service installed and running!")}
+
+  ${c.bold("Plist:")} ${plistPath}
+  ${c.bold("Logs:")}  ${logPath}
+
+  ${c.bold("Useful commands:")}
+    ${c.dim("$")} ${c.primary(`launchctl list | grep ${PLIST_LABEL}`)}
+    ${c.dim("$")} ${c.primary(`tail -f ${logPath}`)}
+`);
+}
+async function uninstallLaunchd() {
+  const plistPath = getPlistPath();
+  if (!existsSync20(plistPath)) {
+    console.log(`
+  ${c.dim("No launchd service found. Nothing to remove.")}
+`);
+    return;
+  }
+  console.log(`  ${c.info("▶")} Unloading service...`);
+  await runShell("launchctl", ["unload", plistPath]);
+  const { unlinkSync: unlinkSync6 } = await import("node:fs");
+  unlinkSync6(plistPath);
+  console.log(`
+  ${c.success("✔")} ${c.bold("Locus service removed.")}
+`);
+}
+async function statusLaunchd() {
+  const plistPath = getPlistPath();
+  if (!existsSync20(plistPath)) {
+    console.log(`
+  ${c.secondary("●")} ${c.bold("Locus service is not installed")}
+`);
+    console.log(`  ${c.dim("Install with:")} ${c.primary("locus service install")}
+`);
+    return;
+  }
+  const result = await runShell("launchctl", ["list"]);
+  const lines = result.stdout.split(`
+`);
+  const match = lines.find((l) => l.includes(PLIST_LABEL));
+  if (match) {
+    const parts = match.trim().split(/\s+/);
+    const pid = parts[0] === "-" ? null : parts[0];
+    if (pid) {
+      console.log(`
+  ${c.success("●")} ${c.bold("Locus service is running")} ${c.dim(`(PID ${pid}, launchd)`)}
+`);
+    } else {
+      console.log(`
+  ${c.secondary("●")} ${c.bold("Locus service is stopped")} ${c.dim("(launchd)")}
+`);
+      console.log(`  ${c.dim("Start with:")} ${c.primary(`launchctl load ${plistPath}`)}
+`);
+    }
+  } else {
+    console.log(`
+  ${c.secondary("●")} ${c.bold("Locus service is not loaded")} ${c.dim("(plist exists but not loaded)")}
+`);
+    console.log(`  ${c.dim("Load with:")} ${c.primary(`launchctl load ${plistPath}`)}
+`);
+  }
+}
+function getPlatform() {
+  if (process.platform === "linux")
+    return "linux";
+  if (process.platform === "darwin")
+    return "darwin";
+  return null;
+}
+async function installCommand(projectPath) {
+  const platform = getPlatform();
+  if (!platform) {
+    console.error(`
+  ${c.error("✖")} ${c.bold(`Unsupported platform: ${process.platform}`)}
+  Service management is supported on Linux (systemd) and macOS (launchd).
+`);
+    process.exit(1);
+  }
+  const manager = new SettingsManager(projectPath);
+  const settings = manager.load();
+  if (!settings.telegram?.botToken || !settings.telegram?.chatId) {
+    console.error(`
+  ${c.error("✖")} ${c.bold("Telegram is not configured.")}
+  Run ${c.primary("locus telegram setup")} first.
+`);
+    process.exit(1);
+  }
+  if (!settings.apiKey) {
+    console.error(`
+  ${c.error("✖")} ${c.bold("API key is not configured.")}
+  Run ${c.primary("locus config setup --api-key <key>")} first.
+`);
+    process.exit(1);
+  }
+  if (platform === "linux") {
+    await installSystemd(projectPath);
+  } else {
+    await installLaunchd(projectPath);
+  }
+}
+async function uninstallCommand() {
+  const platform = getPlatform();
+  if (!platform) {
+    console.error(`
+  ${c.error("✖")} Unsupported platform: ${process.platform}
+`);
+    process.exit(1);
+  }
+  if (platform === "linux") {
+    await uninstallSystemd();
+  } else {
+    await uninstallLaunchd();
+  }
+}
+async function statusCommandHandler() {
+  const platform = getPlatform();
+  if (!platform) {
+    console.error(`
+  ${c.error("✖")} Unsupported platform: ${process.platform}
+`);
+    process.exit(1);
+  }
+  if (platform === "linux") {
+    await statusSystemd();
+  } else {
+    await statusLaunchd();
+  }
+}
+async function serviceCommand(args) {
+  const projectPath = process.cwd();
+  requireInitialization(projectPath, "service");
+  const subcommand = args[0];
+  switch (subcommand) {
+    case "install":
+      await installCommand(projectPath);
+      break;
+    case "uninstall":
+      await uninstallCommand();
+      break;
+    case "status":
+      await statusCommandHandler();
+      break;
+    default:
+      showServiceHelp();
+  }
+}
+// src/commands/telegram.ts
+init_index_node();
+init_settings_manager();
+import { spawn as spawn5 } from "node:child_process";
+import { existsSync as existsSync21 } from "node:fs";
+import { join as join21 } from "node:path";
+import { createInterface as createInterface2 } from "node:readline";
 function ask2(question) {
-  const rl = createInterface4({
+  const rl = createInterface2({
     input: process.stdin,
     output: process.stdout
   });
@@ -45748,7 +46753,8 @@ async function setupCommand2(args, projectPath) {
     ${c.primary("Chat ID:")}  ${parsedChatId}
 
   ${c.bold("Next steps:")}
-    Start the bot with: ${c.primary("locus telegram run")}
+    Install as service: ${c.primary("locus service install")}
+    Or run manually:    ${c.primary("locus telegram run")}
 `);
 }
 function configCommand2(projectPath) {
@@ -45864,8 +46870,8 @@ function runBotCommand(projectPath) {
 `);
     process.exit(1);
   }
-  const monorepoTelegramEntry = join19(projectPath, "packages/telegram/src/index.ts");
-  const isMonorepo = existsSync19(monorepoTelegramEntry);
+  const monorepoTelegramEntry = join21(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync21(monorepoTelegramEntry);
   let cmd;
   let args;
   if (isMonorepo) {
@@ -45876,7 +46882,7 @@ function runBotCommand(projectPath) {
     args = [];
   }
   const env = { ...process.env };
-  const child = spawn4(cmd, args, {
+  const child = spawn5(cmd, args, {
     cwd: projectPath,
     stdio: "inherit",
     env
@@ -46061,6 +47067,9 @@ async function main() {
     case "config":
       await configCommand(args);
       break;
+    case "service":
+      await serviceCommand(args);
+      break;
     case "docs":
       await docsCommand(args);
       break;
@@ -46089,3 +47098,11 @@ main().catch((err) => {
   ${c.error("✖ Fatal Error")} ${c.red(err.message)}`);
   process.exit(1);
 });
+
+// index.ts
+var _emit = process.emit;
+process.emit = function(name, data, ...args) {
+  if (name === "warning" && data?.code === "DEP0040")
+    return false;
+  return _emit.apply(process, [name, data, ...args]);
+};