@hublo/sentinel 1.1.5 → 1.2.0-alpha.0

package/README.md

@@ -43,8 +43,8 @@ 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** and **format** tools. The `--test` / `--build`
-> snippets below illustrate the end state and land with their own ticket.
+> **Shipped today:** the **TypeScript**, **lint**, **format**, **build** and **dev** tools. The
+> `--test` snippets below illustrate the end state and land with their own ticket.
 
 **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:
 
@@ -151,6 +151,7 @@ pnpm dlx @hublo/sentinel@<exact-version> --inspect --typescript --module <name>
 - [`docs/using-sentinel.md`](docs/using-sentinel.md) — every verb for every role, scoping a run to some files, what a fully adopted module looks like, and how versions move between modules.
 - [`docs/lint-adoption.md`](docs/lint-adoption.md) — migrating a module from ESLint to Oxlint: the two steps, what `--init` writes and removes, the two react tiers, and the failures worth recognising.
 - [`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: what the config becomes, what sentinel owns versus what stays the app's, why overriding merges instead of spreading, and why an existing config is not rewritten.
 - [`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/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`.
 
@@ -376,9 +377,9 @@ VERBS      --run       execute the target's tool (--json for metrics + diagnosti
            --report    deprecated → --run --json
            --status    deprecated → --inspect
 
-TYPES      --lint  --format  --typescript  --build  --test
+TYPES      --lint  --format  --typescript  --build  --dev  --test
            --static-analysis  --runtime-analysis  --arch
-           (omit a type → ALL types; or --all)
+           (omit a type → every type that TERMINATES; --dev never sweeps)
 
 LOCATION   in a MODULE dir      → that module (do NOT pass --module)
            at the workspace ROOT → --module <name> (one) · --ci (affected) · else all

package/dist/bin/sentinel.js

@@ -1,14 +1,18 @@
 #!/usr/bin/env node
 import {
   PRESET_NAMES,
+  PresetUnsupportedError,
+  SWEEPABLE_TARGETS,
   TARGETS,
   VERBS,
   WORKSPACE_ROOT_MARKER,
   availableTargets,
+  declaredPresetFor,
   describeFramework,
   dispatch,
   ensureWorkspacePrep,
   findWorkspaceRoot,
+  inspectWorkspacePrep,
   palette,
   readNxProjectName,
   readOwnVersion,
@@ -16,7 +20,8 @@ import {
   registerAdapters,
   resolve,
   resolveBin
-} from "../chunk-RLVLDC5H.js";
+} from "../chunk-TWL6T237.js";
+import "../chunk-XSCDJZDY.js";
 
 // bin/sentinel.ts
 import { program } from "commander";
@@ -144,6 +149,17 @@ async function runInit(ctx) {
       });
       worst = Math.max(worst, code);
     } catch (error) {
+      if (error instanceof PresetUnsupportedError) {
+        if (ctx.targetsExplicit) {
+          process.stderr.write(
+            `
+sentinel (${type}): this module's preset is "${error.preset}", and --${type} has no adapter for it. Pass --preset if it was detected wrongly (hoisted dependencies make detection fall back to "node").
+`
+          );
+          worst = Math.max(worst, 1);
+        }
+        continue;
+      }
       process.stderr.write(`
 sentinel (${type}): ${asMessage(error)}
 `);
@@ -196,8 +212,9 @@ async function analyse(params) {
     }
     for (const target of params.targets) {
       let adapter;
+      const resolutionPreset = params.preset ?? declaredPresetFor(target, module.root) ?? preset2;
       try {
-        adapter = resolve(target, preset2, params.runner);
+        adapter = resolve(target, resolutionPreset, params.runner);
       } catch (error) {
         if (params.targetsExplicit) {
           const reason = error instanceof Error ? error.message : String(error);
@@ -416,7 +433,7 @@ function statusCoverage(items) {
   };
 }
 function presetShort(preset2) {
-  return typeof preset2 === "string" ? preset2.replace("@hublo/sentinel/tsconfig/", "") : "?";
+  return typeof preset2 === "string" ? preset2.replace(/@hublo\/sentinel\/(typescript|tsconfig)\//, "") : "?";
 }
 function renderStatusRow(item, p) {
   if (item.status === "unsupported") return renderUnsupportedRow(item, p);
@@ -438,6 +455,10 @@ function renderStatusSummary(items, p) {
 }
 
 // src/cli/run-verb.ts
+function workspacePrep(cwd2) {
+  const root = findWorkspaceRoot(cwd2);
+  return root ? inspectWorkspacePrep(root) : [];
+}
 async function runVerb(ctx) {
   const { modules, scope } = resolveContext(ctx.cwd, { module: ctx.module, ci: ctx.ci });
   const out = palette(process.stdout);
@@ -482,7 +503,15 @@ async function runVerb(ctx) {
   });
   const summary = generateSummaries(results, ctx.targets);
   if (ctx.json) {
-    const base = ctx.verb === "status" || ctx.verb === "inspect" ? { ...summary, coverage: statusCoverage(summary.results) } : summary;
+    const base = ctx.verb === "status" || ctx.verb === "inspect" ? {
+      ...summary,
+      coverage: statusCoverage(summary.results),
+      // The root-level changes sentinel maintains, each with its justification checked
+      // NOW rather than described in a comment. They are the only thing sentinel does
+      // that nobody can see afterwards, and every one of them is temporary. See
+      // `inspectWorkspacePrep`.
+      ...ctx.verb === "inspect" ? { workspace: workspacePrep(ctx.cwd) } : {}
+    } : summary;
     const payload = ctx.toolArgs.length > 0 ? { ...base, toolArgs: ctx.toolArgs } : base;
     process.stdout.write(JSON.stringify(payload, null, 2) + "\n");
   } else if (ctx.verb === "status" || ctx.verb === "inspect" && modules.length > 1) {
@@ -493,6 +522,19 @@ async function runVerb(ctx) {
       process.stdout.write(renderSummary(item, out) + "\n");
     }
   }
+  if (!ctx.json && ctx.verb === "inspect") {
+    const prep = workspacePrep(ctx.cwd);
+    if (prep.length > 0) {
+      process.stdout.write(`
+  sentinel maintains these at the workspace root:
+`);
+      for (const entry of prep) {
+        process.stdout.write(`    ${out.strong(entry.rule)}
+      ${entry.reason}
+`);
+      }
+    }
+  }
   process.stderr.write(
     err.dim(`  ${modules.length} module(s) [${scope}] in ${Date.now() - started}ms
 `)
@@ -624,7 +666,7 @@ if (opts.all && namedTargets.length > 0) {
     `--all runs every target; drop the specific one(s): ${namedTargets.map((t) => `--${t}`).join(", ")}.`
   );
 }
-var targets = opts.all || namedTargets.length === 0 ? [...TARGETS] : namedTargets;
+var targets = opts.all || namedTargets.length === 0 ? [...SWEEPABLE_TARGETS] : namedTargets;
 var targetsExplicit = !(opts.all || namedTargets.length === 0);
 var maxDiagnostics = Number(opts.maxDiagnostics);
 if (!Number.isInteger(maxDiagnostics) || maxDiagnostics < 0) {