@adam0white/human-framework 2.14.0 → 2.14.1

package/dist/agenda/agenda.js

@@ -47,7 +47,7 @@
  */
 // The bundled catalog is only the default; a host with its own catalog passes it (`World.catalog`).
 import { DEFAULT_NORMS } from '../conscience/catalog.js';
-import { clamp01, dayOf, dpow, hasNumbers, isObj } from '../core/index.js';
+import { clamp01, dayOf, dpow, hasNumbers, isNum, isObj } from '../core/index.js';
 import { expectedEffect } from '../memory/index.js';
 import { MINUTES_PER_DAY } from '../types.js';
 export const AGENDA_DEFAULTS = {
@@ -150,8 +150,11 @@ function sanitizeGoalTemporal(g) {
             typeof project.prospectId === 'string' &&
             project.prospectId.length > 0 &&
             project.prospectId.length <= 512 &&
-            typeof project.perceivedProgress === 'boolean')
+            typeof project.perceivedProgress === 'boolean') {
             g.project = { prospectId: project.prospectId, perceivedProgress: project.perceivedProgress };
+            if (isNum(project.peak) && project.peak >= 0 && project.peak <= 1)
+                g.project.peak = project.peak;
+        }
         else
             delete g.project;
     }
@@ -690,9 +693,12 @@ export function onFinished(p, outcome, startedAt = outcome.at, opts = {}) {
         const amount = own > 0 ? own : namesGoal(g, outcome.advances) ? AGENDA_DEFAULTS.defaultAdvanceAmount : 0;
         if (amount <= 0)
             continue;
-        // Credit the contribution for narration/reward, but only perception sets this project's progress.
+        // onFinished runs before the host shows the result: advanced counts a contribution made from
+        // at or above the high-water mark, not a confirmed new high. Only the next perception moves
+        // the progress clock, importance and pull; the composite does not consume advanced.
         if (g.project?.perceivedProgress) {
-            advanced.push(g);
+            if (g.project.peak === undefined || g.progress >= g.project.peak)
+                advanced.push(g);
             continue;
         }
         g.progress = clamp01(g.progress + amount);
@@ -730,7 +736,11 @@ export function perceiveProjectProgress(p, prospectId, progress, now) {
     for (const g of p.agenda.goals) {
         if (g.status !== 'active' || !g.project?.perceivedProgress || g.project.prospectId !== prospectId)
             continue;
-        if (progress > g.progress) {
+        if (p.projects?.behaviour === 2 && g.project.peak === undefined)
+            g.project.peak = g.progress;
+        if (progress > (g.project.peak ?? g.progress)) {
+            if (g.project.peak !== undefined)
+                g.project.peak = clamp01(progress);
             g.lastAdvancedAt = now;
             if (g.baseImportance !== undefined)
                 g.importance = g.baseImportance;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Human Framework public surface. */
-export declare const FRAMEWORK_VERSION = "2.14.0";
+export declare const FRAMEWORK_VERSION = "2.14.1";
 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.14.0';
+export const FRAMEWORK_VERSION = '2.14.1';
 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/migrate.js

@@ -18,7 +18,8 @@
  * 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. 2.13.0 to 2.14.0 stamps the version (projects and persistence start absent; goals may carry `project`, received successors may carry `advances`). 2.12.0 to 2.13.0 stamps the version (suggestion reasons and firm rules start absent). 2.11.0 to 2.12.0 stamps the version (planning starts absent). 2.10.0 to 2.11.0 stamps the version (curiosity starts absent). 2.9.0 to 2.10.0 stamps the version; belief provenance, noted contradictions and
+ * the earliest-ending one. 2.14.0 to 2.14.1 only stamps the version: slices without behaviour markers
+ * retain 2.14.0 crediting and an undecaying pull until the host re-enables them. 2.13.0 to 2.14.0 stamps the version (projects and persistence start absent; goals may carry `project`, received successors may carry `advances`). 2.12.0 to 2.13.0 stamps the version (suggestion reasons and firm rules start absent). 2.11.0 to 2.12.0 stamps the version (planning starts absent). 2.10.0 to 2.11.0 stamps the version (curiosity starts absent). 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
@@ -70,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.0': {
+        to: '2.14.1',
+        note: 'version stamp only; restored projects and persistence retain 2.14.0 behaviour until explicitly re-enabled',
+        apply: stamp,
+    },
     '2.13.0': {
         to: '2.14.0',
         note: 'projects (Person.projects) and persistence (Person.pursuit) are optional and start absent; Goal.project, Percept.prospect and received successor advances are optional; existing hosts retain exact behavior',

package/dist/persistence/persistence.d.ts

@@ -11,6 +11,7 @@ export declare const PERSISTENCE_DEFAULTS: {
     readonly slackMinutes: 20;
     readonly maxMinutes: 240;
     readonly restMinutes: 20;
+    readonly stallHalfLifeMinutes: 30;
 };
 /** Enable or reconfigure, retaining a current pursuit. Invalid overrides use defaults. */
 export declare function enablePersistence(p: Person, spec?: PersistenceSpec): PursuitState;

package/dist/persistence/persistence.js

@@ -4,15 +4,19 @@
  * unrelated options pay a switching cost (goal shielding: Shah, Friedman & Kruglanski 2002;
  * task switching: Monsell 2003). Unused activation expires (Altmann & Trafton 2002); short
  * interruptions allow resumption (Ovsiankina 1928). See research/projects-and-persistence.md.
- * Maximum-duration release rests that goal for one bounded interval before pursuit can form again.
+ * Maximum-duration release keeps one refractory entry, for the most recent release. With defaults
+ * (maxMinutes 240, restMinutes 20), two releases cannot fall within one interval; with a shorter
+ * maximum, a later release can replace an earlier unexpired interval.
  * These are shapes, not fitted values; all coefficients and time bounds are engineering defaults.
  * This is a bounded bias plus a switching cost, not a planner. It chooses no goals, executes no
  * plans, reorders no steps and changes no agenda valuation. It imports no projects, uses no RNG,
  * LLM or faith lens. Needs and fear gate both terms; commitment options never pay the switch cost.
+ * Behaviour 2 halves both terms with time since the pursued goal last advanced (or adoption),
+ * including after release and re-formation. Absent behaviour retains the 2.14.0 undecaying pull.
  * Without the slice, it adds no state or terms.
  */
 import { emotionLevel } from '../affect/index.js';
-import { clamp01, cmpStr, isNum, isObj, round } from '../core/index.js';
+import { clamp01, cmpStr, dpow, isNum, isObj, round } from '../core/index.js';
 import { MAX_MINUTE, PHYSIOLOGICAL_NEEDS } from '../types.js';
 /** Engineering defaults, relative to cognition's need scale 4, pleasure .6 and curiosity .8/.15.
  * Continuation and switching together outweigh mild relaxed distraction; urgency and fear gate both.
@@ -26,6 +30,7 @@ export const PERSISTENCE_DEFAULTS = {
     slackMinutes: 20,
     maxMinutes: 240,
     restMinutes: 20,
+    stallHalfLifeMinutes: 30,
 };
 const KEYS = [
     'continueScale',
@@ -35,6 +40,7 @@ const KEYS = [
     'slackMinutes',
     'maxMinutes',
     'restMinutes',
+    'stallHalfLifeMinutes',
 ];
 function cleanSpec(input) {
     const out = {};
@@ -42,8 +48,12 @@ function cleanSpec(input) {
         return out;
     for (const key of KEYS) {
         const x = input[key];
-        const max = key === 'slackMinutes' || key === 'maxMinutes' || key === 'restMinutes' ? 1440 : 1;
-        if (isNum(x) && x >= 0 && x <= max)
+        const duration = key === 'slackMinutes' ||
+            key === 'maxMinutes' ||
+            key === 'restMinutes' ||
+            key === 'stallHalfLifeMinutes';
+        const min = key === 'stallHalfLifeMinutes' ? 1 : 0;
+        if (isNum(x) && x >= min && x <= (duration ? 1440 : 1))
             out[key] = x;
     }
     return out;
@@ -53,7 +63,7 @@ const identifier = (x) => typeof x === 'string' && x.length > 0 && x.length <= 5
 const active = (p, id) => p.agenda.goals.find((g) => g.id === id && g.status === 'active');
 /** Enable or reconfigure, retaining a current pursuit. Invalid overrides use defaults. */
 export function enablePersistence(p, spec = {}) {
-    const out = {};
+    const out = { behaviour: 2 };
     const clean = cleanSpec(spec);
     if (Object.keys(clean).length)
         out.spec = clean;
@@ -126,8 +136,13 @@ export function beginPursuit(p, terms) {
 export function persistenceTerms(p, terms, ctx) {
     const s = p.pursuit;
     const c = s?.current;
-    if (!s || !c || !active(p, c.goalId))
+    if (!s || !c)
+        return [];
+    const goal = active(p, c.goalId);
+    if (!goal)
         return [];
+    const stall = Math.max(0, p.now - (goal.lastAdvancedAt ?? goal.adoptedAt));
+    const decay = s.behaviour === 2 ? dpow(0.5, stall / setting(s, 'stallHalfLifeMinutes')) : 1;
     let urgency = 0;
     for (const n of ctx.needs)
         if (n.id === 'safety' || PHYSIOLOGICAL_NEEDS.includes(n.id))
@@ -137,7 +152,7 @@ export function persistenceTerms(p, terms, ctx) {
         return [
             {
                 source: `pursuit:${c.goalId}`,
-                value: round(Math.min(setting(s, 'cap'), setting(s, 'continueScale') * c.strength * gate)),
+                value: round(Math.min(setting(s, 'cap'), setting(s, 'continueScale') * c.strength * gate) * decay),
             },
         ];
     if (terms.some((t) => t.source.startsWith('commitment:')))
@@ -145,7 +160,7 @@ export function persistenceTerms(p, terms, ctx) {
     return [
         {
             source: 'pursuit:switch',
-            value: -round(Math.min(setting(s, 'cap'), setting(s, 'switchScale') * c.strength * gate)),
+            value: -round(Math.min(setting(s, 'cap'), setting(s, 'switchScale') * c.strength * gate) * decay),
         },
     ];
 }
@@ -154,7 +169,11 @@ const minute = (x, now) => isNum(x) && Math.abs(x) <= MAX_MINUTE && x <= now;
 export function sanitizePursuit(input, now) {
     if (!isObj(input) || (input.spec !== undefined && !isObj(input.spec)))
         return undefined;
+    if (input.behaviour !== undefined && input.behaviour !== 2)
+        return undefined;
     const out = {};
+    if (input.behaviour === 2)
+        out.behaviour = 2;
     if (input.spec !== undefined) {
         const spec = cleanSpec(input.spec);
         if (Object.keys(spec).length !== Object.keys(input.spec).length)

package/dist/projects/projects.js

@@ -7,6 +7,7 @@
  * models a pull to continue, not a Zeigarnik memory advantage. See research/projects-and-persistence.md.
  * All thresholds and coefficients are engineering defaults. This owns only p.projects; agenda owns
  * goals. All kinds serve competence and leisure: making is chosen as a free-time pursuit, not duty.
+ * Behaviour 2 credits only new perceived highs; event-credited projects cannot observe reversals and stay unchanged.
  * Restore recovers one active project, keeping the newest (id breaks ties) and abandoning extras.
  * No invented prospects, host task interpretation, world search, persistence, shielding, faith lens,
  * LLM or RNG. Without the slice, perception and minute bookkeeping write nothing.
@@ -70,7 +71,7 @@ function cleanProspect(x) {
         p.placeId = x.placeId;
     if (x.progress !== undefined)
         p.progress = x.progress;
-    // A long list is kept, not rejected: the first eight distinct ids in the host's order (island rerun, 2026-10-20).
+    // A long list is kept, not rejected: the first eight distinct ids in the host's order (host rerun, 2026-10-20).
     if (x.materialIds !== undefined)
         p.materialIds = [...new Set(x.materialIds)].slice(0, 8);
     return p;
@@ -78,6 +79,10 @@ function cleanProspect(x) {
 /** Enable or reconfigure without discarding retained prospects and history. */
 export function enableProjects(p, spec = {}) {
     const state = p.projects ?? { prospects: [], history: [] };
+    for (const g of p.agenda.goals)
+        if (g.status === 'active' && g.project?.perceivedProgress && g.project.peak === undefined)
+            g.project.peak = g.progress;
+    state.behaviour = 2;
     const clean = cleanSpec(spec);
     delete state.spec;
     if (Object.keys(clean).length)
@@ -228,6 +233,8 @@ export function considerProjects(p, now) {
     }, now);
     if (prospect.progress !== undefined)
         perceiveProjectProgress(p, prospect.id, prospect.progress, now);
+    if (s.behaviour === 2 && g.project)
+        g.project.peak = g.progress;
     s.lastAdoptedAt = now;
     s.currentGoalId = g.id;
 }
@@ -235,7 +242,11 @@ export function considerProjects(p, now) {
 export function sanitizeProjects(input, now) {
     if (!isObj(input) || !Array.isArray(input.prospects) || !Array.isArray(input.history))
         return undefined;
+    if (input.behaviour !== undefined && input.behaviour !== 2)
+        return undefined;
     const out = { prospects: [], history: [] };
+    if (input.behaviour === 2)
+        out.behaviour = 2;
     if (input.spec !== undefined) {
         if (!isObj(input.spec))
             return undefined;

package/dist/types.d.ts

@@ -592,6 +592,8 @@ export interface Goal {
     project?: {
         prospectId: string;
         perceivedProgress: boolean;
+        /** Highest perceived progress since adoption; presence opts this goal into net credit. */
+        peak?: Unit;
     };
     id: string;
     label: string;
@@ -894,7 +896,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.0";
+export declare const ENGINE_VERSION = "2.14.1";
 /** A pregnancy carried by this person (host-driven; see `family/`). */
 export interface Pregnancy {
     fatherId: PersonId;
@@ -2003,6 +2005,8 @@ export interface ProjectHistory {
 }
 /** Optional bounded JSON state owned by projects/. */
 export interface ProjectsState {
+    /** Absent retains 2.14.0 credit. Re-enabling, including on every load, opts into net credit. */
+    behaviour?: 2;
     spec?: ProjectsSpec;
     prospects: (Prospect & {
         lastSeenAt: Minute;
@@ -2015,6 +2019,8 @@ export interface ProjectsState {
 }
 /** Bounded engineering overrides for persistence/. Invalid overrides use defaults. */
 export interface PersistenceSpec {
+    /** Half-life without goal progress, in minutes (default 30; valid 1..1440). */
+    stallHalfLifeMinutes?: number;
     continueScale?: number;
     switchScale?: number;
     cap?: number;
@@ -2033,9 +2039,13 @@ export interface Pursuit {
 }
 /** Optional JSON state owned by persistence/: one current pursuit and one refractory goal. */
 export interface PursuitState {
+    /** Absent retains the 2.14.0 pull. Re-enabling, including on every load, opts into decay. */
+    behaviour?: 2;
     spec?: PersistenceSpec;
     current?: Pursuit;
-    /** One goal withheld from pursuit formation until this minute; agenda terms remain unchanged. */
+    /** Most recent maximum-duration release, withheld until this minute; agenda terms stay unchanged.
+     * Defaults (maxMinutes 240, restMinutes 20) prevent two releases within one interval.
+     * A shorter maximum can let a later release replace an earlier unexpired interval. */
     rested?: {
         goalId: string;
         until: 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.0';
+export const ENGINE_VERSION = '2.14.1';

package/package.json

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