plugins/ops-guards/hooks/lib/heavy.mjs

Functions

Imports

It imports plugins/ops-guards/hooks/lib/guard.mjs. Imported by plugins/ops-guards/hooks/register.js.

Source

1// Which commands count as heavy work (job_1e4b82452fe0, mod 1).
2//
3// Narrowed on the seat's answer of 2026-10-08: full test suites now run in CI and never on
4// this machine (PR #7), so what is left to collide locally is installs and builds. Text
5// matching, so a wrapper or alias gets through; it is a reminder to queue, not a wall.
6import { commandWords } from './guard.mjs';
7
8const NODE_PMS = new Set(['npm', 'npm.cmd', 'pnpm', 'pnpm.cmd', 'yarn', 'yarn.cmd', 'bun']);
9
10export function isHeavy(command) {
11  for (const w of commandWords(String(command ?? ''))) {
12    const exe = w[0].toLowerCase().replace(/^.*[\\/]/, '');
13    const args = w.slice(1).filter((a) => !a.startsWith('-'));
14    if (NODE_PMS.has(exe.replace(/\.cmd$/, '')) || NODE_PMS.has(exe)) {
15      const sub = args[0];
16      if (['ci', 'install', 'i', 'add', 'rebuild'].includes(sub)) return true;
17      if (sub === 'run' && /^build(?::|$)/.test(args[1] ?? '')) return true;
18      if (sub === 'build') return true;
19    }
20    if (exe === 'npx' || exe === 'npx.cmd') {
21      if (args[0] === 'playwright' && args[1] === 'install') return true;
22      if (args[0] === 'vite' && args[1] === 'build') return true;
23    }
24  }
25  return false;
26}
27
28/** The lock name for this tab: short and recognisable in the scheduler's refusal message. */
29export function lockNs(sessionId) {
30  return `tab-${String(sessionId ?? 'unknown').slice(0, 8)}`;
31}
32
33export function waitMessage(holder) {
34  if (!holder) return 'heavy-work lock is held by an unknown session';
35  return `heavy-work lock is held by ${holder.ns} since ${holder.started}`;
36}