Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 2 additions & 2 deletions .aii/config.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
meta:
updated: '2026-10-24'
repo:
name: fep_lean
slug: fep-lean
name: fep_formal
slug: fep-formal
full_name: ActiveInferenceInstitute/fep_formal
description: 'Release v2.1.0 implementation (2026-10-24) · Concept DOI [10.5281/zenodo.19699233](https://doi.org/10.5281/zenodo.19699233) · License CC BY 4.0. Standalone 168-topic Free Energy Principle / Active Inference Lean 4 catalogue.'
institute:
Expand Down
8 changes: 7 additions & 1 deletion .github/AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# GitHub repository contract

The public project is **FEP_Formal**, hosted as `ActiveInferenceInstitute/fep_formal`.
The Python import remains `fep_lean`; the CLI remains `fep-lean`.
The canonical Python import is `fep_formal`; the CLI is `fep-formal`.

## Repository presentation

Expand Down Expand Up @@ -42,3 +42,9 @@ Record the new supplement run/attempt before release joining. Dispatch success
is not test acceptance. Reject automatic reruns, changed bases/heads/trees or
unaccepted references rather than substituting an arbitrary prior green run.
This source proposal needs fresh full qualification before activation.


The dispatch-only [source-pair qualification workflow](workflows/source-pair-qualification.yml)
requires explicit FEP and GNN source SHAs. It exports source-bound bridge/Q7
projections and scoped native evidence for review; it does not publish commits
or establish the separate full-mode, publication or release acceptance planes.
21 changes: 11 additions & 10 deletions .github/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,11 @@ areas. Each topic connects an invariant, explicit assumptions, a canonical Lean
4 theorem body and typeset signatures. The catalog is a versioned research
interface, not an exhaustive census of the FEP literature.

The repository is **FEP_Formal** (`fep_formal` on GitHub). Its Python distribution
and import namespace remain **`fep_lean`**, and its command is **`fep-lean`**.
These names identify different interfaces; commands and imports below use their
actual installed names.
The project is **FEP_Formal**, the repository and Python import namespace are
`fep_formal`, and the distribution and command are `fep-formal`.
The previous `fep_lean` imports, `fep-lean` command, and public `FEP_LEAN_`
environment variables are deprecated compatibility aliases. New work uses the
canonical names; see the [migration guide](../docs/identity-migration.md).

Lean checks exact statements under their stated assumptions. A successful
compile does not establish that a theorem captures an entire scientific
Expand Down Expand Up @@ -47,7 +48,7 @@ and dependency policy. The project pins [uv](https://docs.astral.sh/uv/)
git clone https://github.com/ActiveInferenceInstitute/fep_formal.git
cd fep_formal
uv sync --locked --extra dev
uv run fep-lean catalogue
uv run fep-formal catalogue
```

This offline command validates the catalog and creates deterministic figures,
Expand All @@ -68,7 +69,7 @@ Choose the interface that matches the work:
the [atlas](../docs/formalism-atlas.html) and the
[numerical dashboard guide](../docs/formal-kernel-methods.md).
- **Use the Python API:** start with the [API guide](../docs/api.md). Installed
wheels support packaged catalog resources and `fep-lean --help`; substantive
wheels support packaged catalog resources and `fep-formal --help`; substantive
operator commands require the checkout's configuration, Lean workspace and
manuscript assets.
- **Compile the canonical Lean statements:** follow the native setup and
Expand All @@ -79,7 +80,7 @@ Choose the interface that matches the work:
Full mode requires Hermes, OpenGauss, the pinned Lean environment and the
required credentials. Failed capabilities or topics prevent a successful report.
- **Audit GNN numerical semantics:** follow the
[source-bound semantic audit guide](../src/fep_lean/bridge/README.md#independent-semantic-audit).
[source-bound semantic audit guide](../src/fep_formal/bridge/README.md#independent-semantic-audit).
It checks a retained receipt against independent finite/Gaussian calculations;
actual execution and native proof require separate evidence.
- **Inspect mathematical methods:** use the [methods guide](../docs/mathematical-methods.md),
Expand All @@ -88,7 +89,7 @@ Choose the interface that matches the work:

From outside the checkout, place `--project-root /path/to/fep_formal` before the
subcommand. [The command quick reference](../docs/quickref.md) and
`uv run fep-lean --help` describe the available workflows.
`uv run fep-formal --help` describe the available workflows.

## Formal depth

Expand Down Expand Up @@ -130,7 +131,7 @@ The published [**2.1.0 software release**](https://github.com/ActiveInferenceIns
and [GEO-INFER 0.4.0](https://github.com/ActiveInferenceInstitute/GEO_INFER/releases/tag/v0.4.0). It includes seven
bounded composition proofs, updated formal relations, and fail-fast Mathlib
prerequisites. The native supplement remains a separately unactivated proposal. Its
[semantic audit](../src/fep_lean/bridge/README.md#independent-semantic-audit)
[semantic audit](../src/fep_formal/bridge/README.md#independent-semantic-audit)
compares source-bound finite and passive linear-Gaussian numerical witnesses
through independent reference algorithms. It retains identity, parameter,
quantity, refusal and provenance details. The separate
Expand Down Expand Up @@ -197,7 +198,7 @@ explains the canonical README and its generated GitHub presentation.
## Layout

Authoring lives in [config](../config/README.md), the
[Python package](../src/fep_lean/README.md), and the
[Python package](../src/fep_formal/README.md), and the
[manuscript](../manuscript/README.md). The [Lean workspace](../lean/README.md)
compiles the projected formal sources. [Scripts](../scripts/README.md) provide
bounded entry points, [tests](../tests/README.md) enforce contracts, and
Expand Down
Loading
Loading