@locusai/telegram 0.14.5 → 0.15.1

package/bin/telegram.js

@@ -23113,6 +23113,32 @@ var init_auth = __esm(() => {
   });
 });
 
+// ../shared/src/models/autonomy.ts
+var RiskLevel, ChangeCategory, AutonomyRuleSchema;
+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()
+  });
+});
+
 // ../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(() => {
@@ -23431,6 +23457,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(() => {
@@ -23570,6 +23639,7 @@ var init_models = __esm(() => {
   init_activity();
   init_agent();
   init_auth();
+  init_autonomy();
   init_aws_instance();
   init_ci();
   init_doc();
@@ -23577,6 +23647,7 @@ var init_models = __esm(() => {
   init_invitation();
   init_organization();
   init_sprint();
+  init_suggestion();
   init_task();
   init_user();
   init_workspace();
@@ -38620,6 +38691,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;
+    }
+  };
+});
+
 // ../sdk/src/modules/tasks.ts
 var TasksModule;
 var init_tasks = __esm(() => {
@@ -38804,6 +38898,7 @@ class LocusClient {
   docs;
   ci;
   instances;
+  suggestions;
   constructor(config2) {
     this.emitter = new LocusEmitter;
     this.api = axios_default.create({
@@ -38824,6 +38919,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);
     }
@@ -38893,6 +38989,7 @@ var init_src2 = __esm(() => {
   init_invitations();
   init_organizations();
   init_sprints();
+  init_suggestions();
   init_tasks();
   init_workspaces();
   init_discussion_types();
@@ -38904,6 +39001,7 @@ var init_src2 = __esm(() => {
   init_invitations();
   init_organizations();
   init_sprints();
+  init_suggestions();
   init_tasks();
   init_workspaces();
 });
@@ -39491,6 +39589,7 @@ class ClaudeRunner {
   currentToolName;
   activeTools = new Map;
   activeProcess = null;
+  aborted = false;
   timeoutMs;
   constructor(projectPath, model = DEFAULT_MODEL[PROVIDER.CLAUDE], log, timeoutMs) {
     this.model = model;
@@ -39503,6 +39602,7 @@ class ClaudeRunner {
   }
   abort() {
     if (this.activeProcess && !this.activeProcess.killed) {
+      this.aborted = true;
       this.activeProcess.kill("SIGTERM");
       this.activeProcess = null;
     }
@@ -39561,6 +39661,7 @@ class ClaudeRunner {
     return args;
   }
   async* runStream(prompt) {
+    this.aborted = false;
     const args = this.buildCliArgs();
     const env = getAugmentedEnv({
       FORCE_COLOR: "1",
@@ -39655,7 +39756,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}`);
@@ -39800,6 +39901,7 @@ class ClaudeRunner {
     return null;
   }
   executeRun(prompt) {
+    this.aborted = false;
     return new Promise((resolve2, reject) => {
       const args = this.buildCliArgs();
       const env = getAugmentedEnv({
@@ -39852,7 +39954,7 @@ class ClaudeRunner {
         }
         process.stdout.write(`
 `);
-        if (code === 0) {
+        if (code === 0 || this.aborted) {
           resolve2(finalResult);
         } else {
           const detail = errorOutput.trim() || finalResult.trim();
@@ -39923,6 +40025,7 @@ class CodexRunner {
   log;
   reasoningEffort;
   activeProcess = null;
+  aborted = false;
   eventEmitter;
   currentToolName;
   timeoutMs;
@@ -39938,11 +40041,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++) {
@@ -40058,7 +40163,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) {
@@ -40171,7 +40276,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);
@@ -41099,7 +41204,7 @@ var init_worker = __esm(() => {
 var import_config16 = __toESM(require_config(), 1);
 
 // src/bot.ts
-var import_telegraf5 = __toESM(require_lib3(), 1);
+var import_telegraf6 = __toESM(require_lib3(), 1);
 
 // src/callbacks.ts
 init_src();
@@ -43339,6 +43444,241 @@ var PlannerOutputSchema = exports_external.object({
 });
 // ../sdk/src/planning/planning-meeting.ts
 init_config();
+// ../sdk/src/proposals/context-gatherer.ts
+import { execFileSync as execFileSync4 } from "node:child_process";
+import { existsSync as existsSync9, readdirSync as readdirSync5, readFileSync as readFileSync8 } from "node:fs";
+import { join as join9 } from "node:path";
+
+class ContextGatherer {
+  async gather(projectPath, client, workspaceId) {
+    const [activeSprint, allTasks, skippedSuggestions] = await Promise.all([
+      this.fetchActiveSprint(client, workspaceId),
+      this.fetchTasks(client, workspaceId),
+      this.fetchSkippedSuggestions(client, workspaceId)
+    ]);
+    const sprintTasks = activeSprint ? allTasks.filter((t) => t.sprintId === activeSprint.id) : [];
+    const backlogTasks = allTasks.filter((t) => !t.sprintId);
+    const gitLog = this.readGitLog(projectPath);
+    const artifactContents = this.readArtifacts(projectPath);
+    const locusInstructions = this.readLocusInstructions(projectPath);
+    return {
+      activeSprint,
+      sprintTasks,
+      backlogTasks,
+      gitLog,
+      artifactContents,
+      locusInstructions,
+      skippedSuggestions
+    };
+  }
+  async fetchActiveSprint(client, workspaceId) {
+    try {
+      return await client.sprints.getActive(workspaceId);
+    } catch {
+      return null;
+    }
+  }
+  async fetchTasks(client, workspaceId) {
+    try {
+      return await client.tasks.list(workspaceId);
+    } catch {
+      return [];
+    }
+  }
+  async fetchSkippedSuggestions(client, workspaceId) {
+    try {
+      return await client.suggestions.list(workspaceId, { status: "SKIPPED" });
+    } catch {
+      return [];
+    }
+  }
+  readGitLog(projectPath) {
+    try {
+      return execFileSync4("git", ["log", "--oneline", "--no-decorate", "-n", "20"], {
+        cwd: projectPath,
+        encoding: "utf-8",
+        timeout: 1e4,
+        stdio: ["pipe", "pipe", "pipe"]
+      }).trim();
+    } catch {
+      return "";
+    }
+  }
+  readArtifacts(projectPath) {
+    const artifactsDir = join9(projectPath, ".locus", "artifacts");
+    if (!existsSync9(artifactsDir))
+      return [];
+    try {
+      const files = readdirSync5(artifactsDir).filter((f) => f.endsWith(".md"));
+      return files.slice(0, 10).map((name) => ({
+        name,
+        content: readFileSync8(join9(artifactsDir, name), "utf-8").slice(0, 2000)
+      }));
+    } catch {
+      return [];
+    }
+  }
+  readLocusInstructions(projectPath) {
+    const locusPath = join9(projectPath, ".locus", "LOCUS.md");
+    if (!existsSync9(locusPath))
+      return null;
+    try {
+      return readFileSync8(locusPath, "utf-8").slice(0, 3000);
+    } catch {
+      return null;
+    }
+  }
+}
+// ../sdk/src/proposals/proposal-engine.ts
+init_src();
+init_factory();
+class ProposalEngine {
+  contextGatherer;
+  constructor(contextGatherer) {
+    this.contextGatherer = contextGatherer ?? new ContextGatherer;
+  }
+  async runProposalCycle(projectPath, client, workspaceId) {
+    const context2 = await this.contextGatherer.gather(projectPath, client, workspaceId);
+    return this.generateProposals(context2, projectPath, client, workspaceId);
+  }
+  async generateProposals(context2, projectPath, client, workspaceId) {
+    const prompt = this.buildPrompt(context2);
+    const runner = createAiRunner(undefined, {
+      projectPath,
+      timeoutMs: 5 * 60 * 1000,
+      maxTurns: 1
+    });
+    let aiResponse;
+    try {
+      aiResponse = await runner.run(prompt);
+    } catch {
+      return [];
+    }
+    const proposals = this.parseResponse(aiResponse);
+    const created = [];
+    for (const proposal of proposals) {
+      if (this.isDuplicate(proposal.title, context2.skippedSuggestions)) {
+        continue;
+      }
+      try {
+        const suggestion2 = await client.suggestions.create(workspaceId, {
+          type: "NEXT_STEP" /* NEXT_STEP */,
+          title: proposal.title,
+          description: proposal.description,
+          metadata: {
+            complexity: proposal.complexity,
+            relatedBacklogItem: proposal.relatedBacklogItem,
+            source: "proposal-engine"
+          }
+        });
+        created.push(suggestion2);
+      } catch {}
+    }
+    return created;
+  }
+  buildPrompt(context2) {
+    const sections = [];
+    sections.push("You are a proactive software engineering advisor. Based on the project context below, propose 1-3 high-value next steps the team should take. Focus on actionable, impactful work.");
+    if (context2.activeSprint) {
+      const sprintInfo = `Sprint: ${context2.activeSprint.name} (${context2.activeSprint.status})`;
+      const tasksByStatus = this.groupTasksByStatus(context2.sprintTasks);
+      sections.push(`## Current Sprint
+${sprintInfo}
+${tasksByStatus}`);
+    }
+    if (context2.backlogTasks.length > 0) {
+      const backlogList = context2.backlogTasks.slice(0, 15).map((t) => `- [${t.priority}] ${t.title}${t.description ? `: ${t.description.slice(0, 100)}` : ""}`).join(`
+`);
+      sections.push(`## Backlog Items
+${backlogList}`);
+    }
+    if (context2.gitLog) {
+      sections.push(`## Recent Commits (last 20)
+${context2.gitLog}`);
+    }
+    if (context2.artifactContents.length > 0) {
+      const artifacts = context2.artifactContents.map((a) => `### ${a.name}
+${a.content}`).join(`
+
+`);
+      sections.push(`## Product Context
+${artifacts}`);
+    }
+    if (context2.locusInstructions) {
+      sections.push(`## Project Instructions
+${context2.locusInstructions}`);
+    }
+    if (context2.skippedSuggestions.length > 0) {
+      const skipped = context2.skippedSuggestions.map((s) => `- ${s.title}`).join(`
+`);
+      sections.push(`## Previously Skipped Proposals (do NOT re-propose these)
+${skipped}`);
+    }
+    sections.push(`## Instructions
+Propose 1-3 high-value next steps. For each, respond with exactly this format:
+
+PROPOSAL_START
+Title: <clear, concise title>
+Description: <what to do and why, 2-4 sentences>
+Complexity: <low|medium|high>
+Related Backlog: <title of related backlog item, or "none">
+PROPOSAL_END
+
+Rules:
+- Focus on what would deliver the most value right now
+- Align with the current sprint goals when possible
+- Don't propose things that are already in progress
+- Don't re-propose previously skipped suggestions
+- Keep proposals specific and actionable`);
+    return sections.join(`
+
+`);
+  }
+  parseResponse(response) {
+    const proposals = [];
+    const blocks = response.split("PROPOSAL_START");
+    for (const block of blocks) {
+      const endIdx = block.indexOf("PROPOSAL_END");
+      if (endIdx === -1)
+        continue;
+      const content = block.slice(0, endIdx).trim();
+      const title = this.extractField(content, "Title");
+      const description = this.extractField(content, "Description");
+      const complexity = this.extractField(content, "Complexity") ?? "medium";
+      const relatedRaw = this.extractField(content, "Related Backlog");
+      const relatedBacklogItem = relatedRaw && relatedRaw.toLowerCase() !== "none" ? relatedRaw : null;
+      if (title && description) {
+        proposals.push({
+          title: title.slice(0, 200),
+          description: description.slice(0, 2000),
+          complexity: complexity.toLowerCase(),
+          relatedBacklogItem
+        });
+      }
+    }
+    return proposals.slice(0, 3);
+  }
+  extractField(content, field) {
+    const regex = new RegExp(`^${field}:\\s*(.+)`, "im");
+    const match = content.match(regex);
+    return match ? match[1].trim() : null;
+  }
+  isDuplicate(title, skipped) {
+    const normalized = title.toLowerCase().trim();
+    return skipped.some((s) => {
+      const skippedNorm = s.title.toLowerCase().trim();
+      return skippedNorm === normalized || skippedNorm.includes(normalized) || normalized.includes(skippedNorm);
+    });
+  }
+  groupTasksByStatus(tasks2) {
+    const groups = {};
+    for (const t of tasks2) {
+      groups[t.status] = (groups[t.status] ?? 0) + 1;
+    }
+    return Object.entries(groups).map(([status, count]) => `- ${status}: ${count} task(s)`).join(`
+`);
+  }
+}
 // ../sdk/src/index-node.ts
 init_colors();
 
@@ -43802,6 +44142,218 @@ ${escapeHtml(desc)}
     const artifactName = ctx.match[1];
     await convertArtifactToPlan(ctx, config2, executor, artifactName);
   });
+  bot.action(/^proposal_start_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery("Starting proposal…");
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to act on proposals."), {
+        parse_mode: "HTML"
+      });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.updateStatus(workspaceId, suggestionId, { status: "ACTED_ON" /* ACTED_ON */ });
+      try {
+        await ctx.editMessageText(`▶️ Proposal "<b>${escapeHtml(suggestion2.title)}</b>" accepted. Starting planning…`, { parse_mode: "HTML" });
+      } catch {
+        await ctx.reply(`▶️ Proposal "<b>${escapeHtml(suggestion2.title)}</b>" accepted. Starting planning…`, { parse_mode: "HTML" });
+      }
+      const planPrompt = `${suggestion2.title}
+
+${suggestion2.description}`;
+      const args = executor.buildArgs(["plan", planPrompt], {
+        needsApiKey: true
+      });
+      const result = await executor.execute(args);
+      const output = (result.stdout + result.stderr).trim();
+      if (output) {
+        const parts = splitMessage(formatCommandOutput("locus plan", output, result.exitCode));
+        for (const part of parts) {
+          await ctx.reply(part, { parse_mode: "HTML" });
+        }
+      }
+    } catch (err) {
+      console.error("[callback:proposal_start] Failed:", err);
+      await ctx.reply(formatError2(`Failed to start proposal: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
+  bot.action(/^proposal_skip_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery("Skipping…");
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to act on proposals."), {
+        parse_mode: "HTML"
+      });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.updateStatus(workspaceId, suggestionId, { status: "SKIPPED" /* SKIPPED */ });
+      try {
+        await ctx.editMessageText(`⏭ Proposal "<b>${escapeHtml(suggestion2.title)}</b>" skipped. Won't suggest this again.`, { parse_mode: "HTML" });
+      } catch {
+        await ctx.reply(`⏭ Proposal "<b>${escapeHtml(suggestion2.title)}</b>" skipped. Won't suggest this again.`, { parse_mode: "HTML" });
+      }
+    } catch (err) {
+      console.error("[callback:proposal_skip] Failed:", err);
+      await ctx.reply(formatError2(`Failed to skip proposal: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
+  bot.action(/^proposal_details_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery();
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to view proposal details."), { parse_mode: "HTML" });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.get(workspaceId, suggestionId);
+      const complexityMap = {
+        low: "2/5",
+        medium: "3/5",
+        high: "4/5"
+      };
+      const complexity = complexityMap[String(suggestion2.metadata?.complexity).toLowerCase()] ?? "—";
+      const relatedTo = suggestion2.metadata?.relatedBacklogItem || "New initiative";
+      let msg = `\uD83D\uDCCB <b>Proposal Details</b>
+
+`;
+      msg += `<b>Title:</b> ${escapeHtml(suggestion2.title)}
+`;
+      msg += `<b>Type:</b> ${escapeHtml(suggestion2.type)}
+`;
+      msg += `<b>Status:</b> ${escapeHtml(suggestion2.status)}
+`;
+      msg += `<b>Complexity:</b> ${escapeHtml(complexity)}
+`;
+      msg += `<b>Related to:</b> ${escapeHtml(relatedTo)}
+`;
+      msg += `<b>Created:</b> ${escapeHtml(suggestion2.createdAt)}
+`;
+      msg += `<b>Expires:</b> ${escapeHtml(suggestion2.expiresAt)}
+`;
+      if (suggestion2.jobRunId) {
+        msg += `<b>Job Run:</b> <code>${escapeHtml(suggestion2.jobRunId)}</code>
+`;
+      }
+      msg += `
+<b>Description:</b>
+${escapeHtml(truncateOutput(suggestion2.description, 2000))}`;
+      if (suggestion2.metadata && Object.keys(suggestion2.metadata).length > 0) {
+        const {
+          complexity: _c,
+          relatedBacklogItem: _r,
+          ...rest
+        } = suggestion2.metadata;
+        if (Object.keys(rest).length > 0) {
+          msg += `
+
+<b>Metadata:</b>
+<pre>${escapeHtml(JSON.stringify(rest, null, 2).slice(0, 500))}</pre>`;
+        }
+      }
+      const parts = splitMessage(msg);
+      for (const part of parts) {
+        await ctx.reply(part, {
+          parse_mode: "HTML",
+          link_preview_options: { is_disabled: true }
+        });
+      }
+    } catch (err) {
+      console.error("[callback:proposal_details] Failed:", err);
+      await ctx.reply(formatError2(`Failed to fetch proposal: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
+  bot.action(/^suggestion_fix_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery("Applying fix…");
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to act on suggestions."), { parse_mode: "HTML" });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.updateStatus(workspaceId, suggestionId, { status: "ACTED_ON" /* ACTED_ON */ });
+      try {
+        await ctx.editMessageText(formatSuccess(`Suggestion "<b>${escapeHtml(suggestion2.title)}</b>" marked as fixed.`), { parse_mode: "HTML" });
+      } catch {
+        await ctx.reply(formatSuccess(`Suggestion "<b>${escapeHtml(suggestion2.title)}</b>" marked as fixed.`), { parse_mode: "HTML" });
+      }
+    } catch (err) {
+      console.error("[callback:suggestion_fix] Failed:", err);
+      await ctx.reply(formatError2(`Failed to update suggestion: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
+  bot.action(/^suggestion_skip_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery("Skipping…");
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to act on suggestions."), { parse_mode: "HTML" });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.updateStatus(workspaceId, suggestionId, { status: "SKIPPED" /* SKIPPED */ });
+      try {
+        await ctx.editMessageText(`⏭ Suggestion "<b>${escapeHtml(suggestion2.title)}</b>" skipped.`, { parse_mode: "HTML" });
+      } catch {
+        await ctx.reply(`⏭ Suggestion "<b>${escapeHtml(suggestion2.title)}</b>" skipped.`, { parse_mode: "HTML" });
+      }
+    } catch (err) {
+      console.error("[callback:suggestion_skip] Failed:", err);
+      await ctx.reply(formatError2(`Failed to update suggestion: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
+  bot.action(/^suggestion_details_(.+)$/, async (ctx) => {
+    await ctx.answerCbQuery();
+    const suggestionId = ctx.match[1];
+    if (!config2.apiKey) {
+      await ctx.reply(formatError2("API key is required to view suggestion details."), { parse_mode: "HTML" });
+      return;
+    }
+    try {
+      const { client, workspaceId } = await getClientAndWorkspace(config2);
+      const suggestion2 = await client.suggestions.get(workspaceId, suggestionId);
+      let msg = `\uD83D\uDCCB <b>Suggestion Details</b>
+
+`;
+      msg += `<b>Title:</b> ${escapeHtml(suggestion2.title)}
+`;
+      msg += `<b>Type:</b> ${escapeHtml(suggestion2.type)}
+`;
+      msg += `<b>Status:</b> ${escapeHtml(suggestion2.status)}
+`;
+      msg += `<b>Created:</b> ${escapeHtml(suggestion2.createdAt)}
+`;
+      msg += `<b>Expires:</b> ${escapeHtml(suggestion2.expiresAt)}
+`;
+      if (suggestion2.jobRunId) {
+        msg += `<b>Job Run:</b> <code>${escapeHtml(suggestion2.jobRunId)}</code>
+`;
+      }
+      msg += `
+<b>Description:</b>
+${escapeHtml(truncateOutput(suggestion2.description, 2000))}`;
+      if (suggestion2.metadata && Object.keys(suggestion2.metadata).length > 0) {
+        msg += `
+
+<b>Metadata:</b>
+<pre>${escapeHtml(JSON.stringify(suggestion2.metadata, null, 2).slice(0, 500))}</pre>`;
+      }
+      const parts = splitMessage(msg);
+      for (const part of parts) {
+        await ctx.reply(part, {
+          parse_mode: "HTML",
+          link_preview_options: { is_disabled: true }
+        });
+      }
+    } catch (err) {
+      console.error("[callback:suggestion_details] Failed:", err);
+      await ctx.reply(formatError2(`Failed to fetch suggestion: ${err instanceof Error ? err.message : String(err)}`), { parse_mode: "HTML" });
+    }
+  });
 }
 
 // src/commands/activity.ts
@@ -43961,8 +44513,8 @@ Total: ${agents.length} active agent(s)`;
   }
 }
 // src/commands/config.ts
-import { existsSync as existsSync9, readFileSync as readFileSync8, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join9 } from "node:path";
+import { existsSync as existsSync10, readFileSync as readFileSync9, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join10 } from "node:path";
 
 // src/command-whitelist.ts
 var SAFE_BRANCH = /^[a-zA-Z0-9_\-./]+$/;
@@ -44330,13 +44882,13 @@ var USAGE = `<b>Usage:</b>
 ${Object.entries(ALLOWED_KEYS).map(([k, v]) => `  \`${k}\` — ${v.description}`).join(`
 `)}`;
 function getSettingsPath(config2) {
-  return join9(config2.projectPath, CONFIG_DIR, SETTINGS_FILE);
+  return join10(config2.projectPath, CONFIG_DIR, SETTINGS_FILE);
 }
 function loadSettings(config2) {
   const path = getSettingsPath(config2);
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return null;
-  const raw = readFileSync8(path, "utf-8");
+  const raw = readFileSync9(path, "utf-8");
   return JSON.parse(raw);
 }
 function saveSettings(config2, settings) {
@@ -44660,13 +45212,13 @@ import { spawn as spawn4 } from "node:child_process";
 
 // src/env.ts
 import { homedir as homedir2 } from "node:os";
-import { join as join10 } from "node:path";
+import { join as join11 } from "node:path";
 function extraPathDirs() {
   const home = homedir2();
   return [
-    join10(home, ".bun", "bin"),
-    join10(home, ".nvm", "current", "bin"),
-    join10(home, ".local", "bin"),
+    join11(home, ".bun", "bin"),
+    join11(home, ".nvm", "current", "bin"),
+    join11(home, ".local", "bin"),
     "/usr/local/bin"
   ];
 }
@@ -45589,7 +46141,7 @@ async function approveTaskCommand(ctx, config2) {
 // src/commands/upgrade.ts
 import { spawn as spawn5 } from "node:child_process";
 import { homedir as homedir3 } from "node:os";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 function runCommand2(cmd, args, timeout) {
   return new Promise((resolve2) => {
     const proc = spawn5(cmd, args, {
@@ -45628,13 +46180,11 @@ function getRestartInfo() {
   if (platform === "linux") {
     return {
       label: "systemd (Linux)",
-      commands: [
-        { cmd: "sudo", args: ["systemctl", "restart", "locus-telegram"] }
-      ]
+      commands: [{ cmd: "sudo", args: ["systemctl", "restart", "locus"] }]
     };
   }
   if (platform === "darwin") {
-    const plistPath = join11(homedir3(), "Library/LaunchAgents/com.locus.telegram.plist");
+    const plistPath = join12(homedir3(), "Library/LaunchAgents/com.locus.agent.plist");
     return {
       label: "launchctl (macOS)",
       commands: [
@@ -45750,7 +46300,7 @@ async function workspaceCommand(ctx, config2) {
 }
 // src/executor.ts
 import { spawn as spawn6 } from "node:child_process";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 function timestamp2() {
   return new Date().toLocaleTimeString("en-GB", { hour12: false });
 }
@@ -45766,7 +46316,7 @@ class CliExecutor {
   }
   resolveCommand(args) {
     if (this.config.testMode) {
-      const cliPath = join12(this.config.projectPath, "packages/cli/src/cli.ts");
+      const cliPath = join13(this.config.projectPath, "packages/cli/src/cli.ts");
       return { cmd: "bun", cmdArgs: ["run", cliPath, ...args] };
     }
     return { cmd: "locus", cmdArgs: args };
@@ -45925,12 +46475,90 @@ class CliExecutor {
   }
 }
 
+// src/notifications.ts
+var import_telegraf5 = __toESM(require_lib3(), 1);
+var PROPOSALS_GENERATED = "PROPOSALS_GENERATED";
+var COMPLEXITY_DISPLAY = {
+  low: "2/5",
+  medium: "3/5",
+  high: "4/5"
+};
+var SUGGESTION_TYPE_ICONS = {
+  CODE_FIX: "\uD83D\uDD27",
+  DEPENDENCY_UPDATE: "\uD83D\uDCE6",
+  NEXT_STEP: "➡️",
+  REFACTOR: "♻️",
+  TEST_FIX: "\uD83E\uDDEA"
+};
+
+class Notifier {
+  bot;
+  chatId;
+  constructor(bot, chatId) {
+    this.bot = bot;
+    this.chatId = chatId;
+  }
+  connect(emitter) {
+    emitter.on(PROPOSALS_GENERATED, (payload) => {
+      for (const suggestion2 of payload.suggestions) {
+        this.notifyProposal(suggestion2).catch((err) => console.error("[notifier] Failed to send proposal:", err));
+      }
+    });
+  }
+  async notifyProposal(suggestion2) {
+    const complexity = COMPLEXITY_DISPLAY[String(suggestion2.metadata?.complexity).toLowerCase()] ?? "3/5";
+    const relatedTo = suggestion2.metadata?.relatedBacklogItem || "New initiative";
+    let msg = `\uD83D\uDCA1 <b>Proposal:</b> ${escapeHtml(suggestion2.title)}
+
+`;
+    msg += `${escapeHtml(truncateOutput(suggestion2.description, 800))}
+
+`;
+    msg += `<b>Complexity:</b> ${escapeHtml(complexity)}
+`;
+    msg += `<b>Related to:</b> ${escapeHtml(relatedTo)}`;
+    const buttons = [
+      [
+        import_telegraf5.Markup.button.callback("▶️ Start", `proposal_start_${suggestion2.id}`),
+        import_telegraf5.Markup.button.callback("⏭ Skip", `proposal_skip_${suggestion2.id}`),
+        import_telegraf5.Markup.button.callback("\uD83D\uDCCB Details", `proposal_details_${suggestion2.id}`)
+      ]
+    ];
+    await this.bot.telegram.sendMessage(this.chatId, msg, {
+      parse_mode: "HTML",
+      ...import_telegraf5.Markup.inlineKeyboard(buttons)
+    });
+  }
+  async notifySuggestion(suggestion2) {
+    const icon = SUGGESTION_TYPE_ICONS[suggestion2.type] ?? "\uD83D\uDCA1";
+    let msg = `${icon} <b>Suggestion:</b> ${escapeHtml(suggestion2.title)}
+
+`;
+    msg += `${escapeHtml(truncateOutput(suggestion2.description, 800))}
+`;
+    msg += `
+<b>Type:</b> ${escapeHtml(suggestion2.type)}`;
+    const buttons = [
+      [
+        import_telegraf5.Markup.button.callback("\uD83D\uDD27 Fix", `suggestion_fix_${suggestion2.id}`),
+        import_telegraf5.Markup.button.callback("⏭ Skip", `suggestion_skip_${suggestion2.id}`),
+        import_telegraf5.Markup.button.callback("\uD83D\uDCCB Details", `suggestion_details_${suggestion2.id}`)
+      ]
+    ];
+    await this.bot.telegram.sendMessage(this.chatId, msg, {
+      parse_mode: "HTML",
+      ...import_telegraf5.Markup.inlineKeyboard(buttons)
+    });
+  }
+}
+
 // src/bot.ts
 function createBot(config2) {
-  const bot = new import_telegraf5.Telegraf(config2.botToken, {
+  const bot = new import_telegraf6.Telegraf(config2.botToken, {
     handlerTimeout: HANDLER_TIMEOUT
   });
   const executor = new CliExecutor(config2);
+  const notifier = new Notifier(bot, config2.chatId);
   bot.use(async (ctx, next) => {
     const chatId = ctx.chat?.id;
     if (chatId !== config2.chatId) {
@@ -46030,22 +46658,22 @@ function createBot(config2) {
     { command: "upgrade", description: "Upgrade Locus CLI & restart bot" },
     { command: "help", description: "Show all commands" }
   ]).catch((err) => console.error("Failed to set bot commands:", err));
-  return bot;
+  return { bot, notifier };
 }
 
 // src/config.ts
 var import_dotenv = __toESM(require_main(), 1);
-import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
-import { join as join13 } from "node:path";
+import { existsSync as existsSync11, readFileSync as readFileSync10 } from "node:fs";
+import { join as join14 } from "node:path";
 import_dotenv.default.config();
 var SETTINGS_FILE2 = "settings.json";
 var CONFIG_DIR2 = ".locus";
 function loadSettings2(projectPath) {
-  const settingsPath = join13(projectPath, CONFIG_DIR2, SETTINGS_FILE2);
-  if (!existsSync10(settingsPath)) {
+  const settingsPath = join14(projectPath, CONFIG_DIR2, SETTINGS_FILE2);
+  if (!existsSync11(settingsPath)) {
     return null;
   }
-  const raw = readFileSync9(settingsPath, "utf-8");
+  const raw = readFileSync10(settingsPath, "utf-8");
   return JSON.parse(raw);
 }
 function resolveConfig() {
@@ -46082,6 +46710,66 @@ function resolveConfig() {
   };
 }
 
+// src/scheduler.ts
+var PROPOSAL_INTERVAL_MS = 6 * 60 * 60 * 1000;
+
+class ProposalScheduler {
+  config;
+  notifier;
+  timer = null;
+  running = false;
+  constructor(config2, notifier) {
+    this.config = config2;
+    this.notifier = notifier;
+  }
+  async start() {
+    if (!this.config.apiKey) {
+      console.log("[scheduler] API key not configured — proposal scheduling disabled");
+      return;
+    }
+    console.log("[scheduler] Starting proposal scheduler (every 6 hours)");
+    this.runCycle();
+    this.timer = setInterval(() => this.runCycle(), PROPOSAL_INTERVAL_MS);
+  }
+  stop() {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    console.log("[scheduler] Proposal scheduler stopped");
+  }
+  async runCycle() {
+    if (this.running) {
+      console.log("[scheduler] Proposal cycle already in progress, skipping");
+      return;
+    }
+    this.running = true;
+    const ts = new Date().toLocaleTimeString();
+    console.log(`[scheduler] Running proposal cycle at ${ts}`);
+    try {
+      const client = createClient(this.config);
+      const workspaceId = await resolveWorkspaceId(client, this.config);
+      const engine = new ProposalEngine;
+      const suggestions2 = await engine.runProposalCycle(this.config.projectPath, client, workspaceId);
+      if (suggestions2.length > 0) {
+        console.log(`[scheduler] ${suggestions2.length} proposal(s) generated`);
+        for (const s of suggestions2) {
+          console.log(`[scheduler]   - ${s.title}`);
+          this.notifier.notifyProposal(s).catch((err) => {
+            console.error("[scheduler] Failed to notify proposal:", err);
+          });
+        }
+      } else {
+        console.log("[scheduler] No new proposals generated");
+      }
+    } catch (err) {
+      console.error(`[scheduler] Proposal cycle failed: ${err instanceof Error ? err.message : String(err)}`);
+    } finally {
+      this.running = false;
+    }
+  }
+}
+
 // src/index.ts
 async function main() {
   console.log("Locus Telegram Bot");
@@ -46093,10 +46781,13 @@ async function main() {
   console.log(`API Key: ${config2.apiKey ? "configured" : "not set"}`);
   console.log(`----------------------------------------------
 `);
-  const bot = createBot(config2);
+  const { bot, notifier } = createBot(config2);
+  const scheduler = new ProposalScheduler(config2, notifier);
+  await scheduler.start();
   const shutdown = (signal) => {
     console.log(`
 Received ${signal}. Shutting down...`);
+    scheduler.stop();
     bot.stop(signal);
     process.exit(0);
   };

package/package.json

@@ -1,8 +1,18 @@
 {
   "name": "@locusai/telegram",
-  "version": "0.14.5",
+  "version": "0.15.1",
   "description": "Telegram bot for Locus - remote control your AI agents from Telegram",
   "type": "module",
+  "main": "./src/lib.ts",
+  "types": "./src/lib.ts",
+  "exports": {
+    ".": {
+      "types": "./src/lib.ts",
+      "development": "./src/lib.ts",
+      "import": "./src/lib.ts",
+      "default": "./src/lib.ts"
+    }
+  },
   "bin": {
     "locus-telegram": "./bin/telegram.js"
   },
@@ -31,8 +41,8 @@
   "author": "",
   "license": "MIT",
   "dependencies": {
-    "@locusai/sdk": "^0.14.5",
-    "@locusai/shared": "^0.14.5",
+    "@locusai/sdk": "^0.15.1",
+    "@locusai/shared": "^0.15.1",
     "dotenv": "^16.4.7",
     "telegraf": "^4.16.3"
   },