stacksagent 1.4.0 → 1.5.2

package/README.md

@@ -1,179 +1,422 @@
-# stacksagent
+<!--
+  This README is the single source of truth.
+  It's automatically copied to cli/README.md during `npm run build`
+-->
+
+# Stacks Agent
+
+> AI Skill for building Stacks blockchain applications - Bitcoin's most powerful smart contract layer
+
+An intelligent AI assistant that provides development guidance for Clarity smart contracts, DeFi integration, and blockchain development on Stacks. Works with **Claude Code, Cursor, Windsurf, Antigravity, GitHub Copilot, Kiro, and Codex**.
+
+![Stacks Agent](https://img.shields.io/npm/v/stacks-agent?color=blue&label=stacks-agent)
+![License](https://img.shields.io/npm/l/stacks-agent)
+![Downloads](https://img.shields.io/npm/dm/stacks-agent)
+
+## ✨ Features
+
+**v2.0 Highlights:**
+- 🎯 **40 Production Code Examples** - Real code from live dApps (sbtc-market, stacksagent, STX City)
+- 🕸️ **100 Knowledge Relationships** - Connected concepts across domains
+- 🚫 **Zero Deprecated Code** - All modern @stacks/connect v7+ API patterns
+- 🔒 **Security-First Examples** - Post-conditions, error handling, real vulnerabilities
+
+**495+ Knowledge Base Entries Across 15 Domains:**
+
+### Core Language & Tools (175 entries)
+- **🔷 61 Clarity Functions** - Complete language reference with examples
+- **⚛️ 75 Stacks.js Utilities** - Wallet, transactions, CV constructors, API integration
+- **📋 14 Contract Templates** - SIP-010, SIP-009, DAO, Vault, Marketplace, Stacking
+- **🚀 25 Deployment Steps** - Testnet, mainnet, and devnet workflows
+
+### Domain-Specific Integrations (185 entries)
+- **🌐 21 BNS Operations** - Name registration, resolution (Clarity + JS + API)
+- **💰 25 Stacking Guides** - PoX stacking and pool delegation (Clarity + JS + API)
+- **🔄 25 DeFi Protocols** - Alex, Velar, Bitflow, Zest, StackingDAO (Clarity + JS + API)
+- **🎨 30 NFT Operations** - SIP-009, minting, marketplace patterns (Clarity + JS + API)
+- **💎 40 Token Operations** - SIP-010 fungible tokens, DeFi integrations (Clarity + JS + API)
+- **🔐 14 Authentication** - Wallet auth, JWT, sessions, token-gating (**No Gaia** - deprecated) (Clarity + JS + API)
+- **📊 30 Oracle Integration** - Pyth Network price feeds, VAA handling, Hermes API (Clarity + JS + API)
+
+### Advanced & Specialized (135 entries)
+- **🛡️ 15 Security Patterns** - Common vulnerabilities and secure implementations
+- **🎯 40 Advanced Patterns** - Pagination, SWR, presales, lotteries, vesting, CSV export
+- **🔗 30 Chainhooks** - Event indexing, webhooks, predicates, ordinals tracking
+- **🤖 50 Trading Bots** - Automated trading, wallet SDKs, Privy, bonding curves
+
+## 🎯 Use Cases
+
+- Generate Clarity smart contracts from natural language
+- Audit contracts for security vulnerabilities
+- Integrate with DeFi protocols (swaps, liquidity, lending)
+- Integrate Pyth Network oracle for price feeds
+- Deploy to testnet/mainnet
+- Build dApps with Stacks.js
+- Implement stacking and BNS features
 
-> AI Skill CLI installer for building Stacks blockchain applications
+## 📦 Installation
 
-[![npm version](https://img.shields.io/npm/v/stacksagent.svg)](https://www.npmjs.com/package/stacksagent)
-[![npm downloads](https://img.shields.io/npm/dm/stacksagent.svg)](https://www.npmjs.com/package/stacksagent)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+### Using CLI (Recommended)
 
-Transform your AI coding assistant into a Stacks blockchain expert with 170+ searchable knowledge entries.
+```bash
+# Install globally
+npm install -g stacksagent
 
-## 🎯 Supported AI Platforms
+# Go to your project
+cd /path/to/your/project
+
+# Install for your AI assistant
+stacksagent init --ai claude      # Claude Code
+stacksagent init --ai cursor      # Cursor
+stacksagent init --ai windsurf    # Windsurf
+stacksagent init --ai antigravity # Antigravity
+stacksagent init --ai copilot     # GitHub Copilot
+stacksagent init --ai kiro        # Kiro
+stacksagent init --ai codex       # OpenAI Codex
+stacksagent init --ai all         # All platforms
+```
 
-- **Claude Code** - Claude's official CLI
-- **Cursor** - AI-first code editor
-- **Windsurf** - AI coding assistant
-- **Antigravity** - AI development tool
-- **GitHub Copilot** - GitHub's AI assistant
-- **Kiro** - AI coding helper
-- **Codex** - OpenAI Codex integration
+### Manual Installation
 
-## 📦 Installation
+Copy the appropriate folders to your project:
 
-```bash
-npm install -g stacksagent
-```
+| AI Assistant    | Folders to Copy                                          |
+| --------------- | -------------------------------------------------------- |
+| Claude Code     | `.claude/skills/stacks-agent/`                           |
+| Cursor          | `.cursor/commands/stacks-agent.md` + `.shared/stacks-agent/` |
+| Windsurf        | `.windsurf/workflows/stacks-agent.md` + `.shared/stacks-agent/` |
+| Antigravity     | `.agent/workflows/stacks-agent.md` + `.shared/stacks-agent/` |
+| GitHub Copilot  | `.github/prompts/stacks-agent.prompt.md` + `.shared/stacks-agent/` |
+| Kiro            | `.kiro/steering/stacks-agent.md` + `.shared/stacks-agent/` |
+| Codex           | `.codex/skills/stacks-agent/`                            |
 
 ## 🚀 Usage
 
-### Install for Your AI Platform
+### Claude Code
 
-```bash
-# Claude Code
-stacksagent init --ai claude
+The skill activates automatically when you request Stacks development work, tag or mention the `stacksagent`
+
+```
+Create a meme token called PEPE with 1 billion supply @stacksagent
+```
+
+### Cursor / Windsurf / Antigravity
 
-# Cursor
-stacksagent init --ai cursor
+Use the slash command:
 
-# Windsurf
-stacksagent init --ai windsurf
+```
+/stacks-agent Create a meme token called PEPE with 1 billion supply
+```
 
-# Antigravity
-stacksagent init --ai antigravity
+### GitHub Copilot
 
-# GitHub Copilot
-stacksagent init --ai copilot
+Reference in chat:
 
-# Kiro
-stacksagent init --ai kiro
+```
+@stacks-agent How do I swap tokens on Alex?
+```
 
-# Codex
-stacksagent init --ai codex
+## 💡 Example Prompts
 
-# All platforms at once
-stacksagent init --ai all
+**Basic Queries:**
+```
+"Create a SIP-010 token with burn mechanism"
+"Build an NFT collection with royalties"
+"Audit this Clarity contract for security issues"
+"Deploy my contract to testnet"
 ```
 
-### Force Overwrite
+**Production Code Examples (New in v2.0):**
+```
+"Show me a complete working example of swapping tokens with slippage protection"
+"How do I connect a wallet using the new @stacks/connect v7 API?"
+"Give me production code for NFT marketplace listing"
+"Show me how to integrate Pyth oracle for BTC/USD price"
+"How do I implement JWT authentication with wallet signatures?"
+"Show me a secure token transfer with post-conditions"
+```
 
-```bash
-stacksagent init --ai claude --force
+**With Relationships:**
+```
+"What are the dependencies for implementing a token swap?"
+"Show me all security patterns related to NFT marketplace"
+"What JavaScript SDK functions implement Clarity stacking?"
 ```
 
-### Check Version
+## 🔍 Knowledge Base Search
+
+The skill includes a powerful BM25-based search engine:
 
 ```bash
-stacksagent --version
+# Auto-detect domain
+python3 .claude/skills/stacks-agent/scripts/search.py "define-public"
+
+# Search specific domain
+python3 .claude/skills/stacks-agent/scripts/search.py "swap tokens" --domain defi
+
+# Get more results
+python3 .claude/skills/stacks-agent/scripts/search.py "security" --domain security -n 10
+
+# JSON output
+python3 .claude/skills/stacks-agent/scripts/search.py "stx transfer" --domain stacksjs -f json
 ```
 
-### Update to Latest
+**Available domains**:
+- `clarity` - Syntax and functions
+- `templates` - Contract templates
+- `security` - Security patterns
+- `defi` - DeFi protocols (swaps, liquidity, stacking, oracles)
+- `nfts` - NFT operations (minting, marketplace, royalties)
+- `tokens` - Token operations (SIP-010, vesting, allowances)
+- `auth` - Authentication (wallet connect, JWT, sessions)
+- `stacksjs` - JavaScript snippets
+- `bns` - BNS operations
+- `stacking` - Stacking guides
+- `deployment` - Deployment steps
+- `auto` - Auto-detect (default)
+
+## 🎯 Production Code Examples (New in v2.0)
+
+Search 40 complete, production-tested code examples extracted from live dApps:
 
 ```bash
-stacksagent update
+# Search examples
+python3 .claude/skills/stacks-agent/scripts/search.py "how to swap" --examples
+
+# Filter by domain
+python3 .claude/skills/stacks-agent/scripts/search.py "marketplace" --domain nfts --examples
+
+# Filter by difficulty
+python3 .claude/skills/stacks-agent/scripts/search.py "token" --difficulty beginner --examples
+
+# Search specific example type
+python3 .claude/skills/stacks-agent/scripts/search.py "debug" --example-type debugging
 ```
 
-### List Available Versions
+### Example Types
+- **quickstart** - Single-feature examples (8 examples)
+- **integration** - Multi-step workflows (12 examples)
+- **debugging** - Troubleshooting failed transactions (3 examples)
+- **best-practice** - Recommended patterns (3 examples)
+- **security** - Security-focused implementations (2 examples)
+
+### Example Coverage
+
+**DeFi (10 examples)**:
+- Swap with slippage protection (sbtc-market-frontend)
+- Add/remove liquidity (prediction markets)
+- Pyth oracle integration with VAA
+- Delegate stacking to PoX pools
+- Bonding curve buys (STX City)
+- Multi-hop swap routing
+- Debug failed swaps
+- Secure token approvals
+
+**NFT (10 examples)**:
+- Mint/transfer with SIP-009 compliance
+- Marketplace listing and buying (Gamma patterns)
+- NFT royalties (EIP-2981-like)
+- Batch minting for airdrops
+- Dynamic metadata updates
+- Collection launch workflows
+- Debug transfer failures
+- Secure marketplace with escrow
+
+**Tokens (8 examples)**:
+- Deploy SIP-010 tokens
+- Secure transfers with post-conditions
+- Token allowances (DEX integration)
+- Vesting schedules with cliff periods
+- Token burns (deflationary mechanics)
+- Multi-token atomic swaps
+- Debug transfer failures
+
+**Security (7 examples)**:
+- Reentrancy prevention
+- Integer overflow protection
+- Access control (RBAC)
+- Input validation
+- Rate limiting for DoS
+- Secure randomness
+- Privilege escalation prevention
+
+**Auth (5 examples)**:
+- Wallet connect flow (sbtc-market)
+- JWT authentication via signatures (stacksagent)
+- Protected routes with persistence (STX City)
+- NFT token gating
+- Session management with cleanup
+
+### Example Output Format
+
+Each example includes:
+- ✅ **Complete working code** from production dApps
+- ✅ **Test inputs/outputs** with valid JSON
+- ✅ **Common pitfalls** from real bugs
+- ✅ **Live example URLs** to actual code
+- ✅ **Modern API patterns** (@stacks/connect v7+)
+- ✅ **Security best practices** (post-conditions, deny mode)
+
+## 🕸️ Knowledge Graph Relationships (New in v2.0)
+
+100 relationships connect concepts across domains:
 
 ```bash
-stacksagent versions
+# Get related entries for top results
+python3 .claude/skills/stacks-agent/scripts/search.py "swap tokens" --include-relationships
+
+# Export relationship graph
+python3 -c "from scripts.relationships import get_graph; print(get_graph().export_graph('mermaid'))"
 ```
 
-## 💡 What Gets Installed
+### Relationship Types
+- **requires** - Critical dependency (e.g., "swap requires ft-transfer")
+- **uses** - Functional dependency (e.g., "DEX uses post-conditions")
+- **implements** - Standard compliance (e.g., "token implements SIP-010")
+- **javascript-for** - Language bridge (e.g., "SDK implements Clarity function")
+- **prevents** - Security defense (e.g., "access control prevents unauthorized access")
+- **similar-to** - Alternative approach
+- **conflicts** - Incompatibility
+- **complements** - Enhanced together
 
-The CLI installs platform-specific skill files in your project:
+### Example Output
 
-- **Claude Code**: `.claude/skills/stacks-agent/`
-- **Cursor**: `.cursor/commands/` + `.shared/stacks-agent/`
-- **Windsurf**: `.windsurf/workflows/` + `.shared/stacks-agent/`
-- **Antigravity**: `.agent/workflows/` + `.shared/stacks-agent/`
-- **Copilot**: `.github/prompts/` + `.shared/stacks-agent/`
-- **Kiro**: `.kiro/steering/` + `.shared/stacks-agent/`
-- **Codex**: `.codex/skills/stacks-agent/`
+```
+Search: "name-to-address"
 
-## 📚 Knowledge Base
+Result: bns:1 - name-to-address function
 
-170+ entries across 8 domains:
+📚 Related Entries:
+  [requires] clarity-syntax:59 (strength: 10) - Uses contract-call?
+  [javascript-for] bns:12 (strength: 10) - SDK implements resolution
+  [uses] security-patterns:1 (strength: 8) - Needs access control
+```
 
-- **Clarity** (61) - Language syntax and functions
-- **Templates** (14) - Contract templates (SIP-010, SIP-009, DAO, Vault)
-- **Security** (15) - Vulnerability patterns and fixes
-- **DeFi** (15) - Protocol integrations (Alex, Velar, Bitflow, Zest)
-- **Stacks.js** (30) - Frontend integration snippets
-- **BNS** (10) - Bitcoin Name System operations
-- **Stacking** (15) - PoX stacking guides
-- **Deployment** (25) - Testnet/mainnet deployment steps
+## 📚 Knowledge Base Contents
 
-## 🔍 Search Knowledge Base
+### Clarity Language (61 entries)
+Types, functions, control flow, arithmetic, comparisons, maps, tokens, STX operations
 
-After installation, search the knowledge base:
+### Contract Templates (14 entries)
+- **Tokens**: SIP-010 basic, mintable, burnable, capped
+- **NFTs**: SIP-009 basic, mintable, royalties
+- **DeFi**: Vault basic/timelocked, liquidity pool
+- **DAO**: Basic DAO, treasury management
+- **Other**: Marketplace, stacking pool
 
-```bash
-python3 .claude/skills/stacks-agent/scripts/search.py "your query"
+### Security Patterns (15 entries)
+- Critical: Access control, unchecked transfers
+- High: Reentrancy, arithmetic safety
+- Medium: Input validation, front-running
+- Low: Code style, gas optimization
 
-# Search specific domain
-python3 .claude/skills/stacks-agent/scripts/search.py "swap tokens" --domain defi
+### DeFi Protocols (15 entries)
+Alex, Velar, Bitflow, Zest, StackingDAO, Boost, Faktory integration patterns
 
-# Get more results
-python3 .claude/skills/stacks-agent/scripts/search.py "security" -n 10
+### Stacks.js (30 entries)
+Wallet connection, transactions, Clarity values, API calls, post-conditions
 
-# JSON output
-python3 .claude/skills/stacks-agent/scripts/search.py "stx transfer" -f json
-```
+### BNS (10 entries)
+Name resolution, registration, transfer, updates
 
-## 💬 Example Prompts
+### Stacking (15 entries)
+Direct stacking, delegation, pools, rewards
 
-After installing the skill, ask your AI assistant:
+### Deployment (25 entries)
+Testnet, mainnet, devnet workflows with Clarinet
 
-- "Create a SIP-010 token with burn mechanism"
-- "Build an NFT collection with royalties"
-- "Audit this Clarity contract for security issues"
-- "Show me how to integrate Alex swap"
-- "Deploy my contract to testnet"
-- "How do I implement stacking?"
+## 🛡️ Security Best Practices
 
-## 🛠️ Development
+All generated contracts include:
 
-### Requirements
+- ✅ Access control (`tx-sender` validation)
+- ✅ Error handling (`try!`, `unwrap!`)
+- ✅ Input validation (`asserts!`)
+- ✅ Named error constants
+- ✅ Kebab-case naming
+- ✅ Network compatibility checks
 
-- Node.js 18+
-- Python 3.x (for search functionality)
+## 🌐 Networks
 
-### Build from Source
+- **Mainnet**: Production (SP... addresses)
+- **Testnet**: Testing (ST... addresses, free STX)
+- **Devnet**: Local development (Clarinet)
+
+## 🔧 Prerequisites
+
+- Python 3.x (for search functionality)
+- Node.js 18+ (for CLI installation)
 
 ```bash
-git clone https://github.com/kai-builder/stacksagent.git
-cd stacksagent/cli
-npm install
-npm run build
-npm link
+python3 --version
+node --version
 ```
 
 ## 📖 Documentation
 
-- [Main Repository](https://github.com/kai-builder/stacksagent)
 - [Stacks Docs](https://docs.stacks.co)
 - [Clarity Reference](https://docs.stacks.co/clarity)
 - [Hiro Platform](https://platform.hiro.so)
+- [Explorer (Mainnet)](https://explorer.hiro.so)
+- [Explorer (Testnet)](https://explorer.hiro.so/?chain=testnet)
+
+## 🔗 DeFi Resources
+
+- [Alex DEX](https://app.alexlab.co)
+- [Velar DEX](https://app.velar.co)
+- [Bitflow DEX](https://app.bitflow.finance)
+- [Zest Protocol](https://www.zestprotocol.com)
 
 ## 🤝 Contributing
 
-Contributions welcome! Please see [Contributing Guide](https://github.com/kai-builder/stacksagent/blob/main/CONTRIBUTING.md).
+Contributions are welcome! Please:
+
+1. Fork the repository
+2. Create a feature branch
+3. Make your changes
+4. Add knowledge entries to appropriate CSV files
+5. Test the search functionality
+6. Submit a pull request
 
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) for details.
+MIT License - see [LICENSE](LICENSE) file for details
 
-## 🙏 Credits
+## 🙏 Acknowledgments
 
 Built for the Stacks community with:
-- [Stacks.js](https://github.com/hirosystems/stacks.js)
+- [Stacks.js](https://github.com/hirosystems/stacks.js) by Hiro Systems
 - [Stacks Blockchain](https://www.stacks.co)
 - [Clarity Language](https://docs.stacks.co/clarity)
 
 ## 📞 Support
 
-- **GitHub Issues**: [Report bugs or request features](https://github.com/kai-builder/stacksagent/issues)
-- **Stacks Discord**: [Join the community](https://discord.gg/stacks)
+- GitHub Issues: [Report bugs or request features](https://github.com/kai-builder/stacks-agent/issues)
+- Stacks Discord: [Join the community](https://discord.gg/stacks)
+- Twitter: [@kai_builder](https://twitter.com/kai_builder)
+
+## 🎯 Roadmap
+
+### Completed (v2.0) ✅
+- [x] Multi-platform AI skill support (7 platforms)
+- [x] 495+ knowledge base entries
+- [x] BM25 search engine with regex boosting
+- [x] CLI installer
+- [x] 40 production code examples from live dApps
+- [x] 100 knowledge graph relationships
+- [x] Modern API patterns (@stacks/connect v7+)
+- [x] Deprecated code removal (Gaia, openContractCall, showConnect)
+
+### In Progress (v2.1)
+- [ ] Web-based search interface
+- [ ] Interactive example playground
+- [ ] Community example contributions
+
+### Future (v3.0+)
+- [ ] VSCode extension
+- [ ] Real-time contract analysis
+- [ ] Semantic search with embeddings
+- [ ] Multi-language support (Chinese, Spanish)
 
 ---
 

package/dist/assets/.claude/skills/stacks-agent/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: stacks-agent
-description: AI-powered intelligence for building Stacks blockchain applications
-version: 1.1.4
+description: AI-powered intelligence for building Stacks blockchain applications with 40 production code examples
+version: 2.0.0
 author: kai-builder
 triggers:
   - stacks
@@ -17,6 +17,9 @@ triggers:
   - bns
   - bitcoin
   - web3
+  - wallet connect
+  - pyth oracle
+  - marketplace
 ---
 
 # Stacks Agent Skill
@@ -25,27 +28,50 @@ AI-powered development intelligence for building on Stacks blockchain - Bitcoin'
 
 ## Capabilities
 
+### Core Features
 - **Clarity Contracts**: Generate, audit, and deploy smart contracts
 - **Token Standards**: SIP-010 (fungible) and SIP-009 (NFT) templates
 - **DeFi Integration**: Alex, Velar, Bitflow, Zest, Boost, Faktory protocol patterns
 - **Security Analysis**: Vulnerability detection and best practices
-- **Stacks.js**: Frontend integration code snippets
+- **Stacks.js**: Frontend integration with modern @stacks/connect v7+ API
 - **BNS**: Bitcoin Name System operations
 - **Stacking**: PoX stacking and pool delegation
 - **Deployment**: Testnet and mainnet deployment guides
 
+### New in v2.0 🎉
+- **🎯 40 Production Code Examples**: Complete working code from live dApps (sbtc-market, stacksagent, STX City)
+- **🕸️ 100 Knowledge Relationships**: Connected concepts showing dependencies and prerequisites
+- **🚫 Zero Deprecated Code**: All examples use modern API patterns (no openContractCall, showConnect, or Gaia)
+- **🔒 Security-First**: All examples include post-conditions, error handling, and common pitfalls
+- **🐛 Debugging Examples**: Real-world troubleshooting for failed transactions
+
 ## Knowledge Base
 
-This skill includes searchable databases for:
+### Code Snippets (495+ entries)
 - **61 Clarity functions** - Complete language reference
 - **14 Contract templates** - FT, NFT, DAO, Vault, Marketplace, Stacking
 - **15 Security patterns** - Common vulnerabilities and fixes
-- **15 DeFi protocols** - Alex, Velar, Bitflow, Zest, StackingDAO, Boost, Faktory
-- **76 Stacks.js snippets** - Production wallet patterns (STX/BTC addresses, connect, getLocalStorage, isConnected), transactions, API calls, React hooks, server-side patterns
-- **10 BNS operations** - Name registration and resolution
-- **15 Stacking guides** - PoX stacking and delegation
+- **25 DeFi protocols** - Alex, Velar, Bitflow, Zest, StackingDAO, Boost, Faktory
+- **76 Stacks.js snippets** - Modern @stacks/connect v7+ patterns (wallet, transactions, post-conditions)
+- **21 BNS operations** - Name registration and resolution (Clarity + JS + API)
+- **25 Stacking guides** - PoX stacking and delegation (Clarity + JS + API)
+- **30 Oracle integration** - Pyth Network price feeds with VAA handling (Clarity + JS + API)
 - **25 Deployment steps** - Testnet, mainnet, and devnet
 
+### Production Examples (40 examples - NEW in v2.0)
+- **10 DeFi examples** - Swaps, liquidity, oracles, stacking, bonding curves, debugging
+- **10 NFT examples** - Minting, marketplace, royalties, metadata, batch operations, debugging
+- **8 Token examples** - SIP-010, vesting, allowances, burns, multi-token swaps
+- **7 Security examples** - Reentrancy, overflow, access control, rate limiting
+- **5 Auth examples** - Wallet connect, JWT, sessions, NFT gating (**No Gaia** - deprecated)
+
+### Knowledge Relationships (100 relationships - NEW in v2.0)
+- **requires** - Critical dependencies (e.g., "swap requires ft-transfer")
+- **uses** - Functional dependencies (e.g., "DEX uses post-conditions")
+- **javascript-for** - Language bridges (e.g., "SDK implements Clarity function")
+- **prevents** - Security defenses (e.g., "access control prevents unauthorized access")
+- **And 5 more relationship types** connecting concepts across domains
+
 ## Workflow
 
 ### Step 1: Understand Request
@@ -56,18 +82,36 @@ Analyze user request to determine:
 - Target network (testnet/mainnet)
 
 ### Step 2: Search Knowledge Base
+
+**Code Snippets:**
 ```bash
 python3 .shared/stacks-agent/scripts/search.py "<query>" --domain <domain>
 ```
 
+**Production Examples (v2.0):**
+```bash
+python3 .shared/stacks-agent/scripts/search.py "how to swap" --examples
+python3 .shared/stacks-agent/scripts/search.py "marketplace" --domain nfts --examples
+python3 .shared/stacks-agent/scripts/search.py "token" --difficulty beginner --examples
+```
+
+**With Relationships (v2.0):**
+```bash
+python3 .shared/stacks-agent/scripts/search.py "swap tokens" --include-relationships
+```
+
 Available domains:
 - `clarity` - Clarity syntax and functions
 - `templates` - Contract templates
 - `security` - Security patterns
-- `defi` - DeFi protocol integrations
+- `defi` - DeFi protocol integrations (swaps, liquidity, oracles)
+- `nfts` - NFT operations (minting, marketplace, royalties)
+- `tokens` - Token operations (SIP-010, vesting, allowances)
+- `auth` - Authentication (wallet connect, JWT, sessions - **No Gaia**)
 - `stacksjs` - Stacks.js code snippets
 - `bns` - BNS operations
 - `stacking` - PoX stacking
+- `oracles` - Pyth Network price feeds
 - `deployment` - Deployment guides
 - `auto` - Auto-detect domain (default)
 
@@ -208,6 +252,16 @@ python3 scripts/search.py "stx transfer" --domain stacksjs -f json
 
 ## Version History
 
+- **2.0.0** (2026-01): Major update with production code and relationships
+  - ✅ 40 production code examples from live dApps
+  - ✅ 100 knowledge graph relationships
+  - ✅ Modern @stacks/connect v7+ API patterns
+  - ✅ Deprecated code removal (Gaia, openContractCall, showConnect)
+  - ✅ Security-first examples with post-conditions
+  - ✅ Debugging examples for failed transactions
+  - ✅ Pyth Network oracle integration (30 entries)
+  - ✅ Expanded to 495+ knowledge base entries
+
 - **1.0.0** (2025-01): Initial release with 170+ knowledge entries
   - Clarity syntax and functions
   - Contract templates