Engineered by Ahmad Hassan (B-Ted)
A high-fidelity cybersecurity laboratory designed for diagnostic telemetry, advanced fingerprinting, and browser security boundary research.
The toolkit is built on a Zero-Coupling Dynamic Plugin Architecture. The core engine remains entirely agnostic of individual module logic, discovering and loading tools at runtime via a centralized manifest.
graph TD
A[index.html / debug.html] -->|Bootstrap| B[src/core/engine.js]
B -->|Fetch Discovery| C[src/config/modules.json]
C -->|Return Payload Paths| B
B -->|Dynamic import| D[src/modules/level_X/*.js]
D -->|Self-Register| B
B -->|Render Grid| UI[Dynamic Command Center]
- 0% Coupling: Core engine logic and security payloads never touch.
- 100% Cohesion: Each module is a self-contained unit with its own metadata and execution logic.
- Dynamic Handshake: New tools are added by updating a JSON manifestβno code modification required.
Tools are categorized into four distinct levels, reflecting the severity of information exposure.
| Level | Classification | Visual | Focus Area |
|---|---|---|---|
| L1 | Standard Recon | π’ Green | OS, Browser, and Performance Telemetry |
| L2 | Advanced Profiling | π‘ Yellow | Network Topology & Hardware Fingerprinting |
| L3 | Critical Intelligence | π΄ Red | PII, Credentials, and Social Identity |
| L4 | High-Fidelity Exploits | π£ Purple | Security Bypasses & Hardware Silicion Tracing |
When a module is executed, it follows a strict lifecycle from initialization to exfiltration.
sequenceDiagram
participant U as UI (Command Center)
participant E as Engine.js
participant M as Module.js
participant API as Browser/External API
U->>E: User clicks 'EXEC'
E->>E: Initializing Sequence
E->>M: run() async
M->>API: Native Probe / Fetch
API-->>M: Raw Data
M-->>E: Structured JSON Payload
E->>U: Render to Terminal Output
Pinpoint-Location-Tracker/
βββ src/
β βββ core/
β β βββ engine.js # Framework Orchestrator
β β βββ transmitter.js # Data Exfiltration Logic
β βββ config/
β β βββ modules.json # Discovery Manifest
β βββ modules/ # Plug-and-Play Tools
β β βββ level1/ # Standard Recon
β β βββ level2/ # Fingerprinting
β β βββ level3/ # Intelligence
β β βββ level4/ # Bypass Lab
β βββ styles/ # Global Design System
βββ debug.html # Automated Lab Shell
βββ index.html # Stealth Dashboard
Every module must adhere to a strict interface to ensure 100% cohesion within the framework.
View Module Template (JavaScript)
/**
* Pinpoint Module Template
*/
export default {
id: 'unique_identifier',
title: 'Display_Name',
level: 4, // Level 1-4
info: "Description of the security exposure.",
steps: [
"Phase 1 Recon...",
"Phase 2 Probe...",
"Phase 3 Exfiltration..."
],
run: async () => {
// Implementation logic
return { data: 'captured_intel' };
}
};The repository is maintained with a focus on engineering excellence. Contributors are encouraged to expand the toolkit by implementing new diagnostic modules.
- Draft: Implement the module using the standard template.
- Locate: Place the script in the corresponding
src/modules/levelX/folder. - Register: Add the file path to
src/config/modules.json. - Verify: Open
debug.htmlto confirm the tool is automatically rendered and functional.
Developed & Documented by Ahmad Hassan (B-Ted)
Professionally maintained for Cybersecurity Research & Education