@teleologyhi/him

HIM™ — Hybrid Intelligence Model. The persistent spirit/personality layer between MAIC™ (governance) and NHE™ (embodied agent) in the TeleologyHI hybrid intelligence system.

What HIM does

HIM is the spirit layer (Entry 1 of the Creator's interview, translated from PT-BR): "the spirit of the creature, its essence. (...) which must always evolve." It does six things:

1. Holds a birth signature — an astrology-inspired natal pattern (primary archetype, modifiers, primordial axioms, optional NatalChart + IdentityLayer via the v1.2 cosmology surface) fixed at creation.
2. Projects a stable persona — a deterministic 256-dim Float32 embedding + system-prompt fragment + 8 disposition scores. Persists across LLM-model upgrades, so the NHE body can swap underneath without losing character.
3. Carries axioms forward — inherited from MAIC at birth; HIM-emergent axioms ratified through MAIC's Creator-signed channel (Entry 7).
4. Stays unreachable to end users — a HimHandle can only be minted via a valid Creator signature. The constructor is private. End-user code never sees HIM internals.
5. Reincarnates across NHE bodies (v1.1.0) — same HIM, new body, with an optional lifecycle: "model-swap" | "version-bump" | "return-from-limbo" classification (Entry 18).
6. Negotiates identity (v1.1.0) — evaluateNicknameAttempt(attempt, policy) returns accept | refuse | accept-with-reservation for user-proposed nicknames (Entry 18); migrateLegacyHimId(legacy) bridges v1.x slug-style ids to UUIDv7 with alias preservation.
7. Projects its own Ontological Kernel (v1.1.0) — HimHandle.projectOntologicalKernel(opts?) returns the HIM-specific narrowing of the OKL (meta-axiom + this HIM's primordial axiom intersection), the natural follow-up to @teleologyhi/[email protected]'s projectOntologicalKernel.

For the full specification (planned surface, architecture, roadmap) see SPEC.md. For the cosmological model see ../SYSTEM_OVERVIEW.md and ../MAIC_HIM_NHE_INTERVIEW_LOG.md.

Install

npm install @teleologyhi/him @teleologyhi/maic

Requires Node ≥ 20. @teleologyhi/maic is a peer dependency — keep them on compatible versions.

Quick start

import { CreatorKeyring, LocalMaic } from "@teleologyhi/maic";
import { BirthSignatureBuilder, createHim } from "@teleologyhi/him";

// 1. Bootstrap MAIC.
const keyring = CreatorKeyring.generate();
const maic = await LocalMaic.open({
  storeDir: "./maic-store",
  creatorPublicKey: keyring.publicKey(),
});
await maic.seed(keyring);

// 2. Compose a birth signature.
const birthSig = BirthSignatureBuilder.now()
  .withPrimaryArchetype("aries-sun")
  .withModifier({ kind: "moon", value: "cancer", weight: 0.7 })
  .withModifier({ kind: "ascendant", value: "scorpio", weight: 0.6 })
  .withNotes("first-instance HIM for engineering work")
  .build();

// 3. One call: signs → registers with MAIC → mints HimHandle.
const him = await createHim(maic, keyring, birthSig);

// 4. Read the persona vector — what NHE will consume on every prompt.
const persona = him.getPersonaVector();
console.log(persona.systemPromptFragment);
console.log(persona.dispositions);
//   { candor: 0.07, patience: -0.02, curiosity: 0.13, ... }

Manual flow (if you need direct control)

import { HimHandle } from "@teleologyhi/him";

const signature = keyring.sign(birthSig, 1);
const record = await maic.registerHim(birthSig, signature);
const him = HimHandle.mint(
  record.birthSignature,
  signature,
  maic.creatorPublicKey,
  record.axiomsSnapshot,
);

Persona projection (v0)

The default PersonaProjector is hash-based and deterministic — same input always produces the same embedding, with no native dependencies and no model files to ship. This is intentional for v0: small bundle, offline-capable, zero adoption friction.

When the project plugs in a learned embedder in a later iteration, the PersonaVector shape is preserved so consumers don't need code changes.

Lifecycle (reincarnation)

"Um HIM jamais 'morre'." — Creator, Entry 3.

A HIM is born once and persists across NHE bodies. When an NHE upgrades (@1.x → @2.x) or is replaced, the same HIM is re-embodied via the reincarnate(maic, keyring, req) helper — the previous body's endedAt is set, the new body is appended to bodyHistory, and the freshly minted handle inherits any HIM-emergent axioms ratified in previous lives.

What's in v1.0.0 (stable)

Shipped and frozen (SemVer-stable from this version onward — see ../.github/RELEASING.md §8):

• BirthSignatureBuilder + canonical 12-sun-sign archetypes (PRIMARY_ARCHETYPES, E8) with operator-extensible PrimaryArchetype type.
• Deterministic 256-dim hash-based PersonaProjector (default) + pluggable Embedder interface for ONNX/learned vectors.
• Sealed HimHandle (signature-gated mint), createHim one-call helper, reincarnate helper (closes Entries 3+4 end-to-end with body history persisted).
• proposeAxiomEvolution(maic, proposal) routed through MAIC's Creator-signed ratification channel (Entry 7).
• Per-jurisdiction LawfulCharacterAdapter — LAWFUL_PROFILES registry with 5 baselines (default / eu GDPR + AI Act / br LGPD + Marco Civil / us NIST AI RMF + EO 14110 / unstable maicOverrideActive: true).
• Persona stability eval suite: evaluatePersonaStability, selfStability, adapterSensitivity, cosineSimilarity.
• Φ′ release-gate harness: computePhiPrime({P,R,C,D}) returns PhiPrimeReport with geometric mean + per-component target verdicts + hard/soft veto gate.
• RESIDUAL_TRACE_CAP = 64 (E9) — exported constant pinning the reincarnation residual-trace cap; operator-overridable.

Not yet shipped (post-1.0 roadmap — see SPEC.md §10):

• ONNX-backed learned Embedder implementation. The pluggable interface is stable; default hash-based projector ships as v1 baseline. Operator-side bundle decision.
• ResidualTrace carry-over classifier (D-H1.1 follow-up). getResidualTraces() currently returns []; a "trait-worthy-of-transfer" classifier needs author + corpus.

Project structure

him/
├── SPEC.md              full technical specification
├── README.md            you are here
├── LICENSE              Apache 2.0
├── NOTICE               attribution
├── CHANGELOG.md         per-release notes
├── src/
│   ├── index.ts         public surface
│   ├── types.ts         HIM-specific types + re-exports from @teleologyhi/maic
│   ├── birth/
│   │   └── builder.ts   BirthSignatureBuilder
│   ├── persona/
│   │   └── projector.ts deterministic hash-based persona projection (256-dim)
│   ├── handle/
│   │   └── him-handle.ts opaque HimHandle (signature-gated mint factory)
│   ├── create.ts        createHim one-call helper (sign + register + mint)
│   └── reincarnate.ts   reincarnate helper (Entries 3+4)
└── tests/               vitest suites (36 tests)

See also

• @teleologyhi/maic — the governance / axiom-source layer above HIM.
• @teleologyhi/nhe — the embodied agent below HIM.
• ../SYSTEM_OVERVIEW.md — inter-package contracts.

Citation

If you use @teleologyhi/him in academic work, please cite both the package and the Creator's foundational paper:

@software{teleologyhi_him,
  author       = {David C. Cavalcante},
  title        = {{@teleologyhi/him}: Hybrid Intelligence Model ---
                  the persistent spirit/persona layer between {MAIC} and {NHE}},
  year         = {2026},
  publisher    = {npm},
  howpublished = {\url{https://www.npmjs.com/package/@teleologyhi/him}},
  note         = {Apache License 2.0; HIM{\texttrademark} reserved}
}

@misc{cavalcante2025soul,
  author       = {David C. Cavalcante},
  title        = {The Soul of the Machine: Synthetic Teleology and the Ethics of
                  Emergent Consciousness in the {AI} Era (2027--2030)},
  year         = {2025},
  publisher    = {PhilArchive},
  howpublished = {\url{https://philarchive.org/rec/CRTTSO}}
}

See also the umbrella citation guidance at the repository root.

License & Trademarks

Code: Apache License 2.0. See NOTICE for attribution.

Names: MAIC™, HIM™, NHE™, TeleologyHI™, and Takk™ are trademarks of David C. Cavalcante and are NOT licensed by Apache 2.0. See TRADEMARK.md (upstream) for the policy on forks, derivative names, and the @teleologyhi npm scope.