Semantic Library - Conceptual Overview

Overview

This page provides a conceptual entry point and documentation for the Semantic Library.

The Semantic Library is the declarative core of the Narrative Library project. It serves as a centralized, self-contained knowledge base and configuration hub that defines the "what" and "how" of understanding financial and market dynamics and generating explainable narratives.

Refer to the Semantic Library README for comprehensive details.

Note: This HTML file is a static conceptual overview placed within the semantic library for documentation purposes. It is not the active, data-driven frontend of the main application (which is a React app located in the /frontend directory).

Library Structure

The library is primarily composed of YAML and JSON configuration files:

semantic_library/
├── README.md
├── drivers_knowledge_base.yaml
├── narrative_strategies.yaml
├── domain_ontology.yaml
├── simulation_environment_definitions.yaml
├── index.html (this file)
└── schemas/
    ├── company_schema.json
    ├── driver_schema.json
    ├── industry_schema.json
    └── macro_factor_schema.json

Key Files (Links to Raw Content - Conceptual)

Direct links to view the raw content of the key configuration files (these links assume the files are browsable in a repository context):

Intended Usage

The `ReasoningEngine` (Python backend component) is the primary consumer of this library. It loads these configuration files to:

Understand domain entities and relationships (via `domain_ontology.yaml` and `schemas/`).
Identify active "drivers" and their potential impacts (via `drivers_knowledge_base.yaml`).
Select and apply narrative strategies for generating explanations (via `narrative_strategies.yaml`).
(Future) Set up and run simulations based on `simulation_environment_definitions.yaml`.

This declarative approach allows for easier modification and extension of the system's knowledge and explanatory capabilities without deep code changes in the engine itself.