@ai-rpg-engine/modules 1.0.0 → 2.0.0

package/README.md

@@ -0,0 +1,66 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
+</p>
+
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml"><img src="https://github.com/mcp-tool-shop-org/ai-rpg-engine/actions/workflows/ci.yml/badge.svg" alt="CI"></a>
+  <a href="https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
+  <a href="https://mcp-tool-shop-org.github.io/ai-rpg-engine/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
+# @ai-rpg-engine/modules
+
+17 composable simulation modules for AI RPG Engine — combat, dialogue, cognition, perception, factions, and more.
+
+## Install
+
+```bash
+npm install @ai-rpg-engine/modules
+```
+
+## Modules
+
+| Module | Description |
+|--------|-------------|
+| `combatCore` | Attack/defend, damage, defeat, stamina |
+| `dialogueCore` | Graph-based dialogue trees with conditions |
+| `inventoryCore` | Items, equipment, use/equip/unequip |
+| `traversalCore` | Zone movement and exit validation |
+| `statusCore` | Status effects with duration and stacking |
+| `environmentCore` | Dynamic zone properties, hazards, decay |
+| `cognitionCore` | AI beliefs, intent, morale, memory |
+| `perceptionFilter` | Sensory channels, clarity, cross-zone hearing |
+| `narrativeAuthority` | Truth vs presentation, concealment, distortion |
+| `progressionCore` | Currency-based advancement, skill trees |
+| `factionCognition` | Faction beliefs, trust, inter-faction knowledge |
+| `rumorPropagation` | Information spread with confidence decay |
+| `knowledgeDecay` | Time-based confidence erosion |
+| `districtCore` | Spatial memory, zone metrics, alert thresholds |
+| `beliefProvenance` | Trace reconstruction across perception/cognition/rumor |
+| `observerPresentation` | Per-observer event filtering, divergence tracking |
+| `simulationInspector` | Runtime inspection, health checks, diagnostics |
+
+## Usage
+
+```typescript
+import { Engine } from '@ai-rpg-engine/core';
+import { combatCore, dialogueCore, cognitionCore, perceptionFilter } from '@ai-rpg-engine/modules';
+
+const engine = new Engine({
+  manifest: { /* ... */ },
+  seed: 42,
+  modules: [combatCore(), dialogueCore(), cognitionCore(), perceptionFilter()],
+});
+```
+
+## Documentation
+
+- [Modules (Ch. 6)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/06-modules/)
+- [AI Cognition (Ch. 8)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/08-ai-cognition/)
+- [Perception (Ch. 9)](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/09-perception-layers/)
+- [Handbook](https://mcp-tool-shop-org.github.io/ai-rpg-engine/handbook/)
+- [GitHub](https://github.com/mcp-tool-shop-org/ai-rpg-engine)
+
+---
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/package.json

@@ -1,34 +1,38 @@
-{
-  "name": "@ai-rpg-engine/modules",
-  "version": "1.0.0",
-  "description": "AI RPG Engine built-in modules: combat, dialogue, inventory, traversal, status",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
-    }
-  },
-  "files": ["dist"],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run"
-  },
-  "dependencies": {
-    "@ai-rpg-engine/core": "*",
-    "@ai-rpg-engine/content-schema": "*"
-  },
-  "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": "packages/modules"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "@ai-rpg-engine/modules",
+  "version": "2.0.0",
+  "description": "AI RPG Engine built-in modules: combat, dialogue, inventory, traversal, status",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@ai-rpg-engine/core": "*",
+    "@ai-rpg-engine/content-schema": "*"
+  },
+  "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": "packages/modules"
+  },
+  "keywords": ["rpg", "game-engine", "simulation", "combat", "perception", "cognition", "factions"],
+  "bugs": {
+    "url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}