@jawache/flow 0.1.1 → 0.1.2

package/dist/types/language/domain.d.ts

@@ -191,6 +191,24 @@ export type World = Pick<Ctx, "exec" | "fs" | "git">;
  * would be called with `ctx` as its receiver and break any world that closes over itself.
  */
 export declare function makeCtx(moment: Moment, facts: Partial<Ctx>, world: World): Ctx;
+/**
+ * Mark a configured check as built with options it cannot work with, and say why.
+ *
+ * WHY IT IS A VALUE AND NOT A THROW: a check factory runs while the config module is evaluating, so
+ * a throw there is a module that will not import, and the reader gets one fault with a stack trace
+ * instead of every fault with its entry named. Marked instead, the load collects it beside the
+ * grammar's own refusals and the engine blocks every gated moment with the same text — which is the
+ * shape every other load failure already has.
+ *
+ * WHY IT EXISTS AT ALL: an option can be well-TYPED and still be nonsense — the class that bit here
+ * was a depcruise layer written as a regex where the dialect takes globs, which compiled to a
+ * pattern matching nothing. The fence loaded, `flow status` called it armed, and it walked no graph
+ * for as long as nobody planted a probe. A rule that cannot do its job must refuse to load, never
+ * report green.
+ */
+export declare function withFaults<C extends Check>(check: C, faults: readonly string[]): C;
+/** What a configured check said is wrong with its own options. Empty for every healthy check. */
+export declare function faultsOf(check: Check | undefined): readonly string[];
 /**
  * Declare a CONFIGURED check: a function that takes options and returns a check.
  *
@@ -631,7 +649,7 @@ export interface Overlaid {
  */
 export declare function overlay(base: EntrySpec, spoken: Readonly<Record<string, unknown>>, prior?: Readonly<Record<string, "pack" | "override">>): Overlaid;
 /** The closed vocabulary of refusals. Every load failure is exactly one of these. */
-export declare const REFUSAL_CODES: readonly ["not-a-pack", "missing-parameter", "unknown-entry", "unknown-key", "unknown-moment", "missing-mandatory", "undeclared-category", "no-cases", "duplicate-id", "dead-scope"];
+export declare const REFUSAL_CODES: readonly ["not-a-pack", "missing-parameter", "unknown-entry", "unknown-key", "unknown-moment", "missing-mandatory", "undeclared-category", "no-cases", "duplicate-id", "dead-scope", "bad-check-options"];
 export type RefusalCode = (typeof REFUSAL_CODES)[number];
 /** One reason the config will not load. */
 export interface Refusal {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jawache/flow",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Guardrails and breadcrumbs as code — packs you import, a config that typechecks, one adapter per harness.",
   "license": "MIT",
   "repository": {