Added pypi relevant files

.github/workflows/alpha.yml

@@ -9,17 +9,17 @@ on:
 
 jobs:
   validate:
-    runs-on: windows-latest
+    runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v5
 
       - uses: actions/setup-python@v5
         with:
           python-version: "3.11"
           cache: pip
-          cache-dependency-path:
-            - pyproject.toml
-            - poetry.lock
+          cache-dependency-path: |
+            pyproject.toml
+            poetry.lock
 
       - name: Install alpha package
         run: |

.github/workflows/docs-pages.yml

@@ -26,9 +26,9 @@ jobs:
         with:
           python-version: "3.11"
           cache: pip
-          cache-dependency-path:
-            - pyproject.toml
-            - poetry.lock
+          cache-dependency-path: |
+            pyproject.toml
+            poetry.lock
 
       - name: Install project and docs dependencies
         run: |

AGENTS.md

@@ -114,7 +114,7 @@ No skill may override current source or explicit user direction.
 
 ## Release
 
-Current alpha version: 0.4.0.
+Current alpha version: 0.4.0a1.
 
 Notebook, remote, composed-source, and advanced multi-actor paths remain
 experimental. Do not make them release blockers unless promoted into supported

CHANGELOG.md

@@ -10,6 +10,20 @@ Use it together with:
 
 ## Unreleased
 
+## 0.4.0a1 - 2026-07-14
+
+### Changed
+
+- Rebuilt the primary API around inline sources, explicit opt-in views, typed controls, layouts, and `cnv.show()` integration.
+- Unified generic, NEURON, and Jaxley source-level widgets while retaining simulator-native data collection paths.
+- Clarified morphology selection, history capture, and reset versus clear behavior across supported workflows.
+- Replaced the old documentation and test surfaces with a focused alpha guide, example path, and golden-path validation suite.
+
+### Added
+
+- Added representative generic, widget, NEURON, Jaxley, and experimental notebook examples for the current architecture.
+- Added a trusted-publishing GitHub Actions workflow for tagged PyPI releases.
+
 ## 0.3.0 - 2026-05-05
 
 ### Changed

README.md

@@ -7,7 +7,7 @@ integrates those pieces into one application.
 
 ## Alpha Status
 
-CompNeuroVis 0.4.0 is an alpha release. All versions before 1.0.0 are unstable
+CompNeuroVis 0.4.0a1 is an alpha release. All versions before 1.0.0 are unstable
 prereleases. Public APIs may change between releases.
 
 This release supports the inline source workflow used by current examples.
@@ -17,10 +17,10 @@ Notebook, distributed, and multi-source composition paths remain experimental.
 
 CompNeuroVis requires Python 3.11.
 
-Install released package:
+Install the alpha release:
 
 ~~~bash
-pip install compneurovis
+pip install --pre compneurovis
 ~~~
 
 Install current checkout:

docs/examples.md

@@ -72,7 +72,7 @@ their top-of-file instructions before running them.
 ## Experimental Examples
 
 examples/notebook/ demonstrates notebook process and RFB work. Notebook support
-is experimental in 0.4.0.
+is experimental in 0.4.0a1.
 
 examples/debug/ contains focused regressions and renderer diagnostics. They are
 not part of the learning path or supported showcase.

docs/getting-started.md

@@ -8,10 +8,10 @@
 
 ## Install
 
-Released package:
+Alpha release:
 
 ~~~bash
-pip install compneurovis
+pip install --pre compneurovis
 ~~~
 
 Current checkout:

docs/index.md

@@ -44,7 +44,7 @@ when the application needs one.
 
 ## Alpha Scope
 
-Version 0.4.0 is an alpha release. APIs may change before 1.0.0.
+Version 0.4.0a1 is an alpha release. APIs may change before 1.0.0.
 
 Supported release path:
 

pyproject.toml

@@ -4,12 +4,12 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name        = "compneurovis"
-version     = "0.4.0"
+version     = "0.4.0a1"
 description = "Interactive visualization toolkit for computational neuroscience simulations and data"
 authors     = ["Orren Ravid"]
 readme      = "README.md"
 license     = "Apache-2.0"
-repository  = "https://github.com/orrenravid1/CompartmentalNeuronGUI"
+repository  = "https://github.com/orrenravid1/CompNeuroVis"
 packages    = [
   { include = "compneurovis", from = "src" }
 ]