akm-cli 0.8.0-rc2 → 0.8.0

package/dist/output/renderers.js

@@ -1,3 +1,6 @@
+// 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/.
 /**
  * Built-in asset renderers.
  *
@@ -8,9 +11,9 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { listKeys as listVaultKeys } from "../commands/vault";
-import { hasErrnoCode } from "../core/common";
-import { parseFrontmatter, toStringOrUndefined } from "../core/frontmatter";
+import { listKeys as listVaultKeys } from "../commands/env";
+import { asNonEmptyString, hasErrnoCode } from "../core/common";
+import { parseFrontmatter } from "../core/frontmatter";
 import { extractFrontmatterOnly, extractLineRange, extractSection, formatToc, parseMarkdownToc, } from "../core/markdown";
 import { registerRenderer } from "../indexer/file-context";
 import { extractCommentMetadata, extractDescriptionFromComments } from "../indexer/metadata";
@@ -166,7 +169,7 @@ const skillMdRenderer = {
             name,
             path: ctx.absPath,
             action: "Read and follow the instructions below",
-            description: toStringOrUndefined(parsed.data.description),
+            description: asNonEmptyString(parsed.data.description),
             ...(tags ? { tags } : {}),
             content: parsed.content,
         };
@@ -185,11 +188,11 @@ const commandMdRenderer = {
             name,
             path: ctx.absPath,
             action: "Fill $ARGUMENTS placeholders in the template, then dispatch",
-            description: toStringOrUndefined(parsedMd.data.description),
+            description: asNonEmptyString(parsedMd.data.description),
             ...(tags ? { tags } : {}),
             template,
             modelHint: typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined,
-            agent: toStringOrUndefined(parsedMd.data.agent),
+            agent: asNonEmptyString(parsedMd.data.agent),
             parameters: extractParameters(template),
         };
     },
@@ -205,148 +208,67 @@ const agentMdRenderer = {
             name,
             path: ctx.absPath,
             action: "Dispatch using the prompt below verbatim. Use modelHint and toolPolicy if present.",
-            description: toStringOrUndefined(parsedMd.data.description),
+            description: asNonEmptyString(parsedMd.data.description),
             prompt: parsedMd.content,
             toolPolicy: parsedMd.data.tools,
             modelHint: typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined,
         };
     },
 };
+// ── 4. knowledge-md / wiki-md shared helper ───────────────────────────────────
+const KNOWLEDGE_ACTION = "Reference material - read the content below. Use 'toc' view for large documents.";
+const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
+/**
+ * Shared implementation for knowledge-md and wiki-md `buildShowResponse`.
+ *
+ * Both renderers handle the same set of view modes (toc, frontmatter, section,
+ * lines, full). The only differences are the `type` discriminant and the
+ * section-not-found message. Extracting this helper eliminates ~90 lines of
+ * byte-for-byte duplication.
+ */
+function buildMarkdownViewResponse(ctx, type, action) {
+    const name = deriveName(ctx);
+    const v = ctx.matchResult.meta?.view ?? { mode: "full" };
+    const content = ctx.content();
+    switch (v.mode) {
+        case "toc": {
+            const toc = parseMarkdownToc(content);
+            return { type, name, path: ctx.absPath, action, content: formatToc(toc) };
+        }
+        case "frontmatter": {
+            const fm = extractFrontmatterOnly(content);
+            return { type, name, path: ctx.absPath, action, content: fm ?? "(no frontmatter)" };
+        }
+        case "section": {
+            const section = extractSection(content, v.heading);
+            if (!section) {
+                const notFoundMsg = type === "wiki"
+                    ? `Section "${v.heading}" not found in ${name}. Try \`akm show wiki:${name} toc\` to discover available headings.`
+                    : `Section "${v.heading}" not found in ${name}. Try \`akm show <ref> toc\` to discover available headings.`;
+                return { type, name, path: ctx.absPath, action, content: notFoundMsg };
+            }
+            return { type, name, path: ctx.absPath, action, content: section.content };
+        }
+        case "lines": {
+            return { type, name, path: ctx.absPath, action, content: extractLineRange(content, v.start, v.end) };
+        }
+        default: {
+            return { type, name, path: ctx.absPath, action, content };
+        }
+    }
+}
 // ── 4. knowledge-md ──────────────────────────────────────────────────────────
 const knowledgeMdRenderer = {
     name: "knowledge-md",
     buildShowResponse(ctx) {
-        const name = deriveName(ctx);
-        const v = ctx.matchResult.meta?.view ?? { mode: "full" };
-        const content = ctx.content();
-        switch (v.mode) {
-            case "toc": {
-                const toc = parseMarkdownToc(content);
-                return {
-                    type: "knowledge",
-                    name,
-                    path: ctx.absPath,
-                    action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                    content: formatToc(toc),
-                };
-            }
-            case "frontmatter": {
-                const fm = extractFrontmatterOnly(content);
-                return {
-                    type: "knowledge",
-                    name,
-                    path: ctx.absPath,
-                    action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                    content: fm ?? "(no frontmatter)",
-                };
-            }
-            case "section": {
-                const section = extractSection(content, v.heading);
-                if (!section) {
-                    return {
-                        type: "knowledge",
-                        name,
-                        path: ctx.absPath,
-                        action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                        content: `Section "${v.heading}" not found in ${name}. Try \`akm show <ref> toc\` to discover available headings.`,
-                    };
-                }
-                return {
-                    type: "knowledge",
-                    name,
-                    path: ctx.absPath,
-                    action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                    content: section.content,
-                };
-            }
-            case "lines": {
-                return {
-                    type: "knowledge",
-                    name,
-                    path: ctx.absPath,
-                    action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                    content: extractLineRange(content, v.start, v.end),
-                };
-            }
-            default: {
-                return {
-                    type: "knowledge",
-                    name,
-                    path: ctx.absPath,
-                    action: "Reference material - read the content below. Use 'toc' view for large documents.",
-                    content,
-                };
-            }
-        }
+        return buildMarkdownViewResponse(ctx, "knowledge", KNOWLEDGE_ACTION);
     },
 };
 // ── 4b. wiki-md ──────────────────────────────────────────────────────────────
-const WIKI_PAGE_ACTION = "Wiki page — read below. Use 'toc' to scan, 'section <heading>' for depth.";
 const wikiMdRenderer = {
     name: "wiki-md",
     buildShowResponse(ctx) {
-        const name = deriveName(ctx);
-        const v = ctx.matchResult.meta?.view ?? { mode: "full" };
-        const content = ctx.content();
-        switch (v.mode) {
-            case "toc": {
-                const toc = parseMarkdownToc(content);
-                return {
-                    type: "wiki",
-                    name,
-                    path: ctx.absPath,
-                    action: WIKI_PAGE_ACTION,
-                    content: formatToc(toc),
-                };
-            }
-            case "frontmatter": {
-                const fm = extractFrontmatterOnly(content);
-                return {
-                    type: "wiki",
-                    name,
-                    path: ctx.absPath,
-                    action: WIKI_PAGE_ACTION,
-                    content: fm ?? "(no frontmatter)",
-                };
-            }
-            case "section": {
-                const section = extractSection(content, v.heading);
-                if (!section) {
-                    return {
-                        type: "wiki",
-                        name,
-                        path: ctx.absPath,
-                        action: WIKI_PAGE_ACTION,
-                        content: `Section "${v.heading}" not found in ${name}. Try \`akm show wiki:${name} toc\` to discover available headings.`,
-                    };
-                }
-                return {
-                    type: "wiki",
-                    name,
-                    path: ctx.absPath,
-                    action: WIKI_PAGE_ACTION,
-                    content: section.content,
-                };
-            }
-            case "lines": {
-                return {
-                    type: "wiki",
-                    name,
-                    path: ctx.absPath,
-                    action: WIKI_PAGE_ACTION,
-                    content: extractLineRange(content, v.start, v.end),
-                };
-            }
-            default: {
-                return {
-                    type: "wiki",
-                    name,
-                    path: ctx.absPath,
-                    action: WIKI_PAGE_ACTION,
-                    content,
-                };
-            }
-        }
+        return buildMarkdownViewResponse(ctx, "wiki", WIKI_PAGE_ACTION);
     },
 };
 // ── 4c. lesson-md ────────────────────────────────────────────────────────────
@@ -365,8 +287,8 @@ const lessonMdRenderer = {
     buildShowResponse(ctx) {
         const name = deriveName(ctx);
         const parsed = parseFrontmatter(ctx.content());
-        const description = toStringOrUndefined(parsed.data.description);
-        const whenToUse = toStringOrUndefined(parsed.data.when_to_use);
+        const description = asNonEmptyString(parsed.data.description);
+        const whenToUse = asNonEmptyString(parsed.data.when_to_use);
         const action = whenToUse
             ? `Apply this lesson when: ${whenToUse}`
             : "Apply this lesson when its `when_to_use` trigger matches the current task.";
@@ -467,10 +389,55 @@ const vaultEnvRenderer = {
             hit.keys = keys;
     },
 };
+// ── 8b. env-file ───────────────────────────────────────────────────────────────
+/**
+ * Env renderer. Like the (deprecated) vault renderer, returns ONLY key names
+ * and start-of-line comments — never values. Deliberately omits
+ * content/template/prompt so env values cannot leak through `akm show`.
+ */
+const envFileRenderer = {
+    name: "env-file",
+    buildShowResponse(ctx) {
+        const name = deriveName(ctx);
+        const { keys, comments } = listVaultKeys(ctx.absPath);
+        return {
+            type: "env",
+            name,
+            path: ctx.absPath,
+            action: "Environment — keys + comments only. Use `akm env run <ref> -- <command>` to run with the whole .env injected (the safe path — values never reach stdout). `akm env export <ref> --out <file>` writes a sourceable script to a file. Never `source` the raw file. Values stay on disk and are never written to akm's stdout.",
+            description: comments.length > 0 ? comments.join("\n") : undefined,
+            keys,
+            comments,
+        };
+    },
+    enrichSearchHit(hit, _stashDir) {
+        const { keys } = listVaultKeys(hit.path);
+        if (keys.length > 0)
+            hit.keys = keys;
+    },
+};
+// ── 9. secret-file ─────────────────────────────────────────────────────────────
+/**
+ * Secret renderer. The ENTIRE file is the secret value, so this surfaces ONLY
+ * the name + path + a usage hint — never content/template/prompt/keys. There
+ * is no `enrichSearchHit`: secrets are discoverable by name alone.
+ */
+const secretFileRenderer = {
+    name: "secret-file",
+    buildShowResponse(ctx) {
+        const name = deriveName(ctx);
+        return {
+            type: "secret",
+            name,
+            path: ctx.absPath,
+            action: "Secret — name only; the file contents are the value and are never written to akm's stdout. Use `akm secret path <ref>` for the file path, or `akm secret run <ref> <VAR> -- <command>` to run with the value injected into $VAR.",
+        };
+    },
+};
 // ── 7. task-md ───────────────────────────────────────────────────────────────
 const TASK_PAGE_ACTION = "Scheduled task — `akm tasks show <id>` for parsed details, `akm tasks run <id>` to invoke now.";
 const taskMdRenderer = {
-    name: "task-md",
+    name: "task-yaml",
     buildShowResponse(ctx) {
         const name = deriveName(ctx);
         return {
@@ -492,28 +459,37 @@ function applyTocMetadata(entry, ctx) {
         // Non-fatal: skip TOC if file can't be read
     }
 }
+/**
+ * Parse frontmatter, apply description (if not already set) and merge tags
+ * into `entry`. Returns the raw frontmatter data object so callers can access
+ * type-specific fields without re-parsing.
+ */
+function applyFrontmatterDescriptionAndTags(entry, ctx) {
+    const parsed = parseFrontmatter(ctx.content());
+    const fm = parsed.data;
+    const desc = asNonEmptyString(fm.description);
+    if (desc && !entry.description) {
+        entry.description = desc;
+        entry.source = "frontmatter";
+        entry.confidence = 0.9;
+    }
+    if (Array.isArray(fm.tags) && fm.tags.length > 0) {
+        const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
+        if (fmTags.length > 0) {
+            entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
+        }
+    }
+    return fm;
+}
 function applyLessonMetadata(entry, ctx) {
     try {
-        const parsed = parseFrontmatter(ctx.content());
-        const fm = parsed.data;
-        const desc = toStringOrUndefined(fm.description);
-        if (desc && !entry.description) {
-            entry.description = desc;
-            entry.source = "frontmatter";
-            entry.confidence = 0.9;
-        }
-        const whenToUse = toStringOrUndefined(fm.when_to_use);
+        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
+        const whenToUse = asNonEmptyString(fm.when_to_use);
         if (whenToUse) {
             const hints = new Set(entry.searchHints ?? []);
             hints.add(`when_to_use:${whenToUse}`);
             entry.searchHints = Array.from(hints).filter(Boolean);
         }
-        if (Array.isArray(fm.tags) && fm.tags.length > 0) {
-            const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
-            if (fmTags.length > 0) {
-                entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
-            }
-        }
     }
     catch {
         // Non-fatal: skip metadata extraction on parse error
@@ -521,25 +497,12 @@ function applyLessonMetadata(entry, ctx) {
 }
 function applyMemoryMetadata(entry, ctx) {
     try {
-        const parsed = parseFrontmatter(ctx.content());
-        const fm = parsed.data;
-        const desc = toStringOrUndefined(fm.description);
-        if (desc && !entry.description) {
-            entry.description = desc;
-            entry.source = "frontmatter";
-            entry.confidence = 0.9;
-        }
-        if (Array.isArray(fm.tags) && fm.tags.length > 0) {
-            const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
-            if (fmTags.length > 0) {
-                entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
-            }
-        }
+        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
         const hints = new Set(entry.searchHints ?? []);
-        const source = toStringOrUndefined(fm.source);
+        const source = asNonEmptyString(fm.source);
         if (source)
             hints.add(source);
-        const fmObservedAt = toStringOrUndefined(fm.observed_at);
+        const fmObservedAt = asNonEmptyString(fm.observed_at);
         if (fmObservedAt) {
             hints.add(`observed_at:${fmObservedAt}`);
         }
@@ -552,7 +515,7 @@ function applyMemoryMetadata(entry, ctx) {
                 // Non-fatal: skip mtime fallback on stat error
             }
         }
-        const expires = toStringOrUndefined(fm.expires);
+        const expires = asNonEmptyString(fm.expires);
         if (expires)
             hints.add(`expires:${expires}`);
         if (fm.subjective === true)
@@ -587,31 +550,37 @@ function applyVaultMetadata(entry, ctx) {
     }
     entry.tags = Array.from(new Set([...(entry.tags ?? []), "vault", "secrets"]));
 }
+function applyEnvMetadata(entry, ctx) {
+    const { keys, comments } = listVaultKeys(ctx.absPath);
+    if (comments.length > 0 && !entry.description) {
+        entry.description = comments.join(" ").slice(0, 500);
+        entry.source = "comments";
+        entry.confidence = 0.7;
+    }
+    if (keys.length > 0) {
+        entry.searchHints = keys;
+    }
+    entry.tags = Array.from(new Set([...(entry.tags ?? []), "env", "secrets"]));
+}
+/**
+ * Secret metadata: tags only. Must NEVER read the file body — the whole file
+ * is the value, so the entry is built from the filename alone (name-only).
+ */
+function applySecretMetadata(entry, _ctx) {
+    entry.tags = Array.from(new Set([...(entry.tags ?? []), "secret", "sensitive"]));
+}
 function applyTaskMetadata(entry, ctx) {
     try {
-        const parsed = parseFrontmatter(ctx.content());
-        const fm = parsed.data;
-        const desc = toStringOrUndefined(fm.description);
-        if (desc && !entry.description) {
-            entry.description = desc;
-            entry.source = "frontmatter";
-            entry.confidence = 0.9;
-        }
-        if (Array.isArray(fm.tags)) {
-            const fmTags = fm.tags.filter((t) => typeof t === "string" && t.trim().length > 0);
-            if (fmTags.length > 0) {
-                entry.tags = Array.from(new Set([...(entry.tags ?? []), ...fmTags]));
-            }
-        }
+        const fm = applyFrontmatterDescriptionAndTags(entry, ctx);
         entry.tags = Array.from(new Set([...(entry.tags ?? []), "task", "scheduled"]));
         const hints = new Set(entry.searchHints ?? []);
-        const schedule = toStringOrUndefined(fm.schedule);
+        const schedule = asNonEmptyString(fm.schedule);
         if (schedule)
             hints.add(`schedule:${schedule}`);
-        const workflow = toStringOrUndefined(fm.workflow);
+        const workflow = asNonEmptyString(fm.workflow);
         if (workflow)
             hints.add(`workflow:${workflow}`);
-        const prompt = toStringOrUndefined(fm.prompt);
+        const prompt = asNonEmptyString(fm.prompt);
         if (prompt)
             hints.add(`prompt:${prompt}`);
         if (hints.size > 0)
@@ -622,13 +591,8 @@ function applyTaskMetadata(entry, ctx) {
     }
 }
 registerMetadataContributor({
-    name: "knowledge-toc-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "knowledge-md",
-    contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
-});
-registerMetadataContributor({
-    name: "wiki-toc-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "wiki-md",
+    name: "toc-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "knowledge-md" || rendererName === "wiki-md",
     contribute: (entry, ctx) => applyTocMetadata(entry, ctx.renderContext),
 });
 registerMetadataContributor({
@@ -652,8 +616,18 @@ registerMetadataContributor({
     contribute: (entry, ctx) => applyVaultMetadata(entry, ctx.renderContext),
 });
 registerMetadataContributor({
-    name: "task-frontmatter-metadata",
-    appliesTo: ({ rendererName }) => rendererName === "task-md",
+    name: "env-file-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "env-file",
+    contribute: (entry, ctx) => applyEnvMetadata(entry, ctx.renderContext),
+});
+registerMetadataContributor({
+    name: "secret-file-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "secret-file",
+    contribute: (entry, ctx) => applySecretMetadata(entry, ctx.renderContext),
+});
+registerMetadataContributor({
+    name: "task-yaml-metadata",
+    appliesTo: ({ rendererName }) => rendererName === "task-yaml",
     contribute: (entry, ctx) => applyTaskMetadata(entry, ctx.renderContext),
 });
 // ── Registration ─────────────────────────────────────────────────────────────
@@ -668,7 +642,9 @@ const builtinRenderers = [
     memoryMdRenderer,
     workflowMdRenderer,
     scriptSourceRenderer,
+    envFileRenderer,
     vaultEnvRenderer,
+    secretFileRenderer,
     taskMdRenderer,
 ];
 /**
@@ -681,4 +657,4 @@ export function registerBuiltinRenderers() {
     }
 }
 // ── Named exports for testing ────────────────────────────────────────────────
-export { agentMdRenderer, commandMdRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, skillMdRenderer, vaultEnvRenderer, wikiMdRenderer, workflowMdRenderer, };
+export { agentMdRenderer, commandMdRenderer, envFileRenderer, INTERPRETER_MAP, knowledgeMdRenderer, lessonMdRenderer, memoryMdRenderer, SETUP_SIGNALS, scriptSourceRenderer, secretFileRenderer, skillMdRenderer, vaultEnvRenderer, wikiMdRenderer, workflowMdRenderer, };

package/dist/output/shapes/curate.js

@@ -0,0 +1,56 @@
+// 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 { capDescription, NORMAL_DESCRIPTION_LIMIT, pickFields } from "./helpers";
+import { registerOutputShape } from "./registry";
+// Curation is a small, high-signal top-N. Even at `brief` we keep `followUp`
+// (the actionable `akm show <ref>` command) and `reason` (why this asset was
+// selected) — these are the point of curate, unlike a bulk search listing.
+const BRIEF_FIELDS = ["source", "type", "name", "ref", "id", "followUp", "reason"];
+const NORMAL_FIELDS = [
+    "source",
+    "type",
+    "name",
+    "ref",
+    "id",
+    "description",
+    "preview",
+    "keys",
+    "parameters",
+    "run",
+    "followUp",
+    "reason",
+    "score",
+];
+// Agent shape: the minimal field set an LLM needs to decide and act.
+const AGENT_FIELDS = ["source", "type", "name", "ref", "id", "description", "followUp", "reason", "score"];
+function shapeCurateItem(item, detail, shape) {
+    if (shape === "agent") {
+        return capDescription(pickFields(item, AGENT_FIELDS), NORMAL_DESCRIPTION_LIMIT);
+    }
+    if (detail === "brief") {
+        return pickFields(item, BRIEF_FIELDS);
+    }
+    if (detail === "normal") {
+        return capDescription(pickFields(item, NORMAL_FIELDS), NORMAL_DESCRIPTION_LIMIT);
+    }
+    // full: project everything the curator emits.
+    return item;
+}
+export function shapeCurateOutput(result, detail, shape) {
+    const items = Array.isArray(result.items) ? result.items : [];
+    const shapedItems = items.map((item) => shapeCurateItem(item, detail, shape));
+    const base = {
+        // `shape`/`schemaVersion` discriminators preserve the prior passthrough
+        // envelope contract (#484) so consumers can pin a schema version.
+        schemaVersion: typeof result.schemaVersion === "number" ? result.schemaVersion : 1,
+        shape: "curate",
+        query: result.query,
+        summary: result.summary,
+        items: shapedItems,
+        ...(Array.isArray(result.warnings) && result.warnings.length > 0 ? { warnings: result.warnings } : {}),
+        ...(result.tip ? { tip: result.tip } : {}),
+    };
+    return base;
+}
+registerOutputShape("curate", (result, detail, shape) => shapeCurateOutput(result, detail, shape));

package/dist/output/shapes/distill.js

@@ -0,0 +1,10 @@
+// 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/.
+// Output shape registration for `akm distill <ref>` (#228). The shape is
+// simple — outcome + ids + optional payload — so `brief` strips the full
+// proposal blob, `normal` keeps the headline fields, and `full` projects
+// everything for downstream automation.
+import { shapeDistillOutput } from "./helpers";
+import { registerOutputShape } from "./registry";
+registerOutputShape("distill", (result, detail) => shapeDistillOutput(result, detail));

package/dist/output/shapes/env-list.js

@@ -0,0 +1,19 @@
+// 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/.
+// env-list strips `path` from each env object (security: avoid leaking
+// absolute disk paths) then stamps the envelope.
+import { registerOutputShape } from "./registry";
+registerOutputShape("env-list", (result) => {
+    const r = result;
+    const envs = Array.isArray(r.envs) ? r.envs : [];
+    return {
+        ...r,
+        shape: r.shape ?? "env-list",
+        schemaVersion: r.schemaVersion ?? 1,
+        envs: envs.map((v) => {
+            const { path: _path, ...rest } = v;
+            return rest;
+        }),
+    };
+});

package/dist/output/shapes/events.js

@@ -0,0 +1,11 @@
+// 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/.
+// Output shape registration for `akm events list` and `akm events tail` (#204).
+// Both share the same envelope; the renderer in text.ts uses distinct command
+// names so it can format streaming differently.
+import { shapeEventsOutput } from "./helpers";
+import { registerOutputShape } from "./registry";
+const handler = (result, detail) => shapeEventsOutput(result, detail);
+registerOutputShape("events-list", handler);
+registerOutputShape("events-tail", handler);