gp3sequencespy 0.1.3__tar.gz → 0.1.4__tar.gz

gp3sequencespy-0.1.3/.hypothesis/constants/80f540432a454169 → gp3sequencespy-0.1.4/.hypothesis/constants/6490da55911cc2f9

@@ -1,4 +1,4 @@
 # file: /home/runner/work/gp3sequencespy/gp3sequencespy/src/gp3sequencespy/__init__.py
 # hypothesis_version: 6.165.10
 
-['0.1.3', 'CovariateSequenceHMM', 'GP3SequencesError', 'GrpStringInput', 'ModelFitError', 'MotifPositionResult', 'ParityError', 'ValidationError', 'WideSequenceAdapter', 'as_arules_sequences', 'as_grpstring_data', 'as_seqhmm_sequences', 'audit_sequence_data', 'cluster_sequences', 'encode_sequence_data', 'fit_sequence_hmm', 'plot_sequence_index', 'plot_sequence_motifs', 'predict_next_state']
+['0.1.4', 'CovariateSequenceHMM', 'GP3SequencesError', 'GrpStringInput', 'ModelFitError', 'MotifPositionResult', 'ParityError', 'ValidationError', 'WideSequenceAdapter', 'as_arules_sequences', 'as_grpstring_data', 'as_seqhmm_sequences', 'audit_sequence_data', 'cluster_sequences', 'encode_sequence_data', 'fit_sequence_hmm', 'plot_sequence_index', 'plot_sequence_motifs', 'predict_next_state']

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/CHANGELOG.md

@@ -7,6 +7,16 @@ All notable changes to `gp3sequencespy` are documented here. The project follows
 
 No changes yet.
 
+## [0.1.4] - 2026-10-09
+
+*Documentation-only maintenance candidate.*
+
+### Documentation
+
+- Integrate the reviewed methods-briefing guide on estimation-visualization boundaries for participant-level scalar sequence summaries versus transition, HMM and other structured estimands.
+- Keep all underlying scientific implementation and the frozen 81-API/R parity surface unchanged; do not advertise new experimental methods.
+- Require existing frozen parity, exact coverage, mutation smoke, strict documentation, fresh wheel, immutable release-asset checks, and trusted PyPI publication gates to pass before publishing.
+
 ## [0.1.3] - 2026-09-21
 
 ### Changed

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/CITATION.cff

@@ -7,8 +7,8 @@ type: software
 authors:
   - family-names: Balaskas
     given-names: Stefanos
-version: 0.1.3
-date-released: 2026-09-21
+version: 0.1.4
+date-released: 2026-10-09
 license: MIT
 repository-code: https://github.com/stefanosbalaskas/gp3sequencespy
 url: https://stefanosbalaskas.github.io/gp3sequencespy/

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: gp3sequencespy
-Version: 0.1.3
+Version: 0.1.4
 Summary: Transparent, reproducible, and auditable analysis of ordered categorical sequences in Python.
 Project-URL: Homepage, https://stefanosbalaskas.github.io/gp3sequencespy/
 Project-URL: Documentation, https://stefanosbalaskas.github.io/gp3sequencespy/
@@ -82,7 +82,7 @@ Description-Content-Type: text/markdown
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/method-map/">Method map</a>
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/plots/">Plot gallery</a>
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/reference/">API reference</a>
-  · <a href="https://github.com/stefanosbalaskas/gp3sequencespy/releases/tag/v0.1.3">v0.1.2</a>
+  · <a href="https://github.com/stefanosbalaskas/gp3sequencespy/releases/tag/v0.1.4">v0.1.4</a>
 </p>
 
 ---
@@ -94,13 +94,13 @@ The package is designed for research workflows where **data preparation, method
 ## Install
 
 ```bash
-pip install gp3sequencespy==0.1.3
+pip install gp3sequencespy==0.1.4
 ```
 
 With `uv`:
 
 ```bash
-uv add gp3sequencespy==0.1.3
+uv add gp3sequencespy==0.1.4
 ```
 
 Python **3.11–3.14** is supported. Optional extras are available for HMM backends, Arrow/Polars data interoperability, performance helpers, time-varying models, documentation, and development.
@@ -176,7 +176,7 @@ Not sure which family fits your question? Use the **[method map](https://stefano
 
 ## Parity and validation
 
-Version **0.1.3** is a maintenance release preserving the 0.1.2 scientific contracts while strengthening release automation and public documentation.
+Version **0.1.4** is a maintenance release preserving the 0.1.2 scientific contracts while strengthening release automation and public documentation.
 
 | Validation contract | Status |
 | --- | ---: |

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/README.md

@@ -26,7 +26,7 @@
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/method-map/">Method map</a>
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/plots/">Plot gallery</a>
   · <a href="https://stefanosbalaskas.github.io/gp3sequencespy/reference/">API reference</a>
-  · <a href="https://github.com/stefanosbalaskas/gp3sequencespy/releases/tag/v0.1.3">v0.1.2</a>
+  · <a href="https://github.com/stefanosbalaskas/gp3sequencespy/releases/tag/v0.1.4">v0.1.4</a>
 </p>
 
 ---
@@ -38,13 +38,13 @@ The package is designed for research workflows where **data preparation, method
 ## Install
 
 ```bash
-pip install gp3sequencespy==0.1.3
+pip install gp3sequencespy==0.1.4
 ```
 
 With `uv`:
 
 ```bash
-uv add gp3sequencespy==0.1.3
+uv add gp3sequencespy==0.1.4
 ```
 
 Python **3.11–3.14** is supported. Optional extras are available for HMM backends, Arrow/Polars data interoperability, performance helpers, time-varying models, documentation, and development.
@@ -120,7 +120,7 @@ Not sure which family fits your question? Use the **[method map](https://stefano
 
 ## Parity and validation
 
-Version **0.1.3** is a maintenance release preserving the 0.1.2 scientific contracts while strengthening release automation and public documentation.
+Version **0.1.4** is a maintenance release preserving the 0.1.2 scientific contracts while strengthening release automation and public documentation.
 
 | Validation contract | Status |
 | --- | ---: |

gp3sequencespy-0.1.4/docs/validation-scope-methods-briefing.md

@@ -0,0 +1,23 @@
+# Sequence analysis: validation scope and provenance
+
+The September 2026 deep-search briefings did **not** identify a new scanpath similarity, HMM, semi-Markov or transition estimator whose validation justifies displacing the existing gp3sequencespy scientific surface. Accordingly, no speculative estimator is being introduced in this development tranche.
+
+## Boundaries of existing sequence inference
+
+Sequences belong to **participants**, **trials**, **sessions** and sometimes **datasets**. A transition table derived from adjacent gaze events can share observations, stimuli and study context across train/test folds even when its rows differ.
+
+Before machine-learning evaluation, externally certify:
+
+- temporal-block separation, trial separation, session separation and participant separation as different properties;
+- participant and trial identity in the canonical sequence table;
+- event-detector and AOI mapping provenance;
+- order, duplicated state positions, undefined states and exposure denominators;
+- genuine within-person pairing versus unpaired cross-source data.
+
+The [GazeForge validation-scope certificates](https://stefanosbalaskas.github.io/GazeForge/validation-scope-certificates/) can independently audit sample/trial/participant/dataset split identities; its research programme extends session and temporal-block checks. Those validation tools do not automatically certify every sequence model.
+
+## Appropriate reporting
+
+Use `participant-generalization` only when no participant ID appears in both training and test groups. Block-wise disjointness alone does not establish unseen-person inference. Separate transition probabilities from causal claims about attentional mechanisms; analyses of event-derived states should report detector and AOI sensitivity where material.
+
+This page is documentation-only. It does not change the public sequence API, installed version, benchmark status or release readiness.

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/mkdocs.yml

@@ -104,6 +104,7 @@ nav:
       - FAQ & troubleshooting: faq.md
   - Articles:
       - Overview: articles/index.md
+      - Sequence validation scope (methods briefing): validation-scope-methods-briefing.md
       - "Getting Started with gp3sequencespy": articles/getting-started-with-gp3sequences.md
       - "Choosing a Sequence-Analysis Method": articles/choosing-a-sequence-analysis-method.md
       - "Sequence Data Validation and Preparation": articles/sequence-data-validation-and-preparation.md

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "gp3sequencespy"
-version = "0.1.3"
+version = "0.1.4"
 description = "Transparent, reproducible, and auditable analysis of ordered categorical sequences in Python."
 readme = "README.md"
 requires-python = ">=3.11"

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/404.html

@@ -672,6 +672,8 @@
         
       
         
+      
+        
       
         
       
@@ -737,6 +739,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="/gp3sequencespy/validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="/gp3sequencespy/articles/getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/choosing-a-sequence-analysis-method/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/consensus-and-group-comparisons/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/contiguous-motif-workflow/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/distances-clustering-and-stability/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/extended-sequence-visualisations/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/getting-started-with-gp3sequences/index.html

@@ -13,7 +13,7 @@
         <link rel="canonical" href="https://stefanosbalaskas.github.io/gp3sequencespy/articles/getting-started-with-gp3sequences/">
       
       
-        <link rel="prev" href="../">
+        <link rel="prev" href="../../validation-scope-methods-briefing/">
       
       
         <link rel="next" href="../choosing-a-sequence-analysis-method/">
@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -751,6 +753,34 @@
                 
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
     
   
   
@@ -2004,7 +2034,7 @@ objects.</p>
       <nav class="md-footer__inner md-grid" aria-label="Footer" >
         
           
-          <a href="../" class="md-footer__link md-footer__link--prev" aria-label="Previous: Overview">
+          <a href="../../validation-scope-methods-briefing/" class="md-footer__link md-footer__link--prev" aria-label="Previous: Sequence validation scope (methods briefing)">
             <div class="md-footer__button md-icon">
               
               <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
@@ -2014,7 +2044,7 @@ objects.</p>
                 Previous
               </span>
               <div class="md-ellipsis">
-                Overview
+                Sequence validation scope (methods briefing)
               </div>
             </div>
           </a>

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/index.html

@@ -16,7 +16,7 @@
         <link rel="prev" href="../faq/">
       
       
-        <link rel="next" href="getting-started-with-gp3sequences/">
+        <link rel="next" href="../validation-scope-methods-briefing/">
       
       
         
@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="getting-started-with-gp3sequences/" class="md-nav__link">
         
@@ -1764,13 +1794,13 @@ names are tested by the documentation suite.</p>
         
         
           
-          <a href="getting-started-with-gp3sequences/" class="md-footer__link md-footer__link--next" aria-label="Next: Getting Started with gp3sequencespy">
+          <a href="../validation-scope-methods-briefing/" class="md-footer__link md-footer__link--next" aria-label="Next: Sequence validation scope (methods briefing)">
             <div class="md-footer__title">
               <span class="md-footer__direction">
                 Next
               </span>
               <div class="md-ellipsis">
-                Getting Started with gp3sequencespy
+                Sequence validation scope (methods briefing)
               </div>
             </div>
             <div class="md-footer__button md-icon">

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/latent-models-and-optional-adapters/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/longitudinal-panel-sequences/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">
         

{gp3sequencespy-0.1.3 → gp3sequencespy-0.1.4}/site/articles/multichannel-and-covariate-hmms/index.html

@@ -687,6 +687,8 @@
         
       
         
+      
+        
       
         
       
@@ -753,6 +755,34 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../validation-scope-methods-briefing/" class="md-nav__link">
+        
+  
+  
+  <span class="md-ellipsis">
+    
+  
+    Sequence validation scope (methods briefing)
+  
+
+    
+  </span>
+  
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../getting-started-with-gp3sequences/" class="md-nav__link">