feat: affixiate Python source into character-first gonols

.github/workflows/python-gonol.yml

@@ -0,0 +1,41 @@
+name: python-gonol
+
+on:
+  pull_request:
+    paths:
+      - "research/python-gonol/**"
+      - "libs/ucns/**"
+      - "README.md"
+      - "AGENTS.md"
+      - "STACK_MANIFEST.md"
+      - "stack-manifest.json"
+      - ".github/workflows/python-gonol.yml"
+  push:
+    branches: [main]
+    paths:
+      - "research/python-gonol/**"
+      - "libs/ucns/**"
+      - "README.md"
+      - "AGENTS.md"
+      - "STACK_MANIFEST.md"
+      - "stack-manifest.json"
+      - ".github/workflows/python-gonol.yml"
+
+permissions:
+  contents: read
+
+jobs:
+  contracts:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+      - name: Install pytest
+        run: python -m pip install pytest
+      - name: Stack structural consistency
+        run: python tools/check_stack_consistency.py
+      - name: Python Gonol construction tests
+        working-directory: research/python-gonol
+        run: python -m pytest -q tests

AGENTS.md

@@ -13,6 +13,10 @@ projects may later graduate into their own repositories.
 - `research/english-gonol/` is a distinct stack-local English lexical/gonol construction
   component. UCNS owns consumed geometry; EDCM may evaluate outputs but does not define
   the English Gonol construction.
+- `research/python-gonol/` is a distinct stack-local Python source/gonol construction
+  component. It owns Python source admission and bottom-up affixiation only; METAPAT owns
+  affixiation semantics, UCNS owns consumed geometry, and parser objects are witnesses
+  rather than gonol identities.
 - root-level emerging projects such as `ahbg/` may be close to external repo-hood; root
   placement does not transfer authority from their inputs.
 - `STACK_MANIFEST.md` and `stack-manifest.json` own stack-level participant provenance.
@@ -105,6 +109,8 @@ coherence; it does not replace workspace behavioral tests.
 - Organization aggregate and website-projection derivation specs are not yet registered.
 - English Gonol Construction has distinct stack-local authority but has not yet gained an
   independent repository/release authority boundary.
+- Python Gonol Construction has distinct stack-local authority but has not yet gained an
+  independent repository/release authority boundary; exact UCNS affixiation geometry is unresolved.
 - The complete root `skill-lib/` snapshot refresh remains separate because the current
   provenance-bound fresh-making doctrine is newer than the local generator snapshot.
 - Project graduation automation remains unimplemented.

README.md

@@ -33,6 +33,7 @@ stack/
 │   ├── metapat/             # current METAPAT research + BASE.json
 │   ├── ucns/                # current UCNS research + BASE.json
 │   ├── english-gonol/       # English lexical/gonol construction; distinct from EDCM
+│   ├── python-gonol/        # Python 3.12 source affixiation from characters upward
 │   ├── edcm/                # current EDCM measurement research + BASE.json
 │   ├── pcea/                # current PCEA research + BASE.json
 │   ├── ptcna/               # current PTCNA research + BASE.json
@@ -77,6 +78,14 @@ English Gonol Construction is a separated stack-local component at
 English text-domain construction candidate. EDCM may evaluate those outputs but does
 not define the construction.
 
+Python Gonol Construction is a separate stack-local component at
+`research/python-gonol/`. It admits every exact Python source occurrence as a character
+gonol, closes the occurrence's applicable character-definition gonols, then affixiates
+lexical forms, delimiters, grammar constructions, and the module from already-closed
+participants. METAPAT owns affixiation semantics; UCNS owns optional consumed geometry;
+Python Gonol owns Python source construction. Tokens and AST nodes are recognition
+witnesses, never gonol substitutes.
+
 ### Change stack structure
 
 Any change that alters a participant, pin, authority, relation, research workspace,
@@ -103,6 +112,8 @@ stack-local implementation.
 
 English Gonol Construction is currently a distinct stack-local research component,
 separated from EDCM but not independently graduated.
+Python Gonol Construction is likewise stack-local and ungraduated; its Python 3.12
+constructor is an implemented candidate, not stack or language canon.
 EPAC and psychsocio metafauna are currently in this pre-graduation state.
 EPAC is further along: it has an independent extracted repository, but extraction is not
 graduation, so its forge research remains here until EPAC completes its release,
@@ -177,6 +188,8 @@ merge.
   is not yet implemented.
 - English Gonol Construction has distinct stack-local authority but has not yet gained an
   independent repository/release authority boundary.
+- Python Gonol Construction has distinct stack-local authority but has not yet gained an
+  independent repository/release authority boundary; UCNS affixiation geometry remains unresolved.
 - Actual VM PostgreSQL/service-account/storage state and the independent backup device
   remain deployment observations until inspected on the VM.
 - A GitHub-hosted executor remains optional and unimplemented; VM-local execution is the

STACK_MANIFEST.md

@@ -7,9 +7,10 @@ Provenance and authority-boundary record for `The-Interdependency/stack`.
 - PCEA canonical refresh UTC: `2026-08-31T07:49:28Z` at `91ffa8c7249dfb810ca64a0bbc500481c0bd12a9`
 - EPAC extraction reconciliation UTC: `2026-09-05` at `d8868858b2e455381ce670797bdbe47189bdc496`
 - English Gonol separation reconciliation UTC: `2026-09-12` at `030022948fb7c749961ae65743a4448c4bb6cbbe`
+- Python Gonol construction baseline UTC: `2026-09-12` at `0e8384bbb60e4c2189016a212bdd0030d04aed7d`
 - Stack-manifest schema: `the-interdependency.stack-manifest` version `1.1.0`
 - Work-graph digest (SHA-256 over canonical `repositories` + `research_participants` + `boundaries` JSON):
-  `9ab3b3f75a32f5f73b5df68419148181fc632593babe4ec6adf4269d4f35badb`
+  `482e9a4f70c18ad4888d1fab32e44a6ab550fe7486fabd2f1253876c266212eb`
 - Machine-readable copy: [`stack-manifest.json`](stack-manifest.json)
 
 ## Directory contract
@@ -52,6 +53,7 @@ release identity.
 | Workspace | Participant | Exact commit | Relation | Canonical release |
 |---|---|---|---|---|
 | `research/english-gonol/` | `The-Interdependency/stack` | `030022948fb7c749961ae65743a4448c4bb6cbbe` | stack-local English lexical/gonol construction separated from EDCM; consumes UCNS geometry; EDCM may evaluate outputs but does not define construction | no |
+| `research/python-gonol/` | `The-Interdependency/stack` | `0e8384bbb60e4c2189016a212bdd0030d04aed7d` | stack-local bottom-up Python 3.12 source gonol construction; applies METAPAT affixiation semantics, consumes optional UCNS geometry, and transfers no language authority to UCNS or EDCM | no |
 | `research/ucns/` | `The-Interdependency/ucns` | `1975fe70cf4e0826a8020c2da3047569e277af64` | explicit source base for integrated stack-local UCNS research; does not refresh or replace the manifest-pinned `libs/ucns` canonical view | no |
 | `research/from-photons-to-macroverse/` | `The-Interdependency/stack` | `77ef8c7fb0ff75a524181655ee9f9641372768f7` | target composition forge baseline at audit start | no |
 | `research/from-photons-to-macroverse/` | `The-Interdependency/skill-lib` | `61eb3b14db440e6ee9b7bf8de3b646dbfd00fb32` | audit, domain-claim, work-graph, and hmmm doctrine | no |
@@ -139,9 +141,14 @@ immutable release, downstream stack reconsumption, and authority-transition rece
 English Gonol Construction is earlier in that lifecycle: it is a distinct stack-local
 research component, not EDCM and not an independent canonical release.
 
+Python Gonol Construction is also stack-local research. Its Python 3.12 source
+constructor has no independent repository/release authority, and its successful replay
+transfers no semantic, geometric, measurement, or language-canon status.
+
 ## hmmm
 
 - UCNS has no `LICENSE` file at pinned commit `828c0b8`.
 - EPAC clean install, license, stable release, downstream reconsumption, and authority-transition receipt remain incomplete; `libs/epac/` stays unpopulated until graduation.
 - English Gonol Construction remains stack-local research; independent repository/release authority has not been established.
+- Python Gonol Construction remains stack-local research; independent repository/release authority and exact UCNS affixiation geometry remain unresolved.
 - `skill-lib/` remains a special operational snapshot at stack root rather than following the ordinary `libs/` + `research/` pair.

research/python-gonol/BASE.json

@@ -0,0 +1,26 @@
+{
+  "schema": "the-interdependency.stack-research-base",
+  "version": "1.0.0",
+  "project": "python-gonol",
+  "source_repository": "The-Interdependency/stack",
+  "source_commit": "0e8384bbb60e4c2189016a212bdd0030d04aed7d",
+  "metapat_prerequisite": {
+    "repository": "The-Interdependency/metapat",
+    "commit": "510e0171f4ecc6d1889e66bb66a8734c49c3b1fa",
+    "relation": "METAPAT owns affixiation semantics; Python Gonol applies them without root impact"
+  },
+  "ucns_prerequisite": {
+    "repository": "The-Interdependency/ucns",
+    "commit": "31bb761e49307b04a7c7dd7c7c2059ea35fdc089",
+    "relation": "UCNS owns geometry and Public Gonol positions; Python Gonol owns no UCNS operation"
+  },
+  "python_language_profile": {
+    "repository": "python/cpython",
+    "tag": "v3.12.14",
+    "commit": "2d7d957248038635334b62b27f650220213d8e5d",
+    "profile": "Python 3.12 file input"
+  },
+  "canon_path": null,
+  "authority": "stack-local Python source gonol construction",
+  "standing": "stack-local-research"
+}

research/python-gonol/README.md

@@ -0,0 +1,67 @@
+# Python Gonol Construction
+
+Stack-local research implementation for affixiating Python source into gonols from its lowest admitted source units upward.
+
+## Construction
+
+```text
+exact decoded source occurrences
+    -> character gonols
+    -> character-definition gonols sharing each character origin
+    -> Python lexical-form gonols from closed character occurrences
+    -> matched delimiter gonols
+    -> recursive Python grammar-construction gonols
+    -> module gonol
+```
+
+Every source occurrence remains independently addressable. Every character may close multiple definition gonols without changing the character's identity: Unicode category/name, Python identifier eligibility, exact-token membership, layout role, quote/comment introducer role, and other profile-backed definitions may coexist. Lexical forms consume the already-closed character occurrences atomically; larger constructions consume already-closed lexical or construction gonols atomically.
+
+`character` means one exact decoded Unicode scalar occurrence. Spaces, newlines, digits, operators, delimiters, letters, and punctuation are all character gonols. Nothing is normalized, deduplicated, trimmed, or silently discarded.
+
+## Recognition boundary
+
+```text
+METAPAT                         affixiation semantics
+    -> UCNS                     geometry and Public Gonol positions
+        -> Python Gonol         Python source admission and construction
+            -> CPython          pinned recognition witness only
+```
+
+The private `_recognition` module uses CPython 3.12 `tokenize` and `ast` after the source occurrence floor has been admitted. Its former public "letter" vocabulary is deprecated and removed from the public receipt: it is now only an internal recognition plan. Token, AST, compiler, and code objects never become gonols and never replace the source-built relation graph.
+
+Any valid Python 3.12 file-input source accepted by the pinned recognition witness is traversed recursively without a grammar-node whitelist. The broad Python 3.12 surface fixture remains a regression witness; exhaustive parity against CPython's complete grammar/test corpus remains `hmmm` rather than being claimed from that fixture alone.
+
+Standing: **implemented stack-local candidate; not canon and not an independent release**.
+
+## Usage guidance
+
+Run from this directory with Python 3.12:
+
+```bash
+python -m python_gonol path/to/source.py --out source.gonol.json --pretty
+python -m python_gonol --verify source.gonol.json
+python -m pytest -q tests
+```
+
+Use the bytes entry point for files so an encoding declaration and exact original bytes remain bound:
+
+```python
+from pathlib import Path
+from python_gonol import affixiate_python_bytes, replay_python_affixiation
+
+path = Path("example.py")
+receipt = affixiate_python_bytes(path.read_bytes(), source_id=path.as_posix())
+replay_python_affixiation(receipt)
+```
+
+For invalid or unfinished source, the constructor retains every admitted character, character-definition, lexical, and matched-delimiter closure available beneath the failure, closes a `python.source.hmmm` root, records the exact tokenizer/delimiter/grammar boundary, and the CLI exits `2`. A missing end parenthesis therefore remains visible without discarding prior construction.
+
+See [`docs/PYTHON_AFFIXIATION_BOUNDARY.md`](docs/PYTHON_AFFIXIATION_BOUNDARY.md) for the contract and [`WORK_GRAPH.json`](WORK_GRAPH.json) for exact inputs.
+
+## hmmm
+
+- exact UCNS geometric operation of Public Gonol function positions;
+- exact UCNS Möbius-carrier affixiation/coupling law;
+- exhaustive parity replay against the complete CPython 3.12 grammar/test corpus;
+- Python language profiles after Python 3.12 file input;
+- streaming/checkpointed receipt materialization for unusually large source trees.

research/python-gonol/WORK_GRAPH.json

@@ -0,0 +1,49 @@
+{
+  "schema": "the-interdependency.stack-manifest",
+  "version": "1.0.0",
+  "work_graph_sha256": "f677e63e96d1d27db543391a0999ed5f89ad1e3cb82656771137f3022cef4660",
+  "repositories": [
+    {
+      "repository": "The-Interdependency/stack",
+      "commit": "0e8384bbb60e4c2189016a212bdd0030d04aed7d",
+      "authority": "stack-local Python Gonol implementation owner",
+      "relation": "construction workspace and starting identity"
+    },
+    {
+      "repository": "The-Interdependency/metapat",
+      "commit": "510e0171f4ecc6d1889e66bb66a8734c49c3b1fa",
+      "authority": "affixiation semantic authority",
+      "relation": "defines identity-preserving recursive affixiation meaning"
+    },
+    {
+      "repository": "The-Interdependency/ucns",
+      "commit": "31bb761e49307b04a7c7dd7c7c2059ea35fdc089",
+      "authority": "geometry and Public Gonol position authority",
+      "relation": "optional explicit geometry observation; no semantic or language authority transfer"
+    },
+    {
+      "repository": "The-Interdependency/skill-lib",
+      "commit": "c3fe833cdd3a35c5dc12b0678e5489c9b6a18741",
+      "authority": "organization-wide construction and evidence discipline",
+      "relation": "gonol-build, work-graph, module, test, and hmmm discipline"
+    },
+    {
+      "repository": "python/cpython",
+      "commit": "2d7d957248038635334b62b27f650220213d8e5d",
+      "authority": "Python 3.12.14 language and CPython recognition witness",
+      "relation": "exact Python language profile source at tag v3.12.14"
+    }
+  ],
+  "boundaries": {
+    "authority_transfer": false,
+    "proof_status_transfer": false,
+    "measurement_status_transfer": false,
+    "semantic_mapping": "external-provenance",
+    "agent_scope": "cross-repository-work-graph",
+    "hmmm": [
+      "exact UCNS Public Gonol function operations remain unresolved",
+      "exact UCNS Mobius-carrier affixiation/coupling law remains unresolved",
+      "Python language profiles after 3.12 remain unresolved"
+    ]
+  }
+}