mirror of
https://github.com/0xrsydn/idx-cli.git
synced 2026-11-07 09:45:36 +00:00
22b6dabaeb
Phase 1 of docs/DESIGN.md: - Output format resolves -o > IDX_OUTPUT > general.output > auto; auto is a table on a terminal and JSON when stdout is piped or captured. `config init` now writes output = "auto". - JSON is pretty only on a terminal and compact otherwise. New `-o jsonl` prints one array item per line with the same key order. - No ANSI color when stdout is not a terminal (direct owo-colors calls now go through output::style). - `stocks quote -` and `stocks compare -` read symbols from stdin. - Exit codes by class: 2 invalid input/config, 3 not found or cache miss, 4 upstream unavailable, 5 unsupported, 1 other. Golden changes are limited to those documented kinds and were verified mechanically: JSON goldens are semantically identical, tables differ only by removed ANSI codes and the column padding comfy-table had reserved for them (cell contents identical), exit codes match each error's class, and help/completions only gain the new --output values. 17 new golden cases cover auto, jsonl, stdin, and the new errors. tests/cli.rs now pins IDX_OUTPUT=table in its harness (its tests assert table text and run piped) and parses discover JSON instead of matching pretty-printed whitespace. Live A/B against main: 16/16 stocks cases identical; ownership discover got IDX 403 on both binaries, now exiting 4 instead of 1 as intended. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
58 lines
1.9 KiB
Text
58 lines
1.9 KiB
Text
exit: 0
|
|
--- stdout
|
|
Ownership intelligence (KSEI + Bing).
|
|
|
|
Preferred bootstrap path:
|
|
1. Run `idx ownership sync` to install or refresh a maintained SQLite snapshot.
|
|
2. If no snapshot manifest is available, run `idx ownership discover` and then `idx ownership import --url <pdf-url>`.
|
|
3. Local `.xlsx`, `.pdf`, `.zip`, and `.txt` imports remain available for manual or fallback workflows.
|
|
|
|
Usage: idx ownership [OPTIONS] <COMMAND>
|
|
|
|
Commands:
|
|
discover Discover the latest IDX-hosted ownership report URLs
|
|
import Import ownership data directly from source files
|
|
sync Install or refresh a maintained ownership SQLite snapshot
|
|
ticker Show all holders for a ticker (KSEI + Bing combined)
|
|
entity Show all holdings for an entity across tickers
|
|
search Search entities by name
|
|
cross-holders Rank entities by cross-ownership breadth
|
|
concentration Rank tickers by ownership concentration
|
|
flow Show Bing institutional flow for a ticker
|
|
changes Diff two KSEI releases
|
|
graph Ownership network graph
|
|
resolve Manual entity resolution workflow
|
|
releases List imported KSEI releases
|
|
help Print this message or the help of the given subcommand(s)
|
|
|
|
Options:
|
|
-o, --output <OUTPUT>
|
|
Output format [default: auto = table on a terminal, json when piped]
|
|
|
|
[possible values: auto, table, json, jsonl]
|
|
|
|
--no-color
|
|
Disable colored output
|
|
|
|
-q, --quiet
|
|
Suppress non-essential output
|
|
|
|
-v, --verbose...
|
|
Increase verbosity (-v, -vv)
|
|
|
|
--offline
|
|
Run without network requests
|
|
|
|
--no-cache
|
|
Bypass local cache
|
|
|
|
-h, --help
|
|
Print help (see a summary with '-h')
|
|
|
|
Examples:
|
|
idx ownership sync
|
|
idx ownership sync --manifest /path/to/ownership-snapshot-manifest.json
|
|
idx ownership discover --limit 1
|
|
idx ownership import --url <pdf-url>
|
|
idx ownership releases
|
|
--- stderr
|