Function describeCommand

cli/src/framework/help.ts:77–101

(ctor: CommandConstructor, path: string)

}

export function describeCommand(ctor: CommandConstructor, path: string): CommandDescriptor {
  const guide = agentGuideOf(ctor)

  return {
    command: path,
    description: ctor.description ?? null,
    effect: ctor.effect ?? 'read',
    args: Object.entries(ctor.args ?? {}).map(([name, def]) => ({
      name,
      required: def.required ?? false,
      description: def.description,
    })),
    flags: Object.entries(ctor.flags ?? {}).map(([name, def]) => ({
      name,
      char: def.char ?? null,
      type: def.type,
      default: def.default ?? null,
      multiple: def.multiple ?? false,
      options: def.options ?? null,
      description: def.description,
    })),
    examples: renderExamples(ctor),
    agentGuide: guide.length > 0 ? guide : null,
  }
}

function formatHelpText(ctor: CommandConstructor, path: string): string {
  const lines: string[] = []