@cleocode/cleo 2026.10.3 → 2026.10.4

package/dist/cli/federation-SUIB5QWT.js

@@ -0,0 +1,145 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  defineCommand,
+  showUsage
+} from "./chunk-PKKZPOOP.js";
+import {
+  cliError,
+  cliOutput,
+  humanLine
+} from "./chunk-3ZO3M37V.js";
+import "./chunk-6JSJNYH2.js";
+
+// packages/cleo/src/cli/commands/federation.ts
+import { ExitCode } from "@cleocode/contracts";
+import { skills } from "@cleocode/core";
+var { addFederationPeer, listFederationPeers, removeFederationPeer } = skills;
+var addCommand = defineCommand({
+  meta: {
+    name: "add",
+    description: "Add (or update) a federation peer in ~/.cleo/federation.json"
+  },
+  args: {
+    url: {
+      type: "positional",
+      description: "Peer URL (must use http:// or https://)",
+      required: true
+    },
+    trust: {
+      type: "string",
+      description: "Trust level: verified | unverified | blocked (default: unverified)",
+      default: "unverified"
+    }
+  },
+  async run({ args }) {
+    try {
+      const trust = String(args.trust);
+      const result = addFederationPeer(String(args.url), trust);
+      cliOutput(
+        {
+          entry: result.entry,
+          updated: result.updated
+        },
+        { command: "federation add", operation: "federation.add" }
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      cliError(`federation add failed: ${message}`, ExitCode.VALIDATION_ERROR);
+    }
+  }
+});
+var removeCommand = defineCommand({
+  meta: {
+    name: "remove",
+    description: "Remove a federation peer from ~/.cleo/federation.json"
+  },
+  args: {
+    url: {
+      type: "positional",
+      description: "Peer URL to remove (normalised before lookup)",
+      required: true
+    }
+  },
+  async run({ args }) {
+    try {
+      const removed = removeFederationPeer(String(args.url));
+      cliOutput(
+        { url: String(args.url), removed },
+        { command: "federation remove", operation: "federation.remove" }
+      );
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      cliError(`federation remove failed: ${message}`, ExitCode.VALIDATION_ERROR);
+    }
+  }
+});
+var listCommand = defineCommand({
+  meta: {
+    name: "list",
+    description: "List all federation peers in ~/.cleo/federation.json"
+  },
+  args: {
+    json: {
+      type: "boolean",
+      description: "Emit raw JSON envelope instead of human-readable list",
+      default: false
+    }
+  },
+  async run({ args }) {
+    try {
+      const entries = listFederationPeers();
+      if (args.json) {
+        cliOutput(
+          { count: entries.length, entries },
+          { command: "federation list", operation: "federation.list" }
+        );
+        return;
+      }
+      if (entries.length === 0) {
+        humanLine("(no federation peers configured)");
+        return;
+      }
+      for (const entry of entries) {
+        humanLine(`${entry.trust.padEnd(11)}  ${entry.url}  (added ${entry.addedAt})`);
+      }
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      cliError(`federation list failed: ${message}`, ExitCode.GENERAL_ERROR);
+    }
+  }
+});
+var federationCommand = defineCommand({
+  meta: {
+    name: "federation",
+    description: "Federation peer management: add, remove, list trusted peers"
+  },
+  subCommands: {
+    add: addCommand,
+    remove: removeCommand,
+    list: listCommand
+  },
+  run({ rawArgs }) {
+    const sub = rawArgs?.find((a) => !a.startsWith("-"));
+    if (!sub) {
+      showUsage(federationCommand);
+    }
+  }
+});
+export {
+  federationCommand
+};
+//# sourceMappingURL=federation-SUIB5QWT.js.map

package/dist/cli/find-YICG4BG6.js

@@ -0,0 +1,177 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import {
+  dispatchRaw,
+  handleRawError,
+  maybeEmitDescribe
+} from "./chunk-3IOQVUO7.js";
+import "./chunk-AWCQH2W5.js";
+import "./chunk-OGV57L4J.js";
+import "./chunk-ZBISIPCK.js";
+import {
+  cliOutput
+} from "./chunk-3ZO3M37V.js";
+import "./chunk-6JSJNYH2.js";
+import "./chunk-QFFQSKRC.js";
+
+// packages/cleo/src/cli/commands/find.ts
+import { ExitCode } from "@cleocode/contracts";
+import { createPage } from "@cleocode/core";
+var findCommand = defineCommand({
+  meta: { name: "find", description: "Lexical task search; fuzzy matching requires --fuzzy" },
+  args: {
+    query: {
+      type: "positional",
+      description: "Search text (required unless --id is provided)",
+      required: false
+    },
+    id: { type: "string", description: "Search by ID prefix" },
+    exact: { type: "boolean", description: "Exact title match" },
+    fuzzy: {
+      type: "boolean",
+      description: "Opt into character-subsequence matches; each result explains its matching fields"
+    },
+    status: {
+      type: "string",
+      description: "Filter by status (pending|active|blocked|done|cancelled)"
+    },
+    in: { type: "string", description: "Field to search in (title|description|notes|id)" },
+    "include-archive": { type: "boolean", description: "Include archived tasks" },
+    limit: {
+      type: "string",
+      description: "Max results (default: 20; --limit 0 returns every match)"
+    },
+    // GH #1302 — parity with `cleo list --all`. `find` truncated at 20 with no
+    // way to enumerate: no such flag existed, and `--limit 0` returned zero
+    // rows rather than everything. The truncation warning could therefore name
+    // a remedy this command did not have.
+    all: {
+      type: "boolean",
+      description: "Return EVERY matching task instead of the default page of 20."
+    },
+    offset: { type: "string", description: "Skip first N results" },
+    fields: { type: "string", description: "Comma-separated additional fields to include" },
+    verbose: {
+      type: "boolean",
+      description: "Return full task records instead of the MVI projection (id + title + status + key metadata). T9922.",
+      alias: "v"
+    },
+    // T9922 — MVI record projection opt-out alias (surfaced for --help).
+    full: {
+      type: "boolean",
+      description: "Alias for --verbose. T9922."
+    },
+    /**
+     * Filter by task kind axis (T944/T9072).
+     * Values: work | research | experiment | bug | spike | release
+     */
+    kind: {
+      type: "string",
+      description: "Filter by kind axis (work|research|experiment|bug|spike|release) \u2014 T944"
+    },
+    /**
+     * Unified urgency surface (T9905).
+     *
+     * Selects tasks where
+     *   priority IN ('critical','high') OR severity IN ('P0','P1')
+     *
+     * Combines the two orthogonal urgency axes (priority + severity) into a
+     * single filter so agents don't have to query each axis separately.
+     */
+    urgent: {
+      type: "boolean",
+      description: "Surface urgent work across both axes: priority IN (critical,high) OR severity IN (P0,P1) (T9905)",
+      alias: "u"
+    },
+    /**
+     * Filter by label — `cleo find --label <name>` returns every task
+     * whose `labels[]` includes the given value. Closes GH#393 and gives
+     * `find` parity with the positional `cleo labels <name>` surface.
+     * @task T9904
+     */
+    label: {
+      type: "string",
+      description: "Filter by label \u2014 return tasks whose labels[] includes this value (T9904)"
+    },
+    /**
+     * Filter by parent task ID — `cleo find --parent <id>` returns only
+     * tasks whose `parentId` matches. Mirrors the `--parent` axis on
+     * `cleo list`. When the parent target is a Saga (Epic with
+     * `label='saga'`), routing goes through `task_relations.type='groups'`
+     * member IDs (ADR-073 §1) — same path as `cleo list --parent`.
+     *
+     * Closes T10108 — pre-fix the flag was missing entirely AND empty-string
+     * queries bypassed every filter via `fuzzyScore('', '<title>')===80`.
+     *
+     * @task T10108
+     * @saga T9862
+     */
+    parent: {
+      type: "string",
+      description: "Filter by direct parentId containment, including saga children"
+    }
+  },
+  async run({ args }) {
+    if (maybeEmitDescribe("query", "tasks", "find", { command: "find" })) return;
+    let limit = args.limit !== void 0 ? Number(args.limit) : void 0;
+    if (args.all === true) limit = 0;
+    const offset = args.offset !== void 0 ? Number(args.offset) : void 0;
+    const params = {};
+    if (args.query !== void 0) params["query"] = args.query;
+    if (args.id !== void 0) params["id"] = args.id;
+    if (args.exact !== void 0) params["exact"] = args.exact;
+    if (args.fuzzy !== void 0) params["fuzzy"] = args.fuzzy;
+    if (args.status !== void 0) params["status"] = args.status;
+    if (args.in !== void 0) params["field"] = args.in;
+    if (args["include-archive"] !== void 0) params["includeArchive"] = args["include-archive"];
+    if (limit !== void 0) params["limit"] = limit;
+    if (offset !== void 0) params["offset"] = offset;
+    if (args.fields !== void 0) params["fields"] = args.fields;
+    if (args.verbose !== void 0) params["verbose"] = args.verbose;
+    if (args.kind !== void 0) params["kind"] = args.kind;
+    if (args.urgent !== void 0) params["urgent"] = args.urgent;
+    if (args.label !== void 0) params["label"] = args.label;
+    if (args.parent !== void 0) params["parent"] = args.parent;
+    const response = await dispatchRaw("query", "tasks", "find", params);
+    if (!response.success) {
+      handleRawError(response, { command: "find", operation: "tasks.find" });
+    }
+    const rawData = response.data;
+    const data = (Array.isArray(rawData) ? { results: rawData, total: rawData.length } : rawData) ?? {};
+    const results = Array.isArray(data?.results) ? data.results : [];
+    if (results.length === 0) {
+      const matched = typeof data?.["total"] === "number" ? data["total"] : 0;
+      const message = matched > 0 ? `No results on this page \u2014 ${matched} task(s) matched. Re-run with --all to enumerate every match, or adjust --limit/--offset.` : "No matching tasks found";
+      cliOutput(data, { command: "find", message, operation: "tasks.find" });
+      process.exit(ExitCode.NO_DATA);
+      return;
+    }
+    const total = data?.total ?? results.length;
+    const page = response.page ?? (limit === 0 && !offset ? { mode: "none" } : createPage({
+      total,
+      limit: limit === 0 ? Math.max(1, results.length) : limit ?? 20,
+      offset
+    }));
+    cliOutput(data, { command: "find", operation: "tasks.find", page, enumerateAllFlag: "--all" });
+  }
+});
+export {
+  findCommand
+};
+//# sourceMappingURL=find-YICG4BG6.js.map

package/dist/cli/focus-TKCZPKOM.js

@@ -0,0 +1,55 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import {
+  dispatchFromCli
+} from "./chunk-3IOQVUO7.js";
+import "./chunk-AWCQH2W5.js";
+import "./chunk-OGV57L4J.js";
+import "./chunk-ZBISIPCK.js";
+import "./chunk-3ZO3M37V.js";
+import "./chunk-6JSJNYH2.js";
+import "./chunk-QFFQSKRC.js";
+
+// packages/cleo/src/cli/commands/focus.ts
+var focusCommand = defineCommand({
+  meta: {
+    name: "focus",
+    description: "Single-envelope orientation for a task, epic, or saga \u2014 replaces 8 separate calls with one"
+  },
+  args: {
+    id: {
+      type: "positional",
+      description: "Task, Epic, or Saga ID to orient on (e.g. T9973, T9831)",
+      required: true
+    }
+  },
+  async run({ args }) {
+    await dispatchFromCli(
+      "query",
+      "focus",
+      "show",
+      { id: args["id"] },
+      { command: "focus" }
+    );
+  }
+});
+export {
+  focusCommand
+};
+//# sourceMappingURL=focus-TKCZPKOM.js.map

package/dist/cli/gateway-H4HFDC3E.js

@@ -0,0 +1,77 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import "./chunk-C3B7C43W.js";
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import {
+  cliOutput
+} from "./chunk-3ZO3M37V.js";
+import "./chunk-6JSJNYH2.js";
+
+// packages/cleo/src/cli/commands/gateway.ts
+import { resolve } from "node:path";
+import { generateOpenApi, getProjectRoot } from "@cleocode/core";
+var gatewayOpenapiSubCommand = defineCommand({
+  meta: {
+    name: "openapi",
+    description: "Emit the OpenAPI 3.1 spec projected from the OPERATIONS registry"
+  },
+  args: {
+    out: {
+      type: "string",
+      description: "Write the spec to this file (JSON). When omitted, prints the spec.",
+      alias: "o"
+    },
+    version: {
+      type: "string",
+      description: "API-surface version stamped into info.version (default '1.0.0')"
+    }
+  },
+  async run({ args }) {
+    const doc = generateOpenApi(
+      typeof args.version === "string" && args.version.length > 0 ? { version: args.version } : void 0
+    );
+    const json = `${JSON.stringify(doc, null, 2)}
+`;
+    const pathCount = Object.keys(doc.paths).length;
+    if (typeof args.out === "string" && args.out.length > 0) {
+      const { writeFileSync } = await import("node:fs");
+      const target = resolve(getProjectRoot(), args.out);
+      writeFileSync(target, json, "utf8");
+      cliOutput(
+        { out: target, pathCount, version: doc.info.version, openapi: doc.openapi },
+        { command: "gateway", operation: "gateway.openapi" }
+      );
+      return;
+    }
+    cliOutput(doc, { command: "gateway", operation: "gateway.openapi" });
+  }
+});
+var gatewayCommand = defineCommand({
+  meta: {
+    name: "gateway",
+    description: "REST gateway introspection (openapi spec projection)"
+  },
+  subCommands: {
+    openapi: gatewayOpenapiSubCommand
+  }
+});
+export {
+  gatewayCommand,
+  gatewayOpenapiSubCommand
+};
+//# sourceMappingURL=gateway-H4HFDC3E.js.map

package/dist/cli/gateway-auto-start-EDK7XI6E.js

@@ -0,0 +1,36 @@
+(() => {
+  const _installed = Symbol.for('cleocode.cli.sqliteWarningFilter');
+  if (globalThis[_installed]) return;
+  globalThis[_installed] = true;
+  const _origEmitWarning = process.emitWarning;
+  process.emitWarning = function(warning, type, code, ctor) {
+    if (typeof warning === 'object' && warning.name === 'ExperimentalWarning' && typeof warning.message === 'string' && /SQLite is an experimental feature/i.test(warning.message)) {
+      return;
+    }
+    if (typeof warning === 'string' && /SQLite is an experimental feature/i.test(warning)) {
+      return;
+    }
+    return _origEmitWarning.call(process, warning, type, code, ctor);
+  };
+})();
+import {
+  GATEWAY_DEFAULT_HOST,
+  GATEWAY_DEFAULT_PORT,
+  GATEWAY_WAIT_TIMEOUT_MS,
+  pollPort,
+  probePort,
+  resolveCliEntryPath,
+  shouldAutoStartGateway,
+  spawnGatewayIfDown
+} from "./chunk-LVGIFMCV.js";
+export {
+  GATEWAY_DEFAULT_HOST,
+  GATEWAY_DEFAULT_PORT,
+  GATEWAY_WAIT_TIMEOUT_MS,
+  pollPort,
+  probePort,
+  resolveCliEntryPath,
+  shouldAutoStartGateway,
+  spawnGatewayIfDown
+};
+//# sourceMappingURL=gateway-auto-start-EDK7XI6E.js.map