akm-cli 0.9.16-alpha.2 → 0.9.16

package/CHANGELOG.md

@@ -6,7 +6,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-## [0.9.16-alpha.2] - 2026-09-21
+## [0.9.16] - 2026-09-22
+
+### Fixed
+
+- **Result documents larger than 64 KiB are no longer truncated on a piped
+  stdout.** `akm show`/`search`/`config get … | python3 -c …` (or `| head`, or
+  any other pipe) returned exactly 65,536 bytes — the Linux pipe-buffer size —
+  producing unparseable JSON, while the same command with `--output <file>`
+  wrote the complete document. The two stdout writers (`deliverRendered` for
+  json/yaml/text/md/html, `outputJsonl` for jsonl) used `console.log`, and on
+  Bun `console.log` issues a single `write(2)` against a non-blocking fd 1 and
+  silently discards whatever the kernel did not accept; a pipe accepts at most
+  one buffer's worth. Both now go through `writeStdout`
+  (`src/output/stdout.ts`), which uses `process.stdout.write` — that handles
+  the short write correctly, and the queued remainder keeps the process alive
+  until it drains. Byte-for-byte output is unchanged on every format; only the
+  transport moved.
 
 ### Added
 

package/dist/output/html-render.js

@@ -16,6 +16,7 @@ import fs from "node:fs";
 import path from "node:path";
 import healthTemplate from "../assets/templates/html/health.html" with { type: "text" };
 import { getDirname } from "../runtime.js";
+import { writeStdout } from "./stdout.js";
 const TEMPLATES_DIR = path.join(getDirname(import.meta.url), "../assets/templates/html");
 /**
  * Templates embedded at build time, keyed by command name.
@@ -103,5 +104,5 @@ export function deliverRendered(content, outputPath) {
         fs.writeFileSync(outputPath, content.endsWith("\n") ? content : `${content}\n`);
         return;
     }
-    console.log(content);
+    writeStdout(content);
 }

package/dist/output/stdout.js

@@ -0,0 +1,24 @@
+// This Source Code Form is subject to the terms of the Mozilla Public
+// License, v. 2.0. If a copy of the MPL was not distributed with this
+// file, You can obtain one at https://mozilla.org/MPL/2.0/.
+/**
+ * The single stdout writer for result documents.
+ *
+ * WHY NOT `console.log`: on Bun, once `process.stdout` has been materialized
+ * as a Node-compat stream — which this CLI does unconditionally, since
+ * `--help`/`hints` write through it and `src/output/context.ts` reads
+ * `isTTY` — `console.log(bigString)` issues a SINGLE `write(2)` against a
+ * non-blocking fd 1 and silently discards whatever the kernel refused. A pipe
+ * accepts at most one buffer (65,536 bytes on Linux), so `akm show … |
+ * python3` lost everything past 64 KiB while `--output <file>` wrote the
+ * whole document. `process.stdout.write` handles the short write correctly on
+ * both runtimes, and the queued remainder keeps the event loop alive until it
+ * drains, so the natural exit at the end of `runCli` still flushes it.
+ *
+ * The trailing newline is UNCONDITIONAL because that is exactly what
+ * `console.log` appended: this is a transport fix, not a format change, and
+ * `tests/integration/output-baseline.test.ts` pins the bytes either way.
+ */
+export function writeStdout(document) {
+    process.stdout.write(`${document}\n`);
+}

package/dist/output/text.js

@@ -1,6 +1,7 @@
 // This Source Code Form is subject to the terms of the Mozilla Public
 // License, v. 2.0. If a copy of the MPL was not distributed with this
 // file, You can obtain one at https://mozilla.org/MPL/2.0/.
+import { writeStdout } from "./stdout.js";
 import { addFormatters } from "./text/add.js";
 import { bundleCreateFormatters } from "./text/bundle-create.js";
 import { bundleShowFormatters } from "./text/bundle-show.js";
@@ -75,16 +76,16 @@ export function outputJsonl(command, shaped) {
         const r = shaped;
         const hits = Array.isArray(r.hits) ? r.hits : [];
         for (const hit of hits) {
-            console.log(JSON.stringify(hit));
+            writeStdout(JSON.stringify(hit));
         }
         const registryHits = Array.isArray(r.registryHits) ? r.registryHits : [];
         for (const hit of registryHits) {
-            console.log(JSON.stringify(hit));
+            writeStdout(JSON.stringify(hit));
         }
         return;
     }
     // For non-search commands, output the whole object as a single JSONL line
-    console.log(JSON.stringify(shaped));
+    writeStdout(JSON.stringify(shaped));
 }
 // ── Dispatcher ────────────────────────────────────────────────────────────────
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.16-alpha.2",
+  "version": "0.9.16",
   "type": "module",
   "description": "akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cursor.",
   "keywords": [