Dashboard › cli › Distillation
ef1413ec-be55-4239-a2cf-0ea2cc519e1f["lore_tm_v1_ZrPJyzz0DqsIHNVb61megCDjggHEcXfnDPd1lp0DIL8"]
packages/cli/src/lib/introspect.ts defines getPositionalString(params?: PositionalParams): string: absent params return ""; tuple params map to <placeholder> using fallback arg${i}, wrap optional entries as [<placeholder>], and join with spaces; array params return <${params.parameter.placeholder ?? "args"}...>; unsupported kinds return "".packages/cli/src/lib/introspect.ts defines extractPositionals(params?: PositionalParams): PositionalInfo[]: absent or unsupported params return []; tuple entries expose placeholder (fallback arg${i}), brief (fallback ""), and optional (fallback false); array params produce one entry with an ellipsis-suffixed placeholder (fallback "args..."), brief fallback "", and optional: true.packages/cli/src/lib/introspect.ts defines extractFlags(flags: Record<string, FlagDef> | undefined): FlagInfo[]: absent flags return []; each flag is normalized with name, brief: def.brief ?? "", kind, default, optional: def.optional ?? def.kind === "boolean", variadic: def.variadic ?? false, and hidden: def.hidden ?? false.packages/cli/src/lib/introspect.ts defines buildCommandInfo(cmd: Command, path: string, examples: string[] = []): CommandInfo: it derives jsonFields through extractSchemaFields(cmd.__jsonSchema) when a schema exists; sets brief and fullDescription from the command; extracts flags and structured positionals; uses cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional) for positional; defaults aliases to {}; formats each cmd.__examples item as # ${description}\n${command} when present, otherwise uses the supplied examples; and omits jsonFields unless the extracted array is nonempty.packages/cli/src/lib/introspect.ts, beginning after line 319, is intended to extract all visible subcommands from a route group and accepts a route map, parent routeName such as "issue", and optional documentation examples.