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
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 8 additions & 14 deletions .github/workflows/sync-libs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,15 @@ jobs:
mkdir -p libs/pcea/src
rsync -av --delete --exclude='README.md' /tmp/pcea-src/pcea/ libs/pcea/src/

# ── PTCA ────────────────────────────────────────────────────────────────
- name: Sync ptca lib
# ── PTCNA (consolidated prime-tensor stack) ─────────────────────────────
# Supersedes the former separate pcna / pcta / pcsa sync steps. One repo,
# four layers (neural/circle/seed/core) under the ptcna/ package.
- name: Sync ptcna package
run: |
rm -rf /tmp/ptca-src
git clone --depth 1 https://github.com/The-Interdependency/PTCA.git /tmp/ptca-src
mkdir -p libs/ptca/src
rsync -av --delete --exclude='README.md' /tmp/ptca-src/ptca/ libs/ptca/src/
rm -rf /tmp/ptcna-src
git clone --depth 1 https://github.com/The-Interdependency/ptcna.git /tmp/ptcna-src
mkdir -p libs/ptcna/src
rsync -av --delete --exclude='README.md' /tmp/ptcna-src/ptcna/ libs/ptcna/src/

# ── UCNS ────────────────────────────────────────────────────────────────
- name: Sync ucns lib
Expand All @@ -39,14 +41,6 @@ jobs:
mkdir -p libs/ucns/src
rsync -av --delete --exclude='README.md' /tmp/ucns-src/ucns/ libs/ucns/src/

# ── PCNA core ───────────────────────────────────────────────────────────
- name: Sync pcna core
run: |
rm -rf /tmp/pcna-src
git clone --depth 1 https://github.com/The-Interdependency/pcna.git /tmp/pcna-src
mkdir -p libs/pcna/src
rsync -av --delete --exclude='README.md' /tmp/pcna-src/core/ libs/pcna/src/

# ── AIMMH ───────────────────────────────────────────────────────────────
- name: Sync aimmh lib
run: |
Expand Down
21 changes: 21 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,27 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm

## [Unreleased]

### Changed
- **Prime-tensor stack consolidated into a single `ptcna` package.** The former
`pcna`/`pcta`/`pcsa` repos — never actually separate things, just layers of one
architecture — are unified into `The-Interdependency/ptcna` (Prime Tensor
Circled Neural Architecture), four layers: `neural` (the only back-propagating
layer) + `circle`/`seed`/`core` (auditing/timing tensors; fiqs gate core
internal propagation per Fick's law). In this repo:
- `_REGISTRY` collapses `pcna`/`pcta` into a single `ptcna` → `ptcna` key.
- `pyproject.toml` drops the `ptca` extra and its `ptca-lib` pin (superseded);
a single `ptcna` extra lands once `ptcna` publishes to PyPI. `prime-stack`
intent is obsolete.
- `docs/prime-tensor-stack.md` rewritten around the four-layer single-repo
model (backprop-only-in-neural; circle/seed/core as auditing/timing tensors;
fiq/Fick core timing).
- `libs/pcna|pcta|ptca/` stubs replaced by `libs/ptcna/`; `sync-libs.yml` syncs
the consolidated `ptcna/` package; README/CLAUDE/dependency-policy/
release-checklist/CONTRIBUTING updated; `naming-migration.md` records the
consolidation as the terminal state.
- drift-guard tests updated: single `ptcna` key, old keys gone, no `ptca-lib`
pin remains.

### Added
- `docs/prime-tensor-stack.md` — canonical role-and-boundary map for the
prime-tensor compute family: PCNA (tensors + back-propagation → weights) →
Expand Down
63 changes: 31 additions & 32 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,26 +26,28 @@ Verified against `[project.optional-dependencies]` in `pyproject.toml`.

| Acronym | PyPI / requirement | Extra | Status | Description |
|---------|--------------------|-------|--------|-------------|
| PCEA | `pcea>=0.1.0` | `pcea` | Packaged | Prime Circular Encryption Algorithm (guardian"last state as key" at every layer) |
| PTCA | `ptca-lib>=0.1.0` | `ptca` | Packaged | Prime Tensor Core Architecture (stack layer 3: seeds → core; `ptca-lib` ships the sentinel-channel tensor system, the seeds→core role is `prime_core`) |
| PTCNA | — | — | Source-only (not on PyPI) | Prime Tensor Circled Neural Architectureone repo, four layers (neural/circle/seed/core). **Consolidates the former PCNA/PCTA/PCSA.** Registered as `ptcna`; `ptcna` extra lands on PyPI release. See `docs/prime-tensor-stack.md` |
| PCEA | `pcea>=0.1.0` | `pcea` | Packaged | Prime Circular Encryption Algorithm (guardian — "last state as key" at every layer; orthogonal to the stack) |
| UCNS | `ucns>=0.9.1` | `ucns` | Packaged | Unit Circle Number System; Python runtime stdlib-only; upstream formal scaffold is Mathlib-backed |
| AIMMH | `aimmh-lib>=1.1.0`| `aimmh` | Packaged | AI Multimodel Multimodal Hub (five-letter) |
| PCNA | — | — | Source-only (not on PyPI) | Prime Circle Neural Architecture (stack layer 1: tensors → circles, backprop) |
| PCTA | — | — | Repo created; not yet on PyPI | Prime Circled Tensor Architecture (stack layer 2: circles → seeds); see `docs/prime-tensor-stack.md` |
| ZFAE | — | — | Conceptual (runtime lives in `a0`; no dist planned) | Zeta Function Alpha Echo (inference engine) |
| METAPAT | — | — | FLAR; registered, not yet on PyPI | Meta Energy Theory — Axioms, Postulates, And Theorems (first-letter acronym repo; canon + unpublished `metapat` 0.0.1 src-layout package) |

PCNA, PCTA, PTCA and ZFAE form one compute stack (PCEA is the orthogonal
guardian) — the canonical role-and-boundary map is `docs/prime-tensor-stack.md`.
PCTA now has a repo (`The-Interdependency/pcta`) but is not yet published; unlike
PCNA/ZFAE it is **not** in `_REGISTRY` and has no extra until it ships to PyPI.
The prime-tensor stack is now the single `ptcna` package — neural (the only
back-propagating layer) + circle/seed/core (auditing/timing tensors). PCEA is the
orthogonal guardian; ZFAE is the conceptual inference cap (runtime in `a0`). The
canonical role-and-boundary map is `docs/prime-tensor-stack.md`.

The `all` extra installs the four packaged libraries together. `dev` installs `pytest>=8.0`, `build`, and `twine`. PCNA, ZFAE, and METAPAT appear in `available()` and `libs/` but have no extra until they have stable PyPI releases.
The `all` extra installs the three packaged libraries together (pcea, ucns,
aimmh). `dev` installs `pytest>=8.0`, `build`, and `twine`. PTCNA, ZFAE, and
METAPAT appear in `available()` and `libs/` but have no extra until they have
stable PyPI releases (a single `ptcna` extra replaces the former per-repo intent).

> **Naming migration.** The org-wide rename scheme (`PTCA → pcsa`, casing
> normalization, `ucns` frozen) is ratified — `docs/naming-migration.md` is the
> reference, including the extras/registry transition rules. Names above track
> what is published/importable today.
> **Naming migration + consolidation.** The org-wide rename scheme and the
> **prime-tensor stack consolidation** (pcna/pcta/pcsa → single `ptcna`;
> `ucns` frozen) are ratified — `docs/naming-migration.md` is the reference,
> including the extras/registry transition rules. Names above track what is
> published/importable today.

---

Expand All @@ -58,10 +60,10 @@ interdependent_lib/

libs/ Per-library documentation stubs (no primary code lives here)
README.md Lib index + sync-workflow notes
pcea/ ptca/ ucns/ Packaged libs (each has README.md; sync-libs.yml mirrors upstream into <name>/src)
pcea/ ucns/ Packaged libs (each has README.md; sync-libs.yml mirrors upstream into <name>/src)
aimmh/ Packaged five-letter lib (README.md; sync-libs.yml mirrors into aimmh/src)
pcna/ Source-only lib: README.md + src/ (mirrored upstream core/ sources, present in tree)
zfae/ Source-only lib: README.md only (NOT synced by sync-libs.yml)
ptcna/ Consolidated prime-tensor stack (README.md; sync-libs.yml mirrors ptcna/ into ptcna/src)
metapat/ zfae/ Source-only libs: README.md only (NOT synced by sync-libs.yml)

tests/ pytest suite
test_interdependent_lib.py Smoke tests for available() and __version__
Expand Down Expand Up @@ -133,23 +135,20 @@ twine upload dist/*
Lean/Mathlib-backed and is not a Python runtime dependency.
- **`available()`** maps each known sub-library (logical name → import name) and
reports which are importable in the current environment via `importlib.util.find_spec`.
The registry includes source-only libs (`pcna` → `core`, `zfae` → `zfae`), so they are
The registry includes source-only libs (`ptcna` → `ptcna`, `zfae` → `zfae`), so they are
always present as keys but report `False` unless installed manually.
- **Prime-tensor stack canon.** `docs/prime-tensor-stack.md` is the single source
of truth for how PCNA (Prime Circle Neural Architecture; tensors → circles,
back-propagation → weights), PCTA (Prime Circled Tensor Architecture; circles →
seeds), PTCA (Prime Tensor Core Architecture; seeds → core) and ZFAE (Zeta
Function Alpha Echo; inference, using PCNA weights + circles / seeds / cores as
phase-harmonic propagation + auditing) compose, with PCEA as the orthogonal
guardian ("last state as key" at every layer). Like the coherence-prime canon
it lives in the aggregator so leaf repos cite it without inverting the
dependency graph. Back-propagation lives **only** in PCNA; PCTA/PTCA
composition is structural/non-differentiable. **Composition counts are
of truth for the consolidated stack: **PTCNA** (Prime Tensor Circled Neural
Architecture) is one repo with four layers — `neural` (the only differentiable
layer; owns back-propagation), and `circle` / `seed` / `core` (auditing and
timing tensors; non-differentiable). Each layer's tensors divide into the next;
every circle/seed/core is itself a tensor. Within the core layer, **fiqs gate
internal propagation** per Fick's first law `J = −D ∇φ` (timing, not gradient
descent). PCEA is the orthogonal guardian ("last state as key" at every layer),
not a layer. Like the coherence-prime canon it lives in the aggregator so leaf
repos cite it without inverting the dependency graph. **Composition counts are
variable** — the only invariant is that every circle/seed/core is itself a
tensor. The acronym expansions, the variable-count rule, the flow, and the
**formal definition of "motion"** — the Fickian gradient flux `J = −D ∇φ`
(Fick's first law; structure diffusing down its field gradient) — were all
resolved by the maintainer; **no stack-level `hmmm` remains**.
tensor.
- **Coherence-prime canon.** `coherence_primes.py` is the single source of truth
for the recursive coherence-prime sequence (base `{3,5,7}`, then `p≡1 mod 4`
with a square-free kernel whose factors are all already coherence primes). It is
Expand All @@ -161,8 +160,8 @@ twine upload dist/*
`libs/<name>/src`. It has two triggers: `workflow_dispatch` (manual) and an
active `schedule:` cron (`0 3 * * 1` — every Monday 03:00 UTC; the cron line is
*not* commented out, so it runs despite the misleading inline "disabled by
default" comment). It syncs only a **subset** of libs — `pcea`, `ptca`, `ucns`,
`pcna` (from upstream `core/`), and `aimmh` — **not** all `libs/<name>/src`:
default" comment). It syncs only a **subset** of libs — `pcea`, `ucns`,
`ptcna` (the consolidated stack), and `aimmh` — **not** all `libs/<name>/src`:
`zfae` has no sync step and is never mirrored. Each step excludes the upstream
`README.md` so the stubs stay authoritative, then commits any changes with
`[skip ci]`.
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Thank you for your interest in contributing! This document explains how the repo

## Repository purpose

`interdependent-lib` is a **meta-package** and **documentation hub** that aggregates the individual Interdependency acronym libraries. Most library *code* lives in the source repos (pcna, PCEA, PTCA, ucns, ZFAE, aimmh). Changes to library logic belong there.
`interdependent-lib` is a **meta-package** and **documentation hub** that aggregates the individual Interdependency acronym libraries. Most library *code* lives in the source repos (ptcna, PCEA, ucns, ZFAE, aimmh, metapat). Changes to library logic belong there. The prime-tensor stack is consolidated into the single `ptcna` repo (neural/circle/seed/core), superseding the former pcna/pcta/pcsa.

Contributions welcome here:
- Updating or improving the per-library `libs/*/README.md` stubs
Expand Down
35 changes: 18 additions & 17 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,10 @@

| Acronym | Full Name | Letters | Description |
|---------|-----------|---------|-------------|
| [PCEA](libs/pcea/README.md) | Prime Circular Encryption Algorithm | 4 | Neural architecture state encryption ("last state as key") at every layer |
| [PTCA](libs/ptca/README.md) | Prime Tensor Core Architecture | 4 | Stack layer 3 — seeds → core. (`ptca-lib` ships the sentinel-channel / prime-node tensor system; the seeds→core role is `prime_core`.) |
| [PCTA](libs/pcta/README.md) | Prime Circled Tensor Architecture | 4 | Stack layer 2 — composes UCNS-carried circles → seeds |
| [PTCNA](libs/ptcna/README.md) | Prime Tensor Circled Neural Architecture | — | The prime-tensor stack, consolidated into one repo, four layers (neural/circle/seed/core). Supersedes the former PCNA/PCTA/PCSA |
| [PCEA](libs/pcea/README.md) | Prime Circular Encryption Algorithm | 4 | Neural architecture state encryption ("last state as key") at every layer; orthogonal guardian |
| [UCNS](libs/ucns/README.md) | Unit Circle Number System | 4 | Recursive factorization theory, witness-matrix quotient solver, A0-safe factorization envelopes, and Mathlib-backed formal scaffold upstream |
| [PCNA](libs/pcna/README.md) | Prime Circle Neural Architecture | 4 | Stack layer 1 — tensors → circles in a back-propagating NN → weights |
| [ZFAE](libs/zfae/README.md) | Zeta Function Alpha Echo | 4 | Inference engine — pcna weights + circles / seeds / cores as phase-harmonic propagation |
| [ZFAE](libs/zfae/README.md) | Zeta Function Alpha Echo | 4 | Inference engine (conceptual; runtime in `a0`) — reads neural weights + circles / seeds / cores as phase-harmonic propagation |
| [AIMMH](libs/aimmh/README.md) | AI Multimodel Multimodal Hub | 5 | Zero-dependency async multi-model conversation orchestration |

---
Expand All @@ -34,9 +32,9 @@ pip install interdependent-lib

# Install only specific libraries
pip install interdependent-lib[pcea]
pip install interdependent-lib[ptca]
pip install interdependent-lib[ucns] # ucns>=0.9.1
pip install interdependent-lib[aimmh]
# ptcna (the consolidated prime-tensor stack) gets a [ptcna] extra once it publishes to PyPI

# Install everything
pip install interdependent-lib[all]
Expand All @@ -57,16 +55,19 @@ print(interdependent_lib.available())

## The Prime-Tensor Stack

PCNA, PCTA, PTCA and ZFAE form a single compute stack (PCEA is the orthogonal
guardian). Composition counts are **variable** at every level — the only
invariant is that every circle, seed, and core is itself a tensor. The canonical
role-and-boundary map lives in
The stack is one package — **PTCNA** (Prime Tensor Circled Neural Architecture) —
with four layers. PCEA is the orthogonal guardian; ZFAE is the conceptual
inference cap (runtime in `a0`). Composition counts are **variable** at every
level — the only invariant is that every circle, seed, and core is itself a
tensor. The canonical role-and-boundary map lives in
**[docs/prime-tensor-stack.md](docs/prime-tensor-stack.md)**:

```
PCNA (tensors → circles, back-prop) ─► weights + circles ─► PCTA (circles → seeds)
─► seeds ─► PTCA (seeds → core) ─► cores ─► a0(ZFAE) infers
PCEA — guardian: "last state as key for this state" at every layer (orthogonal)
neural tensors ─(circle layer)─► circles ─(seed layer)─► seeds ─(core layer)─► cores
back-propagation lives ONLY in the neural layer
circle / seed / core are auditing & timing tensors (non-differentiable);
fiqs gate core internal propagation per Fick's law (J = −D ∇φ)
PCEA — guardian: "last state as key for this state" at every layer (orthogonal; not a layer)
```

---
Expand All @@ -75,12 +76,12 @@ PCEA — guardian: "last state as key for this state" at every layer (orthogonal

See `libs/` for per-library documentation and source links:

- [`libs/pcea/`](libs/pcea/README.md) — PCEA
- [`libs/ptca/`](libs/ptca/README.md) — PTCA
- [`libs/ptcna/`](libs/ptcna/README.md) — PTCNA (consolidated stack: neural/circle/seed/core)
- [`libs/pcea/`](libs/pcea/README.md) — PCEA (orthogonal guardian)
- [`libs/ucns/`](libs/ucns/README.md) — UCNS
- [`libs/pcna/`](libs/pcna/README.md) — PCNA
- [`libs/zfae/`](libs/zfae/README.md) — ZFAE
- [`libs/zfae/`](libs/zfae/README.md) — ZFAE (conceptual; runtime in `a0`)
- [`libs/aimmh/`](libs/aimmh/README.md) — AIMMH (five-letter)
- [`libs/metapat/`](libs/metapat/README.md) — METAPAT (FLAR)

---

Expand Down
7 changes: 6 additions & 1 deletion docs/dependency-policy.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,10 +22,15 @@ stable PyPI package and a stable import name.
Current packaged extras:

- `pcea` -> `pcea>=0.1.0`
- `ptca` -> `ptca-lib>=0.1.0`
- `ucns` -> `ucns>=0.9.1`
- `aimmh` -> `aimmh-lib>=1.1.0`

The prime-tensor stack (`pcna` / `pcta` / `pcsa`) is consolidated into the single
`ptcna` package. It is a source-only registry probe until it ships to PyPI, at
which point a single `ptcna` extra is added (replacing the former per-repo intent
and the once-planned `prime-stack` extra). The previously-published core-layer
dist is superseded and no longer pinned by any extra.

The `all` extra is the union of packaged extras only. Source-only libraries do
not enter `all` until they have stable package releases.

Expand Down
20 changes: 20 additions & 0 deletions docs/naming-migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,3 +57,23 @@ via the API access available to org agents.
publish it as its own dist. Unresolved.
- Dev-side shadows (`erinepshovel-code`: `UnitCircle`, `EDCM`,
`Interdependent-core`) need dev-mirror labels or reconciliation.

## Terminal state — stack consolidation (2026-07)

The `pcna` / `pcta` / `pcsa` renames are **superseded by consolidation**: those
three repos were never separate things — they are layers of one architecture —
and are now a single package, **`ptcna` — Prime Tensor Circled Neural
Architecture** (`The-Interdependency/ptcna`), with four layer modules:

- `ptcna.neural` — neural tensors; the only back-propagating layer
- `ptcna.circle` — auditing/timing tensors, neural tensors → circles
- `ptcna.seed` — auditing/timing tensors, circles → seeds
- `ptcna.core` — auditing/timing tensors, seeds → cores; fiqs gate internal
propagation per Fick's law `J = −D ∇φ`

So `pcsa` (the earlier `PTCA → pcsa` target), `pcta`, and `pcna` are absorbed;
the standalone repos are to be archived. `pcea` stays separate (orthogonal
guardian). In this aggregator: a single `ptcna` registry key + (on PyPI release)
a single `ptcna` extra replace all of them; the once-planned `prime-stack` extra
is obsolete; the previously-published core-layer dist is superseded. `ucns`
remains frozen; `metapat` (FLAR) and `zfae` (conceptual) are unaffected.
Loading
Loading