akm-cli 0.5.0 → 0.6.0-rc2

package/dist/output/text.js

@@ -0,0 +1,520 @@
+/**
+ * Plain-text formatters for command output. Each top-level `formatPlain`
+ * branch dispatches to a small per-command helper. Returning `null` means
+ * "no plain rendering available — fall back to YAML".
+ *
+ * Pure functions — no IO.
+ */
+import { formatInstallAuditSummary } from "../commands/install-audit";
+export function outputJsonl(command, shaped) {
+    if (command === "search" || command === "registry-search") {
+        const r = shaped;
+        const hits = Array.isArray(r.hits) ? r.hits : [];
+        for (const hit of hits) {
+            console.log(JSON.stringify(hit));
+        }
+        const registryHits = Array.isArray(r.registryHits) ? r.registryHits : [];
+        for (const hit of registryHits) {
+            console.log(JSON.stringify(hit));
+        }
+        return;
+    }
+    // For non-search commands, output the whole object as a single JSONL line
+    console.log(JSON.stringify(shaped));
+}
+/**
+ * Return a plain-text string for commands that are better as short messages,
+ * or null to fall through to YAML output.
+ */
+export function formatPlain(command, result, detail) {
+    const r = result;
+    switch (command) {
+        case "init": {
+            let out = `Stash initialized at ${r.stashDir ?? "unknown"}`;
+            if (r.configPath)
+                out += `\nConfig saved to ${r.configPath}`;
+            return out;
+        }
+        case "index": {
+            const indexResult = result;
+            let out = `Indexed ${indexResult.totalEntries ?? 0} entries from ${indexResult.directoriesScanned ?? 0} directories (mode: ${indexResult.mode ?? "unknown"})`;
+            const warnings = indexResult.warnings;
+            if (Array.isArray(warnings) && warnings.length > 0) {
+                out += `\nWarnings (${warnings.length}):`;
+                for (const message of warnings)
+                    out += `\n  - ${String(message)}`;
+            }
+            const verification = indexResult.verification;
+            if (verification?.ok === false && verification.message) {
+                out += `\nVerification: ${String(verification.message)}`;
+            }
+            return out;
+        }
+        case "show": {
+            return formatShowPlain(r, detail);
+        }
+        case "search": {
+            return formatSearchPlain(r, detail);
+        }
+        case "curate": {
+            return formatCuratePlain(r, detail);
+        }
+        case "wiki-list": {
+            return formatWikiListPlain(r);
+        }
+        case "wiki-show": {
+            return formatWikiShowPlain(r);
+        }
+        case "wiki-create": {
+            return formatWikiCreatePlain(r);
+        }
+        case "wiki-remove": {
+            return formatWikiRemovePlain(r);
+        }
+        case "wiki-pages": {
+            return formatWikiPagesPlain(r);
+        }
+        case "wiki-stash": {
+            return formatWikiStashPlain(r);
+        }
+        case "wiki-lint": {
+            return formatWikiLintPlain(r);
+        }
+        case "wiki-ingest": {
+            return formatWikiIngestPlain(r);
+        }
+        case "workflow-start":
+        case "workflow-status":
+        case "workflow-complete": {
+            return formatWorkflowStatusPlain(r);
+        }
+        case "workflow-next": {
+            return formatWorkflowNextPlain(r);
+        }
+        case "workflow-list": {
+            return formatWorkflowListPlain(r);
+        }
+        case "workflow-create": {
+            if (r.ref && r.path) {
+                return `Created ${String(r.ref)} at ${String(r.path)}`;
+            }
+            return null;
+        }
+        case "list": {
+            const sources = Array.isArray(r.sources) ? r.sources : [];
+            if (sources.length === 0)
+                return "No sources configured. Use `akm add` to add a source.";
+            const lines = [];
+            for (const src of sources) {
+                const kind = typeof src.kind === "string" ? src.kind : "unknown";
+                const name = typeof src.name === "string" ? src.name : "unnamed";
+                const ver = typeof src.version === "string" ? ` v${src.version}` : "";
+                const prov = typeof src.provider === "string" ? ` (${src.provider})` : "";
+                const flags = [];
+                if (typeof src.wiki === "string")
+                    flags.push(`wiki:${src.wiki}`);
+                if (src.updatable === true)
+                    flags.push("updatable");
+                if (src.writable === true)
+                    flags.push("writable");
+                const flagText = flags.length > 0 ? ` [${flags.join(", ")}]` : "";
+                lines.push(`[${kind}] ${name}${ver}${prov}${flagText}`);
+            }
+            return lines.join("\n");
+        }
+        case "add": {
+            const index = r.index;
+            const scanned = index?.directoriesScanned ?? 0;
+            const total = index?.totalEntries ?? 0;
+            const lines = [`Installed ${r.ref} (${scanned} directories scanned, ${total} total assets indexed)`];
+            const warnings = index?.warnings;
+            if (Array.isArray(warnings) && warnings.length > 0) {
+                lines.push(`Warnings (${warnings.length}):`);
+                for (const message of warnings)
+                    lines.push(`  - ${String(message)}`);
+            }
+            const installed = r.installed;
+            const audit = installed?.audit;
+            if (audit && typeof audit === "object") {
+                lines.push(formatInstallAuditSummary(audit));
+            }
+            return lines.join("\n");
+        }
+        case "remove": {
+            const target = r.target ?? r.ref ?? "";
+            const ok = r.ok !== false ? "OK" : "FAILED";
+            return `remove: ${target} ${ok}`;
+        }
+        case "update": {
+            const processed = r.processed;
+            if (!processed?.length)
+                return `update: nothing to update`;
+            const lines = processed.map((item) => {
+                const changed = item.changed;
+                const installed = item.installed;
+                const previous = item.previous;
+                if (changed?.any) {
+                    const prev = previous?.resolvedVersion ?? "unknown";
+                    const next = installed?.resolvedVersion ?? "unknown";
+                    return `update: ${item.id} v${prev} → v${next}`;
+                }
+                return `update: ${item.id} (unchanged)`;
+            });
+            return lines.join("\n");
+        }
+        case "upgrade": {
+            if (r.upgraded === true) {
+                return `akm upgraded: v${r.currentVersion} → v${r.newVersion}`;
+            }
+            if (r.updateAvailable === true) {
+                return `akm v${r.currentVersion} → v${r.latestVersion} available (run 'akm upgrade' to install)`;
+            }
+            if (r.updateAvailable === false && r.latestVersion) {
+                return `akm v${r.currentVersion} is already the latest version`;
+            }
+            if (r.message)
+                return String(r.message);
+            return null;
+        }
+        case "clone": {
+            const dst = r.destination?.path ?? "unknown";
+            const remote = r.remoteFetched ? " (fetched from remote)" : "";
+            const over = r.overwritten ? " (overwritten)" : "";
+            return `Cloned${remote} → ${dst}${over}`;
+        }
+        default:
+            return null; // fall through to YAML
+    }
+}
+function formatShowPlain(r, detail) {
+    const lines = [];
+    if (r.type || r.name) {
+        lines.push(`# ${String(r.type ?? "asset")}: ${String(r.name ?? "unknown")}`);
+    }
+    if (r.origin !== undefined)
+        lines.push(`# origin: ${String(r.origin)}`);
+    if (r.action)
+        lines.push(`# ${String(r.action)}`);
+    if (r.description)
+        lines.push(`description: ${String(r.description)}`);
+    if (r.workflowTitle)
+        lines.push(`workflowTitle: ${String(r.workflowTitle)}`);
+    if (r.agent)
+        lines.push(`agent: ${String(r.agent)}`);
+    if (Array.isArray(r.parameters) && r.parameters.length > 0)
+        lines.push(`parameters: ${r.parameters.join(", ")}`);
+    if (Array.isArray(r.workflowParameters) && r.workflowParameters.length > 0) {
+        lines.push("workflowParameters:");
+        for (const parameter of r.workflowParameters) {
+            const name = typeof parameter.name === "string" ? parameter.name : "unknown";
+            const description = typeof parameter.description === "string" && parameter.description.trim() ? `: ${parameter.description}` : "";
+            lines.push(`  - ${name}${description}`);
+        }
+    }
+    if (r.modelHint != null)
+        lines.push(`modelHint: ${String(r.modelHint)}`);
+    if (r.toolPolicy != null)
+        lines.push(`toolPolicy: ${JSON.stringify(r.toolPolicy)}`);
+    if (r.run)
+        lines.push(`run: ${String(r.run)}`);
+    if (r.setup)
+        lines.push(`setup: ${String(r.setup)}`);
+    if (r.cwd)
+        lines.push(`cwd: ${String(r.cwd)}`);
+    if (detail === "full") {
+        if (r.path)
+            lines.push(`path: ${String(r.path)}`);
+        if (r.editable !== undefined)
+            lines.push(`editable: ${String(r.editable)}`);
+        if (r.editHint)
+            lines.push(`editHint: ${String(r.editHint)}`);
+        if (r.schemaVersion !== undefined)
+            lines.push(`schemaVersion: ${String(r.schemaVersion)}`);
+    }
+    const payloads = [r.content, r.template, r.prompt].filter((value) => value != null).map(String);
+    if (Array.isArray(r.steps) && r.steps.length > 0) {
+        if (lines.length > 0)
+            lines.push("");
+        lines.push("steps:");
+        for (const [index, step] of r.steps.entries()) {
+            const title = typeof step.title === "string" ? step.title : "Untitled step";
+            const id = typeof step.id === "string" ? step.id : "unknown";
+            lines.push(`  ${index + 1}. ${title} [${id}]`);
+            if (typeof step.instructions === "string" && step.instructions.trim()) {
+                lines.push(`     instructions: ${step.instructions.replace(/\n+/g, " ").trim()}`);
+            }
+            if (Array.isArray(step.completionCriteria) && step.completionCriteria.length > 0) {
+                lines.push("     completion:");
+                for (const criterion of step.completionCriteria) {
+                    lines.push(`       - ${String(criterion)}`);
+                }
+            }
+        }
+    }
+    if (payloads.length > 0) {
+        if (lines.length > 0)
+            lines.push("");
+        lines.push(...payloads);
+    }
+    return lines.length > 0 ? lines.join("\n") : null;
+}
+export function formatWorkflowListPlain(result) {
+    const runs = Array.isArray(result.runs) ? result.runs : [];
+    if (runs.length === 0)
+        return "No workflow runs found.";
+    return runs
+        .map((run) => {
+        const id = typeof run.id === "string" ? run.id : "unknown";
+        const ref = typeof run.workflowRef === "string" ? run.workflowRef : "workflow:unknown";
+        const status = typeof run.status === "string" ? run.status : "unknown";
+        const currentStep = typeof run.currentStepId === "string" ? ` (current: ${run.currentStepId})` : "";
+        return `${id} ${ref} [${status}]${currentStep}`;
+    })
+        .join("\n");
+}
+export function formatWorkflowStatusPlain(result) {
+    const run = typeof result.run === "object" && result.run !== null ? result.run : undefined;
+    const workflow = typeof result.workflow === "object" && result.workflow !== null
+        ? result.workflow
+        : undefined;
+    if (!run || !workflow)
+        return null;
+    const lines = [
+        `workflow: ${String(workflow.ref ?? "workflow:unknown")}`,
+        `run: ${String(run.id ?? "unknown")}`,
+        `title: ${String(run.workflowTitle ?? workflow.title ?? "Workflow")}`,
+        `status: ${String(run.status ?? "unknown")}`,
+    ];
+    if (run.currentStepId)
+        lines.push(`currentStep: ${String(run.currentStepId)}`);
+    const steps = Array.isArray(workflow.steps) ? workflow.steps : [];
+    if (steps.length > 0) {
+        lines.push("steps:");
+        for (const step of steps) {
+            const title = typeof step.title === "string" ? step.title : "Untitled step";
+            const id = typeof step.id === "string" ? step.id : "unknown";
+            const status = typeof step.status === "string" ? step.status : "unknown";
+            lines.push(`  - ${title} [${id}] (${status})`);
+            if (typeof step.notes === "string" && step.notes.trim()) {
+                lines.push(`    notes: ${step.notes}`);
+            }
+        }
+    }
+    return lines.join("\n");
+}
+export function formatWorkflowNextPlain(result) {
+    const base = formatWorkflowStatusPlain(result);
+    const step = typeof result.step === "object" && result.step !== null ? result.step : undefined;
+    if (!step)
+        return base;
+    const lines = base ? [base, "", "next:"] : ["next:"];
+    lines.push(`  ${String(step.title ?? "Untitled step")} [${String(step.id ?? "unknown")}]`);
+    if (typeof step.instructions === "string" && step.instructions.trim()) {
+        lines.push(`  instructions: ${step.instructions.replace(/\n+/g, " ").trim()}`);
+    }
+    const completion = Array.isArray(step.completionCriteria) ? step.completionCriteria : [];
+    if (completion.length > 0) {
+        lines.push("  completion:");
+        for (const criterion of completion) {
+            lines.push(`    - ${String(criterion)}`);
+        }
+    }
+    return lines.join("\n");
+}
+export function formatSearchPlain(r, detail) {
+    const hits = r.hits ?? [];
+    const registryHits = r.registryHits ?? [];
+    const allHits = [...hits, ...registryHits];
+    if (allHits.length === 0) {
+        return r.tip ? String(r.tip) : "No results found.";
+    }
+    const lines = [];
+    for (const hit of allHits) {
+        const type = hit.type ?? "unknown";
+        const name = hit.name ?? "unnamed";
+        const score = hit.score != null ? ` (score: ${hit.score})` : "";
+        const desc = hit.description ? `  ${hit.description}` : "";
+        lines.push(`${type}: ${name}${score}`);
+        if (desc)
+            lines.push(desc);
+        if (hit.id)
+            lines.push(`  id: ${String(hit.id)}`);
+        if (hit.ref)
+            lines.push(`  ref: ${String(hit.ref)}`);
+        if (hit.origin !== undefined)
+            lines.push(`  origin: ${String(hit.origin)}`);
+        if (hit.size)
+            lines.push(`  size: ${String(hit.size)}`);
+        if (hit.action)
+            lines.push(`  action: ${String(hit.action)}`);
+        if (hit.run)
+            lines.push(`  run: ${String(hit.run)}`);
+        if (Array.isArray(hit.tags) && hit.tags.length > 0)
+            lines.push(`  tags: ${hit.tags.join(", ")}`);
+        if (hit.curated !== undefined)
+            lines.push(`  curated: ${String(hit.curated)}`);
+        if (detail === "full") {
+            if (hit.path)
+                lines.push(`  path: ${String(hit.path)}`);
+            if (hit.editable != null)
+                lines.push(`  editable: ${String(hit.editable)}`);
+            if (hit.editHint)
+                lines.push(`  editHint: ${String(hit.editHint)}`);
+            const whyMatched = hit.whyMatched;
+            if (whyMatched && whyMatched.length > 0) {
+                lines.push(`  whyMatched: ${whyMatched.join(", ")}`);
+            }
+        }
+        lines.push(""); // blank line between hits
+    }
+    if (detail === "full" && r.timing) {
+        const timing = r.timing;
+        const parts = [];
+        if (timing.totalMs != null)
+            parts.push(`total: ${timing.totalMs}ms`);
+        if (timing.rankMs != null)
+            parts.push(`rank: ${timing.rankMs}ms`);
+        if (timing.embedMs != null)
+            parts.push(`embed: ${timing.embedMs}ms`);
+        if (parts.length > 0)
+            lines.push(`timing: ${parts.join(", ")}`);
+    }
+    return lines.join("\n").trimEnd();
+}
+export function formatWikiListPlain(r) {
+    const wikis = Array.isArray(r.wikis) ? r.wikis : [];
+    if (wikis.length === 0)
+        return "No wikis. Create one with `akm wiki create <name>` or register one with `akm wiki register <name> <path-or-repo>`.";
+    const lines = ["NAME\tPAGES\tRAWS\tLAST-MODIFIED"];
+    for (const w of wikis) {
+        const name = typeof w.name === "string" ? w.name : "?";
+        const pages = typeof w.pages === "number" ? w.pages : 0;
+        const raws = typeof w.raws === "number" ? w.raws : 0;
+        const modified = typeof w.lastModified === "string" ? w.lastModified : "-";
+        lines.push(`${name}\t${pages}\t${raws}\t${modified}`);
+    }
+    return lines.join("\n");
+}
+export function formatWikiShowPlain(r) {
+    const lines = [];
+    if (r.name)
+        lines.push(`# wiki: ${String(r.name)}`);
+    if (r.path)
+        lines.push(`path: ${String(r.path)}`);
+    if (r.description)
+        lines.push(`description: ${String(r.description)}`);
+    if (typeof r.pages === "number")
+        lines.push(`pages: ${r.pages}`);
+    if (typeof r.raws === "number")
+        lines.push(`raws: ${r.raws}`);
+    if (r.lastModified)
+        lines.push(`lastModified: ${String(r.lastModified)}`);
+    const recentLog = Array.isArray(r.recentLog) ? r.recentLog : [];
+    if (recentLog.length > 0) {
+        lines.push("", "recent log:");
+        for (const entry of recentLog) {
+            lines.push(entry);
+            lines.push("");
+        }
+    }
+    return lines.join("\n").trimEnd();
+}
+export function formatWikiCreatePlain(r) {
+    const created = Array.isArray(r.created) ? r.created : [];
+    const skipped = Array.isArray(r.skipped) ? r.skipped : [];
+    const lines = [`Created wiki ${String(r.ref ?? r.name)} at ${String(r.path ?? "?")}`];
+    if (created.length > 0)
+        lines.push(`  created: ${created.length} file(s)`);
+    if (skipped.length > 0)
+        lines.push(`  skipped: ${skipped.length} existing file(s)`);
+    return lines.join("\n");
+}
+export function formatWikiRemovePlain(r) {
+    const preserved = r.preservedRaw === true;
+    const removed = Array.isArray(r.removed) ? r.removed.length : 0;
+    const base = `Removed wiki ${String(r.name ?? "?")} (${removed} path(s))`;
+    return preserved ? `${base}; preserved ${String(r.rawPath ?? "raw/")}` : base;
+}
+export function formatWikiPagesPlain(r) {
+    const pages = Array.isArray(r.pages) ? r.pages : [];
+    if (pages.length === 0)
+        return `No pages in wiki:${String(r.wiki ?? "?")}.`;
+    const lines = [];
+    for (const p of pages) {
+        const ref = String(p.ref ?? "?");
+        const kind = typeof p.pageKind === "string" ? ` [${p.pageKind}]` : "";
+        const desc = typeof p.description === "string" && p.description ? ` — ${p.description}` : "";
+        lines.push(`${ref}${kind}${desc}`);
+    }
+    return lines.join("\n");
+}
+export function formatWikiStashPlain(r) {
+    const slug = String(r.slug ?? "?");
+    const pathValue = String(r.path ?? "?");
+    return `Stashed ${slug} → ${pathValue}`;
+}
+export function formatWikiLintPlain(r) {
+    const findings = Array.isArray(r.findings) ? r.findings : [];
+    const pagesScanned = typeof r.pagesScanned === "number" ? r.pagesScanned : 0;
+    const rawsScanned = typeof r.rawsScanned === "number" ? r.rawsScanned : 0;
+    const header = `${findings.length} finding(s) in wiki:${String(r.wiki ?? "?")} (${pagesScanned} page(s), ${rawsScanned} raw(s))`;
+    if (findings.length === 0)
+        return `${header} — clean.`;
+    const lines = [header];
+    for (const f of findings) {
+        const kind = String(f.kind ?? "?");
+        const message = String(f.message ?? "");
+        lines.push(`- [${kind}] ${message}`);
+    }
+    return lines.join("\n");
+}
+export function formatWikiIngestPlain(r) {
+    if (typeof r.workflow === "string")
+        return r.workflow;
+    return JSON.stringify(r, null, 2);
+}
+export function formatCuratePlain(r, detail) {
+    const query = typeof r.query === "string" ? r.query : "";
+    const summary = typeof r.summary === "string" ? r.summary : "";
+    const items = Array.isArray(r.items) ? r.items : [];
+    const lines = [`Curated results for "${query}"`];
+    if (summary)
+        lines.push(summary);
+    if (items.length === 0) {
+        if (r.tip)
+            lines.push(String(r.tip));
+        return lines.join("\n");
+    }
+    for (const item of items) {
+        const type = typeof item.type === "string" ? item.type : "unknown";
+        const name = typeof item.name === "string" ? item.name : "unnamed";
+        lines.push("");
+        lines.push(`[${type}] ${name}`);
+        if (item.description)
+            lines.push(`  ${String(item.description)}`);
+        if (item.preview)
+            lines.push(`  preview: ${String(item.preview)}`);
+        if (item.ref)
+            lines.push(`  ref: ${String(item.ref)}`);
+        if (item.id)
+            lines.push(`  id: ${String(item.id)}`);
+        if (Array.isArray(item.parameters) && item.parameters.length > 0) {
+            lines.push(`  parameters: ${item.parameters.join(", ")}`);
+        }
+        if (item.run)
+            lines.push(`  run: ${String(item.run)}`);
+        if (item.followUp)
+            lines.push(`  show: ${String(item.followUp)}`);
+        if (detail !== "brief" && item.reason)
+            lines.push(`  why: ${String(item.reason)}`);
+    }
+    const warnings = Array.isArray(r.warnings) ? r.warnings : [];
+    if (warnings.length > 0) {
+        lines.push("");
+        lines.push("Warnings:");
+        for (const warning of warnings) {
+            lines.push(`- ${String(warning)}`);
+        }
+    }
+    return lines.join("\n");
+}