@adam0white/human-framework 2.2.0 → 2.2.1

package/README.md

@@ -177,13 +177,13 @@ reference host: `createVillage`.
 
 There are two version numbers, and they move independently.
 
-- **The release version** is the package version (`package.json`, now `2.2.0`) and `FRAMEWORK_VERSION`, the same
+- **The release version** is the package version (`package.json`, now `2.2.1`) and `FRAMEWORK_VERSION`, the same
   string compiled into the build; a test keeps them equal. It versions the public API under
   [semver](https://semver.org/): a breaking change to an exported name or signature bumps the major, a new
   faculty or export the minor, a fix the patch. Each release is a tag `vX.Y.Z` and a GitHub release whose notes
   are that version's section of the root [CHANGELOG.md](../../CHANGELOG.md), with the package tarball attached
   (`npm run release`, run on a clean, pushed `main`).
-- **`ENGINE_VERSION`** (exported; `2.1.0` at release 2.2.0) versions simulation behaviour and the save format. It
+- **`ENGINE_VERSION`** (exported; `2.2.0` at release 2.2.1) versions simulation behaviour and the save format. It
   changes when the same seed and inputs would give different decisions, or when person state changes shape.
   `restore` upgrades saves from engine 1.4.0 and later through `migrate` and refuses older ones. Every release's notes name the
   `ENGINE_VERSION` it ships, so a host can tell whether its saves still restore.
@@ -301,4 +301,4 @@ const evidence = methodEvidence(learner, 'send-north', 'new-parcel');
 clearMethodContext(learner); // when leaving or switching the task
 ```
 
-Import these functions from the package. Rules/evidence live in optional `Person.methods` and survive snapshots. Current cues expire after 120 minutes. A stable demonstration id avoids counting the same example twice within the retained 256-example history, even after its rule or evidence is evicted. Once an id has left both that history and retained rule evidence, it can be admitted again. Missing observations cannot satisfy a condition; conflicting examples reduce confidence. A successful lecture does not certify reliable execution. [The headless control](examples/method-control.ts) demonstrates changed teaching, withheld teaching, a scalar-skill control and acquired-state ablation with two methods and an exception.
+Import these functions from the package. Rules/evidence live in optional `Person.methods` and survive snapshots. Current cues expire after 120 minutes. A stable demonstration id avoids counting the same example twice within the retained 256-example history, even after its rule or evidence is evicted. Once an id has left both that history and retained rule evidence, it can be admitted again. Missing observations cannot satisfy a condition. Failed demonstrations reduce support for that action. Successful alternatives retain their own support; ordinary cognition weighs the supported offers alongside other motives. A successful lecture does not certify reliable execution. [The routing control](examples/method-control.ts) demonstrates changed teaching, withheld teaching, a scalar-skill control and acquired-state ablation with two methods and an exception. [The alternatives control](examples/method-alternatives-control.ts) demonstrates two independently successful procedures under the same observations, failed practice, hunger and exact restore.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /** Human Framework v1 public surface. */
-export declare const FRAMEWORK_VERSION = "2.2.0";
+export declare const FRAMEWORK_VERSION = "2.2.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 v1 public surface. */
-export const FRAMEWORK_VERSION = '2.2.0';
+export const FRAMEWORK_VERSION = '2.2.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/methods/methods.d.ts

@@ -27,7 +27,7 @@ export interface MethodDemonstration {
     attention?: number;
 }
 export interface MethodEvidence {
-    /** Net matching evidence for this action, -1..1; conflicts reduce it. */
+    /** Net matching evidence for this action, -1..1; its failures reduce it. */
     support: number;
     terms: Term[];
     matched: {

package/dist/methods/methods.js

@@ -4,8 +4,9 @@
  * Successful and unsuccessful demonstrations become person-owned evidence; the
  * same reader supplies host queries and ordinary cognition terms. Unknown cues
  * do not mean false. Context identity prevents one task's observations being used
- * for another task. Contradictory examples weaken support without choosing a
- * privileged correct answer. Attention, source trust and recency grade evidence.
+ * for another task. Failed examples weaken that action without choosing a hidden
+ * correct answer. Successful alternatives retain their own support. Attention,
+ * source trust and recency grade evidence.
  * These are explicit engineering choices, not fitted human learning parameters.
  * This module does not infer cues, invent actions, plan sequences, certify skill,
  * access host truth, compute religious worth, or guarantee that a person obeys.
@@ -155,15 +156,13 @@ export function methodEvidence(p, action, contextId) {
             result.matched.push({ id: rule.id, action: rule.action, sourceId, support });
         }
     }
-    // Comparable alternative actions reduce confidence; they never become a hidden answer override.
+    // A successful alternative is not evidence that this action failed. Each action
+    // retains its own signed support; ordinary cognition weighs all legal offers.
     const strengths = new Map();
     for (const match of result.matched)
         strengths.set(match.action, (strengths.get(match.action) ?? 0) + match.support);
     const own = strengths.get(action) ?? 0;
-    const rival = Math.max(0, ...[...strengths].filter(([a]) => a !== action).map(([, v]) => v));
-    const total = Math.max(1, ...[...strengths.values()].map((v) => Math.abs(v)));
-    const net = own > 0 ? Math.max(0, own - rival) : own;
-    result.support = Math.max(-1, Math.min(1, net / total));
+    result.support = own / Math.max(1, Math.abs(own));
     const scale = own === 0 ? 0 : result.support / own;
     for (const match of result.matched) {
         if (match.action !== action || match.support === 0)

package/dist/migrate.js

@@ -8,7 +8,7 @@
  * field of the optional surroundings slice (`ambient.now` → `ambient.percept`) and changes no behaviour (the optional `social.impressions` and `social.reserve`, like `retention`, are optional and start
  * absent in a migrated save); `restore` then fills and sanitizes
  * the slices as for any save. 2.0.0 to 2.1.0 adds optional conditional method state, absent
- * until explicitly used, so existing hosts retain their previous behavior; that step stamps the version. A migrated save continues under the current engine's rules: it restores and runs,
+ * until explicitly used, so existing hosts retain their previous behavior; that step stamps the version. 2.1.0 to 2.2.0 preserves optional method records and stamps the version; successful alternatives now retain independent support. 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
  * changed how standing advice is heard; 1.8.0 to 1.9.0 changed the omission rule). Saves older than 1.4.0 and unknown versions are refused with an error.
  *
@@ -58,6 +58,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.1.0': {
+        to: '2.2.0',
+        note: 'person shape unchanged; method evidence now grades each action independently, preserving successful alternatives',
+        apply: stamp,
+    },
     '2.0.0': {
         to: '2.1.0',
         note: 'conditional method state and received cues are optional and start absent; existing host decisions unchanged',

package/dist/types.d.ts

@@ -787,7 +787,11 @@ export interface Activity {
 }
 export declare const PERSON_SCHEMA = "human/person@1";
 /**
- * Current: 2.1.0 (2026-10-10): optional acquired conditional methods and explicit received cue contexts.
+ * Current: 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.
+ *
+ * 2.1.0 (2026-10-10): optional acquired conditional methods and explicit received cue contexts.
  * Normal cognition reads learned method evidence only on offers carrying the matching context.
  * Existing hosts with no method state keep their previous decisions; 2.0.0 saves migrate by stamping the version.
  *
@@ -818,7 +822,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.1.0";
+export declare const ENGINE_VERSION = "2.2.0";
 /** A pregnancy carried by this person (host-driven; see `family/`). */
 export interface Pregnancy {
     fatherId: PersonId;

package/dist/types.js

@@ -84,7 +84,11 @@ export const EMOTIONS = [
 // ---------------------------------------------------------------------------------------------
 export const PERSON_SCHEMA = 'human/person@1';
 /**
- * Current: 2.1.0 (2026-10-10): optional acquired conditional methods and explicit received cue contexts.
+ * Current: 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.
+ *
+ * 2.1.0 (2026-10-10): optional acquired conditional methods and explicit received cue contexts.
  * Normal cognition reads learned method evidence only on offers carrying the matching context.
  * Existing hosts with no method state keep their previous decisions; 2.0.0 saves migrate by stamping the version.
  *
@@ -115,4 +119,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.1.0';
+export const ENGINE_VERSION = '2.2.0';

package/package.json

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