docs: update CHANGELOG, examples, and bench docs for v1.0.0 accuracy

- Add comprehensive documentation improvements to CHANGELOG.md v1.0.0
- Fix start_session signatures in example files to use keyword arguments
- Add @impl annotations to all example reducer callbacks
- Update bench/README.md version reference from 0.4.0 to 1.0

Author: GSMLG-BOT

CHANGELOG.md

@@ -121,6 +121,35 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
    - Migrate to Redux Store API (SessionProcess IS the store)
    - See `REDUX_TO_SESSIONPROCESS_MIGRATION.md` for detailed migration
 
+### Documentation
+
+- **Emphasized reusable reducers as core motivation**
+  - Updated README.md, CLAUDE.md to highlight reducer composition patterns
+  - Added "Reducer Reusability - Core Value" section with concrete examples
+  - Demonstrated how reducers are defined once and reused across session types
+  - Included examples: UserSessionProcess, AdminSessionProcess, GuestSessionProcess
+- **Added CODE_PROMPT.md for Claude Code assistance**
+  - Comprehensive 700+ line guide for AI-assisted development
+  - Task-based examples covering setup, reducers, controllers, LiveView, testing
+  - Common mistakes section with wrong/correct patterns
+  - Best practices and troubleshooting guidance
+- **Fixed session_id retrieval documentation**
+  - Corrected all examples from `conn.assigns.session_id` to `get_session(conn, :session_id)`
+  - Updated SessionId plug documentation to show correct storage location
+  - Fixed across README.md, CLAUDE.md, CODE_PROMPT.md, and source code
+- **Clarified session lifecycle management**
+  - Documented that sessions should start in router hooks or login controllers
+  - Updated LiveView examples to check for existing sessions, not start them
+  - Added router hook and login controller examples
+- **Fixed API signatures**
+  - Corrected `start_session` examples to use keyword arguments (module:, args:)
+  - Added documentation for missing functions: `touch/1` and `session_stats/0`
+  - Updated all function signatures to match actual implementation
+- **Enhanced reducer documentation**
+  - Added behaviour contract documentation (ProcessBehaviour, ReducerBehaviour)
+  - Explained compile-time validation for reducer structure
+  - Showed @impl annotations for callbacks
+
 ### Notes
 
 - All changes are breaking but migrations are straightforward

bench/README.md

@@ -301,7 +301,7 @@ Add to `mix.exs` for development:
 defp deps do
   [
     {:benchee, "~> 1.0", only: :dev},
-    {:phoenix_session_process, "~> 0.4.0"}
+    {:phoenix_session_process, "~> 1.0"}
   ]
 end
 ```

examples/01_basic_session.exs

@@ -41,7 +41,7 @@ end
 # Create a session
 session_id = "session_#{:rand.uniform(1_000_000)}"
 IO.puts("1. Starting session...")
-{:ok, pid} = Phoenix.SessionProcess.start_session(session_id, BasicSession)
+{:ok, pid} = Phoenix.SessionProcess.start_session(session_id, module: BasicSession)
 IO.puts("   ✓ Session started: #{session_id}")
 IO.puts("   ✓ Process PID: #{inspect(pid)}")
 

examples/02_redux_reducers.exs

@@ -16,10 +16,12 @@ defmodule CounterReducer do
   @name :counter
   @action_prefix "counter"
 
+  @impl true
   def init_state do
     %{count: 0}
   end
 
+  @impl true
   def handle_action(action, state) do
     alias Phoenix.SessionProcess.Action
 
@@ -46,10 +48,12 @@ defmodule UserReducer do
   @name :user
   @action_prefix "user"
 
+  @impl true
   def init_state do
     %{current_user: nil, logged_in: false}
   end
 
+  @impl true
   def handle_action(action, state) do
     alias Phoenix.SessionProcess.Action
 
@@ -70,10 +74,12 @@ end
 defmodule ReduxSession do
   use Phoenix.SessionProcess, :process
 
+  @impl true
   def init_state(_arg) do
     %{}
   end
 
+  @impl true
   def combined_reducers do
     [CounterReducer, UserReducer]
   end
@@ -82,7 +88,7 @@ end
 # Create a session
 session_id = "redux_session_#{:rand.uniform(1_000_000)}"
 IO.puts("1. Starting session with combined reducers...")
-{:ok, _pid} = Phoenix.SessionProcess.start_session(session_id, ReduxSession)
+{:ok, _pid} = Phoenix.SessionProcess.start_session(session_id, module: ReduxSession)
 IO.puts("   ✓ Session started: #{session_id}")
 IO.puts("   ✓ Reducers registered: counter, user")
 

examples/03_async_actions.exs

@@ -15,10 +15,12 @@ defmodule AsyncReducer do
   @name :data
   @action_prefix "data"
 
+  @impl true
   def init_state do
     %{items: [], loading: false, error: nil}
   end
 
+  @impl true
   def handle_action(action, state) do
     alias Phoenix.SessionProcess.Action
 
@@ -41,6 +43,7 @@ defmodule AsyncReducer do
   end
 
   # Handle async actions - MUST return cancellation callback
+  @impl true
   def handle_async(action, dispatch, _state) do
     alias Phoenix.SessionProcess.Action