@plune-ai/cli 0.25.0 → 0.27.0

package/README.md

@@ -165,9 +165,20 @@ plune requirements import prd.md --sections Requirements --unit bullets --key-pr
 
 `--sections` takes the heading or its number; `--unit bullets|subheadings` (default: sub-headings when the section has any); `--key-prefix` is text a bullet starts with that carries its key (`REQ-12: The system shall ...`; no pattern is accepted); `--priority-from subheading` makes the bullets under a sub-heading take its text as their priority.
 
-**3. Read the plan, then write it.** Without `--yes` nothing is written. The report is the summary line (`create 3 · update 0 · unchanged 12 · skip 1`), the rows grouped by action with their line in the file, key, title and reason (a skipped row says why), the priority and category values seen and what they map to, and what was **not imported** (other tables, other sections, frontmatter keys). It ends with `dry run — nothing was written; add --yes to apply`. Add `--yes` to apply the same plan in one transaction. A row with a key matches the requirement of that key; one without matches by exact title; running the same file again changes nothing (every row is `unchanged`). A skipped row does not fail the command.
+**2c. Several tables in one run.** A PRD keeps its functional and non-functional requirements in different tables. Repeat `--table` and put each table's columns inside it, after the number and a colon:
 
-`--json` prints the platform's answer instead. The project is the only one of the account, or `--project <id>` / `PLUNE_PROJECT` (a token only works in the project it was minted in). Exit `0` on success, `2` for a flag combination that cannot work (`--table` with `--sections`, `--title-column` with `--text-column`), an unreadable or over-limit file, or a rejected token, `1` when the platform refuses (400, 403, 409 a key taken meanwhile, 413) or does not have the routes yet.
+```bash
+plune requirements import prd.md \
+  --table "1:key=ID,text=Requirement,priority=Priority,fixed-category=functional" \
+  --table "2:key=ID,text=Requirement,fixed-category=non-functional" \
+  --map-priority "Must=Must-have"
+```
+
+Inside a `--table` the names are `key`, `title` or `text` (one of the two), `description`, `priority`, `category`, `type`, `status`, `criteria`, plus `fixed-category=functional|non-functional|other` and `fixed-type=user_story|feature|epic` — one meaning for the whole table, used where a row has none of its own. Names are separated by commas, so a header that contains a comma cannot be named in this form. `--map-priority`, `--type` and `--map-category` are shared by all tables. A table number may be given once. The single-table form (`--table 0 --key-column ...`) keeps working, but the two forms are not mixed: `--key-column` and the other column flags are refused together with `--table "<n>:..."`. The plan shows `table #N "heading"` in front of each row.
+
+**3. Read the plan, then write it.** Without `--yes` nothing is written. The report is the summary line (`create 3 · update 0 · unchanged 12 · skip 1`), the rows grouped by action with their line in the file, key, title and reason (a skipped row says why), the priority and category values seen and what they map to, and what was **not imported** (other tables, other sections, frontmatter keys). It ends with `dry run — nothing was written; add --yes to apply`. Add `--yes` to apply the same plan in one transaction. A row with a key matches the requirement of that key; one without matches by exact title; running the same file again changes nothing (every row is `unchanged`). A skipped row does not fail the command. Rows that are only placeholders (`[Behavior]`) are skipped with the reason `template placeholder`; a key that appears twice in the file is skipped with `first on line N, again on line M`. When every row is a placeholder the plan says `this file is an empty template` (`--json` has `"emptyTemplate": true`) and the exit code is `0`, like any plan whose rows are skipped: nothing is written, and nothing is an error.
+
+`--json` prints the platform's answer instead. The project is the only one of the account, or `--project <id>` / `PLUNE_PROJECT` (a token only works in the project it was minted in). Exit `0` on success, `2` for a flag combination that cannot work (`--table` with `--sections`, `--title-column` with `--text-column`, a `--table "<n>:..."` spec with the single-table column flags), an unreadable or over-limit file, or a rejected token, `1` when the platform refuses (400, 403, 409 a key taken meanwhile, 413) or does not have the routes yet.
 
 ### A release gate: `--fail-on-failures`
 
@@ -381,6 +392,17 @@ The shard that is the Nth also prints `plune: run closed` just above that line,
   and leaves the run open, as `PLUNE_SHARED_RUN` does: close it with `plune run finish`.
 - With `--fail-on-failures`, the shard that closes the run gates on its summary; the others have no verdict yet.
 
+### A time limit for the import
+
+The whole `plune run import` stops after 600 seconds by default, so a platform that stops answering cannot hold a CI job until its own timeout kills it. Raise it for a very large report, or turn it off with `0`:
+
+```bash
+PLUNE_IMPORT_TIMEOUT=1200 plune run import ./playwright.json     # seconds, 0 to 86400; 0 is no limit
+plune run import ./playwright.json --timeout 1200                # the same, as a flag (it wins)
+```
+
+At the limit the command sends `terminate` for the run it opened (not for a run other jobs share), says in one line that the platform may have received part of the results, and exits 1. Import the report again afterwards.
+
 ### Many screenshots: upload concurrency and retries
 
 Files go to Plune up to 100 to a request: `uploads-batch` announces them (with the SHA-256 of each, read as a stream,

package/dist/cli.cjs

@@ -2315,7 +2315,8 @@ function nodeTransport(url, init, idleMs = IDLE_MS) {
   return new Promise((resolve10, reject) => {
     const target = new URL(url);
     const send = target.protocol === "https:" ? import_node_https.request : import_node_http.request;
-    const req = send(target, { method: init.method, headers: init.headers }, (res) => {
+    const agent = POOLS[target.protocol === "https:" ? "https:" : "http:"];
+    const req = send(target, { method: init.method, headers: init.headers, agent }, (res) => {
       const chunks = [];
       res.on("data", (chunk2) => chunks.push(chunk2));
       res.on("error", reject);
@@ -2506,7 +2507,7 @@ function createClient(opts) {
     }
   };
 }
-var import_node_fs2, import_node_stream, import_node_http, import_node_https, BACKOFF_BASE_MS, BACKOFF_CAP_MS, DEFAULT_RETRIES, RETRY_AFTER_CAP_MS, IDLE_MS, withoutLength, codeOfError, sleep;
+var import_node_fs2, import_node_stream, import_node_http, import_node_https, BACKOFF_BASE_MS, BACKOFF_CAP_MS, DEFAULT_RETRIES, RETRY_AFTER_CAP_MS, POOLS, IDLE_MS, withoutLength, codeOfError, sleep;
 var init_client = __esm({
   "src/reporter-core/client.ts"() {
     "use strict";
@@ -2519,6 +2520,7 @@ var init_client = __esm({
     BACKOFF_CAP_MS = 1e4;
     DEFAULT_RETRIES = 2;
     RETRY_AFTER_CAP_MS = 6e4;
+    POOLS = { "http:": new import_node_http.Agent({ keepAlive: true }), "https:": new import_node_https.Agent({ keepAlive: true }) };
     IDLE_MS = 3e5;
     withoutLength = (headers) => Object.fromEntries(Object.entries(headers).filter(([name]) => name.toLowerCase() !== "content-length"));
     codeOfError = (err) => {
@@ -2577,6 +2579,7 @@ function readEnv(env = process.env) {
   const warnings = [];
   const uploadConcurrency = bounded(env, "PLUNE_UPLOAD_CONCURRENCY", UPLOAD_CONCURRENCY, warnings);
   const uploadRetries = bounded(env, "PLUNE_UPLOAD_RETRIES", UPLOAD_RETRIES, warnings);
+  const importTimeout = bounded(env, "PLUNE_IMPORT_TIMEOUT", IMPORT_TIMEOUT, warnings);
   const title = value(env, "PLUNE_RUN_TITLE");
   const environment = value(env, "PLUNE_ENV");
   const labels = list(env, "PLUNE_LABELS");
@@ -2608,6 +2611,7 @@ function readEnv(env = process.env) {
     keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED") || shard !== void 0 || shardError !== void 0,
     ...shard !== void 0 ? { shard } : {},
     ...shardError !== void 0 ? { shardError } : {},
+    ...importTimeout !== void 0 ? { importTimeout } : {},
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0),
     warnings
   };
@@ -2635,7 +2639,7 @@ function ciCommit(reported, env = process.env) {
     ...branch !== void 0 ? { branch } : {}
   };
 }
-var path6, UNSUPPORTED_VARS, SHARDS_MAX, UPLOAD_CONCURRENCY, UPLOAD_RETRIES, PROVIDERS;
+var path6, UNSUPPORTED_VARS, SHARDS_MAX, UPLOAD_CONCURRENCY, UPLOAD_RETRIES, IMPORT_TIMEOUT, PROVIDERS;
 var init_env2 = __esm({
   "src/reporter-core/env.ts"() {
     "use strict";
@@ -2645,6 +2649,7 @@ var init_env2 = __esm({
     SHARDS_MAX = 1e3;
     UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 16 };
     UPLOAD_RETRIES = { min: 0, max: 20, default: 6 };
+    IMPORT_TIMEOUT = { min: 0, max: 86400, default: 600 };
     PROVIDERS = [
       { is: "GITHUB_ACTIONS", sha: "GITHUB_SHA", branch: ["GITHUB_HEAD_REF", "GITHUB_REF_NAME"] },
       { is: "GITLAB_CI", sha: "CI_COMMIT_SHA", branch: ["CI_COMMIT_REF_NAME"] },
@@ -3558,7 +3563,29 @@ async function startRun(passed, declared2) {
     else await uploadBatched(jobs);
     uploadMs += Date.now() - started;
   }
+  const sending = /* @__PURE__ */ new Set();
+  let sendError;
+  let answered = false;
+  async function dispatch(work) {
+    while (sending.size >= (answered ? SEND_CONCURRENCY : 1)) await Promise.race(sending);
+    const task = work().catch((err) => {
+      sendError ??= err;
+    }).finally(() => sending.delete(task));
+    sending.add(task);
+  }
+  async function settle() {
+    while (sending.size > 0) await Promise.all([...sending]);
+    if (sendError !== void 0) {
+      const err = sendError;
+      sendError = void 0;
+      throw err;
+    }
+  }
   async function flush() {
+    await flushBuffer();
+    await settle();
+  }
+  async function flushBuffer() {
     if (buffer.length === 0) return;
     const pending = buffer;
     buffer = [];
@@ -3566,6 +3593,9 @@ async function startRun(passed, declared2) {
       defer(pending);
       return;
     }
+    await dispatch(() => deliver(pending));
+  }
+  async function deliver(pending) {
     await resolveKeys(pending.flatMap((p) => p.keys));
     const submissions = [];
     const unanswered = [];
@@ -3606,6 +3636,7 @@ async function startRun(passed, declared2) {
         for (const k of told) stats[k] += counts[k];
         progress();
         await upload(out.ok ? out.body?.items : void 0, filesByKey);
+        answered = true;
         continue;
       }
       if (out.ok) {
@@ -3680,7 +3711,7 @@ async function startRun(passed, declared2) {
     },
     async add(result) {
       buffer.push({ ...result, keys: bound(result.keys) });
-      if (buffer.length >= batchSize) await flush();
+      if (buffer.length >= batchSize) await flushBuffer();
     },
     flush,
     async finish(reason) {
@@ -3745,7 +3776,7 @@ async function startRun(passed, declared2) {
     }
   };
 }
-var import_node_crypto3, import_node_fs5, import_node_path3, import_node_util2, RESOLVE_CHUNK, BATCH_MAX, DISCOVER_MAX, BATCH_DEFAULT, EXPECTED_MAX, KEY_MAX, TITLE_MAX, COUNTED, SCREENSHOT_TYPES, SCREENSHOT_BYTES, SCREENSHOTS_PER_RESULT, TEXT_BYTES, TEXTS_PER_RESULT, UTF8, TYPE_BY_EXTENSION, METADATA_TYPE2, NAME_MAX, SKIPPED, BUCKET_FOUND, KINDS, codeOf2, BATCH_BYTES, ENVELOPE_BYTES;
+var import_node_crypto3, import_node_fs5, import_node_path3, import_node_util2, RESOLVE_CHUNK, BATCH_MAX, DISCOVER_MAX, BATCH_DEFAULT, SEND_CONCURRENCY, EXPECTED_MAX, KEY_MAX, TITLE_MAX, COUNTED, SCREENSHOT_TYPES, SCREENSHOT_BYTES, SCREENSHOTS_PER_RESULT, TEXT_BYTES, TEXTS_PER_RESULT, UTF8, TYPE_BY_EXTENSION, METADATA_TYPE2, NAME_MAX, SKIPPED, BUCKET_FOUND, KINDS, codeOf2, BATCH_BYTES, ENVELOPE_BYTES;
 var init_session = __esm({
   "src/reporter-core/session.ts"() {
     "use strict";
@@ -3765,6 +3796,7 @@ var init_session = __esm({
     BATCH_MAX = 500;
     DISCOVER_MAX = 500;
     BATCH_DEFAULT = 500;
+    SEND_CONCURRENCY = 4;
     EXPECTED_MAX = 1e4;
     KEY_MAX = 1024;
     TITLE_MAX = 300;
@@ -5336,8 +5368,24 @@ var init_importers = __esm({
 // src/cli/commands/run-import.ts
 var run_import_exports = {};
 __export(run_import_exports, {
+  ImportTimeoutError: () => ImportTimeoutError,
   handleRunImport: () => handleRunImport
 });
+async function timeoutMessage(limit, runId, ours, options) {
+  const head = `plune: run import did not finish in ${limit} s (--timeout / PLUNE_IMPORT_TIMEOUT; 0 turns the limit off); the platform may have received part of the results`;
+  if (runId === null) return `${head}; the run id is not known, so nothing was terminated - look for an open run with this key in Plune and terminate it there, then import again.`;
+  if (!ours) return `${head}; run ${runId} is shared with other jobs and was left open - close it with "plune run finish ${runId}" once they are done, then import this report again.`;
+  const wait = options.terminateWaitMs ?? 15e3;
+  let timer;
+  const gaveUp = new Promise((resolve10) => timer = setTimeout(() => resolve10("gaveup"), wait));
+  const quiet = () => void 0;
+  const closed = handleRunFinish(runId, { ...options, write: quiet, terminate: true, reason: `import timed out after ${limit} s` }).then(
+    () => true,
+    () => false
+  );
+  const done = await Promise.race([closed, gaveUp]).finally(() => clearTimeout(timer)) === true;
+  return done ? `${head}; run ${runId} was terminated - import the report again.` : `${head}; run ${runId} could not be terminated from here - run "plune run finish ${runId} --terminate" (the platform also closes a silent run after 30 minutes), then import again.`;
+}
 async function handleRunImport(options) {
   const write = options.write ?? ((line) => void process.stdout.write(`${line}
 `));
@@ -5364,31 +5412,47 @@ async function handleRunImport(options) {
   const apiUrl = resolveApiUrl(options.apiUrl ?? env.config.apiUrl);
   const token = options.token ?? env.config.token ?? loadToken() ?? "";
   if (token === "") throw new NoTokenError();
-  const session = await startRun(
-    {
-      apiUrl,
-      token,
-      ...options.fetchImpl !== void 0 ? { fetchImpl: options.fetchImpl } : {},
-      ...options.key !== void 0 ? { externalKey: options.key } : {},
-      ...options.create === true ? { offerDiscovered: true } : {},
-      ...options.uploadConcurrency !== void 0 ? { uploadConcurrency: options.uploadConcurrency } : {},
-      kind: "automated",
-      // The CI run the report names, never this machine's: whoever imports may be another job (#790).
-      // The commit and branch likewise, where the report names a commit; a report that names none —
-      // JUnit's never does — takes this job's own, which is where the tests ran when import follows
-      // them in one job (plune-ai/plune#927).
-      meta: { runner: format, ...ciUrl !== void 0 ? { ciUrl } : {}, ...ciCommit(ci) },
-      log: write
-    },
-    // The file is the complete list of what ran, so the platform can resolve every test in one
-    // request and derive what never ran from the same list (AC-09/AC-10) — the lazy path would be
-    // a lookup per result.
-    results.map((r) => r.keys)
-  );
-  for (const result2 of results) await session.add(result2);
+  let session;
+  const send = async () => {
+    session = await startRun(
+      {
+        apiUrl,
+        token,
+        ...options.fetchImpl !== void 0 ? { fetchImpl: options.fetchImpl } : {},
+        ...options.key !== void 0 ? { externalKey: options.key } : {},
+        ...options.create === true ? { offerDiscovered: true } : {},
+        ...options.uploadConcurrency !== void 0 ? { uploadConcurrency: options.uploadConcurrency } : {},
+        kind: "automated",
+        // The CI run the report names, never this machine's: whoever imports may be another job (#790).
+        // The commit and branch likewise, where the report names a commit; a report that names none —
+        // JUnit's never does — takes this job's own, which is where the tests ran when import follows
+        // them in one job (plune-ai/plune#927).
+        meta: { runner: format, ...ciUrl !== void 0 ? { ciUrl } : {}, ...ciCommit(ci) },
+        log: write
+      },
+      // The file is the complete list of what ran, so the platform can resolve every test in one
+      // request and derive what never ran from the same list (AC-09/AC-10) — the lazy path would be
+      // a lookup per result.
+      results.map((r) => r.keys)
+    );
+    for (const result2 of results) await session.add(result2);
+    return env.keepOpen ? session.leaveOpen({ holdShardLines: true }) : session.finish();
+  };
+  const limit = options.timeoutSec ?? env.importTimeout ?? IMPORT_TIMEOUT.default;
+  const sent = send();
   let frozen;
-  if (env.keepOpen) frozen = await session.leaveOpen({ holdShardLines: true });
-  else frozen = await session.finish();
+  if (limit === 0) frozen = await sent;
+  else {
+    sent.catch(() => void 0);
+    let timer;
+    const late = new Promise((resolve10) => timer = setTimeout(() => resolve10("late"), limit * 1e3));
+    const first = await Promise.race([sent, late]).finally(() => clearTimeout(timer));
+    if (first === "late") {
+      throw new ImportTimeoutError(await timeoutMessage(limit, session?.runId ?? null, !env.keepOpen, { ...options, apiUrl, token }));
+    }
+    frozen = first;
+  }
+  if (session === void 0) throw new RunCommandError("The import did not start.");
   const stats = session.stats;
   const result = {
     runId: session.runId,
@@ -5483,7 +5547,7 @@ function describe(result, apiUrl) {
   if (result.runId !== null) lines.push(runUrl2(apiUrl, result.runId));
   return lines;
 }
-var fs12, NEXT;
+var fs12, ImportTimeoutError, NEXT;
 var init_run_import = __esm({
   "src/cli/commands/run-import.ts"() {
     "use strict";
@@ -5497,6 +5561,8 @@ var init_run_import = __esm({
     init_credentials();
     init_gate();
     init_env2();
+    ImportTimeoutError = class extends RunCommandError {
+    };
     NEXT = {
       queue: "the review queue is full. Approve or reject what is waiting, then import this report again to offer the rest.",
       cases: "the project is at its test case limit. Delete cases you no longer need, or ask an operator to raise the limit, then import this report again to offer the rest.",
@@ -6291,6 +6357,7 @@ __export(requirements_import_exports, {
   formatReport: () => formatReport2,
   handleRequirementsImport: () => handleRequirementsImport,
   parseMap: () => parseMap,
+  parseTableSpec: () => parseTableSpec,
   reportRequirementsImportFailure: () => reportRequirementsImportFailure
 });
 function parseMap(flag2, raw) {
@@ -6306,25 +6373,63 @@ function parseMap(flag2, raw) {
   if (Object.keys(out).length === 0) usage(`${flag2} is empty. Write it like ${flag2} "Critical=Must-have,High=Should-have".`);
   return out;
 }
+function parseTableSpec(spec) {
+  const at = spec.indexOf(":");
+  const index = (at < 0 ? spec : spec.slice(0, at)).trim();
+  if (!/^\d+$/.test(index)) usage(`--table "${spec}": "${index}" is not a table number. ${SPEC_HELP}`);
+  const t = { table: Number(index) };
+  for (const pair of (at < 0 ? "" : spec.slice(at + 1)).split(",")) {
+    if (pair.trim() === "") continue;
+    const eq = pair.indexOf("=");
+    const name = (eq < 0 ? pair : pair.slice(0, eq)).trim().toLowerCase();
+    const value2 = eq < 0 ? "" : pair.slice(eq + 1).trim();
+    const field = TABLE_SPEC_KEYS[name];
+    if (field === void 0) return usage(`--table "${spec}": "${name}" is not a column name. Use ${Object.keys(TABLE_SPEC_KEYS).join(", ")}.`);
+    if (value2 === "") usage(`--table "${spec}": "${name}" has no value. ${SPEC_HELP}`);
+    if (field in t) usage(`--table "${spec}": "${name}" is given twice.`);
+    if (field === "fixedCategory") oneOf("fixed-category", value2, ["functional", "non-functional", "other"]);
+    if (field === "fixedType") oneOf("fixed-type", value2, ["user_story", "feature", "epic"]);
+    t[field] = value2;
+  }
+  if (t["titleColumn"] !== void 0 && t["textColumn"] !== void 0) usage(`--table "${spec}": give title= or text=, not both.`);
+  if (t["titleColumn"] === void 0 && t["textColumn"] === void 0) usage(`--table "${spec}": each table needs title=<header> or text=<header>.`);
+  return t;
+}
 function buildImportBody(f) {
+  const tables = f.table === void 0 ? [] : Array.isArray(f.table) ? f.table : [f.table];
   const columnFlags = COLUMN_FLAGS.filter(([k]) => f[k] !== void 0);
   const sectionFlags = SECTION_FLAGS.filter(([k]) => f[k] !== void 0);
-  const anyMapping = f.table !== void 0 || f.sections !== void 0 || columnFlags.length > 0 || sectionFlags.length > 0 || f.mapPriority !== void 0 || f.mapCategory !== void 0 || f.type !== void 0;
+  const anyMapping = tables.length > 0 || f.sections !== void 0 || columnFlags.length > 0 || sectionFlags.length > 0 || f.mapPriority !== void 0 || f.mapCategory !== void 0 || f.type !== void 0;
   if (!anyMapping) return null;
-  if (f.table !== void 0 && f.sections !== void 0) usage("Give --table or --sections, not both: one import reads one table or one section.");
-  if (f.table === void 0 && f.sections === void 0) {
+  if (tables.length > 0 && f.sections !== void 0) usage("Give --table or --sections, not both: one import reads one table or one section.");
+  if (tables.length === 0 && f.sections === void 0) {
     usage("The mapping flags need --table <n> (a table) or --sections <heading|n> (a section). Run without flags to see which the file has.");
   }
   const body = {};
   if (f.mapPriority !== void 0) body["priorityMap"] = parseMap("--map-priority", f.mapPriority);
   if (f.type !== void 0) body["defaultType"] = oneOf("--type", f.type, ["user_story", "feature", "epic"]);
-  if (f.table !== void 0) {
-    if (!/^\d+$/.test(f.table)) usage(`--table is the number of the table in the list (0, 1, ...), not "${f.table}".`);
+  if (tables.length > 1 || tables.some((t) => t.includes(":"))) {
+    if (sectionFlags.length > 0) usage(`${sectionFlags.map(([, n]) => n).join(", ")} ${sectionFlags.length > 1 ? "are" : "is"} for --sections, not --table.`);
+    if (columnFlags.length > 0) {
+      usage(`${columnFlags.map(([, n]) => n).join(", ")} cannot be used with --table "<n>:...": put the column inside each --table, e.g. --table "3:key=ID,text=Requirement".`);
+    }
+    const specs = tables.map(parseTableSpec);
+    const seen = /* @__PURE__ */ new Set();
+    for (const t of specs) {
+      if (seen.has(t["table"])) usage(`Table ${String(t["table"])} is given twice in --table.`);
+      seen.add(t["table"]);
+    }
+    body["mode"] = "table";
+    const categoryMap = f.mapCategory !== void 0 ? parseMap("--map-category", f.mapCategory) : void 0;
+    body["tables"] = specs.map((t) => categoryMap === void 0 ? t : { ...t, categoryMap });
+  } else if (tables.length === 1) {
+    const only = tables[0];
+    if (!/^\d+$/.test(only)) usage(`--table is the number of the table in the list (0, 1, ...), not "${only}".`);
     if (sectionFlags.length > 0) usage(`${sectionFlags.map(([, n]) => n).join(", ")} ${sectionFlags.length > 1 ? "are" : "is"} for --sections, not --table.`);
     if (f.titleColumn !== void 0 && f.textColumn !== void 0) usage("Give --title-column or --text-column, not both.");
     if (f.titleColumn === void 0 && f.textColumn === void 0) usage("--table needs --title-column <header> or --text-column <header>.");
     body["mode"] = "table";
-    body["table"] = Number(f.table);
+    body["table"] = Number(only);
     for (const [k, , key] of columnFlags) body[key] = f[k];
     if (f.mapCategory !== void 0) body["categoryMap"] = parseMap("--map-category", f.mapCategory);
   } else {
@@ -6434,13 +6539,19 @@ function formatDiscover(file, r) {
     "",
     "Pick one and map it (a dry run, nothing is written):",
     `  plune requirements import ${file} --table <n> --key-column <header> --title-column <header>`,
-    `  plune requirements import ${file} --sections <heading|n> --unit bullets|subheadings`
+    `  plune requirements import ${file} --sections <heading|n> --unit bullets|subheadings`,
+    "Several tables in one run, each with its own columns:",
+    `  plune requirements import ${file} --table "<n>:key=<header>,text=<header>,fixed-category=functional" --table "<m>:key=<header>,text=<header>"`
   );
   return out.join("\n") + "\n";
 }
 function formatReport2(report) {
   const s = report.summary;
   const out = [`create ${s.create} \xB7 update ${s.update} \xB7 unchanged ${s.unchanged} \xB7 skip ${s.skip}`];
+  if (report.emptyTemplate === true) {
+    const said = report.message !== void 0 && !/empty template/i.test(report.message) ? ` ${flat(report.message)}` : "";
+    out.push("", `this file is an empty template: every row is a placeholder, nothing to import.${said}`);
+  }
   for (const action of ["create", "update", "skip", "unchanged"]) {
     const rows = report.items.filter((i) => i.action === action);
     if (rows.length === 0) continue;
@@ -6448,7 +6559,8 @@ function formatReport2(report) {
     for (const i of rows.slice(0, SHOWN)) {
       const changes = i.changes !== void 0 && i.changes.length > 0 ? `; changes: ${i.changes.join(", ")}` : "";
       const notes = i.notes !== void 0 && i.notes.length > 0 ? `; note: ${i.notes.join("; ")}` : "";
-      out.push(`  line ${i.line}  ${i.key ?? "-"}  ${cut2(flat(i.title), 80)}  - ${flat(i.reason)}${changes}${notes}`);
+      const from = i.table === void 0 ? "" : `table #${i.table}${i.tableHeading ? ` "${cut2(flat(i.tableHeading), 40)}"` : ""}  `;
+      out.push(`  ${from}line ${i.line}  ${i.key ?? "-"}  ${cut2(flat(i.title), 80)}  - ${flat(i.reason)}${changes}${notes}`);
     }
     if (rows.length > SHOWN) out.push(`  ... and ${rows.length - SHOWN} more (--json lists every row)`);
   }
@@ -6472,7 +6584,7 @@ function reportRequirementsImportFailure(err, write) {
   write(err.message + "\n");
   return err.exitCode;
 }
-var import_node_fs7, import_node_path4, MAX_MARKDOWN_BYTES, RequirementsImportError, usage, COLUMN_FLAGS, SECTION_FLAGS, oneOf, SUPPORT, SHOWN, flat, cut2, plural;
+var import_node_fs7, import_node_path4, MAX_MARKDOWN_BYTES, RequirementsImportError, usage, COLUMN_FLAGS, SECTION_FLAGS, oneOf, TABLE_SPEC_KEYS, SPEC_HELP, SUPPORT, SHOWN, flat, cut2, plural;
 var init_requirements_import = __esm({
   "src/cli/commands/requirements-import.ts"() {
     "use strict";
@@ -6511,6 +6623,20 @@ var init_requirements_import = __esm({
       ["priorityFrom", "--priority-from"]
     ];
     oneOf = (flag2, value2, allowed) => allowed.includes(value2) ? value2 : usage(`${flag2} must be ${allowed.join(" or ")}, not "${value2}".`);
+    TABLE_SPEC_KEYS = {
+      key: "keyColumn",
+      title: "titleColumn",
+      text: "textColumn",
+      description: "descriptionColumn",
+      priority: "priorityColumn",
+      category: "categoryColumn",
+      type: "typeColumn",
+      status: "statusColumn",
+      criteria: "acceptanceCriteriaColumn",
+      "fixed-category": "fixedCategory",
+      "fixed-type": "fixedType"
+    };
+    SPEC_HELP = 'Write it like --table "3:key=ID,text=Requirement,fixed-category=functional".';
     SUPPORT = "This platform does not support requirements import yet. Nothing was sent to a project; try a newer Plune platform.";
     SHOWN = 50;
     flat = (s) => s.replace(/\s+/g, " ").trim();
@@ -6773,6 +6899,13 @@ function createProgram() {
       if (!/^\d+$/.test(v) || Number(v) < 1 || Number(v) > 32) throw new import_commander.InvalidArgumentError("a whole number from 1 to 32.");
       return Number(v);
     }
+  ).option(
+    "--timeout <seconds>",
+    "Give up on the whole import after this many seconds, 0 for no limit (default 600; PLUNE_IMPORT_TIMEOUT sets it too). On a timeout the run this import opened is terminated, and the exit code is 1",
+    (v) => {
+      if (!/^\d+$/.test(v) || Number(v) > 86400) throw new import_commander.InvalidArgumentError("a whole number of seconds from 0 to 86400.");
+      return Number(v);
+    }
   ).option("--fail-on-failures", FAIL_ON_FAILURES, false).action(
     async (file, options, command) => {
       const [
@@ -6799,6 +6932,7 @@ function createProgram() {
           ...options.key !== void 0 ? { key: options.key } : {},
           ...options.create ? { create: true } : {},
           ...options.uploadConcurrency !== void 0 ? { uploadConcurrency: options.uploadConcurrency } : {},
+          ...options.timeout !== void 0 ? { timeoutSec: options.timeout } : {},
           ...options.failOnFailures ? { failOnFailures: true } : {}
         });
         if (options.failOnMissingAttachments && imported.missingAttachments.length > 0) process.exitCode = 1;
@@ -7008,7 +7142,11 @@ function createProgram() {
   const requirementsCommand = program.command("requirements").description("Requirements on the platform \u2014 import them from a Markdown file");
   requirementsCommand.command("import").argument("<file>", "A Markdown file (UTF-8, at most 1 MiB)").description(
     "Import requirements from a Markdown file. With no mapping flags it lists the tables and sections found; with them it is a dry run until --yes"
-  ).option("--table <n>", "Read the table with this number (from the list)").option("--key-column <header>", "Table: the column holding the requirement key").option("--title-column <header>", "Table: the column holding the title").option("--text-column <header>", "Table: one text column; the title is its first line (not with --title-column)").option("--description-column <header>", "Table: the description column").option("--priority-column <header>", "Table: the priority column").option("--category-column <header>", "Table: the category column").option("--type-column <header>", "Table: the type column").option("--status-column <header>", "Table: the status column (draft, active or done)").option("--criteria-column <header>", "Table: the acceptance criteria column").option("--map-priority <pairs>", 'Rename priority values, e.g. "Critical=Must-have,High=Should-have"').option("--map-category <pairs>", 'Table: rename category values, e.g. "Quality=non-functional"').option("--sections <heading|n>", "Read the section with this heading or number (from the list)").option("--unit <unit>", "Sections: bullets or subheadings (default: sub-headings if it has any)").option("--key-prefix <text>", "Sections: text a bullet or sub-heading starts with that carries its key").option("--priority-from <source>", "Sections: subheading \u2014 bullets take their sub-heading as priority").option("--type <type>", "What a row without a type becomes: user_story, feature or epic").option("--project <id>", "The project (default: PLUNE_PROJECT, else the only project of the account)").option("--yes", "Write it. Without it the import is a dry run", false).option("--json", "Print the platform\u2019s answer as JSON", false).action(async (file, options, command) => {
+  ).option(
+    "--table <n|spec>",
+    'Read the table with this number (from the list); repeat as --table "<n>:key=ID,text=Requirement,fixed-category=functional" for several tables',
+    (value2, previous = []) => [...previous, value2]
+  ).option("--key-column <header>", "Table: the column holding the requirement key").option("--title-column <header>", "Table: the column holding the title").option("--text-column <header>", "Table: one text column; the title is its first line (not with --title-column)").option("--description-column <header>", "Table: the description column").option("--priority-column <header>", "Table: the priority column").option("--category-column <header>", "Table: the category column").option("--type-column <header>", "Table: the type column").option("--status-column <header>", "Table: the status column (draft, active or done)").option("--criteria-column <header>", "Table: the acceptance criteria column").option("--map-priority <pairs>", 'Rename priority values, e.g. "Critical=Must-have,High=Should-have"').option("--map-category <pairs>", 'Table: rename category values, e.g. "Quality=non-functional"').option("--sections <heading|n>", "Read the section with this heading or number (from the list)").option("--unit <unit>", "Sections: bullets or subheadings (default: sub-headings if it has any)").option("--key-prefix <text>", "Sections: text a bullet or sub-heading starts with that carries its key").option("--priority-from <source>", "Sections: subheading \u2014 bullets take their sub-heading as priority").option("--type <type>", "What a row without a type becomes: user_story, feature or epic").option("--project <id>", "The project (default: PLUNE_PROJECT, else the only project of the account)").option("--yes", "Write it. Without it the import is a dry run", false).option("--json", "Print the platform\u2019s answer as JSON", false).action(async (file, options, command) => {
     const verbose = command.optsWithGlobals().verbose === true;
     const { handleRequirementsImport: handleRequirementsImport2, formatDiscover: formatDiscover2, formatReport: formatReport3, reportRequirementsImportFailure: reportRequirementsImportFailure2 } = await Promise.resolve().then(() => (init_requirements_import(), requirements_import_exports));
     try {

package/dist/reporter-core.cjs

@@ -95,12 +95,14 @@ function parseRetryAfter(raw, now = Date.now()) {
   if (!Number.isFinite(seconds)) return null;
   return Math.min(Math.max(seconds, 0) * 1e3, RETRY_AFTER_CAP_MS);
 }
+var POOLS = { "http:": new import_node_http.Agent({ keepAlive: true }), "https:": new import_node_https.Agent({ keepAlive: true }) };
 var IDLE_MS = 3e5;
 function nodeTransport(url, init, idleMs = IDLE_MS) {
   return new Promise((resolve2, reject) => {
     const target = new URL(url);
     const send = target.protocol === "https:" ? import_node_https.request : import_node_http.request;
-    const req = send(target, { method: init.method, headers: init.headers }, (res) => {
+    const agent = POOLS[target.protocol === "https:" ? "https:" : "http:"];
+    const req = send(target, { method: init.method, headers: init.headers, agent }, (res) => {
       const chunks = [];
       res.on("data", (chunk2) => chunks.push(chunk2));
       res.on("error", reject);
@@ -314,6 +316,7 @@ function shardOf(env) {
 }
 var UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 16 };
 var UPLOAD_RETRIES = { min: 0, max: 20, default: 6 };
+var IMPORT_TIMEOUT = { min: 0, max: 86400, default: 600 };
 function value(env, name) {
   const raw = env[name]?.trim();
   return raw === void 0 || raw === "" ? void 0 : raw;
@@ -351,6 +354,7 @@ function readEnv(env = process.env) {
   const warnings = [];
   const uploadConcurrency = bounded(env, "PLUNE_UPLOAD_CONCURRENCY", UPLOAD_CONCURRENCY, warnings);
   const uploadRetries = bounded(env, "PLUNE_UPLOAD_RETRIES", UPLOAD_RETRIES, warnings);
+  const importTimeout = bounded(env, "PLUNE_IMPORT_TIMEOUT", IMPORT_TIMEOUT, warnings);
   const title = value(env, "PLUNE_RUN_TITLE");
   const environment = value(env, "PLUNE_ENV");
   const labels = list(env, "PLUNE_LABELS");
@@ -382,6 +386,7 @@ function readEnv(env = process.env) {
     keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED") || shard !== void 0 || shardError !== void 0,
     ...shard !== void 0 ? { shard } : {},
     ...shardError !== void 0 ? { shardError } : {},
+    ...importTimeout !== void 0 ? { importTimeout } : {},
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0),
     warnings
   };
@@ -591,6 +596,7 @@ var RESOLVE_CHUNK = 500;
 var BATCH_MAX = 500;
 var DISCOVER_MAX = 500;
 var BATCH_DEFAULT = 500;
+var SEND_CONCURRENCY = 4;
 var EXPECTED_MAX = 1e4;
 var KEY_MAX = 1024;
 var TITLE_MAX = 300;
@@ -1344,7 +1350,29 @@ async function startRun(passed, declared) {
     else await uploadBatched(jobs);
     uploadMs += Date.now() - started;
   }
+  const sending = /* @__PURE__ */ new Set();
+  let sendError;
+  let answered = false;
+  async function dispatch(work) {
+    while (sending.size >= (answered ? SEND_CONCURRENCY : 1)) await Promise.race(sending);
+    const task = work().catch((err) => {
+      sendError ??= err;
+    }).finally(() => sending.delete(task));
+    sending.add(task);
+  }
+  async function settle() {
+    while (sending.size > 0) await Promise.all([...sending]);
+    if (sendError !== void 0) {
+      const err = sendError;
+      sendError = void 0;
+      throw err;
+    }
+  }
   async function flush() {
+    await flushBuffer();
+    await settle();
+  }
+  async function flushBuffer() {
     if (buffer.length === 0) return;
     const pending = buffer;
     buffer = [];
@@ -1352,6 +1380,9 @@ async function startRun(passed, declared) {
       defer(pending);
       return;
     }
+    await dispatch(() => deliver(pending));
+  }
+  async function deliver(pending) {
     await resolveKeys(pending.flatMap((p) => p.keys));
     const submissions = [];
     const unanswered = [];
@@ -1392,6 +1423,7 @@ async function startRun(passed, declared) {
         for (const k of told) stats[k] += counts[k];
         progress();
         await upload(out.ok ? out.body?.items : void 0, filesByKey);
+        answered = true;
         continue;
       }
       if (out.ok) {
@@ -1466,7 +1498,7 @@ async function startRun(passed, declared) {
     },
     async add(result) {
       buffer.push({ ...result, keys: bound(result.keys) });
-      if (buffer.length >= batchSize) await flush();
+      if (buffer.length >= batchSize) await flushBuffer();
     },
     flush,
     async finish(reason) {

package/dist/reporter-core.d.cts

@@ -445,6 +445,8 @@ interface EnvSettings {
     shard?: ShardOf;
     /** `PLUNE_SHARD` was set to something that is not `k/N`. A configuration error: the caller refuses to start. */
     shardError?: string;
+    /** `PLUNE_IMPORT_TIMEOUT` in seconds, when set and usable. */
+    importTimeout?: number;
     /** Variables that were set and have nowhere to land. The caller says so once. */
     ignored: string[];
     /** Variables that were set to something unusable and fell back to their default. The caller says so once. */

package/dist/reporter-core.d.ts

@@ -445,6 +445,8 @@ interface EnvSettings {
     shard?: ShardOf;
     /** `PLUNE_SHARD` was set to something that is not `k/N`. A configuration error: the caller refuses to start. */
     shardError?: string;
+    /** `PLUNE_IMPORT_TIMEOUT` in seconds, when set and usable. */
+    importTimeout?: number;
     /** Variables that were set and have nowhere to land. The caller says so once. */
     ignored: string[];
     /** Variables that were set to something unusable and fell back to their default. The caller says so once. */

package/dist/reporter-core.js

@@ -33,8 +33,8 @@ function loadToken() {
 // src/reporter-core/client.ts
 import { createReadStream, openAsBlob } from "fs";
 import { pipeline } from "stream";
-import { request as httpRequest } from "http";
-import { request as httpsRequest } from "https";
+import { Agent as HttpAgent, request as httpRequest } from "http";
+import { Agent as HttpsAgent, request as httpsRequest } from "https";
 var BACKOFF_BASE_MS = 300;
 var BACKOFF_CAP_MS = 1e4;
 var DEFAULT_RETRIES = 2;
@@ -46,12 +46,14 @@ function parseRetryAfter(raw, now = Date.now()) {
   if (!Number.isFinite(seconds)) return null;
   return Math.min(Math.max(seconds, 0) * 1e3, RETRY_AFTER_CAP_MS);
 }
+var POOLS = { "http:": new HttpAgent({ keepAlive: true }), "https:": new HttpsAgent({ keepAlive: true }) };
 var IDLE_MS = 3e5;
 function nodeTransport(url, init, idleMs = IDLE_MS) {
   return new Promise((resolve2, reject) => {
     const target = new URL(url);
     const send = target.protocol === "https:" ? httpsRequest : httpRequest;
-    const req = send(target, { method: init.method, headers: init.headers }, (res) => {
+    const agent = POOLS[target.protocol === "https:" ? "https:" : "http:"];
+    const req = send(target, { method: init.method, headers: init.headers, agent }, (res) => {
       const chunks = [];
       res.on("data", (chunk2) => chunks.push(chunk2));
       res.on("error", reject);
@@ -265,6 +267,7 @@ function shardOf(env) {
 }
 var UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 16 };
 var UPLOAD_RETRIES = { min: 0, max: 20, default: 6 };
+var IMPORT_TIMEOUT = { min: 0, max: 86400, default: 600 };
 function value(env, name) {
   const raw = env[name]?.trim();
   return raw === void 0 || raw === "" ? void 0 : raw;
@@ -302,6 +305,7 @@ function readEnv(env = process.env) {
   const warnings = [];
   const uploadConcurrency = bounded(env, "PLUNE_UPLOAD_CONCURRENCY", UPLOAD_CONCURRENCY, warnings);
   const uploadRetries = bounded(env, "PLUNE_UPLOAD_RETRIES", UPLOAD_RETRIES, warnings);
+  const importTimeout = bounded(env, "PLUNE_IMPORT_TIMEOUT", IMPORT_TIMEOUT, warnings);
   const title = value(env, "PLUNE_RUN_TITLE");
   const environment = value(env, "PLUNE_ENV");
   const labels = list(env, "PLUNE_LABELS");
@@ -333,6 +337,7 @@ function readEnv(env = process.env) {
     keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED") || shard !== void 0 || shardError !== void 0,
     ...shard !== void 0 ? { shard } : {},
     ...shardError !== void 0 ? { shardError } : {},
+    ...importTimeout !== void 0 ? { importTimeout } : {},
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0),
     warnings
   };
@@ -542,6 +547,7 @@ var RESOLVE_CHUNK = 500;
 var BATCH_MAX = 500;
 var DISCOVER_MAX = 500;
 var BATCH_DEFAULT = 500;
+var SEND_CONCURRENCY = 4;
 var EXPECTED_MAX = 1e4;
 var KEY_MAX = 1024;
 var TITLE_MAX = 300;
@@ -1295,7 +1301,29 @@ async function startRun(passed, declared) {
     else await uploadBatched(jobs);
     uploadMs += Date.now() - started;
   }
+  const sending = /* @__PURE__ */ new Set();
+  let sendError;
+  let answered = false;
+  async function dispatch(work) {
+    while (sending.size >= (answered ? SEND_CONCURRENCY : 1)) await Promise.race(sending);
+    const task = work().catch((err) => {
+      sendError ??= err;
+    }).finally(() => sending.delete(task));
+    sending.add(task);
+  }
+  async function settle() {
+    while (sending.size > 0) await Promise.all([...sending]);
+    if (sendError !== void 0) {
+      const err = sendError;
+      sendError = void 0;
+      throw err;
+    }
+  }
   async function flush() {
+    await flushBuffer();
+    await settle();
+  }
+  async function flushBuffer() {
     if (buffer.length === 0) return;
     const pending = buffer;
     buffer = [];
@@ -1303,6 +1331,9 @@ async function startRun(passed, declared) {
       defer(pending);
       return;
     }
+    await dispatch(() => deliver(pending));
+  }
+  async function deliver(pending) {
     await resolveKeys(pending.flatMap((p) => p.keys));
     const submissions = [];
     const unanswered = [];
@@ -1343,6 +1374,7 @@ async function startRun(passed, declared) {
         for (const k of told) stats[k] += counts[k];
         progress();
         await upload(out.ok ? out.body?.items : void 0, filesByKey);
+        answered = true;
         continue;
       }
       if (out.ok) {
@@ -1417,7 +1449,7 @@ async function startRun(passed, declared) {
     },
     async add(result) {
       buffer.push({ ...result, keys: bound(result.keys) });
-      if (buffer.length >= batchSize) await flush();
+      if (buffer.length >= batchSize) await flushBuffer();
     },
     flush,
     async finish(reason) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plune-ai/cli",
-  "version": "0.25.0",
+  "version": "0.27.0",
   "description": "AI-powered assertion testing for LLM apps — write assertions, run them against any provider, get a pass/fail report (local, CI, or diff).",
   "keywords": [
     "ai",