@synapta/skills 0.1.0 → 0.1.2

package/skills/repo-bootstrap/references/examples/fastapi-app/src/__init__.py

@@ -0,0 +1,3 @@
+"""FastAPI application package."""
+
+__version__ = "0.1.0"

package/skills/repo-bootstrap/references/examples/fastapi-app/src/config.py

@@ -0,0 +1,49 @@
+"""Application configuration using pydantic-settings."""
+
+from functools import lru_cache
+
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Application settings loaded from environment variables."""
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        case_sensitive=False,
+    )
+
+    # Application
+    app_name: str = "fastapi-app"
+    app_env: str = "development"
+    debug: bool = True
+
+    # Server
+    host: str = "0.0.0.0"
+    port: int = 8000
+    workers: int = 1
+
+    # Database
+    database_url: str = "postgresql://user:password@localhost:5432/fastapi_app"
+
+    # Security
+    secret_key: str = "change-me-in-production"
+    api_key: str = ""
+
+    # External Services
+    redis_url: str = "redis://localhost:6379/0"
+
+    @property
+    def is_production(self) -> bool:
+        """Check if running in production environment."""
+        return self.app_env == "production"
+
+
+@lru_cache
+def get_settings() -> Settings:
+    """Get cached settings instance."""
+    return Settings()
+
+
+settings = get_settings()

package/skills/repo-bootstrap/references/examples/fastapi-app/src/main.py

@@ -0,0 +1,66 @@
+"""FastAPI application entry point."""
+
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+
+import uvicorn
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+
+from src.config import settings
+from src.routes import health, items, users
+
+
+@asynccontextmanager
+async def lifespan(_app: FastAPI) -> AsyncIterator[None]:
+    """Application lifespan context manager."""
+    # Startup
+    print(f"Starting {settings.app_name}...")
+    yield
+    # Shutdown
+    print(f"Shutting down {settings.app_name}...")
+
+
+def create_app() -> FastAPI:
+    """Create and configure the FastAPI application."""
+    app = FastAPI(
+        title=settings.app_name,
+        version="0.1.0",
+        description="Example FastAPI application",
+        lifespan=lifespan,
+    )
+
+    # CORS middleware — wildcard origins here are intentional for this
+    # fixture example only; real deployments must set concrete origins
+    # from settings (e.g. settings.cors_allowed_origins).
+    app.add_middleware(
+        CORSMiddleware,
+        allow_origins=["*"],  # nosemgrep: python.fastapi.security.wildcard-cors.wildcard-cors
+        allow_credentials=True,
+        allow_methods=["*"],
+        allow_headers=["*"],
+    )
+
+    # Include routers
+    app.include_router(health.router, tags=["health"])
+    app.include_router(users.router, prefix="/api/v1/users", tags=["users"])
+    app.include_router(items.router, prefix="/api/v1/items", tags=["items"])
+
+    return app
+
+
+app = create_app()
+
+
+def run() -> None:
+    """Run the application with uvicorn."""
+    uvicorn.run(
+        "src.main:app",
+        host=settings.host,
+        port=settings.port,
+        reload=settings.debug,
+    )
+
+
+if __name__ == "__main__":
+    run()

package/skills/repo-bootstrap/references/examples/fastapi-app/src/models/__init__.py

@@ -0,0 +1,13 @@
+"""Pydantic models for request/response schemas."""
+
+from src.models.item import Item, ItemCreate, ItemUpdate
+from src.models.user import User, UserCreate, UserUpdate
+
+__all__ = [
+    "Item",
+    "ItemCreate",
+    "ItemUpdate",
+    "User",
+    "UserCreate",
+    "UserUpdate",
+]

package/skills/repo-bootstrap/references/examples/fastapi-app/src/models/item.py

@@ -0,0 +1,43 @@
+"""Item model schemas."""
+
+from datetime import datetime
+from decimal import Decimal
+
+from pydantic import BaseModel, Field
+
+
+class ItemBase(BaseModel):
+    """Base item schema with common fields."""
+
+    name: str = Field(..., min_length=1, max_length=200)
+    description: str | None = None
+    price: Decimal = Field(..., ge=0, decimal_places=2)
+    quantity: int = Field(default=0, ge=0)
+    is_available: bool = True
+
+
+class ItemCreate(ItemBase):
+    """Schema for creating a new item."""
+
+    owner_id: int
+
+
+class ItemUpdate(BaseModel):
+    """Schema for updating an existing item."""
+
+    name: str | None = Field(None, min_length=1, max_length=200)
+    description: str | None = None
+    price: Decimal | None = Field(None, ge=0, decimal_places=2)
+    quantity: int | None = Field(None, ge=0)
+    is_available: bool | None = None
+
+
+class Item(ItemBase):
+    """Item response schema."""
+
+    id: int
+    owner_id: int
+    created_at: datetime
+    updated_at: datetime | None = None
+
+    model_config = {"from_attributes": True}

package/skills/repo-bootstrap/references/examples/fastapi-app/src/models/user.py

@@ -0,0 +1,40 @@
+"""User model schemas."""
+
+from datetime import datetime
+
+from pydantic import BaseModel, EmailStr, Field
+
+
+class UserBase(BaseModel):
+    """Base user schema with common fields."""
+
+    email: EmailStr
+    username: str = Field(..., min_length=3, max_length=50)
+    full_name: str | None = None
+    is_active: bool = True
+
+
+class UserCreate(UserBase):
+    """Schema for creating a new user."""
+
+    password: str = Field(..., min_length=8)
+
+
+class UserUpdate(BaseModel):
+    """Schema for updating an existing user."""
+
+    email: EmailStr | None = None
+    username: str | None = Field(None, min_length=3, max_length=50)
+    full_name: str | None = None
+    is_active: bool | None = None
+    password: str | None = Field(None, min_length=8)
+
+
+class User(UserBase):
+    """User response schema."""
+
+    id: int
+    created_at: datetime
+    updated_at: datetime | None = None
+
+    model_config = {"from_attributes": True}

package/skills/repo-bootstrap/references/examples/fastapi-app/src/routes/__init__.py

@@ -0,0 +1,5 @@
+"""API route modules."""
+
+from src.routes import health, items, users
+
+__all__ = ["health", "items", "users"]

package/skills/repo-bootstrap/references/examples/fastapi-app/src/routes/health.py

@@ -0,0 +1,20 @@
+"""Health check endpoints."""
+
+from fastapi import APIRouter
+
+from src.config import settings
+
+router = APIRouter()
+
+
+@router.get("/health")
+async def health_check() -> dict[str, str]:
+    """Basic health check endpoint."""
+    return {"status": "healthy", "app": settings.app_name}
+
+
+@router.get("/ready")
+async def readiness_check() -> dict[str, str]:
+    """Readiness check endpoint."""
+    # Could add database connectivity check here
+    return {"status": "ready"}

package/skills/repo-bootstrap/references/examples/fastapi-app/src/routes/items.py

@@ -0,0 +1,61 @@
+"""Item management endpoints."""
+
+from fastapi import APIRouter, HTTPException, Query, status
+
+from src.models.item import Item, ItemCreate, ItemUpdate
+from src.services.item_service import ItemService
+
+router = APIRouter()
+item_service = ItemService()
+
+
+@router.get("/", response_model=list[Item])
+async def list_items(
+    skip: int = Query(0, ge=0),
+    limit: int = Query(100, ge=1, le=1000),
+    search: str | None = None,
+) -> list[Item]:
+    """List all items with pagination and optional search."""
+    if search:
+        return item_service.search(search, skip=skip, limit=limit)
+    return item_service.get_all(skip=skip, limit=limit)
+
+
+@router.get("/{item_id}", response_model=Item)
+async def get_item(item_id: int) -> Item:
+    """Get a specific item by ID."""
+    item = item_service.get_by_id(item_id)
+    if not item:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Item with id {item_id} not found",
+        )
+    return item
+
+
+@router.post("/", response_model=Item, status_code=status.HTTP_201_CREATED)
+async def create_item(item_data: ItemCreate) -> Item:
+    """Create a new item."""
+    return item_service.create(item_data)
+
+
+@router.put("/{item_id}", response_model=Item)
+async def update_item(item_id: int, item_data: ItemUpdate) -> Item:
+    """Update an existing item."""
+    item = item_service.update(item_id, item_data)
+    if not item:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Item with id {item_id} not found",
+        )
+    return item
+
+
+@router.delete("/{item_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_item(item_id: int) -> None:
+    """Delete an item."""
+    if not item_service.delete(item_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"Item with id {item_id} not found",
+        )

package/skills/repo-bootstrap/references/examples/fastapi-app/src/routes/users.py

@@ -0,0 +1,55 @@
+"""User management endpoints."""
+
+from fastapi import APIRouter, HTTPException, status
+
+from src.models.user import User, UserCreate, UserUpdate
+from src.services.user_service import UserService
+
+router = APIRouter()
+user_service = UserService()
+
+
+@router.get("/", response_model=list[User])
+async def list_users(skip: int = 0, limit: int = 100) -> list[User]:
+    """List all users with pagination."""
+    return user_service.get_all(skip=skip, limit=limit)
+
+
+@router.get("/{user_id}", response_model=User)
+async def get_user(user_id: int) -> User:
+    """Get a specific user by ID."""
+    user = user_service.get_by_id(user_id)
+    if not user:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"User with id {user_id} not found",
+        )
+    return user
+
+
+@router.post("/", response_model=User, status_code=status.HTTP_201_CREATED)
+async def create_user(user_data: UserCreate) -> User:
+    """Create a new user."""
+    return user_service.create(user_data)
+
+
+@router.put("/{user_id}", response_model=User)
+async def update_user(user_id: int, user_data: UserUpdate) -> User:
+    """Update an existing user."""
+    user = user_service.update(user_id, user_data)
+    if not user:
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"User with id {user_id} not found",
+        )
+    return user
+
+
+@router.delete("/{user_id}", status_code=status.HTTP_204_NO_CONTENT)
+async def delete_user(user_id: int) -> None:
+    """Delete a user."""
+    if not user_service.delete(user_id):
+        raise HTTPException(
+            status_code=status.HTTP_404_NOT_FOUND,
+            detail=f"User with id {user_id} not found",
+        )

package/skills/repo-bootstrap/references/examples/fastapi-app/src/services/__init__.py

@@ -0,0 +1,6 @@
+"""Business logic services."""
+
+from src.services.item_service import ItemService
+from src.services.user_service import UserService
+
+__all__ = ["ItemService", "UserService"]

package/skills/repo-bootstrap/references/examples/fastapi-app/src/services/item_service.py

@@ -0,0 +1,77 @@
+"""Item service for business logic."""
+
+from datetime import UTC, datetime
+
+from src.models.item import Item, ItemCreate, ItemUpdate
+
+
+class ItemService:
+    """Service class for item operations."""
+
+    def __init__(self) -> None:
+        """Initialize with in-memory storage for demo."""
+        self._items: dict[int, Item] = {}
+        self._next_id = 1
+
+    def get_all(self, skip: int = 0, limit: int = 100) -> list[Item]:
+        """Get all items with pagination."""
+        items = list(self._items.values())
+        return items[skip : skip + limit]
+
+    def get_by_id(self, item_id: int) -> Item | None:
+        """Get an item by ID."""
+        return self._items.get(item_id)
+
+    def search(self, query: str, skip: int = 0, limit: int = 100) -> list[Item]:
+        """Search items by name or description."""
+        query_lower = query.lower()
+        results = [
+            item
+            for item in self._items.values()
+            if query_lower in item.name.lower()
+            or (item.description and query_lower in item.description.lower())
+        ]
+        return results[skip : skip + limit]
+
+    def get_by_owner(self, owner_id: int) -> list[Item]:
+        """Get all items for a specific owner."""
+        return [item for item in self._items.values() if item.owner_id == owner_id]
+
+    def create(self, item_data: ItemCreate) -> Item:
+        """Create a new item."""
+        item = Item(
+            id=self._next_id,
+            name=item_data.name,
+            description=item_data.description,
+            price=item_data.price,
+            quantity=item_data.quantity,
+            is_available=item_data.is_available,
+            owner_id=item_data.owner_id,
+            created_at=datetime.now(UTC),
+        )
+        self._items[self._next_id] = item
+        self._next_id += 1
+        return item
+
+    def update(self, item_id: int, item_data: ItemUpdate) -> Item | None:
+        """Update an existing item."""
+        item = self._items.get(item_id)
+        if not item:
+            return None
+
+        update_data = item_data.model_dump(exclude_unset=True)
+        updated_item = item.model_copy(
+            update={
+                **update_data,
+                "updated_at": datetime.now(UTC),
+            }
+        )
+        self._items[item_id] = updated_item
+        return updated_item
+
+    def delete(self, item_id: int) -> bool:
+        """Delete an item."""
+        if item_id not in self._items:
+            return False
+        del self._items[item_id]
+        return True

package/skills/repo-bootstrap/references/examples/fastapi-app/src/services/user_service.py

@@ -0,0 +1,69 @@
+"""User service for business logic."""
+
+from datetime import UTC, datetime
+
+from src.models.user import User, UserCreate, UserUpdate
+
+
+class UserService:
+    """Service class for user operations."""
+
+    def __init__(self) -> None:
+        """Initialize with in-memory storage for demo."""
+        self._users: dict[int, User] = {}
+        self._next_id = 1
+
+    def get_all(self, skip: int = 0, limit: int = 100) -> list[User]:
+        """Get all users with pagination."""
+        users = list(self._users.values())
+        return users[skip : skip + limit]
+
+    def get_by_id(self, user_id: int) -> User | None:
+        """Get a user by ID."""
+        return self._users.get(user_id)
+
+    def get_by_email(self, email: str) -> User | None:
+        """Get a user by email."""
+        for user in self._users.values():
+            if user.email == email:
+                return user
+        return None
+
+    def create(self, user_data: UserCreate) -> User:
+        """Create a new user."""
+        user = User(
+            id=self._next_id,
+            email=user_data.email,
+            username=user_data.username,
+            full_name=user_data.full_name,
+            is_active=user_data.is_active,
+            created_at=datetime.now(UTC),
+        )
+        self._users[self._next_id] = user
+        self._next_id += 1
+        return user
+
+    def update(self, user_id: int, user_data: UserUpdate) -> User | None:
+        """Update an existing user."""
+        user = self._users.get(user_id)
+        if not user:
+            return None
+
+        update_data = user_data.model_dump(exclude_unset=True)
+        update_data.pop("password", None)  # Don't include password in response
+
+        updated_user = user.model_copy(
+            update={
+                **update_data,
+                "updated_at": datetime.now(UTC),
+            }
+        )
+        self._users[user_id] = updated_user
+        return updated_user
+
+    def delete(self, user_id: int) -> bool:
+        """Delete a user."""
+        if user_id not in self._users:
+            return False
+        del self._users[user_id]
+        return True

package/skills/repo-bootstrap/references/examples/fastapi-app/uv.lock

@@ -0,0 +1,4 @@
+# This file is auto-generated by uv
+# Placeholder lock file to indicate uv package manager usage
+version = 1
+requires-python = ">=3.11"

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/.scopes

@@ -0,0 +1,3 @@
+# Scopes for Go API with React admin dashboard
+# Format: path:type
+admin:frontend-typescript

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/AGENTS.md

@@ -0,0 +1,86 @@
+<!-- FOR AI AGENTS - Human readability is a side effect, not a goal -->
+<!-- Managed by agent: keep sections and order; edit content, not structure -->
+<!-- Last updated: 2026-02-05 | Last verified: never -->
+
+# AGENTS.md
+
+**Precedence:** the **closest `AGENTS.md`** to the files you're changing wins. Root holds global defaults only.
+
+## Commands (unverified)
+> Source: go.mod — CI-sourced commands are most reliable
+
+<!-- AGENTS-GENERATED:START commands -->
+| Task | Command | ~Time |
+|------|---------|-------|
+| Typecheck | go build -v ./... | ~15s |
+| Format | gofmt -w . | ~5s |
+| Test (single) | go test -v -race | ~2s |
+| Test (all) | go test -v -race -short ./... | ~30s |
+| Build | go build -v ./... | ~30s |
+<!-- AGENTS-GENERATED:END commands -->
+
+> If commands fail, verify against Makefile/package.json/composer.json or ask user to update.
+
+## Workflow
+1. **Before coding**: Read nearest `AGENTS.md` + check Golden Samples for the area you're touching
+2. **After each change**: Run the smallest relevant check (lint → typecheck → single test)
+3. **Before committing**: Run full test suite if changes affect >2 files or touch shared code
+
+## File Map
+<!-- AGENTS-GENERATED:START filemap -->
+```
+admin/           → configuration/data
+cmd/             → CLI entrypoints
+```
+<!-- AGENTS-GENERATED:END filemap -->
+
+## Golden Samples (follow these patterns)
+<!-- AGENTS-GENERATED:START golden-samples -->
+| For | Reference | Key patterns |
+|-----|-----------|--------------|
+| Entrypoint | `cmd/api/main.go` | standard patterns |
+| Entrypoint | `main.go` | standard patterns |
+<!-- AGENTS-GENERATED:END golden-samples -->
+
+## Heuristics (quick decisions)
+<!-- AGENTS-GENERATED:START heuristics -->
+| When | Do |
+|------|-----|
+| Adding package | Internal → `internal/`, Public → `pkg/` |
+| Committing | Use Conventional Commits (feat:, fix:, docs:, etc.) |
+| Merging PRs | Squash and merge |
+| Adding dependency | Ask first - we minimize deps |
+| Unsure about pattern | Check Golden Samples above |
+<!-- AGENTS-GENERATED:END heuristics -->
+
+## Repository Settings
+<!-- AGENTS-GENERATED:START repo-settings -->
+- **Default branch:** `main`
+- **Merge strategy:** squash, merge, rebase
+<!-- AGENTS-GENERATED:END repo-settings -->
+
+## Boundaries
+
+### Always Do
+- Run pre-commit checks before committing
+- Add tests for new code paths
+- Use conventional commit format: `type(scope): subject`
+- Follow Go 1.22 conventions and idioms
+
+### Ask First
+- Adding new dependencies
+- Modifying CI/CD configuration
+- Changing public API signatures
+- Running full e2e test suites
+- Repo-wide refactoring or rewrites
+
+### Never Do
+- Commit secrets, credentials, or sensitive data
+- Modify vendor/, node_modules/, or generated files
+- Push directly to main/master branch
+- Delete migration files or schema changes
+- Commit go.sum without go.mod changes
+
+## When instructions conflict
+The nearest `AGENTS.md` wins. Explicit user prompts override files.
+- For Go-specific patterns, defer to language idioms and standard library conventions

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/admin/package.json

@@ -0,0 +1,20 @@
+{
+    "name": "admin-dashboard",
+    "private": true,
+    "scripts": {
+        "dev": "vite",
+        "build": "vite build",
+        "test": "vitest",
+        "lint": "eslint src"
+    },
+    "dependencies": {
+        "react": "^18.2.0",
+        "react-dom": "^18.2.0"
+    },
+    "devDependencies": {
+        "vite": "^8.0.8",
+        "vitest": "^1.0.0",
+        "eslint": "^8.56.0",
+        "typescript": "^5.3.0"
+    }
+}

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/admin/src/App.tsx

@@ -0,0 +1,5 @@
+import React from 'react';
+
+export default function App() {
+    return <div>Admin Dashboard</div>;
+}

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/cmd/api/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("API entrypoint")
+}

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/go.mod

@@ -0,0 +1,2 @@
+module example.com/api
+go 1.22

package/skills/repo-bootstrap/references/examples/go-api-with-react-admin/main.go

@@ -0,0 +1,7 @@
+package main
+
+import "fmt"
+
+func main() {
+	fmt.Println("API Server")
+}

package/skills/repo-bootstrap/references/examples/go-with-internal-web-tsx/.scopes

@@ -0,0 +1,3 @@
+# Scopes for testing Go+frontend hybrid projects
+# Format: path:type
+internal/web:frontend-typescript