@cleocode/cleo 2026.4.111 → 2026.4.113

package/dist/cli/index.js

@@ -1037,6 +1037,27 @@ var init_normalizer = __esm({
   }
 });
 
+// packages/cleo/src/cli/tree-context.ts
+function setTreeContext(ctx) {
+  currentContext2 = {
+    withDeps: ctx.withDeps ?? false,
+    withBlockers: ctx.withBlockers ?? false
+  };
+}
+function getTreeContext() {
+  return currentContext2;
+}
+var currentContext2;
+var init_tree_context = __esm({
+  "packages/cleo/src/cli/tree-context.ts"() {
+    "use strict";
+    currentContext2 = {
+      withDeps: false,
+      withBlockers: false
+    };
+  }
+});
+
 // packages/cleo/src/cli/renderers/colors.ts
 function ansi2(code) {
   return colorsEnabled ? code : "";
@@ -1154,6 +1175,31 @@ var init_colors = __esm({
 });
 
 // packages/cleo/src/cli/renderers/system.ts
+import { formatTree, formatWaves } from "@cleocode/core/formatters";
+function cliColorize(text, style) {
+  switch (style) {
+    case "bold":
+      return `${BOLD}${text}${NC}`;
+    case "dim":
+      return `${DIM}${text}${NC}`;
+    case "red":
+      return `${RED}${text}${NC}`;
+    case "green":
+      return `${GREEN}${text}${NC}`;
+    case "yellow":
+      return `${YELLOW}${text}${NC}`;
+    case "blue":
+      return `${BLUE}${text}${NC}`;
+    case "magenta":
+      return `${MAGENTA}${text}${NC}`;
+    case "cyan":
+      return `${CYAN}${text}${NC}`;
+    case "reset":
+      return `${NC}${text}`;
+    default:
+      return text;
+  }
+}
 function renderDoctor(data, quiet) {
   const healthy = data["healthy"];
   const errors = data["errors"];
@@ -1256,11 +1302,37 @@ function renderBlockers(data, quiet) {
   }
   return lines.join("\n");
 }
+function renderWaves(data, opts) {
+  return formatWaves(data, {
+    mode: opts?.mode ?? "rich",
+    colorize: cliColorize
+  });
+}
 function renderTree(data, quiet) {
+  const waves = data["waves"];
   const tree = data["tree"];
   const tasks = data["tasks"];
+  if (waves) {
+    const epicId = data["epicId"];
+    const totalWaves = data["totalWaves"];
+    const totalTasks = data["totalTasks"];
+    if (quiet) {
+      return renderWaves(data, { mode: "quiet" });
+    }
+    const header = epicId ? `${BOLD}Waves for ${epicId}${NC}  ${DIM}(${totalWaves ?? waves.length} waves, ${totalTasks ?? "?"} tasks)${NC}` : `${BOLD}Execution Waves${NC}`;
+    const body = renderWaves(data, { mode: "rich", epicId, totalWaves, totalTasks });
+    return `${header}
+
+${body}`;
+  }
   if (tree) {
-    return renderTreeNodes(tree, "", quiet);
+    const { withDeps, withBlockers } = getTreeContext();
+    return formatTree(tree, {
+      mode: quiet ? "quiet" : "rich",
+      colorize: cliColorize,
+      withDeps,
+      withBlockers
+    });
   }
   if (tasks) {
     if (quiet) return tasks.map((t) => t.id).join("\n");
@@ -1271,29 +1343,6 @@ function renderTree(data, quiet) {
   }
   return quiet ? "" : "No tree data.";
 }
-function renderTreeNodes(nodes, prefix, quiet) {
-  const lines = [];
-  for (let i = 0; i < nodes.length; i++) {
-    const node = nodes[i];
-    const isLast = i === nodes.length - 1;
-    const connector = isLast ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
-    const childPrefix = isLast ? "    " : "\u2502   ";
-    const id = String(node["id"] ?? "");
-    const title = String(node["title"] ?? "");
-    const status = String(node["status"] ?? "");
-    const sSym = statusSymbol(status);
-    if (quiet) {
-      lines.push(`${prefix}${id}`);
-    } else {
-      lines.push(`${prefix}${connector}${sSym} ${BOLD}${id}${NC} ${title}`);
-    }
-    const children = node["children"];
-    if (children?.length) {
-      lines.push(renderTreeNodes(children, prefix + childPrefix, quiet));
-    }
-  }
-  return lines.join("\n");
-}
 function renderStart(data, quiet) {
   const task = data["task"];
   const taskId = data["taskId"];
@@ -1487,6 +1536,7 @@ function formatLabel(key) {
 var init_system2 = __esm({
   "packages/cleo/src/cli/renderers/system.ts"() {
     "use strict";
+    init_tree_context();
     init_colors();
   }
 });
@@ -1731,7 +1781,8 @@ var init_tasks2 = __esm({
 var renderers_exports = {};
 __export(renderers_exports, {
   cliError: () => cliError,
-  cliOutput: () => cliOutput
+  cliOutput: () => cliOutput,
+  renderWaves: () => renderWaves
 });
 import { randomUUID } from "node:crypto";
 import { formatSuccess } from "@cleocode/core";
@@ -1908,6 +1959,9 @@ var init_renderers = __esm({
       tree: renderTree,
       depends: renderTree,
       deps: renderTree,
+      // Orchestration — `cleo orchestrate waves` emits { waves, epicId, ... }
+      // which renderTree handles via its data.waves branch (T1194/T1195).
+      orchestrate: renderTree,
       session: renderSession,
       version: renderVersion
     };
@@ -4903,7 +4957,7 @@ var init_registry = __esm({
         gateway: "mutate",
         domain: "pipeline",
         operation: "manifest.append",
-        description: "pipeline.manifest.append (mutate) \u2014 append entry to MANIFEST.jsonl",
+        description: "pipeline.manifest.append (mutate) \u2014 append entry to pipeline_manifest (SQLite table per ADR-027)",
         tier: 1,
         idempotent: false,
         sessionRequired: false,
@@ -12785,9 +12839,9 @@ async function taskBlockers(projectRoot, params) {
     return engineError("E_NOT_INITIALIZED", "Task database not initialized");
   }
 }
-async function taskTree(projectRoot, taskId) {
+async function taskTree(projectRoot, taskId, withBlockers) {
   try {
-    const result = await coreTaskTree(projectRoot, taskId);
+    const result = await coreTaskTree(projectRoot, taskId, withBlockers);
     return { success: true, data: result };
   } catch (err) {
     return cleoErrorToEngineError(err, "E_NOT_FOUND", "Task not found");
@@ -28805,7 +28859,8 @@ var init_tasks3 = __esm({
             }
             case "tree": {
               const taskId = params?.taskId;
-              const result = await taskTree(projectRoot, taskId);
+              const withBlockers = params?.withBlockers;
+              const result = await taskTree(projectRoot, taskId, withBlockers);
               return wrapResult(result, "query", "tasks", operation, startTime);
             }
             case "blockers": {
@@ -39170,6 +39225,7 @@ init_src();
 import { depsCriticalPath, resolveProjectRoot as resolveProjectRoot5 } from "@cleocode/core/internal";
 init_cli();
 init_renderers();
+init_tree_context();
 var overviewCommand = defineCommand({
   meta: { name: "overview", description: "Overview of all dependencies" },
   async run() {
@@ -39311,14 +39367,25 @@ var treeCommand = defineCommand({
       type: "positional",
       description: "Root task ID (optional)",
       required: false
+    },
+    withDeps: {
+      type: "boolean",
+      description: "Inline dependency chain below each task that has deps",
+      default: false
+    },
+    blockers: {
+      type: "boolean",
+      description: "Render transitive blocker chain and leaf blockers below each blocked task",
+      default: false
     }
   },
   async run({ args }) {
+    setTreeContext({ withDeps: args.withDeps, withBlockers: args.blockers });
     await dispatchFromCli(
       "query",
       "tasks",
       "tree",
-      { taskId: args.rootId },
+      { taskId: args.rootId, withBlockers: args.blockers },
       { command: "tree", operation: "tasks.tree" }
     );
   }
@@ -42654,6 +42721,7 @@ var logCommand2 = defineCommand({
 });
 
 // packages/cleo/src/cli/commands/manifest.ts
+import { buildManifestEntryFromShorthand } from "@cleocode/core/memory/manifest-builder.js";
 init_cli();
 var showCommand7 = defineCommand({
   meta: {
@@ -42796,24 +42864,32 @@ var statsCommand3 = defineCommand({
 var appendCommand = defineCommand({
   meta: {
     name: "append",
-    description: "Append a new manifest entry"
+    description: "Append a new manifest entry (pipeline_manifest table). Accepts either a full --entry JSON blob / --file / stdin, OR the shorthand --task + --type + --content flags which build a valid entry with sensible defaults for id/file/title/date/etc."
   },
   args: {
     entry: {
       type: "string",
-      description: "JSON string of entry fields"
+      description: "JSON string of entry fields (full ManifestEntry shape)"
     },
     task: {
       type: "string",
-      description: "Task ID to associate (shorthand for entry.task_id)"
+      description: "Task ID to associate \u2014 becomes linked_tasks[0] + id prefix (shorthand)"
     },
     type: {
       type: "string",
-      description: "Entry type (shorthand for entry.type)"
+      description: "Entry type \u2014 becomes agent_type (e.g. research, implementation, decomposition) (shorthand)"
     },
     content: {
       type: "string",
-      description: "Entry content string (shorthand for entry.content)"
+      description: "One-paragraph summary \u2014 becomes key_findings[0] and title (first line) (shorthand)"
+    },
+    title: {
+      type: "string",
+      description: "Explicit title override for shorthand mode"
+    },
+    status: {
+      type: "string",
+      description: "Entry status: completed (default) | partial | blocked (shorthand)"
     },
     file: {
       type: "string",
@@ -42822,6 +42898,7 @@ var appendCommand = defineCommand({
   },
   async run({ args }) {
     let entry;
+    const hasShorthand = Boolean(args.task || args.type || args.content);
     if (args.entry) {
       try {
         entry = JSON.parse(args.entry);
@@ -42838,10 +42915,22 @@ var appendCommand = defineCommand({
         console.error(`Error: failed to read or parse ${args.file}`);
         process.exit(1);
       }
+    } else if (hasShorthand) {
+      entry = {
+        ...buildManifestEntryFromShorthand({
+          task: args.task,
+          type: args.type,
+          content: args.content,
+          title: args.title,
+          status: args.status
+        })
+      };
     } else {
       const stdinData = await readStdin();
       if (!stdinData) {
-        console.error("Error: must provide --entry, --file, or stdin with JSON entry data");
+        console.error(
+          "Error: must provide --entry JSON, --file path, stdin, or shorthand (--task + --type + --content)"
+        );
         process.exit(1);
       }
       try {
@@ -42851,14 +42940,22 @@ var appendCommand = defineCommand({
         process.exit(1);
       }
     }
-    if (args.task) {
-      entry.task_id = args.task;
-    }
-    if (args.type) {
-      entry.type = args.type;
-    }
-    if (args.content) {
-      entry.content = args.content;
+    if ((args.entry || args.file) && hasShorthand) {
+      if (args.task) {
+        entry.linked_tasks = Array.isArray(entry.linked_tasks) ? [args.task, ...entry.linked_tasks.filter((t) => t !== args.task)] : [args.task];
+      }
+      if (args.type) {
+        entry.agent_type = args.type;
+      }
+      if (args.content && !entry.key_findings) {
+        entry.key_findings = [args.content];
+      }
+      if (args.title) {
+        entry.title = args.title;
+      }
+      if (args.status) {
+        entry.status = args.status;
+      }
     }
     await dispatchFromCli(
       "mutate",
@@ -52681,7 +52778,7 @@ var archiveCommand3 = defineCommand({
   }
 });
 var manifestCommand2 = defineCommand({
-  meta: { name: "manifest", description: "Query MANIFEST.jsonl entries" },
+  meta: { name: "manifest", description: "Query pipeline_manifest entries" },
   args: {
     status: {
       type: "string",