persistence-agnostic-linter

Audit and fix persistence wiring so the repository adapter (TypeORM/Firestore/other) stays swappable. Use when adding or reviewing entity/repository code, when you see @InjectRepository or a module-local TypeOrmModule.forFeature, or when checking that core/feature packages don't hard-require an ORM. Triggers on "is this persistence swappable", "register this entity", "review repository usage".

Jump to install

Repository: conceptadev/rockets
Last source activity: August 6, 2026 at 16:41
Detected SKILL.md language: English
Stars: 1
Forks: 2

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/conceptadev/rockets --skill persistence-agnostic-linter

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

e2e-fixer

Diagnose and fix failing or flaky tests in this monorepo, with a bias for e2e (*.e2e-spec.ts). Use when tests fail after a change, when a suite passes alone but fails in the full run, on fixture/bootstrap drift, barrel-registration collisions, teardown/open-handle leaks, or runner/config drift. Triggers on "fix the tests", "e2e failing", "flaky test", "tests pass alone but not together".

2026-08-06

upstream-migrator

Migrate the monorepo across @concepta/* and @nestjs/* version bumps and local↔npm dependency swaps. Use when asked to "bump @concepta to alpha.X", "use the npm packages instead of local", "upgrade NestJS", or when a version change breaks the build with module-resolution, exports-map, common→core, or exception-identity errors. Handles the recurring traps that classic version bumps hide.

2026-08-06

orchestrator

Router/dispatcher for Rockets work. Reads the user's request, classifies intent, and tells you which Rockets skill to invoke (or that none applies). Use FIRST whenever a request touches this monorepo and the right skill is not obvious — e.g. "bump @concepta to alpha.X", "refactor module to DDD", "generate a CRUD", "fix failing e2e", "review my changes", "why is this 500", "add ACL". Triggers on "what skill", "which skill", "orchestrate", "route this", or any broad Rockets task.

2026-06-22

View all from this repository

Persistence-Agnostic Linter

The supported contract is RepositoryInterface + dynamic repository keys. Concrete backends are selected in module options and must stay swappable. Flag and fix anything that nails the code to one ORM.

Reject these

@InjectRepository(...) / importing Repository from typeorm in core or feature code.

A module-local TypeOrmModule.forFeature([...]) to register a feature entity.

ORM types (FindManyOptions, DeepPartial, SaveOptions, TypeORM EntityManager) in rockets-core public surface, types, or docs.

The same entity/key registered in two places, or key and class split across files.

Require instead

@InjectDynamicRepository(KEY) + RepositoryInterface<Entity>. Feature/server code imports these from @concepta/rockets-core (it re-exports InjectDynamicRepository, RepositoryInterface, RepositoryModuleInterface, Where, getDynamicRepositoryToken). Only core/lower packages import from @concepta/rockets-repository directly.

Entity registration through bundles in resources[]: defineResource() auto-contributes its entity row; defineModuleResource({ entities: [...] }) contributes extra rows; userMetadata.entity for the metadata row.

A single top-level repository: RepositoryModuleInterface (default adapter) at the module root; per-entity repository override only when one table needs a different backend. No repositories.entities[] block.

For the zod layer: entity generation goes through a SchemaEntityCompiler adapter (e.g. typeOrmZodEntityCompiler), never TypeORM imported directly into rockets-zod.

How to audit

grep -rn "@InjectRepository\|from 'typeorm'\|TypeOrmModule.forFeature" packages/*/src — every hit in core or a feature is a finding (example/sample apps may legitimately pick TypeORM as the concrete adapter).

Confirm each entity is registered exactly once, via a bundle, not a module-local forFeature.

Confirm rockets-core builds and type-checks with no ORM symbol in its public index.ts.

When you fix a violation, migrate it to the dynamic-repository pattern — do not cast around the type. If a real gap blocks the abstraction, stop and ask rather than leaking the ORM.