@adam0white/human-framework 2.15.0 → 2.17.0

package/README.md

@@ -410,6 +410,7 @@ Knowledge lives in optional `Person.prospection` and survives snapshot/restore.
 `projectPersona(source, mapping)` produces `PersonaProjectionSnapshot` (`hf-persona-state/1`).
 `admitPersona(projection, targetOpening, { mappingVersion, sourceId, targetId })` returns a detached
 `{ person, report }`. `validatePersonaProjection(unknown)` validates portable data without filling defaults.
+Portable v1 accepts the published 2.14.1 source-engine stamp and the current engine; it preserves that source provenance. Unknown source engines remain rejected.
 These functions never enter the actor loop and never mutate the source or the host opening.
 
 The host supplies a versioned map of skill ids, selected episode ids and every continuing obligation.
@@ -440,3 +441,38 @@ commitment history prunes it. It removes only records matched to an existing, cl
 recursively frozen, detached `MakeUpReceipt` objects. Persist those receipts in the source replay. Pending,
 broken, released, exempt and missing matches remain unresolved. The normal actor loop never calls retirement;
 existing games and saves keep their previous behavior until a host opts in.
+
+
+### Calendar passports (2.16.0, opt-in)
+
+Use `projectCalendarPersona(source, { version, skills, episodes, calendar })` when declared obligations must
+travel. `calendar` has version `hf-persona-calendar-map/1`, one exact clock offset, explicit injective maps
+for commitment, chain, action, entity and norm references, and the source-backed norm catalog.
+The result is `hf-persona-calendar/1`, wrapping the original approved Person projection and a separate
+calendar. It preserves continuing commitments, every owed record, actual retained receipts, held norm
+understandings and lapse state. A missing scheduled receipt remains unresolved and is disclosed; it never
+becomes a paid duty. `isContinuingCommitment(agenda, commitment)` lets a host construct the required maps
+using the owning agenda's existing recurrence semantics.
+
+`validateCalendarPersona` strictly validates portable data. `admitCalendarPersona(payload, opening,
+{ mappingVersion, sourceId, targetId, targetNorms })` checks the offset and exact catalog semantics before
+returning a detached Person. The receiving calendar must be empty; authored role goals may remain. After
+admission, the host uses ordinary agenda APIs and its declared calendar. No duty is waived, no new ruling
+is invented, and no obligation is converted to a score. Activities, projects and incompatible identity or
+health remain unsupported. The original passport format and no-call continuation remain unchanged.
+
+### Project protection and narration options
+
+Projects can opt into undo protection with `enableProjects(person, { protectProgress: true })`.
+Declare `diminishes: [prospectId]` on an offer or its described successor, or let the person
+learn the exact action context from a perceived drop after its own completed act.
+`adoptProjectTask(person, prospectId, task)` reuses an active project and its net credit
+for a host task; an absent match returns `undefined`.
+
+Narration remains unchanged unless requested. Set `person.lexicon.variety`,
+`nounActions` or `materialMeaning` for the corresponding host wording. Use
+`promptingLine(reading, outcome, kind, { voice: 'third' })` for plain third-person lines.
+`converse` adds per-call `loyalWarning`, `confidentMin` and `phrase` options;
+`perceive` adds a third `{ reputationTraits }` argument. See the architecture's
+[narration and social host options](../../docs/framework.md#narration-and-social-host-options-opt-in)
+for cause-aware reviews and actor-addressed recall. These options change no default continuation.

package/dist/agenda/agenda.d.ts

@@ -56,6 +56,8 @@ export declare function createAgenda(spec: {
 export declare function promise(p: Person, c: Omit<Commitment, 'id' | 'status'>): Commitment;
 /** Release a pending commitment (the other party let it go). Released commitments do not recur. */
 export declare function release(p: Person, id: string): boolean;
+/** Whether an instance still owns a pending duty or a recurrence that can produce its next window. Read-only. */
+export declare const isContinuingCommitment: (state: AgendaState, c: Commitment) => boolean;
 /**
  * Whether an activity that would keep `c` is under way at `now`: begun no later than the window's end
  * (`spanMeetsWindow`), not yet ended, not sleep, and serving `c` (listed in `fulfills` or matching its action and

package/dist/agenda/agenda.js

@@ -49,6 +49,7 @@
 import { DEFAULT_NORMS } from '../conscience/catalog.js';
 import { clamp01, dayOf, dpow, hasNumbers, isNum, isObj } from '../core/index.js';
 import { expectedEffect } from '../memory/index.js';
+import { diminishesProject } from '../projects/index.js';
 import { MINUTES_PER_DAY } from '../types.js';
 export const AGENDA_DEFAULTS = {
     /** Minutes before a window opens during which a commitment already pulls (to get there). */
@@ -246,6 +247,13 @@ const sameShape = (a, b) => a.kind === b.kind &&
 const hasSuccessor = (state, c) => state.commitments.some((x) => x !== c && x.from > c.from && sameChain(x, c));
 /** Closed instances that carry their chain on: kept, broken, or released by an exemption (not by the other party). */
 const chainLink = (c) => c.status === 'kept' || c.status === 'broken' || (c.status === 'released' && c.exempt !== undefined);
+/** Whether an instance still owns a pending duty or a recurrence that can produce its next window. Read-only. */
+export const isContinuingCommitment = (state, c) => c.status === 'pending' ||
+    (c.recurEvery !== undefined &&
+        c.recurEvery > 0 &&
+        chainLink(c) &&
+        (c.recurUntil === undefined || c.from + c.recurEvery <= c.recurUntil) &&
+        !hasSuccessor(state, c));
 const needsSpawn = (state, c, now) => c.recurEvery !== undefined &&
     c.recurEvery > 0 &&
     chainLink(c) &&
@@ -520,6 +528,8 @@ function goalValue(g, aff, now) {
 }
 /** Opt-in completion-time and success estimate, shared by direct and received routes. @internal */
 export function temporalGoalValue(p, g, aff, now, completion) {
+    if (g.project && diminishesProject(p, aff, g.project.prospectId))
+        return 0;
     const base = goalValue(g, aff, now);
     return g.temporal
         ? base *
@@ -571,7 +581,7 @@ export function agendaTermsWithGoalEstimates(p, aff, now, goalOverrides) {
         terms.push({ source: `commitment:${c.id}`, value: d.commitmentScale * c.importance * pressure });
     }
     for (const g of p.agenda.goals) {
-        if (g.status !== 'active')
+        if (g.status !== 'active' || (g.project && diminishesProject(p, aff, g.project.prospectId)))
             continue;
         const override = goalOverrides?.get(g.id);
         if (override !== undefined || g.temporal) {

package/dist/conversation/conversation.d.ts

@@ -55,6 +55,12 @@ export interface ConverseContext {
     traits?: Record<string, TraitEffect>;
     /** Carry belief origin and opaque lineage into told claims (off by default). */
     provenance?: boolean;
+    /** Relay beliefs this far from 0.5 (0..0.5); default 0.2. Invalid values use the default. */
+    confidentMin?: number;
+    /** Let a fond speaker warn the listener of an unfavourable character claim about them. */
+    loyalWarning?: boolean;
+    /** Presentation only. Receives a told claim or a withheld reason and its default summary; never changes selection. */
+    phrase?: (claim: Readonly<ToldClaim | WithheldClaim>, summary: string) => string;
 }
 /** Host-visible record of one claim. */
 export interface ToldClaim {
@@ -80,6 +86,12 @@ export interface AdviceGiven {
     /** For the listener's next decision; the voice is the speaker. */
     suggestion: Suggestion;
 }
+export interface WithheldClaim {
+    prop: string;
+    reason: string;
+    /** Present only when a host phrasing callback rendered this reason. */
+    summary?: string;
+}
 export interface ConversationResult {
     /** Testimony percepts for `perceive(listener, told)`. */
     told: Percept[];
@@ -87,10 +99,7 @@ export interface ConversationResult {
     advice: AdviceGiven[];
     claims: ToldClaim[];
     /** Candidate claims the speaker held back, and why (e.g. 'norm:backbiting', 'norm:lying'). */
-    withheld: {
-        prop: string;
-        reason: string;
-    }[];
+    withheld: WithheldClaim[];
     /** True when any told claim was a lie. */
     deceit: boolean;
     /** The speaker's own deed tags for conscience (e.g. backbiting/lying violated), deduplicated, sorted. */

package/dist/conversation/conversation.js

@@ -21,6 +21,10 @@
  * share of conversation about absent third parties that spreads reputational information (Dunbar 2004), and
  * extraversion as talkativeness (how many claims are offered).
  *
+ * SCOPE (host options): `loyalWarning` admits only unfavourable listener claims when affection is at least
+ * 0.5 (an engineering threshold). `confidentMin` sets a per-call relay threshold. `phrase` renders selected
+ * testimony only; the host owns authored facts, delivery and subsequent disclosure. No hidden relay occurs.
+ *
  * It does NOT generate language, model turn-taking, persuasion beyond source trust, what the speaker believes
  * the listener already knows, lies of omission, white lies told to spare feelings, or the speaker's fear of
  * being found out. Coefficients are engineering defaults, not calibrated estimates. Nothing here judges the
@@ -150,12 +154,25 @@ export function converse(speaker, listener, ctx) {
         if (b.prop.startsWith('advice:') || b.prop.includes(':should:'))
             continue;
         const subject = b.prop.split(':')[0];
-        if (subject === listener.id || subject === speaker.id)
+        if (subject === speaker.id)
             continue;
         const cred = expit(b.logOdds);
-        if (Math.abs(cred - 0.5) < C.confidentMin)
+        const threshold = Number.isFinite(ctx.confidentMin) &&
+            ctx.confidentMin >= 0 &&
+            ctx.confidentMin <= 0.5
+            ? ctx.confidentMin
+            : C.confidentMin;
+        if (Math.abs(cred - 0.5) < threshold)
             continue;
         const value = cred > 0.5;
+        if (subject === listener.id) {
+            const trait = parseTraitProp(b.prop, table)?.trait;
+            if (!ctx.loyalWarning ||
+                relationshipWith(speaker, listener.id).affection < 0.5 ||
+                trait === undefined ||
+                !isUnfavourableTrait(trait, value, table))
+                continue;
+        }
         const confidence = value ? cred : 1 - cred;
         const recency = 1 / (1 + Math.max(0, ctx.at - b.updatedAt) / C.recencyScale);
         consider(b.prop, value, confidence, cred, false, R.confidence * (confidence - 0.5) * 2 + R.recency * recency);
@@ -231,6 +248,8 @@ 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'}`,
         };
+        if (ctx.phrase)
+            pc.summary = ctx.phrase(Object.freeze(structuredClone(c)), pc.summary ?? '');
         const claim = pc.claims?.[0];
         if (claim && c.origin !== undefined)
             claim.origin = c.origin;
@@ -292,6 +311,9 @@ export function converse(speaker, listener, ctx) {
             suggestion.appeal = 'benevolence';
         out.advice.push({ action: a.action, percept, suggestion });
     }
+    if (ctx.phrase)
+        for (const withheld of out.withheld)
+            withheld.summary = ctx.phrase(Object.freeze(structuredClone(withheld)), withheld.reason);
     const magnitude = clamp01((ctx.magnitude ?? C.chatMagnitude) + C.chatPerClaim * out.told.length);
     out.socialEvents.speaker.push({ at: ctx.at, kind: 'chat', otherId: listener.id, byMe: true, magnitude });
     out.socialEvents.listener.push({ at: ctx.at, kind: 'chat', otherId: speaker.id, byMe: false, magnitude });

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /** Human Framework public surface. */
-export declare const FRAMEWORK_VERSION = "2.15.0";
+export declare const FRAMEWORK_VERSION = "2.17.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';
-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, retirePaidMakeUps, revisePurposes, scheduleMakeUp, spanMeetsWindow, suhoorWindow, timesFor, violatesAbstention, } from './agenda/index.ts';
+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.ts';
 export * from './beliefs/index.ts';
 export * from './body/index.ts';
 export * from './character/index.ts';
@@ -31,7 +31,8 @@ export * from './partnering/index.ts';
 export { enablePersistence, PERSISTENCE_DEFAULTS, pursuitOf } from './persistence/index.ts';
 export * from './person.ts';
 export * from './persona.ts';
-export { considerProjects, enableProjects, PROJECTS_DEFAULTS, projectAppeal } from './projects/index.ts';
+export * from './persona-calendar.ts';
+export { adoptProjectTask, considerProjects, enableProjects, PROJECTS_DEFAULTS, projectAppeal, } from './projects/index.ts';
 export * from './promptings/index.ts';
 export type { ConsequenceEvidence, PlanRoute, PlanStep } from './prospection/index.ts';
 export { bodyForecastFor, bodyForecastTerm, consequenceEvidence, enablePlanning, FORECAST_DEFAULTS, forecastLine, forecastThresholds, PROSPECTION_DEFAULTS, seedConsequences, } from './prospection/index.ts';

package/dist/index.js

@@ -1,8 +1,8 @@
 /** Human Framework public surface. */
-export const FRAMEWORK_VERSION = '2.15.0';
+export const FRAMEWORK_VERSION = '2.17.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, retirePaidMakeUps, revisePurposes, scheduleMakeUp, spanMeetsWindow, suhoorWindow, timesFor, violatesAbstention, } from './agenda/index.js';
+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';
 export * from './beliefs/index.js';
 export * from './body/index.js';
 export * from './character/index.js';
@@ -28,7 +28,8 @@ export * from './partnering/index.js';
 export { enablePersistence, PERSISTENCE_DEFAULTS, pursuitOf } from './persistence/index.js';
 export * from './person.js';
 export * from './persona.js';
-export { considerProjects, enableProjects, PROJECTS_DEFAULTS, projectAppeal } from './projects/index.js';
+export * from './persona-calendar.js';
+export { adoptProjectTask, considerProjects, enableProjects, PROJECTS_DEFAULTS, projectAppeal, } from './projects/index.js';
 export * from './promptings/index.js';
 export { bodyForecastFor, bodyForecastTerm, consequenceEvidence, enablePlanning, FORECAST_DEFAULTS, forecastLine, forecastThresholds, PROSPECTION_DEFAULTS, seedConsequences, } from './prospection/index.js';
 export { fingerprint, restore, snapshot } from './restore.js';

package/dist/migrate.js

@@ -71,6 +71,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.14.1': {
+        to: '2.17.0',
+        note: 'version stamp only; project protection and narration/social options require explicit opt-in, and existing enabled faculties retain exact behavior',
+        apply: stamp,
+    },
     '2.14.0': {
         to: '2.14.1',
         note: 'version stamp only; restored projects and persistence retain 2.14.0 behaviour until explicitly re-enabled',

package/dist/narrate/lexicon.js

@@ -34,6 +34,23 @@ export const EN_LINES = {
     // Decision lines by other dominant sources.
     'source:habit': ['Same as always.', 'Out of habit, really.', "It's what I do at this hour."],
     'source:effort': ['The easy thing, for now.', 'Nothing strenuous.'],
+    'review.cause': [
+        'After {cause}, {missed} remained undone. {next}',
+        'I left {missed} unfinished after {cause}. {next}',
+        'I was {cause}; {missed} went unfinished. {next}',
+    ],
+    'review.accounting': [
+        "I didn't keep {missed}. Next time I'll be ready when it comes.",
+        'I left {missed} undone. I will prepare for the next occasion.',
+        'Today {missed} went unfinished. Next time I will make room for it.',
+    ],
+    'review.ruminating': [
+        'I keep going back over {missed}.',
+        'My thoughts keep returning to {missed}.',
+        'I cannot stop turning {missed} over in my mind.',
+    ],
+    'source:material.named': ['It brings {material}.', 'We can use the {material}.'],
+    'intention.material.named': ['for {material}'],
     'source:material': ['There is money in it.', 'It pays.'],
     'source:expectation': ['It went well last time.', 'I know how this goes.'],
     'source:conscience:repair': ['I owe them that much.', 'I have to make this right.'],
@@ -363,6 +380,12 @@ function regularGerund(verb) {
 export function actionForms(action, lexicon) {
     const given = lexicon?.actions?.[action];
     const base = given?.base ?? action.replace(/[-_]/g, ' ');
+    if (lexicon?.nounActions)
+        return {
+            base: given?.base ?? `do ${base}`,
+            past: given?.past ?? `did ${base}`,
+            gerund: given?.gerund ?? `doing ${base}`,
+        };
     const [verb = base, ...rest] = base.split(' ');
     const tail = rest.length > 0 ? ` ${rest.join(' ')}` : '';
     return {

package/dist/narrate/narrate.d.ts

@@ -1,4 +1,4 @@
-import type { DecisionRecord, Lexicon, Person, SuggestionResolution } from '../types.ts';
+import type { DecisionRecord, Episode, Lexicon, Person, SuggestionResolution } from '../types.ts';
 /** Intention string for a decision: 'for Allah', 'to feed myself', 'to keep my promise to X', ... */
 export declare function intentionFor(p: Person, record: DecisionRecord, lexicon?: Lexicon): string;
 /** First-person narration of a decision record. Deterministic by the decision id. */
@@ -7,3 +7,9 @@ export declare function narrateDecision(p: Person, record: DecisionRecord, lexic
 export declare function voiceLine(p: Person, res: SuggestionResolution, key?: string, lexicon?: Lexicon): string;
 /** Short UI summary of a person's state. */
 export declare function describePerson(p: Person, lexicon?: Lexicon): string;
+/**
+ * SCOPE: a host-authored addressee form of an episode, selected only for its named actor.
+ * Free text cannot safely be inflected. With no authored form, return the original summary.
+ * This read-only helper neither recalls an episode nor changes its salience or RNG.
+ */
+export declare function recallLine(episode: Episode, toActor: string): string;

package/dist/narrate/narrate.js

@@ -93,7 +93,9 @@ export function intentionFor(p, record, lexicon) {
         case 'emotion':
             return phraseLine('intention.emotion', {}, lex);
         case 'material':
-            return phraseLine('intention.material', {}, lex);
+            return lex?.materialMeaning !== undefined
+                ? phraseLine('intention.material.named', { material: lex.materialMeaning }, lex)
+                : phraseLine('intention.material', {}, lex);
         case 'precommit':
             return phraseLine('intention.precommit', {}, lex);
         case 'expectation':
@@ -157,6 +159,8 @@ export function narrateDecision(p, record, lexicon) {
             ? pickLine(`emotion:${tag}`, id, {}, lex)
             : pickLine('emotion:default', id, {}, lex));
     }
+    else if (kind === 'material' && lex?.materialMeaning !== undefined)
+        parts.push(pickLine('source:material.named', id, { material: lex.materialMeaning }, lex));
     else
         parts.push(linesFor(`source:${source}`, lex).length > 0
             ? pickLine(`source:${source}`, id, {}, lex)
@@ -192,6 +196,8 @@ export function narrateDecision(p, record, lexicon) {
 /** The person's spoken reply to a suggestion. */
 export function voiceLine(p, res, key = res.reason, lexicon) {
     const lex = lexicon ?? p.lexicon;
+    if (lex?.variety && (res.verdict === 'assented' || res.verdict === 'deferred'))
+        key = `${p.id}:${p.now}:${p.traits.extraversion}:${p.traits.honesty}:${key}`;
     const trust = p.will.voices.find((v) => v.voiceId === res.voiceId)?.trust ?? 0.5;
     switch (res.verdict) {
         case 'assented':
@@ -293,3 +299,13 @@ export function describePerson(p, lexicon) {
     const state = bits.length > 0 ? bits.join(', ') : phraseLine('describe.well', {}, lex);
     return phraseLine('describe.line', { name: p.name, act, state }, lex);
 }
+/**
+ * SCOPE: a host-authored addressee form of an episode, selected only for its named actor.
+ * Free text cannot safely be inflected. With no authored form, return the original summary.
+ * This read-only helper neither recalls an episode nor changes its salience or RNG.
+ */
+export function recallLine(episode, toActor) {
+    return episode.actorId === toActor && episode.addressedSummary !== undefined
+        ? episode.addressedSummary
+        : episode.summary;
+}

package/dist/person.d.ts

@@ -1,6 +1,7 @@
 import { type BodyForecastSpan } from './body/index.ts';
 import { type NafsPattern } from './promptings/index.ts';
 import { type SkillTransfer } from './skills/index.ts';
+import { applyReputationBelief } from './social/index.ts';
 import type { Activity, Affordance, BodyLoad, BodyReadout, Command, Commitment, DecisionRecord, LearningDomain, Minute, NeedId, NeedReading, NormDefinition, Outcome, Percept, Person, PersonSpec, Retention, Suggestion, SuggestionResolution, Unit } from './types.ts';
 import { type CommandOutcome } from './will/index.ts';
 export declare const PERSON_DEFAULTS: {
@@ -85,12 +86,16 @@ export declare function standUp(p: Person): boolean;
  * only age (from `life.bornAt`) changes. Hosts that want the interval lived call `tick`.
  */
 export declare function skip(p: Person, to: Minute): void;
+export interface PerceiveOptions {
+    /** Complete host character-trait vocabulary; absent uses HF's default table. */
+    reputationTraits?: Parameters<typeof applyReputationBelief>[5];
+}
 /**
  * Attend to percepts (limited capacity), then encode what got through: claims into beliefs, interactions
  * into relationships, others' acts judged by my norms, appraisal into emotions, and an episode each.
  * Returns the percepts that were attended to.
  */
-export declare function perceive(p: Person, percepts: readonly Percept[]): Percept[];
+export declare function perceive(p: Person, percepts: readonly Percept[], options?: PerceiveOptions): Percept[];
 export interface DecideOptions {
     suggestion?: Suggestion;
     /** Several voices in one decision (N1); merged with `suggestion`, one per voice id. */

package/dist/person.js

@@ -38,7 +38,7 @@ import { intentionFor, narrateDecision, voiceLine } from './narrate/index.js';
 import { advanceNeeds, createNeeds, levelOf, meanSatisfaction, readNeeds, satisfy, urgencyOf, } from './needs/index.js';
 import { widow } from './partnering/index.js';
 import { beginPursuit, enablePersistence, releasePursuit } from './persistence/index.js';
-import { considerProjects, enableProjects, noteProjectStatus, perceiveProspect } from './projects/index.js';
+import { considerProjects, enableProjects, noteProjectAct, noteProjectStatus, perceiveProspect, } from './projects/index.js';
 import { enablePromptings, nafsPatterns, notePromptings } from './promptings/index.js';
 import { bodyForecastFor, consumeConsequences, enablePlanning, forecastLine, forecastThresholds, pruneConsequences, receiveConsequences, } from './prospection/index.js';
 import { enableReview, reviewIfDue } from './review/index.js';
@@ -585,10 +585,10 @@ function socialKindOf(kind) {
         return kind;
     return SOCIAL_ALIASES[kind];
 }
-function perceiveOne(p, pc) {
+function perceiveOne(p, pc, options) {
     receiveConsequences(p, pc);
     if (p.projects && pc.prospect)
-        perceiveProspect(p, pc.prospect, pc.at);
+        perceiveProspect(p, pc.prospect, pc.at, (pc.channel === 'saw' || pc.channel === 'outcome') && (pc.actorId === undefined || pc.actorId === p.id));
     const at = Math.min(Math.max(pc.at, p.affect.lastUpdated), p.now);
     const actor = pc.actorId;
     const target = pc.targetId;
@@ -606,7 +606,7 @@ function perceiveOne(p, pc) {
         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);
+        applyReputationBelief(p, claim.prop, before, credence(p, claim.prop), at, options.reputationTraits);
     }
     // 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)) {
@@ -724,8 +724,11 @@ function perceiveOne(p, pc) {
         summary: pc.summary,
         tags: [pc.kind, pc.channel, ...(isNight(at) ? ['night'] : []), ...(threat ? ['threat'] : [])],
     };
-    if (actor !== undefined)
+    if (actor !== undefined) {
         episode.actorId = actor;
+        if (pc.addressedSummary !== undefined)
+            episode.addressedSummary = pc.addressedSummary;
+    }
     if (target !== undefined)
         episode.targetId = target;
     if (pc.placeId !== undefined)
@@ -748,7 +751,7 @@ function judgeDeed(p, actor, pc, at) {
  * into relationships, others' acts judged by my norms, appraisal into emotions, and an episode each.
  * Returns the percepts that were attended to.
  */
-export function perceive(p, percepts) {
+export function perceive(p, percepts, options = {}) {
     if (percepts.length === 0 || !p.body.alive)
         return [];
     const body = readBodyOf(p);
@@ -758,7 +761,7 @@ export function perceive(p, percepts) {
         fear: emotionLevel(p, 'fear'),
     });
     for (const pc of attended) {
-        perceiveOne(p, pc);
+        perceiveOne(p, pc, options);
         // What I just noticed may bring a memory back (the cemetery road, her name on the phone).
         const at = Math.min(Math.max(pc.at, p.affect.lastUpdated), p.now);
         const cue = { at, action: pc.kind, tags: [pc.kind] };
@@ -1449,8 +1452,10 @@ export function finish(p, outcome, opts = {}) {
         ...(act.necessity ? { necessity: true } : {}),
         ...(opts.catalog ? { catalog: opts.catalog } : {}),
     });
-    if (p.projects)
+    if (p.projects) {
+        noteProjectAct(p, aff, completed, now);
         noteProjectStatus(p, now);
+    }
     if (p.pursuit)
         releasePursuit(p);
     // A completed violating action inside an open abstention's window broke it (the fast, e.g. "no work after the evening prayer").

package/dist/persona-calendar.d.ts

@@ -0,0 +1,39 @@
+import { type PersonaAdmission, type PersonaAdmissionResult, type PersonaProjection, type PersonaProjectionSnapshot } from './persona.ts';
+import { type Commitment, type HeldNorm, type NormDefinition, type OwedMakeUp, type Person } from './types.ts';
+export interface PersonaCalendarMap {
+    version: 'hf-persona-calendar-map/1';
+    /** Exactly target opening minus source departure. All retained calendar timestamps use this offset. */
+    offset: number;
+    references: {
+        commitments: Record<string, string>;
+        chains: Record<string, string>;
+        actions: Record<string, string>;
+        entities: Record<string, string>;
+        norms: Record<string, string>;
+    };
+    sourceNorms: NormDefinition[];
+}
+export interface CalendarPersonaProjection extends Omit<PersonaProjection, 'commitments'> {
+    calendar: PersonaCalendarMap;
+}
+export interface CalendarPersonaSnapshot {
+    format: 'hf-persona-calendar/1';
+    person: PersonaProjectionSnapshot;
+    calendar: {
+        offset: number;
+        commitments: Commitment[];
+        owed: OwedMakeUp[];
+        lapse: Person['agenda']['lapse'] | null;
+        heldNorms: HeldNorm[];
+        norms: NormDefinition[];
+    };
+}
+export interface CalendarPersonaAdmission extends PersonaAdmission {
+    targetNorms: NormDefinition[];
+}
+/** Validate portable calendar data strictly; no restore defaults or debt settlement. */
+export declare function validateCalendarPersona(input: unknown): CalendarPersonaSnapshot;
+/** Source declares a complete semantic ID map, a clock offset and source-backed norm catalog. */
+export declare function projectCalendarPersona(source: Person, mapping: CalendarPersonaProjection): CalendarPersonaSnapshot;
+/** Receiver declares identical norm meanings and a clean calendar at the exact declared opening clock. */
+export declare function admitCalendarPersona(input: unknown, target: Person, policy: CalendarPersonaAdmission): PersonaAdmissionResult;