Skip to content

@W-20783316 Add SCAPI Schemas commands for browsing and retrieving API specifications#49

Merged
clavery merged 4 commits intomainfrom
feature/W-20783316-scapi-schemas
Jan 19, 2026
Merged

@W-20783316 Add SCAPI Schemas commands for browsing and retrieving API specifications#49
clavery merged 4 commits intomainfrom
feature/W-20783316-scapi-schemas

Conversation

@clavery
Copy link
Copy Markdown
Collaborator

@clavery clavery commented Jan 14, 2026

Summary

  • Adds scapi schemas list command to list available SCAPI schemas with filtering by apiFamily, apiName, apiVersion, and status
  • Adds scapi schemas get command to retrieve a specific schema with selective expansion support for context-efficient output (ideal for agentic/LLM use cases)
  • Schema collapsing by default - paths show HTTP methods only, schemas/examples show names only
  • Selective expansion via --expand-paths, --expand-schemas, --expand-examples flags
  • Discovery via --list-paths, --list-schemas, --list-examples flags
  • YAML output support via --yaml flag
  • SDK client with OAuth scope sfcc.scapi-schemas
  • Documentation page and b2c-cli agent skill
    GUS: W-20783316

…ions

Introduces new CLI commands to interact with the SCAPI Schemas API:

- `scapi schemas list` - List available SCAPI schemas with filtering by
  apiFamily, apiName, apiVersion, and status
- `scapi schemas get` - Get a specific schema with selective expansion
  support for context-efficient output (ideal for agentic/LLM use cases)

Key features:
- Schema collapsing by default (paths show methods, schemas show names only)
- Selective expansion via --expand-paths, --expand-schemas, --expand-examples
- List available items via --list-paths, --list-schemas, --list-examples
- YAML output support via --yaml flag
- Custom properties expansion (enabled by default)

SDK additions:
- OpenAPI spec and generated types for SCAPI Schemas API
- createScapiSchemasClient() factory with OAuth scope sfcc.scapi-schemas
- collapseOpenApiSchema() utility for three-tier disclosure model
- Helper functions: getPathKeys, getSchemaNames, getExampleNames

Also includes documentation page and b2c-cli skill for the new commands.
- Reorder class members per perfectionist rules
- Fix union type ordering (null before string[])
- Remove unnecessary length check in Array.some()
- Fix test assertion to use lowercase 'apiFamily'
@clavery clavery changed the title Add SCAPI Schemas commands for browsing and retrieving API specifications W-20783316 Add SCAPI Schemas commands for browsing and retrieving API specifications Jan 15, 2026
@clavery clavery changed the title W-20783316 Add SCAPI Schemas commands for browsing and retrieving API specifications @W-20783316 Add SCAPI Schemas commands for browsing and retrieving API specifications Jan 15, 2026
@clavery clavery merged commit 62b6acb into main Jan 19, 2026
3 checks passed
@clavery clavery deleted the feature/W-20783316-scapi-schemas branch January 27, 2026 01:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant