@glubean/cli 0.2.6 → 0.3.0

package/dist/commands/run.d.ts

@@ -3,12 +3,29 @@ interface RunOptions {
     pick?: string;
     tags?: string[];
     tagMode?: "or" | "and";
+    /** Per-test timeout ms (Phase 1 sub-task E: profile execution.timeoutMs). */
+    timeoutMs?: number;
+    /** Worker concurrency (Phase 1 sub-task E: profile execution.concurrency). */
+    concurrency?: number;
+    /**
+     * Tags to EXCLUDE. Any test/case carrying ANY of these tags is dropped
+     * from the inventory before execution. excludeTags is always OR-mode
+     * (any match → exclude), independent of `tagMode` which only governs
+     * positive `tags` matching. Phase 1 first slice — see plan §Phase 1 task 8.
+     */
+    excludeTags?: string[];
     envFile?: string;
     logFile?: boolean;
     pretty?: boolean;
     verbose?: boolean;
     failFast?: boolean;
-    failAfter?: number;
+    /**
+     * Stop after N failures. `null` = explicit "no count limit" (e.g. from a
+     * profile that disables it). Distinct from `undefined` (= "no override,
+     * fall through to underlying config defaults") — mergeRunOptions
+     * preserves the null vs undefined distinction.
+     */
+    failAfter?: number | null;
     resultJson?: boolean | string;
     emitFullTrace?: boolean;
     inferSchema?: boolean;
@@ -25,6 +42,7 @@ interface RunOptions {
     /** Include cases with defaultRun: "opt-in" (headless but expensive/slow) */
     includeOptIn?: boolean;
     upload?: boolean;
+    uploadReceiptJson?: string;
     project?: string;
     token?: string;
     apiUrl?: string;
@@ -49,7 +67,77 @@ interface RunOptions {
     inputJson?: string;
     bootstrapJson?: string;
     forceStandalone?: boolean;
+    /**
+     * Per-file allow-list of runnable kinds. When set, each discovered
+     * runnable is filtered: only emit it if its kind is in the file's
+     * allowed set. This enforces `suite.kinds` at the RUNNABLE level —
+     * a `kinds: [contract]` suite running a `.contract.ts` file that
+     * also exports a flow inline still drops the flow. Missing entry
+     * for a file means "no filter" (legacy behavior).
+     */
+    allowedKindsPerFile?: Map<string, Set<"test" | "contract" | "flow">>;
+    /**
+     * Full redaction config from the v1 resolved plan
+     * (`defaults.redaction`). When present, runCommand uses this instead
+     * of `glubeanConfig.redaction` loaded via the legacy `loadConfig`
+     * path — which doesn't read glubean.yaml. Without this, projects
+     * that declare custom `globalRules` / `sensitiveKeys` / `customPatterns`
+     * in glubean.yaml would silently ship secrets to Cloud uploads.
+     */
+    redactionConfig?: import("@glubean/redaction").RedactionConfig;
+    /**
+     * Phase 5 5a — profile name from `glubean.yaml` the run executed
+     * against. Threaded through upload payload as `metadata.runPlan.profile`
+     * so cloud server can project to top-level `RunEntity.profile` for
+     * index-backed `GET /open/v1/runs?profile=X` queries.
+     */
+    profile?: string;
+    /**
+     * Phase 5 5a — suite names the run spanned (in declaration order).
+     * Threaded as `metadata.runPlan.suites` for the equivalent
+     * `?suite=Y` membership query.
+     */
+    suites?: string[];
+    /**
+     * Metric thresholds from the v1 resolved plan (defaults.thresholds ∪
+     * profile.thresholds). When non-empty, takes precedence over the legacy
+     * `glubeanConfig.thresholds` (package.json) — v1 profiles can declare
+     * per-profile gates that the legacy flat-shape path can't express.
+     */
+    thresholds?: import("@glubean/sdk").ThresholdConfig;
 }
+/**
+ * Map a file path to its Glubean kind by extension.
+ * - `.test.ts` → "test"
+ * - `.contract.ts` → "contract"
+ * - `.flow.ts` → "flow"
+ * - `.bootstrap.ts` → "bootstrap" (overlay registration only; not a runnable kind)
+ *
+ * Returns undefined for non-Glubean files. The suite.kinds filter in
+ * resolveTestFiles uses this to keep only files whose kind matches.
+ */
+export type GlubeanFileKind = "test" | "contract" | "flow" | "bootstrap";
+export declare function classifyGlubeanFile(filePath: string): GlubeanFileKind | undefined;
+/**
+ * Per-suite resolution helper exposed for main.ts. Resolves a suite's
+ * `target` (file / dir / glob), then keeps only files whose
+ * `classifyGlubeanFile` result is in `kinds` (.bootstrap.ts files are
+ * always kept regardless of kinds so overlay registration still fires
+ * across the project — they emit no runnable tests on their own).
+ *
+ * `kinds.length === 0` means "no kind filter" (all Glubean files).
+ *
+ * KNOWN LIMITATION (file-level only): the filter operates on the file
+ * EXTENSION, not on individual exports. A `.contract.ts` file CAN
+ * legitimately export a flow inline (and vice versa). For canonical
+ * `tests/` + `contracts/` directory layouts this doesn't matter — each
+ * file kind matches its declared suite kind. For mixed exports inside
+ * a single file (`kinds: [contract]` running a flow exported from the
+ * same .contract.ts), authors should split flows into `.flow.ts`. A
+ * proper export-level kind filter would require threading suite kinds
+ * through discoverTests and is left as a follow-up.
+ */
+export declare function resolveTestFilesForSuite(target: string, kinds: string[]): Promise<string[]>;
 interface DiscoveredTestMeta {
     id: string;
     name?: string;
@@ -64,12 +152,32 @@ interface DiscoveredTestMeta {
     defaultRun?: string;
     deferred?: string;
     deprecated?: string;
+    /**
+     * Runnable kind — used by Phase 4's suite.kinds filter to drop
+     * runnables whose kind isn't in the declared kinds for the suite
+     * that contributed the file. Set by discoverTests at emit time:
+     * - "test"     — plain `test(...)` exports
+     * - "contract" — contract case (any protocol)
+     * - "flow"     — `contract.flow(...).build()` orchestrator
+     */
+    kind?: "test" | "contract" | "flow";
 }
 interface DiscoveredTest {
     exportName: string;
     meta: DiscoveredTestMeta;
 }
 export declare function discoverTests(filePath: string): Promise<DiscoveredTest[]>;
-export declare function runCommand(target: string, options?: RunOptions): Promise<void>;
+export declare const __testing: {
+    matchesTags: (testItem: DiscoveredTest, tags: string[], mode?: "or" | "and" | undefined) => boolean;
+    matchesExcludeTags: (testItem: DiscoveredTest, excludeTags: string[]) => boolean;
+};
+declare function matchesTags(testItem: DiscoveredTest, tags: string[], mode?: "or" | "and"): boolean;
+/**
+ * Returns true if the test carries ANY tag in excludeTags (case-insensitive).
+ * Always OR-mode — independent of positive-side tagMode. A test with no
+ * tags is never excluded by this filter.
+ */
+declare function matchesExcludeTags(testItem: DiscoveredTest, excludeTags: string[]): boolean;
+export declare function runCommand(target: string | string[], options?: RunOptions): Promise<void>;
 export {};
 //# sourceMappingURL=run.d.ts.map

package/dist/commands/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"AA+CA,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,IAAI,GAAG,KAAK,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B;;;;;;;;;;;;;;;OAeG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAyID,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,cAAc;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAkG/E;AA+ED,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,UAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CA44Cf"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/commands/run.ts"],"names":[],"mappings":"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"}