humanish 0.56.0 → 0.58.0

package/dist/run.d.ts

@@ -1045,6 +1045,15 @@ export interface DoctorResult {
         name: string;
         ok: boolean;
         message: string;
+        /**
+       * ADDITIVE + OPTIONAL. `false` means the check never ran — the directory could not be read, so
+       * there is nothing to report about it either way. Absent means it ran and `ok` is its verdict.
+       *
+       * It exists because a failed check and an unrun one used to render identically, and the unrun
+       * rows carried the SUCCESS text: a participant read `missing package.json: package.json is
+       * present and safe to read` off a real screen (labs/tui-self-study.yaml).
+       */
+        checked?: boolean;
     }>;
 }
 /**

package/dist/run.js

@@ -25,6 +25,7 @@ import { bindExistingRunArtifactPaths, RUNS_RELATIVE_ROOT, isSafeRunIdSegment, p
 import { probeKeySources } from "./key-resolution.js";
 import { beginRunStatus, withRunStatusScope } from "./run-status.js";
 import { nodeSupportsTui, terminalSurfaceMessage, tuiBundleUrl } from "./tui-contract.js";
+import { detectLocalAgents, localAgentDoctorMessage } from "./local-agent-cli.js";
 import { assertPreparedSelectedOutputDirectory, assertSafeOutputPathSegment, bindExistingManagedHumanishOutputDirectory, prepareContainedOutputDirectory, prepareContainedOutputDirectoryRoot, prepareContainedOutputFile, prepareSelectedOutputDirectory, readContainedRegularFile, writeContainedOutputFile, writePreparedRunLatestPointer } from "./selected-output-paths.js";
 export const RUN_BUNDLE_SCHEMA = "humanish.run-bundle.v1";
 export const SHARED_WORLD_SCHEMA = "humanish.shared-world.v1";
@@ -2960,10 +2961,10 @@ export async function doctor(cwdInput) {
     const cwdOk = await validateCwd(cwd).then((error) => error === null).catch(() => false);
     if (!cwdOk) {
         const checks = [
-            { name: "target cwd", ok: false, message: "target directory exists" },
-            { name: "package.json", ok: false, message: "package.json is present and safe to read" },
-            { name: "humanish source", ok: false, message: "committed humanish/ source directory is present and safe to read" },
-            { name: "runtime ignore", ok: false, message: ".gitignore safely contains .humanish/" }
+            { name: "target cwd", ok: false, message: "this directory does not exist, or humanish cannot read it" },
+            { name: "package.json", ok: false, checked: false, message: "not checked — the target directory could not be read" },
+            { name: "humanish source", ok: false, checked: false, message: "not checked — the target directory could not be read" },
+            { name: "runtime ignore", ok: false, checked: false, message: "not checked — the target directory could not be read" }
         ];
         return { schema: DOCTOR_SCHEMA, ok: false, cwd, checks };
     }
@@ -2974,9 +2975,9 @@ export async function doctor(cwdInput) {
     catch {
         const checks = [
             { name: "target cwd", ok: false, message: "target directory failed containment validation" },
-            { name: "package.json", ok: false, message: "package.json is present and safe to read" },
-            { name: "humanish source", ok: false, message: "committed humanish/ source directory is present and safe to read" },
-            { name: "runtime ignore", ok: false, message: ".gitignore safely contains .humanish/" }
+            { name: "package.json", ok: false, checked: false, message: "not checked — containment validation failed first" },
+            { name: "humanish source", ok: false, checked: false, message: "not checked — containment validation failed first" },
+            { name: "runtime ignore", ok: false, checked: false, message: "not checked — containment validation failed first" }
         ];
         return { schema: DOCTOR_SCHEMA, ok: false, cwd, checks };
     }
@@ -3056,6 +3057,14 @@ export async function doctor(cwdInput) {
                 })
             };
         })(),
+        // The operator's own signed-in coding agent, reported as a CAPABILITY and never a gate: a
+        // machine with none is not broken, it just needs a provider key. This row exists because
+        // "go make an API key" is where most people trying humanish stop, and a developer very often
+        // already has one of these signed in.
+        ...await (async () => {
+            const found = await detectLocalAgents();
+            return [{ name: "local agents", ok: true, message: localAgentDoctorMessage(found) }];
+        })(),
         // Provider-key discovery (#436): which source supplies each live-run key, through the same
         // chain a live command resolves (env/--env-file, project overlay, vendor stores, the
         // humanish user store). Values never appear; sources and fill commands do.