@wirecat/cli-core 0.19.0 → 0.19.2

package/README.md

@@ -36,6 +36,9 @@ streams.stderr // []
 | `renderer` · `pretty` | `pretty` / `json` / `jsonl`; tables for lists, labelled lines for objects; `quiet` keeps only failures on stderr |
 | `errors` · `exit-codes` | 14 closed error codes, one exit number each, so a script can branch on `$?` |
 | `keyring` | `KeyringStore` with the system, memory and deliberately-broken implementations |
+| `fieldsOf` · `projectFields` | validated field selection preserving list metadata and operation identifiers |
+| `createOutputBuffer` | bounded UTF-8 output held until successful completion and resource cleanup |
+| `createDeadline` | cooperative command cancellation with injected sleep and a parent abort signal |
 | `time` | monotonic and wall clocks, and the one sleep that both timeouts and backoff use |
 | `logger` | the four-method interface a host adapts Pino to — this package logs nothing itself |
 | `paths` | `env-paths` for config, state and cache, each overridable by environment variable |
@@ -60,6 +63,34 @@ does not call:
 import { providerWaitMs, statusToCode } from "@wirecat/cli-core/http"
 ```
 
+**Portable command control stays independent of provider and store lifetimes.**
+`fieldsOf("id,speaker.id")` parses up to 128 field paths; `projectFields(value, paths)` selects data
+from objects or list items while preserving the list envelope and `operationId` / `sendId`.
+`items.id` also works for bare objects and JSONL items. Unknown fields are omitted; parent selections
+win over their children. Unsafe prototype paths are refused, including when paths are passed directly.
+
+`createOutputBuffer({ maxOutputBytes })` retains raw output chunks until `flush(write)` or `discard()`.
+Its default limit is 4 MiB; zero disables the limit. It counts actual UTF-8 bytes, including delimiters
+the caller passes, and adds no newlines. Use a new buffer for each command and flush only after resource
+cleanup succeeds; discard on failure. A flush consumes the buffer even when its writer throws.
+The `bytes` property reports the cumulative accepted byte count. A writer failure can leave partial
+output; buffering only guarantees no output before flushing.
+
+Optional `{ fields, format: "json" | "jsonl" }` projects before counting bytes. With projection,
+each `data(text)` must contain a complete JSON value or complete JSONL lines; fragments fail before
+buffering. Without projection, arbitrary text chunks work. Hosts can instead project values before
+rendering and buffer the renderer's raw text. For core renderers, pass the line delimiter explicitly
+when adapting `Streams.data`: `data: (text) => buffer.data(text + "\n")`.
+
+`createDeadline({ timeoutMs, signal, sleep })` supplies a command signal and `race(body)`. An omitted
+timeout creates no timer; zero is an immediate deadline, and the maximum is 2147483647 milliseconds.
+Pass its signal to every cancellable operation and check it before writes. On timeout or parent
+cancellation, `race` waits for the body to settle before rejecting, so a caller can safely close
+resources afterwards. An operation ignoring its signal can delay completion; this helper never
+abandons it in the background. A body's more precise `outcome_unknown` error survives interruption.
+Call `dispose()` in `finally` to remove the timer and parent listener. There are no process signal
+handlers, retries, automatic resource cleanup or HTTP behavior in these helpers.
+
 **The command registry is `@wirecat/cli-core/commands`** — the whole command tree as data, like
 `rails routes`, for an agent to read instead of `--help` and for generated documentation. It walks
 the live [Commander](https://github.com/tj/commander.js) tree, so a command built in a loop from a

package/config/wirecat/LICENSE

@@ -0,0 +1,204 @@
+Copyright (c) 2026 Viacheslav Ptsarev
+
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/config/wirecat/biome.base.json

@@ -0,0 +1,56 @@
+{
+  "vcs": {
+    "enabled": true,
+    "clientKind": "git",
+    "useIgnoreFile": true
+  },
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space",
+    "indentWidth": 2,
+    "lineWidth": 120
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "asNeeded",
+      "trailingCommas": "all",
+      "arrowParentheses": "always"
+    }
+  },
+  "linter": {
+    "enabled": true,
+    "rules": {
+      "preset": "recommended",
+      "style": {
+        "useConst": "error",
+        "noNonNullAssertion": "error"
+      },
+      "correctness": {
+        "noUnusedImports": "error",
+        "noUnusedVariables": "error"
+      },
+      "suspicious": {
+        "noExplicitAny": "error",
+        "noConsole": {
+          "level": "error",
+          "options": {
+            "allow": ["error"]
+          }
+        }
+      }
+    }
+  },
+  "overrides": [
+    {
+      "includes": ["scripts/**"],
+      "linter": {
+        "rules": {
+          "suspicious": {
+            "noConsole": "off"
+          }
+        }
+      }
+    }
+  ]
+}

package/config/wirecat/check.mjs

@@ -0,0 +1,41 @@
+import { createHash } from "node:crypto"
+import { readFileSync } from "node:fs"
+import { dirname, resolve } from "node:path"
+import { fileURLToPath } from "node:url"
+
+const directory = dirname(fileURLToPath(import.meta.url))
+const root = resolve(directory, "../..")
+const manifest = JSON.parse(readFileSync(resolve(directory, "manifest.json"), "utf8"))
+const errors = []
+
+for (const [name, expected] of Object.entries(manifest.files)) {
+  const actual = createHash("sha256")
+    .update(readFileSync(resolve(directory, name)))
+    .digest("hex")
+  if (actual !== expected) errors.push(`Managed standard changed: ${name}`)
+}
+
+const packageJson = JSON.parse(readFileSync(resolve(root, "package.json"), "utf8"))
+for (const [name, expected] of Object.entries(manifest.devDependencies)) {
+  if (packageJson.devDependencies?.[name] !== expected) errors.push(`Expected ${name}@${expected}`)
+}
+if (packageJson.packageManager !== manifest.packageManager) errors.push("Package manager differs from shared standard")
+
+const biome = JSON.parse(readFileSync(resolve(root, "biome.json"), "utf8"))
+if (!biome.extends?.includes("./config/wirecat/biome.base.json"))
+  errors.push("Biome does not extend the shared standard")
+const spell = JSON.parse(readFileSync(resolve(root, "cspell.json"), "utf8"))
+if (!spell.import?.includes("./config/wirecat/cspell.json")) errors.push("CSpell does not import the shared standard")
+const markdown = JSON.parse(readFileSync(resolve(root, ".markdownlint-cli2.jsonc"), "utf8"))
+if (markdown.config?.extends !== "./config/wirecat/markdownlint.json")
+  errors.push("Markdown does not extend the shared standard")
+const hooks = readFileSync(resolve(root, "lefthook.yml"), "utf8")
+if (!/^\s*-\s*config\/wirecat\/lefthook\.yml\s*$/m.test(hooks))
+  errors.push("Git hooks do not extend the shared standard")
+
+if (errors.length) {
+  process.stderr.write(`${errors.join("\n")}\nUpdate standards centrally or put project overrides in root configs.\n`)
+  process.exitCode = 1
+} else {
+  process.stdout.write(`Shared standards match ${manifest.revision}.\n`)
+}

package/config/wirecat/cspell.json

@@ -0,0 +1,80 @@
+{
+  "version": "0.2",
+  "language": "en,en-GB,ru,es",
+  "ignoreRegExpList": [
+    "/^\\s*(```|~~~)[\\s\\S]*?^\\s*\\1/gm",
+    "/`[^`\\n]*`/g",
+    "/<!--[\\s\\S]*?-->/g",
+    "/\\]\\([^)]*\\)/g",
+    "/<[^>]+>/g",
+    "/^---[\\s\\S]*?^---/gm"
+  ],
+  "words": [
+    "armv",
+    "brazecli",
+    "bunx",
+    "claude",
+    "codegen",
+    "CodeWiki",
+    "DeepWiki",
+    "Excalidraw",
+    "frontmatter",
+    "Fumadocs",
+    "gitleaks",
+    "Hermes",
+    "JSONL",
+    "keyring",
+    "kwallet",
+    "leemour",
+    "libc",
+    "libsecret",
+    "Lucene",
+    "LUKS",
+    "Mermaid",
+    "mtcute",
+    "npmjs",
+    "ONNX",
+    "pioh",
+    "Repomix",
+    "riscv",
+    "Shiki",
+    "subcommand",
+    "tailnet",
+    "tailscale",
+    "tgcli",
+    "unpushed",
+    "userbot",
+    "volta",
+    "webhooks",
+    "WireCat",
+    "wirecat",
+    "автодополнение",
+    "бана",
+    "вебхук",
+    "вебхуки",
+    "капчу",
+    "контрибьюторы",
+    "листателя",
+    "Минцифры",
+    "опкод",
+    "отсканируете",
+    "переголосовать",
+    "пулл",
+    "реквесты",
+    "рендерер",
+    "спиннера",
+    "схлопнет",
+    "схлопывает",
+    "токенам",
+    "токене",
+    "токеном",
+    "токену",
+    "хэша",
+    "хэшем"
+  ],
+  "import": [
+    "@cspell/dict-en-gb/cspell-ext.json",
+    "@cspell/dict-ru_ru/cspell-ext.json",
+    "@cspell/dict-es-es/cspell-ext.json"
+  ]
+}

package/config/wirecat/lefthook.yml

@@ -0,0 +1,34 @@
+# Git hooks. Installed by the `prepare` npm script, which pnpm runs on every install — necessary
+# because pnpm blocks dependencies' build scripts by default, so lefthook's own postinstall never
+# fires and the hooks would otherwise silently never land.
+#
+# Install by hand:      pnpm exec lefthook install
+# Skip for one commit:  LEFTHOOK=0 git commit …
+
+pre-commit:
+  parallel: true
+  commands:
+    biome:
+      glob: "*.{ts,tsx,js,mjs,cjs,json,jsonc}"
+      # Staged files only. The whole-repo run is the CI gate; running it per-commit is how people
+      # end up reaching for --no-verify, which is worse than no hook.
+      run: pnpm exec biome check --no-errors-on-unmatched --files-ignore-unknown=true {staged_files}
+
+    gitleaks:
+      # Staged content only, and it warns rather than blocks when gitleaks is not installed: a
+      # fresh clone must still be able to commit. CI is the gate that cannot be skipped.
+      run: |
+        if command -v gitleaks >/dev/null 2>&1; then
+          gitleaks git --staged --no-banner --redact .
+        else
+          echo "gitleaks is not installed — staged changes were NOT scanned for secrets."
+          echo "  install: https://github.com/gitleaks/gitleaks#installing  (CI scans regardless)"
+        fi
+
+pre-push:
+  parallel: true
+  commands:
+    typecheck:
+      # A messaging CLI's parity check builds into the same dist/ as typecheck, so it runs here, after
+      # it, rather than as a command of its own beside it. A project without the script skips it.
+      run: pnpm -s run --if-present typecheck && pnpm -s run --if-present parity:check

package/config/wirecat/manifest.json

@@ -0,0 +1,23 @@
+{
+  "source": "https://github.com/WireCatLabs/community",
+  "revision": "bfd56be79ac1c39c3692bf83eb7ea8bc046682f0",
+  "files": {
+    "biome.base.json": "83a43910f2530e21d720e3ad4c3fc7fcb16ba36253c6dbc720b3c68a4dd80893",
+    "cspell.json": "8241122ed4d461976a838099b265ef8f2689a066608257b6fdc250d9b49b58aa",
+    "lefthook.yml": "6a19c2473a570d29e33abf90470af68af9d990aac94971f4cb6d2698788c61b4",
+    "markdownlint.json": "5ed7d6980054c539f3f3c0e47a090f1a725b15be2c486a769a836bc6cd48ad2d",
+    "rumdl.toml": "048b929176f13234324f5825d1e811397f1491b9cb6684a1953e268e2c2ed863",
+    "check.mjs": "34b266411eaab7707030915f645308e86784b1574b21fa44ca974861a90c9ce1"
+  },
+  "packageManager": "pnpm@11.20.0",
+  "node": ">=22",
+  "devDependencies": {
+    "@biomejs/biome": "2.5.15",
+    "@cspell/dict-en-gb": "5.0.34",
+    "@cspell/dict-es-es": "3.0.9",
+    "@cspell/dict-ru_ru": "2.3.3",
+    "cspell": "10.3.6",
+    "lefthook": "2.1.16",
+    "markdownlint-cli2": "0.23.3"
+  }
+}

package/config/wirecat/markdownlint.json

@@ -0,0 +1,10 @@
+{
+  "default": false,
+  "MD001": false,
+  "MD010": true,
+  "MD012": {
+    "maximum": 2
+  },
+  "MD040": true,
+  "MD042": true
+}

package/config/wirecat/rumdl.toml

@@ -0,0 +1,9 @@
+# MD013 (line length): prose is wrapped by hand at 100–120 and tables cannot wrap.
+# MD041 (first line a heading): READMEs open with the logo; docs-check --pages checks the pages.
+# MD057 (relative links): docs-check follows every link and anchor already.
+[global]
+disable = ["MD013", "MD041", "MD057"]
+exclude = ["docs/commands.md", "node_modules", "dist", "docs_ai"]
+
+[MD033]
+allowed-elements = ["p", "img", "a", "br", "details", "summary", "sup", "sub", "kbd"]

package/dist/deadline.d.ts

@@ -0,0 +1,14 @@
+import { type SleepLike } from "./time.js";
+export interface DeadlineOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+    sleep?: SleepLike;
+}
+export interface Deadline {
+    readonly signal: AbortSignal;
+    /** On abort, waits for the body to settle before throwing; the body must cooperate to finish promptly. */
+    race<T>(body: (signal: AbortSignal) => Promise<T>): Promise<T>;
+    dispose(): void;
+}
+export declare const createDeadline: ({ timeoutMs, signal, sleep }?: DeadlineOptions) => Deadline;
+//# sourceMappingURL=deadline.d.ts.map

package/dist/deadline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,WAAW,CAAA;AAErD,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB;AACD,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,0GAA0G;IAC1G,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAC9D,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,eAAO,MAAM,cAAc,kCAA8C,eAAe,KAAQ,QA6E/F,CAAA"}

package/dist/deadline.js

@@ -0,0 +1,85 @@
+import { CliError } from "./errors.js";
+import { realSleep } from "./time.js";
+export const createDeadline = ({ timeoutMs, signal, sleep = realSleep } = {}) => {
+    if (timeoutMs !== undefined && (!Number.isSafeInteger(timeoutMs) || timeoutMs < 0 || timeoutMs > 2147483647))
+        throw new CliError("validation_error", "timeoutMs must be an integer from zero through 2147483647");
+    const controller = new AbortController();
+    const timer = new AbortController();
+    let disposed = false;
+    const abort = (reason) => {
+        if (controller.signal.aborted)
+            return;
+        controller.abort(reason);
+        timer.abort();
+        signal?.removeEventListener("abort", onAbort);
+    };
+    const onAbort = () => abort(signal?.reason instanceof CliError ? signal.reason : new CliError("cancelled", "command cancelled"));
+    if (signal?.aborted)
+        onAbort();
+    else
+        signal?.addEventListener("abort", onAbort, { once: true });
+    if (timeoutMs !== undefined && !controller.signal.aborted) {
+        let waiting;
+        try {
+            waiting = sleep(timeoutMs, timer.signal, "timeout");
+        }
+        catch {
+            waiting = Promise.reject(new Error("deadline timer failed"));
+        }
+        void waiting.then(() => {
+            if (!disposed && !timer.signal.aborted)
+                abort(new CliError("timeout", "the command did not finish before its deadline", {
+                    reason: "command_timeout",
+                    timeoutMs,
+                    retryable: false,
+                }));
+        }, () => {
+            if (!disposed && !timer.signal.aborted)
+                abort(new CliError("configuration_error", "command deadline timer failed"));
+        });
+    }
+    return {
+        signal: controller.signal,
+        async race(body) {
+            if (disposed)
+                throw new CliError("validation_error", "deadline is already disposed");
+            if (controller.signal.aborted)
+                throw controller.signal.reason;
+            let interrupt = () => { };
+            const interrupted = new Promise((_, reject) => {
+                interrupt = () => reject(controller.signal.reason);
+                controller.signal.addEventListener("abort", interrupt, { once: true });
+            });
+            const running = Promise.resolve().then(() => {
+                if (controller.signal.aborted)
+                    throw controller.signal.reason;
+                return body(controller.signal);
+            });
+            try {
+                return await Promise.race([running, interrupted]);
+            }
+            catch (error) {
+                if (controller.signal.aborted) {
+                    // A caller may close resources only after its operation can no longer use them.
+                    let settled;
+                    await running.catch((reason) => {
+                        settled = reason;
+                    });
+                    if (settled instanceof CliError && settled.code === "outcome_unknown")
+                        throw settled;
+                    throw controller.signal.reason;
+                }
+                throw error;
+            }
+            finally {
+                controller.signal.removeEventListener("abort", interrupt);
+            }
+        },
+        dispose() {
+            disposed = true;
+            timer.abort();
+            signal?.removeEventListener("abort", onAbort);
+        },
+    };
+};
+//# sourceMappingURL=deadline.js.map

package/dist/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../src/deadline.ts"],"names":[],"mappings":"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"}

package/dist/executable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,YAClB,MAAM,OACV,MAAM,CAAC,UAAU,aACZ,MAAM,CAAC,QAAQ,WACjB,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,KAChC,MAkBF,CAAA;AAED,eAAO,MAAM,qBAAqB,QAC3B,MAAM,CAAC,UAAU,aACZ,MAAM,CAAC,QAAQ,KACxB,MAAM,CAAC,UAeT,CAAA"}
+{"version":3,"file":"executable.d.ts","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,YAClB,MAAM,OACV,MAAM,CAAC,UAAU,aACZ,MAAM,CAAC,QAAQ,WACjB,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,KAChC,MAcF,CAAA;AAED,eAAO,MAAM,qBAAqB,QAC3B,MAAM,CAAC,UAAU,aACZ,MAAM,CAAC,QAAQ,KACxB,MAAM,CAAC,UAcT,CAAA"}

package/dist/executable.js

@@ -5,37 +5,32 @@ export const executableOnPath = (command, env, platform = process.platform, exis
     if (platform !== "win32" || win32.isAbsolute(command))
         return command;
     if (/[\\/]/.test(command))
-        throw new Error("use an absolute path for a Windows command");
+        return command;
     const extensions = win32.extname(command)
         ? [""]
-        : (variable(env, "PATHEXT") ?? ".EXE;.COM;.CMD;.BAT")
-            .split(";")
-            .filter((ext) => /^\.(?:exe|com|cmd|bat)$/i.test(ext));
-    // Relative/empty PATH entries would reintroduce the current-folder executable search.
+        : (variable(env, "PATHEXT") ?? ".EXE;.COM;.CMD;.BAT").split(";").filter((ext) => /^\.[a-z0-9]+$/i.test(ext));
     for (const entry of (variable(env, "PATH") ?? "").split(";")) {
         const directory = entry.replace(/^"(.*)"$/, "$1");
-        if (!win32.isAbsolute(directory))
-            continue;
         for (const extension of extensions) {
             const candidate = win32.join(directory, command + extension);
             if (exists(candidate))
                 return candidate;
         }
     }
-    throw new Error(`could not find ${command} on an absolute Windows PATH entry`);
+    return command;
 };
 export const executableEnvironment = (env, platform = process.platform) => {
     if (platform !== "win32")
         return env;
     const configured = variable(env, "COMSPEC");
     const system = variable(env, "SYSTEMROOT");
-    const shell = configured && win32.isAbsolute(configured)
+    const shell = configured
         ? configured
         : system && win32.isAbsolute(system)
             ? win32.join(system, "System32", "cmd.exe")
             : undefined;
     if (!shell)
-        throw new Error("Windows needs an absolute ComSpec or SystemRoot to run command shims");
+        return env;
     const result = { ...env };
     for (const key of Object.keys(result))
         if (key.toUpperCase() === "COMSPEC")

package/dist/executable.js.map

@@ -1 +1 @@
-{"version":3,"file":"executable.js","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executable.js","sourceRoot":"","sources":["../src/executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAEjC,MAAM,QAAQ,GAAG,CAAC,GAAsB,EAAE,IAAY,EAAE,EAAE,CACxD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAEtE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,OAAe,EACf,GAAsB,EACtB,QAAQ,GAAoB,OAAO,CAAC,QAAQ,EAC5C,MAAM,GAA8B,UAAU,EACtC,EAAE;IACV,IAAI,QAAQ,KAAK,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACrE,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAA;IACzC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACvC,CAAC,CAAC,CAAC,EAAE,CAAC;QACN,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IAC9G,KAAK,MAAM,KAAK,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACjD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,SAAS,CAAC,CAAA;YAC5D,IAAI,MAAM,CAAC,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAA;QACzC,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,GAAsB,EACtB,QAAQ,GAAoB,OAAO,CAAC,QAAQ,EACzB,EAAE;IACrB,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,GAAG,CAAA;IACpC,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;IAC3C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;IAC1C,MAAM,KAAK,GAAG,UAAU;QACtB,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC;YAC3C,CAAC,CAAC,SAAS,CAAA;IACf,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAA;IACtB,MAAM,MAAM,GAAG,EAAE,GAAG,GAAG,EAAE,CAAA;IACzB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,IAAI,GAAG,CAAC,WAAW,EAAE,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAA;IAC9F,MAAM,CAAC,OAAO,GAAG,KAAK,CAAA;IACtB,OAAO,MAAM,CAAA;AACf,CAAC,CAAA"}

package/dist/index.d.ts

@@ -1,14 +1,17 @@
 export { loadConfigFile, saveConfigFile, writeSecurely } from "./config.js";
 export type { CredentialSource, CredentialStorage, CredentialsOptions, StoredCredential } from "./credentials.js";
 export { CREDENTIAL_STORAGE, Credentials, keyringService } from "./credentials.js";
+export { createDeadline, type Deadline, type DeadlineOptions } from "./deadline.js";
 export { CliError, type CliErrorDetails, type ErrorCode, errorCodes, isCliError } from "./errors.js";
 export { EXIT_CODES, exitCodeFor, GENERIC_FAILURE } from "./exit-codes.js";
 export { brokenKeyring, type KeyringStore, memoryKeyring, systemKeyring } from "./keyring.js";
 export { type Logger, noopLogger } from "./logger.js";
 export { createFileLogger, type FileLogger, type FileLoggerOptions, REDACTED_FIELDS } from "./logging.js";
+export { createOutputBuffer, type OutputBuffer, type OutputBufferOptions } from "./output-buffer.js";
 export { configFilePath, type Paths, type PathsOptions, pathsAreOverridden, resolvePaths } from "./paths.js";
 export { indent, type PrettyOptions, renderPretty } from "./pretty.js";
 export { createRenderer, RENDER_FORMATS, type Renderer, type RendererOptions, type RenderFormat, } from "./renderer.js";
+export { fieldsOf, projectFields } from "./result-fields.js";
 export { backoffMs, DEFAULT_RETRY, isTransportFailure, type RetryConfig } from "./retry.js";
 export { singleLine, visibleControls } from "./sanitize.js";
 export { captureStreams, processStreams, type Streams } from "./streams.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,SAAS,EACT,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3E,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACjH,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AACnF,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EAAE,KAAK,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EACV,KAAK,cAAc,EACnB,SAAS,EACT,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,SAAS,GACV,MAAM,WAAW,CAAA"}

package/dist/index.js

@@ -1,13 +1,16 @@
 export { loadConfigFile, saveConfigFile, writeSecurely } from "./config.js";
 export { CREDENTIAL_STORAGE, Credentials, keyringService } from "./credentials.js";
+export { createDeadline } from "./deadline.js";
 export { CliError, errorCodes, isCliError } from "./errors.js";
 export { EXIT_CODES, exitCodeFor, GENERIC_FAILURE } from "./exit-codes.js";
 export { brokenKeyring, memoryKeyring, systemKeyring } from "./keyring.js";
 export { noopLogger } from "./logger.js";
 export { createFileLogger, REDACTED_FIELDS } from "./logging.js";
+export { createOutputBuffer } from "./output-buffer.js";
 export { configFilePath, pathsAreOverridden, resolvePaths } from "./paths.js";
 export { indent, renderPretty } from "./pretty.js";
 export { createRenderer, RENDER_FORMATS, } from "./renderer.js";
+export { fieldsOf, projectFields } from "./result-fields.js";
 export { backoffMs, DEFAULT_RETRY, isTransportFailure } from "./retry.js";
 export { singleLine, visibleControls } from "./sanitize.js";
 export { captureStreams, processStreams } from "./streams.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,QAAQ,EAAwC,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAqB,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EAAe,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAA2C,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,cAAc,EAAiC,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAsB,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,GAIf,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EAEV,SAAS,EACT,SAAS,EAIT,SAAS,GACV,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3E,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAClF,OAAO,EAAE,cAAc,EAAuC,MAAM,eAAe,CAAA;AACnF,OAAO,EAAE,QAAQ,EAAwC,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACpG,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC1E,OAAO,EAAE,aAAa,EAAqB,aAAa,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAC7F,OAAO,EAAe,UAAU,EAAE,MAAM,aAAa,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAA2C,eAAe,EAAE,MAAM,cAAc,CAAA;AACzG,OAAO,EAAE,kBAAkB,EAA+C,MAAM,oBAAoB,CAAA;AACpG,OAAO,EAAE,cAAc,EAAiC,kBAAkB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAC5G,OAAO,EAAE,MAAM,EAAsB,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,OAAO,EACL,cAAc,EACd,cAAc,GAIf,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,kBAAkB,EAAoB,MAAM,YAAY,CAAA;AAC3F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAgB,MAAM,cAAc,CAAA;AAC3E,OAAO,EACL,UAAU,EAEV,SAAS,EACT,SAAS,EAIT,SAAS,GACV,MAAM,WAAW,CAAA"}

package/dist/output-buffer.d.ts

@@ -0,0 +1,16 @@
+import type { RenderFormat } from "./renderer.js";
+export interface OutputBufferOptions {
+    maxOutputBytes?: number;
+    fields?: string;
+    format?: RenderFormat;
+}
+export interface OutputBuffer {
+    readonly bytes: number;
+    /** Raw output chunks, including any delimiters. Projection requires complete JSON values/JSONL lines. */
+    data(text: string): void;
+    /** Consumes the buffer once; the writer receives the exact buffered text, without extra newlines. */
+    flush(write: (text: string) => void): void;
+    discard(): void;
+}
+export declare const createOutputBuffer: ({ maxOutputBytes, fields, format, }?: OutputBufferOptions) => OutputBuffer;
+//# sourceMappingURL=output-buffer.d.ts.map

package/dist/output-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-buffer.d.ts","sourceRoot":"","sources":["../src/output-buffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAGjD,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AACD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yGAAyG;IACzG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,qGAAqG;IACrG,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAA;IAC1C,OAAO,IAAI,IAAI,CAAA;CAChB;AAED,eAAO,MAAM,kBAAkB,yCAI5B,mBAAmB,KAAQ,YA6D7B,CAAA"}

package/dist/output-buffer.js

@@ -0,0 +1,69 @@
+import { CliError } from "./errors.js";
+import { fieldsOf, projectFields } from "./result-fields.js";
+export const createOutputBuffer = ({ maxOutputBytes = 4 * 1024 * 1024, fields, format, } = {}) => {
+    if (!Number.isSafeInteger(maxOutputBytes) || maxOutputBytes < 0)
+        throw new CliError("validation_error", "maxOutputBytes must be a nonnegative whole byte count");
+    const paths = fields === undefined ? undefined : fieldsOf(fields);
+    if (paths && format !== "json" && format !== "jsonl")
+        throw new CliError("validation_error", "field projection requires an explicit JSON or JSONL format");
+    let chunks = [];
+    let bytes = 0;
+    let finished = false;
+    const requireActive = () => {
+        if (finished)
+            throw new CliError("validation_error", "output buffer is already finished");
+    };
+    return {
+        get bytes() {
+            return bytes;
+        },
+        data(text) {
+            requireActive();
+            let result = text;
+            if (paths) {
+                const project = (value) => JSON.stringify(projectFields(JSON.parse(value), paths));
+                try {
+                    result =
+                        format === "jsonl"
+                            ? text
+                                .split("\n")
+                                .map((line) => (line.trim() ? project(line) : line))
+                                .join("\n")
+                            : project(text) + (text.endsWith("\n") ? "\n" : "");
+                }
+                catch (error) {
+                    if (error instanceof CliError)
+                        throw error;
+                    throw new CliError("invalid_response", "field projection requires complete JSON values or JSONL lines", {
+                        reason: "projection_unavailable",
+                        retryable: false,
+                    });
+                }
+            }
+            const size = Buffer.byteLength(result);
+            if (!Number.isSafeInteger(bytes + size) || (maxOutputBytes !== 0 && bytes + size > maxOutputBytes))
+                throw new CliError("invalid_response", "output exceeds the configured byte limit", {
+                    reason: "output_limit",
+                    maxBytes: maxOutputBytes,
+                    bufferedBytes: bytes,
+                    retryable: false,
+                    partialOutput: false,
+                });
+            bytes += size;
+            chunks.push(result);
+        },
+        flush(write) {
+            requireActive();
+            finished = true;
+            const output = chunks;
+            chunks = [];
+            for (const text of output)
+                write(text);
+        },
+        discard() {
+            finished = true;
+            chunks = [];
+        },
+    };
+};
+//# sourceMappingURL=output-buffer.js.map

package/dist/output-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-buffer.js","sourceRoot":"","sources":["../src/output-buffer.ts"],"names":[],"mappings":"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"}

package/dist/result-fields.d.ts

@@ -0,0 +1,4 @@
+export declare const fieldsOf: (value: string) => string[];
+/** Projects item data while retaining the list envelope and operation identifiers. */
+export declare const projectFields: (value: unknown, fields: readonly string[]) => unknown;
+//# sourceMappingURL=result-fields.d.ts.map

package/dist/result-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-fields.d.ts","sourceRoot":"","sources":["../src/result-fields.ts"],"names":[],"mappings":"AAiBA,eAAO,MAAM,QAAQ,UAAW,MAAM,KAAG,MAAM,EAI9C,CAAA;AA6BD,sFAAsF;AACtF,eAAO,MAAM,aAAa,UAAW,OAAO,UAAU,SAAS,MAAM,EAAE,KAAG,OAMzE,CAAA"}

package/dist/result-fields.js

@@ -0,0 +1,56 @@
+import { CliError } from "./errors.js";
+const forbidden = new Set(["__proto__", "prototype", "constructor"]);
+const validate = (paths) => {
+    if (paths.length === 0 ||
+        paths.length > 128 ||
+        paths.some((path) => path.length > 256 ||
+            !/^[A-Za-z][A-Za-z0-9_]*(?:\.[A-Za-z][A-Za-z0-9_]*)*$/.test(path) ||
+            path.split(".").some((part) => forbidden.has(part))))
+        throw new CliError("validation_error", "--fields takes comma-separated field paths, for example id,locator,text");
+};
+export const fieldsOf = (value) => {
+    const paths = value.split(",").map((one) => one.trim());
+    validate(paths);
+    return [...new Set(paths)];
+};
+const object = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const select = (value, paths, item = false) => {
+    if (!object(value))
+        return value;
+    const fields = item ? paths.map((path) => (path.startsWith("items.") ? path.slice(6) : path)) : paths;
+    const result = {};
+    for (const path of fields.filter((one) => !fields.some((parent) => parent !== one && one.startsWith(`${parent}.`)))) {
+        const parts = path.split(".");
+        let found = value;
+        for (const part of parts) {
+            if (!object(found) || !Object.hasOwn(found, part)) {
+                found = undefined;
+                break;
+            }
+            found = found[part];
+        }
+        if (found === undefined)
+            continue;
+        let target = result;
+        for (const part of parts.slice(0, -1)) {
+            if (!object(target[part]))
+                target[part] = {};
+            target = target[part];
+        }
+        target[parts.at(-1)] = found;
+    }
+    for (const name of ["operationId", "sendId"])
+        if (Object.hasOwn(value, name))
+            result[name] = value[name];
+    return result;
+};
+/** Projects item data while retaining the list envelope and operation identifiers. */
+export const projectFields = (value, fields) => {
+    validate(fields);
+    if (Array.isArray(value))
+        return value.map((item) => select(item, fields, true));
+    if (object(value) && Array.isArray(value.items))
+        return { ...value, items: value.items.map((item) => select(item, fields, true)) };
+    return select(value, fields, object(value) && !Object.hasOwn(value, "items"));
+};
+//# sourceMappingURL=result-fields.js.map

package/dist/result-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-fields.js","sourceRoot":"","sources":["../src/result-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAA;AACpE,MAAM,QAAQ,GAAG,CAAC,KAAwB,EAAQ,EAAE;IAClD,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,MAAM,GAAG,GAAG;QAClB,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,MAAM,GAAG,GAAG;YACjB,CAAC,qDAAqD,CAAC,IAAI,CAAC,IAAI,CAAC;YACjE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CACtD;QAED,MAAM,IAAI,QAAQ,CAAC,kBAAkB,EAAE,yEAAyE,CAAC,CAAA;AACrH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAY,EAAE;IAClD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAA;IACvD,QAAQ,CAAC,KAAK,CAAC,CAAA;IACf,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;AAC5B,CAAC,CAAA;AACD,MAAM,MAAM,GAAG,CAAC,KAAc,EAAoC,EAAE,CAClE,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;AACtE,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,KAAwB,EAAE,IAAI,GAAG,KAAK,EAAW,EAAE;IACjF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAChC,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACrG,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACpH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC7B,IAAI,KAAK,GAAY,KAAK,CAAA;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;gBAClD,KAAK,GAAG,SAAS,CAAA;gBACjB,MAAK;YACP,CAAC;YACD,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC;QACD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAQ;QACjC,IAAI,MAAM,GAAG,MAAM,CAAA;QACnB,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;YAC5C,MAAM,GAAG,MAAM,CAAC,IAAI,CAA4B,CAAA;QAClD,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAW,CAAC,GAAG,KAAK,CAAA;IACxC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,QAAQ,CAAC;QAAE,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAA;IACxG,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,sFAAsF;AACtF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,MAAyB,EAAW,EAAE;IAClF,QAAQ,CAAC,MAAM,CAAC,CAAA;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAA;IAChF,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;QAC7C,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,CAAA;IACnF,OAAO,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAA;AAC/E,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "description": "The parts every command line tool needs: output modes, terminal rendering, error model, exit codes, credentials, clocks",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",
@@ -87,7 +87,10 @@
     "smoke:bun": "bun run scripts/smoke.ts",
     "prepare": "lefthook install || true",
     "secrets:scan": "gitleaks git --no-banner --redact .",
-    "prepublishOnly": "pnpm build"
+    "prepublishOnly": "pnpm build",
+    "standards:check": "node config/wirecat/check.mjs",
+    "docs:lint": "markdownlint-cli2",
+    "docs:spell": "cspell lint --config cspell.json --no-progress README.md"
   },
   "dependencies": {
     "cli-table3": "^0.6.5",
@@ -101,14 +104,19 @@
     "@napi-rs/keyring": "2.1.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.14",
+    "@biomejs/biome": "2.5.15",
     "@types/cross-spawn": "6.0.6",
     "@types/node": "^22.20.4",
     "@vitest/coverage-v8": "^5.0.2",
     "commander": "^15.0.0",
-    "lefthook": "^2.1.8",
+    "lefthook": "2.1.16",
     "typescript": "^7.0.2",
-    "vitest": "^5.0.2"
+    "vitest": "^5.0.2",
+    "@cspell/dict-en-gb": "5.0.34",
+    "@cspell/dict-es-es": "3.0.9",
+    "@cspell/dict-ru_ru": "2.3.3",
+    "cspell": "10.3.6",
+    "markdownlint-cli2": "0.23.3"
   },
   "publishConfig": {
     "access": "public"