sync: auto-sync from HOWARD-HOME at 2026-06-21 10:50:27

Author: Howard Enos
Machine: HOWARD-HOME
Timestamp: 2026-06-21 10:50:27
This commit is contained in:
2026-06-21 10:51:11 -07:00
parent 1e058ea596
commit bb3c40190f
3 changed files with 96 additions and 4 deletions

View File

@@ -316,10 +316,19 @@ if(-not (Test-Path $root)){ Write-Output 'NO-SCANLOGS'; return }
$dir=Get-ChildItem $root -Directory | Sort-Object LastWriteTime -Descending | Select-Object -First 1
if(-not $dir){ Write-Output 'NO-SCAN-DIR'; return }
Write-Output ("SCANDIR=" + $dir.FullName)
Get-ChildItem $dir.FullName -File | ForEach-Object {
$b=[Convert]::ToBase64String([IO.File]::ReadAllBytes($_.FullName))
Write-Output ("===FILE===" + $_.Name + "===")
Write-Output $b
# EICAR sanity: is the planted test file still on disk after a clean-mode scan?
$eicar='C:\GuruScanTest\eicar_test.com'
if(Test-Path $eicar){ Write-Output ("EICAR-STILL-PRESENT (" + (Get-Item $eicar).Length + " bytes) - NOT quarantined") }
else { Write-Output 'EICAR-GONE - a scanner removed/quarantined it' }
# whitelist that was handed to the engines
if(Test-Path 'C:\GuruScan\whitelist.txt'){ Write-Output '===FILE===whitelist.txt==='; Write-Output ([Convert]::ToBase64String([IO.File]::ReadAllBytes('C:\GuruScan\whitelist.txt'))) }
# recurse: pull every log file under the scan dir (logs live in *_Logs subdirs), cap each at 512KB
Get-ChildItem $dir.FullName -File -Recurse | ForEach-Object {
$bytes=[IO.File]::ReadAllBytes($_.FullName)
if($bytes.Length -gt 524288){ $bytes=$bytes[0..524287] }
$rel=$_.FullName.Substring($dir.FullName.Length).TrimStart('\') -replace '\\','__'
Write-Output ("===FILE===" + $rel + "===")
Write-Output ([Convert]::ToBase64String($bytes))
}
Write-Output "===END==="
PS

View File

@@ -23,6 +23,12 @@ Categories (the `[type]` tag): _(none)_ = skill/command execution failure ·
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [network.getEndpointsList]: Invalid value for 'parentId' parameter. [ctx: cmd=endpoints]
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [policies.getPolicyDetails]: Invalid value for 'policyId' parameter. [ctx: cmd=policy]
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [network.getManagedEndpointDetails]: Invalid value for 'endpointId' parameter. Expected format: 24-char hex ID [ctx: cmd=endpoint]
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [network.getEndpointsList]: Invalid value for 'parentId' parameter. [ctx: cmd=endpoints]
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [push.sendTestPushEvent]: The required parameter is missing : eventType [ctx: cmd=raw]
2026-06-21 | Howard-Home | bitdefender | GravityZone API error [incidents.updateIncidentNote]: The required parameter is missing : type [ctx: cmd=raw]

View File

@@ -0,0 +1,77 @@
## User
- **User:** Howard Enos (howard)
- **Machine:** Howard-Home
- **Role:** tech
## Session Summary
Began by closing out the Tier-1 items from the 2026-06-09 GuruRMM audit. Verification against live code showed the CRITICAL and most HIGH findings had already been fixed after the audit (commits `f7750fa` status-stream auth, `5cd11a3` cred-key fail-closed + sqlx-runtime + coord-proxy + 500-leak sweep). The one genuine remaining gap was the 500-error-leak tail (17 `(INTERNAL_SERVER_ERROR, e.to_string())` sites in auth.rs/alerts.rs/credentials.rs); converted all to `.map_err(internal_err)`, `cargo check` clean, committed + pushed to gururmm as `58c1a96`. Also confirmed the coord-URL HIGH and event_log_watches-on-reconnect HIGH were already fixed in live code — all six audit CRITICAL/HIGH items are now closed.
Filed a coord broadcast + a durable todo for Mike covering the two deferred Tier-1 items (fabb3421/Mail.Send decision and packetdial creds). A later `/sync` surfaced Mike's reply: the fabb3421 narrative was stale — Mail.Send already lives in the 365 remediation app suite (Exchange Operator app `b43e7342`); no separate app needed. That closed the mailbox/remediation-tool item.
The bulk of the session was a full build-out of the `bitdefender` skill (GravityZone Cloud Public API). First confirmed the skill was already live (selftest 29/29) and that the API key's scope was far broader than the skill wrapped. Ran a read-only discovery sweep across every enabled module, discovering that `getPolicyDetails` actually returns the FULL granular policy config (the docs' "shallow" claim was wrong), and that several modules (patchmanagement/phasr/maintenancewindows) are license-dead. Verified state-changing param shapes via safe empty-param validation probes (no state changed on the live tenant), cross-checked against the GravityZone Support Center docs (link provided by Howard).
Then worked module-by-module, autonomously with checkpoints, committing per module and routing commit bodies through local Ollama (qwen3:14b) per Howard's token-saving directive. Completed Accounts (7), Companies (6), Network completion, Packages, Reports, Quarantine, Incidents/EDR (incl. custom rules + incident status/note), Push (incl. sendTestPushEvent), Licensing (monthly-usage), and Integrations. Final state: 61 CLI subcommands / 61 client methods, selftest 75/75, every write gated behind `--confirm` (gating-only tested — no writes fired on the live partner tenant). All docs (`api-reference.md`, `BUILDOUT.md` tracker, `SKILL.md`) updated with verified/dead status and doc URLs.
## Key Decisions
- Resolved the errorlog.md rebase conflict by keeping Mike's two entries and dropping ~45 lines of bitdefender probe-noise (expected validation/bad-id errors auto-logged by the CLI) — per the "do not log expected conditions" rule. Added one genuine friction entry: gz.py main() auto-logs every GravityZoneError, so selftest/probes spam the errorlog.
- Built the bitdefender expansion as a methodical module-by-module pass with a persistent `BUILDOUT.md` tracker rather than one big change, so progress survives across turns/sessions.
- Verified write-method param shapes via empty-param validation probes (validation fires before any state change) instead of only docs — the live API is more authoritative than docs (which lag: e.g. getIncidentsList "method not found" despite being documented).
- Kept all account/company/report/quarantine/incident WRITE methods gated and gating-tested only; did NOT execute any create/delete/uninstall against the live partner tenant.
- Routed git commit bodies and prose through Ollama (qwen3:14b local on Howard-Home); kept all API param/field values authored by Claude (per OLLAMA.md — never Ollama for payload field values).
## Problems Encountered
- `endpoint-tags` crashed (`_print_kv` expects a dict, getEndpointTags returns a list). Fixed with a list-aware `_print_tags` renderer.
- Ollama commit-body call failed with `UnicodeEncodeError` (cp1252 stdout vs a `→` char). Fixed by setting `PYTHONIOENCODING=utf-8` and `.encode('ascii','ignore')` on output.
- `configureNotificationsSettings {}` probe returned `true` — a no-required-param SETTER. Verified live notification settings were intact (idempotent, no damage). Recorded the lesson: never probe a no-required-param setter with an empty payload on a live tenant.
- sync.sh hit a errorlog.md rebase conflict (Mike's GURU-KALI entries vs local auto-sync); resolved manually and re-ran sync.
## Configuration Changes
- `projects/msp-tools/guru-rmm/server/src/api/{auth,alerts,credentials}.rs` — 17 sites converted to `internal_err` (committed + pushed as gururmm `58c1a96`).
- `.claude/skills/bitdefender/scripts/gz_client.py` — +~30 new API methods across all modules.
- `.claude/skills/bitdefender/scripts/gz.py` — +~35 new CLI subcommands, handlers, parsers, raw-gating patterns, `_print_tags`/`_load_json_arg` helpers.
- `.claude/skills/bitdefender/scripts/selftest.py` — 29 → 75 checks.
- `.claude/skills/bitdefender/SKILL.md` — corrected policy section, enabled-scopes, command list.
- `.claude/skills/bitdefender/references/api-reference.md` — full verified/dead status per module + doc URLs + Support Center source.
- `.claude/skills/bitdefender/references/BUILDOUT.md` — NEW master tracker (all live modules complete).
- `.claude/memory/reference_gravityzone_support.md` + `MEMORY.md` — NEW reference memory for the Support Center.
## Credentials & Secrets
- No new credentials created or discovered. GravityZone API key remains in SOPS vault `msp-tools/gravityzone.sops.yaml` field `credentials.api_key` (HTTP Basic: key as username, empty password).
- Mike's note: Mail.Send for the 365 remediation suite lives in Exchange Operator app `b43e7342` (no separate app needed; the deleted `fabb3421`/Claude-MSP-Access narrative is stale).
## Infrastructure & Servers
- GravityZone Cloud Public API base: `https://cloud.gravityzone.bitdefender.com/api/v1.0/jsonrpc`; module path `<base>/<module>`.
- ACG partner tenant: root company `5c4280716c0318f3478b456a`, companies container `5c4280716c0318f3478b456e`. 55 companies, 9 policies, 119 endpoints used. License expiry 2030-02-17.
- API key enabled scopes: companies, licensing, packages, network, integrations, policies, maintenancewindows, reports, accounts, incidents, push, quarantine, phasr, patchmanagement. License-dead: patchmanagement (managePatchManagement=false), phasr, maintenancewindows.
- Ollama: local on Howard-Home (`http://localhost:11434`), models qwen3:14b (prose), codestral:22b / qwen3-coder:30b (code), nomic-embed-text.
- Coord API: `http://172.16.3.30:8001/api/coord` — broadcast `84c473a5`, todo for Mike `667c742e`.
## Commands & Outputs
- Safe param-shape discovery: `gz.py raw --module M --method m --params '{}'` → "required parameter is missing : <field>" reveals the next required field without changing state.
- `getPolicyDetails` returns full granular config (passwordConfig/powerUser/scanSsl/mitm/...) — not shallow.
- Methods confirmed NON-EXISTENT on this tenant: companies.updateCompany, companies.getCompaniesList, network.createUninstallTask(+variants), network.getEndpointsByPolicy, network.getManagedEndpointDetailsByIp, network.createScanTaskByMailboxes, reports.getReportConfiguration, licensing.getMonthlyUsagePerCompany, incidents.getIncidentsList.
- Final: `gz.py` 61 subcommands, selftest 75/75 passing.
- gururmm `cargo check` (SQLX_OFFLINE=true) EXIT 0 after the 500-leak fix.
## Pending / Incomplete Tasks
- **DESKTOP-MS42HNC integration test** (needs Howard's go): install Bitdefender via `/rmm`, then verify create-test-group → move endpoint → assign policy → scan → isolate → restore against a live endpoint. Changes the machine + creates a live test group, so not run autonomously.
- **Push webhook receiver**: `push-set` is built; standing up an HTTPS (TLS 1.2+) receiver endpoint (coord-API or RMM ingest route) to point GravityZone events at is still needed before enabling.
- **RMM push-deploy**: install-links → `/rmm` push integration still to wire (would be exercised by the DESKTOP-MS42HNC test).
- **packetdial** skill still non-functional — needs NetSapiens API key provisioned into vault `msp-tools/oitvoip.sops.yaml` (deferred to Mike).
- Friction to address: gz.py main() auto-logs expected GravityZoneErrors to errorlog (selftest/probe spam) — suppress for expected validation/not-found responses.
## Reference Information
- GravityZone Support Center (authoritative API docs): https://www.bitdefender.com/business/support/en/77211-79436-welcome-to-gravityzone.html
- Key doc pages: assignPolicy 77212-924802; createAccount 77212-125284; createCompany 77211-126236; setPushEventSettings 77209-135319.
- gururmm commit: `58c1a96` (500-leak tail fix, pushed to gururmm origin/main).
- bitdefender build-out commits (claudetools): `4cf34f5` tracker, `8a64bc4` Accounts, `2a1ffab` Companies, `a254e5f` Network, `53d7e94` remaining modules, `1e058ea` SKILL.md.
- Skill tracker: `.claude/skills/bitdefender/references/BUILDOUT.md`; spec: `references/api-reference.md`.