Add automated PyPI publishing workflow and polish README

- Add GitHub Actions workflow for Trusted Publishing (publish on tag push)
- Create missing tags: v0.1.1, v0.1.2
- Update PyPI badge to use shields.io (more reliable)
- Add Downloads badge
- Add 'Stability & API Guarantees' section for 0.x expectations
- Document semantic versioning plan for v1.0+

Workflow will auto-publish to PyPI on future tag pushes.
Setup Trusted Publishing at: https://pypi.org/manage/account/publishing/

Author: darshild1024-cpu

.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install build tools
+        run: python -m pip install -U build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

README.md

@@ -2,9 +2,10 @@
 
 **Official Python SDK for [DataSetIQ](https://www.datasetiq.com) — The Modern Economic Data Platform**
 
-[![PyPI version](https://badge.fury.io/py/datasetiq.svg)](https://badge.fury.io/py/datasetiq)
+[![PyPI version](https://img.shields.io/pypi/v/datasetiq.svg)](https://pypi.org/project/datasetiq/)
 [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://img.shields.io/pypi/dm/datasetiq.svg)](https://pypi.org/project/datasetiq/)
 [![GitHub](https://img.shields.io/github/stars/DataSetIQ/datasetiq-python?style=social)](https://github.com/DataSetIQ/datasetiq-python)
 
 ---
@@ -356,6 +357,17 @@ ruff check datasetiq tests
 
 ---
 
+## 🛡️ Stability & API Guarantees
+
+**Current Status: Beta (0.x versions)**
+
+- **Breaking changes** may occur between minor versions (e.g., 0.1.x → 0.2.x)
+- **Core functions** (`get()`, `set_api_key()`) are stable and tested
+- **v1.0 release** will follow semantic versioning with backward compatibility guarantees
+- Subscribe to [GitHub releases](https://github.com/DataSetIQ/datasetiq-python/releases) for updates
+
+---
+
 ## 🗺️ Roadmap
 
 - [ ] Add `get_insight()` for AI-generated analysis