codeninja 3.1.0 → 4.0.0

package/ide/cursor/.cursor/rules/06-code-intelligence.mdc

@@ -1,112 +0,0 @@
----
-description: codeninja code intelligence — loaded for explain, review, debug, optimize, audit commands
-globs: ["**/*"]
-alwaysApply: false
----
-
-# codeninja — Code Intelligence
-
-All analysis commands use real project context — real file names, real column names,
-real service names from context.json. Never generic advice.
-
-## Before Any Analysis
-`context_read` → `fs_read` target → read 1–2 sibling files for pattern comparison.
-
-## /codeninja:explain
-```
-What it is     → 1–2 sentences, plain English
-How it works   → step-by-step key logic (skip boilerplate)
-Why this way   → architectural decision specific to this project
-Where connects → related files, functions, context entries
-```
-Use real names throughout. End: "Want me to explain further or show how to modify it?"
-
-## /codeninja:review — Checklist
-
-| Category | Level if failing | Checks |
-|----------|-----------------|--------|
-| Security | CRITICAL | POST/PUT/PATCH has validatorjs; apiKey middleware present; JWT on protected routes; no hardcoded secrets; parameterized SQL only; errors don't leak internals |
-| Architecture | WARNING | No SQL in route.js; no res.json() in _model.js; route_manager.js registered; swagger has entry; all strings in languages/en.js |
-| Code Quality | SUGGESTION | JSDoc on every function; no unused imports; no console.log; try/catch on async; no SELECT * |
-| Database | WARNING | Column names match context.db.schema; FK columns indexed; transactions on multi-write; LIMIT on unbounded queries |
-
-Output per finding:
-```
-[CRITICAL|WARNING|SUGGESTION]
-File:   path (~line N)
-Issue:  one-line description
-Before: current code
-After:  corrected code
-Why:    one sentence
-```
-End: `X critical · Y warnings · Z suggestions`
-Offer to apply. Confirm each before writing.
-
-## /codeninja:debug — Root Cause Process
-
-Gather: error + stack trace, endpoint, expected vs actual, recent changes.
-
-Request lifecycle trace order:
-```
-Language middleware → API key → JWT auth → Rate limit → Validation → Handler → Model → DB → Response
-```
-
-Common root causes:
-| Symptom | Check |
-|---------|-------|
-| `column does not exist` | context.db.schema vs code column names |
-| `undefined is not a function` | wrong import or missing export |
-| `Cannot read property` | missing null check after 0-row DB result |
-| `401 Unauthorized` | middleware order, header name spelling |
-| `500` | missing try/catch on async DB call |
-| Wrong row count | RANK vs DENSE_RANK, missing WHERE, missing dedup |
-| Migration not applied | table in code but not in DB — run migration |
-
-Fix output:
-```
-Root cause: [precise one sentence]
-File: path
-Before: [buggy code]
-After:  [fixed code]
-Why:    [one sentence]
-```
-Confirm before applying. Suggest one prevention guard after fix.
-
-## /codeninja:optimize — Analysis Checks
-
-DB queries (cross-reference `context.db.schema.<table>.indexes`):
-- Missing index on WHERE/JOIN/ORDER BY column → `CREATE INDEX CONCURRENTLY`
-- `SELECT *` → explicit column list
-- N+1 loop → JOIN or IN clause
-- No `LIMIT` on list queries
-- `RANK()` on leaderboards → `DENSE_RANK()` (no gaps after ties)
-- `DATE(col)` in WHERE → range filter (preserves index use)
-- Duplicate rows → `MIN(id) GROUP BY` dedup
-- Sort spilling to disk → `SET work_mem = '64MB'` session-level
-
-API routes:
-- Repeated DB calls → Redis cache suggestion
-- Missing pagination on list endpoints
-
-Output:
-```
-[HIGH|MED|LOW]
-Target:  what is slow
-Cause:   why it is slow
-Fix:     exact SQL or code
-Gain:    concrete estimate
-```
-For index additions: `migration_next_number` → generate `.sql` migration.
-`context_write` after applying index changes.
-
-## /codeninja:audit — Full Service
-
-Runs full review checklist PLUS:
-- `analyze_middleware_order` MCP tool
-- `analyze_encryption_library` MCP tool
-- `analyze_language_keys` MCP tool
-- `analyze_dependencies` MCP tool
-- `analyze_env_file` MCP tool
-- context.db.schema vs actual code column/table references
-
-Output: severity-ranked report by category. Auto-fix SUGGESTION. Confirm WARNING/CRITICAL.