amsd-pipeline-shared 0.4.2 → 0.4.4

package/orchestrations/scripts/lib/prelaunch.js

@@ -122,7 +122,9 @@ function seed({ install, project, ticket, runsRoots }) {
  * list, less the templates it installs as they are (copyVerbatim, and multi-body templates), present in the cached set.
  * An entry is <cache>/<id>.json, or <id>.<variant>.json for a variant run (brownfield).
  */
-function cache({ install, project, codeline, variant = process.env.EPAM_BROWNFIELD === '1' ? 'brownfield' : '' }) {
+// maxRebuild: how many generated prompts without an entry the launch accepts rebuilding (operator, 2026-10-19: a short,
+// NAMED list is acceptable). The launch states it (--max-rebuild); unstated it is 0 — every prompt must be reusable.
+function cache({ install, project, codeline, variant = process.env.EPAM_BROWNFIELD === '1' ? 'brownfield' : '', maxRebuild = 0 }) {
   const O = orchOf(install);
   const C = path.join(O, 'projects', project, '.prompt-cache', codeline);
   const b = require(path.join(scriptsOf(install), 'lib', 'project-prompt-builder.js'));
@@ -139,9 +141,10 @@ function cache({ install, project, codeline, variant = process.env.EPAM_BROWNFIE
   const required = list.filter((i) => prompts.includes(i) && !multi(i));
   const has = (i) => fs.existsSync(path.join(C, `${i}.json`)) || (variant && fs.existsSync(path.join(C, `${i}.${variant}.json`)));
   const missing = required.filter((i) => !has(i));
-  if (missing.length) problems.push(`${missing.length} of ${required.length} generated prompt(s) have no per-prompt entry, so any template change rebuilds them all (${missing.slice(0, 5).join(', ')}${missing.length > 5 ? ', …' : ''})`);
-  return res('cache', !problems.length, problems.length ? problems.join('; ') : `${codeline}: ${prompts.length} cached prompt(s), ${b.MINTED_FILES.length} minted file(s), ${required.length} per-prompt entries, marker present`,
-    { required: required.length, missing });
+  if (missing.length > Number(maxRebuild || 0)) problems.push(`${missing.length} of ${required.length} generated prompt(s) have no per-prompt entry and would be rebuilt (paid), above the launch's limit of ${Number(maxRebuild || 0)}: ${missing.join(', ')}`);
+  const rebuild = missing.length ? `; ${missing.length} without an entry will be rebuilt (within the launch's limit of ${maxRebuild}): ${missing.join(', ')}` : '';
+  return res('cache', !problems.length, problems.length ? problems.join('; ') : `${codeline}: ${prompts.length} cached prompt(s), ${b.MINTED_FILES.length} minted file(s), ${required.length - missing.length} of ${required.length} per-prompt entries, marker present${rebuild}`,
+    { required: required.length, missing, willRebuild: problems.length ? [] : missing });
 }
 
 // ── 4. cost ──────────────────────────────────────────────────────────────────────────────────────────────────────────
@@ -192,6 +195,13 @@ const cmdline = (pid, procDir = '/proc') => { try { return fs.readFileSync(`${pr
 function alone({ install, selfPid = process.pid, procDir = '/proc' }) {
   const mine = ancestors(selfPid, procDir);
   const inst = path.resolve(install);
+  // THE INSTALL'S OWN SERVICES are not another run: the services its installer registers, one pid file each
+  // (orchestrations/dashboards/.<name>.pid — snapshot-watch, cassette-watch), read from the install, never listed here.
+  // The pre-flight requires them running; a process running one of their scripts is that service (the pid recorded may be
+  // stale after a restart, so the script, not the pid, identifies it).
+  let services = [];
+  try { services = fs.readdirSync(path.join(orchOf(install), 'dashboards')).map((n) => (n.match(/^\.(.+)\.pid$/) || [])[1]).filter(Boolean).sort(); } catch { services = []; }
+  const isService = (s) => services.some((n) => s.includes(`${n}.js`));
   const others = [];
   let pids = []; try { pids = fs.readdirSync(procDir).filter((n) => /^\d+$/.test(n)); } catch { pids = []; }
   for (const p of pids) {
@@ -200,9 +210,9 @@ function alone({ install, selfPid = process.pid, procDir = '/proc' }) {
     const s = a.join(' ');
     let cwd = ''; try { cwd = fs.readlinkSync(`${procDir}/${p}/cwd`); } catch { cwd = ''; }
     // a pipeline process of THIS install: anything running its scripts or a run against it; my own shell is excluded above
-    if ((s.includes(inst) || cwd.startsWith(inst)) && /\b(node|bash|sh|python3?|claude)\b/.test(a[0] + ' ' + (a[1] || ''))) others.push(`${p} ${s.slice(0, 140)}`);
+    if ((s.includes(inst) || cwd.startsWith(inst)) && /\b(node|bash|sh|python3?|claude)\b/.test(a[0] + ' ' + (a[1] || '')) && !isService(s)) others.push(`${p} ${s.slice(0, 140)}`);
   }
-  return res('alone', !others.length, others.length ? `${others.length} other process(es) are working against ${inst}: ${others.slice(0, 3).join(' | ')}` : `nothing else is working against ${inst}`, { others });
+  return res('alone', !others.length, others.length ? `${others.length} other process(es) are working against ${inst}: ${others.slice(0, 3).join(' | ')}` : `nothing else is working against ${inst}${services.length ? ` (its own services not counted: ${services.join(', ')})` : ''}`, { others, services });
 }
 
 // ── 6. memory ────────────────────────────────────────────────────────────────────────────────────────────────────────
@@ -257,7 +267,7 @@ function prelaunch(o) {
   results.push(langfuse({ install: o.install, env: o.env, runId: o.runId, outDir: o.outDir }));
   if (o.ticket) results.push(seed({ install: o.install, project: o.project, ticket: o.ticket, runsRoots: o.runsRoots || [] }));
   // the variant (brownfield) is the run's, from the env the launch hands over — not this process's own environment
-  if (o.codeline) results.push(cache({ install: o.install, project: o.project, codeline: o.codeline, variant: (o.env || {}).EPAM_BROWNFIELD === '1' ? 'brownfield' : '' }));
+  if (o.codeline) results.push(cache({ install: o.install, project: o.project, codeline: o.codeline, variant: (o.env || {}).EPAM_BROWNFIELD === '1' ? 'brownfield' : '', maxRebuild: o.maxRebuild || 0 }));
   results.push(cost({ install: o.install, set: o.set || o.env.EPAM_PROVIDER_SET || 'claude', tmpDir: o.outDir }));
   results.push(alone({ install: o.install }));
   results.push(memory({ needMb: Number(o.needMb || 4096) }));
@@ -276,7 +286,7 @@ module.exports = { prelaunch, prelaunchCli, preflight, langfuse, langfuseEnv, se
  * THE COMMAND, for every pipeline:
  *   prelaunch.js --install <i> --project <p> --run-id <id> --out <dir> [--ticket <KEY> --runs <runs dir>[,…]]
  *                [--codeline <cl>] [--set <provider set>] [--need-mb <n>] [--leg-timeout-secs <s>] [--runner <launcher>]
- *                [--prd <file>] [--preflight no]
+ *                [--prd <file>] [--preflight no] [--max-rebuild <n prompts the launch accepts rebuilding>]
  * Prints each check and the verdict; writes <out>/prelaunch.json; exit 0 all green, 1 any red, 64 usage.
  */
 function prelaunchCli(argv, env = process.env) {
@@ -284,7 +294,7 @@ function prelaunchCli(argv, env = process.env) {
   for (const k of ['install', 'project', 'run-id', 'out']) if (!a[k]) { process.stderr.write(`prelaunch: --${k} is required\n`); return 64; }
   const r = prelaunch({ install: path.resolve(a.install), project: a.project, runId: a['run-id'], outDir: path.resolve(a.out), env,
     ticket: a.ticket, runsRoots: a.runs ? a.runs.split(',').map((d) => path.resolve(d)) : [], codeline: a.codeline,
-    set: a.set, needMb: a['need-mb'], legTimeoutSecs: a['leg-timeout-secs'], runner: a.runner, prd: a.prd, preflight: a.preflight !== 'no' });
+    set: a.set, needMb: a['need-mb'], maxRebuild: Number(a['max-rebuild'] || 0), legTimeoutSecs: a['leg-timeout-secs'], runner: a.runner, prd: a.prd, preflight: a.preflight !== 'no' });
   process.stdout.write('── Pre-launch (amsd-pipeline-shared) ─────────────────────────────────────────\n');
   for (const c of r.results) process.stdout.write(`  ${c.ok ? '✓' : '✗'} ${c.name}: ${c.detail}\n`);
   const cl = r.results.find((c) => c.name === 'checklist');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "amsd-pipeline-shared",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "The AMSD pipeline's shared components, one source for the bash pipeline and its Claude workflows: the model-call gateway (llm-handler.sh — retry, ladder, self-heal, cost) and the libraries it runs.",
   "license": "UNLICENSED",
   "bin": {