docs: v1.0 post-release audit + decision items

PUBLISHING.md

@@ -22,13 +22,13 @@ No PyPI token is needed in CI — the workflow authenticates via OIDC.
 3. **Commit** to main:
    ```bash
    git add pyproject.toml statewave/__init__.py CHANGELOG.md
-   git commit -m "release: v0.X.Y"
+   git commit -m "release: vX.Y.Z"
    git push
    ```
 4. **Wait for CI to pass** on the main branch push.
 5. **Tag and push**:
    ```bash
-   git tag v0.X.Y
+   git tag vX.Y.Z
    git push --tags
    ```
 6. The `release.yml` workflow will:
@@ -51,7 +51,7 @@ No PyPI token is needed in CI — the workflow authenticates via OIDC.
 ## Post-release verification
 
 - [ ] GitHub Release exists at `https://github.com/smaramwbc/statewave-py/releases`
-- [ ] PyPI package updated: `pip install statewave==0.X.Y`
+- [ ] PyPI package updated: `pip install statewave==X.Y.Z`
 - [ ] Import works: `python -c "import statewave; print(statewave.__version__)"`
 - [ ] CHANGELOG version matches tag
 

README.md

@@ -48,6 +48,7 @@ with StatewaveClient(
                 {"role": "assistant", "content": "Welcome Alice!"},
             ]
         },
+        session_id="ticket-8842",  # optional — pins the episode to a session (1.0+)
     )
 
     # Compile memories (idempotent)

SECURITY.md

@@ -70,6 +70,8 @@ This policy applies to all Statewave repositories:
 - `statewave` - Core backend
 - Python SDK (`pip install statewave`, source: github.com/smaramwbc/statewave-py)
 - TypeScript SDK (`npm install @statewavedev/sdk`, source: github.com/smaramwbc/statewave-ts)
+- Connectors (`npm install @statewavedev/connectors-*`, source: github.com/smaramwbc/statewave-connectors)
+- `statewave-bench` - Benchmark harness
 - `statewave-docs` - Documentation
 - `statewave-examples` - Examples
 - `statewave-web` - Marketing site + embedded demo

pyproject.toml

@@ -29,7 +29,7 @@ dependencies = [
 Homepage = "https://statewave.ai"
 Documentation = "https://statewave.ai"
 Repository = "https://github.com/smaramwbc/statewave-py"
-Issues = "https://github.com/smaramwbc/statewave-py/issues"
+Issues = "https://github.com/smaramwbc/statewave/issues"
 Changelog = "https://github.com/smaramwbc/statewave-py/blob/main/CHANGELOG.md"
 
 [project.optional-dependencies]