@cleocode/cleo 2026.10.3 → 2026.10.5-rc.ci.672

package/dist/cli/setup-L3YYV53D.js

@@ -0,0 +1,323 @@
+(() => {
+  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 {
+  makeOAuthAcquirer
+} from "./chunk-UWCZY52R.js";
+import {
+  ReadlineWizardIO,
+  StdinClosedError
+} from "./chunk-GZFVDR44.js";
+import "./chunk-GRU74UE4.js";
+import "./chunk-47JYZAMS.js";
+import "./chunk-C3B7C43W.js";
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import {
+  cliError,
+  cliOutput
+} from "./chunk-4RGSNUUP.js";
+import "./chunk-6JSJNYH2.js";
+
+// packages/cleo/src/cli/commands/setup.ts
+import {
+  createDefaultWizardRunner,
+  mergeConfigJson,
+  printWhoamiSummaryAndOfferTui,
+  SetupConfigJsonError,
+  WizardInterruptError
+} from "@cleocode/core/setup";
+function buildWizardOptions(args) {
+  const out = {};
+  const configJsonRaw = args["config-json"] ?? args["configJson"];
+  if (typeof configJsonRaw === "string" && configJsonRaw !== "") {
+    let parsed;
+    try {
+      parsed = JSON.parse(configJsonRaw);
+    } catch {
+    }
+    if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+      mergeConfigJson(parsed, out);
+    }
+  }
+  if (args["non-interactive"] === true || args["nonInteractive"] === true) {
+    out.nonInteractive = true;
+  }
+  if (args["reset"] === true) {
+    out.reset = true;
+  }
+  if (typeof args["provider"] === "string" && args["provider"] !== "") {
+    out.provider = args["provider"];
+  }
+  if (typeof args["api-key"] === "string" && args["api-key"] !== "") {
+    out.apiKey = args["api-key"];
+  } else if (typeof args["apiKey"] === "string" && args["apiKey"] !== "") {
+    out.apiKey = args["apiKey"];
+  }
+  if (typeof args["label"] === "string" && args["label"] !== "") {
+    out.label = args["label"];
+  }
+  if (typeof args["agent-name"] === "string" && args["agent-name"] !== "") {
+    out.agentName = args["agent-name"];
+  } else if (typeof args["agentName"] === "string" && args["agentName"] !== "") {
+    out.agentName = args["agentName"];
+  }
+  if (typeof args["strictness"] === "string" && args["strictness"] !== "") {
+    const s = args["strictness"];
+    if (s === "strict" || s === "standard" || s === "minimal") {
+      out.strictness = s;
+    }
+  }
+  if (typeof args["project-root"] === "string" && args["project-root"] !== "") {
+    out.projectRoot = args["project-root"];
+  }
+  if (typeof args["harness"] === "string" && args["harness"] !== "") {
+    const h = args["harness"];
+    if (h === "pi" || h === "claude-code") {
+      out.harness = h;
+    }
+  }
+  if (typeof args["brain-bridge-mode"] === "string" && args["brain-bridge-mode"] !== "") {
+    const b = args["brain-bridge-mode"];
+    if (b === "digest" || b === "file" || b === "disabled") {
+      out.brainBridgeMode = b;
+    }
+  } else if (typeof args["brainBridgeMode"] === "string" && args["brainBridgeMode"] !== "") {
+    const b = args["brainBridgeMode"];
+    if (b === "digest" || b === "file" || b === "disabled") {
+      out.brainBridgeMode = b;
+    }
+  }
+  if (typeof args["retention-days"] === "string" && args["retention-days"] !== "") {
+    const days = Number.parseInt(args["retention-days"], 10);
+    if (!Number.isNaN(days) && days >= 0) {
+      out.brainRetentionDays = days;
+    }
+  } else if (typeof args["retentionDays"] === "number") {
+    const days = args["retentionDays"];
+    if (Number.isInteger(days) && days >= 0) {
+      out.brainRetentionDays = days;
+    }
+  }
+  if (typeof args["sentient"] === "string" && args["sentient"] !== "") {
+    const s = args["sentient"];
+    if (s === "on") out.sentientEnabled = true;
+    else if (s === "off") out.sentientEnabled = false;
+  }
+  if (typeof args["tier2"] === "string" && args["tier2"] !== "") {
+    const t = args["tier2"];
+    if (t === "on") out.tier2Enabled = true;
+    else if (t === "off") out.tier2Enabled = false;
+  }
+  if (args["signaldock-enabled"] === true) {
+    out.signaldockEnabled = true;
+  } else if (args["signaldock-enabled"] === false) {
+    out.signaldockEnabled = false;
+  }
+  if (typeof args["signaldock-endpoint"] === "string" && args["signaldock-endpoint"] !== "") {
+    out.signaldockEndpoint = args["signaldock-endpoint"];
+  }
+  if (args["studio-enabled"] === true) {
+    out.studioEnabled = true;
+  } else if (args["studio-enabled"] === false) {
+    out.studioEnabled = false;
+  }
+  if (typeof args["default-model"] === "string" && args["default-model"] !== "") {
+    out.defaultModel = args["default-model"];
+  } else if (typeof args["defaultModel"] === "string" && args["defaultModel"] !== "") {
+    out.defaultModel = args["defaultModel"];
+  }
+  const roleBindingsRaw = args["role-bindings"] ?? args["roleBindings"];
+  if (typeof roleBindingsRaw === "string" && roleBindingsRaw !== "") {
+    try {
+      const parsed = JSON.parse(roleBindingsRaw);
+      if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+        out.roleBindings = parsed;
+      }
+    } catch {
+    }
+  }
+  return out;
+}
+function wrapSingleSection(name, result) {
+  return {
+    sectionsRun: [name],
+    summary: [`${name}: ${result.summary}`],
+    // Single-section runs never trigger the full first-run completion flow.
+    firstRunComplete: false
+  };
+}
+function isOk(result) {
+  return !result.summary.some((line) => /:\s*failed:/i.test(line));
+}
+async function runSetup(args, io) {
+  const options = buildWizardOptions(args);
+  const runner = createDefaultWizardRunner({ oauthAcquirer: makeOAuthAcquirer(options.label) });
+  const sectionArg = typeof args["section"] === "string" ? args["section"] : null;
+  let runResult;
+  if (sectionArg) {
+    const known = runner.list().map((r) => r.section);
+    if (!known.includes(sectionArg)) {
+      throw new Error(`cleo setup: unknown section '${sectionArg}'. Known: ${known.join(", ")}`);
+    }
+    const single = await runner.runSection(sectionArg, io, options);
+    runResult = wrapSingleSection(sectionArg, single);
+  } else {
+    runResult = await runner.run(io, options);
+  }
+  return {
+    sectionsRun: runResult.sectionsRun,
+    summary: runResult.summary,
+    ok: isOk(runResult),
+    firstRunComplete: runResult.firstRunComplete
+  };
+}
+var setupCommand = defineCommand({
+  meta: {
+    name: "setup",
+    description: "Interactive setup wizard \u2014 runs every section in canonical order (llm \u2192 system-one \u2192 models-roles \u2192 identity \u2192 sentient \u2192 project-conventions \u2192 harness \u2192 brain \u2192 integrations \u2192 telemetry \u2192 verification); system-one is optional. Use --section <name> for a single section, --non-interactive with section-specific flags to configure without prompts, --config-json for fully scripted setup, or --reset to reconfigure already-set sections."
+  },
+  args: {
+    section: {
+      type: "string",
+      description: "Run only one named section. Valid: llm | system-one | models-roles | identity | sentient | harness | brain | project-conventions | integrations | nexus-account | telemetry | verification"
+    },
+    "non-interactive": {
+      type: "boolean",
+      description: "Skip prompts. Requires section-specific flags (e.g. --provider/--api-key for llm, --harness for harness, --brain-bridge-mode for brain, --sentient/--tier2 for sentient, --signaldock-enabled/--signaldock-endpoint/--studio-enabled for integrations). Missing required flags emit E_SETUP_MISSING_FLAG."
+    },
+    provider: {
+      type: "string",
+      description: "LLM provider id when --non-interactive (anthropic, openai, gemini, openrouter, moonshot, deepseek, xai, groq, ollama)."
+    },
+    "api-key": {
+      type: "string",
+      description: "API key used when --non-interactive --provider is set."
+    },
+    label: {
+      type: "string",
+      description: "Optional credential label override (defaults to 'cli-input')."
+    },
+    "agent-name": {
+      type: "string",
+      description: "Override agent display name for the identity section."
+    },
+    strictness: {
+      type: "string",
+      description: "Project-conventions strictness preset: 'strict' | 'standard' | 'minimal'."
+    },
+    "project-root": {
+      type: "string",
+      description: "Override project root path (defaults to process.cwd())."
+    },
+    harness: {
+      type: "string",
+      description: "Active harness for the harness section when --non-interactive: 'pi' | 'claude-code'."
+    },
+    "brain-bridge-mode": {
+      type: "string",
+      description: "BRAIN memory bridge mode for the brain section when --non-interactive: 'digest' | 'file' | 'disabled'."
+    },
+    sentient: {
+      type: "string",
+      description: "Enable or disable the sentient daemon for the sentient section when --non-interactive: 'on' | 'off'."
+    },
+    tier2: {
+      type: "string",
+      description: "Enable or disable Tier-2 proposals for the sentient section when --non-interactive: 'on' | 'off'."
+    },
+    "config-json": {
+      type: "string",
+      description: `JSON bag of per-section options. Keys are section IDs ('identity', 'llm', 'brain', 'sentient', 'harness', 'project-conventions', 'integrations', 'verification'), values are WizardOptions sub-objects. Example: '{"identity":{"agentName":"Atlas"},"llm":{"provider":"anthropic","apiKey":"sk-ant-..."}}'. Explicit CLI flags take precedence over configJson values.`
+    },
+    reset: {
+      type: "boolean",
+      description: "Clear the 'already configured' sentinel before running \u2014 forces all sections to re-run even if they report isConfigured()=true. Does NOT clear the credential pool; use 'cleo llm remove' for that."
+    },
+    "retention-days": {
+      type: "string",
+      description: "BRAIN retention days for the brain section when --non-interactive (0 = retain forever, default 0). Must be a non-negative integer."
+    },
+    "signaldock-enabled": {
+      type: "boolean",
+      description: "Enable (true) or disable (false) the SignalDock transport. Used by the integrations section."
+    },
+    "signaldock-endpoint": {
+      type: "string",
+      description: "SignalDock endpoint URL for the integrations section (e.g. http://localhost:4000). Must be a valid HTTP(S) URL."
+    },
+    "studio-enabled": {
+      type: "boolean",
+      description: "Enable (true) or disable (false) the Studio web UI. Used by the integrations section."
+    },
+    "default-model": {
+      type: "string",
+      description: "Default model id for the global binding (models-roles section, --non-interactive). Equivalent to `cleo llm use --model`."
+    },
+    "role-bindings": {
+      type: "string",
+      description: `JSON map of per-role profile pins for the models-roles section (--non-interactive). Keys are role names (extraction|consolidation|derivation|hygiene|judgement); values are {provider, model?, credentialLabel?}. Example: '{"extraction":{"provider":"anthropic","model":"claude-..."}}'.`
+    }
+  },
+  async run({ args }) {
+    const io = new ReadlineWizardIO(process.stdin, process.stderr);
+    let result;
+    try {
+      result = await runSetup(args, io);
+    } catch (err) {
+      io.close();
+      if (err instanceof WizardInterruptError || err?.isWizardInterruptError) {
+        process.stderr.write("Setup interrupted. Run 'cleo setup' to continue.\n");
+        process.exit(130);
+      }
+      if (err instanceof WizardInterruptError) {
+        process.stderr.write("Setup interrupted. Run 'cleo setup' to continue.\n");
+        process.exit(130);
+      }
+      if (err instanceof SetupConfigJsonError) {
+        cliError(err.message, 6, { name: err.codeName, fix: err.fix });
+        process.exit(6);
+      }
+      if (StdinClosedError.is(err)) {
+        cliError(err.message, 1, {
+          name: err.codeName,
+          fix: "Run cleo setup interactively (with a TTY) or use --non-interactive flags."
+        });
+        process.exit(1);
+      }
+      throw err;
+    } finally {
+      io.close();
+    }
+    cliOutput(result, {
+      command: "setup",
+      operation: "setup.run",
+      message: result.ok ? `Setup completed (${result.sectionsRun.length} section(s)).` : `Setup finished with errors (${result.sectionsRun.length} section(s)).`
+    });
+    if (result.ok && result.firstRunComplete) {
+      await printWhoamiSummaryAndOfferTui(io);
+    }
+    if (!result.ok) {
+      process.exit(1);
+    }
+  }
+});
+export {
+  buildWizardOptions,
+  runSetup,
+  setupCommand
+};
+//# sourceMappingURL=setup-L3YYV53D.js.map

package/dist/cli/show-364V3KY2.js

@@ -0,0 +1,123 @@
+(() => {
+  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 {
+  getOperationParams,
+  paramsToCittyArgs
+} from "./chunk-RRKP7HLU.js";
+import {
+  dispatchFromCli,
+  dispatchRaw
+} from "./chunk-L7ONYSV6.js";
+import "./chunk-6N6WGLXE.js";
+import "./chunk-4VASFLUW.js";
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import "./chunk-QKMBWYAS.js";
+import {
+  cliOutput
+} from "./chunk-4RGSNUUP.js";
+import "./chunk-6JSJNYH2.js";
+import "./chunk-D7BAQNV2.js";
+import "./chunk-TYC7G5LF.js";
+
+// packages/cleo/src/cli/commands/show.ts
+var showCommand = defineCommand({
+  meta: {
+    name: "show",
+    description: "Show task details by ID. Accepts SEVERAL ids \u2014 `cleo show T1 T2 T3` returns them in one envelope and pays CLI startup once instead of per task (gh#1207). MVI-projected (id + title + status + key metadata) by default; pass --verbose / --full to receive the complete record with description, acceptance, verification, evidence, etc. (T9922)"
+  },
+  args: {
+    ...paramsToCittyArgs(getOperationParams("query", "tasks", "show")),
+    // T9922 — MVI record projection opt-out flags. The global parser in
+    // cli/index.ts reads these too; the declarations here surface them in
+    // `cleo show --help` and document the contract for agents.
+    verbose: {
+      type: "boolean",
+      description: "Return the full task record (description, acceptance, verification, evidence) instead of the MVI projection. T9922."
+    },
+    full: {
+      type: "boolean",
+      description: "Alias for --verbose. T9922."
+    },
+    // T9932 — 1-line summary render. Global flag; parsed by cli/index.ts.
+    summary: {
+      type: "boolean",
+      description: 'Render the task as a single line "<id> [<status>] <title-truncated-60>". Composes with --output: --output {id|table|count|silent} wins. T9932.'
+    }
+  },
+  async run({ args }) {
+    const shared = {
+      history: args["history"] === true,
+      ivtrHistory: args["ivtr-history"] === true,
+      relations: args["relations"] === true
+    };
+    const ids = collectTaskIds(args);
+    if (ids.length <= 1) {
+      await dispatchFromCli(
+        "query",
+        "tasks",
+        "show",
+        { taskId: args["taskId"], ...shared },
+        { command: "show" }
+      );
+      return;
+    }
+    const tasks = [];
+    const notFound = [];
+    for (const taskId of ids) {
+      const res = await dispatchRaw("query", "tasks", "show", { taskId, ...shared });
+      if (res.success) {
+        tasks.push(unwrapShowRecord(res.data));
+      } else {
+        notFound.push({
+          taskId,
+          reason: res.error?.message ?? "not found"
+        });
+      }
+    }
+    cliOutput(
+      { tasks, count: tasks.length, requested: ids.length, notFound },
+      { command: "show", operation: "tasks.show.batch" }
+    );
+    if (notFound.length > 0 && (process.exitCode ?? 0) === 0) {
+      process.exitCode = 1;
+    }
+  }
+});
+function unwrapShowRecord(data) {
+  if (typeof data !== "object" || data === null || !("task" in data)) return data;
+  const wrapped = data;
+  return typeof wrapped.task === "object" && wrapped.task !== null ? wrapped.task : data;
+}
+function collectTaskIds(args) {
+  const out = [];
+  const push = (v) => {
+    if (typeof v !== "string") return;
+    const id = v.trim();
+    if (id.length === 0 || id.startsWith("-")) return;
+    if (!out.includes(id)) out.push(id);
+  };
+  push(args["taskId"]);
+  const rest = args["_"];
+  if (Array.isArray(rest)) for (const v of rest) push(v);
+  return out;
+}
+export {
+  showCommand,
+  unwrapShowRecord
+};
+//# sourceMappingURL=show-364V3KY2.js.map

package/dist/cli/skill-F2KR6HW5.js

@@ -0,0 +1,84 @@
+(() => {
+  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 {
+  isSubCommandDispatch
+} from "./chunk-YY66LFZF.js";
+import {
+  defineCommand
+} from "./chunk-PKKZPOOP.js";
+import {
+  cliError,
+  cliOutput
+} from "./chunk-4RGSNUUP.js";
+import "./chunk-6JSJNYH2.js";
+
+// packages/cleo/src/cli/commands/skill.ts
+var restoreCommand = defineCommand({
+  meta: {
+    name: "restore",
+    description: "Restore a previously-archived skill from ~/.cleo/skills/.archive/"
+  },
+  args: {
+    "skill-name": {
+      type: "positional",
+      description: "Name of the archived skill to restore",
+      required: true
+    }
+  },
+  async run({ args }) {
+    const name = args["skill-name"];
+    try {
+      const { restoreSkillFromArchive } = await import("@cleocode/core/sentient/curator.js");
+      const result = await restoreSkillFromArchive(name);
+      cliOutput(
+        {
+          name: result.name,
+          restoredTo: result.restoredTo,
+          restoredFrom: result.restoredFrom,
+          restoredAt: result.restoredAt
+        },
+        {
+          command: "skill restore",
+          operation: "skill.restore",
+          message: `restored ${result.name} \u2192 ${result.restoredTo}`
+        }
+      );
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      cliError(message, "E_RESTORE_FAILED", void 0, { operation: "skill.restore" });
+      process.exit(1);
+    }
+  }
+});
+var skillCommand = defineCommand({
+  meta: {
+    name: "skill",
+    description: "Single-skill operations (restore, \u2026)"
+  },
+  subCommands: {
+    restore: restoreCommand
+  },
+  async run({ cmd, rawArgs }) {
+    if (isSubCommandDispatch(rawArgs, cmd.subCommands)) return;
+    process.stdout.write(
+      "usage: cleo skill restore <name>\n       see `cleo skill --help` for the full list of single-skill verbs.\n"
+    );
+  }
+});
+export {
+  skillCommand
+};
+//# sourceMappingURL=skill-F2KR6HW5.js.map