chirality-framework 15.0.0

CF14 Semantic Calculator - Fixed canonical algorithm for structured problem-solving

Chirality Framework: A Semantic Calculator

Version: 15.0.0 | Status: Refactored to Canonical Algorithm

The Chirality Framework is a direct, simple, and observable implementation of a fixed, canonical algorithm for structured problem-solving. It is not a general-purpose framework but a "semantic calculator" designed to execute a specific sequence of semantic transformations.

The value of this project is in the unique, insightful output of the calculation, not in the flexibility of the code.

Core Concept: The Three-Stage Interpretation Pipeline

The heart of the Chirality Framework is a three-stage process that generates deep meaning from fixed inputs:

1. Stage 1 (Combinatorial): Mechanical combination of terms.
2. Stage 2 (Semantic Resolution): An LLM resolves the raw terms into meaningful concepts.
3. Stage 3 (Ontological Lensing): The LLM interprets these concepts through the contextual lens of the framework's ontological axes.

For a complete technical description of this process, see the Canonical Algorithm Documentation.

Quick Start: Using the CLI

The primary way to interact with the calculator is via the command-line interface. The most common command is compute-cell, which allows you to observe the 3-stage pipeline for any cell in a matrix.

Prerequisites

• Python 3.8+
• An OpenAI API key set as the OPENAI_API_KEY environment variable.

Examples: Computing cells through the 3-stage pipeline

# Navigate to the project root
cd /path/to/chirality-framework

# Compute cell C[0,0] with verbose output (shows all 3 stages)
python3 -m chirality.cli compute-cell C --i 0 --j 0 --verbose

# Compute with OpenAI resolver (requires API key)
python3 -m chirality.cli compute-cell C --i 0 --j 0 --resolver openai --verbose

# Compute different matrix types
python3 -m chirality.cli compute-cell F --i 1 --j 2 --verbose
python3 -m chirality.cli compute-cell D --i 2 --j 1 --problem "creating value"

# Enable tracing for full observability
python3 -m chirality.cli compute-cell C --i 0 --j 0 --trace --verbose

# Get help and information
python3 -m chirality.cli --help
python3 -m chirality.cli info

This will display the output of all three stages for the specified cell.

Development

To set up the development environment and run tests, please refer to the instructions in CONTRIBUTING.md.