{"id":"@lssm-tech/app.cli-database","slug":"app.cli-database","name":"@lssm-tech/app.cli-database","version":"6.0.4","path":"packages/apps/cli-database","manifestPath":"packages/apps/cli-database/package.json","manifestBlobSha":"84f596824bb425176255430fda7adb57fab075d7","layer":"apps","physicalArea":null,"primaryArea":"tooling-and-agent-delivery","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"app","catalogStatus":"active","adoptionMode":"operator-only","stability":"stable"},"description":"Command-line database tooling for ContractSpec-managed schemas and operations.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"app","status":"active","adoptionMode":"operator-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./blueprint","./cli","./commands/check","./commands/generate","./commands/import","./commands/migrate","./commands/schema-compose","./commands/schema-generate","./commands/seed","./lib/client","./lib/config","./lib/schema-config","./*"],"documentation":[{"title":"App Cli Database documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fapp.cli-database","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This app is published for execution by operators, not as a reusable library dependency."},"canonicalImports":[],"scripts":{"clean":"rm -rf dist","publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"bun ../../../scripts/tsdown.mjs","dev":"bun run build --watch","lint":"bun run lint:fix","lint:fix":"node ../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../scripts/biome.cjs check --write .","lint:check":"node ../../../scripts/biome.cjs check .","dbs:generate":"database generate --dry-run","dbs:migrate":"database migrate:dev --dry-run","dbs:deploy":"database migrate:deploy --dry-run","dbs:status":"database migrate:status","dbs:seed":"database seed --dry-run","schema:generate":"database schema:generate","schema:compose":"database schema:compose","test":"bun test"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.schema":"workspace:^","minimist":"^1.2.8","execa":"^10.0.1","@lssm-tech/lib.contracts-spec":"workspace:^","drizzle-kit":"catalog:data","drizzle-orm":"catalog:data"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","@lssm-tech/tool.tsdown":"workspace:*","@types/minimist":"^1.2.5","tsdown":"catalog:build"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./dist/index.mjs","./blueprint":"./dist/blueprint.mjs","./cli":"./dist/cli.mjs","./commands/check":"./dist/commands/check.mjs","./commands/generate":"./dist/commands/generate.mjs","./commands/import":"./dist/commands/import.mjs","./commands/migrate":"./dist/commands/migrate.mjs","./commands/schema-compose":"./dist/commands/schema-compose.mjs","./commands/schema-generate":"./dist/commands/schema-generate.mjs","./commands/seed":"./dist/commands/seed.mjs","./lib/client":"./dist/lib/client.mjs","./lib/config":"./dist/lib/config.mjs","./lib/schema-config":"./dist/lib/schema-config.mjs","./*":"./*"},"publishExports":{".":"./dist/index.mjs","./cli":"./dist/cli.mjs","./*":"./*"},"types":"./dist/index.d.mts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/app.cli-database","target":"./dist/index.mjs","targets":[{"conditions":[],"target":"./dist/index.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./blueprint","importPath":"@lssm-tech/app.cli-database/blueprint","target":"./dist/blueprint.mjs","targets":[{"conditions":[],"target":"./dist/blueprint.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./cli","importPath":"@lssm-tech/app.cli-database/cli","target":"./dist/cli.mjs","targets":[{"conditions":[],"target":"./dist/cli.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/check","importPath":"@lssm-tech/app.cli-database/commands/check","target":"./dist/commands/check.mjs","targets":[{"conditions":[],"target":"./dist/commands/check.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/generate","importPath":"@lssm-tech/app.cli-database/commands/generate","target":"./dist/commands/generate.mjs","targets":[{"conditions":[],"target":"./dist/commands/generate.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/import","importPath":"@lssm-tech/app.cli-database/commands/import","target":"./dist/commands/import.mjs","targets":[{"conditions":[],"target":"./dist/commands/import.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/migrate","importPath":"@lssm-tech/app.cli-database/commands/migrate","target":"./dist/commands/migrate.mjs","targets":[{"conditions":[],"target":"./dist/commands/migrate.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/schema-compose","importPath":"@lssm-tech/app.cli-database/commands/schema-compose","target":"./dist/commands/schema-compose.mjs","targets":[{"conditions":[],"target":"./dist/commands/schema-compose.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/schema-generate","importPath":"@lssm-tech/app.cli-database/commands/schema-generate","target":"./dist/commands/schema-generate.mjs","targets":[{"conditions":[],"target":"./dist/commands/schema-generate.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./commands/seed","importPath":"@lssm-tech/app.cli-database/commands/seed","target":"./dist/commands/seed.mjs","targets":[{"conditions":[],"target":"./dist/commands/seed.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./lib/client","importPath":"@lssm-tech/app.cli-database/lib/client","target":"./dist/lib/client.mjs","targets":[{"conditions":[],"target":"./dist/lib/client.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./lib/config","importPath":"@lssm-tech/app.cli-database/lib/config","target":"./dist/lib/config.mjs","targets":[{"conditions":[],"target":"./dist/lib/config.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./lib/schema-config","importPath":"@lssm-tech/app.cli-database/lib/schema-config","target":"./dist/lib/schema-config.mjs","targets":[{"conditions":[],"target":"./dist/lib/schema-config.mjs","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]},{"subpath":"./*","importPath":"@lssm-tech/app.cli-database/*","target":"./*","targets":[{"conditions":[],"target":"./*","sourcePath":null,"sourceUrl":null,"sourceStatus":"declared target; source not verified"}]}],"entryCount":14,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"App Cli Database documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fapp.cli-database","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-database","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-database/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-database/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/app.cli-database.txt"},"readme":{"status":"available","body":"# @lssm-tech/app.cli-database\n\nWebsite: https://contractspec.io\n\n**CLI tool for contract-source-first Drizzle/PostgreSQL database management: generate, migrate, seed, and schema operations.**\n\n## What It Does\n\n- Uses `@lssm-tech/lib.schema` for schema definitions.\n- Generates Drizzle/PostgreSQL artifacts from portable ContractSpec database entities.\n- Commands dispatched via minimist argument parsing.\n- Related ContractSpec packages include `@lssm-tech/lib.schema`, `@lssm-tech/tool.tsdown`, `@lssm-tech/tool.typescript`.\n\n## Running Locally\n\nFrom `packages/apps/cli-database`:\n- `bun run dev`\n- `bun run build`\n\n## Usage\n\n```bash\nnpx database --help\n# or\nbunx database --help\n```\n\n## Architecture\n\n- Uses `@lssm-tech/lib.schema` for schema definitions.\n- Generates Drizzle/PostgreSQL artifacts from portable ContractSpec database entities.\n- Commands dispatched via minimist argument parsing.\n- `src/cli.ts` is the CLI entrypoint.\n- `src/index.ts` is the root public barrel and package entrypoint.\n\n## Public Entry Points\n\n- Binary `database` points to `dist/cli.js`.\n- Export `.` resolves through `./dist/index.mjs`.\n- Export `./cli` resolves through `./dist/cli.mjs`.\n- Export `./commands/check` resolves through `./dist/commands/check.mjs`.\n- Export `./commands/generate` resolves through `./dist/commands/generate.mjs`.\n- Export `./commands/import` resolves through `./dist/commands/import.mjs`.\n- Export `./commands/migrate` resolves through `./dist/commands/migrate.mjs`.\n- Export `./commands/schema-compose` resolves through `./dist/commands/schema-compose.mjs`.\n- Export `./commands/schema-generate` resolves through `./dist/commands/schema-generate.mjs`.\n- Export `./commands/seed` resolves through `./dist/commands/seed.mjs`.\n- Export `./lib/config` resolves through `./dist/lib/config.mjs`.\n- The package publishes 12 total export subpaths; keep docs aligned with `package.json`.\n\n\n## Database Workflow Boundary\n\nPrisma support is retired for supported workflows. Broad root workflows such as `lint:fix`, `typecheck`, and release checks must not run Prisma implicitly; use the explicit Drizzle/PostgreSQL `packages/apps/cli-database` commands below when a database schema workflow is required.\n\n## Local Commands\n\n- `bun run dev` — bun run build --watch\n- `bun run build` — tsdown\n- `bun run lint` — bun run lint:fix\n- `bun run lint:check` — biome check .\n- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .\n- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose\n- `bun run publish:pkg:canary` — bun publish:pkg --tag canary\n- `bun run clean` — rm -rf dist\n- `bun run test` — standalone host test: spawns `src/cli.ts` in a throwaway project (schema generate/compose, check, Drizzle config, dry-run and refused migrations, status, seed) with no database\n- `bun run dbs:generate` — database generate --dry-run\n- `bun run dbs:migrate` — database migrate:dev --dry-run\n- `bun run dbs:deploy` — database migrate:deploy --dry-run\n- `bun run dbs:status` — database migrate:status\n- `bun run dbs:seed` — database seed\n\n## Recent Updates\n\n- Replace eslint+prettier by biomejs to optimize speed.\n\n## Notes\n\n- Do not change CLI argument signatures without updating docs and CI scripts.\n- Drizzle/PostgreSQL artifact generation is contract-source-first — test migrations carefully.\n","sourcePath":"packages/apps/cli-database/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/cli-database/README.md","blobSha":"12f2f449dc589745dc7e13a8d253ec2bb7e753db","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"tooling-and-agent-delivery","areaTitle":"CLI, authoring and agent tooling","displayName":"app.cli-database","runtimes":["node"],"platforms":["server"],"kind":"app","scope":"Package manifest","canonicalRoute":"/docs/packages/app.cli-database/","contextUrl":"/docs/packages/app.cli-database.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}