@shrkcrft/cli 0.1.0-alpha.30 → 0.1.0-alpha.31

package/dist/commands/gates.command.d.ts

@@ -1,4 +1,55 @@
+import type { IWiringSource } from '@shrkcrft/core';
 import { type ICommandHandler, type ParsedArgs } from '../command-registry.js';
+import { type GatePlane, type IGateRuleView } from '../gates/gate-rule-view.js';
+import { type IGateRuleResult } from '../gates/gate-envelope.js';
+export interface IPrepared {
+    readonly cwd: string;
+    readonly rules: readonly IGateRuleView[];
+    readonly excludeDirs: string[];
+    readonly planeDiagnostics: readonly string[];
+    /**
+     * Every pack rule the merge seam REJECTED, as an errored row (`failed
+     * validation — NOT evaluated`) — a configured rule that did not run, so it
+     * enters every verdict's denominator (round 12 review, R12-X1).
+     */
+    readonly rejectedRules: readonly (IGateRuleResult & {
+        readonly type: GatePlane;
+    })[];
+    /** The config's named `extractors`, for the shared-extractor coverage view. */
+    readonly extractors: Readonly<Record<string, IWiringSource>>;
+    /** Absolute path of the loaded config file, or null when none exists. */
+    readonly configFile: string | null;
+}
+export declare function prepare(args: ParsedArgs): Promise<{
+    ok: true;
+    value: IPrepared;
+} | {
+    ok: false;
+    code: number;
+}>;
+/**
+ * Resolve `--changed-only` / `--since <ref>` (`--base` is a synonym) into the
+ * changed-file set, or `undefined` for a whole-tree run.
+ *
+ * `error` is distinct from "no files changed": an unresolvable ref must not
+ * silently degrade to an empty diff, which would narrow every rule out of
+ * scope and produce a green run that checked nothing.
+ */
+export declare function resolveScope(args: ParsedArgs, cwd: string): {
+    files?: readonly string[];
+    error?: string;
+};
+/**
+ * Narrow rules to those whose FOOTPRINT intersects the change.
+ *
+ * Returns the surviving rules plus how many were dropped, because a scoped run
+ * must never print the same headline as a full one — "0 violations across 2 of
+ * 9 rules" and "0 violations across 9 of 9" are different facts.
+ */
+export declare function narrowToScope(rules: readonly IGateRuleView[], files: readonly string[] | undefined): {
+    selected: readonly IGateRuleView[];
+    skippedByScope: number;
+};
 export declare const gatesListCommand: ICommandHandler;
 export declare const gatesCoverageCommand: ICommandHandler;
 export declare const gatesCheckCommand: ICommandHandler;
@@ -14,5 +65,6 @@ export declare const gatesExplainCommand: ICommandHandler;
  * it, and no existing invocation changes meaning.
  */
 export declare function tryExplainGateRule(args: ParsedArgs, id: string): Promise<number | undefined>;
+export declare const gatesScaffoldSelfTestCommand: ICommandHandler;
 export declare const gatesCommand: ICommandHandler;
 //# sourceMappingURL=gates.command.d.ts.map

package/dist/commands/gates.command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gates.command.d.ts","sourceRoot":"","sources":["../../src/commands/gates.command.ts"],"names":[],"mappings":"AA6CA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAgOhC,eAAO,MAAM,gBAAgB,EAAE,eAsD9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA+KlC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,eAwK/B,CAAC;AAkCF,eAAO,MAAM,eAAe,EAAE,eAgN7B,CAAC;AA+FF,eAAO,MAAM,mBAAmB,EAAE,eAmGjC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAED,eAAO,MAAM,YAAY,EAAE,eAuB1B,CAAC"}
+{"version":3,"file":"gates.command.d.ts","sourceRoot":"","sources":["../../src/commands/gates.command.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAKV,aAAa,EACd,MAAM,gBAAgB,CAAC;AAkCxB,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAMhC,OAAO,EAGL,KAAK,SAAS,EAEd,KAAK,aAAa,EACnB,MAAM,4BAA4B,CAAC;AAgBpC,OAAO,EAAyC,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAiBxG,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,eAAe,GAAG;QAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC;IACpF,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7D,yEAAyE;IACzE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CACpC;AAED,wBAAsB,OAAO,CAC3B,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BvE;AAkCD;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,MAAM,GACV;IAAE,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgB/C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,SAAS,aAAa,EAAE,EAC/B,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC;IAAE,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAIhE;AAqHD,eAAO,MAAM,gBAAgB,EAAE,eA+D9B,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,eA0RlC,CAAC;AAGF,eAAO,MAAM,iBAAiB,EAAE,eAiQ/B,CAAC;AAyNF,eAAO,MAAM,eAAe,EAAE,eAyT7B,CAAC;AA6GF,eAAO,MAAM,mBAAmB,EAAE,eAmGjC,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAED,eAAO,MAAM,4BAA4B,EAAE,eA4I1C,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eA4B1B,CAAC"}