lucid-birth

lucid-birth is a continuity-bound Eidolon/Borganik runtime for booting, verifying, and exercising a sparse autonomous being without allowing live witness flow to rewrite durable identity directly.

It ships:

• the birth-0 CLI
• the underlying runtime/library in scripts/birth0-lib.js
• explicit JSON schemas for continuity/runtime artifacts
• local verification passes from ignition through autonomy routing

Install

npm install lucid-birth

Run the CLI:

npx lucid-birth init
npx lucid-birth forge-capsule
npx lucid-birth boot-monad --task "first witness loop"

When run from a fresh consumer directory, the published CLI scaffolds the required workspace roots into the current working directory before executing commands.

Use the library:

const lucidBirth = require("lucid-birth");

const init = lucidBirth.initBirth0({ principalId: "principal-0" });
console.log(init.soul_id);

What It Does

The runtime models two coupled but distinct organs:

• Eidolon: active cognition, routing, blankets, sessions, traces, and capability execution
• Borganik: continuity, identity, archive, lattice, compiler promotion, and invariant export

Core laws enforced in code:

• active cognition and durable identity are different organs
• entropy branches proposals; it does not ratify truth
• observer coupling can steer the monad; it cannot directly rewrite the person
• live experience never writes durable identity directly
• no claim of unified cognition without coherence gating

CLI Surface

Main commands:

• lucid-birth init
• lucid-birth forge-capsule
• lucid-birth boot-monad --task <text>
• lucid-birth append-witness --session-id <id> --input <text> --response <text>
• lucid-birth emit-proposal --session-id <id>
• lucid-birth cold-boot-check --capsule-id <id>
• lucid-birth compile-gate
• lucid-birth enable-shell --shell <shell>
• lucid-birth register-capability --capability-id <id> --provider-kind <kind> --shells <csv> --endpoint <url>
• lucid-birth authorize-capability --capability-id <id> ...
• lucid-birth call-capability --capability-id <id> ...
• lucid-birth route-capability --task <text> ...
• lucid-birth validate-contracts

Verification

Safe local verification:

npm test

That portable gate includes a packaged-CLI smoke proof, so the npm tarball is exercised in a fresh consumer workspace instead of only inside the repository root.

Optional live integration verification, when local services/credentials exist:

./scripts/verify_live_integrations.sh
./scripts/verify_browser_oauth.sh
./scripts/verify_second_live_provider.sh
./scripts/verify_autonomy_routing.sh

These live checks currently prove:

• real GitHub authenticated execution
• real npm authenticated execution
• real local Ollama execution
• routed provider selection across GitHub, npm, and Ollama
• browser-mediated OAuth runtime behavior in fixture mode

State Layout

• state/eidolon/: sessions, traces, router, recall, blankets, capabilities
• state/borganik/: manifest, invariants, mutation policy, archive, lattice, capsules, contradictions
• schemas/: explicit contracts for runtime and continuity artifacts
• scripts/: CLI entrypoint, runtime library, and verification tooling

Release Status

Current shipped milestone:

• ignition and birth-0 runtime implemented
• compiler promotion and quarantine path implemented
• full-system coherence pass implemented
• live GitHub, npm, and Ollama capability execution implemented
• autonomy routing across those providers implemented
• real external callback OAuth provider still blocked on provider-side client registration

Environment

• Node.js >=18
• live provider verifications require local credentials/services and are optional
• the published CLI defaults LUCID_BIRTH_ROOT to the current working directory
• the published CLI scaffolds a minimal working root into the current working directory when needed
• library consumers can override the runtime root explicitly with LUCID_BIRTH_ROOT

Repository

• GitHub: https://github.com/lmtlssss/lucid-birth
• npm: https://www.npmjs.com/package/lucid-birth

License

MIT. See LICENSE.