@link-assistant/hive-mind 2.7.4 → 2.8.0

package/src/fix.mjs

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+
+/**
+ * `/fix` command (issue #1733).
+ *
+ * Currently implements `--ci-cd`: automatically generate a CI/CD remediation
+ * issue for a target repository and (optionally) hand it off to
+ * `/solve --development-log --deep-analysis --auto-merge`.
+ *
+ *   fix.mjs <github-repository-url> --ci-cd [solve options...]
+ *
+ * Every option `/fix` does not consume itself (e.g. --tool, --model, --think)
+ * is forwarded to `/solve`.
+ */
+
+import path from 'path';
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { CI_CD_ISSUE_LABELS, CI_CD_ISSUE_TYPE, buildCiCdIssueBody, buildCiCdIssueTitle, buildSolveArgs, partitionFixArgs, summarizeRunFailures } from './fix.ci-cd.lib.mjs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+function printHelp() {
+  console.log(`Usage: fix.mjs <github-repository-url> --ci-cd [options]
+
+Automatically generate a CI/CD remediation issue for a repository and hand it
+off to /solve --development-log --deep-analysis --auto-merge.
+
+Options:
+  --ci-cd            Generate a CI/CD remediation issue (required mode)
+  --dry-run          Print the issue that would be created without creating it
+  --no-solve         Create the issue but do not start /solve on it
+  --version          Show version number
+  --help, -h         Show help
+
+All other options (e.g. --tool, --model, --think) are forwarded to /solve.
+
+Examples:
+  fix.mjs https://github.com/owner/repo --ci-cd
+  fix.mjs https://github.com/owner/repo --ci-cd --tool codex --model gpt-5.5
+  fix.mjs owner/repo --ci-cd --think max --no-solve`);
+}
+
+function runCommand(command, args, options = {}) {
+  return new Promise(resolve => {
+    const child = spawn(command, args, {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      env: process.env,
+      ...options,
+    });
+    let stdout = '';
+    let stderr = '';
+    child.stdout.on('data', data => {
+      stdout += data.toString();
+    });
+    child.stderr.on('data', data => {
+      stderr += data.toString();
+    });
+    child.on('error', error => {
+      resolve({ code: 1, stdout, stderr: stderr || error.message });
+    });
+    child.on('close', code => {
+      resolve({ code, stdout, stderr });
+    });
+  });
+}
+
+async function commandOutput(command, args) {
+  const result = await runCommand(command, args);
+  if (result.code !== 0) {
+    const output = `${result.stderr || ''}${result.stdout || ''}`.trim();
+    throw new Error(output || `${command} exited with code ${result.code}`);
+  }
+  return result.stdout.trim();
+}
+
+async function detectLanguages(repository) {
+  try {
+    const json = await commandOutput('gh', ['api', `repos/${repository.fullName}/languages`]);
+    return JSON.parse(json);
+  } catch (error) {
+    console.warn(`⚠️  Could not detect languages: ${error.message}`);
+    return {};
+  }
+}
+
+async function getDefaultBranch(repository) {
+  try {
+    return await commandOutput('gh', ['api', `repos/${repository.fullName}`, '--jq', '.default_branch']);
+  } catch (error) {
+    console.warn(`⚠️  Could not determine default branch: ${error.message}`);
+    return null;
+  }
+}
+
+async function getLatestCommit(repository, branch) {
+  if (!branch) return null;
+  try {
+    const json = await commandOutput('gh', ['api', `repos/${repository.fullName}/commits/${branch}`, '--jq', '{sha: .sha, message: .commit.message, url: .html_url}']);
+    return JSON.parse(json);
+  } catch (error) {
+    console.warn(`⚠️  Could not fetch latest commit: ${error.message}`);
+    return null;
+  }
+}
+
+const RUNS_JQ = '[.workflow_runs[] | {name: .name, status: .status, conclusion: .conclusion, html_url: .html_url, head_sha: .head_sha}]';
+
+async function getRunsForCommit(repository, sha) {
+  if (!sha) return [];
+  try {
+    const json = await commandOutput('gh', ['api', `repos/${repository.fullName}/actions/runs?head_sha=${sha}&per_page=100`, '--jq', RUNS_JQ]);
+    const parsed = JSON.parse(json);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch (error) {
+    console.warn(`⚠️  Could not fetch CI/CD runs: ${error.message}`);
+    return [];
+  }
+}
+
+async function getRecentBranchRuns(repository, branch) {
+  if (!branch) return [];
+  try {
+    const json = await commandOutput('gh', ['api', `repos/${repository.fullName}/actions/runs?branch=${encodeURIComponent(branch)}&per_page=20`, '--jq', RUNS_JQ]);
+    const parsed = JSON.parse(json);
+    return Array.isArray(parsed) ? parsed : [];
+  } catch (error) {
+    console.warn(`⚠️  Could not fetch recent CI/CD runs for branch ${branch}: ${error.message}`);
+    return [];
+  }
+}
+
+function resolveSolveCommand() {
+  return path.join(__dirname, 'solve.mjs');
+}
+
+async function main() {
+  const rawArgs = process.argv.slice(2);
+
+  if (rawArgs.includes('--version')) {
+    const { getVersion } = await import('./version.lib.mjs');
+    try {
+      console.log(await getVersion());
+    } catch {
+      console.error('Error: Unable to determine version');
+      process.exit(1);
+    }
+    return;
+  }
+
+  if (rawArgs.length === 0 || rawArgs.includes('--help') || rawArgs.includes('-h')) {
+    printHelp();
+    process.exit(rawArgs.length === 0 ? 1 : 0);
+  }
+
+  const parsed = partitionFixArgs(rawArgs);
+
+  if (!parsed.ciCd) {
+    console.error('❌ /fix currently supports only --ci-cd mode. Pass --ci-cd to continue.');
+    process.exit(1);
+  }
+
+  if (!parsed.repository) {
+    console.error('❌ Missing or invalid GitHub repository URL. Provide it as the first argument, e.g. fix.mjs https://github.com/owner/repo --ci-cd');
+    process.exit(1);
+  }
+
+  const repository = parsed.repository;
+  console.log(`🔧 /fix --ci-cd for ${repository.fullName}`);
+
+  const [languages, defaultBranch] = await Promise.all([detectLanguages(repository), getDefaultBranch(repository)]);
+  const commit = await getLatestCommit(repository, defaultBranch);
+  let runs = await getRunsForCommit(repository, commit?.sha);
+  let runsSource = 'commit';
+
+  // Release/tag commits frequently produce no runs of their own. Fall back to
+  // the most recent runs on the default branch so the issue stays actionable.
+  if (runs.length === 0) {
+    const branchRuns = await getRecentBranchRuns(repository, defaultBranch);
+    if (branchRuns.length > 0) {
+      runs = branchRuns;
+      runsSource = 'branch';
+    }
+  }
+
+  const { total, failing } = summarizeRunFailures(runs);
+  console.log(`   Default branch: ${defaultBranch || 'unknown'}`);
+  console.log(`   Latest commit:  ${commit?.sha ? commit.sha.slice(0, 7) : 'unknown'}`);
+  console.log(`   CI/CD runs:     ${total} (${failing} not passing)${runsSource === 'branch' ? ' [recent branch runs]' : ''}`);
+
+  const title = buildCiCdIssueTitle();
+  const body = buildCiCdIssueBody({ repository, defaultBranch, commit, runs, languages, runsSource });
+
+  if (parsed.dryRun) {
+    console.log('\n--- DRY RUN: issue that would be created ---\n');
+    console.log(`Title: ${title}\n`);
+    console.log(body);
+    return;
+  }
+
+  console.log('\n📝 Creating remediation issue...');
+  const { createTaskIssue } = await import('./task.issue-creation.lib.mjs');
+  const issue = await createTaskIssue({
+    repository,
+    title,
+    body,
+    // The Bug type is what makes /solve --deep-analysis emit the root-cause
+    // instructions this body omits (issue #1733).
+    issueType: CI_CD_ISSUE_TYPE,
+    labels: [...CI_CD_ISSUE_LABELS],
+    run: runCommand,
+    log: message => console.log(message),
+  });
+  console.log(`✅ Created issue: ${issue.url}`);
+
+  if (!parsed.runSolve) {
+    console.log('ℹ️  --no-solve set; skipping /solve. Run it manually with:');
+    console.log(`   solve ${buildSolveArgs({ issueUrl: issue.url, passthrough: parsed.passthrough }).join(' ')}`);
+    return;
+  }
+
+  const solveArgs = buildSolveArgs({ issueUrl: issue.url, passthrough: parsed.passthrough });
+  const solveCommand = resolveSolveCommand();
+  console.log(`\n🚀 Starting /solve: solve ${solveArgs.join(' ')}`);
+
+  await new Promise((resolve, reject) => {
+    const child = spawn(process.execPath, [solveCommand, ...solveArgs], {
+      stdio: 'inherit',
+      env: process.env,
+    });
+    child.on('error', reject);
+    child.on('close', code => {
+      if (code === 0) resolve();
+      else reject(new Error(`solve exited with code ${code}`));
+    });
+  });
+}
+
+main().catch(error => {
+  console.error(`❌ ${error.message}`);
+  process.exit(1);
+});

package/src/locales/en.lino

@@ -564,6 +564,11 @@ en
         enabled "*/split* - Split a GitHub issue into smaller issues"
         usage "Usage: `/split <github-issue-url> [options]` or `/task --split <github-issue-url>`"
         example "Example: `/split https://github.com/owner/repo/issues/123 --split-count 2`"
+      fix
+        enabled "*/fix* - Create a CI/CD remediation issue for a repository and solve it"
+        usage "Usage: `/fix <github-repository-url> [options]`"
+        example "Example: `/fix https://github.com/owner/repo --model sonnet`"
+        disabled "*/fix* - ❌ Disabled"
       hive
         enabled "*/hive* - Run hive command"
         usage "Usage: `/hive <github-url> [options]`"
@@ -590,7 +595,7 @@ en
       isolation
         mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
       group
-        note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /watch, /subscribe and /unsubscribe work in private and group chats."
+        note "⚠️ *Note:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop and /start commands only work in group chats. /terminal\\_watch, /watch, /subscribe and /unsubscribe work in private and group chats."
       common
         options "🔧 *Common Options:*"
       model

package/src/locales/hi.lino

@@ -564,6 +564,11 @@ hi
         enabled "*/split* - GitHub issue को छोटे issues में बाँटें"
         usage "उपयोग: `/split <github-issue-url> [options]` या `/task --split <github-issue-url>`"
         example "उदाहरण: `/split https://github.com/owner/repo/issues/123 --split-count 2`"
+      fix
+        enabled "*/fix* - repository के लिए CI/CD सुधार issue बनाएँ और उसे हल करें"
+        usage "उपयोग: `/fix <github-repository-url> [options]`"
+        example "उदाहरण: `/fix https://github.com/owner/repo --model sonnet`"
+        disabled "*/fix* - ❌ अक्षम"
       hive
         enabled "*/hive* - hive command चलाएँ"
         usage "उपयोग: `/hive <github-url> [options]`"
@@ -590,7 +595,7 @@ hi
       isolation
         mode "🔒 *Isolation Mode:* `{{isolationBackend}}` (experimental)"
       group
-        note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
+        note "⚠️ *नोट:* /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop और /start commands केवल group chats में काम करती हैं। /terminal\\_watch, /watch, /subscribe और /unsubscribe private और group chats में काम करती हैं।"
       common
         options "🔧 *Common Options:*"
       model

package/src/locales/ru.lino

@@ -564,6 +564,11 @@ ru
         enabled "*/split* - Разделить задачу GitHub на меньшие задачи"
         usage "Использование: `/split <github-issue-url> [options]` или `/task --split <github-issue-url>`"
         example "Пример: `/split https://github.com/owner/repo/issues/123 --split-count 2`"
+      fix
+        enabled "*/fix* - Создать задачу об исправлении CI/CD для репозитория и решить её"
+        usage "Использование: `/fix <github-repository-url> [options]`"
+        example "Пример: `/fix https://github.com/owner/repo --model sonnet`"
+        disabled "*/fix* - ❌ Отключено"
       hive
         enabled "*/hive* - Выполнить команду hive"
         usage "Использование: `/hive <github-url> [options]`"
@@ -590,7 +595,7 @@ ru
       isolation
         mode "🔒 *Режим изоляции:* `{{isolationBackend}}` (экспериментально)"
       group
-        note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
+        note "⚠️ *Замечание:* команды /solve, /do, /continue, /claude, /codex, /opencode, /agent, /gemini, /qwen, /task, /split, /fix, /hive, /queue, /limits, /version, /accept\\_invites, /merge, /stop и /start работают только в групповых чатах. /terminal\\_watch, /watch, /subscribe и /unsubscribe работают в личных и групповых чатах."
       common
         options "🔧 *Общие опции:*"
       model

package/src/locales/zh.lino

@@ -564,6 +564,11 @@ zh
         enabled "*/split* - 将 GitHub issue 拆分为更小的 issue"
         usage "用法：`/split <github-issue-url> [options]` 或 `/task --split <github-issue-url>`"
         example "示例：`/split https://github.com/owner/repo/issues/123 --split-count 2`"
+      fix
+        enabled "*/fix* - 为仓库创建 CI/CD 修复 issue 并解决它"
+        usage "用法：`/fix <github-repository-url> [options]`"
+        example "示例：`/fix https://github.com/owner/repo --model sonnet`"
+        disabled "*/fix* - ❌ 已禁用"
       hive
         enabled "*/hive* - 运行 hive 命令"
         usage "用法：`/hive <github-url> [options]`"
@@ -590,7 +595,7 @@ zh
       isolation
         mode "🔒 *隔离模式：* `{{isolationBackend}}`（实验性）"
       group
-        note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/hive、/queue、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
+        note "⚠️ *注意：* /solve、/do、/continue、/claude、/codex、/opencode、/agent、/gemini、/qwen、/task、/split、/fix、/hive、/queue、/limits、/version、/accept\\_invites、/merge、/stop 和 /start 仅在群聊中有效。/terminal\\_watch、/watch、/subscribe 和 /unsubscribe 在私聊和群聊中有效。"
       common
         options "🔧 *常用选项：*"
       model

package/src/task.issue-creation.lib.mjs

@@ -196,18 +196,44 @@ export function parseCreatedTaskIssueOutput(output) {
   throw new Error(`Could not parse created issue URL from gh output: ${String(output || '').trim()}`);
 }
 
-export async function createTaskIssue({ repository, title, body, run = runCommand }) {
+export function buildCreateIssueArgs({ repository, title, bodyFile, issueType = null, labels = [] }) {
+  const args = ['issue', 'create', '--repo', repository.fullName, '--title', title, '--body-file', bodyFile];
+  if (issueType) args.push('--type', issueType);
+  for (const label of labels) args.push('--label', label);
+  return args;
+}
+
+/**
+ * Create an issue via `gh issue create`.
+ *
+ * `issueType` and `labels` are optional and best-effort: issue types are
+ * configured per organization and labels per repository, so a target repo may
+ * not have them. Rather than failing the whole command, a rejected create is
+ * retried once without them (issue #1733).
+ */
+export async function createTaskIssue({ repository, title, body, issueType = null, labels = [], run = runCommand, log = null }) {
   const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'hive-mind-task-issue-'));
   const bodyFile = path.join(tempDir, 'body.md');
 
   try {
     await fs.writeFile(bodyFile, body);
-    const result = await run('gh', ['issue', 'create', '--repo', repository.fullName, '--title', title, '--body-file', bodyFile]);
-    if (result.code !== 0) {
-      const output = `${result.stderr || ''}${result.stdout || ''}`.trim();
+
+    const result = await run('gh', buildCreateIssueArgs({ repository, title, bodyFile, issueType, labels }));
+    if (result.code === 0) return parseCreatedTaskIssueOutput(result.stdout);
+
+    const output = `${result.stderr || ''}${result.stdout || ''}`.trim();
+    const usedOptionalMetadata = Boolean(issueType) || labels.length > 0;
+    if (!usedOptionalMetadata) {
       throw new Error(output || `gh issue create exited with code ${result.code}`);
     }
-    return parseCreatedTaskIssueOutput(result.stdout);
+
+    await log?.(`⚠️  Could not create issue with type/labels (${output || `exit code ${result.code}`}); retrying without them`);
+    const retry = await run('gh', buildCreateIssueArgs({ repository, title, bodyFile }));
+    if (retry.code !== 0) {
+      const retryOutput = `${retry.stderr || ''}${retry.stdout || ''}`.trim();
+      throw new Error(retryOutput || `gh issue create exited with code ${retry.code}`);
+    }
+    return parseCreatedTaskIssueOutput(retry.stdout);
   } finally {
     await fs.rm(tempDir, { recursive: true, force: true }).catch(() => {});
   }

package/src/telegram-bot.mjs

@@ -23,94 +23,14 @@ dotenvx.config({ quiet: true, ignore: ['MISSING_ENV_FILE'] });
 await loadLenvConfig({ override: true, quiet: true });
 
 const yargs = getLinoYargsFactory();
+const { createYargsConfig: createTelegramYargsConfig } = await import('./telegram.config.lib.mjs');
 const { createYargsConfig: createSolveYargsConfig, detectMalformedFlags } = await import('./solve.config.lib.mjs');
 const { createYargsConfig: createHiveYargsConfig } = await import('./hive.config.lib.mjs');
 const { enhanceUnknownArgumentError } = await import('./option-suggestions.lib.mjs');
 const { validateBranchInArgs } = await import('./solve.branch.lib.mjs');
 const { extractIsolationFromArgs, isValidPerCommandIsolation } = await import('./telegram-isolation.lib.mjs');
 
-const config = yargs(hideBin(process.argv))
-  .usage('Usage: hive-telegram-bot [options]')
-  .option('configuration', {
-    type: 'string',
-    description: 'LINO configuration string for environment variables',
-    alias: 'c',
-    default: getenv('TELEGRAM_CONFIGURATION', ''),
-  })
-  .option('token', {
-    type: 'string',
-    description: 'Telegram bot token from @BotFather',
-    alias: 't',
-    default: getenv('TELEGRAM_BOT_TOKEN', ''),
-  })
-  .option('allowedChats', {
-    type: 'string',
-    description: 'Allowed chat IDs in lino notation, e.g., "(\n  123456789\n  987654321\n)"',
-    alias: 'allowed-chats',
-    default: getenv('TELEGRAM_ALLOWED_CHATS', ''),
-  })
-  .option('allowedTopics', {
-    type: 'string',
-    description: 'Allowed topic IDs in Links Notation format "chatId topicId" pairs',
-    alias: 'allowed-topics',
-    default: getenv('TELEGRAM_ALLOWED_TOPICS', ''),
-  })
-  .option('solveOverrides', {
-    type: 'string',
-    description: 'Override options for /solve command in lino notation, e.g., "(\n  --auto-continue\n  --attach-logs\n)"',
-    alias: 'solve-overrides',
-    default: getenv('TELEGRAM_SOLVE_OVERRIDES', ''),
-  })
-  .option('hiveOverrides', {
-    type: 'string',
-    description: 'Override options for /hive command in lino notation, e.g., "(\n  --verbose\n  --all-issues\n)"',
-    alias: 'hive-overrides',
-    default: getenv('TELEGRAM_HIVE_OVERRIDES', ''),
-  })
-  .option('solve', {
-    type: 'boolean',
-    description: 'Enable /solve command (use --no-solve to disable)',
-    default: getenv('TELEGRAM_SOLVE', 'true') !== 'false',
-  })
-  .option('hive', {
-    type: 'boolean',
-    description: 'Enable /hive command (use --no-hive to disable)',
-    default: getenv('TELEGRAM_HIVE', 'true') !== 'false',
-  })
-  .option('task', {
-    type: 'boolean',
-    description: 'Enable /task and /split commands (use --no-task to disable)',
-    default: getenv('TELEGRAM_TASK', 'true') !== 'false',
-  })
-  .option('auth', {
-    type: 'boolean',
-    description: 'Enable experimental private /auth command for allowlisted chat owners (use --no-auth to disable)',
-    default: getenv('TELEGRAM_AUTH', 'true') !== 'false',
-  })
-  .option('dryRun', {
-    type: 'boolean',
-    description: 'Validate configuration and options without starting the bot',
-    alias: 'dry-run',
-    default: false,
-  })
-  .option('verbose', {
-    type: 'boolean',
-    description: 'Enable verbose logging for debugging',
-    alias: 'v',
-    default: getenv('TELEGRAM_BOT_VERBOSE', 'false') === 'true',
-  })
-  .option('autoStartScreenWatchMessage', { type: 'boolean', description: 'Experimental: auto-start separate /terminal_watch messages for public /solve sessions', alias: 'auto-start-screen-watch-message', default: getenv('TELEGRAM_AUTO_START_SCREEN_WATCH_MESSAGE', getenv('TELEGRAM_AUTO_WATCH_MESSAGE', 'false')) === 'true' })
-  // Issue #594: bot-owner toggle for --show-limits virtual option in /solve and /hive.
-  .option('showLimits', { type: 'boolean', description: 'Experimental: allow /solve and /hive callers to use --show-limits to embed Claude/Codex usage at start, end, and delta in the completion message', alias: 'show-limits', default: getenv('TELEGRAM_SHOW_LIMITS', 'true') !== 'false' })
-  .option('isolation', { type: 'string', description: "Isolation backend (screen/tmux/docker). Defaults to 'docker' so Telegram-bot work sessions run in Docker isolation; pass --isolation '' (or set TELEGRAM_ISOLATION='') to disable.", default: getenv('TELEGRAM_ISOLATION', 'docker') })
-  .help('h')
-  .alias('h', 'help')
-  .parserConfiguration({
-    'boolean-negation': true,
-    'strip-dashed': true, // Remove dashed keys from argv to simplify validation
-  })
-  .strict() // Enable strict mode to reject unknown options (consistent with solve.mjs and hive.mjs)
-  .parse();
+const config = createTelegramYargsConfig(yargs(hideBin(process.argv))).parse();
 
 // Configuration priority: CLI option > --configuration LINO > .lenv > .env
 if (config.configuration) {
@@ -150,6 +70,7 @@ const hiveOverrides = resolvedHiveOverrides
 const solveEnabled = config.solve;
 const hiveEnabled = config.hive;
 const taskEnabled = config.task;
+const fixEnabled = config.fix;
 const authEnabled = config.auth;
 // Isolation mode (experimental): uses `$` from start-command with specified backend
 const ISOLATION_BACKEND = (config.isolation || getenv('TELEGRAM_ISOLATION', '')).trim().toLowerCase();
@@ -299,7 +220,7 @@ if (config.dryRun) {
   if (allowedTopics && allowedTopics.length > 0) {
     console.log('  Allowed topics:', lino.formatLinks(allowedTopics));
   }
-  console.log('  Commands enabled:', { solve: solveEnabled, hive: hiveEnabled, task: taskEnabled, auth: authEnabled });
+  console.log('  Commands enabled:', { solve: solveEnabled, hive: hiveEnabled, task: taskEnabled, fix: fixEnabled, auth: authEnabled });
   if (solveOverrides.length > 0) {
     console.log('  Solve overrides:', lino.format(solveOverrides));
   }
@@ -570,6 +491,7 @@ bot.command('help', async ctx => {
     stopReason: stopInfo?.reason || DEFAULT_STOP_REASON,
     solveEnabled,
     taskEnabled,
+    fixEnabled,
     hiveEnabled,
     solveOverrides,
     hiveOverrides,
@@ -672,6 +594,8 @@ const { registerSubscribeCommands } = await import('./telegram-subscribers.lib.m
 registerSubscribeCommands(bot, sharedCommandOpts);
 const { registerTaskCommands } = await import('./telegram-task-command.lib.mjs');
 const { handleTaskCommand, TASK_COMMAND_NAMES } = registerTaskCommands(bot, { ...sharedCommandOpts, taskEnabled, safeReply, executeAndUpdateMessage, resolveLocale: resolveLocaleFromTelegramCtx });
+const { registerFixCommand } = await import('./telegram-fix-command.lib.mjs');
+const { handleFixCommand, FIX_COMMAND_NAMES } = registerFixCommand(bot, { ...sharedCommandOpts, fixEnabled, safeReply, executeAndUpdateMessage, resolveLocale: resolveLocaleFromTelegramCtx });
 const { registerAuthCommand } = await import('./telegram-auth-command.lib.mjs');
 const { handleAuthCommand } = registerAuthCommand(bot, { ...sharedCommandOpts, allowedChats, authEnabled, safeReply });
 
@@ -1235,7 +1159,8 @@ bot.on('message', async (ctx, next) => {
   // /subscribe + /unsubscribe (#1688) are intentionally not in the text fallback — Telegraf's bot.command() is sufficient.
   const solveHandlers = Object.fromEntries(SOLVE_COMMAND_NAMES.map(command => [command, handleSolveCommand]));
   const taskHandlers = Object.fromEntries(TASK_COMMAND_NAMES.map(command => [command, handleTaskCommand]));
-  const handlers = { ...solveHandlers, ...taskHandlers, auth: handleAuthCommand, hive: handleHiveCommand, queue: handleSolveQueueCommand };
+  const fixHandlers = Object.fromEntries(FIX_COMMAND_NAMES.map(command => [command, handleFixCommand]));
+  const handlers = { ...solveHandlers, ...taskHandlers, ...fixHandlers, auth: handleAuthCommand, hive: handleHiveCommand, queue: handleSolveQueueCommand };
 
   const handler = handlers[extracted.command];
   if (!handler) return next();
@@ -1344,7 +1269,7 @@ if (allowedChats && allowedChats.length > 0) {
 if (allowedTopics && allowedTopics.length > 0) {
   console.log('Allowed topics (lino):', lino.formatLinks(allowedTopics));
 }
-console.log('Commands enabled:', { solve: solveEnabled, hive: hiveEnabled, task: taskEnabled, auth: authEnabled });
+console.log('Commands enabled:', { solve: solveEnabled, hive: hiveEnabled, task: taskEnabled, fix: fixEnabled, auth: authEnabled });
 if (solveOverrides.length > 0) console.log('Solve overrides (lino):', lino.format(solveOverrides));
 if (hiveOverrides.length > 0) console.log('Hive overrides (lino):', lino.format(hiveOverrides));
 if (VERBOSE) {