docs: professional collateral and CI setup for v0.1.0 release

Author: NikitasT2003

.github/workflows/ci.yml

@@ -0,0 +1,30 @@
+name: CI
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.12'
+        
+    - name: Install uv
+      run: curl -LsSf https://astral.sh/uv/install.sh | sh
+      
+    - name: Install dependencies
+      run: uv sync
+      
+    - name: Lint with ruff
+      run: uv run ruff check .
+      
+    - name: Run tests
+      run: uv run pytest

CONTRIBUTING.md

@@ -0,0 +1,25 @@
+# Contributing to agentsrc-py
+
+We welcome contributions! This project uses `uv` for fast, reproducible Python development.
+
+## Setup
+
+1. Install [uv](https://github.com/astral-sh/uv).
+2. Clone the repository: `git clone https://github.com/NikitasT2003/agentsrc-py.git`
+3. Install dependencies: `uv sync`
+4. Run tests to verify setup: `uv run pytest`
+
+## Development Workflow
+
+1. Create a feature branch: `git checkout -b feature/your-feature`
+2. Make your changes.
+3. Verify formatting and linting: `uv run ruff check .`
+4. Run tests: `uv run pytest`
+5. Push your branch and open a Pull Request.
+
+## Pull Request Guidelines
+
+- Ensure all tests pass.
+- Add new tests for new features.
+- Update documentation in `README.md` if necessary.
+- We follow the [MIT License](LICENSE).

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nikitas Tsoumas
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,64 @@
+# 📡 agentsrc-py
+
+![agentsrc banner](assets/banner.png)
+
+> **Semantic Signal Extraction for the Age of AI Agents.**
+
+`agentsrc-py` is a powerful, developer-first utility designed to bridge the gap between LLM-based coding agents and the vast ecosystem of Python dependencies. It fetches, unpacks, and analyzes packages to extract high-fidelity semantic summaries, enabling agents to understand complex APIs instantly without reading thousands of lines of source code.
+
+---
+
+## ⚡ Quickstart
+
+Get up and running in seconds:
+
+```bash
+# Install with uv (recommended)
+uv tool install agentsrc-py
+
+# Initialize a project
+agentsrc init
+
+# Sync and analyze your dependencies
+agentsrc sync
+
+# Query semantic symbols
+agentsrc query search "Pydantic models with validation"
+```
+
+## 🛠️ Key Features
+
+- **🎯 Semantic Analysis**: Extracts classes, functions, and docstrings into structured JSON/Markdown.
+- **🔌 Plugin System**: Extensible architecture to detect framework-specific patterns (e.g., Pydantic Models).
+- **📦 Intelligent Fetching**: Downloads and caches PyPI packages with robust dependency resolution.
+- **🔍 Global Symbol Search**: Instantly find any symbol across your entire dependency tree.
+- **🚀 Built with uv**: Blazing fast performance and reproducible environments.
+
+## 🏗️ Architecture
+
+The following diagram illustrates how `agentsrc-py` transforms raw PyPI packages into actionable semantic intelligence:
+
+```mermaid
+graph TD
+    A[CLI / API] --> B[ProjectResolver]
+    B --> C[PackageFetcher]
+    C --> D[Local Cache]
+    D --> E[ASTAnalyzer]
+    E --> F[Framework Plugins]
+    F --> G[Symbol Map]
+    G --> H[Semantic Markdown]
+```
+
+## 🤝 Contributing
+
+We love contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on our development workflow and how to get started.
+
+## 📄 License
+
+This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
+
+---
+
+<p align="center">
+  Built with ❤️ for the AI Developer Community.
+</p>

git_commit.ps1

@@ -0,0 +1 @@
+git commit -m "docs: professional collateral and CI setup for v0.1.0 release"

git_push.ps1

@@ -0,0 +1 @@
+git push origin master

pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "agentsrc"
 version = "0.1.0"
-description = "A local developer tool that fetches the exact source code of installed Python packages."
+description = "Extract semantic signals for AI Agents from Python dependencies."
 readme = "README.md"
 authors = [
     { name = "NikitasT2003", email = "tsoumasnikitas@gmail.com" }