feat!: extract vendor bridges to pharn-skills-* category modules (0.69.0)

[PrzemekGalarowicz]

Summary

• Extracts vendor-bridge skills from pharn-stack-nextjs into five stack-agnostic category modules: pharn-skills-db, pharn-skills-orm, pharn-skills-auth, pharn-skills-payments, and pharn-skills-email.
• Bumps SKILLS_VERSION to 0.69.0 and manifest.json to schemaVersion: 2, adding the wizard catalog (sections, questions, per-option install paths, vendorSkill/comingSoon flags, and dependency rules).
• Updates contributor docs, manifest JSON schema, and validation tests to reflect the new module layout and selective-install contract.

Test plan

• npm run validate
• npm test
• npx pharn@latest init --wizard against this branch (CLI integration — lives in pharn-cli)
• Confirm existing .claude/ installs are unaffected; new installs resolve bridges via wizard install paths

Made with Cursor

Summary by CodeRabbit

• New Features

  • Added interactive wizard for selective skill installation, allowing users to choose specific skills instead of entire categories.
  • Introduced five new standalone skill-category modules for database, ORM, authentication, payments, and email vendor integrations.
  • Added new authentication bridge options including Supabase Auth and Better Auth.

• Breaking Changes

  • Manifest format upgraded to schemaVersion 2; older manifests (schemaVersion 1) remain compatible.
  • Vendor-bridge skills relocated from stack packs into dedicated modules.

• Version Updates

  • SKILLS_VERSION bumped to 0.69.0; pharn-stack-nextjs updated to 0.31.0.

[coderabbitai]

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

This PR refactors vendor-bridge skills from stack packs into five standalone, stack-agnostic skill-category modules (pharn-skills-{db,orm,auth,payments,email}). The manifest format upgrades to schemaVersion 2 to support a new wizard-driven selective installation flow, while maintaining backward compatibility with schemaVersion 1.

Changes

Skill-category modules with schemaVersion 2 support

Layer / File(s)	Summary
Manifest schema upgrade to schemaVersion 2 scripts/schemas/manifest.schema.json	JSON-schema now supports multiple schemaVersion values (1 and 2), conditionally requires wizard block for v2, introduces kind field for skill-category modules, and defines complete wizard taxonomy (sections, questions, options with install paths, and per-question rules).
Create five skill-category modules pharn-skills-{db,orm,auth,payments,email}/module.json, pharn-skills-auth/skills/{better-auth,clerk,supabase-auth}/SKILL.md, pharn-skills-db/skills/neon/SKILL.md, pharn-skills-orm/skills/{drizzle,prisma}/SKILL.md, pharn-skills-email/skills/resend/SKILL.md, pharn-skills-payments/skills/stripe/SKILL.md	Five new stack-agnostic modules introduced with module.json metadata. New and relocated vendor-bridge skills updated with module ownership, rule_files_provided_by: stack-pack declaration, and pharn_version 0.69.0 pinning.
Manifest root-level wizard and module registration manifest.json	Bump schemaVersion to 2 and skillsVersion to 0.69.0. Register five new skill-category modules and wire wizard sections/questions/options to pharn-skills-* install paths; pharn-stack-nextjs updated to v0.31.0.
Update pharn-stack-nextjs module to v0.31.0 pharn-stack-nextjs/module.json, pharn-stack-nextjs/combinations/planetscale.md	Version bump to 0.31.0 with new "App Router stack pack" description. Reference to vendor-bridge drizzle skill updated to pharn-skills-orm location.

Documentation updates for new architecture

Layer / File(s)	Summary
Architecture documentation for schemaVersion 2 and skill categories docs/architecture.md	Document schemaVersion 2 backward compatibility, kind: skill-category concept, wizard block structure and rule semantics (hide, hideQuestion, relabel, warn), and selective-install contract (schemaVersion detection, wizard rule application, targeted subfolder copying, pharn.config.json recording, single-skill install via pharn add).
Module anatomy and skill authoring guides docs/module-anatomy.md, docs/skill-authoring.md	Add skill-category module documentation for five bridge categories with vendor-bridge conventions (location, metadata, scope, rule-file sourcing). Update pharn-stack-nextjs module docs to reflect vendor-bridge relocation. Update skill-authoring vendor-bridge location guidance to point to pharn-skills-* module paths and clarify stack-pack rule sourcing.
CLAUDE.md repo documentation CLAUDE.md	Update internal source of truth to document new skill-category modules in repo structure, clarify vendor-bridge locations and conventions, document wiring-only coexistence exception with vendorSkill references, bump SKILLS_VERSION to 0.69.0, and update contributor checklist for vendor additions.

Version bumps and release documentation

Layer / File(s)	Summary
Version updates and release notes SKILLS_VERSION, README.md, CHANGELOG.md	Bump SKILLS_VERSION to 0.69.0. Update README module table to include pharn-skills-* categories and expand pharn-stack-nextjs description. Document in CHANGELOG schemaVersion upgrade, vendor-bridge extraction into skill-category modules, manifest schema changes, wizard-driven selective installation, and migration via npx pharn@latest update.
Test coverage for schemaVersion 2 test/validate.test.mjs	Extend makeRepo fixture to accept configurable schemaVersion and optional wizard block. Add skill-category module and validWizard fixtures. Add three tests validating schemaVersion 2 with wizard and skill-category module, missing required install field, and unknown module kind.

🎯 4 (Complex) | ⏱️ ~60 minutes

A hop through the manifest tree, five new modules sprout tall,
schemaVersion climbs from one to two, and the wizard answers all. 🐰✨
Vendor bridges find new homes so clean, skills spread wide and lean.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly and specifically describes the main change: extracting vendor bridges into dedicated pharn-skills-* category modules with version bump to 0.69.0.
Docstring Coverage	✅ Passed	Docstring coverage is 100.00% which is sufficient. The required threshold is 80.00%.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/skill-category-modules

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

ESLint install failed due to a network error.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}