@guiho/runx 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -15,6 +15,18 @@ owner: runx
 
 # Changelog
 
+## 0.4.1 - 2026-07-18
+
+### Fixed
+
+- Fixed `runx upgrade` so its required `--version`, `--arch`, `--variant`,
+  `--dry-run`, and `--format` flags route to the upgrade action instead of
+  being hidden by the command group or intercepted as the root version flag.
+- Fixed no-argument startup so a decoded cached update notice is printed before
+  the exact RunX banner without waiting for network work.
+- Fixed `runx agent prompt list --names` text output so it prints raw prompt
+  names, one per line, while JSON mode remains structured.
+
 ## 0.4.0 - 2026-07-18
 
 ### Added

package/docs/reviews/implementation/implementation.xdocs.md

@@ -7,12 +7,12 @@ files:
   citty-cli-migration-review.md: Reviews the implemented Citty command tree, compatibility adapter, tests, documentation, packaging, and release readiness.
   interactive-init-manifest-review.md: Reviews the implemented RunX initializer, strict manifest contract, tests, documentation, and delivery readiness.
   windows-self-upgrade-review.md: Reviews synchronous Windows replacement, rollback, cleanup, tests, CI coverage, and release readiness.
-  rfc-0034-cli-compliance-migration-review.md: Accepts the complete RFC 0034 runtime, CLI, agent, installer, packaging, documentation, and release migration.
+  rfc-0034-cli-compliance-migration-review.md: Accepts the RFC 0034 migration after independent upgrade-routing, cached-notice, prompt-output, asset, and release-readiness corrections.
 documents:
   citty-cli-migration-review.md: Accepted implementation review for the full Citty CLI migration.
   interactive-init-manifest-review.md: Accepted implementation review for the RunX interactive init manifest feature.
   windows-self-upgrade-review.md: Accepted implementation review for the Windows native self-upgrade fix.
-  rfc-0034-cli-compliance-migration-review.md: Accepted implementation review for RX-01 through RX-16.
+  rfc-0034-cli-compliance-migration-review.md: Accepted implementation and independent correction review for RX-01 through RX-16.
 tags:
   - reviews
   - implementation

package/docs/reviews/implementation/rfc-0034-cli-compliance-migration-review.md

@@ -31,6 +31,15 @@ JSON output, directory existence checking initially rejected valid command
 working directories, and legacy Windows cleanup tests waited indefinitely.
 Focused tests now cover each corrected behavior.
 
+An independent post-release audit then found and corrected three additional
+contract defects: the public upgrade flags were unreachable through the Citty
+group and root `--version` intercepted the nested version selector;
+no-argument startup skipped the decoded cached update notice; and text-mode
+prompt names rendered as a JSON array. The corrected CLI routes all upgrade
+flags through `runx upgrade`, prints a cached notice before the banner without
+network work, and prints raw names one per line. Live-routing regression tests
+cover each path.
+
 ## Acceptance Criteria Check
 
 - Mandatory Bun, TypeScript, Citty, and TypeBox stack: accepted.
@@ -48,9 +57,10 @@ Focused tests now cover each corrected behavior.
 
 ## Residual Risk
 
-Publishing and GitHub Release creation are intentionally outside this delivery.
-The workflows are validated locally and will execute only on a protected
-Mirror-managed version tag.
+Package publication and GitHub Release creation remain tag-triggered workflow
+effects rather than direct local actions. The patch release validates the
+workflow inputs and exact asset set locally; the protected production workflow
+still owns publication.
 
 ## References
 

package/docs/todo/rfc-0034-cli-compliance-migration-implementation.md

@@ -49,7 +49,26 @@ npm bootstrap, and the exact fourteen release assets.
 The original unbounded suite hung in legacy process-oriented tests. The
 individual CLI baseline passed 10/10, proving the CLI was not persistently
 stuck. The obsolete tests were replaced or bounded; the final complete suite
-runs 38 tests and exits normally in about 28 seconds.
+runs 40 tests and exits normally in about 30 seconds.
+
+## Independent Audit Corrections
+
+The final independent RFC audit found three public-surface defects that the
+first validation suite did not exercise:
+
+- the `upgrade` group hid its apply flags and allowed root `--version` handling
+  to intercept `runx upgrade --version <version>`;
+- no-argument startup skipped the cached update notice;
+- text-mode `agent prompt list --names` rendered a JSON array instead of raw
+  names.
+
+The correction keeps `upgrade check` and `upgrade list`, makes the public
+`upgrade` command own and execute all RFC flags directly, gates root version
+handling to a one-token root invocation, reads the local cache before the
+no-argument banner, and emits one raw prompt name per line. Focused tests invoke
+the real Citty routing and output paths. The ignored `bin/runx.exe` left by a
+single-binary build was removed before exact-asset verification; the strict
+fourteen-name comparison remains unchanged.
 
 ## References
 

package/docs/todo/rfc-0034-cli-compliance-migration.md

@@ -69,7 +69,8 @@ RFC-named binaries plus `guiho-s-runx` and `guiho-i-runx`.
 ## Acceptance Signals
 
 - No prohibited Node built-ins exist in core CLI source.
-- No arguments prints exactly `Hello Windows - runx v<version>`.
+- No arguments prints a decoded cached update notice first when one is
+  available, followed by exactly `Hello Windows - runx v<version>`.
 - `runx.yaml` resolves only by `--config`, effective cwd, then the standardized
   global path, and prints its absolute loaded path.
 - TypeBox decodes configuration, cache, remote releases, structured flags, and

package/docs/todo/todo.xdocs.md

@@ -6,11 +6,11 @@ children: []
 files:
   protect-branches-and-tag-creation.md: Records the verified active GitHub branch and release-tag rulesets for RunX.
   rfc-0034-cli-compliance-migration.md: Defines the required breaking migration outcome, scope, constraints, and completion signals for full RFC 0034 compliance.
-  rfc-0034-cli-compliance-migration-implementation.md: Records the delivered RX units, implementation map, and test-hang diagnosis.
+  rfc-0034-cli-compliance-migration-implementation.md: Records the delivered RX units, implementation map, test-hang diagnosis, and independent audit corrections.
 documents:
   protect-branches-and-tag-creation.md: Completed task specification with active RunX ruleset IDs, protected patterns, and verification evidence.
   rfc-0034-cli-compliance-migration.md: Task specification linked from TODO task 1 for the full RunX CLI contract migration.
-  rfc-0034-cli-compliance-migration-implementation.md: Completed implementation and validation handoff for TODO task 1.
+  rfc-0034-cli-compliance-migration-implementation.md: Completed implementation, independent correction, and validation handoff for TODO task 1.
 tags:
   - todo
 keywords:

package/docs/validation/rfc-0034-cli-compliance-migration.md

@@ -10,7 +10,7 @@ tags:
   - cli
 keywords:
   - RFC 0034
-  - 38 tests
+  - 40 tests
   - 14 assets
   - RunX
 owner: runx-validation
@@ -20,14 +20,16 @@ owner: runx-validation
 
 ## Summary
 
-All local RFC completion gates passed. No validation blocker remains.
+All local RFC completion gates passed after independent audit corrections for
+upgrade routing, no-argument cached notices, and names-only prompt output. No
+validation blocker remains.
 
 ## Commands Run
 
 | Command or check | Result |
 | --- | --- |
 | `bun run typecheck` | Passed |
-| `bun test --timeout 30000` | Passed: 38 tests, 262 assertions |
+| `bun test --timeout 30000` | Passed: 40 tests, 272 assertions |
 | `bun run build` | Passed |
 | `bun run binary` | Passed |
 | `bun run binaries` | Passed: twelve native targets |
@@ -36,10 +38,24 @@ All local RFC completion gates passed. No validation blocker remains.
 | packed npm bootstrap local-server smoke | Passed with Node and Bun removed from PATH |
 | prohibited core Node-import scan | Passed: zero matches |
 | CLI banner/help/config/agent/output/exit smoke tests | Passed in CLI suite |
+| live `upgrade --help`, prompt names, source banner, and compiled version smokes | Passed |
 | PowerShell and POSIX installer contract tests | Passed |
 | `xdocs doctor --warnings-as-errors` | Passed: zero errors and zero warnings |
 | `git diff --check` | Passed |
 
+## Independent Audit Regression Evidence
+
+- `runx upgrade` now exposes and executes `--version`, `--arch`, `--variant`,
+  `--dry-run`, and `--format` without root-version interception while retaining
+  `upgrade check` and `upgrade list`.
+- A valid `newVersionAvailable: true` cache produces the required notice before
+  the no-argument banner with the update worker disabled.
+- `agent prompt list --names` prints `guiho-i-runx` as a raw text line; JSON
+  mode still returns a parseable names array.
+- The stale ignored `bin/runx.exe` created by the single-target build was
+  removed before matrix verification. The verifier itself remains strict and
+  observed only the twelve RFC binaries plus the two named agent assets.
+
 ## Exact Release Asset Evidence
 
 The verifier observed twelve `runx-*` assets using Linux, Darwin, and Windows
@@ -57,9 +73,9 @@ These are release mutations rather than local validation requirements.
 
 ## Readiness
 
-Ready for the authorized Mirror minor version application, one-file commits,
+Ready for the authorized Mirror patch application to `0.4.1`, one-file commits,
 main push, and Mirror-managed tag/ref push. Package publication and GitHub
-Release creation remain intentionally unperformed.
+Release creation remain intentionally unperformed as direct local actions.
 
 ## References
 

package/docs/validation/validation.xdocs.md

@@ -9,7 +9,7 @@ files:
   interactive-init-manifest.md: Records validation evidence for the interactive initializer and strict manifest contract.
   windows-self-upgrade.md: Records Windows replacement, rollback, cleanup, native build, CI, and XDocs validation evidence.
   upgrade-reliability.md: Tracks the superseded first pass and required revalidation after independent upgrade reliability review corrections.
-  rfc-0034-cli-compliance-migration.md: Records passing RFC tests, builds, bootstrap, installer, import, and fourteen-asset evidence.
+  rfc-0034-cli-compliance-migration.md: Records passing RFC tests, live upgrade/startup/prompt regressions, builds, bootstrap, installers, import scan, and fourteen-asset evidence.
 documents:
   alpha-implementation-summary.md: Validation summary for the first RunX implementation.
   citty-cli-migration.md: Validation evidence for TypeScript, tests, native assets, npm packaging, CLI behavior, and XDocs.
@@ -17,7 +17,7 @@ documents:
   npm-trusted-publishing-0.2.2.md: Validation evidence for the blocked 0.2.2 npm trusted-publishing retry.
   windows-self-upgrade.md: Validation evidence for GitHub issues #9 and #1 and the Windows self-upgrade patch.
   upgrade-reliability.md: Revalidation record for GitHub issues 12 and 13; currently marked needs-revalidation.
-  rfc-0034-cli-compliance-migration.md: Complete RFC 0034 validation and readiness report.
+  rfc-0034-cli-compliance-migration.md: Complete RFC 0034 correction validation and patch-release readiness report.
 tags:
   - validation
 keywords:

package/library/agents.d.ts

@@ -27,7 +27,8 @@ declare function applyAgentInstructions(cwd: string): Promise<string[]>;
 declare function updateAgentInstructions(cwd: string): Promise<string[]>;
 declare function removeAgentInstructions(cwd: string): Promise<string[]>;
 declare function showAgentInstructions(): Promise<string>;
-declare function listAgentPrompts(namesOnly?: boolean): string[] | Array<{
+declare function listAgentPrompts(namesOnly: true): string[];
+declare function listAgentPrompts(namesOnly?: false): Array<{
     id: string;
     description: string;
 }>;

package/library/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,CAAA;AAED,KAAK,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAEtE,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,2BAA2B,EAAE,iBAAiB,CAAA;CACnD;AAOD,iBAAe,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElF;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEjF;AAED,iBAAe,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIpF;AAED,iBAAS,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpF;AAED,iBAAe,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAQtI;AAED,iBAAe,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEpE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrE;AAED,iBAAe,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,iBAAS,gBAAgB,CAAC,SAAS,UAAQ,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAIlG;AAED,iBAAe,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1D"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,CAAA;AAED,KAAK,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAEtE,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,2BAA2B,EAAE,iBAAiB,CAAA;CACnD;AAOD,iBAAe,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElF;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEjF;AAED,iBAAe,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIpF;AAED,iBAAS,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpF;AAED,iBAAe,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAQtI;AAED,iBAAe,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEpE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrE;AAED,iBAAe,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,iBAAS,gBAAgB,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,EAAE,CAAA;AACpD,iBAAS,gBAAgB,CAAC,SAAS,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAAA;AAOxF,iBAAe,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1D"}

package/library/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,OAAO,KAAK,EAAkB,UAAU,EAAkB,MAAM,OAAO,CAAA;AAIvE,OAAO,EACL,MAAM,EACN,uBAAuB,EACvB,WAAW,GACZ,CAAA;AAuOD,QAAA,MAAiB,WAAW,iBAAwB,CAAA;AAEpD,iBAAe,MAAM,CAAC,OAAO,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;AAED,iBAAe,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../source/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,OAAO,KAAK,EAAkB,UAAU,EAAkB,MAAM,OAAO,CAAA;AAIvE,OAAO,EACL,MAAM,EACN,uBAAuB,EACvB,WAAW,GACZ,CAAA;AAsPD,QAAA,MAAiB,WAAW,iBAAwB,CAAA;AAEpD,iBAAe,MAAM,CAAC,OAAO,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E;AAED,iBAAe,uBAAuB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAexE"}

package/library/cli.js

@@ -102,7 +102,14 @@ function createCommandTree() {
     const instruction = group('runx agent instruction', 'Manage RunX instruction blocks.', { apply: instructionApply, remove: instructionRemove, update: instructionUpdate, show: instructionShow }, state);
     const promptList = leaf('runx agent prompt list', 'List bundled RunX prompts.', {
         names: { type: 'boolean', description: 'Print prompt names only.' }, format: catalogArgs.format,
-    }, () => writeFormatted(listAgentPrompts(Boolean(state.args.names)), state.args));
+    }, () => {
+        if (state.args.names) {
+            const names = listAgentPrompts(true);
+            write(options(state.args).format === 'json' ? renderJson(names) : `${names.join('\n')}\n`);
+            return;
+        }
+        writeFormatted(listAgentPrompts(false), state.args);
+    });
     const promptShow = leaf('runx agent prompt show', 'Print one raw bundled prompt.', {
         id: { type: 'positional', description: 'Bundled prompt ID.' },
     }, async ({ args }) => {
@@ -112,14 +119,13 @@ function createCommandTree() {
     });
     const prompt = group('runx agent prompt', 'Inspect bundled agent prompts.', { list: promptList, show: promptShow }, state);
     const agent = group('runx agent', 'Manage RunX agent integration.', { skill, instruction, prompt }, state);
-    const upgradeApply = leaf('runx upgrade', 'Upgrade the canonical native RunX executable.', {
+    const upgradeArgs = {
         version: { type: 'string', valueHint: 'version', description: 'Select an exact release version.' },
         arch: { type: 'string', valueHint: 'x64|arm64', description: 'Select target architecture.' },
         variant: { type: 'string', valueHint: 'baseline|default|modern', description: 'Select x64 binary variant.' },
         'dry-run': { type: 'boolean', description: 'Plan without mutation.' },
         format: catalogArgs.format,
-    }, async () => runUpgrade(options(state.args), state.args));
-    upgradeApply.meta = { ...upgradeApply.meta, hidden: true };
+    };
     const upgradeCheck = leaf('runx upgrade check', 'Check whether a newer stable release exists.', {
         format: catalogArgs.format,
     }, async () => {
@@ -134,7 +140,14 @@ function createCommandTree() {
         variant: { type: 'string', valueHint: 'baseline|default|modern', description: 'Select x64 variant.' },
         format: catalogArgs.format,
     }, async () => runUpgradeList(state.args));
-    const upgrade = group('runx upgrade', 'Inspect or upgrade a native RunX executable.', { _apply: upgradeApply, check: upgradeCheck, list: upgradeList }, state, '_apply');
+    const upgrade = defineCommand({
+        meta: { name: 'runx upgrade', description: 'Inspect or upgrade a native RunX executable.' },
+        args: { ...upgradeArgs, ...helpArgs },
+        subCommands: { check: upgradeCheck, list: upgradeList },
+        setup: helpSetup(state),
+        run: async () => runUpgrade(options(state.args), state.args),
+    });
+    state.commands.set('upgrade', upgrade);
     const uninstall = leaf('runx uninstall', 'Uninstall the native RunX executable.', {
         'dry-run': { type: 'boolean', description: 'Print the target without deleting it.' }, format: catalogArgs.format,
     }, async () => {
@@ -149,8 +162,9 @@ function createCommandTree() {
             state.args = context.args;
             state.command = resolveHelpCommand(state);
             await validateInvocation(state);
-            if (state.args.v || state.args.version === true)
+            if (context.rawArgs.length === 1 && ['-v', '--version'].includes(context.rawArgs[0] ?? '')) {
                 return handled(`${readVersion()}\n`);
+            }
             await handleHelp(state);
         },
         run: ({ args }) => {
@@ -217,10 +231,14 @@ async function runCli(rawArgs = process.argv.slice(2)) {
     }
     const { command, state } = createCommandTree();
     const cleanOutput = rawArgs.some((arg) => ['-h', '--help', '-v', '--version', '--help-tree', '--help-docs'].includes(arg) || arg.startsWith('--help-tree-depth'));
-    if (!cleanOutput && rawArgs.length > 0) {
+    if (!cleanOutput) {
         const notice = await readCachedUpdateNotice(rawArgs.includes('--verbose'));
-        if (notice)
-            process.stderr.write(`${notice}\n`);
+        if (notice) {
+            if (rawArgs.length === 0)
+                write(`${notice}\n`);
+            else
+                process.stderr.write(`${notice}\n`);
+        }
     }
     spawnUpdateWorker();
     try {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@guiho/runx",
   "description": "A language-agnostic, documented command catalog and local CLI executor.",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "type": "module",
   "main": "./library/guiho-runx.js",
   "types": "./library/guiho-runx.d.ts",