@rehearsal-db/core 0.1.0-beta.7 → 0.1.0-beta.8

package/CHANGELOG.md

@@ -5,6 +5,14 @@ a Changelog, and versions will follow Semantic Versioning after the package exis
 
 ## Unreleased
 
+## [0.1.0-beta.8] - 2026-10-02
+
+### Fixed
+
+- Lifecycle commands now preserve an explicit `--config=<path>` through runtime
+  selection and execution. A command cannot silently operate on the default config's
+  baseline, runtime identity, ports, or cleanup target instead.
+
 ## [0.1.0-beta.7] - 2026-10-02
 
 ### Added
@@ -194,7 +202,8 @@ a Changelog, and versions will follow Semantic Versioning after the package exis
   publication uses short-lived trusted OIDC, and every release tag must already exist on
   protected `main`.
 
-[Unreleased]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.7...HEAD
+[Unreleased]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.8...HEAD
+[0.1.0-beta.8]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.7...v0.1.0-beta.8
 [0.1.0-beta.7]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.6...v0.1.0-beta.7
 [0.1.0-beta.6]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.5...v0.1.0-beta.6
 [0.1.0-beta.5]: https://github.com/Ddupasquier/rehearsal-db/compare/v0.1.0-beta.4...v0.1.0-beta.5

package/docs/commands.md

@@ -97,7 +97,7 @@ belonging to other projects are never included. This follows
 | `--verbose`                     | Show more safe detail.                                           |
 | `--debug`                       | Show the most diagnostic detail; still review it before sharing. |
 | `--plain`                       | Disable decorative interactive prompts.                          |
-| `--config=<path>`               | Use a specific config file inside the project.                   |
+| `--config=<path>`               | Use only this config for planning and every runtime action.      |
 | `--target=supabase\|postgresql` | Choose the setup target.                                         |
 | `--include-runtime`             | Include this project's runtime in a cleanup preview.             |
 | `--include-images`              | Include older unused Supabase images in a cleanup preview.       |
@@ -105,3 +105,8 @@ belonging to other projects are never included. This follows
 | `--write`                       | Apply a setup, policy, or cleanup preview.                       |
 
 Run `npx rehearsal --help` to print the command list available in your installed version.
+
+When a project has more than one config, pass `--config=<path>` on every command for the
+non-default one. Rehearsal keeps that exact config selected through status, run, reset,
+start, migrate, verify, stop, discard, and cleanup; it will not fall back to
+`rehearsal.config.mjs` during a runtime action.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rehearsal-db/core",
-  "version": "0.1.0-beta.7",
+  "version": "0.1.0-beta.8",
   "private": false,
   "description": "Safely rehearse PostgreSQL and Supabase migrations against sanitized, production-shaped data.",
   "repository": {

package/scripts/lib/rehearsal/diagnostics.mjs

@@ -7,7 +7,7 @@
 import { createHash } from "node:crypto";
 
 export const REHEARSAL_RESULT_VERSION = 1;
-export const REHEARSAL_VERSION = "0.1.0-beta.7";
+export const REHEARSAL_VERSION = "0.1.0-beta.8";
 
 export const REHEARSAL_EXIT_CODES = Object.freeze({
   success: 0,

package/scripts/lib/runtime/postgresql_runtime.mjs

@@ -28,10 +28,13 @@ import {
 } from "../rehearsal/runtime_restore.mjs";
 import { readBoundRuntimeSanitizationPolicy } from "../rehearsal/sanitization_policy.mjs";
 import { ensureLocalContainerRuntime } from "../environment/local_supabase.mjs";
+import { parseRuntimeInvocation } from "./runtime_target.mjs";
 
 const repositoryRoot = process.cwd();
+const invocation = parseRuntimeInvocation();
 const loadedConfiguration = await loadRehearsalConfig({
   projectRoot: repositoryRoot,
+  configPath: invocation.configPath,
 });
 const { config, paths: configuredPaths } = loadedConfiguration;
 const artifactRoot = configuredPaths.artifactDirectory;
@@ -51,7 +54,7 @@ const image = config.postgresql.image;
 const database = config.postgresql.database;
 const databaseUser = config.postgresql.user;
 const databasePort = config.runtime.ports.database;
-const action = process.argv[2] ?? "status";
+const action = invocation.action;
 const applicationMigrations = new URL(
   "./",
   pathToFileURL(`${configuredPaths.migrationDirectory}/`),
@@ -650,9 +653,7 @@ const migrateRuntime = async () => {
   const { baseline } = await readActive();
   await startRuntime();
   const receipt = await readCandidateReceipt(baseline);
-  const confirmation = process.argv
-    .find((argument) => argument.startsWith("--confirm-candidates="))
-    ?.slice("--confirm-candidates=".length);
+  const confirmation = invocation.confirmation;
   if (confirmation !== receipt.candidateSha256) {
     throw new Error(
       "Candidate migration confirmation is missing or does not match the exact SHA-256.",

package/scripts/lib/runtime/runtime_target.mjs

@@ -17,6 +17,31 @@ const TARGETS = Object.freeze({
 
 export const REHEARSAL_RUNTIME_TARGETS = Object.freeze(Object.keys(TARGETS));
 
+export const parseRuntimeInvocation = (arguments_ = process.argv.slice(2)) => {
+  const action = arguments_.find((argument) => !argument.startsWith("--"));
+  const valueAfter = (prefix) =>
+    arguments_
+      .find((argument) => argument.startsWith(prefix))
+      ?.slice(prefix.length);
+  return Object.freeze({
+    action: action ?? "status",
+    configPath: valueAfter("--config="),
+    confirmation: valueAfter("--confirm-candidates="),
+  });
+};
+
+export const buildRuntimeManagerArguments = ({
+  managerPath,
+  action,
+  configPath,
+  confirmation,
+}) => [
+  managerPath,
+  action,
+  ...(configPath ? [`--config=${configPath}`] : []),
+  ...(confirmation ? [`--confirm-candidates=${confirmation}`] : []),
+];
+
 export const resolveRuntimeTarget = (value = "supabase") => {
   if (typeof value !== "string" || !Object.hasOwn(TARGETS, value)) {
     throw new Error(

package/scripts/lib/runtime/supabase_runtime.mjs

@@ -50,10 +50,13 @@ import {
   compareProductionSchemaDumps,
 } from "../rehearsal/schema_snapshot.mjs";
 import { formatCount } from "../rehearsal/human_output.mjs";
+import { parseRuntimeInvocation } from "./runtime_target.mjs";
 
 const repositoryRoot = process.cwd();
+const invocation = parseRuntimeInvocation();
 const loadedConfiguration = await loadRehearsalConfig({
   projectRoot: repositoryRoot,
+  configPath: invocation.configPath,
 });
 const { config, paths: configuredPaths } = loadedConfiguration;
 const artifactRoot = configuredPaths.artifactDirectory;
@@ -76,7 +79,7 @@ const runtimeAdapter = configuredPaths.runtimeAdapter
   ? await import(pathToFileURL(configuredPaths.runtimeAdapter).href)
   : null;
 const environmentKeyPattern = /^[A-Z][A-Z0-9_]*$/u;
-const action = process.argv[2] ?? "status";
+const action = invocation.action;
 
 const readServiceEnvironment = () =>
   readRehearsalServiceEnvironment({
@@ -662,9 +665,7 @@ const migrateRuntime = async () => {
   console.log(
     `${receipt.candidates.length === 1 ? "Candidate migration" : "Candidate migrations"} (${receipt.candidateSha256}): ${receipt.candidates.map((candidate) => candidate.filename).join(", ")}`,
   );
-  const confirmation = process.argv
-    .find((argument) => argument.startsWith("--confirm-candidates="))
-    ?.slice("--confirm-candidates=".length);
+  const confirmation = invocation.confirmation;
   if (confirmation !== receipt.candidateSha256) {
     throw new Error(
       "Candidate migration confirmation is missing or does not match the exact SHA-256.",

package/scripts/operations/database/manage_rehearsal_database.mjs

@@ -5,7 +5,14 @@
  */
 
 import { loadRehearsalConfig } from "../../lib/rehearsal/configuration.mjs";
-import { runRuntimeTarget } from "../../lib/runtime/runtime_target.mjs";
+import {
+  parseRuntimeInvocation,
+  runRuntimeTarget,
+} from "../../lib/runtime/runtime_target.mjs";
 
-const { config } = await loadRehearsalConfig({ projectRoot: process.cwd() });
+const invocation = parseRuntimeInvocation();
+const { config } = await loadRehearsalConfig({
+  projectRoot: process.cwd(),
+  configPath: invocation.configPath,
+});
 await runRuntimeTarget(config.runtime.target);

package/scripts/operations/rehearsal/rehearsal_cli.mjs

@@ -60,6 +60,7 @@ import {
   applyRehearsalCleanup,
   planRehearsalCleanup,
 } from "../../lib/rehearsal/cleanup.mjs";
+import { buildRuntimeManagerArguments } from "../../lib/runtime/runtime_target.mjs";
 
 const packageRoot = fileURLToPath(new URL("../../..", import.meta.url));
 const projectRoot = process.cwd();
@@ -1283,10 +1284,12 @@ const emit = ({ command, data, flags, render, status = "success" }) => {
 };
 
 const runManager = ({ action, flags }) => {
-  const args = [managerPath, action];
-  if (flags.confirmation) {
-    args.push(`--confirm-candidates=${flags.confirmation}`);
-  }
+  const args = buildRuntimeManagerArguments({
+    managerPath,
+    action,
+    configPath: flags.configPath,
+    confirmation: flags.confirmation,
+  });
   const environment = Object.fromEntries(
     [
       "CI",