@wirecat/cli-core 0.523.0 → 0.524.0

package/CHANGELOG.md

@@ -5,7 +5,13 @@ 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.524.0 — 01.11.2026
+
+### Added
+
+- **`appDoctorCommand` takes a `local` check.** A CLI that is not a messenger can now put what it reads of its own
+  state from disk into `doctor` — a run that stopped half way, an undo window about to close — without `--online`.
+  Its fields join the answer and its notes go to stderr; a throw is reported as `local.error`, never a failed doctor.
 
 ## 0.523.0 — 01.11.2026
 

package/dist/cli/app-doctor-command.d.ts

@@ -18,6 +18,14 @@ export interface AppDoctorOptions {
     online?: (env: NodeJS.ProcessEnv) => Promise<{
         ok: boolean;
     } & Record<string, unknown>>;
+    /**
+     * What the CLI reads of its own state from disk, with no call out: a run left half done, a deadline near. `fields`
+     * join the answer; each of `notes` goes to stderr, as a fix does. A throw is reported as `local.error`.
+     */
+    local?: (env: NodeJS.ProcessEnv) => {
+        fields: Record<string, unknown>;
+        notes?: string[];
+    };
 }
 /**
  * Run when everything else is broken, so a problem in the config file or the OAuth setting is a field, never a throw.

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

@@ -13,6 +13,17 @@ import { itemOf, renderAnswer } from "./envelope.js";
 import { privateFiles } from "./messenger/private-files.js";
 import { unknownPermissionIssues } from "./permission-keys.js";
 import { profileFree } from "./profile.js";
+const localCheck = (env, options) => {
+    if (!options.local)
+        return { fields: {}, notes: [] };
+    try {
+        const { fields, notes = [] } = options.local(env);
+        return { fields, notes };
+    }
+    catch (error) {
+        return { fields: { local: { error: error instanceof Error ? error.message : String(error) } }, notes: [] };
+    }
+};
 const onlineCheck = async (app, env, fetcher, options) => {
     const started = Date.now();
     let service = { ok: true };
@@ -133,11 +144,14 @@ export const appDoctorCommand = (app, configuration, options = {}) => profileFre
     const environment = environmentOf(this);
     const env = environment.env ?? process.env;
     const { report, fixes } = appDoctorReport(app, configuration, env, this, options);
+    const local = localCheck(env, options);
     const online = this.opts().online
         ? await onlineCheck(app, env, environment.fetch ?? fetch, options)
         : undefined;
     const output = outputFor(this);
-    renderAnswer(this, output, itemOf(online ? { ...report, online } : report));
+    renderAnswer(this, output, itemOf({ ...report, ...local.fields, ...(online ? { online } : {}) }));
     for (const fix of fixes)
         output.renderer.note(`to make it private: ${fix}`);
+    for (const note of local.notes)
+        output.renderer.note(note);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wirecat/cli-core",
-  "version": "0.523.0",
+  "version": "0.524.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",