feat: flat structure

Author: Matt Carey

.cursor-rules/examples-standards.mdc

@@ -1,3 +1,7 @@
+---
+description: Standards for creating and maintaining examples for all functionality
+globs: examples/*
+---
 # Examples Standards
 
 Standards for creating and maintaining examples in the StackOne repository.
@@ -9,8 +13,6 @@ description: Standards for creating and maintaining examples for all functionali
 filters:
   - type: path
     pattern: "^examples/.*"
-  - type: path
-    pattern: "^packages/.*/.*"
 
 actions:
   - type: suggest
@@ -36,8 +38,6 @@ actions:
          - Load credentials from .env
          - Include type hints
          - Follow the same code style as the main codebase
-         - Always use "gpt-4o-mini" as the model name in LLM examples
-         - Keep examples minimal and focused on demonstrating specific functionality
 
       3. Documentation:
          - Each example file should start with a docstring explaining its purpose
@@ -55,21 +55,14 @@ examples:
       import os
       from dotenv import load_dotenv
       from stackone_ai import StackOneToolSet
-      from openai import OpenAI
 
       def main():
-          """Example showing basic usage of StackOneToolSet with OpenAI."""
+          """Example showing basic usage of StackOneToolSet."""
           load_dotenv()
 
           api_key = os.getenv("STACKONE_API_KEY")
           if not api_key:
               raise ValueError("STACKONE_API_KEY not found")
-          
-          client = OpenAI()
-          response = client.chat.completions.create(
-              model="gpt-4o-mini",  # Always use gpt-4o-mini in examples
-              messages=[{"role": "user", "content": "Hello"}]
-          )
 
           # Example code...
 
@@ -78,16 +71,12 @@ examples:
     output: "Correctly structured example"
 
   - input: |
-      # Bad example - missing error handling, docs, types, wrong model name
+      # Bad example - missing error handling, docs, types
       from stackone_ai import StackOneToolSet
-      from openai import OpenAI
 
       toolset = StackOneToolSet("hardcoded_key")
-      client = OpenAI()
-      response = client.chat.completions.create(
-          model="gpt-4",  # Wrong - should use gpt-4o-mini
-          messages=[{"role": "user", "content": "Hello"}]
-      )
+      tools = toolset.get_tools("crm")
+      result = tools["some_tool"].execute()
     output: "Incorrectly structured example"
 
 metadata:

.cursor/rules/examples-standards.mdc

@@ -29,9 +29,6 @@ actions:
 
       2. Package Level Dependencies:
          ```bash
-         # Navigate to package directory
-         cd packages/stackone-core
-
          # Install package dependencies
          uv add pydantic
          uv add requests
@@ -52,7 +49,10 @@ actions:
          uv run pytest
 
          # Run specific package tests
-         uv run pytest packages/stackone-core/tests/
+         uv run pytest stackone_ai
+
+         #Run tests on examples 
+         uv run pytest examples
          ```
 
       5. Package Dependencies:
@@ -72,7 +72,6 @@ examples:
       uv add --dev black
 
       # Good: Installing package dependencies
-      cd packages/stackone-core
       uv add pydantic
 
       # Bad: Using pip install

.cursor/rules/new-stackone-package.mdc

@@ -14,7 +14,7 @@ filters:
   - type: path
     pattern: "^scripts/.*"
   - type: exclude_path
-    pattern: "^(packages|examples)/.*"  # Exclude packages and examples
+    pattern: "^(stackone_ai|examples)/.*"  # Exclude package and examples
 
 actions:
   - type: suggest

.cursor/rules/package-installation.mdc

@@ -26,4 +26,4 @@ jobs:
           args: check .
 
       - name: Run Mypy
-        run: uv run mypy packages/stackone-ai/stackone_ai
+        run: uv run mypy stackone_ai

.cursor/rules/test-standards.mdc

@@ -35,6 +35,5 @@ jobs:
         env:
           UV_PUBLISH_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
         run: |
-          cd packages/stackone-ai
           uv build --no-sources
           uv publish

.cursor/rules/uv-scripts.mdc

@@ -11,3 +11,7 @@ __pycache__
 # Documentation build
 .docs/
 site/
+
+*.egg-info
+dist/
+build/

.github/workflows/lint.yml

@@ -10,7 +10,7 @@ repos:
     rev: v1.8.0
     hooks:
       - id: mypy
-        files: ^packages/stackone-ai/stackone_ai/
+        files: ^stackone_ai/
         additional_dependencies:
           - types-requests
           - types-PyYAML