@plune-ai/cli 0.24.0 → 0.25.0

package/dist/cli.cjs

@@ -512,7 +512,7 @@ var init_retry = __esm({
     "use strict";
     init_cjs_shims();
     init_errors2();
-    defaultSleep = (ms) => new Promise((resolve9) => setTimeout(resolve9, ms));
+    defaultSleep = (ms) => new Promise((resolve10) => setTimeout(resolve10, ms));
   }
 });
 
@@ -555,22 +555,22 @@ var init_prices = __esm({
 });
 
 // src/providers/cost.ts
-function priceFrom(price, usage) {
-  return usage.input_tokens / 1e3 * price.input_per_1k_usd + usage.output_tokens / 1e3 * price.output_per_1k_usd;
+function priceFrom(price, usage2) {
+  return usage2.input_tokens / 1e3 * price.input_per_1k_usd + usage2.output_tokens / 1e3 * price.output_per_1k_usd;
 }
-function resolveCost(usage, model, reportedCostUsd, overrides, deps = {}) {
+function resolveCost(usage2, model, reportedCostUsd, overrides, deps = {}) {
   const table = deps.table ?? PRICE_TABLE;
   const warn = deps.warn ?? defaultWarn;
   const override = overrides?.[model];
   if (override !== void 0) {
-    return priceFrom(override, usage);
+    return priceFrom(override, usage2);
   }
   if (reportedCostUsd !== void 0) {
     return reportedCostUsd;
   }
   const tablePrice = table[model];
   if (tablePrice !== void 0) {
-    return priceFrom(tablePrice, usage);
+    return priceFrom(tablePrice, usage2);
   }
   warn(
     `plune: no price for model "${model}" \u2014 reporting cost_usd=0. Set pricing["${model}"] in plune.yaml to track its cost.`
@@ -628,8 +628,8 @@ function makeAnthropicProvider(config, env, pricing) {
         throw normalizeProviderError(err, apiKey, ENV_VAR);
       }
     },
-    estimateCost(usage, reportedCostUsd) {
-      return { cost_usd: resolveCost(usage, config.model, reportedCostUsd, pricing) };
+    estimateCost(usage2, reportedCostUsd) {
+      return { cost_usd: resolveCost(usage2, config.model, reportedCostUsd, pricing) };
     }
   };
 }
@@ -692,8 +692,8 @@ function makeOpenAiCompatibleProvider(opts) {
         throw normalizeProviderError(err, apiKey, apiKeyEnv);
       }
     },
-    estimateCost(usage, reportedCostUsd) {
-      return { cost_usd: resolveCost(usage, config.model, reportedCostUsd, pricing) };
+    estimateCost(usage2, reportedCostUsd) {
+      return { cost_usd: resolveCost(usage2, config.model, reportedCostUsd, pricing) };
     }
   };
 }
@@ -796,8 +796,8 @@ function makeEstimateProvider(config, pricing) {
     complete: () => Promise.reject(
       new Error("The --dry-run provider only estimates cost; it never calls a model.")
     ),
-    estimateCost: (usage, reportedCostUsd) => ({
-      cost_usd: resolveCost(usage, config.model, reportedCostUsd, pricing)
+    estimateCost: (usage2, reportedCostUsd) => ({
+      cost_usd: resolveCost(usage2, config.model, reportedCostUsd, pricing)
     })
   };
 }
@@ -1716,8 +1716,8 @@ async function runRow(p) {
   const maxTokens = p.providerConfig.max_tokens ?? DEFAULT_MAX_TOKENS2;
   if (p.dryRun) {
     const est = estimateUsage(prompt5, maxTokens);
-    const usage2 = { ...est, cost_usd: p.provider.estimateCost(est).cost_usd };
-    return { vars: p.row.vars, output: null, cached: false, usage: usage2, assertions: [] };
+    const usage3 = { ...est, cost_usd: p.provider.estimateCost(est).cost_usd };
+    return { vars: p.row.vars, output: null, cached: false, usage: usage3, assertions: [] };
   }
   const key = cacheKey({
     provider: p.providerConfig.type,
@@ -1727,13 +1727,13 @@ async function runRow(p) {
     prompt_resolved: prompt5
   });
   let output;
-  let usage;
+  let usage2;
   let cached = false;
   const hit = p.noCache ? void 0 : p.cache.get(key);
   if (hit !== void 0) {
     output = hit.output;
     cached = true;
-    usage = {
+    usage2 = {
       input_tokens: hit.usage.input_tokens,
       output_tokens: hit.usage.output_tokens,
       cost_usd: 0
@@ -1748,7 +1748,7 @@ async function runRow(p) {
         prompt_resolved: prompt5
       });
       output = res.output;
-      usage = {
+      usage2 = {
         input_tokens: res.usage.input_tokens,
         output_tokens: res.usage.output_tokens,
         // Prefer the provider-reported actual cost (res.cost_usd) when present; resolveCost still
@@ -1794,7 +1794,7 @@ async function runRow(p) {
       break;
     }
   }
-  const finalUsage = { ...usage, cost_usd: usage.cost_usd + judgeCost };
+  const finalUsage = { ...usage2, cost_usd: usage2.cost_usd + judgeCost };
   return {
     vars: p.row.vars,
     output,
@@ -2312,7 +2312,7 @@ function parseRetryAfter(raw, now = Date.now()) {
   return Math.min(Math.max(seconds, 0) * 1e3, RETRY_AFTER_CAP_MS);
 }
 function nodeTransport(url, init, idleMs = IDLE_MS) {
-  return new Promise((resolve9, reject) => {
+  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) => {
@@ -2322,7 +2322,7 @@ function nodeTransport(url, init, idleMs = IDLE_MS) {
       res.on("end", () => {
         const status = res.statusCode ?? 0;
         const text2 = Buffer.concat(chunks).toString("utf8");
-        resolve9({
+        resolve10({
           ok: status >= 200 && status <= 299,
           status,
           headers: {
@@ -2341,12 +2341,12 @@ function nodeTransport(url, init, idleMs = IDLE_MS) {
   });
 }
 function nodePut(url, headers, source, idleMs) {
-  return new Promise((resolve9, reject) => {
+  return new Promise((resolve10, reject) => {
     const target = new URL(url);
     const send = target.protocol === "https:" ? import_node_https.request : import_node_http.request;
     const length = "body" in source ? source.body.length : source.size;
     let answered;
-    const settle = (err) => answered !== void 0 ? resolve9(answered) : reject(err);
+    const settle = (err) => answered !== void 0 ? resolve10(answered) : reject(err);
     const req = send(
       target,
       { method: "PUT", headers: { ...withoutLength(headers), "content-length": String(length) } },
@@ -2355,7 +2355,7 @@ function nodePut(url, headers, source, idleMs) {
         answered = { status: res.statusCode ?? 0, retryAfter: Array.isArray(retry) ? retry[0] ?? null : retry ?? null };
         res.on("error", settle);
         res.on("close", () => {
-          resolve9(answered);
+          resolve10(answered);
           req.destroy();
         });
         res.resume();
@@ -2370,14 +2370,25 @@ function nodePut(url, headers, source, idleMs) {
 async function detailOf(res) {
   try {
     const body = await res.json();
+    const q = body.quota;
     return {
+      ...typeof body.shardsExpected === "number" && Number.isInteger(body.shardsExpected) ? { shardsExpected: body.shardsExpected } : {},
       detail: typeof body.error === "string" ? body.error : "",
+      ...typeof q === "object" && q !== null && !Array.isArray(q) ? { quota: q } : {},
       ...typeof body.code === "string" && /^[a-z0-9_]{1,60}$/.test(body.code) ? { code: body.code } : {}
     };
   } catch {
     return { detail: "" };
   }
 }
+function describeQuota(q) {
+  const num = (v) => typeof v === "number" && Number.isFinite(v) ? v : void 0;
+  const kind = typeof q["kind"] === "string" ? q["kind"].slice(0, 60) : "limit";
+  const [used, limit] = [num(q["used"]), num(q["limit"])];
+  const parts = [used !== void 0 && limit !== void 0 ? `${kind}: ${used} of ${limit} used` : kind];
+  if (typeof q["resetsAt"] === "string" && q["resetsAt"] !== "") parts.push(`resets ${q["resetsAt"].slice(0, 40)}`);
+  return parts.join(", ");
+}
 function classify(status) {
   if (status === 401 || status === 403) return "auth";
   if (status === 409) return "conflict";
@@ -2442,12 +2453,12 @@ function createClient(opts) {
       }
       const said = await detailOf(res);
       const kind = classify(res.status);
-      last = { kind, status: res.status, detail: scrub(said.detail), ...said.code !== void 0 ? { code: said.code } : {} };
+      last = { kind, status: res.status, detail: scrub(said.detail), ...said.code !== void 0 ? { code: said.code } : {}, ...said.shardsExpected !== void 0 ? { shardsExpected: said.shardsExpected } : {} };
       if (kind !== "unavailable") break;
       const said429 = parseRetryAfter(res.headers.get("retry-after"), now());
-      if (res.status === 429 && said429 === null) {
+      if (res.status === 429 && (said.quota !== void 0 || said429 === null)) {
         last.kind = "invalid";
-        last.detail = "quota exceeded (no Retry-After)";
+        last.detail = `quota exceeded (${said.quota === void 0 ? "no Retry-After" : scrub(describeQuota(said.quota))})`;
         if (said.detail) last.detail += ` \u2014 ${scrub(said.detail)}`;
         break;
       }
@@ -2460,6 +2471,7 @@ function createClient(opts) {
     post: (path17, body, retries) => send("POST", path17, { body: JSON.stringify(body), type: "application/json" }, retries),
     upload: (path17, bytes, contentType) => send("POST", path17, { body: bytes, type: contentType }, uploadRetries ?? DEFAULT_RETRIES),
     del: (path17) => send("DELETE", path17),
+    get: (path17) => send("GET", path17),
     async put(url, headers, source) {
       const putRetries = uploadRetries ?? 3;
       let last = { ok: false, status: null, code: "network" };
@@ -2518,6 +2530,16 @@ var init_client = __esm({
 });
 
 // src/reporter-core/env.ts
+function shardOf(env) {
+  const raw = value(env, "PLUNE_SHARD");
+  if (raw === void 0) return {};
+  const m = /^(\d{1,4})\/(\d{1,4})$/.exec(raw);
+  const [k, n] = m ? [Number(m[1]), Number(m[2])] : [0, 0];
+  if (k >= 1 && k <= n && n <= SHARDS_MAX) return { shard: { index: k, total: n } };
+  return {
+    error: `PLUNE_SHARD=${JSON.stringify(raw.slice(0, 40))} is not "k/N" with 1 <= k <= N <= ${SHARDS_MAX} (for example 2/4) - nothing was sent.`
+  };
+}
 function value(env, name) {
   const raw = env[name]?.trim();
   return raw === void 0 || raw === "" ? void 0 : raw;
@@ -2560,6 +2582,7 @@ function readEnv(env = process.env) {
   const labels = list(env, "PLUNE_LABELS");
   const offerDiscovered = flag(env, "PLUNE_CREATE");
   const full = flag(env, "PLUNE_FULL_RUN");
+  const { shard, error: shardError } = shardOf(env);
   return {
     config: {
       ...externalKey !== void 0 ? { externalKey } : {},
@@ -2580,7 +2603,11 @@ function readEnv(env = process.env) {
     // Two names for two situations that end the same way. `SHARED_RUN` says other processes are
     // reporting into this run; `PROCEED` says the job will close it on its own schedule. Either
     // way this process must not be the one to call it finished.
-    keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED"),
+    // `PLUNE_SHARD` implies it: the run is joined by the shared key and this process does not close it
+    // by itself; `leaveOpen` reports the shard instead.
+    keepOpen: flag(env, "PLUNE_SHARED_RUN") || flag(env, "PLUNE_PROCEED") || shard !== void 0 || shardError !== void 0,
+    ...shard !== void 0 ? { shard } : {},
+    ...shardError !== void 0 ? { shardError } : {},
     ignored: UNSUPPORTED_VARS.filter((name) => value(env, name) !== void 0),
     warnings
   };
@@ -2608,14 +2635,15 @@ function ciCommit(reported, env = process.env) {
     ...branch !== void 0 ? { branch } : {}
   };
 }
-var path6, UNSUPPORTED_VARS, UPLOAD_CONCURRENCY, UPLOAD_RETRIES, PROVIDERS;
+var path6, UNSUPPORTED_VARS, SHARDS_MAX, UPLOAD_CONCURRENCY, UPLOAD_RETRIES, PROVIDERS;
 var init_env2 = __esm({
   "src/reporter-core/env.ts"() {
     "use strict";
     init_cjs_shims();
     path6 = __toESM(require("path"), 1);
     UNSUPPORTED_VARS = ["PLUNE_GROUP"];
-    UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 4 };
+    SHARDS_MAX = 1e3;
+    UPLOAD_CONCURRENCY = { min: 1, max: 32, default: 16 };
     UPLOAD_RETRIES = { min: 0, max: 20, default: 6 };
     PROVIDERS = [
       { is: "GITHUB_ACTIONS", sha: "GITHUB_SHA", branch: ["GITHUB_HEAD_REF", "GITHUB_REF_NAME"] },
@@ -2914,6 +2942,7 @@ function warnIfDropped(sent, run, log) {
 }
 async function startRun(passed, declared2) {
   const env = readEnv();
+  if (env.shardError !== void 0) throw new Error(env.shardError);
   const stated = Object.fromEntries(Object.entries(passed).filter(([, v]) => v !== void 0));
   const cfg = { ...env.config, ...stated };
   const log = cfg.log ?? ((line) => void process.stderr.write(`${line}
@@ -2955,6 +2984,9 @@ async function startRun(passed, declared2) {
   const resolved = /* @__PURE__ */ new Map();
   let buffer = [];
   const discoveries = /* @__PURE__ */ new Map();
+  const held = /* @__PURE__ */ new Map();
+  let createdWithResult = 0;
+  let createdUndelivered = 0;
   let runId = null;
   let joined = false;
   let offline = token === "";
@@ -3083,6 +3115,7 @@ async function startRun(passed, declared2) {
       specRef: result.specRef,
       rawStatus: result.rawStatus
     });
+    held.set(result.keys[0].value, result);
   }
   async function offer() {
     if (discoveries.size === 0 || offline || runId === null) return;
@@ -3101,7 +3134,24 @@ async function startRun(passed, declared2) {
         return;
       }
       stats.offered += out.body.results.filter((r) => r?.outcome === "queued").length;
-      stats.created += out.body.results.filter((r) => r?.outcome === "created").length;
+      const made = out.body.results.filter((r) => r?.outcome === "created");
+      stats.created += made.length;
+      const submissions = [];
+      const filesByKey = /* @__PURE__ */ new Map();
+      for (const r of made) {
+        const pending = typeof r.id === "string" && r.id !== "" ? held.get(r.key?.value) : void 0;
+        if (pending === void 0) continue;
+        held.delete(r.key.value);
+        const { keys: _keys, files, ...rest } = pending;
+        submissions.push({ ...rest, testCaseId: r.id });
+        if (files !== void 0) filesByKey.set(pending.resultKey, files);
+      }
+      if (submissions.length > 0) {
+        const before = stats.deferred;
+        await send(submissions, filesByKey);
+        createdWithResult += submissions.length;
+        createdUndelivered += stats.deferred - before;
+      }
     }
   }
   function skip(kind, name, why) {
@@ -3154,8 +3204,8 @@ async function startRun(passed, declared2) {
         return skip(kind, job.name, "missing");
       }
     }
-    const refusal = kind === "text" ? textRefusal(bytes) : void 0;
-    if (refusal !== void 0) return skip(kind, job.name, refusal);
+    const refusal2 = kind === "text" ? textRefusal(bytes) : void 0;
+    if (refusal2 !== void 0) return skip(kind, job.name, refusal2);
     requests += 1;
     const out = await client.upload(
       `/v1/results/${encodeURIComponent(job.id)}/files?name=${encodeURIComponent(job.name)}`,
@@ -3187,7 +3237,7 @@ async function startRun(passed, declared2) {
   let free = uploadsAtOnce;
   const waiting = [];
   async function gated(work) {
-    if (free === 0) await new Promise((resolve9) => waiting.push(resolve9));
+    if (free === 0) await new Promise((resolve10) => waiting.push(resolve10));
     else free -= 1;
     try {
       return await work();
@@ -3439,9 +3489,9 @@ async function startRun(passed, declared2) {
           skip(kind, job.name, "missing");
           continue;
         }
-        const refusal = kind === "text" ? textRefusal(data) : void 0;
-        if (refusal !== void 0) {
-          skip(kind, job.name, refusal);
+        const refusal2 = kind === "text" ? textRefusal(data) : void 0;
+        if (refusal2 !== void 0) {
+          skip(kind, job.name, refusal2);
           continue;
         }
         body.push({ resultId: job.id, name: job.name, contentType: job.type, data: data.toString("base64") });
@@ -3538,6 +3588,9 @@ async function startRun(passed, declared2) {
       progress();
       return;
     }
+    await send(submissions, filesByKey);
+  }
+  async function send(submissions, filesByKey) {
     for (const part of packed(submissions)) {
       if (offline) {
         defer(part);
@@ -3581,7 +3634,10 @@ async function startRun(passed, declared2) {
     if (stats.rejected > 0) parts.push(`${stats.rejected} rejected`);
     if (stats.unresolved > 0) parts.push(`${stats.unresolved} with no matching test case`);
     if (stats.offered > 0) parts.push(`${stats.offered} offered for review`);
-    if (stats.created > 0) parts.push(`${stats.created} added as cases (trusted source)`);
+    if (stats.created > 0) {
+      const recorded = createdWithResult === stats.created && createdUndelivered === 0;
+      parts.push(`${stats.created} added as cases (trusted source)${recorded ? " and their results recorded" : ""}`);
+    }
     const kinds = [stats.screenshots, stats.textFiles, stats.otherFiles];
     const sum = (what) => kinds.reduce((n, counts) => n + counts[what], 0);
     if (bucketSeen) {
@@ -3611,6 +3667,7 @@ async function startRun(passed, declared2) {
       log(`::warning::${stats.deferred} result(s) were not delivered to Plune \u2014 see the reporting step's log.`);
     }
   }
+  const shardLines = [];
   return {
     get runId() {
       return runId;
@@ -3648,15 +3705,43 @@ async function startRun(passed, declared2) {
       summarise();
       return frozen;
     },
-    async leaveOpen() {
-      if (done) return;
+    shardLines,
+    async leaveOpen(opts) {
+      if (done) return void 0;
       done = true;
       await flush();
       await offer();
-      if (runId !== null) {
+      let frozen;
+      const after = [];
+      const shard = env.shard;
+      let counted = false;
+      let mismatch;
+      if (runId !== null && shard !== void 0 && !offline) {
+        const out = await client.post(`/v1/runs/${runId}/events`, { event: "finish", shardIndex: shard.index, shardsExpected: shard.total });
+        if (out.ok && typeof out.body?.shardsReported === "number") {
+          counted = true;
+          frozen = out.body.summary ?? void 0;
+          const n = out.body.shardsExpected ?? shard.total;
+          if (out.body.run?.statusEvent === "finished") after.push("plune: run closed");
+          after.push(`plune: shard ${shard.index} of ${shard.total} done \u2014 ${out.body.shardsReported} of ${n} shards reported`);
+        } else if (out.ok || out.kind === "invalid") {
+          log('plune: the platform does not support shard auto-close yet \u2014 the run is left open for "plune run finish".');
+        } else if (out.code === "shards_mismatch") {
+          mismatch = new Error(
+            `PLUNE_SHARD=${shard.index}/${shard.total} says ${shard.total} shards, but run ${runId} already expects ${out.shardsExpected ?? "a different number of"} \u2014 every shard of one run must use the same N. The results are uploaded; the run is left open.`
+          );
+        } else {
+          log(`plune: could not report shard ${shard.index} of ${shard.total} to run ${runId} (${out.detail || out.kind}) \u2014 the results are uploaded; close the run with "plune run finish ${runId}".`);
+        }
+      }
+      if (runId !== null && !counted) {
         log(`plune: run ${runId} is still open \u2014 close it with "plune run finish ${runId}".`);
       }
       summarise();
+      shardLines.push(...after);
+      if (opts?.holdShardLines !== true) for (const line of after) log(line);
+      if (mismatch !== void 0) throw mismatch;
+      return frozen;
     }
   };
 }
@@ -3843,14 +3928,14 @@ async function handleRunExec(options) {
   if (command === void 0) throw new RunCommandError("Nothing to run \u2014 pass a command after `--`.");
   const run = await handleRunStart(options);
   const spawnImpl = options.spawnImpl ?? import_node_child_process.spawn;
-  const code = await new Promise((resolve9) => {
+  const code = await new Promise((resolve10) => {
     const child = spawnImpl(command, args, {
       stdio: "inherit",
       shell: process.platform === "win32",
       env: { ...process.env, PLUNE_RUN: run.externalKey, PLUNE_PROCEED: "1" }
     });
-    child.on("close", (exitCode) => resolve9(exitCode ?? 1));
-    child.on("error", () => resolve9(1));
+    child.on("close", (exitCode) => resolve10(exitCode ?? 1));
+    child.on("error", () => resolve10(1));
   });
   return handleRunFinish(run.id, options, code);
 }
@@ -5302,7 +5387,7 @@ async function handleRunImport(options) {
   );
   for (const result2 of results) await session.add(result2);
   let frozen;
-  if (env.keepOpen) await session.leaveOpen();
+  if (env.keepOpen) frozen = await session.leaveOpen({ holdShardLines: true });
   else frozen = await session.finish();
   const stats = session.stats;
   const result = {
@@ -5333,13 +5418,14 @@ async function handleRunImport(options) {
   };
   for (const line of describe(result, apiUrl)) write(line);
   if (options.failOnFailures === true) {
-    if (env.keepOpen) {
+    if (env.keepOpen && frozen === void 0) {
       write("plune: the run is left open for the jobs still reporting, so there is no verdict yet \u2014 gate on the step that finishes it.");
     }
     const gate = gateExit(frozen);
     write(gate.line);
     result.gate = gate.code;
   }
+  for (const line of session.shardLines) write(line);
   return result;
 }
 function runUrl2(apiUrl, id) {
@@ -6195,6 +6281,244 @@ var init_ingest = __esm({
   }
 });
 
+// src/cli/commands/requirements-import.ts
+var requirements_import_exports = {};
+__export(requirements_import_exports, {
+  MAX_MARKDOWN_BYTES: () => MAX_MARKDOWN_BYTES,
+  RequirementsImportError: () => RequirementsImportError,
+  buildImportBody: () => buildImportBody,
+  formatDiscover: () => formatDiscover,
+  formatReport: () => formatReport2,
+  handleRequirementsImport: () => handleRequirementsImport,
+  parseMap: () => parseMap,
+  reportRequirementsImportFailure: () => reportRequirementsImportFailure
+});
+function parseMap(flag2, raw) {
+  const out = {};
+  for (const pair of raw.split(",")) {
+    if (pair.trim() === "") continue;
+    const at = pair.indexOf("=");
+    const from = at < 0 ? "" : pair.slice(0, at).trim();
+    const to = at < 0 ? "" : pair.slice(at + 1).trim();
+    if (from === "" || to === "") usage(`${flag2}: "${pair.trim()}" is not Value=Value. Write it like ${flag2} "Critical=Must-have,High=Should-have".`);
+    out[from] = to;
+  }
+  if (Object.keys(out).length === 0) usage(`${flag2} is empty. Write it like ${flag2} "Critical=Must-have,High=Should-have".`);
+  return out;
+}
+function buildImportBody(f) {
+  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;
+  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) {
+    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 (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);
+    for (const [k, , key] of columnFlags) body[key] = f[k];
+    if (f.mapCategory !== void 0) body["categoryMap"] = parseMap("--map-category", f.mapCategory);
+  } else {
+    if (columnFlags.length > 0) usage(`${columnFlags.map(([, n]) => n).join(", ")} ${columnFlags.length > 1 ? "are" : "is"} for --table, not --sections.`);
+    if (f.mapCategory !== void 0) usage("--map-category is for --table, not --sections.");
+    body["mode"] = "sections";
+    const section = (f.sections ?? "").trim();
+    if (section === "") usage("--sections needs a heading or its number in the list.");
+    body["section"] = /^\d+$/.test(section) ? Number(section) : section;
+    if (f.unit !== void 0) body["unit"] = oneOf("--unit", f.unit, ["bullets", "subheadings"]);
+    if (f.keyPrefix !== void 0) body["keyPrefix"] = f.keyPrefix;
+    if (f.priorityFrom !== void 0) body["priorityFrom"] = oneOf("--priority-from", f.priorityFrom, ["subheading"]);
+  }
+  return body;
+}
+function readMarkdown(cwd, file) {
+  const target = (0, import_node_path4.resolve)(cwd, file);
+  let size;
+  try {
+    const st = (0, import_node_fs7.statSync)(target);
+    if (!st.isFile()) return usage(`${target} is not a file.`);
+    size = st.size;
+  } catch {
+    return usage(`File not found: ${target}`);
+  }
+  if (size > MAX_MARKDOWN_BYTES) {
+    return usage(`${target} is ${size} bytes; the platform reads at most ${MAX_MARKDOWN_BYTES} bytes (1 MiB). Nothing was sent. Split the file.`);
+  }
+  let text2;
+  try {
+    text2 = new TextDecoder("utf-8", { fatal: true }).decode((0, import_node_fs7.readFileSync)(target));
+  } catch {
+    return usage(`${target} is not valid UTF-8. Save it as UTF-8 and try again.`);
+  }
+  text2 = text2.replace(/^/, "");
+  if (text2.trim() === "") usage(`${target} is empty.`);
+  return text2;
+}
+function refusal(out, apiUrl, projectId) {
+  const d = out.detail;
+  const said = d === "" ? "" : ` (${d})`;
+  switch (out.status) {
+    case null:
+      return new RequirementsImportError(`Could not reach the Plune API at ${apiUrl}. Check your connection (or PLUNE_API_URL) and try again.`, 1);
+    case 401:
+      return new RequirementsImportError(`Your API token was rejected (revoked or invalid). ${whereToGetAToken(apiUrl)} Then run "plune login".`, 2);
+    case 403:
+      return new RequirementsImportError(`The platform refused: ${d || "read-only member"}. Importing needs an owner or a member of the project.`, 1);
+    case 404:
+      return /^project '.*' not found$/.test(d) ? new RequirementsImportError(`Project ${projectId} was not found for this token. A token only works in the project it was minted in; pass --project <id> or use a token from that project.`, 1) : new RequirementsImportError(SUPPORT, 1);
+    case 409:
+      return new RequirementsImportError(`A requirement key was taken by another change while the import ran. Nothing was written; run it again${said}.`, 1);
+    case 413:
+      return new RequirementsImportError(`The platform refused the file as too large${said}. Nothing was written.`, 1);
+    case 400:
+      return new RequirementsImportError(`The platform refused the mapping${said}.`, 1);
+    default:
+      return new RequirementsImportError(`The platform answered HTTP ${out.status}${said}. Nothing was written.`, 1);
+  }
+}
+async function resolveProject(client, explicit, apiUrl) {
+  const given = (explicit ?? process.env["PLUNE_PROJECT"])?.trim();
+  if (given !== void 0 && given !== "") return given;
+  const out = await client.get("/v1/projects");
+  if (!out.ok) throw refusal(out, apiUrl, "");
+  const projects = out.body.projects ?? [];
+  if (projects.length === 1 && projects[0] !== void 0) return projects[0].id;
+  const list2 = projects.map((p) => `${p.id}${p.name ? ` (${p.name})` : ""}`).join(", ");
+  return usage(
+    projects.length === 0 ? "No project found for this token. Pass --project <id>." : `This account is in ${projects.length} projects (${list2}). A token only works in the project it was minted in: pass --project <id> (or set PLUNE_PROJECT).`
+  );
+}
+async function handleRequirementsImport(deps) {
+  const apiUrl = resolveApiUrl(deps.apiUrl);
+  const mapping = buildImportBody(deps);
+  const markdown = readMarkdown(deps.cwd ?? process.cwd(), deps.file);
+  const token = (deps.loadToken ?? loadToken)();
+  if (token === null) throw new RequirementsImportError('Not logged in. Run "plune login" first, or set PLUNE_TOKEN.', 2);
+  const client = createClient({ apiUrl, token, ...deps.fetchImpl !== void 0 ? { fetchImpl: deps.fetchImpl } : {} });
+  const projectId = await resolveProject(client, deps.project, apiUrl);
+  const base = `/v1/projects/${encodeURIComponent(projectId)}/requirements/import`;
+  if (mapping === null) {
+    const out2 = await client.post(`${base}/discover`, { markdown });
+    if (!out2.ok) throw refusal(out2, apiUrl, projectId);
+    return { step: "discover", result: out2.body };
+  }
+  const out = await client.post(base, { markdown, dryRun: deps.yes !== true, ...mapping });
+  if (!out.ok) throw refusal(out, apiUrl, projectId);
+  return { step: "import", report: out.body };
+}
+function formatDiscover(file, r) {
+  const out = [`${file}: ${plural(r.tables.length, "table")}, ${plural(r.sections.length, "section")}`];
+  if (r.frontmatter.keys.length > 0) out.push(`Frontmatter keys: ${r.frontmatter.keys.join(", ")}`);
+  out.push("", "Tables");
+  if (r.tables.length === 0) out.push("  (none)");
+  for (const t of r.tables) {
+    const mark = t.unreadable !== void 0 ? `   cannot be read: ${t.unreadable}` : t.looksLikeRequirements ? "   <- looks like requirements" : "";
+    out.push(`  #${t.index}  line ${t.line}  ${t.heading === null ? "(no heading)" : `"${flat(t.heading)}"`}  ${cut2(t.headers.map(flat).join(" | "), 100)}  ${plural(t.rowCount, "row")}${mark}`);
+  }
+  out.push("", "Sections");
+  if (r.sections.length === 0) out.push("  (none)");
+  for (const s of r.sections) {
+    out.push(`  #${s.index}  line ${s.line}  ${"#".repeat(s.level)} ${flat(s.heading)}  ${plural(s.bulletCount, "bullet")}, ${plural(s.subheadingCount, "sub-heading")}`);
+  }
+  if (r.truncated) out.push("", "The file has more headings or tables than are listed here.");
+  out.push(
+    "",
+    "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`
+  );
+  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}`];
+  for (const action of ["create", "update", "skip", "unchanged"]) {
+    const rows = report.items.filter((i) => i.action === action);
+    if (rows.length === 0) continue;
+    out.push("", `${action} (${rows.length})`);
+    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}`);
+    }
+    if (rows.length > SHOWN) out.push(`  ... and ${rows.length - SHOWN} more (--json lists every row)`);
+  }
+  for (const [label, values] of [["Priority values", report.values.priority], ["Category values", report.values.category]]) {
+    if (values.length === 0) continue;
+    out.push("", label);
+    for (const v of values.slice(0, SHOWN)) out.push(`  ${v.value}  x${v.count}  -> ${v.mappedTo ?? "(no mapping: kept as written)"}`);
+  }
+  const n = report.notImported;
+  if (n.tables.length + n.sections.length + n.frontmatterKeys.length > 0) {
+    out.push("", "Not imported");
+    for (const t of n.tables) out.push(`  table #${t.index} ${t.heading === null ? "" : `"${flat(t.heading)}" `}(${cut2(t.headers.map(flat).join(" | "), 80)}; ${plural(t.rowCount, "row")})`);
+    for (const x of n.sections) out.push(`  section #${x.index} "${flat(x.heading)}" (${plural(x.bulletCount, "bullet")})`);
+    if (n.frontmatterKeys.length > 0) out.push(`  frontmatter keys: ${n.frontmatterKeys.join(", ")}`);
+  }
+  out.push("", report.applied ? `applied \u2014 ${plural(s.create, "requirement")} created, ${s.update} updated.` : "dry run \u2014 nothing was written; add --yes to apply");
+  return out.join("\n") + "\n";
+}
+function reportRequirementsImportFailure(err, write) {
+  if (!(err instanceof RequirementsImportError)) return null;
+  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 init_requirements_import = __esm({
+  "src/cli/commands/requirements-import.ts"() {
+    "use strict";
+    init_cjs_shims();
+    import_node_fs7 = require("fs");
+    import_node_path4 = require("path");
+    init_client();
+    init_api_url();
+    init_credentials();
+    MAX_MARKDOWN_BYTES = 1048576;
+    RequirementsImportError = class extends Error {
+      constructor(message, exitCode) {
+        super(message);
+        this.exitCode = exitCode;
+        this.name = "RequirementsImportError";
+      }
+      exitCode;
+    };
+    usage = (message) => {
+      throw new RequirementsImportError(message, 2);
+    };
+    COLUMN_FLAGS = [
+      ["keyColumn", "--key-column", "keyColumn"],
+      ["titleColumn", "--title-column", "titleColumn"],
+      ["textColumn", "--text-column", "textColumn"],
+      ["descriptionColumn", "--description-column", "descriptionColumn"],
+      ["priorityColumn", "--priority-column", "priorityColumn"],
+      ["categoryColumn", "--category-column", "categoryColumn"],
+      ["typeColumn", "--type-column", "typeColumn"],
+      ["statusColumn", "--status-column", "statusColumn"],
+      ["criteriaColumn", "--criteria-column", "acceptanceCriteriaColumn"]
+    ];
+    SECTION_FLAGS = [
+      ["unit", "--unit"],
+      ["keyPrefix", "--key-prefix"],
+      ["priorityFrom", "--priority-from"]
+    ];
+    oneOf = (flag2, value2, allowed) => allowed.includes(value2) ? value2 : usage(`${flag2} must be ${allowed.join(" or ")}, not "${value2}".`);
+    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();
+    cut2 = (s, n) => s.length > n ? `${s.slice(0, n - 1)}\u2026` : s;
+    plural = (n, one, many = `${one}s`) => `${n} ${n === 1 ? one : many}`;
+  }
+});
+
 // src/cli.ts
 var cli_exports = {};
 __export(cli_exports, {
@@ -6204,11 +6528,11 @@ module.exports = __toCommonJS(cli_exports);
 init_cjs_shims();
 init_api_url();
 var import_commander = require("commander");
-var import_node_fs7 = require("fs");
-var import_node_path4 = require("path");
+var import_node_fs8 = require("fs");
+var import_node_path5 = require("path");
 var import_node_url = require("url");
-var __dirname = (0, import_node_path4.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
-var pkg = JSON.parse((0, import_node_fs7.readFileSync)((0, import_node_path4.join)(__dirname, "..", "package.json"), "utf-8"));
+var __dirname = (0, import_node_path5.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
+var pkg = JSON.parse((0, import_node_fs8.readFileSync)((0, import_node_path5.join)(__dirname, "..", "package.json"), "utf-8"));
 function toFormat(s) {
   return s === "json" || s === "markdown" ? s : "console";
 }
@@ -6217,7 +6541,7 @@ function shouldColor(outputPath) {
 }
 function writeReport(text2, outputPath) {
   if (outputPath !== void 0) {
-    (0, import_node_fs7.writeFileSync)(outputPath, text2);
+    (0, import_node_fs8.writeFileSync)(outputPath, text2);
   } else {
     process.stdout.write(text2 + "\n");
   }
@@ -6262,7 +6586,7 @@ function createProgram() {
   program.hook("preAction", async (_program, action) => {
     const { loadEnv: loadEnv2 } = await Promise.resolve().then(() => (init_env(), env_exports));
     const { config } = action.optsWithGlobals();
-    if (config !== void 0) loadEnv2((0, import_node_path4.dirname)((0, import_node_path4.resolve)(config)));
+    if (config !== void 0) loadEnv2((0, import_node_path5.dirname)((0, import_node_path5.resolve)(config)));
     loadEnv2(process.cwd());
   });
   const runCommand = program.command("run").description("Run assertions against a dataset").option("--dry-run", "Estimate cost/tokens; do not call the model", false).option("--config <path>", "Path to plune.yaml config file").option(
@@ -6444,7 +6768,7 @@ function createProgram() {
     false
   ).option(
     "--upload-concurrency <n>",
-    "File uploads in flight at once, 1 to 32 (default 4; PLUNE_UPLOAD_CONCURRENCY sets it too). Files are announced and confirmed up to 100 to a request; a 429 is retried PLUNE_UPLOAD_RETRIES times (default 6)",
+    "File uploads in flight at once, 1 to 32 (default 16; PLUNE_UPLOAD_CONCURRENCY sets it too). Files are announced and confirmed up to 100 to a request; a 429 is retried PLUNE_UPLOAD_RETRIES times (default 6)",
     (v) => {
       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);
@@ -6495,7 +6819,7 @@ function createProgram() {
       Promise.resolve().then(() => (init_report(), report_exports)),
       Promise.resolve().then(() => (init_reporters(), reporters_exports))
     ]);
-    const cwd = globals.config !== void 0 ? (0, import_node_path4.dirname)((0, import_node_path4.resolve)(globals.config)) : process.cwd();
+    const cwd = globals.config !== void 0 ? (0, import_node_path5.dirname)((0, import_node_path5.resolve)(globals.config)) : process.cwd();
     try {
       const result = handleReport2({ cwd });
       const text2 = renderReport2(result, toFormat(options.format), {
@@ -6592,7 +6916,7 @@ function createProgram() {
     const globals = command.optsWithGlobals();
     const verbose = globals.verbose === true;
     const { handleSync: handleSync2, reportSyncFailure: reportSyncFailure2 } = await Promise.resolve().then(() => (init_sync(), sync_exports));
-    const cwd = globals.config !== void 0 ? (0, import_node_path4.dirname)((0, import_node_path4.resolve)(globals.config)) : process.cwd();
+    const cwd = globals.config !== void 0 ? (0, import_node_path5.dirname)((0, import_node_path5.resolve)(globals.config)) : process.cwd();
     try {
       const { id, url, gate } = await handleSync2({
         cwd,
@@ -6663,13 +6987,13 @@ function createProgram() {
     "Send a Markdown document of test cases back to Plune (POST /v1/test-cases/markdown)"
   ).option("--dry-run", "Show what would change and write nothing", false).action(async (file, options, command) => {
     const verbose = command.optsWithGlobals().verbose === true;
-    const { handlePush: handlePush2, formatReport: formatReport2, reportCasesFailure: reportCasesFailure2 } = await Promise.resolve().then(() => (init_cases(), cases_exports));
+    const { handlePush: handlePush2, formatReport: formatReport3, reportCasesFailure: reportCasesFailure2 } = await Promise.resolve().then(() => (init_cases(), cases_exports));
     try {
       const report = await handlePush2({
         ...file !== void 0 ? { file } : {},
         dryRun: options.dryRun
       });
-      process.stdout.write(formatReport2(report));
+      process.stdout.write(formatReport3(report));
       if (report.refused.length > 0) process.exitCode = 4;
     } catch (err) {
       const code = reportCasesFailure2(err, (s) => process.stderr.write(s));
@@ -6681,6 +7005,29 @@ function createProgram() {
       failUnexpected(err, verbose);
     }
   });
+  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) => {
+    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 {
+      const res = await handleRequirementsImport2({ file, ...options });
+      if (options.json === true) {
+        process.stdout.write(JSON.stringify(res.step === "discover" ? res.result : res.report, null, 2) + "\n");
+      } else {
+        process.stdout.write(res.step === "discover" ? formatDiscover2(file, res.result) : formatReport3(res.report));
+      }
+    } catch (err) {
+      const code = reportRequirementsImportFailure2(err, (s) => process.stderr.write(s));
+      if (code !== null) {
+        maybeStack(err, verbose);
+        process.exitCode = code;
+        return;
+      }
+      failUnexpected(err, verbose);
+    }
+  });
   const planCommand = program.command("plan").description("Test plans on the platform \u2014 what a plan collects, as something a runner can take");
   planCommand.command("grep").argument("<id>", "The plan").description(
     "Print the plan's cases as one --grep pattern for the runner (GET /v1/plans/:id/cases)"
@@ -6716,7 +7063,7 @@ function isMainModule() {
   const entry = process.argv[1];
   if (entry === void 0) return false;
   try {
-    return (0, import_node_fs7.realpathSync)(entry) === (0, import_node_fs7.realpathSync)((0, import_node_url.fileURLToPath)(importMetaUrl));
+    return (0, import_node_fs8.realpathSync)(entry) === (0, import_node_fs8.realpathSync)((0, import_node_url.fileURLToPath)(importMetaUrl));
   } catch {
     return false;
   }