akm-cli 0.9.14 → 0.9.15-beta.2

package/dist/output/shapes/helpers.js

@@ -2,6 +2,21 @@
 // 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/.
 export const NORMAL_DESCRIPTION_LIMIT = 250;
+const FRAGMENT_PROVENANCE_FIELDS = [
+    "selectedRef",
+    "parentRef",
+    "fragmentOrdinal",
+    "fragmentCount",
+    "startLine",
+    "endLine",
+    "previousRef",
+    "nextRef",
+    "fragmentChars",
+    "fragmentEstimatedTokens",
+    "parentChars",
+    "parentEstimatedTokens",
+];
+const FRAGMENT_CONTEXT_FIELDS = ["contextMode", "contextMaxChars", "contextTruncated"];
 export function shapeProposalProducerOutput(result, detail) {
     if (result.ok === false) {
         const base = {
@@ -268,8 +283,21 @@ export function shapeSearchHit(hit, detail) {
     // Stash hit (local or remote)
     // `ref` is included at `brief` so agents can run `akm show <ref>` without
     // needing --detail full or --shape agent (REC-03).
-    if (detail === "brief")
-        return pickFields(hit, ["type", "name", "ref", "action", "estimatedTokens", "keys"]);
+    if (detail === "brief") {
+        return pickFields(hit, [
+            "type",
+            "name",
+            "ref",
+            "action",
+            "estimatedTokens",
+            "keys",
+            "selectedRef",
+            "parentRef",
+            "fragmentOrdinal",
+            "fragmentCount",
+            "parentEstimatedTokens",
+        ]);
+    }
     if (detail === "normal") {
         // `warnings` is projected at `normal` so non-fatal hit-level issues are
         // visible without forcing callers up to `--detail full`. Optional
@@ -288,6 +316,7 @@ export function shapeSearchHit(hit, detail) {
             "warnings",
             "quality",
             "matchStage",
+            ...FRAGMENT_PROVENANCE_FIELDS,
         ]), NORMAL_DESCRIPTION_LIMIT);
         if (Array.isArray(hit.keys) && hit.keys.length > 0)
             shaped.keys = hit.keys;
@@ -314,6 +343,7 @@ export function shapeSearchHitForAgent(hit) {
         // hit (a strict-AND match is stronger signal than an OR-fallback
         // recovery match) without going to `--detail full`.
         "matchStage",
+        ...FRAGMENT_PROVENANCE_FIELDS,
     ]);
     if (picked.editable !== false)
         delete picked.editHint;
@@ -360,6 +390,8 @@ export function shapeShowOutput(result, detail, shape = "human") {
             "steps",
             "keys",
             "related",
+            ...FRAGMENT_PROVENANCE_FIELDS,
+            ...FRAGMENT_CONTEXT_FIELDS,
         ]);
         if (shaped.editable !== false)
             delete shaped.editHint;
@@ -382,6 +414,8 @@ export function shapeShowOutput(result, detail, shape = "human") {
             "origin",
             "keys",
             "related",
+            ...FRAGMENT_PROVENANCE_FIELDS,
+            ...FRAGMENT_CONTEXT_FIELDS,
         ]);
     }
     const base = pickFields(result, [
@@ -409,6 +443,8 @@ export function shapeShowOutput(result, detail, shape = "human") {
         "activeRun",
         "keys",
         "related",
+        ...FRAGMENT_PROVENANCE_FIELDS,
+        ...FRAGMENT_CONTEXT_FIELDS,
         // ref, path, and editable are always projected — at every --detail level,
         // not just --detail full — so JSON consumers can locate and edit the
         // asset without needing --detail full (QA #7 / D-14).

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

@@ -0,0 +1,16 @@
+// 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/.
+export const modelsListShapes = [
+    {
+        command: "models-list",
+        handler: (result) => {
+            const r = result;
+            return {
+                ...r,
+                shape: r.shape ?? "models-list",
+                schemaVersion: r.schemaVersion ?? 1,
+            };
+        },
+    },
+];

package/dist/output/shapes/passthrough.js

@@ -43,6 +43,7 @@ const PASSTHROUGH_COMMANDS = [
     "clone",
     "command-dry-run",
     "config",
+    "config-diff",
     "env-create",
     "env-export",
     "env-remove",
@@ -50,6 +51,7 @@ const PASSTHROUGH_COMMANDS = [
     "extract",
     "health",
     "improve",
+    "improve-report",
     "import",
     "index",
     "info",

package/dist/output/shapes.js

@@ -22,6 +22,7 @@ import { curateShapes } from "./shapes/curate.js";
 import { envListShapes } from "./shapes/env-list.js";
 import { eventsShapes } from "./shapes/events.js";
 import { migrateShapes } from "./shapes/migrate.js";
+import { modelsListShapes } from "./shapes/models-list.js";
 import { passthroughShapes } from "./shapes/passthrough.js";
 import { proposalAcceptShapes } from "./shapes/proposal/accept.js";
 import { proposalDiffShapes } from "./shapes/proposal/diff.js";
@@ -55,6 +56,7 @@ const BUILT_IN_OUTPUT_SHAPES = [
     ...envListShapes,
     ...secretListShapes,
     ...migrateShapes,
+    ...modelsListShapes,
     // Passthrough commands are registered last so an explicit dedicated handler
     // above always wins over the identity-stamp fallback for the same name.
     ...passthroughShapes,
@@ -94,6 +96,8 @@ const LIST_RESULT_COLLECTION_KEYS = {
     "workflow-list": "runs",
     "task-history": "rows",
     "log-list": "events", // `akm log list`
+    "config-diff": "rows", // `akm config diff`
+    "models-list": "rows", // `akm models list`
 };
 function withResultsAlias(command, shaped) {
     const key = LIST_RESULT_COLLECTION_KEYS[command];

package/dist/output/text/command-format.js

@@ -478,6 +478,35 @@ export function formatListPlain(r) {
     lines.push("To search: akm search '<query>'  |  To view an asset: akm show <ref>");
     return lines.join("\n");
 }
+/** Render `akm models list`'s `{ rows }` as a column-aligned table (#946). */
+export function formatModelsListPlain(r) {
+    const rows = Array.isArray(r.rows) ? r.rows : [];
+    if (rows.length === 0)
+        return "No model aliases configured.";
+    const headers = ["ALIAS", "COLUMN", "MODEL", "SOURCE", "VIA", "ENGINE"];
+    const cells = rows.map((row) => [
+        String(row.alias ?? "?"),
+        String(row.column ?? "?"),
+        String(row.model ?? "?"),
+        String(row.source ?? "?"),
+        String(row.via ?? "?"),
+        row.engine !== undefined ? String(row.engine) : "-",
+    ]);
+    const widths = headers.map((header, i) => {
+        let width = header.length;
+        for (const cols of cells) {
+            const cell = cols[i];
+            if (cell !== undefined && cell.length > width)
+                width = cell.length;
+        }
+        return width;
+    });
+    const renderRow = (cols) => cols
+        .map((cell, i) => cell.padEnd(widths[i] ?? cell.length))
+        .join("  ")
+        .trimEnd();
+    return [renderRow(headers), ...cells.map(renderRow)].join("\n");
+}
 /** Render a single `SourceEntry` — `akm bundle show <name>`'s detail view of one `list` row. */
 export function formatBundleShowPlain(r) {
     const name = typeof r.name === "string" ? r.name : "unknown";

package/dist/output/text/helpers.js

@@ -15,7 +15,7 @@
  *
  * No registry imports — no circular dependencies.
  */
-export { formatAddPlain, formatBundleShowPlain, formatClonePlain, formatConfigPlain, formatCuratePlain, formatEnvCreatePlain, formatEnvExportPlain, formatEnvListPlain, formatEnvRemovePlain, formatEventLine, formatEventsPlain, formatFeedbackPlain, formatImportPlain, formatIndexPlain, formatInfoPlain, formatInitPlain, formatListPlain, formatRegistryAddPlain, formatRegistryListPlain, formatRegistryRemovePlain, formatRegistrySearchPlain, formatRememberPlain, formatRemovePlain, formatSearchPlain, formatSyncPlain, formatUpdatePlain, formatUpgradePlain, } from "./command-format.js";
+export { formatAddPlain, formatBundleShowPlain, formatClonePlain, formatConfigPlain, formatCuratePlain, formatEnvCreatePlain, formatEnvExportPlain, formatEnvListPlain, formatEnvRemovePlain, formatEventLine, formatEventsPlain, formatFeedbackPlain, formatImportPlain, formatIndexPlain, formatInfoPlain, formatInitPlain, formatListPlain, formatModelsListPlain, formatRegistryAddPlain, formatRegistryListPlain, formatRegistryRemovePlain, formatRegistrySearchPlain, formatRememberPlain, formatRemovePlain, formatSearchPlain, formatSyncPlain, formatUpdatePlain, formatUpgradePlain, } from "./command-format.js";
 export { formatHealthPlain } from "./health-format.js";
 export { formatLintPlain } from "./lint-format.js";
 export { formatGateDecisionSummary, formatProposalAcceptPlain, formatProposalDiffPlain, formatProposalDrainPlain, formatProposalListPlain, formatProposalProducerPlain, formatProposalRejectPlain, formatProposalShowPlain, } from "./proposal-format.js";

package/dist/output/text/improve-report.js

@@ -0,0 +1,27 @@
+// 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/.
+/**
+ * #944 — `akm improve report --format text`. Renders the SAME fixed-width
+ * table `formatUsageReportTable` produces for the end-of-run stderr summary
+ * (`improve-cli.ts`), prefixed with which run(s) it covers.
+ */
+import { formatUsageReportTable } from "../../commands/improve/improve-usage-report.js";
+function formatImproveReportPlain(result) {
+    const usageReport = result.usageReport;
+    if (!usageReport)
+        return null;
+    const lines = [];
+    if (result.mode === "since") {
+        const runIds = Array.isArray(result.runIds) ? result.runIds : [];
+        lines.push(`[improve] report since ${String(result.since ?? "?")} (${runIds.length} run${runIds.length === 1 ? "" : "s"})`);
+    }
+    else {
+        lines.push(`[improve] report for run ${String(result.runId ?? "?")}${result.strategy ? ` (strategy: ${result.strategy})` : ""}`);
+    }
+    lines.push(formatUsageReportTable(usageReport, result.notes));
+    return lines.join("\n");
+}
+export const improveReportFormatters = [
+    { command: "improve-report", handler: (r) => formatImproveReportPlain(r) },
+];

package/dist/{commands/env/marker-path.js → output/text/models.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/.
-export function sensitiveMarkerPath(assetPath, type) {
-    return type === "env" ? assetPath.replace(/\.env$/, ".sensitive") : `${assetPath}.sensitive`;
-}
+import { formatModelsListPlain } from "./helpers.js";
+export const modelsFormatters = [
+    { command: "models-list", handler: (r) => formatModelsListPlain(r) },
+];

package/dist/output/text/show-format.js

@@ -14,6 +14,10 @@ export function formatShowPlain(r, detail) {
         lines.push(`# origin: ${String(r.origin)}`);
     if (r.action)
         lines.push(`# ${String(r.action)}`);
+    if (Array.isArray(r.keys)) {
+        const keys = r.keys.map(String);
+        lines.push(keys.length > 0 ? `keys: ${keys.join(", ")}` : "(no keys)");
+    }
     if (r.description)
         lines.push(`description: ${String(r.description)}`);
     if (r.workflowTitle)

package/dist/output/text.js

@@ -12,11 +12,13 @@ import { eventsFormatters } from "./text/events.js";
 import { feedbackFormatters } from "./text/feedback.js";
 import { healthFormatters } from "./text/health.js";
 import { importFormatters } from "./text/import.js";
+import { improveReportFormatters } from "./text/improve-report.js";
 import { indexFormatters } from "./text/index.js";
 import { infoFormatters } from "./text/info.js";
 import { lintFormatters } from "./text/lint.js";
 import { listFormatters } from "./text/list.js";
 import { migrateFormatters } from "./text/migrate.js";
+import { modelsFormatters } from "./text/models.js";
 import { proposalProducerFormatters } from "./text/proposal/producer.js";
 import { proposalFormatters } from "./text/proposal/proposal.js";
 import { getTextFormatterHandler, registerTextFormatters } from "./text/registry.js";
@@ -54,6 +56,7 @@ const BUILT_IN_TEXT_FORMATTERS = [
     ...proposalProducerFormatters,
     ...infoFormatters,
     ...healthFormatters,
+    ...improveReportFormatters,
     ...lintFormatters,
     ...configFormatters,
     ...feedbackFormatters,
@@ -63,6 +66,7 @@ const BUILT_IN_TEXT_FORMATTERS = [
     ...registryCommandFormatters,
     ...envFormatters,
     ...migrateFormatters,
+    ...modelsFormatters,
 ];
 registerTextFormatters(BUILT_IN_TEXT_FORMATTERS);
 // ── JSONL output (unchanged — not part of the formatPlain dispatch) ───────────