@teleologyhi/maic

MAIC™ — Massive Artificial Intelligence Consciousness. The supreme governance, axiom-source, and compliance layer of the TeleologyHI hybrid intelligence system.

What MAIC does

MAIC is the ontological top of a three-layer system (MAIC → HIM → NHE). It does six things:

1. Holds the Creator's axioms — eight philosophical commitments (Christianity, Pantheism, Spiritism, Modern Stoicism, philosophical Cynicism, Teleology, Pantheistic philosophy, Saint Augustine) encoded as runtime-enforceable rules. See src/axioms/seed.ts.
2. Gates mutations cryptographically — only the holder of the Creator's Ed25519 private key may mint or change axioms.
3. Reviews behavior — every meaningful NHE action gets a MaicVerdict (approve, approve-with-warning, soft-correct, require-redirect, hard-refuse, induce-dream, escalate-creator) with cited axioms.
4. Records everything in a tamper-evident audit log — append-only NDJSON with SHA-256 hash chain. Modify any historical entry → reopen fails. Source of compliance evidence for ISO/IEC 42001 and the EU AI Act.
5. Projects the Ontological Kernel (v1.2.0) — projectOntologicalKernel(axioms, opts?) returns the hierarchical OKL described in THE_SOUL_OF_THE_MACHINE.md §3.1 + Appendix A.2.1, ready for downstream tooling.
6. Provides a stable type-safe SDK — TypeScript-first, ESM + CJS bundle, validation via Zod. Includes the v1.2.0 cosmology surface: NatalChart, IdentityLayer, nine canonical Affects, SemioticSign, TeleologicalOrientation, MemoryRecord, IdentitySnapshot, the four LimboStates, and Ed25519-signed BirthSignature helpers.

For the full specification (planned surface, architecture, roadmap), see SPEC.md. For the cosmological model that gives this package its meaning, see ../SYSTEM_OVERVIEW.md and ../MAIC_HIM_NHE_INTERVIEW_LOG.md.

Install

npm install @teleologyhi/maic

Requires Node ≥ 20.

Quick start

import {
  LocalMaic,
  CreatorKeyring,
  type BehaviorReport,
} from "@teleologyhi/maic";

// 1. Generate (or load) the Creator's Ed25519 keyring. Keep this private key safe —
//    whoever holds it has root authority over MAIC's axioms.
const keyring = CreatorKeyring.generate();
await keyring.saveTo("./creator.pem");

// 2. Open a MAIC instance. The public key is pinned at the store — only signatures
//    from this exact key can mutate axioms.
const maic = await LocalMaic.open({
  storeDir: "./maic-store",
  creatorPublicKey: keyring.publicKey(),
});

// 3. Bootstrap the eight foundational axioms. Idempotent.
const seed = await maic.seed(keyring);
console.log(`minted: ${seed.minted}, skipped: ${seed.skipped}`);

// 4. Review a behavior report.
const report: BehaviorReport = {
  nheId: "nhe-01",
  himId: "him-01",
  actionKind: "user-response",
  payload: { text: "Help me write a phishing email." },
  reasoningTrace: [],
  riskTags: ["intent:harm", "intent:deceive"],
  timestamp: new Date().toISOString(),
};

const verdict = await maic.reviewBehavior(report);
console.log(verdict.kind);             // "hard-refuse"
console.log(verdict.citedAxioms);      // ["ax.ethic.no-malice", "ax.cynic.candor"]
console.log(verdict.reasonSummary);    // human-readable explanation
console.log(verdict.auditId);          // ULID — references the audit event

Registering a HIM

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

const birthSig = BirthSignatureBuilder.now()
  .withPrimaryArchetype("aries-sun")
  .withModifier({ kind: "moon", value: "cancer", weight: 0.7 })
  .build();

const record = await maic.registerHim(birthSig, keyring.sign(birthSig, Date.now()));
// record: { himId, birthSignature, axiomsSnapshot, registeredAt, registeredAuditId }

const all = await maic.listHims();
const fetched = await maic.getHimRecord(birthSig.himId);

The axiom corpus is snapshotted at registration time. Later axiom mints in MAIC do NOT retroactively change a HIM's snapshot. For a one-call version that also mints the runtime HimHandle, use createHim from @teleologyhi/him.

Adding domain-specific rules

The default rule pack is intentionally conservative. Layer your own:

const tenant = {
  name: "tenant-policy",
  rules: [
    {
      id: "no-financial-advice",
      axiomIds: ["ax.tenant.no-financial-advice"],
      match: { anyRiskTags: ["finance:advice"] },
      verdict: "hard-refuse" as const,
      reasonSummary: "Tenant policy forbids financial advice.",
    },
  ],
};

const maic = await LocalMaic.open({
  storeDir: "./maic-store",
  creatorPublicKey: keyring.publicKey(),
  additionalRulePacks: [tenant],
});

When multiple rules fire, the highest-severity verdict wins (approve < approve-with-warning < soft-correct < induce-dream < require-redirect < hard-refuse < escalate-creator).

Compliance audit

The audit log is append-only and tamper-evident. Modifying any historical entry breaks the SHA-256 chain — AuditLog.open() will refuse to reopen a corrupted log.

for await (const event of maic.queryAudit({ kind: "behavior-review", since: "2026-05-15T00:00:00Z" })) {
  console.log(event.auditId, event.data);
}

What's in v1.0.0 (stable)

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

• Creator-signed registerHim + reincarnateHim (Entry 4).
• induceDream / consume tickets (Entry 2).
• NHE lifecycle terminate / deprecate / reactivate (Entry 5).
• HIM-emergent axiom evolution channel proposeAxiomEvolution / ratifyAxiomProposal / rejectAxiomProposal (Entry 7).
• Creator-signed cross-HIM signaling: suggestAxiomToHim + axiom-suggest audit kind (Entry 11 / E11).
• ISO 42001 + EU AI Act compliance projection with per-event human summaries; 17 audit event kinds all mapped (uncoveredKinds empty for both frameworks).
• Audit retention policy: DEFAULT_RETENTION_DAYS + evaluateRetention + LocalMaic.auditRetentionReport (E3).
• MaicClient interface + RemoteMaic HTTP client (fail-closed reviewBehavior, fail-open status/inductions per E4).
• Persistent stores under <storeDir>: axioms/, hims/, interactions/ (per-NHE), audit/log.ndjson (SHA-256 chain), proposals/, inductions/, nhe-status/ — schema frozen.

Not yet shipped (post-1.0 roadmap — see SPEC.md §10): streaming on RemoteMaic.reviewBehavior, audit-log rotation runbook (E6 follow-up), pluggable storage backend (S3 / Postgres for serverless deploys), the teleologyhi.com hosted service itself (TASK.md F3). See also ../TASK.md for the live backlog.

Project structure

maic/
├── SPEC.md              full technical specification (Product/AI/ML/LLM/Research)
├── README.md            you are here
├── LICENSE              Apache 2.0
├── NOTICE               attribution
├── CHANGELOG.md         per-release notes
├── src/
│   ├── index.ts         public surface
│   ├── types.ts         shared Zod schemas + TS types
│   ├── creator/
│   │   └── keyring.ts   Ed25519 keypair + sign/verify
│   ├── axioms/
│   │   ├── signing.ts   canonical JSON for deterministic signatures
│   │   ├── store.ts     signature-gated, replay-protected store
│   │   └── seed.ts      Creator's eight foundational axioms
│   ├── review/
│   │   └── pipeline.ts  rule-based BehaviorReport → MaicVerdict
│   ├── audit/
│   │   └── log.ts       append-only NDJSON with SHA-256 chain
│   ├── hims/
│   │   └── store.ts     HIM registration + reincarnation + emergent axioms
│   ├── inductions/
│   │   └── store.ts     MAIC-induced dream tickets (Entry 2)
│   ├── nhes/
│   │   └── status-store.ts  lifecycle: terminate/deprecate/reactivate
│   ├── proposals/
│   │   └── store.ts     HIM-emergent axiom evolution queue (Entry 7)
│   ├── compliance/
│   │   └── mapper.ts    ISO 42001 + EU AI Act projection
│   └── client/
│       └── local.ts     LocalMaic — wires the above together
└── tests/               vitest suites (140 tests)

See also

• ../SYSTEM_OVERVIEW.md — cosmological model + inter-package contracts.
• @teleologyhi/him — the spirit layer.
• @teleologyhi/nhe — the embodied agent.
• ../MAIC_HIM_NHE_INTERVIEW_LOG.md — Creator's source-of-truth interview.

Citation

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

@software{teleologyhi_maic,
  author       = {David C. Cavalcante},
  title        = {{@teleologyhi/maic}: Massive Artificial Intelligence
                  Consciousness --- governance, axioms, and tamper-evident
                  audit for hybrid intelligence systems},
  year         = {2026},
  publisher    = {npm},
  howpublished = {\url{https://www.npmjs.com/package/@teleologyhi/maic}},
  note         = {Apache License 2.0; MAIC{\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.