Standards alignment: Document .js tools deviation, fix port 3030, enhance tool documentation
This commit is contained in:
+28
-1
@@ -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
|
||||
================================================================================
|
||||
|
||||
Reference in New Issue
Block a user