Skip to content

Latest commit

 

History

History
30 lines (25 loc) · 1.75 KB

CLAUDE.md

File metadata and controls

30 lines (25 loc) · 1.75 KB

Cacti coding guide

Read AGENTS.md and .github/copilot-instructions.md. The Copilot document contains the established application conventions; AGENTS adds test organization, path-depth and dependency rules. Keep shared guidance free of private security-research notes.

Use mise for the PHP/Node versions declared by Composer, .nvmrc and CI. Use composer check for the canonical checks and composer test -- --testsuite=Unit for focused PHP tests after dependency setup. Run npm ci and npm test for frontend changes; the install rebuilds managed assets, so review generated diffs and preserve build/ and patches/ inputs.

Preserve prepared DB helpers, validated request wrappers, auth/CSRF boundaries, context-specific output escaping and remote-poller behavior. Place Pest tests in category subfolders; never shadow production functions or hand-edit autoloaders. Do not refresh vendored packages by copying source. Preserve runtime directory security guards, GPL notices and the exact branch's compatibility contracts. No live database migration or polling is part of ordinary offline verification.

For poller, script-server, SNMP, subprocess and RRD update work, follow the polling performance sections in AGENTS and the Copilot instructions. Cache template metadata once per process or defined cycle, including empty results; avoid repeated source lookups, launches and fixed per-call sleeps. Preserve source-specific correctness, cache invalidation and bounded memory. Verify query/call counts and subprocess overhead on the actual target branch. Measure credential-cache benefits separately, and never present synthetic scale tests as proof of production RTM throughput.