b3c37bd7df
Rebrand NetAnalyzer -> StoreHealthAnalyzer and consolidate the store
reporting surface into a single `st [number]` command with focused
sub-modes.
Commands
- st [number] - general info (SIW + brands + Meraki net link)
- st [number] network - switches, APs, store server
- st [number] pos - registers, payment terminals, customer display
- st [number] ios - MDM-tracked iOS hardware
- st [number] phone - wired 78xx + DECT basestations/handsets with
registration state, extensions and main DID
- st [number] av - Atlas AMPs + MDM-tracked Apple TVs, video
walls, music players, LED displays
- Removed `analyze` in favor of the unified `st` surface
Integrations
- integrations/webex: Service App OAuth with rotating refresh tokens,
seed + cleanup scripts, tokens/ storage (git-ignored)
- integrations/atlas: Xyte client + cached device discovery keyed on
zero-padded 6-digit store numbers, cold-cache failure -> unavailable
banner instead of a misleading empty result
- services/webexPhone, services/webexService, services/avService: shape
raw upstream data into the report layer's contract
- utils/merakiMatcher: FQDN hostname extraction so payment terminals
match Meraki descriptions; case-insensitive lookup
- utils/chunkReport: split long markdown replies at 7000-char boundaries
Reliability / ops
- server.js: awaited framework.stop() + 8s hard-kill timer so nodemon /
Docker restarts don't leak WDM device registrations ("excessive device
registrations")
- nodemon.json: SIGINT so the graceful path always runs
- scripts/cleanupWebexDevices.js: one-shot WDM cleanup utility
- Group-space routing: hears() regexes tolerate the leading @BotName
prefix Webex prepends to mentions
- Replaced HTML-unsafe <number> placeholders with [number] in all help
strings
Remote agent containerization
- docker/remote-agent/: multi-stage node:22-alpine image, non-root user,
tini for signal handling, minimal deps (ws/axios/dotenv)
- docker/remote-agent/package.sh: docker buildx build defaulting to
linux/amd64 (with override), saves image + assembles deploy/ + writes
SHA256 + zips for offline transfer
- docker/remote-agent/deploy/: runtime docker-compose.yml, install.sh
with platform sanity check, remote-host README
- .dockerignore + .gitignore updates for build artifacts and dist bundles
- npm run agent:package convenience script
Cleanup
- Dropped storeHealth.js / HealthReport.js and their tests/mocks in favor
of the shared storeDetail pipeline
- Store model handles null SIW records gracefully; toSummary always
ends with a newline so the Meraki link sits on its own line
Tests
- 144 tests across 14 suites passing; new coverage for atlasClient,
atlasDevices, avService, avCategory classification, webexPhone,
webexServiceAppAuth, storeDetail integration, siw, chunkReport and
the updated meraki matcher
Co-authored-by: Cursor <cursoragent@cursor.com>
60 lines
1.6 KiB
JSON
60 lines
1.6 KiB
JSON
{
|
|
"name": "storehealthanalyzer",
|
|
"version": "1.0.0",
|
|
"private": true,
|
|
"main": "server.js",
|
|
"type": "commonjs",
|
|
"description": "StoreHealthAnalyzer — Webex bot for store network and device health analysis using Meraki, SIW, and MDM integrations",
|
|
"scripts": {
|
|
"start": "node server.js",
|
|
"agent": "node remoteAgent.js",
|
|
"dev": "nodemon server.js",
|
|
"dev:agent": "nodemon remoteAgent.js",
|
|
"lint": "eslint . --ext .js",
|
|
"lint:fix": "eslint . --ext .js --fix",
|
|
"format": "prettier --write \"**/*.{js,json,md}\"",
|
|
"format:check": "prettier --check \"**/*.{js,json,md}\"",
|
|
"test": "jest",
|
|
"test:watch": "jest --watch",
|
|
"webex:cleanup": "node scripts/cleanupWebexDevices.js",
|
|
"webex:cleanup:delete": "node scripts/cleanupWebexDevices.js --delete",
|
|
"webex:seed": "node scripts/seedWebexTokens.js",
|
|
"agent:package": "bash docker/remote-agent/package.sh"
|
|
},
|
|
"keywords": [
|
|
"webex",
|
|
"bot",
|
|
"meraki",
|
|
"network-analysis",
|
|
"store-health"
|
|
],
|
|
"author": "",
|
|
"license": "ISC",
|
|
"engines": {
|
|
"node": ">=18"
|
|
},
|
|
"dependencies": {
|
|
"axios": "^1.16.1",
|
|
"dotenv": "^17.4.2",
|
|
"express": "^5.2.1",
|
|
"webex-node-bot-framework": "^2.5.1",
|
|
"ws": "^8.20.1"
|
|
},
|
|
"devDependencies": {
|
|
"@eslint/js": "^10.0.1",
|
|
"eslint": "^10.5.0",
|
|
"eslint-config-prettier": "^10.1.8",
|
|
"eslint-plugin-prettier": "^5.5.6",
|
|
"globals": "^17.7.0",
|
|
"jest": "^30.4.2",
|
|
"nodemon": "^3.1.14",
|
|
"prettier": "^3.8.4"
|
|
},
|
|
"jest": {
|
|
"testEnvironment": "node",
|
|
"testMatch": [
|
|
"<rootDir>/tests/**/*.test.js"
|
|
],
|
|
"verbose": true
|
|
}
|
|
}
|