@link-assistant/hive-mind 1.59.7 → 1.60.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @link-assistant/hive-mind
 
+## 1.60.0
+
+### Minor Changes
+
+- Add issue-based task splitting with `/task` and `/split` Telegram commands.
+
 ## 1.59.7
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@link-assistant/hive-mind",
-  "version": "1.59.7",
+  "version": "1.60.0",
   "description": "AI-powered issue solver and hive mind for collaborative problem solving",
   "main": "src/hive.mjs",
   "type": "module",
@@ -72,8 +72,10 @@
     "@secretlint/secretlint-rule-preset-recommend": "^11.2.5",
     "@sentry/node": "^10.15.0",
     "@sentry/profiling-node": "^10.15.0",
+    "agent-commander": "^0.4.2",
     "dayjs": "^1.11.19",
     "decimal.js-light": "^2.5.1",
+    "lino-arguments": "^0.3.0",
     "secretlint": "^11.2.5",
     "semver": "^7.7.3"
   },

package/src/cli-arguments.lib.mjs

@@ -0,0 +1,68 @@
+import { getenv, makeConfig, yargs as linoYargs } from 'lino-arguments';
+
+export { getenv };
+
+export const hideBin = argv => argv.slice(2);
+
+export const getLinoYargsFactory = () => linoYargs;
+
+const toKebabCase = key =>
+  key
+    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+    .replace(/[_\s]+/g, '-')
+    .toLowerCase();
+
+const toCamelCase = key => key.replace(/[-_\s]+(.)?/g, (_, char) => (char ? char.toUpperCase() : ''));
+
+const ensureFullArgv = (argv, commandName) => {
+  if (argv.length >= 2 && (argv[0].includes('/') || argv[0] === 'node' || argv[0].endsWith('node'))) {
+    return argv;
+  }
+  return ['node', commandName, ...argv];
+};
+
+export function addCliCompatibilityAliases(parsed, { positionalAliases = [] } = {}) {
+  const result = {};
+  for (const [key, value] of Object.entries(parsed)) {
+    if (value === undefined) continue;
+    result[key] = value;
+  }
+
+  for (const [key, value] of Object.entries(result)) {
+    const kebabKey = toKebabCase(key);
+    if (kebabKey && result[kebabKey] === undefined) {
+      result[kebabKey] = value;
+    }
+  }
+
+  const positionalValues = [];
+  for (const alias of positionalAliases) {
+    const camelAlias = toCamelCase(alias);
+    const value = result[alias] ?? result[camelAlias];
+    if (value !== undefined) {
+      result[alias] = value;
+      result[camelAlias] = value;
+      positionalValues.push(value);
+    }
+  }
+  result._ = positionalValues;
+
+  return result;
+}
+
+export function parseCliArgumentsWithLino({ argv = process.argv, commandName = 'cli', createYargsConfig, positionalAliases = [], lenv = { enabled: true }, env = { enabled: false }, getenv: getenvOptions = { enabled: true } } = {}) {
+  const fullArgv = ensureFullArgv(argv, commandName);
+  const parsed = makeConfig({
+    argv: fullArgv,
+    lenv,
+    env,
+    getenv: getenvOptions,
+    yargs: ({ yargs, getenv: getenvHelper }) => {
+      const parser = yargs.exitProcess(false);
+      const configured = createYargsConfig ? createYargsConfig(parser, getenvHelper) : parser;
+      return configured.exitProcess(false);
+    },
+  });
+
+  return addCliCompatibilityAliases(parsed, { positionalAliases });
+}

package/src/configure-claude.lib.mjs

@@ -16,25 +16,48 @@ import os from 'node:os';
 import path from 'node:path';
 
 import { REQUIRED_CLAUDE_QUIET_ENV, REQUIRED_CLAUDE_QUIET_SETTINGS, REQUIRED_CLAUDE_QUIET_ATTRIBUTION, REQUIRED_CLAUDE_QUIET_PERMISSIONS, ensureClaudeQuietConfig } from './claude-quiet-config.lib.mjs';
+import { parseCliArgumentsWithLino } from './cli-arguments.lib.mjs';
 import { buildDisallowedToolsList, ensureDisallowedToolsInSettings } from './useless-tools.lib.mjs';
 
 export const resolveSettingsPath = settingsPath => settingsPath || path.join(os.homedir(), '.claude', 'settings.json');
 
+export const createConfigureClaudeYargsConfig = yargsInstance =>
+  yargsInstance
+    .usage('Usage: configure-claude [options]')
+    .option('settings-path', {
+      type: 'string',
+      description: 'Path to settings.json',
+      alias: 's',
+    })
+    .option('verify', {
+      type: 'boolean',
+      description: 'Report configuration status without writing',
+      default: false,
+    })
+    .option('help', {
+      type: 'boolean',
+      description: 'Show this help and exit',
+      alias: 'h',
+      default: false,
+    })
+    .help(false)
+    .version(false)
+    .strict();
+
 export const parseConfigureClaudeArgs = argv => {
-  const args = { settingsPath: null, verify: false, help: false };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (arg === '--settings-path' || arg === '-s') {
-      args.settingsPath = argv[++i];
-    } else if (arg.startsWith('--settings-path=')) {
-      args.settingsPath = arg.slice('--settings-path='.length);
-    } else if (arg === '--verify') {
-      args.verify = true;
-    } else if (arg === '--help' || arg === '-h') {
-      args.help = true;
-    }
-  }
-  return args;
+  const help = argv.includes('--help') || argv.includes('-h');
+  const parsed = parseCliArgumentsWithLino({
+    argv: argv.filter(arg => arg !== '--help' && arg !== '-h'),
+    commandName: 'configure-claude',
+    createYargsConfig: createConfigureClaudeYargsConfig,
+    lenv: { enabled: false },
+    getenv: { enabled: false },
+  });
+  return {
+    settingsPath: parsed.settingsPath || parsed['settings-path'] || null,
+    verify: parsed.verify === true,
+    help,
+  };
 };
 
 export const CONFIGURE_CLAUDE_HELP = `Usage: configure-claude [options]

package/src/hive-screens.lib.mjs

@@ -15,6 +15,7 @@ import fs from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { promisify } from 'node:util';
+import { parseCliArgumentsWithLino } from './cli-arguments.lib.mjs';
 
 const execAsync = promisify(execCallback);
 
@@ -52,6 +53,9 @@ References:
 
 const ACTION_FLAGS = new Set(['--enter', '--close', '--list']);
 const SELECTION_FLAGS = new Set(['--oldest', '--newest', '--all']);
+const HIVE_SCREENS_FLAGS = new Set([...ACTION_FLAGS, ...SELECTION_FLAGS, '--help', '-h', '--verbose', '-v']);
+
+const createHiveScreensYargsConfig = yargsInstance => yargsInstance.usage('Usage: hive-screens (--list | --enter | --close) [--oldest|--newest|--all] [--verbose]').option('enter', { type: 'boolean', default: false }).option('close', { type: 'boolean', default: false }).option('list', { type: 'boolean', default: false }).option('oldest', { type: 'boolean', default: false }).option('newest', { type: 'boolean', default: false }).option('all', { type: 'boolean', default: false }).option('verbose', { type: 'boolean', alias: 'v', default: false }).option('help', { type: 'boolean', alias: 'h', default: false }).help(false).version(false).strict(false);
 
 /**
  * Parse the argv for `hive-screens`. Returns the parsed flags plus an
@@ -59,6 +63,7 @@ const SELECTION_FLAGS = new Set(['--oldest', '--newest', '--all']);
  * with a non-zero status without throwing).
  */
 export const parseHiveScreensArgs = argv => {
+  const help = argv.includes('--help') || argv.includes('-h');
   const result = {
     enter: false,
     close: false,
@@ -70,32 +75,41 @@ export const parseHiveScreensArgs = argv => {
   };
 
   for (const arg of argv) {
-    if (arg === '--help' || arg === '-h') {
-      result.help = true;
-      continue;
-    }
-    if (arg === '--verbose' || arg === '-v') {
-      result.verbose = true;
-      continue;
+    if (!HIVE_SCREENS_FLAGS.has(arg)) {
+      result.error = `Unknown option: ${arg}`;
+      return result;
     }
-    if (ACTION_FLAGS.has(arg)) {
-      if (arg === '--enter') result.enter = true;
-      else if (arg === '--close') result.close = true;
-      else result.list = true;
-      continue;
-    }
-    if (SELECTION_FLAGS.has(arg)) {
-      if (result.selection && result.selection !== arg.slice(2)) {
-        result.error = `Conflicting selection flags: --${result.selection} and ${arg}`;
-        return result;
-      }
-      result.selection = arg.slice(2);
-      continue;
-    }
-    result.error = `Unknown option: ${arg}`;
+  }
+
+  let parsed;
+  try {
+    parsed = parseCliArgumentsWithLino({
+      argv: argv.filter(arg => arg !== '--help' && arg !== '-h'),
+      commandName: 'hive-screens',
+      createYargsConfig: createHiveScreensYargsConfig,
+      lenv: { enabled: false },
+      getenv: { enabled: false },
+    });
+  } catch (err) {
+    result.error = err.message || String(err);
     return result;
   }
 
+  result.help = help;
+  result.verbose = parsed.verbose === true || parsed.v === true;
+  result.enter = parsed.enter === true;
+  result.close = parsed.close === true;
+  result.list = parsed.list === true;
+
+  for (const selection of ['oldest', 'newest', 'all']) {
+    if (parsed[selection] !== true) continue;
+    if (result.selection && result.selection !== selection) {
+      result.error = `Conflicting selection flags: --${result.selection} and --${selection}`;
+      return result;
+    }
+    result.selection = selection;
+  }
+
   if (result.help) return result;
 
   const actions = [result.enter, result.close, result.list].filter(Boolean).length;

package/src/hive.mjs

@@ -17,15 +17,9 @@ if (earlyArgs.includes('--version')) {
 if (earlyArgs.includes('--help') || earlyArgs.includes('-h')) {
   try {
     // Load minimal modules needed for help
-    const { use } = eval(await (await fetch('https://unpkg.com/use-m/use.js')).text());
-    globalThis.use = use;
-    const yargsModule = await use('yargs@17.7.2');
-    const { resolveYargsFactory } = await import('./yargs-factory.lib.mjs');
-    const yargs = resolveYargsFactory(yargsModule);
-    const helpersModuleHelp = await use('yargs@17.7.2/helpers');
-    const _helpersHelp = helpersModuleHelp.default || helpersModuleHelp;
-    const hideBinHelp = _helpersHelp.hideBin || (argv => argv.slice(2));
-    const rawArgs = hideBinHelp(process.argv);
+    const { getLinoYargsFactory, hideBin } = await import('./cli-arguments.lib.mjs');
+    const yargs = getLinoYargsFactory();
+    const rawArgs = hideBin(process.argv);
     // Reuse createYargsConfig from shared module to avoid duplication
     const { createYargsConfig } = await import('./hive.config.lib.mjs');
     const helpYargs = createYargsConfig(yargs(rawArgs)).version(false);
@@ -71,12 +65,7 @@ if (isRunningDirectly) {
       30000, // 30 second timeout
       'loading command-stream'
     );
-    const yargsModule = await withTimeout(use('yargs@17.7.2'), 30000, 'loading yargs');
-    const { resolveYargsFactory } = await import('./yargs-factory.lib.mjs');
-    const yargs = resolveYargsFactory(yargsModule);
-    const helpersModuleMain = await withTimeout(use('yargs@17.7.2/helpers'), 30000, 'loading yargs helpers');
-    const _helpersMain = helpersModuleMain.default || helpersModuleMain;
-    const hideBin = _helpersMain.hideBin || (argv => argv.slice(2));
+    const { parseCliArgumentsWithLino, hideBin } = await import('./cli-arguments.lib.mjs');
     const path = (await withTimeout(use('path'), 30000, 'loading path')).default;
     const fs = (await withTimeout(use('fs'), 30000, 'loading fs')).promises;
     // Import shared library functions
@@ -258,7 +247,12 @@ if (isRunningDirectly) {
     };
 
     try {
-      argv = await createYargsConfig(yargs()).parse(rawArgs);
+      argv = parseCliArgumentsWithLino({
+        argv: process.argv,
+        commandName: 'hive',
+        createYargsConfig,
+        positionalAliases: ['github-url'],
+      });
       // Restore stderr if parsing succeeded
       process.stderr.write = originalStderrWrite;
     } catch (error) {

package/src/memory-check.mjs

@@ -6,7 +6,7 @@ if (typeof globalThis.use === 'undefined') {
   globalThis.use = (await eval(await (await fetch('https://unpkg.com/use-m/use.js')).text())).use;
 }
 const use = globalThis.use;
-const { resolveYargsFactory } = await import('./yargs-factory.lib.mjs');
+const { getLinoYargsFactory, hideBin, parseCliArgumentsWithLino } = await import('./cli-arguments.lib.mjs');
 
 // Temporarily unset CI to avoid command-stream trace logs
 const originalCI = process.env.CI;
@@ -18,12 +18,6 @@ const { $ } = await use('command-stream');
 // These are filtered out by consuming code when parsing JSON
 const $silent = $({ mirror: false, capture: true });
 
-const yargsModule = await use('yargs@17.7.2');
-const yargs = resolveYargsFactory(yargsModule);
-const helpersModule = await use('yargs@17.7.2/helpers');
-// Node 24 CJS/ESM interop may return the whole module object instead of named exports directly
-const _helpers = helpersModule.default || helpersModule;
-const hideBin = _helpers.hideBin || (argv => argv.slice(2));
 const fs = (await use('fs')).promises;
 
 // Import log function from lib.mjs
@@ -325,9 +319,8 @@ export const checkSystem = async (requirements = {}, options = {}) => {
 };
 
 // CLI interface when run directly
-if (import.meta.url === `file://${process.argv[1]}`) {
-  // Create yargs instance with all options
-  const yargsInstance = yargs(hideBin(process.argv))
+const createMemoryCheckYargsConfig = yargsInstance =>
+  yargsInstance
     .scriptName('memory-check.mjs')
     .usage('Usage: $0 [options]')
     .option('min-memory', {
@@ -368,13 +361,19 @@ if (import.meta.url === `file://${process.argv[1]}`) {
     .help('h')
     .alias('h', 'help');
 
+if (import.meta.url === `file://${process.argv[1]}`) {
   // Check for help before parsing
   if (process.argv.includes('--help') || process.argv.includes('-h')) {
+    const yargsInstance = createMemoryCheckYargsConfig(getLinoYargsFactory()(hideBin(process.argv)));
     yargsInstance.showHelp();
     process.exit(0);
   }
 
-  const argv = await yargsInstance.parseAsync();
+  const argv = parseCliArgumentsWithLino({
+    argv: process.argv,
+    commandName: 'memory-check.mjs',
+    createYargsConfig: createMemoryCheckYargsConfig,
+  });
 
   // If we get here, help wasn't requested or yargs didn't handle it
   // Set up logging based on options

package/src/review.mjs

@@ -38,13 +38,13 @@ const { use } = eval(await (await fetch('https://unpkg.com/use-m/use.js')).text(
 const { $: __rawDollar$ } = await use('command-stream');
 const { wrapDollarWithGhRetry } = await import('./github-rate-limit.lib.mjs');
 const $ = wrapDollarWithGhRetry(__rawDollar$);
-const yargs = (await use('yargs@latest')).default;
 const os = (await use('os')).default;
 const path = (await use('path')).default;
 const fs = (await use('fs')).promises;
 
 // Import shared functions from lib.mjs to follow DRY principle
 import { log, setLogFile, getLogFile, formatAligned } from './lib.mjs';
+import { parseCliArgumentsWithLino } from './cli-arguments.lib.mjs';
 import { reportError } from './sentry.lib.mjs';
 import * as memoryCheck from './memory-check.mjs';
 
@@ -53,64 +53,77 @@ import { executeClaudeCommand } from './claude.lib.mjs';
 import { defaultModels, getClaudeModelChoices, buildModelOptionDescription } from './models/index.mjs';
 
 // Configure command line arguments - GitHub PR URL as positional argument
-// Use yargs().parse(args) instead of yargs(args).argv to ensure .strict() mode works
-const argv = yargs()
-  .usage('Usage: $0 <pr-url> [options]')
-  .positional('pr-url', {
-    type: 'string',
-    description: 'The GitHub pull request URL to review',
-  })
-  .option('resume', {
-    type: 'string',
-    description: 'Resume from a previous session ID (when limit was reached)',
-    alias: 'r',
-  })
-  .option('dry-run', {
-    type: 'boolean',
-    description: 'Prepare everything but do not execute Claude',
-    alias: 'n',
-  })
-  .option('model', {
-    type: 'string',
-    description: buildModelOptionDescription(),
-    alias: 'm',
-    default: defaultModels.claude,
-    choices: getClaudeModelChoices(),
-  })
-  .option('focus', {
-    type: 'string',
-    description: 'Focus areas for review (security, performance, logic, style, tests)',
-    alias: 'f',
-    default: 'all',
-  })
-  .option('approve', {
-    type: 'boolean',
-    description: 'If review passes, approve the PR',
-    default: false,
-  })
-  .option('verbose', {
-    type: 'boolean',
-    description: 'Enable verbose logging for debugging',
-    alias: 'v',
-    default: false,
-  })
-  .option('execute-tool-with-bun', {
-    type: 'boolean',
-    description: 'Execute the AI tool using bunx (experimental, may improve speed and memory usage)',
-    default: false,
-  })
-  .demandCommand(1, 'The GitHub pull request URL is required')
-  .parserConfiguration({
-    'boolean-negation': true,
-  })
-  .help('h')
-  .alias('h', 'help')
-  // Use yargs built-in strict mode to reject unrecognized options
-  // This prevents issues like #453 and #482 where unknown options are silently ignored
-  .strict()
-  .parse(process.argv.slice(2));
-
-const prUrl = argv['pr-url'] || argv._[0];
+const createReviewYargsConfig = yargsInstance =>
+  yargsInstance
+    .usage('Usage: $0 <pr-url> [options]')
+    .command('$0 <pr-url>', 'Review a GitHub pull request', yargs =>
+      yargs.positional('pr-url', {
+        type: 'string',
+        description: 'The GitHub pull request URL to review',
+      })
+    )
+    .option('resume', {
+      type: 'string',
+      description: 'Resume from a previous session ID (when limit was reached)',
+      alias: 'r',
+    })
+    .option('dry-run', {
+      type: 'boolean',
+      description: 'Prepare everything but do not execute Claude',
+      alias: 'n',
+    })
+    .option('model', {
+      type: 'string',
+      description: buildModelOptionDescription(),
+      alias: 'm',
+      default: defaultModels.claude,
+      choices: getClaudeModelChoices(),
+    })
+    .option('focus', {
+      type: 'string',
+      description: 'Focus areas for review (security, performance, logic, style, tests)',
+      alias: 'f',
+      default: 'all',
+    })
+    .option('approve', {
+      type: 'boolean',
+      description: 'If review passes, approve the PR',
+      default: false,
+    })
+    .option('verbose', {
+      type: 'boolean',
+      description: 'Enable verbose logging for debugging',
+      alias: 'v',
+      default: false,
+    })
+    .option('execute-tool-with-bun', {
+      type: 'boolean',
+      description: 'Execute the AI tool using bunx (experimental, may improve speed and memory usage)',
+      default: false,
+    })
+    .check(parsed => {
+      if (!parsed['pr-url'] && !parsed.prUrl && !parsed._?.[0]) {
+        throw new Error('The GitHub pull request URL is required');
+      }
+      return true;
+    })
+    .parserConfiguration({
+      'boolean-negation': true,
+    })
+    .help('h')
+    .alias('h', 'help')
+    // Use yargs built-in strict mode to reject unrecognized options
+    // This prevents issues like #453 and #482 where unknown options are silently ignored
+    .strict();
+
+const argv = parseCliArgumentsWithLino({
+  argv: process.argv,
+  commandName: 'review',
+  createYargsConfig: createReviewYargsConfig,
+  positionalAliases: ['pr-url'],
+});
+
+const prUrl = argv['pr-url'] || argv.prUrl || argv._[0];
 
 // Set global verbose mode for log function
 global.verboseMode = argv.verbose;