@locusai/locus-telegram 0.21.10 → 0.21.11

package/README.md

@@ -28,7 +28,7 @@ Multiple chat IDs can be comma-separated: `"12345678,87654321"`
 ### 4. Install & Start
 
 ```sh
-locus install locus-telegram
+locus install telegram
 locus pkg telegram start
 ```
 

package/package.json

@@ -1,11 +1,17 @@
 {
   "name": "@locusai/locus-telegram",
-  "version": "0.21.10",
+  "version": "0.21.11",
   "description": "Remote-control Locus via Telegram with full CLI mapping, git operations, and PM2 management",
   "type": "module",
   "bin": {
     "locus-telegram": "./bin/locus-telegram.js"
   },
+  "files": [
+    "bin",
+    "dist",
+    "package.json",
+    "README.md"
+  ],
   "locus": {
     "displayName": "Telegram",
     "description": "Remote-control your Locus agent from Telegram",
@@ -21,7 +27,7 @@
     "format": "biome format --write ."
   },
   "dependencies": {
-    "@locusai/sdk": "^0.21.10",
+    "@locusai/sdk": "^0.21.11",
     "grammy": "^1.35.0",
     "pm2": "^6.0.5"
   },

package/CHANGELOG.md

@@ -1,34 +0,0 @@
-# @locusai/locus-telegram
-
-## 0.21.10
-
-### Patch Changes
-
-- Package resolution
-- Updated dependencies
-  - @locusai/sdk@0.21.10
-
-## 0.21.9
-
-### Patch Changes
-
-- Locus package names convention fixes
-- Updated dependencies
-  - @locusai/sdk@0.21.9
-
-## 0.21.8
-
-### Patch Changes
-
-- Continious learning improvements
-  Fix Telegram package installation issue
-- Updated dependencies
-  - @locusai/sdk@0.21.8
-
-## 0.21.7
-
-### Patch Changes
-
-- Initial telegram package
-- Updated dependencies
-  - @locusai/sdk@0.21.7

package/src/bot.ts

@@ -1,256 +0,0 @@
-/**
- * Bot instance — sets up grammy bot, registers middleware, commands,
- * and callback query handlers.
- */
-
-import { createLogger } from "@locusai/sdk";
-import { Bot } from "grammy";
-import {
-  handleBranch,
-  handleCheckout,
-  handleCommit,
-  handleDiff,
-  handleGitStatus,
-  handlePR,
-  handleStage,
-  handleStash,
-} from "./commands/git.js";
-import { handleLocusCommand } from "./commands/locus.js";
-import { handleService } from "./commands/service.js";
-import type { TelegramConfig } from "./config.js";
-import { formatInfo, formatSuccess } from "./ui/format.js";
-import { CB } from "./ui/keyboards.js";
-import { welcomeMessage } from "./ui/messages.js";
-
-const logger = createLogger("telegram");
-
-// ─── Bot Factory ────────────────────────────────────────────────────────────
-
-export function createBot(config: TelegramConfig): Bot {
-  const bot = new Bot(config.botToken);
-
-  // ── Auth Middleware ─────────────────────────────────────────────────────
-  bot.use(async (ctx, next) => {
-    const chatId = ctx.chat?.id;
-    if (!chatId || !config.allowedChatIds.includes(chatId)) {
-      logger.warn("Unauthorized access attempt", {
-        chatId,
-        from: ctx.from?.username,
-      });
-      return; // silently ignore
-    }
-    await next();
-  });
-
-  // ── Help / Start ────────────────────────────────────────────────────────
-  bot.command("start", async (ctx) => {
-    await ctx.reply(welcomeMessage(), { parse_mode: "HTML" });
-  });
-
-  bot.command("help", async (ctx) => {
-    await ctx.reply(welcomeMessage(), { parse_mode: "HTML" });
-  });
-
-  // ── Locus CLI Commands ──────────────────────────────────────────────────
-  const locusCommands = [
-    "run",
-    "status",
-    "issues",
-    "issue",
-    "sprint",
-    "plan",
-    "review",
-    "iterate",
-    "discuss",
-    "exec",
-    "logs",
-    "config",
-    "artifacts",
-  ];
-
-  for (const cmd of locusCommands) {
-    bot.command(cmd, async (ctx) => {
-      const args = parseArgs(ctx.message?.text ?? "", cmd);
-      await handleLocusCommand(ctx, cmd, args);
-    });
-  }
-
-  // ── Git Commands ────────────────────────────────────────────────────────
-  bot.command("gitstatus", async (ctx) => {
-    await handleGitStatus(ctx);
-  });
-
-  bot.command("stage", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "stage");
-    await handleStage(ctx, args);
-  });
-
-  bot.command("commit", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "commit");
-    await handleCommit(ctx, args);
-  });
-
-  bot.command("stash", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "stash");
-    await handleStash(ctx, args);
-  });
-
-  bot.command("branch", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "branch");
-    await handleBranch(ctx, args);
-  });
-
-  bot.command("checkout", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "checkout");
-    await handleCheckout(ctx, args);
-  });
-
-  bot.command("diff", async (ctx) => {
-    await handleDiff(ctx);
-  });
-
-  bot.command("pr", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "pr");
-    await handlePR(ctx, args);
-  });
-
-  // ── Service Commands ────────────────────────────────────────────────────
-  bot.command("service", async (ctx) => {
-    const args = parseArgs(ctx.message?.text ?? "", "service");
-    await handleService(ctx, args);
-  });
-
-  // ── Callback Query Handlers ─────────────────────────────────────────────
-  registerCallbackHandlers(bot);
-
-  // ── Fallback ────────────────────────────────────────────────────────────
-  bot.on("message:text", async (ctx) => {
-    // Treat non-command text as a locus exec prompt
-    const text = ctx.message.text;
-    if (text.startsWith("/")) return; // unknown command — ignore
-
-    await handleLocusCommand(ctx, "exec", [text]);
-  });
-
-  return bot;
-}
-
-// ─── Callback Query Handlers ────────────────────────────────────────────────
-
-function registerCallbackHandlers(bot: Bot): void {
-  // Plan callbacks
-  bot.callbackQuery(CB.APPROVE_PLAN, async (ctx) => {
-    await ctx.answerCallbackQuery({ text: "Plan approved!" });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await ctx.reply(formatSuccess("Plan approved. Starting execution..."), {
-      parse_mode: "HTML",
-    });
-    // Trigger the run
-    await handleLocusCommand(ctx, "run", []);
-  });
-
-  bot.callbackQuery(CB.REJECT_PLAN, async (ctx) => {
-    await ctx.answerCallbackQuery({ text: "Plan rejected." });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await ctx.reply(formatInfo("Plan rejected. No changes will be made."), {
-      parse_mode: "HTML",
-    });
-  });
-
-  bot.callbackQuery(CB.SHOW_PLAN_DETAILS, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleLocusCommand(ctx, "plan", ["--show"]);
-  });
-
-  // Run callbacks
-  bot.callbackQuery(CB.VIEW_LOGS, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleLocusCommand(ctx, "logs", ["--lines", "30"]);
-  });
-
-  bot.callbackQuery(/^run:again:(\d+)$/, async (ctx) => {
-    const issue = ctx.match[1];
-    await ctx.answerCallbackQuery({ text: `Re-running issue #${issue}` });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await handleLocusCommand(ctx, "run", [issue]);
-  });
-
-  // Review callbacks
-  bot.callbackQuery(/^review:approve:(\d+)$/, async (ctx) => {
-    const pr = ctx.match[1];
-    await ctx.answerCallbackQuery({ text: "Approving PR..." });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await ctx.reply(formatSuccess(`Approved PR #${pr}`), {
-      parse_mode: "HTML",
-    });
-  });
-
-  bot.callbackQuery(/^review:changes:(\d+)$/, async (ctx) => {
-    const pr = ctx.match[1];
-    await ctx.answerCallbackQuery();
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await ctx.reply(
-      formatInfo(
-        `Requesting changes on PR #${pr}. Reply with your feedback and I'll pass it along via /iterate ${pr}`
-      ),
-      { parse_mode: "HTML" }
-    );
-  });
-
-  bot.callbackQuery(/^review:diff:(\d+)$/, async (ctx) => {
-    const pr = ctx.match[1];
-    await ctx.answerCallbackQuery();
-    await handleLocusCommand(ctx, "review", [pr, "--diff"]);
-  });
-
-  // Status callbacks
-  bot.callbackQuery(CB.RUN_SPRINT, async (ctx) => {
-    await ctx.answerCallbackQuery({ text: "Starting sprint run..." });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await handleLocusCommand(ctx, "run", []);
-  });
-
-  bot.callbackQuery(CB.VIEW_ISSUES, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleLocusCommand(ctx, "issues", []);
-  });
-
-  // Stash callbacks
-  bot.callbackQuery(CB.STASH_POP, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleStash(ctx, ["pop"]);
-  });
-
-  bot.callbackQuery(CB.STASH_LIST, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleStash(ctx, ["list"]);
-  });
-
-  bot.callbackQuery(CB.STASH_DROP, async (ctx) => {
-    await ctx.answerCallbackQuery();
-    await handleStash(ctx, ["drop"]);
-  });
-
-  // Confirmation callbacks
-  bot.callbackQuery(CB.CONFIRM_ACTION, async (ctx) => {
-    await ctx.answerCallbackQuery({ text: "Confirmed!" });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-  });
-
-  bot.callbackQuery(CB.CANCEL_ACTION, async (ctx) => {
-    await ctx.answerCallbackQuery({ text: "Cancelled." });
-    await ctx.editMessageReplyMarkup({ reply_markup: undefined });
-    await ctx.reply(formatInfo("Action cancelled."), { parse_mode: "HTML" });
-  });
-}
-
-// ─── Helpers ────────────────────────────────────────────────────────────────
-
-/** Parse arguments from a Telegram command message. */
-function parseArgs(text: string, command: string): string[] {
-  // Remove the /command part (handles @botname suffix too)
-  const prefixRegex = new RegExp(`^/${command}(@\\S+)?\\s*`);
-  const rest = text.replace(prefixRegex, "").trim();
-  if (!rest) return [];
-  return rest.split(/\s+/);
-}

package/src/commands/git.ts

@@ -1,309 +0,0 @@
-/**
- * Git command handlers — stage, commit, stash, branch, checkout, diff, PR.
- *
- * Uses direct git subprocess calls for fast, local operations.
- * PR creation uses `gh` CLI (same as the locus CLI does).
- */
-
-import { execSync } from "node:child_process";
-import type { Context } from "grammy";
-import {
-  bold,
-  codeBlock,
-  escapeHtml,
-  formatError,
-  formatSuccess,
-} from "../ui/format.js";
-import { stashKeyboard } from "../ui/keyboards.js";
-import {
-  gitBranchCreatedMessage,
-  gitCheckoutMessage,
-  gitCommitMessage,
-  gitStashMessage,
-  prCreatedMessage,
-} from "../ui/messages.js";
-
-// ─── Git Helper ─────────────────────────────────────────────────────────────
-
-function git(args: string): string {
-  return execSync(`git ${args}`, {
-    encoding: "utf-8",
-    stdio: ["pipe", "pipe", "pipe"],
-    cwd: process.cwd(),
-  });
-}
-
-function gitSafe(args: string): string | null {
-  try {
-    return git(args);
-  } catch {
-    return null;
-  }
-}
-
-// ─── Command Handlers ───────────────────────────────────────────────────────
-
-/** /gitstatus — show git status */
-export async function handleGitStatus(ctx: Context): Promise<void> {
-  try {
-    const status = git("status --short");
-    if (!status.trim()) {
-      await ctx.reply(formatSuccess("Working tree is clean."), {
-        parse_mode: "HTML",
-      });
-      return;
-    }
-
-    const branch = git("branch --show-current").trim();
-    await ctx.reply(
-      `${bold("Branch:")} ${escapeHtml(branch)}\n\n${codeBlock(status)}`,
-      { parse_mode: "HTML" }
-    );
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Failed to get git status", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /stage [files|.] — stage files for commit */
-export async function handleStage(ctx: Context, args: string[]): Promise<void> {
-  const target = args.length > 0 ? args.join(" ") : ".";
-
-  try {
-    git(`add ${target}`);
-    const status = git("status --short");
-    await ctx.reply(
-      `${formatSuccess(`Staged: ${target}`)}\n\n${codeBlock(status)}`,
-      { parse_mode: "HTML" }
-    );
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Failed to stage files", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /commit <message> — commit staged changes */
-export async function handleCommit(
-  ctx: Context,
-  args: string[]
-): Promise<void> {
-  if (args.length === 0) {
-    await ctx.reply(formatError("Usage: /commit <message>"), {
-      parse_mode: "HTML",
-    });
-    return;
-  }
-
-  const message = args.join(" ");
-
-  try {
-    const result = git(`commit -m ${JSON.stringify(message)}`);
-    // Extract short hash from commit output
-    const hashMatch = result.match(/\[[\w/.-]+ ([a-f0-9]+)\]/);
-    const hash = hashMatch?.[1] ?? "unknown";
-
-    await ctx.reply(gitCommitMessage(message, hash), {
-      parse_mode: "HTML",
-    });
-  } catch (error: unknown) {
-    const errStr = String(error);
-    if (errStr.includes("nothing to commit")) {
-      await ctx.reply(
-        formatError("Nothing to commit. Stage changes first with /stage"),
-        {
-          parse_mode: "HTML",
-        }
-      );
-    } else {
-      await ctx.reply(formatError("Failed to commit", errStr), {
-        parse_mode: "HTML",
-      });
-    }
-  }
-}
-
-/** /stash [pop|list|drop|save] — stash operations */
-export async function handleStash(ctx: Context, args: string[]): Promise<void> {
-  const subcommand = args[0] ?? "push";
-
-  try {
-    switch (subcommand) {
-      case "push":
-      case "save": {
-        const message = args.slice(1).join(" ");
-        const stashArgs = message
-          ? `stash push -m ${JSON.stringify(message)}`
-          : "stash push";
-        git(stashArgs);
-        await ctx.reply(gitStashMessage("Changes stashed"), {
-          parse_mode: "HTML",
-          reply_markup: stashKeyboard(),
-        });
-        break;
-      }
-      case "pop": {
-        git("stash pop");
-        await ctx.reply(gitStashMessage("Stash popped"), {
-          parse_mode: "HTML",
-        });
-        break;
-      }
-      case "list": {
-        const list = gitSafe("stash list") ?? "";
-        if (!list.trim()) {
-          await ctx.reply(formatSuccess("No stashes."), {
-            parse_mode: "HTML",
-          });
-        } else {
-          await ctx.reply(codeBlock(list), { parse_mode: "HTML" });
-        }
-        break;
-      }
-      case "drop": {
-        const stashRef = args[1] ?? "stash@{0}";
-        git(`stash drop ${stashRef}`);
-        await ctx.reply(gitStashMessage(`Dropped ${stashRef}`), {
-          parse_mode: "HTML",
-        });
-        break;
-      }
-      default: {
-        // Default: just stash
-        git("stash push");
-        await ctx.reply(gitStashMessage("Changes stashed"), {
-          parse_mode: "HTML",
-          reply_markup: stashKeyboard(),
-        });
-      }
-    }
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Stash operation failed", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /branch [name] — list branches or create a new one */
-export async function handleBranch(
-  ctx: Context,
-  args: string[]
-): Promise<void> {
-  try {
-    if (args.length === 0) {
-      // List branches
-      const branches = git("branch -a --format='%(refname:short)'");
-      const current = git("branch --show-current").trim();
-      await ctx.reply(
-        `${bold("Current:")} ${escapeHtml(current)}\n\n${codeBlock(branches)}`,
-        { parse_mode: "HTML" }
-      );
-    } else {
-      // Create new branch
-      const branchName = args[0];
-      git(`branch ${branchName}`);
-      await ctx.reply(gitBranchCreatedMessage(branchName), {
-        parse_mode: "HTML",
-      });
-    }
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Branch operation failed", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /checkout <branch> — switch to a branch */
-export async function handleCheckout(
-  ctx: Context,
-  args: string[]
-): Promise<void> {
-  if (args.length === 0) {
-    await ctx.reply(formatError("Usage: /checkout <branch>"), {
-      parse_mode: "HTML",
-    });
-    return;
-  }
-
-  const branch = args[0];
-
-  try {
-    git(`checkout ${branch}`);
-    await ctx.reply(gitCheckoutMessage(branch), { parse_mode: "HTML" });
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Checkout failed", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /diff — show git diff summary */
-export async function handleDiff(ctx: Context): Promise<void> {
-  try {
-    const diff = git("diff --stat");
-    if (!diff.trim()) {
-      const staged = git("diff --cached --stat");
-      if (!staged.trim()) {
-        await ctx.reply(formatSuccess("No changes."), {
-          parse_mode: "HTML",
-        });
-      } else {
-        await ctx.reply(`${bold("Staged changes:")}\n\n${codeBlock(staged)}`, {
-          parse_mode: "HTML",
-        });
-      }
-    } else {
-      await ctx.reply(`${bold("Unstaged changes:")}\n\n${codeBlock(diff)}`, {
-        parse_mode: "HTML",
-      });
-    }
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Diff failed", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}
-
-/** /pr <title> — create a pull request */
-export async function handlePR(ctx: Context, args: string[]): Promise<void> {
-  if (args.length === 0) {
-    await ctx.reply(formatError("Usage: /pr <title>"), {
-      parse_mode: "HTML",
-    });
-    return;
-  }
-
-  const title = args.join(" ");
-
-  try {
-    // Push current branch first
-    const branch = git("branch --show-current").trim();
-    try {
-      git(`push -u origin ${branch}`);
-    } catch {
-      // May already be pushed — continue
-    }
-
-    // Create PR using gh CLI
-    const result = execSync(
-      `gh pr create --title ${JSON.stringify(title)} --body "Created via Locus Telegram Bot" --head ${branch}`,
-      {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"],
-        cwd: process.cwd(),
-      }
-    );
-
-    const prMatch = result.match(/\/pull\/(\d+)/);
-    const prNumber = prMatch ? Number(prMatch[1]) : 0;
-
-    await ctx.reply(prCreatedMessage(prNumber, result.trim()), {
-      parse_mode: "HTML",
-    });
-  } catch (error: unknown) {
-    await ctx.reply(formatError("Failed to create PR", String(error)), {
-      parse_mode: "HTML",
-    });
-  }
-}