Function registerToolsCommand

src/cli/commands/tools.ts:164–271

(app: Argv)

 * Register the 'tools' command for listing available tools.
 */
export function registerToolsCommand(app: Argv): void {
  app.command(
    'tools',
    'List available tools',
    (yargs) => {
      return yargs
        .option('flat', {
          alias: 'f',
          type: 'boolean',
          default: false,
          describe: 'Show flat list instead of grouped by workflow',
        })
        .option('verbose', {
          alias: 'v',
          type: 'boolean',
          default: false,
          describe: 'Show full descriptions',
        })
        .option('json', {
          type: 'boolean',
          default: false,
          describe: 'Output as JSON',
        })
        .option('workflow', {
          alias: 'w',
          type: 'string',
          describe: 'Filter by workflow name',
        });
    },
    async (argv) => {
      const manifest = loadManifest();
      let tools = await buildToolList(manifest);

      // Filter by workflow if specified
      if (argv.workflow) {
        const workflowFilter = (argv.workflow as string).toLowerCase();
        tools = tools.filter((t) => t.workflow.toLowerCase() === workflowFilter);
      }

      if (argv.json) {
        if (argv.flat) {
          const flatTools = [...tools]
            .sort((a, b) => {
              const aKey = `${a.workflow} ${a.cliName}`;
              const bKey = `${b.workflow} ${b.cliName}`;
              return aKey.localeCompare(bKey);
            })
            .map((tool) => toFlatJsonTool(tool));

          const canonicalCount = flatTools.filter((t) => !t.canonicalWorkflow).length;
          writeLine(
            JSON.stringify(
              {
                canonicalToolCount: canonicalCount,
                toolCount: flatTools.length,
                tools: flatTools,
              },
              null,