Commands · Sparkles

Status surface

Navigation telemetry, not a verdict.

Use the structured finance_track_status receipt—denominator, criteria, and gaps—before treating compact percentages as operationally credible.

Pi keeps the active track visible in its TUI statusline.

CN · CNY · Asia/Shanghai · src:65% · feat:100%

DSH appends whole-value status events to the invoking agent's session, folds them through the piSparklesStatus projection, and renders the current session in the additive shell.overlay slot. State is isolated per agent and restored from the session log. Drag the badge or move it with the arrow keys when it covers content; double-click it or press Home to reset its position.

CN · CNY · Asia/Shanghai · src:65% · feat:100%

track

`track`

The active navigation context: CN, HK, or US. It does not rewrite source evidence.

src

`src`

Equal-weight evidence-maturity of the track's versioned source stack. Verified is 100%, partial 50%, missing 0%. It is not the probability that a source statement is true. A critical criterion must still be fully verified.

feat

`feat`

Installed end-user feature coverage for the active track only. A US tool never increases CN or HK coverage. Breadth is not data completeness.

The version-1 feature denominator has ten equally weighted families. Installed breadth is not statement depth, entitlement, or source-maturity parity:

navigation contextsource registrysecurity identitymarket calendareffective rulesquotes and historydisclosure discoveryraw fundamentalsnormalized fundamentalsreproducible derivations

Launch configuration

Defaults are interaction defaults.

FlagValuesMeaning

--finance-trackcn | hk | us

Initial navigation track. Invalid values fail safe to us. This is navigation only.

--finance-currencyISO currency, default USD

Global reporting default for /finance-setup. It is not the active track currency.

--finance-timezoneUTC or IANA Area/Location, default UTC

Global reporting default for /finance-setup. It is not the active track timezone.

pi --finance-track cn
# equivalent once Pi is running
/finance-track cn

DSH does not consume Pi's CLI flags. Set the equivalent compatibility default in the bundle's config.flags map or with PI_SPARKLES_FLAG_<NORMALIZED_NAME>.

PI_SPARKLES_FLAG_FINANCE_TRACK=cn dsh web
# equivalent after the agent starts
/finance-track cn

Shared command surface

Show, switch, or queue — never execute.

Pi registers these with its extension API. The DSH compatibility shell registers the same names with ctx.commands and binds queued messages and session effects to the invoking agent.

CommandPluginWhat it does

/finance-setup/finance-setup

finance_setup

Inspect installed foundations, reporting defaults, and whether a named adapter surface is present. It never prints secrets or claims live connectivity.

/finance-track/finance-track [cn|hk|us]

finance_track_status

Show the active navigation track, or switch it. Switching never relabels observations, providers, calendars, or persisted state.

/cn-track/cn-track

finance_track_status

Direct shortcut to the mainland China navigation track.

/hk-track/hk-track

finance_track_status

Direct shortcut to the Hong Kong navigation track.

/us-track/us-track

finance_track_status

Direct shortcut to the United States navigation track.

/cn-setup/cn-setup

cn_setup

Inspect isolated mainland capabilities and blocked provider decisions. Companion tools advance only their own surfaces.

/cn-sources/cn-sources

cn_setup

Show verified mainland authorities, official roles, access state, and redistribution limits.

/hk-setup/hk-setup

hk_setup

Inspect isolated Hong Kong capabilities and blocked provider decisions.

/hk-sources/hk-sources

hk_setup

Show verified Hong Kong authorities, including HKEXnews and HKEX Full List roles.

/finance-policy/finance-policy

finance_guardrails

Show the active evidence policy: freshness, provenance, disclaimer, and incompatible-mix rejection.

/symbol/symbol <query>

finance_symbols

Resolve a name or ticker through OpenFIGI v3. Ambiguity is returned, never guessed.

/sec-company/sec-company <ticker or company name>

sec_edgar

Search the SEC ticker association file without guessing a CIK.

/us-research/us-research <company, symbol, CIK, period>

stock_research_report

Queue a bounded US source-fact brief workflow from already-named receipts.

/fundamentals/fundamentals

stock_fundamentals

Show the US fundamentals workflow and the exact supported metric definitions.

/swing/swing [workflow-name]

swing_workbench

Show exact branch-scoped swing workflow facts without selecting a next step.

/journal/journal <local-jsonl-path>

trade_journal

Show compact journal context from an explicit local JSONL path. Decisions stay with the LLM.

/watch/watch [list-name]

watchlist

Show saved watchlists or one exact lowercase list name. Members stay on their labelled track.

Typical first minute

Inventory, then choose a track.

Try this with Sparkles

›

Run the finance setup and track-status tools. Do not reveal environment values. Tell me which of CN, HK, and US have configured read-only adapters, then wait for me to choose a track and a provider.