@adam0white/human-framework 2.15.0 → 2.17.0

package/dist/promptings/promptings.js

@@ -256,7 +256,19 @@ export function notePromptings(p, seen, chosenId, now) {
     return noted;
 }
 /** Vocabulary for one prompt under a held reading (narration only; it changes nothing). */
-export function promptingLine(reading, outcome, kind) {
+export function promptingLine(reading, outcome, kind, options = {}) {
+    // Plain third-person observations describe the response, without inferring the prompt's origin.
+    if (options.voice === 'third') {
+        if (outcome === 'assented')
+            return 'an urge came and was acted on';
+        if (outcome === 'turned')
+            return kind === 'refuge'
+                ? 'an urge came; the person sought refuge and let it pass'
+                : kind === 'redirect'
+                    ? 'an urge came; the person turned to something else'
+                    : 'an urge came; the person held back';
+        return 'an urge came and passed';
+    }
     if (outcome === 'assented')
         return reading === 'whisper'
             ? 'a whisper came and was followed'

package/dist/prospection/prospection.js

@@ -17,6 +17,7 @@ import { temporalGoalValue } from '../agenda/agenda.js';
 import { trustOf } from '../beliefs/index.js';
 import { cmpStr, isNum, isObj, round } from '../core/index.js';
 import { expectedEffect } from '../memory/index.js';
+import { diminishesProject } from '../projects/index.js';
 import { MAX_MINUTE, MINUTES_PER_DAY } from '../types.js';
 export const PROSPECTION_DEFAULTS = {
     maxEntries: 16,
@@ -92,6 +93,10 @@ function consequence(x, receivedAt) {
             (!Array.isArray(s.advances) ||
                 s.advances.length > 8 ||
                 !s.advances.every((x) => typeof x === 'string' && x.length > 0 && x.length <= 512))) ||
+        (s.diminishes !== undefined &&
+            (!Array.isArray(s.diminishes) ||
+                s.diminishes.length > 8 ||
+                !s.diminishes.every((x) => typeof x === 'string' && x.length > 0 && x.length <= 512))) ||
         (s.focus !== undefined && !unit(s.focus)) ||
         (s.materialCost !== undefined &&
             (!isNum(s.materialCost) || s.materialCost < 0 || s.materialCost > PROSPECTION_DEFAULTS.maxMaterialCost)))
@@ -115,6 +120,7 @@ function consequence(x, receivedAt) {
             duration: s.duration,
             effort: s.effort,
             ...(s.advances !== undefined ? { advances: [...s.advances] } : {}),
+            ...(s.diminishes !== undefined ? { diminishes: [...s.diminishes] } : {}),
             ...(s.focus !== undefined ? { focus: s.focus } : {}),
             ...(s.materialCost !== undefined ? { materialCost: s.materialCost } : {}),
         },
@@ -262,7 +268,9 @@ function successorOffer(e) {
 }
 /** Select a whole route in the exact rounded units cognition emits. @internal */
 export function receivedGoalRoute(p, aff, now, maturityScale, costs) {
-    const goals = p.agenda.goals.filter((g) => g.status === 'active' && g.temporal !== undefined);
+    const goals = p.agenda.goals.filter((g) => g.status === 'active' &&
+        g.temporal !== undefined &&
+        !(g.project && diminishesProject(p, aff, g.project.prospectId)));
     if (!goals.length || !p.prospection?.entries.length)
         return undefined;
     const direct = goals.map((g) => temporalGoalValue(p, g, aff, now, now + Math.max(0, aff.duration)));
@@ -297,7 +305,12 @@ export function receivedGoalRoute(p, aff, now, maturityScale, costs) {
                 entry.confidence *
                 reliability(p, entry);
             const successor = successorOffer(entry);
-            const nextValues = goals.map((g, i) => Math.max(values[i] ?? 0, nextAccess * beta * temporalGoalValue(p, g, successor, now, end)));
+            const nextValues = goals.map((g, i) => {
+                const prospectId = g.project?.prospectId;
+                return prospectId && [...done, previous, successor].some((a) => diminishesProject(p, a, prospectId))
+                    ? 0
+                    : Math.max(values[i] ?? 0, nextAccess * beta * temporalGoalValue(p, g, successor, now, end));
+            });
             const nextCost = accumulatedCost + beta * nextAccess * Math.min(0, costs(successor));
             const cost = round(nextCost);
             const total = nextValues.reduce((sum, value) => sum + round(value * maturityScale), 0) + cost;

package/dist/review/review.d.ts

@@ -42,6 +42,9 @@ export declare function reviewIfDue(p: Person, now: Minute, recent: readonly Day
     distress: number;
 } | undefined;
 /** The person's own words for their latest review, or undefined when they hold no review. */
-export declare function reviewLine(p: Person): string | undefined;
+export declare function reviewLine(p: Person, options?: {
+    variety?: boolean;
+    cause?: 'ordered' | 'interrupted';
+}): string | undefined;
 /** Restore guard: drop malformed fields, keep valid resolves. */
 export declare function sanitizeReview(x: unknown, now?: Minute): ReviewState | undefined;

package/dist/review/review.js

@@ -31,6 +31,7 @@
  * fast-forward) should still live, or release, that day's occasions, or the review counts each one as missed.
  */
 import { clamp01, dexp, isObj, minuteOfDay, round } from '../core/index.js';
+import { pickLine } from '../narrate/lexicon.js';
 export const REVIEW_DEFAULTS = {
     /** Default evening review time, minute of day. */
     at: 21 * 60,
@@ -192,7 +193,7 @@ export function reviewIfDue(p, now, recent, closed) {
     return { record, distress };
 }
 /** The person's own words for their latest review, or undefined when they hold no review. */
-export function reviewLine(p) {
+export function reviewLine(p, options = {}) {
     const st = p.review;
     const r = st?.last;
     if (!st || st.style === 'none' || !r)
@@ -200,6 +201,16 @@ export function reviewLine(p) {
     const list = (xs) => xs.length <= 1 ? (xs[0] ?? '') : `${xs.slice(0, -1).join(', ')} and ${xs.at(-1)}`;
     if (r.missed.length === 0)
         return r.kept.length > 0 ? `Today I kept ${list(r.kept)}.` : undefined;
+    if (options.cause) {
+        const cause = options.cause === 'ordered' ? 'following an order' : 'being interrupted';
+        const next = options.cause === 'ordered'
+            ? 'Next time I will say what the order would put aside.'
+            : 'Next time I will make room to return to it.';
+        return pickLine('review.cause', `${p.id}:${r.day}`, { cause, missed: list(r.missed), next }, p.lexicon);
+    }
+    if (options.variety ?? p.lexicon?.variety) {
+        return pickLine(`review.${st.style}`, `${p.id}:${r.day}`, { missed: list(r.missed) }, p.lexicon);
+    }
     if (st.style === 'ruminating')
         return `I keep going back over ${list(r.missed)}.`;
     return `I didn't keep ${list(r.missed)}. Next time I'll be ready when it comes.`;

package/dist/types.d.ts

@@ -373,6 +373,8 @@ export interface Episode {
     /** 0..1 how memorable; decays and is boosted by recall. */
     salience: Unit;
     summary: string;
+    /** Host-authored summary spoken back to actorId (second person); never inferred from free text. */
+    addressedSummary?: string;
     tags: string[];
     /**
      * The outside voice whose suggestion led to this episode (set on outcomes of assented/complied activities and
@@ -896,7 +898,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.14.1";
+export declare const ENGINE_VERSION = "2.17.0";
 /** A pregnancy carried by this person (host-driven; see `family/`). */
 export interface Pregnancy {
     fatherId: PersonId;
@@ -1013,6 +1015,8 @@ export interface ReceivedConsequence {
         effort: Unit;
         focus?: Unit;
         materialCost?: number;
+        /** Prospect ids this successor reduces; read only with projects protectProgress. */
+        diminishes?: string[];
         /** Goal or prospect ids this successor contributes to (bounded to 8). */
         advances?: string[];
     };
@@ -1186,6 +1190,8 @@ export interface Affordance {
      * earliest-ending match, explicit or by action, as before.
      */
     fulfills?: string[];
+    /** Prospect ids this offer reduces; read only with projects protectProgress. */
+    diminishes?: string[];
     /** Goal ids this advances. */
     advances?: string[];
     /** Probability of harm and its severity, as advertised. */
@@ -1251,6 +1257,8 @@ export interface Percept {
         aboutId?: PersonId;
     };
     summary: string;
+    /** Host-authored summary spoken back to actorId (second person); never inferred from free text. */
+    addressedSummary?: string;
     /**
      * Host flag for `sim/` interrupts. true: this percept is near the person (the framework has no spatial model),
      * so a salient one forces re-decision even if it does not target them. false: never interrupts.
@@ -1759,6 +1767,12 @@ export interface VoiceConflict {
  * slots documented next to each key.
  */
 export interface Lexicon {
+    /** Include person identity and stable temperament in assent/deferral selection (no RNG draws). */
+    variety?: boolean;
+    /** What material gains mean here, e.g. 'food', 'household keep' or 'resources'; absent keeps legacy money lines. */
+    materialMeaning?: string;
+    /** Treat action labels as noun phrases unless explicit verb forms are supplied. */
+    nounActions?: boolean;
     /** Informational locale tag, e.g. 'en', 'tr'. */
     locale?: string;
     /** Display names by entity id: { ana: 'Ana', ben: 'Ben' }. */
@@ -1987,6 +2001,8 @@ export interface Prospect {
     progress?: Unit;
 }
 export interface ProjectsSpec {
+    /** Learn and respect declared reductions of a held project. Absent preserves existing choice. */
+    protectProgress?: boolean;
     forgetMinutes?: number;
     calmUrgency?: Unit;
     fearBelow?: Unit;
@@ -2008,6 +2024,24 @@ export interface ProjectsState {
     /** Absent retains 2.14.0 credit. Re-enabling, including on every load, opts into net credit. */
     behaviour?: 2;
     spec?: ProjectsSpec;
+    /** Exact contextual acts learned to reduce a prospect; oldest entries are evicted. */
+    setbacks?: {
+        prospectId: string;
+        action: string;
+        targetId?: EntityId;
+        placeId?: EntityId;
+    }[];
+    /** Last completed act and attended progress before it; consumed by the next matching perception. */
+    pendingAct?: {
+        action: string;
+        targetId?: EntityId;
+        placeId?: EntityId;
+        at: Minute;
+        readings: {
+            prospectId: string;
+            progress: Unit;
+        }[];
+    };
     prospects: (Prospect & {
         lastSeenAt: Minute;
     })[];

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.14.1';
+export const ENGINE_VERSION = '2.17.0';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adam0white/human-framework",
-  "version": "2.15.0",
+  "version": "2.17.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",