Python Examples for Context SDK

[richhankins]

Add comprehensive Python SDK examples demonstrating context modes and AI-powered code analysis capabilities.

What's Included

This PR introduces five complete working examples showcasing different ways to use the Auggie SDK's context features:

Core Examples

• Direct Context - API-based indexing with semantic search, AI Q&A, and state persistence for import/export workflows
• FileSystem Context - Local directory search via MCP protocol with automatic on-the-fly indexing
• File Search Server - REST API server providing semantic file search with AI-powered summarization
• Prompt Enhancer Server - HTTP server that enriches vague prompts using AI with codebase context
• GitHub Action Indexer - Production-ready example for indexing GitHub repositories with incremental updates, state persistence, and GitHub Actions integration

Key Features Demonstrated

• Semantic search across codebases using search() and search_and_ask()
• Multiple authentication methods (CLI login, environment variables, session files)
• State management and persistence for efficient re-indexing
• MCP protocol integration for standardized context access
• Incremental indexing using GitHub's Compare API
• REST API patterns for building context-aware services

Documentation

Each example includes:

• Detailed README with prerequisites, usage instructions, and troubleshooting
• Complete working code with inline comments
• Configuration examples and environment variable documentation
• Integration guides (e.g., GitHub Actions workflow setup)

---

🤖 This description was generated automatically. Please react with 👍 if it's helpful or 👎 if it needs improvement.

[github-actions]

This PR adds comprehensive Python SDK examples for the Context SDK. I've identified a few potential bugs and security concerns that should be addressed.

---

🤖 Automated review complete. Please react with 👍 or 👎 on the individual review comments to provide feedback on their usefulness.

[augment-app-staging]

🤖 Augment PR Summary

Summary: This PR adds a comprehensive set of Python examples for the Auggie Context SDK, covering both API-backed and local filesystem-backed context modes.

Changes:

• Expanded examples/python-sdk/README.md to introduce the Context SDK and link to the new context examples.
• Added a new examples/python-sdk/context/ hub README with prerequisites, auth guidance, and troubleshooting.
• Implemented a DirectContext example showing indexing, search(), search_and_ask(), and state export/import.
• Implemented a FileSystemContext example using the MCP protocol (via auggie --mcp) for local semantic search and Q&A.
• Added two small HTTP services: a file-search API server and a prompt-enhancer server, both backed by FileSystem Context.
• Added a GitHub Action Indexer example demonstrating incremental indexing via GitHub Compare API, persisted state, and an install script/workflow template.
• Updated the TypeScript GitHub-action-indexer workflow to upload hidden files in artifacts.

Technical Notes: The indexer downloads tarballs for full re-index, uses Compare API for incremental changes, and filters files (ignore rules, key-ish patterns, UTF-8 checks) before uploading to Direct Context.

_{🤖 Was this summary useful? React with 👍 or 👎}

[augment-app-staging]

Review completed. 5 suggestions posted. Focused on example usability (Python-version/path consistency) and one potential runtime error path.

Fix All in Augment

Comment augment review to trigger a new review at any time.

[richhankins]

augment review

[augment-app-staging]

Review completed. 5 suggestions posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.

[richhankins]

augment review

[augment-app-staging]

Review completed. 1 suggestion posted.

Fix All in Augment

Comment augment review to trigger a new review at any time.