docs(readme): add link to demos directory and fix pyproject.toml per-file-ignore path

Author: JohnRichard4096

README.md

@@ -62,6 +62,8 @@ pc = WorkflowPC(flow.render())
 pc.run_sync()
 ```
 
+See more demos in `demos/`
+
 ## Documentation
 
 Full guides, concept explanations, and API reference at **[sense.amritabot.com](https://sense.amritabot.com)**.

pyproject.toml

@@ -52,7 +52,7 @@ ignore = [
     "RUF003", # ambiguous-unicode-character-comment
 ]
 [tool.ruff.lint.per-file-ignores]
-"demo/*.py" = ["ASYNC250"]
+"demos/*.py" = ["ASYNC250"]
 "tests/*.py" = ["ASYNC250", "PERF401"]
 
 [tool.pyright]

scripts/ci.sh

@@ -0,0 +1,35 @@
+#!/usr/bin/env bash
+# ci.sh — Full CI pipeline (init → lint → test → build).
+# Run this locally to simulate what CI does.
+set -euo pipefail
+
+echo "========== 1. Init environment =========="
+uv venv
+uv sync
+
+echo ""
+echo "========== 2. Type check (Pyright) =========="
+uv run pyright
+
+echo ""
+echo "========== 3. Lint (Ruff) =========="
+uv run ruff check .
+
+echo ""
+echo "========== 4. Unit tests with coverage =========="
+uv run pytest tests/ \
+    --cov=src/amrita_sense \
+    --cov-report=term-missing \
+    --cov-report=xml \
+    -v
+
+echo ""
+echo "========== 5. Build package =========="
+uv build
+
+echo ""
+echo "========== 6. Build docs =========="
+npm run docs:build
+
+echo ""
+echo "=== CI pipeline complete ==="

scripts/docs-build.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# docs-build.sh — Build the VitePress documentation.
+set -euo pipefail
+
+echo "=== Building docs ==="
+npm run docs:build

scripts/docs-dev.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# docs-dev.sh — Start the VitePress dev server with hot reload.
+set -euo pipefail
+
+echo "=== Starting VitePress dev server ==="
+npm run docs:dev

scripts/docs-init.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# docs-init.sh — Install docs dependencies.
+set -euo pipefail
+
+echo "=== Installing docs dependencies ==="
+npm install

scripts/init-env.sh

@@ -0,0 +1,12 @@
+#!/usr/bin/env bash
+# init-env.sh — Initialize the Python virtual environment and install dependencies.
+set -euo pipefail
+
+echo "=== Creating virtual environment ==="
+uv venv
+
+echo "=== Installing dependencies ==="
+uv sync
+
+echo "=== Done ==="
+echo "Activate with: source .venv/bin/activate"

scripts/lint.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# lint.sh — Run linters and type checker.
+set -euo pipefail
+
+echo "=== Pyright ==="
+uv run pyright
+
+echo ""
+echo "=== Ruff check ==="
+uv run ruff check .
+
+echo ""
+echo "=== Ruff format check ==="
+uv run ruff format --check .

scripts/test-cov.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# test-cov.sh — Run unit tests with coverage report.
+set -euo pipefail
+
+echo "=== Running tests with coverage ==="
+uv run pytest tests/ \
+    --cov=src/amrita_sense \
+    --cov-report=term-missing \
+    --cov-report=xml \
+    -v

scripts/test.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+# test.sh — Run unit tests without coverage.
+set -euo pipefail
+
+echo "=== Running unit tests ==="
+uv run pytest tests/ -v