How zgdsaid1/emora works
HYBRID EMOTIONAL ENGINE is a Next.js product API and a framework-independent emotional-modeling core, with a separate evaluation package. The primary workflow authenticates a user, scopes requests to a project/profile, accepts a transition, computes a deterministic next state, and persists it for later retrieval. Other documented capabilities include workspace bootstrap, project/profile discovery and creation, transition history, and evaluation methodologies. Several evaluation and UI paths are present in the tree but were not sampled; their internal wiring is therefore omitted.
Main entry points: tables.ts PostgreSQL Persistence · route.ts Transition API · service.ts Transition Processing · calculate-next-state.ts Deterministic Dynamics
Components 21
Product API
- Workspace Bootstrap
apps/web/server/bootstrap/service.ts - Project Discovery
apps/web/server/profiles/service.ts - Profile Management
apps/web/server/profiles/service.ts - Transition API
apps/web/app/api/v1/projects/[projectId]/profiles/[profileId]/transitions/route.ts - Transition Processing
apps/web/server/transitions/service.ts - Latest State
apps/web/server/states/service.ts - State History
apps/web/server/states/history/service.ts - Transition History
apps/web/server/transitions/history/service.ts
Access and Persistence
- Authentication and Authorization
packages/auth/src/authorization.ts - PostgreSQL Persistence
packages/database/src/schema/tables.ts
Emotional Model
- Domain Mapping
apps/web/server/transitions/domain-mapping.ts - Deterministic Dynamics
packages/emotional-core/src/dynamics/calculate-next-state.ts - Emotional Domain Types
packages/emotional-core/src/domain/emotional-state.ts - Model Parameters
packages/emotional-core/src/parameters/model-parameters.ts - Emotion Vectors
packages/emotional-core/src/domain/emotion-vector.ts
Evaluation
- Evaluation Contracts
packages/emora-evaluation/src/contracts.ts - D09 Evaluation
packages/emora-evaluation/src/d09/contracts.ts - D10 Thresholds
packages/emora-evaluation/src/d10/threshold.ts - D11 Methodology
packages/emora-evaluation/src/d11/methodology.ts - Human Methodology
packages/emora-evaluation/src/human-methodology/contracts.ts
Other components
- User
Connections 28
- User → Workspace Bootstrap: bootstraps workspace
- User → Project Discovery: discovers projects
- User → Profile Management: manages profiles
- User → Transition API: submits transition
apps/web/app/api/v1/projects/[projectId]/profiles/[profileId]/transitions/route.ts - Transition API → Transition Processing: runs transition
apps/web/app/api/v1/projects/[projectId]/profiles/[profileId]/transitions/route.ts - Transition API → Transition History: reads history
apps/web/app/api/v1/projects/[projectId]/profiles/[profileId]/transitions/route.ts - User → Latest State: requests latest state
- User → State History: requests history
- Transition API → Authentication and Authorization: authenticates request
apps/web/app/api/v1/projects/[projectId]/profiles/[profileId]/transitions/route.ts - Workspace Bootstrap → PostgreSQL Persistence: persists workspace
apps/web/server/bootstrap/service.ts - Profile Management → PostgreSQL Persistence: reads and writes
apps/web/server/profiles/service.ts - Profile Management → Emotional Domain Types: creates profile
apps/web/server/profiles/service.ts - Transition Processing → PostgreSQL Persistence: reads and writes
apps/web/server/transitions/service.ts - Transition Processing → Deterministic Dynamics: uses model core
apps/web/server/transitions/service.ts - Transition Processing → Domain Mapping: maps state
apps/web/server/transitions/service.ts - Latest State → PostgreSQL Persistence: reads state
apps/web/server/states/service.ts - Latest State → Domain Mapping: maps stored state
apps/web/server/states/service.ts - State History → PostgreSQL Persistence: reads history
apps/web/server/states/history/service.ts - State History → Domain Mapping: maps stored state
apps/web/server/states/history/service.ts - Transition History → PostgreSQL Persistence: reads history
- Deterministic Dynamics → Emotional Domain Types: validates state inputs
packages/emotional-core/src/dynamics/calculate-next-state.ts - Deterministic Dynamics → Model Parameters: validates parameters
packages/emotional-core/src/dynamics/calculate-next-state.ts - Deterministic Dynamics → Emotion Vectors: calculates vectors
packages/emotional-core/src/dynamics/calculate-next-state.ts - D09 Evaluation → Human Methodology: references contracts
packages/emora-evaluation/src/d09/contracts.ts - D10 Thresholds → D09 Evaluation: uses contracts
packages/emora-evaluation/src/d10/threshold.ts - D10 Thresholds → Evaluation Contracts: canonicalizes inputs
packages/emora-evaluation/src/d10/threshold.ts - D11 Methodology → D09 Evaluation: uses contracts
packages/emora-evaluation/src/d11/methodology.ts - D11 Methodology → Evaluation Contracts: canonicalizes inputs
packages/emora-evaluation/src/d11/methodology.ts