@contractspec/app.cli-database 3.7.5 → 3.7.7

package/README.md

@@ -1,55 +1,77 @@
 # @contractspec/app.cli-database
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
+**CLI tool for single-database management: import, generate, migrate, seed, and schema operations. Wraps Prisma with ContractSpec schema conventions.**
 
-Prisma wrapper and CLI tools for managing database schemas, migrations, and seeding within the LSSM monorepo.
+## What It Does
 
-## Purpose
+- Uses `@contractspec/lib.schema` for schema definitions.
+- Uses Prisma for database operations and migrations.
+- Commands dispatched via minimist argument parsing.
+- Related ContractSpec packages include `@contractspec/lib.schema`, `@contractspec/tool.tsdown`, `@contractspec/tool.typescript`.
 
-To abstract and standardize Prisma usage across multiple services and verticals. It provides a unified CLI (`database`) to handle common database tasks like migrations (`dbs:migrate`), client generation (`dbs:generate`), and seeding (`dbs:seed`).
+## Running Locally
 
-## Installation
-
-```bash
-npm install @contractspec/app.cli-database
-# or
-bun add @contractspec/app.cli-database
-```
-
-## Key Concepts
-
-- **Unified Config**: Centralizes Prisma configuration.
-- **CLI Wrapper**: Wraps standard Prisma commands for consistent execution in the monorepo environment.
-- **Seeding**: Standardized seeding entry point.
-
-## Exports
-
-- `cli`: The command-line interface.
-- `prisma`: Re-exports `@prisma/client`.
+From `packages/apps/cli-database`:
+- `bun run dev`
+- `bun run build`
 
 ## Usage
 
-### CLI Commands
-
-Run via package scripts:
-
 ```bash
-# Generate Prisma Client
-bun database generate
-
-# Run migrations
-bun database migrate:dev
-
-# Seed database
-bun database seed
+npx database --help
+# or
+bunx database --help
 ```
 
-### In Code
-
-```ts
-import { PrismaClient } from '@contractspec/app.cli-database';
-
-const prisma = new PrismaClient();
-const users = await prisma.user.findMany();
-```
+## Architecture
+
+- Uses `@contractspec/lib.schema` for schema definitions.
+- Uses Prisma for database operations and migrations.
+- Commands dispatched via minimist argument parsing.
+- `src/cli.ts` is the CLI entrypoint.
+- `src/index.ts` is the root public barrel and package entrypoint.
+
+## Public Entry Points
+
+- Binary `database` points to `dist/cli.js`.
+- Export `.` resolves through `./dist/index.mjs`.
+- Export `./cli` resolves through `./dist/cli.mjs`.
+- Export `./commands/check` resolves through `./dist/commands/check.mjs`.
+- Export `./commands/generate` resolves through `./dist/commands/generate.mjs`.
+- Export `./commands/import` resolves through `./dist/commands/import.mjs`.
+- Export `./commands/migrate` resolves through `./dist/commands/migrate.mjs`.
+- Export `./commands/schema-compose` resolves through `./dist/commands/schema-compose.mjs`.
+- Export `./commands/schema-generate` resolves through `./dist/commands/schema-generate.mjs`.
+- Export `./commands/seed` resolves through `./dist/commands/seed.mjs`.
+- Export `./lib/config` resolves through `./dist/lib/config.mjs`.
+- The package publishes 12 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — bun run build --watch
+- `bun run build` — tsdown
+- `bun run lint` — bun run lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rm -rf dist
+- `bun run prisma:format` — prisma format
+- `bun run prisma:import` — database import
+- `bun run prisma:check` — database check
+- `bun run dbs:generate` — database generate
+- `bun run dbs:migrate` — database migrate:dev
+- `bun run dbs:deploy` — database migrate:deploy
+- `bun run dbs:status` — database migrate:status
+- `bun run dbs:seed` — database seed
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+
+## Notes
+
+- Do not change CLI argument signatures without updating docs and CI scripts.
+- Prisma schema generation is order-sensitive — test migrations carefully.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/app.cli-database",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "type": "module",
   "bin": {
     "database": "dist/cli.js"
@@ -12,8 +12,9 @@
     "build": "tsdown",
     "dev": "bun run build --watch",
     "lint": "bun run lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
+    "prisma:format": "prisma format",
     "prisma:import": "database import",
     "prisma:check": "database check",
     "dbs:generate": "database generate",
@@ -25,16 +26,16 @@
     "schema:compose": "database schema:compose"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "3.7.5",
+    "@contractspec/lib.schema": "3.7.6",
     "prisma": "^7.4.2",
     "minimist": "^1.2.8",
     "execa": "^9.6.1"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
-    "@contractspec/tool.tsdown": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
+    "@contractspec/tool.tsdown": "3.7.6",
     "@types/minimist": "^1.2.5",
-    "tsdown": "^0.21.0"
+    "tsdown": "^0.21.4"
   },
   "types": "./dist/index.d.mts",
   "files": [