Skip to content

AGENTS.md

Latest commit

 

History

History
47 lines (35 loc) · 1.48 KB

AGENTS.md

File metadata and controls

47 lines (35 loc) · 1.48 KB

JOOservices Node FormRequest Repository Instructions

This repository is a Node.js package named @jooservices/node-formrequest.

Core Intent

  • Inspect source before editing; do not assume docs or previous implementation are correct.
  • Keep FormRequest class-based and Laravel-inspired, not Laravel-compatible.
  • rules() returns a Zod schema and validation uses parseAsync.
  • Keep the core framework-neutral.
  • Keep the optional adapter targeted to Express 4.x.
  • Keep business logic outside FormRequest.
  • Update tests and docs with behavior changes.
  • Do not weaken the 100% coverage gate.
  • Follow the approved master and develop Git flow.

Required Commands

  • npm run lint
  • npm run typecheck
  • npm run test:coverage
  • npm run build
  • npm pack --dry-run

Architecture Rules

  • No Laravel string rule parser.
  • No database-backed validation rules in the base package.
  • No service container.
  • No persistence or business workflows.
  • No Express import in the core FormRequest class.
  • Do not document unimplemented behavior.

Versioning

  • Feature PRs into develop do not bump package.json.
  • Version bumps happen only in release/<version> branches.
  • The initial public release is 0.1.0.

Branch Workflow

  • master: stable release branch only.
  • develop: integration branch.
  • feature/*: branch from latest develop and PR back into develop.
  • release/<version>: branch from latest develop and PR into master.
  • Tags are created from master only.