akm-cli 0.9.1 → 0.9.2-alpha.2

package/dist/output/renderers.js

@@ -181,6 +181,9 @@ const commandMdRenderer = {
         const parsedMd = parseFrontmatter(ctx.content());
         const template = parsedMd.content;
         const tags = readFrontmatterTags(parsedMd.data.tags);
+        const modelHint = typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined;
+        const agent = asNonEmptyString(parsedMd.data.agent);
+        const parameters = extractParameters(template);
         return {
             type: "command",
             name,
@@ -189,9 +192,9 @@ const commandMdRenderer = {
             description: asNonEmptyString(parsedMd.data.description),
             ...(tags ? { tags } : {}),
             template,
-            modelHint: typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined,
-            agent: asNonEmptyString(parsedMd.data.agent),
-            parameters: extractParameters(template),
+            ...(modelHint !== undefined ? { modelHint } : {}),
+            ...(agent !== undefined ? { agent } : {}),
+            ...(parameters !== undefined ? { parameters } : {}),
         };
     },
 };
@@ -201,6 +204,8 @@ const agentMdRenderer = {
     buildShowResponse(ctx) {
         const name = deriveName(ctx);
         const parsedMd = parseFrontmatter(ctx.content());
+        const toolPolicy = parsedMd.data.tools;
+        const modelHint = typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined;
         return {
             type: "agent",
             name,
@@ -212,8 +217,8 @@ const agentMdRenderer = {
             // whether this self-declared policy is honoured is applied at the show
             // layer (`akmShowUnified`), which knows whether the source is the operator's
             // own writable stash vs a read-only third-party source (07 P1-D).
-            toolPolicy: parsedMd.data.tools,
-            modelHint: typeof parsedMd.data.model === "string" ? parsedMd.data.model : undefined,
+            ...(toolPolicy !== undefined ? { toolPolicy } : {}),
+            ...(modelHint !== undefined ? { modelHint } : {}),
         };
     },
 };
@@ -296,8 +301,8 @@ const scriptSourceRenderer = {
                     path: ctx.absPath,
                     action: "Execute the run command below",
                     run: hints.run,
-                    setup: hints.setup,
-                    cwd: hints.cwd,
+                    ...(hints.setup !== undefined ? { setup: hints.setup } : {}),
+                    ...(hints.cwd !== undefined ? { cwd: hints.cwd } : {}),
                 };
             }
         }

package/dist/output/shapes/curate.js

@@ -68,6 +68,7 @@ export function shapeCurateOutput(result, detail, shape) {
         query: result.query,
         summary: result.summary,
         items: shapedItems,
+        ...(typeof result.searchMode === "string" ? { searchMode: result.searchMode } : {}),
         ...(Array.isArray(result.warnings) && result.warnings.length > 0 ? { warnings: result.warnings } : {}),
         ...(result.tip ? { tip: result.tip } : {}),
     };

package/dist/output/shapes/helpers.js

@@ -13,6 +13,7 @@ export function shapeProposalProducerOutput(result, detail) {
             ...(result.name !== undefined ? { name: result.name } : {}),
             ...(result.engine !== undefined ? { engine: result.engine } : {}),
             ...(result.exitCode !== undefined ? { exitCode: result.exitCode } : {}),
+            ...(Array.isArray(result.notices) ? { notices: result.notices } : {}),
         };
         if (detail === "full") {
             return {
@@ -30,6 +31,7 @@ export function shapeProposalProducerOutput(result, detail) {
         ref: result.ref,
         ...(result.engine !== undefined ? { engine: result.engine } : {}),
         ...(typeof result.durationMs === "number" ? { durationMs: result.durationMs } : {}),
+        ...(Array.isArray(result.notices) ? { notices: result.notices } : {}),
         proposal: shapeProposalEntry(proposal, detail === "brief" ? "normal" : detail),
     };
     if (detail === "full") {
@@ -185,10 +187,14 @@ export function shapeSearchOutput(result, detail, shape = "human") {
     const shapedRegistryHits = forAgent
         ? registryHits.map((hit) => shapeSearchHitForAgent(hit))
         : registryHits.map((hit) => shapeSearchHit(hit, detail));
+    const searchMode = typeof result.searchMode === "string" ? result.searchMode : undefined;
+    const warnings = Array.isArray(result.warnings) && result.warnings.length > 0 ? result.warnings : undefined;
     if (forAgent) {
         return {
             hits: shapedHits,
             ...(shapedRegistryHits.length > 0 ? { registryHits: shapedRegistryHits } : {}),
+            ...(searchMode ? { searchMode } : {}),
+            ...(warnings ? { warnings } : {}),
             ...(result.tip ? { tip: result.tip } : {}),
         };
     }
@@ -200,14 +206,16 @@ export function shapeSearchOutput(result, detail, shape = "human") {
             hits: shapedHits,
             ...(shapedRegistryHits.length > 0 ? { registryHits: shapedRegistryHits } : {}),
             ...(result.tip ? { tip: result.tip } : {}),
-            ...(result.warnings ? { warnings: result.warnings } : {}),
+            ...(searchMode ? { searchMode } : {}),
+            ...(warnings ? { warnings } : {}),
             ...(result.timing ? { timing: result.timing } : {}),
         };
     }
     return {
         hits: shapedHits,
         ...(shapedRegistryHits.length > 0 ? { registryHits: shapedRegistryHits } : {}),
-        ...(Array.isArray(result.warnings) && result.warnings.length > 0 ? { warnings: result.warnings } : {}),
+        ...(searchMode ? { searchMode } : {}),
+        ...(warnings ? { warnings } : {}),
         ...(result.tip ? { tip: result.tip } : {}),
     };
 }

package/dist/output/shapes/passthrough.js

@@ -24,6 +24,7 @@ const PASSTHROUGH_COMMANDS = [
     "bundle-create",
     "bundle-show",
     "clone",
+    "command-dry-run",
     "config",
     "env-create",
     "env-export",
@@ -37,6 +38,7 @@ const PASSTHROUGH_COMMANDS = [
     "info",
     "lint",
     "list",
+    "models",
     "proposal-accept-batch",
     "proposal-drain",
     "proposal-reject-batch",

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

@@ -2,21 +2,20 @@
 // 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/.
 /**
- * `akm info`'s real result (`InfoResponse`, `src/sources/types.ts`) carries
- * `defaultBundle`/`assetTypes`/`searchModes`/`semanticSearch`/`registries`/
- * `sourceProviders`/`indexStats` — this formatter used to check for
- * `configPath`/`cacheDir`/`dbPath`/`capabilities`/`index` instead, none of
- * which `InfoResponse` has ever had, so every one of those `if` guards was
- * always false and those five real fields silently never appeared in
- * `--format text` output (the plain fallthrough JSON check three lines below
- * papered over it: `lines` was never empty because `version`/`bundleDir`
- * always matched, so the "render everything" escape hatch never fired
- * either — same class of bug as `akm health`/`akm lint`'s raw-JSON-array
- * dump: `--format text` claiming to render a shape it wasn't actually
- * rendering). The legacy field checks stay (harmless no-ops on the current
- * shape) in case another producer still emits them; the real fields are
- * added alongside.
+ * Plain-text renderers for the remaining leaf `akm` commands: info/config/
+ * feedback/remember/import/save/enable/disable, registry, env, wiki,
+ * events/history, search/curate, and the stash-lifecycle verbs (init,
+ * index, list, add, remove, update, upgrade, clone).
+ *
+ * Split out of `helpers.ts` (formerly 1418 lines / 59 fns) as its own
+ * sibling module: unlike `show`/`workflow`/`proposal` (each a stateful,
+ * multi-branch renderer with its own module), these are flat
+ * field-extraction formatters with no shared state beyond
+ * `formatRegistrySearchPlain` delegating to `formatSearchPlain` in this
+ * same file.
  */
+import { formatRegistryUrl } from "../../core/registry-url.js";
+/** Render the current `InfoResponse` shape. */
 export function formatInfoPlain(r) {
     const lines = [];
     if (r.version)
@@ -26,12 +25,6 @@ export function formatInfoPlain(r) {
     if (r.defaultBundle !== undefined) {
         lines.push(`defaultBundle: ${r.defaultBundle === null ? "(none)" : String(r.defaultBundle)}`);
     }
-    if (r.configPath)
-        lines.push(`configPath: ${String(r.configPath)}`);
-    if (r.cacheDir)
-        lines.push(`cacheDir: ${String(r.cacheDir)}`);
-    if (r.dbPath)
-        lines.push(`dbPath: ${String(r.dbPath)}`);
     if (Array.isArray(r.assetTypes) && r.assetTypes.length > 0) {
         lines.push(`assetTypes: ${r.assetTypes.join(", ")}`);
     }
@@ -52,7 +45,8 @@ export function formatInfoPlain(r) {
             const name = typeof reg.name === "string" ? `${reg.name}: ` : "";
             const provider = typeof reg.provider === "string" ? ` (${reg.provider})` : "";
             const disabled = reg.enabled === false ? " [disabled]" : "";
-            lines.push(`  ${name}${String(reg.url ?? "?")}${provider}${disabled}`);
+            const url = typeof reg.url === "string" ? formatRegistryUrl(reg.url) : "?";
+            lines.push(`  ${name}${url}${provider}${disabled}`);
         }
     }
     const sourceProviders = Array.isArray(r.sourceProviders)
@@ -66,14 +60,7 @@ export function formatInfoPlain(r) {
             lines.push(`  [${String(source.type ?? "?")}] ${String(label)}${disabled}`);
         }
     }
-    const capabilities = r.capabilities;
-    if (capabilities) {
-        lines.push("capabilities:");
-        for (const [k, v] of Object.entries(capabilities)) {
-            lines.push(`  ${k}: ${typeof v === "object" && v !== null ? JSON.stringify(v) : String(v)}`);
-        }
-    }
-    const indexStats = (r.indexStats ?? r.index);
+    const indexStats = r.indexStats;
     if (indexStats) {
         lines.push("indexStats:");
         for (const [k, v] of Object.entries(indexStats)) {
@@ -101,7 +88,8 @@ export function formatConfigPlain(r) {
                 walk(v, path);
             }
             else {
-                lines.push(`${path}=${String(v)}`);
+                const rendered = typeof v === "string" && /^registries\.\d+\.url$/u.test(path) ? formatRegistryUrl(v) : String(v);
+                lines.push(`${path}=${rendered}`);
             }
         }
     };
@@ -148,7 +136,7 @@ export function formatRegistryListPlain(r) {
     }
     const lines = [];
     for (const reg of registries) {
-        const url = String(reg.url ?? "?");
+        const url = typeof reg.url === "string" ? formatRegistryUrl(reg.url) : "?";
         const name = typeof reg.name === "string" ? reg.name : "";
         const provider = typeof reg.provider === "string" ? ` (${reg.provider})` : "";
         const enabled = reg.enabled === false ? " [disabled]" : "";
@@ -169,7 +157,7 @@ export function formatRegistryRemovePlain(r) {
         return typeof r.message === "string" ? r.message : "No matching registry found.";
     }
     const entry = r.entry;
-    const url = entry ? String(entry.url ?? entry.name ?? "?") : "?";
+    const url = entry ? (typeof entry.url === "string" ? formatRegistryUrl(entry.url) : String(entry.name ?? "?")) : "?";
     return `Removed registry ${url}`;
 }
 export function formatRegistrySearchPlain(r, detail) {
@@ -437,6 +425,14 @@ export function formatIndexPlain(r) {
         for (const message of warnings)
             out += `\n  - ${String(message)}`;
     }
+    const notices = Array.isArray(indexResult.notices) ? indexResult.notices : [];
+    for (const notice of notices) {
+        const severity = notice.severity === "info" ? "info" : "warning";
+        const field = typeof notice.field === "string" ? ` field=${notice.field}` : "";
+        out +=
+            `\n  notice[${severity}] ${notice.code} adapter=${notice.adapter}${field}` +
+                (notice.message ? `: ${notice.message}` : "");
+    }
     const verification = indexResult.verification;
     if (verification?.ok === false && verification.message) {
         out += `\nVerification: ${String(verification.message)}`;
@@ -586,7 +582,9 @@ export function formatUpdatePlain(r) {
         }
     }
     for (const item of plainSynced ?? []) {
-        lines.push(`update: ${item.id} synced (${item.kind})`);
+        lines.push(item.kind === "filesystem"
+            ? `update: ${item.id} reconciled (filesystem)`
+            : `update: ${item.id} synced (${item.kind})`);
     }
     for (const item of skipped ?? []) {
         lines.push(`update: ${item.id} skipped — ${item.reason}`);

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

@@ -39,30 +39,8 @@ function renderCheckSection(title, checks, detail) {
     const header = `${title} (${checks.length}${summary ? ` — ${summary}` : ""})`;
     return [header, ...renderStatusEntries(checks.map((check) => checkStatusEntry(check, detail)))];
 }
-function sessionAdvisoryEntry(advisory) {
-    const isFailure = advisory.isFailurePattern === true;
-    return {
-        severityRank: isFailure ? 0 : 1,
-        glyph: (isFailure ? STATUS_GLYPH.warn : STATUS_GLYPH.pass) ?? "?",
-        headline: `${advisory.topic ?? "?"}  (x${advisory.frequency ?? 0}, source: ${advisory.source ?? "?"})`,
-    };
-}
-function renderSessionLogAdvisories(advisories) {
-    if (advisories.length === 0)
-        return [];
-    return [`sessionLogAdvisories (${advisories.length})`, ...renderStatusEntries(advisories.map(sessionAdvisoryEntry))];
-}
 /** Fields already rendered explicitly above — everything else in `r` falls to the `flattenForText` sweep below. */
-const HANDLED_KEYS = new Set([
-    "ok",
-    "status",
-    "since",
-    "hardChecks",
-    "advisories",
-    "sessionLogAdvisories",
-    "shape",
-    "schemaVersion",
-]);
+const HANDLED_KEYS = new Set(["ok", "status", "since", "hardChecks", "advisories", "shape", "schemaVersion"]);
 export function formatHealthPlain(r, detail) {
     if (r === null || typeof r !== "object")
         return null;
@@ -75,14 +53,8 @@ export function formatHealthPlain(r, detail) {
         lines.push(`since: ${r.since}`);
     const hardChecks = Array.isArray(r.hardChecks) ? r.hardChecks : [];
     const advisories = Array.isArray(r.advisories) ? r.advisories : [];
-    const sessionLogAdvisories = Array.isArray(r.sessionLogAdvisories)
-        ? r.sessionLogAdvisories
-        : [];
     lines.push("", ...renderCheckSection("hardChecks", hardChecks, detail));
     lines.push("", ...renderCheckSection("advisories", advisories, detail));
-    const sessionLines = renderSessionLogAdvisories(sessionLogAdvisories);
-    if (sessionLines.length > 0)
-        lines.push("", ...sessionLines);
     if (detail === "brief" &&
         [...hardChecks, ...advisories].some((c) => c.evidence && Object.keys(c.evidence).length > 0)) {
         lines.push("", "(evidence omitted at --detail brief; re-run with --detail normal or --detail full to see it)");

package/dist/output/text/migrate.js

@@ -1,37 +1,12 @@
 // 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 { renderStatusEntries } from "./status-list.js";
-const ARTIFACT_ORDER = ["config", "state", "workflow", "index"];
-const ARTIFACT_LABEL = {
-    config: "config.json",
-    state: "state.db",
-    workflow: "workflow.db",
-    index: "index.db",
-};
-/** Lower rank sorts first (worse-first) via `renderStatusEntries`. */
-function artifactSeverity(status) {
-    switch (status) {
-        case "corrupt":
-        case "inconsistent":
-        case "newer":
-            return { rank: 0, glyph: "✗" };
-        case "old":
-            return { rank: 1, glyph: "⚠" };
-        case "missing":
-            return { rank: 2, glyph: "?" };
-        default: // "current"
-            return { rank: 3, glyph: "✓" };
-    }
-}
 function planGlyph(status) {
     switch (status) {
         case "current":
             return "✓";
         case "ready":
             return "⚠";
-        case "not-applicable":
-            return "·";
         default: // "blocked"
             return "✗";
     }
@@ -43,43 +18,18 @@ export function formatMigratePlain(result) {
     if (typeof plan.status !== "string")
         return null;
     const lines = [`${planGlyph(plan.status)} ${plan.status}`];
-    if (plan.message)
-        lines.push(`    ${plan.message}`);
-    if (plan.activeOperation) {
-        lines.push(`    in-flight ${plan.activeOperation.kind} at ${plan.activeOperation.sentinelPath}`);
-    }
-    if (plan.artifacts) {
-        const entries = ARTIFACT_ORDER.filter((name) => plan.artifacts?.[name]).map((name) => {
-            const artifact = plan.artifacts?.[name];
-            const { rank, glyph } = artifactSeverity(artifact.status);
-            const detailLines = [];
-            if (artifact.detail)
-                detailLines.push(artifact.detail);
-            if (artifact.migrationIds?.length)
-                detailLines.push(`migrations applied: ${artifact.migrationIds.length}`);
-            return { severityRank: rank, glyph, headline: `${ARTIFACT_LABEL[name]}: ${artifact.status}`, detailLines };
-        });
-        lines.push("", "artifacts:", ...renderStatusEntries(entries).map((line) => `  ${line}`));
-    }
-    if (plan.targetConfig) {
-        const target = plan.targetConfig;
-        lines.push("", `target config: ${target.status} (source: ${target.source}${target.path ? `, ${target.path}` : ""})`);
-        if (target.detail)
-            lines.push(`  ${target.detail}`);
-    }
-    if (plan.generatedConfig) {
-        const generated = plan.generatedConfig;
-        lines.push("", `generated config: ${generated.status} at ${generated.path}`);
-        if (generated.droppedKeys.length > 0) {
-            lines.push(`  drops (add engines/defaults yourself if needed): ${generated.droppedKeys.join(", ")}`);
-        }
+    if (plan.taskV3Migration) {
+        const tasks = plan.taskV3Migration;
+        lines.push(`    tasks: ${tasks.changed} change, ${tasks.skipped} current, ${tasks.blocked} blocked`);
     }
     if (plan.blockers?.length) {
         lines.push("", "blockers:", ...plan.blockers.map((blocker) => `  - ${blocker}`));
     }
     if (plan.backupPath) {
-        lines.push("", `backup: ${plan.backupPath}${plan.backupRunId ? ` (run ${plan.backupRunId})` : ""}`);
+        lines.push("", `backup: ${plan.backupPath}`);
     }
+    if (plan.applied !== undefined)
+        lines.push(`applied: ${plan.applied}`);
     return lines.join("\n");
 }
 export const migrateFormatters = [

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

@@ -10,6 +10,17 @@
  * plain-text renderer, `formatDistillPlain`, was dead code; removed per
  * R-063/B5.)
  */
+function appendLoweringNotices(lines, result) {
+    const notices = Array.isArray(result.notices) ? result.notices : [];
+    for (const notice of notices) {
+        const severity = notice.severity === "info" ? "info" : "warning";
+        const code = typeof notice.code === "string" ? notice.code : "lowering-notice";
+        const adapter = typeof notice.adapter === "string" ? ` adapter=${notice.adapter}` : "";
+        const field = typeof notice.field === "string" ? ` field=${notice.field}` : "";
+        const message = typeof notice.message === "string" ? `: ${notice.message}` : "";
+        lines.push(`  notice[${severity}] ${code}${adapter}${field}${message}`);
+    }
+}
 export function formatProposalProducerPlain(command, r) {
     if (r.ok === false) {
         const reason = String(r.reason);
@@ -22,13 +33,16 @@ export function formatProposalProducerPlain(command, r) {
         if (r.exitCode !== undefined && r.exitCode !== null) {
             lines.push(`  exitCode: ${String(r.exitCode)}`);
         }
+        appendLoweringNotices(lines, r);
         return lines.join("\n");
     }
     const proposal = r.proposal;
     const id = String(proposal.id);
     const ref = String(r.ref);
     const status = String(proposal.status);
-    return `${command}: queued proposal ${id} (${ref}) [${status}]`;
+    const lines = [`${command}: queued proposal ${id} (${ref}) [${status}]`];
+    appendLoweringNotices(lines, r);
+    return lines.join("\n");
 }
 /**
  * Render a one-line gate-decision summary for the proposal list / show surfaces
@@ -189,6 +203,7 @@ export function formatProposalDrainPlain(r) {
     for (const d of deferred) {
         lines.push(`    - ${String(d.id ?? "?")} (${String(d.reason ?? "?")})`);
     }
+    appendLoweringNotices(lines, r);
     return lines.join("\n").trimEnd();
 }
 export function formatProposalDiffPlain(r) {

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

@@ -118,6 +118,22 @@ export function formatWorkflowRunPlain(result) {
     // hide the announcement from the DEFAULT output mode — where it matters most.
     for (const warning of Array.isArray(result.warnings) ? result.warnings : [])
         lines.push(`! ${String(warning)}`);
+    // Live-only common-lowerer diagnostics are already sanitized and deduped by
+    // the workflow engine. Render their typed headline (not opaque details) so
+    // default text output has the same observability as JSON without widening a
+    // durable workflow schema.
+    for (const value of Array.isArray(result.notices) ? result.notices : []) {
+        if (typeof value !== "object" || value === null)
+            continue;
+        const notice = value;
+        if (typeof notice.code !== "string" ||
+            typeof notice.severity !== "string" ||
+            typeof notice.adapter !== "string" ||
+            typeof notice.message !== "string")
+            continue;
+        const field = typeof notice.field === "string" && notice.field ? `; ${notice.field}` : "";
+        lines.push(`! lowering[${notice.severity}] ${notice.code} (${notice.adapter}${field}): ${notice.message}`);
+    }
     const executed = Array.isArray(result.executed) ? result.executed : [];
     if (executed.length === 0) {
         lines.push("executed: (no steps — run was already done or blocked)");