@plasius/training

Institutional training, trust, and specialization contracts for Plasius game progression.

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

Installation

npm install @plasius/training

Scope

@plasius/training owns the authority boundary for:

• schools, barracks, academies, and apprenticeships
• institutional trust and eligibility state
• internalized, externalized, and hybrid specialization state
• privacy-safe progression payloads and large-cohort scale assumptions for institutional training flows
• training mutation reliability and bounded-error expectations
• observable training-state transition records for regression detection

Demo

npm run build
node demo/example.mjs

Usage

import {
  createTrainingInstitution,
  createTrainingMutationReliabilityPolicy,
  createTrainingProgressionRecord,
  createTrainingStateTransitionEvent,
  defaultTrainingScaleAssumptions,
  trainingPrivacyScaleRollout,
} from "@plasius/training";

const academy = createTrainingInstitution({
  institutionId: "academy-1",
  type: "academy",
  track: "hybrid",
  eligible: true,
});

const progression = createTrainingProgressionRecord({
  playerSubjectId: "player-sub-1",
  institutionId: academy.institutionId,
  track: academy.track,
  trustLevel: "trusted",
  eligible: academy.eligible,
  updatedAtIso: new Date().toISOString(),
});

const policy = createTrainingMutationReliabilityPolicy({
  timeoutMs: 1500,
  cancellationWindowMs: 250,
  maxRetryAttempts: 2,
  recoverableFailureCodes: ["TRAINING_TIMEOUT"],
  terminalFailureCodes: ["TRACK_MISMATCH"],
});

const transition = createTrainingStateTransitionEvent({
  transitionId: "transition-1",
  institutionId: academy.institutionId,
  transitionType: "track-changed",
  outcome: "committed",
  fromTrack: "internalized",
  toTrack: academy.track,
  observedAt: new Date().toISOString(),
});

console.log(trainingPrivacyScaleRollout.featureFlagId);
console.log(defaultTrainingScaleAssumptions.maxLearnersPerInstitution);
console.log(progression.playerSubjectId, policy.maxRetryAttempts, transition.transitionType);

Privacy And Scale Baseline

The package exports an inherited rollout descriptor for the cross-repo feature flag isekai.training-progression.privacy-scale.enabled.

When that rollout is enabled, package consumers should prefer the minimal TrainingProgressionRecord contract:

• playerSubjectId is the only player-linked identifier and is expected to be pseudonymous
• profile names, email addresses, IP addresses, and free-form notes are outside the package contract
• trainingProgressionFieldPolicies documents the retention and sensitivity expectation for every exported progression field
• defaultTrainingScaleAssumptions publishes the validated large-cohort operating envelope used by the package docs and tests

Governance

• ADRs: docs/adrs
• TDRs: docs/tdrs
• Design notes: docs/design