paracosm 0.7.455 → 0.7.458

package/dist/engine/trait-models/index.js

@@ -0,0 +1,156 @@
+/**
+ * Trait Model Registry. Pluggable interface for leader / agent
+ * personality (or, for non-human leaders, decision-tendency) models.
+ *
+ * Today paracosm ships two built-in models:
+ *   - 'hexaco'    six-axis Ashton-Lee personality (the historical default)
+ *   - 'ai-agent'  six-axis AI-system tendency model
+ *
+ * Adding a third model post-hoc is a single `traitModelRegistry.register(...)`
+ * call. See `docs/superpowers/specs/2026-04-26-trait-model-generalization-design.md`.
+ *
+ * @module paracosm/engine/trait-models
+ */
+/* ─────────────────────────── registry ─────────────────────────── */
+/**
+ * Thrown when a TraitProfile references an unregistered modelId.
+ */
+export class UnknownTraitModelError extends Error {
+    modelId;
+    registered;
+    constructor(modelId, registered) {
+        const list = registered.length > 0 ? registered.join(', ') : '(none)';
+        super(`Unknown trait model id: '${modelId}'. ` +
+            `Registered models: ${list}. ` +
+            `If this artifact was created by a newer paracosm version, upgrade. ` +
+            `If you registered a custom model, ensure paracosm/engine/trait-models loads first.`);
+        this.modelId = modelId;
+        this.registered = registered;
+        this.name = 'UnknownTraitModelError';
+    }
+}
+/**
+ * In-memory map of TraitModel by id. The runtime singleton lives at
+ * `traitModelRegistry`; tests and isolated callers can construct
+ * their own via `new TraitModelRegistry()`.
+ */
+export class TraitModelRegistry {
+    models = new Map();
+    /**
+     * Register a model. Throws if a model with the same id is already
+     * registered (registration-time-only; no live re-binding).
+     */
+    register(model) {
+        if (this.models.has(model.id)) {
+            throw new Error(`TraitModelRegistry.register: id '${model.id}' is already registered. ` +
+                `Re-registration is not supported; use a unique id.`);
+        }
+        this.assertValid(model);
+        this.models.set(model.id, model);
+    }
+    /** Return the model or `undefined` if not registered. */
+    get(modelId) {
+        return this.models.get(modelId);
+    }
+    /** Return the model or throw `UnknownTraitModelError`. */
+    require(modelId) {
+        const model = this.models.get(modelId);
+        if (!model)
+            throw new UnknownTraitModelError(modelId, this.list().map(m => m.id));
+        return model;
+    }
+    /** All registered models in registration order. */
+    list() {
+        return Array.from(this.models.values());
+    }
+    /**
+     * Validate model shape: axes match defaults + drift + cues, ids are
+     * kebab-case, defaults are in [0, 1].
+     */
+    assertValid(model) {
+        if (!/^[a-z0-9-]+$/.test(model.id)) {
+            throw new Error(`TraitModel.id must be kebab-case: '${model.id}'`);
+        }
+        if (model.axes.length < 2 || model.axes.length > 12) {
+            throw new Error(`TraitModel.axes count must be 2..12, got ${model.axes.length}`);
+        }
+        const axisIds = new Set();
+        for (const axis of model.axes) {
+            // Axis ids accept kebab-case OR camelCase identifier-safe strings.
+            // The hexaco model's `honestyHumility` axis is camelCase to match
+            // the legacy LeaderConfig.hexaco.honestyHumility field name so the
+            // back-compat resolver can synthesize TraitProfile.traits from
+            // the legacy field without renaming. New models should still
+            // prefer kebab-case for new axes.
+            if (!/^[a-zA-Z0-9_-]+$/.test(axis.id)) {
+                throw new Error(`TraitAxis.id must be identifier-safe: '${axis.id}' (model: ${model.id})`);
+            }
+            if (axisIds.has(axis.id)) {
+                throw new Error(`Duplicate axis id '${axis.id}' in model '${model.id}'`);
+            }
+            axisIds.add(axis.id);
+            const def = model.defaults[axis.id];
+            if (typeof def !== 'number' || def < 0 || def > 1 || Number.isNaN(def)) {
+                throw new Error(`TraitModel '${model.id}' axis '${axis.id}': defaults must be a number in [0, 1], got ${def}`);
+            }
+        }
+        // Sanity check drift / cues only reference declared axes; missing
+        // axes are tolerated (treated as zero / no cue).
+        for (const axisId of Object.keys(model.drift.outcomes)) {
+            if (!axisIds.has(axisId)) {
+                throw new Error(`TraitModel '${model.id}' drift.outcomes references unknown axis '${axisId}'`);
+            }
+        }
+        for (const axisId of Object.keys(model.cues)) {
+            if (!axisIds.has(axisId)) {
+                throw new Error(`TraitModel '${model.id}' cues references unknown axis '${axisId}'`);
+            }
+        }
+    }
+}
+/**
+ * Process-wide singleton registry. The hexaco + ai-agent built-ins
+ * register on import via `engine/trait-models/builtins.ts` (which is
+ * imported by `engine/index.ts`). External consumers should `import
+ * { traitModelRegistry } from 'paracosm/engine/trait-models'`.
+ */
+export const traitModelRegistry = new TraitModelRegistry();
+/* ─────────────────────────── helpers ─────────────────────────── */
+/**
+ * Clamp a numeric trait value to [0, 1]. Used by the drift dispatcher
+ * after applying outcome / leader-pull / role-activation deltas.
+ */
+export function clampTrait(value) {
+    if (Number.isNaN(value))
+        return 0.5;
+    if (value < 0)
+        return 0;
+    if (value > 1)
+        return 1;
+    return value;
+}
+/**
+ * Compute the zone for a trait value: 'low' when <= 0.35, 'high' when
+ * >= 0.65, 'mid' otherwise. Used by the cue translator.
+ */
+export function traitZone(value) {
+    if (value <= 0.35)
+        return 'low';
+    if (value >= 0.65)
+        return 'high';
+    return 'mid';
+}
+/**
+ * Fill a partial trait map with model defaults so every axis has a
+ * value. Idempotent: existing keys are preserved.
+ */
+export function withDefaults(partial, model) {
+    const out = { ...model.defaults };
+    for (const axis of model.axes) {
+        if (axis.id in partial) {
+            out[axis.id] = clampTrait(partial[axis.id]);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/engine/trait-models/index.js.map

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

package/dist/runtime/schemas/department.d.ts

@@ -17,18 +17,18 @@ export declare const CitationSchema: z.ZodObject<{
 }, z.core.$strip>;
 export declare const RiskSchema: z.ZodObject<{
     severity: z.ZodEnum<{
-        critical: "critical";
         low: "low";
-        medium: "medium";
         high: "high";
+        critical: "critical";
+        medium: "medium";
     }>;
     description: z.ZodString;
 }, z.core.$strip>;
 export declare const OpportunitySchema: z.ZodObject<{
     impact: z.ZodEnum<{
         low: "low";
-        medium: "medium";
         high: "high";
+        medium: "medium";
     }>;
     description: z.ZodString;
 }, z.core.$strip>;
@@ -82,18 +82,18 @@ export declare const DepartmentReportSchema: z.ZodObject<{
     }, z.core.$strip>>>;
     risks: z.ZodDefault<z.ZodArray<z.ZodObject<{
         severity: z.ZodEnum<{
-            critical: "critical";
             low: "low";
-            medium: "medium";
             high: "high";
+            critical: "critical";
+            medium: "medium";
         }>;
         description: z.ZodString;
     }, z.core.$strip>>>;
     opportunities: z.ZodDefault<z.ZodArray<z.ZodObject<{
         impact: z.ZodEnum<{
             low: "low";
-            medium: "medium";
             high: "high";
+            medium: "medium";
         }>;
         description: z.ZodString;
     }, z.core.$strip>>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paracosm",
-  "version": "0.7.455",
+  "version": "0.7.458",
   "description": "Prompt/document/URL-grounded structured world model for AI agents: typed ScenarioPackages, deterministic kernels, HEXACO leaders, LLM events, runtime tool forging, and reproducible counterfactual RunArtifacts. Built on AgentOS.",
   "type": "module",
   "main": "dist/engine/index.js",