@adam0white/human-framework 2.22.0 → 3.0.0

package/dist/impression.js

@@ -4,7 +4,7 @@
  * - `outwardSigns(target)`: perceived fatigue, pain and fear and the felt mood, each reduced by the target's reserve;
  *   a limp (lost moving capacity) shows through any reserve. `selfReport(target)` is the same in words, which hide
  *   more (`IMPRESSION_DEFAULTS.wordsReserve`): "I'm fine".
- * - `glimpseOf(observer, target, at, clarity?)` = `glimpse` of the target's outward signs; `acquaintWith` hands the target's
+ * - `glimpsePerson(observer, target, at, clarity?)` = `glimpse` of the target's outward signs; `acquaintPerson` hands the target's
  *   traits and family ties (public roles) to `acquaint`.
  * - `imagine(observer, target, now)`: the target as the observer pictures them — a copy whose traits, fear, pain,
  *   fatigue, mood, ties and trust in voices are the observer's beliefs (each pulled to the prior by its uncertainty)
@@ -61,14 +61,12 @@ export function selfReport(target) {
     s.pain = round(body.perceived.pain * (1 - clamp01(reserveOf(target, 'pain') * IMPRESSION_DEFAULTS.wordsReserve)));
     return s;
 }
-export function glimpseOf(observer, target, when, clarity) {
-    if (typeof when === 'number')
-        glimpse(observer, target.id, outwardSigns(target), when, clarity);
-    else
-        glimpse(observer, target.id, outwardSigns(target), when.at, when.clarity);
+/** `observer` looks at `target` at `at` (clarity 0..1: a clear look near by, or a distant figure; default 1). */
+export function glimpsePerson(observer, target, at, clarity) {
+    glimpse(observer, target.id, outwardSigns(target), at, clarity);
 }
 /** `observer` has known `target` for a long time (familiarity 0..1): traits and family ties, condensed. */
-export function acquaintWith(observer, target, familiarity, at) {
+export function acquaintPerson(observer, target, familiarity, at) {
     const ties = {};
     for (const r of target.social.relationships)
         if (r.roles.some((x) => PUBLIC_ROLES.includes(x)))

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Human Framework public surface. */
-export declare const FRAMEWORK_VERSION = "2.22.0";
+export declare const FRAMEWORK_VERSION = "3.0.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, MakeUpReceipt, PrayerCalendar, PrayerSchedule, PrayerTimes, Retimer, } from './agenda/index.ts';
@@ -46,5 +46,6 @@ export * from './scenarios/index.ts';
 export * from './sim/index.ts';
 export * from './skills/index.ts';
 export * from './social/index.ts';
+export { canonicalTickInputs, type TickInput, type TickInputKey } from './tick-input.ts';
 export * from './types.ts';
 export * from './will/index.ts';

package/dist/index.js

@@ -1,5 +1,5 @@
 /** Human Framework public surface. */
-export const FRAMEWORK_VERSION = '2.22.0';
+export const FRAMEWORK_VERSION = '3.0.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, isContinuingCommitment, isUnderWay, MAKRUH_DEFAULTS, makruhWindows, missedExcuse, onFinished, owedMakeUps, PRAYER_IMPORTANCE, PURPOSE_DEFAULTS, prayerWindows, pressureReachedAt, promise, proposeGoals, RAMADAN_DEFAULTS, ramadanFast, ramadanMeals, release as releaseCommitment, retimeCommitments, retirePaidMakeUps, revisePurposes, scheduleMakeUp, spanMeetsWindow, suhoorWindow, timesFor, violatesAbstention, } from './agenda/index.js';
@@ -42,5 +42,6 @@ export * from './scenarios/index.js';
 export * from './sim/index.js';
 export * from './skills/index.js';
 export * from './social/index.js';
+export { canonicalTickInputs } from './tick-input.js';
 export * from './types.js';
 export * from './will/index.js';

package/dist/longrun.d.ts

@@ -87,8 +87,8 @@ export interface RoutineDay {
  * Live one routine day from `p.now` (see SCOPE). A dead person only moves the clock. Returns what happened.
  */
 export declare function routineDay(p: Person, routine: Routine, opts?: RoutineOptions): RoutineDay;
-/** A routine, or one chosen per day (by season, age, role). */
-export type RoutineSource = Routine | ((p: Person, day: number) => Routine);
+/** Choose a routine for a person at the start of an absolute day. Capture host context in a closure. */
+export type RoutineSource = (p: Person, day: number) => Routine;
 /**
  * Live from `p.now` to `to` by routine (see SCOPE): the running activity is dropped and the open chronicle day closed
  * first, whole days are lived with `routineDay`, a remainder shorter than a day is skipped (`skip`), and past

package/dist/longrun.js

@@ -181,7 +181,6 @@ export function routineDay(p, routine, opts = {}) {
         report.stage = stageAfter;
     return report;
 }
-const routineOf = (src, p) => typeof src === 'function' ? src(p, dayOf(p.now)) : src;
 /**
  * Live from `p.now` to `to` by routine (see SCOPE): the running activity is dropped and the open chronicle day closed
  * first, whole days are lived with `routineDay`, a remainder shorter than a day is skipped (`skip`), and past
@@ -199,7 +198,7 @@ export function liveRoutine(p, to, routine, opts = {}) {
     endDay(p);
     p.activity = null;
     while (p.now + MINUTES_PER_DAY <= to && p.body.alive) {
-        const r = routineDay(p, routineOf(routine, p), opts);
+        const r = routineDay(p, routine(p, dayOf(p.now)), opts);
         if (r.episodes.length > 0 || r.onsets.length > 0 || r.stage || r.died)
             out.push(r);
     }

package/dist/memory/memory.d.ts

@@ -139,10 +139,6 @@ export interface RetellOptions {
  * from the listener to others (a host may call it again with the listener as teller).
  */
 export declare function retell(teller: Person, listener: Person, at: Minute, opts?: RetellOptions): Gist[];
-/** @deprecated since 2.1: pass `at` (and the optional knobs) positionally. Removed in 3.0. */
-export declare function retell(teller: Person, listener: Person, opts: RetellOptions & {
-    at: Minute;
-}): Gist[];
 /** Encode an episode. Evicts the weakest (salience × recency) episode beyond the bound. */
 export declare function remember(p: Person, e: Omit<Episode, 'id' | 'salience'> & {
     salience?: Unit;

package/dist/memory/memory.js

@@ -287,8 +287,22 @@ export const RETELL_DEFAULTS = {
     /** Gists weaker than this (teller's salience) are not worth telling. */
     minSalience: 0.1,
 };
-export function retell(teller, listener, when, knobs = {}) {
-    const opts = typeof when === 'number' ? { ...knobs, at: when } : when;
+/**
+ * `teller` tells `listener` at `at` the gist of what mattered to them (2.0, L2: stories passed in a household or around a
+ * fire). The listener must have gists on (`enableGists`); otherwise nothing happens. The teller's strongest gists
+ * (up to `limit`, optionally only those about `placeIds`) become the listener's own gists with the tag `told`, the
+ * teller's valence and summary, and a salience of the teller's × `trust` × `RETELL_DEFAULTS.share`. A listener who
+ * already holds a gist about the same thing (kind, action, target and place, whoever was there) from their own
+ * experience keeps it unchanged; one told before keeps the
+ * stronger telling (retelling the same story does not keep raising it). So a child of parents who fear a place
+ * weighs that fear (cognition's `memory` term, by place at half weight) before ever standing there, and their own
+ * later visits outweigh it as they would any gist. No randomness; returns the gists written or strengthened.
+ * It does not model distortion in the retelling, the listener doubting the teller beyond `trust`, or retelling on
+ * from the listener to others (a host may call it again with the listener as teller).
+ */
+export function retell(teller, listener, at, opts = {}) {
+    if (!Number.isFinite(at))
+        throw new TypeError('retell requires a finite positional time');
     const told = teller.memory.gists;
     const list = listener.memory.gists;
     if (!told || !list || teller.id === listener.id)
@@ -312,7 +326,7 @@ export function retell(teller, listener, when, knobs = {}) {
             if (salience > mine.salience) {
                 mine.salience = salience;
                 mine.weight = salience;
-                mine.lastAt = opts.at;
+                mine.lastAt = at;
                 out.push(mine);
             }
             continue;
@@ -321,15 +335,15 @@ export function retell(teller, listener, when, knobs = {}) {
         listener.memory.nextGist = (listener.memory.nextGist ?? 0) + 1;
         const g = {
             id,
-            at: opts.at,
+            at,
             kind: src.kind,
             valence: src.valence,
             salience,
             summary: src.summary,
             tags: ['told', ...src.tags.filter((t) => t !== 'told')].slice(0, GIST_DEFAULTS.maxTags),
             count: 0,
-            firstAt: opts.at,
-            lastAt: opts.at,
+            firstAt: at,
+            lastAt: at,
             weight: salience,
             peak: salience,
         };

package/dist/migrate.js

@@ -41,6 +41,11 @@ function renameAmbient(json) {
 }
 /** The chain, keyed by the version each step upgrades from. */
 export const MIGRATIONS = {
+    '2.21.0': {
+        to: '2.23.0',
+        note: 'shape unchanged; doze delivery and plain narration fixes apply to opted-in runs',
+        apply: stamp,
+    },
     '2.17.0': {
         to: '2.21.0',
         note: 'doze and bladder state start absent; old callers retain their continuation',

package/dist/narrate/narrate.js

@@ -332,7 +332,9 @@ export function describePerson(p, lexicon) {
         ? `${p.activity.action}${p.activity.targetId ? ` (${p.activity.targetId})` : ''}`
         : phraseLine('describe.idle', {}, lex);
     if (lex?.plainEnglish) {
-        const state = bits.length > 0 ? bits.join(', ') : phraseLine('describe.well', {}, lex);
+        const state = bits.length > 1
+            ? `${bits.slice(0, -1).join(', ')} and ${bits.at(-1)}`
+            : (bits[0] ?? phraseLine('describe.well', {}, lex));
         const activity = p.activity
             ? `${p.name} is doing this: ${p.activity.affordance.label}${p.activity.targetId ? ` (${nameOf(p, p.activity.targetId, lex)})` : ''}.`
             : `${p.name} is ${phraseLine('describe.idle', {}, lex)}.`;

package/dist/observed-reputation.js

@@ -1,6 +1,6 @@
 /**
  * SCOPE: opt-in composition of beliefs.confirm and social.applyReputationBelief, in that order.
- * Owns no state or formula. This is the Hearsay 2 wrapper: direct observation corrects the belief,
+ * Owns no state or formula. This host composition handles observed-trait correction: direct observation corrects the belief,
  * recalibrates its sources and applies the credence change to the subject's relationship. It does
  * not infer opposite traits, accuse a source of lying, run attention or record a percept. Hosts
  * supply only observations their person has access to. Existing callers remain unchanged.

package/dist/person.d.ts

@@ -196,7 +196,11 @@ export interface BeginOptions {
     /** Joint-activity proposal id (set by `sim/` when both partners begin together). */
     jointId?: string;
 }
-/** Start an activity chosen by `record`. Returns null when the person is dead. */
+/**
+ * Start an activity chosen by `record`. Returns null when dead, or when dozed work
+ * is unresolved. Call `finish` for the stopped activity before starting any replacement,
+ * including voluntary sleep or an activity chosen after a waking percept.
+ */
 export declare function begin(p: Person, aff: Affordance, record: DecisionRecord, opts?: BeginOptions): Activity | null;
 /**
  * Push the review time forward after a decision to continue the current activity, refresh the cached

package/dist/person.js

@@ -29,7 +29,8 @@ import { ageCharacter, enableCharacterChange, noteCharacterDay, noteCharacterSoc
 import { closeDay, enableYearbook, endDay, noteAnswer, noteCommitments, noteDecision, noteMood, noteOutcome, trimChronicle, } from './chronicle/index.js';
 import { decide as cognitionDecide, desperationOf, prospectiveRoute, scoreAll } from './cognition/index.js';
 import { createConscience, guiltLoad, heldNorms, normVeto, recordDeed, recordRepair, repent, } from './conscience/index.js';
-import { clamp01, clampSigned, createRng, dayOf, isObj, keysOf, minuteOfDay, round } from './core/index.js';
+import { clamp01, clampSigned, createRng, dayOf, isObj, minuteOfDay, round } from './core/index.js';
+import { keysOf } from './core/keys.js';
 import { enableCuriosity, noteCuriosity } from './curiosity/index.js';
 import { ambientBodyParams, ambientModifiers, ambientMood, ambientNeeds } from './environment/index.js';
 import { aptitudeOf, createFamily, pregnancyModifiers } from './family/index.js';
@@ -865,17 +866,18 @@ function judgeDeed(p, actor, pc, at) {
 export function perceive(p, percepts, options = {}) {
     if (percepts.length === 0 || !p.body.alive)
         return [];
-    if (p.body.doze?.since !== undefined) {
+    const dozeSince = p.body.doze?.since;
+    if (dozeSince !== undefined) {
         const wakes = percepts.some((pc) => Number.isFinite(pc.at) &&
-            pc.at === p.now &&
+            pc.at >= dozeSince &&
+            pc.at <= p.now &&
             Number.isFinite(pc.salience) &&
             pc.salience >= DOZE_DEFAULTS.wakeSalience &&
             pc.near !== false &&
             (pc.targetId === p.id || pc.near === true) &&
             (pc.channel === 'heard' || pc.channel === 'felt' || pc.channel === 'social'));
-        if (!wakes)
-            return [];
-        wakeDoze(p, p.now);
+        if (wakes)
+            wakeDoze(p, p.now);
     }
     const body = readBodyOf(p);
     const attended = attend(p, [...percepts], {
@@ -1170,9 +1172,13 @@ function thresholdFor(p, load, review) {
     const t = nextBodyThreshold(p, load, segmentModifiers(p), PERSON_DEFAULTS.interruptThresholds, review, p.ambient ? ambientBodyParams(p, BODY_DEFAULTS) : BODY_DEFAULTS, fastingCtx(p));
     return Number.isFinite(t) ? p.now + t : undefined;
 }
-/** Start an activity chosen by `record`. Returns null when the person is dead. */
+/**
+ * Start an activity chosen by `record`. Returns null when dead, or when dozed work
+ * is unresolved. Call `finish` for the stopped activity before starting any replacement,
+ * including voluntary sleep or an activity chosen after a waking percept.
+ */
 export function begin(p, aff, record, opts = {}) {
-    if (!p.body.alive)
+    if (!p.body.alive || p.activity?.dozedAt !== undefined)
         return null;
     if (p.body.doze?.since !== undefined && aff.mode !== 'sleep')
         return null;
@@ -1385,7 +1391,7 @@ function respondToConscience(p, act, now, completed, minutes) {
         // Worship closes breaches against God alone; guilt toward a wronged person waits for repair.
         const repented = new Set();
         for (const b of p.conscience.breaches) {
-            if (!b.repaired && b.victimId === undefined && repent(p, b.id, now))
+            if (!b.repaired && b.victimId === undefined && repent(p, b.id))
                 repented.add(b.normId);
         }
         for (const b of p.conscience.breaches)
@@ -1396,7 +1402,7 @@ function respondToConscience(p, act, now, completed, minutes) {
         regulate(p, minutes, 'worship');
     }
     if (completed && (tags.includes('repair') || tags.includes('apologize')) && aff.targetId !== undefined) {
-        recordRepair(p, aff.targetId, now);
+        recordRepair(p, aff.targetId);
         release(p, { id: 'guilt', targetId: aff.targetId });
         socialEvent(p, { at: now, kind: 'apology', otherId: aff.targetId, byMe: true, magnitude: 0.7 });
     }

package/dist/persona.js

@@ -188,6 +188,7 @@ export function validatePersonaProjection(input) {
     keys(input.source, ['schema', 'engine', 'id', 'now']);
     // The 2.14.1 and 2.17.0 portable fields retain their semantics across the bodily opt-ins.
     const compatibleEngine = input.source.engine === ENGINE_VERSION ||
+        input.source.engine === '2.21.0' ||
         input.source.engine === '2.17.0' ||
         input.source.engine === '2.14.1';
     if (input.source.schema !== PERSON_SCHEMA || !compatibleEngine)

package/dist/presentation.js

@@ -68,6 +68,7 @@ export function reasonLine(reason, lexicon) {
         'need:water': 'I need to drink first.',
         'need:sleep': 'I need to sleep first.',
         'need:rest': 'I need to rest first.',
+        'need:bladder': 'I need to use the toilet first.',
         'need:survival': 'I need to meet an urgent bodily need first.',
     };
     if (Object.hasOwn(lines, reason))

package/dist/promptings/promptings.js

@@ -360,7 +360,7 @@ export function nafsPatterns(p, inputs) {
             ref: 'Qur’an 12:53',
             evident: assentedAgainstNorm.length > 0,
             evidence: p.lexicon?.plainEnglish
-                ? `The person acted on ${assentedAgainstNorm.length} recent urges despite a rule they hold.`
+                ? `The person acted on ${assentedAgainstNorm.length} recent ${assentedAgainstNorm.length === 1 ? 'urge' : 'urges'} despite a rule they hold.`
                 : `${assentedAgainstNorm.length} recent prompts followed against a held norm`,
         },
         {
@@ -376,7 +376,7 @@ export function nafsPatterns(p, inputs) {
             ref: 'Qur’an 89:27',
             evident: letPass > 0 && assentedAgainstNorm.length === 0 && !reproach,
             evidence: p.lexicon?.plainEnglish
-                ? `${letPass} recent urges passed without action. ${assentedAgainstNorm.length} were acted on against a held rule. Current guilt or unresolved breach: ${reproach ? 'yes' : 'no'}.`
+                ? `${letPass} recent ${letPass === 1 ? 'urge' : 'urges'} passed without action. ${assentedAgainstNorm.length} ${assentedAgainstNorm.length === 1 ? 'was' : 'were'} acted on against a held rule. Current guilt or unresolved breach: ${reproach ? 'yes' : 'no'}.`
                 : `${letPass} recent prompts let pass, none followed against a norm, no felt reproach`,
         },
     ];

package/dist/qalb.d.ts

@@ -1,15 +1,3 @@
-/**
- * SCOPE: a read-only narration lens over retained attention evidence, held norms and conviction,
- * mood and the three distinct trust stores. Owns no state and supplies no decision input. It does
- * not infer spiritual health, rank people, judge norms, measure the ruh or compute divine acceptance.
- * Retained memories are evidence available for narration, not a complete attention history.
- *
- * Provenance: research/reconciliation.md §2–4, §7 (Q7: Qur'an 22:46; H9: Bukhari 52 /
- * Muslim 1599a); research/islamic-foundations.md §2 (qalb as an overlapping interpretive view);
- * research/decisions.md, “Qalb, nafs, fitra, ʿaql as state”. These support the lens, not a
- * diagnostic mapping. Sign/zero categories below are engineering descriptions of stored values,
- * not religious categories. Mood and interpersonal trust imply nothing about faith.
- */
 import type { Person } from './types.ts';
 export interface QalbDescription {
     facet: 'attention' | 'held-norm' | 'mood' | 'trust';

package/dist/qalb.js

@@ -1,3 +1,18 @@
+/**
+ * SCOPE: a read-only narration lens over retained attention evidence, held norms and conviction,
+ * mood and the three distinct trust stores. Owns no state and supplies no decision input. It does
+ * not infer spiritual health, rank people, judge norms, measure the ruh or compute divine acceptance.
+ * Retained memories are evidence available for narration, not a complete attention history.
+ *
+ * Provenance: research/reconciliation.md §2–4, §7 (Q7: Qur'an 22:46; H9: Bukhari 52 /
+ * Muslim 1599a); research/islamic-foundations.md §2 (qalb as an overlapping interpretive view);
+ * research/decisions.md, “Qalb, nafs, fitra, ʿaql as state”. These support the lens, not a
+ * diagnostic mapping. Sign/zero categories below are engineering descriptions of stored values,
+ * not religious categories. Mood and interpersonal trust imply nothing about faith.
+ */
+import { DEFAULT_NORMS } from './conscience/catalog.js';
+import { nameOf } from './narrate/lexicon.js';
+import { normLabel } from './presentation.js';
 /**
  * Plain English descriptions; no scalar summary, comparison or hidden update.
  * Hosts must not present these records as spiritual health or a religious assessment.
@@ -19,18 +34,17 @@ export function qalbReading(p) {
     if (!p.conscience.norms.length)
         add('held-norm', 'unrecorded', 'Their records contain no held rules.', ['conscience.norms']);
     for (const n of p.conscience.norms) {
+        const rule = normLabel(DEFAULT_NORMS.find((rule) => rule.id === n.normId) ?? { id: n.normId, label: n.normId }, { ...p.lexicon, plainEnglish: true });
         add('held-norm', n.conviction === 0 ? 'no-conviction' : 'held-understanding', n.conviction === 0
-            ? 'They have a recorded rule with no stated conviction.'
-            : 'They hold an understanding of this rule. This is their view.', [`norm:${n.normId}`, `standing:${n.standing}`, 'conscience.norms.conviction']);
+            ? `They have a recorded rule, “${rule}”, with no stated conviction.`
+            : `They hold an understanding of the rule “${rule}”. This is their view.`, [`norm:${n.normId}`, `standing:${n.standing}`, 'conscience.norms.conviction']);
     }
     add('mood', p.affect.mood.valence < 0 ? 'unpleasant' : p.affect.mood.valence > 0 ? 'pleasant' : 'neutral', p.affect.mood.valence < 0
         ? 'Their recorded mood feels unpleasant.'
         : p.affect.mood.valence > 0
             ? 'Their recorded mood feels pleasant.'
             : 'Their recorded mood feels neutral.', ['affect.mood.valence']);
-    add('mood', p.affect.mood.arousal === 0 ? 'no-arousal' : 'some-arousal', p.affect.mood.arousal === 0
-        ? 'Their recorded mood has no arousal.'
-        : 'Their recorded mood has some arousal.', ['affect.mood.arousal']);
+    add('mood', p.affect.mood.arousal === 0 ? 'no-arousal' : 'some-arousal', p.affect.mood.arousal === 0 ? 'Their recorded mood is calm.' : 'Their recorded mood is stirred.', ['affect.mood.arousal']);
     // Keep stores distinct. Do not substitute relationship trust for source or advising-voice trust.
     const ties = p.social.relationships.map((r) => ({
         store: 'social.relationships',
@@ -53,10 +67,10 @@ export function qalbReading(p) {
     for (const t of trusts) {
         // 0.5 is the numeric range midpoint, not a faith threshold or personal baseline.
         const subject = t.store === 'social.relationships'
-            ? 'this person'
+            ? `the person ${nameOf(p, t.id)}`
             : t.store === 'will.voices'
-                ? 'this advising voice'
-                : 'this information source';
+                ? `the advising voice ${nameOf(p, t.id)}`
+                : `the information source ${nameOf(p, t.id)}`;
         add('trust', t.trust < 0.5 ? 'below-midpoint' : t.trust > 0.5 ? 'above-midpoint' : 'at-midpoint', t.trust < 0.5
             ? `Their trust in ${subject} is below the middle of its range.`
             : t.trust > 0.5

package/dist/sim/longrun.d.ts

@@ -15,9 +15,9 @@
  * since a routine day writes only its own person. Births and arrivals are the host's (`birth`, `addPerson` in
  * `onDay`); a person added during the stretch starts on the next day.
  */
-import { type Routine, type RoutineDay } from '../longrun.ts';
+import { type RoutineDay, type RoutineSource } from '../longrun.ts';
 import type { SkillTransfer } from '../skills/index.ts';
-import type { Minute, Person, PersonId } from '../types.ts';
+import type { Minute, PersonId } from '../types.ts';
 import { type Community, type LifecourseOptions, type SimEvent } from './sim.ts';
 export declare const LIVE_COMMUNITY_DEFAULTS: {
     /** Upbringing time a day with the parents (engineering assumption: a few waking hours together). */
@@ -25,7 +25,7 @@ export declare const LIVE_COMMUNITY_DEFAULTS: {
 };
 export interface LiveCommunityOptions {
     /** Each living person's routine for a day (`day` is the day number being lived). */
-    routineFor(p: Person, day: number, c: Community): Routine;
+    routineFor: RoutineSource;
     /** At each dawn, before anyone's day: births, arrivals, routine changes. */
     onDay?(c: Community, day: number, at: Minute): void;
     /** Tell each death to everyone with a tie (default true; see `tellDeath`). */

package/dist/sim/longrun.js

@@ -70,7 +70,7 @@ export function liveCommunity(c, until, opts) {
                 tick(p, now);
             if (p.now !== now)
                 continue; // added mid-stretch with a later clock: joins when the day catches up
-            const r = routineDay(p, opts.routineFor(p, day, c), routineOpts);
+            const r = routineDay(p, opts.routineFor(p, day), routineOpts);
             if (r.episodes.length > 0 || r.onsets.length > 0 || r.stage || r.died) {
                 const list = days[p.id] ?? [];
                 list.push(r);

package/dist/sim/sim.js

@@ -840,10 +840,15 @@ export function stepCommunity(c, world, until, opts = {}) {
                     at: t,
                     personId: p.id,
                     kind: 'finish',
-                    detail: `${act.action} interrupted by doze`,
+                    detail: outcome.summary ??
+                        (p.lexicon?.plainEnglish
+                            ? `${p.name} stopped the task “${act.affordance.label}” because they dozed off.`
+                            : `${act.action} interrupted by doze`),
+                    decisionId: act.decisionId,
+                    affordanceId: act.affordanceId,
                     action: act.action,
                     status: outcome.status,
-                });
+                }, outcome.summary !== undefined);
             }
             c.idleUntil[p.id] = t + quantum;
             if (!ordinaryDue)
@@ -995,12 +1000,12 @@ export function stepCommunity(c, world, until, opts = {}) {
                 detail: p.lexicon?.plainEnglish
                     ? proposal.status === 'declined'
                         ? `The shared task “${chosen.label}” could not start because a partner was unavailable.`
-                        : `${chosen.label} with ${proposal.partnerIds.map((id) => personById(c, id)?.name ?? id).join(', ')}`
+                        : `${p.name} proposed the shared task “${chosen.label}” with ${proposal.partnerIds.map((id) => personById(c, id)?.name ?? id).join(', ')}.`
                     : `${chosen.label} with ${proposal.partnerIds.join(', ')}`,
                 affordanceId: chosen.id,
                 action: chosen.action,
                 jointId: proposal.id,
-            }, Boolean(p.lexicon?.plainEnglish && proposal.status === 'declined'));
+            }, Boolean(p.lexicon?.plainEnglish));
             continue;
         }
         if (act) {

package/dist/social/impressions.d.ts

@@ -1,8 +1,6 @@
 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)[];
 export declare const IMPRESSION_DEFAULTS: {
     /** Weight half-life by kind, minutes (0 = no decay). */
     halfLife: Record<CueKind, number>;
@@ -88,20 +86,10 @@ export declare function setReserve(p: Person, reserve: Partial<Record<StateCue,
  * the evidence and how true it is (a figure in the dark tells little and tells it wrong).
  */
 export declare function glimpse(observer: Person, targetId: PersonId, signs: OutwardSigns, at: Minute, clarity?: Unit): void;
-/** @deprecated since 2.1: pass `at` (and the optional knobs) positionally. Removed in 3.0. */
-export declare function glimpse(observer: Person, targetId: PersonId, signs: OutwardSigns, opts: {
-    at: Minute;
-    clarity?: Unit;
-}): void;
 /** What someone was seen to do: place fear, ties, trust in a voice and trait evidence (see `ObservedAct`). */
 export declare function observeAct(observer: Person, targetId: PersonId, act: ObservedAct, table?: Record<string, Partial<Record<keyof Traits, Unit>>>): void;
 /** Testimony about someone (their own words, or another's): `value` on `key`, weighted (e.g. by trust in the teller). */
 export declare function hear(observer: Person, targetId: PersonId, key: string, value: number, at: Minute, weight?: Unit): void;
-/** @deprecated since 2.1: pass `at` (and the optional knobs) positionally. Removed in 3.0. */
-export declare function hear(observer: Person, targetId: PersonId, key: string, value: number, opts: {
-    at: Minute;
-    weight?: Unit;
-}): void;
 /**
  * Years of history condensed (host call, e.g. at the start of a run for people who already know each other): one
  * sample per trait from `traits` with an error that shrinks with familiarity, at weight

package/dist/social/impressions.js

@@ -30,8 +30,6 @@ import { clamp, clamp01, cmpStr, decay, latestPerId, newestN, round } from '../c
 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;
 export const IMPRESSION_DEFAULTS = {
     /** Weight half-life by kind, minutes (0 = no decay). */
     halfLife: {
@@ -208,11 +206,16 @@ function erred(observer, targetId, key, at, value, clarity) {
     const e = (hash01(`${observer.id}|${targetId}|${key}|${at}`) - 0.5) * IMPRESSION_DEFAULTS.noise;
     return value + e * (1 - clamp01(clarity));
 }
-export function glimpse(observer, targetId, signs, when, clarity) {
+/**
+ * A look at someone's outward signs (from the composite's `outwardSigns`). `clarity` 0..1 scales both the weight of
+ * the evidence and how true it is (a figure in the dark tells little and tells it wrong).
+ */
+export function glimpse(observer, targetId, signs, at, clarity) {
+    if (!Number.isFinite(at))
+        throw new TypeError('glimpse requires a finite positional time');
     if (targetId === observer.id)
         return;
-    const at = typeof when === 'number' ? when : when.at;
-    const clear = clamp01((typeof when === 'number' ? clarity : when.clarity) ?? 1);
+    const clear = clamp01(clarity ?? 1);
     if (clear <= 0)
         return;
     const imp = impressionFor(observer, targetId, true, at);
@@ -252,11 +255,13 @@ export function observeAct(observer, targetId, act, table = IMPRESSION_DEFAULTS.
         }
     }
 }
-export function hear(observer, targetId, key, value, when, weight) {
+/** Testimony about someone (their own words, or another's): `value` on `key`, weighted (e.g. by trust in the teller). */
+export function hear(observer, targetId, key, value, at, weight) {
+    if (!Number.isFinite(at))
+        throw new TypeError('hear requires a finite positional time');
     if (targetId === observer.id)
         return;
-    const at = typeof when === 'number' ? when : when.at;
-    const w = clamp01((typeof when === 'number' ? weight : when.weight) ?? 0.5);
+    const w = clamp01(weight ?? 0.5);
     if (w <= 0)
         return;
     const imp = impressionFor(observer, targetId, true, at);

package/dist/social/social.js

@@ -12,7 +12,7 @@
  * 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 { clamp, clamp01, clampSigned, cmpStr, decay, dlog, round, sigmoid } from '../core/index.js';
 import { MINUTES_PER_DAY, MINUTES_PER_YEAR } from '../types.js';
 import { careFor } from './groups.js';
 import { regardOf } from './impressions.js';
@@ -554,7 +554,7 @@ export function reputation(people, targetId, table = REPUTATION_TRAITS) {
                 continue;
             knows = true;
             const slot = traitSum[parsed.trait] ?? { sum: 0, n: 0 };
-            slot.sum += expit(b.logOdds);
+            slot.sum += sigmoid(b.logOdds);
             slot.n += 1;
             traitSum[parsed.trait] = slot;
         }

package/dist/tick-input.d.ts

@@ -0,0 +1,24 @@
+/**
+ * SCOPE: opt-in host input ordering for one declared logical tick. Waits for the
+ * caller's complete expected identity set, then sorts by sender and sequence.
+ * Lexical sender priority is deterministic host policy, not fairness or
+ * consensus. For conflicting same-voice requests, earlier senders take priority.
+ * Owns no Person, clock, queue or RNG state. Does not supply transport, consensus,
+ * payload validation, retries or snapshot storage. Payloads remain caller-owned;
+ * hosts must agree on their meaning and save pending input alongside host state.
+ */
+export interface TickInputKey {
+    sender: string;
+    sequence: number;
+}
+export interface TickInput<T> extends TickInputKey {
+    tick: number;
+    payload: T;
+}
+/**
+ * Returns undefined while a declared input is missing. Unexpected, duplicate or
+ * wrong-tick inputs throw. An empty expected set is a complete barrier. This
+ * reader never mutates input arrays or envelopes and never reads payload fields.
+ * Call only when explicitly opting into this host scheduling convention.
+ */
+export declare function canonicalTickInputs<T>(tick: number, inputs: readonly TickInput<T>[], expected: readonly TickInputKey[]): TickInput<T>[] | undefined;

package/dist/tick-input.js

@@ -0,0 +1,56 @@
+const MAX_INPUTS = 256;
+function identity(key) {
+    if (typeof key.sender !== 'string' ||
+        key.sender.length === 0 ||
+        key.sender.length > 128 ||
+        !Number.isSafeInteger(key.sequence) ||
+        key.sequence < 0) {
+        throw new Error('Invalid tick input identity');
+    }
+    return JSON.stringify([key.sender, key.sequence]);
+}
+/**
+ * Returns undefined while a declared input is missing. Unexpected, duplicate or
+ * wrong-tick inputs throw. An empty expected set is a complete barrier. This
+ * reader never mutates input arrays or envelopes and never reads payload fields.
+ * Call only when explicitly opting into this host scheduling convention.
+ */
+export function canonicalTickInputs(tick, inputs, expected) {
+    if (!Number.isSafeInteger(tick) || tick < 0)
+        throw new Error('Invalid logical tick');
+    if (inputs.length > MAX_INPUTS || expected.length > MAX_INPUTS) {
+        throw new Error('Tick input limit exceeded');
+    }
+    const wanted = new Set();
+    for (const key of expected) {
+        const id = identity(key);
+        if (wanted.has(id))
+            throw new Error('Duplicate expected tick input');
+        wanted.add(id);
+    }
+    const received = new Set();
+    for (const input of inputs) {
+        const id = identity(input);
+        if (input.tick !== tick)
+            throw new Error('Input belongs to another tick');
+        if (!wanted.has(id))
+            throw new Error('Unexpected tick input');
+        if (received.has(id))
+            throw new Error('Duplicate tick input');
+        received.add(id);
+    }
+    if (received.size !== wanted.size)
+        return undefined;
+    return inputs
+        .map((input) => ({
+        tick: input.tick,
+        sender: input.sender,
+        sequence: input.sequence,
+        payload: input.payload,
+    }))
+        .sort((a, b) => {
+        if (a.sender !== b.sender)
+            return a.sender < b.sender ? -1 : 1;
+        return a.sequence - b.sequence;
+    });
+}