Platform groups with CIDR rules, script editor rework, server MSI with turn-key setup, ARM agents #4

Merged
gsadmin merged 18 commits from dev into main 2026-08-08 16:15:34 +00:00
Owner

Fleet ergonomics and turn-key servers: CIDR-aware dynamic groups seeded per platform, triggers living on scripts, a reworked script editor, and a server that installs from an MSI straight to a running service with a forced first-password reset. 12 commits, all verified locally (89 + 63 + 49 tests green, svelte-check clean, production WebUI build, live screenshot pass, standalone server booted and exercised end to end).

Groups & targeting

  • CIDR rule operators (in/not in CIDR range) via the BCL System.Net.IPNetwork: comma-separated ranges, IPv4+IPv6, bare IPs as equality, host bits normalized, universal semantics across multi-homed devices. New os.platform (windows/linux/macos) and network.interface rule fields.
  • Six default platform groups seeded on first boot — Windows Servers/Workstations, Linux, Linux Servers/Workstations (unix agents report os.edition from the boot target / desktop-session detection), macOS — plus four starter schedules (hourly, daily 1 AM, weekdays 7 AM, weekly Sunday 2 AM). Each family seeds only while its table is empty.
  • Instant membership: the rule field bag falls back to enrollment-captured OS data before the first inventory snapshot, so on-agent-ready triggers scoped to platform groups cannot race the first report.
  • Scales to thousands of devices: a parsed-inventory cache keyed by snapshot timestamp — fleet-wide evaluation probes (ClientId, UpdatedUtc) only, fetches/parses just changed snapshots, prunes departed devices. Steady-state sweeps touch no JSON.

Script editor

  • Vertical flow: full-width editor with toolbar (pop-out fills the window, Esc restores; optional offline IntelliSense — curated cmdlets/keywords/snippets plus the script's own parameters and $Secrets bindings), then Execution (target + Execution values), Schedules, and Triggers cards, with full-width output below.
  • Triggers moved from Groups to scripts (on agent ready / on registration, scoped to a group or all devices).
  • Script Engine selector with short names (PowerShell 7 / PowerShell 5 / Bash) and a one-line platform-behavior hint; "function modules" are simply Functions everywhere.

Standalone server

  • Binaries are ExecuteR-Server(.exe) (containers unchanged); committed icon embeds in every full-checkout build.
  • setup alone fully configures: admin/admin by default (flags remain as overrides), NATS keys + sidecar config + appsettings, downloads nats-server for the current OS/arch when not bundled, and wires the bundled agent installers (agent-package/ with Agent.msi + Agent.zip + VERSION) so the URL install command works immediately.
  • Forced first-sign-in reset: a defaulted (or literal admin) password marks the account; valid credentials return a must-change signal with no session, the sign-in page flows into a set-new-password form, and POST /api/auth/change-password (rate-limited, credential-authenticated) completes sign-in in one step — also usable as self-service password change. Covered end to end by HTTP tests.
  • Server MSI (Server-<version>.msi): wizard page for the admin account, then the binary's own setup + service install; idempotent on repair/upgrade; uninstall stops and removes the service. Content root anchors to the binary so services and foreign working directories behave identically. Verified live: MSI contents, sidecar download from a bare directory, ready checks, admin sign-in, SPA, and bundled Agent.msi reported with version + SHA-256.

Inventory & devices

  • Network adapters report the OS interface name (Win32_NetworkAdapter join on Windows, NetworkInterface.Name on unix); the device Network tab titles adapters by interface with a copyable row.
  • The client ID is a single-line copyable chip under the device name; breadcrumb shows the hostname.

Platforms & CI

  • win-arm64 agents join the matrix (six agent RIDs total); the binaries artifact and releases carry Server-*.msi alongside the ZIPs and checksums.
  • Fixed in-flight: the schedule worker no longer races deterministic test sweeps (gated out of test hosts), and the icon reference is conditional so docker builds (no assets/ in context) publish cleanly.

🤖 Generated with Claude Code

Fleet ergonomics and turn-key servers: CIDR-aware dynamic groups seeded per platform, triggers living on scripts, a reworked script editor, and a server that installs from an MSI straight to a running service with a forced first-password reset. 12 commits, all verified locally (89 + 63 + 49 tests green, svelte-check clean, production WebUI build, live screenshot pass, standalone server booted and exercised end to end). ## Groups & targeting - **CIDR rule operators** (`in/not in CIDR range`) via the BCL `System.Net.IPNetwork`: comma-separated ranges, IPv4+IPv6, bare IPs as equality, host bits normalized, universal semantics across multi-homed devices. New `os.platform` (windows/linux/macos) and `network.interface` rule fields. - **Six default platform groups** seeded on first boot — Windows Servers/Workstations, Linux, Linux Servers/Workstations (unix agents report `os.edition` from the boot target / desktop-session detection), macOS — plus **four starter schedules** (hourly, daily 1 AM, weekdays 7 AM, weekly Sunday 2 AM). Each family seeds only while its table is empty. - **Instant membership**: the rule field bag falls back to enrollment-captured OS data before the first inventory snapshot, so on-agent-ready triggers scoped to platform groups cannot race the first report. - **Scales to thousands of devices**: a parsed-inventory cache keyed by snapshot timestamp — fleet-wide evaluation probes `(ClientId, UpdatedUtc)` only, fetches/parses just changed snapshots, prunes departed devices. Steady-state sweeps touch no JSON. ## Script editor - **Vertical flow**: full-width editor with toolbar (pop-out fills the window, Esc restores; optional offline **IntelliSense** — curated cmdlets/keywords/snippets plus the script's own parameters and `$Secrets` bindings), then Execution (target + **Execution values**), Schedules, and **Triggers** cards, with full-width output below. - **Triggers moved from Groups to scripts** (on agent ready / on registration, scoped to a group or all devices). - **Script Engine** selector with short names (PowerShell 7 / PowerShell 5 / Bash) and a one-line platform-behavior hint; "function modules" are simply **Functions** everywhere. ## Standalone server - Binaries are **`ExecuteR-Server(.exe)`** (containers unchanged); committed icon embeds in every full-checkout build. - `setup` alone fully configures: **admin/admin by default** (flags remain as overrides), NATS keys + sidecar config + appsettings, **downloads nats-server for the current OS/arch** when not bundled, and wires the **bundled agent installers** (`agent-package/` with Agent.msi + Agent.zip + VERSION) so the URL install command works immediately. - **Forced first-sign-in reset**: a defaulted (or literal `admin`) password marks the account; valid credentials return a must-change signal with **no session**, the sign-in page flows into a set-new-password form, and `POST /api/auth/change-password` (rate-limited, credential-authenticated) completes sign-in in one step — also usable as self-service password change. Covered end to end by HTTP tests. - **Server MSI** (`Server-<version>.msi`): wizard page for the admin account, then the binary's own `setup` + `service install`; idempotent on repair/upgrade; uninstall stops and removes the service. Content root anchors to the binary so services and foreign working directories behave identically. Verified live: MSI contents, sidecar download from a bare directory, ready checks, admin sign-in, SPA, and bundled Agent.msi reported with version + SHA-256. ## Inventory & devices - Network adapters report the **OS interface name** (Win32_NetworkAdapter join on Windows, `NetworkInterface.Name` on unix); the device Network tab titles adapters by interface with a copyable row. - The **client ID is a single-line copyable chip under the device name**; breadcrumb shows the hostname. ## Platforms & CI - **win-arm64 agents** join the matrix (six agent RIDs total); the `binaries` artifact and releases carry `Server-*.msi` alongside the ZIPs and checksums. - Fixed in-flight: the schedule worker no longer races deterministic test sweeps (gated out of test hosts), and the icon reference is conditional so docker builds (no `assets/` in context) publish cleanly. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
gsadmin added 12 commits 2026-08-08 14:32:35 +00:00
New in/not-in CIDR operators evaluate device IPs against comma-separated
ranges using the BCL System.Net.IPNetwork (IPv4 and IPv6; bare IPs mean
equality; host bits in the base address are normalized, so 10.20.4.99/24
matches the same network as 10.20.4.0/24). Not-in is universal across
multi-homed devices: every address must be outside.

os.platform (windows/linux/macos) derives from the OS caption so rules
and the default platform groups can target an OS family without caption
gymnastics.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Every deployment starts with four dynamic groups (Windows Servers,
Windows Workstations, Linux, macOS — driven by os.platform) and four
common cadences (hourly, daily 1 AM, weekdays 7 AM, weekly Sunday 2 AM,
UTC). Each family seeds only while its table is empty, so operator
edits and deletions are never recreated.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The editor now owns the page: full width with a toolbar (optional
IntelliSense toggle and a pop-out that fills the window, Esc restores).
IntelliSense is a curated offline provider — common cmdlets, keywords,
automatic variables, snippets, plus the script's own parameters and
$Secrets bindings — no language server. Below the editor everything
flows vertically: an Execution card (target + Execution values, the
new name for run values), Schedules, and Triggers; group fan-out and
Output sit full width underneath so output finally has room.

Triggers belong to scripts now (run on agent ready / registration,
scoped to a group or all devices) — the card lives on the script page
and the Groups page drops its trigger section.

Engine selection is labeled Script Engine with short names
(PowerShell 7 / PowerShell 5 / Bash) and a one-line hint describing
the selected engine's platform behavior. Function modules are simply
Functions everywhere.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The fixture app ran the real ScheduleWorker, whose 30-second tick could
steal a due schedule between a test seeding the schedule and its
assignments — firing with zero assignments and advancing NextRunUtc, so
the test''s deterministic manual sweep found nothing due. SCHEDULE_WORKER=0
(set by the fixture) now skips registering the hosted service.

Also anchors the content root to the binary''s directory whenever a
setup-generated appsettings.json sits next to it, so the standalone
server behaves identically however it is launched — console from any
directory, SCM service, or systemd.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
setup now lives fully in the binary to suit every platform: it accepts
--admin-user/--admin-password (written into appsettings.json on first
run only), downloads nats-server for the current OS/architecture when
the sidecar is absent (zip/tar.gz, BCL only), and wires
AGENT_PACKAGE_PATH at the bundled agent-package directory. Bundles ship
Agent.msi + Agent.zip + VERSION next to the server, so the URL install
command works immediately instead of reporting Missing. Direct binaries
are named ExecuteR-Server(.exe); container names are unchanged. The
committed icon (assets/icons/app.ico) embeds in every build, CI
included.

New Windows installer (src/Installer.Server): harvests the whole
bundle, shows an Administrator account page (defaults Admin/Admin,
ADMINUSERNAME/ADMINPASSWORD properties for silent installs), then runs
the binary''s own `setup` and `service install` — idempotent, so
upgrades and repairs never overwrite existing configuration. Uninstall
stops and removes the service. Verified end to end: MSI carries all 169
files, setup from a bare directory downloaded the sidecar, and the
booted server answered ready (db+nats+signing), signed in Admin/Admin,
served the SPA and reported the bundled Agent.msi with version and
SHA-256.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
win-arm64 joins the agent RID set (published and zipped alongside the
five existing platforms in CI and releases), and the binaries artifact
now carries Server-*.msi.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Docs and screenshots: editor flow, platform groups, server bootstrap
CI / build-test (push) Successful in 13m20s
CI / images (push) Failing after 48s
5ed93853e0
README covers the CIDR operators and os.platform field, the seeded
platform groups and starter cadences, triggers on scripts, the Script
Engine selector with pop-out/IntelliSense and the vertical execution
flow, the ExecuteR-Server rename with setup flags and in-code
nats-server download, the server MSI, bundled agent delivery, and the
win-arm64 addition to the CI matrix. Fresh captures: the new editor
layout, the execution flow with a live trigger, groups with the
default platform groups, starter schedules and the Functions rename.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Adapters now report the OS interface name — NetConnectionID joined from
Win32_NetworkAdapter on Windows ("Ethernet0"), NetworkInterface.Name on
unix ("eth0"/"en0") with the hardware description kept separately. The
device Network tab titles each adapter by interface, shows a copyable
Interface row, and rules gain a network.interface field.

The unix agent also reports os.edition: Workstation when the device
boots to a graphical session (default systemd target, installed desktop
sessions as fallback; macOS always), Server otherwise — powering two
new default groups, Linux Servers and Linux Workstations, alongside the
Linux umbrella.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Bare setup fully configures the server with admin/admin
CI / build-test (push) Successful in 11m47s
CI / images (push) Failing after 44s
573852cb83
No flags needed: setup writes the admin/admin sign-in by default (the
flags remain as overrides), prints the first sign-in guidance, and the
server MSI wizard matches with lowercase admin/admin defaults.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Defaulted admin/admin demands a new password at first sign-in
CI / build-test (push) Successful in 12m48s
CI / images (push) Successful in 1m51s
6c8016029d
Standalone setup marks the account (INITIAL_ADMIN_MUST_CHANGE) whenever
the password was left at admin — including a literal "admin" passed via
the flag or kept in the MSI wizard. Valid credentials then return a
must-change signal with no session; the sign-in page flows into a
set-new-password form, and POST /api/auth/change-password (rate-limited,
credential-authenticated, CSRF-exempt like login) sets the password,
clears the flag and completes the sign-in in one step. The endpoint
doubles as self-service password change for any local account.

Also: platform groups now work from the moment of enrollment — the rule
field bag falls back to the device row''s OS caption/version before the
first inventory snapshot lands, so on-agent-ready triggers scoped to
platform groups can''t race the first inventory report.

Covered end to end: login returns must-change without a cookie, wrong
current password refused, the change issues a full admin session, and
re-login uses the new password cleanly.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Icon reference is conditional again: docker builds lack assets/
CI / build-test (push) Successful in 11m44s
CI / images (push) Successful in 3m8s
af73894b5f
The backend image build context has no assets directory, so the
unconditional ApplicationIcon path broke the container publish (linux
images need no exe icon anyway). Full checkouts — local and the CI
binary jobs — still embed the committed icon.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Cache parsed inventory for group evaluation; client id under the title
CI / build-test (push) Successful in 11m49s
CI / images (push) Successful in 1m47s
CI / build-test (pull_request) Successful in 3m18s
CI / images (pull_request) Has been skipped
11f626fb03
Dynamic-group evaluation ran every device''s inventory blob through the
JSON deserializer on every use — fine at dozens of devices, the hot
cost at thousands. A singleton InventoryReportCache now keys parsed
snapshots by the inventory UpdatedUtc: fleet-wide evaluation probes
timestamps only, fetches JSON just for snapshots that changed, parses
those once, and prunes departed devices. Steady-state sweeps touch no
JSON at all.

The device page shows the client id as a single-line copyable chip
right under the device name (breadcrumb shows the hostname now), and
the Identity card drops the redundant wrapped row.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:08:51 +00:00
Script-integrated S3 delivery: $Files dictionary, prefixes, expansion
CI / build-test (push) Successful in 12m48s
CI / images (push) Successful in 1m57s
CI / build-test (pull_request) Successful in 3m18s
CI / images (pull_request) Has been skipped
0c15833f7c
Scripts declare file bindings in the define strip alongside parameters,
secrets and Functions: S3 objects — or whole prefixes delivered
recursively — that download to the device before execution. The server
lists and presigns everything once at dispatch (shared across group
fan-outs; failures surface before any job rows exist, like secrets),
so agents never hold S3 credentials.

On the device the destination path gets full expansion (%VAR% natively,
$env:/$(...) through a short-lived runspace regardless of engine), items
stream to temp files and move into place, relative keys are checked
against traversal, and every entry lands in a case-insensitive ordered
dictionary: $Files.Name is a FileInfo, or a DirectoryInfo for prefixes.
Per-entry continue-on-failure logs a warning and still runs the script
($Files.Name.Exists reveals what arrived); otherwise delivery failure
fails the job before execution. PowerShell 5 gets the same $Files via
typed literals; bash gets one env var per entry.

The execution flow below the editor is now fully vertical — Execution,
Schedules and Triggers each get a full-width row.

Verified with real HTTP round-trips: single files, recursive directory
trees, 404s under both failure modes, server-side resolution errors,
and path-traversal refusal (9 new tests; suites at 58/63/89, svelte
clean).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:16:22 +00:00
IntelliSense binds $Files keys; refreshed screenshots and docs
CI / build-test (push) Successful in 12m12s
CI / images (push) Successful in 1m42s
CI / build-test (pull_request) Successful in 3m11s
CI / images (pull_request) Has been skipped
718082d08a
Completions now include every file binding as $Files.Name, labeled with
its delivered type (FileInfo, or DirectoryInfo for recursive prefixes),
alongside the existing parameter and $Secrets entries. Fresh captures:
the define strip with a Files (S3) binding, the fully vertical
execution flow, the device header with the copyable client id, and the
network tab titled by interface name with its copyable Interface row.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:32:02 +00:00
Script Configuration strip with self-headed sections; directory guard
CI / build-test (push) Successful in 11m26s
CI / images (push) Successful in 3m10s
CI / build-test (pull_request) Successful in 3m18s
CI / images (pull_request) Has been skipped
cdfe02eb1b
The define strip is titled Script Configuration and every section
carries its own header — Parameters, Secrets, Files (S3), Functions —
instead of one mashed headline. Directory file deliveries now refuse a
leaf destination: the server rejects destinations whose last segment
looks like a file path (extension heuristic that tolerates version-like
dots), and the editor shows the same warning inline as you type.
Screenshots refreshed.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:36:33 +00:00
Docs sweep: cross-platform intro, Functions naming, first-reset shot
CI / build-test (pull_request) Has been cancelled
CI / images (pull_request) Has been cancelled
CI / build-test (push) Successful in 11m45s
CI / images (push) Successful in 3m20s
6dbbb56a1c
The README intro finally says what the product is now: cross-platform
agents (Windows/Linux/macOS, x64 + arm64) with three script engines and
per-platform service integration. "Function modules" is Functions in
the remaining prose and gallery, run values are execution values, and
the gallery caption for the define strip reflects Script Configuration.
New capture: the forced first-sign-in password reset (also exercised
live — the shot run set a real password and landed signed in).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:48:20 +00:00
One-click Clone for scripts, Functions, schedules, groups and roles
CI / build-test (push) Has been cancelled
CI / images (push) Has been cancelled
CI / images (pull_request) Has been cancelled
CI / build-test (pull_request) Has been cancelled
9fc557aab5
Each surface clones in place: the script editor copies its full current
state (content, engine, parameters, secrets, files, Functions) and
switches to the copy; Functions clone from the editor panel; schedule
rows copy the cadence (assignments stay with the original); group
clones carry rules or, for static groups, the member list; role clones
copy permissions and device scope — but never OIDC claim values, so
identity mappings stay unambiguous — and work on system roles too,
turning Admin/Operator/Viewer into templates. Copies land as
"Name (copy)" with collision-free numbering against unique-name tables.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin added 1 commit 2026-08-08 15:53:06 +00:00
Screenshots: clone actions, seeded schedules, live platform-group rules
CI / build-test (push) Has been cancelled
CI / images (push) Has been cancelled
CI / build-test (pull_request) Successful in 3m19s
CI / images (pull_request) Has been skipped
7549d079ce
Fresh captures across the clone-bearing surfaces: schedule rows with
Pause/Edit/Clone showing all four starter cadences, the groups page
with Windows Servers selected (its seeded platform rules in the
builder and Clone in the editor header), a saved Function with its
Clone action, the script editor header, the Script Configuration
strip, and the Access roles table with Clone on every row.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
gsadmin merged commit 5e1a37e270 into main 2026-08-08 16:15:34 +00:00
Sign in to join this conversation.