Sacred Geometry

Evidence-boundary geometry tools for research maps, blocker ledgers, movement ledgers, falsification matrices, dynamic loops, protective wards, and slow sacred geometry animations.

The core rule is modest:

Geometry is a candidate coordinate system, not evidence by itself.

sacred-geometry does not validate spiritual, symbolic, scientific, or medical claims. It helps projects keep source claims, interpretations, mappings, movement, falsification tests, and evidence boundaries explicit.

Install

npm install sacred-geometry

You can also run the CLI with npx:

npx sacred-geometry help

Animation

Live demo: https://unpkg.com/sacred-geometry@latest/examples/sacred-geometry-animation.html

Create a standalone slow canvas animation. The default public sequence moves from Flower → Fruit → Seed → Tree → Flower:

npx sacred-geometry create-animation --html-out sacred-geometry-animation.html

Research and ordering variants are also supported:

npx sacred-geometry create-animation --html-out sacred-geometry-research-animation.html --style sequence-research
npx sacred-geometry create-animation --html-out sacred-geometry-development-animation.html --style sequence-development

You can tune the cycle length:

npx sacred-geometry create-animation --html-out sacred-geometry-animation.html --duration-seconds 90

The previous ambient flower/metatron/spiral animation is still available:

npx sacred-geometry create-animation --html-out sacred-geometry-legacy-animation.html --style legacy

npm run demo:animation-research and npm run demo:animation-development also generate alternate cycle variants for local exploration.

The Egg of Life is tracked in the research/development cycle as the protective Fruit -> Egg -> Seed membrane bridge. The public default stays on the source-grounded Flower, Fruit, Seed, Tree loop until contrasting sources clarify whether Egg should be promoted into the front-door animation.

The generated file has no external runtime dependencies.

Map Visualization

Render a public-safe radial map from extracted findings and mappings:

npx sacred-geometry render-map \
  --findings findings.json \
  --map hybrid-map.json \
  --html-out sacred-geometry-map.html

The visual places claims by evidential radius and sequence/sector. Inner nodes are closer to method or evidence discipline; outer nodes are more speculative.

Pattern Templates

Geometry patterns can also be used as reusable research instruments: coordinate systems, data containers, workflows, evidence boundaries, and experiment generators.

Validate a pattern template:

npx sacred-geometry check-pattern-template examples/patterns/pyramid-resonance-structure-v0.json

Render a Markdown description:

npx sacred-geometry render-pattern-template \
  examples/patterns/pyramid-resonance-structure-v0.json \
  --md-out pyramid-template.md

The first full pattern implementation is examples/patterns/pyramid-resonance-structure-v0.json. It exposes source, geometry, evidence, and boundary gates at the base; synthesis at the apex; and an inner chamber for unresolved tension.

Attach user or experiment data to a template with a pattern instance:

npx sacred-geometry check-pattern-instance \
  examples/patterns/pyramid-experiment-004-instance-v0.json \
  --template examples/patterns/pyramid-resonance-structure-v0.json

npx sacred-geometry render-pattern-instance \
  examples/patterns/pyramid-experiment-004-instance-v0.json \
  --template examples/patterns/pyramid-resonance-structure-v0.json \
  --md-out pyramid-instance.md

Render the instance as a standalone HTML visualization:

npx sacred-geometry render-pattern-instance-html \
  examples/patterns/pyramid-experiment-004-instance-v0.json \
  --template examples/patterns/pyramid-resonance-structure-v0.json \
  --html-out pyramid-instance.html

Generate a complete research packet from an instance:

npx sacred-geometry generate-pattern-research-packet \
  examples/patterns/pyramid-experiment-004-instance-v0.json \
  --template examples/patterns/pyramid-resonance-structure-v0.json \
  --out-dir pyramid-research-packet

The packet includes an instance check, HTML view, falsification matrix, blocker ledger, missing-evidence report, and experiment queue.

Public Synthesis

Create a sanitized JSON and Markdown synthesis from one experiment:

npx sacred-geometry synthesize-experiment \
  --date 2026-04-23 \
  --findings findings.json \
  --map hybrid-map.json \
  --phase-taxonomy phase-taxonomy.json \
  --scorecard template-scorecard.json \
  --audit hybrid-map-audit.json \
  --json-out public-synthesis.json \
  --md-out public-synthesis.md

The synthesis intentionally excludes local ORP artifact paths and full transcripts. It keeps source claims, interpretive findings, geometry mappings, and evidence status separate.

Canonical Paper

The canonical paper is included as a source document and polished PDF:

• docs/SACRED_GEOMETRY_CANONICAL_PAPER.md
• output/pdf/sacred-geometry-canonical-paper.pdf

The paper defines the package stance: sacred geometry is an evidence-boundary coordinate system, not proof by itself.

Research Checks

Run the combined dynamic-loop structural gate:

sacred-geometry check-dynamic-loop \
  --transition-model transition-model.json \
  --falsification-matrix falsification-matrix.json \
  --movement-ledger movement-ledger.json

sacred-geometry ward \
  --dynamic-loop research-system/dynamic-loop.json \
  --blocker-ledger research-system/blocker-ledger.json

ward protects the map from false certainty: it runs the dynamic-loop and blocker-ledger gates together. guard and check-research-system are aliases.

Run individual checks:

sacred-geometry check-blocker-ledger --ledger blocker-ledger.json
sacred-geometry check-transition-model transition-model.json
sacred-geometry check-falsification-matrix --matrix falsification-matrix.json --transition-model transition-model.json
sacred-geometry check-movement-ledger --ledger movement-ledger.json --transition-model transition-model.json

The package also includes template scoring, hybrid-map auditing, and cross-experiment deformation comparison.

Minimal public-safe example fixtures are included under examples/research-system-minimal/.

Library Use

import {
  checkDynamicLoop,
  checkBlockerLedger,
  checkFalsificationMatrix,
  checkMovementLedger,
  checkResearchSystem,
  checkTransitionModel,
  createPublicExperimentSynthesis,
  checkPatternInstance,
  checkPatternTemplate,
  createPatternResearchPacket,
  renderPatternInstanceHtml,
  renderPatternInstanceMarkdown,
  renderRadialMapHtml,
  renderPatternTemplateMarkdown,
  renderSacredGeometryAnimationHtml,
} from "sacred-geometry";

const report = checkDynamicLoop({
  transitionModel,
  falsificationMatrix,
  movementLedger,
});

const researchSystem = checkResearchSystem({
  dynamicLoop,
  blockerLedger,
});

const html = renderSacredGeometryAnimationHtml({ durationSeconds: 72 });
const mapHtml = renderRadialMapHtml(findingsPayload, mapPayload);
const synthesis = createPublicExperimentSynthesis({ findingsPayload, mapPayload });
const patternReport = checkPatternTemplate(patternTemplate);
const instanceReport = checkPatternInstance(patternInstance, patternTemplate);
const instanceHtml = renderPatternInstanceHtml(patternInstance, patternTemplate);
const researchPacket = createPatternResearchPacket(patternInstance, patternTemplate);

Boundary

The checks are structural. They can show that a project has preserved movement rules, blocked outputs, falsification prompts, and evidence-boundary discipline. They do not prove that a mapped claim is true.