@adam0white/human-framework 2.9.1 → 2.10.0

package/dist/beliefs/beliefs.d.ts

@@ -1,4 +1,4 @@
-import type { Belief, EntityId, Minute, Percept, Person, Unit } from '../types.ts';
+import type { Belief, BeliefProvenance, EntityId, Minute, Percept, Person, Unit } from '../types.ts';
 export declare const BELIEF_DEFAULTS: {
     maxBeliefs: number;
     maxSources: number;
@@ -17,6 +17,9 @@ export declare const BELIEF_DEFAULTS: {
     /** Trust change on confirmation: gain toward 1, loss toward 0 (loss > gain). */
     trustGain: number;
     trustLoss: number;
+    /** Loss of source trust after attending incompatible accounts from that same source. */
+    contradictionLoss: number;
+    maxContradictions: number;
     /** Half-life of log-odds drift toward 0. */
     driftHalfLife: number;
     attentionBase: number;
@@ -89,3 +92,22 @@ export declare function contested(p: Person, prop: string): {
     against: EntityId[];
     contested: boolean;
 };
+/** Where this person first got the belief on `prop`, or undefined. */
+export declare function provenanceOf(p: Person, prop: string): BeliefProvenance | undefined;
+export interface ContradictionResult {
+    applied: boolean;
+    reason?: 'no-account' | 'same-account' | 'already-noted' | 'self' | 'untrusted-reporter';
+    before: Unit;
+    after: Unit;
+}
+/**
+ * The person learns that `sourceId` also gave the account `prop = value` elsewhere, against what that source told
+ * them. See the contradiction SCOPE.
+ */
+export declare function contradicted(p: Person, ev: {
+    sourceId: EntityId;
+    prop: string;
+    value: boolean;
+    reporterId?: EntityId;
+    at?: Minute;
+}): ContradictionResult;

package/dist/beliefs/beliefs.js

@@ -12,11 +12,20 @@
  * Three independent stores: `social.relationships[].trust` moves through authored ties, social events
  * (including forgiveness), judged acts and reputation; `will.voices[].trust` moves through followed-advice
  * outcomes, insisting, commands, `noteVoicePromise`, `seedVoice` and `adoptVoiceTrust` (also used by upbringing).
- * This module owns `memory.sourceTrust`: `seedSourceTrust` authors it and `confirm` recalibrates it.
+ * This module owns `memory.sourceTrust`: `seedSourceTrust` authors it, `confirm` recalibrates it and
+ * `contradicted` reduces it when one source gives incompatible accounts.
  * `believe`, including testimony delivered by `perceive`, weights claims by source trust, read by `trustOf`.
+ *
+ * SCOPE (Word and witness): optional provenance records the first known origin, direct teller and opaque
+ * host lineage of a belief. It does not change credence or decisions, reconstruct a relay graph, verify an
+ * origin, or survive belief eviction. Contradiction reduces information-source trust only when a retained
+ * first-hand account from that source opposes the newly learned account. Independent sources disagreeing
+ * are not a contradiction here. A third-party report is weighted by the reporter's source trust; this does
+ * not prove deceit, change the belief, or change relationship or voice trust. Loss and retention limits are
+ * engineering defaults, not calibrated effect sizes. Deduplication lasts only while its bounded record stays.
  */
-import { clamp, clamp01, decay, dpow, expit, logit } from '../core/index.js';
-import { MINUTES_PER_DAY } from '../types.js';
+import { clamp, clamp01, decay, dpow, expit, isNum, isObj, logit } from '../core/index.js';
+import { MAX_MINUTE, MINUTES_PER_DAY } from '../types.js';
 export const BELIEF_DEFAULTS = {
     maxBeliefs: 300,
     maxSources: 6,
@@ -35,6 +44,9 @@ export const BELIEF_DEFAULTS = {
     /** Trust change on confirmation: gain toward 1, loss toward 0 (loss > gain). */
     trustGain: 0.1,
     trustLoss: 0.25,
+    /** Loss of source trust after attending incompatible accounts from that same source. */
+    contradictionLoss: 0.25,
+    maxContradictions: 32,
     /** Half-life of log-odds drift toward 0. */
     driftHalfLife: 45 * MINUTES_PER_DAY,
     // Attention
@@ -107,7 +119,9 @@ export function attend(p, percepts, ctx) {
 export function trustOf(p, sourceId) {
     if (sourceId === p.id || sourceId === 'self')
         return BELIEF_DEFAULTS.selfTrust;
-    return p.memory.sourceTrust[sourceId] ?? BELIEF_DEFAULTS.defaultTrust;
+    // Own entries only: an id such as `constructor` or `__proto__` must not read an inherited property.
+    const own = Object.hasOwn(p.memory.sourceTrust, sourceId) ? p.memory.sourceTrust[sourceId] : undefined;
+    return typeof own === 'number' ? own : BELIEF_DEFAULTS.defaultTrust;
 }
 /**
  * Set authored trust in an information source, clamped to 0..1. Writes only `memory.sourceTrust`;
@@ -233,7 +247,13 @@ export function confirm(p, prop, truth, now) {
         if (s.id === p.id || s.id === 'self')
             continue;
         const t = trustOf(p, s.id);
-        p.memory.sourceTrust[s.id] = clamp01(s.value === truth ? t + d.trustGain * (1 - t) : t - d.trustLoss * t);
+        // An own data property even for ids such as `__proto__` (plain assignment would set the prototype).
+        Object.defineProperty(p.memory.sourceTrust, s.id, {
+            value: clamp01(s.value === truth ? t + d.trustGain * (1 - t) : t - d.trustLoss * t),
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
         if (s.value !== truth)
             misled.push(s.id);
     }
@@ -272,3 +292,136 @@ export function contested(p, prop) {
 }
 // Remembered advice (N9) is owned by `will/` (`standingAdvice`, fed from `Percept.advice`); review 2026-10-03
 // removed a second, unused belief-based implementation here so the two could not drift apart.
+// ---------------------------------------------------------------------------------------------
+// Word and witness (2.10.0): provenance and contradiction.
+// ---------------------------------------------------------------------------------------------
+const validId = (x) => typeof x === 'string' && x.length > 0;
+const validMinute = (x) => isNum(x) && Math.abs(x) <= MAX_MINUTE;
+function cleanProvenance(x) {
+    if (!isObj(x) || !validId(x.origin) || !validId(x.firstFrom) || !validMinute(x.at))
+        return undefined;
+    if (x.lineage !== undefined && typeof x.lineage !== 'string')
+        return undefined;
+    const out = { origin: x.origin, firstFrom: x.firstFrom, at: x.at };
+    if (typeof x.lineage === 'string' && x.lineage.length <= 64)
+        out.lineage = x.lineage;
+    return out;
+}
+/** Record where a belief came from, if it has no provenance yet (first acquisition wins). @internal */
+export function noteProvenance(p, claim, teller, at) {
+    if (claim.origin === undefined && claim.lineage === undefined)
+        return;
+    const b = findBelief(p, claim.prop);
+    if (!b || b.provenance !== undefined)
+        return;
+    const input = { origin: claim.origin ?? teller, firstFrom: teller, at };
+    if (claim.lineage !== undefined)
+        input.lineage = claim.lineage;
+    const meta = cleanProvenance(input);
+    if (meta !== undefined)
+        b.provenance = meta;
+}
+/** Where this person first got the belief on `prop`, or undefined. */
+export function provenanceOf(p, prop) {
+    return findBelief(p, prop)?.provenance;
+}
+/**
+ * The person learns that `sourceId` also gave the account `prop = value` elsewhere, against what that source told
+ * them. See the contradiction SCOPE.
+ */
+export function contradicted(p, ev) {
+    return applyContradiction(p, ev, ev.reporterId === undefined ? undefined : trustOf(p, ev.reporterId));
+}
+/**
+ * `contradicted` with the reporter's trust given, so that several reports delivered together share one trust basis
+ * (`perceive` reads it once per percept, before any report applies). @internal
+ */
+export function applyContradiction(p, ev, reporterTrust) {
+    const t = trustOf(p, ev.sourceId);
+    const refused = (reason) => ({
+        applied: false,
+        reason,
+        before: t,
+        after: t,
+    });
+    if (ev.sourceId === p.id || ev.sourceId === 'self')
+        return refused('self');
+    const weight = reporterTrust === undefined ? 1 : testimonyWeight(reporterTrust);
+    // One loss per (source, proposition), at the strongest evidence: a weaker earlier report leaves room for the rest.
+    const prior = p.memory.contradictions?.find((x) => x.sourceId === ev.sourceId && x.prop === ev.prop);
+    const priorWeight = prior === undefined ? 0 : (prior.weight ?? 1);
+    if (prior !== undefined && priorWeight >= weight)
+        return refused('already-noted');
+    const account = findBelief(p, ev.prop)?.sources.find((s) => s.id === ev.sourceId);
+    if (!account)
+        return refused('no-account');
+    if (account.value === ev.value)
+        return refused('same-account');
+    // A reporter at or below the trust floor carries no weight and must not use up the pair.
+    if (weight <= 0)
+        return refused('untrusted-reporter');
+    const at = ev.at ?? p.now;
+    if (!validMinute(at))
+        throw new Error('human: contradiction time must be a finite supported minute');
+    const loss = BELIEF_DEFAULTS.contradictionLoss;
+    // Multiplicative, so the total over a pair is `1 - loss * strongest weight` whatever the arrival order.
+    const after = seedSourceTrust(p, ev.sourceId, (t * (1 - loss * weight)) / (1 - loss * priorWeight));
+    if (prior !== undefined) {
+        if (weight >= 1)
+            delete prior.weight;
+        else
+            prior.weight = weight;
+    }
+    else {
+        const noted = p.memory.contradictions ?? [];
+        const row = { sourceId: ev.sourceId, prop: ev.prop, at };
+        if (weight < 1)
+            row.weight = weight;
+        noted.push(row);
+        noted.sort((a, b) => a.at - b.at);
+        p.memory.contradictions = noted.slice(-BELIEF_DEFAULTS.maxContradictions);
+    }
+    return { applied: true, before: t, after };
+}
+/**
+ * Restore (2.10.0): drop malformed provenance (lineage over 64 characters is dropped, not truncated) and bound and
+ * validate `contradictions`. A save the engine wrote is unchanged. @internal
+ */
+export function sanitizeBeliefMeta(memory) {
+    for (const b of memory.beliefs) {
+        if (!isObj(b) || b.provenance === undefined)
+            continue;
+        const meta = cleanProvenance(b.provenance);
+        if (meta === undefined)
+            delete b.provenance;
+        else
+            b.provenance = meta;
+    }
+    if (memory.contradictions === undefined)
+        return;
+    if (!Array.isArray(memory.contradictions)) {
+        delete memory.contradictions;
+        return;
+    }
+    const clean = [];
+    const seen = new Map();
+    for (const x of memory.contradictions) {
+        if (!isObj(x) || typeof x.sourceId !== 'string' || typeof x.prop !== 'string' || !validMinute(x.at))
+            continue;
+        const props = seen.get(x.sourceId) ?? new Set();
+        if (props.has(x.prop))
+            continue;
+        props.add(x.prop);
+        seen.set(x.sourceId, props);
+        const row = { sourceId: x.sourceId, prop: x.prop, at: x.at };
+        // A malformed weight reads as 1 (fully applied): restore never reopens a pair to a further loss.
+        if (typeof x.weight === 'number' && Number.isFinite(x.weight) && x.weight > 0 && x.weight < 1)
+            row.weight = x.weight;
+        clean.push(row);
+    }
+    clean.sort((a, b) => a.at - b.at);
+    if (clean.length === 0)
+        delete memory.contradictions;
+    else
+        memory.contradictions = clean.slice(-BELIEF_DEFAULTS.maxContradictions);
+}

package/dist/conversation/conversation.d.ts

@@ -53,6 +53,8 @@ export interface ConverseContext {
     magnitude?: Unit;
     /** Character-trait vocabulary (defaults to `REPUTATION_TRAITS`). */
     traits?: Record<string, TraitEffect>;
+    /** Carry belief origin and opaque lineage into told claims (off by default). */
+    provenance?: boolean;
 }
 /** Host-visible record of one claim. */
 export interface ToldClaim {
@@ -69,6 +71,8 @@ export interface ToldClaim {
     /** The person the claim is about, when it is a character claim. */
     about?: PersonId;
     score: number;
+    origin?: EntityId;
+    lineage?: string;
 }
 export interface AdviceGiven {
     action: string;

package/dist/conversation/conversation.js

@@ -29,6 +29,11 @@
  * percept (it is in `claims`, not `told`). A claim this listener already heard from this speaker, in the same
  * direction, is dropped before the speaker chooses, so it is not even a deed. The speaker keeps no memory of what was said to whom; the listener's
  * belief stands in for it.
+ *
+ * SCOPE (Word and witness, 2.10.0): `provenance: true` carries each claim's first known origin and opaque
+ * lineage into testimony. Missing provenance names the speaker as origin. Metadata changes neither claim
+ * selection nor repetition rules; the host still owns the relay graph and disclosure. It does not establish
+ * that an origin is truthful, expose deceit to the listener, or infer who else heard a claim.
  */
 import { clamp01, expit, round } from '../core/index.js';
 import { isDeceased, isUnfavourableTrait, parseTraitProp, REPUTATION_TRAITS, relationshipWith, } from '../social/index.js';
@@ -191,6 +196,12 @@ export function converse(speaker, listener, ctx) {
         .slice(0, Math.max(0, maxClaims));
     const norms = new Map();
     for (const c of chosen) {
+        if (ctx.provenance) {
+            const meta = speaker.memory.beliefs.find((b) => b.prop === c.prop)?.provenance;
+            c.origin = meta?.origin ?? speaker.id;
+            if (meta?.lineage !== undefined)
+                c.lineage = meta.lineage;
+        }
         out.claims.push(c);
         const pcNorms = [];
         if (c.backbiting) {
@@ -220,6 +231,11 @@ export function converse(speaker, listener, ctx) {
                 ? `${nameOf(speaker)} says ${c.about} is ${c.value ? '' : 'not '}${c.prop.split(':')[1] ?? ''}`
                 : `${nameOf(speaker)} says ${c.prop} is ${c.value ? 'so' : 'not so'}`,
         };
+        const claim = pc.claims?.[0];
+        if (claim && c.origin !== undefined)
+            claim.origin = c.origin;
+        if (claim && c.lineage !== undefined)
+            claim.lineage = c.lineage;
         if (c.about !== undefined) {
             pc.targetId = c.about;
             const parsed = parseTraitProp(c.prop, table);
@@ -260,6 +276,15 @@ export function converse(speaker, listener, ctx) {
             claims: [{ prop: `advice:${a.action}`, value: true, confidence: round(a.cred) }],
             summary: `${nameOf(speaker)} says I should ${a.action}`,
         };
+        if (ctx.provenance) {
+            const meta = beliefs.find((b) => b.prop === `${prefix}${a.action}`)?.provenance;
+            const claim = percept.claims?.[0];
+            if (claim) {
+                claim.origin = meta?.origin ?? speaker.id;
+                if (meta?.lineage !== undefined)
+                    claim.lineage = meta.lineage;
+            }
+        }
         if (ctx.placeId !== undefined)
             percept.placeId = ctx.placeId;
         const suggestion = { voiceId: speaker.id, action: a.action, strength: round(a.strength) };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Human Framework public surface. */
-export declare const FRAMEWORK_VERSION = "2.9.1";
+export declare const FRAMEWORK_VERSION = "2.10.0";
 export type { CrisisEvent, PracticeKind } from './affect/index.ts';
 export { AFFECT_DEFAULTS, actionTendencies, advanceAffect, appraise, breakAllows, breakBehaviour, breakHazard, CRISIS_DEFAULTS, checkCrisis, createAffect, easeBreak, emotionLevel, enableBreaks, feel, inBreak, readAffect, regulate, release as releaseEmotion, skipCrisis, strain, tendencyEmotions, } from './affect/index.ts';
 export type { GoalTemplate, PrayerCalendar, PrayerSchedule, PrayerTimes, Retimer, } from './agenda/index.ts';

package/dist/index.js

@@ -1,5 +1,5 @@
 /** Human Framework public surface. */
-export const FRAMEWORK_VERSION = '2.9.1';
+export const FRAMEWORK_VERSION = '2.10.0';
 export { AFFECT_DEFAULTS, actionTendencies, advanceAffect, appraise, breakAllows, breakBehaviour, breakHazard, CRISIS_DEFAULTS, checkCrisis, createAffect, easeBreak, emotionLevel, enableBreaks, feel, inBreak, readAffect, regulate, release as releaseEmotion, skipCrisis, strain, tendencyEmotions, } from './affect/index.js';
 // `agenda.release` collides with `affect.release`; the agenda one is re-exported under a clearer name.
 export { AGENDA_DEFAULTS, abandonGoal, adoptGoal, advanceAgenda, agendaTerms, applyExemptions, CARE_DEFAULTS, calendarRetimer, careDuty, commitmentPressure, createAgenda, DEFAULT_PRAYER_TIMES, EID_PRAYER_IMPORTANCE, EXEMPTION_DEFAULTS, eidPrayer, eidWindow, fastWindow, iftarWindow, inMakruhTime, isUnderWay, MAKRUH_DEFAULTS, makruhWindows, missedExcuse, onFinished, owedMakeUps, PRAYER_IMPORTANCE, PURPOSE_DEFAULTS, prayerWindows, pressureReachedAt, promise, proposeGoals, RAMADAN_DEFAULTS, ramadanFast, ramadanMeals, release as releaseCommitment, retimeCommitments, revisePurposes, scheduleMakeUp, spanMeetsWindow, suhoorWindow, timesFor, violatesAbstention, } from './agenda/index.js';

package/dist/memory/memory.js

@@ -349,7 +349,10 @@ export function retell(teller, listener, when, knobs = {}) {
 }
 /** The same thing happening, whoever it happened to (kind, action, target, place). */
 const sameStory = (g, e) => g.kind === e.kind && g.action === e.action && g.targetId === e.targetId && g.placeId === e.placeId;
-const trustOfSource = (p, id) => p.memory.sourceTrust[id] ?? 0.5;
+const trustOfSource = (p, id) => {
+    const own = Object.hasOwn(p.memory.sourceTrust, id) ? p.memory.sourceTrust[id] : undefined;
+    return typeof own === 'number' ? own : 0.5;
+};
 const idNum = (id) => Number(id.slice(1)) || 0;
 const byId = (a, b) => idNum(a.id) - idNum(b.id);
 function recency(now, at) {

package/dist/migrate.js

@@ -18,7 +18,9 @@
  * version; fullness stays absent unless enabled, and alongside partners and reconsideration are opt-in.
  * 2.8.0 to 2.9.0 stamps the version; prompting cues and practice half-lives stay absent unless supplied,
  * review terms may carry refs, and an outcome naming several commitments now keeps each rather than only
- * the earliest-ending one. A migrated save continues under the current engine's rules: it restores and runs,
+ * the earliest-ending one. 2.9.0 to 2.10.0 stamps the version; belief provenance, noted contradictions and
+ * believed regard stay absent unless a host supplies them;
+ * `regard` becomes a reserved impression cue key. A migrated save continues under the current engine's rules: it restores and runs,
  * but it does not reproduce what the old engine would have done next where the rules changed (1.4.0 to 1.5.0
  * changed how standing advice is heard; 1.8.0 to 1.9.0 changed the omission rule). Saves older than 1.4.0 and unknown versions are refused with an error.
  *
@@ -68,6 +70,11 @@ export const MIGRATIONS = {
         note: 'the surroundings field `ambient.now` is renamed `ambient.percept`; per-person retention is optional and starts absent; behaviour unchanged',
         apply: renameAmbient,
     },
+    '2.9.0': {
+        to: '2.10.0',
+        note: 'belief provenance (Belief.provenance), noted contradictions (memory.contradictions) and the believed-regard impression cue are optional and start absent; existing hosts retain exact behavior',
+        apply: stamp,
+    },
     '2.8.0': {
         to: '2.9.0',
         note: 'prompting responses may carry a cue and the slice a practice half-life (both optional, absent as before); review terms may carry a ref; an outcome naming two or more commitments in fulfills now keeps each of them, where 2.8.0 kept the earliest-ending one',

package/dist/person.js

@@ -21,7 +21,7 @@
  */
 import { actionTendencies, advanceAffect, appraise, CRISIS_DEFAULTS, checkCrisis, createAffect, easeBreak, emotionLevel, feel, readAffect, regulate, release, skipAffect, skipCrisis, strain, tendencyEmotions, } from './affect/index.js';
 import { advanceAgenda, createAgenda, onFinished, promise, proposeGoals, revisePurposes, } from './agenda/index.js';
-import { advanceBeliefs, attend, believe, confirm, credence } from './beliefs/index.js';
+import { advanceBeliefs, applyContradiction, attend, believe, confirm, credence, noteProvenance, trustOf, } from './beliefs/index.js';
 import { advanceBody, BODY_DEFAULTS, checkDowned, clearDowned, consume, createBody, downedAllows, enableFatigueStore, enableFullness, expose, injure, nextBodyThreshold, readBody, setDowned, sicken, skipBody, } from './body/index.js';
 import { ageCharacter, enableCharacterChange, noteCharacterDay, noteCharacterSocial, } from './character/index.js';
 import { closeDay, enableYearbook, endDay, noteAnswer, noteCommitments, noteDecision, noteMood, noteOutcome, trimChronicle, } from './chronicle/index.js';
@@ -40,7 +40,7 @@ import { enablePromptings, nafsPatterns, notePromptings } from './promptings/ind
 import { bodyForecastFor, consumeConsequences, forecastLine, forecastThresholds, pruneConsequences, receiveConsequences, } from './prospection/index.js';
 import { enableReview, reviewIfDue } from './review/index.js';
 import { enableSkillRetention, learnByWatching, practise, seedSkills, } from './skills/index.js';
-import { advanceSocial, applyReputationBelief, careFor, closeness, judge, markDeceased, relationshipWith, seedRelationships, socialEvent, threatAppraisal, } from './social/index.js';
+import { advanceSocial, applyReputationBelief, careFor, closeness, judge, markDeceased, noteKnownBy, relationshipWith, seedRelationships, socialEvent, threatAppraisal, } from './social/index.js';
 import { ENGINE_VERSION, MAX_MINUTE, PERSON_SCHEMA, PHYSIOLOGICAL_NEEDS, PSYCHOLOGICAL_NEEDS, TRAIT_KEYS, VALUE_KEYS, } from './types.js';
 import { advanceWill, answerSuggestion, chargeCommand, commandTargets, createWill, creditedVoices, dischargeAdvice, dutyReviewAt, endCommand, learnFromVoice, noteCommandOutcome, predictResponse, rememberAdvice, resolveCommand, takeCommand, voicesIn, WILL_DEFAULTS, wakeReviewAt, } from './will/index.js';
 export const PERSON_DEFAULTS = {
@@ -571,9 +571,36 @@ function perceiveOne(p, pc) {
             confirm(p, claim.prop, claim.value, at);
         else
             believe(p, claim.prop, claim.value, claim.confidence, direct ? p.id : (actor ?? 'rumour'), at);
+        // Provenance (2.10.0): recorded only when the claim carries it; first acquisition wins.
+        if (claim.origin !== undefined || claim.lineage !== undefined)
+            noteProvenance(p, claim, direct ? p.id : (actor ?? 'rumour'), at);
         // Hearsay about someone's character moves my relationship with them (reputation).
         applyReputationBelief(p, claim.prop, before, credence(p, claim.prop), at);
     }
+    // Another source's account, reported by the teller (2.10.0): one source telling two people opposite things.
+    if (pc.channel === 'told' && actor !== undefined && Array.isArray(pc.reports)) {
+        // One trust basis for the whole percept: a report that lowers the reporter's own trust must not reweigh the rest.
+        const reporterTrust = trustOf(p, actor);
+        for (const r of pc.reports.slice(0, 4))
+            applyContradiction(p, { ...r, reporterId: actor, at }, reporterTrust);
+    }
+    // My own act, seen by others (2.10.0): what I believe they now think of me.
+    if (byMe && Array.isArray(pc.witnesses)) {
+        for (const w of pc.witnesses.slice(0, 8)) {
+            if (typeof w !== 'string')
+                continue;
+            if (w === p.id)
+                continue;
+            const act = { kind: pc.kind };
+            if (target !== undefined)
+                act.targetId = target;
+            if (pc.valence !== undefined)
+                act.valence = pc.valence;
+            if (pc.norms)
+                act.norms = pc.norms;
+            noteKnownBy(p, { otherId: w, act, at, via: 'seen' });
+        }
+    }
     // Advice carried by testimony keeps pulling after the speaker falls silent (standing advice, N9).
     if (pc.channel === 'told')
         rememberAdvice(p, pc);

package/dist/restore.js

@@ -8,6 +8,7 @@
  */
 import { sanitizeCrisis } from './affect/index.js';
 import { sanitizeAgenda } from './agenda/index.js';
+import { sanitizeBeliefMeta } from './beliefs/index.js';
 import { sanitizeBody, sanitizeInjuries } from './body/index.js';
 import { sanitizeCharacter } from './character/index.js';
 import { CHRONICLE_DEFAULTS, sanitizeYears } from './chronicle/index.js';
@@ -188,6 +189,7 @@ export function restore(input) {
     sanitizeCrisis(out.affect);
     sanitizeAgenda(out.agenda);
     sanitizeGists(out.memory);
+    sanitizeBeliefMeta(out.memory);
     // Optional top-level slices (1.8.0 onward), each checked by its owner.
     keepValid(out, 'chronicleYears', sanitizeYears);
     keepValid(out, 'character', sanitizeCharacter);

package/dist/social/impressions.d.ts

@@ -1,5 +1,5 @@
-import type { EntityId, Minute, Person, PersonId, Signed, StateCue, Traits, Unit } from '../types.ts';
-export type CueKind = 'state' | 'place' | 'trait' | 'tie' | 'trust' | 'skill';
+import type { EntityId, Minute, NormTag, Person, PersonId, Signed, StateCue, Traits, Unit } from '../types.ts';
+export type CueKind = 'state' | 'place' | 'trait' | 'tie' | 'trust' | 'skill' | 'regard';
 export declare const STATE_CUES: readonly StateCue[];
 /** @deprecated since 2.1: use `TRAIT_KEYS` (types.ts), the same list. Removed in 3.0. */
 export declare const TRAIT_NAMES: readonly (keyof Traits)[];
@@ -21,6 +21,7 @@ export declare const IMPRESSION_DEFAULTS: {
         tie: number;
         trust: number;
         skill: number;
+        regard: number;
     };
     /** Default reserve: base + emotionalityCoef × (1 − emotionality) for pain and fear; fatigue and mood a little. */
     reserve: {
@@ -129,3 +130,31 @@ export declare function impressionOf(observer: Person, targetId: PersonId, now:
  * and unhurt reads positive, frightened or hurt negative. Cognition weighs it on risky offers shared with them.
  */
 export declare function companionSteadiness(p: Person, otherId: PersonId, now: Minute): Signed;
+/**
+ * SCOPE (believed regard): the person's estimate of how another regards them, updated only by their own evidence
+ * that the other knows of an act. Seen witnesses carry full weight; a learned relay carries information-source
+ * trust. The person projects the act's valence and their own held-norm judgement, without reading the other's
+ * mind. Negative samples carry the social negativity bias. Evidence halves over 60 days. This does not model
+ * hidden witnesses, unknown relays, recursive beliefs or the other's actual feelings. Relationships and
+ * impressions remain separate stores. The projection weights and half-life are engineering defaults.
+ */
+/** An act of mine that someone else knows of (2.10.0). */
+export interface KnownAct {
+    kind: string;
+    targetId?: PersonId;
+    valence?: Signed;
+    norms?: NormTag[];
+}
+/**
+ * The person has their own evidence that `otherId` knows of their act: they saw them see it (`via: 'seen'`) or were
+ * told they heard (`via: 'told'`, weighted by trust in `sourceId`). Moves the believed regard cue. See the SCOPE.
+ */
+export declare function noteKnownBy(p: Person, ev: {
+    otherId: PersonId;
+    act: KnownAct;
+    at?: Minute;
+    via: 'seen' | 'told';
+    sourceId?: EntityId;
+}): Estimate | undefined;
+/** How `p` believes `otherId` regards them; the neutral prior has zero confidence. Pure and RNG-free. */
+export declare function regardOf(p: Person, otherId: PersonId, now: Minute): Estimate;

package/dist/social/impressions.js

@@ -25,8 +25,10 @@
  * of one's own state, deliberate deception beyond reserve, the target noticing being watched, or gossip about
  * impressions (conversation carries reputation beliefs separately, `social.ts`).
  */
+import { testimonyWeight, trustOf } from '../beliefs/beliefs.js';
 import { clamp, clamp01, cmpStr, decay, latestPerId, newestN, round } from '../core/index.js';
 import { MINUTES_PER_DAY, MINUTES_PER_YEAR, TRAIT_KEYS } from '../types.js';
+import { judge, SOCIAL_DEFAULTS } from './social.js';
 export const STATE_CUES = ['fatigue', 'pain', 'fear', 'mood'];
 /** @deprecated since 2.1: use `TRAIT_KEYS` (types.ts), the same list. Removed in 3.0. */
 export const TRAIT_NAMES = TRAIT_KEYS;
@@ -40,6 +42,7 @@ export const IMPRESSION_DEFAULTS = {
         trust: 30 * MINUTES_PER_DAY,
         /** `skill:<id>`: how good someone is at a craft changes over seasons, and what was seen of it lasts. */
         skill: MINUTES_PER_YEAR,
+        regard: 60 * MINUTES_PER_DAY,
     },
     /** confidence = weight / (weight + priorWeight). */
     priorWeight: 1.5,
@@ -56,6 +59,7 @@ export const IMPRESSION_DEFAULTS = {
         tie: 0,
         trust: 0.5,
         skill: 0.3,
+        regard: 0,
     },
     /** Default reserve: base + emotionalityCoef × (1 − emotionality) for pain and fear; fatigue and mood a little. */
     reserve: { base: 0.1, emotionalityCoef: 0.4, fatigue: 0.1, mood: 0.2 },
@@ -83,6 +87,8 @@ export const IMPRESSION_DEFAULTS = {
     maxCues: 48,
 };
 function cueKind(key) {
+    if (key === 'regard')
+        return 'regard';
     if (key.startsWith('trait:'))
         return 'trait';
     if (key.startsWith('tie:'))
@@ -103,7 +109,7 @@ function priorOf(key) {
     return P[kind];
 }
 function rangeOf(key) {
-    return key === 'mood' || cueKind(key) === 'tie' ? [-1, 1] : [0, 1];
+    return key === 'mood' || key === 'regard' || cueKind(key) === 'tie' ? [-1, 1] : [0, 1];
 }
 /** FNV-1a over a string, as a 0..1 fraction: deterministic observation error with no RNG drawn. */
 function hash01(s) {
@@ -379,3 +385,34 @@ export function sanitizeImpressions(social) {
     else
         social.impressions = kept;
 }
+/**
+ * The person has their own evidence that `otherId` knows of their act: they saw them see it (`via: 'seen'`) or were
+ * told they heard (`via: 'told'`, weighted by trust in `sourceId`). Moves the believed regard cue. See the SCOPE.
+ */
+export function noteKnownBy(p, ev) {
+    if (ev.otherId === p.id)
+        return undefined;
+    const weight = ev.via === 'seen' ? 1 : ev.sourceId === undefined ? 0 : testimonyWeight(trustOf(p, ev.sourceId));
+    if (!(weight > 0))
+        return undefined;
+    const at = ev.at ?? p.now;
+    const defaults = {
+        'promise-broken': -0.6,
+        'promise-kept': 0.3,
+        harm: -0.6,
+        help: 0.4,
+        apology: 0.2,
+    };
+    const valence = ev.act.valence ?? (Object.hasOwn(defaults, ev.act.kind) ? (defaults[ev.act.kind] ?? 0) : 0);
+    const judgement = judge(p, { actorId: p.id, norms: ev.act.norms ?? [] }, p.conscience.norms, at).praiseworthiness;
+    const value = clamp(valence * (ev.act.targetId === ev.otherId ? 1 : 0.5) + 0.3 * judgement, -1, 1);
+    if (!Number.isFinite(value) || !Number.isFinite(at))
+        return undefined;
+    const imp = impressionFor(p, ev.otherId, true, at);
+    sample(imp, 'regard', value, weight * (value < 0 ? SOCIAL_DEFAULTS.negativityBias : 1), at);
+    return regardOf(p, ev.otherId, at);
+}
+/** How `p` believes `otherId` regards them; the neutral prior has zero confidence. Pure and RNG-free. */
+export function regardOf(p, otherId, now) {
+    return estimate(p, otherId, 'regard', now);
+}

package/dist/social/social.d.ts

@@ -30,6 +30,8 @@ export declare const SOCIAL_DEFAULTS: {
         group: number;
         /** Group size (others) from which the extraversion term applies. */
         groupFrom: number;
+        regardRepair: number;
+        regardRepairMax: number;
     };
     judge: {
         respect: number;

package/dist/social/social.js

@@ -6,14 +6,16 @@
  * helps), reciprocity as a favour ledger (Gouldner 1960), the mere-exposure / familiarity growth with
  * diminishing returns, HEXACO agreeableness as tolerance of provocation and honesty-humility as sensitivity
  * to deceit (Ashton & Lee), Schwartz benevolence as care for close others. Observers judge only the outward
- * act and never see intentions. It does NOT model the other person's view of me (each person holds their
- * own one-sided record) or attachment styles (gossip, reputation and bereavement are in the SCOPE paragraphs
+ * act and never see intentions. An opt-in `regard` impression estimates the other's view of me and adds a bounded
+ * repair term; it never reads the other's actual view. It does NOT model attachment styles
+ * (gossip, reputation and bereavement are in the SCOPE paragraphs
  * further down; insiders, outsiders and threats in `groups.ts`); the
  * coefficients are engineering defaults, not calibrated estimates.
  */
 import { clamp, clamp01, clampSigned, cmpStr, decay, dlog, expit, round } from '../core/index.js';
 import { MINUTES_PER_DAY, MINUTES_PER_YEAR } from '../types.js';
 import { careFor } from './groups.js';
+import { regardOf } from './impressions.js';
 const WEEK = 7 * MINUTES_PER_DAY;
 export const SOCIAL_DEFAULTS = {
     maxRelationships: 80,
@@ -50,6 +52,8 @@ export const SOCIAL_DEFAULTS = {
         group: 0.3,
         /** Group size (others) from which the extraversion term applies. */
         groupFrom: 3,
+        regardRepair: 0.5,
+        regardRepairMax: 0.3,
     },
     judge: {
         respect: 0.12,
@@ -328,6 +332,18 @@ export function socialTerms(p, aff, ctx) {
         const size = clamp01((others - W.groupFrom + 1) / 6);
         terms.push({ source: 'social:group', value: round(W.group * (p.traits.extraversion - 0.5) * 2 * size) });
     }
+    if (aff.targetId !== undefined &&
+        aff.targetId !== p.id &&
+        (tags.includes('repair') || aff.action === 'apology' || aff.action === 'amends') &&
+        !isDeceased(p, aff.targetId)) {
+        const regard = regardOf(p, aff.targetId, p.now);
+        if (regard.value < 0 && regard.confidence > 0) {
+            terms.push({
+                source: `regard:${aff.targetId}`,
+                value: round(Math.min(W.regardRepairMax, W.regardRepair * -regard.value * regard.confidence * (0.5 + p.traits.agreeableness))),
+            });
+        }
+    }
     return terms;
 }
 /** Moral weight of an observed act against one held standing, -1..1 before conviction. */

package/dist/types.d.ts

@@ -393,6 +393,49 @@ export interface Belief {
         id: EntityId;
         value: boolean;
     }[];
+    /**
+     * Where this person first got the belief (2.10.0, `beliefs/`). Absent unless an incoming claim carried provenance
+     * (`PerceptClaim.origin` or `lineage`). First acquisition wins; never read by decisions.
+     */
+    provenance?: BeliefProvenance;
+}
+/** Where a belief first came from, as far as the person knows (2.10.0). Owned by `beliefs/`. */
+export interface BeliefProvenance {
+    /** Who first said it: the first teller of the chain as told, or this person when they saw it themselves. */
+    origin: EntityId;
+    /** Who this person first heard it from (equal to `origin` when told first-hand or observed). */
+    firstFrom: EntityId;
+    /** Minute the provenance was acquired. */
+    at: Minute;
+    /** Opaque host token (at most 64 characters), carried unchanged through relays; HF never parses it. */
+    lineage?: string;
+}
+/** One proposition claim carried by a percept. */
+export interface PerceptClaim {
+    prop: string;
+    value: boolean;
+    confidence: Unit;
+    /** 2.10.0: who first said it, as the teller passes it on (provenance; never read by decisions). */
+    origin?: EntityId;
+    /** 2.10.0: opaque host lineage token (at most 64 characters), carried unchanged by `converse`. */
+    lineage?: string;
+}
+/**
+ * A report that `sourceId` told the reporter (the percept's `actorId`) that `prop` is `value` (2.10.0). On an attended
+ * `told` percept it is checked against what `sourceId` told this person (`beliefs.contradicted`).
+ */
+export interface ReportedAccount {
+    sourceId: EntityId;
+    prop: string;
+    value: boolean;
+}
+/** A noted contradiction by one source on one proposition (2.10.0, `beliefs/`); kept so it counts once. */
+export interface NotedContradiction {
+    sourceId: EntityId;
+    prop: string;
+    at: Minute;
+    /** Testimony weight already applied, 0..1; absent means 1 (heard both accounts directly). */
+    weight?: Unit;
 }
 /** Learned expectation of an action's actual result for this person (prediction-error learning). */
 export interface ActionExpectation {
@@ -431,6 +474,8 @@ export interface MemoryState {
     /** Lasting gists (1.8.0, opt-in via `enableGists`; absent = episodes are simply forgotten). Bounded. */
     gists?: Gist[];
     nextGist?: number;
+    /** Contradictions already noted (2.10.0, `beliefs.contradicted`). Absent until one is noted. Bounded. */
+    contradictions?: NotedContradiction[];
 }
 export interface Relationship {
     otherId: PersonId;
@@ -840,7 +885,7 @@ export declare const PERSON_SCHEMA = "human/person@1";
  * and an activity that would cover a closing stretch is reviewed when the stretch begins (`isUnderWay`,
  * `dutyReviewAt`). Person shape unchanged.
  */
-export declare const ENGINE_VERSION = "2.9.0";
+export declare const ENGINE_VERSION = "2.10.0";
 /** A pregnancy carried by this person (host-driven; see `family/`). */
 export interface Pregnancy {
     fatherId: PersonId;
@@ -1157,11 +1202,7 @@ export interface Percept {
     /** Base salience before attention, 0..1. */
     salience: Unit;
     /** Proposition claims carried by the percept (e.g. a rumour). */
-    claims?: {
-        prop: string;
-        value: boolean;
-        confidence: Unit;
-    }[];
+    claims?: PerceptClaim[];
     /** Norms the observed act honoured or violated (for judging others). */
     norms?: NormTag[];
     /**
@@ -1206,6 +1247,14 @@ export interface Percept {
         id: string;
         revision: number;
     }[];
+    /**
+     * 2.10.0: on a percept of my own act (`actorId` is the perceiver), the people I saw see it. Each one's believed
+     * regard of me moves (`social/impressions.ts`, `noteKnownBy`). Someone present but not listed changes nothing.
+     * The first 8 are read.
+     */
+    witnesses?: readonly PersonId[];
+    /** 2.10.0: on a `told` percept, accounts the teller says another source gave them (at most four). */
+    reports?: readonly ReportedAccount[];
 }
 /**
  * Domains with distinct age curves for learning rate (`lifecourse.learningMultiplier`). 'general' is

package/dist/types.js

@@ -120,4 +120,4 @@ export const PERSON_SCHEMA = 'human/person@1';
  * and an activity that would cover a closing stretch is reviewed when the stretch begins (`isUnderWay`,
  * `dutyReviewAt`). Person shape unchanged.
  */
-export const ENGINE_VERSION = '2.9.0';
+export const ENGINE_VERSION = '2.10.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adam0white/human-framework",
-  "version": "2.9.1",
+  "version": "2.10.0",
   "description": "Deterministic, explainable simulated people: body, needs, affect, memory, beliefs, skills, habits, relationships, values and a will that can refuse a suggestion",
   "keywords": [
     "simulation",