Skip to content
Open
5 changes: 4 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
# UCNS agent instructions

- Treat UCNS as a geometry repository.
- Treat UCNS as a geometry and mathematical-representation repository whose cross-domain role is geometric scale/representation transport, never semantic transfer.
- Read `CANON.md` before changing domain behavior.
- Placement test: if work constructs geometric carriers, motion, attachment, recursion, or transport across a declared scale/representation boundary, it may belong in UCNS.
- If work defines what the transported structure means in a domain, keep that meaning with the domain consumer or METAPAT authority.
- If work measures whether a claimed transformation preserves an observable, keep that measurement in EDCM; UCNS supplies only the represented geometry and its own mathematical evidence.
- Keep only code, tests, documents, and evidence that directly construct, represent, certify, falsify, or replay geometry/topology.
- Do not introduce lexical, NLP, dictionary, morphology, definition, semantic-graph, EDCM-measurement, PTCNA-state, generic evaluator/laboratory, or cross-stack adapter machinery into UCNS.
- Every Public Gonol glyph is a function position. Do not create letter/punctuation/digit/symbol subclasses as UCNS architecture.
Expand Down
44 changes: 43 additions & 1 deletion CANON.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,50 @@ UCNS assigns elements of an unknowable to completion through geometric motion.

Assignment, ordered motion, orientation, nesting, recursive scale, and scoped completion are load-bearing. Text labels, lexical definitions, corpora, hashes, evaluator frameworks, and external semantic graphs are not substitutes for geometry.

## Scale-transformation jurisdiction

UCNS is the geometric and mathematical-representation substrate for constructing how structure changes across declared scale or representation boundaries. Its cross-domain role is structural, not semantic: a consumer may supply domain meaning and domain evidence, while UCNS owns only the geometry of the representation, motion, attachment, recursion, and transport it actually constructs.

A claimed UCNS scale transformation must declare enough geometry to identify both sides of the transition and the operation between them. At minimum, the construction must make explicit:

- the source and target geometric boundaries or carriers;
- the geometric operation that relates them;
- the attachment, origin, or provenance needed to establish continuity of the construction;
- which geometric distinctions are retained, changed, or discarded by the operation; and
- the standing of the relation: candidate, selected within a declared scope, ratified, or `hmmm`.

Identity across scale is not inferred from similar coordinates, labels, hashes, or downstream meaning. Composition is likewise not assumed: when two scale transitions are claimed to compose, the composed geometric law must itself be constructed or tested.

METAPAT remains the semantic authority for cross-domain terms and transfer constraints. EDCM owns measurement and evaluation. EPAC, consciousness constructions, language constructions, and other consumers retain their own domain semantics and evidence standards. Their recurrence may test UCNS structure; it does not move their semantics into UCNS.

The present repository contains candidate pieces of this formalism, including exact carrier state, native Möbius return, radius/layer recursion, continuum-to-finite gonal trace, lattice address structure, an exact multiplicative scale-action candidate, displacement, lift selection, and motion. Their existence does not establish one complete scale-transformation law.

## Multiplicative scale-action candidate

UCNS has an executable domain-agnostic candidate action on an ordered positive exact-rational coordinate carrier:

```text
T_q(x)_i = q^w_i x_i
```

where `q > 0` is an exact rational factor and each `w_i` is an integer. For one fixed ordered weight vector, the candidate constructs exact composition, identity, and inverse:

```text
T_p o T_q = T_(p*q)
T_1 = identity
T_q^-1 = T_(1/q)
```

For a monomial `I_a(x) = product(x_i^a_i)`, the candidate's structural scale weight is `sum(a_i*w_i)`; the monomial is invariant under the action when that weight is zero.

This establishes an exact algebraic candidate component, not the complete UCNS scale-transition law. UCNS assigns no domain meaning to the coordinate positions or weights. A consumer may bind physical, chemical, linguistic, consciousness, or other meanings externally under its own authority and evidence.

`hmmm`: how this diagonal action binds to native Möbius origin/attachment, recursive carrier transitions, and the full higher-dimensional construction remains unresolved.


## Public Gonol carrier


The exact 157-position Public Gonol arrangement is retained as geometry. Every admitted glyph is a Public Gonol function position. No active UCNS rule divides these positions into letters, punctuation, symbols, digits, lexical glyphs, or other linguistic classes.

The exact operation of a function position must be supplied by a geometric construction. It may be identity-like ("carry on") where geometry supports that behavior. Unicode names and dictionary definitions do not define Public Gonol function semantics.
Expand Down Expand Up @@ -168,4 +210,4 @@ Those experiments remain recoverable from Git history but carry no current UCNS

A construction may close only relative to its declared geometric boundary. No executable convenience is promoted to the complete UCNS merely because it produces coordinates, hashes, scores, or labels.

`hmmm`: ratification of the modular-orbit / continuum-boundary-trace candidates; the full circle → epicycle → disk → sphere → recursive-scale transition law; exact direct coupling across distant scales; the visible-circle trace → native Möbius complete-state lift; any law selecting one continuum lift from a finite modular congruence class; and the geometric operation of Public Gonol function positions not yet constructed.
`hmmm`: ratification of the modular-orbit / continuum-boundary-trace candidates; one explicit composition law binding the present candidate pieces into a complete UCNS scale-transformation formalism; the full circle → epicycle → disk → sphere → recursive-scale transition law; exact direct coupling across distant scales; the visible-circle trace → native Möbius complete-state lift; any law selecting one continuum lift from a finite modular congruence class; and the geometric operation of Public Gonol function positions not yet constructed.
2 changes: 2 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,6 @@ Read `AGENTS.md`, then `CANON.md`.

This repository is geometry-only. Active implementation work is limited to geometric/topological construction and the exact evidence required to reproduce or falsify it.

Its cross-domain purpose is geometric scale/representation transport: UCNS may construct how structure is carried across declared boundaries, while consumer semantics stay with the consumer, METAPAT governs semantic transfer, and EDCM owns measurement/evaluation.

Do not restore semantic, lexical, corpus, EDCM-measurement, PTCNA, generic evaluator, or cross-stack machinery from Git history into the active tree.
34 changes: 32 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<img src="docs/ucns-geometry-repository.svg" alt="UCNS — Geometry Repository" width="100%">
</p>

UCNS is a geometry repository.
UCNS is a geometry repository and domain-independent mathematical-representation substrate for constructing transformations across declared scale or representation boundaries.

Its active scope is limited to constructions that directly represent or test geometry:

Expand All @@ -14,13 +14,44 @@ Its active scope is limited to constructions that directly represent or test geo
- Möbius vesica and Seed-of-Life constructions and certificates;
- candidate exact finite modular-action orbit and circle geometry;
- candidate exact visible-circle continuum wave / gonal boundary traces;
- candidate exact multiplicative scale actions and monomial-invariant kernels;
- prime-indexed ribbon, link, interval, Milnor, Alexander, and related topological geometry;
- numerical machinery used to certify those constructions.

Everything semantic is outside this repository's active domain: lexical corpora, definitions, morphology, NLP parsing, function-name semantics, EDCM measurement profiles, PTCNA state, evaluator laboratories, and cross-stack adapters.

## Scale-transformation jurisdiction

UCNS supplies geometry for asking what survives, changes, or disappears when a construction is represented across a declared scale or representation boundary. A consumer supplies domain meaning; METAPAT constrains cross-domain semantic transfer; EDCM measures claimed observables. UCNS does not absorb those roles.

The current repository already contains pieces of this architecture: carrier and origin state, native Möbius transport and return, candidate radius/layer recursion, continuum-to-finite gonal traces, discrete lattice addresses, displacement and lift candidates, and candidate motion. These are evidence-bearing components, not yet one complete scale-transformation law.

Use this placement test before adding a cross-domain feature:

```text
geometric representation / transport across scale -> UCNS
domain meaning and domain evidence -> consuming domain
cross-domain semantic authority -> METAPAT
measurement / evaluation of claimed observables -> EDCM
```

See `docs/scale-transformation-jurisdiction.md` for the contract, current primitive audit, usage guidance, and unresolved boundary.

### Multiplicative scale-action candidate

`src/ucns/scale_action.py` implements one exact candidate component:

```text
T_q(x)_i = q^w_i x_i
```

for positive exact rational `q`, positive exact rational coordinates, and an ordered integer weight vector `w`. Actions with the same weights compose as `T_p o T_q = T_(p*q)`; reciprocal factors invert. A monomial `product(x_i^a_i)` is structurally invariant exactly when `sum(a_i*w_i) = 0`.

The core carries no domain axis names. Physics, chemistry, language, consciousness, or other domain bindings belong in consumer repositories under exact provenance; those consumers may bind ordered coordinate names and claims without transferring them into UCNS.

The poster above is a display certificate of those constructions. It is not an interpretation layer.


## Public Gonol

The Public Gonol is the exact ordered 157-position carrier in `src/ucns/public_gonol.py`. Every glyph is a Public Gonol function position. UCNS does not divide glyphs into letters, punctuation, digits, or symbols for construction.
Expand Down Expand Up @@ -156,7 +187,6 @@ raise SystemExit(run_suite(["tests", "-c", "pyproject.toml", "--noconftest", "--
PY
.venv/bin/python -m build
.venv/bin/python -m twine check dist/*
.venv/bin/python tools/verify_distributions.py . dist
```

The independent interval checks also require system MPFR (for example,
Expand Down
112 changes: 112 additions & 0 deletions docs/scale-transformation-jurisdiction.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,112 @@
# UCNS scale-transformation jurisdiction

Standing: **canonical repository jurisdiction; incomplete formalism**.

UCNS is the geometric and mathematical-representation substrate for constructing how structure changes across declared scale or representation boundaries. This document makes that repository role explicit without promoting any unresolved candidate geometry.

The distinction is load-bearing:

```text
METAPAT cross-domain semantic authority and transfer constraints
UCNS geometric representation and scale/representation transport
EDCM measurement, projection, and evaluation of claimed observables
consumer domain meaning, evidence, and interpretation
```

A repeated structure across EPAC, consciousness, language, physics, or another domain can motivate and falsify UCNS geometry. Recurrence does not transfer the source domain's vocabulary, mechanism, conservation law, or evidence standard into UCNS.

## Minimal geometric contract

A UCNS scale/representation transformation is admissible only when the construction declares enough geometry to distinguish a real transition from two unrelated records.

For a source construction (X_a), target construction (X_b), and candidate geometric operation (R_{a\to b}), require:

1. **source boundary** — the exact source carrier or geometric boundary;
2. **target boundary** — the exact target carrier or geometric boundary;
3. **operation** — the constructed geometric action relating source to target;
4. **continuity evidence** — attachment, origin, provenance, or another geometric witness sufficient to justify that the target is a transformation of the source;
5. **distinction accounting** — which geometric distinctions remain recoverable, which change, and which are discarded;
6. **composition status** — if (R_{b\to c}\circ R_{a\to b}) is claimed, construct or test that composition rather than assuming it;
7. **standing** — candidate, selected within an explicitly declared scope, ratified, or `hmmm`.

Coordinate similarity, equal hashes, matching labels, or a shared downstream interpretation do not establish geometric identity across scale.

No universal completed `ScaleTransform` law is introduced here. `src/ucns/scale_action.py` implements one narrower exact candidate component: a diagonal multiplicative action `T_q(x)_i = q^w_i x_i` with exact composition, inversion, and monomial-invariant detection. It does not bind the existing Möbius, origin/attachment, recursive carrier, or higher-dimensional transition machinery into one universal transform.

## Current primitive audit

| UCNS surface | Present contribution | Standing relative to scale transformation |
|---|---|---|
| Public Gonol carrier | exact ordered 157-position geometric carrier | carrier floor; not itself a scale law |
| native Möbius state | exact framed transport; 360° visible / 720° complete return | established geometric return primitive |
| modular orbit geometry | exact finite action and cycle decomposition | candidate representation component |
| gonal boundary trace | exact continuum-covering to finite gonal action relation | candidate cross-representation component |
| radius recursion | radius from breadth plus deck-translation layer recursion | direct candidate scale-recursion component |
| lattice carrier | discrete deck/modular address structure | candidate address substrate |
| visible/lifted displacement | candidate transport on the carrier | candidate transform component; scope-bounded selection where recorded |
| lift selection | explicit alternatives and selection gate for finite-to-lifted witnesses | candidate selection machinery |
| multiplicative scale action | exact `T_q(x)_i = q^w_i x_i`, multiplicative composition, inverse, and monomial-invariant kernel | executable domain-agnostic candidate component |
| motion | ordered accumulation of selected-scoped displacement with radius/layer state | candidate composed transport |
| circle → epicycle → disk → sphere → recursive scale | not yet constructed as one law | `hmmm` |

This audit means UCNS already contains much of the machinery the scale-transform purpose requires. It does **not** mean the components presently compose into one complete formalism.

## Cross-domain consumption

A consumer should bind its own states to UCNS geometry without moving its semantics into UCNS.

For EPAC, an electron, atom, boundary, ligand, or molecule remains an EPAC object. UCNS may represent a declared geometric relation between levels. EDCM may then test whether a distinction survives, collapses, or becomes measurable under that representation.

For consciousness work, stimulus, somatic response, integrated state, learned association, or persistent model remain consciousness-domain terms. UCNS may represent declared coupling geometry or scale transport only when that geometry is independently specified.

Renormalization-group flow is therefore a useful external test case, not UCNS doctrine. If UCNS can express an RG scale flow without importing field-theory semantics, that is evidence for the abstraction. RG vocabulary does not become UCNS primitive vocabulary merely because the structures correspond.

Physics bindings, including the conditional six-axis confinement fixture formerly drafted here, belong in a consumer repository such as Stack. UCNS may supply the exact ordered integer weight vector and multiplicative action; the names `(epsilon, mu, c, hbar, m, L)`, the Compton/confinement algebra, varying-constants hypotheses, and all empirical or physical claims stay outside UCNS under exact provenance and non-transfer boundaries.

## Usage guidance

When adding a proposed scale transformation:

1. Name the two geometric boundaries, not merely two domain labels.
2. Construct the operation using existing UCNS primitives where possible.
3. Identify the continuity witness that makes the target a transformation of the source.
4. State exactly what information the operation preserves, transforms, or forgets.
5. If the operation composes with another UCNS transition, test the composition explicitly.
6. Keep domain interpretation outside UCNS.
7. Bind every executable candidate to its source-owned `CONTRACTS`, test-owned `CHECKS`, replay path, falsifiers, and standing.
8. Leave unresolved geometry as `hmmm`; do not fill the gap with a generic abstraction.

### Placement examples

- “EPAC valence means outer-shell occupancy” — EPAC, not UCNS.
- “These two EPAC states map to the same declared UCNS boundary state under operation (R)” — UCNS geometry plus EPAC binding.
- “The mapping loses a behaviorally relevant ligand distinction” — EDCM measurement/evaluation against an EPAC observable.
- “Two consciousness time windows share this geometric coupling transform” — UCNS only after the coupling geometry and boundaries are independently declared.
- “All such transformations are energy flows” — not licensed by structural recurrence; METAPAT/domain restraint applies.
- “A six-axis physical hypothesis gives names to the ordered coordinates of `T_q`” — consumer/Stack physics fixture, not UCNS.

## Acceptance target

The missing architectural result is not another label. It is an explicit, replayable composition law that binds the existing carrier, origin/attachment, recursion, lift, and motion primitives into a scale-transition construction while preserving each component's current standing.

A future complete contract should be able to answer, for an exact transformation:

```text
what is the source geometry?
what is the target geometry?
what operation connects them?
what establishes continuity?
what survives?
what changes?
what is forgotten?
does composition hold where claimed?
what is the evidence/status?
```

Until then, UCNS has a declared jurisdiction and candidate machinery, not a completed universal scale-transform theorem.

## hmmm

The complete circle → epicycle → disk → sphere → recursive-scale transition law; exact composition across distant scales; the unified attachment/origin law needed to follow one construction across those boundaries; and the relation between current candidate components remain unresolved.

The map now has a legend. The bridge still has to carry weight.
Loading
Loading