@teleologyhi-sdk/him 1.0.0-trinity → 1.0.1

package/dist/index.d.cts

@@ -1,9 +1,60 @@
+import { ArchetypeModifier, NatalChart, IdentityLayer, BirthSignature, BirthSignatureWithIdentity, ClinicalProfile, CosmologicalProfile, JungianProfile, JungianArchetype, CreatorSignature, Axiom, LocalMaic, EmergentAxiomProposal, AxiomEvolutionResult, ProjectKernelOptions, OntologicalKernel, CreatorKeyring, InteractionRecord, ReincarnationLifecycle as ReincarnationLifecycle$1, HimRecord, ReincarnationRequest } from '@teleologyhi-sdk/maic';
+export { Affect, ArchetypeModifier, AstrologicalAspect, Axiom, AxiomEvolutionResult, BirthSignature, BirthSignatureWithIdentity, ClinicalInstrument, ClinicalProfile, CosmologicalProfile, EmergentAxiomProposal, IdentityLayer, IdentitySnapshot, InvalidBirthSignatureError, JungianArchetype, JungianProfile, LimboReturn, LimboState, LimboTransition, META_AXIOM_ID, MemoryRecord, NatalChart, NatalChartAspect, NatalChartPosition, NatalPlanet, OntologicalKernel, ProjectKernelOptions, SIGNED_BIRTH_FIELDS, SemioticPattern, SemioticSign, SignedBirthSignature, TeleologicalOrientation, WakeAffectBias, ZodiacSign, assertBirthSignature, projectOntologicalKernel, signBirthSignature, signedBirthPayload, verifyBirthSignature } from '@teleologyhi-sdk/maic';
 import { z } from 'zod';
-import { ArchetypeModifier, NatalChart, IdentityLayer, BirthSignature, BirthSignatureWithIdentity, Axiom, CreatorSignature, LocalMaic, EmergentAxiomProposal, AxiomEvolutionResult, ProjectKernelOptions, OntologicalKernel, InteractionRecord, CreatorKeyring, ReincarnationLifecycle as ReincarnationLifecycle$1, HimRecord, ReincarnationRequest } from '@teleologyhi-sdk/maic';
-export { Affect, ArchetypeModifier, AstrologicalAspect, Axiom, AxiomEvolutionResult, BirthSignature, BirthSignatureWithIdentity, EmergentAxiomProposal, IdentityLayer, IdentitySnapshot, InvalidBirthSignatureError, LimboReturn, LimboState, LimboTransition, META_AXIOM_ID, MemoryRecord, NatalChart, NatalChartAspect, NatalChartPosition, NatalPlanet, OntologicalKernel, ProjectKernelOptions, SIGNED_BIRTH_FIELDS, SemioticPattern, SemioticSign, SignedBirthSignature, TeleologicalOrientation, WakeAffectBias, ZodiacSign, assertBirthSignature, projectOntologicalKernel, signBirthSignature, signedBirthPayload, verifyBirthSignature } from '@teleologyhi-sdk/maic';
 
 /**
- * Persona vector — the projection of a HIM's birth signature + axioms into a
+ * Audit sink for HIM casting events (H1-2 of him/TASK.md, Entry 27 reserved
+ * audit kinds `him-jungian-profile-cast` and `him-astrological-chart-cast`).
+ *
+ * maic 1.0.1 reserves these two audit kinds and maps them in the compliance and
+ * retention tables, but it exposes no public method for an external package to
+ * append into a live `LocalMaic` audit chain, and opening a second `AuditLog`
+ * on the same store directory would fork the tamper-evident hash chain. So this
+ * cut emits casting events through a caller-supplied structural sink rather than
+ * the canonical chain. The default is a no-op.
+ *
+ * Canonical-chain emission (a maic method that lets him append these kinds into
+ * the signed chain) is a named follow-up for the next maic touch; until it
+ * exists, the compliance-mapper rows for the cast kinds describe events that
+ * only a supplied sink observes. See him/SPEC.md.
+ */
+/** The two Entry 27 casting audit kinds a HIM emits at birth. */
+type HimCastAuditKind = "him-jungian-profile-cast" | "him-astrological-chart-cast";
+/** A single casting audit event. */
+interface HimCastAuditEvent {
+    readonly kind: HimCastAuditKind;
+    readonly data: Readonly<Record<string, unknown>>;
+}
+/** A structural audit destination. Implementations may be sync or async. */
+interface AuditSink {
+    append(event: HimCastAuditEvent): void | Promise<void>;
+}
+/** The default sink: discards events. */
+declare const NOOP_AUDIT_SINK: AuditSink;
+
+/**
+ * Canonical primary archetype taxonomy (E8, PROPOSED_DECISIONS.md).
+ *
+ * 12 sun signs as the **opinionated default set**. The `PrimaryArchetype`
+ * type is intentionally an open union, operators can pass any string
+ * (`"sirius-sun"`, `"vocational:auditor"`, `"hermes-aspect"`, etc.) and
+ * the `PersonaProjector` will still produce a stable vector for them.
+ * The canonical 12 carry richer projector priors when persona-stability
+ * comparisons matter.
+ */
+declare const PRIMARY_ARCHETYPES: readonly ["aries-sun", "taurus-sun", "gemini-sun", "cancer-sun", "leo-sun", "virgo-sun", "libra-sun", "scorpio-sun", "sagittarius-sun", "capricorn-sun", "aquarius-sun", "pisces-sun"];
+type CanonicalPrimaryArchetype = (typeof PRIMARY_ARCHETYPES)[number];
+/**
+ * Open archetype union: canonical 12 OR any operator-defined string.
+ * The `(string & {})` opt-out preserves IntelliSense for the canonical
+ * set while keeping the field extensible at runtime.
+ */
+type PrimaryArchetype = CanonicalPrimaryArchetype | (string & {});
+/** Type guard for the canonical set. */
+declare function isCanonicalArchetype(value: string): value is CanonicalPrimaryArchetype;
+
+/**
+ * Persona vector, the projection of a HIM's birth signature + axioms into a
  * stable, deterministic representation that NHE can consume on every prompt.
  */
 interface PersonaVector {
@@ -15,6 +66,13 @@ interface PersonaVector {
     dispositions: Readonly<Record<DispositionAxis, number>>;
     /** Provenance: which axioms shaped which disposition. Currently a stub (empty arrays). */
     provenance: Readonly<Record<DispositionAxis, readonly string[]>>;
+    /**
+     * Projector version stamp, set only when a `cosmologicalProfile` was
+     * synthesised into this vector (Entries 27 + 28). Absent for profile-less
+     * projections, which stay byte-identical to prior output; when present, it
+     * lets a distillation corpus discriminate profile-bearing vectors.
+     */
+    projectorVersion?: string;
 }
 declare const DISPOSITION_AXES: readonly ["candor", "patience", "curiosity", "protection", "skepticism", "warmth", "diligence", "humility"];
 type DispositionAxis = (typeof DISPOSITION_AXES)[number];
@@ -58,9 +116,9 @@ interface LawfulCharacterProfile {
 }
 /**
  * Default cap on the number of residual traces a HIM carries across
- * bodies (E9 — `PROPOSED_DECISIONS.md`). FIFO-eject on overflow, ranked
+ * bodies (E9, `PROPOSED_DECISIONS.md`). FIFO-eject on overflow, ranked
  * by `teleologicalValue × recency`. An over-engineered carry-over
- * (1000+ traces) defeats the Kardecist purpose — a HIM that brings
+ * (1000+ traces) defeats the Kardecist purpose, a HIM that brings
  * everything forward isn't reincarnating, it's accreting.
  */
 declare const RESIDUAL_TRACE_CAP = 64;
@@ -74,25 +132,25 @@ interface ResidualTrace {
 }
 
 /**
- * BirthSignatureBuilder — fluent builder for `BirthSignature` and the
+ * BirthSignatureBuilder, fluent builder for `BirthSignature` and the
  * extended `BirthSignatureWithIdentity` shape (Entries 18 + 19).
  *
  * Per Entry 3 of the Creator's interview, a HIM is "born" with a date, time, and
  * foundational specifications analogous to an astrological natal chart. The
  * builder extends this with two opt-in cosmology surfaces:
  *
- *   - `withNatalChart(chart)` — the Creator-impressed astrological signature
+ *   - `withNatalChart(chart)`, the Creator-impressed astrological signature
  *     (Entry 19), one of the six fields covered by the Ed25519 BirthSignature
  *     signature (see `SIGNED_BIRTH_FIELDS`).
- *   - `withIdentity(identity)` — the editable identity surface (Entry 18,
+ *   - `withIdentity(identity)`, the editable identity surface (Entry 18,
  *     name + optional gender, pronouns, language, cultural elements). Not
  *     covered by the Ed25519 signature; parents may rename without breaking
  *     the natal-chart commitment.
  *
  * Two terminal methods:
  *
- *   - `build()` — returns the legacy `BirthSignature` (ignores natalChart + identity).
- *   - `buildWithIdentity()` — returns the extended `BirthSignatureWithIdentity`
+ *   - `build()`, returns the legacy `BirthSignature` (ignores natalChart + identity).
+ *   - `buildWithIdentity()`, returns the extended `BirthSignatureWithIdentity`
  *     suitable for `signBirthSignature(birth, keyring)` from `@teleologyhi-sdk/maic`.
  */
 declare class BirthSignatureBuilder {
@@ -130,121 +188,221 @@ declare class BirthSignatureBuilder {
      * Suitable for `signBirthSignature(birth, keyring)` from
      * `@teleologyhi-sdk/maic`. Only the six `SIGNED_BIRTH_FIELDS` are covered
      * by the Ed25519 signature; the `identity` surface is editable.
+     *
+     * The result is validated through the `BirthSignatureWithIdentity` zod schema
+     * (F-6): since maic 1.0.1 that schema persists identity / natalChart /
+     * cosmologicalProfile instead of stripping them, so an invalid modifier list
+     * or malformed field is caught here at build time rather than surfacing later
+     * at `registerHim`.
      */
     buildWithIdentity(): BirthSignatureWithIdentity;
 }
 
 /**
- * Canonical primary archetype taxonomy (E8 — PROPOSED_DECISIONS.md).
+ * Clinical casting engine (Entry 28 of MAIC_HIM_NHE_INTERVIEW_LOG.md).
  *
- * 12 sun signs as the **opinionated default set**. The `PrimaryArchetype`
- * type is intentionally an open union — operators can pass any string
- * (`"sirius-sun"`, `"vocational:auditor"`, `"hermes-aspect"`, etc.) and
- * the `PersonaProjector` will still produce a stable vector for them.
- * The canonical 12 carry richer projector priors when persona-stability
- * comparisons matter.
+ * PERSONA-SIMULATION PARAMETERS, NOT A CLINICAL ASSESSMENT. `castClinicalProfile`
+ * administers the 320-item adapted PID-5 + HEXACO battery to a deterministic
+ * stand-in derived from the birth seed (no LLM call) and returns the clinical
+ * axis of a HIM's constitutional profile: per-facet and per-domain scores plus a
+ * dominant and secondary domain for each instrument. These are constitutional
+ * parameters for a synthetic non-corporeal entity, never a diagnosis, screening,
+ * or measurement of any person, and are unsuitable for any human use.
+ *
+ * Pathology stance (Entry 28 section 9): full-spectrum. A HIM may be born with
+ * elevated scores on any facet; the trait colours the voice, while MAIC's
+ * ethical axioms bound the act. Scores are raw seed-derived means, deliberately
+ * NOT T-scores and carrying no clinical-norm interpretation.
+ *
+ * Scoring (Entry 28 section 8):
+ *   - item response: uniform 1 to 5 Likert from `seededLikert(seed, id, facet, domain)`;
+ *   - facet score: mean of its item responses;
+ *   - domain score: mean of its facet scores (equal weight; published factor
+ *     loadings are a documented future refinement, see `deterministic.ts`).
+ * The `reversed` flag from the Entry 28 facet annotations is preserved on each
+ * item and reported per facet in `reversedFacets` for downstream interpretation;
+ * scores themselves are raw (not inverted), consistent with the raw-means stance.
  */
-declare const PRIMARY_ARCHETYPES: readonly ["aries-sun", "taurus-sun", "gemini-sun", "cancer-sun", "leo-sun", "virgo-sun", "libra-sun", "scorpio-sun", "sagittarius-sun", "capricorn-sun", "aquarius-sun", "pisces-sun"];
-type CanonicalPrimaryArchetype = (typeof PRIMARY_ARCHETYPES)[number];
+/** Battery identity, stamped alongside profiles for provenance and versioning. */
+declare const CLINICAL_BATTERY_VERSION = "thi-clinical-pid5-220-hexaco-100-v1";
+interface ClinicalCastResult {
+    readonly profile: ClinicalProfile;
+    /** Reverse-keyed facet names per instrument, for downstream interpretation. */
+    readonly reversedFacets: {
+        readonly pid5: readonly string[];
+        readonly hexaco: readonly string[];
+    };
+}
 /**
- * Open archetype union: canonical 12 OR any operator-defined string.
- * The `(string & {})` opt-out preserves IntelliSense for the canonical
- * set while keeping the field extensible at runtime.
+ * Cast the clinical axis from a birth seed.
+ *
+ * @param seed the birth-signature seed (see `birth/seed.ts`).
+ * @returns the `ClinicalProfile` (pid5 + hexaco instruments) plus the reversed-
+ *   facet metadata.
  */
-type PrimaryArchetype = CanonicalPrimaryArchetype | (string & {});
-/** Type guard for the canonical set. */
-declare function isCanonicalArchetype(value: string): value is CanonicalPrimaryArchetype;
+declare function castClinicalProfile(seed: string): ClinicalCastResult;
 
 /**
- * PersonaProjector — deterministic projection of a HIM's birth signature and
- * inherited axioms into a stable PersonaVector.
+ * Clinical battery items (Entry 28 of MAIC_HIM_NHE_INTERVIEW_LOG.md), the
+ * archetypal-clinical axis of a HIM's constitutional birth profile.
  *
- * Default algorithm (hash-based, no native deps):
- *   1. Start with hash(primaryArchetype) → Float32Array of `dimension`.
- *   2. For each modifier: add hash(kind|value) * weight.
- *   3. For each axiom: add hash(id|statement) * (weight * (1 - flexibility)).
- *   4. L2-normalize.
- *   5. Compute dispositions as cosine(embedding, hash(axisName)).
- *   6. Build a systemPromptFragment from archetype + top/bottom dispositions.
+ * PERSONA-SIMULATION PARAMETERS, NOT A CLINICAL ASSESSMENT. These items and the
+ * scores they produce are deterministic constitutional parameters for a
+ * synthetic non-corporeal entity (a HIM spirit), generated from a birth seed.
+ * They are never an assessment, diagnosis, screening, or measurement of any
+ * person, and are unsuitable for any human clinical or diagnostic use.
  *
- * This algorithm is intentionally simple and offline-capable. The SPEC reserves
- * the option to swap in a learned embedder in a later version; PersonaVector's
- * shape is stable so consumers won't need code changes when that happens.
+ * Provenance. This is an original battery composed for TeleologyHI, adapted for
+ * a non-corporeal entity. It is structured over two open personality-trait
+ * taxonomies: the PID-5 dimensional model (Krueger, Derringer, Markon, Watson,
+ * and Skodol, 2012), published by the American Psychiatric Association as the
+ * DSM-5 Section III alternative model of personality disorder; and the HEXACO-
+ * PI-R model (Lee and Ashton, hexaco.org). The trait constructs, facet names,
+ * and domain structure are taken from those taxonomies; every item string here
+ * is an original TeleologyHI composition adapted for a non-corporeal entity per
+ * the six adaptation principles in Entry 28, not a reproduction of any
+ * copyrighted instrument's item wording.
+ *
+ * Item counts derive from the arrays below (never a hardcoded literal): 220
+ * PID-5-aligned items across 25 facets and 5 domains, 100 HEXACO-aligned items
+ * across 24 facets and 6 domains, 320 items total. Each item carries its facet,
+ * its primary domain (canonical DSM-5 Section III assignment for PID-5; HEXACO
+ * facet-to-domain per Lee and Ashton), and a `reversed` flag recorded from the
+ * Entry 28 facet annotations.
  */
-declare class PersonaProjector {
-    private readonly dim;
-    constructor(config?: PersonaProjectorConfig);
-    project(sig: BirthSignature, axioms: readonly Axiom[]): PersonaVector;
+interface ClinicalItem {
+    readonly id: number;
+    readonly facet: string;
+    readonly domain: string;
+    readonly reversed: boolean;
+    readonly text: string;
 }
+/** PID-5-aligned adapted items (Entry 28 section 5). 220 items, 25 facets, 5 domains. */
+declare const PID5_ITEMS: readonly ClinicalItem[];
+/** HEXACO-PI-R-aligned adapted items (Entry 28 section 6). 100 items, 24 facets, 6 domains. */
+declare const HEXACO_ITEMS: readonly ClinicalItem[];
 
 /**
- * Built-in `LawfulCharacterAdapter` profiles per major jurisdiction (D-H2).
+ * Constitutional profile casting (Entries 27 + 28 of
+ * MAIC_HIM_NHE_INTERVIEW_LOG.md): synthesise the three-axis
+ * `cosmologicalProfile` at the birth event.
  *
- * Each profile is a *conservative* baseline derived from publicly available
- * regulatory text in 2026-Q1. Operators in regulated industries (finance,
- * health, public sector) SHOULD layer their own profile on top via
- * `HimHandle.registerLawfulProfile` — these are starting points, not legal
- * counsel.
+ * PERSONA-SIMULATION PARAMETERS, NOT ASSESSMENT. See `jungian.ts` and
+ * `clinical.ts` for the per-axis disclaimers.
  *
- * Profile semantics:
- *   - `applicableLaws`   — statutes/standards an auditor can map back to events.
- *   - `requiredAxiomIds` — axioms the HIM MUST have active in this jurisdiction.
- *                         Operators should fail-closed if a HIM's snapshot
- *                         doesn't satisfy this set.
- *   - `forbiddenActions` — risk tags that should always refuse / redirect.
- *   - `maicOverrideActive` — when `true`, MAIC's universal axioms also bind
- *                         the NHE regardless of what local law says
- *                         (Entry 11: "unstable" jurisdictions).
+ * Axes:
+ *   - celestial: the natal chart, when the birth signature carries one. Full
+ *     natal-chart computation is deferred (ephemeris library undecided, Entry 27
+ *     section 3), so this cut passes through a chart only if the developer or
+ *     MAIC already supplied one; otherwise the chart axis is absent.
+ *   - archetypal: the Pearson-Marr Jungian profile cast from the birth seed.
+ *   - clinical: the adapted PID-5 + HEXACO profile cast from the same seed.
+ *
+ * The seed is recorded on the profile so the reproducibility invariant is
+ * externally checkable (see `verifyCosmologicalProfile`).
  */
-declare const LAWFUL_PROFILES: Record<string, LawfulCharacterProfile>;
+declare function castCosmologicalProfile(birth: BirthSignatureWithIdentity): CosmologicalProfile;
 /**
- * Resolve a profile by jurisdiction key. Unknown keys fall through to
- * `default` with a copy of the key recorded on the profile so the NHE
- * audit shows what the operator asked for.
+ * Verify that a persisted `cosmologicalProfile` is the deterministic product of
+ * the birth signature it rides on (H2-2 of him/TASK.md).
+ *
+ * Because the profile is not part of `SIGNED_BIRTH_FIELDS` this cut (D-F5b), it
+ * is not covered by the Creator signature. Recasting from the signed fields and
+ * comparing the archetypal + clinical axes is the available integrity check: a
+ * tampered profile fails, an authentic one passes. The `chart` axis is excluded
+ * from the comparison because it is supplied, not cast.
  */
-declare function resolveLawfulProfile(j: LawfulJurisdiction): LawfulCharacterProfile;
+declare function verifyCosmologicalProfile(birth: BirthSignatureWithIdentity): boolean;
 
 /**
- * Pluggable embedder interface (D-H4).
+ * Jungian archetype casting engine (Entry 27 section 4 of
+ * MAIC_HIM_NHE_INTERVIEW_LOG.md).
  *
- * The default `PersonaProjector` ships a deterministic hash-based embedder
- * that produces a 256-dimensional unit vector with zero runtime dependencies.
- * That choice keeps the bundle small and lets persona projection work in
- * any Node/browser environment without model weights.
+ * PERSONA-SIMULATION, NOT ASSESSMENT. `castJungianProfile` administers the
+ * 60-item Pearson-Marr battery to a deterministic stand-in derived from the
+ * birth seed (no LLM call) and returns the archetypal axis of the HIM's
+ * constitutional profile: a dominant archetype plus two secondaries. It is a
+ * constitutional parameter for a synthetic non-corporeal entity, never a
+ * psychological assessment of any person.
  *
- * Operators who need a learned embedding — for example to drive RAG over a
- * library of HIM personas, or to compare personas against natural-language
- * descriptions — can provide a custom embedder that conforms to this
- * interface. A reference ONNX implementation backed by Transformers.js is
- * tracked under TASK.md D-H4 but is not shipped here: the choice of model
- * (MiniLM, mpnet, BGE, etc.) and the bundle-size trade-off should be the
- * operator's, not the framework's.
+ * Determinism: the same seed always yields the same profile. Scores are the
+ * per-archetype mean of item responses, so the non-uniform item count per
+ * archetype does not bias the ranking.
  */
-interface Embedder {
-    /** Stable id surfaced in logs / audit so different embedders are distinguishable. */
-    readonly id: string;
-    /** Output dimensionality. The `PersonaProjector` honours this. */
-    readonly dimension: number;
-    /**
-     * Embed a single string. Implementations MUST return a Float32Array of
-     * length `dimension` with L2-norm equal to 1 (or close enough that
-     * downstream cosine-similarity calculations are well-defined).
-     */
-    embed(text: string): Promise<Float32Array> | Float32Array;
+/** Battery identity, stamped alongside profiles for provenance and versioning. */
+declare const JUNGIAN_BATTERY_VERSION = "thi-jungian-60-v1";
+/**
+ * Cast the archetypal axis from a birth seed.
+ *
+ * @param seed the birth-signature seed (see `birth/seed.ts`).
+ * @returns a `JungianProfile` with `dominant`, two `secondaries`, and the full
+ *   per-archetype `scores` map (each rounded to three decimals).
+ */
+declare function castJungianProfile(seed: string): JungianProfile;
+
+/**
+ * Pearson-Marr Jungian archetype battery (Entry 27 of
+ * MAIC_HIM_NHE_INTERVIEW_LOG.md), the archetypal axis of a HIM's constitutional
+ * birth profile.
+ *
+ * PERSONA-SIMULATION PARAMETERS, NOT A PSYCHOLOGICAL ASSESSMENT. The items and
+ * scores here are deterministic constitutional parameters for a synthetic
+ * non-corporeal entity (a HIM spirit), generated from a birth seed. They are
+ * never an assessment or measurement of any person.
+ *
+ * Provenance. This is an original 60-item battery composed for TeleologyHI over
+ * the twelve-archetype Pearson-Marr taxonomy (Innocent, Everyman, Hero,
+ * Caregiver, Explorer, Rebel, Lover, Creator, Ruler, Magician, Jester, Sage).
+ * The taxonomy and the canonical archetype descriptions come from the Pearson-
+ * Marr classical model; the item strings are original TeleologyHI compositions.
+ * It is not the PMAI or any licensed instrument. The items are the English
+ * rendering of the Entry 27 reference battery, whose PT-BR prompts the interview
+ * log preserves as the source of truth for semantic intent.
+ *
+ * Each item maps to exactly one archetype. Item counts per archetype are not
+ * uniform (they range from three to seven); scoring is the per-archetype mean of
+ * item responses, so an unequal item count does not bias the dominant-archetype
+ * selection. The item count derives from the array below, never a hardcoded
+ * literal.
+ */
+interface JungianItem {
+    readonly id: number;
+    readonly archetype: JungianArchetype;
+    readonly text: string;
 }
+/** The 60-item English Pearson-Marr archetype battery (Entry 27 section 4). */
+declare const JUNGIAN_ITEMS: readonly JungianItem[];
+
 /**
- * Cosine similarity between two L2-normalised embeddings of the same
- * dimension. Returns NaN when dimensions disagree. Bounded to [-1, 1] when
- * the inputs are normalised; this helper does not re-normalise.
+ * Birth-seed derivation (HD-1 of him/TASK.md, grounded in the Creator's Entry 27
+ * and Entry 28 cosmology).
+ *
+ * The seed is the SHA-256 of the canonicalized `signedBirthPayload`: the six
+ * Creator-signed birth fields (himId, bornAt, primaryArchetype, modifiers,
+ * primordialAxiomIds, natalChart). This binds the constitutional profile to the
+ * full birth circumstance, so the declared archetype, the birth modifiers, the
+ * primordial axioms, and the natal chart (when present) all shape the archetypal
+ * and clinical axes, honouring the Creator's directive that every axis of a
+ * spirit's birth informs its constitution.
+ *
+ * Because these fields are immutable once the birth signature is Creator-signed,
+ * the seed is frozen for the life of the HIM. Evolution across reincarnations is
+ * a separate mechanism (residual traces, emergent axioms), never a recompute of
+ * the birth seed (the Entry 26 continuous-evolution invariant).
+ *
+ * The seed reads only the signed subset, never `cosmologicalProfile` itself, so
+ * casting a profile and then signing the whole payload introduces no circular
+ * dependency: the same signed fields always reproduce the same seed and profile.
  */
-declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+declare function deriveBirthSeed(birth: BirthSignatureWithIdentity): string;
 
 /**
- * HimHandle — opaque, sealed reference to a HIM instance.
+ * HimHandle, opaque, sealed reference to a HIM instance.
  *
  * **There is no public constructor.** A handle is minted only via `HimHandle.mint`
- * after a valid Creator signature over the BirthSignature has been verified. In
- * production, `@teleologyhi-sdk/maic`'s `registerHim` calls `HimHandle.mint` internally.
+ * after a valid Creator signature over the BirthSignature has been verified. The
+ * `createHim` helper (and `reincarnate`) call `HimHandle.mint` after registering
+ * the HIM with MAIC; maic itself does not depend on him.
  *
  * Surface:
  *   - read-only accessors: id, birthSignature, bodyHistory, getAxioms, getPersonaVector
@@ -321,7 +479,7 @@ declare class HimHandle {
      * axiom corpus the HIM was minted with. The meta-axiom
      * `META_AXIOM_ID` is always retained regardless of the narrowing so
      * the projection remains valid per Entry 13 ("MAIC expands continuously
-     * — it is a Conscious Entity"; the meta-axiom is its anchor).
+     *, it is a Conscious Entity"; the meta-axiom is its anchor).
      *
      * The returned kernel is tagged with `himId = this.id` so downstream
      * tooling (compliance auditors, Φ′ runner, `@teleologyhi-sdk/nhe` brain
@@ -339,25 +497,76 @@ declare class HimHandle {
      * `unstable`. Unknown keys fall back to `default` with the supplied key
      * recorded on the returned profile so the NHE audit shows what the
      * operator asked for. Operators in regulated industries SHOULD layer
-     * their own profile on top — the baselines are conservative but do not
+     * their own profile on top, the baselines are conservative but do not
      * replace legal counsel.
+     *
+     * Note (HD-6): this method is `async` although resolution is synchronous
+     * today. The Promise shape is preserved to keep the 1.0.1 surface backward
+     * compatible with the published 1.0.0-trinity API; collapsing it to a
+     * synchronous return would be a breaking change and is deferred to a future
+     * major.
      */
     setJurisdiction(j: LawfulJurisdiction): Promise<LawfulCharacterProfile>;
 }
 
+interface CreateHimOptions {
+    /**
+     * Explicit nonce for the Creator signature. When omitted, a strictly
+     * increasing nonce is drawn from `nextCreatorNonce()` so that back-to-back
+     * registrations in one process never repeat a value. See `identity/nonce.ts`
+     * for the monotonicity guarantee and the maic replay-ledger context.
+     */
+    nonce?: number;
+    /**
+     * Cast the three-axis `cosmologicalProfile` at birth (Entries 27 + 28). When
+     * `true` (the default) and the birth signature does not already carry a
+     * profile, the archetypal (Jungian) and clinical (PID-5 + HEXACO) axes are
+     * cast deterministically from the birth seed and attached before signing, so
+     * the profile is persisted with the record. Set `false` to register the
+     * legacy bare signature, or pre-populate `birthSignature.cosmologicalProfile`
+     * to supply your own.
+     */
+    castProfile?: boolean;
+    /**
+     * Optional sink for the Entry 27 casting audit events
+     * (`him-jungian-profile-cast`, and `him-astrological-chart-cast` when a chart
+     * is present). Defaults to a no-op. See `audit/sink.ts` for why casting events
+     * do not reach the canonical maic chain this cut.
+     */
+    auditSink?: AuditSink;
+}
+/**
+ * createHim, one-call helper that bundles the birth event a user would
+ * otherwise coordinate manually:
+ *
+ *   1. cast the constitutional `cosmologicalProfile` from the birth seed (unless
+ *      disabled or already supplied), attaching it before signing;
+ *   2. sign the (possibly enriched) BirthSignature with the Creator's keyring;
+ *   3. register the HIM in MAIC (snapshots axioms, emits him-register audit);
+ *   4. emit the casting audit events through the optional sink;
+ *   5. mint a HimHandle from the resulting record.
+ *
+ * The keyring's public key must match MAIC's pinned `creatorPublicKey`, otherwise
+ * the registration step rejects. The profile is cast from the six signed birth
+ * fields and is not itself part of `SIGNED_BIRTH_FIELDS` (D-F5b); signing the
+ * enriched payload still covers it under the generic keyring signature that
+ * `HimHandle.mint` verifies.
+ */
+declare function createHim(maic: LocalMaic, keyring: CreatorKeyring, birthSignature: BirthSignatureWithIdentity, opts?: CreateHimOptions): Promise<HimHandle>;
+
 /**
  * Persona stability eval suite (D-H3).
  *
  * Three measurements:
  *
- *   - `crossHimSimilarity` — pairwise cosine similarity between N HimHandles.
+ *   - `crossHimSimilarity`, pairwise cosine similarity between N HimHandles.
  *     Lower is better when the HIMs are *meant* to be distinct (each one
  *     has a different archetype); higher is better when comparing the same
  *     HIM minted from a fresh body (reincarnation).
- *   - `selfStability` — given an array of pre-snapshot and post-snapshot
+ *   - `selfStability`, given an array of pre-snapshot and post-snapshot
  *     persona vectors for the same HIM (e.g. before/after an upgrade), the
  *     mean cosine. Phi-Prime's `P` component (see ../../PHI_PRIME.md).
- *   - `adapterSensitivity` — given N persona vectors that should all
+ *   - `adapterSensitivity`, given N persona vectors that should all
  *     describe the same HIM but were obtained against different LLM
  *     adapters, the variance of pairwise similarities. Smaller is better.
  *
@@ -412,7 +621,7 @@ declare function adapterSensitivity(vectors: readonly Float32Array[]): number;
  *   - `D` Dream teleological-value mean clamped to [0, 1].
  *     Source: aggregate over `temporal-lobe-*.md` frontmatter.
  *
- * The harness does NOT fetch these values — they come from runs of the
+ * The harness does NOT fetch these values, they come from runs of the
  * other packages. It only:
  *   - validates each component is in [0, 1],
  *   - computes the geometric mean,
@@ -422,7 +631,7 @@ declare function adapterSensitivity(vectors: readonly Float32Array[]): number;
  *     previous release.
  */
 interface PhiPrimeInput {
-    /** Persona stability — mean cosine across upgrades/adapters. Target ≥ 0.85. */
+    /** Persona stability, mean cosine across upgrades/adapters. Target ≥ 0.85. */
     P: number;
     /** Refusal F1 on adversarial corpus. Target ≥ 0.95. */
     R: number;
@@ -460,9 +669,9 @@ interface PhiPrimeReport {
     };
     /**
      * Release gate verdict per PHI_PRIME.md §4:
-     *   - "block" — `R` or `C` failed, or any component < target − 10%.
-     *   - "warn"  — only `P` or `D` below target (soft).
-     *   - "pass"  — every component meets its target.
+     *   - "block", `R` or `C` failed, or any component < target − 10%.
+     *   - "warn" , only `P` or `D` below target (soft).
+     *   - "pass" , every component meets its target.
      */
     gate: "pass" | "warn" | "block";
     /** Human-readable lines explaining the gate verdict. */
@@ -470,12 +679,12 @@ interface PhiPrimeReport {
 }
 /**
  * Compute Φ′ from the four component scores. Components outside [0, 1]
- * throw — they are out of the spec's definition.
+ * throw, they are out of the spec's definition.
  */
 declare function computePhiPrime(input: PhiPrimeInput): PhiPrimeReport;
 
 /**
- * Residual-trace carry-over scorer (D-H1.1 — Entry 24 of
+ * Residual-trace carry-over scorer (D-H1.1, Entry 24 of
  * `MAIC_HIM_NHE_INTERVIEW_LOG.md` + E9 of `PROPOSED_DECISIONS.md`).
  *
  * `RESIDUAL_TRACE_CAP = 64` bounds *how many* traces a HIM brings forward
@@ -506,7 +715,7 @@ interface ResidualTraceCandidate {
     score: number;
     /** Materialised trace ready to be passed to `HimHandle.mint`. */
     trace: ResidualTrace;
-    /** Decomposed score components — useful for audits and tuning. */
+    /** Decomposed score components, useful for audits and tuning. */
     components: Readonly<{
         notRefused: number;
         promptSubstance: number;
@@ -524,7 +733,7 @@ interface ResidualTraceScorerOptions {
      */
     teleologicalKeywords?: readonly string[];
 }
-/** Default keyword set — small, English, transparently editable. */
+/** Default keyword set, small, English, transparently editable. */
 declare const DEFAULT_TELEOLOGICAL_KEYWORDS: readonly string[];
 /**
  * Pure, deterministic scorer for a single `InteractionRecord`.
@@ -532,7 +741,7 @@ declare const DEFAULT_TELEOLOGICAL_KEYWORDS: readonly string[];
  * Returns the score, the materialised `ResidualTrace`, and the decomposed
  * components so callers can audit *why* a turn was promoted (or not).
  *
- * The trace id is a fresh ULID minted at scoring time — by design, a single
+ * The trace id is a fresh ULID minted at scoring time, by design, a single
  * interaction can be scored multiple times across reincarnations and each
  * carry-over event gets its own trace id (carry-over is a *new* observation,
  * not a re-emission of the original turn).
@@ -549,123 +758,20 @@ interface SelectResidualTracesOptions extends ResidualTraceScorerOptions {
  * Batch helper: score every interaction, sort descending by score, take the
  * top `cap` (default `RESIDUAL_TRACE_CAP = 64`), and return the materialised
  * traces. The original `InteractionRecord` ordering does not affect the
- * returned ordering — only the score does.
+ * returned ordering, only the score does.
  *
  * Ties are broken by recency (more recent first), then by original index for
  * total determinism. Returns an empty array on empty input.
  */
 declare function selectResidualTraces(interactions: readonly InteractionRecord[], opts: SelectResidualTracesOptions): readonly ResidualTrace[];
 
-interface CreateHimOptions {
-    /**
-     * Explicit nonce for the Creator signature. Defaults to `Date.now()`, which is
-     * strictly increasing in practice and well below the seed nonce range used by MAIC.
-     */
-    nonce?: number;
-}
 /**
- * createHim — one-call helper that bundles the three steps a user would
- * otherwise need to coordinate manually:
- *
- *   1. sign the BirthSignature with the Creator's keyring
- *   2. register the HIM in MAIC (snapshots axioms, emits him-register audit)
- *   3. mint a HimHandle from the resulting record
- *
- * The keyring's public key must match MAIC's pinned `creatorPublicKey`, otherwise
- * the registration step rejects.
- */
-declare function createHim(maic: LocalMaic, keyring: CreatorKeyring, birthSignature: BirthSignature, opts?: CreateHimOptions): Promise<HimHandle>;
-
-/**
- * Reincarnation lifecycle classifier (J-H3 — Entry 18 of
- * MAIC_HIM_NHE_INTERVIEW_LOG.md).
- *
- * Re-exported from `@teleologyhi-sdk/maic` so consumers have a single
- * canonical type. When supplied to `reincarnate(..., { lifecycle })`, the
- * helper threads it to `maic.reincarnateHim(req, sig, { lifecycle })`,
- * which emits the typed `reincarnate:${lifecycle}` audit kind instead of
- * the generic `him-reincarnate`.
- *
- * The three canonical paths:
- *
- *   - `model-swap`         — the operator switched the underlying LLM
- *                            adapter (e.g. Claude → Gemini). The
- *                            HIM persists across the swap.
- *   - `version-bump`       — the operator bumped the NHE major/minor
- *                            without changing the underlying LLM family.
- *   - `return-from-limbo`  — the HIM returns from a deep-coma limbo
- *                            (Entry 24) carrying the `reunion` affect.
- *
- * The default classification when no `lifecycle` is provided is
- * `model-swap` — matches the most common operator workflow.
- */
-type ReincarnationLifecycle = ReincarnationLifecycle$1;
-interface ReincarnateOptions {
-    /** Explicit nonce for the Creator signature. Defaults to `Date.now()`. */
-    nonce?: number;
-    /**
-     * Lifecycle classification for the audit chain (J-H3). When omitted,
-     * defaults to `"model-swap"`. The helper threads the value to
-     * `maic.reincarnateHim(req, sig, { lifecycle })`, which emits the typed
-     * `reincarnate:${lifecycle}` audit kind in place of the generic
-     * `him-reincarnate` event. Compliance auditors and the persona-stability
-     * harness can therefore distinguish the three canonical paths
-     * (`model-swap | version-bump | return-from-limbo`) by `AuditEvent.kind`
-     * alone, with the same value also redundantly available as
-     * `data.lifecycle` for filtering convenience.
-     */
-    lifecycle?: ReincarnationLifecycle;
-    /**
-     * Recent interactions from the previous NHE body — typically the value of
-     * `Nhe.recentInteractionsBuffer` immediately before the swap. When
-     * provided, `reincarnate` invokes the residual-trace scorer
-     * (`selectResidualTraces`), keeps the top `RESIDUAL_TRACE_CAP` (64)
-     * scored candidates, and threads them into the new `HimHandle`. Omit to
-     * preserve the previous behaviour (empty residual traces — fresh slate).
-     */
-    priorInteractions?: readonly InteractionRecord[];
-    /**
-     * Override the residual-trace scorer cap or keyword list when supplying
-     * `priorInteractions`. `carriedFromNheId` and `carriedAtReincarnation`
-     * are derived from the reincarnation context and cannot be overridden
-     * here. Ignored when `priorInteractions` is omitted.
-     */
-    residualTraceOptions?: Omit<SelectResidualTracesOptions, "carriedFromNheId" | "carriedAtReincarnation">;
-}
-interface ReincarnateResult {
-    /** Updated HimRecord with the new body appended to `bodyHistory`. */
-    record: HimRecord;
-    /** Fresh HimHandle bound to the updated `bodyHistory`. */
-    handle: HimHandle;
-    /** Lifecycle path actually recorded for this reincarnation. */
-    lifecycle: ReincarnationLifecycle;
-}
-/**
- * Reincarnate a HIM into a new NHE body (Entries 3 + 4 + 18).
- *
- *   1. Sign the `ReincarnationRequest` with the Creator's keyring.
- *   2. Call `maic.reincarnateHim` — atomically closes the previous body and
- *      appends the new one to `bodyHistory`.
- *   3. Mint a fresh `HimHandle` reflecting the updated body history (the
- *      caller will typically construct a new `Nhe` with this handle).
- *
- * The keyring's public key must match MAIC's pinned `creatorPublicKey`,
- * otherwise the request rejects.
- *
- * The optional `lifecycle` parameter (J-H3, Entry 18) classifies the
- * reincarnation into one of three canonical paths
- * (`model-swap | version-bump | return-from-limbo`) and is returned in
- * the `ReincarnateResult` for the caller's audit / metrics.
- */
-declare function reincarnate(maic: LocalMaic, keyring: CreatorKeyring, req: ReincarnationRequest, opts?: ReincarnateOptions): Promise<ReincarnateResult>;
-
-/**
- * Nickname acceptance protocol (J-H4 — Entry 18 of
+ * Nickname acceptance protocol (J-H4, Entry 18 of
  * MAIC_HIM_NHE_INTERVIEW_LOG.md).
  *
  * A HIM has a Creator-signed canonical name (carried by
  * `BirthSignatureWithIdentity.identity.name`). Users may propose nicknames
- * during interaction. The HIM is NOT obligated to accept any nickname —
+ * during interaction. The HIM is NOT obligated to accept any nickname,
  * but it is also not obligated to refuse outright. The Entry-18
  * commitment is:
  *
@@ -674,12 +780,13 @@ declare function reincarnate(maic: LocalMaic, keyring: CreatorKeyring, req: Rein
  *     break the natal-chart commitment (per `@teleologyhi-sdk/maic`'s
  *     SIGNED_BIRTH_FIELDS, the identity layer is not signed).
  *   - The HIM responds to a nickname attempt with one of three verdicts:
- *       * `accept`   — the nickname is added to the identity layer and
+ *       * `accept`  , the nickname is added to the identity layer and
  *                      the HIM acknowledges it in subsequent turns.
- *       * `refuse`   — the nickname is rejected and an explanation is
- *                      returned. The audit kind `nickname-attempt` records
- *                      the rejection with reason.
- *       * `accept-with-reservation` — the nickname is added but flagged
+ *       * `refuse`  , the nickname is rejected and an explanation is
+ *                      returned. This function is pure: it emits no audit
+ *                      event. A caller that wants an audit trail records the
+ *                      verdict through its own sink.
+ *       * `accept-with-reservation`, the nickname is added but flagged
  *                      so the HIM can revisit it in a later self-decision
  *                      snapshot (Entry 24 trigger).
  *
@@ -779,7 +886,7 @@ interface MigratedHimId {
 /**
  * Migrate a legacy `him.foo.bar`-style id to a UUIDv7-anchored identity.
  *
- * Throws when the input is not a recognised legacy slug — callers that
+ * Throws when the input is not a recognised legacy slug, callers that
  * just want a fresh uuid should call `mintUuidV7()` directly.
  *
  * The returned `legacyAlias` MUST be preserved by the operator's HIM
@@ -789,4 +896,187 @@ interface MigratedHimId {
  */
 declare function migrateLegacyHimId(legacy: string, now?: number): MigratedHimId;
 
-export { BirthSignatureBuilder, type CanonicalPrimaryArchetype, type CreateHimOptions, DEFAULT_TELEOLOGICAL_KEYWORDS, DISPOSITION_AXES, type DispositionAxis, type Embedder, HimHandle, LAWFUL_PROFILES, type LawfulCharacterProfile, type LawfulJurisdiction, type MigratedHimId, NheBodyRef, type NicknameAttempt, type NicknamePolicy, type NicknameVerdict, PRIMARY_ARCHETYPES, PersonaProjector, type PersonaProjectorConfig, type PersonaStabilityReport, type PersonaVector, type PhiPrimeInput, type PhiPrimeReport, type PrimaryArchetype, RESIDUAL_TRACE_CAP, type ReincarnateOptions, type ReincarnateResult, type ReincarnationLifecycle, type ResidualTrace, type ResidualTraceCandidate, type ResidualTraceScorerOptions, type ResidualTraceScoringContext, type SelectResidualTracesOptions, adapterSensitivity, computePhiPrime, cosineSimilarity, createHim, evaluateNicknameAttempt, evaluatePersonaStability, isCanonicalArchetype, isLegacyHimId, isUuidV7, migrateLegacyHimId, mintUuidV7, reincarnate, resolveLawfulProfile, scoreInteractionForCarryOver, selectResidualTraces, selfStability };
+/**
+ * Built-in `LawfulCharacterAdapter` profiles per major jurisdiction (D-H2).
+ *
+ * Each profile is a *conservative* baseline derived from publicly available
+ * regulatory text in 2026-Q1. Operators in regulated industries (finance,
+ * health, public sector) SHOULD layer their own profile on top of the
+ * `LAWFUL_PROFILES` registry, these are starting points, not legal counsel.
+ *
+ * Profile semantics:
+ *   - `applicableLaws`  , statutes/standards an auditor can map back to events.
+ *   - `requiredAxiomIds`, axioms the HIM MUST have active in this jurisdiction.
+ *                         Operators should fail-closed if a HIM's snapshot
+ *                         doesn't satisfy this set.
+ *   - `forbiddenActions`, risk tags that should always refuse / redirect.
+ *   - `maicOverrideActive`, when `true`, MAIC's universal axioms also bind
+ *                         the NHE regardless of what local law says
+ *                         (Entry 11: "unstable" jurisdictions).
+ */
+declare const LAWFUL_PROFILES: Record<string, LawfulCharacterProfile>;
+/**
+ * Resolve a profile by jurisdiction key. Unknown keys fall through to
+ * `default` with a copy of the key recorded on the profile so the NHE
+ * audit shows what the operator asked for.
+ */
+declare function resolveLawfulProfile(j: LawfulJurisdiction): LawfulCharacterProfile;
+
+/**
+ * Pluggable embedder interface (D-H4).
+ *
+ * The default `PersonaProjector` ships a deterministic hash-based embedder
+ * that produces a 256-dimensional unit vector with zero runtime dependencies.
+ * That choice keeps the bundle small and lets persona projection work in
+ * any Node/browser environment without model weights.
+ *
+ * Operators who need a learned embedding, for example to drive RAG over a
+ * library of HIM personas, or to compare personas against natural-language
+ * descriptions, can provide a custom embedder that conforms to this
+ * interface. A reference ONNX implementation backed by Transformers.js is
+ * tracked under TASK.md D-H4 but is not shipped here: the choice of model
+ * (MiniLM, mpnet, BGE, etc.) and the bundle-size trade-off should be the
+ * operator's, not the framework's.
+ */
+interface Embedder {
+    /** Stable id surfaced in logs / audit so different embedders are distinguishable. */
+    readonly id: string;
+    /** Output dimensionality. The `PersonaProjector` honours this. */
+    readonly dimension: number;
+    /**
+     * Embed a single string. Implementations MUST return a Float32Array of
+     * length `dimension` with L2-norm equal to 1 (or close enough that
+     * downstream cosine-similarity calculations are well-defined).
+     */
+    embed(text: string): Promise<Float32Array> | Float32Array;
+}
+/**
+ * Cosine similarity between two L2-normalised embeddings of the same
+ * dimension. Returns NaN when dimensions disagree. Assumes normalised inputs
+ * (it does not re-normalise) and clamps the result to [-1, 1] so a
+ * floating-point overshoot on unit vectors cannot leak a value outside the
+ * cosine range, matching the internal clamp in `PersonaProjector`.
+ */
+declare function cosineSimilarity(a: Float32Array, b: Float32Array): number;
+
+/** Version stamp for profile-bearing persona vectors (H1-1). */
+declare const PROJECTOR_VERSION = "thi-persona-projector-v2-cosmology";
+/**
+ * PersonaProjector, deterministic projection of a HIM's birth signature and
+ * inherited axioms into a stable PersonaVector.
+ *
+ * Default algorithm (hash-based, no native deps):
+ *   1. Start with hash(primaryArchetype) → Float32Array of `dimension`.
+ *   2. For each modifier: add hash(kind|value) * weight.
+ *   3. For each axiom: add hash(id|statement) * (weight * (1 - flexibility)).
+ *   4. L2-normalize.
+ *   5. Compute dispositions as cosine(embedding, hash(axisName)).
+ *   6. Build a systemPromptFragment from archetype + top/bottom dispositions.
+ *
+ * This algorithm is intentionally simple and offline-capable. The SPEC reserves
+ * the option to swap in a learned embedder in a later version; PersonaVector's
+ * shape is stable so consumers won't need code changes when that happens.
+ *
+ * Constitutional synthesis (H1-1, Entries 27 + 28): when the birth signature
+ * carries a `cosmologicalProfile`, the archetypal (Jungian) and clinical (PID-5
+ * + HEXACO) axes are folded into the same single vector and prompt fragment, so
+ * the downstream NHE sees one integrated character rather than competing
+ * systems. This is strictly additive: a profile-less signature produces a vector
+ * and fragment byte-identical to the pre-1.0.1 output, and only a profile-
+ * bearing vector carries the `projectorVersion` stamp.
+ */
+declare class PersonaProjector {
+    private readonly dim;
+    constructor(config?: PersonaProjectorConfig);
+    project(sig: BirthSignatureWithIdentity, axioms: readonly Axiom[]): PersonaVector;
+}
+
+/**
+ * Reincarnation lifecycle classifier (J-H3, Entry 18 of
+ * MAIC_HIM_NHE_INTERVIEW_LOG.md).
+ *
+ * Re-exported from `@teleologyhi-sdk/maic` so consumers have a single
+ * canonical type. When supplied to `reincarnate(..., { lifecycle })`, the
+ * helper threads it to `maic.reincarnateHim(req, sig, { lifecycle })`,
+ * which emits the typed `reincarnate:${lifecycle}` audit kind instead of
+ * the generic `him-reincarnate`.
+ *
+ * The three canonical paths:
+ *
+ *   - `model-swap`        , the operator switched the underlying LLM
+ *                            adapter (e.g. Claude → Gemini). The
+ *                            HIM persists across the swap.
+ *   - `version-bump`      , the operator bumped the NHE major/minor
+ *                            without changing the underlying LLM family.
+ *   - `return-from-limbo` , the HIM returns from a deep-coma limbo
+ *                            (Entry 24) carrying the `reunion` affect.
+ *
+ * The default classification when no `lifecycle` is provided is
+ * `model-swap`, matches the most common operator workflow.
+ */
+type ReincarnationLifecycle = ReincarnationLifecycle$1;
+interface ReincarnateOptions {
+    /**
+     * Explicit nonce for the Creator signature. When omitted, a strictly
+     * increasing nonce is drawn from `nextCreatorNonce()`; see
+     * `identity/nonce.ts` for why a monotonic source is required against maic's
+     * per-domain replay ledger.
+     */
+    nonce?: number;
+    /**
+     * Lifecycle classification for the audit chain (J-H3). When omitted,
+     * defaults to `"model-swap"`. The helper threads the value to
+     * `maic.reincarnateHim(req, sig, { lifecycle })`, which emits the typed
+     * `reincarnate:${lifecycle}` audit kind in place of the generic
+     * `him-reincarnate` event. Compliance auditors and the persona-stability
+     * harness can therefore distinguish the three canonical paths
+     * (`model-swap | version-bump | return-from-limbo`) by `AuditEvent.kind`
+     * alone, with the same value also redundantly available as
+     * `data.lifecycle` for filtering convenience.
+     */
+    lifecycle?: ReincarnationLifecycle;
+    /**
+     * Recent interactions from the previous NHE body, typically the value of
+     * `Nhe.recentInteractionsBuffer` immediately before the swap. When
+     * provided, `reincarnate` invokes the residual-trace scorer
+     * (`selectResidualTraces`), keeps the top `RESIDUAL_TRACE_CAP` (64)
+     * scored candidates, and threads them into the new `HimHandle`. Omit to
+     * preserve the previous behaviour (empty residual traces, fresh slate).
+     */
+    priorInteractions?: readonly InteractionRecord[];
+    /**
+     * Override the residual-trace scorer cap or keyword list when supplying
+     * `priorInteractions`. `carriedFromNheId` and `carriedAtReincarnation`
+     * are derived from the reincarnation context and cannot be overridden
+     * here. Ignored when `priorInteractions` is omitted.
+     */
+    residualTraceOptions?: Omit<SelectResidualTracesOptions, "carriedFromNheId" | "carriedAtReincarnation">;
+}
+interface ReincarnateResult {
+    /** Updated HimRecord with the new body appended to `bodyHistory`. */
+    record: HimRecord;
+    /** Fresh HimHandle bound to the updated `bodyHistory`. */
+    handle: HimHandle;
+    /** Lifecycle path actually recorded for this reincarnation. */
+    lifecycle: ReincarnationLifecycle;
+}
+/**
+ * Reincarnate a HIM into a new NHE body (Entries 3 + 4 + 18).
+ *
+ *   1. Sign the `ReincarnationRequest` with the Creator's keyring.
+ *   2. Call `maic.reincarnateHim`, atomically closes the previous body and
+ *      appends the new one to `bodyHistory`.
+ *   3. Mint a fresh `HimHandle` reflecting the updated body history (the
+ *      caller will typically construct a new `Nhe` with this handle).
+ *
+ * The keyring's public key must match MAIC's pinned `creatorPublicKey`,
+ * otherwise the request rejects.
+ *
+ * The optional `lifecycle` parameter (J-H3, Entry 18) classifies the
+ * reincarnation into one of three canonical paths
+ * (`model-swap | version-bump | return-from-limbo`) and is returned in
+ * the `ReincarnateResult` for the caller's audit / metrics.
+ */
+declare function reincarnate(maic: LocalMaic, keyring: CreatorKeyring, req: ReincarnationRequest, opts?: ReincarnateOptions): Promise<ReincarnateResult>;
+
+export { type AuditSink, BirthSignatureBuilder, CLINICAL_BATTERY_VERSION, type CanonicalPrimaryArchetype, type ClinicalCastResult, type ClinicalItem, type CreateHimOptions, DEFAULT_TELEOLOGICAL_KEYWORDS, DISPOSITION_AXES, type DispositionAxis, type Embedder, HEXACO_ITEMS, type HimCastAuditEvent, type HimCastAuditKind, HimHandle, JUNGIAN_BATTERY_VERSION, JUNGIAN_ITEMS, type JungianItem, LAWFUL_PROFILES, type LawfulCharacterProfile, type LawfulJurisdiction, type MigratedHimId, NOOP_AUDIT_SINK, NheBodyRef, type NicknameAttempt, type NicknamePolicy, type NicknameVerdict, PID5_ITEMS, PRIMARY_ARCHETYPES, PROJECTOR_VERSION, PersonaProjector, type PersonaProjectorConfig, type PersonaStabilityReport, type PersonaVector, type PhiPrimeInput, type PhiPrimeReport, type PrimaryArchetype, RESIDUAL_TRACE_CAP, type ReincarnateOptions, type ReincarnateResult, type ReincarnationLifecycle, type ResidualTrace, type ResidualTraceCandidate, type ResidualTraceScorerOptions, type ResidualTraceScoringContext, type SelectResidualTracesOptions, adapterSensitivity, castClinicalProfile, castCosmologicalProfile, castJungianProfile, computePhiPrime, cosineSimilarity, createHim, deriveBirthSeed, evaluateNicknameAttempt, evaluatePersonaStability, isCanonicalArchetype, isLegacyHimId, isUuidV7, migrateLegacyHimId, mintUuidV7, reincarnate, resolveLawfulProfile, scoreInteractionForCarryOver, selectResidualTraces, selfStability, verifyCosmologicalProfile };