feat: add CIP analytics topic, SDK client, and report tooling

[clavery]

This PR introduces end-to-end CIP/CCAC support across both the CLI and SDK, delivering a complete analytics feature set for curated report workflows, metadata discovery, and raw SQL access.

CLI Additions

New cip topic and command model

• Added a new top-level CLI topic: b2c cip.
• Added b2c cip query for raw SQL execution with:
  • positional SQL argument support (including piped/heredoc stdin)
  • --file input mode
  • <FROM>/<TO> token replacement from date flags
  • table/csv/json output options
• Added curated report subcommands under b2c cip report <report-name>

Metadata discovery commands

• Added b2c cip tables to list metadata catalog tables with schema/pattern/type filtering.
• Added b2c cip describe <table> to inspect table column structure (name/type/nullability).
• Tuned default table output for readability (cip tables: table/type; cip describe: column/type/nullability).

Curated report command system

• Implemented shared report command base utilities and shared flag definitions for consistent report UX.
• Added report-specific command files for all curated reports (sales, OCAPI, search, payments, referrers, etc.).
• Added --describe and --sql report options, including SQL piping support into cip query.

Auth, host, and output behavior

• Enforced client-credentials-only auth on CIP commands and rejected user-auth paths.
• Added --staging shorthand and automatic host selection behavior by tenant pattern, with explicit --cip-host override support.
• Normalized output behavior so CSV/JSON formats write to stdout and global --json continues to work as expected.

SDK Additions

CIP client foundation

• Added a new protobuf-based Avatica client (CipClient) and factory (createCipClient) in @salesforce/b2c-tooling-sdk for executing CIP SQL queries.
• Implemented connection/session handling, statement execution/fetch paging, row decoding, and middleware integration.
• Added host constants and selection support for production/staging analytics endpoints.

SDK configuration and exports

• Added CIP host support to config mapping/resolution and CLI config extraction in the SDK.
• Updated SDK/client barrel exports so CIP APIs are available from both root and subpath imports.
• Extended TypeDoc entrypoints and API documentation to include CIP operations/types in generated docs.

Curated report and metadata operations API

• Added operations/cip module with curated report catalog + typed interfaces.
• Added report helpers for discovery, validation, SQL generation, and execution:
  • listCipReports
  • getCipReportByName
  • buildCipReportSql
  • executeCipReport
• Added metadata helpers for table and column discovery:
  • listCipTables
  • describeCipTable
• Added and expanded SDK tests for client behavior, report semantics, and metadata operations.

Docs, Skills, and Release Artifacts

• Added/updated CLI docs for CIP commands and command index integration.
• Added a new guide page: Analytics Reports (CIP/CCAC) with authentication, non-prod guidance, host behavior, query/report quick start, metadata discovery examples, output examples, and SDK references.
• Updated CIP skill content to match final command model and best-practice usage guidance.
• Added a changeset covering CLI and SDK package changes.

Validation

• pnpm --filter @salesforce/b2c-tooling-sdk run typecheck:agent
• pnpm --filter @salesforce/b2c-tooling-sdk run lint:agent
• pnpm --filter @salesforce/b2c-tooling-sdk run test:agent
• pnpm --filter @salesforce/b2c-cli run typecheck:agent
• pnpm --filter @salesforce/b2c-cli run lint:agent
• pnpm --filter @salesforce/b2c-cli run test:agent
• pnpm run docs:build

[clavery]

3PL note: protobufjs is BSD 3-clause and support by SF opensource. It's also maintained by google and extremely popular.