@noforeignland/signalk-to-noforeignland 1.1.0 → 1.2.0-beta.1

package/README.md

@@ -6,8 +6,9 @@ Effortlessly log your boat's movement to **noforeignland.com**
 * Send detailed tracks to log your entire trip and not just your final position
 * Can be used in near real time or cache and upload when stopped and data-connection is available
 * Sends 24h keepalive
+* **Velocity-based GPS outlier filtering** - catches anomalous GPS jumps (new in v1.2.0)
 * Option to archive your track on the local disk
-* Detailed plugin information in the SK dashboard 
+* Detailed plugin information in the SK dashboard
 * SK data paths about the plugin status for your own dashboard or Node Red coding
 
 ## Issues
@@ -28,7 +29,10 @@ Effortlessly log your boat's movement to **noforeignland.com**
 ## Configuration
 1. Add your boat's API Key into the Server > Plugin Config > Signal K to Noforeignland > Boat API Key
 2. Hit "Submit"
-3. Restart the Signal K server 
+3. Restart the Signal K server
+
+### Expert Settings
+* **Maximum velocity (m/s)** - Rejects positions implying movement faster than this threshold. Catches GPS outliers that jump to impossible locations. Default: 50 m/s (~97 knots). Adjust higher for aircraft tracking. 
 
 ## Data paths created by this plugin
 ```
@@ -42,7 +46,22 @@ noforeignland.source - string              - string            - data source of
 notifications.noforeignland.status_boolean - json object       - auto created
 ```
 
-# Virctron Cerbo GX Users
+## Development
+
+This plugin is written in TypeScript with strict type checking.
+
+```bash
+npm install          # Install dependencies
+npm run build        # Compile TypeScript
+npm run dev          # Watch mode compilation
+npm run test         # Run tests
+npm run test:coverage # Run tests with coverage
+npm run lint         # Run ESLint
+npm run format       # Run Prettier
+npm run validate     # Run all checks (typecheck + lint + test:coverage)
+```
+
+# Victron Cerbo GX Users
 
 ## Limited storage
 Signal K can quickly exhaust the small onboard storage of the device, especially when a lot of logging is enabled and not properly configured. Even concider to not enable "Keep track files on disk" if you are moving a lot.

package/package.json

@@ -3,9 +3,13 @@
   "signalk": {
     "id": "@noforeignland/signalk-to-noforeignland"
   },
-  "version": "1.1.0",
+  "version": "1.2.0-beta.1",
   "description": "SignalK track logger to noforeignland.com",
-  "main": "index.js",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
   "keywords": [
     "signalk-node-server-plugin",
     "signalk-category-utility"
@@ -24,11 +28,39 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "echo \"No tests specified\" && exit 0"
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix",
+    "format": "eslint src test --fix && prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
+    "typecheck": "tsc --noEmit",
+    "validate": "npm run typecheck && npm run lint && npm run test:coverage",
+    "prepublishOnly": "npm run validate && npm run build"
   },
   "dependencies": {
-    "cron": "^2.1.0",
-    "fs-extra": "^10.1.0",
-    "node-fetch": "^2.6.7"
+    "cron": "^3.2.1",
+    "fs-extra": "^11.2.0",
+    "node-fetch": "^2.7.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.18.0",
+    "@signalk/server-api": "^2.10.0",
+    "@tsconfig/node20": "^20.1.4",
+    "@types/fs-extra": "^11.0.4",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.17.14",
+    "@types/node-fetch": "^2.6.12",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "jest": "^29.7.0",
+    "mock-fs": "^5.4.1",
+    "prettier": "^3.4.2",
+    "ts-jest": "^29.2.5",
+    "typescript": "^5.7.3",
+    "typescript-eslint": "^8.21.0"
   }
 }

package/.github/workflows/publish.yml

@@ -1,40 +0,0 @@
-name: Publish Package
-
-on:
-  push:
-    tags:
-      - 'v*'
-
-permissions:
-  id-token: write
-  contents: read
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Clean workspace
-        run: git clean -xfd
-
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: 'https://registry.npmjs.org'
-
-      # Ensure npm 11.5.1 or later is installed
-      - name: Update npm
-        run: npm install -g npm@latest
-      - run: npm install
-
-      - run: npm test
-
-      - name: Publish
-        run: | 
-          if [[ "${{ github.ref }}" == refs/tags/*-beta.* ]] || [[ "${{ github.ref }}" == refs/tags/*-rc.* ]]; then
-            npm publish --provenance --access public --tag beta
-          else
-            npm publish --provenance --access public
-          fi

package/CHANGELOG.md

@@ -1,122 +0,0 @@
-1.1.0
-* CHANGE: Removed postinstall script - SignalK server will use --ignore-scripts (issue #2181). Runtime PluginCleanup handles all migration.
-* CHANGE: Refactored Project structure, see PROJECT_STRUCTURE.md
-* CHANGE: Use phrase GNSS instead of GPS - Thanks Piotr
-* BUGFIX: Removed unreliable DNS-based internet connectivity test (beta.11) - API retry logic is sufficient
-* BUGFIX: Reverted to beta.3 working configuration (beta.10) - undoing all failed schema experiments from beta.4-9
-* CHANGE: Improved cleanup error handling - only shows error after all retry attempts fail
-* CHANGE: Added installed plugins logging for better debugging
-* CHANGE: Platform-specific cleanup instructions (Cerbo GX vs standard)
-
-1.0.1
-* CHANGE: Cleanup previous installs and migrate plugin config, removes depricated old plugins.
-
-1.0.0
-* CHANGE: Package now released unter npmjs org noforeignland in version 1.0.0 due to deployment changes in npmjs and the need of trustworthy sources. All npmjs keys will be revoked Nov 19th, 2025. 
-Users of the old (depricated) 0.1.x versions need to install this new package once manually using the Signal K Appstore. The Plugin Configuration will be kept from the 0.1.x install. 
-
-0.2.x
-* CHANGE: Deployment via OIDC authentication 
-npmjs.org is revoking all deployment keys Nov 19th. The future deployment shall be via trusted publishers, so the workflow changes from publishing local -> npmjs to local -> github -> npmjs.
-To fullfil this we had to deprecate the old package and deploy it under the scope of the org noforeignland in npmjs. This is the reason, why you don't see the old package anymore in the Appstore.
-
-The "new" one has to be installed once manually, after that everything is back to normal and you are fine.
-
-0.1.3x
-* CHANGE: Working on Deployment via OIDC authentication 
-
-0.1.29
-* CHANGE: Removed unused dependency "is-reachable" in package.json
-
-0.1.29-beta.2 
-* NEW: setPluginError and error in data path if Internet Connection is not working. 
-
-0.1.29-beta.1
-* CHANGE: After talking to Treppo from Sugnal K core team we should use the data path "noforeignland.*", code and docs changed.
-* CHANGE: README.md info added and format optimized
-* CHANGE: GNSS source at the end for setPluginStatus - Cerbo has a long source name and truncates it.
-* CHANGE: Use "npm install instead" of "npm ci" to push from Github to npmjs using OIDC authentication
-* CHANGE: Moved navigation.position source from path noforeignland.status to noforeignland.source
-
-0.1.28
-* BUGFIX: No GNSS data found - introduced in 0.1.27 - Thanks Piotr
-
-0.1.28-beta.2
-* EXPERIMENTAL: Signal K data path to visualize the plugin behaviour or error in Node Red, KIP, etc. Using plugin.signalk-to-noforeignland.* for now. See README.md for details.
-* CHANGE: Using app.getDataDirPath() to store transient data, thanks Jeremy, they are now in "plugin-config-data/signalk-to-noforeignland/nfl-track" and renamed to pending.json1 and sent.json1
-* CHANGE: Optimize GNSS detection if multiple navigation.position from different sources exist.
-* CHANGE: PluginStatus optimized for limited space available.
-* CHANGE: doc/beta_install.md changed for new file structure.
-
-0.1.28-beta.1
-* CHANGE: By design SK deletes the track folder upon Pluging update via the Appstore, so we have to save the long term track in a different location, default folder: signalk-to-noforeignland-data
-
-0.1.27
-* Final version after successful testing SV MOIN and SV KIAPA NUI
-
-0.1.27-beta.1
-* NEW: NPMJS requires new method for publishing. The old tokens will expire Nov 19th, 2025, so moving to OIDC authentication.
-* NEW: Check the GNSS status in navigation.position, else retry and throw PluginError on Dashboard
-* CHANGE: Keep track data on disk rewritten and migrate old files to new structure, so nfl-track-sent.jsonl becomes a continuous archive of all sent track data over time, when enabled. New Logic:
-    * New points accumulate in nfl-track-pending.jsonl
-    * Send succeeds → API confirms receipt
-    * If keepFiles=true: The content of pending file is appended to nfl-track-sent.jsonl (line 588)
-    * Pending file is deleted
-    * Next GNSS points → create a new pending file
-    * Next successful send → appends again to the same nfl-track-sent.jsonl
-
-0.1.26
-* Same as 0.1.26-beta.1 
-
-0.1.26-beta.1
-* CHANGE: PluginStatus last track sent "Not transfered since plugin start" gets truncated by the dashboard. Changed to "None since start"
-
-0.1.25
-* CHANGE: Minimum boat move default increased from 50m to 80m
-* CHANGE: Updated the README.md
-* CHANGE: Use public ipv4 DNS instead of local with cache for testInternet()
-* Final version after successful testing SV MOIN and SV KIAPA NUI
-
-0.1.25-beta.3
-* NEW: Check if boat key is set on startup, else report error to dashboard
-* CHANGE: Changing the order and label of the Plugin Settings to make it more clear for unexpierienced users and grouped to Mandatory, Advanced and Expert.
-* CHANGE: Migration of < 0.1.25 Plugin settings to new structure.
-* CHANGE: PluginStatus last track sent "Never" changed to "Not transfered since plugin start" to avoid confusions.
-
-
-0.1.25-beta.2
-* CHANGE: Typo in pluginName fixed
-* CHANGE: Dates for SetPlugin now ISO8601 formated (https://github.com/noforeignland/nfl-signalk/issues/9)
-
-0.1.25-beta.1
-* CHANGE: User mattzilla470 reported timout Issues on VE Cerbo with a small CPU and using 4G (https://github.com/noforeignland/nfl-signalk/issues/7). So added a timout option in the plugin config and a tripple retry while increasing the timeout for the API call.
-
-0.1.24
-* CHANGE: testInternet() only uses ipv4 now, some users don't have ipv6 configured properly and where unable to reach the API, when testInternet returned false
-* NEW: PluginStatus on SK dashboard now shows last savePoint and last API transfer, so a user has more feedback what the app is doing without enabling the debug log and crawling though it.
-* CHANGE: Renamed CHANGELOG to CHANGELOG.md
-* CHANGE: CHANGELOG ORDER - newest on top.
-* Final version after successful testing SV MOIN and  SV KIAPA NUI
-
-0.1.23
-* Final version after successful testing SV MOIN and SV KIAPA NUI
-
-0.1.23-beta.1
-* Renamed branch to follow the release versions. 
-* CLEANUP - More debug info for the SK dashboard using this.app.setPluginError
-* CLEANUP - Removed CreateGPX, was only used for removed Email transmission of the track
-
-0.1.22-beta.2
-
-* CLEANUP and move to Object Oriented Javascript
-
-0.1.22-beta.1
-
-* CONFIG: Attempt sending location while moving - Default changed from false to true
-* CONFIG: Ping added for 24h ping if boat is not moved. - Default: true
-* Package.json - Nodemailer dependency removed
-* Marked for removal - Depricated "sendEmailData" function.
-* REMOVED - sendEmail.js
-* CLEANUP - Renamed emaiCron to apiCron
-* NEW: 24h api ping, when enabled, even if boat didn't move.
-

package/PROJECT_STRUCTURE.md

@@ -1,357 +0,0 @@
-# Project Structure
-
-This document describes the architecture and organization of the SignalK to Noforeignland plugin.
-
-## Overview
-
-This plugin follows a modular architecture where each responsibility is encapsulated in a dedicated module. The main orchestrator ([index.js](index.js)) coordinates all modules through a class-based approach.
-
-## Directory Layout
-
-```
-nfl-signalk/
-  index.js                      # Main plugin entry point & orchestrator
-  cleanup-old-plugin.js         # Postinstall script for removing old versions
-  package.json                  # NPM package configuration
-  lib/                          # Core modules directory
-    ConfigManager.js            # Configuration handling & migration
-    TrackLogger.js              # Position subscription & logging
-    TrackSender.js              # API communication & track sending
-    HealthMonitor.js            # Position data health checks
-    PluginCleanup.js            # Runtime cleanup of old plugins
-    TrackMigration.js           # Track file migration utilities
-    DataPathEmitter.js          # SignalK delta emission
-    DirectoryUtils.js           # File system utilities
-  README.md                     # User documentation
-  CHANGELOG.md                  # Version history
-  PROJECT_STRUCTURE.md          # This file
-```
-
-## Module Responsibilities
-
-### Core Orchestrator
-
-#### [index.js](index.js)
-**Purpose**: Main plugin class that orchestrates all modules and implements SignalK plugin lifecycle.
-
-**Key Responsibilities**:
-- Exports SignalK plugin object with `start()` and `stop()` methods
-- Initializes all module instances in correct order
-- Manages plugin state (options, upSince, cron, lastSuccessfulTransfer)
-- Coordinates between modules during startup sequence
-- Handles plugin status and error reporting to SignalK UI
-- Implements CRON-based interval for data sending
-
-**Key Methods**:
-- `start(options, restartPlugin)`: 13-step startup sequence
-- `stop()`: Cleanup and shutdown
-- `interval()`: CRON job handler for sending tracks
-- `handleSavePoint(lastPosition)`: Callback when track point is saved
-- `handleHealthy()`: Callback when health check passes
-- `setPluginStatus(status)`: Update UI status
-- `setPluginError(error)`: Report error to UI
-
-### Configuration & Migration
-
-#### [lib/ConfigManager.js](lib/ConfigManager.js)
-**Purpose**: Handles plugin configuration, schema definition, and config migration.
-
-**Key Responsibilities**:
-- Defines plugin schema (mandatory/advanced/expert settings groups)
-- Migrates old flat config structure to new nested structure
-- Flattens nested config back to internal format with defaults
-- Validates boat API key
-- Resolves track directory paths (absolute vs relative)
-- Randomizes CRON schedule to avoid server load spikes
-
-**Config Structure**:
-```javascript
-{
-  mandatory: { boatApiKey: string },
-  advanced: { minMove, minSpeed, sendWhileMoving, ping_api_every_24h },
-  expert: { filterSource, trackDir, keepFiles, trackFrequency, apiCron,
-            internetTestTimeout, apiTimeout }
-}
-```
-
-### Position Tracking
-
-#### [lib/TrackLogger.js](lib/TrackLogger.js)
-**Purpose**: Subscribes to position updates and logs them to disk.
-
-**Key Responsibilities**:
-- Subscribes to `navigation.position` and optionally `navigation.speedOverGround`
-- Implements GNSS source auto-selection (stick to one source unless stale)
-- Supports manual source filtering via `filterSource` config
-- Validates positions (rejects coordinates near 0,0)
-- Applies movement filters (minSpeed, minMove, trackFrequency)
-- Implements 24-hour keepalive ping
-- Saves track points to JSONL file (`pending.jsonl`)
-- Calculates distances using equirectangular approximation
-
-**GNSS Source Logic**:
-- If `filterSource` is set: only accept that specific source
-- If not set: auto-select first source, switch only if stale (>5 min)
-- Prevents position jumps when multiple GNSS devices are present
-
-**Track Point Format**:
-```json
-{"lat": 37.8136, "lon": -122.4784, "t": "2025-01-15T10:30:00.000Z"}
-```
-
-#### [lib/TrackSender.js](lib/TrackSender.js)
-**Purpose**: Sends accumulated track data to the Noforeignland API.
-
-**Key Responsibilities**:
-- Reads track points from `pending.jsonl`
-- Tests internet connectivity via DNS lookups (8.8.8.8, 1.1.1.1)
-- Checks if boat is moving (based on last position timestamp)
-- Sends track data to NFL API with retry logic (3 attempts)
-- Handles successful sends (archive to `sent.jsonl` or delete)
-- Validates position coordinates before sending
-
-**API Request Format**:
-```javascript
-POST https://www.noforeignland.com/home/api/v1/boat/tracking/track
-Headers: { 'X-NFL-API-Key': pluginApiKey }
-Body: {
-  timestamp: ms,
-  track: [[ms, lat, lon], [ms, lat, lon], ...],
-  boatApiKey: userBoatApiKey
-}
-```
-
-**Retry Logic**:
-- Attempt 1: base timeout (default 30s)
-- Attempt 2: 2x timeout + 2s delay
-- Attempt 3: 3x timeout + 4s delay
-
-### Health & Monitoring
-
-#### [lib/HealthMonitor.js](lib/HealthMonitor.js)
-**Purpose**: Monitors GNSS position data freshness and reports issues.
-
-**Key Responsibilities**:
-- Initial check: 2 minutes after startup
-- Periodic checks: every 5 minutes
-- Detects stale position data (>5 minutes old)
-- Detects missing position data
-- Provides context-aware error messages (filtered vs auto-selected source)
-- Calls error/healthy callbacks to update plugin status
-
-**Health States**:
-- Healthy: Position received within last 5 minutes
-- Warning: No position for >5 minutes
-- Error: No position ever received (or 2+ min after startup)
-
-### Cleanup & Migration
-
-#### [lib/PluginCleanup.js](lib/PluginCleanup.js)
-**Purpose**: Runtime cleanup of old plugin versions.
-
-**Key Responsibilities**:
-- Detects Victron Cerbo vs standard SignalK paths
-- Migrates config from old `signalk-to-noforeignland` to new scoped name
-- Removes old plugin directories (`signalk-to-noforeignland`, `signalk-to-nfl`)
-- Multiple retry attempts (immediate, 5s, 15s, 30s delays)
-- Falls back to manual instructions if removal fails
-- Returns promise resolving to 'all_removed' or 'partial_removal'
-
-**Old Plugins Removed**:
-- `signalk-to-noforeignland` (unscoped predecessor)
-- `signalk-to-nfl` (deprecated alias)
-
-#### [cleanup-old-plugin.js](cleanup-old-plugin.js)
-**Purpose**: Postinstall script for immediate cleanup during npm install.
-
-**Key Responsibilities**:
-- Runs via `npm postinstall` hook
-- Uses direct `fs.rmSync()` instead of npm uninstall (safer during install)
-- 2-second delay to allow npm to complete current operation
-- Detects Victron Cerbo vs standard SignalK paths
-- Migrates config files
-- Provides fallback manual instructions
-
-**Why Two Cleanup Mechanisms?**
-1. **Postinstall**: Runs during installation, removes old plugins immediately
-2. **Runtime**: Handles cases where postinstall failed (permissions, timing)
-
-#### [lib/TrackMigration.js](lib/TrackMigration.js)
-**Purpose**: Migrates track files from old naming/location schemes.
-
-**Key Responsibilities**:
-- Migrates old file names to new naming scheme:
-  - `nfl-track.jsonl` -> `pending.jsonl`
-  - `nfl-track-pending.jsonl` -> `pending.jsonl`
-  - `nfl-track-sent.jsonl` -> `sent.jsonl`
-- Migrates track files from old plugin directory to new data directory
-- Removes old track directory if empty
-- Non-destructive: only migrates if target doesn't exist
-
-### SignalK Integration
-
-#### [lib/DataPathEmitter.js](lib/DataPathEmitter.js)
-**Purpose**: Creates and updates SignalK data paths for external integrations.
-
-**Key Responsibilities**:
-- Emits SignalK deltas to create data paths
-- Updates status paths on state changes
-- Manages error state independently
-- Provides both ISO8601 and locale-formatted timestamps
-
-**Data Paths Created**:
-```
-noforeignland.savepoint             # ISO8601 timestamp of last save
-noforeignland.savepoint_local       # Locale string of last save
-noforeignland.sent_to_api           # ISO8601 timestamp of last API transfer
-noforeignland.sent_to_api_local     # Locale string of last API transfer
-noforeignland.status                # Status string (save/transfer/source info)
-noforeignland.status_boolean        # 0 = OK, 1 = error
-noforeignland.source                # Active GNSS source name
-```
-
-**Usage**: These paths can be consumed by Node-RED, KIP dashboards, or other SignalK consumers.
-
-#### [lib/DirectoryUtils.js](lib/DirectoryUtils.js)
-**Purpose**: File system utilities with proper error handling.
-
-**Key Responsibilities**:
-- Creates directories recursively
-- Checks read/write permissions
-- Provides context-specific error messages
-- Handles common error codes (EACCES, EPERM, ETIMEDOUT)
-
-## Data Flow
-
-### Startup Sequence
-```
-1. ConfigManager: Migrate old config -> flatten -> validate
-2. DirectoryUtils: Create track directory
-3. PluginCleanup: Remove old plugins (async, non-blocking)
-4. TrackMigration: Migrate old track files
-5. Initialize: TrackLogger, TrackSender, HealthMonitor
-6. ConfigManager: Randomize CRON schedule
-7. TrackLogger: Start position subscription
-8. CRON: Start interval job
-9. HealthMonitor: Start health checks
-```
-
-### Position Logging Flow
-```
-navigation.position delta
-  -> TrackLogger.doOnValue()
-    -> handleSourceSelection() [filter/auto-select]
-    -> isValidPosition() [validate lat/lon]
-    -> shouldLogPosition() [check distance/frequency]
-    -> savePoint() [append to pending.jsonl]
-    -> callback to index.handleSavePoint()
-      -> DataPathEmitter.emitSavepoint()
-      -> setPluginStatus()
-```
-
-### Track Sending Flow (CRON Interval)
-```
-CRON trigger
-  -> index.interval()
-    -> TrackSender.isBoatMoving() [check last position age]
-    -> TrackSender.hasTrackData() [check pending.jsonl exists]
-    -> TrackSender.testInternet() [DNS lookup test]
-    -> TrackSender.sendTrack()
-      -> createTrackFromFile() [read pending.jsonl]
-      -> sendWithRetry() [POST to API, 3 attempts]
-      -> handleSuccessfulSend() [archive or delete]
-    -> DataPathEmitter.emitApiTransfer()
-    -> setPluginStatus()
-```
-
-### Health Monitoring Flow
-```
-HealthMonitor timer (every 5 min)
-  -> performHealthCheck()
-    -> check lastPositionReceived timestamp
-    -> if stale/missing: call onError callback
-      -> index.setPluginError()
-        -> DataPathEmitter.setError()
-        -> app.setPluginError()
-    -> if healthy: call onHealthy callback
-      -> index.handleHealthy()
-        -> setPluginStatus() [clear error if needed]
-```
-
-## File Locations
-
-### Victron Cerbo GX
-- SignalK directory: `/data/conf/signalk`
-- Plugin installed at: `/data/conf/signalk/node_modules/@noforeignland/signalk-to-noforeignland`
-- Config: `/data/conf/signalk/plugin-config-data/@noforeignland-signalk-to-noforeignland.json`
-- Track files: `/data/conf/signalk/plugin-config-data/@noforeignland-signalk-to-noforeignland/nfl-track/`
-
-### Standard SignalK
-- SignalK directory: `~/.signalk`
-- Plugin installed at: `~/.signalk/node_modules/@noforeignland/signalk-to-noforeignland`
-- Config: `~/.signalk/plugin-config-data/@noforeignland-signalk-to-noforeignland.json`
-- Track files: `~/.signalk/plugin-config-data/@noforeignland-signalk-to-noforeignland/nfl-track/`
-
-## Development Notes
-
-### Adding New Features
-1. Create module in `lib/` if it's a distinct responsibility
-2. Instantiate in [index.js](index.js) constructor
-3. Initialize in `start()` method at appropriate step
-4. Clean up in `stop()` method
-5. Update this document
-
-### Configuration Changes
-1. Update schema in [ConfigManager.js](lib/ConfigManager.js) `getSchema()`
-2. Add migration logic in `migrateOldConfig()` if breaking change
-3. Update `flattenConfig()` to include new fields with defaults
-4. Test both old and new config formats
-
-### Track File Format Changes
-1. Update `TrackLogger.savePoint()` for writing
-2. Update `TrackSender.createTrackFromFile()` for reading
-3. Add migration logic in [TrackMigration.js](lib/TrackMigration.js) if needed
-
-### Testing Checklist
-- [ ] Test on Victron Cerbo GX (path detection, limited storage)
-- [ ] Test on standard SignalK installation
-- [ ] Test config migration from old versions
-- [ ] Test with multiple GNSS sources (auto-selection)
-- [ ] Test with filtered source
-- [ ] Test with no internet connection
-- [ ] Test with slow internet (timeout scenarios)
-- [ ] Test cleanup of old plugins
-- [ ] Test track file migration
-
-## Dependencies
-
-```json
-{
-  "cron": "^2.1.0",           // CRON job scheduling
-  "fs-extra": "^10.1.0",      // Enhanced file system operations
-  "node-fetch": "^2.6.7"      // HTTP requests to API
-}
-```
-
-## Version History Notes
-
-- **1.1.0**: Refactored to modular structure
-- **1.0.x**: Scoped package name, cleanup mechanism
-- **0.1.x**: Original flat structure (deprecated)
-
-## Known Technical Debt
-
-1. **Empty process.exit()**: [cleanup-old-plugin.js](cleanup-old-plugin.js) setTimeout may not complete
-2. **Error timing**: [PluginCleanup.js](lib/PluginCleanup.js) shows error before retries complete
-3. **No test suite**: Manual testing only, no automated tests
-
-## SignalK Plugin Conventions
-
-This plugin follows SignalK plugin conventions:
-- Exports function returning `{id, name, schema, start, stop}`
-- Uses `app.debug()` for logging
-- Uses `app.setPluginStatus()` and `app.setPluginError()` for UI feedback
-- Subscribes via `app.subscriptionmanager.subscribe()`
-- Emits deltas via `app.handleMessage(pluginId, delta)`
-- Config stored in `plugin-config-data/` directory
-- Data stored in plugin's data directory