@wirecat/cli-core 0.561.0 → 0.562.0

package/CHANGELOG.md

@@ -5,7 +5,23 @@ Notable changes to `@wirecat/cli-core` (`@wirecat/cli-messaging` up to 0.261.0,
 minor version may break callers, and says how under "Changed — may break callers". `pnpm docs:check` checks the
 shape of this file.
 
-## Unreleased
+## 0.562.0 — 03.11.2026
+
+### Added
+
+- **A CLI can write each of its settings into its config file with the default, so the owner sees every setting
+  there.** A CLI declares its scalar settings as `DeclaredSetting` (`key`, `default`, `description`).
+  `withSettingDefaults(raw, declared)` returns the file with each missing setting added at its default. It keeps the
+  owner's values, their order and unknown keys. It does not create a section that is not there.
+  `settingRows(raw, declared)` gives `config show` each setting with its value, default, description and `from`
+  (`config file` or `default`). memo is the first user (cli-base WC-CMD-30).
+- **`KEEP_SUCCESSFUL_RUNS_FOR_DAYS` and `RUNS_SIZE_LIMIT_MB` are exported** beside `KEEP_RUNS_FOR_DAYS`. A host can
+  then name the run-record defaults it writes into its config file.
+
+### Fixed
+
+- **The shared `doctor` (`appDoctorCommand`) answers with the clock:** `meta.now`, `meta.now_local` and
+  `meta.timezone`, as a setup check should (WC-TIME-7). A CLI that kept its own doctor for this can use the shared one.
 
 ## 0.561.0 — 03.11.2026
 

package/dist/cli/app-doctor-command.js

@@ -2,6 +2,8 @@ import { existsSync } from "node:fs";
 import { dirname, resolve } from "node:path";
 import { CliError, configFilePath, resolvePaths } from "@wirecat/cli-base";
 import { annotate } from "@wirecat/cli-base/commands";
+import { timezoneOf } from "@wirecat/cli-base/query";
+import { clockMeta } from "@wirecat/cli-base/standards";
 import { isNewer, latestVersion } from "@wirecat/cli-base/update";
 import { Command } from "commander";
 import { envName, readOnlyLockOf } from "../ports/app.js";
@@ -149,7 +151,7 @@ export const appDoctorCommand = (app, configuration, options = {}) => profileFre
         ? await onlineCheck(app, env, environment.fetch ?? fetch, options)
         : undefined;
     const output = outputFor(this);
-    renderAnswer(this, output, itemOf({ ...report, ...local.fields, ...(online ? { online } : {}) }));
+    renderAnswer(this, output, itemOf({ ...report, ...local.fields, ...(online ? { online } : {}) }, { meta: clockMeta(Date.now(), timezoneOf()) }));
     for (const fix of fixes)
         output.renderer.note(`to make it private: ${fix}`);
     for (const note of local.notes)

package/dist/cli/index.d.ts

@@ -26,7 +26,7 @@ export { type CacheEvent, type DiagnosticEvent, type EventSink, providerErrorKey
 export { CORE_LOG_EVENTS } from "../runs/log-events.js";
 export { openProviderLog, PROVIDER_LOG_BYTES, type ProviderWarnings, providerLogPathFor, providerWarnings, writeProviderWarning, } from "../runs/provider-log.js";
 export { crashOf, type Recording, type RecordingOptions, recorded, startRecording, wasSettled, } from "../runs/recording.js";
-export { findRun, KEEP_RUNS_FOR_DAYS, listRuns, pruneRuns, type RunContext, type RunMetadata, readEvents, runsDirFor, runtime, startRun, } from "../runs/run.js";
+export { findRun, KEEP_RUNS_FOR_DAYS, KEEP_SUCCESSFUL_RUNS_FOR_DAYS, listRuns, pruneRuns, RUNS_SIZE_LIMIT_MB, type RunContext, type RunMetadata, readEvents, runsDirFor, runtime, startRun, } from "../runs/run.js";
 export { runContextOf, secretInput } from "../runs/run-context.js";
 export { type Attempt, currentAttempt, currentRun, inRun, type RunScope, runEvent, useAsProcessRun, withAttempt, } from "../runs/scope.js";
 export { LANGUAGES } from "../search/languages.js";
@@ -119,6 +119,7 @@ export { type ProjectStatusHints, type ProjectStatusItem, projectStatusAnswer, p
 export { STATUS_ROWS, STATUS_SIGNAL_ROWS } from "./project-status-rows.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
 export type { ScheduleHost } from "./schedule/schedule-command.js";
+export { type DeclaredSetting, type SettingRow, settingRows, withSettingDefaults } from "./setting-defaults.js";
 export { type Config, type Configuration, count, first, flag, fromFile, type GlobalFlags, NONE_NAMED, namedProfile, type ProfileKind, plain, type ResolveOptions, type Settings, type SettingsExtension, type SettingsExtensionContext, type Source, settingsFor, } from "./settings.js";
 export { type PermissionAnswer, readSetupAnswers, type SetupAnswers, setupPermissionCeiling } from "./setup-answers.js";
 export { AGENTS, type Agent, agentFor, screenFor } from "./setup-screen.js";

package/dist/cli/index.js

@@ -22,7 +22,7 @@ export { providerErrorKey, renderEvent, } from "../runs/events.js";
 export { CORE_LOG_EVENTS } from "../runs/log-events.js";
 export { openProviderLog, PROVIDER_LOG_BYTES, providerLogPathFor, providerWarnings, writeProviderWarning, } from "../runs/provider-log.js";
 export { crashOf, recorded, startRecording, wasSettled, } from "../runs/recording.js";
-export { findRun, KEEP_RUNS_FOR_DAYS, listRuns, pruneRuns, readEvents, runsDirFor, runtime, startRun, } from "../runs/run.js";
+export { findRun, KEEP_RUNS_FOR_DAYS, KEEP_SUCCESSFUL_RUNS_FOR_DAYS, listRuns, pruneRuns, RUNS_SIZE_LIMIT_MB, readEvents, runsDirFor, runtime, startRun, } from "../runs/run.js";
 export { runContextOf, secretInput } from "../runs/run-context.js";
 export { currentAttempt, currentRun, inRun, runEvent, useAsProcessRun, withAttempt, } from "../runs/scope.js";
 export { LANGUAGES } from "../search/languages.js";
@@ -108,6 +108,7 @@ export { projectAnswerParts, projectCutoffTime, projectEvidenceText, projectWind
 export { projectStatusAnswer, projectStatusRow, projectStatusSchema, projectStatusText, } from "./project-status.js";
 export { STATUS_ROWS, STATUS_SIGNAL_ROWS } from "./project-status-rows.js";
 export { fieldsOf, projectFields } from "./result-fields.js";
+export { settingRows, withSettingDefaults } from "./setting-defaults.js";
 export { count, first, flag, fromFile, NONE_NAMED, namedProfile, plain, settingsFor, } from "./settings.js";
 export { readSetupAnswers, setupPermissionCeiling } from "./setup-answers.js";
 export { AGENTS, agentFor, screenFor } from "./setup-screen.js";

package/dist/cli/setting-defaults.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A scalar setting a CLI writes into its config file with its default, so the owner finds and edits it there without
+ * reading the docs (WC-CMD-30). Never declare a secret: `config show` prints every declared value.
+ */
+export interface DeclaredSetting {
+    /** The dotted path in the file. A nested setting is written only where its section already exists. */
+    key: string;
+    default: string | number | boolean;
+    description: string;
+}
+export interface SettingRow {
+    setting: string;
+    value: unknown;
+    default: string | number | boolean;
+    from: "config file" | "default";
+    description: string;
+}
+/**
+ * The file with every declared setting it lacks, at its default. What the owner wrote stays as written, in its order,
+ * unknown keys included; a section that is not there is not created, since it may need fields no default can give.
+ */
+export declare const withSettingDefaults: (raw: unknown, declared: readonly DeclaredSetting[]) => {
+    config: unknown;
+    added: string[];
+};
+/** Every declared setting with what holds and whether the file says it, for `config show`. */
+export declare const settingRows: (raw: unknown, declared: readonly DeclaredSetting[]) => SettingRow[];

package/dist/cli/setting-defaults.js

@@ -0,0 +1,36 @@
+const isNode = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parentOf = (config, key) => {
+    const path = key.split(".");
+    const leaf = path.pop();
+    return { node: path.reduce((node, part) => (isNode(node) ? node[part] : undefined), config), leaf };
+};
+/**
+ * The file with every declared setting it lacks, at its default. What the owner wrote stays as written, in its order,
+ * unknown keys included; a section that is not there is not created, since it may need fields no default can give.
+ */
+export const withSettingDefaults = (raw, declared) => {
+    if (raw !== undefined && !isNode(raw))
+        return { config: raw, added: [] };
+    const config = raw === undefined ? {} : structuredClone(raw);
+    const added = [];
+    for (const setting of declared) {
+        const { node, leaf } = parentOf(config, setting.key);
+        if (!isNode(node) || Object.hasOwn(node, leaf))
+            continue;
+        node[leaf] = setting.default;
+        added.push(setting.key);
+    }
+    return { config, added };
+};
+/** Every declared setting with what holds and whether the file says it, for `config show`. */
+export const settingRows = (raw, declared) => declared.map((setting) => {
+    const { node, leaf } = isNode(raw) ? parentOf(raw, setting.key) : { node: undefined, leaf: "" };
+    const written = isNode(node) && Object.hasOwn(node, leaf);
+    return {
+        setting: setting.key,
+        value: written ? node[leaf] : setting.default,
+        default: setting.default,
+        from: written ? "config file" : "default",
+        description: setting.description,
+    };
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.561.0",
+  "version": "0.562.0",
   "description": "The messenger-neutral half of a messaging CLI: domain model, message locators, rendering, name resolution, the SQLite seam, the command skeleton and shared read commands, the send guard, run records and the message store",
   "license": "Apache-2.0",
   "author": "Viacheslav Ptsarev",