Update dependencies and enhance documentation

- Bumped `setuptools` version requirement in `pyproject.toml` to ensure compatibility with newer features.
- Added `license-files` entry in `pyproject.toml` for better license management.
- Expanded `README.md` with additional usage examples for the `auralog` helper function, improving clarity for users.
- Updated `dev-docs/README.md` to include project description, package naming conventions, and publishing setup details for maintainers.

Author: Bhanu-Vardhan-Reddy

LICENSE

@@ -0,0 +1,17 @@
+ISC License
+
+Copyright (c) 2026, Bhanu Vardhan Reddy Nanavala
+
+Contact: nbhanuvardhanreddy@gmail.com
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

README.md

@@ -2,6 +2,18 @@
 
 Command-line client for [Auralogger](https://auralogger.com): `init`, `server-check`, `client-check`, `test-serverlog`, `test-clientlog`, and `get-logs`, plus the `aura_log` helper for Python apps.
 
+```text
+├── LICENSE
+├── pyproject.toml
+├── README.md
+```
+
+## Package naming (Node vs Python)
+
+- Python distribution name: `auralogger` (install with `pip install auralogger`)
+- Node distribution name: `auralogger-cli` (install with `npm install auralogger-cli`)
+- Both expose the CLI command `auralogger`, but package names on package indexes are intentionally different.
+
 ## Install
 
 From [PyPI](https://pypi.org/) (once published):
@@ -22,8 +34,6 @@ The CLI uses **your shell’s current working directory** as the project root. I
 
 Configuration is **environment variables** only — see **`user-docs/environment.md`** for **`AURALOGGER_PROJECT_TOKEN`**, **`AURALOGGER_USER_SECRET`**, and the publishable `AURALOGGER_PROJECT_*` keys. There is no `auralogger.config.json`.
 
-**Wire contract (matches Node):** `proj_auth` is **`POST /api/{project_token}/proj_auth`** with the token in the path only. **`get-logs`** uses **`POST /api/{project_token}/logs`** with headers **`secret`** and **`user_secret`** both set to your **user secret**. The server ingest socket is **`WS /{project_token}/create_log`** with **`Authorization: Bearer <user_secret>`**. Set **`AURALOGGER_PROJECT_TOKEN`** and **`AURALOGGER_USER_SECRET`**; legacy **`AURALOGGER_PROJECT_SECRET`** is treated as the user secret (with a deprecation warning) if **`AURALOGGER_USER_SECRET`** is unset.
-
 ```bash
 cd /path/to/my-app
 auralogger init
@@ -63,6 +73,28 @@ auralog(
 )
 ```
 
+## Using the generated `auralog(...)` helper
+
+After `auralogger init`, paste the server snippet into your app (for example `your_server_auralog_file.py`), then use it like this:
+
+```python
+from your_server_auralog_file import auralog
+
+auralog(
+    "info",
+    "Request completed",
+    "api/orders#create",
+    {"order_id": "ord_123", "status": 201},
+)
+# expected: [info] Request completed @ api/orders#create {"order_id": "ord_123", "status": 201}
+
+auralog("warn", "Cache miss")
+# expected: [warn] Cache miss
+
+auralog("error", "Payment gateway timeout", data={"provider": "stripe"})
+# expected: [error] Payment gateway timeout {"provider": "stripe"}
+```
+
 ## Commands
 
 ```text
@@ -93,21 +125,3 @@ Install editable package + development tooling (currently Ruff):
 cd python
 pip install -e ".[dev]"
 ```
-
-## Publishing (maintainers)
-
-Releases are automated through `.github/workflows/python-publish.yml`.
-
-- The workflow runs on GitHub release publish events only when the tag matches `python-v*` (for example, `python-v0.1.1`), or through manual `workflow_dispatch`.
-- Configure repository secret `PYPI_API_TOKEN` with a PyPI API token.
-- Before tagging, bump `version` in `python/pyproject.toml` and update `python/CHANGELOG.md`.
-
-Manual fallback from this directory, after configuring PyPI credentials (`twine`):
-
-```bash
-python -m pip install build twine
-python -m build
-twine upload dist/*
-```
-
-End users only need `pip install auralogger` once the release is on PyPI.

auralogger/cli/commands/init.py

@@ -172,28 +172,26 @@ def _build_server_integration_snippet() -> str:
         [
             "import os",
             "from typing import Any, Dict, Literal, Optional",
-            "from pydantic import BaseModel, Field",
             "from auralogger import AuraServer",
             "",
-            "class LogInputs(BaseModel):",
-            "    type: Literal['debug', 'info', 'warn', 'error'] = 'info'",
-            "    message: str = Field(..., min_length=1)",
-            "    location: Optional[str] = None",
-            "    data: Optional[Dict[str, Any]] = None",
-            "",
             "def configure_auralogger() -> None:",
             "    project_token = os.environ.get('AURALOGGER_PROJECT_TOKEN', '').strip()",
             "    user_secret = os.environ.get('AURALOGGER_USER_SECRET', '').strip()",
             "    if not project_token or not user_secret:",
             "        raise RuntimeError('Missing Auralogger server env variables')",
             "    AuraServer.sync_from_secret(project_token, user_secret)",
             "",
-            "def auralog(loginputs: LogInputs) -> None:",
+            "def auralog(",
+            "    type: Literal['debug', 'info', 'warn', 'error'],",
+            "    message: str,",
+            "    location: Optional[str] = None,",
+            "    data: Optional[Dict[str, Any]] = None,",
+            ") -> None:",
             "    AuraServer.log(",
-            "        loginputs.type,",
-            "        loginputs.message,",
-            "        loginputs.location,",
-            "        loginputs.data,",
+            "        type,",
+            "        message,",
+            "        location,",
+            "        data,",
             "    )",
         ]
     )
@@ -226,6 +224,28 @@ def _build_client_integration_snippet() -> str:
     )
 
 
+def _build_server_usage_snippet() -> str:
+    return "\n".join(
+        [
+            "from your_server_auralog_file import auralog",
+            "",
+            "auralog(",
+            "    'info',",
+            "    'Request completed',",
+            "    'api/orders#create',",
+            "    {'order_id': 'ord_123', 'status': 201},",
+            ")",
+            "# expected: [info] Request completed @ api/orders#create {'order_id': 'ord_123', 'status': 201}",
+            "",
+            "auralog('warn', 'Cache miss')",
+            "# expected: [warn] Cache miss",
+            "",
+            "auralog('error', 'Payment gateway timeout', data={'provider': 'stripe'})",
+            "# expected: [error] Payment gateway timeout {'provider': 'stripe'}",
+        ]
+    )
+
+
 def print_two_auralog_explainer() -> None:
     print()
     print(
@@ -274,6 +294,10 @@ def print_init_helper_snippets_with_character_voices() -> None:
         "Server-side AuraLog — auralogger (AuraServer)",
         _build_server_integration_snippet(),
     )
+    _print_python_code_story(
+        "Using your generated auralog helper (server example logs)",
+        _build_server_usage_snippet(),
+    )
     print(
         dim(
             "   If your frontend runtime is JavaScript/TypeScript, use the Node package "

dev-docs/README.md

@@ -2,13 +2,44 @@
 
 Contributor-oriented notes for the Python `auralogger` package.
 
+## Python package repo
+
+- Source/publishing repo: [Beever-Labs/auralogger-python](https://github.com/Beever-Labs/auralogger-python)
+
+## Project description
+
+`auralogger` (Python): command-line client for Auralogger: `init`, `server-check`, `client-check`, `test-serverlog`, `test-clientlog`, and `get-logs`, plus the `aura_log` helper for Python apps.
+
+```text
+├── LICENSE
+├── pyproject.toml
+├── README.md
+```
+
+## Package naming (Node vs Python)
+
+- Python distribution name: `auralogger` (`pip install auralogger`)
+- Node distribution name: `auralogger-cli` (`npm install auralogger-cli`)
+- Both expose the CLI command `auralogger`, but package-index names are intentionally different.
+
 ## Start here
 
 - `file-map.md`: quick map of what each important module does
 - `routes.md`: HTTP + WebSocket routes and where they are used in this package
 
 Auth contract (match Node / hosted API): **`POST /api/{project_token}/proj_auth`** — token in path only. **`POST /api/{project_token}/logs`** — headers **`secret`** and **`user_secret`** both set to the **user secret**. Server ingest WebSocket — **`Authorization: Bearer <user_secret>`** on **`/{project_token}/create_log`**.
 
+## Publishing setup (maintainers)
+
+- Automated release workflow: `.github/workflows/python-publish.yml`
+- Trigger: GitHub release publish for tags matching `python-v*` (for example, `python-v0.1.1`) or manual `workflow_dispatch`
+- Required secret: `PYPI_API_TOKEN`
+- Before release: bump `version` in `pyproject.toml` and update `CHANGELOG.md`
+- Manual fallback:
+  - `python -m pip install build twine`
+  - `python -m build`
+  - `twine upload dist/*`
+
 ## Related folders
 
 - `user-docs/commands.md`: end-user setup and command reference (keep in sync when behavior changes)

pyproject.toml

@@ -1,5 +1,5 @@
 [build-system]
-requires = ["setuptools>=61", "wheel"]
+requires = ["setuptools>=77", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
@@ -8,6 +8,7 @@ version = "0.1.0"
 description = "CLI for Auralogger: init, logs, and websocket checks (project-scoped to your cwd)."
 readme = "README.md"
 license = "ISC"
+license-files = ["LICENSE"]
 requires-python = ">=3.8"
 authors = [
   { name = "Bhanu Vardhan Reddy Nanavala" },