@ai-rpg-engine/starter-template 2.3.6 → 2.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MCP Tool Shop
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,15 +1,15 @@
-# Starter Template
-
-Copy this directory to `packages/starter-yourname/` to create a new game.
-
-```bash
-cp -r templates/starter packages/starter-mygame
-```
-
-Then edit:
-- `package.json` — name and description
-- `src/ruleset.ts` — your stats, resources, verbs
-- `src/content.ts` — entities and zones
-- `src/setup.ts` — wire your modules alongside `buildCombatStack`
-
-See [Chapter 58 — Create Your Own Starter](../../site/src/content/docs/handbook/58-create-your-own-starter.md) for the full walkthrough.
+# Starter Template
+
+Copy this directory to `packages/starter-yourname/` to create a new game.
+
+```bash
+cp -r templates/starter packages/starter-mygame
+```
+
+Then edit:
+- `package.json` — name and description
+- `src/ruleset.ts` — your stats, resources, verbs
+- `src/content.ts` — entities and zones
+- `src/setup.ts` — wire your modules alongside `buildCombatStack`
+
+See [Chapter 58 — Create Your Own Starter](../../site/src/content/docs/handbook/58-create-your-own-starter.md) for the full walkthrough.

package/package.json

@@ -1,35 +1,36 @@
-{
-  "name": "@ai-rpg-engine/starter-template",
-  "version": "2.3.6",
-  "description": "Starter template for ai-rpg-engine — copy, rename, and build your own game",
-  "type": "module",
-  "files": [
-    "src",
-    "README.md",
-    "tsconfig.json"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "@ai-rpg-engine/core": "*",
-    "@ai-rpg-engine/content-schema": "*",
-    "@ai-rpg-engine/modules": "*"
-  },
-  "license": "MIT",
-  "author": "mcp-tool-shop",
-  "homepage": "https://mcp-tool-shop-org.github.io/ai-rpg-engine/",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine.git",
-    "directory": "templates/starter"
-  },
-  "keywords": [
-    "rpg",
-    "game-engine",
-    "starter",
-    "template",
-    "ai-rpg-engine"
-  ]
-}
+{
+  "name": "@ai-rpg-engine/starter-template",
+  "version": "2.5.0",
+  "description": "Starter template for ai-rpg-engine — copy, rename, and build your own game",
+  "type": "module",
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE",
+    "tsconfig.json"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@ai-rpg-engine/core": "*",
+    "@ai-rpg-engine/content-schema": "*",
+    "@ai-rpg-engine/modules": "*"
+  },
+  "license": "MIT",
+  "author": "mcp-tool-shop",
+  "homepage": "https://mcp-tool-shop-org.github.io/ai-rpg-engine/",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine.git",
+    "directory": "templates/starter"
+  },
+  "keywords": [
+    "rpg",
+    "game-engine",
+    "starter",
+    "template",
+    "ai-rpg-engine"
+  ]
+}

package/src/content.ts

@@ -1,80 +1,86 @@
-// Starter content — entities, zones, and manifest
-//
-// Replace this with your game's content.
-
-import type { EntityState, ZoneState, GameManifest } from '@ai-rpg-engine/core';
-
-export const manifest: GameManifest = {
-  id: 'my-game',
-  title: 'My Game',
-  version: '0.1.0',
-  engineVersion: '0.1.0',
-  ruleset: 'my-game',
-  modules: ['traversal-core', 'status-core', 'combat-core'],
-  contentPacks: ['my-game'],
-};
-
-// ═══════════════════════════════════════════════════════════════════
-// PACK METADATA (used by the CLI pack selector)
-// ═══════════════════════════════════════════════════════════════════
-
-export const packMeta = {
-  id: 'my-game',
-  name: 'My Game',
-  description: 'A brief description of your game',
-  version: '0.1.0',
-};
-
-// ═══════════════════════════════════════════════════════════════════
-// PLAYER
-// ═══════════════════════════════════════════════════════════════════
-
-export const player: EntityState = {
-  id: 'player',
-  blueprintId: 'player',
-  type: 'player',
-  name: 'Hero',
-  tags: ['player'],
-  stats: { power: 5, speed: 4, grit: 3 },
-  resources: { hp: 25, stamina: 10, tension: 0 },
-  statuses: [],
-  inventory: [],
-  zoneId: 'start',
-};
-
-// ═══════════════════════════════════════════════════════════════════
-// ENEMIES
-// ═══════════════════════════════════════════════════════════════════
-
-export const enemy: EntityState = {
-  id: 'grunt',
-  blueprintId: 'grunt',
-  type: 'npc',
-  name: 'Grunt',
-  tags: ['enemy', 'hostile'],
-  stats: { power: 3, speed: 3, grit: 2 },
-  resources: { hp: 12 },
-  statuses: [],
-  zoneId: 'danger-zone',
-};
-
-// ═══════════════════════════════════════════════════════════════════
-// ZONES
-// ═══════════════════════════════════════════════════════════════════
-
-export const zones: ZoneState[] = [
-  {
-    id: 'start',
-    roomId: 'room-1',
-    name: 'Starting Area',
-    tags: ['safe'],
-    neighbors: ['danger-zone'],
-  },
-  {
-    id: 'danger-zone',
-    roomId: 'room-2',
-    name: 'The Danger Zone',
-    tags: ['hostile'],
-    neighbors: ['start'],
-  },
-];
+// Starter content — entities, zones, and manifest
+//
+// Replace this with your game's content.
+
+import type { EntityState, ZoneState, GameManifest } from '@ai-rpg-engine/core';
+
+export const manifest: GameManifest = {
+    id: 'my-game',
+    title: 'My Game',
+    version: '0.1.0',
+    engineVersion: '0.1.0',
+    ruleset: 'my-game',
+    modules: ['traversal-core', 'status-core', 'combat-core'],
+    contentPacks: ['my-game'],
+};
+
+// ═══════════════════════════════════════════════════════════════════
+// PACK METADATA
+// This is a minimal subset to keep the template dependency-light. To list
+// your pack in the CLI pack selector, export the full PackMetadata shape
+// from @ai-rpg-engine/pack-registry (adds: tagline, genres, difficulty,
+// tones, tags, engineVersion, narratorTone) plus a BuildCatalog from
+// @ai-rpg-engine/character-creation — see any packages/starter-* content.ts
+// for a complete example.
+// ═══════════════════════════════════════════════════════════════════
+
+export const packMeta = {
+    id: 'my-game',
+    name: 'My Game',
+    description: 'A brief description of your game',
+    version: '0.1.0',
+};
+
+// ═══════════════════════════════════════════════════════════════════
+// PLAYER
+// ═══════════════════════════════════════════════════════════════════
+
+export const player: EntityState = {
+    id: 'player',
+    blueprintId: 'player',
+    type: 'player',
+    name: 'Hero',
+    tags: ['player'],
+    stats: { power: 5, speed: 4, grit: 3 },
+    resources: { hp: 25, stamina: 10, tension: 0 },
+    statuses: [],
+    inventory: [],
+    zoneId: 'start',
+};
+
+// ═══════════════════════════════════════════════════════════════════
+// ENEMIES
+// ═══════════════════════════════════════════════════════════════════
+
+export const enemy: EntityState = {
+    id: 'grunt',
+    blueprintId: 'grunt',
+    type: 'npc',
+    name: 'Grunt',
+    tags: ['enemy', 'hostile'],
+    stats: { power: 3, speed: 3, grit: 2 },
+    resources: { hp: 12 },
+    statuses: [],
+    zoneId: 'danger-zone',
+};
+
+// ═══════════════════════════════════════════════════════════════════
+// ZONES
+// ═══════════════════════════════════════════════════════════════════
+
+export const zones: ZoneState[] = [
+    {
+        id: 'start',
+        roomId: 'room-1',
+        name: 'Starting Area',
+        tags: ['safe'],
+        neighbors: ['danger-zone'],
+    },
+    {
+        id: 'danger-zone',
+        roomId: 'room-2',
+        name: 'The Danger Zone',
+        tags: ['hostile'],
+        neighbors: ['start'],
+    },
+];

package/src/index.ts

@@ -1,5 +1,5 @@
-// @ai-rpg-engine/starter-YOURNAME
-
-export { createGame } from './setup.js';
-export { manifest, packMeta } from './content.js';
-export { myRuleset } from './ruleset.js';
+// @ai-rpg-engine/starter-YOURNAME
+
+export { createGame } from './setup.js';
+export { manifest, packMeta } from './content.js';
+export { myRuleset } from './ruleset.js';

package/src/ruleset.ts

@@ -1,65 +1,65 @@
-// Ruleset — declarative contract for your game's stats, resources, and verbs
-
-import type { RulesetDefinition } from '@ai-rpg-engine/core';
-
-export const myRuleset: RulesetDefinition = {
-  id: 'my-game',
-  name: 'My Game',
-  version: '0.1.0',
-
-  // ═══════════════════════════════════════════════════════════════
-  // STATS — three combat dimensions + any exploration/social stats
-  // ═══════════════════════════════════════════════════════════════
-  stats: [
-    // Combat dimensions (required — mapped in buildCombatStack)
-    { id: 'power', name: 'Power', min: 1, max: 20, default: 5 },      // → attack
-    { id: 'speed', name: 'Speed', min: 1, max: 20, default: 5 },      // → precision
-    { id: 'grit', name: 'Grit', min: 1, max: 20, default: 5 },       // → resolve
-    // Add exploration/social stats here if needed
-  ],
-
-  // ═══════════════════════════════════════════════════════════════
-  // RESOURCES — hp is required; add your starter-specific resource
-  // ═══════════════════════════════════════════════════════════════
-  resources: [
-    { id: 'hp', name: 'HP', min: 0, max: 100, default: 25 },
-    { id: 'stamina', name: 'Stamina', min: 0, max: 50, default: 10, regenRate: 1 },
-    // YOUR RESOURCE: the one thing that makes your game feel different
-    { id: 'tension', name: 'Tension', min: 0, max: 100, default: 0 },
-  ],
-
-  // ═══════════════════════════════════════════════════════════════
-  // VERBS — actions available to players and AI
-  // ═══════════════════════════════════════════════════════════════
-  verbs: [
-    { id: 'move', name: 'Move', description: 'Travel to an adjacent zone' },
-    { id: 'inspect', name: 'Inspect', description: 'Examine surroundings' },
-    { id: 'attack', name: 'Attack', tags: ['combat'], description: 'Strike a target' },
-    { id: 'guard', name: 'Guard', tags: ['combat', 'defensive'], description: 'Reduce incoming damage' },
-    { id: 'brace', name: 'Brace', tags: ['combat', 'defensive'], description: 'Stabilize and resist status effects' },
-    { id: 'disengage', name: 'Disengage', tags: ['combat', 'movement'], description: 'Break from combat' },
-    { id: 'reposition', name: 'Reposition', tags: ['combat', 'movement'], description: 'Shift engagement state' },
-    { id: 'use', name: 'Use', description: 'Use an item' },
-    { id: 'speak', name: 'Speak', tags: ['dialogue'], description: 'Talk to an NPC' },
-    { id: 'choose', name: 'Choose', tags: ['dialogue'], description: 'Select a dialogue option' },
-    { id: 'use-ability', name: 'Use Ability', tags: ['ability'], description: 'Activate a special ability' },
-  ],
-
-  formulas: [
-    { id: 'hit-chance', name: 'Hit Chance', description: 'Standard: 50 + speed*5 - target.speed*3', inputs: ['attacker.speed', 'target.speed'], output: 'number (0-100)' },
-    { id: 'damage', name: 'Damage', description: 'Standard: attacker.power', inputs: ['attacker.power'], output: 'number' },
-  ],
-
-  defaultModules: [
-    'traversal-core',
-    'combat-core',
-    'cognition-core',
-    'engagement-core',
-    'combat-tactics',
-    'combat-intent',
-    'combat-recovery',
-    'combat-state-narration',
-  ],
-
-  progressionModels: [],
-};
+// Ruleset — declarative contract for your game's stats, resources, and verbs
+
+import type { RulesetDefinition } from '@ai-rpg-engine/core';
+
+export const myRuleset: RulesetDefinition = {
+    id: 'my-game',
+    name: 'My Game',
+    version: '0.1.0',
+
+    // ═══════════════════════════════════════════════════════════════
+    // STATS — three combat dimensions + any exploration/social stats
+    // ═══════════════════════════════════════════════════════════════
+    stats: [
+        // Combat dimensions (required — mapped in buildCombatStack)
+        { id: 'power', name: 'Power', min: 1, max: 20, default: 5 },      // → attack
+        { id: 'speed', name: 'Speed', min: 1, max: 20, default: 5 },      // → precision
+        { id: 'grit', name: 'Grit', min: 1, max: 20, default: 5 },       // → resolve
+        // Add exploration/social stats here if needed
+    ],
+
+    // ═══════════════════════════════════════════════════════════════
+    // RESOURCES — hp is required; add your starter-specific resource
+    // ═══════════════════════════════════════════════════════════════
+    resources: [
+        { id: 'hp', name: 'HP', min: 0, max: 100, default: 25 },
+        { id: 'stamina', name: 'Stamina', min: 0, max: 50, default: 10, regenRate: 1 },
+        // YOUR RESOURCE: the one thing that makes your game feel different
+        { id: 'tension', name: 'Tension', min: 0, max: 100, default: 0 },
+    ],
+
+    // ═══════════════════════════════════════════════════════════════
+    // VERBS — actions available to players and AI
+    // ═══════════════════════════════════════════════════════════════
+    verbs: [
+        { id: 'move', name: 'Move', description: 'Travel to an adjacent zone' },
+        { id: 'inspect', name: 'Inspect', description: 'Examine surroundings' },
+        { id: 'attack', name: 'Attack', tags: ['combat'], description: 'Strike a target' },
+        { id: 'guard', name: 'Guard', tags: ['combat', 'defensive'], description: 'Reduce incoming damage' },
+        { id: 'brace', name: 'Brace', tags: ['combat', 'defensive'], description: 'Stabilize and resist status effects' },
+        { id: 'disengage', name: 'Disengage', tags: ['combat', 'movement'], description: 'Break from combat' },
+        { id: 'reposition', name: 'Reposition', tags: ['combat', 'movement'], description: 'Shift engagement state' },
+        { id: 'use', name: 'Use', description: 'Use an item' },
+        { id: 'speak', name: 'Speak', tags: ['dialogue'], description: 'Talk to an NPC' },
+        { id: 'choose', name: 'Choose', tags: ['dialogue'], description: 'Select a dialogue option' },
+        { id: 'use-ability', name: 'Use Ability', tags: ['ability'], description: 'Activate a special ability' },
+    ],
+
+    formulas: [
+        { id: 'hit-chance', name: 'Hit Chance', description: 'Standard: 50 + speed*5 - target.speed*3', inputs: ['attacker.speed', 'target.speed'], output: 'number (0-100)' },
+        { id: 'damage', name: 'Damage', description: 'Standard: attacker.power', inputs: ['attacker.power'], output: 'number' },
+    ],
+
+    defaultModules: [
+        'traversal-core',
+        'combat-core',
+        'cognition-core',
+        'engagement-core',
+        'combat-tactics',
+        'combat-intent',
+        'combat-recovery',
+        'combat-state-narration',
+    ],
+
+    progressionModels: [],
+};

package/src/setup.ts

@@ -1,95 +1,112 @@
-// Game setup — wire content + combat stack into the engine
-//
-// ╔══════════════════════════════════════════════════════════════════╗
-// ║  COMPOSITION CONTRACT                                           ║
-// ║  buildCombatStack owns: cognition, engagement, review,          ║
-// ║    combatCore, tactics, resources, intent, recovery, narration   ║
-// ║  YOU own: traversal, status, inventory, dialogue, progression,  ║
-// ║    perception, environment, abilities, and your custom modules   ║
-// ╚══════════════════════════════════════════════════════════════════╝
-
-import { Engine } from '@ai-rpg-engine/core';
-import type { EngineModule, ResolvedEvent, WorldState } from '@ai-rpg-engine/core';
-import {
-  traversalCore,
-  statusCore,
-  buildCombatStack,
-} from '@ai-rpg-engine/modules';
-import { manifest, player, enemy, zones } from './content.js';
-import { myRuleset } from './ruleset.js';
-
-// ═══════════════════════════════════════════════════════════════════
-// STARTER-OWNED SYSTEMS
-// Add your game-specific modules here. These are the things that make
-// your starter feel different from other starters.
-// ═══════════════════════════════════════════════════════════════════
-
-// Example: a custom module that ticks your "tension" resource each combat round
-function createTensionPressure(): EngineModule {
-  return {
-    id: 'tension-pressure',
-    version: '1.0.0',
-    register(ctx) {
-      ctx.events.on('combat.round.end', (event: ResolvedEvent, world: WorldState) => {
-        const p = world.entities['player'];
-        if (p && p.resources.tension !== undefined) {
-          p.resources.tension = Math.min(100, (p.resources.tension ?? 0) + 5);
-        }
-      });
-    },
-  };
-}
-
-// ═══════════════════════════════════════════════════════════════════
-// GAME FACTORY
-// ═══════════════════════════════════════════════════════════════════
-
-export function createGame(seed?: number): Engine {
-  // Combat stack: map your three stats → the combat dimensions
-  const combat = buildCombatStack({
-    statMapping: { attack: 'power', precision: 'speed', resolve: 'grit' },
-    playerId: 'player',
-    // resourceProfile — uncomment and customize for your game's resource pressure:
-    // resourceProfile: {
-    //   spends: [
-    //     { verbId: 'attack', costStat: 'stamina', amount: 2 },
-    //   ],
-    // },
-    // biasTags — entity tags that cognition uses for faction bias:
-    // biasTags: ['enemy'],
-    // engagement — customize if your game uses ranged/melee distance:
-    // engagement: { defaultRange: 'melee' },
-    // recovery — safe zone recovery:
-    recovery: { safeZoneTags: ['safe'] },
-  });
-
-  const engine = new Engine({
-    manifest,
-    seed: seed ?? 42,
-    ruleset: myRuleset,
-    modules: [
-      traversalCore,
-      statusCore,
-      ...combat.modules, // ← the full combat stack
-      // ──────────────────────────────────────────────
-      // YOUR MODULES GO HERE
-      createTensionPressure(),
-      // ──────────────────────────────────────────────
-    ],
-  });
-
-  // Register zones
-  for (const zone of zones) {
-    engine.store.addZone(zone);
-  }
-
-  // Register entities
-  engine.store.addEntity({ ...player });
-  engine.store.addEntity({ ...enemy });
-
-  // Set player context
-  engine.store.state.playerId = 'player';
-  engine.store.state.locationId = 'start';
-
-  return engine;
-}
+// Game setup — wire content + combat stack into the engine
+//
+// ╔══════════════════════════════════════════════════════════════════╗
+// ║  COMPOSITION CONTRACT                                           ║
+// ║  buildCombatStack owns: cognition, engagement, review,          ║
+// ║    combatCore, tactics, resources, intent, recovery, narration   ║
+// ║  YOU own: traversal, status, inventory, dialogue, progression,  ║
+// ║    perception, environment, abilities, and your custom modules   ║
+// ╚══════════════════════════════════════════════════════════════════╝
+
+import { Engine } from '@ai-rpg-engine/core';
+import type { EngineModule, ResolvedEvent, WorldState } from '@ai-rpg-engine/core';
+import {
+    traversalCore,
+    statusCore,
+    buildCombatStack,
+} from '@ai-rpg-engine/modules';
+import { manifest, player, enemy, zones } from './content.js';
+import { myRuleset } from './ruleset.js';
+
+// ═══════════════════════════════════════════════════════════════════
+// STARTER-OWNED SYSTEMS
+// Add your game-specific modules here. These are the things that make
+// your starter feel different from other starters.
+// ═══════════════════════════════════════════════════════════════════
+
+// Example: a custom module that raises your "tension" resource whenever
+// damage lands in combat. It listens on 'combat.damage.applied' — a real
+// event emitted by combat-core every time an attack connects (other engine
+// events you can hook: 'combat.contact.hit', 'combat.contact.miss',
+// 'combat.entity.defeated', 'status.applied', 'world.zone.entered').
+function createTensionPressure(): EngineModule {
+    return {
+        id: 'tension-pressure',
+        version: '1.0.0',
+        register(ctx) {
+            ctx.events.on('combat.damage.applied', (event: ResolvedEvent, world: WorldState) => {
+                const p = world.entities['player'];
+                if (p && p.resources.tension !== undefined) {
+                    p.resources.tension = Math.min(100, (p.resources.tension ?? 0) + 5);
+                }
+            });
+        },
+    };
+}
+
+// ═══════════════════════════════════════════════════════════════════
+// GAME FACTORY
+// ═══════════════════════════════════════════════════════════════════
+
+export function createGame(seed?: number): Engine {
+    // Combat stack: map your three stats → the combat dimensions
+    const combat = buildCombatStack({
+        statMapping: { attack: 'power', precision: 'speed', resolve: 'grit' },
+        playerId: 'player',
+        // resourceProfile — uncomment and customize for your game's resource
+        // pressure. A CombatResourceProfile needs packId + the four arrays
+        // (gains / spends / drains / aiModifiers — empty arrays are fine):
+        // resourceProfile: {
+        //   packId: 'my-game',
+        //   gains: [
+        //     // +2 tension every time an attack you make lands
+        //     { trigger: 'attack-hit', resourceId: 'tension', amount: 2 },
+        //   ],
+        //   spends: [
+        //     // spend 2 stamina on each attack for +1 damage
+        //     { action: 'attack', resourceId: 'stamina', amount: 2, effects: { damageBonus: 1 } },
+        //   ],
+        //   drains: [],
+        //   aiModifiers: [],
+        // },
+        // biasTags — built-in pack bias tags that shape combat AI intent.
+        // Must come from PACK_BIAS_TAGS (exported by @ai-rpg-engine/modules,
+        // e.g. 'undead', 'beast', 'feral'); unknown tags warn and are dropped:
+        // biasTags: ['undead', 'beast'],
+        // engagement — backline/protector behavior for ranged parties
+        // (fields: backlineTags, protectorTags, chokepointTag, ambushTag):
+        // engagement: { backlineTags: ['ranged', 'caster'], protectorTags: ['bodyguard'] },
+        // recovery — safe zone recovery:
+        recovery: { safeZoneTags: ['safe'] },
+    });
+
+    const engine = new Engine({
+        manifest,
+        seed: seed ?? 42,
+        ruleset: myRuleset,
+        modules: [
+            traversalCore,
+            statusCore,
+            ...combat.modules, // ← the full combat stack
+            // ──────────────────────────────────────────────
+            // YOUR MODULES GO HERE
+            createTensionPressure(),
+            // ──────────────────────────────────────────────
+        ],
+    });
+
+    // Register zones
+    for (const zone of zones) {
+        engine.store.addZone(zone);
+    }
+
+    // Register entities
+    engine.store.addEntity({ ...player });
+    engine.store.addEntity({ ...enemy });
+
+    // Set player context
+    engine.store.state.playerId = 'player';
+    engine.store.state.locationId = 'start';
+
+    return engine;
+}

package/src/starter.test.ts

@@ -1,35 +1,47 @@
-import { describe, it, expect } from 'vitest';
-import { validateRulesetDefinition } from '@ai-rpg-engine/content-schema';
-import { myRuleset } from './ruleset.js';
-import { createGame } from './setup.js';
-
-describe('starter template', () => {
-  it('ruleset validates against schema', () => {
-    const r = validateRulesetDefinition(myRuleset);
-    expect(r.ok).toBe(true);
-    expect(r.errors).toHaveLength(0);
-  });
-
-  it('declares combat stats mapped in buildCombatStack', () => {
-    const statIds = myRuleset.stats.map((s) => s.id);
-    expect(statIds).toContain('power');
-    expect(statIds).toContain('speed');
-    expect(statIds).toContain('grit');
-  });
-
-  it('declares a starter-specific resource', () => {
-    const resIds = myRuleset.resources.map((r) => r.id);
-    expect(resIds).toContain('tension');
-  });
-
-  it('createGame boots without throwing', () => {
-    const engine = createGame(1);
-    expect(engine).toBeDefined();
-  });
-
-  it('tension pressure module is wired', () => {
-    const engine = createGame(1);
-    const p = engine.world.entities['player'];
-    expect(p?.resources.tension).toBe(0);
-  });
-});
+import { describe, it, expect } from 'vitest';
+import { validateRulesetDefinition } from '@ai-rpg-engine/content-schema';
+import { myRuleset } from './ruleset.js';
+import { createGame } from './setup.js';
+
+describe('starter template', () => {
+    it('ruleset validates against schema', () => {
+        const r = validateRulesetDefinition(myRuleset);
+        expect(r.ok).toBe(true);
+        expect(r.errors).toHaveLength(0);
+    });
+
+    it('declares combat stats mapped in buildCombatStack', () => {
+        const statIds = myRuleset.stats.map((s) => s.id);
+        expect(statIds).toContain('power');
+        expect(statIds).toContain('speed');
+        expect(statIds).toContain('grit');
+    });
+
+    it('declares a starter-specific resource', () => {
+        const resIds = myRuleset.resources.map((r) => r.id);
+        expect(resIds).toContain('tension');
+    });
+
+    it('createGame boots without throwing', () => {
+        const engine = createGame(1);
+        expect(engine).toBeDefined();
+    });
+
+    it('tension rises when combat damage lands (tension-pressure fires)', () => {
+        const engine = createGame(1);
+        expect(engine.world.entities['player']?.resources.tension).toBe(0);
+
+        // Walk into the danger zone and fight. combat-core emits
+        // 'combat.damage.applied' whenever a hit lands — that is the event
+        // the tension-pressure module listens on.
+        engine.submitAction('move', { targetIds: ['danger-zone'] });
+        for (let i = 0; i < 8; i++) {
+            engine.submitAction('attack', { targetIds: ['grunt'] });
+            if ((engine.world.entities['player']?.resources.tension ?? 0) > 0) break;
+        }
+
+        // Meta-test property: deleting the tension-pressure listener in
+        // setup.ts turns this RED — nothing else writes the tension resource.
+        expect(engine.world.entities['player']?.resources.tension).toBeGreaterThan(0);
+    });
+});

package/tsconfig.json

@@ -1,14 +1,24 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src"],
-  "references": [
-    { "path": "../../packages/core" },
-    { "path": "../../packages/content-schema" },
-    { "path": "../../packages/modules" }
-  ],
-  "exclude": ["**/*.test.ts"]
-}
+{
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "dist",
+        "rootDir": "src"
+    },
+    "include": [
+        "src"
+    ],
+    "references": [
+        {
+            "path": "../../packages/core"
+        },
+        {
+            "path": "../../packages/content-schema"
+        },
+        {
+            "path": "../../packages/modules"
+        }
+    ],
+    "exclude": [
+        "**/*.test.ts"
+    ]
+}