@ansible-flow/node 0.0.0-stage → 0.86.0

package/dist/chunks/chunk-HPVT6I36.js

@@ -0,0 +1,371 @@
+// src/node/catalog/catalogIndex.ts
+import {
+  badgesOf,
+  metaOf,
+  nameCandidates,
+  planQuery,
+  rerank,
+  stem
+} from "@ansible-flow/core/catalog/rank";
+var INDEX_SCHEMA = 8;
+var WEIGHTS = [10, 6, 3, 1, 2];
+var CANDIDATES = 200;
+var COMMON = 0.5;
+var BROAD = 0.12;
+var TOKENIZE = "tokenize='porter unicode61'";
+var COLUMNS = "p.id, p.fqcn, p.type, p.collection, p.name, p.short, p.deprecated, p.meta";
+var sqlite;
+function loadSqlite() {
+  if (sqlite === void 0) {
+    const get = process.getBuiltinModule;
+    try {
+      sqlite = get?.call(process, "node:sqlite") ?? null;
+    } catch {
+      sqlite = null;
+    }
+  }
+  return sqlite;
+}
+function sqliteAvailable() {
+  return loadSqlite() !== null;
+}
+function sqliteMissing() {
+  return `The module catalog needs an editor running Node.js 22.13 or later (VS Code 1.101+); this one runs Node.js ${process.versions.node}`;
+}
+function database(path, options) {
+  const s = loadSqlite();
+  if (!s) throw new Error(sqliteMissing());
+  return options ? new s.DatabaseSync(path, options) : new s.DatabaseSync(path);
+}
+function hits(column, words2) {
+  return Array.from({ length: words2 }, (_, i) => `((instr(p.${column}, ?) > 0) << ${i})`).join(" | ") || "0";
+}
+function words(text) {
+  return text.replaceAll(/[._-]+/g, " ");
+}
+var CatalogIndex = class _CatalogIndex {
+  constructor(db) {
+    this.db = db;
+    this.total = db.prepare("SELECT count(*) AS n FROM plugins").get().n;
+    this.df = db.prepare("SELECT n FROM df WHERE term = ?");
+    this.named = db.prepare("SELECT 1 FROM plugins WHERE name = ? LIMIT 1");
+    this.docOf = db.prepare(
+      "SELECT d.doc FROM plugins p JOIN docs d ON d.id = p.id WHERE p.type = ? AND p.fqcn = ?"
+    );
+    this.routeOf = db.prepare("SELECT entry FROM routing WHERE type = ? AND name = ?");
+    this.textOf = db.prepare("SELECT opts, text FROM plugins WHERE id = ?");
+    this.stemmer.exec(`CREATE VIRTUAL TABLE t USING fts5(x, ${TOKENIZE});
+      CREATE VIRTUAL TABLE v USING fts5vocab(t, 'instance');`);
+    this.stemSql = {
+      clear: this.stemmer.prepare("DELETE FROM t"),
+      add: this.stemmer.prepare("INSERT INTO t (x) VALUES (?)"),
+      read: this.stemmer.prepare("SELECT term, offset FROM v")
+    };
+  }
+  db;
+  total;
+  df;
+  named;
+  docOf;
+  routeOf;
+  textOf;
+  searches = /* @__PURE__ */ new Map();
+  /** A scratch FTS table whose vocabulary gives the Porter stems the index uses. */
+  stemmer = database(":memory:");
+  stemSql;
+  /** Builds a fresh index at `path` (':memory:' in tests) from the probe's collection files. */
+  static build(path, files) {
+    const db = database(path);
+    db.exec(`
+      PRAGMA journal_mode = OFF;
+      PRAGMA synchronous = OFF;
+      PRAGMA page_size = 16384;
+      DROP TABLE IF EXISTS plugins; DROP TABLE IF EXISTS fts; DROP TABLE IF EXISTS routing;
+      DROP TABLE IF EXISTS meta; DROP TABLE IF EXISTS vocab; DROP TABLE IF EXISTS docs;
+      DROP TABLE IF EXISTS df;
+      CREATE TABLE meta (key TEXT PRIMARY KEY, value TEXT);
+      CREATE TABLE plugins (
+        id INTEGER PRIMARY KEY, type TEXT, fqcn TEXT, collection TEXT, name TEXT, short TEXT,
+        deprecated INTEGER, opts TEXT, strong TEXT, text TEXT, meta TEXT, UNIQUE (type, fqcn));
+      CREATE INDEX plugins_name ON plugins (name);
+      -- Full docs apart, so searches never page through them.
+      CREATE TABLE docs (id INTEGER PRIMARY KEY, doc TEXT);
+      CREATE VIRTUAL TABLE fts USING fts5(name, short, opts, body, coll, content='', ${TOKENIZE});
+      CREATE VIRTUAL TABLE vocab USING fts5vocab(fts, 'row');
+      -- Document frequency per stemmed term; reading it from vocab walks the term's doclist.
+      CREATE TABLE df (term TEXT PRIMARY KEY, n INTEGER) WITHOUT ROWID;
+      INSERT INTO fts (fts, rank) VALUES ('rank', 'bm25(${WEIGHTS.join(", ")})');
+      CREATE TABLE routing (type TEXT, name TEXT, entry TEXT, PRIMARY KEY (type, name));
+    `);
+    const addPlugin = db.prepare(
+      "INSERT OR IGNORE INTO plugins (type, fqcn, collection, name, short, deprecated, opts, strong, text, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)"
+    );
+    const addDoc = db.prepare("INSERT INTO docs (id, doc) VALUES (?, ?)");
+    const addText = db.prepare(
+      "INSERT INTO fts (rowid, name, short, opts, body, coll) VALUES (?, ?, ?, ?, ?, ?)"
+    );
+    const addRoute = db.prepare(
+      "INSERT OR REPLACE INTO routing (type, name, entry) VALUES (?, ?, ?)"
+    );
+    db.exec("BEGIN");
+    for (const file of files) {
+      for (const p of file.plugins) {
+        const options = Object.entries(p.options ?? {});
+        const strong = [
+          words(p.name),
+          p.short_description,
+          options.map(([k]) => words(k)).join(" ")
+        ].join(" ").toLowerCase();
+        const text = [
+          p.description.slice(0, 1500),
+          options.map(([, o]) => o.description).join(" ").slice(0, 2500)
+        ].join(" ").toLowerCase();
+        const r = addPlugin.run(
+          p.type,
+          p.fqcn,
+          p.collection,
+          p.name,
+          p.short_description,
+          p.deprecated ? 1 : 0,
+          options.map(([k]) => k).join(" "),
+          strong,
+          text,
+          JSON.stringify(metaOf(p))
+        );
+        if (!r.changes) continue;
+        addDoc.run(r.lastInsertRowid, JSON.stringify(p));
+        addText.run(
+          r.lastInsertRowid,
+          // The local name only: "open"* must not match every openstack.* module.
+          words(p.name),
+          p.short_description,
+          options.flatMap(([k, o]) => [words(k), ...(o.aliases ?? []).map(words)]).join(" "),
+          [p.description, p.notes ?? "", ...options.map(([, o]) => o.description)].join("\n").slice(0, 8e3),
+          words(p.collection)
+        );
+      }
+      const prefix = file.collection === "ansible.builtin" ? "" : `${file.collection}.`;
+      for (const [type, entries] of Object.entries(file.routing ?? {})) {
+        for (const [name, entry] of Object.entries(entries ?? {})) {
+          addRoute.run(type, `${prefix}${name}`, JSON.stringify(entry));
+          if (!prefix) addRoute.run(type, `ansible.builtin.${name}`, JSON.stringify(entry));
+        }
+      }
+    }
+    db.exec("INSERT INTO df (term, n) SELECT term, doc FROM vocab");
+    const set = db.prepare("INSERT INTO meta (key, value) VALUES (?, ?)");
+    set.run("schema", String(INDEX_SCHEMA));
+    set.run("collections", JSON.stringify(files.map((f) => `${f.collection}@${f.version}`)));
+    db.exec("COMMIT");
+    return new _CatalogIndex(db);
+  }
+  /** Opens an index built before, or undefined when it is missing or of an older schema. */
+  static open(path) {
+    try {
+      const db = database(path, { readOnly: true });
+      const row = db.prepare("SELECT value FROM meta WHERE key = 'schema'").get();
+      if (row?.value !== String(INDEX_SCHEMA)) {
+        db.close();
+        return void 0;
+      }
+      return new _CatalogIndex(db);
+    } catch {
+      return void 0;
+    }
+  }
+  close() {
+    this.db.close();
+    this.stemmer.close();
+  }
+  stats() {
+    const count = (sql) => this.db.prepare(sql).get().n;
+    return {
+      plugins: count("SELECT count(*) AS n FROM plugins"),
+      modules: count("SELECT count(*) AS n FROM plugins WHERE type = 'module'"),
+      collections: count("SELECT count(DISTINCT collection) AS n FROM plugins")
+    };
+  }
+  versions;
+  /** Every indexed collection and its version. */
+  collections() {
+    this.collectionVersion("");
+    return Object.fromEntries(this.versions ?? []);
+  }
+  /** The indexed version of a collection (`ansible.builtin` is ansible-core's). */
+  collectionVersion(name) {
+    if (!this.versions) {
+      const row = this.db.prepare("SELECT value FROM meta WHERE key = 'collections'").get();
+      const list = row ? JSON.parse(row.value) : [];
+      this.versions = new Map(
+        list.map((c) => [c.slice(0, c.indexOf("@")), c.slice(c.indexOf("@") + 1)])
+      );
+    }
+    return this.versions.get(name);
+  }
+  /**
+   * AFD-225: the filters, tests or lookups the environment has, for the Jinja completion list:
+   * ansible.builtin's by short name, a collection's by FQCN (ansible.legacy repeats builtin).
+   */
+  names(type) {
+    const rows = this.db.prepare(
+      "SELECT fqcn, collection, name, short FROM plugins WHERE type = ? AND collection <> 'ansible.legacy' ORDER BY collection <> 'ansible.builtin', fqcn"
+    ).all(type);
+    return rows.map((r) => ({
+      name: r.collection === "ansible.builtin" ? r.name : r.fqcn,
+      fqcn: r.fqcn,
+      ...r.short ? { doc: r.short } : {}
+    }));
+  }
+  plugin(fqcn, type = "module") {
+    const row = this.docOf.get(type, fqcn);
+    return row ? JSON.parse(row.doc) : void 0;
+  }
+  /** The index's own Porter stems of query words (create → creat, query → queri). */
+  porter(list) {
+    this.stemSql.clear.run();
+    this.stemSql.add.run(list.join(" "));
+    const out = [...list];
+    for (const r of this.stemSql.read.all())
+      out[r.offset] = r.term;
+    return out;
+  }
+  /** Parameters in text order: (match | names), stems for in_strong, stems for in_text, types. */
+  statement(kind, words2, types) {
+    const key = `${kind}:${words2}:${types}`;
+    let st = this.searches.get(key);
+    if (!st) {
+      const typed = types ? `p.type IN (${Array.from({ length: types }, () => "?").join(", ")})` : "";
+      const select = `${COLUMNS}, ${hits("strong", words2)} AS in_strong, ${hits("text", words2)} AS in_text`;
+      st = this.db.prepare(
+        kind === "fts" ? (
+          // FTS5 sorts by its configured rank (weighted bm25) fastest when nothing else is joined in.
+          `WITH top AS (SELECT rowid, rank FROM fts WHERE fts MATCH ? ORDER BY rank LIMIT ${CANDIDATES})
+            SELECT ${select}, top.rank FROM top JOIN plugins p ON p.id = top.rowid ${typed ? `WHERE ${typed}` : ""}`
+        ) : `WITH wanted AS (SELECT value FROM json_each(?))
+            SELECT ${select}, NULL AS rank FROM plugins p
+            WHERE p.name IN (SELECT value FROM wanted) ${typed ? `AND ${typed}` : ""}`
+      );
+      this.searches.set(key, st);
+    }
+    return st;
+  }
+  search(query, ctx = {}, limit = 20) {
+    const plan = planQuery(query);
+    if (plan.words.length === 0) return [];
+    let share = this.porter(plan.words).map(
+      (s) => (this.df.get(s)?.n ?? 0) / this.total
+    );
+    const keep = plan.words.map((w, i) => (share[i] ?? 0) <= COMMON || !!this.named.get(w));
+    if (plan.words.length > 1 && keep.some(Boolean)) {
+      plan.words = plan.words.filter((_, i) => keep[i]);
+      share = share.filter((_, i) => keep[i]);
+    }
+    const terms = plan.words;
+    const match = terms.map((t, i) => {
+      const column = (share[i] ?? 0) > BROAD ? "{name short opts} : " : "";
+      return t.length >= 3 ? `${column}"${t}" OR name : "${t}"*` : `${column}"${t}"`;
+    }).join(" OR ");
+    plan.names = nameCandidates(terms);
+    const types = ctx.types?.length ? ctx.types : [];
+    const crude = terms.map(stem);
+    const args = [...crude, ...crude, ...types];
+    const rows = [
+      ...this.statement("fts", terms.length, types.length).all(match, ...args),
+      ...this.statement("names", terms.length, types.length).all(
+        JSON.stringify([...plan.names.keys()]),
+        ...args
+      )
+    ];
+    const best = rows.reduce((m, r) => Math.max(m, -(r.rank ?? 0)), 0);
+    const seen = /* @__PURE__ */ new Set();
+    const scored = rows.filter((r) => {
+      const key = `${r.type}:${r.fqcn}`;
+      if (seen.has(key)) return false;
+      seen.add(key);
+      return true;
+    }).map((r) => {
+      const candidate = {
+        type: r.type,
+        name: r.name,
+        collection: r.collection,
+        inStrong: r.in_strong,
+        inText: r.in_text,
+        deprecated: r.deprecated === 1,
+        bm25: -(r.rank ?? 0)
+      };
+      return { r, score: rerank(candidate, plan, ctx, best) };
+    });
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, limit).map(({ r, score }) => {
+      const badges = badgesOf(r, JSON.parse(r.meta), ctx);
+      return {
+        fqcn: r.fqcn,
+        type: r.type,
+        collection: r.collection,
+        short_description: r.short,
+        score: Math.round(score * 1e3) / 1e3,
+        match: matchText(r, this.textOf.get(r.id), terms),
+        badges,
+        dimmed: badges.includes("other-platform")
+      };
+    });
+  }
+  route(type, name) {
+    const row = this.routeOf.get(type, name);
+    return row ? JSON.parse(row.entry) : void 0;
+  }
+  /**
+   * What Ansible runs for a module name (07 §2): the play's collections, then ansible.builtin, then
+   * redirects (at most five hops); tombstones mean removed.
+   */
+  resolve(name, collections = [], type = "module") {
+    const candidates = name.split(".").length >= 3 ? [name] : [...collections.map((c) => `${c}.${name}`), `ansible.builtin.${name}`];
+    let fallback;
+    for (const start of candidates) {
+      const hops = [start];
+      let current = start;
+      let deprecated;
+      for (let i = 0; i <= 5; i++) {
+        if (this.docOf.get(type, current)) return { fqcn: current, hops, deprecated, found: true };
+        const r = this.route(type, current);
+        if (!r) break;
+        if (r.deprecation)
+          deprecated = r.deprecation.warning_text || `deprecated (${r.deprecation.removal_version})`;
+        if (r.tombstone) {
+          fallback ??= {
+            hops,
+            removed: r.tombstone.warning_text || `removed in ${r.tombstone.removal_version}`,
+            found: false
+          };
+          break;
+        }
+        if (!r.redirect) break;
+        current = r.redirect;
+        hops.push(current);
+      }
+    }
+    return fallback ?? { hops: [name], found: false };
+  }
+};
+function matchText(r, more, terms) {
+  const where = [];
+  for (const t of terms) {
+    const s = stem(t);
+    if (r.name.toLowerCase().includes(s)) where.push(`name: ${t}`);
+    else if (r.short.toLowerCase().includes(s)) where.push(`summary: ${t}`);
+    else {
+      const opt = more.opts.split(" ").find((k) => k.toLowerCase().includes(s));
+      if (opt) where.push(`option \`${opt}\``);
+      else if (more.text.includes(s)) where.push(`description: ${t}`);
+    }
+  }
+  return [...new Set(where)].join(" \xB7 ");
+}
+
+export {
+  INDEX_SCHEMA,
+  sqliteAvailable,
+  sqliteMissing,
+  CatalogIndex
+};
+//# sourceMappingURL=chunk-HPVT6I36.js.map

package/dist/chunks/chunk-HPVT6I36.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/catalog/catalogIndex.ts"],
+  "sourcesContent": ["// The module catalog index (M5, ADR-0011): SQLite FTS5 through node:sqlite in the extension host\n// (verified on VS Code 1.140 and 1.144, desktop and Remote server). Built from the probe's\n// per-collection files; one database per environment manifest.\nimport type { DatabaseSync, StatementSync } from 'node:sqlite';\nimport {\n  badgesOf,\n  type Candidate,\n  metaOf,\n  nameCandidates,\n  type PluginMeta,\n  planQuery,\n  rerank,\n  stem,\n} from '../../core/catalog/rank';\nimport type {\n  CatalogPlugin,\n  CollectionFile,\n  PluginType,\n  Resolution,\n  RoutingEntry,\n  SearchContext,\n  SearchHit,\n} from '../../core/catalog/types';\nimport type { PluginName } from '../../core/view/jinjaComplete';\n\nexport const INDEX_SCHEMA = 8;\n/** bm25 column weights: plugin name, short description, option names, long text, collection. */\nconst WEIGHTS = [10, 6, 3, 1, 2];\nconst CANDIDATES = 200;\n/** Words in more than this share of the docs say nothing about the query (07 \u00A72). */\nconst COMMON = 0.5;\n/**\n * Words in more than this share are matched in names, summaries and option names only: bm25 runs\n * over every matching doc, and \"value\" in every option description is the whole catalog (p95 gate).\n */\nconst BROAD = 0.12;\nconst TOKENIZE = \"tokenize='porter unicode61'\";\n\ntype Row = {\n  id: number;\n  fqcn: string;\n  type: PluginType;\n  collection: string;\n  name: string;\n  short: string;\n  deprecated: number;\n  meta: string;\n  /** Bit i: query word i is in the name, summary or option names. */\n  in_strong: number;\n  /** Bit i: query word i is in the description or the option descriptions. */\n  in_text: number;\n  rank: number | null;\n};\n\nconst COLUMNS = 'p.id, p.fqcn, p.type, p.collection, p.name, p.short, p.deprecated, p.meta';\n\ntype Sqlite = typeof import('node:sqlite');\nlet sqlite: Sqlite | null | undefined;\n\n/**\n * node:sqlite, loaded on first use (AFD-171). It needs Node 22.13 (VS Code 1.101); editors built\n * on an older Electron (Kiro 0.1, older forks) run the extension without the module catalog\n * instead of failing to load it. getBuiltinModule, not require: the same code runs bundled and\n * under Vitest; Node before 20.16 has no getBuiltinModule and no SQLite either.\n */\nfunction loadSqlite(): Sqlite | null {\n  if (sqlite === undefined) {\n    const get = (process as { getBuiltinModule?: (id: string) => unknown }).getBuiltinModule;\n    try {\n      sqlite = (get?.call(process, 'node:sqlite') as Sqlite | undefined) ?? null;\n    } catch {\n      sqlite = null;\n    }\n  }\n  return sqlite;\n}\n\nexport function sqliteAvailable(): boolean {\n  return loadSqlite() !== null;\n}\n\n/** Why the catalog is off in this editor, for the status line and errors. */\nexport function sqliteMissing(): string {\n  return `The module catalog needs an editor running Node.js 22.13 or later (VS Code 1.101+); this one runs Node.js ${process.versions.node}`;\n}\n\nfunction database(path: string, options?: { readOnly?: boolean }): DatabaseSync {\n  const s = loadSqlite();\n  if (!s) throw new Error(sqliteMissing());\n  // An explicit undefined options argument is refused (\"must be an object\").\n  return options ? new s.DatabaseSync(path, options) : new s.DatabaseSync(path);\n}\n\n/** `(instr(col, ?) > 0) << 0 | \u2026` per query word: coverage computed in SQLite, not by shipping text. */\nfunction hits(column: string, words: number): string {\n  return (\n    Array.from({ length: words }, (_, i) => `((instr(p.${column}, ?) > 0) << ${i})`).join(' | ') ||\n    '0'\n  );\n}\n\nfunction words(text: string): string {\n  return text.replaceAll(/[._-]+/g, ' ');\n}\n\nexport class CatalogIndex {\n  private readonly total: number;\n  private readonly df: StatementSync;\n  private readonly named: StatementSync;\n  private readonly docOf: StatementSync;\n  private readonly routeOf: StatementSync;\n  private readonly textOf: StatementSync;\n  private readonly searches = new Map<string, StatementSync>();\n  /** A scratch FTS table whose vocabulary gives the Porter stems the index uses. */\n  private readonly stemmer = database(':memory:');\n  private readonly stemSql: { clear: StatementSync; add: StatementSync; read: StatementSync };\n\n  private constructor(private readonly db: DatabaseSync) {\n    this.total = (db.prepare('SELECT count(*) AS n FROM plugins').get() as { n: number }).n;\n    this.df = db.prepare('SELECT n FROM df WHERE term = ?');\n    this.named = db.prepare('SELECT 1 FROM plugins WHERE name = ? LIMIT 1');\n    this.docOf = db.prepare(\n      'SELECT d.doc FROM plugins p JOIN docs d ON d.id = p.id WHERE p.type = ? AND p.fqcn = ?',\n    );\n    this.routeOf = db.prepare('SELECT entry FROM routing WHERE type = ? AND name = ?');\n    this.textOf = db.prepare('SELECT opts, text FROM plugins WHERE id = ?');\n    this.stemmer.exec(`CREATE VIRTUAL TABLE t USING fts5(x, ${TOKENIZE});\n      CREATE VIRTUAL TABLE v USING fts5vocab(t, 'instance');`);\n    this.stemSql = {\n      clear: this.stemmer.prepare('DELETE FROM t'),\n      add: this.stemmer.prepare('INSERT INTO t (x) VALUES (?)'),\n      read: this.stemmer.prepare('SELECT term, offset FROM v'),\n    };\n  }\n\n  /** Builds a fresh index at `path` (':memory:' in tests) from the probe's collection files. */\n  static build(path: string, files: CollectionFile[]): CatalogIndex {\n    const db = database(path);\n    db.exec(`\n      PRAGMA journal_mode = OFF;\n      PRAGMA synchronous = OFF;\n      PRAGMA page_size = 16384;\n      DROP TABLE IF EXISTS plugins; DROP TABLE IF EXISTS fts; DROP TABLE IF EXISTS routing;\n      DROP TABLE IF EXISTS meta; DROP TABLE IF EXISTS vocab; DROP TABLE IF EXISTS docs;\n      DROP TABLE IF EXISTS df;\n      CREATE TABLE meta (key TEXT PRIMARY KEY, value TEXT);\n      CREATE TABLE plugins (\n        id INTEGER PRIMARY KEY, type TEXT, fqcn TEXT, collection TEXT, name TEXT, short TEXT,\n        deprecated INTEGER, opts TEXT, strong TEXT, text TEXT, meta TEXT, UNIQUE (type, fqcn));\n      CREATE INDEX plugins_name ON plugins (name);\n      -- Full docs apart, so searches never page through them.\n      CREATE TABLE docs (id INTEGER PRIMARY KEY, doc TEXT);\n      CREATE VIRTUAL TABLE fts USING fts5(name, short, opts, body, coll, content='', ${TOKENIZE});\n      CREATE VIRTUAL TABLE vocab USING fts5vocab(fts, 'row');\n      -- Document frequency per stemmed term; reading it from vocab walks the term's doclist.\n      CREATE TABLE df (term TEXT PRIMARY KEY, n INTEGER) WITHOUT ROWID;\n      INSERT INTO fts (fts, rank) VALUES ('rank', 'bm25(${WEIGHTS.join(', ')})');\n      CREATE TABLE routing (type TEXT, name TEXT, entry TEXT, PRIMARY KEY (type, name));\n    `);\n    const addPlugin = db.prepare(\n      'INSERT OR IGNORE INTO plugins (type, fqcn, collection, name, short, deprecated, opts, strong, text, meta) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',\n    );\n    const addDoc = db.prepare('INSERT INTO docs (id, doc) VALUES (?, ?)');\n    const addText = db.prepare(\n      'INSERT INTO fts (rowid, name, short, opts, body, coll) VALUES (?, ?, ?, ?, ?, ?)',\n    );\n    const addRoute = db.prepare(\n      'INSERT OR REPLACE INTO routing (type, name, entry) VALUES (?, ?, ?)',\n    );\n    db.exec('BEGIN');\n    for (const file of files) {\n      for (const p of file.plugins) {\n        const options = Object.entries(p.options ?? {});\n        // What the re-rank checks query words against, without parsing the whole doc per search:\n        // name, summary and option names, then the prose.\n        const strong = [\n          words(p.name),\n          p.short_description,\n          options.map(([k]) => words(k)).join(' '),\n        ]\n          .join(' ')\n          .toLowerCase();\n        const text = [\n          p.description.slice(0, 1500),\n          options\n            .map(([, o]) => o.description)\n            .join(' ')\n            .slice(0, 2500),\n        ]\n          .join(' ')\n          .toLowerCase();\n        const r = addPlugin.run(\n          p.type,\n          p.fqcn,\n          p.collection,\n          p.name,\n          p.short_description,\n          p.deprecated ? 1 : 0,\n          options.map(([k]) => k).join(' '),\n          strong,\n          text,\n          JSON.stringify(metaOf(p)),\n        );\n        if (!r.changes) continue;\n        addDoc.run(r.lastInsertRowid, JSON.stringify(p));\n        addText.run(\n          r.lastInsertRowid,\n          // The local name only: \"open\"* must not match every openstack.* module.\n          words(p.name),\n          p.short_description,\n          options.flatMap(([k, o]) => [words(k), ...(o.aliases ?? []).map(words)]).join(' '),\n          [p.description, p.notes ?? '', ...options.map(([, o]) => o.description)]\n            .join('\\n')\n            .slice(0, 8000),\n          words(p.collection),\n        );\n      }\n      // Builtin runtime entries are short names (ios_config); collection entries are local names.\n      const prefix = file.collection === 'ansible.builtin' ? '' : `${file.collection}.`;\n      for (const [type, entries] of Object.entries(file.routing ?? {})) {\n        for (const [name, entry] of Object.entries(entries ?? {})) {\n          addRoute.run(type, `${prefix}${name}`, JSON.stringify(entry));\n          if (!prefix) addRoute.run(type, `ansible.builtin.${name}`, JSON.stringify(entry));\n        }\n      }\n    }\n    db.exec('INSERT INTO df (term, n) SELECT term, doc FROM vocab');\n    const set = db.prepare('INSERT INTO meta (key, value) VALUES (?, ?)');\n    set.run('schema', String(INDEX_SCHEMA));\n    set.run('collections', JSON.stringify(files.map((f) => `${f.collection}@${f.version}`)));\n    db.exec('COMMIT');\n    return new CatalogIndex(db);\n  }\n\n  /** Opens an index built before, or undefined when it is missing or of an older schema. */\n  static open(path: string): CatalogIndex | undefined {\n    try {\n      const db = database(path, { readOnly: true });\n      const row = db.prepare(\"SELECT value FROM meta WHERE key = 'schema'\").get() as\n        | { value: string }\n        | undefined;\n      if (row?.value !== String(INDEX_SCHEMA)) {\n        db.close();\n        return undefined;\n      }\n      return new CatalogIndex(db);\n    } catch {\n      return undefined;\n    }\n  }\n\n  close(): void {\n    this.db.close();\n    this.stemmer.close();\n  }\n\n  stats(): { plugins: number; modules: number; collections: number } {\n    const count = (sql: string) => (this.db.prepare(sql).get() as { n: number }).n;\n    return {\n      plugins: count('SELECT count(*) AS n FROM plugins'),\n      modules: count(\"SELECT count(*) AS n FROM plugins WHERE type = 'module'\"),\n      collections: count('SELECT count(DISTINCT collection) AS n FROM plugins'),\n    };\n  }\n\n  private versions?: Map<string, string>;\n\n  /** Every indexed collection and its version. */\n  collections(): Record<string, string> {\n    this.collectionVersion('');\n    return Object.fromEntries(this.versions ?? []);\n  }\n\n  /** The indexed version of a collection (`ansible.builtin` is ansible-core's). */\n  collectionVersion(name: string): string | undefined {\n    if (!this.versions) {\n      const row = this.db.prepare(\"SELECT value FROM meta WHERE key = 'collections'\").get() as\n        | { value: string }\n        | undefined;\n      const list = row ? (JSON.parse(row.value) as string[]) : [];\n      this.versions = new Map(\n        list.map((c) => [c.slice(0, c.indexOf('@')), c.slice(c.indexOf('@') + 1)]),\n      );\n    }\n    return this.versions.get(name);\n  }\n\n  /**\n   * AFD-225: the filters, tests or lookups the environment has, for the Jinja completion list:\n   * ansible.builtin's by short name, a collection's by FQCN (ansible.legacy repeats builtin).\n   */\n  names(type: 'filter' | 'test' | 'lookup'): PluginName[] {\n    const rows = this.db\n      .prepare(\n        \"SELECT fqcn, collection, name, short FROM plugins WHERE type = ? AND collection <> 'ansible.legacy' ORDER BY collection <> 'ansible.builtin', fqcn\",\n      )\n      .all(type) as { fqcn: string; collection: string; name: string; short: string | null }[];\n    return rows.map((r) => ({\n      name: r.collection === 'ansible.builtin' ? r.name : r.fqcn,\n      fqcn: r.fqcn,\n      ...(r.short ? { doc: r.short } : {}),\n    }));\n  }\n\n  plugin(fqcn: string, type: PluginType = 'module'): CatalogPlugin | undefined {\n    const row = this.docOf.get(type, fqcn) as { doc: string } | undefined;\n    return row ? (JSON.parse(row.doc) as CatalogPlugin) : undefined;\n  }\n\n  /** The index's own Porter stems of query words (create \u2192 creat, query \u2192 queri). */\n  private porter(list: string[]): string[] {\n    this.stemSql.clear.run();\n    this.stemSql.add.run(list.join(' '));\n    const out = [...list];\n    for (const r of this.stemSql.read.all() as { term: string; offset: number }[])\n      out[r.offset] = r.term;\n    return out;\n  }\n\n  /** Parameters in text order: (match | names), stems for in_strong, stems for in_text, types. */\n  private statement(kind: 'fts' | 'names', words: number, types: number): StatementSync {\n    const key = `${kind}:${words}:${types}`;\n    let st = this.searches.get(key);\n    if (!st) {\n      const typed = types\n        ? `p.type IN (${Array.from({ length: types }, () => '?').join(', ')})`\n        : '';\n      const select = `${COLUMNS}, ${hits('strong', words)} AS in_strong, ${hits('text', words)} AS in_text`;\n      st = this.db.prepare(\n        kind === 'fts'\n          ? // FTS5 sorts by its configured rank (weighted bm25) fastest when nothing else is joined in.\n            `WITH top AS (SELECT rowid, rank FROM fts WHERE fts MATCH ? ORDER BY rank LIMIT ${CANDIDATES})\n            SELECT ${select}, top.rank FROM top JOIN plugins p ON p.id = top.rowid ${typed ? `WHERE ${typed}` : ''}`\n          : `WITH wanted AS (SELECT value FROM json_each(?))\n            SELECT ${select}, NULL AS rank FROM plugins p\n            WHERE p.name IN (SELECT value FROM wanted) ${typed ? `AND ${typed}` : ''}`,\n      );\n      this.searches.set(key, st);\n    }\n    return st;\n  }\n\n  search(query: string, ctx: SearchContext = {}, limit = 20): SearchHit[] {\n    const plan = planQuery(query);\n    if (plan.words.length === 0) return [];\n    // Share of plugins using each word. Common words go, except plugin names (\"create user\").\n    let share = this.porter(plan.words).map(\n      (s) => ((this.df.get(s) as { n: number } | undefined)?.n ?? 0) / this.total,\n    );\n    const keep = plan.words.map((w, i) => (share[i] ?? 0) <= COMMON || !!this.named.get(w));\n    if (plan.words.length > 1 && keep.some(Boolean)) {\n      plan.words = plan.words.filter((_, i) => keep[i]);\n      share = share.filter((_, i) => keep[i]);\n    }\n    const terms = plan.words;\n    const match = terms\n      .map((t, i) => {\n        const column = (share[i] ?? 0) > BROAD ? '{name short opts} : ' : '';\n        return t.length >= 3 ? `${column}\"${t}\" OR name : \"${t}\"*` : `${column}\"${t}\"`;\n      })\n      .join(' OR ');\n    // Plugins named by the words themselves (user, json_query, ipaddr for \"ip address\") are\n    // candidates even when bm25 can't tell them apart from thousands of others.\n    plan.names = nameCandidates(terms);\n    const types = ctx.types?.length ? ctx.types : [];\n    const crude = terms.map(stem);\n    const args = [...crude, ...crude, ...types];\n    const rows = [\n      ...(this.statement('fts', terms.length, types.length).all(match, ...args) as Row[]),\n      ...(this.statement('names', terms.length, types.length).all(\n        JSON.stringify([...plan.names.keys()]),\n        ...args,\n      ) as Row[]),\n    ];\n    const best = rows.reduce((m, r) => Math.max(m, -(r.rank ?? 0)), 0);\n    const seen = new Set<string>();\n    const scored = rows\n      .filter((r) => {\n        const key = `${r.type}:${r.fqcn}`;\n        if (seen.has(key)) return false;\n        seen.add(key);\n        return true;\n      })\n      .map((r) => {\n        const candidate: Candidate = {\n          type: r.type,\n          name: r.name,\n          collection: r.collection,\n          inStrong: r.in_strong,\n          inText: r.in_text,\n          deprecated: r.deprecated === 1,\n          bm25: -(r.rank ?? 0),\n        };\n        return { r, score: rerank(candidate, plan, ctx, best) };\n      });\n    scored.sort((a, b) => b.score - a.score);\n    return scored.slice(0, limit).map(({ r, score }) => {\n      const badges = badgesOf(r, JSON.parse(r.meta) as PluginMeta, ctx);\n      return {\n        fqcn: r.fqcn,\n        type: r.type,\n        collection: r.collection,\n        short_description: r.short,\n        score: Math.round(score * 1000) / 1000,\n        match: matchText(r, this.textOf.get(r.id) as { opts: string; text: string }, terms),\n        badges,\n        dimmed: badges.includes('other-platform'),\n      };\n    });\n  }\n\n  private route(type: string, name: string): RoutingEntry | undefined {\n    const row = this.routeOf.get(type, name) as { entry: string } | undefined;\n    return row ? (JSON.parse(row.entry) as RoutingEntry) : undefined;\n  }\n\n  /**\n   * What Ansible runs for a module name (07 \u00A72): the play's collections, then ansible.builtin, then\n   * redirects (at most five hops); tombstones mean removed.\n   */\n  resolve(name: string, collections: string[] = [], type: PluginType = 'module'): Resolution {\n    const candidates =\n      name.split('.').length >= 3\n        ? [name]\n        : [...collections.map((c) => `${c}.${name}`), `ansible.builtin.${name}`];\n    let fallback: Resolution | undefined;\n    for (const start of candidates) {\n      const hops = [start];\n      let current = start;\n      let deprecated: string | undefined;\n      for (let i = 0; i <= 5; i++) {\n        if (this.docOf.get(type, current)) return { fqcn: current, hops, deprecated, found: true };\n        const r = this.route(type, current);\n        if (!r) break;\n        if (r.deprecation)\n          deprecated =\n            r.deprecation.warning_text || `deprecated (${r.deprecation.removal_version})`;\n        if (r.tombstone) {\n          fallback ??= {\n            hops,\n            removed: r.tombstone.warning_text || `removed in ${r.tombstone.removal_version}`,\n            found: false,\n          };\n          break;\n        }\n        if (!r.redirect) break;\n        current = r.redirect;\n        hops.push(current);\n      }\n    }\n    return fallback ?? { hops: [name], found: false };\n  }\n}\n\n/** \"name: vlans \u00B7 option `vlan_id`\": where the query words were found, for the result list. */\nfunction matchText(\n  r: Pick<Row, 'name' | 'short'>,\n  more: { opts: string; text: string },\n  terms: string[],\n): string {\n  const where: string[] = [];\n  for (const t of terms) {\n    const s = stem(t);\n    if (r.name.toLowerCase().includes(s)) where.push(`name: ${t}`);\n    else if (r.short.toLowerCase().includes(s)) where.push(`summary: ${t}`);\n    else {\n      const opt = more.opts.split(' ').find((k) => k.toLowerCase().includes(s));\n      if (opt) where.push(`option \\`${opt}\\``);\n      else if (more.text.includes(s)) where.push(`description: ${t}`);\n    }\n  }\n  return [...new Set(where)].join(' \u00B7 ');\n}\n"],
+  "mappings": "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",
+  "names": ["words"]
+}

package/dist/chunks/chunk-I6FIOP7G.js

@@ -0,0 +1,48 @@
+// src/node/run/exec.ts
+import { spawn } from "node:child_process";
+function startProcess(spec, env, log) {
+  const group = process.platform !== "win32";
+  const feed = spec.input?.length ? spec.input : void 0;
+  const child = spawn(spec.command, spec.args, {
+    cwd: spec.cwd,
+    env: { ...process.env, ...env },
+    stdio: [feed ? "pipe" : "ignore", "pipe", "pipe"],
+    windowsHide: true,
+    detached: group
+  });
+  if (feed && child.stdin) {
+    child.stdin.on("error", () => void 0);
+    for (const name of feed)
+      child.stdin.write(`${Buffer.from(env[name] ?? "", "utf8").toString("base64")}
+`);
+    child.stdin.end();
+  }
+  const lines = (chunk) => {
+    for (const line of chunk.toString().split(/\r?\n/)) if (line.trim()) log(line);
+  };
+  child.stdout?.on("data", lines);
+  child.stderr?.on("data", lines);
+  const exit = new Promise((resolve) => {
+    child.on("error", (e) => {
+      log(e.message);
+      resolve(void 0);
+    });
+    child.on("close", (code) => resolve(code ?? void 0));
+  });
+  return {
+    exit,
+    terminate() {
+      try {
+        if (group && child.pid) process.kill(-child.pid, "SIGTERM");
+        else child.kill();
+      } catch {
+        child.kill();
+      }
+    }
+  };
+}
+
+export {
+  startProcess
+};
+//# sourceMappingURL=chunk-I6FIOP7G.js.map

package/dist/chunks/chunk-I6FIOP7G.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/run/exec.ts"],
+  "sourcesContent": ["// Starts the process of a run, a scenario or a check (AFD-271: one copy for the scenario runner\n// and for hosts that run flows without a terminal).\nimport { spawn } from 'node:child_process';\nimport type { ProcessSpec } from '../../core/run/command';\n\n/** A process that was started: how it ended, and how to end it. */\nexport interface Execution {\n  /** The exit code; undefined when the process could not start or ended without one. */\n  exit: Promise<number | undefined>;\n  /** Ends the process. What it started beyond itself (a container) is ended with `stopStarted`. */\n  terminate(): void;\n}\n\n/**\n * Runs `spec` with `env` on top of this process's environment, feeding its output to `log` line\n * by line. AFD-247: a spec with `input` names the variables whose values go to the process's\n * input, one base64 line each, instead of its arguments (what afd-ssh-run does for a terminal).\n */\nexport function startProcess(\n  spec: ProcessSpec,\n  env: Record<string, string>,\n  log: (line: string) => void,\n): Execution {\n  // AFD-131: on Linux and macOS the run gets a process group of its own, so a stop ends\n  // ansible-playbook too, not only the shell that started it.\n  const group = process.platform !== 'win32';\n  const feed = spec.input?.length ? spec.input : undefined;\n  const child = spawn(spec.command, spec.args, {\n    cwd: spec.cwd,\n    env: { ...process.env, ...env },\n    stdio: [feed ? 'pipe' : 'ignore', 'pipe', 'pipe'],\n    windowsHide: true,\n    detached: group,\n  });\n  if (feed && child.stdin) {\n    child.stdin.on('error', () => undefined);\n    for (const name of feed)\n      child.stdin.write(`${Buffer.from(env[name] ?? '', 'utf8').toString('base64')}\\n`);\n    child.stdin.end();\n  }\n  const lines = (chunk: Buffer) => {\n    for (const line of chunk.toString().split(/\\r?\\n/)) if (line.trim()) log(line);\n  };\n  child.stdout?.on('data', lines);\n  child.stderr?.on('data', lines);\n  const exit = new Promise<number | undefined>((resolve) => {\n    child.on('error', (e) => {\n      log(e.message);\n      resolve(undefined);\n    });\n    child.on('close', (code) => resolve(code ?? undefined));\n  });\n  return {\n    exit,\n    terminate() {\n      try {\n        if (group && child.pid) process.kill(-child.pid, 'SIGTERM');\n        else child.kill();\n      } catch {\n        child.kill();\n      }\n    },\n  };\n}\n"],
+  "mappings": ";AAEA,SAAS,aAAa;AAgBf,SAAS,aACd,MACA,KACA,KACW;AAGX,QAAM,QAAQ,QAAQ,aAAa;AACnC,QAAM,OAAO,KAAK,OAAO,SAAS,KAAK,QAAQ;AAC/C,QAAM,QAAQ,MAAM,KAAK,SAAS,KAAK,MAAM;AAAA,IAC3C,KAAK,KAAK;AAAA,IACV,KAAK,EAAE,GAAG,QAAQ,KAAK,GAAG,IAAI;AAAA,IAC9B,OAAO,CAAC,OAAO,SAAS,UAAU,QAAQ,MAAM;AAAA,IAChD,aAAa;AAAA,IACb,UAAU;AAAA,EACZ,CAAC;AACD,MAAI,QAAQ,MAAM,OAAO;AACvB,UAAM,MAAM,GAAG,SAAS,MAAM,MAAS;AACvC,eAAW,QAAQ;AACjB,YAAM,MAAM,MAAM,GAAG,OAAO,KAAK,IAAI,IAAI,KAAK,IAAI,MAAM,EAAE,SAAS,QAAQ,CAAC;AAAA,CAAI;AAClF,UAAM,MAAM,IAAI;AAAA,EAClB;AACA,QAAM,QAAQ,CAAC,UAAkB;AAC/B,eAAW,QAAQ,MAAM,SAAS,EAAE,MAAM,OAAO,EAAG,KAAI,KAAK,KAAK,EAAG,KAAI,IAAI;AAAA,EAC/E;AACA,QAAM,QAAQ,GAAG,QAAQ,KAAK;AAC9B,QAAM,QAAQ,GAAG,QAAQ,KAAK;AAC9B,QAAM,OAAO,IAAI,QAA4B,CAAC,YAAY;AACxD,UAAM,GAAG,SAAS,CAAC,MAAM;AACvB,UAAI,EAAE,OAAO;AACb,cAAQ,MAAS;AAAA,IACnB,CAAC;AACD,UAAM,GAAG,SAAS,CAAC,SAAS,QAAQ,QAAQ,MAAS,CAAC;AAAA,EACxD,CAAC;AACD,SAAO;AAAA,IACL;AAAA,IACA,YAAY;AACV,UAAI;AACF,YAAI,SAAS,MAAM,IAAK,SAAQ,KAAK,CAAC,MAAM,KAAK,SAAS;AAAA,YACrD,OAAM,KAAK;AAAA,MAClB,QAAQ;AACN,cAAM,KAAK;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

package/dist/chunks/chunk-IIFP6UQR.js

@@ -0,0 +1,44 @@
+// src/node/timeouts.ts
+var TIMEOUTS = {
+  /** The probe's first answer: the first start may pull the image. */
+  probeReady: 18e4,
+  /** A probe call without a timeout of its own. */
+  probeCall: 6e4,
+  /** The inventory read for a run's confirmation or the Inventory lens. */
+  probeInventory: 12e4,
+  /** The roles of a repository (catalog, Code mode). */
+  probeRoles: 12e4,
+  /** Compiling the generated code and roles (Code mode, the syntax check). */
+  probeCompile: 18e4,
+  /** Reading every collection's docs for the module catalog. */
+  catalogDump: 15 * 6e4,
+  /** Indexing the collection docs in a worker (seconds for a full environment; AFD-163). */
+  catalogIndex: 5 * 6e4,
+  /** One AWX REST request without data (idle). */
+  awxRequest: 3e4,
+  /** One AWX REST request from start to end, however slowly the data comes (AFD-161). */
+  awxRequestTotal: 12e4,
+  /** Between two polls of a running AWX job, workflow or project update. */
+  awxPoll: 2e3,
+  /** A finished AWX job's events keep arriving for a while. */
+  awxEventsGrace: 2e4,
+  /** An AWX project update before a template is set up. */
+  awxProjectSync: 18e4,
+  /** AFD-276: one Ansible Flow Server request without data. */
+  runnerRequest: 3e4,
+  /** AFD-276: between two looks at a run on the server. */
+  runnerPoll: 2e3,
+  /** A designer panel loading (PNG export opens one). */
+  designerReady: 3e4,
+  /** A designer panel drawing a PNG. */
+  designerPng: 6e4,
+  /** Test mode: a designer panel's DOM summary. */
+  designerInspect: 1e4,
+  /** Typing in a text editor settles before the designer parses again. */
+  typingSettles: 150
+};
+
+export {
+  TIMEOUTS
+};
+//# sourceMappingURL=chunk-IIFP6UQR.js.map

package/dist/chunks/chunk-IIFP6UQR.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/timeouts.ts"],
+  "sourcesContent": ["// How long the extension waits for things outside it (AFD-39: one place instead of constants in\n// a dozen files). Values in milliseconds.\n\nexport const TIMEOUTS = {\n  /** The probe's first answer: the first start may pull the image. */\n  probeReady: 180_000,\n  /** A probe call without a timeout of its own. */\n  probeCall: 60_000,\n  /** The inventory read for a run's confirmation or the Inventory lens. */\n  probeInventory: 120_000,\n  /** The roles of a repository (catalog, Code mode). */\n  probeRoles: 120_000,\n  /** Compiling the generated code and roles (Code mode, the syntax check). */\n  probeCompile: 180_000,\n  /** Reading every collection's docs for the module catalog. */\n  catalogDump: 15 * 60_000,\n  /** Indexing the collection docs in a worker (seconds for a full environment; AFD-163). */\n  catalogIndex: 5 * 60_000,\n  /** One AWX REST request without data (idle). */\n  awxRequest: 30_000,\n  /** One AWX REST request from start to end, however slowly the data comes (AFD-161). */\n  awxRequestTotal: 120_000,\n  /** Between two polls of a running AWX job, workflow or project update. */\n  awxPoll: 2_000,\n  /** A finished AWX job's events keep arriving for a while. */\n  awxEventsGrace: 20_000,\n  /** An AWX project update before a template is set up. */\n  awxProjectSync: 180_000,\n  /** AFD-276: one Ansible Flow Server request without data. */\n  runnerRequest: 30_000,\n  /** AFD-276: between two looks at a run on the server. */\n  runnerPoll: 2_000,\n  /** A designer panel loading (PNG export opens one). */\n  designerReady: 30_000,\n  /** A designer panel drawing a PNG. */\n  designerPng: 60_000,\n  /** Test mode: a designer panel's DOM summary. */\n  designerInspect: 10_000,\n  /** Typing in a text editor settles before the designer parses again. */\n  typingSettles: 150,\n} as const;\n"],
+  "mappings": ";AAGO,IAAM,WAAW;AAAA;AAAA,EAEtB,YAAY;AAAA;AAAA,EAEZ,WAAW;AAAA;AAAA,EAEX,gBAAgB;AAAA;AAAA,EAEhB,YAAY;AAAA;AAAA,EAEZ,cAAc;AAAA;AAAA,EAEd,aAAa,KAAK;AAAA;AAAA,EAElB,cAAc,IAAI;AAAA;AAAA,EAElB,YAAY;AAAA;AAAA,EAEZ,iBAAiB;AAAA;AAAA,EAEjB,SAAS;AAAA;AAAA,EAET,gBAAgB;AAAA;AAAA,EAEhB,gBAAgB;AAAA;AAAA,EAEhB,eAAe;AAAA;AAAA,EAEf,YAAY;AAAA;AAAA,EAEZ,eAAe;AAAA;AAAA,EAEf,aAAa;AAAA;AAAA,EAEb,iBAAiB;AAAA;AAAA,EAEjB,eAAe;AACjB;",
+  "names": []
+}

package/dist/chunks/chunk-JDPN3LTT.js

@@ -0,0 +1,18 @@
+// src/node/run/stop.ts
+import { execFile } from "node:child_process";
+function stopStarted(spec, timeoutMs = 15e3) {
+  const stop = spec.stop;
+  if (!stop) return Promise.resolve();
+  return new Promise((done) => {
+    try {
+      execFile(stop.command, stop.args, { timeout: timeoutMs, windowsHide: true }, () => done());
+    } catch {
+      done();
+    }
+  });
+}
+
+export {
+  stopStarted
+};
+//# sourceMappingURL=chunk-JDPN3LTT.js.map

package/dist/chunks/chunk-JDPN3LTT.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/node/run/stop.ts"],
+  "sourcesContent": ["// Ends what a run, scenario or probe process started beyond itself (AFD-131): its container. The\n// client process can be killed, but its container keeps running the playbook against the hosts.\nimport { execFile } from 'node:child_process';\nimport type { ProcessSpec } from '../../core/run/command';\n\n/** Runs `spec.stop` when it has one. Resolves once it ended or after `timeoutMs`; never rejects. */\nexport function stopStarted(spec: ProcessSpec, timeoutMs = 15_000): Promise<void> {\n  const stop = spec.stop;\n  if (!stop) return Promise.resolve();\n  return new Promise((done) => {\n    try {\n      execFile(stop.command, stop.args, { timeout: timeoutMs, windowsHide: true }, () => done());\n    } catch {\n      done();\n    }\n  });\n}\n"],
+  "mappings": ";AAEA,SAAS,gBAAgB;AAIlB,SAAS,YAAY,MAAmB,YAAY,MAAuB;AAChF,QAAM,OAAO,KAAK;AAClB,MAAI,CAAC,KAAM,QAAO,QAAQ,QAAQ;AAClC,SAAO,IAAI,QAAQ,CAAC,SAAS;AAC3B,QAAI;AACF,eAAS,KAAK,SAAS,KAAK,MAAM,EAAE,SAAS,WAAW,aAAa,KAAK,GAAG,MAAM,KAAK,CAAC;AAAA,IAC3F,QAAQ;AACN,WAAK;AAAA,IACP;AAAA,EACF,CAAC;AACH;",
+  "names": []
+}