@adam0white/human-framework 2.2.1 → 2.4.0

package/dist/types.d.ts

@@ -543,6 +543,10 @@ export interface Goal {
     status: 'active' | 'achieved' | 'abandoned';
     adoptedAt: Minute;
     deadline?: Minute;
+    /** Opt-in expected completion valuation; deadline remains urgency, never a cutoff. */
+    temporal?: {
+        halfLifeMinutes: number;
+    };
     /** Last minute the goal was advanced (or adopted); neglect is counted from here. */
     lastAdvancedAt?: Minute;
     /** Importance before neglect decay; `revisePurposes` recomputes `importance` from it. */
@@ -787,7 +791,8 @@ export interface Activity {
 }
 export declare const PERSON_SCHEMA = "human/person@1";
 /**
- * Current: 2.2.0 (2026-10-14): method evidence grades each action independently.
+ * Current: 2.3.0 (2026-10-17): optional temporal goals and received consequences.
+ * 2.2.0 (2026-10-14): method evidence grades each action independently.
  * Successful alternatives no longer count as failures of another action. Person state shape is unchanged.
  * 2.1.0 saves migrate by stamping the version.
  *
@@ -822,7 +827,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.2.0";
+export declare const ENGINE_VERSION = "2.4.0";
 /** A pregnancy carried by this person (host-driven; see `family/`). */
 export interface Pregnancy {
     fatherId: PersonId;
@@ -923,6 +928,49 @@ export interface MethodsState {
         cues: MethodCue[];
     };
 }
+/** Exact current-action identity; omitted target/place match only omitted values. */
+export interface ConsequenceAction {
+    action: string;
+    targetId?: EntityId;
+    placeId?: EntityId;
+}
+/** A received conditional opportunity, never another person's consent or an actual outcome. */
+export interface ReceivedConsequence {
+    id: string;
+    revision: number;
+    trigger: ConsequenceAction;
+    successor: ConsequenceAction & {
+        duration: number;
+        effort: Unit;
+        focus?: Unit;
+        materialCost?: number;
+    };
+    availableFrom: Minute;
+    /** Latest permitted successor completion, inclusive. */
+    availableUntil: Minute;
+    expiresAt: Minute;
+    /** P(access | trigger completes successfully), not consent. */
+    chance: Unit;
+    confidence: Unit;
+}
+export interface ConsequenceRevision {
+    sourceId: EntityId;
+    id: string;
+    revision: number;
+    receivedAt: Minute;
+}
+export interface RetainedConsequence extends ReceivedConsequence {
+    sourceId: EntityId;
+    channel: 'told';
+    receivedAt: Minute;
+    /** Own completed trigger; does not establish access or goal progress. */
+    triggeredAt?: Minute;
+}
+/** Optional person-owned received knowledge. Deduplication lasts only within bounded revision memory. */
+export interface ProspectionState {
+    entries: RetainedConsequence[];
+    revisions: ConsequenceRevision[];
+}
 export interface Person {
     schema: typeof PERSON_SCHEMA;
     /** Engine version that last wrote this state. */
@@ -942,6 +990,10 @@ export interface Person {
     skills: Record<string, Skill>;
     /** Acquired conditional method evidence and current received cues; absent until used. */
     methods?: MethodsState;
+    /** Received future consequences, absent until attended testimony supplies them. */
+    prospection?: ProspectionState;
+    /** Noticed promptings and practised turnings-away (2.4.0, opt-in via `enablePromptings`). Owned by `promptings/`. */
+    promptings?: PromptingsState;
     /** Practice consolidation (1.8.0, opt-in via `enableSkillRetention`). Owned by `skills/`. */
     skillRetention?: {
         consolidationHours: number;
@@ -1107,6 +1159,12 @@ export interface Percept {
         minutes: number;
         domain?: LearningDomain;
     };
+    /** At most four additions/withdrawals combined; attended external testimony to this person or a broadcast. */
+    consequences?: readonly ReceivedConsequence[];
+    withdrawConsequences?: readonly {
+        id: string;
+        revision: number;
+    }[];
 }
 /**
  * Domains with distinct age curves for learning rate (`lifecourse.learningMultiplier`). 'general' is
@@ -1239,7 +1297,8 @@ export interface SuggestionResolution {
 export interface Term {
     /** 'need:food', 'norm:salah', 'commitment:c3', 'commitment' (promise inertia of the running activity),
      *  'goal:g1', 'habit', 'emotion:fear:risky' (emotion id, then the tag it acts through), 'effort', 'risk',
-     *  'suggestion:player', 'social:p2', 'expectation', 'autonomy' (reactance to a pushing voice) */
+     *  'suggestion:player', 'social:p2', 'expectation', 'autonomy' (reactance to a pushing voice),
+     *  'promptings:turn' (a practised turning-away), 'promptings:echo' (recurrence under the `fault` reading) */
     source: string;
     value: number;
 }
@@ -1327,8 +1386,63 @@ export interface PersonSpec {
         yearbook?: boolean;
         character?: boolean;
         skillRetention?: boolean;
+        /** Promptings and turning away (2.4.0): the same as `enablePromptings(p, spec)` after creation. */
+        promptings?: PromptingsSpec;
     };
 }
+/**
+ * How a person understands their own unwanted inner pulls (a held reading, set by the host, with provenance).
+ * `whisper`, `inclination` and `intrusion` share mechanics and differ only in vocabulary; `fault` (the scrupulous
+ * reading) adds guilt at the prompt itself; `none` is neutral vocabulary. See research/reconciliation.md §5.
+ */
+export type PromptingReading = 'whisper' | 'inclination' | 'intrusion' | 'fault' | 'none';
+/** A practised turning-away: seeking refuge, redirecting attention, or simply leaving the thought. */
+export type PromptingResponseKind = 'refuge' | 'redirect' | 'leave';
+export interface PromptingResponse {
+    id: string;
+    kind: PromptingResponseKind;
+    /** Skill-like practice 0..1 as of `lastUsedAt`; it decays slowly with disuse. */
+    practice: Unit;
+    lastUsedAt: Minute;
+}
+export interface PromptingRecord {
+    at: Minute;
+    action: string;
+    affordanceId: string;
+    /** The strongest pull: 'habit', 'emotion:*', 'need:*', 'promptings:echo' or 'host' (a `temptation` tag). */
+    source: string;
+    /** The opposing term: 'norm:x' or 'goal:g'. */
+    opposedBy: string;
+    outcome: 'passed' | 'turned' | 'assented';
+    /** The response that was practised at this prompt, if any. */
+    responseId?: string;
+}
+export interface PromptingsState {
+    reading: PromptingReading;
+    /** Provenance of the reading (upbringing, a teacher, a book id), as for held norms. */
+    readingSource?: string;
+    responses: PromptingResponse[];
+    /** Recent prompts, oldest first, bounded (`PROMPTINGS_DEFAULTS.maxRecent`). */
+    recent: PromptingRecord[];
+    /** Recurrence per action under the `fault` reading (an off-by-default assumption; see `echoRate`). */
+    echo: Record<string, {
+        level: Unit;
+        at: Minute;
+    }>;
+    /** Echo gained per prompt under `fault`. Default 0: the recurrence term is a host-set assumption (P3 contested). */
+    echoRate: number;
+}
+/** What a host hands `enablePromptings`. */
+export interface PromptingsSpec {
+    reading?: PromptingReading;
+    readingSource?: string;
+    responses?: {
+        id: string;
+        kind: PromptingResponseKind;
+        practice?: Unit;
+    }[];
+    echoRate?: number;
+}
 /** What the body is doing over an interval. */
 export interface BodyLoad {
     effort: Unit;

package/dist/types.js

@@ -84,7 +84,8 @@ export const EMOTIONS = [
 // ---------------------------------------------------------------------------------------------
 export const PERSON_SCHEMA = 'human/person@1';
 /**
- * Current: 2.2.0 (2026-10-14): method evidence grades each action independently.
+ * Current: 2.3.0 (2026-10-17): optional temporal goals and received consequences.
+ * 2.2.0 (2026-10-14): method evidence grades each action independently.
  * Successful alternatives no longer count as failures of another action. Person state shape is unchanged.
  * 2.1.0 saves migrate by stamping the version.
  *
@@ -119,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.2.0';
+export const ENGINE_VERSION = '2.4.0';

package/package.json

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