@cleocode/cleo 2026.5.13 → 2026.5.15

package/dist/cli/index.js

@@ -1976,6 +1976,122 @@ function renderBrainExport(data, quiet) {
   if (quiet) return String(data["outputFile"] ?? "");
   return `${GREEN}Exported to ${data["outputFile"]}:${NC} ${data["nodeCount"]} nodes, ${data["edgeCount"]} edges (${String(data["format"] ?? "").toUpperCase()})`;
 }
+function renderAuditReconstruct(data, quiet) {
+  if (quiet) return "";
+  const taskId = data["taskId"];
+  const directCommits = data["directCommits"] ?? [];
+  const childIdRange = data["childIdRange"];
+  const childCommits = data["childCommits"] ?? {};
+  const releaseTags = data["releaseTags"] ?? [];
+  const inferredChildren = data["inferredChildren"] ?? [];
+  const firstSeenAt = data["firstSeenAt"];
+  const lastSeenAt = data["lastSeenAt"];
+  const lines = [
+    `${BOLD}Lineage for ${taskId ?? "?"}${NC}`,
+    "=".repeat(40),
+    "",
+    `${DIM}Direct commits:${NC} ${directCommits.length}`
+  ];
+  for (const c of directCommits) {
+    const sha = typeof c["sha"] === "string" ? c["sha"].slice(0, 10) : "?";
+    const subject = typeof c["subject"] === "string" ? c["subject"] : "";
+    lines.push(`  ${CYAN}${sha}${NC}  ${subject}`);
+  }
+  lines.push("");
+  if (childIdRange) {
+    lines.push(
+      `${DIM}Inferred children:${NC} ${inferredChildren.join(", ")} (${childIdRange.min} \u2192 ${childIdRange.max})`
+    );
+  } else {
+    lines.push(`${DIM}Inferred children:${NC} none`);
+  }
+  const childEntries = Object.entries(childCommits);
+  if (childEntries.length > 0) {
+    lines.push("");
+    lines.push(`${BOLD}Child commits:${NC}`);
+    for (const [childId, commits] of childEntries) {
+      lines.push(`  ${CYAN}${childId}${NC}: ${commits.length} commit(s)`);
+      for (const c of commits) {
+        const sha = typeof c["sha"] === "string" ? c["sha"].slice(0, 10) : "?";
+        const subject = typeof c["subject"] === "string" ? c["subject"] : "";
+        lines.push(`    ${DIM}${sha}${NC}  ${subject}`);
+      }
+    }
+  }
+  lines.push("");
+  if (releaseTags.length > 0) {
+    lines.push(`${BOLD}Release tags (${releaseTags.length}):${NC}`);
+    for (const t of releaseTags) {
+      const tag = typeof t["tag"] === "string" ? t["tag"] : "?";
+      const sha = typeof t["commitSha"] === "string" ? t["commitSha"].slice(0, 10) : "?";
+      const subject = typeof t["subject"] === "string" ? t["subject"] : "";
+      lines.push(`  ${GREEN}${tag}${NC}  ${DIM}${sha}${NC}  ${subject}`);
+    }
+  } else {
+    lines.push(`${DIM}Release tags:${NC} none found`);
+  }
+  lines.push("");
+  lines.push(`${DIM}First seen:${NC} ${firstSeenAt ?? "n/a"}`);
+  lines.push(`${DIM}Last seen: ${NC} ${lastSeenAt ?? "n/a"}`);
+  return lines.join("\n");
+}
+function renderSchemaCommand(data, quiet) {
+  if (quiet) return "";
+  const lines = [];
+  lines.push(`Operation : ${String(data["operation"] ?? "")}`);
+  lines.push(`Gateway   : ${String(data["gateway"] ?? "")}`);
+  lines.push(`Description: ${String(data["description"] ?? "")}`);
+  lines.push("");
+  const params = data["params"] ?? [];
+  lines.push("Parameters:");
+  if (params.length === 0) {
+    lines.push("  (none declared)");
+  } else {
+    for (const p of params) {
+      const req = p["required"] ? "[required]" : "[optional]";
+      const enumVal = p["enum"];
+      const enumStr = enumVal ? `  enum: ${enumVal.join(" | ")}` : "";
+      const cli = p["cli"];
+      let cliStr = "";
+      if (cli) {
+        const parts = [];
+        if (cli["positional"]) parts.push("positional");
+        if (cli["short"]) parts.push(`short: ${String(cli["short"])}`);
+        if (cli["flag"]) parts.push(`flag: --${String(cli["flag"])}`);
+        if (parts.length > 0) cliStr = `  cli: ${parts.join(", ")}`;
+      }
+      lines.push(`  ${String(p["name"] ?? "")} (${String(p["type"] ?? "")}) ${req}`);
+      lines.push(`    ${String(p["description"] ?? "")}${enumStr}${cliStr}`);
+    }
+  }
+  const gates = data["gates"];
+  if (gates !== void 0) {
+    lines.push("");
+    lines.push("Gates:");
+    if (gates.length === 0) {
+      lines.push("  (none declared \u2014 see note on static gate table)");
+    } else {
+      for (const g of gates) {
+        lines.push(`  ${String(g["name"] ?? "")} \u2192 ${String(g["errorCode"] ?? "")}`);
+        lines.push(`    ${String(g["description"] ?? "")}`);
+        const triggers = g["triggers"] ?? [];
+        for (const t of triggers) {
+          lines.push(`    - ${t}`);
+        }
+      }
+    }
+  }
+  const examples = data["examples"];
+  if (examples !== void 0 && examples.length > 0) {
+    lines.push("");
+    lines.push("Examples:");
+    for (const ex of examples) {
+      lines.push(`  ${String(ex["command"] ?? "")}`);
+      lines.push(`    ${String(ex["description"] ?? "")}`);
+    }
+  }
+  return lines.join("\n");
+}
 function renderGeneric(data, quiet) {
   if (quiet) return "";
   const lines = [];
@@ -2273,6 +2389,21 @@ function renderNexusProjectsClean(data, quiet) {
   }
   return `[nexus] Purged ${purged} project(s). ${remaining} project(s) remaining in registry.`;
 }
+function renderNexusProjectsCleanPreview(data, _quiet) {
+  const matched = Number(data["matched"] ?? 0);
+  const totalCount = Number(data["totalCount"] ?? 0);
+  const samplePaths = data["sample"] ?? [];
+  const lines = [
+    `[nexus] Clean preview \u2014 ${matched} project(s) of ${totalCount} total match criteria:`
+  ];
+  if (matched === 0) {
+    lines.push("  (no matches)");
+  } else {
+    for (const p of samplePaths) lines.push(`  ${p}`);
+    if (matched > 10) lines.push(`  ... and ${matched - 10} more`);
+  }
+  return lines.join("\n");
+}
 function renderNexusRefreshBridge(data, quiet) {
   if (quiet) return "";
   if (data["written"]) {
@@ -2995,7 +3126,7 @@ function cliOutput(data, opts) {
         process.exit(4);
       }
       if (typeof extracted !== "object" || extracted === null) {
-        console.log(String(extracted));
+        process.stdout.write(String(extracted) + "\n");
         return;
       }
       if (Array.isArray(extracted)) {
@@ -3009,7 +3140,7 @@ function cliOutput(data, opts) {
     const renderer = fieldExtracted ? renderGeneric : renderers[opts.command] ?? renderGeneric;
     const text = renderer(normalized, ctx.quiet);
     if (text) {
-      console.log(text);
+      process.stdout.write(text + "\n");
     }
     return;
   }
@@ -3077,14 +3208,16 @@ function cliOutput(data, opts) {
       }
     }
   }
-  console.log(envelopeString);
+  process.stdout.write(envelopeString + "\n");
 }
 function cliError(message, code, details, meta) {
   const ctx = getFormatContext();
   if (ctx.format === "human") {
-    console.error(`Error: ${message}${code ? ` (${code})` : ""}`);
+    process.stderr.write(`Error: ${message}${code ? ` (${code})` : ""}
+`);
     if (typeof details?.fix === "string") {
-      console.error(`Fix: ${details.fix}`);
+      process.stderr.write(`Fix: ${details.fix}
+`);
     }
     return;
   }
@@ -3108,7 +3241,7 @@ function cliError(message, code, details, meta) {
     error: errorObj,
     meta: errorMeta
   };
-  console.log(JSON.stringify(envelope));
+  process.stdout.write(JSON.stringify(envelope) + "\n");
 }
 var renderers;
 var init_renderers = __esm({
@@ -3163,6 +3296,10 @@ var init_renderers = __esm({
       "brain-plasticity-stats": renderBrainPlasticityStats,
       "brain-quality": renderBrainQuality,
       "brain-export": renderBrainExport,
+      // Audit subcommand renderers (T1729)
+      "audit-reconstruct": renderAuditReconstruct,
+      // Schema command renderer (T1729)
+      schema: renderSchemaCommand,
       // Nexus subcommand renderers (T1720)
       "nexus-status": renderNexusStatus,
       "nexus-setup": renderNexusSetup,
@@ -3176,6 +3313,7 @@ var init_renderers = __esm({
       "nexus-projects-remove": renderNexusProjectsRemove,
       "nexus-projects-scan": renderNexusProjectsScan,
       "nexus-projects-clean": renderNexusProjectsClean,
+      "nexus-projects-clean-preview": renderNexusProjectsCleanPreview,
       "nexus-refresh-bridge": renderNexusRefreshBridge,
       "nexus-diff": renderNexusDiff,
       "nexus-query": renderNexusQuery,
@@ -31936,6 +32074,7 @@ var archiveStatsCommand = defineCommand({
 
 // packages/cleo/src/cli/commands/audit.ts
 import { getProjectRoot as getProjectRoot19, reconstructLineage } from "@cleocode/core/internal";
+init_renderers();
 var reconstructCommand = defineCommand({
   meta: {
     name: "reconstruct",
@@ -31960,9 +32099,11 @@ var reconstructCommand = defineCommand({
   async run({ args }) {
     const taskId = args["taskId"];
     if (!taskId || !/^T\d+$/i.test(taskId)) {
-      process.stderr.write(
-        `Error: taskId must match /^T\\d+$/ (e.g. T991). Got: ${JSON.stringify(taskId)}
-`
+      cliError(
+        `taskId must match /^T\\d+$/ (e.g. T991). Got: ${JSON.stringify(taskId)}`,
+        1,
+        { name: "E_VALIDATION" },
+        { operation: "audit.reconstruct" }
       );
       process.exit(1);
     }
@@ -31977,53 +32118,11 @@ var reconstructCommand = defineCommand({
       }
     }
     const result = await reconstructLineage(taskId, repoRoot);
-    if (args["json"]) {
-      process.stdout.write(`${JSON.stringify(result, null, 2)}
-`);
-      return;
-    }
-    const lines = [
-      `Lineage for ${result.taskId}`,
-      `${"=".repeat(40)}`,
-      "",
-      `Direct commits: ${result.directCommits.length}`
-    ];
-    for (const c of result.directCommits) {
-      lines.push(`  ${c.sha.slice(0, 10)}  ${c.subject}`);
-    }
-    lines.push("");
-    if (result.childIdRange) {
-      lines.push(
-        `Inferred children: ${result.inferredChildren.join(", ")} (${result.childIdRange.min} \u2192 ${result.childIdRange.max})`
-      );
-    } else {
-      lines.push("Inferred children: none");
-    }
-    const childEntries = Object.entries(result.childCommits);
-    if (childEntries.length > 0) {
-      lines.push("");
-      lines.push("Child commits:");
-      for (const [childId, commits] of childEntries) {
-        lines.push(`  ${childId}: ${commits.length} commit(s)`);
-        for (const c of commits) {
-          lines.push(`    ${c.sha.slice(0, 10)}  ${c.subject}`);
-        }
-      }
-    }
-    lines.push("");
-    if (result.releaseTags.length > 0) {
-      lines.push(`Release tags (${result.releaseTags.length}):`);
-      for (const t of result.releaseTags) {
-        lines.push(`  ${t.tag}  ${t.commitSha.slice(0, 10)}  ${t.subject}`);
-      }
-    } else {
-      lines.push("Release tags: none found");
-    }
-    lines.push("");
-    lines.push(`First seen: ${result.firstSeenAt ?? "n/a"}`);
-    lines.push(`Last seen:  ${result.lastSeenAt ?? "n/a"}`);
-    process.stdout.write(`${lines.join("\n")}
-`);
+    cliOutput(result, {
+      command: "audit-reconstruct",
+      operation: "audit.reconstruct",
+      message: `Lineage for ${result.taskId}`
+    });
   }
 });
 var auditCommand = defineCommand({
@@ -43080,7 +43179,7 @@ var projectsCleanCommand = defineCommand({
       if (ctx.format !== "json") {
         cliOutput(
           { matched: matchCount, totalCount, sample: samplePaths },
-          { command: "nexus-projects-clean", operation: "nexus.projects.clean" }
+          { command: "nexus-projects-clean-preview", operation: "nexus.projects.clean" }
         );
       }
       if (matchCount === 0 || dryRun) {
@@ -47899,6 +47998,7 @@ var safestopCommand = defineCommand({
 // packages/cleo/src/cli/commands/schema.ts
 import { describeOperation } from "@cleocode/lafs";
 init_registry();
+init_format_context();
 init_renderers();
 function resolveOperationDef(operationArg) {
   const dotIdx = operationArg.indexOf(".");
@@ -47913,56 +48013,6 @@ function resolveOperationDef(operationArg) {
   const operation = operationArg.slice(dotIdx + 1);
   return OPERATIONS.find((op) => op.domain === domain && op.operation === operation) ?? null;
 }
-function renderSchemaHuman(schema2) {
-  const lines = [];
-  lines.push(`Operation : ${schema2.operation}`);
-  lines.push(`Gateway   : ${schema2.gateway}`);
-  lines.push(`Description: ${schema2.description}`);
-  lines.push("");
-  lines.push("Parameters:");
-  if (schema2.params.length === 0) {
-    lines.push("  (none declared)");
-  } else {
-    for (const p of schema2.params) {
-      const req = p.required ? "[required]" : "[optional]";
-      const enumStr = p.enum ? `  enum: ${p.enum.join(" | ")}` : "";
-      let cliStr = "";
-      if (p.cli) {
-        const parts = [];
-        if (p.cli.positional) parts.push("positional");
-        if (p.cli.short) parts.push(`short: ${p.cli.short}`);
-        if (p.cli.flag) parts.push(`flag: --${p.cli.flag}`);
-        if (parts.length > 0) cliStr = `  cli: ${parts.join(", ")}`;
-      }
-      lines.push(`  ${p.name} (${p.type}) ${req}`);
-      lines.push(`    ${p.description}${enumStr}${cliStr}`);
-    }
-  }
-  if (schema2.gates !== void 0) {
-    lines.push("");
-    lines.push("Gates:");
-    if (schema2.gates.length === 0) {
-      lines.push("  (none declared \u2014 see note on static gate table)");
-    } else {
-      for (const g of schema2.gates) {
-        lines.push(`  ${g.name} \u2192 ${g.errorCode}`);
-        lines.push(`    ${g.description}`);
-        for (const t of g.triggers) {
-          lines.push(`    - ${t}`);
-        }
-      }
-    }
-  }
-  if (schema2.examples !== void 0 && schema2.examples.length > 0) {
-    lines.push("");
-    lines.push("Examples:");
-    for (const ex of schema2.examples) {
-      lines.push(`  ${ex.command}`);
-      lines.push(`    ${ex.description}`);
-    }
-  }
-  return lines.join("\n");
-}
 var schemaCommand = defineCommand({
   meta: {
     name: "schema",
@@ -47998,6 +48048,9 @@ var schemaCommand = defineCommand({
     const format = args.format ?? "json";
     const includeGates = args["include-gates"] !== false;
     const includeExamples = args["include-examples"] === true;
+    if (format === "human") {
+      setFormatContext({ format: "human", source: "flag", quiet: false });
+    }
     const def = resolveOperationDef(args.operation);
     if (def === null) {
       cliError(
@@ -48015,10 +48068,6 @@ var schemaCommand = defineCommand({
       includeGates,
       includeExamples
     });
-    if (format === "human") {
-      console.log(renderSchemaHuman(schema2));
-      return;
-    }
     cliOutput(schema2, {
       command: "schema",
       operation: `schema.${args.operation}`,