@hublo/sentinel 1.4.0-alpha.1 → 1.4.0-alpha.3

package/README.md

@@ -4,7 +4,7 @@
 
 `sentinel` is a standalone, semver-versioned package (published to a registry, consumed by a repo as a normal dependency) that unifies a repo's tooling, config, and quality checks into one place, so projects stop copying config files everywhere and stop carrying a pile of duplicated tooling dependencies.
 
-> Status: **the foundation, the TypeScript tool and the lint tool are shipped** (`@hublo/sentinel` on npm). The rest of this README is the design reference for the tools still to come, added one at a time on top of this foundation.
+> Status: **the foundation, TypeScript, lint, format, build, dev and test are shipped** (`@hublo/sentinel` on npm). The rest of this README is the design reference for the tools still to come, added one at a time on top of this foundation.
 
 ---
 
@@ -43,8 +43,9 @@ A large monorepo accumulates:
 
 sentinel writes **standard config files** into a project (each just `extends` a sentinel preset) and runs the checks. Your editor and the tools read those **normal files natively**, they never call sentinel at runtime, so nothing is coupled to it or brittle.
 
-> **Shipped today:** the **TypeScript**, **lint**, **format**, **build** and **dev** tools. The
-> `--test` snippets below illustrate the end state and land with their own ticket.
+> **Shipped today:** the **TypeScript**, **lint**, **format**, **build**, **dev** and **test**
+> tools. `--test` migrates a module from jest to Vitest and proves the migration by comparing the
+> full NAMES of the tests before and after; see [the test cheat sheet](docs/test-adoption.md).
 
 **Step 1 — put a module on sentinel** (once per module, by a dev; the files are committed). Run from the app dir; `--init` does it all, nothing is hand-edited:
 
@@ -168,6 +169,7 @@ throwaway run wants. Once a module has adopted, nothing is fetched any more: the
 - [`docs/format-adoption.md`](docs/format-adoption.md) — migrating a module from Prettier to oxfmt: why this config is materialized rather than a stub, how a module keeps its own formatting, and what did not survive the move.
 - [`docs/build-adoption.md`](docs/build-adoption.md) — moving a React app's Vite toolchain into sentinel: adoption changes the config's IMPORTS and nothing else, what sentinel owns versus what stays the app's, and why reading nothing is what makes losing nothing a guarantee.
 - [`docs/typescript-adoption.md`](docs/typescript-adoption.md) — the adoption cheat sheet: the two adoption steps, the command model (verb x type x location), options, reading a report, and troubleshooting.
+- [`docs/test-adoption.md`](docs/test-adoption.md) — migrating a module from jest to Vitest: the two steps, what the migration rewrites and what it refuses BY NAME, how the baseline gate proves nothing was lost, and the failures worth recognising.
 - [`docs/typescript-traces.md`](docs/typescript-traces.md) — a **generated, versioned** reference of live command + output traces (every verb, option, config result and edge case) against the mock monorepo. Regenerate after CLI changes with `pnpm docs:traces`.
 
 ## Architecture: `target → runner → preset`
@@ -529,7 +531,7 @@ This scaffold is the foundation; each tool is added one at a time on top of it:
 2. **TypeScript** (`--typescript`) — runner `tsc` (later `tsgo`): presets react/nest/node, `--run`/`--inspect`/`--report`/`--init`, the composable grid, phased (non-breaking) strictness. **✅ shipped in `0.1.0-alpha.x`**
 3. **Lint** (`--lint`) — benchmark `eslint` vs `biome` vs `oxlint`.
 4. **Build** (`--build`) — `vite`.
-5. **Test** (`--test`) — `vitest`, plus a11y / w3c setups.
+5. **Test** (`--test`) — `vitest`, migration from jest proven module by module against a name-level baseline. **✅ shipped in `1.4.0-alpha.x`**; a11y / w3c setups still to come.
 6. **Static analysis** (`--static-analysis`) — cycles, complexity, duplication, centrality.
 7. **Runtime analysis** (`--runtime-analysis`) — bundle, Lighthouse, web vitals.
 8. **Unified CI workflow + `--report --all` dashboard.**

package/dist/bin/sentinel.js

@@ -16,7 +16,7 @@ import {
   registerAdapters,
   resolve,
   resolveBin
-} from "../chunk-O3XCQGTJ.js";
+} from "../chunk-MUQWAZQN.js";
 import {
   WORKSPACE_ROOT_MARKER,
   ensureWorkspacePrep,

package/dist/chunk-CPCUPK4J.js

@@ -0,0 +1,70 @@
+import {
+  findWorkspaceRoot
+} from "./chunk-WLFE5RUU.js";
+
+// src/roles/test/setup/workspace.ts
+import { createRequire } from "module";
+import { join } from "path";
+function isMissingModule(error) {
+  return error?.code === "ERR_MODULE_NOT_FOUND";
+}
+async function optional(specifier, use) {
+  try {
+    use(await import(
+      /* @vite-ignore */
+      specifier
+    ));
+  } catch (error) {
+    if (!isMissingModule(error)) throw error;
+  }
+}
+function fromModule(specifier) {
+  try {
+    const require2 = createRequire(join(process.cwd(), "noop.cjs"));
+    return require2(specifier);
+  } catch {
+    return void 0;
+  }
+}
+async function loadEnvironment() {
+  await optional("dotenv-flow", (module) => {
+    const flow = module;
+    const config = flow.config ?? flow.default?.config;
+    const workspaceRoot = findWorkspaceRoot(process.cwd());
+    config?.({
+      silent: true,
+      purge_dotenv: true,
+      ...workspaceRoot === void 0 ? {} : { path: workspaceRoot }
+    });
+  });
+}
+async function pinLuxonZone() {
+  let pinned = false;
+  await optional("luxon", (module) => {
+    const settings = module.Settings;
+    if (settings === void 0) return;
+    settings.defaultZone = "utc";
+    pinned = true;
+  });
+  if (pinned) return;
+  const own = fromModule("luxon");
+  if (own?.Settings !== void 0) {
+    own.Settings.defaultZone = "utc";
+    return;
+  }
+  process.stderr.write(
+    "sentinel (test): luxon was not found in this module, so the UTC default zone is NOT pinned. Dates will follow the machine zone, as they did not under jest.\n"
+  );
+}
+async function installWorkspaceSetup() {
+  await loadEnvironment();
+}
+async function pinWorkspaceTimezone() {
+  await pinLuxonZone();
+}
+
+export {
+  installWorkspaceSetup,
+  pinWorkspaceTimezone
+};
+//# sourceMappingURL=chunk-CPCUPK4J.js.map