tpmjs AGENTS.md

TPMJS OpenCode Configuration

This file contains project-specific rules and guidance for OpenCode agents working in the TPMJS monorepo.

Repository Overview

TPMJS is a Turborepo monorepo for AI tool discovery and registry. Key characteristics:

• Package Manager: pnpm with workspace configuration
• Build System: Turborepo for task orchestration
• Main App: Next.js 16 App Router (apps/web)
• Component Library: .ts-only React components (packages/ui)
• Database: Prisma with PostgreSQL (packages/db)
• Tool Registry: npm package discovery and metadata sync

Core Commands (Always Use These)

# Development
pnpm dev                    # Start all dev servers
pnpm --filter=@tpmjs/web dev  # Start web app only

# Building (Respects Dependencies)
pnpm build                  # Build all packages
pnpm --filter=@tpmjs/ui build  # Build specific package
pnpm --filter=@tpmjs/web... build  # Build web + all dependencies

# Testing & Quality
pnpm test                   # Run all tests
pnpm lint                   # Lint all packages
pnpm format                 # Format with Biome
pnpm type-check             # TypeScript checking

Architecture Rules (Critical)

Module Boundaries

• Apps (apps/*) can only import from published packages (@tpmjs/*)
• Packages (packages/*) cannot import from apps
• UI Package (packages/ui) cannot import from utils (stays dependency-free)
• No barrel exports - always import directly: @tpmjs/ui/Button/Button

Component Usage

ALWAYS use @tpmjs/ui components instead of raw HTML:

// Good
import { Button } from '@tpmjs/ui/Button/Button';
import { Input } from '@tpmjs/ui/Input/Input';

// Bad
<button onClick={handleClick}>Submit</button>
<input value={value} onChange={onChange} />

TypeScript Configuration

• All packages extend from @tpmjs/tsconfig
• Strict mode enabled
• Composite projects for proper dependency resolution

Package Structure