instar 1.3.736 → 1.3.738

package/dist/core/testRunnerRunClassifier.js

@@ -0,0 +1,382 @@
+/**
+ * testRunnerRunClassifier — run-class differentiation + skip detection for the
+ * test-runner concurrency bound (spec §2.3/§2.5/§2.6).
+ *
+ * Pure logic (no holders/lock I/O beyond an injected holders read + `ps`
+ * ancestry walk) so the vitest config-eval helper and the globalSetup
+ * chokepoint consume ONE shared classifier — the two evaluation points must
+ * never disagree in the dangerous direction, and sharing the code is how
+ * (State-Not-Symbol: the globalSetup additionally verifies the RESOLVED
+ * config's live pool bound — a symbol never binds the two points).
+ *
+ * CLASSIFICATION IS CONSERVATIVE BY PINNED DESIGN (§2.3): vitest positionals
+ * are substring FILTERS, not exact selectors, so a run is targeted ONLY if
+ * every positional matches EXACTLY ONE file under filter expansion against
+ * the resolved include set, the union is ≤ K files, and NO pool-shaping or
+ * filter flags are present. Every ambiguity routes suite-class (safe
+ * superset) — version drift can only ever mis-route toward the STRICTER lane.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execFileSync } from 'node:child_process';
+import { TARGETED_FILE_LIMIT, classifyRow } from './hostTestRunnerSemaphore.js';
+// ── Pool-shaping argv (§2.3 — disqualifies at BOTH evaluation points) ─────
+/**
+ * Recognized pool-shaping flags (defense-in-depth; the resolved-state check is
+ * the guarantee). Kebab and camel variants both match; `=value` suffix too.
+ */
+const POOL_SHAPING_FLAG_RE = /^--?(no-)?(max-?workers|min-?workers|pool|pool-?options(\..+)?|file-?parallelism|isolate)(=.*)?$/i;
+export function findPoolShapingArgv(argv) {
+    return argv.filter((a) => POOL_SHAPING_FLAG_RE.test(a));
+}
+/**
+ * Strip recognized pool-shaping flags (and their value token where the flag
+ * form takes one) from an argv array. Used by the nested CLI-proof clamp
+ * (§2.5) — the BELT alongside the config hard-set.
+ *
+ * VERSION NOTE (verified against vitest 2.1.9): mutating `process.argv` at
+ * config-eval is a NO-OP on this line — vitest's `cac` parser reads the CLI
+ * BEFORE the config module loads, so the pool flags are already resolved by
+ * the time this runs. The load-bearing CLI-proofness therefore comes from the
+ * config `clampConfigPool` hard-set of `poolOptions.*.{min,max}` (which outrank
+ * a CLI `--maxWorkers`, measured in §5), NOT from this strip. This is kept as
+ * the belt because (a) it is harmless, (b) it does work for children spawned
+ * through `guarded-vitest.mjs`, and (c) vitest arg-parse order is not a stable
+ * contract across versions. The residual it cannot reach — a CLI
+ * `--poolOptions.forks.maxForks=N` that same-keys the config clamp — is caught
+ * loud by the globalSetup `poolOverride` WARN (resolved pool > 4 → ledgered
+ * `nested-skip clamped:false, poolOverride:true`), never silently unbounded.
+ */
+export function neutralizePoolShapingArgv(argv) {
+    const out = [];
+    const removed = [];
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (!POOL_SHAPING_FLAG_RE.test(a)) {
+            out.push(a);
+            continue;
+        }
+        removed.push(a);
+        if (!a.includes('=')) {
+            const next = argv[i + 1];
+            const isValueTaking = /^--?(max-?workers|min-?workers|pool|pool-?options)/i.test(a);
+            if (next !== undefined) {
+                if (isValueTaking && !next.startsWith('-')) {
+                    removed.push(next);
+                    i++;
+                }
+                else if (!isValueTaking && /^(true|false)$/i.test(next)) {
+                    removed.push(next);
+                    i++;
+                }
+            }
+        }
+    }
+    return { argv: out, removed };
+}
+// ── Filter-argv extraction (conservative allowlist — §2.3) ────────────────
+const SUBCOMMANDS = new Set(['run', 'watch', 'list', 'related', 'bench', 'dev', 'typecheck', 'init']);
+/** Flags that do NOT disqualify a targeted classification (value-taking noted). */
+const SAFE_FLAGS_WITH_VALUE = new Set(['--config', '--reporter', '--root', '--dir']);
+const SAFE_BOOLEAN_FLAGS = new Set(['--run', '--silent', '--no-color', '--color', '--globals', '--passWithNoTests', '--pass-with-no-tests', '--allowOnly', '--allow-only']);
+/** Analyze a vitest argv (process.argv.slice(2) shape or full — both work). */
+export function analyzeVitestArgv(argvIn) {
+    // Trim node + script tokens when a full process.argv is passed.
+    let argv = argvIn;
+    const scriptIdx = argvIn.findIndex((a) => /vitest(\.mjs|\.js)?$/.test(a) || a.endsWith('/vitest'));
+    if (scriptIdx >= 0)
+        argv = argvIn.slice(scriptIdx + 1);
+    else if (argvIn[0] && /node(\.exe)?$/.test(argvIn[0]))
+        argv = argvIn.slice(2);
+    const analysis = {
+        subcommand: null,
+        positionals: [],
+        poolShaping: [],
+        unknownFlags: [],
+        explicitWatch: false,
+        isList: false,
+    };
+    let first = true;
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (first && SUBCOMMANDS.has(a)) {
+            analysis.subcommand = a;
+            if (a === 'list')
+                analysis.isList = true;
+            if (a === 'watch')
+                analysis.explicitWatch = true;
+            first = false;
+            continue;
+        }
+        first = false;
+        if (a === '--watch' || a === '-w') {
+            analysis.explicitWatch = true;
+            continue;
+        }
+        if (POOL_SHAPING_FLAG_RE.test(a)) {
+            analysis.poolShaping.push(a);
+            continue;
+        }
+        if (a.startsWith('-')) {
+            const base = a.split('=')[0];
+            if (SAFE_FLAGS_WITH_VALUE.has(base)) {
+                if (!a.includes('='))
+                    i++; // consume the value token
+                continue;
+            }
+            if (SAFE_BOOLEAN_FLAGS.has(base))
+                continue;
+            analysis.unknownFlags.push(a);
+            continue;
+        }
+        analysis.positionals.push(a);
+    }
+    return analysis;
+}
+// ── Include-set resolution + matched-file-set classification (§2.3) ───────
+/**
+ * Resolve the test files selected by simple include globs of the shape this
+ * repo uses (`tests/<dir>/**\/*.test.ts`). Deliberately minimal: a pattern we
+ * cannot interpret contributes NOTHING (and classification then routes
+ * suite-class via zero/ambiguous matches — the safe direction).
+ */
+export function resolveIncludedTestFiles(includeGlobs, rootDir) {
+    const out = [];
+    for (const glob of includeGlobs) {
+        const starIdx = glob.indexOf('*');
+        if (starIdx < 0) {
+            out.push(glob);
+            continue;
+        }
+        const baseDir = glob.slice(0, starIdx).replace(/\/$/, '');
+        const suffixMatch = glob.match(/\*\*\/\*(\.[a-z.]+)$/i) ?? glob.match(/\*(\.[a-z.]+)$/i);
+        const suffix = suffixMatch ? suffixMatch[1].replace('*', '') : '.test.ts';
+        const abs = path.resolve(rootDir, baseDir);
+        walkFiles(abs, (p) => {
+            if (p.endsWith(suffix) || p.endsWith('.test.ts'))
+                out.push(path.relative(rootDir, p));
+        });
+    }
+    return [...new Set(out)];
+}
+function walkFiles(dir, visit) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        // @silent-fallback-ok: unreadable dir contributes no files (→ suite-class).
+        return;
+    }
+    for (const e of entries) {
+        const p = path.join(dir, e.name);
+        if (e.isDirectory()) {
+            if (e.name === 'node_modules' || e.name.startsWith('.'))
+                continue;
+            walkFiles(p, visit);
+        }
+        else {
+            visit(p);
+        }
+    }
+}
+/**
+ * The pinned conservative classifier (§2.3): targeted ONLY if every positional
+ * is a non-glob, non-directory filter matching EXACTLY ONE file in the
+ * resolved include set under vitest's substring filter semantics, and the
+ * union of matches is ≤ K. Anything ambiguous routes suite-class.
+ */
+export function classifyTargetedRun(analysis, includedFiles, rootDir, k = TARGETED_FILE_LIMIT) {
+    if (analysis.positionals.length === 0) {
+        return { targeted: false, matchedCount: 0, reason: 'no-positional-filters' };
+    }
+    if (analysis.poolShaping.length > 0) {
+        return { targeted: false, matchedCount: 0, reason: `pool-shaping-argv:${analysis.poolShaping[0]}` };
+    }
+    if (analysis.unknownFlags.length > 0) {
+        return { targeted: false, matchedCount: 0, reason: `filter-flag:${analysis.unknownFlags[0]}` };
+    }
+    const matchedUnion = new Set();
+    for (const positional of analysis.positionals) {
+        if (/[*?[\]{}]/.test(positional)) {
+            return { targeted: false, matchedCount: 0, reason: `glob-positional:${positional}` };
+        }
+        try {
+            if (fs.statSync(path.resolve(rootDir, positional)).isDirectory()) {
+                return { targeted: false, matchedCount: 0, reason: `directory-positional:${positional}` };
+            }
+        }
+        catch {
+            /* @silent-fallback-ok: not a resolvable path — still a legal substring filter */
+        }
+        // vitest positionals are substring FILTERS against the file path (§2.3).
+        const norm = positional.replace(/^\.\//, '');
+        const matches = includedFiles.filter((f) => f.includes(norm));
+        if (matches.length !== 1) {
+            return {
+                targeted: false,
+                matchedCount: matches.length,
+                reason: matches.length === 0 ? `no-match:${positional}` : `multi-match:${positional}(${matches.length})`,
+            };
+        }
+        matchedUnion.add(matches[0]);
+    }
+    if (matchedUnion.size > k) {
+        return { targeted: false, matchedCount: matchedUnion.size, reason: `matched-count-${matchedUnion.size}>K-${k}` };
+    }
+    return { targeted: true, matchedCount: matchedUnion.size, reason: 'exact-match-set' };
+}
+// ── Resolved-pool bound (the STATE check — §2.3) ──────────────────────────
+/**
+ * Compute the effective worker-pool bound from a resolved vitest config
+ * fragment. Reads maxWorkers AND every poolOptions max* — the MAX of the
+ * bounds that could apply; `fileParallelism:false` bounds file concurrency
+ * to 1. Unknown/absent values resolve to `null` (unbounded ⇒ suite-class).
+ */
+export function resolvedPoolBound(config) {
+    if (config.fileParallelism === false)
+        return 1;
+    const candidates = [];
+    const mw = typeof config.maxWorkers === 'string' ? Number(config.maxWorkers) : config.maxWorkers;
+    if (typeof mw === 'number' && Number.isFinite(mw) && mw >= 1)
+        candidates.push(mw);
+    const po = config.poolOptions;
+    for (const v of [po?.threads?.maxThreads, po?.forks?.maxForks, po?.vmThreads?.maxThreads, po?.vmForks?.maxForks]) {
+        if (typeof v === 'number' && Number.isFinite(v) && v >= 1)
+            candidates.push(v);
+    }
+    if (candidates.length === 0)
+        return null; // unbounded / unknown
+    return Math.max(...candidates);
+}
+/** Clamp a config's pool bounds to ≤ maxAllowed (Math.min — a ceiling, never a floor). */
+export function clampConfigPool(test, maxAllowed) {
+    const t = test;
+    const clampMax = (v) => {
+        const n = typeof v === 'string' ? Number(v) : typeof v === 'number' ? v : NaN;
+        return Number.isFinite(n) && n >= 1 ? Math.min(n, maxAllowed) : maxAllowed;
+    };
+    // The MIN bound must be set EXPLICITLY to ≤ the clamped max, even when the
+    // config left it UNSET — otherwise vitest's Tinypool resolves the pool's
+    // `minThreads`/`minForks` default to (numCpus − 1), which on a ≥6-core host
+    // EXCEEDS our max of 4 and throws `minThreads and maxThreads must not
+    // conflict`, crashing the root at pool creation. That is a §1.1 false-BLOCK
+    // (the clamp meant to bound a run wedges it instead). Clamp min DOWN toward
+    // the max (default an unset/invalid min to 1); never raise a legitimately
+    // lower min — still a ceiling, never a floor.
+    const clampMin = (v, max) => {
+        const n = typeof v === 'string' ? Number(v) : typeof v === 'number' ? v : NaN;
+        return Number.isFinite(n) && n >= 1 ? Math.min(n, max) : 1;
+    };
+    const maxW = clampMax(t.maxWorkers);
+    t.maxWorkers = maxW;
+    t.minWorkers = clampMin(t.minWorkers, maxW);
+    const po = (t.poolOptions ?? {});
+    for (const [key, maxKey, minKey] of [
+        ['threads', 'maxThreads', 'minThreads'],
+        ['forks', 'maxForks', 'minForks'],
+        ['vmThreads', 'maxThreads', 'minThreads'],
+        ['vmForks', 'maxForks', 'minForks'],
+    ]) {
+        const sub = { ...(po[key] ?? {}) };
+        const m = clampMax(sub[maxKey]);
+        sub[maxKey] = m;
+        sub[minKey] = clampMin(sub[minKey], m);
+        po[key] = sub;
+    }
+    t.poolOptions = po;
+    return test;
+}
+// ── CI / off detection (§2.6, hardened) ───────────────────────────────────
+/** Hardened CI predicate: CI truthy-ONLY-as-'true'/'1' AND a positive signal. */
+export function isCiEnvironment(env = process.env) {
+    const ci = env['CI'];
+    if (ci !== 'true' && ci !== '1')
+        return false;
+    return env['GITHUB_ACTIONS'] !== undefined || env['RUNNER_OS'] !== undefined;
+}
+/** Is this an agent-launched / non-interactive context (watch-loudness + CI-spoof heuristics)? */
+export function isAgentContext(env = process.env) {
+    return (env['TMUX'] !== undefined ||
+        env['INSTAR_SESSION_ID'] !== undefined ||
+        env['CLAUDE_CODE_SESSION_ID'] !== undefined ||
+        env['INSTAR_HOST_TEST_RUN_CLASS'] === 'background');
+}
+export function isKillSwitchOff(env = process.env) {
+    return (env['INSTAR_HOST_TEST_SEMAPHORE'] ?? '').toLowerCase() === 'off';
+}
+/** Run-class derivation (§2.6): never from user input. */
+export function deriveRunClass(configName, env = process.env, isTTY = Boolean(process.stdout.isTTY)) {
+    if (env['INSTAR_HOST_TEST_RUN_CLASS'] === 'background')
+        return 'background';
+    if (configName === 'push')
+        return 'interactive';
+    // Safest reading (§1.1 bias): a TTY-attached run not marked background gets
+    // the longer, user-blocking budget — a human is waiting on it.
+    return isTTY ? 'interactive' : 'background';
+}
+// ── Re-entrancy: ancestry + holders cross-check (§2.5) ────────────────────
+/** Walk the ancestor pid chain via `ps` (bounded depth). */
+export function ancestryPids(startPid = process.pid, maxDepth = 25) {
+    const chain = [];
+    let pid = startPid;
+    for (let i = 0; i < maxDepth; i++) {
+        let out;
+        try {
+            // lint-allow-sync-spawn: bounded (1s) one-shot ppid probes, cold path only.
+            out = execFileSync('ps', ['-p', String(pid), '-o', 'ppid='], { timeout: 1000, encoding: 'utf-8' });
+        }
+        catch {
+            // @silent-fallback-ok: unresolvable ancestry fails toward NOT-nested —
+            // the run then acquires normally (bounded, never sheltered).
+            break;
+        }
+        const ppid = Number(out.trim());
+        if (!Number.isInteger(ppid) || ppid <= 1)
+            break;
+        chain.push(ppid);
+        pid = ppid;
+    }
+    return chain;
+}
+/**
+ * The lane-scoped ancestry+holders cross-check (§2.5). The env marker
+ * (INSTAR_TEST_SEMAPHORE_HELD) only NARROWS the check — a stale/foreign/leaked
+ * marker fails the cross-check and does NOT skip; a scrubbed-env child still
+ * skips via pure ancestry.
+ */
+export function checkNestedUnderHolder(holdersRows, laneChildWouldAcquire, opts = {}) {
+    const ancestors = opts.ancestors ?? ancestryPids();
+    const ancestorSet = new Set(ancestors);
+    let markerPid = null;
+    if (opts.envMarker) {
+        const n = Number(opts.envMarker.split(':')[0]);
+        if (Number.isInteger(n) && n >= 2)
+            markerPid = n;
+    }
+    let sameLane = null;
+    let anyLane = false;
+    for (const r of holdersRows) {
+        if (classifyRow(r) !== 'held')
+            continue;
+        const row = r;
+        if (!ancestorSet.has(row.pid))
+            continue;
+        if (opts.pidAlive && !opts.pidAlive(row.pid))
+            continue;
+        if (markerPid !== null && row.pid !== markerPid) {
+            // Marker present but names a different pid: the marker only narrows —
+            // the ancestry facts still count this ancestor row.
+        }
+        anyLane = true;
+        if (row.lane === laneChildWouldAcquire && !sameLane)
+            sameLane = row;
+    }
+    return {
+        nested: sameLane !== null,
+        shelteringPid: sameLane?.pid ?? null,
+        shelteringSlotId: sameLane?.id ?? null,
+        anyLaneAncestorHolder: anyLane,
+    };
+}
+//# sourceMappingURL=testRunnerRunClassifier.js.map

package/dist/core/testRunnerRunClassifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testRunnerRunClassifier.js","sourceRoot":"","sources":["../../src/core/testRunnerRunClassifier.ts"],"names":[],"mappings":"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"}

package/dist/core/types.d.ts

@@ -3336,6 +3336,27 @@ export interface InstarConfig {
                 rb?: number;
             };
         };
+        /**
+         * Test-Runner Concurrency Bound — host-wide vitest-root cap (the spawn
+         * cap's sibling; docs/specs/test-runner-concurrency-bound.md §2.9).
+         * CAVEAT (§2.6/§2.7 no-lie constraint): this block tunes the ROUTE's
+         * report + server-launched tooling ONLY — NOT the chokepoint. The vitest
+         * globalSetup runs in a bare test process that cannot know which agent's
+         * config to read, so setting `enabled:false` here does NOT disable the
+         * bound: the sole chokepoint kill switch is env
+         * `INSTAR_HOST_TEST_SEMAPHORE=off`, and the host-uniform authority for
+         * caps/posture is the tuning file `~/.instar/host-test-runner-tuning.json`
+         * (env `INSTAR_HOST_TEST_MAX` etc. are per-process overrides). The
+         * GET /test-runner-limiter route likewise resolves cap/posture through
+         * the chokepoint's resolvers, never from these values.
+         */
+        testRunnerCap?: {
+            enabled?: boolean;
+            /** Suite-lane concurrency (mirrors the code default 1). */
+            maxConcurrent?: number;
+            /** Background-class suite-lane acquire budget in ms (mirrors the code default 120000). */
+            acquireWaitMs?: number;
+        };
     };
     /**
      * Agent-level set of frameworks this install actively uses. Drives