Merge remote-tracking branch 'origin/main' into release/0.2.0

Author: Patel230

.github/workflows/release.yml

@@ -1,41 +1,18 @@
-# Canonical PyPI publish workflow for hawk-eco Python repos.
+# PyPI publish workflow - DISABLED: package is not published anywhere.
+# If publishing is needed in the future, re-enable and configure:
+# - Add PYPI_API_TOKEN secret at https://github.com/GrayCodeAI/hawk-sdk-python/settings/secrets/actions
+# - Or fix OIDC trusted publisher at https://pypi.org/manage/account/publishing/
 # Triggered by release-please when it pushes a v* tag.
-# Source of truth: https://github.com/GrayCodeAI/hawk/blob/main/.shared-templates/workflows/python-release.yml.tmpl
-#
-# Uses PyPI Trusted Publishing (OIDC) — no API tokens stored in GitHub.
-# Configure once at https://pypi.org/manage/account/publishing/
 
 name: release
 
 on:
   push:
     tags: ["v*"]
 
-permissions:
-  contents: read
-  id-token: write   # required for PyPI Trusted Publishing
+permissions: {}  # disabled
 
 jobs:
   build-and-publish:
     runs-on: ubuntu-latest
-    environment:
-      name: pypi
-      url: https://pypi.org/p/hawk-sdk
-    steps:
-      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
-
-      - uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5.6.0
-        with:
-          python-version: "3.12"
-
-      - name: Install build tooling
-        run: |
-          python -m pip install --upgrade pip build
-
-      - name: Build sdist + wheel
-        run: python -m build
-
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          packages-dir: dist/
+    steps: []  # disabled

AGENTS.md

@@ -8,6 +8,10 @@ alwaysApply: false
 
 Official Python client for the Hawk daemon API.
 
+## Development workflow
+
+When starting any new work (feature, fix, refactor, chore), always create a feature branch from `main` first. Never commit directly to `main`. Use branch naming conventions like `feat/<description>`, `fix/<description>`, or `chore/<description>`. Open a PR, ensure CI is green, then merge.
+
 ## Build & Test
 
 ```bash