Cursor rule

1---
2description: "Project context for pmctl — Precious Metals Intelligence CLI"
3alwaysApply: true
4---
5 
6# Project Context
7 
8## Project
9 
10| Field | Value |
11|-------|-------|
12| Name | pmctl |
13| Type | monolith |
14 
15## Active Stacks (directory → router)
16 
17| Directory / path pattern | Router file |
18|--------------------------|-------------|
19| `src/**/*.ts`, `tests/**/*.ts` | `languages/nodejs/nodejs-base.mdc` |
20 
21## Key Dependencies
22 
23| Area | Key deps |
24|------|----------|
25| Runtime | Node.js 20+ (ESM), TypeScript 5.9 (strict) |
26| CLI | commander 14, chalk 5, cli-table3 |
27| Validation | zod 4 |
28| Storage | better-sqlite3 (SQLite — caching + history) |
29| Logging | pino 10, pino-pretty |
30| Rate limiting | bottleneck |
31| LLM | @google/generative-ai (Gemini Flash) |
32| Analysis | technicalindicators |
33| Testing | vitest 4, tsx (dev runner) |
34 
35## Architecture Notes
36 
37CLI tool that fetches data from multiple free REST APIs (Alpha Vantage, MetalpriceAPI, FRED, GDELT, NewsAPI), caches responses in SQLite, computes technical indicators and a composite Buy Score for gold/silver, and optionally generates an LLM narrative via Gemini Flash. No web server — single-command execution model.
38