@ai-rpg-engine/modules 1.0.0

package/dist/environment-core.test.js

@@ -0,0 +1,252 @@
+import { describe, it, expect } from 'vitest';
+import { createTestEngine } from '@ai-rpg-engine/core';
+import { createEnvironmentCore, getZoneProperty, setZoneProperty, modifyZoneProperty, getHazardLog, processEnvironmentDecays, } from './environment-core.js';
+import { traversalCore } from './traversal-core.js';
+import { combatCore } from './combat-core.js';
+const makePlayer = (zoneId) => ({
+    id: 'player',
+    blueprintId: 'player',
+    type: 'player',
+    name: 'Hero',
+    tags: ['player'],
+    stats: { vigor: 5, instinct: 5 },
+    resources: { hp: 20, stamina: 5 },
+    statuses: [],
+    zoneId,
+});
+const makeEnemy = (id, zoneId) => ({
+    id,
+    blueprintId: id,
+    type: 'enemy',
+    name: id,
+    tags: ['enemy'],
+    stats: { vigor: 3, instinct: 3 },
+    resources: { hp: 5, stamina: 3 },
+    statuses: [],
+    zoneId,
+});
+describe('Zone property access', () => {
+    it('reads base zone property', () => {
+        const engine = createTestEngine({
+            modules: [createEnvironmentCore()],
+            entities: [makePlayer('a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: [], light: 7 }],
+        });
+        expect(getZoneProperty(engine.world, 'a', 'light')).toBe(7);
+        expect(getZoneProperty(engine.world, 'a', 'noise')).toBe(0); // Default
+    });
+    it('sets and reads dynamic zone property', () => {
+        const engine = createTestEngine({
+            modules: [createEnvironmentCore()],
+            entities: [makePlayer('a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: [], light: 5 }],
+        });
+        setZoneProperty(engine.world, 'a', 'noise', 10);
+        expect(getZoneProperty(engine.world, 'a', 'noise')).toBe(10);
+    });
+    it('modifies zone property by delta', () => {
+        const engine = createTestEngine({
+            modules: [createEnvironmentCore()],
+            entities: [makePlayer('a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: [], light: 5 }],
+        });
+        setZoneProperty(engine.world, 'a', 'noise', 3);
+        modifyZoneProperty(engine.world, 'a', 'noise', 5);
+        expect(getZoneProperty(engine.world, 'a', 'noise')).toBe(8);
+    });
+});
+describe('Combat raises noise (built-in rule)', () => {
+    it('combat hit increases zone noise', () => {
+        const engine = createTestEngine({
+            modules: [traversalCore, combatCore, createEnvironmentCore()],
+            entities: [makePlayer('a'), makeEnemy('rat', 'a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: [] }],
+        });
+        engine.submitAction('attack', { targetIds: ['rat'] });
+        // Combat should have raised noise (hit=3, miss=2)
+        const noise = getZoneProperty(engine.world, 'a', 'noise');
+        expect(noise).toBeGreaterThan(0);
+    });
+    it('zone entry adds minor noise', () => {
+        const engine = createTestEngine({
+            modules: [traversalCore, createEnvironmentCore()],
+            entities: [makePlayer('a')],
+            zones: [
+                { id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: ['b'] },
+                { id: 'b', roomId: 'test', name: 'B', tags: [], neighbors: ['a'] },
+            ],
+        });
+        engine.submitAction('move', { targetIds: ['b'] });
+        const noise = getZoneProperty(engine.world, 'b', 'noise');
+        expect(noise).toBeGreaterThan(0);
+    });
+});
+describe('Noise decay', () => {
+    it('noise decays toward baseline over time', () => {
+        const engine = createTestEngine({
+            modules: [traversalCore, combatCore, createEnvironmentCore()],
+            entities: [makePlayer('a'), makeEnemy('rat', 'a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: ['b'] },
+                { id: 'b', roomId: 'test', name: 'B', tags: [], neighbors: ['a'] }],
+        });
+        engine.submitAction('attack', { targetIds: ['rat'] });
+        const noiseAfterCombat = getZoneProperty(engine.world, 'a', 'noise');
+        expect(noiseAfterCombat).toBeGreaterThan(0);
+        // Explicitly process decays (in a game loop, this happens via environment-tick)
+        processEnvironmentDecays(engine.world);
+        const noiseAfterDecay = getZoneProperty(engine.world, 'a', 'noise');
+        expect(noiseAfterDecay).toBeLessThan(noiseAfterCombat);
+    });
+});
+describe('Custom environment rules', () => {
+    it('custom rule modifies zone property on event', () => {
+        const engine = createTestEngine({
+            modules: [
+                traversalCore,
+                createEnvironmentCore({
+                    rules: [{
+                            id: 'torch-light',
+                            eventPattern: 'world.zone.entered',
+                            property: 'light',
+                            delta: 2, // Player brings light
+                        }],
+                }),
+            ],
+            entities: [makePlayer('a')],
+            zones: [
+                { id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: ['b'] },
+                { id: 'b', roomId: 'test', name: 'B', tags: [], neighbors: ['a'], light: 3 },
+            ],
+        });
+        engine.submitAction('move', { targetIds: ['b'] });
+        // Light in zone B should have increased by custom rule + base
+        const light = getZoneProperty(engine.world, 'b', 'light');
+        expect(light).toBe(5); // 3 base + 2 from torch rule
+    });
+    it('dynamic delta function uses event context', () => {
+        const engine = createTestEngine({
+            modules: [
+                traversalCore,
+                combatCore,
+                createEnvironmentCore({
+                    rules: [{
+                            id: 'blood-stain',
+                            eventPattern: 'combat.contact.hit',
+                            property: 'stability',
+                            delta: (event) => -(event.payload.damage ?? 1),
+                        }],
+                }),
+            ],
+            entities: [makePlayer('a'), makeEnemy('rat', 'a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: [], stability: 10 }],
+        });
+        engine.submitAction('attack', { targetIds: ['rat'] });
+        const stability = getZoneProperty(engine.world, 'a', 'stability');
+        // Stability should have decreased based on damage dealt
+        expect(stability).toBeLessThanOrEqual(10);
+    });
+});
+describe('Hazards', () => {
+    it('hazard activates when condition is met', () => {
+        let hazardTriggered = false;
+        let affectedEntity = '';
+        const engine = createTestEngine({
+            modules: [
+                traversalCore,
+                createEnvironmentCore({
+                    hazards: [{
+                            id: 'exposed-wiring',
+                            triggerOn: 'world.zone.entered',
+                            condition: (zone) => zone.hazards?.includes('exposed wiring') ?? false,
+                            effect: (zone, entity, world, tick) => {
+                                hazardTriggered = true;
+                                affectedEntity = entity.id;
+                                // Deal 2 damage
+                                entity.resources.hp = Math.max(0, (entity.resources.hp ?? 0) - 2);
+                                return [{
+                                        id: `hazard-${tick}`,
+                                        tick,
+                                        type: 'environment.hazard.triggered',
+                                        actorId: entity.id,
+                                        payload: {
+                                            hazardId: 'exposed-wiring',
+                                            zoneId: zone.id,
+                                            damage: 2,
+                                        },
+                                    }];
+                            },
+                        }],
+                }),
+            ],
+            entities: [makePlayer('a')],
+            zones: [
+                { id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: ['b'] },
+                { id: 'b', roomId: 'test', name: 'B', tags: ['hazardous'], neighbors: ['a'], hazards: ['exposed wiring'] },
+            ],
+        });
+        const hpBefore = engine.player().resources.hp;
+        engine.submitAction('move', { targetIds: ['b'] });
+        expect(hazardTriggered).toBe(true);
+        expect(affectedEntity).toBe('player');
+        expect(engine.player().resources.hp).toBe(hpBefore - 2);
+    });
+    it('hazard log tracks activations', () => {
+        const engine = createTestEngine({
+            modules: [
+                traversalCore,
+                createEnvironmentCore({
+                    hazards: [{
+                            id: 'ice-floor',
+                            triggerOn: 'world.zone.entered',
+                            condition: (zone) => zone.tags.includes('icy'),
+                            effect: (_zone, _entity, _world, tick) => [],
+                        }],
+                }),
+            ],
+            entities: [makePlayer('a')],
+            zones: [
+                { id: 'a', roomId: 'test', name: 'A', tags: [], neighbors: ['b'] },
+                { id: 'b', roomId: 'test', name: 'B', tags: ['icy'], neighbors: ['a'] },
+            ],
+        });
+        engine.submitAction('move', { targetIds: ['b'] });
+        const log = getHazardLog(engine.world, 'b');
+        expect(log.length).toBeGreaterThan(0);
+        expect(log[0].hazardId).toBe('ice-floor');
+        expect(log[0].entityId).toBe('player');
+    });
+});
+describe('Zone tick effects', () => {
+    it('tick effect applies to qualifying zones', () => {
+        const regenEvents = [];
+        const engine = createTestEngine({
+            modules: [
+                createEnvironmentCore({
+                    tickEffects: [{
+                            id: 'healing-spring',
+                            condition: (zone) => zone.tags.includes('healing'),
+                            apply: (zone, world, tick) => {
+                                // Heal all entities in zone
+                                for (const entity of Object.values(world.entities)) {
+                                    if (entity.zoneId === zone.id) {
+                                        entity.resources.hp = Math.min(20, (entity.resources.hp ?? 0) + 1);
+                                        regenEvents.push(entity.id);
+                                    }
+                                }
+                                return [];
+                            },
+                        }],
+                }),
+            ],
+            entities: [makePlayer('a')],
+            zones: [{ id: 'a', roomId: 'test', name: 'A', tags: ['healing'], neighbors: [] }],
+        });
+        // Manually lower HP
+        engine.player().resources.hp = 15;
+        // Trigger environment tick
+        engine.submitAction('environment-tick', {});
+        expect(engine.player().resources.hp).toBe(16);
+        expect(regenEvents).toContain('player');
+    });
+});
+//# sourceMappingURL=environment-core.test.js.map

package/dist/environment-core.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-core.test.js","sourceRoot":"","sources":["../src/environment-core.test.ts"],"names":[],"mappings":"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"}

package/dist/faction-cognition.d.ts

@@ -0,0 +1,39 @@
+import type { EngineModule, WorldState, ScalarValue } from '@ai-rpg-engine/core';
+export type FactionBelief = {
+    subject: string;
+    key: string;
+    value: ScalarValue;
+    confidence: number;
+    sourceEntities: string[];
+    lastUpdateTick: number;
+    distortion: number;
+};
+export type FactionCognitionState = {
+    beliefs: FactionBelief[];
+    alertLevel: number;
+    cohesion: number;
+};
+export type FactionMembership = {
+    factionId: string;
+    entityIds: string[];
+    cohesion?: number;
+};
+export type FactionCognitionConfig = {
+    factions: FactionMembership[];
+};
+export declare function createFactionCognition(config: FactionCognitionConfig): EngineModule;
+/** Get cognition state for a faction */
+export declare function getFactionCognition(world: WorldState, factionId: string): FactionCognitionState;
+/** Get the faction an entity belongs to */
+export declare function getEntityFaction(world: WorldState, entityId: string): string | undefined;
+/** Get all entity IDs in a faction */
+export declare function getFactionMembers(world: WorldState, factionId: string): string[];
+/** Set or update a faction belief */
+export declare function setFactionBelief(factionState: FactionCognitionState, subject: string, key: string, value: ScalarValue, confidence: number, sourceEntityId: string, tick: number, distortion?: number): void;
+/** Get a specific faction belief */
+export declare function getFactionBelief(factionState: FactionCognitionState, subject: string, key: string): FactionBelief | undefined;
+/** Check if a faction believes something */
+export declare function factionBelieves(factionState: FactionCognitionState, subject: string, key: string, value?: ScalarValue): boolean;
+/** Get all beliefs about a subject */
+export declare function getFactionBeliefsAbout(factionState: FactionCognitionState, subject: string): FactionBelief[];
+//# sourceMappingURL=faction-cognition.d.ts.map

package/dist/faction-cognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-cognition.d.ts","sourceRoot":"","sources":["../src/faction-cognition.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAI7B,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B,CAAC;AAUF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,YAAY,CAyCnF;AAYD,wCAAwC;AACxC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,qBAAqB,CAU/F;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAExF;AAED,sCAAsC;AACtC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAEhF;AAID,qCAAqC;AACrC,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAU,GACrB,IAAI,CA8BN;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,aAAa,GAAG,SAAS,CAE3B;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAC7B,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,WAAW,GAClB,OAAO,CAKT;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,qBAAqB,EACnC,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAEjB"}

package/dist/faction-cognition.js

@@ -0,0 +1,139 @@
+// faction-cognition — faction-level shared belief graphs
+// Factions aggregate beliefs from members, producing collective awareness.
+// Entity beliefs propagate to factions via rumor events with delay and distortion.
+// --- Module ---
+export function createFactionCognition(config) {
+    const membershipMap = {};
+    const factionMembersMap = {};
+    const initialCognition = {};
+    for (const faction of config.factions) {
+        factionMembersMap[faction.factionId] = [...faction.entityIds];
+        initialCognition[faction.factionId] = {
+            beliefs: [],
+            alertLevel: 0,
+            cohesion: faction.cohesion ?? 0.8,
+        };
+        for (const entityId of faction.entityIds) {
+            membershipMap[entityId] = faction.factionId;
+        }
+    }
+    return {
+        id: 'faction-cognition',
+        version: '0.1.0',
+        dependsOn: ['cognition-core'],
+        register(ctx) {
+            ctx.persistence.registerNamespace('faction-cognition', {
+                factionCognition: initialCognition,
+                membership: membershipMap,
+                factionMembers: factionMembersMap,
+            });
+            // Handle rumor propagation events → update faction beliefs
+            ctx.events.on('rumor.belief.propagated', (event, world) => {
+                handleRumorArrival(event, world);
+            });
+            // Register faction-tick verb for alert level decay
+            ctx.actions.registerVerb('faction-tick', (_action, world) => {
+                processFactionTick(world);
+                return [];
+            });
+        },
+    };
+}
+// --- State Access ---
+function getModuleState(world) {
+    return (world.modules['faction-cognition'] ?? {
+        factionCognition: {},
+        membership: {},
+        factionMembers: {},
+    });
+}
+/** Get cognition state for a faction */
+export function getFactionCognition(world, factionId) {
+    const state = getModuleState(world);
+    if (!state.factionCognition[factionId]) {
+        state.factionCognition[factionId] = {
+            beliefs: [],
+            alertLevel: 0,
+            cohesion: 0.8,
+        };
+    }
+    return state.factionCognition[factionId];
+}
+/** Get the faction an entity belongs to */
+export function getEntityFaction(world, entityId) {
+    return getModuleState(world).membership[entityId];
+}
+/** Get all entity IDs in a faction */
+export function getFactionMembers(world, factionId) {
+    return getModuleState(world).factionMembers[factionId] ?? [];
+}
+// --- Faction Belief Operations ---
+/** Set or update a faction belief */
+export function setFactionBelief(factionState, subject, key, value, confidence, sourceEntityId, tick, distortion = 0) {
+    const existing = factionState.beliefs.find((b) => b.subject === subject && b.key === key);
+    if (existing) {
+        // Update if higher confidence or significantly newer
+        if (confidence >= existing.confidence || tick > existing.lastUpdateTick + 5) {
+            existing.value = value;
+            existing.confidence = Math.min(1, confidence);
+            existing.lastUpdateTick = tick;
+            existing.distortion = Math.min(existing.distortion, distortion);
+        }
+        // Track corroborating sources
+        if (!existing.sourceEntities.includes(sourceEntityId)) {
+            existing.sourceEntities.push(sourceEntityId);
+            // Multiple corroborating sources boost confidence
+            existing.confidence = Math.min(1, existing.confidence + 0.05);
+        }
+    }
+    else {
+        factionState.beliefs.push({
+            subject,
+            key,
+            value,
+            confidence,
+            sourceEntities: [sourceEntityId],
+            lastUpdateTick: tick,
+            distortion,
+        });
+    }
+}
+/** Get a specific faction belief */
+export function getFactionBelief(factionState, subject, key) {
+    return factionState.beliefs.find((b) => b.subject === subject && b.key === key);
+}
+/** Check if a faction believes something */
+export function factionBelieves(factionState, subject, key, value) {
+    const belief = getFactionBelief(factionState, subject, key);
+    if (!belief)
+        return false;
+    if (value !== undefined)
+        return belief.value === value;
+    return true;
+}
+/** Get all beliefs about a subject */
+export function getFactionBeliefsAbout(factionState, subject) {
+    return factionState.beliefs.filter((b) => b.subject === subject);
+}
+// --- Internal ---
+function handleRumorArrival(event, world) {
+    const { factionId, subject, key, value, confidence, sourceEntityId, distortion, } = event.payload;
+    const factionCog = getFactionCognition(world, factionId);
+    // Scale confidence by faction cohesion
+    const effectiveConfidence = confidence * factionCog.cohesion;
+    setFactionBelief(factionCog, subject, key, value, effectiveConfidence, sourceEntityId, event.tick, distortion);
+    // Hostile beliefs raise faction alert level
+    if (key === 'hostile' && value === true) {
+        factionCog.alertLevel = Math.min(100, factionCog.alertLevel + Math.round(20 * effectiveConfidence));
+    }
+}
+function processFactionTick(world) {
+    const state = getModuleState(world);
+    for (const factionCog of Object.values(state.factionCognition)) {
+        // Alert level decays slowly
+        if (factionCog.alertLevel > 0) {
+            factionCog.alertLevel = Math.max(0, factionCog.alertLevel - 2);
+        }
+    }
+}
+//# sourceMappingURL=faction-cognition.js.map

package/dist/faction-cognition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-cognition.js","sourceRoot":"","sources":["../src/faction-cognition.ts"],"names":[],"mappings":"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"}

package/dist/faction-cognition.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=faction-cognition.test.d.ts.map

package/dist/faction-cognition.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"faction-cognition.test.d.ts","sourceRoot":"","sources":["../src/faction-cognition.test.ts"],"names":[],"mappings":""}

package/dist/faction-cognition.test.js

@@ -0,0 +1,166 @@
+import { describe, test, expect } from 'vitest';
+import { createTestEngine } from '@ai-rpg-engine/core';
+import { createCognitionCore } from './cognition-core.js';
+import { createPerceptionFilter } from './perception-filter.js';
+import { createEnvironmentCore } from './environment-core.js';
+import { createFactionCognition, getFactionCognition, getEntityFaction, getFactionMembers, setFactionBelief, getFactionBelief, factionBelieves, getFactionBeliefsAbout, } from './faction-cognition.js';
+function makeGuard(id, zone) {
+    return {
+        id,
+        blueprintId: id,
+        type: 'npc',
+        name: `Guard ${id}`,
+        tags: ['enemy'],
+        stats: { vigor: 5, instinct: 6, will: 4 },
+        resources: { hp: 20, stamina: 10 },
+        statuses: [],
+        zoneId: zone,
+        ai: { profileId: 'aggressive', goals: ['guard'], fears: [], alertLevel: 0, knowledge: {} },
+    };
+}
+const player = {
+    id: 'player',
+    blueprintId: 'player',
+    type: 'player',
+    name: 'Hero',
+    tags: ['player'],
+    stats: { vigor: 7, instinct: 5, will: 5 },
+    resources: { hp: 30, stamina: 15 },
+    statuses: [],
+    zoneId: 'courtyard',
+};
+const zones = [
+    { id: 'courtyard', roomId: 'castle', name: 'Courtyard', tags: [], neighbors: ['gatehouse', 'hall'] },
+    { id: 'gatehouse', roomId: 'castle', name: 'Gatehouse', tags: [], neighbors: ['courtyard'] },
+    { id: 'hall', roomId: 'castle', name: 'Great Hall', tags: [], neighbors: ['courtyard'] },
+];
+describe('faction-cognition', () => {
+    function createEngine() {
+        return createTestEngine({
+            modules: [
+                createCognitionCore(),
+                createPerceptionFilter(),
+                createEnvironmentCore(),
+                createFactionCognition({
+                    factions: [
+                        { factionId: 'castle-guard', entityIds: ['guard_1', 'guard_2'], cohesion: 0.9 },
+                    ],
+                }),
+            ],
+            entities: [player, makeGuard('guard_1', 'courtyard'), makeGuard('guard_2', 'gatehouse')],
+            zones,
+            playerId: 'player',
+            startZone: 'courtyard',
+        });
+    }
+    test('initializes faction cognition state', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        expect(factionCog).toBeDefined();
+        expect(factionCog.beliefs).toEqual([]);
+        expect(factionCog.alertLevel).toBe(0);
+        expect(factionCog.cohesion).toBe(0.9);
+    });
+    test('tracks entity-faction membership', () => {
+        const engine = createEngine();
+        expect(getEntityFaction(engine.world, 'guard_1')).toBe('castle-guard');
+        expect(getEntityFaction(engine.world, 'guard_2')).toBe('castle-guard');
+        expect(getEntityFaction(engine.world, 'player')).toBeUndefined();
+    });
+    test('returns faction members', () => {
+        const engine = createEngine();
+        const members = getFactionMembers(engine.world, 'castle-guard');
+        expect(members).toContain('guard_1');
+        expect(members).toContain('guard_2');
+        expect(members).toHaveLength(2);
+    });
+    test('sets and queries faction beliefs', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        setFactionBelief(factionCog, 'player', 'hostile', true, 0.7, 'guard_1', 5);
+        expect(factionBelieves(factionCog, 'player', 'hostile', true)).toBe(true);
+        const belief = getFactionBelief(factionCog, 'player', 'hostile');
+        expect(belief?.confidence).toBe(0.7);
+        expect(belief?.sourceEntities).toEqual(['guard_1']);
+    });
+    test('corroborating sources boost confidence', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        setFactionBelief(factionCog, 'player', 'hostile', true, 0.6, 'guard_1', 5);
+        setFactionBelief(factionCog, 'player', 'hostile', true, 0.5, 'guard_2', 6);
+        const belief = getFactionBelief(factionCog, 'player', 'hostile');
+        expect(belief?.sourceEntities).toContain('guard_1');
+        expect(belief?.sourceEntities).toContain('guard_2');
+        // Corroboration should boost confidence
+        expect(belief.confidence).toBeGreaterThan(0.6);
+    });
+    test('higher confidence updates override lower', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        setFactionBelief(factionCog, 'player', 'location', 'courtyard', 0.5, 'guard_1', 5);
+        setFactionBelief(factionCog, 'player', 'location', 'hall', 0.8, 'guard_2', 6);
+        const belief = getFactionBelief(factionCog, 'player', 'location');
+        expect(belief?.value).toBe('hall');
+        expect(belief?.confidence).toBeGreaterThanOrEqual(0.8);
+    });
+    test('getFactionBeliefsAbout returns all beliefs about a subject', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        setFactionBelief(factionCog, 'player', 'hostile', true, 0.7, 'guard_1', 5);
+        setFactionBelief(factionCog, 'player', 'location', 'courtyard', 0.6, 'guard_1', 5);
+        const beliefs = getFactionBeliefsAbout(factionCog, 'player');
+        expect(beliefs).toHaveLength(2);
+    });
+    test('rumor.belief.propagated event updates faction beliefs', () => {
+        const engine = createEngine();
+        engine.drainEvents();
+        // Simulate a rumor event arriving
+        engine.store.emitEvent('rumor.belief.propagated', {
+            factionId: 'castle-guard',
+            subject: 'player',
+            key: 'hostile',
+            value: true,
+            confidence: 0.8,
+            sourceEntityId: 'guard_1',
+            distortion: 0.05,
+            originTick: 0,
+            hops: 1,
+        });
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        expect(factionBelieves(factionCog, 'player', 'hostile', true)).toBe(true);
+        // Confidence scaled by cohesion (0.8 * 0.9 = 0.72)
+        const belief = getFactionBelief(factionCog, 'player', 'hostile');
+        expect(belief.confidence).toBeCloseTo(0.72, 1);
+    });
+    test('hostile rumor raises faction alert level', () => {
+        const engine = createEngine();
+        engine.drainEvents();
+        engine.store.emitEvent('rumor.belief.propagated', {
+            factionId: 'castle-guard',
+            subject: 'player',
+            key: 'hostile',
+            value: true,
+            confidence: 0.9,
+            sourceEntityId: 'guard_1',
+            distortion: 0.02,
+            originTick: 0,
+            hops: 1,
+        });
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        expect(factionCog.alertLevel).toBeGreaterThan(0);
+    });
+    test('faction-tick decays alert level', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'castle-guard');
+        factionCog.alertLevel = 20;
+        engine.submitAction('faction-tick');
+        expect(factionCog.alertLevel).toBe(18);
+    });
+    test('unknown faction returns fresh state', () => {
+        const engine = createEngine();
+        const factionCog = getFactionCognition(engine.world, 'bandits');
+        expect(factionCog.beliefs).toEqual([]);
+        expect(factionCog.alertLevel).toBe(0);
+    });
+});
+//# sourceMappingURL=faction-cognition.test.js.map