feat(cartridges): add cartridge/*.properties fallback for pwa-kit / storefront-next repos

[bendvc]

Summary

• findCartridges() now falls back to **/cartridge/*.properties when no .project files are found, enabling b2c code deploy to work out-of-the-box with pwa-kit and storefront-next repos
• .project discovery (existing behavior) is unchanged and takes full priority — the fallback is skipped entirely when any .project files exist under the search root
• maxDepth is automatically adjusted (+1) for the properties glob so both markers honor the same logical cartridge-nesting depth bound
• Updated docs/cli/code.md Cartridge Discovery section to document both markers
• Added 7 targeted unit tests

Background

b2c code deploy discovered cartridges exclusively via .project (Eclipse/UX Studio marker). pwa-kit (packages/template-retail-react-app/cartridges/app_pwakit_base/cartridge/app_pwakit_base.properties) and storefront-next omit .project but always include cartridge/<name>.properties, so running the deploy command from those repos returned No cartridges found with no actionable hint. Charles Lavery (PMTS, tool author) confirmed the .project requirement is historical and welcomed a PR adding the properties heuristic.

Files changed

File	Change
packages/b2c-tooling-sdk/src/operations/code/cartridges.ts	Add toCartridgeFromProperties, fallback glob, propertiesGlobOptions (maxDepth +1), update JSDoc
packages/b2c-tooling-sdk/src/discovery/patterns/cartridges.ts	Update module/class JSDoc
packages/b2c-tooling-sdk/test/operations/code/cartridges.test.ts	7 new tests in cartridge/*.properties fallback describe block
docs/cli/code.md	Updated Cartridge Discovery section to document both markers
.changeset/cartridge-properties-fallback-discovery.md	Changeset (minor SDK, patch CLI)

Test plan

• All 17 cartridges unit tests pass (pnpm --filter @salesforce/b2c-tooling-sdk exec mocha "test/operations/code/cartridges.test.ts")
• Run b2c code deploy from a pwa-kit package root (has cartridge/<name>.properties, no .project) — cartridges should be discovered
• Run b2c code deploy from an SFRA repo (has .project) — existing behavior unchanged
• Run b2c code deploy from a mixed repo with both markers — only .project cartridges discovered

[github-actions]

📘 Docs preview

Your documentation changes are published at:

https://d3uhw92m2zac57.cloudfront.net/pr-694/

Commit 1d26e4f · ✅ Published

_{This preview updates on every push and is removed when the PR is closed.}