Standards alignment: Document .js tools deviation, fix port 3030, enhance tool documentation

This commit is contained in:
2026-01-14 12:47:22 +00:00
parent 2c384eb734
commit 534016e9d5
6 changed files with 226 additions and 4 deletions
+28 -1
View File
@@ -30,5 +30,32 @@ Reviewed: No
Reviewer: Monica
================================================================================
END OF DEVIATIONS LOG
DEVIATION: Tool Files Use Vanilla JavaScript (.js)
================================================================================
Reasoning: Standalone utility tools (screen-capture, screen-record, user-alert)
designed as reusable browser-side modules. Vanilla JS allows direct browser
execution without build step. Tools are self-contained utilities, not critical
business logic. Conversion to TypeScript not necessary at current maturity.
Affected Files:
- /tools/screen-capture/index.js (246 LOC)
- /tools/screen-record/index.js (165 LOC)
- /tools/user-alert/index.js (196 LOC)
Implications:
- Loss of type safety on tool internals (no IDE autocomplete, no .ts checks)
- Tools cannot be used in strict TypeScript environments without @ts-ignore
- Maintenance slightly harder as tool complexity grows
Standards Violated:
- LANGUAGE: TypeScript (Frontend & Backend) → Using vanilla JS instead
Adopted: 2026-01-14
Review Date: 2026-03-01
Triggers for Conversion:
- Tools grow beyond 250 LOC each
- Tools need to interact with backend types
- Tool suite grows to >5 tools
- Performance optimization requires bundling
Reviewed: No
Reviewer: Monica
================================================================================
END OF DEVIATIONS LOG
================================================================================