feat(cli): start Alexandria browsing with a category guide

[developersdigest]

Summary

Make firecrawl alexandria list start with a compact guide: what Alexandria is, commands for finding and calling tools, and live categories with descriptions. list and list-tools share this root. Selecting a category lists providers; direct provider and capability paths continue to work.

• Read the root from the existing public GET /exchange/discover route on the configured Firecrawl API, using the same login/API key. Provider and tool lookups continue through Find Tools on Scrape.
• Keep category IDs, descriptions, and membership on the server. Unknown categories appear without a CLI release. Friendly labels/aliases map names such as Retail and Public records to the catalog's canonical IDs.
• Keep the flat provider inventory available with --providers. The root shows all returned categories; --limit controls provider/tool pages.
• Preserve request IDs and access errors. Root JSON exposes the category index at data.items; --providers retains the previous Scrape envelope.
• Update help and the beta skill, and bump the Alexandria npm release to 1.23.4-alexandria-beta.9.

npx firecrawl-cli@alexandria alexandria list
npx firecrawl-cli@alexandria list finance
npx firecrawl-cli@alexandria list-tools retail --category
npx firecrawl-cli@alexandria list benzinga
npx firecrawl-cli@alexandria list --providers

Validation

• Build, formatting, and all 475 tests pass. One new integration case covers category discovery, previously unknown categories, JSON navigation, and access-error propagation; existing traversal coverage now checks the explicit provider list and friendly category names.
• Local build against production: 17 categories; Retail drill-down returns 12 providers; explicit flat inventory returns 87 providers; direct Benzinga lookup returns seven tools.
• The complete plain-text root guide is about 560 output tokens with o200k_base, excluding request-ID logging. No provider tools were executed.

[cubic-dev-ai]

All reported issues were addressed

<sub>Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would not auto-approve because issues were found.

Fix all with cubic | Re-trigger cubic</sub>

[cubic-dev-ai]

All reported issues were addressed across 5 files

<sub>Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would not auto-approve. Auto-approval blocked because this review re-detected 2 unresolved issues already reported by Cubic.

Re-trigger cubic</sub>

[cubic-dev-ai]

0 issues found across 2 files (changes from recent commits).

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

<sub>Heads up: you’re close to your flex budget. Increase your flex budget so reviews don’t pause.

Shadow auto-approve: would require human review. The PR changes the default Alexandria browsing behavior and root JSON contract from a provider inventory to a live category guide. A human should confirm this intentional compatibility and UX change.

Re-trigger cubic</sub>