Mike Swanson
70c496bb30
Seeded via /wiki-compile (parallel sub-agents): - clients: gonzvar-tax-services, tohono-oodham-doit (Syncro 33069069), tucson-golden-corral (Syncro 3859123) - projects: gururmm-agent (artifact-based, agent/ @ origin/main), msp-tools (umbrella) Index rows added for all five. Deduped the duplicate system:neptune compile-queue entry (merged the cert/DkimSigner note into one). Left as-is (intentional, not duplicates/dead): wiki/projects/guru-rmm.md is a redirect tombstone; the patterns/tailscale-client-enroll.ps1 index link is valid (the .ps1 script exists).
124 lines
7.2 KiB
Markdown
124 lines
7.2 KiB
Markdown
---
|
||
type: project
|
||
name: msp-tools
|
||
display_name: MSP Tools (umbrella)
|
||
last_compiled: 2026-06-12
|
||
compiled_by: GURU-5070/claude-main
|
||
sources:
|
||
- projects/msp-tools/session-logs/2026-06-02-recovered-build-self-diagnosis-skill-for-claudetools-setup.md
|
||
- projects/msp-tools/session-logs/2026-06-02-recovered-build-self-diagnosis-skill-for-claudetools-setup-25f5d8b9.md
|
||
- projects/msp-tools/README.md
|
||
- .claude/memory/project_gururmm.md
|
||
- .claude/memory/project_guruconnect.md
|
||
- .claude/memory/reference_msp_audit_scripts.md
|
||
backlinks:
|
||
- projects/gururmm
|
||
- projects/guruconnect
|
||
---
|
||
|
||
# MSP Tools (Umbrella)
|
||
|
||
## Summary
|
||
|
||
`projects/msp-tools/` is the umbrella directory for ACG's MSP tooling under ClaudeTools. It hosts two active product submodules ([[gururmm]] and GuruConnect), plus supporting PowerShell modules, audit scripts, and operational utilities. The directory was originally populated in January 2026 by importing conversation archives from prior Claude projects; active development now lives in the submodules and supporting directories with their own session-log trees.
|
||
|
||
This article covers the umbrella scope only. For the full capability record of each product, see the dedicated articles linked below.
|
||
|
||
---
|
||
|
||
## Sub-Projects
|
||
|
||
| Directory | Type | Purpose | Wiki Article |
|
||
|---|---|---|---|
|
||
| `guru-rmm/` | git submodule | Full-stack RMM: agent fleet, monitoring, remote execution, dashboard | [[gururmm]] |
|
||
| `guru-connect/` | git submodule | Remote access / screen sharing product (Rust; native-first, WebRTC fallback) | no article yet (verify) |
|
||
| `guru-scan/` | PowerShell module | Multi-engine malware scan orchestrator; runs RKill + scanner chain, outputs JSON for GuruRMM agent | — |
|
||
| `msp-audit-scripts/` | PowerShell scripts | On-demand server and workstation audit scripts; run via ScreenConnect Toolbox as SYSTEM | — |
|
||
| `quote-wizard/` | PHP/web app | MSP quoting tool (PHP API + frontend + admin panel) — maturity/status (verify) | — |
|
||
| `scripts/` | Misc scripts | M365 onboarding (CIPP templates, tenant onboarding, permission manifests), Datto SmartBadge diagnostics, RMM status check | — |
|
||
| `utilities/` | Standalone PS1 | Printer port cleanup, Win11 upgrade script, saved ScreenConnect Toolbox one-liners | — |
|
||
| `toolkit/` | (empty README) | Purpose (verify) | — |
|
||
|
||
**Archived conversation imports (not active code):**
|
||
- `guru-rmm-conversation-logs/` — 54 JSONL transcripts from the original GuruRMM Claude project, imported 2026-01-17
|
||
- `guru-connect-conversation-logs/` — 40 JSONL transcripts from the original GuruConnect Claude project, imported 2026-01-17
|
||
|
||
---
|
||
|
||
## Architecture
|
||
|
||
### Components
|
||
| Component | Location | Tech | State |
|
||
|---|---|---|---|
|
||
| GuruRMM | `projects/msp-tools/guru-rmm/` (submodule) | Rust (server + agent), TypeScript (dashboard), PostgreSQL | Active — see [[gururmm]] |
|
||
| GuruConnect | `projects/msp-tools/guru-connect/` (submodule) | Rust (server + Windows agent), TypeScript (dashboard), PostgreSQL | Active — v2 in dev |
|
||
| GuruScan | `projects/msp-tools/guru-scan/` | PowerShell module | Active |
|
||
| MSP Audit Scripts | `projects/msp-tools/msp-audit-scripts/` | PowerShell | Active; mirrored on `Howweird/msp-audit-scripts` (GitHub) |
|
||
| Quote Wizard | `projects/msp-tools/quote-wizard/` | PHP + frontend | Status (verify) |
|
||
|
||
### Key Files & Repos
|
||
- **GuruRMM repo:** `azcomputerguru/gururmm` on Gitea (172.16.3.20)
|
||
- **GuruConnect repo:** `azcomputerguru/guru-connect` on Gitea (172.16.3.20) — separate repo, NOT a submodule of ClaudeTools
|
||
- **MSP Audit Scripts remote:** `https://raw.githubusercontent.com/Howweird/msp-audit-scripts/master/`
|
||
- **GuruScan config:** `projects/msp-tools/guru-scan/scanners.json`
|
||
|
||
---
|
||
|
||
## Development
|
||
|
||
### Current Focus
|
||
|
||
Active development is in the submodules. See [[gururmm]] for GuruRMM's current sprint. GuruConnect is undergoing v2 architecture (native-first remote access, Rust relay/auth rebuild, bidirectional clipboard file transfer). The other tools (GuruScan, audit scripts, utilities) are maintained but not under active sprint.
|
||
|
||
### Patterns & Anti-Patterns
|
||
|
||
- GuruRMM and GuruConnect are each versioned products with their own CI/CD pipelines, changelogs, and session-log trees. Do not conflate umbrella session logs with product session logs.
|
||
- The `README.md` at the umbrella root is stale (dated 2026-01-17; describes the directory as a conversation-import archive — that framing is obsolete). Do not rely on it for current state.
|
||
- `guru-rmm-conversation-logs/` and `guru-connect-conversation-logs/` are read-only import archives. Development context lives in the submodule repos and root `session-logs/`.
|
||
|
||
### Build & Deploy
|
||
|
||
Each product has its own build and deploy procedure. See [[gururmm]] for GuruRMM. For GuruConnect, see the deploy procedure in `.claude/memory/project_guruconnect.md` (manual build on server `172.16.3.30`, login shell required for cargo/protoc on PATH).
|
||
|
||
---
|
||
|
||
## Own Session Logs — Work Captured
|
||
|
||
The `projects/msp-tools/session-logs/` directory holds two recovered log files, both reconstructed from the same transcript (`25f5d8b9`, 2026-06-02T21:14–22:06 UTC). They cover building the `/self-check` ClaudeTools harness diagnostic skill — this is ClaudeTools infrastructure work, not an MSP tool feature. The logs were saved here rather than root `session-logs/`; the reason is unclear (verify if misclassified).
|
||
|
||
**Work done in those sessions (2026-06-02):**
|
||
|
||
- Assessed existing ClaudeTools diagnostic infrastructure; determined a new harness self-check skill was needed.
|
||
- Created `manifest.json` (baseline, v1.0.0 provisional) as the single source of truth for all machines — required tools vs capability-gated tools, per-tier rules.
|
||
- Created `self-check.sh` (cross-platform bash; runs probes, grades machine, publishes census to coord API).
|
||
- Created command wrapper at `.claude/commands/self-check.md` and skill docs at `.claude/skills/self-check/`.
|
||
- First run on GURU-5070 (windows/amd64): **Grade AMBER** — PASS 71, WARN 2, FAIL 0.
|
||
- Resolved: `jq` (winget build) emitting `\r\n` line endings causing false negatives in hook/path resolution; patched with a `jq` wrapper.
|
||
- Found: `post-commit` hooks not installed despite `HOOKS.md` mandate; found `autotask.md` missing on Linux machine.
|
||
|
||
**Pending from those sessions (unresolved as of log date):**
|
||
- Manifest to be moved from provisional to ratified status.
|
||
- Validate `--json` output and graceful `aggregate` degradation.
|
||
- Mandatory code review for the self-check engine before committing.
|
||
|
||
---
|
||
|
||
## Active State
|
||
|
||
See [[gururmm]] for GuruRMM's live state. GuruConnect v2 in development; v1 prod at `connect.azcomputerguru.com` (172.16.3.30:3002 behind NPM). Self-check skill status: AMBER on GURU-5070 as of 2026-06-02; fleet aggregate status (verify current via coord API `selfcheck_*` components under `claudetools` project key).
|
||
|
||
---
|
||
|
||
## History Highlights
|
||
|
||
- **2026-01-17** — Original import of guru-rmm (54 files, 14 MB) and guru-connect (40 files, 6.1 MB) conversation archives into `projects/msp-tools/`
|
||
- **2026-05-30** — GuruConnect v2 deployed to production at `connect.azcomputerguru.com`
|
||
- **2026-06-02** — `/self-check` harness skill built; GURU-5070 grades AMBER on first run
|
||
|
||
---
|
||
|
||
## Backlinks
|
||
|
||
- [[gururmm]] — GuruRMM product article (full capability record)
|
||
- GuruConnect wiki article not yet created (verify — slug would be `guruconnect`)
|