
============================================================
BLE Reticulum Migration Executive Summary
============================================================

1. Counts by phase/status/tag
phase           status          tag         symbol_c
--------------  --------------  ----------  --------
0_inventory     REVIEWED        GLUE        39      

0_inventory     REVIEWED        PLATFORM    33      

0_inventory     REVIEWED        TEST        3       

1_protocol_cor  FIELD_ACCEPTED  CORE        16      
e                                                   

2_ble_protocol  OPTIONAL_INTEG  GLUE        1       
_session_manag  RATION                              
er                                                  

2. Phase-1 C++ candidates
source_file     class_name      symbol_nam  line_num  tag     status                                                      
--------------  --------------  ----------  --------  ------  ------------------------------------------------------------
src/ble_reticu                  BLEFragmen  52        CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  ter                                                                                       
tation.py                                                                                                                 

src/ble_reticu  BLEFragmenter   __init__    68        CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                                                                                                            
tation.py                                                                                                                 

src/ble_reticu  BLEFragmenter   fragment_p  82        CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  acket                                                                                     
tation.py                                                                                                                 

src/ble_reticu  BLEFragmenter   get_fragme  158       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  nt_overhea                                                                                
tation.py                       d                                                                                         

src/ble_reticu                  BLEReassem  176       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  bler                                                                                      
tation.py                                                                                                                 

src/ble_reticu  BLEReassembler  __init__    187       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                                                                                                            
tation.py                                                                                                                 

src/ble_reticu  BLEReassembler  receive_fr  205       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  agment                                                                                    
tation.py                                                                                                                 

src/ble_reticu  BLEReassembler  _reassembl  380       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  e                                                                                         
tation.py                                                                                                                 

src/ble_reticu  BLEReassembler  cleanup_st  402       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  ale_buffer                                                                                
tation.py                       s                                                                                         

src/ble_reticu  BLEReassembler  get_statis  429       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  tics                                                                                      
tation.py                                                                                                                 

src/ble_reticu  BLEReassembler  reset_stat  443       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  istics                                                                                    
tation.py                                                                                                                 

src/ble_reticu                  HDLCFramer  450       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                                                                                                            
tation.py                                                                                                                 

src/ble_reticu  HDLCFramer      frame_pack  464       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  et                                                                                        
tation.py                                                                                                                 

src/ble_reticu  HDLCFramer      deframe_pa  491       CORE    FIELD_ACCEPTED                                              
lum/BLEFragmen                  cket                                                                                      
tation.py                                                                                                                 

src/ble_reticu  BLEInterface    _handle_id  1202      GLUE    OPTIONAL_INTEGRATION                                        
lum/BLEInterfa                  entity_han                                                                                
ce.py                           dshake                                                                                    

src/ble_reticu  BLEInterface    _get_fragm  1858      CORE    FIELD_ACCEPTED                                              
lum/BLEInterfa                  enter_key                                                                                 
ce.py                                                                                                                     

src/ble_reticu  BLEInterface    _compute_i  1871      CORE    FIELD_ACCEPTED                                              
lum/BLEInterfa                  dentity_ha                                                                                
ce.py                           sh                                                                                        

3. Symbols marked TESTED or ACCEPTED
source_file     class_name      symbol_nam  phase     status  notes_preview                                               
--------------  --------------  ----------  --------  ------  ------------------------------------------------------------
src/ble_reticu                  BLEFragmen  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  ter         ol_core   ACCEPT  ol cell: BLEFragment                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEFragmenter   __init__    1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                              ol_core   ACCEPT  ol cell: BLEFragment                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEFragmenter   fragment_p  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  acket       ol_core   ACCEPT  ol cell: BLEFragment                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEFragmenter   get_fragme  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  nt_overhea  ol_core   ACCEPT  ol cell: BLEFragment                                        
tation.py                       d                     ED                                                                  

src/ble_reticu                  BLEReassem  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  bler        ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEReassembler  __init__    1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                              ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEReassembler  receive_fr  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  agment      ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEReassembler  _reassembl  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  e           ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEReassembler  cleanup_st  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  ale_buffer  ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                       s                     ED                                                                  

src/ble_reticu  BLEReassembler  get_statis  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  tics        ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEReassembler  reset_stat  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  istics      ol_core   ACCEPT  ol cell: BLEReassemb                                        
tation.py                                             ED                                                                  

src/ble_reticu                  HDLCFramer  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                              ol_core   ACCEPT  ol cell: HDLCFramer                                         
tation.py                                             ED                                                                  

src/ble_reticu  HDLCFramer      frame_pack  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  et          ol_core   ACCEPT  ol cell: HDLCFramer.                                        
tation.py                                             ED                                                                  

src/ble_reticu  HDLCFramer      deframe_pa  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEFragmen                  cket        ol_core   ACCEPT  ol cell: HDLCFramer.                                        
tation.py                                             ED                                                                  

src/ble_reticu  BLEInterface    _get_fragm  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEInterfa                  enter_key   ol_core   ACCEPT  ol cell: _get_fragme                                        
ce.py                                                 ED                                                                  

src/ble_reticu  BLEInterface    _compute_i  1_protoc  FIELD_  Imported from Codex_response_20260616_1514.md; original symb
lum/BLEInterfa                  dentity_ha  ol_core   ACCEPT  ol cell: _compute_id                                        
ce.py                           sh                    ED                                                                  

4. Remaining CORE symbols not accepted

5. Unknown or needs-review symbols

6. Do-not-port-yet inventory
tag             symbol_count  
--------------  --------------
GLUE            40            
PLATFORM        33            
TEST            3             

7. Candidate next tasks
source_file     class_name      symbol_nam  line_num  tag     phase                                                         status                cpp_candidate  rationale_preview                                           
--------------  --------------  ----------  --------  ------  ------------------------------------------------------------  --------------------  -------------  ------------------------------------------------------------
src/ble_reticu  BLEInterface    _handle_id  1202      GLUE    2_ble_protocol_session_manager                                OPTIONAL_INTEGRATION  1              Gate 2E added optional BLEPeerSessionManager integration beh
lum/BLEInterfa                  entity_han                                                                                                                       ind BLE_RETICULUM_SESSION_BACKEND. The e                    
ce.py                           dshake                                                                                                                                                                                       

8. Latest review notes
reviewed_at     reviewer        source_fil  class_na  symbol  old_status                                                    new_status            note_preview                                                
--------------  --------------  ----------  --------  ------  ------------------------------------------------------------  --------------------  ------------------------------------------------------------
2026-05-18 23:  jlpoole         src/ble_re  BLEInter  _handl  REVIEWED                                                      REVIEWED              2026-05-18: Gate 2E ARM validation passed on zerodev1 after 
49:39                           ticulum/BL  face      e_iden                                                                                      pull, rebuild of pybind11 extension, and                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-18 23:  jlpoole         src/ble_re  BLEInter  _handl  OPTIONAL_INTEGRATION                                          OPTIONAL_INTEGRATION  2026-05-18: Gate 2E ARM validation passed on zerodev1 after 
49:39                           ticulum/BL  face      e_iden                                                                                      pull, rebuild of pybind11 extension, and                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-18 23:  Codex           src/ble_re  BLEInter  _handl  PYTHON_EQUIVALENT                                             OPTIONAL_INTEGRATION  Gate 2E added optional BLEPeerSessionManager integration beh
42:23                           ticulum/BL  face      e_iden                                                                                      ind BLE_RETICULUM_SESSION_BACKEND. Regre                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-18 23:  Codex           src/ble_re  BLEInter  _handl  PYTHON_BOUND                                                  PYTHON_EQUIVALENT     Gate 2D completed the Python equivalence harness for BLEPeer
20:04                           ticulum/BL  face      e_iden                                                                                      SessionManager. New equivalence test pas                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-18 21:  Codex           src/ble_re  BLEInter  _handl  DESIGN                                                        NATIVE_TESTED         Gate 2B native C++ BLEPeerSessionManager skeleton implemente
58:56                           ticulum/BL  face      e_iden                                                                                      d with pure native tests. Tests passed v                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-18 21:  Codex           src/ble_re  BLEInter  _handl  REVIEWED                                                      DESIGN                Gate 2A opened as design-only. _handle_identity_handshake is
43:11                           ticulum/BL  face      e_iden                                                                                       reference behavior for a future C++ BLE                    
                                EInterface            tity_h                                                                                                                                                  
                                .py                   andsha                                                                                                                                                  
                                                      ke                                                                                                                                                      

2026-05-17 20:  jlpoole + Code  src/ble_re            BLEFra  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL            gmente                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            r                                                                                                                                                       
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEFragm  __init  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  enter     __                                                                                          re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta                                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEFragm  fragme  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  enter     nt_pac                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            ket                                                                                                                                                     
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEFragm  get_fr  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  enter     agment                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            _overh                                                                                                                                                  
                                tion.py               ead                                                                                                                                                     

2026-05-17 20:  jlpoole + Code  src/ble_re            BLERea  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL            ssembl                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            er                                                                                                                                                      
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  __init  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    __                                                                                          re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta                                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  receiv  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    e_frag                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            ment                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  _reass  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    emble                                                                                       re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta                                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  cleanu  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    p_stal                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            e_buff                                                                                                                                                  
                                tion.py               ers                                                                                                                                                     

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  get_st  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    atisti                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            cs                                                                                                                                                      
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  BLEReass  reset_  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  embler    statis                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            tics                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re            HDLCFr  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL            amer                                                                                        re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta                                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  HDLCFram  frame_  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  er        packet                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta                                                                                                                                                                    
                                tion.py                                                                                                                                                                       

2026-05-17 20:  jlpoole + Code  src/ble_re  HDLCFram  defram  FIELD_ACCEPTED                                                FIELD_ACCEPTED        2026-05-17: Phase 1 frozen at git tag phase1-ble-protocol-co
35:48           x + ChatGPT     ticulum/BL  er        e_pack                                                                                      re-20260517. All CORE symbols are FIELD_                    
                                EFragmenta            et                                                                                                                                                      
                                tion.py                                                                                                                                                                       
