@plasius/player-system

Non-rendering Player System orchestration contracts and helpers for Plasius game experiences.

Apache-2.0. ESM + CJS builds. TypeScript types included.

Installation

npm install @plasius/player-system

Scope

@plasius/player-system owns the reusable runtime-side boundary for:

• Player System session shape
• focus and combat-safe state
• preference-learning signal capture
• module orchestration metadata
• authority-safe handoff readiness into external systems

It does not own rendering, world mutation, or institutional authority.

Demo

npm run build
node demo/example.mjs

Usage

import {
  PLAYER_SYSTEM_FEATURE_FLAG_ID,
  createPlayerSystemSessionState,
  packageDescriptor,
} from "@plasius/player-system";

const session = createPlayerSystemSessionState({
  sessionId: "awakening-001",
  mode: "ambient",
  combatSafe: true,
});

console.log(packageDescriptor.packageName, PLAYER_SYSTEM_FEATURE_FLAG_ID);
console.log(session.mode);

Governance

• ADRs: docs/adrs
• TDRs: docs/tdrs
• Design notes: docs/design
• Parent feature flag: isekai.player-system.packages.enabled
• Capability: not required for package bootstrap; adoption remains feature-flag led
• Rollback: disable isekai.player-system.packages.enabled to halt package-family adoption without changing package code