24 lines
1.1 KiB
Plaintext
24 lines
1.1 KiB
Plaintext
# .clinerules — Cline / Roo Code Rules for @bytelyst Common Platform
|
|
# Read AGENTS.md for the complete onboarding guide.
|
|
|
|
## Project: Shared packages + microservices for ByteLyst ecosystem
|
|
Architecture: pnpm monorepo with @bytelyst/* packages + @lysnrai/* Fastify services
|
|
|
|
## Mandatory Rules
|
|
1. Every Cosmos document MUST include a `productId` field
|
|
2. Every endpoint MUST validate input with Zod schemas
|
|
3. Every service MUST propagate `x-request-id` headers
|
|
4. Use `PRODUCT_ID` from `@bytelyst/config` — never hardcode `"lysnrai"`
|
|
5. Services re-export `@bytelyst/*` in `src/lib/` files
|
|
6. Use `req.log` / `app.log` — never `console.log`
|
|
7. ESM only: `"type": "module"`, `.js` extensions in imports
|
|
8. Package manager: `pnpm` — never `npm`
|
|
9. Commits: `type(scope): description`
|
|
10. After changes, verify: `pnpm build && pnpm test`
|
|
|
|
## Key File Locations
|
|
- Packages: `packages/` (@bytelyst/errors, cosmos, config, auth, api-client, fastify-core, react-auth, logger, testing, blob, extraction, monitoring, design-tokens)
|
|
- Services: `services/` (platform-service :4003, extraction-service :4005)
|
|
- Base config: `tsconfig.base.json`
|
|
- Full guide: `AGENTS.md`
|