fix: show update notice before program output, add changelog

Moves the version update notice to appear between transpilation and
program execution so it doesn't interrupt output. Refactors CLI main
to extract common transpilation logic. Adds CHANGELOG.md.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: hiibolt

CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+All notable changes to Rosy are documented here. Versions follow [Semantic Versioning](https://semver.org/).
+
+## [0.3.1] - 2026-03-20
+
+### Fixed
+- Update notice now appears between transpilation and program output instead of after program output
+
+### Changed
+- Refactored CLI main to extract common transpilation logic before Run/Build dispatch
+
+## [0.3.0] - 2026-03-20
+
+### Changed
+- **Docs overhaul**: all module docs rewritten with user-intent "Looking for something?" navigation tables
+- **Module reorganization**: operators grouped into `arithmetic/`, `comparison/`, `unary/`, `collection/`; math functions grouped into `trig/`, `exponential/`, `complex/`, `rounding/`, `vector/`, `query/`, `memory/`
+- README slimmed to showcase + install, pointing users to the full Rustdoc reference
+
+## [0.2.0] - 2026-03-20
+
+### Added
+- CI workflow (`cargo check` + tests on every push/PR)
+- Version-gated docs and release workflows (trigger on `Cargo.toml` version changes, not tags)
+- Auto-injected version in rustdoc header via `env!("CARGO_PKG_VERSION")`
+- Semver versioning with `semver` crate
+- Background update check against GitHub releases (warns if a newer version exists)
+- GitHub Actions release workflow (builds Linux x86_64, macOS x86_64, macOS aarch64)
+- Colored step-by-step transpiler progress output (`[1/5] Parsing...`, etc.)
+- Real-time cargo build output piping (no more silent compilation)
+- `rosy --version` flag
+- Install docs: `cargo install --path rosy`, GitHub Releases, NIU Metis MPI instructions
+
+## [0.1.0] - 2026-03-20
+
+Initial release with core language support.
+
+### Language Features
+- 7 base types: `RE`, `ST`, `LO`, `CM`, `VE`, `DA`, `CD`
+- Multi-dimensional arrays
+- 13 binary operators with full type compatibility
+- 40+ intrinsic functions (trig, exponential, complex, rounding, vector, query, conversion, string)
+- 13 intrinsic procedures (SCRLEN, CPUSEC, QUIT, OS, DA operations, linear algebra, etc.)
+- Control flow: `IF`/`ELSEIF`/`ELSE`, `LOOP`, `WHILE`, `PLOOP` (MPI), `BREAK`
+- `FUNCTION` and `PROCEDURE` definitions with recursion
+- File I/O: `WRITE`, `READ`, `OPENF`, `CLOSEF`, binary I/O
+- `FIT` optimization loop
+- Differential Algebra: `OV`, `DA(n)`, `CD(n)`, `DAPRV`, `DAREV`
+- Optional MPI support via `PLOOP`

rosy/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rosy"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2024"
 
 [dependencies]

rosy/src/main.rs

@@ -323,19 +323,33 @@ fn main() -> Result<()> {
 
     let cli = Cli::parse();
 
-    match cli.command {
-        Commands::Run {
-            source,
-            output_dir,
-            release,
-            cosy_syntax,
-        } => {
-            syntax_config::set_cosy_syntax(cosy_syntax);
-            let binary_path = rosy(&source, output_dir, release)?;
+    // Extract common fields and transpile
+    let (source, output_dir, release, cosy_syntax, output_name) = match &cli.command {
+        Commands::Run { source, output_dir, release, cosy_syntax } => {
+            (source.clone(), output_dir.clone(), *release, *cosy_syntax, None)
+        }
+        Commands::Build { source, output, output_dir, release, cosy_syntax } => {
+            let name = output.clone().unwrap_or_else(|| {
+                source.file_stem()
+                    .and_then(|s| s.to_str())
+                    .unwrap_or("rosy_output")
+                    .to_string()
+            });
+            (source.clone(), output_dir.clone(), *release, *cosy_syntax, Some(name))
+        }
+    };
+
+    syntax_config::set_cosy_syntax(cosy_syntax);
+    let binary_path = rosy(&source, output_dir, release)?;
+
+    // Show update notice after transpilation (network has had time)
+    update_handle.finish();
 
+    // Run or copy the binary
+    match cli.command {
+        Commands::Run { .. } => {
             eprintln!("{BOLD}{CYAN}     Running{RESET} {}\n", source.display());
 
-            // Run the binary, piping stdout and stderr
             let status = Command::new(&binary_path)
                 .status()
                 .with_context(|| format!("Failed to run binary at `{}`!", binary_path.display()))?;
@@ -345,28 +359,8 @@ fn main() -> Result<()> {
                 status.code()
             );
         }
-
-        Commands::Build {
-            source,
-            output,
-            output_dir,
-            release,
-            cosy_syntax,
-        } => {
-            syntax_config::set_cosy_syntax(cosy_syntax);
-            let binary_path = rosy(&source, output_dir, release)?;
-
-            // Determine output name
-            let output_name = output.unwrap_or_else(|| {
-                source
-                    .file_stem()
-                    .and_then(|s| s.to_str())
-                    .unwrap_or("rosy_output")
-                    .to_string()
-            });
-
-            // Copy binary to PWD
-            let destination = PathBuf::from(&output_name);
+        Commands::Build { .. } => {
+            let destination = PathBuf::from(output_name.unwrap());
             std::fs::copy(&binary_path, &destination)
                 .context("Failed to copy binary to current directory")?;
             eprintln!(
@@ -376,8 +370,5 @@ fn main() -> Result<()> {
         }
     }
 
-    // Show update notice if a newer version was found
-    update_handle.finish();
-
     Ok(())
 }