humanish 0.104.2 → 0.105.0

package/dist/persona-resolve.d.ts

@@ -5,8 +5,8 @@ export declare const PERSONA_ID_PATTERN: RegExp;
 /** Title-case an id for the fallback display name (`skeptical-power-user` -> `Skeptical Power User`). */
 export declare function personaTitleFromId(personaId: string): string;
 /**
- * Resolve ONE committed persona. Returns `null` (never a throw, never a guess) when the id is
- * unsafe or no file exists, so a lane always runs.
+ * Resolve ONE committed persona. Returns `null` with a warning when the id is
+ * unsafe or no file exists. Invalid rich backgrounds reject the study before execution.
  */
 export declare function resolveCommittedPersona(projectRoot: PreparedSelectedOutputDirectory, personaId: string): Promise<{
     persona: ResolvedPersona | null;

package/dist/persona-resolve.js

@@ -1,24 +1,9 @@
-// Resolve committed persona files into compiled personas, for EVERY lane (#381).
-//
-// #308 gave the terminal lane this: read `humanish/personas/<id>.yaml`, compile the traits into
-// behavioral directives, and record truthfully which traits were applied. The computer-use lanes
-// never got it — they composed a bare `Persona: <id>.` line and hardcoded `traitsApplied: []`, so
-// on browser routes the persona axis was a label rather than a behavior. A live two-lane contrast
-// (an impatient expert vs a patient newcomer, same app, same mission) came back with near-identical
-// action profiles, which read like evidence that personas do not matter and was actually evidence
-// that personas were never applied.
-//
-// This module is the shared implementation so the two routes cannot drift again: one containment
-// rule, one compiler, one fallback polarity.
-//
-// FAIL-SAFE, not fail-closed — deliberately the opposite polarity to the scorer loader. A persona
-// that declared nothing must never be given fabricated traits, so an unsafe id, a missing file, or
-// unparseable YAML falls back to the bare id line with a truthful EMPTY traitsApplied (warning only
-// when the file existed but could not be read). Silence here is honest; invention would not be.
+// Shared contained persona resolution for browser and terminal participants.
 import { parse as parseYaml } from "yaml";
 import path from "node:path";
-import { parseResolvedPersona } from "./persona.js";
+import { parseResolvedPersona, PersonaConfigError } from "./persona.js";
 import { prepareSelectedOutputDirectory, readContainedRegularFile } from "./selected-output-paths.js";
+import { digestText, redactText } from "./redaction.js";
 import { realpath } from "node:fs/promises";
 /** Persona ids are file-name segments, never paths: the same grammar the terminal lane enforces. */
 export const PERSONA_ID_PATTERN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
@@ -31,12 +16,12 @@ export function personaTitleFromId(personaId) {
         .join(" ");
 }
 /**
- * Resolve ONE committed persona. Returns `null` (never a throw, never a guess) when the id is
- * unsafe or no file exists, so a lane always runs.
+ * Resolve ONE committed persona. Returns `null` with a warning when the id is
+ * unsafe or no file exists. Invalid rich backgrounds reject the study before execution.
  */
 export async function resolveCommittedPersona(projectRoot, personaId) {
     if (!PERSONA_ID_PATTERN.test(personaId)) {
-        return { persona: null, warnings: [] };
+        return { persona: null, warnings: ["Persona id is not a safe filename; using the id only (no persona context)."] };
     }
     for (const candidate of [
         path.posix.join("humanish", "personas", `${personaId}.yaml`),
@@ -55,9 +40,12 @@ export async function resolveCommittedPersona(projectRoot, personaId) {
                 warnings: [`${candidate} could not be parsed as YAML; the lane ran with the persona id only (no traits applied).`]
             };
         }
-        return { persona: parseResolvedPersona(raw, { id: personaId, name: personaTitleFromId(personaId) }), warnings: [] };
+        const warnings = [];
+        const persona = parseResolvedPersona(raw, { id: personaId, name: personaTitleFromId(personaId) }, warnings);
+        persona.sourceDigest = digestText(bytes.toString("utf8"));
+        return { persona, warnings: warnings.map(warning => `${candidate}: ${warning}`) };
     }
-    return { persona: null, warnings: [] };
+    return { persona: null, warnings: [`Persona ${redactText(personaId)} has no readable file under humanish/personas; using the id only (no persona context).`] };
 }
 /**
  * Resolve every distinct persona id a run will use, once, before lane specs are built. Returning a
@@ -102,8 +90,10 @@ export async function resolveCommittedPersonasForCwd(cwd, personaIds) {
         const projectRoot = await prepareSelectedOutputDirectory(path.dirname(physical), physical);
         return await resolveCommittedPersonas(projectRoot, personaIds);
     }
-    catch {
-        return { personas: new Map(), warnings: [] };
+    catch (error) {
+        if (error instanceof PersonaConfigError)
+            throw error;
+        return { personas: new Map(), warnings: ["Persona directory could not be read; no persona context was loaded."] };
     }
 }
 //# sourceMappingURL=persona-resolve.js.map

package/dist/persona-resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"persona-resolve.js","sourceRoot":"","sources":["../src/persona-resolve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"persona-resolve.js","sourceRoot":"","sources":["../src/persona-resolve.ts"],"names":[],"mappings":"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"}

package/dist/persona.d.ts

@@ -1,11 +1,20 @@
+import type { ActorPersonaRef } from "./actor-contract.js";
 export type PersonaLevel = "low" | "medium" | "high";
+export declare const PERSONA_BACKGROUND_MAX_BYTES: number;
+export declare const PERSONA_COMPILER_VERSION = 2;
+export declare class PersonaConfigError extends Error {
+    constructor(message: string);
+}
 export interface ResolvedPersona {
     id: string;
     name: string;
     summary?: string;
+    background?: string;
+    /** Digest of the source file, when resolved from disk. */
+    sourceDigest?: string;
     traits: {
-        patience: PersonaLevel;
-        skill: PersonaLevel;
+        patience?: PersonaLevel;
+        skill?: PersonaLevel;
         accessibilityNeeds?: string;
     };
     constraints: string[];
@@ -15,21 +24,16 @@ export interface PersonaDirectives {
     skillBias: string;
     accessibilityBehavior?: string;
     constraints: string[];
+    /** Directives included in the prompt, not proof of behavioral adherence. */
     traitsApplied: string[];
 }
-/**
- * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
- * supplies id/name when the document omits them (or is not a record at all).
- */
+/** Legacy short fields keep their bounds, but every discarded value is diagnosed. */
 export declare function parseResolvedPersona(raw: unknown, fallback: {
     id: string;
     name: string;
-}): ResolvedPersona;
+}, warnings?: string[]): ResolvedPersona;
 export declare function personaToDirectives(persona: ResolvedPersona): PersonaDirectives;
-/**
- * Render the persona section injected into an actor prompt. Replaces the bare
- * `Persona: <name>.` line so the persona's friction tolerance, skill, and
- * accessibility behavior actually shape the run. Returns a single space-joined
- * string to match the existing prompt-builder style.
- */
 export declare function renderPersonaPromptSection(persona: ResolvedPersona): string;
+/** Only the authored persona section; excludes task criteria, runtime grants and inbox URLs. */
+export declare function personaBrief(persona: ResolvedPersona, scrub?: (text: string) => string): NonNullable<ActorPersonaRef["brief"]>;
+export declare function scrubPersonaBrief(persona: ActorPersonaRef, scrub: (text: string) => string): ActorPersonaRef;

package/dist/persona.js

@@ -1,141 +1,144 @@
-// Compiles a committed persona (humanish/personas/*.yaml) into actor-neutral
-// behavioral directives so persona traits actually drive how the actor uses the
-// product, instead of being inert metadata. See docs/architecture/actor-contract.md.
-//
-// Patience is modeled as FRICTION TOLERANCE, never a turn/tool-call budget: the
-// directive tells the actor when, in character, to stop and report the friction.
-const LEVELS = ["low", "medium", "high"];
-function normalizeLevel(value, fallback = "medium") {
-    if (typeof value === "string") {
-        const lowered = value.trim().toLowerCase();
-        if (LEVELS.includes(lowered)) {
-            return lowered;
-        }
-    }
-    return fallback;
-}
-// Persona files are committed public-safe source, but they still flow into an
-// actor prompt, so replace control characters with spaces and cap length to
-// limit prompt-injection surface from a hand-authored persona.
-function stripControlChars(value) {
-    let out = "";
-    for (const ch of value) {
-        const code = ch.codePointAt(0) ?? 0;
-        out += code < 0x20 || code === 0x7f ? " " : ch;
-    }
-    return out;
-}
-function sanitizePersonaText(value, maxLength) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const cleaned = stripControlChars(value)
-        // Neutralize the actor verdict/nonce markers so persona text injected into a
-        // prompt cannot forge a verdict line an actor might echo back.
-        .replace(/HUMANISH_ACTOR_(?:VERDICT|NONCE)/gi, "HUMANISH_ACTOR_[neutralized]")
-        .replace(/\s+/g, " ")
-        .trim();
-    if (cleaned.length === 0) {
-        return undefined;
-    }
-    return cleaned.length > maxLength ? `${cleaned.slice(0, maxLength - 1)}…` : cleaned;
+import { digestText, redactText } from "./redaction.js";
+export const PERSONA_BACKGROUND_MAX_BYTES = 32 * 1024;
+export const PERSONA_COMPILER_VERSION = 2;
+export class PersonaConfigError extends Error {
+    constructor(message) { super(message); this.name = "PersonaConfigError"; }
 }
+const LEVELS = ["low", "medium", "high"];
+const PERSONA_FIELDS = new Set(["schema", "id", "name", "summary", "background", "traits", "constraints"]);
+const TRAIT_FIELDS = new Set(["patience", "technical_confidence", "accessibility_needs"]);
 function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
-/**
- * Parse a YAML-parsed persona object into a normalized ResolvedPersona. `fallback`
- * supplies id/name when the document omits them (or is not a record at all).
- */
-export function parseResolvedPersona(raw, fallback) {
+function cleanText(value) {
+    return value.replace(/\r\n?/g, "\n").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f\x7f]/g, " ")
+        .replace(/HUMANISH_ACTOR_(?:VERDICT|NONCE)/gi, "HUMANISH_ACTOR_[neutralized]").trim();
+}
+/** Legacy short fields keep their bounds, but every discarded value is diagnosed. */
+export function parseResolvedPersona(raw, fallback, warnings = []) {
     const record = isRecord(raw) ? raw : {};
     const traits = isRecord(record.traits) ? record.traits : {};
-    const id = sanitizePersonaText(record.id, 120) ?? fallback.id;
-    const name = sanitizePersonaText(record.name, 120) ?? fallback.name;
-    const summary = sanitizePersonaText(record.summary, 280);
-    const accessibilityNeeds = sanitizePersonaText(traits.accessibility_needs, 80);
-    const constraints = Array.isArray(record.constraints)
-        ? record.constraints
-            .map((entry) => sanitizePersonaText(entry, 160))
-            .filter((entry) => entry !== undefined)
-            .slice(0, 8)
-        : [];
+    if (!isRecord(raw))
+        warnings.push("Persona must be a mapping; using the legacy defaults.");
+    for (const field of Object.keys(record)) {
+        if (!PERSONA_FIELDS.has(field))
+            warnings.push(`Unsupported persona field ${redactText(JSON.stringify(field))}; it is not sent to the participant. Use background for relevant context.`);
+    }
+    for (const field of Object.keys(traits)) {
+        if (!TRAIT_FIELDS.has(field))
+            warnings.push(`Unsupported persona trait ${redactText(JSON.stringify(field))}; it is not sent to the participant.`);
+    }
+    const short = (value, max, field) => {
+        if (value === undefined)
+            return undefined;
+        if (typeof value !== "string") {
+            warnings.push(`${field} must be text; ignored.`);
+            return undefined;
+        }
+        const cleaned = cleanText(value).replace(/\s+/g, " ");
+        if (!cleaned)
+            return undefined;
+        if (cleaned.length > max)
+            warnings.push(`${field} exceeds ${max} characters and was shortened; move detailed context to background.`);
+        return cleaned.length > max ? `${cleaned.slice(0, max - 1)}…` : cleaned;
+    };
+    let background;
+    if (record.background !== undefined) {
+        if (typeof record.background !== "string")
+            throw new PersonaConfigError("Persona background must be text.");
+        background = cleanText(record.background);
+        if (!background)
+            throw new PersonaConfigError("Persona background must not be empty.");
+        if (Buffer.byteLength(record.background, "utf8") > PERSONA_BACKGROUND_MAX_BYTES || Buffer.byteLength(background, "utf8") > PERSONA_BACKGROUND_MAX_BYTES) {
+            throw new PersonaConfigError(`Persona background exceeds ${PERSONA_BACKGROUND_MAX_BYTES} UTF-8 bytes; shorten it explicitly. No background was truncated.`);
+        }
+    }
+    const level = (field) => {
+        const value = traits[field];
+        const normalized = typeof value === "string" ? value.trim().toLowerCase() : undefined;
+        if (LEVELS.includes(normalized))
+            return normalized;
+        if (value !== undefined)
+            warnings.push(`traits.${field} must be low, medium or high; ${background ? "ignored" : "using medium"}.`);
+        return background ? undefined : "medium";
+    };
+    if (record.traits !== undefined && !isRecord(record.traits))
+        warnings.push("Persona traits must be a mapping; invalid traits ignored.");
+    if (background && Object.keys(traits).some(field => field === "patience" || field === "technical_confidence")) {
+        warnings.push("Background and explicit trait directives are both sent to the participant. Review the brief for conflicting instructions; prose conflicts are not automatically detected.");
+    }
+    let accessibilityNeeds = short(traits.accessibility_needs, 80, "traits.accessibility_needs");
+    if (accessibilityNeeds && /^(none[ _-]declared|none|not[ _-]applicable)$/i.test(accessibilityNeeds))
+        accessibilityNeeds = undefined;
+    if (record.constraints !== undefined && !Array.isArray(record.constraints))
+        warnings.push("Persona constraints must be a list; ignored.");
+    const allConstraints = Array.isArray(record.constraints) ? record.constraints : [];
+    if (allConstraints.length > 8)
+        warnings.push("Only the first eight persona constraints are used; move detailed context to background.");
+    const constraints = allConstraints.slice(0, 8).map(value => short(value, 160, "constraint")).filter((value) => value !== undefined);
+    const patience = level("patience"), skill = level("technical_confidence");
+    const summary = short(record.summary, 280, "summary");
     return {
-        id,
-        name,
+        id: short(record.id, 120, "id") ?? fallback.id,
+        name: short(record.name, 120, "name") ?? fallback.name,
         ...(summary === undefined ? {} : { summary }),
-        traits: {
-            patience: normalizeLevel(traits.patience),
-            // Persona YAML uses `technical_confidence`; the directive model calls it skill.
-            skill: normalizeLevel(traits.technical_confidence),
-            ...(accessibilityNeeds === undefined ? {} : { accessibilityNeeds })
-        },
+        ...(background === undefined ? {} : { background }),
+        traits: { ...(patience === undefined ? {} : { patience }), ...(skill === undefined ? {} : { skill }), ...(accessibilityNeeds === undefined ? {} : { accessibilityNeeds }) },
         constraints
     };
 }
 const FRICTION_TOLERANCE = {
-    low: "You are impatient: if you hit repeated friction (errors, dead-ends, confusing UI) or stop making progress toward your goal, stop and report exactly what blocked you instead of pushing through.",
-    medium: "You have moderate patience: work through some friction, but if you repeatedly fail to make progress toward your goal, stop and report what blocked you.",
-    high: "You are determined: push through friction and try recovery paths, but if you reach an unrecoverable dead-end, stop and report it."
+    low: "You are impatient: if you hit repeated friction or stop making progress toward your goal, you are likely to stop. Describe what you actually encountered.",
+    medium: "You have moderate patience: you will work through some friction, but may stop if further effort no longer seems worthwhile.",
+    high: "You are determined: you are willing to spend effort on recovery when the goal matters to you, but may stop at an unrecoverable dead-end."
 };
-// Skill describes how COMPETENTLY an actor works the surfaces its population actually uses — it
-// must not name an affordance that escapes those surfaces. The `high` directive used to say
-// "inspect configuration, and try the recovery paths an expert would", which a computer-use actor
-// can honestly read as license to open devtools or type a `javascript:` URL: a human-persona run
-// then routes around the very friction the study exists to measure and still returns green. Skill
-// is now modality-neutral (an expert human uses advanced UI and settings; an expert agent uses the
-// documented API), so which affordances are in scope is a property of the declared population,
-// not a side effect of a trait table.
 const SKILL_BIAS = {
-    low: "You are not technically confident: prefer obvious UI affordances over CLI flags or config, and narrate your confusion whenever the interface is ambiguous.",
-    medium: "You have moderate technical confidence: use straightforward paths and try one recovery step before giving up.",
-    high: "You are technically confident: use keyboard shortcuts, the product's own advanced options and settings, and the recovery paths an expert would try on the surfaces this product gives you."
+    low: "You are not technically confident and generally rely on familiar, visible controls. Describe confusion only when you actually encounter it.",
+    medium: "You have moderate technical confidence and generally use straightforward paths through the product.",
+    high: "You are technically confident and comfortable with keyboard shortcuts and advanced options on the surfaces this product gives you."
 };
 function accessibilityBehavior(needs) {
-    const lowered = needs.toLowerCase();
-    if (lowered.includes("keyboard")) {
-        return "Navigate using the keyboard; treat a control that requires a mouse and offers no keyboard path as a defect and report it.";
-    }
-    if (lowered.includes("terminal") || lowered.includes("output")) {
-        return "You rely on clear terminal output; flag noisy, unreadable, or ambiguous output as a defect.";
-    }
-    return `You have the accessibility need "${needs}"; treat violations of it as defects and report them.`;
+    if (/keyboard[ _-]first/i.test(needs))
+        return "You prefer keyboard navigation, but can use a pointer when needed. Describe any difficulty you encounter switching between them.";
+    if (/keyboard[ _-]only/i.test(needs))
+        return "You can only use the keyboard. If an essential control has no discoverable keyboard path, describe where you could not proceed.";
+    if (/terminal|output/i.test(needs))
+        return "You rely on clear terminal output. Describe any difficulty understanding the output you actually encounter.";
+    return `Your accessibility requirement is: ${needs}. Use the available interface within this requirement and describe any difficulty you encounter.`;
 }
 export function personaToDirectives(persona) {
-    const traitsApplied = [`patience:${persona.traits.patience}`, `skill:${persona.traits.skill}`];
-    const accessibility = persona.traits.accessibilityNeeds
-        ? accessibilityBehavior(persona.traits.accessibilityNeeds)
-        : undefined;
-    if (persona.traits.accessibilityNeeds) {
-        traitsApplied.push(`accessibility:${persona.traits.accessibilityNeeds}`);
-    }
-    if (persona.constraints.length > 0) {
+    const { patience, skill, accessibilityNeeds } = persona.traits;
+    const traitsApplied = [...(patience ? [`patience:${patience}`] : []), ...(skill ? [`skill:${skill}`] : [])];
+    if (accessibilityNeeds)
+        traitsApplied.push(`accessibility:${accessibilityNeeds}`);
+    if (persona.constraints.length)
         traitsApplied.push(`constraints:${persona.constraints.length}`);
-    }
     return {
-        frictionTolerance: FRICTION_TOLERANCE[persona.traits.patience],
-        skillBias: SKILL_BIAS[persona.traits.skill],
-        ...(accessibility === undefined ? {} : { accessibilityBehavior: accessibility }),
-        constraints: persona.constraints,
-        traitsApplied
+        frictionTolerance: patience ? FRICTION_TOLERANCE[patience] : "",
+        skillBias: skill ? SKILL_BIAS[skill] : "",
+        ...(accessibilityNeeds ? { accessibilityBehavior: accessibilityBehavior(accessibilityNeeds) } : {}),
+        constraints: persona.constraints, traitsApplied
     };
 }
-/**
- * Render the persona section injected into an actor prompt. Replaces the bare
- * `Persona: <name>.` line so the persona's friction tolerance, skill, and
- * accessibility behavior actually shape the run. Returns a single space-joined
- * string to match the existing prompt-builder style.
- */
 export function renderPersonaPromptSection(persona) {
     const directives = personaToDirectives(persona);
-    const parts = [
-        `Persona: ${persona.name}.`,
-        ...(persona.summary ? [persona.summary] : []),
-        directives.frictionTolerance,
-        directives.skillBias,
-        ...(directives.accessibilityBehavior ? [directives.accessibilityBehavior] : []),
-        ...(directives.constraints.length > 0 ? [`Honor these constraints: ${directives.constraints.join("; ")}.`] : [])
-    ];
-    return parts.join(" ");
+    return [
+        `Persona: ${persona.name}.`, persona.summary,
+        persona.background ? `Background:\n${persona.background}` : undefined,
+        directives.frictionTolerance, directives.skillBias, directives.accessibilityBehavior,
+        persona.constraints.length ? `Honor these constraints: ${persona.constraints.join("; ")}.` : undefined
+    ].filter(Boolean).join("\n\n");
+}
+/** Only the authored persona section; excludes task criteria, runtime grants and inbox URLs. */
+export function personaBrief(persona, scrub = text => text) {
+    const original = renderPersonaPromptSection(persona), text = redactText(scrub(original));
+    return { compilerVersion: PERSONA_COMPILER_VERSION, text, digest: digestText(original), redacted: text !== original,
+        ...(persona.sourceDigest ? { sourceDigest: persona.sourceDigest } : {}) };
+}
+export function scrubPersonaBrief(persona, scrub) {
+    if (!persona.brief)
+        return persona;
+    const text = redactText(scrub(persona.brief.text));
+    return { ...persona, brief: { ...persona.brief, text, redacted: persona.brief.redacted || text !== persona.brief.text } };
 }
 //# sourceMappingURL=persona.js.map

package/dist/persona.js.map

@@ -1 +1 @@
-{"version":3,"file":"persona.js","sourceRoot":"","sources":["../src/persona.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"persona.js","sourceRoot":"","sources":["../src/persona.ts"],"names":[],"mappings":"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"}

package/dist/program.js

@@ -1351,6 +1351,7 @@ function registerCommsCommands(parent, io) {
         .option("--port <port>", "Port for capture + inbox (default 8025).", String(DEFAULT_SANDBOX_CATCH_PORT))
         .option("--dir <path>", "Directory for the deliveries log and rendered inbox.", ".humanish/comms-catch")
         .option("--token <value>", "Require this bearer token on GET /deliveries (recommended when reachable off-host).")
+        .option("--smtp-port <port>", "Also capture SMTP mail on 127.0.0.1:<port>. Point your app's SMTP transport here.")
         .option("--inbox-port <port>", "Also serve a READ-ONLY inbox listener on 0.0.0.0:<port>, so a persona on another machine can open /inbox. Without it the catch stays loopback-only.")
         .option("--recipient <address>", "Only render mail sent to this address (repeatable). Default: render whatever the app actually mailed.", (value, previous = []) => [...previous, value])
         .action(async (options) => {
@@ -1374,11 +1375,26 @@ function registerCommsCommands(parent, io) {
                 return;
             }
         }
+        let smtpPort;
+        if (options.smtpPort !== undefined) {
+            smtpPort = Number(options.smtpPort);
+            if (!Number.isInteger(smtpPort) || smtpPort <= 0 || smtpPort > 65_534) {
+                io.writeErr("--smtp-port must be an integer between 1 and 65534.\n");
+                io.setExitCode(2);
+                return;
+            }
+            if (smtpPort === port || smtpPort === inboxPort) {
+                io.writeErr("--smtp-port must differ from --port and --inbox-port.\n");
+                io.setExitCode(2);
+                return;
+            }
+        }
         await runCommsCatchHost({
             port,
             dir: options.dir,
             ...(options.token ? { token: options.token } : {}),
             ...(inboxPort === undefined ? {} : { inboxPort }),
+            ...(smtpPort === undefined ? {} : { smtpPort }),
             ...(options.recipient && options.recipient.length > 0 ? { recipients: options.recipient } : {})
         }, io);
     });
@@ -3680,6 +3696,7 @@ function formatLabInspectHuman(result) {
         ...(result.path ? [`path: ${result.path}`] : []),
         ...(result.origin ? [`origin: ${result.origin}`] : []),
         ...(config.subject.repos?.length ? [`repos: ${config.subject.repos.join(", ")}`] : []),
+        ...(result.personas ?? []).map(persona => `persona ${persona.id}: ${persona.brief ? `authored context (before runtime additions)\n${persona.brief.text}` : "unresolved; id only"}`),
         ...result.warnings.map((warning) => `warning: ${warning}`)
     ].join("\n") + "\n";
 }