feat: Updated vuln style

fix: Fixed agent collect packages
feat: Better button description
2026-08-06 16:35:04 +01:00 · 2026-08-06 16:20:34 +01:00 · 2026-08-06 15:51:18 +01:00 · 2026-08-06 15:49:39 +01:00 · 2026-08-06 15:48:20 +01:00 · 2026-08-06 15:46:30 +01:00
111 changed files with 10771 additions and 756 deletions
@@ -124,6 +124,39 @@ A library of reusable **steps** (bash or PowerShell scripts with declared inputs

 Default steps are seeded per org at boot (`SeedDefaultSteps`) from `VANTAGE_DEFAULT_STEPS_DIR`, which `server/Dockerfile` bakes to `/opt/default-steps` from the repo's `default_steps/`. Deliberately **not** under `/data` — that is a bind mount, so the library would be editable from the host. Adding a step there means committing a file and rebuilding, which is why `default_steps/` is in the `server` rebuild trigger. **Steps with `source: "default"` are read-only**: `UpdateStep`/`DeleteStep` refuse with `ErrDefaultStep` (409), because seeding rewrites them on every boot, so an edit would silently revert and a delete would come back. `web/` mirrors this — the step modal opens read-only, Delete is hidden, and the designer's per-step script override is `readOnly` for a default library step — but as elsewhere, the API is the boundary and the UI is the courtesy. Seeding writes straight to the collection rather than through `UpdateStep`, so the guard does not lock out the seeder. Logs are swept by retention (`workflow_log_retention_days`; nil = 30 days, 0 = forever).

+### Scheduled workflows
+
+A workflow may carry `schedule{enabled, cron, tz}` — standard **5-field** cron
+and an IANA zone name, both validated at save time. `next_run_at` is
+**persisted on the document, not held in memory**: a leader handover between
+computing an occurrence and firing it would otherwise lose it or fire it twice,
+the same argument that put `workflow_log_seq` in MongoDB.
+
+`server/internal/workflowsched` ticks every 30s inside the **existing**
+`bus.RunAsLeader("housekeeping", …)` alongside `monitorsched` and the sweepers —
+one role, one lock. **The atomic claim, not the lock, is what prevents a double
+fire**: the `UpdateOne` matches on the document *and* its current `next_run_at`
+while setting the recomputed one, so a second process reaching the same workflow
+matches nothing and does nothing. The lock only makes it cheap.
+
+`workflowsched` **must not import `services`** — `services` already imports it
+for `SetSchedule`'s call to `NextOccurrence`, and Go has no cycles.
+`TriggerWorkflow` and `LogEvent` are therefore injected as `workflowsched.Deps`
+from `main.go`. Firing goes through the same `TriggerWorkflow` a person uses,
+with `"schedule"` as the actor, so there is no second dispatch path and the run
+detail page needed no changes.
+
+`main.go` imports `_ "time/tzdata"`, and it is load-bearing: `server/Dockerfile`
+runs on `scratch`, which ships no zone database, so without it
+`time.LoadLocation("Europe/London")` fails and every schedule silently falls
+back to UTC — an hour wrong for half the year, in the direction nobody notices
+until a maintenance window lands in business hours. It works on a developer
+machine either way, which is exactly why it gets forgotten.
+
+Skips are recorded and surfaced, not just logged: past the 1h grace window is
+`missed`, an active run is `already_running`, and a schedule that no longer
+parses is disabled rather than left spinning the loop every 30 seconds forever.
+
 ### Server tags and workflow targeting

 A server carries `tags map[string]string` — lowercase `[a-z0-9_-]`, key ≤32,
@@ -150,11 +183,26 @@ are **not** filtered out — the dispatcher already answers 503 per server, and
 patch run that silently omits an unreachable machine is worse than one that
 visibly fails on it.

-`web/app/(app)/workflows/[id]/page.tsx` **duplicates that match logic in
-TypeScript** to draw the resolved count without a round trip, since the browser
-already holds the fleet. It is a second implementation of `UnionTargets` /
-`MatchesTags` and must change in the same commit as the Go one — the same shape
-of hazard as the mirrored token blocks.
+**Both halves of the selector are edited in `EditWorkflowModal`** — the named
+servers in a `DualListBox`, the tag rows directly beneath it — and saved
+together by one `updateWorkflow`. The designer's Targets panel is **read-only**:
+it reports the count and the tags and links to Edit. Splitting the two halves
+across two screens meant a workflow's reach was decided in two places with no
+one view showing both.
+
+`web/lib/targets.ts` **duplicates the match logic in TypeScript** to draw the
+resolved count without a round trip, since the browser already holds the fleet.
+It is a second implementation of `UnionTargets` / `MatchesTags` and must change
+in the same commit as the Go one — the same shape of hazard as the mirrored
+token blocks. It is a shared module rather than inline in a component because
+the logic had already been written twice, and the second copy — the workflows
+list — counted `target_server_ids` alone, so a **tag-only workflow reported zero
+targets** while running fine.
+
+The server picker is a hand-built two-pane list, not `<select multiple>`: a
+native multi-select paints its selected rows with the platform highlight colour,
+which cannot be restyled across browsers and lands outside the token palette on
+a dark ground.

 ### Monitors

@@ -267,6 +315,51 @@ a Service cannot address the one pod holding a console listener.

 Agents report CPU/memory/swap/partitions/kernel — metrics every 30s, full static snapshot every 15 min. They also check for pending OS package updates hourly and can apply them on command (`ApplyUpdatesCmd`).

+### Package inventory and CVE findings
+
+Agents report their installed packages hourly; the control plane matches them
+against distribution security feeds and raises findings that link to the
+existing `ApplyUpdatesCmd` patching path. Gated by the `vuln_scanning` licence
+feature, **checked at collection rather than display** — an ungated instance
+stores no inventory, and storage is the expensive half.
+
+**Matching uses distribution feeds, never NVD version ranges.** Distributions
+backport security fixes without changing the upstream version: Ubuntu's
+`openssl 3.0.2-0ubuntu1.15` is patched against CVE-2023-0286 while NVD still
+calls 3.0.2 vulnerable. Matching on NVD would report a fully patched fleet as
+critical, and once the first report is mostly wrong nobody reads the second.
+`trivy-db` is those feeds pre-merged; `server/internal/vulndb` pulls it as an
+OCI artifact to an ephemeral directory. Version comparison is bought from
+`go-deb-version`/`go-rpm-version`/`go-apk-version` because dpkg epochs, `~`
+sorting before the empty string, and `rpmvercmp` are each a silent false
+negative waiting to happen.
+
+**Only the leader matches.** `ReportPackages` upserts the list and sets
+`scan_pending`; it does not scan. `vulnsched` runs inside the existing
+`bus.RunAsLeader("housekeeping", …)` and does the matching, because otherwise
+every replica needs the ~50MB database resident and a database refresh has N
+replicas rescanning the same fleet and sending N digests. The tick is also the
+digest's batch boundary, which is what makes "one message, not five hundred"
+structural rather than a debounce someone maintains.
+
+Findings are **never deleted when a package is patched** — the state moves to
+`fixed`, so "what did we remediate last quarter" stays answerable. Acceptance
+requires a reason and an expiry, and reopens automatically: permanent dismissal
+is where risk goes to be forgotten. An unsupported distribution reports
+`status: unsupported`, never "0 findings"; claiming clean when the truth is
+unknown is the same lie as a silently stale database, which is why
+`vulndb_meta.pulled_at` is on screen rather than only in a log.
+
+**`server/Dockerfile`'s runtime stage is `scratch`, so it carries an explicitly
+copied `/tmp`.** The scheduler unpacks the database to a temporary directory,
+and a scratch image has none — the failure is `vulnsched: temp dir: stat /tmp:
+no such file or directory`, logged once at boot while every other subsystem
+runs normally, so the only symptom is a fleet that never reports a finding.
+
+Two environment variables: `VANTAGE_TRIVY_DB_REF` mirrors the artifact for
+air-gapped installs, and `VANTAGE_VULNDB_DISABLED` switches the puller and
+scheduler off entirely.
+
 ### Agent self-update

 `UpdateAgentCmd` carries a target version and Gitea base URL; the agent downloads and replaces itself.
@@ -479,6 +572,12 @@ channels     GET,POST /channels · PUT,DELETE /channels/:id · POST /channels/:i
 secrets      GET,POST /secrets · GET,PUT,DELETE /secrets/:group
             POST /secrets/:group/reveal · DELETE /secrets/:group/:key
 console      POST /console/connect · GET /console/tunnel (websocket)
+vulns        GET /vulnerabilities · GET /vulnerabilities/summary
+             POST /vulnerabilities/rescan                          (owner|admin)
+             POST,DELETE /vulnerabilities/:id/accept               (owner|admin)
+             GET /servers/:id/vulnerabilities · GET /servers/:id/packages
+             GET /packages/search?name=
+             GET,POST /vuln-rules · PUT,DELETE /vuln-rules/:id     (owner|admin)
 audit        GET /audit
 agent        GET /agent/latest-version
 settings     GET,PUT /settings · POST /settings/secrets-token       (owner|admin)
@@ -559,7 +658,7 @@ Paddle is merchant of record; `admin/internal/paddle` is a thin REST client (no

 ## MongoDB Collections

-`servers` · `keys` · `assignments` · `orgs` · `users` · `auth_providers` · `settings` · `secrets` · `workflows` · `workflow_steps` · `workflow_runs` · `workflow_log_lines` · `workflow_log_seq` · `monitors` · `incidents` · `monitor_rollups` · `notification_channels` · `console_sessions` · `audit_logs` · `migrations`
+`servers` · `keys` · `assignments` · `orgs` · `users` · `auth_providers` · `settings` · `secrets` · `workflows` · `workflow_steps` · `workflow_runs` · `workflow_log_lines` · `workflow_log_seq` · `monitors` · `incidents` · `monitor_rollups` · `notification_channels` · `console_sessions` · `audit_logs` · `server_packages` · `vuln_findings` · `vuln_alert_rules` · `vulndb_meta` · `migrations`

 Every document except `migrations` carries `org_id`. Struct definitions are the source of truth — see `server/internal/models/`.

@@ -574,6 +673,10 @@ Notes that are not obvious from the structs:
 - `auth_providers.provider_id` is a short random identifier, not the Mongo `_id`: it appears in the callback URL a customer pastes into their IdP, and an `_id` there would publish a database key. `callback_notice` marks a provider migrated from the old single-provider shape, whose redirect URI therefore changed.
 - `workflow_log_lines` is keyed `(run_id, server_id, seq)` — the index is not an optimisation, every read is a range scan over it. `workflow_log_seq` holds one counter document per `run_id/server_id`, which is what lets two pods interleave into one ordered log. Neither carries `instance_id`: they are reached only through a run, and a run is already scoped.
 - `users.auth_source` is `local`, `oidc` or `hq`. An `hq` user was projected from a Vantage HQ account and carries `hq_user_id`; HQ owns its role, password and existence.
+- `server_packages` holds a server's whole package set in **one** document, not one per package. The hash already established that something changed, so a report is a single atomic upsert with no delta logic to get wrong; ~2000 packages is ~150KB, well inside the 16MB limit. `scan_pending` lives on the document rather than in memory so a leader handover cannot lose it.
+- `vuln_findings` is unique on `(instance_id, server_id, cve_id, package_name)`. That key is what makes a rescan an idempotent upsert rather than a duplicate factory, and what lets `first_seen` survive one. An empty `fixed_in` means no vendor fix exists — a real state, never "not vulnerable".
+- `vulndb_meta` is a singleton and deliberately carries **no** `instance_id`: the vulnerability database is a property of the deployment, not a tenant. Same reasoning as `migrations`, and the reason it is absent from `services.ScopedCollections`.
+- **`services.ScopedCollections` is the canonical registry of tenant-scoped collections**, and `scopedCollectionsForPurge` derives instance deletion from it rather than keeping a second list. A new collection carrying `instance_id` must be added there or its rows outlive the instance.

 Admin's own database is separate and holds `accounts` · `admin_instances` · `licenses` · `subscriptions` · `plans` · `catalogue` · `entitlements` · `paddle_events` · `staff_users` · `customer_users` · `instance_members` · `admin_audit`. `paddle_events` is the webhook idempotency log, unique on `event_id`: an event is claimed there before processing, and a duplicate of a handled event is a 200 no-op. `instance_members` is unique on `(instance_id, customer_user_id)` — one person holds at most one user in one instance, which makes a grant idempotent-by-refusal rather than silently doubling a projection. It is an _index_ of the control-plane rows, not the authority (see "Grants project, they do not federate"). Admin has no migrations collection; `models.Backfill` runs on every boot and is idempotent by filtering on the absence of what it writes.

@@ -666,6 +769,8 @@ Windows: MSI built by CI (WiX), or `installer/setup.ps1` registering the agent a
 | `POD_IP`                   | no              | this pod's own address, set by the Helm chart from the downward API. **Takes precedence over `PROXY_ADVERTISE_HOST`** — a console relay listener belongs to one replica, and a Service address names all of them                                                                                                     |
 | `VANTAGE_MIGRATE_ONLY`     | no              | run schema setup (migrations, index builders, default-step seeding) and exit without serving. `GRPC_HOST` is not required in this mode. Set by the Helm chart's pre-upgrade Job                                                                                                                                                          |
 | `VANTAGE_SKIP_MIGRATIONS`  | no              | serve without running schema setup, on the assumption a Job already did. Set by the chart's Deployment whenever `server.migrationJob.enabled`. Unset under Compose, where one process still migrates and then serves                                                                                                                    |
+| `VANTAGE_TRIVY_DB_REF`     | no              | default `ghcr.io/aquasecurity/trivy-db:2`. Point at a mirror for an air-gapped install, or to avoid the anonymous ghcr rate limit                                                                                                                                                                                    |
+| `VANTAGE_VULNDB_DISABLED`  | no              | `true` disables the vulnerability database puller and scan loop entirely. Findings already written are still served, and still shown as stale                                                                                                                                                                       |
 | `FREE_INSTANCE_REAP_AFTER` | no              | duration past a Free licence's expiry before the instance and all its data are deleted. **Empty disables the reaper, and empty is the default.** Set to `336h` in `docker-compose.site.yml` only — a self-hosted deployment must never reap. Must match admin's value, which only names the date in warning emails |

 **sitesvc** (`deploy/docker-compose.site.yml` only):
@@ -67,7 +67,8 @@ func (r CatalogueRow) Priced(env string) bool {
 	return false
 }

-// SeedCatalogue inserts the sixteen rows the four PAID plans need.
+// SeedCatalogue inserts the twenty rows the four PAID plans need: a base, a
+// server limit, and one row per feature key.
 //
 // The two Free plans get no rows at all, and that absence is what keeps Free
 // outside Paddle: with nothing to price, no checkout can be built for it. Do not
@@ -84,6 +85,7 @@ func SeedCatalogue(ctx context.Context) error {
 				{Kind: KindLimit, Deployment: deployment, Tier: tier, LimitKey: LimitKeyServers},
 				{Kind: KindFeature, Deployment: deployment, Tier: tier, FeatureKey: license.FeatureConsole},
 				{Kind: KindFeature, Deployment: deployment, Tier: tier, FeatureKey: license.FeatureOIDC},
+				{Kind: KindFeature, Deployment: deployment, Tier: tier, FeatureKey: license.FeatureVulnScanning},
 			}
 			for _, r := range rows {
 				filter := bson.M{
@@ -12,6 +12,7 @@ import { StatePill } from "@/components/StatePill";
 import { PageFrame, RailCard, RailFacts } from "@/components/PageFrame";
 import { PageHeader } from "@/components/PageHeader";
 import { formatDate, licenceState, limitLabel } from "@/lib/format";
+import { featureLabel } from "@/lib/features";

 export default function InstancePage() {
    const id = String(useParams().id);
@@ -104,7 +105,11 @@ export default function InstancePage() {
                                        },
                                        {
                                            label: "Features",
-                                            value: lic.features.join(", ") || "none",
+                                            // Labelled, not raw keys: this is
+                                            // the customer's own licence, and
+                                            // "vuln_scanning" is not a name
+                                            // anyone bought.
+                                            value: lic.features.map(featureLabel).join(", ") || "none",
                                        },
                                    ]}
                                />
@@ -6,25 +6,16 @@ import Link from "next/link";
 import { useMutation, useQuery } from "@tanstack/react-query";
 import { ApiError, api, lineItemsFor, type CatalogueRow, type CheckoutOptions, type Deployment, type Plan, type Term, type Tier } from "@/lib/api";
 import { initPaddle, previewPrices, type PricePreview } from "@/lib/paddle";
+import { featureDesc, featureLabel } from "@/lib/features";

 /* Tiers in the order a customer reads them, cheapest first. */
 const TIER_ORDER: Tier[] = ["free", "professional", "enterprise"];

 const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;

-/* Human labels for feature keys. The catalogue names them by key; this is the
- * one place the customer-facing wording lives. */
-const FEATURE_LABEL: Record<string, string> = {
-    console: "Browser console",
-    oidc: "Single sign-on",
-};
-const FEATURE_DESC: Record<string, string> = {
-    console: "In-browser SSH, RDP and VNC sessions",
-    oidc: "OIDC sign-in for your whole team",
-};
-function featureLabel(key: string) {
-    return FEATURE_LABEL[key] ?? key;
-}
+/* Feature wording lives in lib/features.ts, shared with the staff
+ * configurator. It was duplicated here and there, and the two copies had
+ * already drifted. */

 interface Choice {
    tier: Tier;
@@ -294,7 +285,7 @@ export function PurchaseForm() {
                            {featureKeys.map((key) => {
                                const st = featureStateFor(plan, rows, options.env, choice.term, key);
                                return (
-                                    <Row key={key} title={featureLabel(key)} desc={FEATURE_DESC[key] ?? ""} dim={st === "absent"}>
+                                    <Row key={key} title={featureLabel(key)} desc={featureDesc(key)} dim={st === "absent"}>
                                        {st === "included" ? (
                                            <span className="text-[0.72rem] font-semibold uppercase tracking-[0.06em] text-valid">Included</span>
                                        ) : st === "absent" ? (
@@ -2,6 +2,7 @@

 import { useMemo } from "react";
 import type { CatalogueRow, Deployment, Plan, Term, Tier } from "@/lib/api";
+import { featureLabel } from "@/lib/features";

 export interface PlanChoice {
    tier: Tier;
@@ -159,7 +160,7 @@ export default function PlanConfigurator({
                                        })
                                    }
                                />
-                                <span>{key === "console" ? "Browser console" : "Single sign-on"}</span>
+                                <span>{featureLabel(key)}</span>
                                <span className="text-[0.72rem] text-ink-3">
                                    {priced ? "paid add-on" : "included"}
                                </span>
@@ -0,0 +1,27 @@
+/* Human wording for licence feature keys.
+ *
+ * One place, because there were two and they disagreed: the staff configurator
+ * rendered every key that was not "console" as "Single sign-on", so adding a
+ * third feature silently mislabelled the checkbox that grants it. A map with a
+ * fallback degrades to the raw key, which is ugly but never wrong.
+ *
+ * Keys must match shared/license/license.go. */
+export const FEATURE_LABEL: Record<string, string> = {
+    console: "Browser console",
+    oidc: "Single sign-on",
+    vuln_scanning: "Vulnerability scanning",
+};
+
+export const FEATURE_DESC: Record<string, string> = {
+    console: "In-browser SSH, RDP and VNC sessions",
+    oidc: "OIDC sign-in for your whole team",
+    vuln_scanning: "Package inventory matched against distribution security advisories",
+};
+
+export function featureLabel(key: string): string {
+    return FEATURE_LABEL[key] ?? key;
+}
+
+export function featureDesc(key: string): string {
+    return FEATURE_DESC[key] ?? "";
+}
@@ -80,7 +80,11 @@ func (c *Client) Register(serverID, preRegToken, hostname, ipAddress, osInfo str
 	return resp.AgentToken, nil
 }

-func (c *Client) SyncKeys(serverID, agentToken, version string) ([]string, error) {
+// SyncKeys returns the whole response rather than just the keys: the poll now
+// also carries CollectPackages, and a second RPC purely to learn one boolean
+// would be a message every 30 seconds for a value that changes at most when a
+// licence does.
+func (c *Client) SyncKeys(serverID, agentToken, version string) (*pb.SyncResponse, error) {
 	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
 	defer cancel()

@@ -92,7 +96,21 @@ func (c *Client) SyncKeys(serverID, agentToken, version string) ([]string, error
 	if err != nil {
 		return nil, err
 	}
-	return resp.PublicKeys, nil
+	return resp, nil
+}
+
+// ReportPackages sends a package report and returns whether the server wants
+// the full list. Given a longer deadline than the other unary calls because the
+// full body is ~150KB on a slow link.
+func (c *Client) ReportPackages(req *pb.ReportPackagesRequest) (bool, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 60*time.Second)
+	defer cancel()
+
+	resp, err := c.client.ReportPackages(ctx, req)
+	if err != nil {
+		return false, err
+	}
+	return resp.NeedFull, nil
 }

 func (c *Client) UploadGeneratedKey(serverID, agentToken, publicKey, privateKey, label string) (string, error) {
@@ -30,6 +30,45 @@ type SyncRequest struct {

 type SyncResponse struct {
 	PublicKeys []string `json:"public_keys"`
+	// CollectPackages tells the agent whether this instance's licence grants
+	// vulnerability scanning. Absent decodes as false, which is the safe
+	// direction: an older server leaves agents collecting nothing.
+	CollectPackages bool `json:"collect_packages,omitempty"`
+}
+
+type OSRelease struct {
+	Family string `json:"family"`
+	// VersionId is not optional: Ubuntu 22.04 and 24.04 publish different fixed
+	// versions for the same CVE, so a scan without it is guesswork.
+	VersionId string `json:"version_id"`
+	Arch      string `json:"arch,omitempty"`
+}
+
+type InstalledPackage struct {
+	Name    string `json:"name"`
+	Version string `json:"version"`
+	Epoch   int32  `json:"epoch,omitempty"`
+	Arch    string `json:"arch,omitempty"`
+	// SourceName is what the Debian and Ubuntu feeds are keyed on: one advisory
+	// against "openssl" covers libssl3, openssl and libssl-dev.
+	SourceName string `json:"source_name,omitempty"`
+}
+
+// ReportPackagesRequest carries a server's installed package set.
+//
+// The agent calls twice at most: first with Packages empty, offering only the
+// hash. If the server already holds it, NeedFull is false and the ~150KB body
+// is never sent.
+type ReportPackagesRequest struct {
+	ServerId   string             `json:"server_id"`
+	AgentToken string             `json:"agent_token"`
+	Hash       string             `json:"hash"`
+	Os         OSRelease          `json:"os"`
+	Packages   []InstalledPackage `json:"packages,omitempty"`
+}
+
+type ReportPackagesResponse struct {
+	NeedFull bool `json:"need_full"`
 }

 type UploadKeyRequest struct {
@@ -337,6 +376,7 @@ type VantageClient interface {
 	SyncKeys(ctx context.Context, in *SyncRequest, opts ...grpc.CallOption) (*SyncResponse, error)
 	UploadGeneratedKey(ctx context.Context, in *UploadKeyRequest, opts ...grpc.CallOption) (*UploadKeyResponse, error)
 	ReportUpdates(ctx context.Context, in *ReportUpdatesRequest, opts ...grpc.CallOption) (*ReportUpdatesResponse, error)
+	ReportPackages(ctx context.Context, in *ReportPackagesRequest, opts ...grpc.CallOption) (*ReportPackagesResponse, error)
 	ReportInventory(ctx context.Context, in *InventoryReport, opts ...grpc.CallOption) (*InventoryReportResponse, error)
 	SyncMonitors(ctx context.Context, in *SyncMonitorsRequest, opts ...grpc.CallOption) (*SyncMonitorsResponse, error)
 	ReportChecks(ctx context.Context, in *ReportChecksRequest, opts ...grpc.CallOption) (*ReportChecksResponse, error)
@@ -396,6 +436,14 @@ func (c *keyManagerClient) ReportUpdates(ctx context.Context, in *ReportUpdatesR
 	return out, nil
 }

+func (c *keyManagerClient) ReportPackages(ctx context.Context, in *ReportPackagesRequest, opts ...grpc.CallOption) (*ReportPackagesResponse, error) {
+	out := new(ReportPackagesResponse)
+	if err := c.cc.Invoke(ctx, "/vantage.v1.Vantage/ReportPackages", in, out, opts...); err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
 func (c *keyManagerClient) ReportInventory(ctx context.Context, in *InventoryReport, opts ...grpc.CallOption) (*InventoryReportResponse, error) {
 	out := new(InventoryReportResponse)
 	if err := c.cc.Invoke(ctx, "/vantage.v1.Vantage/ReportInventory", in, out, opts...); err != nil {
@@ -0,0 +1,63 @@
+package packages
+
+import (
+	"bufio"
+	"errors"
+	"io"
+	"os"
+	"runtime"
+	"strings"
+)
+
+// OSRelease identifies the distribution well enough to select an advisory
+// feed. VersionID is not optional: Ubuntu 22.04 and 24.04 publish different
+// fixed versions for the same CVE.
+type OSRelease struct {
+	Family    string
+	VersionID string
+	Arch      string
+}
+
+// ParseOSRelease reads the os-release format: KEY=value, one per line, with
+// values optionally quoted, and # comments.
+//
+// The quote stripping handles both ID=ubuntu and ID="rocky", which real
+// distributions both emit.
+func ParseOSRelease(r io.Reader) (OSRelease, error) {
+	out := OSRelease{Arch: runtime.GOARCH}
+	sc := bufio.NewScanner(r)
+	for sc.Scan() {
+		line := strings.TrimSpace(sc.Text())
+		if line == "" || strings.HasPrefix(line, "#") {
+			continue
+		}
+		key, val, ok := strings.Cut(line, "=")
+		if !ok {
+			continue
+		}
+		val = strings.Trim(strings.TrimSpace(val), `"'`)
+		switch strings.TrimSpace(key) {
+		case "ID":
+			out.Family = strings.ToLower(val)
+		case "VERSION_ID":
+			out.VersionID = val
+		}
+	}
+	if err := sc.Err(); err != nil {
+		return OSRelease{}, err
+	}
+	if out.Family == "" {
+		return OSRelease{}, errors.New("os-release has no ID")
+	}
+	return out, nil
+}
+
+// DetectOS reads /etc/os-release.
+func DetectOS() (OSRelease, error) {
+	f, err := os.Open("/etc/os-release")
+	if err != nil {
+		return OSRelease{}, err
+	}
+	defer f.Close()
+	return ParseOSRelease(f)
+}
@@ -0,0 +1,73 @@
+package packages
+
+import (
+	"context"
+	"fmt"
+	"os/exec"
+	"runtime"
+	"time"
+)
+
+const collectTimeout = 2 * time.Minute
+
+// Collect enumerates installed packages. Linux only: Windows agents are
+// second-class by design, and vulnerability scanning there needs a different
+// source, a different collector and a different matcher, all out of scope.
+//
+// The format strings below are raw string literals on purpose. The "\t" and
+// "\n" reach dpkg-query and rpm as two characters each, and those tools do the
+// interpreting themselves — Go must not consume the escapes first.
+func Collect() (OSRelease, []Package, error) {
+	if runtime.GOOS != "linux" {
+		return OSRelease{}, nil, fmt.Errorf("package collection is linux-only, got %s", runtime.GOOS)
+	}
+
+	osrel, err := DetectOS()
+	if err != nil {
+		return OSRelease{}, nil, fmt.Errorf("detect os: %w", err)
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), collectTimeout)
+	defer cancel()
+
+	switch {
+	case have("dpkg-query"):
+		out, err := run(ctx, "dpkg-query", "-W", "-f",
+			`${Package}\t${Version}\t${Architecture}\t${source:Package}\n`)
+		if err != nil {
+			return osrel, nil, err
+		}
+		return osrel, ParseDpkg(out), nil
+
+	case have("rpm"):
+		out, err := run(ctx, "rpm", "-qa", "--qf",
+			`%{NAME}\t%{EPOCH}\t%{VERSION}-%{RELEASE}\t%{ARCH}\t%{SOURCERPM}\n`)
+		if err != nil {
+			return osrel, nil, err
+		}
+		return osrel, ParseRPM(out), nil
+
+	case have("apk"):
+		out, err := run(ctx, "apk", "info", "-v")
+		if err != nil {
+			return osrel, nil, err
+		}
+		return osrel, ParseAPK(out), nil
+
+	default:
+		return osrel, nil, fmt.Errorf("no supported package manager found")
+	}
+}
+
+func have(bin string) bool {
+	_, err := exec.LookPath(bin)
+	return err == nil
+}
+
+func run(ctx context.Context, name string, args ...string) (string, error) {
+	out, err := exec.CommandContext(ctx, name, args...).Output()
+	if err != nil {
+		return "", fmt.Errorf("%s: %w", name, err)
+	}
+	return string(out), nil
+}
@@ -0,0 +1,146 @@
+package packages
+
+import (
+	"crypto/sha256"
+	"encoding/hex"
+	"sort"
+	"strconv"
+	"strings"
+)
+
+// Package is one installed package as the distribution reports it. Version is
+// the distribution's own version string, verbatim — never normalised, because
+// the advisory feeds are keyed on exactly this form.
+type Package struct {
+	Name       string
+	Version    string
+	Epoch      int
+	Arch       string
+	SourceName string
+}
+
+// ParseDpkg reads tab-separated output of
+// dpkg-query -W -f '${Package}\t${Version}\t${Architecture}\t${source:Package}\n'
+//
+// SourceName is why the fourth column is requested at all: Debian and Ubuntu
+// advisories are keyed on the SOURCE package, so one CVE against "openssl"
+// covers the binaries libssl3, openssl and libssl-dev. Matching on binary name
+// alone finds one of the three.
+func ParseDpkg(out string) []Package {
+	var pkgs []Package
+	for _, line := range strings.Split(out, "\n") {
+		if strings.TrimSpace(line) == "" {
+			continue
+		}
+		f := strings.Split(line, "\t")
+		if len(f) < 3 {
+			continue
+		}
+		p := Package{Name: f[0], Version: f[1], Arch: f[2]}
+		if len(f) > 3 && f[3] != "" {
+			p.SourceName = f[3]
+		} else {
+			p.SourceName = p.Name
+		}
+		pkgs = append(pkgs, p)
+	}
+	return pkgs
+}
+
+// ParseRPM reads tab-separated output of
+// rpm -qa --qf '%{NAME}\t%{EPOCH}\t%{VERSION}-%{RELEASE}\t%{ARCH}\t%{SOURCERPM}\n'
+func ParseRPM(out string) []Package {
+	var pkgs []Package
+	for _, line := range strings.Split(out, "\n") {
+		if strings.TrimSpace(line) == "" {
+			continue
+		}
+		f := strings.Split(line, "\t")
+		if len(f) < 4 {
+			continue
+		}
+		epoch := 0
+		// rpm prints "(none)" rather than omitting the field when a package has
+		// no epoch. That must become 0, not fail the line.
+		if f[1] != "" && f[1] != "(none)" {
+			if n, err := strconv.Atoi(f[1]); err == nil {
+				epoch = n
+			}
+		}
+		p := Package{Name: f[0], Epoch: epoch, Version: f[2], Arch: f[3]}
+		if len(f) > 4 {
+			p.SourceName = srcRPMName(f[4])
+		}
+		if p.SourceName == "" {
+			p.SourceName = p.Name
+		}
+		pkgs = append(pkgs, p)
+	}
+	return pkgs
+}
+
+// srcRPMName reduces "openssl-3.0.7-24.el9.src.rpm" to "openssl" by dropping
+// the trailing ".src.rpm" and then the version and release segments, which are
+// the last two hyphen-separated fields.
+func srcRPMName(s string) string {
+	s = strings.TrimSuffix(s, ".src.rpm")
+	parts := strings.Split(s, "-")
+	if len(parts) <= 2 {
+		return s
+	}
+	return strings.Join(parts[:len(parts)-2], "-")
+}
+
+// ParseAPK reads "apk info -v" output: one "name-version-rREV" per line.
+// Alpine has no separate source package, so SourceName mirrors Name.
+func ParseAPK(out string) []Package {
+	var pkgs []Package
+	for _, line := range strings.Split(out, "\n") {
+		line = strings.TrimSpace(line)
+		if line == "" {
+			continue
+		}
+		name, version := splitAPK(line)
+		if name == "" {
+			continue
+		}
+		pkgs = append(pkgs, Package{Name: name, Version: version, SourceName: name})
+	}
+	return pkgs
+}
+
+// splitAPK finds the version boundary from the RIGHT. The version is always the
+// last two hyphen-separated fields ("<version>-r<rev>"), which is reliable
+// where scanning from the left is not: package names legitimately contain
+// digits and underscores, so "musl" in "musl-1.2.4_git20230717-r4" cannot be
+// found by looking for the first digit.
+func splitAPK(s string) (name, version string) {
+	last := strings.LastIndex(s, "-")
+	if last <= 0 {
+		return "", ""
+	}
+	prev := strings.LastIndex(s[:last], "-")
+	if prev <= 0 {
+		return "", ""
+	}
+	return s[:prev], s[prev+1:]
+}
+
+// Hash fingerprints a package set so an unchanged set never has to be sent.
+//
+// It sorts first: the ordering of dpkg or rpm output is not guaranteed stable,
+// and an ordering-sensitive hash would resend the full ~150KB list every hour
+// for no reason — a cost visible only as traffic.
+func Hash(pkgs []Package) string {
+	lines := make([]string, 0, len(pkgs))
+	for _, p := range pkgs {
+		lines = append(lines, p.Name+"\x00"+strconv.Itoa(p.Epoch)+"\x00"+p.Version+"\x00"+p.Arch)
+	}
+	sort.Strings(lines)
+	h := sha256.New()
+	for _, l := range lines {
+		h.Write([]byte(l))
+		h.Write([]byte("\n"))
+	}
+	return hex.EncodeToString(h.Sum(nil))
+}
@@ -0,0 +1,125 @@
+package agentsync
+
+import (
+	"context"
+	"log"
+	"runtime"
+	"sync"
+	"sync/atomic"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/agent/internal/config"
+	grpcclient "gitea.hostxtra.co.uk/mrhid6/vantage/agent/internal/grpc"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/agent/internal/grpc/pb"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/agent/internal/packages"
+)
+
+// collectPackagesFlag is written by the 30s key poll and read by the hourly
+// package loop — two different goroutines, hence the atomic.
+//
+// It defaults to false, so an agent that has not yet completed a poll, or is
+// talking to a server too old to send the field, collects nothing. Off is the
+// safe default: collecting without a licence costs the customer storage they
+// are not paying for.
+var collectPackagesFlag atomic.Bool
+
+// firstPoll closes once a SyncKeys response has set the flag above.
+//
+// Without it the boot-time package report loses a race it can only lose: the
+// hourly loop starts before the first poll, reads a flag that is still false by
+// construction, and skips — so a freshly installed agent reports no packages for
+// an hour and the server shows nothing to scan.
+// How long the boot package report waits for that first poll. Two poll
+// intervals plus slack: long enough to cover one failed attempt, short enough
+// that a dead control plane does not hold the OS-update report hostage.
+const firstPollWait = 90 * time.Second
+
+var (
+	firstPoll     = make(chan struct{})
+	firstPollOnce sync.Once
+)
+
+func markFirstPoll() { firstPollOnce.Do(func() { close(firstPoll) }) }
+
+// waitFirstPoll blocks until the flag is known, or gives up. The wait is
+// bounded because this loop also reports OS updates, which do not depend on the
+// flag at all — a control plane that cannot be polled must not silence those too.
+func waitFirstPoll(ctx context.Context, limit time.Duration) {
+	t := time.NewTimer(limit)
+	defer t.Stop()
+	select {
+	case <-firstPoll:
+	case <-t.C:
+		log.Printf("package collection: no SyncKeys response within %s, collecting nothing this round", limit)
+	case <-ctx.Done():
+	}
+}
+
+func collectPackagesEnabled() bool { return collectPackagesFlag.Load() }
+
+// reportPackages offers a hash of the installed package set and sends the full
+// list only if the server does not already hold it.
+//
+// It runs on the same hourly cadence as the update check because a package set
+// changes on roughly the same schedule, and reusing that loop means one timer
+// rather than two.
+func reportPackages(client *grpcclient.Client, cfg *config.Config) {
+	if runtime.GOOS != "linux" {
+		return
+	}
+	if !collectPackagesEnabled() {
+		return
+	}
+
+	osrel, pkgs, err := packages.Collect()
+	if err != nil {
+		log.Printf("package collection error: %v", err)
+		return
+	}
+
+	pbOS := pb.OSRelease{
+		Family:    osrel.Family,
+		VersionId: osrel.VersionID,
+		Arch:      osrel.Arch,
+	}
+	hash := packages.Hash(pkgs)
+
+	// The offer: hash only, no body. On an unchanged host this is the whole
+	// exchange, which is the point of the handshake.
+	needFull, err := client.ReportPackages(&pb.ReportPackagesRequest{
+		ServerId:   cfg.ServerID,
+		AgentToken: cfg.AgentToken,
+		Hash:       hash,
+		Os:         pbOS,
+	})
+	if err != nil {
+		log.Printf("ReportPackages offer error: %v", err)
+		return
+	}
+	if !needFull {
+		return
+	}
+
+	pbPkgs := make([]pb.InstalledPackage, len(pkgs))
+	for i, p := range pkgs {
+		pbPkgs[i] = pb.InstalledPackage{
+			Name:       p.Name,
+			Version:    p.Version,
+			Epoch:      int32(p.Epoch),
+			Arch:       p.Arch,
+			SourceName: p.SourceName,
+		}
+	}
+
+	if _, err := client.ReportPackages(&pb.ReportPackagesRequest{
+		ServerId:   cfg.ServerID,
+		AgentToken: cfg.AgentToken,
+		Hash:       hash,
+		Os:         pbOS,
+		Packages:   pbPkgs,
+	}); err != nil {
+		log.Printf("ReportPackages full error: %v", err)
+		return
+	}
+	log.Printf("reported %d installed packages", len(pkgs))
+}
@@ -92,11 +92,19 @@ func Run(ctx context.Context, cfg *config.Config, version string) error {
 }

 func poll(client *grpcclient.Client, cfg *config.Config, version string) error {
-	desired, err := client.SyncKeys(cfg.ServerID, cfg.AgentToken, version)
+	resp, err := client.SyncKeys(cfg.ServerID, cfg.AgentToken, version)
 	if err != nil {
 		return fmt.Errorf("SyncKeys: %w", err)
 	}

+	// Stored atomically: the hourly package loop reads this from another
+	// goroutine. Absent on the wire decodes as false, so an older server leaves
+	// collection off rather than on.
+	collectPackagesFlag.Store(resp.CollectPackages)
+	markFirstPoll()
+
+	desired := resp.PublicKeys
+
 	if runtime.GOOS != "linux" {
 		return nil
 	}
@@ -395,8 +403,17 @@ func runUpdateCheck(ctx context.Context, cfg *config.Config) {
 			return
 		}
 		log.Printf("reported %d available OS updates", len(pkgs))
+
+		// Same hourly cadence, same connection. A package set changes on
+		// roughly the schedule available updates do, so this needs no timer of
+		// its own.
+		reportPackages(client, cfg)
 	}

+	// The boot round only: after this the flag has long been set, and every
+	// later tick is an hour past a poll that runs every 30s.
+	waitFirstPoll(ctx, firstPollWait)
+
 	doCheck()
 	ticker := time.NewTicker(interval)
 	defer ticker.Stop()
@@ -0,0 +1,12 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Apply Package Updates",
+  "description": "Apply all pending OS package updates. Supports apt, dnf, yum, zypper, apk and pacman.",
+  "interpreter": "bash",
+  "script": "set -u\nif command -v apt-get >/dev/null 2>&1; then\n    export DEBIAN_FRONTEND=noninteractive\n    apt-get update -qq && apt-get -y -qq upgrade\nelif command -v dnf >/dev/null 2>&1; then\n    dnf -y upgrade\nelif command -v yum >/dev/null 2>&1; then\n    yum -y update\nelif command -v zypper >/dev/null 2>&1; then\n    zypper --non-interactive update\nelif command -v apk >/dev/null 2>&1; then\n    apk update && apk upgrade\nelif command -v pacman >/dev/null 2>&1; then\n    pacman -Syu --noconfirm\nelse\n    echo \"no supported package manager found\"\n    exit 1\nfi\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"package update failed\"\n    exit 1\nfi\necho \"packages up to date\"\n# Debian and Ubuntu drop this file when a new kernel or libc needs a restart.\n# Reported rather than acted on: rebooting a fleet is a decision, not a detail.\nif [ -f /var/run/reboot-required ]; then\n    echo \"REBOOT_REQUIRED=true\" >> $WORKFLOW_ENV\n    echo \"a reboot is required to finish applying updates\"\nelse\n    echo \"REBOOT_REQUIRED=false\" >> $WORKFLOW_ENV\nfi",
+  "declared_outputs": [
+    "REBOOT_REQUIRED"
+  ],
+  "declared_inputs": [],
+  "secret_refs": []
+}
@@ -0,0 +1,23 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Check Port Is Listening",
+  "description": "Fail unless something is listening on a TCP port.",
+  "interpreter": "bash",
+  "script": "set -u\nhost=\"${host:-127.0.0.1}\"\nif command -v nc >/dev/null 2>&1; then\n    nc -z -w 5 \"$host\" \"$port\" >/dev/null 2>&1\n    ok=$?\nelse\n    # bash builds /dev/tcp in, so this needs nothing installed.\n    timeout 5 bash -c \"cat < /dev/null > /dev/tcp/$host/$port\" >/dev/null 2>&1\n    ok=$?\nfi\nif [ $ok -ne 0 ]; then\n    echo \"PORT_OPEN=false\" >> $WORKFLOW_ENV\n    echo \"nothing listening on $host:$port\"\n    exit 1\nfi\necho \"PORT_OPEN=true\" >> $WORKFLOW_ENV\necho \"$host:$port is open\"",
+  "declared_outputs": [
+    "PORT_OPEN"
+  ],
+  "declared_inputs": [
+    {
+      "name": "host",
+      "default": "127.0.0.1",
+      "description": "host to test"
+    },
+    {
+      "name": "port",
+      "default": "",
+      "description": "TCP port to test"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,23 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Copy File/Directory",
+  "description": "Copy a file or directory, preserving mode, ownership and timestamps.",
+  "interpreter": "bash",
+  "script": "set -u\nif [ ! -e \"$source\" ]; then\n    echo \"source $source does not exist\"\n    exit 1\nfi\ncp -a \"$source\" \"$destination\" || { echo \"failed to copy $source to $destination\"; exit 1; }\necho \"copied $source to $destination\"\necho \"DEST_PATH=$destination\" >> $WORKFLOW_ENV",
+  "declared_outputs": [
+    "DEST_PATH"
+  ],
+  "declared_inputs": [
+    {
+      "name": "source",
+      "default": "",
+      "description": "path to copy from"
+    },
+    {
+      "name": "destination",
+      "default": "",
+      "description": "path to copy to"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,23 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Create Directory",
+  "description": "Create a directory, including any missing parents.",
+  "interpreter": "bash",
+  "script": "set -u\nmkdir -p \"$path\" || { echo \"failed to create $path\"; exit 1; }\nif [ -n \"${mode:-}\" ]; then\n    chmod \"$mode\" \"$path\" || { echo \"failed to set mode $mode on $path\"; exit 1; }\nfi\necho \"created $path\"\necho \"DIR_PATH=$path\" >> $WORKFLOW_ENV",
+  "declared_outputs": [
+    "DIR_PATH"
+  ],
+  "declared_inputs": [
+    {
+      "name": "path",
+      "default": "",
+      "description": "directory to create"
+    },
+    {
+      "name": "mode",
+      "default": "",
+      "description": "optional octal mode, e.g. 0750"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Delete File/Directory",
+  "description": "Delete a path. Refuses the root filesystem and an empty value.",
+  "interpreter": "bash",
+  "script": "set -u\n# A step that runs as root on every server in a selector has to refuse the\n# one input that would wipe the fleet. An unset variable expands to empty,\n# so the empty case is the accident this actually guards against.\ncase \"$path\" in\n    \"\"|\"/\"|\"/.\"|\"/..\")\n        echo \"refusing to delete '$path'\"\n        exit 1\n        ;;\nesac\nif [ ! -e \"$path\" ]; then\n    echo \"$path does not exist, nothing to do\"\n    exit 0\nfi\nrm -rf \"$path\" || { echo \"failed to delete $path\"; exit 1; }\necho \"deleted $path\"",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "path",
+      "default": "",
+      "description": "path to delete"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,24 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Disk Usage Report",
+  "description": "Report usage for a mount point and fail past a threshold.",
+  "interpreter": "bash",
+  "script": "set -u\nmount=\"${mountPoint:-/}\"\nlimit=\"${maxPercent:-90}\"\ndf -h \"$mount\"\nused=$(df --output=pcent \"$mount\" | tail -1 | tr -dc \"0-9\")\navail=$(df -h --output=avail \"$mount\" | tail -1 | tr -d \" \")\necho \"DISK_USED_PERCENT=$used\" >> $WORKFLOW_ENV\necho \"DISK_AVAILABLE=$avail\" >> $WORKFLOW_ENV\nif [ \"$used\" -ge \"$limit\" ]; then\n    echo \"$mount is ${used}% full, at or over the ${limit}% limit\"\n    exit 1\nfi\necho \"$mount is ${used}% full, ${avail} available\"",
+  "declared_outputs": [
+    "DISK_USED_PERCENT",
+    "DISK_AVAILABLE"
+  ],
+  "declared_inputs": [
+    {
+      "name": "mountPoint",
+      "default": "/",
+      "description": "mount point to measure"
+    },
+    {
+      "name": "maxPercent",
+      "default": "90",
+      "description": "fail at or above this percentage"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Docker Compose Pull and Up",
+  "description": "Pull the latest images for a compose project and recreate its containers.",
+  "interpreter": "bash",
+  "script": "set -u\ncd \"$projectDir\" || { echo \"no such directory: $projectDir\"; exit 1; }\nif docker compose version >/dev/null 2>&1; then\n    dc=\"docker compose\"\nelif command -v docker-compose >/dev/null 2>&1; then\n    dc=\"docker-compose\"\nelse\n    echo \"docker compose is not installed\"\n    exit 1\nfi\n$dc pull || { echo \"pull failed\"; exit 1; }\n$dc up -d --remove-orphans || { echo \"up failed\"; exit 1; }\n$dc ps",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "projectDir",
+      "default": "",
+      "description": "directory holding docker-compose.yml"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+    "kind": "vantage.step/v1",
+    "name": "Download File (Linux)",
+    "description": "Download a file over HTTP to a local path",
+    "interpreter": "bash",
+    "script": "out=$(mktemp -p ./)\necho \"Downloading file from $url\"\nwget -q $url -O $out\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to download file from url\"\n    exit 1\nfi\necho \"FILE_PATH=$out\" \u003e\u003e $WORKFLOW_ENV",
+    "declared_outputs": ["FILE_PATH"],
+    "declared_inputs": [
+        {
+            "name": "url",
+            "default": "",
+            "description": ""
+        }
+    ],
+    "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Enable Linux Service",
+  "description": "Enable a systemd unit so it starts on boot.",
+  "interpreter": "bash",
+  "script": "set -u\necho \"enabling service $serviceName\"\nsystemctl enable \"$serviceName\" || { echo \"failed to enable $serviceName\"; exit 1; }\necho \"$serviceName enabled\"",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "serviceName",
+      "default": "",
+      "description": "systemd unit to enable"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,23 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Extract Archive",
+  "description": "Extract a tar, tar.gz, tar.bz2, tar.xz or zip archive into a directory.",
+  "interpreter": "bash",
+  "script": "set -u\ndest=\"${destination:-.}\"\nif [ ! -f \"$archive\" ]; then\n    echo \"archive $archive does not exist\"\n    exit 1\nfi\nmkdir -p \"$dest\"\ncase \"$archive\" in\n    *.tar.gz|*.tgz)   tar -xzf \"$archive\" -C \"$dest\" ;;\n    *.tar.bz2|*.tbz2) tar -xjf \"$archive\" -C \"$dest\" ;;\n    *.tar.xz|*.txz)   tar -xJf \"$archive\" -C \"$dest\" ;;\n    *.tar)            tar -xf  \"$archive\" -C \"$dest\" ;;\n    *.zip)\n        command -v unzip >/dev/null 2>&1 || { echo \"unzip is not installed\"; exit 1; }\n        unzip -oq \"$archive\" -d \"$dest\"\n        ;;\n    *)\n        echo \"unsupported archive type: $archive\"\n        exit 1\n        ;;\nesac\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to extract $archive\"\n    exit 1\nfi\necho \"extracted $archive into $dest\"\necho \"EXTRACT_DIR=$dest\" >> $WORKFLOW_ENV",
+  "declared_outputs": [
+    "EXTRACT_DIR"
+  ],
+  "declared_inputs": [
+    {
+      "name": "archive",
+      "default": "",
+      "description": "archive file to extract"
+    },
+    {
+      "name": "destination",
+      "default": ".",
+      "description": "directory to extract into"
+    }
+  ],
+  "secret_refs": []
+}
@@ -1,12 +1,10 @@
 {
-  "kind": "vantage.step/v1",
-  "name": "Get Host Name",
-  "description": "",
-  "interpreter": "bash",
-  "script": "HOSTNAME=$(hostname)\necho $HOSTNAME\necho \"HOSTNAME=$HOSTNAME\" \u003e\u003e $WORKFLOW_ENV",
-  "declared_outputs": [
-    "HOSTNAME"
-  ],
-  "declared_inputs": [],
-  "secret_refs": []
-}
+    "kind": "vantage.step/v1",
+    "name": "Get Host Name",
+    "description": "Gets the agents hostname",
+    "interpreter": "bash",
+    "script": "HOSTNAME=$(hostname)\necho $HOSTNAME\necho \"HOSTNAME=$HOSTNAME\" \u003e\u003e $WORKFLOW_ENV",
+    "declared_outputs": ["HOSTNAME"],
+    "declared_inputs": [],
+    "secret_refs": []
+}
@@ -0,0 +1,33 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "HTTP Health Check",
+  "description": "Request a URL and fail unless it answers with the expected status.",
+  "interpreter": "bash",
+  "script": "set -u\nexpected=\"${expectedStatus:-200}\"\nattempts=\"${retries:-3}\"\ndelay=\"${retryDelay:-5}\"\nstatus=\"\"\ni=1\n# Retries live in the script rather than in on_failure: a service coming up\n# after a restart wants a few seconds, not a whole step re-dispatched.\nwhile [ \"$i\" -le \"$attempts\" ]; do\n    status=$(curl -s -o /dev/null -w \"%{http_code}\" --max-time 10 \"$url\" || echo \"000\")\n    echo \"attempt $i: $url returned $status\"\n    if [ \"$status\" = \"$expected\" ]; then\n        break\n    fi\n    i=$(( i + 1 ))\n    if [ \"$i\" -le \"$attempts\" ]; then sleep \"$delay\"; fi\ndone\necho \"HTTP_STATUS=$status\" >> $WORKFLOW_ENV\nif [ \"$status\" != \"$expected\" ]; then\n    echo \"$url returned $status, expected $expected\"\n    exit 1\nfi\necho \"$url is healthy\"",
+  "declared_outputs": [
+    "HTTP_STATUS"
+  ],
+  "declared_inputs": [
+    {
+      "name": "url",
+      "default": "",
+      "description": "URL to request"
+    },
+    {
+      "name": "expectedStatus",
+      "default": "200",
+      "description": "HTTP status that counts as healthy"
+    },
+    {
+      "name": "retries",
+      "default": "3",
+      "description": "how many attempts before failing"
+    },
+    {
+      "name": "retryDelay",
+      "default": "5",
+      "description": "seconds between attempts"
+    }
+  ],
+  "secret_refs": []
+}
@@ -1,16 +1,16 @@
 {
-  "kind": "vantage.step/v1",
-  "name": "List Directory",
-  "description": "",
-  "interpreter": "bash",
-  "script": "if [ ! -e $path ]; then\n    echo \"file or directory doesn't exist: $path\"\n    exit 1\nfi\nls -l $path",
-  "declared_outputs": [],
-  "declared_inputs": [
-    {
-      "name": "path",
-      "default": "./",
-      "description": ""
-    }
-  ],
-  "secret_refs": []
-}
+    "kind": "vantage.step/v1",
+    "name": "List Directory",
+    "description": "Lists the files in the specified path",
+    "interpreter": "bash",
+    "script": "if [ ! -e $path ]; then\n    echo \"file or directory doesn't exist: $path\"\n    exit 1\nfi\nls -l $path",
+    "declared_outputs": [],
+    "declared_inputs": [
+        {
+            "name": "path",
+            "default": "./",
+            "description": ""
+        }
+    ],
+    "secret_refs": []
+}
@@ -0,0 +1,13 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Memory Usage Report",
+  "description": "Report memory usage as a percentage of total.",
+  "interpreter": "bash",
+  "script": "set -u\nfree -h\ntotal=$(free -m | awk \"/^Mem:/ {print \\$2}\")\nused=$(free -m | awk \"/^Mem:/ {print \\$3}\")\npct=$(( used * 100 / total ))\necho \"MEM_USED_PERCENT=$pct\" >> $WORKFLOW_ENV\necho \"MEM_USED_MB=$used\" >> $WORKFLOW_ENV\necho \"memory ${pct}% used (${used}MB of ${total}MB)\"",
+  "declared_outputs": [
+    "MEM_USED_PERCENT",
+    "MEM_USED_MB"
+  ],
+  "declared_inputs": [],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Reboot Server",
+  "description": "Schedule a reboot a minute out, so the step reports success before the machine goes down.",
+  "interpreter": "bash",
+  "script": "set -u\ndelay=\"${delayMinutes:-1}\"\n# Scheduled rather than immediate on purpose: `shutdown -r now` kills the\n# agent before it can report, and the run records a failure on a server\n# that did exactly what it was told.\necho \"rebooting in $delay minute(s)\"\nshutdown -r \"+$delay\" \"Reboot requested by Vantage\" || { echo \"failed to schedule a reboot\"; exit 1; }",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "delayMinutes",
+      "default": "1",
+      "description": "minutes to wait before rebooting"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Restart Linux Service",
+  "description": "Restart a systemd unit and fail if it does not come back up.",
+  "interpreter": "bash",
+  "script": "set -u\necho \"restarting service $serviceName\"\nsystemctl restart \"$serviceName\" || { echo \"failed to restart $serviceName\"; exit 1; }\nsystemctl is-active --quiet \"$serviceName\" || {\n    echo \"$serviceName did not come back up\"\n    systemctl status \"$serviceName\" --no-pager --lines=20 || true\n    exit 1\n}\necho \"$serviceName is active\"",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "serviceName",
+      "default": "",
+      "description": "systemd unit to restart, e.g. nginx"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,19 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Linux Service Status",
+  "description": "Report whether a systemd unit is active and enabled. Does not fail on a stopped unit.",
+  "interpreter": "bash",
+  "script": "set -u\nstate=$(systemctl is-active \"$serviceName\" 2>/dev/null || true)\nenabled=$(systemctl is-enabled \"$serviceName\" 2>/dev/null || true)\necho \"$serviceName: state=$state enabled=$enabled\"\necho \"SERVICE_STATE=$state\" >> $WORKFLOW_ENV\necho \"SERVICE_ENABLED=$enabled\" >> $WORKFLOW_ENV",
+  "declared_outputs": [
+    "SERVICE_STATE",
+    "SERVICE_ENABLED"
+  ],
+  "declared_inputs": [
+    {
+      "name": "serviceName",
+      "default": "",
+      "description": "systemd unit to inspect"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,31 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Set Permissions and Ownership",
+  "description": "Set the mode and optionally the owner of a path.",
+  "interpreter": "bash",
+  "script": "set -u\nif [ ! -e \"$path\" ]; then\n    echo \"$path does not exist\"\n    exit 1\nfi\nrecurse=\"\"\nif [ \"${recursive:-false}\" = \"true\" ]; then\n    recurse=\"-R\"\nfi\nif [ -n \"${mode:-}\" ]; then\n    chmod $recurse \"$mode\" \"$path\" || { echo \"failed to set mode\"; exit 1; }\n    echo \"set mode $mode on $path\"\nfi\nif [ -n \"${owner:-}\" ]; then\n    chown $recurse \"$owner\" \"$path\" || { echo \"failed to set owner\"; exit 1; }\n    echo \"set owner $owner on $path\"\nfi",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "path",
+      "default": "",
+      "description": "path to change"
+    },
+    {
+      "name": "mode",
+      "default": "",
+      "description": "octal mode, e.g. 0640"
+    },
+    {
+      "name": "owner",
+      "default": "",
+      "description": "owner, e.g. root:root"
+    },
+    {
+      "name": "recursive",
+      "default": "false",
+      "description": "true to apply recursively"
+    }
+  ],
+  "secret_refs": []
+}
@@ -1,7 +1,7 @@
 {
  "kind": "vantage.step/v1",
  "name": "Start Linux Service",
-  "description": "",
+  "description": "Start a linux systemd service",
  "interpreter": "bash",
  "script": "echo \"starting service $serviceName\"\nsystemctl start $serviceName\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to start service\"\n    exit 1\nfi",
  "declared_outputs": [],
@@ -1,16 +1,16 @@
 {
-  "kind": "vantage.step/v1",
-  "name": "Stop Linux Service",
-  "description": "",
-  "interpreter": "bash",
-  "script": "echo \"stopping service $serviceName\"\nsystemctl stop $serviceName\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to stop service\"\n    exit 1\nfi",
-  "declared_outputs": [],
-  "declared_inputs": [
-    {
-      "name": "serviceName",
-      "default": "",
-      "description": ""
-    }
-  ],
-  "secret_refs": []
-}
+    "kind": "vantage.step/v1",
+    "name": "Stop Linux Service",
+    "description": "Stops a linux systemd service",
+    "interpreter": "bash",
+    "script": "echo \"stopping service $serviceName\"\nsystemctl stop $serviceName\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to stop service\"\n    exit 1\nfi",
+    "declared_outputs": [],
+    "declared_inputs": [
+        {
+            "name": "serviceName",
+            "default": "",
+            "description": ""
+        }
+    ],
+    "secret_refs": []
+}
@@ -0,0 +1,21 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Tail Log File",
+  "description": "Print the last N lines of a file, for reading a log after a deployment step.",
+  "interpreter": "bash",
+  "script": "set -u\nlines=\"${lines:-50}\"\nif [ ! -f \"$path\" ]; then\n    echo \"$path does not exist\"\n    exit 1\nfi\necho \"last $lines lines of $path:\"\ntail -n \"$lines\" \"$path\"",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "path",
+      "default": "",
+      "description": "log file to read"
+    },
+    {
+      "name": "lines",
+      "default": "50",
+      "description": "how many lines to print"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,29 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "TLS Certificate Expiry",
+  "description": "Report days remaining on a TLS certificate and fail under a threshold.",
+  "interpreter": "bash",
+  "script": "set -u\nport=\"${port:-443}\"\nmin=\"${minDays:-14}\"\ncommand -v openssl >/dev/null 2>&1 || { echo \"openssl is not installed\"; exit 1; }\n# -servername sends SNI, without which a shared host returns the wrong\n# certificate and the expiry reported here belongs to someone else.\nend=$(echo | openssl s_client -servername \"$host\" -connect \"$host:$port\" 2>/dev/null \\\n    | openssl x509 -noout -enddate | cut -d= -f2)\nif [ -z \"$end\" ]; then\n    echo \"could not read a certificate from $host:$port\"\n    exit 1\nfi\nendEpoch=$(date -d \"$end\" +%s)\nnowEpoch=$(date +%s)\ndays=$(( (endEpoch - nowEpoch) / 86400 ))\necho \"CERT_DAYS_REMAINING=$days\" >> $WORKFLOW_ENV\necho \"CERT_EXPIRES=$end\" >> $WORKFLOW_ENV\necho \"$host:$port expires in $days days ($end)\"\nif [ \"$days\" -lt \"$min\" ]; then\n    echo \"fewer than $min days remaining\"\n    exit 1\nfi",
+  "declared_outputs": [
+    "CERT_DAYS_REMAINING",
+    "CERT_EXPIRES"
+  ],
+  "declared_inputs": [
+    {
+      "name": "host",
+      "default": "",
+      "description": "hostname to check"
+    },
+    {
+      "name": "port",
+      "default": "443",
+      "description": "TLS port"
+    },
+    {
+      "name": "minDays",
+      "default": "14",
+      "description": "fail below this many days remaining"
+    }
+  ],
+  "secret_refs": []
+}
@@ -1,18 +0,0 @@
-{
-  "kind": "vantage.step/v1",
-  "name": "WGET",
-  "description": "",
-  "interpreter": "bash",
-  "script": "out=$(mktemp -p ./)\necho \"Downloading file from $url\"\nwget -q $url -O $out\nretVal=$?\nif [ $retVal -ne 0 ]; then\n    echo \"failed to download file from url\"\n    exit 1\nfi\necho \"FILE_PATH=$out\" \u003e\u003e $WORKFLOW_ENV",
-  "declared_outputs": [
-    "FILE_PATH"
-  ],
-  "declared_inputs": [
-    {
-      "name": "url",
-      "default": "",
-      "description": ""
-    }
-  ],
-  "secret_refs": []
-}
@@ -0,0 +1,23 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Download File (Windows)",
+  "description": "Download a file over HTTP to a local path.",
+  "interpreter": "powershell",
+  "script": "$ErrorActionPreference = \"Stop\"\n$url  = $env:url\n$dest = if ($env:destination) { $env:destination } else { Join-Path $env:TEMP ([System.IO.Path]::GetFileName($url)) }\nWrite-Output \"downloading $url\"\ntry {\n    # -UseBasicParsing keeps this working on Server Core, where the IE\n    # engine Invoke-WebRequest otherwise reaches for is not installed.\n    Invoke-WebRequest -Uri $url -OutFile $dest -UseBasicParsing\n} catch {\n    Write-Output \"failed to download: $_\"\n    exit 1\n}\nWrite-Output \"saved to $dest\"\nAdd-Content -Path $env:WORKFLOW_ENV -Value \"FILE_PATH=$dest\"",
+  "declared_outputs": [
+    "FILE_PATH"
+  ],
+  "declared_inputs": [
+    {
+      "name": "url",
+      "default": "",
+      "description": "URL to download"
+    },
+    {
+      "name": "destination",
+      "default": "",
+      "description": "where to save it; defaults to a file in TEMP"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Reboot Windows Server",
+  "description": "Schedule a reboot a minute out, so the step reports success before the machine goes down.",
+  "interpreter": "powershell",
+  "script": "$ErrorActionPreference = \"Stop\"\n$delay = if ($env:delaySeconds) { [int]$env:delaySeconds } else { 60 }\nWrite-Output \"rebooting in $delay second(s)\"\n& shutdown.exe /r /t $delay /c \"Reboot requested by Vantage\"\nif ($LASTEXITCODE -ne 0) {\n    Write-Output \"failed to schedule a reboot\"\n    exit 1\n}",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "delaySeconds",
+      "default": "60",
+      "description": "seconds to wait before rebooting"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,16 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Restart Windows Service",
+  "description": "Restart a Windows service and fail if it does not come back up.",
+  "interpreter": "powershell",
+  "script": "$ErrorActionPreference = \"Stop\"\n$name = $env:serviceName\nWrite-Output \"restarting service $name\"\ntry {\n    Restart-Service -Name $name -Force\n} catch {\n    Write-Output \"failed to restart ${name}: $_\"\n    exit 1\n}\n$svc = Get-Service -Name $name\nif ($svc.Status -ne \"Running\") {\n    Write-Output \"$name is $($svc.Status), not Running\"\n    exit 1\n}\nWrite-Output \"$name is running\"",
+  "declared_outputs": [],
+  "declared_inputs": [
+    {
+      "name": "serviceName",
+      "default": "",
+      "description": "Windows service name to restart"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,24 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Windows Disk Report",
+  "description": "Report free space on a drive and fail past a usage threshold.",
+  "interpreter": "powershell",
+  "script": "$ErrorActionPreference = \"Stop\"\n$letter = if ($env:driveLetter) { $env:driveLetter } else { \"C\" }\n$limit  = if ($env:maxPercent)  { [int]$env:maxPercent } else { 90 }\n$d = Get-PSDrive -Name $letter -ErrorAction SilentlyContinue\nif ($null -eq $d) {\n    Write-Output \"drive $letter not found\"\n    exit 1\n}\n$total  = $d.Used + $d.Free\n$pct    = [math]::Round(($d.Used / $total) * 100)\n$freeGb = [math]::Round($d.Free / 1GB, 1)\nWrite-Output \"${letter}: is $pct% full, $freeGb GB free\"\nAdd-Content -Path $env:WORKFLOW_ENV -Value \"DISK_USED_PERCENT=$pct\"\nAdd-Content -Path $env:WORKFLOW_ENV -Value \"DISK_FREE_GB=$freeGb\"\nif ($pct -ge $limit) {\n    Write-Output \"at or over the $limit% limit\"\n    exit 1\n}",
+  "declared_outputs": [
+    "DISK_USED_PERCENT",
+    "DISK_FREE_GB"
+  ],
+  "declared_inputs": [
+    {
+      "name": "driveLetter",
+      "default": "C",
+      "description": "drive letter, without a colon"
+    },
+    {
+      "name": "maxPercent",
+      "default": "90",
+      "description": "fail at or above this percentage"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,19 @@
+{
+  "kind": "vantage.step/v1",
+  "name": "Windows Service Status",
+  "description": "Report a Windows service's status and start type. Does not fail on a stopped service.",
+  "interpreter": "powershell",
+  "script": "$ErrorActionPreference = \"Stop\"\n$name = $env:serviceName\n$svc = Get-Service -Name $name -ErrorAction SilentlyContinue\nif ($null -eq $svc) {\n    Write-Output \"$name is not installed\"\n    Add-Content -Path $env:WORKFLOW_ENV -Value \"SERVICE_STATE=missing\"\n    Add-Content -Path $env:WORKFLOW_ENV -Value \"SERVICE_START_TYPE=none\"\n    exit 0\n}\nWrite-Output \"${name}: $($svc.Status), start type $($svc.StartType)\"\nAdd-Content -Path $env:WORKFLOW_ENV -Value \"SERVICE_STATE=$($svc.Status)\"\nAdd-Content -Path $env:WORKFLOW_ENV -Value \"SERVICE_START_TYPE=$($svc.StartType)\"",
+  "declared_outputs": [
+    "SERVICE_STATE",
+    "SERVICE_START_TYPE"
+  ],
+  "declared_inputs": [
+    {
+      "name": "serviceName",
+      "default": "",
+      "description": "Windows service name to inspect"
+    }
+  ],
+  "secret_refs": []
+}
@@ -0,0 +1,538 @@
+# Package inventory and CVE findings
+
+Date: 2026-08-06
+
+Agents report the packages installed on each server. The control plane matches
+them against distro security feeds and raises findings that link straight to
+the patching path that already exists. A finding nobody can fix today can be
+accepted with a reason and an expiry date rather than sitting red forever.
+
+This is one of four sub-projects sketched together and deliberately separated:
+
+| # | Sub-project | Depends on |
+| - | ----------- | ---------- |
+| A | **Package inventory + CVE findings** — this spec | nothing |
+| B | Container/service registry | nothing |
+| C | Container image scanning | A and B |
+| D | Compliance profiles (baseline assertions) | shares A's findings UI only |
+
+A and B are independent of one another. C is the joiner and must not be
+designed before both exist. D shares a page with A and nothing else — a
+different collector, a different evaluation model and a different remediation
+story — so folding it in here would double the size for no shared machinery.
+
+Scope of this spec is **A, Linux only.** Windows needs a separate source
+(MSRC CVRF), a separate collector (`Get-HotFix` plus registry) and a KB
+supersedence matcher that shares no code with the Linux path. That matches the
+existing position that Windows agents are second-class by design, and the six
+package managers `updates.go` already detects cover the whole Linux surface.
+
+---
+
+## The trap this design is built around
+
+Distributions **backport** security fixes without changing the upstream
+version. Ubuntu ships `openssl 3.0.2-0ubuntu1.15` patched against
+CVE-2023-0286; NVD says version 3.0.2 is vulnerable. Matching installed
+versions against NVD or CPE ranges therefore reports a fleet full of criticals
+that are all already fixed.
+
+That is not merely noisy. It is fatal to the feature: once the first report is
+mostly wrong, nobody reads the second one, and a genuine finding is lost in the
+noise it created. Everything below follows from refusing to make that mistake.
+
+The correct source is the **distribution's own security feed**, keyed on the
+distribution's own version string — Debian and Ubuntu OVAL/USN, Red Hat OVAL
+v2, Alpine secdb. `trivy-db` is those feeds pre-merged into one BoltDB
+artifact, rebuilt every six hours and published as an OCI artifact.
+
+---
+
+## Where the vulnerability data comes from
+
+`trivy-db`, pulled server-side from `ghcr.io/aquasecurity/trivy-db:2`.
+
+The alternative considered was querying OSV.dev per scan, which needs no
+storage and no puller. It was rejected on two counts: it requires outbound
+internet on every scan, which breaks air-gapped installs; and it sends the
+package list of a customer's entire fleet to a third party. The audience most
+likely to buy vulnerability scanning is the audience least willing to do that.
+
+The blob is roughly 50MB, read-only, reproducible, and identified by a version
+number. **It is not stored in Mongo and not written to `/data`** —
+`server.persistence` defaults to off and nothing writes to `/data` any more.
+It does not need durable storage: whichever pod needs it pulls it to its own
+ephemeral temp directory. Nothing shared, nothing to back up, nothing to
+migrate.
+
+`VANTAGE_TRIVY_DB_REF` overrides the default reference so a customer can mirror
+the artifact into their own registry. It also covers the anonymous ghcr rate
+limit, which the six-hourly pull cadence already makes unlikely to bite.
+
+---
+
+## Only the leader matches
+
+This is the crux, and it falls out of the replica model already in the
+codebase.
+
+Two things trigger matching, and they happen on different pods:
+
+1. a fleet-wide rescan when `trivy-db` updates — naturally the leader's job
+2. a server's package list changing — handled by whichever pod holds *that
+   agent's* command stream
+
+If (2) matched inline, **every replica would need the 50MB database resident**,
+and a database refresh would have N pods racing to rescan the same fleet and N
+digests reaching the customer. That is the exact failure `RunAsLeader` exists
+to prevent, and it is the same argument that put `monitorsched` behind the
+lock.
+
+So `ReportPackages` does not match. It upserts the package list and sets
+`scan_pending: true`. That is all it does.
+
+`server/internal/vulnsched` then runs inside the **existing**
+`bus.RunAsLeader("housekeeping", …)` alongside `monitorsched`,
+`workflowsched` and the sweepers — one role, one lock. Every 60 seconds it:
+
+1. pulls `trivy-db` if the local copy is older than six hours
+2. if the pulled version differs from `vulndb_meta.db_version`, marks **every**
+   server `scan_pending`
+3. matches all `scan_pending` servers, clears the flag, diffs against existing
+   findings
+4. emits **one** digest per tick covering everything newly opened
+
+Step 4 is why batching is structural rather than bolted on. A `trivy-db`
+refresh can open several hundred findings across a fleet at once; one message
+per finding would rate-limit the webhook or get the channel muted, and either
+way the customer stops receiving the alerts they are paying for. The tick is
+already the natural batch boundary, so **the failure cannot occur by
+construction** rather than by a debounce someone has to maintain.
+
+`scan_pending` lives on the document rather than in memory, for the same reason
+`next_run_at` and `workflow_log_seq` do: a leader handover between marking and
+scanning would otherwise lose it. A handover costs the new leader one re-pull
+of the database.
+
+The cost of this indirection is up to 60 seconds between an agent reporting a
+changed package set and its findings updating. For vulnerability data that is
+nothing, and it buys a single matching path instead of two.
+
+---
+
+## Components
+
+```
+agent/internal/packages/        collect installed packages + /etc/os-release
+proto/                          ReportPackages RPC
+server/internal/vulndb/         puller, BoltDB access, matcher
+server/internal/vulnsched/      leader-owned tick: pull, scan, digest
+server/internal/services/       findings, acceptance, alert rules
+web/app/(app)/vulnerabilities/  fleet board; plus two server-detail tabs
+```
+
+`vulnsched` takes the dependencies it needs — `LogEvent` and the notification
+dispatch — as a `vulnsched.Deps` injected from `main.go`, following
+`workflowsched`. The manual rescan endpoint does not call into `vulnsched` at
+all: it sets `scan_pending` on every server and lets the next tick find them,
+so there is no path by which `services` imports the scheduler and no cycle to
+avoid later.
+
+---
+
+## The wire path
+
+A new `ReportPackages` RPC on the agent's existing hourly loop — the same
+`runUpdateCheck` cadence, reusing `updates.go`'s `detectPM()`.
+
+```protobuf
+rpc ReportPackages(ReportPackagesRequest) returns (ReportPackagesResponse);
+
+message ReportPackagesRequest {
+  string server_id     = 1;
+  string agent_token   = 2;
+  string hash          = 3;  // sha256 of the sorted list
+  OSRelease os         = 4;
+  repeated InstalledPackage packages = 5;  // omitted when only offering a hash
+}
+
+message ReportPackagesResponse {
+  bool need_full = 1;  // hash differs; resend with packages populated
+}
+```
+
+The agent calls once with `packages` empty. `need_full` true means the hash
+differs from what the server holds, and the agent immediately calls again with
+the list populated.
+
+The agent sends a SHA-256 of its sorted package list first. If it matches what
+the server already holds, the server answers `unchanged` and the ~150KB body is
+never sent. A machine's package set changes rarely, so almost every hour costs
+one small message, and the rare changed hour costs one extra round trip.
+
+Folding the list into the existing 15-minute `InventoryReport` static snapshot
+was rejected: it would re-send ~150KB per server every 15 minutes regardless of
+change, roughly 40MB/hour of gRPC traffic on a 100-server fleet to transmit
+data that is almost always identical.
+
+---
+
+## Data model
+
+Four new collections. Every one carries `instance_id` except `vulndb_meta`,
+which is explained below.
+
+### `server_packages` — one document per server, not per package
+
+```go
+type ServerPackages struct {
+    ID          primitive.ObjectID `bson:"_id"`
+    InstanceID  primitive.ObjectID `bson:"instance_id"`
+    ServerID    string             `bson:"server_id"`
+    OS          OSRelease          `bson:"os"`          // family, version_id, arch
+    Hash        string             `bson:"hash"`        // sha256 of the sorted list
+    Packages    []InstalledPackage `bson:"packages"`
+    CollectedAt time.Time          `bson:"collected_at"`
+    ScanPending bool               `bson:"scan_pending"`
+    ScannedAt   time.Time          `bson:"scanned_at"`
+    Status      string             `bson:"status"`      // ok | unsupported
+    DBVersion   int                `bson:"db_version"`  // last matched against
+}
+
+type InstalledPackage struct {
+    Name       string `bson:"name"`
+    Version    string `bson:"version"`     // distro version string, verbatim
+    Epoch      int    `bson:"epoch,omitempty"`
+    Arch       string `bson:"arch"`
+    SourceName string `bson:"source_name,omitempty"`
+}
+```
+
+One document rather than two thousand is what makes a report a **single atomic
+upsert with no delta logic** — the hash already established that something
+changed, so there is nothing to reconcile field by field. A typical Linux host
+lands near 150KB, comfortably inside the 16MB document limit.
+
+Indexes: `{instance_id, server_id}` unique, and a multikey
+`{instance_id, "packages.name"}` for fleet-wide package search.
+
+`SourceName` is not decoration. **Debian and Ubuntu advisories are keyed on the
+source package**: a CVE against `openssl` covers the binaries `libssl3`,
+`openssl` and `libssl-dev`, so matching on binary name alone misses two of the
+three.
+
+`OS.VersionID` selects the feed. Ubuntu 22.04 and 24.04 publish different fixed
+versions for the same CVE, so a scan without it is guesswork.
+
+### `vuln_findings` — one document per (server, CVE, package)
+
+```go
+type VulnFinding struct {
+    ID         primitive.ObjectID `bson:"_id"`
+    InstanceID primitive.ObjectID `bson:"instance_id"`
+    ServerID   string             `bson:"server_id"`
+
+    CVEID       string   `bson:"cve_id"`
+    PackageName string   `bson:"package_name"`
+    Installed   string   `bson:"installed_version"`
+    FixedIn     string   `bson:"fixed_in,omitempty"`
+    Severity    string   `bson:"severity"`
+    CVSSScore   float64  `bson:"cvss_score,omitempty"`
+    Title       string   `bson:"title,omitempty"`
+    References  []string `bson:"references,omitempty"`
+
+    State     string      `bson:"state"` // open | fixed | accepted
+    FirstSeen time.Time   `bson:"first_seen"`
+    LastSeen  time.Time   `bson:"last_seen"`
+    FixedAt   *time.Time  `bson:"fixed_at,omitempty"`
+    Accepted  *Acceptance `bson:"accepted,omitempty"`
+}
+
+type Acceptance struct {
+    By     primitive.ObjectID `bson:"by"`
+    Reason string             `bson:"reason"`
+    Until  time.Time          `bson:"until"`
+    At     time.Time          `bson:"at"`
+}
+```
+
+Unique on `{instance_id, server_id, cve_id, package_name}`. That key is what
+makes a rescan an idempotent upsert rather than a duplicate factory, and it is
+what lets `first_seen` survive across scans. Query index
+`{instance_id, state, severity}`.
+
+**An empty `FixedIn` is a real and common state** and must never be conflated
+with "not vulnerable". A CVE with no vendor fix published yet is exactly the
+finding people most need to see, and also the one that most needs acceptance,
+because there is nothing to patch.
+
+Findings are **not deleted when a package is patched**. State moves to `fixed`
+with `fixed_at` set, so "what did we remediate last quarter" remains
+answerable — which is the question an auditor asks.
+
+### `vulndb_meta` — singleton, deliberately unscoped
+
+`db_version`, `pulled_at`, `last_full_scan_at`, `last_error`. It carries no
+`instance_id` because the vulnerability database is a property of the
+deployment, not of a tenant. Same reasoning as `migrations`.
+
+### `vuln_alert_rules`
+
+`instance_id`, `name`, `enabled`, `min_severity`, `tags map[string]string`,
+`channel_ids []`, timestamps.
+
+The tag filter resolves through **`services.ResolveTargets`**, not a second
+matcher. That function is already the single answer to which servers a
+selector touches, and an alert rule that disagreed with a workflow about what
+`env:prod` means would be worse than having no filter at all.
+
+---
+
+## The matching engine
+
+```
+server/internal/vulndb/
+  pull.go      OCI fetch → temp dir, version compare against vulndb_meta
+  db.go        BoltDB open, advisory lookup by (ecosystem, source, version)
+  match.go     per-family matching, severity resolution
+  version.go   dispatch to deb/rpm/apk comparator by OS family
+```
+
+Dependencies: `github.com/aquasecurity/trivy-db` for the BoltDB schema, plus
+`go-deb-version`, `go-rpm-version` and `go-apk-version` — each a small
+standalone module doing one job. The roughly 200 lines of per-distro advisory
+lookup are ours.
+
+Importing `trivy` itself was rejected: it would pull a very large transitive
+dependency tree into the server binary for one feature, and its Go API carries
+no stability guarantee across minor versions. Shelling out to the `trivy`
+binary against a generated SBOM was rejected for shipping a second binary in
+the image and turning a library call into subprocess lifecycle, timeouts and
+output-format drift.
+
+### Why the comparators are bought rather than written
+
+Version ordering is where this feature lives or dies, and its failure mode is
+silent. `dpkg` ordering has epochs, and `~` sorts *before* the empty string, so
+`3.0.2-0ubuntu1.15~rc1` precedes `3.0.2-0ubuntu1.15`. `rpmvercmp` has its own
+segment rules and treats `~` and `^` differently again. A `strings.Compare` or
+a semver parse orders `1.9` above `1.10` and reports a vulnerable fleet as
+clean — a false negative, which nobody notices until it matters.
+
+### Scanning one server
+
+1. Load `server_packages`; resolve OS family and version to a `trivy-db`
+   ecosystem.
+2. **Unsupported ecosystem → record `status: unsupported`, clear the flag,
+   write no findings.**
+3. For each package: resolve source name, look up advisories, compare versions.
+4. Upsert vulnerable results as `open`, preserving `first_seen`.
+5. Any currently-`open` finding absent from this result set → `fixed`, stamp
+   `fixed_at`.
+6. Any `accepted` finding past its `until` → back to `open`.
+7. Clear `scan_pending`, stamp `scanned_at` and `db_version`.
+
+Steps 5 and 6 must run in that order, so a finding that is both absent and
+expired settles as `fixed` rather than reopening on a package that no longer
+carries it.
+
+Step 2 matters as much as any of the matching. Arch has no feed in `trivy-db`,
+so an Arch host must report **unsupported**, never "0 findings". Reporting
+clean when the truth is unknown is the same class of lie as a silently stale
+database, and it is the reason `vulndb_meta.pulled_at` appears on screen rather
+than only in a log.
+
+### Severity
+
+Resolved **vendor → NVD → unknown**, in that order, never invented.
+
+This will surface as "why is this critical CVE marked low", and the answer is
+that Debian and Red Hat routinely downgrade an NVD score because the vulnerable
+code path is not reachable in their build. Their rating is the accurate one for
+that package, and showing NVD's above it would manufacture work that does not
+need doing.
+
+---
+
+## Findings lifecycle
+
+`open | fixed | accepted`.
+
+An accepted finding is suppressed from counts and alerts until its `until`
+date, then reopens automatically. A reason is required.
+
+Acceptance with a mandatory expiry, rather than permanent dismissal, is what
+keeps the feature usable in both directions. Without any acceptance mechanism,
+a kernel CVE awaiting a reboot window sits red indefinitely and trains people
+to ignore the page. With permanent dismissal, accepted findings accumulate
+silently and nobody revisits them — the dismissal list becomes where risk goes
+to be forgotten, which is precisely what an auditor asks to see.
+
+Retention: `settings.vuln_finding_retention_days`, a `*int` on the same pattern
+as `workflow_log_retention_days` — nil means 90 days, 0 means forever. Only
+`fixed` findings are swept, by a `StartVulnSweeper` inside the same
+`RunAsLeader("housekeeping", …)` as the existing sweepers. `open` and
+`accepted` findings are never swept at any setting.
+
+---
+
+## Alerting
+
+Per-org rules over the existing `notification_channels`: severity threshold,
+optional tag filter, target channels.
+
+A rescan emits one message summarising what newly opened — "12 new critical
+across 4 servers" — never one message per finding. See the leader section for
+why the tick boundary makes this structural.
+
+Modelling findings as a monitor type was rejected. It would reuse monitors'
+state machine and channel wiring for free, but monitors are up/down for one
+endpoint with retries and hourly rollups, none of which means anything for a
+CVE; most fields would be disabled in the UI and the uptime graphs would be
+polluted with a signal that is not uptime.
+
+This adds one `notify` payload type and a `vuln_digest.html.tmpl` /
+`vuln_digest.txt.tmpl` pair in `shared/mail`. Note that `shared/mail` templates
+are parsed in `init()`, so a mistyped field is a boot-time panic — CLAUDE.md
+describes a `render_test.go` guarding against exactly this, but **that file does
+not exist**; the repository has no Go tests at all, and by instruction this
+feature adds none. The template pair must therefore be verified by starting the
+binary and sending one digest through a real channel.
+
+---
+
+## Entitlement
+
+The feature name is `vuln_scanning`, and it crosses the two services the way
+every other feature does:
+
+- **admin** carries it as a per-instance entitlement toggle, so it can later be
+  priced as a catalogue `feature` component without a second migration;
+- **the licence** snapshots it into `License.Features []string` at issue time;
+- **the server** asks `lic.HasFeature("vuln_scanning")` and never switches on
+  tier, so changing what a tier includes needs no server release.
+
+Off on Free.
+
+**The gate is checked at `ReportPackages`, not at display.** Gating only the UI
+would still pay every write cost, and storage is the expensive half.
+
+The agent learns of it through the existing 30-second `SyncKeys` poll:
+`SyncResponse` gains a `collect_packages` bool, and the hourly loop skips
+collection entirely when it is false. So an ungated instance produces no
+collection, no gRPC body, no document and no storage. `ReportPackages` still
+re-checks the entitlement server-side and refuses — the agent flag is an
+optimisation, the server check is the boundary.
+
+Turning the feature off does not delete existing findings; they stop being
+served and stop updating. Deletion is the instance-deletion path's job.
+
+---
+
+## REST API
+
+```
+GET    /api/vulnerabilities              # filter: severity, state, server, tags
+GET    /api/vulnerabilities/summary      # severity counts + database freshness
+POST   /api/vulnerabilities/rescan       # marks all scan_pending  (owner|admin)
+POST   /api/vulnerabilities/:id/accept   # reason + until          (owner|admin)
+DELETE /api/vulnerabilities/:id/accept   #                         (owner|admin)
+GET    /api/servers/:id/vulnerabilities
+GET    /api/servers/:id/packages
+GET    /api/packages/search?name=        # fleet-wide
+GET,POST /api/vuln-rules · PUT,DELETE /api/vuln-rules/:id
+```
+
+Every mutating path writes an audit event, as all of them do. Acceptance is the
+one decision people will be asked to justify, so `by`, `reason`, `until` and
+`at` land in the audit record and not only on the document.
+
+---
+
+## UI
+
+`/vulnerabilities` is a fleet board **grouped by CVE** — one row per CVE with
+an affected-server count, expandable to the individual servers. The same CVE
+across 40 servers is one decision, and a flat list of findings makes it look
+like forty.
+
+Server detail gains **Vulnerabilities** and **Packages** tabs. Alert rules go
+on `/settings/notifications`, beside the channels they consume.
+
+Remediation introduces no new mechanism: a finding carrying `fixed_in` renders
+an **Apply updates** action calling the existing
+`POST /api/servers/:id/apply-updates`, which is already `ApplyUpdatesCmd`. See
+it, patch it, one place — and no second patching path to keep consistent with
+the first.
+
+Database freshness is shown wherever findings are, not tucked into settings. A
+fleet scanning against a three-week-old database must say so rather than
+quietly report all-clear.
+
+---
+
+## Verification
+
+**No automated tests.** The repository has none today, and by explicit
+instruction this feature adds none — no `*_test.go`, no frontend test files.
+That is a deliberate decision by the repository owner, recorded here so the
+absence reads as a choice rather than an omission.
+
+It does change the risk profile, and the places it changes it are worth naming,
+because each fails by producing a **wrong answer rather than a crash**:
+
+- **Version comparison.** The backport case — installed `1:3.0.2-0ubuntu1.15`
+  against advisory fixed-in `1:3.0.2-0ubuntu1.15` resolving to *not
+  vulnerable* — plus tilde ordering (`1.0~rc1` < `1.0`), epoch dominance
+  (`1:1.0` > `2.0`) and `1.9` < `1.10`. Wrong here means a vulnerable fleet
+  reported clean.
+- **Source-package fan-out.** One advisory against `openssl` must flag
+  `libssl3`, `openssl` and `libssl-dev`. Matching on binary name alone silently
+  finds one of three.
+- **`first_seen` preservation.** An upsert that overwrites it makes every
+  finding look discovered today, and nothing surfaces that until someone reads
+  a report.
+- **Fixed-before-reopen ordering.** A finding both absent from a scan and past
+  its acceptance expiry must settle `fixed`, not reopen.
+
+The implementation plan carries a manual verification table for each, to be
+walked before the relevant task is committed. They are the substitute for the
+tests, not a formality.
+
+---
+
+## Failure modes
+
+| Failure | Behaviour |
+| ------- | --------- |
+| Database pull fails | Keep the last good copy and serve stale. Record `last_error`, surface `pulled_at` age. **Never clear findings** — a network blip must not read as "all fixed" |
+| Unsupported distribution | `status: unsupported`, not zero findings |
+| Agent stops reporting | Findings persist and `collected_at` age is shown. No auto-expiry: a silent agent is not a patched server |
+| `trivy-db` schema version bumps | The puller refuses an unknown schema rather than mis-parsing it |
+| ghcr anonymous rate limit | Backoff; `VANTAGE_TRIVY_DB_REF` mirrors to a private registry |
+| Leadership lost mid-scan | The context is cancelled and the scan returns; `scan_pending` is still set, so the next leader picks it up |
+| Instance deleted | **`server_packages` and `vuln_findings` must be added to the control plane's instance-deletion collection list.** Easy to miss, and missing it orphans a tenant's package data indefinitely |
+
+---
+
+## Environment variables
+
+| Name | Required | Notes |
+| ---- | -------- | ----- |
+| `VANTAGE_TRIVY_DB_REF` | no | default `ghcr.io/aquasecurity/trivy-db:2`. Point at a mirror for air-gapped installs or to avoid the anonymous ghcr rate limit |
+| `VANTAGE_VULNDB_DISABLED` | no | disables the puller and the scheduler entirely. Findings already written are still served and still marked stale |
+
+---
+
+## Deliberately out of scope
+
+- **Windows.** Separate source, collector and matcher; its own spec.
+- **Container image scanning.** Sub-project C; needs the container registry.
+- **Compliance baseline assertions.** Sub-project D; shares this findings UI
+  and nothing else.
+- **Language-level dependency scanning** (npm, pip, Go modules). `trivy-db`
+  covers these ecosystems, but finding the manifests on a host is a different
+  collection problem from asking the package manager what is installed.
+- **Automatic patching on a finding.** Remediation is one click, not zero. An
+  unattended upgrade triggered by a CVE feed is a fleet-wide change driven by a
+  third party's data, which is not a decision to take away from an operator.
@@ -0,0 +1,441 @@
+# Workload registry
+
+Date: 2026-08-06
+
+Agents enumerate what each server actually runs — Docker containers, the
+compose stacks grouping them, and systemd services — and report it to the
+control plane. Containers and units can be started, stopped and restarted from
+the UI, and a bounded snapshot of their logs can be read without opening a
+console.
+
+This is **sub-project B** of the four sketched in
+`2026-08-06-package-inventory-and-cve-findings-design.md`:
+
+| # | Sub-project | Depends on |
+| - | ----------- | ---------- |
+| A | Package inventory + CVE findings — its own spec | nothing |
+| B | **Workload registry** — this spec | nothing |
+| C | Container image scanning | A and B |
+| D | Compliance profiles | shares A's findings UI only |
+
+A and B are independent. C is the joiner and must not be designed before both
+exist: it needs B's image list and A's findings model.
+
+**Workload** is the domain word throughout: one container or one systemd unit.
+It gives the collection, the commands and the page a single honest name rather
+than saying "container or service" in every identifier.
+
+Scope is **Linux only**, matching sub-project A and the existing position that
+Windows agents are second-class by design. Docker runs on Windows; systemd does
+not, and half a feature per platform is worse than a clear line.
+
+---
+
+## What this is for
+
+The control plane can manage a fleet's keys, run workflows across it and watch
+its endpoints, but it has no idea what any of those servers actually *runs*.
+"Restart nginx on that box" means opening a console. "Which of these 80 servers
+is still on the old image" is unanswerable.
+
+---
+
+## Reporting and refresh are one path
+
+The agent reports on its own 60-second ticker through a `ReportWorkloads` RPC,
+using the same hash short-circuit as the package report: it offers a SHA-256 of
+the sorted workload list, and sends the body only when the server does not
+already hold that hash. An unchanged list costs one small message, which on a
+60-second cadence is the common case by a wide margin.
+
+The on-demand refresh **does not return data**. `RefreshWorkloadsCmd` carries
+no payload back; it makes the agent report immediately through the normal RPC,
+and the UI refetches the stored document.
+
+That is deliberate. A refresh that returned workloads inline would be a second
+writer for the same collection, arriving by a different route, with its own
+serialisation and its own opportunity to disagree with the periodic one. One
+writer, one shape; the refresh is a nudge, not a channel.
+
+Opening a server's Workloads tab dispatches a refresh, so what is on screen is
+live rather than up to a minute stale. That matters because the page has a
+Restart button on it: a stale list is not merely a wrong impression, it is a
+wrong action aimed at a container that already died.
+
+## What does answer back
+
+Two operations genuinely return something:
+
+| Command | Answers with |
+| ------- | ------------ |
+| `ControlWorkloadCmd{kind, id, action}` | the existing `CommandResult` — ok or error |
+| `WorkloadLogsCmd{kind, id, tail}` | a new `WorkloadLogsResult{command_id, text, truncated}` |
+
+Both ride the proven path: `commandDispatcher.send()` for request and ack, and
+a `WorkloadResults` registry mirroring `StepResults.Await`/`Deliver` over the
+bus. **`Await` must subscribe before the command is dispatched** — the pod
+driving the request is usually not the pod holding the agent's stream, and a
+fast agent otherwise answers into a channel nobody has joined. This is not a
+new hazard; it is the one `stepresults.go` already documents.
+
+```protobuf
+rpc ReportWorkloads(ReportWorkloadsRequest) returns (ReportWorkloadsResponse);
+
+message ReportWorkloadsRequest {
+  string server_id     = 1;
+  string agent_token   = 2;
+  string hash          = 3;
+  bool   docker_ok     = 4;
+  string docker_error  = 5;
+  bool   systemd_ok    = 6;
+  string systemd_error = 7;
+  repeated Workload workloads = 8;  // empty on the offer call
+}
+
+message ReportWorkloadsResponse {
+  bool need_full = 1;
+}
+
+// ServerCommand gains three variants.
+message RefreshWorkloadsCmd {}
+
+message ControlWorkloadCmd {
+  string kind   = 1;  // "container" | "unit"
+  string id     = 2;
+  string action = 3;  // "start" | "stop" | "restart"
+}
+
+message WorkloadLogsCmd {
+  string kind = 1;
+  string id   = 2;
+  int32  tail = 3;
+}
+
+// AgentMessage gains one variant.
+message WorkloadLogsResult {
+  string command_id = 1;
+  string text       = 2;
+  bool   truncated  = 3;
+  string error      = 4;
+}
+```
+
+The offer-then-send handshake is the package report's, unchanged: the agent
+calls once with `workloads` empty, and resends with the body only if the
+response sets `need_full`.
+
+An agent whose stream no pod holds gets a 503 from the dispatcher, as
+everything else does. Commands are not queued: a command whose owner died must
+fail loudly rather than be delivered to nobody while the operator is told it
+worked.
+
+---
+
+## Not gated by licence
+
+Unlike CVE scanning, this reads as core fleet management rather than a premium
+add-on, so v1 ships to every instance with no entitlement check.
+
+If that changes it is a one-line `HasFeature` check at `ReportWorkloads`,
+gating collection rather than display — the same placement and the same
+reasoning as sub-project A, where gating the UI alone would still pay every
+write cost.
+
+---
+
+## Data model
+
+One new collection, `server_workloads`, one document per server, mirroring
+`server_packages`.
+
+```go
+type ServerWorkloads struct {
+    ID          bson.ObjectID `bson:"_id,omitempty" json:"-"`
+    InstanceID  string        `bson:"instance_id" json:"-"`
+    ServerID    string        `bson:"server_id" json:"server_id"`
+    Hash        string        `bson:"hash" json:"hash"`
+    Workloads   []Workload    `bson:"workloads" json:"workloads"`
+    CollectedAt time.Time     `bson:"collected_at" json:"collected_at"`
+
+    DockerOK     bool   `bson:"docker_ok" json:"docker_ok"`
+    DockerError  string `bson:"docker_error,omitempty" json:"docker_error,omitempty"`
+    SystemdOK    bool   `bson:"systemd_ok" json:"systemd_ok"`
+    SystemdError string `bson:"systemd_error,omitempty" json:"systemd_error,omitempty"`
+}
+
+type Workload struct {
+    Kind      string    `bson:"kind" json:"kind"`           // "container" | "unit"
+    ID        string    `bson:"id" json:"id"`               // container id, or unit name
+    Name      string    `bson:"name" json:"name"`
+    State     string    `bson:"state" json:"state"`
+    Health    string    `bson:"health,omitempty" json:"health,omitempty"`
+    Image     string    `bson:"image,omitempty" json:"image,omitempty"`
+    Stack     string    `bson:"stack,omitempty" json:"stack,omitempty"`
+    Ports     []string  `bson:"ports,omitempty" json:"ports,omitempty"`
+    Restarts  int       `bson:"restarts,omitempty" json:"restarts,omitempty"`
+    StartedAt time.Time `bson:"started_at,omitempty" json:"started_at,omitempty"`
+    Protected bool      `bson:"protected" json:"protected"`
+}
+```
+
+`State` is normalised across the two kinds: containers report `running`,
+`exited`, `paused`, `restarting`, `created`; units report `active`, `inactive`,
+`failed`, `activating`. They are deliberately **not** collapsed into a shared
+vocabulary — a failed unit and an exited container mean different things, and
+flattening them would lose the distinction the operator needs.
+
+Indexes: `{instance_id, server_id}` unique, plus multikey
+`{instance_id, "workloads.image"}` for the fleet-wide "which servers run image
+X" query.
+
+### Why the OK/Error pairs exist
+
+A host with no Docker installed and a host where Docker is installed and
+running nothing both produce an empty list. One should read "not in use here",
+the other "nothing running", and only the second deserves any alarm.
+
+The error strings separate a third case the booleans alone cannot: Docker
+installed with the daemon down. "Not installed" and "installed but not
+responding" are different problems with different fixes, and collapsing them
+into one false boolean throws away the only thing that tells them apart.
+
+### Why `Protected` is reported rather than derived
+
+The agent already knows which unit and container it is. Sending that up lets
+the UI render the action disabled with a reason instead of offering a button
+whose refusal is already known.
+
+The field is the courtesy; the agent's own check is the boundary. See the
+control section.
+
+### No history
+
+A workload list is state, not a record. Nobody asks what containers ran last
+Tuesday, and keeping it would grow a collection per server per minute in
+exchange for a question nobody has.
+
+---
+
+## Collectors
+
+### Docker: two commands, no English parsing
+
+```
+docker ps -aq
+docker inspect --format '{{json .}}' <ids…>
+```
+
+Not `docker ps --format '{{json .}}'` alone. That reports health and uptime
+inside a human `Status` string — `"Up 2 hours (healthy)"` — and anything built
+on it is parsing English that is localised, reworded between releases, and
+silently different for a paused or restarting container. `inspect` returns
+`State.Health.Status`, `State.StartedAt` and `RestartCount` as typed fields.
+Two execs instead of one, and no parser to be wrong.
+
+`RestartCount` justifies the second call by itself: a container cycling is the
+single thing this page most needs to show, and it is invisible in a list that
+only ever says "Up".
+
+Compose stacks come from the `com.docker.compose.project` label. **No YAML is
+read from disk** — the label is what Docker itself treats as authoritative, and
+a compose file on disk may not be what is actually running.
+
+Docker absent, or a socket that cannot be reached, sets `DockerOK: false`. It
+is not an error and produces no log line: most servers in a fleet built around
+SSH key management will not have Docker, and treating the normal case as a
+fault makes the feature look broken on the majority of the estate.
+
+### systemd: filtered on purpose
+
+```
+systemctl list-units --type=service --state=running,failed --no-legend --plain --no-pager
+systemctl list-unit-files --type=service --state=enabled --no-legend --plain --no-pager
+```
+
+Two calls because "running or failed" and "enabled but stopped" are different
+questions, and an enabled unit that is not running is exactly the one worth
+seeing.
+
+Excluded by prefix: `systemd-`, `user@`, `session-`, `init.scope`. A typical
+host carries 300+ units, the platform's own accounting for most of them.
+Listing all of them buries the ten anyone cares about — the same failure mode
+as an unfiltered vulnerability report, and the same fix.
+
+Column output rather than `--output=json`: the JSON flag requires systemd 246+,
+and this fleet includes older stable distributions. The column format has been
+stable considerably longer than the JSON one has existed.
+
+---
+
+## Control actions
+
+```
+container: docker {start|stop|restart} <id>
+unit:      systemctl {start|stop|restart} <unit>
+```
+
+Owner or admin only. Every action writes an audit event naming the actor, the
+server and the target.
+
+### The protected set
+
+Computed agent-side: `vantage-agent.service`, plus the container ID read from
+`/proc/self/cgroup` should the agent ever be run inside a container.
+
+The agent refuses those before doing anything. As with the console relay
+hardcoding `127.0.0.1` agent-side, **the control plane may name a target, but
+the agent decides what it will do to itself**. A server-side denylist alone
+would be bypassed by the next dispatch path someone adds, and the failure is
+unrecoverable from the UI: a server that stops its own agent goes offline, and
+the way back is SSH or physical access — precisely what this feature exists to
+avoid needing.
+
+### Timeouts
+
+`docker stop` waits on a container that may ignore SIGTERM. `systemctl stop`
+on a unit with a long `TimeoutStopSec` blocks for exactly as long as that says.
+Both run under a 90-second context, and a timeout returns a real error rather
+than an ack implying success.
+
+---
+
+## Logs
+
+```
+container: docker logs --tail 500 --timestamps <id>
+unit:      journalctl -u <unit> -n 500 --no-pager --output=short-iso
+```
+
+Capped at **500 lines and 256KB, whichever binds first**, with `truncated` set
+so the UI can say so. Two caps because 500 lines of a container emitting 4KB
+JSON blobs is 2MB, and a line count alone does not stop it — the same reasoning
+that gave workflow logs both a per-line and a per-run cap.
+
+Live following is deliberately absent. The browser console already offers a
+real terminal on the same server, where `docker logs -f` works properly with
+its own scrollback and cancellation. Building a second streaming path — a
+relay listener, proxy bus keys, a WebSocket upgrade and a cancellation story
+for a follow nobody closed — to duplicate that would be a large amount of
+machinery aimed at a capability already shipped. A bounded snapshot answers
+"why did this restart", which is the question that sends people to the console
+in the first place.
+
+### Log reads are owner or admin only, and audited
+
+Unlike workflow logs, these cannot be masked. A workflow's logs can be masked
+because the run injected the secrets and therefore knows their values. A
+container's stdout is arbitrary and may contain credentials nobody declared —
+a connection string in a startup banner, a token in a stack trace.
+
+So log reads sit behind the same role check as control actions and are audited.
+A member who can see the fleet cannot read its logs. This is a deliberate
+access decision, not an oversight, and it is why log reading is not simply
+folded in with the read-only snapshot endpoints.
+
+---
+
+## REST API
+
+```
+GET  /api/servers/:id/workloads                 # stored snapshot
+POST /api/servers/:id/workloads/refresh         # dispatch, then refetch
+POST /api/servers/:id/workloads/:wid/action     # {"action":"start|stop|restart"}  (owner|admin)
+GET  /api/servers/:id/workloads/:wid/logs?tail= #                                   (owner|admin)
+GET  /api/workloads?image=&stack=&state=        # fleet-wide
+```
+
+`:wid` is a container ID or a unit name, URL-encoded. Unit names carry dots and
+`@`, which are legal in a path segment but not worth relying on unencoded.
+
+`tail` is clamped to the 500-line cap server-side; a client asking for more
+gets 500, not an error.
+
+---
+
+## UI
+
+Server detail gains a **Workloads** tab, ordered compose stacks first — grouped
+under the stack name — then loose containers, then units.
+
+That ordering is not cosmetic. A stack is one thing to an operator even when it
+is six containers, and a flat list turns one decision into six rows. It is the
+same argument that groups the vulnerabilities board by CVE rather than by
+finding.
+
+A `/workloads` fleet view answers "which servers run image X", which is the
+reason the snapshot is stored at all rather than fetched on demand and
+discarded.
+
+Three rules that follow directly from the model:
+
+- **Protected rows render their actions disabled, with the reason**, rather
+  than offering a button whose refusal is already known.
+- **`DockerOK: false` reads "Docker not in use on this server"**, never an
+  empty list, and `DockerError` when present is shown as a distinct problem.
+- State never reads by colour alone: every pill carries a distinct shape and a
+  text label, matching the existing monitor and severity pills.
+
+---
+
+## Verification
+
+**No automated tests.** The repository has none today, and by explicit
+instruction this feature adds none — no `*_test.go`, no frontend test files.
+A deliberate decision by the repository owner, recorded so the absence reads as
+a choice rather than an omission.
+
+The behaviours that would otherwise have been tested are the ones that fail
+quietly, and the implementation plan carries a manual check for each:
+
+- **Parser output against real command output.** `docker inspect` must yield
+  `RestartCount`, health and the compose label as `Stack`; the `systemctl`
+  exclusion filter must drop `systemd-*` and `user@*` while keeping
+  `nginx.service`. Both are verified against a live host rather than a fixture.
+- **Protected-set computation.** `vantage-agent.service` marked,
+  `nginx.service` not. Getting this wrong in the permissive direction lets a
+  server stop its own agent, which is unrecoverable from the UI.
+- **Hash order-independence.** An ordering-sensitive hash resends the full list
+  every 60 seconds, which is invisible except as traffic.
+- **Log capping in both directions.** 600 lines in → 500 out with `truncated`;
+  a 300KB blob of fewer than 500 lines → capped, `truncated`. The second is the
+  case a line-count-only implementation silently fails, and it fails by sending
+  megabytes rather than by erroring.
+
+---
+
+## Failure modes
+
+| Failure | Behaviour |
+| ------- | --------- |
+| Docker not installed | `DockerOK: false`, no error, UI reads "not in use" |
+| Docker installed, daemon down | `DockerOK: false` **plus** `DockerError` — different message, different fix |
+| Agent offline | 503 from the existing dispatcher. No queueing: a command whose owner died must fail loudly |
+| Action on a protected workload | Agent refuses; API answers 409 naming the reason |
+| `stop` exceeds its timeout | Real error surfaced, never a hopeful ack. Snapshot refreshed afterwards |
+| Container removed between snapshot and action | Docker's "No such container" surfaced and a refresh dispatched — this is what on-demand refresh is for |
+| Log exceeds either cap | Truncated, flagged, and stated in the UI |
+| Instance deleted | **`server_workloads` must be added to the control plane's instance-deletion collection list**, alongside sub-project A's two collections |
+
+---
+
+## Deliberately out of scope
+
+- **Live log following.** The console already does it. See the logs section.
+- **Creating, deleting or updating containers and units.** This is a control
+  and visibility surface, not a deployment tool — workflows already exist for
+  changing what a server runs, with snapshots, audit and rollback.
+- **`docker exec` into a container.** The console reaches the host; exec from
+  the control plane is a second remote-execution path with its own audit and
+  authorisation story, and it belongs in its own spec if anywhere.
+- **Kubernetes and containerd.** The Docker collector shells to the `docker`
+  CLI, so a node whose runtime is containerd or CRI-O reports nothing from it —
+  `DockerOK: false`, correctly, since Docker genuinely is not in use. Covering
+  those runtimes means a `crictl`/`nerdctl` collector, and talking to a
+  Kubernetes API server is a different subsystem again. Neither is v1.
+- **Podman as a supported runtime.** Its `docker`-compatible CLI means an
+  aliased install will largely work, and that is a happy accident rather than a
+  claim: nothing here is tested against Podman and its `RestartCount` and
+  compose-label behaviour are not verified.
+- **Windows.** No systemd, and a different container story.
+- **Image vulnerability scanning.** Sub-project C, which needs this spec's
+  image list and sub-project A's findings model.
@@ -10,67 +10,54 @@ HQ portal.

 ## What a licence is

-A signed file. It carries the instance UUID it belongs to, the tier, the server
+A signed file. It carries the instance ID it belongs to, the tier, the server
 allowance, feature toggles and an expiry. The control plane verifies the
-signature locally checking a licence never contacts HQ, and a running instance
-does not need HQ to be reachable.
+signature locally.

-Signing happens in exactly one place, in HQ. The control plane can only verify.
+A running instance does not need HQ to be reachable.

-## 1. Find your instance UUID
+:::info One Free per account, per deployment.
+The limit is enforced per account **and** deployment, so a Free cloud instance does not stop you claiming Free on a self-hosted install.
+:::

-In the control plane, go to **Settings → Licence**. The instance UUID is shown
-there. It is the identity your licence binds to.
+## 1. Find your instance ID

-## 2. Link the install to your HQ account
+In the control plane, go to **Settings → Licence**. The instance ID is shown there.
+
+## 2. Create a free license

 1. Sign in at [Vantage HQ](https://vantage-hq.hostxtra.co.uk). If you have no
   account, see [Accounts and signup](../hq/accounts-and-signup.md).
-2. Choose **Link an instance**.
-3. Paste the instance UUID and give it a name you will recognise.
+2. Click on the **Buy A Plan** button.
+3. Click on **Self Hosted** then click on the **Free** plan, then finally Paste the instance ID and give it a name you will recognise.

-Linking claims the UUID for your account. A UUID already linked elsewhere is
-refused with a conflict rather than silently moved.
+You will then see the new instance on the **Overview** page.

-## 3. Claim Free
+## 3. Downloading the free license

-With the instance linked, choose **Claim Free** on it. HQ issues a Free licence
-bound to that UUID and hands it back.
+With the instance created go to the **Overview** page and expand the new instance.

-:::info One Free per account, per deployment
-The limit is enforced per account **and** deployment, so a Free cloud instance
-does not stop you claiming Free on a self-hosted install. Both the friendly
-pre-check and the issuer apply the same rule deliberately, because a
-pre-check stricter than the issuer would refuse something that would actually
-have worked.
-:::
+Click on the **View Instance Settings** button. You can then click on the **Download License** or the **Copy to clipboard** button.

 ## 4. Install the licence

 Download the licence from HQ and paste it in the control plane at
 **Settings → Licence**.

-The instance validates the signature, checks the UUID matches its own, and
+The instance validates the signature, checks the ID matches its own, and
 starts reporting the tier, allowance and expiry.

-:::warning Cloud instances cannot paste a licence
-On a cloud instance `POST /license` answers `409 cloud_managed`, and the UI
-hides the form entirely. A cloud licence is written directly by HQ. This is not
-a restriction the injection path has to work around it writes to the database,
-not through the endpoint.
+:::info Cloud instances do **not** require installing the license as this is done automatically.
 :::

 ## Renewing

 Free licences are renewable from HQ within a renewal window near expiry;
-outside that window the renew call refuses. See [Free tier](../hq/free-tier.md).
-
-Pasting a licence keeps working while the current one is expired that endpoint
-is exempt from the licence check, because it is the way out of degraded mode.
+outside that window you cannot renew early. See [Free tier](../hq/free-tier.md).

 ## Moving the install to new hardware

-Rebuilding produces a new instance UUID, and a licence binds to a UUID. Use
+Rebuilding produces a new instance ID, and a licence binds to a ID. Use
 **Relink** in HQ to move the licence across. The number of relinks per term is
 capped; the portal shows how many you have left.

@@ -4,7 +4,7 @@ title: First login
 sidebar_label: First login
 ---

-A fresh install has no users and no organisation. The first visit creates both.
+A fresh install has no users and no instance. The first visit creates both.

 ## 1. Bootstrap

@@ -13,48 +13,49 @@ Open the control plane in a browser. Because no user exists, you land on

 Fill in:

-| Field             | Notes                                                             |
-| ----------------- | ----------------------------------------------------------------- |
-| Organisation name | Display name. Shown throughout the UI                             |
-| Slug              | Lowercase, used in the hostname on cloud. Some names are reserved |
-| Your name         |                                                                   |
-| Email             | Becomes your sign-in identity                                     |
-| Password          | Stored bcrypt-hashed                                              |
+| Field         | Notes                                 |
+| ------------- | ------------------------------------- |
+| Instance name | Display name. Shown throughout the UI |
+| Email         | Becomes your sign-in identity         |
+| Password      | Stored bcrypt-hashed                  |

-Submitting creates the organisation and its **owner** you.
+Submitting creates the instance and its **owner** you.

 :::warning Bootstrap works exactly once
 The endpoint is open only while the database has no users. As soon as the first
-one exists, `/setup` redirects to the login page and the bootstrap endpoint
-refuses. There is no second chance to create the first owner, so record the
-credentials before you close the tab.
+one exists, There is no second chance to create the first owner, so record the
+credentials before you continue.
 :::

-## 2. Sign in
+## 2. Copy the Instance ID

-You are taken to `/login`. Sign in with the email and password you just set.
+Once you have finished setup you will see the successfully created page.

-Sessions are an opaque 32-byte token in the `km_session` cookie, with the body
-held in Redis for 24 hours. Restarting Redis signs everyone out and loses
-nothing else.
+This will show the Instance ID. You will need this ID when creating a license in the HQ.

-## 3. Look around
+## 3. Sign in

-You land on the fleet dashboard, which is empty. The sidebar is the whole
+Click the continue to sign in button on the successful setup page.
+
+You will be taken to `/login`. Sign in with the email and password you just set.
+
+## 4. Look around
+
+You land on the servers dashboard, which is empty. The sidebar is the whole
 product:

-| Section   | What it does                              |
-| --------- | ----------------------------------------- |
-| Servers   | The fleet enrol, inspect, console, update |
-| Keys      | SSH public keys and their assignments     |
-| Workflows | Compose and run scripted work             |
-| Steps     | The reusable step library                 |
-| Monitors  | HTTP, TCP, ICMP and TLS checks            |
-| Secrets   | The encrypted vault                       |
-| Audit     | Every mutating action                     |
-| Settings  | Members, SSO, alerts, retention, licence  |
+| Section   | What it does                               |
+| --------- | ------------------------------------------ |
+| Servers   | The server enrol, inspect, console, update |
+| Keys      | SSH public keys and their assignments      |
+| Workflows | Compose and run scripted work              |
+| Steps     | The reusable step library                  |
+| Monitors  | HTTP, TCP, ICMP and TLS checks             |
+| Secrets   | The encrypted vault                        |
+| Audit     | Every mutating action                      |
+| Settings  | Members, SSO, alerts, retention, licence   |

-## 4. Add the rest of your team
+## 5. Add the rest of your team

 Go to **Settings → Access**. Add members with a role:

@@ -66,12 +67,6 @@ Go to **Settings → Access**. Add members with a role:

 Settings and organisation management require `owner` or `admin`.

-If you would rather not manage passwords, configure single sign-on instead:
-see [Settings](../vantage/settings.md#single-sign-on). You can add more than
-one identity provider; each gets its own button on the login page, and no
-buttons appear at all until at least one provider is configured. Client
-secrets are stored encrypted.
+If you would rather not manage passwords, configure single sign-on instead: see [Settings](../vantage/settings.md#single-sign-on).

-## Next
-
-[Add your first server](./first-server.md).
+You can add more than one identity provider; each gets its own button on the login page, and no buttons appear at all until at least one provider is configured.
@@ -4,41 +4,39 @@ title: Add your first server
 sidebar_label: Add your first server
 ---

-Enrolling a machine means running one command on it. The control plane issues a
+Enrolling a server means running one command on it. The control plane issues a
 short-lived token, the install script fetches the agent and writes a config, and
 the machine registers itself.

 ## 1. Create the enrolment

-In the UI, go to **Servers → Add server**. That calls `POST /api/servers/new`,
-which generates a server ID and a pre-registration token and hands back a ready
-one-liner.
+In the UI, go to **Servers → Add server** Then click the **Generate Install Command** button.
+This generates a server ID and a pre-registration token

 :::warning The token is single-use and lives one hour
-It is the only credential in the flow, and it is spent the moment the agent
-calls `Register`. If you paste it somewhere and come back tomorrow, create a new
-enrolment instead nothing is lost by doing so.
+It is the only credential in the flow, and it is spent the moment the agent registers.
 :::

 ## 2. Run the one-liner

 ### Linux

+Run the generated install script as root.
+
+Here is an example of the install script:
+
 ```bash
 curl -fsSL "https://vantage.example.com/install?server_id=<id>&token=<token>" | bash
 ```

-Run it as root. The script:
+What the script does:

 1. Detects architecture `x86_64` and `aarch64` only; anything else exits.
-2. Asks the Gitea API for the newest `agent/v*` release.
-3. Downloads the binary and `checksums.txt`, and **verifies the SHA-256**,
-   aborting on a mismatch.
-4. Installs to `/usr/local/bin/vantage-agent`, mode `0755`.
-5. Writes `/etc/vantage/config.yaml` (directory `0700`, file `0600`) containing
-   the server ID, the pre-registration token and the gRPC host.
-6. Writes `/etc/systemd/system/vantage-agent.service` with `Restart=always`, and
-   runs `systemctl enable --now vantage-agent`.
+2. Downloads the binary and `checksums.txt`, and **verifies the SHA-256**, aborting on a mismatch.
+3. Installs to `/usr/local/bin/vantage-agent`, mode `0755`.
+4. Writes the config file at `/etc/vantage/config.yaml`
+    1. This contains the server ID, the pre-registration token and the gRPC host.
+5. Writes the systemd service file `/etc/systemd/system/vantage-agent.service` and starts the agent.

 ### Windows

@@ -46,42 +44,30 @@ Run it as root. The script:
 irm "https://vantage.example.com/install.ps1?server_id=<id>&token=<token>" | iex
 ```

-Run from an elevated PowerShell. The agent is registered as a service through
-NSSM, with the config at `%ProgramData%\vantage\config.yaml`. There is also an
-MSI built by CI if you would rather deploy that.
+Run from an elevated PowerShell.

-:::info Windows agents are second-class on purpose
-They register, heartbeat, run workflow steps and report inventory. They do
-**not** manage `authorized_keys` the key subsystem is Linux-only, and a
-Windows agent stops after the heartbeat portion of the poll.
+What the script does:
+
+1. Creates the config at `%ProgramData%\vantage\config.yaml`.
+    1. This contains the server ID, the pre-registration token and the gRPC host.
+2. Downloads the agent MSI from Gitea.
+3. Installs the MSI and creates the Windows service.
+4. Starts the agent.
+
+:::info Windows agents do **not** manage `authorized_keys` as this is a Linux-only function.
 :::

 ## 3. Watch it come up

-The server appears immediately as `pending`. Within one poll interval 30
-seconds it flips to `active`.
+The server appears immediately as `pending`. Within one poll interval, 30 seconds it becomes `active`.

-On the machine:
+Check the systemd logs using the following commands:

 ```bash
 systemctl status vantage-agent
 journalctl -u vantage-agent -f
 ```

-What happens on that first run:
-
-```
-1. Load /etc/vantage/config.yaml
-2. pre_reg_token present  → register → save agent_token, clear pre_reg_token
-3. Reconnect with the permanent token
-4. Start: command stream · hourly update check · inventory · monitors
-5. Enter the key poll loop
-```
-
-After registration the config no longer contains the pre-registration token; it
-contains a permanent agent token instead. The control plane stores only the
-SHA-256 of that token, never the token itself.
-
 ## 4. Confirm it works

 Open the server's detail page. Within a minute or two you should see:
@@ -104,7 +90,7 @@ Open the server's detail page. Within a minute or two you should see:
 A server is marked `offline` when its last-seen time passes the threshold; that
 sweep runs every two minutes, so allow for it before concluding anything.

-## Next
+## Next Steps

 - [Assign an SSH key](../vantage/ssh-keys.md)
 - [Run a workflow](../vantage/workflows.md)
@@ -4,8 +4,7 @@ title: Accounts and signup
 sidebar_label: Accounts and signup
 ---

-Vantage HQ, at `vantage-hq.hostxtra.co.uk`, is where you manage the **account**
-behind your instances: your team, your instances, their licences and billing.
+[Vantage HQ](https://vantage-hq.hostxtra.co.uk) is where you manage the **account**, your team, your instances, their licences and billing.

 ## An account is a team, not a person

@@ -31,26 +30,15 @@ Signup is **account-first**. Creating an account creates the account and you;
 it does not create a Vantage instance. Nothing exists in any control plane until
 you later create or link one.

-1. Go to the signup form.
+1. Go to the [signup form](https://vantage.hostxtra.co.uk/start).
 2. Enter your name, email and a password.
 3. Check your email and click the verification link.

-:::info Verify before you can sign in
-An unverified account gets a distinct "check your email" message rather than a
-generic authentication failure the address is already known to be yours, so
-there is nothing to protect by being vague.
-:::
-
-Verification links are valid for **24 hours**. The token is 32 random bytes and
-only its SHA-256 hash is stored, so a leaked database yields no working links.
-
-If the verification email cannot be sent, the signup is rolled back rather than
-left stranded retry rather than assuming a half-created account is in the way.
+Verification links are valid for **24 hours**.

 ## Signing in

-Email and password. The session is a cookie, separate from the control plane's:
-signing in to HQ does not sign you in to an instance, and vice versa.
+Use the Email and password used in the signup form to login to the HQ, signing in to HQ does not sign you in to an instance, and vice versa.

 ## What comes next

@@ -65,14 +53,6 @@ signing in to HQ does not sign you in to an instance, and vice versa.

 Three destinations: **Overview**, **People**, **Billing**.

-Settings lives in the account menu rather than the nav, because it is your
-password rather than a place. The appearance toggle is there too.
-
-Overview lists your instances. Each is one record, closed to a row and open to
-its licence contents, members and actions. It opens by default when it is your
-only instance or when it needs attention, and your manual choice is remembered.
-
-There is deliberately no "your plan" card in the sidebar: tier, limits and
-expiry belong to a **licence**, and a licence belongs to one instance. An
-account with a Free cloud instance and a Professional self-hosted one has no
-single plan to show.
+- Overview lists your instances.
+- People shows all the account members and their roles.
+- Billing show the current subscriptions and subscription management.
@@ -8,56 +8,29 @@ Paid plans are billed through **Paddle**, which is the merchant of record. Your
 invoice, your card details and your tax handling are all Paddle's; HQ holds a
 customer reference and nothing sensitive.

-Billing is **owner-only**.
+:::warning
+The Billing page requires the **owner-only** account role.
+:::

-## Buying
+## Buying A Plan
+
+Buying a plan license can be found in Vantage HQ by clicking on the **Buy a Plan** button on the **Overview** page.

 ### Cloud

-Open the instance, change its configuration to what you want, and check out.
-Checkout runs in the browser.
+On the **Buy A Plan** page you will need to select the **Deployment** to **Cloud** then chose your **Billing** cycle (Monthly or Annually).
+
+Then select your desired **Plan** and configure the features.
+
+Finally specify the **Instance Name** and click the **Continue to payment** button.

 ### Self-hosted

-**Buy self-hosted**, then bind the purchase to your install's UUID. See
-[Self-hosted instances](./self-hosted-instances.md).
+On the **Buy A Plan** page you will need to select the **Deployment** to **Self-Hosted** then chose your **Billing** cycle (Monthly or Annually).

-## What you are buying
+Then select your desired **Plan** and configure the features.

-A subscription's line items are the configuration: the plan base, the metered
-server count above the base, and any per-instance features. Changing the
-configuration changes the line items.
-
-## Changing configuration
-
-**Instance → Configuration**, adjust servers or features, and save.
-
- **Increases** take effect when the payment confirms.
- **Reductions** are scheduled for the end of the term. The portal shows the
-  date and the new value.
-
-## The customer portal
-
-**Billing → Manage** mints a Paddle customer-portal session where you can
-update your payment method, see invoices and cancel.
-
-## How a licence follows a payment
-
-```mermaid
-flowchart LR
-    C["Checkout / change"] --> P["Paddle"]
-    P -->|signed webhook| H["HQ"]
-    H --> G["Entitlement: desired → granted"]
-    G --> L["Licence signed from granted"]
-```
-
-The webhook is the **only** issuing path for paid plans. It is signature
-verified, processed exactly once, and resolved from the subscription's _current_
-line items so a webhook that arrives out of order still produces the right
-answer rather than replaying a stale state.
-
-A licence is signed from **granted** only. A checkout you abandon changes
-nothing.
+Finally specify the **Instance Name** and click the **Continue to payment** button.

 ## Cancelling and failed payments

@@ -66,18 +39,12 @@ Your licence runs to its grace-padded expiry and then lapses normally. There is
 no mid-term cut-off.

 For a cloud Free instance, lapsing eventually leads to deletion see
-[Free tier](./free-tier.md). Paid instances are not reaped.
+[Free tier](./free-tier.md). Paid instances are not deleted.

 ## Renewals

 At renewal the subscription bills again and the licence is reissued for the new
 term. It is also the only moment a scheduled **reduction** takes effect.

-Self-hosted customers: download and paste the reissued licence. Cloud customers:
-nothing to do.
-
-## Free is not in Paddle at all
-
-Free has no subscription, no £0 line item and no Paddle record. It has its own
-renewal, in the portal. An account only acquires a Paddle customer reference
-with its first paid purchase.
+- Self-hosted customers: download and paste the reissued licence.
+- Cloud customers: the license is automatically linked to the instance.
@@ -25,11 +25,6 @@ features on a paid plan.
 The limit is enforced per account **and** deployment. A Free cloud instance does
 not prevent a Free self-hosted one they are separate slots.

-## Free is outside Paddle
-
-There is no subscription, no £0 line item and no invoice. Your account acquires
-a Paddle customer reference only with its first paid purchase.
-
 ## Renewing

 Free licences have a term and must be renewed from the portal.
@@ -30,9 +30,9 @@ entitlement.

 Two are per-instance toggles rather than tier bundles:

-| Feature   | What it enables                                                           |
-| --------- | ------------------------------------------------------------------------- |
-| `console` | The [browser console](../vantage/browser-console.md)                      |
+| Feature   | What it enables                                                      |
+| --------- | -------------------------------------------------------------------- |
+| `console` | The [browser console](../vantage/browser-console.md)                 |
 | `oidc`    | Per-instance [single sign-on](../vantage/settings.md#single-sign-on) |

 No tier includes them by default; you enable them on the instances that need
@@ -88,8 +88,3 @@ or let it be written for you (cloud).
 When you exceed your server allowance, enrolling another one is refused. The
 existing fleet is unaffected. Raise the allowance in the portal, or remove a
 server you are not using.
-
-## Legacy tiers
-
-An older `self_hosted` tier is mapped forward to self-hosted Professional
-wherever it appears. Nothing needs doing about it.
@@ -10,7 +10,6 @@ themselves on command.
 ## Checking the current version

 Each server's detail page shows the version it reported at its last sync.
-`GET /api/agent/latest-version` reports the newest release available.

 ## Updating from the UI

@@ -21,8 +20,6 @@ version. The agent then:
 2. Verifies the SHA-256 against `checksums.txt`.
 3. Stops itself, replaces the binary in place, and starts again.

-`Restart=always` on the systemd unit is what makes the last step work.
-
 The server briefly goes `offline` and comes back within a poll interval or two.

 ## Updating from the machine
@@ -52,16 +52,9 @@ cp /opt/vantage/.env /secure-location/vantage.env

 Treat it as a credential in its own right it holds the encryption key.

-## Run logs
-
-Workflow run logs live in the `./data` bind mount, not in the database. They are
-swept on the retention schedule anyway, so most people do not back them up. If
-you keep them for compliance, set retention to `0` (forever) and include the
-directory.
-
 ## What a restore gives you

-Everything: fleet, keys, assignments, workflows and their history, monitors and
+Everything: server, keys, assignments, workflows and their history, monitors and
 incidents, secrets, settings and the audit log.

 What it does **not** do is reconcile the world. After a restore:
@@ -37,31 +37,9 @@ tls: true

 :::danger This file is the credential
 `agent_token` is plaintext here and nowhere else the control plane holds only
-its SHA-256. Anyone who can read this file can act as this agent. That is why
-it is `0600` and the directory is `0700`.
+its SHA-256. Anyone who can read this file can act as this agent.
 :::

-## Startup sequence
-
-```
-1. Load the config
-2. pre_reg_token present → register → save agent_token,
-   clear pre_reg_token, reconnect
-3. Start: command stream · hourly update check · inventory · monitors
-4. Enter the key poll loop
-```
-
-## The poll loop
-
-```
-1. Ask the control plane for the desired key state, reporting the
-   agent version
-2. Non-Linux hosts stop here Windows agents register and heartbeat only
-3. Diff the desired keys against /root/.ssh/authorized_keys;
-   unchanged → write nothing
-4. Changed → write a temp file, rename it over the real one, chmod 0600
-```
-
 ## Service management

 ### Linux
@@ -77,21 +55,13 @@ journalctl -u vantage-agent -f

 ### Windows

-A service registered through NSSM, or installed by the MSI that CI builds.
+A service registered through NSSM, or installed by the MSI.

 ```powershell
 Get-Service vantage-agent
 Restart-Service vantage-agent
 ```

-## Command-line flags
-
-```
-vantage-agent -generate-key
-```
-
-Generates a keypair locally. Normal operation takes no flags.
-
 ## Moving an agent to a new control plane

 Change `server_url`, clear `agent_token`, set a fresh `pre_reg_token` from a new
@@ -0,0 +1,94 @@
+---
+id: vulnerabilities
+title: Vulnerabilities
+sidebar_label: Vulnerabilities
+---
+
+Each Linux server reports the packages it has installed. Vantage matches them
+against the security advisories published by that server's own distribution and
+raises a finding for anything not yet patched.
+
+Requires the **vulnerability scanning** feature on your licence. Without it,
+agents collect nothing at all — there is no inventory stored and no findings
+page to read.
+
+## What gets scanned
+
+Linux servers running `apt`, `dnf`/`yum`, `apk`, `zypper` or `pacman`. Agents
+report their package list hourly, and only when it has changed since the last
+report.
+
+Windows servers are not scanned.
+
+Some distributions publish no machine-readable advisory feed. Those servers
+show **unsupported** on their own page rather than appearing as having no
+vulnerabilities — the two are very different answers, and only one of them is
+good news.
+
+## Why versions look "wrong"
+
+A finding names the version your distribution ships, not the upstream release.
+Ubuntu's `openssl 3.0.2-0ubuntu1.15` carries security fixes backported into
+what still calls itself 3.0.2, so public CVE databases listing "3.0.2" as
+vulnerable are describing upstream, not your machine.
+
+Vantage matches against your distribution's own advisories, which is why a
+server can be running a version some scanners flag while Vantage correctly
+reports it as patched.
+
+For the same reason a severity here may be lower than the one you find on a CVE
+website. Debian and Red Hat routinely downgrade a rating when the vulnerable
+code path is not reachable in the way they build the package. Their rating is
+the accurate one for the package you are actually running.
+
+## The board
+
+`/vulnerabilities` groups findings by CVE. One row per CVE with the number of
+affected servers, expandable to the individual servers — the same CVE across
+forty machines is one decision, not forty.
+
+Severity counts at the top filter the list when clicked. The state tabs switch
+between **open**, **accepted** and **fixed**.
+
+The vulnerability database's age is shown above the board. If a pull has failed
+for long enough for the data to be stale, that becomes a warning: a low count
+against three-week-old data is not the same as a low count.
+
+## Fixing something
+
+A finding with a known fixed version gets an **Apply updates** button, which
+runs the same OS update the server page offers. There is no separate patching
+mechanism.
+
+Vantage never patches automatically. An unattended upgrade triggered by a third
+party's data feed is a fleet-wide change nobody chose.
+
+## Accepting a finding
+
+Some findings cannot be fixed today: a kernel CVE waiting on a reboot window,
+or one with no vendor fix published at all.
+
+**Accept** hides a finding from counts and alerts until a date you choose, with
+a reason that is recorded in the audit log along with your name. On that date it
+reopens by itself.
+
+The expiry is required. A dismissal with no end date is how a finding gets
+forgotten, and it is exactly what an auditor will ask to see.
+
+## Alerts
+
+Alert rules live with your notification channels, under
+**Settings → Notification Channels**. A rule has a minimum severity, an optional
+server tag filter, and one or more channels.
+
+A rule sends **one digest per scan** summarising what newly opened — never one
+message per finding. A database refresh can open several hundred findings at
+once, and a message each would flood the channel.
+
+Findings that were already open do not re-alert.
+
+## Fleet-wide package search
+
+`GET /api/packages/search?name=openssl` answers which servers run a given
+package and at what version, across the whole fleet. Useful during an incident
+before a finding exists for it.
@@ -147,6 +147,57 @@ A run shows the script that actually executed, not the current library version.

 Targets run **in parallel**; steps within one server run **in order**.

+## Schedules
+
+A workflow can carry a schedule, and Vantage will start it the same way a person
+would — the same dispatch, the same snapshot, the same run page. A scheduled run
+is an ordinary run with `schedule` recorded as who triggered it.
+
+Open a workflow, choose **Edit**, and tick **Run on a schedule**. The expression
+is standard five-field cron:
+
+```
+minute  hour  day-of-month  month  day-of-week
+```
+
+The presets write cron underneath, so you can start from one and adjust:
+
+| Preset              | Cron        |
+| ------------------- | ----------- |
+| Hourly              | `0 * * * *` |
+| Nightly, 02:00      | `0 2 * * *` |
+| Weekly, Sun 02:00   | `0 2 * * 0` |
+| Monthly, 1st 02:00  | `0 2 1 * *` |
+
+There is no seconds field and no `@daily`-style shorthand. The next three
+occurrences are shown as you type, and they are computed by the server rather
+than the browser, so what you see is exactly what will fire.
+
+### Timezones
+
+A schedule stores an IANA timezone by name — `Europe/London`, not an offset.
+That is what makes a 02:00 job stay at 02:00 across a daylight-saving change
+instead of drifting an hour for half the year. An unknown zone is refused when
+you save it, not at 2am.
+
+### Overlaps are skipped, not queued
+
+If a run of the same workflow is still going when the next occurrence comes
+round, the occurrence is **skipped** and the reason recorded. It is not queued
+behind the running one. A patch workflow that takes longer than its interval
+should fall behind visibly rather than pile up.
+
+### Missed occurrences
+
+If the control plane was not running when an occurrence was due, it still fires
+when the control plane comes back — but only within **one hour** of the due
+time. Anything older is recorded as missed and dropped. A job missed by ten
+minutes during an upgrade should still run; one missed by two days should not
+suddenly fire at lunchtime.
+
+Either kind of skip is shown on the workflow's schedule panel, with the time it
+was due and why it did not run.
+
 ## Watching a run

 Step stdout and stderr stream back as chunks, are appended to a log file on the
@@ -26,6 +26,7 @@ const sidebars: SidebarsConfig = {
                "vantage/ssh-keys",
                "vantage/workflows",
                "vantage/monitors",
+                "vantage/vulnerabilities",
                "vantage/notification-channels",
                "vantage/secrets",
                "vantage/browser-console",
@@ -1,22 +1,69 @@
 cloud.google.com/go/compute v1.25.1/go.mod h1:oopOIR53ly6viBYxaDhBfJwzUAxf1zE//uf3IB011ls=
 cloud.google.com/go/compute/metadata v0.3.0/go.mod h1:zFmK7XCadkQkj6TtorcaGlCW1hT1fIilQDwofLpJ20k=
+github.com/Intevation/gval v1.3.0/go.mod h1:xmGyGpP5be12EL0P12h+dqiYG8qn2j3PJxIgkoOHO5o=
+github.com/Intevation/jsonpath v0.2.1/go.mod h1:WnZ8weMmwAx/fAO3SutjYFU+v7DFreNYnibV7CiaYIw=
+github.com/VividCortex/ewma v1.2.0/go.mod h1:nz4BbCtbLyFDeC9SUHbtcT5644juEuWfUAUnGx7j5l4=
 github.com/alecthomas/template v0.0.0-20190718012654-fb15b899a751/go.mod h1:LOuyumcjzFXgccqObfd/Ljyb9UuFJ6TxHnclSeseNhc=
 github.com/alecthomas/units v0.0.0-20211218093645-b94a6e3cc137/go.mod h1:OMCwj8VM1Kc9e19TLln2VL61YJF0x1XFtfdL4JdbSyE=
+github.com/aquasecurity/bolt-fixtures v0.0.0-20200903104109-d34e7f983986/go.mod h1:NT+jyeCzXk6vXR5MTkdn4z64TgGfE5HMLC8qfj5unl8=
+github.com/aquasecurity/go-gem-version v0.0.0-20201115065557-8eed6fe000ce/go.mod h1:HXgVzOPvXhVGLJs4ZKO817idqr/xhwsTcj17CLYY74s=
+github.com/aquasecurity/go-npm-version v0.0.1/go.mod h1:hxbJZtKlO4P8sZ9nztizR6XLoE33O+BkPmuYQ4ACyz0=
+github.com/aquasecurity/go-pep440-version v0.0.1/go.mod h1:3naPe+Bp6wi3n4l5iBFCZgS0JG8vY6FT0H4NGhFJ+i4=
+github.com/aquasecurity/go-version v0.0.1/go.mod h1:s1UU6/v2hctXcOa3OLwfj5d9yoXHa3ahf+ipSwEvGT0=
+github.com/briandowns/spinner v1.23.0/go.mod h1:rPG4gmXeN3wQV/TsAY4w8lPdIM6RX3yqeBQJSrbXjuE=
 github.com/bytedance/sonic/loader v0.3.0/go.mod h1:N8A3vUdtUebEY2/VQC0MyhYeKUFosQU6FxH2JmUe6VI=
 github.com/census-instrumentation/opencensus-proto v0.4.1/go.mod h1:4T9NM4+4Vw91VeyqjLS6ao50K5bOcLKN6Q42XnYaRYw=
+github.com/cheggaaa/pb/v3 v3.1.7/go.mod h1:/Ji89zfVPeC/u5j8ukD0MBPHt2bzTYp74lQ7KlgFWTQ=
 github.com/cncf/xds/go v0.0.0-20240318125728-8a4994d93e50/go.mod h1:5e1+Vvlzido69INQaVO6d87Qn543Xr6nooe9Kz7oBFM=
+github.com/cpuguy83/go-md2man/v2 v2.0.5/go.mod h1:tgQtvFlXSQOSOSIRvRPT7W67SCa46tRHOmNcaadrF8o=
 github.com/envoyproxy/go-control-plane v0.12.0/go.mod h1:ZBTaoJ23lqITozF0M6G4/IragXCQKCnYbmlmtHvwRG0=
 github.com/envoyproxy/protoc-gen-validate v1.0.4/go.mod h1:qys6tmnRsYrQqIhm2bvKZH4Blx/1gTIZ2UKVY1M+Yew=
+github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=
+github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY=
+github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ=
+github.com/goccy/go-yaml v1.19.0/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA=
+github.com/gocsaf/csaf/v3 v3.1.1/go.mod h1:EpUCrQg69i+Y66MphmQvVbcj333GFLjXOYHg1zoXVso=
 github.com/golang/glog v1.2.0/go.mod h1:6AhwSGph0fcJtXVM/PEHPqZlFeoLxhs7/t5UDAwmO+w=
 github.com/golang/protobuf v1.5.0/go.mod h1:FsONVRAS9T7sI+LIUmWTfcYkHO4aIWwzhcaSAoJOfIk=
 github.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=
 github.com/google/go-cmp v0.5.5/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=
+github.com/hashicorp/errwrap v1.0.0/go.mod h1:YH+1FKiLXxHSkmPseP+kNlulaMuP3n2brvKWEqk/Jc4=
+github.com/hashicorp/go-multierror v1.1.1/go.mod h1:iw975J/qwKPdAO1clOe2L8331t/9/fmwbPZ6JB6eMoM=
+github.com/josephburnett/jd/v2 v2.3.0/go.mod h1:0I5+gbo7y8diuajJjm79AF44eqTheSJy1K7DSbIUFAQ=
+github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
 github.com/klauspost/cpuid/v2 v2.2.9/go.mod h1:rqkxqrZ1EhYM9G+hXH7YdowN5R5RGN6NK4QwQ3WMXF8=
+github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
+github.com/masahiro331/go-mvn-version v0.0.0-20250131095131-f4974fa13b8a/go.mod h1:jZ3F25l7DbD7l7DcA8aj7eo1EZ84nbzcQHBB4lCSrI8=
+github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
+github.com/mattn/go-runewidth v0.0.16/go.mod h1:Jdepj2loyihRzMpdS35Xk/zdY8IAYHsh153qUoGf23w=
+github.com/oklog/ulid/v2 v2.1.1 h1:suPZ4ARWLOJLegGFiZZ1dFAkqzhMjL3J1TzI+5wHz8s=
+github.com/oklog/ulid/v2 v2.1.1/go.mod h1:rcEKHmBBKfef9DhnvX7y1HZBYxjXb0cP5ExxNsTT1QQ=
+github.com/package-url/packageurl-go v0.1.3/go.mod h1:nKAWB8E6uk1MHqiS/lQb9pYBGH2+mdJ2PJc2s50dQY0=
+github.com/pandatix/go-cvss v0.6.2/go.mod h1:jDXYlQBZrc8nvrMUVVvTG8PhmuShOnKrxP53nOFkt8Q=
+github.com/rivo/uniseg v0.4.7/go.mod h1:FN3SvrM+Zdj16jyLfmOkMNblXMcoc8DfTHruCPUcx88=
+github.com/russross/blackfriday v1.6.0/go.mod h1:ti0ldHuxg49ri4ksnFxlkCfN+hvslNlmVHqNRXXJNAY=
+github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
+github.com/samber/lo v1.50.0 h1:XrG0xOeHs+4FQ8gJR97zDz5uOFMW7OwFWiFVzqopKgY=
+github.com/samber/lo v1.50.0/go.mod h1:RjZyNk6WSnUFRKK6EyOhsRJMqft3G+pg7dCWHQCWvsc=
+github.com/samber/oops v1.18.1 h1:qjhZbqbdyhWBKntkY8sxrDNKA8b4c5VHlmI1rli7X7M=
+github.com/samber/oops v1.18.1/go.mod h1:xYqvimigkKV70HyLXiBZJFpIWi2CGcc6Xx7eV+2HycI=
+github.com/santhosh-tekuri/jsonschema/v5 v5.3.1/go.mod h1:uToXkOrWAZ6/Oc07xWQrPOhJotwFIyu2bBVN41fcDUY=
+github.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=
+github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
+github.com/urfave/cli v1.22.16/go.mod h1:EeJR6BKodywf4zciqrdw6hpCPk68JO9z5LazXZMn5Po=
+go.etcd.io/bbolt v1.4.3 h1:dEadXpI6G79deX5prL3QRNP6JB8UxVkqo4UPnHaNXJo=
+go.etcd.io/bbolt v1.4.3/go.mod h1:tKQlpPaYCVFctUIgFKFnAlvbmB3tpy1vkTnDWohtc0E=
 go.mongodb.org/mongo-driver/v2 v2.5.0/go.mod h1:yOI9kBsufol30iFsl1slpdq1I0eHPzybRWdyYUs8K/0=
+go.opentelemetry.io/otel v1.34.0 h1:zRLXxLCgL1WyKsPVrgbSdMN4c0FMkDAskSTQP+0hdUY=
+go.opentelemetry.io/otel v1.34.0/go.mod h1:OWFPOQ+h4G8xpyjgqo4SxJYdDQ/qmRH+wivy7zzx9oI=
+go.opentelemetry.io/otel/trace v1.34.0 h1:+ouXS2V8Rd4hp4580a8q23bg0azF2nI8cqLYnC8mh/k=
+go.opentelemetry.io/otel/trace v1.34.0/go.mod h1:Svm7lSjQD7kG7KJ/MUHPVXSDGz2OX4h0M2jHBhmSfRE=
+go.yaml.in/yaml/v4 v4.0.0-rc.3/go.mod h1:aZqd9kCMsGL7AuUv/m/PvWLdg5sjJsZ4oHDEnfPPfY0=
 golang.org/x/crypto v0.33.0/go.mod h1:bVdXmD7IV/4GdElGPozy6U7lWdRXA4qyRVGJV57uQ5M=
 golang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0=
 golang.org/x/crypto v0.48.0/go.mod h1:r0kV5h3qnFPlQnBSrULhlsRfryS2pmewsg+XfMgkVos=
 golang.org/x/crypto v0.53.0/go.mod h1:DNLU434OwVakk9PzuwV8w62mAJpRJL3vsgcfp4Qnsio=
+golang.org/x/exp v0.0.0-20251125195548-87e1e737ad39/go.mod h1:46edojNIoXTNOhySWIWdix628clX9ODXwPsQuG6hsK0=
 golang.org/x/mod v0.37.0/go.mod h1:m8S8VeM9r4dzDwjrKO0a1sZP3YjeMamRRlD+fmR2Q/0=
 golang.org/x/net v0.51.0/go.mod h1:aamm+2QF5ogm02fjy5Bb7CQ0WMt1/WVM7FtyaTLlA9Y=
 golang.org/x/sync v0.11.0/go.mod h1:Czt+wKu1gCyEFDUtn0jG5QVvpJ6rzVqr5aXyt9drQfk=
@@ -32,10 +79,13 @@ golang.org/x/text v0.22.0/go.mod h1:YRoo4H8PVmsu+E3Ou7cqLVH8oXWIHVoX0jqUWALQhfY=
 golang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=
 golang.org/x/text v0.34.0/go.mod h1:homfLqTYRFyVYemLBFl5GgL/DWEiH5wcsQ5gSh1yziA=
 golang.org/x/text v0.38.0/go.mod h1:YXZt3QhHUKYT53r2lLKFIVi6Ao1jdzrTR/KQ09qyxF4=
+golang.org/x/time v0.8.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
 golang.org/x/tools v0.47.0/go.mod h1:dFHnyTvFWY212G+h7ZY4Vsp/K3U4/7W9TyVaAul8uCA=
 golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+golang.org/x/xerrors v0.0.0-20231012003039-104605ab7028/go.mod h1:NDW/Ps6MPRej6fsCIbMTohpP40sJ/P/vI1MoTEGwX90=
 google.golang.org/appengine v1.6.8/go.mod h1:1jJ3jBArFh5pcgW8gCtRJnepW8FzD1V44FJffLiz/Ds=
 google.golang.org/genproto/googleapis/api v0.0.0-20240318140521-94a12d6c2237/go.mod h1:Z5Iiy3jtmioajWHDGFk7CeugTyHtPvMHA4UTmUkyalE=
 google.golang.org/protobuf v1.26.0-rc.1/go.mod h1:jlhhOSvTdKEhbULTjvd4ARK9grFBp09yW+WbY/TyQbw=
 google.golang.org/protobuf v1.33.0/go.mod h1:c6P6GXX6sHbq/GpV6MGZEdwhWPcYBgnhAHhKbcUYpos=
 gopkg.in/alecthomas/kingpin.v2 v2.2.6/go.mod h1:FMv+mEhP44yOT+4EoQTLFTRgOQ1FBLkstjWtayDeSgw=
+k8s.io/utils v0.0.0-20201110183641-67b214c5f920/go.mod h1:jPW/WVKK9YHAvNhRxK0md/EJ228hCsBRufyofKtW8HA=
@@ -9,6 +9,7 @@ service Vantage {
  rpc SyncKeys(SyncRequest)                    returns (SyncResponse);
  rpc UploadGeneratedKey(UploadKeyRequest)      returns (UploadKeyResponse);
  rpc ReportUpdates(ReportUpdatesRequest)       returns (ReportUpdatesResponse);
+  rpc ReportPackages(ReportPackagesRequest)     returns (ReportPackagesResponse);
  rpc ReportInventory(InventoryReport)        returns (InventoryReportResponse);
  rpc SyncMonitors(SyncMonitorsRequest)         returns (SyncMonitorsResponse);
  rpc ReportChecks(ReportChecksRequest)         returns (ReportChecksResponse);
@@ -37,6 +38,51 @@ message SyncRequest {

 message SyncResponse {
  repeated string public_keys = 1;
+
+  // collect_packages tells the agent whether this instance's licence grants
+  // vulnerability scanning. False means do not collect at all: no gRPC body,
+  // no document, no storage. The server re-checks on ReportPackages — this
+  // flag is the optimisation, the server check is the boundary.
+  //
+  // Absent reads as false, which is the safe direction: an old server that
+  // does not send it leaves agents collecting nothing.
+  bool collect_packages = 2;
+}
+
+// ReportPackages carries a server's installed package set.
+//
+// The agent calls twice at most. The first call sends only the hash; if the
+// server already holds that hash it answers need_full = false and the ~150KB
+// body is never sent. A machine's package set changes rarely, so almost every
+// hour costs one small message.
+message ReportPackagesRequest {
+  string server_id   = 1;
+  string agent_token = 2;
+  string hash        = 3;
+  OSRelease os       = 4;
+  repeated InstalledPackage packages = 5;  // empty on the offer call
+}
+
+message ReportPackagesResponse {
+  bool need_full = 1;
+}
+
+message OSRelease {
+  string family     = 1;
+  // version_id is not optional: Ubuntu 22.04 and 24.04 publish different fixed
+  // versions for the same CVE, so a scan without it is guesswork.
+  string version_id = 2;
+  string arch       = 3;
+}
+
+message InstalledPackage {
+  string name    = 1;
+  string version = 2;
+  int32  epoch   = 3;
+  string arch    = 4;
+  // source_name is what the Debian and Ubuntu feeds are keyed on: one advisory
+  // against "openssl" covers libssl3, openssl and libssl-dev.
+  string source_name = 5;
 }

 message UploadKeyRequest {
@@ -18,10 +18,19 @@ ARG VERSION=dev
 RUN cd server && CGO_ENABLED=0 GOOS=linux go build \
      -ldflags="-s -w -X main.Version=${VERSION}" -o /vantage-server ./cmd

+# Staged so the scratch image below can have a /tmp. It cannot mkdir one
+# itself — scratch has no shell — and os.MkdirTemp fails outright without it.
+RUN mkdir -p /staging/tmp && chmod 1777 /staging/tmp
+
 # Runtime stage
 FROM scratch

 COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
+
+# vulndb unpacks the ~50MB trivy-db here. Without it the scheduler stops at
+# "temp dir: stat /tmp: no such file or directory" and no scanning happens,
+# while everything else in the process runs perfectly well.
+COPY --from=builder /staging/tmp /tmp
 COPY --from=builder /vantage-server /vantage-server

 COPY default_steps/ /opt/default-steps/
@@ -24,6 +24,7 @@ import (
 	grpcserver "gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/grpc"
 	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/monitorsched"
 	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/services"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/vulnsched"
 	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/workflowsched"
 	"github.com/gin-gonic/gin"
 )
@@ -131,6 +132,10 @@ func runSchemaSetup() {
 		log.Printf("warning: failed to ensure workflow indexes: %v", err)
 	}

+	if err := services.EnsureVulnIndexes(); err != nil {
+		log.Printf("warning: failed to ensure vuln indexes: %v", err)
+	}
+
 	if instanceIDs, err := services.ListInstanceIDs(); err != nil {
 		log.Printf("warning: failed to list instances for default step seeding: %v", err)
 	} else {
@@ -191,6 +196,12 @@ func serve() {
 			LogEvent:        services.LogEvent,
 		})

+		vulnsched.Start(jobCtx, vulnsched.Deps{
+			LogEvent:   services.LogEvent,
+			SendDigest: services.SendVulnDigest,
+		})
+		services.StartVulnSweeper(jobCtx)
+
 		ticker := time.NewTicker(2 * time.Minute)
 		defer ticker.Stop()
 		for {
@@ -3,20 +3,37 @@ module gitea.hostxtra.co.uk/mrhid6/vantage/server
 go 1.26

 require (
+	github.com/aquasecurity/trivy-db v0.0.0-20260713131703-4be526083c54
 	github.com/coreos/go-oidc/v3 v3.18.0
 	github.com/gin-gonic/gin v1.10.0
 	github.com/google/uuid v1.6.0
+	github.com/knqyf263/go-apk-version v0.0.0-20200609155635-041fdbb8563f
+	github.com/knqyf263/go-deb-version v0.0.0-20241115132648-6f4aee6ccd23
+	github.com/knqyf263/go-rpm-version v0.0.0-20240918084003-2afd7dc6a38f
+	github.com/opencontainers/image-spec v1.1.1
 	github.com/redis/go-redis/v9 v9.20.1
+	github.com/robfig/cron/v3 v3.0.1
 	github.com/wwt/guac v1.3.2
 	go.mongodb.org/mongo-driver/v2 v2.8.0
 	golang.org/x/crypto v0.54.0
 	golang.org/x/oauth2 v0.36.0
 	google.golang.org/grpc v1.64.0
+	oras.land/oras-go/v2 v2.6.2
 )

 require (
+	github.com/davecgh/go-spew v1.1.1 // indirect
 	github.com/hyperboloide/lk v0.0.0-20251220053519-b291812e3216 // indirect
-	github.com/robfig/cron/v3 v3.0.1 // indirect
+	github.com/oklog/ulid/v2 v2.1.1 // indirect
+	github.com/opencontainers/go-digest v1.0.0 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	github.com/samber/lo v1.50.0 // indirect
+	github.com/samber/oops v1.18.1 // indirect
+	github.com/stretchr/objx v0.5.2 // indirect
+	github.com/stretchr/testify v1.11.1 // indirect
+	go.etcd.io/bbolt v1.4.3 // indirect
+	go.opentelemetry.io/otel v1.34.0 // indirect
+	go.opentelemetry.io/otel/trace v1.34.0 // indirect
 )

 require (
@@ -1,3 +1,7 @@
+github.com/aquasecurity/bolt-fixtures v0.0.0-20200903104109-d34e7f983986 h1:2a30xLN2sUZcMXl50hg+PJCIDdJgIvIbVcKqLJ/ZrtM=
+github.com/aquasecurity/bolt-fixtures v0.0.0-20200903104109-d34e7f983986/go.mod h1:NT+jyeCzXk6vXR5MTkdn4z64TgGfE5HMLC8qfj5unl8=
+github.com/aquasecurity/trivy-db v0.0.0-20260713131703-4be526083c54 h1:4CZNoDkNfcuACevZeDraACGmP1+L0nKkRY52+jV8k1M=
+github.com/aquasecurity/trivy-db v0.0.0-20260713131703-4be526083c54/go.mod h1:iIEV2oGuZScvfyX2SMIn78iVMNnepgo0QuJJh/srgVI=
 github.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=
 github.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=
 github.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=
@@ -35,6 +39,8 @@ github.com/go-playground/validator/v10 v10.20.0 h1:K9ISHbSaI0lyB2eWMPJo+kOS/FBEx
 github.com/go-playground/validator/v10 v10.20.0/go.mod h1:dbuPbCMFw/DrkbEynArYaCwl3amGuJotoKCe95atGMM=
 github.com/goccy/go-json v0.10.2 h1:CrxCmQqYDkv1z7lO7Wbh2HN93uovUHgrECaO5ZrCXAU=
 github.com/goccy/go-json v0.10.2/go.mod h1:6MelG93GURQebXPDq3khkgXZkazVtN9CRI+MGFi0w8I=
+github.com/goccy/go-yaml v1.19.0 h1:EmkZ9RIsX+Uq4DYFowegAuJo8+xdX3T/2dwNPXbxEYE=
+github.com/goccy/go-yaml v1.19.0/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA=
 github.com/google/go-cmp v0.6.0 h1:ofyhxvXcZhMsU5ulbFiLKl/XBFqE1GSq7atu8tAmTRI=
 github.com/google/go-cmp v0.6.0/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=
 github.com/google/gofuzz v1.0.0/go.mod h1:dBl0BpW6vV/+mYPU4Po3pmUjxk6FQPldtuIdl/M65Eg=
@@ -52,9 +58,17 @@ github.com/klauspost/compress v1.17.6/go.mod h1:/dCuZOvVtNoHsyb+cuJD3itjs3NbnF6K
 github.com/klauspost/cpuid/v2 v2.0.9/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg=
 github.com/klauspost/cpuid/v2 v2.2.10 h1:tBs3QSyvjDyFTq3uoc/9xFpCuOsJQFNPiAhYdw2skhE=
 github.com/klauspost/cpuid/v2 v2.2.10/go.mod h1:hqwkgyIinND0mEev00jJYCxPNVRVXFQeu1XKlok6oO0=
+github.com/knqyf263/go-apk-version v0.0.0-20200609155635-041fdbb8563f h1:GvCU5GXhHq+7LeOzx/haG7HSIZokl3/0GkoUFzsRJjg=
+github.com/knqyf263/go-apk-version v0.0.0-20200609155635-041fdbb8563f/go.mod h1:q59u9px8b7UTj0nIjEjvmTWekazka6xIt6Uogz5Dm+8=
+github.com/knqyf263/go-deb-version v0.0.0-20241115132648-6f4aee6ccd23 h1:dWzdsqjh1p2gNtRKqNwuBvKqMNwnLOPLzVZT1n6DK7s=
+github.com/knqyf263/go-deb-version v0.0.0-20241115132648-6f4aee6ccd23/go.mod h1:lUaIXCWzf7BRKTY5iEcrYy1TfgbYLYVIS/B2vPkJzOc=
+github.com/knqyf263/go-rpm-version v0.0.0-20240918084003-2afd7dc6a38f h1:xt29M2T6STgldg+WEP51gGePQCsQvklmP2eIhPIBK3g=
+github.com/knqyf263/go-rpm-version v0.0.0-20240918084003-2afd7dc6a38f/go.mod h1:i4sF0l1fFnY1aiw08QQSwVAFxHEm311Me3WsU/X7nL0=
 github.com/knz/go-libedit v1.10.1/go.mod h1:MZTVkCWyz0oBc7JOWP3wNAzd002ZbM/5hgShxwh4x8M=
 github.com/konsorten/go-windows-terminal-sequences v1.0.1 h1:mweAR1A6xJ3oS2pRaGiHgQ4OO8tzTaLawm8vnODuwDk=
 github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
 github.com/leodido/go-urn v1.4.0 h1:WT9HwE9SGECu3lg4d/dIA+jxlljEa1/ffXKmRjqdmIQ=
 github.com/leodido/go-urn v1.4.0/go.mod h1:bvxc+MVxLKB4z00jd1z+Dvzr47oO32F/QSNjSBOlFxI=
 github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
@@ -64,6 +78,15 @@ github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd h1:TRLaZ9cD/w
 github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q=
 github.com/modern-go/reflect2 v1.0.2 h1:xBagoLtFs94CBntxluKeaWgTMpvLxC4ur3nMaC9Gz0M=
 github.com/modern-go/reflect2 v1.0.2/go.mod h1:yWuevngMOJpCy52FWWMvUC8ws7m/LJsjYzDa0/r8luk=
+github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e h1:fD57ERR4JtEqsWbfPhv4DMiApHyliiK5xCTNVSPiaAs=
+github.com/niemeyer/pretty v0.0.0-20200227124842-a10e7caefd8e/go.mod h1:zD1mROLANZcx1PVRCS0qkT7pwLkGfwJo4zjcN/Tysno=
+github.com/oklog/ulid/v2 v2.1.1 h1:suPZ4ARWLOJLegGFiZZ1dFAkqzhMjL3J1TzI+5wHz8s=
+github.com/oklog/ulid/v2 v2.1.1/go.mod h1:rcEKHmBBKfef9DhnvX7y1HZBYxjXb0cP5ExxNsTT1QQ=
+github.com/opencontainers/go-digest v1.0.0 h1:apOUWs51W5PlhuyGyz9FCeeBIOUDA/6nW8Oi/yOhh5U=
+github.com/opencontainers/go-digest v1.0.0/go.mod h1:0JzlMkj0TRzQZfJkVvzbP0HBR3IKzErnv2BNG4W4MAM=
+github.com/opencontainers/image-spec v1.1.1 h1:y0fUlFfIZhPF1W537XOLg0/fcx6zcHCJwooC2xJA040=
+github.com/opencontainers/image-spec v1.1.1/go.mod h1:qpqAh3Dmcf36wStyyWU+kCeDgrGnAve2nCC8+7h8Q0M=
+github.com/pborman/getopt v0.0.0-20170112200414-7148bc3a4c30/go.mod h1:85jBQOZwpVEaDAr341tbn15RS4fCAsIst0qp7i8ex1o=
 github.com/pelletier/go-toml/v2 v2.2.2 h1:aYUidT7k73Pcl9nb2gScu7NSrKCSHIDE89b3+6Wq+LM=
 github.com/pelletier/go-toml/v2 v2.2.2/go.mod h1:1t835xjRzz80PqgE6HHgN2JOsmgYu/h4qDAS4n929Rs=
 github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
@@ -72,15 +95,21 @@ github.com/redis/go-redis/v9 v9.20.1 h1:sfCU6A8P3dXbKyWes02uxA2baehGux9dZHfEKtsT
 github.com/redis/go-redis/v9 v9.20.1/go.mod h1:v/M13XI1PVCDcm01VtPFOADfZtHf8YW3baQf57KlIkA=
 github.com/robfig/cron/v3 v3.0.1 h1:WdRxkvbJztn8LMz/QEvLN5sBU+xKpSqwwUO1Pjr4qDs=
 github.com/robfig/cron/v3 v3.0.1/go.mod h1:eQICP3HwyT7UooqI/z+Ov+PtYAWygg1TEWWzGIFLtro=
+github.com/samber/lo v1.50.0 h1:XrG0xOeHs+4FQ8gJR97zDz5uOFMW7OwFWiFVzqopKgY=
+github.com/samber/lo v1.50.0/go.mod h1:RjZyNk6WSnUFRKK6EyOhsRJMqft3G+pg7dCWHQCWvsc=
+github.com/samber/oops v1.18.1 h1:qjhZbqbdyhWBKntkY8sxrDNKA8b4c5VHlmI1rli7X7M=
+github.com/samber/oops v1.18.1/go.mod h1:xYqvimigkKV70HyLXiBZJFpIWi2CGcc6Xx7eV+2HycI=
 github.com/sirupsen/logrus v1.4.2 h1:SPIRibHv4MatM3XXNO2BJeFLZwZ2LvZgfQ5+UNI2im4=
 github.com/sirupsen/logrus v1.4.2/go.mod h1:tLMulIdttU9McNUspp0xgXVQah82FyeX6MwdIuYE2rE=
 github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=
 github.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=
 github.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=
+github.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=
 github.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=
 github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=
 github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI=
+github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA=
 github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=
 github.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=
@@ -106,8 +135,14 @@ github.com/youmark/pkcs8 v0.0.0-20240726163527-a2c0da244d78/go.mod h1:aL8wCCfTfS
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
 github.com/zeebo/xxh3 v1.1.0 h1:s7DLGDK45Dyfg7++yxI0khrfwq9661w9EN78eP/UZVs=
 github.com/zeebo/xxh3 v1.1.0/go.mod h1:IisAie1LELR4xhVinxWS5+zf1lA4p0MW4T+w+W07F5s=
+go.etcd.io/bbolt v1.4.3 h1:dEadXpI6G79deX5prL3QRNP6JB8UxVkqo4UPnHaNXJo=
+go.etcd.io/bbolt v1.4.3/go.mod h1:tKQlpPaYCVFctUIgFKFnAlvbmB3tpy1vkTnDWohtc0E=
 go.mongodb.org/mongo-driver/v2 v2.8.0 h1:CxWDGQYY8QQwNjAl/aq2sfWakdnWZynnqJ9F4DhHbP8=
 go.mongodb.org/mongo-driver/v2 v2.8.0/go.mod h1:yOI9kBsufol30iFsl1slpdq1I0eHPzybRWdyYUs8K/0=
+go.opentelemetry.io/otel v1.34.0 h1:zRLXxLCgL1WyKsPVrgbSdMN4c0FMkDAskSTQP+0hdUY=
+go.opentelemetry.io/otel v1.34.0/go.mod h1:OWFPOQ+h4G8xpyjgqo4SxJYdDQ/qmRH+wivy7zzx9oI=
+go.opentelemetry.io/otel/trace v1.34.0 h1:+ouXS2V8Rd4hp4580a8q23bg0azF2nI8cqLYnC8mh/k=
+go.opentelemetry.io/otel/trace v1.34.0/go.mod h1:Svm7lSjQD7kG7KJ/MUHPVXSDGz2OX4h0M2jHBhmSfRE=
 go.uber.org/atomic v1.11.0 h1:ZvwS0R+56ePWxUNi+Atn9dWONBPp/AUETXlHW0DxSjE=
 go.uber.org/atomic v1.11.0/go.mod h1:LUxbIzbOniOlMKjJjyPfpl4v+PKK2cNJn91OQbhoJI0=
 golang.org/x/arch v0.0.0-20210923205945-b76863e36670/go.mod h1:5om86z9Hs0C8fWVUuoMHwpExlXzs5Tkyp9hOrfG7pp8=
@@ -156,10 +191,14 @@ google.golang.org/grpc v1.64.0 h1:KH3VH9y/MgNQg1dE7b3XfVK0GsPSIzJwdF617gUSbvY=
 google.golang.org/grpc v1.64.0/go.mod h1:oxjF8E3FBnjp+/gVFYdWacaLDx9na1aqy9oovLpxQYg=
 google.golang.org/protobuf v1.34.2 h1:6xV6lTsCfpGD21XK49h7MhtcApnLqkfYgPcdHftf6hg=
 google.golang.org/protobuf v1.34.2/go.mod h1:qYOHts0dSfpeUzUFpOMr/WGzszTmLH+DiWniOlNbLDw=
-gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f h1:BLraFXnmrev5lT+xlilqcH8XK9/i0At2xKjWk4p6zsU=
+gopkg.in/check.v1 v1.0.0-20200227125254-8fa46927fb4f/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=
 gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
 gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=
 nullprogram.com/x/optparse v1.0.0/go.mod h1:KdyPE+Igbe0jQUrVfMqDMeJQIJZEuyV7pjYmp6pbG50=
+oras.land/oras-go/v2 v2.6.2 h1:N04RXngAp1LJKTG6ifz3xHPipasEkWr+hFmInja5YKo=
+oras.land/oras-go/v2 v2.6.2/go.mod h1:PlTtg4JTDJkDe8yVHpM2wz7/YDc00GVas+i4jAW2TZ4=
 rsc.io/pdf v0.1.1/go.mod h1:n8OzWcQ6Sp37PL01nO98y4iUCRdTGarVfzxY20ICaU4=
@@ -119,6 +119,19 @@ func RegisterRoutes(r *gin.Engine) {
 			providers.POST("/:id/ack-notice", ackAuthProviderNotice)
 		}
 		apiGroup.GET("/auth/presets", auth.RequireRole("owner", "admin"), listAuthPresets)
+
+		apiGroup.GET("/vulnerabilities", listVulnerabilities)
+		apiGroup.GET("/vulnerabilities/summary", vulnerabilitySummary)
+		apiGroup.POST("/vulnerabilities/rescan", auth.RequireRole("owner", "admin"), rescanVulnerabilities)
+		apiGroup.POST("/vulnerabilities/:id/accept", auth.RequireRole("owner", "admin"), acceptFinding)
+		apiGroup.DELETE("/vulnerabilities/:id/accept", auth.RequireRole("owner", "admin"), unacceptFinding)
+		apiGroup.GET("/servers/:id/vulnerabilities", listServerVulnerabilities)
+		apiGroup.GET("/servers/:id/packages", getServerPackages)
+		apiGroup.GET("/packages/search", searchPackages)
+		apiGroup.GET("/vuln-rules", listVulnRules)
+		apiGroup.POST("/vuln-rules", auth.RequireRole("owner", "admin"), createVulnRule)
+		apiGroup.PUT("/vuln-rules/:id", auth.RequireRole("owner", "admin"), updateVulnRule)
+		apiGroup.DELETE("/vuln-rules/:id", auth.RequireRole("owner", "admin"), deleteVulnRule)
 	}
 }

@@ -0,0 +1,304 @@
+package api
+
+import (
+	"errors"
+	"net/http"
+	"sort"
+	"strconv"
+	"strings"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/auth"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/services"
+	"github.com/gin-gonic/gin"
+)
+
+// vulnGroup is one CVE across every server it affects.
+//
+// The board groups by CVE rather than listing findings flat: the same CVE on
+// forty servers is one decision, and a flat list makes it look like forty.
+type vulnGroup struct {
+	CVEID       string               `json:"cve_id"`
+	Severity    string               `json:"severity"`
+	Title       string               `json:"title,omitempty"`
+	ServerCount int                  `json:"server_count"`
+	Findings    []models.VulnFinding `json:"findings"`
+}
+
+func listVulnerabilities(c *gin.Context) {
+	findings, err := services.ListInstanceFindings(auth.InstanceID(c), services.FindingFilter{
+		Severity: c.Query("severity"),
+		State:    c.DefaultQuery("state", models.FindingOpen),
+		ServerID: c.Query("server"),
+		Tags:     tagsFromQuery(c),
+	})
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, groupByCVE(findings))
+}
+
+// groupByCVE collapses findings into one row per CVE, most severe first.
+func groupByCVE(findings []models.VulnFinding) []vulnGroup {
+	index := map[string]*vulnGroup{}
+	order := []string{}
+
+	for _, f := range findings {
+		g, ok := index[f.CVEID]
+		if !ok {
+			g = &vulnGroup{CVEID: f.CVEID, Severity: f.Severity, Title: f.Title}
+			index[f.CVEID] = g
+			order = append(order, f.CVEID)
+		}
+		// Several servers can disagree on severity when their distributions
+		// rate the same CVE differently. The highest is shown, because that is
+		// the one deciding whether anyone acts.
+		if models.SeverityRank(f.Severity) > models.SeverityRank(g.Severity) {
+			g.Severity = f.Severity
+		}
+		g.Findings = append(g.Findings, f)
+	}
+
+	out := make([]vulnGroup, 0, len(order))
+	for _, id := range order {
+		g := index[id]
+		servers := map[string]bool{}
+		for _, f := range g.Findings {
+			servers[f.ServerID] = true
+		}
+		g.ServerCount = len(servers)
+		out = append(out, *g)
+	}
+
+	sort.SliceStable(out, func(i, j int) bool {
+		ri, rj := models.SeverityRank(out[i].Severity), models.SeverityRank(out[j].Severity)
+		if ri != rj {
+			return ri > rj
+		}
+		return out[i].ServerCount > out[j].ServerCount
+	})
+	return out
+}
+
+// tagsFromQuery reads repeated tag=key:value parameters.
+func tagsFromQuery(c *gin.Context) map[string]string {
+	out := map[string]string{}
+	for _, raw := range c.QueryArray("tag") {
+		k, v, ok := strings.Cut(raw, ":")
+		if !ok || k == "" {
+			continue
+		}
+		out[k] = v
+	}
+	if len(out) == 0 {
+		return nil
+	}
+	return out
+}
+
+func vulnerabilitySummary(c *gin.Context) {
+	counts, err := services.CountOpenFindingsBySeverity(auth.InstanceID(c))
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	resp := gin.H{"counts": counts}
+
+	// Database freshness travels with the counts rather than living in
+	// settings: a fleet scanned against a three-week-old database must say so
+	// wherever its findings are read, not somewhere the reader has to go and
+	// look for it.
+	if meta, err := services.GetVulnDBMeta(); err == nil && meta != nil {
+		resp["db_version"] = meta.DBVersion
+		resp["pulled_at"] = meta.PulledAt
+		resp["last_full_scan_at"] = meta.LastFullScanAt
+		if meta.LastError != "" {
+			resp["last_error"] = meta.LastError
+		}
+	}
+
+	c.JSON(http.StatusOK, resp)
+}
+
+func rescanVulnerabilities(c *gin.Context) {
+	instanceID := auth.InstanceID(c)
+
+	n, err := services.MarkInstanceForRescan(instanceID)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.rescan", actorFromCtx(c), "", "",
+		"queued "+strconv.FormatInt(n, 10)+" server(s) for rescan")
+	c.JSON(http.StatusOK, gin.H{"queued": n})
+}
+
+type acceptFindingRequest struct {
+	Reason string    `json:"reason"`
+	Until  time.Time `json:"until"`
+}
+
+func acceptFinding(c *gin.Context) {
+	var req acceptFindingRequest
+	if err := c.ShouldBindJSON(&req); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "invalid request body"})
+		return
+	}
+
+	// Both rejected deliberately. An acceptance with no reason is a dismissal
+	// nobody can audit, and one already expired is a permanent dismissal
+	// wearing an expiry — the graveyard the expiry exists to prevent.
+	if strings.TrimSpace(req.Reason) == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "a reason is required"})
+		return
+	}
+	if req.Until.IsZero() || !req.Until.After(time.Now()) {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "until must be a future date"})
+		return
+	}
+
+	instanceID := auth.InstanceID(c)
+	actor := actorFromCtx(c)
+
+	f, err := services.AcceptFinding(instanceID, c.Param("id"), actor, req.Reason, req.Until)
+	if err != nil {
+		writeFindingError(c, err)
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.accepted", actor, f.ServerID, "",
+		f.CVEID+" on "+f.PackageName+" accepted until "+req.Until.Format(time.RFC3339)+": "+req.Reason)
+	c.JSON(http.StatusOK, f)
+}
+
+func unacceptFinding(c *gin.Context) {
+	instanceID := auth.InstanceID(c)
+	actor := actorFromCtx(c)
+
+	f, err := services.UnacceptFinding(instanceID, c.Param("id"))
+	if err != nil {
+		writeFindingError(c, err)
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.unaccepted", actor, f.ServerID, "",
+		f.CVEID+" on "+f.PackageName+" returned to open")
+	c.JSON(http.StatusOK, f)
+}
+
+func writeFindingError(c *gin.Context, err error) {
+	if errors.Is(err, services.ErrFindingNotFound) {
+		c.JSON(http.StatusNotFound, gin.H{"error": "finding not found"})
+		return
+	}
+	c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+}
+
+func listServerVulnerabilities(c *gin.Context) {
+	findings, err := services.ListFindings(c.Request.Context(), auth.InstanceID(c), c.Param("id"))
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	if findings == nil {
+		findings = []models.VulnFinding{}
+	}
+	c.JSON(http.StatusOK, findings)
+}
+
+func getServerPackages(c *gin.Context) {
+	sp, err := services.ListPackages(auth.InstanceID(c), c.Param("id"))
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	if sp == nil {
+		// Not a 404: an agent that has not reported yet is the normal state for
+		// the first hour after install, and is a different thing from a bad
+		// server id.
+		c.JSON(http.StatusOK, gin.H{"reported": false})
+		return
+	}
+	c.JSON(http.StatusOK, sp)
+}
+
+func searchPackages(c *gin.Context) {
+	name := c.Query("name")
+	if name == "" {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "name is required"})
+		return
+	}
+	hits, err := services.SearchPackages(auth.InstanceID(c), name)
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, hits)
+}
+
+func listVulnRules(c *gin.Context) {
+	rules, err := services.ListVulnRules(auth.InstanceID(c))
+	if err != nil {
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+	c.JSON(http.StatusOK, rules)
+}
+
+func createVulnRule(c *gin.Context) {
+	var r models.VulnAlertRule
+	if err := c.ShouldBindJSON(&r); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "invalid request body"})
+		return
+	}
+
+	instanceID := auth.InstanceID(c)
+	created, err := services.CreateVulnRule(instanceID, &r)
+	if err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.rule_created", actorFromCtx(c), "", "", "rule "+created.Name)
+	c.JSON(http.StatusCreated, created)
+}
+
+func updateVulnRule(c *gin.Context) {
+	var r models.VulnAlertRule
+	if err := c.ShouldBindJSON(&r); err != nil {
+		c.JSON(http.StatusBadRequest, gin.H{"error": "invalid request body"})
+		return
+	}
+
+	instanceID := auth.InstanceID(c)
+	if err := services.UpdateVulnRule(instanceID, c.Param("id"), &r); err != nil {
+		if errors.Is(err, services.ErrVulnRuleNotFound) {
+			c.JSON(http.StatusNotFound, gin.H{"error": "rule not found"})
+			return
+		}
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.rule_updated", actorFromCtx(c), "", "", "rule "+r.Name)
+	c.JSON(http.StatusOK, gin.H{"status": "updated"})
+}
+
+func deleteVulnRule(c *gin.Context) {
+	instanceID := auth.InstanceID(c)
+	if err := services.DeleteVulnRule(instanceID, c.Param("id")); err != nil {
+		if errors.Is(err, services.ErrVulnRuleNotFound) {
+			c.JSON(http.StatusNotFound, gin.H{"error": "rule not found"})
+			return
+		}
+		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+		return
+	}
+
+	services.LogEvent(instanceID, "vuln.rule_deleted", actorFromCtx(c), "", "", "rule "+c.Param("id"))
+	c.JSON(http.StatusOK, gin.H{"status": "deleted"})
+}
@@ -28,6 +28,45 @@ type SyncRequest struct {

 type SyncResponse struct {
 	PublicKeys []string `json:"public_keys"`
+	// CollectPackages tells the agent whether this instance's licence grants
+	// vulnerability scanning. Absent decodes as false, which is the safe
+	// direction: an older server leaves agents collecting nothing.
+	CollectPackages bool `json:"collect_packages,omitempty"`
+}
+
+type OSRelease struct {
+	Family string `json:"family"`
+	// VersionId is not optional: Ubuntu 22.04 and 24.04 publish different fixed
+	// versions for the same CVE, so a scan without it is guesswork.
+	VersionId string `json:"version_id"`
+	Arch      string `json:"arch,omitempty"`
+}
+
+type InstalledPackage struct {
+	Name    string `json:"name"`
+	Version string `json:"version"`
+	Epoch   int32  `json:"epoch,omitempty"`
+	Arch    string `json:"arch,omitempty"`
+	// SourceName is what the Debian and Ubuntu feeds are keyed on: one advisory
+	// against "openssl" covers libssl3, openssl and libssl-dev.
+	SourceName string `json:"source_name,omitempty"`
+}
+
+// ReportPackagesRequest carries a server's installed package set.
+//
+// The agent calls twice at most: first with Packages empty, offering only the
+// hash. If the server already holds it, NeedFull is false and the ~150KB body
+// is never sent.
+type ReportPackagesRequest struct {
+	ServerId   string             `json:"server_id"`
+	AgentToken string             `json:"agent_token"`
+	Hash       string             `json:"hash"`
+	Os         OSRelease          `json:"os"`
+	Packages   []InstalledPackage `json:"packages,omitempty"`
+}
+
+type ReportPackagesResponse struct {
+	NeedFull bool `json:"need_full"`
 }

 type UploadKeyRequest struct {
@@ -326,6 +365,7 @@ type VantageServer interface {
 	SyncKeys(context.Context, *SyncRequest) (*SyncResponse, error)
 	UploadGeneratedKey(context.Context, *UploadKeyRequest) (*UploadKeyResponse, error)
 	ReportUpdates(context.Context, *ReportUpdatesRequest) (*ReportUpdatesResponse, error)
+	ReportPackages(context.Context, *ReportPackagesRequest) (*ReportPackagesResponse, error)
 	ReportInventory(context.Context, *InventoryReport) (*InventoryReportResponse, error)
 	SyncMonitors(context.Context, *SyncMonitorsRequest) (*SyncMonitorsResponse, error)
 	ReportChecks(context.Context, *ReportChecksRequest) (*ReportChecksResponse, error)
@@ -351,6 +391,10 @@ func (UnimplementedVantageServer) ReportUpdates(context.Context, *ReportUpdatesR
 	return nil, status.Errorf(codes.Unimplemented, "method ReportUpdates not implemented")
 }

+func (UnimplementedVantageServer) ReportPackages(context.Context, *ReportPackagesRequest) (*ReportPackagesResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method ReportPackages not implemented")
+}
+
 func (UnimplementedVantageServer) ReportInventory(context.Context, *InventoryReport) (*InventoryReportResponse, error) {
 	return nil, status.Errorf(codes.Unimplemented, "method ReportInventory not implemented")
 }
@@ -376,6 +420,7 @@ type VantageClient interface {
 	SyncKeys(ctx context.Context, in *SyncRequest, opts ...grpc.CallOption) (*SyncResponse, error)
 	UploadGeneratedKey(ctx context.Context, in *UploadKeyRequest, opts ...grpc.CallOption) (*UploadKeyResponse, error)
 	ReportUpdates(ctx context.Context, in *ReportUpdatesRequest, opts ...grpc.CallOption) (*ReportUpdatesResponse, error)
+	ReportPackages(ctx context.Context, in *ReportPackagesRequest, opts ...grpc.CallOption) (*ReportPackagesResponse, error)
 	ReportInventory(ctx context.Context, in *InventoryReport, opts ...grpc.CallOption) (*InventoryReportResponse, error)
 	SyncMonitors(ctx context.Context, in *SyncMonitorsRequest, opts ...grpc.CallOption) (*SyncMonitorsResponse, error)
 	ReportChecks(ctx context.Context, in *ReportChecksRequest, opts ...grpc.CallOption) (*ReportChecksResponse, error)
@@ -423,6 +468,14 @@ func (c *keyManagerClient) ReportUpdates(ctx context.Context, in *ReportUpdatesR
 	return out, nil
 }

+func (c *keyManagerClient) ReportPackages(ctx context.Context, in *ReportPackagesRequest, opts ...grpc.CallOption) (*ReportPackagesResponse, error) {
+	out := new(ReportPackagesResponse)
+	if err := c.cc.Invoke(ctx, "/vantage.v1.Vantage/ReportPackages", in, out, opts...); err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
 func (c *keyManagerClient) ReportInventory(ctx context.Context, in *InventoryReport, opts ...grpc.CallOption) (*InventoryReportResponse, error) {
 	out := new(InventoryReportResponse)
 	if err := c.cc.Invoke(ctx, "/vantage.v1.Vantage/ReportInventory", in, out, opts...); err != nil {
@@ -475,6 +528,7 @@ var Vantage_ServiceDesc = grpc.ServiceDesc{
 		{MethodName: "SyncKeys", Handler: _Vantage_SyncKeys_Handler},
 		{MethodName: "UploadGeneratedKey", Handler: _Vantage_UploadGeneratedKey_Handler},
 		{MethodName: "ReportUpdates", Handler: _Vantage_ReportUpdates_Handler},
+		{MethodName: "ReportPackages", Handler: _Vantage_ReportPackages_Handler},
 		{MethodName: "ReportInventory", Handler: _Vantage_ReportInventory_Handler},
 		{MethodName: "SyncMonitors", Handler: _Vantage_SyncMonitors_Handler},
 		{MethodName: "ReportChecks", Handler: _Vantage_ReportChecks_Handler},
@@ -556,6 +610,21 @@ func _Vantage_ReportUpdates_Handler(srv interface{}, ctx context.Context, dec fu
 	return interceptor(ctx, in, info, handler)
 }

+func _Vantage_ReportPackages_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(ReportPackagesRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(VantageServer).ReportPackages(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: "/vantage.v1.Vantage/ReportPackages"}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(VantageServer).ReportPackages(ctx, req.(*ReportPackagesRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
 func _Vantage_ReportInventory_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
 	in := new(InventoryReport)
 	if err := dec(in); err != nil {
@@ -63,7 +63,13 @@ func (s *vantageServer) SyncKeys(ctx context.Context, req *pb.SyncRequest) (*pb.
 		return nil, status.Errorf(codes.Internal, "failed to build authorized keys: %v", err)
 	}

-	return &pb.SyncResponse{PublicKeys: keys}, nil
+	// Carried on the 30s key poll rather than its own RPC: the agent needs it
+	// before its hourly package report, and this is the only message it already
+	// receives that often.
+	return &pb.SyncResponse{
+		PublicKeys:      keys,
+		CollectPackages: services.VulnScanningEnabled(srv.InstanceID),
+	}, nil
 }

 func (s *vantageServer) UploadGeneratedKey(ctx context.Context, req *pb.UploadKeyRequest) (*pb.UploadKeyResponse, error) {
@@ -104,6 +110,59 @@ func (s *vantageServer) ReportUpdates(ctx context.Context, req *pb.ReportUpdates
 	return &pb.ReportUpdatesResponse{}, nil
 }

+// ReportPackages stores a server's installed package set.
+//
+// It does NOT match against the vulnerability database. Matching happens in
+// vulnsched, on the leader: every replica would otherwise need the ~50MB
+// database resident, and a database refresh would have N replicas racing to
+// rescan the same fleet and sending N digests to the customer.
+func (s *vantageServer) ReportPackages(ctx context.Context, req *pb.ReportPackagesRequest) (*pb.ReportPackagesResponse, error) {
+	srv, err := services.ValidateAgentToken(req.ServerId, req.AgentToken)
+	if err != nil {
+		return nil, status.Errorf(codes.Unauthenticated, "invalid agent token")
+	}
+
+	// The agent's collect_packages flag is an optimisation; this is the
+	// boundary. An agent that ignores the flag still stores nothing.
+	if !services.VulnScanningEnabled(srv.InstanceID) {
+		return &pb.ReportPackagesResponse{NeedFull: false}, nil
+	}
+
+	// The offer call: a hash and no packages. Answering NeedFull=false here is
+	// what saves the ~150KB body on the overwhelming majority of reports.
+	if len(req.Packages) == 0 {
+		known, err := services.HasPackageHash(srv.InstanceID, srv.ServerID, req.Hash)
+		if err != nil {
+			log.Printf("package hash lookup for %s: %v", srv.ServerID, err)
+			return nil, status.Errorf(codes.Internal, "package hash lookup failed")
+		}
+		return &pb.ReportPackagesResponse{NeedFull: !known}, nil
+	}
+
+	pkgs := make([]models.InstalledPackage, len(req.Packages))
+	for i, p := range req.Packages {
+		pkgs[i] = models.InstalledPackage{
+			Name:       p.Name,
+			Version:    p.Version,
+			Epoch:      int(p.Epoch),
+			Arch:       p.Arch,
+			SourceName: p.SourceName,
+		}
+	}
+
+	os := models.OSRelease{
+		Family:    req.Os.Family,
+		VersionID: req.Os.VersionId,
+		Arch:      req.Os.Arch,
+	}
+
+	if err := services.StorePackages(srv.InstanceID, srv.ServerID, os, req.Hash, pkgs); err != nil {
+		log.Printf("store packages for %s: %v", srv.ServerID, err)
+		return nil, status.Errorf(codes.Internal, "failed to store packages")
+	}
+	return &pb.ReportPackagesResponse{NeedFull: false}, nil
+}
+
 func (s *vantageServer) ReportInventory(ctx context.Context, req *pb.InventoryReport) (*pb.InventoryReportResponse, error) {
 	srv, err := services.ValidateAgentToken(req.ServerId, req.AgentToken)
 	if err != nil {
@@ -0,0 +1,52 @@
+package models
+
+import (
+	"time"
+
+	"go.mongodb.org/mongo-driver/v2/bson"
+)
+
+// Scan status values for ServerPackages.
+const (
+	ScanStatusOK          = "ok"
+	ScanStatusUnsupported = "unsupported"
+)
+
+type OSRelease struct {
+	Family    string `bson:"family" json:"family"`
+	VersionID string `bson:"version_id" json:"version_id"`
+	Arch      string `bson:"arch" json:"arch"`
+}
+
+type InstalledPackage struct {
+	Name    string `bson:"name" json:"name"`
+	Version string `bson:"version" json:"version"`
+	Epoch   int    `bson:"epoch,omitempty" json:"epoch,omitempty"`
+	Arch    string `bson:"arch" json:"arch"`
+	// SourceName is what the Debian and Ubuntu feeds are keyed on. One advisory
+	// against "openssl" covers the binaries libssl3, openssl and libssl-dev;
+	// matching on binary name alone finds one of the three.
+	SourceName string `bson:"source_name,omitempty" json:"source_name,omitempty"`
+}
+
+// ServerPackages holds one server's whole package set in ONE document rather
+// than one document per package. The hash has already established that
+// something changed, so a report is a single atomic upsert with no delta logic
+// to get wrong. A typical Linux host is ~2000 packages and ~150KB, comfortably
+// inside the 16MB document limit.
+type ServerPackages struct {
+	ID          bson.ObjectID      `bson:"_id,omitempty" json:"-"`
+	InstanceID  string             `bson:"instance_id" json:"-"`
+	ServerID    string             `bson:"server_id" json:"server_id"`
+	OS          OSRelease          `bson:"os" json:"os"`
+	Hash        string             `bson:"hash" json:"hash"`
+	Packages    []InstalledPackage `bson:"packages" json:"packages"`
+	CollectedAt time.Time          `bson:"collected_at" json:"collected_at"`
+	ScanPending bool               `bson:"scan_pending" json:"scan_pending"`
+	ScannedAt   time.Time          `bson:"scanned_at,omitempty" json:"scanned_at,omitempty"`
+	// Status distinguishes a scanned host from one whose distribution we hold
+	// no feed for. Reporting zero findings for an unsupported distribution is
+	// indistinguishable from reporting a clean host, and one of those is a lie.
+	Status    string `bson:"status" json:"status"`
+	DBVersion int    `bson:"db_version" json:"db_version"`
+}
@@ -0,0 +1,109 @@
+package models
+
+import (
+	"time"
+
+	"go.mongodb.org/mongo-driver/v2/bson"
+)
+
+// Finding states.
+const (
+	FindingOpen     = "open"
+	FindingFixed    = "fixed"
+	FindingAccepted = "accepted"
+)
+
+// Severities. Lowercase and fixed; SeverityRank orders them.
+const (
+	SeverityUnknown  = "unknown"
+	SeverityLow      = "low"
+	SeverityMedium   = "medium"
+	SeverityHigh     = "high"
+	SeverityCritical = "critical"
+)
+
+// SeverityRank orders severities for threshold comparisons. An unrecognised
+// value ranks lowest rather than panicking: severity comes from a third-party
+// feed, and an unexpected string must not stop a scan.
+func SeverityRank(s string) int {
+	switch s {
+	case SeverityCritical:
+		return 4
+	case SeverityHigh:
+		return 3
+	case SeverityMedium:
+		return 2
+	case SeverityLow:
+		return 1
+	default:
+		return 0
+	}
+}
+
+// Acceptance records a decision someone will be asked to justify, so who, why
+// and until when all live on the document as well as in the audit log.
+type Acceptance struct {
+	By     string    `bson:"by" json:"by"`
+	Reason string    `bson:"reason" json:"reason"`
+	Until  time.Time `bson:"until" json:"until"`
+	At     time.Time `bson:"at" json:"at"`
+}
+
+// VulnFinding is one vulnerable package on one server.
+//
+// Findings are never deleted when a package is patched: the state moves to
+// "fixed" with FixedAt stamped, which is what keeps "what did we remediate last
+// quarter" answerable.
+type VulnFinding struct {
+	ID         bson.ObjectID `bson:"_id,omitempty" json:"id"`
+	InstanceID string        `bson:"instance_id" json:"-"`
+	ServerID   string        `bson:"server_id" json:"server_id"`
+
+	CVEID       string `bson:"cve_id" json:"cve_id"`
+	PackageName string `bson:"package_name" json:"package_name"`
+	Installed   string `bson:"installed_version" json:"installed_version"`
+	// FixedIn empty means no vendor fix has been published. That is a real and
+	// common state and must never be conflated with "not vulnerable" — it is
+	// the finding most in need of acceptance, since there is nothing to patch.
+	FixedIn    string   `bson:"fixed_in,omitempty" json:"fixed_in,omitempty"`
+	Severity   string   `bson:"severity" json:"severity"`
+	CVSSScore  float64  `bson:"cvss_score,omitempty" json:"cvss_score,omitempty"`
+	Title      string   `bson:"title,omitempty" json:"title,omitempty"`
+	References []string `bson:"references,omitempty" json:"references,omitempty"`
+
+	State     string      `bson:"state" json:"state"`
+	FirstSeen time.Time   `bson:"first_seen" json:"first_seen"`
+	LastSeen  time.Time   `bson:"last_seen" json:"last_seen"`
+	FixedAt   *time.Time  `bson:"fixed_at,omitempty" json:"fixed_at,omitempty"`
+	Accepted  *Acceptance `bson:"accepted,omitempty" json:"accepted,omitempty"`
+}
+
+// VulnDBMeta is a singleton and deliberately carries no instance_id: the
+// vulnerability database is a property of the deployment, not of a tenant.
+// Same reasoning as the migrations collection, and the reason vulndb_meta is
+// absent from ScopedCollections.
+type VulnDBMeta struct {
+	ID             bson.ObjectID `bson:"_id,omitempty" json:"-"`
+	DBVersion      int           `bson:"db_version" json:"db_version"`
+	PulledAt       time.Time     `bson:"pulled_at" json:"pulled_at"`
+	LastFullScanAt time.Time     `bson:"last_full_scan_at,omitempty" json:"last_full_scan_at,omitempty"`
+	LastError      string        `bson:"last_error,omitempty" json:"last_error,omitempty"`
+}
+
+// VulnAlertRule routes newly opened findings to notification channels.
+//
+// Tags resolve through services.ResolveTargets rather than a second matcher:
+// that function is already the single answer to which servers a selector
+// touches, and a rule disagreeing with a workflow about what env:prod means
+// would be worse than having no filter.
+type VulnAlertRule struct {
+	ID          bson.ObjectID     `bson:"_id,omitempty" json:"id"`
+	InstanceID  string            `bson:"instance_id" json:"-"`
+	Name        string            `bson:"name" json:"name"`
+	Enabled     bool              `bson:"enabled" json:"enabled"`
+	MinSeverity string            `bson:"min_severity" json:"min_severity"`
+	Tags        map[string]string `bson:"tags,omitempty" json:"tags,omitempty"`
+	ChannelIDs  []string          `bson:"channel_ids" json:"channel_ids"`
+	CreatedAt   time.Time         `bson:"created_at" json:"created_at"`
+	UpdatedAt   time.Time         `bson:"updated_at" json:"updated_at"`
+}
@@ -26,7 +26,11 @@ func (e Event) title() string {
 		verb = "is DOWN"
 	}
 	var s string
-	if e.Type == TypeServer {
+	if e.Type == TypeVuln {
+		// A digest is not a transition. MonitorName already carries the whole
+		// headline ("12 new critical across 4 servers"), so no verb applies.
+		s = fmt.Sprintf("[Vantage] %s", e.MonitorName)
+	} else if e.Type == TypeServer {
 		if e.NewStatus == models.StatusDown {
 			verb = "went offline"
 		} else {
@@ -0,0 +1,83 @@
+package notify
+
+import (
+	"fmt"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/shared/mail"
+)
+
+// TypeVuln marks an event whose subject is a batch of new vulnerability
+// findings rather than a state transition. It exists so title() does not
+// describe a digest as something going "DOWN".
+const TypeVuln = "vulnerability"
+
+// VulnDigest is one batch of newly opened findings, ready to send.
+//
+// One per rule per scan, never one per finding: a database refresh can open
+// several hundred at once, and a message each would rate-limit the webhook or
+// get the channel muted — either way the alerts stop being read.
+type VulnDigest struct {
+	InstanceName string
+	RuleName     string
+	Summary      string
+	TopSeverity  string
+	Count        int
+	Rows         []mail.VulnDigestRow
+	More         int
+	DBAge        string
+}
+
+// DispatchVulnDigest delivers a digest over one channel.
+//
+// SMTP gets its own template so a vulnerability digest does not arrive dressed
+// as a monitor alert. The other four transports carry short text, so they reuse
+// the existing Event path rather than growing a second payload shape per
+// transport.
+func DispatchVulnDigest(ch models.NotificationChannel, d VulnDigest) error {
+	if ch.Type == models.ChannelSMTP {
+		to := ch.Config["to"]
+		sender := mail.Sender{
+			Host:     ch.Config["host"],
+			Port:     ch.Config["port"],
+			From:     ch.Config["from"],
+			Username: ch.Config["username"],
+			Password: ch.Config["password"],
+		}
+		if !sender.Enabled() || sender.Port == "" || to == "" {
+			return fmt.Errorf("smtp: missing host/port/from/to")
+		}
+		return sender.SendVulnDigest(to, mail.VulnDigest{
+			InstanceName: d.InstanceName,
+			Count:        d.Count,
+			TopSeverity:  d.TopSeverity,
+			Summary:      d.Summary,
+			Rows:         d.Rows,
+			More:         d.More,
+			DBAge:        d.DBAge,
+		})
+	}
+
+	return Dispatch(ch, Event{
+		MonitorName: d.Summary,
+		Type:        TypeVuln,
+		Message:     vulnLines(d),
+	})
+}
+
+// vulnLines renders the finding list for the text-only transports, capped by
+// whatever the caller already put in Rows.
+func vulnLines(d VulnDigest) string {
+	var s string
+	for _, r := range d.Rows {
+		fix := "no fix published"
+		if r.FixedIn != "" {
+			fix = "fixed in " + r.FixedIn
+		}
+		s += fmt.Sprintf("\n• %s (%s) — %s on %s, %s", r.CVEID, r.Severity, r.PackageName, r.ServerName, fix)
+	}
+	if d.More > 0 {
+		s += fmt.Sprintf("\n…and %d more.", d.More)
+	}
+	return s
+}
@@ -0,0 +1,420 @@
+package services
+
+import (
+	"context"
+	"errors"
+	"log"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/db"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/vulndb"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+// FindingDiff is what one server's scan changes.
+type FindingDiff struct {
+	Upserts   []models.VulnFinding
+	FixedIDs  []bson.ObjectID
+	ReopenIDs []bson.ObjectID
+	// NewlyOpened is what the digest reports: findings that were not open
+	// before this scan. A finding that was already open must not re-alert every
+	// tick, or the digest becomes noise and stops being read.
+	NewlyOpened []models.VulnFinding
+}
+
+func findingKey(cveID, pkg string) string { return cveID + "\x00" + pkg }
+
+// DiffFindings computes the state changes for one server's scan.
+//
+// Pure by design: no database, no clock of its own. The ordering below is
+// load-bearing — see the comment above the second loop.
+func DiffFindings(existing []models.VulnFinding, results []vulndb.Result, now time.Time) FindingDiff {
+	var d FindingDiff
+
+	byKey := make(map[string]models.VulnFinding, len(existing))
+	for _, f := range existing {
+		byKey[findingKey(f.CVEID, f.PackageName)] = f
+	}
+
+	seen := make(map[string]bool, len(results))
+	for _, r := range results {
+		key := findingKey(r.CVEID, r.PackageName)
+		seen[key] = true
+
+		prev, had := byKey[key]
+
+		f := models.VulnFinding{
+			CVEID:       r.CVEID,
+			PackageName: r.PackageName,
+			Installed:   r.Installed,
+			FixedIn:     r.FixedIn,
+			Severity:    r.Severity,
+			State:       models.FindingOpen,
+			FirstSeen:   now,
+			LastSeen:    now,
+		}
+
+		if had {
+			f.ID = prev.ID
+			// Preserved, never overwritten: an upsert that moves first_seen
+			// forward makes every finding look discovered today.
+			f.FirstSeen = prev.FirstSeen
+
+			// A live acceptance survives the scan untouched: it is suppressed
+			// from counts and alerts until its expiry, then reopens on its own.
+			if prev.State == models.FindingAccepted && prev.Accepted != nil {
+				if now.Before(prev.Accepted.Until) {
+					continue
+				}
+				d.ReopenIDs = append(d.ReopenIDs, prev.ID)
+				continue
+			}
+
+			if prev.State != models.FindingOpen {
+				d.NewlyOpened = append(d.NewlyOpened, f)
+			}
+		} else {
+			d.NewlyOpened = append(d.NewlyOpened, f)
+		}
+
+		d.Upserts = append(d.Upserts, f)
+	}
+
+	// Anything we hold that this scan did not produce is fixed. This runs AFTER
+	// the loop above, and the ordering matters: a finding that is both absent
+	// and past its acceptance expiry must settle as fixed rather than reopening
+	// on a package that no longer carries it.
+	for _, f := range existing {
+		if seen[findingKey(f.CVEID, f.PackageName)] {
+			continue
+		}
+		if f.State == models.FindingFixed {
+			continue
+		}
+		d.FixedIDs = append(d.FixedIDs, f.ID)
+	}
+
+	return d
+}
+
+// ErrFindingNotFound is returned for a finding that does not exist in this
+// instance. Callers turn it into a 404 — never a 403, which would confirm the
+// finding exists in someone else's instance.
+var ErrFindingNotFound = errors.New("finding not found")
+
+// FindingFilter narrows a fleet-wide finding query. An empty field is no
+// filter.
+type FindingFilter struct {
+	Severity string
+	State    string
+	ServerID string
+	Tags     map[string]string
+}
+
+// ListInstanceFindings returns findings across the whole fleet.
+func ListInstanceFindings(instanceID string, f FindingFilter) ([]models.VulnFinding, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
+	defer cancel()
+
+	filter := bson.M{"instance_id": instanceID}
+	if f.State != "" {
+		filter["state"] = f.State
+	}
+	if f.Severity != "" {
+		filter["severity"] = f.Severity
+	}
+	if f.ServerID != "" {
+		filter["server_id"] = f.ServerID
+	}
+
+	// The tag selector resolves through ResolveTargets, the single answer to
+	// which servers a selector touches. A second matcher here could disagree
+	// with what a workflow means by env:prod.
+	if len(f.Tags) > 0 {
+		servers, err := ResolveTargets(instanceID, nil, f.Tags)
+		if err != nil {
+			return nil, err
+		}
+		ids := make([]string, 0, len(servers))
+		for _, s := range servers {
+			ids = append(ids, s.ServerID)
+		}
+		if len(ids) == 0 {
+			return []models.VulnFinding{}, nil
+		}
+		filter["server_id"] = bson.M{"$in": ids}
+	}
+
+	cur, err := db.Col("vuln_findings").Find(ctx, filter)
+	if err != nil {
+		return nil, err
+	}
+	defer cur.Close(ctx)
+
+	out := []models.VulnFinding{}
+	if err := cur.All(ctx, &out); err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+// CountOpenFindingsBySeverity powers the summary tiles. Accepted findings are
+// excluded: they are suppressed from counts until their expiry, which is the
+// whole point of accepting one.
+func CountOpenFindingsBySeverity(instanceID string) (map[string]int, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
+	defer cancel()
+
+	cur, err := db.Col("vuln_findings").Aggregate(ctx, []bson.M{
+		{"$match": bson.M{"instance_id": instanceID, "state": models.FindingOpen}},
+		{"$group": bson.M{"_id": "$severity", "n": bson.M{"$sum": 1}}},
+	})
+	if err != nil {
+		return nil, err
+	}
+	defer cur.Close(ctx)
+
+	var rows []struct {
+		Severity string `bson:"_id"`
+		N        int    `bson:"n"`
+	}
+	if err := cur.All(ctx, &rows); err != nil {
+		return nil, err
+	}
+
+	counts := map[string]int{}
+	for _, r := range rows {
+		counts[r.Severity] = r.N
+	}
+	return counts, nil
+}
+
+// MarkInstanceForRescan flags every server in an instance for rescanning and
+// returns how many were flagged.
+//
+// It does not scan. vulnsched picks the flags up on its next tick, which keeps
+// matching on the leader and means this endpoint cannot become a second
+// scanning path.
+func MarkInstanceForRescan(instanceID string) (int64, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 15*time.Second)
+	defer cancel()
+
+	res, err := db.Col("server_packages").UpdateMany(ctx,
+		bson.M{"instance_id": instanceID},
+		bson.M{"$set": bson.M{"scan_pending": true}},
+	)
+	if err != nil {
+		return 0, err
+	}
+	return res.ModifiedCount, nil
+}
+
+// AcceptFinding suppresses a finding until a date, with a reason.
+//
+// The expiry is mandatory at the API layer. A finding reopens on its own when
+// it passes, which is what stops the accepted list becoming where risk goes to
+// be forgotten.
+func AcceptFinding(instanceID, findingID, actor, reason string, until time.Time) (*models.VulnFinding, error) {
+	id, err := bson.ObjectIDFromHex(findingID)
+	if err != nil {
+		return nil, ErrFindingNotFound
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	var f models.VulnFinding
+	err = db.Col("vuln_findings").FindOneAndUpdate(ctx,
+		bson.M{"_id": id, "instance_id": instanceID},
+		bson.M{"$set": bson.M{
+			"state": models.FindingAccepted,
+			"accepted": models.Acceptance{
+				By:     actor,
+				Reason: reason,
+				Until:  until,
+				At:     time.Now(),
+			},
+		}},
+		options.FindOneAndUpdate().SetReturnDocument(options.After),
+	).Decode(&f)
+	if err == mongo.ErrNoDocuments {
+		return nil, ErrFindingNotFound
+	}
+	if err != nil {
+		return nil, err
+	}
+	return &f, nil
+}
+
+// UnacceptFinding returns an accepted finding to open before its expiry.
+func UnacceptFinding(instanceID, findingID string) (*models.VulnFinding, error) {
+	id, err := bson.ObjectIDFromHex(findingID)
+	if err != nil {
+		return nil, ErrFindingNotFound
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	var f models.VulnFinding
+	err = db.Col("vuln_findings").FindOneAndUpdate(ctx,
+		bson.M{"_id": id, "instance_id": instanceID},
+		bson.M{
+			"$set":   bson.M{"state": models.FindingOpen},
+			"$unset": bson.M{"accepted": ""},
+		},
+		options.FindOneAndUpdate().SetReturnDocument(options.After),
+	).Decode(&f)
+	if err == mongo.ErrNoDocuments {
+		return nil, ErrFindingNotFound
+	}
+	if err != nil {
+		return nil, err
+	}
+	return &f, nil
+}
+
+// ListFindings returns every finding held for one server.
+func ListFindings(ctx context.Context, instanceID, serverID string) ([]models.VulnFinding, error) {
+	cur, err := db.Col("vuln_findings").Find(ctx, bson.M{
+		"instance_id": instanceID,
+		"server_id":   serverID,
+	})
+	if err != nil {
+		return nil, err
+	}
+	defer cur.Close(ctx)
+
+	var out []models.VulnFinding
+	if err := cur.All(ctx, &out); err != nil {
+		return nil, err
+	}
+	return out, nil
+}
+
+// ApplyFindingDiff writes a diff. Thin on purpose — the logic worth reading
+// twice is all in DiffFindings.
+func ApplyFindingDiff(ctx context.Context, instanceID, serverID string, d FindingDiff, now time.Time) error {
+	col := db.Col("vuln_findings")
+
+	for _, f := range d.Upserts {
+		_, err := col.UpdateOne(ctx,
+			bson.M{
+				"instance_id":  instanceID,
+				"server_id":    serverID,
+				"cve_id":       f.CVEID,
+				"package_name": f.PackageName,
+			},
+			bson.M{
+				"$set": bson.M{
+					"installed_version": f.Installed,
+					"fixed_in":          f.FixedIn,
+					"severity":          f.Severity,
+					"state":             models.FindingOpen,
+					"last_seen":         now,
+				},
+				// first_seen is written only on insert, so a rescan cannot move
+				// it forward.
+				"$setOnInsert": bson.M{
+					"instance_id":  instanceID,
+					"server_id":    serverID,
+					"cve_id":       f.CVEID,
+					"package_name": f.PackageName,
+					"first_seen":   f.FirstSeen,
+				},
+				"$unset": bson.M{"fixed_at": "", "accepted": ""},
+			},
+			options.UpdateOne().SetUpsert(true),
+		)
+		if err != nil {
+			return err
+		}
+	}
+
+	if len(d.FixedIDs) > 0 {
+		if _, err := col.UpdateMany(ctx,
+			bson.M{"_id": bson.M{"$in": d.FixedIDs}},
+			bson.M{"$set": bson.M{"state": models.FindingFixed, "fixed_at": now}},
+		); err != nil {
+			return err
+		}
+	}
+
+	if len(d.ReopenIDs) > 0 {
+		if _, err := col.UpdateMany(ctx,
+			bson.M{"_id": bson.M{"$in": d.ReopenIDs}},
+			bson.M{"$set": bson.M{"state": models.FindingOpen, "last_seen": now}, "$unset": bson.M{"accepted": ""}},
+		); err != nil {
+			return err
+		}
+	}
+
+	return nil
+}
+
+// StartVulnSweeper deletes old FIXED findings. Open and accepted findings are
+// never swept at any setting: retention is about history, and an unresolved
+// vulnerability is not history.
+func StartVulnSweeper(ctx context.Context) {
+	go func() {
+		ticker := time.NewTicker(6 * time.Hour)
+		defer ticker.Stop()
+		for {
+			select {
+			case <-ctx.Done():
+				return
+			case <-ticker.C:
+				sweepFixedFindings(ctx)
+			}
+		}
+	}()
+}
+
+// defaultVulnRetentionDays is what an unset setting means. A pointer field and
+// this constant together give absent-means-90 and 0-means-forever, the same
+// shape as workflow log retention.
+const defaultVulnRetentionDays = 90
+
+// sweepFixedFindings deletes fixed findings past each instance's retention.
+//
+// Only "fixed" is ever swept. An open or accepted finding is not history, it is
+// an outstanding decision, and deleting one on a timer would quietly shrink the
+// fleet's risk picture.
+func sweepFixedFindings(ctx context.Context) {
+	instanceIDs, err := ListInstanceIDs()
+	if err != nil {
+		log.Printf("vuln sweeper: list instances: %v", err)
+		return
+	}
+
+	for _, instanceID := range instanceIDs {
+		if ctx.Err() != nil {
+			return
+		}
+
+		days := defaultVulnRetentionDays
+		if s, err := GetSettings(instanceID); err == nil && s != nil && s.VulnFindingRetentionDays != nil {
+			days = *s.VulnFindingRetentionDays
+		}
+		if days <= 0 {
+			continue // 0 means keep forever
+		}
+
+		cutoff := time.Now().AddDate(0, 0, -days)
+		res, err := db.Col("vuln_findings").DeleteMany(ctx, bson.M{
+			"instance_id": instanceID,
+			"state":       models.FindingFixed,
+			"fixed_at":    bson.M{"$lt": cutoff},
+		})
+		if err != nil {
+			log.Printf("vuln sweeper: delete for %s: %v", instanceID, err)
+			continue
+		}
+		if res.DeletedCount > 0 {
+			log.Printf("vuln sweeper: removed %d fixed findings for %s", res.DeletedCount, instanceID)
+		}
+	}
+}
@@ -40,6 +40,9 @@ var ScopedCollections = []string{
 	"console_sessions",
 	"audit_logs",
 	"auth_providers",
+	"server_packages",
+	"vuln_findings",
+	"vuln_alert_rules",
 }

 // collectionRenames maps the two collections whose names change. Ordered so the
@@ -0,0 +1,121 @@
+package services
+
+import (
+	"context"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/db"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/shared/license"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+// VulnScanningEnabled reports whether this instance may collect packages.
+//
+// It reads the feature by name from shared/license and never switches on tier,
+// so changing what a tier includes needs no server release. A lapsed licence
+// collects nothing: there is no point accumulating inventory an instance cannot
+// act on.
+func VulnScanningEnabled(instanceID string) bool {
+	st := GetLicenseState(instanceID)
+	return st.Active() && st.Feature(license.FeatureVulnScanning)
+}
+
+// HasPackageHash reports whether we already hold this exact package set, which
+// is what lets the agent skip sending ~150KB it has already sent.
+func HasPackageHash(instanceID, serverID, hash string) (bool, error) {
+	err := db.Col("server_packages").FindOne(context.Background(), bson.M{
+		"instance_id": instanceID,
+		"server_id":   serverID,
+		"hash":        hash,
+	}, options.FindOne().SetProjection(bson.M{"_id": 1})).Err()
+	if err == mongo.ErrNoDocuments {
+		return false, nil
+	}
+	if err != nil {
+		return false, err
+	}
+	return true, nil
+}
+
+// StorePackages replaces a server's package set and marks it for scanning.
+//
+// It deliberately does NOT match against the vulnerability database. Matching
+// happens in vulnsched, on the leader, for two reasons: every replica would
+// otherwise need the ~50MB database resident, and a database refresh would have
+// N replicas racing to rescan the same fleet and sending N digests.
+func StorePackages(instanceID, serverID string, os models.OSRelease, hash string, pkgs []models.InstalledPackage) error {
+	now := time.Now()
+	_, err := db.Col("server_packages").UpdateOne(context.Background(),
+		bson.M{"instance_id": instanceID, "server_id": serverID},
+		bson.M{"$set": bson.M{
+			"os":           os,
+			"hash":         hash,
+			"packages":     pkgs,
+			"collected_at": now,
+			"scan_pending": true,
+		}},
+		options.UpdateOne().SetUpsert(true),
+	)
+	return err
+}
+
+// ListPackages returns a server's stored package set, or nil when the agent has
+// not reported yet. A missing document is not an error: an agent that has never
+// reported is the normal state for the first hour after install.
+func ListPackages(instanceID, serverID string) (*models.ServerPackages, error) {
+	var sp models.ServerPackages
+	err := db.Col("server_packages").FindOne(context.Background(), bson.M{
+		"instance_id": instanceID,
+		"server_id":   serverID,
+	}).Decode(&sp)
+	if err == mongo.ErrNoDocuments {
+		return nil, nil
+	}
+	if err != nil {
+		return nil, err
+	}
+	return &sp, nil
+}
+
+// PackageHit is one server running one package.
+type PackageHit struct {
+	ServerID string `json:"server_id"`
+	Name     string `json:"name"`
+	Version  string `json:"version"`
+}
+
+// SearchPackages answers "which servers run package X" across the fleet — the
+// question people actually ask during an incident.
+//
+// The Mongo filter narrows to documents containing the name; the second pass is
+// needed because a multikey match returns the whole document, not the matching
+// array element.
+func SearchPackages(instanceID, name string) ([]PackageHit, error) {
+	ctx := context.Background()
+	cur, err := db.Col("server_packages").Find(ctx, bson.M{
+		"instance_id":   instanceID,
+		"packages.name": name,
+	}, options.Find().SetProjection(bson.M{"server_id": 1, "packages": 1}))
+	if err != nil {
+		return nil, err
+	}
+	defer cur.Close(ctx)
+
+	var docs []models.ServerPackages
+	if err := cur.All(ctx, &docs); err != nil {
+		return nil, err
+	}
+
+	hits := []PackageHit{}
+	for _, d := range docs {
+		for _, p := range d.Packages {
+			if p.Name == name {
+				hits = append(hits, PackageHit{ServerID: d.ServerID, Name: p.Name, Version: p.Version})
+			}
+		}
+	}
+	return hits, nil
+}
@@ -0,0 +1,62 @@
+package services
+
+import (
+	"context"
+	"log"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/db"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+// EnsureVulnIndexes declares the indexes for package inventory and findings.
+//
+// It warns rather than being fatal, matching EnsureSecretIndexes and
+// EnsureWorkflowIndexes: a missing index degrades these queries to a collection
+// scan, which is no reason to refuse to serve the fleet.
+func EnsureVulnIndexes() error {
+	ctx := context.Background()
+
+	pkgIdx := []mongo.IndexModel{
+		{
+			Keys:    bson.D{{Key: "instance_id", Value: 1}, {Key: "server_id", Value: 1}},
+			Options: options.Index().SetUnique(true),
+		},
+		// Multikey, for fleet-wide package search: "who runs openssl 3.0.2?"
+		{Keys: bson.D{{Key: "instance_id", Value: 1}, {Key: "packages.name", Value: 1}}},
+		// The scheduler's only query. Deliberately unscoped: it sweeps the whole
+		// deployment on the leader, not one tenant.
+		{Keys: bson.D{{Key: "scan_pending", Value: 1}}},
+	}
+	if _, err := db.Col("server_packages").Indexes().CreateMany(ctx, pkgIdx); err != nil {
+		log.Printf("warning: server_packages indexes: %v", err)
+	}
+
+	findingIdx := []mongo.IndexModel{
+		{
+			// This key is what makes a rescan an idempotent upsert rather than a
+			// duplicate factory, and what lets first_seen survive a rescan.
+			Keys: bson.D{
+				{Key: "instance_id", Value: 1},
+				{Key: "server_id", Value: 1},
+				{Key: "cve_id", Value: 1},
+				{Key: "package_name", Value: 1},
+			},
+			Options: options.Index().SetUnique(true),
+		},
+		{Keys: bson.D{{Key: "instance_id", Value: 1}, {Key: "state", Value: 1}, {Key: "severity", Value: 1}}},
+		{Keys: bson.D{{Key: "instance_id", Value: 1}, {Key: "cve_id", Value: 1}}},
+	}
+	if _, err := db.Col("vuln_findings").Indexes().CreateMany(ctx, findingIdx); err != nil {
+		log.Printf("warning: vuln_findings indexes: %v", err)
+	}
+
+	if _, err := db.Col("vuln_alert_rules").Indexes().CreateOne(ctx, mongo.IndexModel{
+		Keys: bson.D{{Key: "instance_id", Value: 1}},
+	}); err != nil {
+		log.Printf("warning: vuln_alert_rules indexes: %v", err)
+	}
+
+	return nil
+}
@@ -0,0 +1,363 @@
+package services
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"sort"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/db"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/notify"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/shared/mail"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+)
+
+// digestRowLimit caps how many findings a single digest lists by name. The
+// remainder is summarised as a count: a webhook payload holding six hundred
+// rows is not a notification, it is a report nobody reads in a chat client.
+const digestRowLimit = 20
+
+// ErrVulnRuleNotFound is returned for a rule that does not exist in this
+// instance. Callers turn it into a 404.
+var ErrVulnRuleNotFound = fmt.Errorf("vulnerability alert rule not found")
+
+func ListVulnRules(instanceID string) ([]models.VulnAlertRule, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	cur, err := db.Col("vuln_alert_rules").Find(ctx, bson.M{"instance_id": instanceID})
+	if err != nil {
+		return nil, err
+	}
+	defer cur.Close(ctx)
+
+	rules := []models.VulnAlertRule{}
+	if err := cur.All(ctx, &rules); err != nil {
+		return nil, err
+	}
+	return rules, nil
+}
+
+func CreateVulnRule(instanceID string, r *models.VulnAlertRule) (*models.VulnAlertRule, error) {
+	if err := validateVulnRule(instanceID, r); err != nil {
+		return nil, err
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	r.ID = bson.NewObjectID()
+	r.InstanceID = instanceID
+	r.CreatedAt = time.Now()
+	r.UpdatedAt = r.CreatedAt
+
+	if _, err := db.Col("vuln_alert_rules").InsertOne(ctx, r); err != nil {
+		return nil, err
+	}
+	return r, nil
+}
+
+func UpdateVulnRule(instanceID, ruleID string, r *models.VulnAlertRule) error {
+	if err := validateVulnRule(instanceID, r); err != nil {
+		return err
+	}
+
+	id, err := bson.ObjectIDFromHex(ruleID)
+	if err != nil {
+		return ErrVulnRuleNotFound
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	res, err := db.Col("vuln_alert_rules").UpdateOne(ctx,
+		bson.M{"_id": id, "instance_id": instanceID},
+		bson.M{"$set": bson.M{
+			"name":         r.Name,
+			"enabled":      r.Enabled,
+			"min_severity": r.MinSeverity,
+			"tags":         r.Tags,
+			"channel_ids":  r.ChannelIDs,
+			"updated_at":   time.Now(),
+		}},
+	)
+	if err != nil {
+		return err
+	}
+	if res.MatchedCount == 0 {
+		return ErrVulnRuleNotFound
+	}
+	return nil
+}
+
+func DeleteVulnRule(instanceID, ruleID string) error {
+	id, err := bson.ObjectIDFromHex(ruleID)
+	if err != nil {
+		return ErrVulnRuleNotFound
+	}
+
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	res, err := db.Col("vuln_alert_rules").DeleteOne(ctx, bson.M{"_id": id, "instance_id": instanceID})
+	if err != nil {
+		return err
+	}
+	if res.DeletedCount == 0 {
+		return ErrVulnRuleNotFound
+	}
+	return nil
+}
+
+// validateVulnRule rejects a rule that could never fire, and one naming a
+// channel from another instance. The channel check reuses validateChannelIDs so
+// there is one answer to "is this channel mine".
+func validateVulnRule(instanceID string, r *models.VulnAlertRule) error {
+	if r.Name == "" {
+		return fmt.Errorf("name is required")
+	}
+	switch r.MinSeverity {
+	case models.SeverityUnknown, models.SeverityLow, models.SeverityMedium,
+		models.SeverityHigh, models.SeverityCritical:
+	default:
+		return fmt.Errorf("min_severity %q is not a severity", r.MinSeverity)
+	}
+	if len(r.ChannelIDs) == 0 {
+		return fmt.Errorf("at least one channel is required")
+	}
+	return validateChannelIDs(instanceID, r.ChannelIDs)
+}
+
+// SendVulnDigest delivers one message per rule per tick — never one per
+// finding. See vulnsched for why the tick is the batch boundary.
+func SendVulnDigest(instanceID string, newly []models.VulnFinding) {
+	rules, err := ListVulnRules(instanceID)
+	if err != nil {
+		log.Printf("vuln digest: list rules: %v", err)
+		return
+	}
+
+	for _, rule := range rules {
+		if !rule.Enabled {
+			continue
+		}
+
+		matched := filterBySeverity(newly, rule.MinSeverity)
+		if len(matched) == 0 {
+			continue
+		}
+
+		if len(rule.Tags) > 0 {
+			// ResolveTargets is already the single answer to which servers a
+			// selector touches. A rule that disagreed with a workflow about
+			// what env:prod means would be worse than no filter at all.
+			allowed, err := ResolveTargets(instanceID, nil, rule.Tags)
+			if err != nil {
+				log.Printf("vuln digest: resolve targets: %v", err)
+				continue
+			}
+			matched = filterByServers(matched, allowed)
+			if len(matched) == 0 {
+				continue
+			}
+		}
+
+		dispatchVulnDigest(instanceID, rule, matched)
+	}
+}
+
+func filterBySeverity(findings []models.VulnFinding, min string) []models.VulnFinding {
+	floor := models.SeverityRank(min)
+	out := make([]models.VulnFinding, 0, len(findings))
+	for _, f := range findings {
+		if models.SeverityRank(f.Severity) >= floor {
+			out = append(out, f)
+		}
+	}
+	return out
+}
+
+// filterByServers keeps findings on servers the rule's tag selector matched.
+// ResolveTargets answers in whole server documents, so the IDs are lifted here.
+func filterByServers(findings []models.VulnFinding, allowed []models.Server) []models.VulnFinding {
+	set := make(map[string]bool, len(allowed))
+	for _, s := range allowed {
+		set[s.ServerID] = true
+	}
+	out := make([]models.VulnFinding, 0, len(findings))
+	for _, f := range findings {
+		if set[f.ServerID] {
+			out = append(out, f)
+		}
+	}
+	return out
+}
+
+// dispatchVulnDigest builds one digest and sends it over each of the rule's
+// channels.
+func dispatchVulnDigest(instanceID string, rule models.VulnAlertRule, findings []models.VulnFinding) {
+	channels, err := GetChannels(instanceID, rule.ChannelIDs)
+	if err != nil {
+		log.Printf("vuln digest: load channels for rule %s: %v", rule.Name, err)
+		return
+	}
+
+	digest := buildVulnDigest(instanceID, rule, findings)
+
+	for _, ch := range channels {
+		if !ch.Enabled {
+			continue
+		}
+		go func(c models.NotificationChannel) {
+			if err := notify.DispatchVulnDigest(c, digest); err != nil {
+				log.Printf("vuln digest: dispatch to %s (%s): %v", c.Name, c.Type, err)
+			}
+		}(ch)
+	}
+}
+
+// buildVulnDigest turns a batch of findings into one message.
+//
+// Findings are ordered most severe first so the capped list shows the ones that
+// matter rather than whichever the scan happened to produce first.
+func buildVulnDigest(instanceID string, rule models.VulnAlertRule, findings []models.VulnFinding) notify.VulnDigest {
+	sorted := make([]models.VulnFinding, len(findings))
+	copy(sorted, findings)
+	sort.SliceStable(sorted, func(i, j int) bool {
+		return models.SeverityRank(sorted[i].Severity) > models.SeverityRank(sorted[j].Severity)
+	})
+
+	counts := map[string]int{}
+	servers := map[string]bool{}
+	for _, f := range sorted {
+		counts[f.Severity]++
+		servers[f.ServerID] = true
+	}
+
+	names := serverNames(instanceID)
+
+	shown := sorted
+	more := 0
+	if len(shown) > digestRowLimit {
+		more = len(shown) - digestRowLimit
+		shown = shown[:digestRowLimit]
+	}
+
+	rows := make([]mail.VulnDigestRow, 0, len(shown))
+	for _, f := range shown {
+		name := names[f.ServerID]
+		if name == "" {
+			name = f.ServerID
+		}
+		rows = append(rows, mail.VulnDigestRow{
+			CVEID:       f.CVEID,
+			Severity:    f.Severity,
+			PackageName: f.PackageName,
+			ServerName:  name,
+			FixedIn:     f.FixedIn,
+		})
+	}
+
+	top := models.SeverityUnknown
+	if len(sorted) > 0 {
+		top = sorted[0].Severity
+	}
+
+	instanceName := instanceID
+	if inst, err := GetInstance(instanceID); err == nil && inst != nil && inst.Name != "" {
+		instanceName = inst.Name
+	}
+
+	return notify.VulnDigest{
+		InstanceName: instanceName,
+		RuleName:     rule.Name,
+		Summary:      summariseCounts(counts, len(servers)),
+		TopSeverity:  top,
+		Count:        len(sorted),
+		Rows:         rows,
+		More:         more,
+		DBAge:        vulnDBAge(),
+	}
+}
+
+// summariseCounts renders "12 new critical, 4 new high across 6 servers".
+func summariseCounts(counts map[string]int, serverCount int) string {
+	order := []string{
+		models.SeverityCritical, models.SeverityHigh,
+		models.SeverityMedium, models.SeverityLow, models.SeverityUnknown,
+	}
+	parts := ""
+	for _, sev := range order {
+		if counts[sev] == 0 {
+			continue
+		}
+		if parts != "" {
+			parts += ", "
+		}
+		parts += fmt.Sprintf("%d new %s", counts[sev], sev)
+	}
+	if parts == "" {
+		parts = "new findings"
+	}
+	plural := "servers"
+	if serverCount == 1 {
+		plural = "server"
+	}
+	return fmt.Sprintf("%s across %d %s", parts, serverCount, plural)
+}
+
+// serverNames maps server IDs to display names for one instance. A digest that
+// named raw UUIDs would be unreadable in a chat client.
+func serverNames(instanceID string) map[string]string {
+	out := map[string]string{}
+	servers, err := ListServers(instanceID)
+	if err != nil {
+		log.Printf("vuln digest: list servers: %v", err)
+		return out
+	}
+	for _, s := range servers {
+		out[s.ServerID] = s.Hostname
+	}
+	return out
+}
+
+// vulnDBAge renders how long ago the vulnerability database was pulled.
+//
+// It is on every digest deliberately: a fleet scanned against a three-week-old
+// database must say so rather than let the reader assume freshness.
+func vulnDBAge() string {
+	meta, err := GetVulnDBMeta()
+	if err != nil || meta == nil || meta.PulledAt.IsZero() {
+		return "an unknown time"
+	}
+	d := time.Since(meta.PulledAt)
+	switch {
+	case d < time.Hour:
+		return fmt.Sprintf("%d minutes", int(d.Minutes()))
+	case d < 48*time.Hour:
+		return fmt.Sprintf("%d hours", int(d.Hours()))
+	default:
+		return fmt.Sprintf("%d days", int(d.Hours()/24))
+	}
+}
+
+// GetVulnDBMeta reads the deployment-wide vulnerability database metadata.
+// It carries no instance_id: the database is a property of the deployment, not
+// of a tenant.
+func GetVulnDBMeta() (*models.VulnDBMeta, error) {
+	ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
+	defer cancel()
+
+	var meta models.VulnDBMeta
+	err := db.Col("vulndb_meta").FindOne(ctx, bson.M{}).Decode(&meta)
+	if err == mongo.ErrNoDocuments {
+		return nil, nil
+	}
+	if err != nil {
+		return nil, err
+	}
+	return &meta, nil
+}
@@ -0,0 +1,129 @@
+package vulndb
+
+import (
+	"strings"
+
+	trivydb "github.com/aquasecurity/trivy-db/pkg/db"
+	trivytypes "github.com/aquasecurity/trivy-db/pkg/types"
+)
+
+// Advisory is one fixed-version statement for one source package.
+type Advisory struct {
+	CVEID string
+	// FixedVersion empty means no vendor fix has been published. It is a real
+	// state, not an absence of data, and callers must treat it as vulnerable.
+	FixedVersion string
+	Severity     string
+}
+
+// VulnInfo is the CVE's own metadata, shared across every server it affects.
+type VulnInfo struct {
+	Title      string
+	Severity   string
+	CVSSScore  float64
+	References []string
+}
+
+// Store reads a pulled trivy-db.
+type Store struct {
+	cfg trivydb.Config
+}
+
+// Open opens the database in dir. trivy-db expects the directory, not the file:
+// it appends "trivy.db" itself.
+func Open(dir string) (*Store, error) {
+	if err := trivydb.Init(dir); err != nil {
+		return nil, err
+	}
+	return &Store{cfg: trivydb.Config{}}, nil
+}
+
+func (s *Store) Close() error { return trivydb.Close() }
+
+// Advisories returns every advisory for a source package in a bucket.
+func (s *Store) Advisories(bucket, srcName string) ([]Advisory, error) {
+	raw, err := s.cfg.GetAdvisories(bucket, srcName)
+	if err != nil {
+		return nil, err
+	}
+	out := make([]Advisory, 0, len(raw))
+	for _, a := range raw {
+		out = append(out, Advisory{
+			CVEID:        a.VulnerabilityID,
+			FixedVersion: a.FixedVersion,
+			// Advisory.Severity is trivy's numeric Severity type, unlike
+			// Vulnerability.Severity which is a string. They are genuinely
+			// different types in trivy-db, not an inconsistency here.
+			Severity: severityFromLevel(a.Severity),
+		})
+	}
+	return out, nil
+}
+
+// Vulnerability returns a CVE's shared metadata.
+func (s *Store) Vulnerability(cveID string) (VulnInfo, error) {
+	v, err := s.cfg.GetVulnerability(cveID)
+	if err != nil {
+		return VulnInfo{}, err
+	}
+	return VulnInfo{
+		Title:      v.Title,
+		Severity:   resolveSeverity(v),
+		CVSSScore:  topCVSS(v),
+		References: v.References,
+	}, nil
+}
+
+// resolveSeverity picks a CVE's severity: vendor, then NVD, then unknown.
+//
+// Never invented. This will surface as "why is this critical CVE marked low":
+// Debian and Red Hat routinely downgrade an NVD score because the vulnerable
+// path is not reachable in their build, and their rating is the accurate one
+// for that package. Where several vendors disagree the highest wins, because
+// under-reporting a vulnerability is the worse mistake.
+func resolveSeverity(v trivytypes.Vulnerability) string {
+	best := 0
+	for _, sev := range v.VendorSeverity {
+		if int(sev) > best {
+			best = int(sev)
+		}
+	}
+	if best > 0 {
+		return severityFromLevel(trivytypes.Severity(best))
+	}
+
+	// Vulnerability.Severity is the deprecated NVD-derived string. Used only as
+	// the fallback, which is exactly what it is good for.
+	if s := strings.ToLower(strings.TrimSpace(v.Severity)); s != "" && s != "unknown" {
+		return s
+	}
+	return "unknown"
+}
+
+// topCVSS returns the highest V3 score any source published, or 0.
+func topCVSS(v trivytypes.Vulnerability) float64 {
+	var top float64
+	for _, c := range v.CVSS {
+		if c.V3Score > top {
+			top = c.V3Score
+		}
+	}
+	return top
+}
+
+// severityFromLevel maps trivy-db's numeric severity onto our lowercase
+// strings. The names are fixed by models.Severity* and must stay in step.
+func severityFromLevel(n trivytypes.Severity) string {
+	switch int(n) {
+	case 4:
+		return "critical"
+	case 3:
+		return "high"
+	case 2:
+		return "medium"
+	case 1:
+		return "low"
+	default:
+		return "unknown"
+	}
+}
@@ -0,0 +1,61 @@
+package vulndb
+
+import (
+	"fmt"
+	"strings"
+)
+
+// rhelRebuilds share Red Hat's advisory feed rather than publishing their own.
+var rhelRebuilds = map[string]bool{
+	"redhat": true, "centos": true, "rocky": true, "alma": true, "oracle": true,
+}
+
+// Bucket maps an OS family and version onto the trivy-db bucket that holds its
+// advisories.
+//
+// It returns ErrUnsupportedFamily rather than a best guess when we have no
+// feed. A scan that cannot be performed must say so; reporting zero findings
+// for a distribution we do not cover is indistinguishable from reporting a
+// clean host, and one of those is a lie.
+func Bucket(family, versionID string) (string, error) {
+	family = strings.ToLower(strings.TrimSpace(family))
+	versionID = strings.TrimSpace(versionID)
+
+	switch {
+	case family == "debian" || family == "ubuntu":
+		if versionID == "" {
+			return "", fmt.Errorf("%s requires a version id", family)
+		}
+		return family + " " + versionID, nil
+
+	case family == "alpine":
+		if versionID == "" {
+			return "", fmt.Errorf("alpine requires a version id")
+		}
+		return "alpine " + majorMinor(versionID), nil
+
+	case rhelRebuilds[family]:
+		if versionID == "" {
+			return "", fmt.Errorf("%s requires a version id", family)
+		}
+		return "redhat " + major(versionID), nil
+
+	default:
+		return "", fmt.Errorf("%w: %s", ErrUnsupportedFamily, family)
+	}
+}
+
+func major(v string) string {
+	if i := strings.Index(v, "."); i != -1 {
+		return v[:i]
+	}
+	return v
+}
+
+func majorMinor(v string) string {
+	parts := strings.Split(v, ".")
+	if len(parts) >= 2 {
+		return parts[0] + "." + parts[1]
+	}
+	return v
+}
@@ -0,0 +1,81 @@
+package vulndb
+
+import (
+	"fmt"
+	"log"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+)
+
+// AdvisorySource is the advisory lookup the matcher needs. *Store satisfies it.
+// The seam keeps the matching logic independent of how the database is opened.
+type AdvisorySource interface {
+	Advisories(bucket, srcName string) ([]Advisory, error)
+}
+
+// Result is one vulnerable package on one server, before it becomes a finding.
+type Result struct {
+	CVEID       string
+	PackageName string // the BINARY package, which is what is installed
+	Installed   string
+	FixedIn     string
+	Severity    string
+}
+
+// Match returns every advisory that the installed packages do not satisfy.
+//
+// Vulnerable means: no fix has been published, or the installed version sorts
+// strictly before the fixed version under the distribution's own ordering.
+// Equal is NOT vulnerable — that is the backported-fix case, where a
+// distribution patches in place without changing the upstream version, and
+// treating it as vulnerable reports a patched fleet as exposed.
+func Match(src AdvisorySource, os models.OSRelease, pkgs []models.InstalledPackage) ([]Result, error) {
+	bucket, err := Bucket(os.Family, os.VersionID)
+	if err != nil {
+		return nil, err
+	}
+
+	var out []Result
+	for _, p := range pkgs {
+		// Debian and Ubuntu advisories are keyed on the source package: one
+		// advisory against "openssl" covers libssl3, openssl and libssl-dev.
+		srcName := p.SourceName
+		if srcName == "" {
+			srcName = p.Name
+		}
+
+		advs, err := src.Advisories(bucket, srcName)
+		if err != nil {
+			return nil, fmt.Errorf("advisories for %s: %w", srcName, err)
+		}
+
+		for _, a := range advs {
+			// No published fix. Vulnerable, and the finding most in need of
+			// acceptance, since there is nothing to patch.
+			if a.FixedVersion == "" {
+				out = append(out, Result{
+					CVEID: a.CVEID, PackageName: p.Name,
+					Installed: p.Version, Severity: a.Severity,
+				})
+				continue
+			}
+
+			older, err := LessThan(os.Family, p.Version, a.FixedVersion)
+			if err != nil {
+				// Skip this one advisory rather than failing the whole server:
+				// one unparseable version must not blind us to every other CVE
+				// on the host. Log it — a silent skip is a silent false
+				// negative, which is the direction that hurts.
+				log.Printf("vulndb: compare %s %s vs %s: %v", p.Name, p.Version, a.FixedVersion, err)
+				continue
+			}
+			if older {
+				out = append(out, Result{
+					CVEID: a.CVEID, PackageName: p.Name,
+					Installed: p.Version, FixedIn: a.FixedVersion, Severity: a.Severity,
+				})
+			}
+		}
+	}
+	return out, nil
+}
@@ -0,0 +1,186 @@
+package vulndb
+
+import (
+	"archive/tar"
+	"compress/gzip"
+	"context"
+	"encoding/json"
+	"fmt"
+	"io"
+	"os"
+	"path/filepath"
+	"strings"
+
+	ocispec "github.com/opencontainers/image-spec/specs-go/v1"
+	"oras.land/oras-go/v2"
+	"oras.land/oras-go/v2/registry"
+	"oras.land/oras-go/v2/registry/remote"
+)
+
+// DefaultRef is the published trivy-db OCI artifact, rebuilt every six hours.
+const DefaultRef = "ghcr.io/aquasecurity/trivy-db:2"
+
+// SupportedSchema is the trivy-db schema version this code understands.
+//
+// A different version is refused rather than parsed on the assumption it is
+// close enough. Mis-reading the schema would not fail loudly — it would return
+// no advisories, which is indistinguishable from a clean fleet.
+const SupportedSchema = 2
+
+// dbFileName and metaFileName are the two files inside the artifact layer.
+const (
+	dbFileName   = "trivy.db"
+	metaFileName = "metadata.json"
+)
+
+// Ref returns the artifact reference, honouring VANTAGE_TRIVY_DB_REF so an
+// air-gapped deployment can mirror the artifact into its own registry, and so
+// a busy deployment can avoid the anonymous ghcr rate limit.
+func Ref() string {
+	if v := os.Getenv("VANTAGE_TRIVY_DB_REF"); v != "" {
+		return v
+	}
+	return DefaultRef
+}
+
+// Disabled reports whether the puller and scheduler are switched off entirely.
+// Findings already written are still served, and still marked stale.
+func Disabled() bool {
+	return strings.EqualFold(os.Getenv("VANTAGE_VULNDB_DISABLED"), "true")
+}
+
+// dbMetadata is the subset of trivy-db's metadata.json we read.
+type dbMetadata struct {
+	Version int `json:"Version"`
+}
+
+// Pull fetches the trivy-db artifact into dir and returns its schema version.
+//
+// It extracts into a staging directory and only moves the files into place once
+// both are present and the schema has been accepted. A pull that fails partway
+// therefore leaves the previous database untouched rather than a half-written
+// one that Open would happily accept and scan against.
+func Pull(ctx context.Context, dir string) (int, error) {
+	ref := Ref()
+
+	parsed, err := registry.ParseReference(ref)
+	if err != nil {
+		return 0, fmt.Errorf("parse reference %q: %w", ref, err)
+	}
+
+	repo, err := remote.NewRepository(ref)
+	if err != nil {
+		return 0, fmt.Errorf("open repository %q: %w", ref, err)
+	}
+
+	// The tag or digest half of the reference; the repository already knows the
+	// registry and path.
+	target := parsed.Reference
+	if target == "" {
+		target = "latest"
+	}
+
+	_, manifestBytes, err := oras.FetchBytes(ctx, repo, target, oras.DefaultFetchBytesOptions)
+	if err != nil {
+		return 0, fmt.Errorf("fetch manifest %s: %w", ref, err)
+	}
+
+	var man ocispec.Manifest
+	if err := json.Unmarshal(manifestBytes, &man); err != nil {
+		return 0, fmt.Errorf("decode manifest %s: %w", ref, err)
+	}
+	if len(man.Layers) == 0 {
+		return 0, fmt.Errorf("artifact %s has no layers", ref)
+	}
+
+	// Streamed rather than buffered: the layer is ~50MB and there is no reason
+	// to hold it in memory on the way to disk.
+	rc, err := repo.Blobs().Fetch(ctx, man.Layers[0])
+	if err != nil {
+		return 0, fmt.Errorf("fetch layer: %w", err)
+	}
+	defer rc.Close()
+
+	staging, err := os.MkdirTemp(dir, ".staging-")
+	if err != nil {
+		return 0, fmt.Errorf("staging dir: %w", err)
+	}
+	defer os.RemoveAll(staging)
+
+	if err := extractTarGz(rc, staging); err != nil {
+		return 0, fmt.Errorf("extract layer: %w", err)
+	}
+
+	metaBytes, err := os.ReadFile(filepath.Join(staging, metaFileName))
+	if err != nil {
+		return 0, fmt.Errorf("read %s: %w", metaFileName, err)
+	}
+	var meta dbMetadata
+	if err := json.Unmarshal(metaBytes, &meta); err != nil {
+		return 0, fmt.Errorf("decode %s: %w", metaFileName, err)
+	}
+	if meta.Version != SupportedSchema {
+		return 0, fmt.Errorf("trivy-db schema %d is not supported (want %d)", meta.Version, SupportedSchema)
+	}
+
+	if _, err := os.Stat(filepath.Join(staging, dbFileName)); err != nil {
+		return 0, fmt.Errorf("artifact has no %s: %w", dbFileName, err)
+	}
+
+	// Both files present and the schema accepted, so it is safe to replace.
+	for _, name := range []string{dbFileName, metaFileName} {
+		src := filepath.Join(staging, name)
+		dst := filepath.Join(dir, name)
+		if err := os.Remove(dst); err != nil && !os.IsNotExist(err) {
+			return 0, fmt.Errorf("remove old %s: %w", name, err)
+		}
+		if err := os.Rename(src, dst); err != nil {
+			return 0, fmt.Errorf("install %s: %w", name, err)
+		}
+	}
+
+	return meta.Version, nil
+}
+
+// extractTarGz writes the artifact layer into dir. Paths are flattened and
+// checked so a crafted archive cannot write outside dir.
+func extractTarGz(r io.Reader, dir string) error {
+	gz, err := gzip.NewReader(r)
+	if err != nil {
+		return err
+	}
+	defer gz.Close()
+
+	tr := tar.NewReader(gz)
+	for {
+		hdr, err := tr.Next()
+		if err == io.EOF {
+			return nil
+		}
+		if err != nil {
+			return err
+		}
+		if hdr.Typeflag != tar.TypeReg {
+			continue
+		}
+		name := filepath.Base(hdr.Name) // flatten; the archive is two files
+		if name == "." || name == ".." || name == "" {
+			continue
+		}
+		dst := filepath.Join(dir, name)
+		if !strings.HasPrefix(dst, filepath.Clean(dir)+string(os.PathSeparator)) {
+			return fmt.Errorf("archive entry escapes destination: %q", hdr.Name)
+		}
+		f, err := os.Create(dst)
+		if err != nil {
+			return err
+		}
+		if _, err := io.Copy(f, tr); err != nil {
+			f.Close()
+			return err
+		}
+		if err := f.Close(); err != nil {
+			return err
+		}
+	}
+}
@@ -0,0 +1,73 @@
+// Package vulndb matches installed packages against distribution security
+// advisories.
+//
+// Version comparison is bought rather than written. Distribution version
+// ordering is subtle in ways that are invisible until they are wrong: dpkg has
+// epochs and sorts "~" before the empty string, rpmvercmp has its own segment
+// rules and treats "~" and "^" differently again, and any ordering that falls
+// back on string comparison puts 1.10 before 1.9. Every one of those mistakes
+// produces a false negative — a vulnerable host reported clean — which is the
+// failure nobody notices.
+package vulndb
+
+import (
+	"errors"
+	"fmt"
+
+	apk "github.com/knqyf263/go-apk-version"
+	deb "github.com/knqyf263/go-deb-version"
+	rpm "github.com/knqyf263/go-rpm-version"
+)
+
+// ErrUnsupportedFamily means we hold no comparator for this distribution, and
+// therefore cannot answer whether it is vulnerable. Callers must surface this
+// as "unsupported" and must never treat it as "not vulnerable".
+var ErrUnsupportedFamily = errors.New("unsupported OS family")
+
+// LessThan reports whether version a sorts before version b under the ordering
+// rules of the given OS family.
+//
+// An unparseable or empty version is an error, never a quiet false. False here
+// means "not vulnerable", which is the dangerous direction to guess in.
+func LessThan(family, a, b string) (bool, error) {
+	switch family {
+	case "debian", "ubuntu":
+		if a == "" || b == "" {
+			return false, fmt.Errorf("empty deb version (a=%q b=%q)", a, b)
+		}
+		va, err := deb.NewVersion(a)
+		if err != nil {
+			return false, fmt.Errorf("parse deb version %q: %w", a, err)
+		}
+		vb, err := deb.NewVersion(b)
+		if err != nil {
+			return false, fmt.Errorf("parse deb version %q: %w", b, err)
+		}
+		return va.LessThan(vb), nil
+
+	case "redhat", "centos", "rocky", "alma", "amazon", "oracle", "suse", "opensuse", "sles":
+		// go-rpm-version does not error; rpmvercmp is defined over arbitrary
+		// strings. Guard empties so a missing version cannot read as equal.
+		if a == "" || b == "" {
+			return false, fmt.Errorf("empty rpm version (a=%q b=%q)", a, b)
+		}
+		return rpm.NewVersion(a).LessThan(rpm.NewVersion(b)), nil
+
+	case "alpine":
+		if a == "" || b == "" {
+			return false, fmt.Errorf("empty apk version (a=%q b=%q)", a, b)
+		}
+		va, err := apk.NewVersion(a)
+		if err != nil {
+			return false, fmt.Errorf("parse apk version %q: %w", a, err)
+		}
+		vb, err := apk.NewVersion(b)
+		if err != nil {
+			return false, fmt.Errorf("parse apk version %q: %w", b, err)
+		}
+		return va.LessThan(vb), nil
+
+	default:
+		return false, fmt.Errorf("%w: %s", ErrUnsupportedFamily, family)
+	}
+}
@@ -0,0 +1,238 @@
+// Package vulnsched owns the vulnerability scan loop.
+//
+// It runs inside bus.RunAsLeader("housekeeping", …) alongside monitorsched,
+// workflowsched and the sweepers: one role, one lock. N replicas each running
+// this loop would mean N copies of the ~50MB database resident, N rescans of
+// the same fleet on every database refresh, and N digests reaching the
+// customer for one set of findings.
+package vulnsched
+
+import (
+	"context"
+	"errors"
+	"log"
+	"os"
+	"time"
+
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/db"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/models"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/services"
+	"gitea.hostxtra.co.uk/mrhid6/vantage/server/internal/vulndb"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+const (
+	tickInterval = 60 * time.Second
+	// trivy-db is rebuilt every six hours; pulling more often buys nothing.
+	dbMaxAge = 6 * time.Hour
+)
+
+// Deps are injected from main.go rather than imported, following
+// workflowsched. It keeps this package's reach explicit and reviewable.
+type Deps struct {
+	LogEvent   func(instanceID, eventType, actor, serverID, keyID, details string)
+	SendDigest func(instanceID string, newly []models.VulnFinding)
+}
+
+type scheduler struct {
+	deps    Deps
+	dir     string
+	store   *vulndb.Store
+	version int
+	pulled  time.Time
+}
+
+func Start(ctx context.Context, deps Deps) {
+	if vulndb.Disabled() {
+		log.Println("vulnsched: disabled by VANTAGE_VULNDB_DISABLED")
+		return
+	}
+
+	dir, err := os.MkdirTemp("", "vantage-vulndb-")
+	if err != nil {
+		log.Printf("vulnsched: temp dir: %v", err)
+		return
+	}
+
+	s := &scheduler{deps: deps, dir: dir}
+
+	go func() {
+		defer os.RemoveAll(dir)
+		defer s.closeStore()
+
+		ticker := time.NewTicker(tickInterval)
+		defer ticker.Stop()
+		for {
+			select {
+			case <-ctx.Done():
+				return
+			case <-ticker.C:
+				s.tick(ctx)
+			}
+		}
+	}()
+}
+
+func (s *scheduler) tick(ctx context.Context) {
+	if err := s.ensureDB(ctx); err != nil {
+		// Keep the last good database and carry on scanning against it. A
+		// network blip must never clear findings or read as "all fixed".
+		log.Printf("vulnsched: database unavailable: %v", err)
+		s.recordDBError(ctx, err)
+		if s.store == nil {
+			return
+		}
+	}
+	s.scanPending(ctx)
+}
+
+// ensureDB pulls a fresh database when the local copy is stale, and marks the
+// whole fleet for rescanning when the version changes — which is what makes a
+// newly published CVE flag existing servers within a minute rather than at the
+// next agent report.
+func (s *scheduler) ensureDB(ctx context.Context) error {
+	if s.store != nil && time.Since(s.pulled) < dbMaxAge {
+		return nil
+	}
+
+	version, err := vulndb.Pull(ctx, s.dir)
+	if err != nil {
+		return err
+	}
+
+	s.closeStore()
+	store, err := vulndb.Open(s.dir)
+	if err != nil {
+		return err
+	}
+	s.store = store
+	s.pulled = time.Now()
+
+	changed := version != s.version
+	s.version = version
+
+	_, _ = db.Col("vulndb_meta").UpdateOne(ctx, bson.M{},
+		bson.M{"$set": bson.M{"db_version": version, "pulled_at": s.pulled}, "$unset": bson.M{"last_error": ""}},
+		options.UpdateOne().SetUpsert(true),
+	)
+
+	if changed {
+		res, err := db.Col("server_packages").UpdateMany(ctx,
+			bson.M{"status": bson.M{"$ne": models.ScanStatusUnsupported}},
+			bson.M{"$set": bson.M{"scan_pending": true}},
+		)
+		if err != nil {
+			log.Printf("vulnsched: mark fleet pending: %v", err)
+		} else {
+			log.Printf("vulnsched: database version %d, %d servers marked for rescan", version, res.ModifiedCount)
+		}
+	}
+	return nil
+}
+
+func (s *scheduler) recordDBError(ctx context.Context, err error) {
+	_, _ = db.Col("vulndb_meta").UpdateOne(ctx, bson.M{},
+		bson.M{"$set": bson.M{"last_error": err.Error()}},
+		options.UpdateOne().SetUpsert(true),
+	)
+}
+
+func (s *scheduler) scanPending(ctx context.Context) {
+	cur, err := db.Col("server_packages").Find(ctx, bson.M{"scan_pending": true})
+	if err != nil {
+		log.Printf("vulnsched: find pending: %v", err)
+		return
+	}
+	defer cur.Close(ctx)
+
+	var pending []models.ServerPackages
+	if err := cur.All(ctx, &pending); err != nil {
+		log.Printf("vulnsched: decode pending: %v", err)
+		return
+	}
+
+	// Newly opened findings are collected across the whole tick and sent as one
+	// digest per instance. A database refresh can open several hundred findings
+	// at once; one message per finding would rate-limit the webhook or get the
+	// channel muted, and either way the alerts stop being read.
+	newly := map[string][]models.VulnFinding{}
+
+	for _, sp := range pending {
+		if ctx.Err() != nil {
+			// Leadership lost. scan_pending is still set, so the next leader
+			// picks these up — which is why it lives on the document.
+			return
+		}
+		opened := s.scanOne(ctx, sp)
+		newly[sp.InstanceID] = append(newly[sp.InstanceID], opened...)
+	}
+
+	for instanceID, findings := range newly {
+		if len(findings) > 0 && s.deps.SendDigest != nil {
+			s.deps.SendDigest(instanceID, findings)
+		}
+	}
+
+	_, _ = db.Col("vulndb_meta").UpdateOne(ctx, bson.M{},
+		bson.M{"$set": bson.M{"last_full_scan_at": time.Now()}},
+		options.UpdateOne().SetUpsert(true),
+	)
+}
+
+func (s *scheduler) scanOne(ctx context.Context, sp models.ServerPackages) []models.VulnFinding {
+	now := time.Now()
+
+	results, err := vulndb.Match(s.store, sp.OS, sp.Packages)
+	if err != nil {
+		// We hold no feed for this distribution, so we cannot answer whether it
+		// is vulnerable. Say "unsupported" — reporting zero findings here would
+		// be indistinguishable from reporting a clean host, and one of those is
+		// a lie.
+		status := models.ScanStatusUnsupported
+		if !errors.Is(err, vulndb.ErrUnsupportedFamily) {
+			log.Printf("vulnsched: scan %s: %v", sp.ServerID, err)
+			status = sp.Status
+		}
+		s.clearPending(ctx, sp.ID, status, now)
+		return nil
+	}
+
+	existing, err := services.ListFindings(ctx, sp.InstanceID, sp.ServerID)
+	if err != nil {
+		log.Printf("vulnsched: list findings %s: %v", sp.ServerID, err)
+		return nil
+	}
+
+	diff := services.DiffFindings(existing, results, now)
+	if err := services.ApplyFindingDiff(ctx, sp.InstanceID, sp.ServerID, diff, now); err != nil {
+		log.Printf("vulnsched: apply diff %s: %v", sp.ServerID, err)
+		return nil
+	}
+
+	s.clearPending(ctx, sp.ID, models.ScanStatusOK, now)
+
+	for i := range diff.NewlyOpened {
+		diff.NewlyOpened[i].ServerID = sp.ServerID
+	}
+	return diff.NewlyOpened
+}
+
+func (s *scheduler) clearPending(ctx context.Context, id bson.ObjectID, status string, now time.Time) {
+	_, _ = db.Col("server_packages").UpdateOne(ctx,
+		bson.M{"_id": id},
+		bson.M{"$set": bson.M{
+			"scan_pending": false,
+			"status":       status,
+			"scanned_at":   now,
+			"db_version":   s.version,
+		}},
+	)
+}
+
+func (s *scheduler) closeStore() {
+	if s.store != nil {
+		_ = s.store.Close()
+		s.store = nil
+	}
+}
@@ -31,6 +31,10 @@ const (

 	FeatureConsole = "console" // browser SSH/RDP/VNC
 	FeatureOIDC    = "oidc"    // per-instance single sign-on
+	// FeatureVulnScanning gates package inventory collection as well as the
+	// findings themselves. The gate is at collection, not display: an ungated
+	// instance stores no inventory, and storage is the expensive half.
+	FeatureVulnScanning = "vuln_scanning"
 )

 // Support levels. Carried for display and enforced by nothing — there is no code
@@ -0,0 +1,13 @@
+{{define "title"}}New vulnerabilities detected{{end}}
+{{define "pill"}}{{template "chip" (dict "label" (upper .TopSeverity) "tone" "down")}}{{end}}
+{{define "body"}}
+{{template "lead" .Summary}}
+{{template "rows" (list
+  (dict "k" "Instance" "v" .InstanceName)
+  (dict "k" "New findings" "v" .Count))}}
+{{range .Rows}}
+{{if .FixedIn}}{{template "well" (printf "%s (%s) — %s on %s, fixed in %s" .CVEID .Severity .PackageName .ServerName .FixedIn)}}{{else}}{{template "well" (printf "%s (%s) — %s on %s, no fix published" .CVEID .Severity .PackageName .ServerName)}}{{end}}
+{{end}}
+{{if .More}}{{template "p" (printf "…and %d more." .More)}}{{end}}
+{{template "note" (printf "Scanned against a vulnerability database pulled %s ago." .DBAge)}}
+{{end}}
@@ -0,0 +1,12 @@
+{{define "subject"}}{{.Count}} new {{if eq .Count 1}}vulnerability{{else}}vulnerabilities{{end}} on {{.InstanceName}}{{end}}
+{{define "title"}}New vulnerabilities detected{{end}}
+{{define "pill"}}{{.TopSeverity}}{{end}}
+{{define "body"}}
+{{template "lead" .Summary}}
+
+{{range .Rows}}- {{.CVEID}} ({{.Severity}}) — {{.PackageName}} on {{.ServerName}}{{if .FixedIn}}, fixed in {{.FixedIn}}{{else}}, no fix published{{end}}
+{{end}}
+{{if .More}}...and {{.More}} more.{{end}}
+
+Scanned against vulnerability database pulled {{.DBAge}} ago.
+{{end}}
@@ -0,0 +1,41 @@
+package mail
+
+// VulnDigestRow is one newly opened finding as the digest shows it.
+//
+// It lives here rather than in server/ so the templates and the caller agree on
+// the fields without server's model package leaking into shared.
+type VulnDigestRow struct {
+	CVEID       string
+	Severity    string
+	PackageName string
+	ServerName  string
+	// FixedIn empty means no vendor fix has been published, which the template
+	// says explicitly rather than leaving blank — it is a real state, not
+	// missing data.
+	FixedIn string
+}
+
+// VulnDigest is one batch of newly opened findings.
+//
+// One message per rule per scan, never one per finding: a database refresh can
+// open several hundred at once, and one message each would rate-limit the
+// webhook or get the channel muted.
+type VulnDigest struct {
+	InstanceName string
+	// Count is every newly opened finding in the batch, which may exceed
+	// len(Rows) — Rows is capped and More carries the remainder.
+	Count       int
+	TopSeverity string
+	Summary     string
+	Rows        []VulnDigestRow
+	More        int
+	// DBAge is pre-formatted by the caller. A digest scanned against a
+	// three-week-old database must say so rather than quietly imply freshness.
+	DBAge string
+}
+
+// SendVulnDigest delivers one digest to an SMTP notification channel's
+// recipients, which may be a comma-separated list.
+func (s Sender) SendVulnDigest(to string, d VulnDigest) error {
+	return s.sendTemplate(to, "", "vuln_digest", d)
+}
@@ -34,6 +34,11 @@ type Settings struct {
 	// absent as disabled — turning off password login for the entire fleet at
 	// upgrade. Nil means enabled.
 	LocalLoginEnabled *bool `bson:"local_login_enabled,omitempty" json:"local_login_enabled,omitempty"`
+
+	// VulnFindingRetentionDays is a pointer for the same reason
+	// WorkflowLogRetentionDays is: absent must mean the default, not zero.
+	// Nil is 90 days, 0 is forever. Only "fixed" findings are ever swept.
+	VulnFindingRetentionDays *int `bson:"vuln_finding_retention_days,omitempty" json:"vuln_finding_retention_days,omitempty"`
 }

 // LocalLoginEnabled reads the setting with its absent-means-on default. Every
@@ -21,6 +21,7 @@ const COMPARISON: [string, string, string, string][] = [
    ["Audit history", "30 days", "365 days", "Forever"],
    ["Browser console", "Not Available", "Add-on", "Add-on"],
    ["Single sign-on", "Not Available", "Add-on", "Add-on"],
+    ["Vulnerability scanning", "Not Available", "Add-on", "Add-on"],
    ["Support", "Community", "Email, 24/5", "Email and phone, 24/7"],
    ["Cloud term", "Annual, £0", "Monthly or annual", "Monthly or annual"],
    ["Self-hosted term", "Annual, £0", "Annual", "Annual"],
@@ -39,10 +40,7 @@ export default function PricingPage() {
            >
                Pick a tier, then pay per server.
            </h1>
-            <p className="lede">
-                You pay for the number of servers you manage, and nothing else. Adding people costs nothing, and neither does adding keys, scripts, uptime checks or stored passwords. Every tier costs
-                the same whether we host it or you do.
-            </p>
+            <p className="lede">You pay for the number of servers you manage, and nothing else. Adding people costs nothing, and neither does adding keys, scripts, uptime checks or stored passwords. Every tier costs the same whether we host it or you do.</p>

            <div className="plans">
                <div className="plan">
@@ -79,7 +77,7 @@ export default function PricingPage() {
                        <li>3 servers included, add as many as you like</li>
                        <li>Unlimited monitors, secrets and channels</li>
                        <li>365 days of audit history</li>
-                        <li>Browser console and single sign-on as add-ons</li>
+                        <li>Browser console, single sign-on and vulnerability scanning as add-ons</li>
                        <li>Email support, 24/5</li>
                    </ul>
                    <Link className="btn btn--solid" href="/start">
@@ -125,6 +123,13 @@ export default function PricingPage() {
                        <p>Connect your own OIDC provider to an instance. £90 a year.</p>
                    </div>
                </div>
+                <div className="spec">
+                    <span className="spec__k">£7 / MO</span>
+                    <div>
+                        <h3>Vulnerability Scanning</h3>
+                        <p>Agents will scan and report known Vulnerabilites. £70 a year.</p>
+                    </div>
+                </div>
            </div>

            <p className="scroll__hint">Scroll the table sideways for all three tiers</p>
@@ -179,39 +184,28 @@ export default function PricingPage() {
                        <span className="spec__k">LIMITS</span>
                        <div>
                            <h3>Reaching your limit</h3>
-                            <p>
-                                Nothing gets deleted. A server past the limit still checks in and still shows up in your list, but access changes stop reaching it until you raise the limit or remove
-                                one.
-                            </p>
+                            <p>Nothing gets deleted. A server past the limit still checks in and still shows up in your list, but access changes stop reaching it until you raise the limit or remove one.</p>
                        </div>
                    </div>
                    <div className="spec">
                        <span className="spec__k">CANCELLING</span>
                        <div>
                            <h3>What happens when you stop paying</h3>
-                            <p>
-                                You keep everything until the end of the period you paid for. After that it becomes read-only: your uptime checks carry on running, your alerts still arrive and your
-                                servers keep the access they have. You just can&apos;t change anything until you renew.
-                            </p>
+                            <p>You keep everything until the end of the period you paid for. After that it becomes read-only: your uptime checks carry on running, your alerts still arrive and your servers keep the access they have. You just can&apos;t change anything until you renew.</p>
                        </div>
                    </div>
                    <div className="spec">
                        <span className="spec__k">SELF-HOSTED</span>
                        <div>
                            <h3>Why self-hosted is yearly only</h3>
-                            <p>
-                                When you host it yourself, your licence is a file your installation checks on its own. It never contacts us, which is the point but it also means we can&apos;t switch
-                                one off partway through, so we sell it a year at a time.
-                            </p>
+                            <p>When you host it yourself, your licence is a file your installation checks on its own. It never contacts us, which is the point but it also means we can&apos;t switch one off partway through, so we sell it a year at a time.</p>
                        </div>
                    </div>
                    <div className="spec">
                        <span className="spec__k">EXIT</span>
                        <div>
                            <h3>Leaving</h3>
-                            <p>
-                                You can export your servers, keys, scripts and stored passwords at any time. Your servers keep the access they already have, so nobody gets locked out while you move.
-                            </p>
+                            <p>You can export your servers, keys, scripts and stored passwords at any time. Your servers keep the access they already have, so nobody gets locked out while you move.</p>
                        </div>
                    </div>
                </div>
@@ -9,6 +9,7 @@ import { Badge, Button, Card, CardHeader, CardTitle } from "@/components/ui";
 import { Table, Thead, Tbody, Tr, Th, Td } from "@/components/ui";
 import { useLicense } from "@/lib/useLicense";
 import { TagChips } from "@/components/servers/TagChips";
+import { ServerVulnerabilities } from "@/components/vulnerabilities/ServerVulnerabilities";

 function statusVariant(status: ServerStatus) {
    switch (status) {
@@ -549,6 +550,10 @@ export default function ServerDetailPage() {
                    </dl>
                </Card>

+                <div className="lg:col-span-2">
+                    <ServerVulnerabilities serverId={server.server_id} />
+                </div>
+
                <div className="lg:col-span-2">
                    <Card padding={false}>
                        <div className="flex items-center justify-between border-b border-border px-6 py-4">
@@ -104,14 +104,7 @@ function Allowance({ label, used, limit }: { label: string; used: number; limit:
            {unlimited ? (
                <p className="mt-3 font-mono text-[0.62rem] uppercase tracking-[0.14em] text-text-secondary">No limit</p>
            ) : (
-                <div
-                    className="mt-3 h-1.5 overflow-hidden rounded-full bg-surface-2"
-                    role="meter"
-                    aria-valuenow={used}
-                    aria-valuemin={0}
-                    aria-valuemax={limit}
-                    aria-label={`${label}: ${used} of ${limit} used`}
-                >
+                <div className="mt-3 h-1.5 overflow-hidden rounded-full bg-surface-2" role="meter" aria-valuenow={used} aria-valuemin={0} aria-valuemax={limit} aria-label={`${label}: ${used} of ${limit} used`}>
                    <div className={`h-full rounded-full ${fill}`} style={{ width: `${pct}%` }} />
                </div>
            )}
@@ -122,12 +115,7 @@ function Allowance({ label, used, limit }: { label: string; used: number; limit:
 function Feature({ label, included }: { label: string; included: boolean }) {
    return (
        <div className="flex items-center gap-3 py-2.5">
-            <span
-                aria-hidden
-                className={`flex h-4 w-4 flex-shrink-0 items-center justify-center rounded-sm border text-[0.6rem] font-bold ${
-                    included ? "border-success text-success" : "border-border text-text-tertiary"
-                }`}
-            >
+            <span aria-hidden className={`flex h-4 w-4 flex-shrink-0 items-center justify-center rounded-sm border text-[0.6rem] font-bold ${included ? "border-success text-success" : "border-border text-text-tertiary"}`}>
                {included ? "✓" : "–"}
            </span>
            <span className="text-sm text-text-primary">{label}</span>
@@ -183,11 +171,7 @@ function RecordPanel({ license }: { license: LicenseInfo }) {
                    <Keyed label="Instance ID">
                        <div className="flex items-center gap-2">
                            <code className="truncate font-mono text-xs text-text-primary">{license.instance_id}</code>
-                            <button
-                                type="button"
-                                onClick={copyId}
-                                className="flex-shrink-0 rounded-sm border border-border px-1.5 py-0.5 font-mono text-[0.6rem] uppercase tracking-[0.1em] text-text-secondary transition-colors hover:border-text-tertiary hover:text-text-primary"
-                            >
+                            <button type="button" onClick={copyId} className="flex-shrink-0 rounded-sm border border-border px-1.5 py-0.5 font-mono text-[0.6rem] uppercase tracking-[0.1em] text-text-secondary transition-colors hover:border-text-tertiary hover:text-text-primary">
                                {copied ? "Copied" : "Copy"}
                            </button>
                        </div>
@@ -265,6 +249,7 @@ export default function LicensePage() {
                        <div className="divide-y divide-border-soft">
                            <Feature label="Browser console" included={Boolean(license.features.console)} />
                            <Feature label="Single sign-on" included={Boolean(license.features.oidc)} />
+                            <Feature label="Vulnerability Scanning" included={Boolean(license.features.vuln_scanning)} />
                        </div>
                    </Card>
                </Group>
@@ -272,9 +257,7 @@ export default function LicensePage() {
                {isCloud ? (
                    <Group label="Where this licence comes from">
                        <Card>
-                            <p className="max-w-prose text-sm text-text-secondary">
-                                This is a cloud instance, so its licence is issued and renewed in Vantage HQ and applied here automatically. There is nothing to paste.
-                            </p>
+                            <p className="max-w-prose text-sm text-text-secondary">This is a cloud instance, so its licence is issued and renewed in Vantage HQ and applied here automatically. There is nothing to paste.</p>
                            {hqUrl && (
                                <div className="mt-5 border-t border-border-soft pt-5">
                                    <a href={hqUrl} target="_blank" rel="noreferrer">
@@ -5,6 +5,7 @@ import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
 import Link from "next/link";
 import { api, ChannelInput, ChannelType, NotificationChannel } from "@/lib/api";
 import { Badge, Button, Card } from "@/components/ui";
+import { VulnAlertRulesCard } from "@/components/vulnerabilities/VulnAlertRulesCard";

 const inputClass =
  "w-full rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary placeholder:text-text-tertiary focus:border-accent/50 focus:outline-none focus:ring-1 focus:ring-accent/30";
@@ -182,6 +183,12 @@ export default function NotificationSettingsPage() {
          channels.map((ch) => <ChannelRow key={ch.channel_id} ch={ch} />)
        )}
      </Card>
+
+      {/* Beside the channels it consumes rather than on its own page: a rule is
+          a routing decision about destinations configured directly above it. */}
+      <div className="mt-6">
+        <VulnAlertRulesCard />
+      </div>
    </div>
  );
 }
@@ -3,214 +3,234 @@
 import { useMemo, useRef, useState } from "react";
 import { useQuery, useQueryClient } from "@tanstack/react-query";
 import { api, WorkflowStep } from "@/lib/api";
-import { Button } from "@/components/ui";
+import { Button, Card } from "@/components/ui";
+import { Table, Thead, Tbody, Tr, Th, Td } from "@/components/ui";
 import { EditStepModal } from "@/components/workflows/EditStepModal";

 type Tab = "all" | "bash" | "powershell" | "default" | "shared";

-const inputClass =
-  "w-full rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary placeholder-text-secondary/50 focus:border-signal focus:outline-none focus:ring-1 focus:ring-signal";
+const inputClass = "w-full rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary placeholder-text-secondary/50 focus:border-accent/50 focus:outline-none focus:ring-1 focus:ring-accent/30";

 function ShellBadge({ interpreter }: { interpreter: "bash" | "powershell" }) {
-  const isBash = interpreter === "bash";
-  return (
-    <span className={`rounded px-1.5 py-0.5 font-mono text-[10px] uppercase ${isBash ? "bg-bash/15 text-bash" : "bg-pwsh/15 text-pwsh"}`}>
-      {isBash ? "bash" : "pwsh"}
-    </span>
-  );
+    const isBash = interpreter === "bash";
+    return <span className={`rounded px-1.5 py-0.5 font-mono text-[10px] uppercase ${isBash ? "bg-bash/15 text-bash" : "bg-pwsh/15 text-pwsh"}`}>{isBash ? "bash" : "pwsh"}</span>;
 }

 export default function StepsPage() {
-  const qc = useQueryClient();
-  const { data: steps } = useQuery({ queryKey: ["steps"], queryFn: api.listSteps });
-  const { data: usage } = useQuery({ queryKey: ["step-usage"], queryFn: api.stepUsage });
+    const qc = useQueryClient();
+    const { data: steps, isLoading, error: loadError } = useQuery({ queryKey: ["steps"], queryFn: api.listSteps });
+    const { data: usage } = useQuery({ queryKey: ["step-usage"], queryFn: api.stepUsage });

-  const [search, setSearch] = useState("");
-  const [tab, setTab] = useState<Tab>("all");
-  const [editOpen, setEditOpen] = useState(false);
-  const [editing, setEditing] = useState<WorkflowStep | null>(null);
-  const [importing, setImporting] = useState(false);
-  const [syncing, setSyncing] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-  const [notice, setNotice] = useState<string | null>(null);
-  const fileRef = useRef<HTMLInputElement>(null);
+    const [search, setSearch] = useState("");
+    const [tab, setTab] = useState<Tab>("all");
+    const [editOpen, setEditOpen] = useState(false);
+    const [editing, setEditing] = useState<WorkflowStep | null>(null);
+    const [importing, setImporting] = useState(false);
+    const [syncing, setSyncing] = useState(false);
+    const [error, setError] = useState<string | null>(null);
+    const [notice, setNotice] = useState<string | null>(null);
+    const fileRef = useRef<HTMLInputElement>(null);

-  const rows = useMemo(() => {
-    const q = search.toLowerCase();
-    return (steps ?? []).filter((s) => {
-      const matchesText = s.name.toLowerCase().includes(q) || (s.description ?? "").toLowerCase().includes(q);
-      const matchesTab =
-        tab === "all" ||
-        (tab === "bash" && s.interpreter === "bash") ||
-        (tab === "powershell" && s.interpreter === "powershell") ||
-        (tab === "default" && s.source === "default") ||
-        (tab === "shared" && s.source !== "default");
-      return matchesText && matchesTab;
-    });
-  }, [steps, search, tab]);
+    const rows = useMemo(() => {
+        const q = search.toLowerCase();
+        return (steps ?? []).filter((s) => {
+            const matchesText = s.name.toLowerCase().includes(q) || (s.description ?? "").toLowerCase().includes(q);
+            const matchesTab =
+                tab === "all" ||
+                (tab === "bash" && s.interpreter === "bash") ||
+                (tab === "powershell" && s.interpreter === "powershell") ||
+                (tab === "default" && s.source === "default") ||
+                (tab === "shared" && s.source !== "default");
+            return matchesText && matchesTab;
+        });
+    }, [steps, search, tab]);

-  const openNew = () => {
-    setEditing(null);
-    setEditOpen(true);
-  };
-  const openEdit = (s: WorkflowStep) => {
-    setEditing(s);
-    setEditOpen(true);
-  };
+    const openNew = () => {
+        setEditing(null);
+        setEditOpen(true);
+    };
+    const openEdit = (s: WorkflowStep) => {
+        setEditing(s);
+        setEditOpen(true);
+    };

-  const onImport = async (e: React.ChangeEvent<HTMLInputElement>) => {
-    const file = e.target.files?.[0];
-    if (!file) return;
-    setImporting(true);
-    setError(null);
-    try {
-      const doc = JSON.parse(await file.text());
-      await api.importStep(doc);
-      qc.invalidateQueries({ queryKey: ["steps"] });
-      setNotice("Step imported.");
-    } catch (err) {
-      setError((err as Error).message);
-    } finally {
-      setImporting(false);
-      e.target.value = "";
-    }
-  };
+    const onImport = async (e: React.ChangeEvent<HTMLInputElement>) => {
+        const file = e.target.files?.[0];
+        if (!file) return;
+        setImporting(true);
+        setError(null);
+        try {
+            const doc = JSON.parse(await file.text());
+            await api.importStep(doc);
+            qc.invalidateQueries({ queryKey: ["steps"] });
+            setNotice("Step imported.");
+        } catch (err) {
+            setError((err as Error).message);
+        } finally {
+            setImporting(false);
+            e.target.value = "";
+        }
+    };

-  const onSync = async () => {
-    setSyncing(true);
-    setError(null);
-    try {
-      const { created, updated } = await api.seedDefaults();
-      qc.invalidateQueries({ queryKey: ["steps"] });
-      setNotice(`${created} created, ${updated} updated`);
-    } catch (err) {
-      setError((err as Error).message);
-    } finally {
-      setSyncing(false);
-    }
-  };
+    const onSync = async () => {
+        setSyncing(true);
+        setError(null);
+        try {
+            const { created, updated } = await api.seedDefaults();
+            qc.invalidateQueries({ queryKey: ["steps"] });
+            setNotice(`${created} created, ${updated} updated`);
+        } catch (err) {
+            setError((err as Error).message);
+        } finally {
+            setSyncing(false);
+        }
+    };

-  return (
-    <div className="p-4 sm:p-6 lg:p-8">
-      <div className="mb-6 flex items-center gap-3">
-        <div>
-          <h1 className="text-xl font-semibold text-text-primary">Steps</h1>
-          <p className="text-sm text-text-secondary">Reusable steps shared across all workflows.</p>
-        </div>
-        <div className="ml-auto flex items-center gap-2">
-          <input ref={fileRef} type="file" accept="application/json" className="hidden" onChange={onImport} />
-          <Button variant="secondary" size="sm" loading={syncing} onClick={onSync}>
-            Sync defaults
-          </Button>
-          <Button variant="secondary" size="sm" loading={importing} onClick={() => fileRef.current?.click()}>
-            Import
-          </Button>
-          <Button size="sm" onClick={openNew}>
-            + New step
-          </Button>
-        </div>
-      </div>
+    return (
+        <div className="p-4 sm:p-6 lg:p-8">
+            <div className="mb-6 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+                <div>
+                    <h1 className="text-2xl font-bold text-text-primary">Steps</h1>
+                    <p className="mt-1 text-sm text-text-secondary">
+                        {steps?.length ?? 0} step{steps?.length !== 1 ? "s" : ""} · reusable across all workflows
+                    </p>
+                </div>
+                <div className="flex items-center gap-2">
+                    <input ref={fileRef} type="file" accept="application/json" className="hidden" onChange={onImport} />
+                    <Button variant="ghost" size="sm" loading={syncing} onClick={onSync}>
+                        Sync defaults
+                    </Button>
+                    <Button variant="ghost" size="sm" loading={importing} onClick={() => fileRef.current?.click()}>
+                        Import
+                    </Button>
+                    <Button variant="primary" size="sm" onClick={openNew}>
+                        <svg className="h-4 w-4" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={2}>
+                            <path strokeLinecap="round" strokeLinejoin="round" d="M12 4.5v15m7.5-7.5h-15" />
+                        </svg>
+                        New step
+                    </Button>
+                </div>
+            </div>

-      {error && <div className="mb-4 rounded border border-danger/30 bg-danger/10 px-3 py-2 text-sm text-danger">{error}</div>}
-      {notice && <div className="mb-4 rounded border border-signal/30 bg-signal/10 px-3 py-2 text-sm text-signal">{notice}</div>}
+            {error && <div className="mb-4 rounded-lg border border-danger/30 bg-danger/10 px-3 py-2 text-sm text-danger">{error}</div>}
+            {notice && <div className="mb-4 rounded-lg border border-accent/30 bg-accent/10 px-3 py-2 text-sm text-accent">{notice}</div>}

-      <div className="mb-4 flex items-center gap-2">
-        <input className={`${inputClass} max-w-sm`} placeholder="Search steps…" value={search} onChange={(e) => setSearch(e.target.value)} />
-        <div className="flex gap-1.5">
-          {(["all", "bash", "powershell", "default", "shared"] as Tab[]).map((t) => (
-            <button
-              key={t}
-              onClick={() => setTab(t)}
-              className={`rounded-full border px-3 py-1 text-xs capitalize ${
-                tab === t ? "border-signal/50 bg-signal/15 text-signal" : "border-border bg-surface-2 text-text-secondary hover:text-text-primary"
-              }`}
-            >
-              {t === "powershell" ? "PowerShell" : t}
-            </button>
-          ))}
-        </div>
-      </div>
-
-      <div className="overflow-x-auto rounded-lg border border-border">
-        <table className="w-full text-sm">
-          <thead>
-            <tr className="border-b border-border text-left text-[11px] uppercase tracking-wide text-text-secondary">
-              <th className="px-4 py-2.5 font-bold">Name</th>
-              <th className="px-4 py-2.5 font-bold">Shell</th>
-              <th className="px-4 py-2.5 font-bold">Source</th>
-              <th className="px-4 py-2.5 font-bold">Outputs</th>
-              <th className="px-4 py-2.5 font-bold">Used by</th>
-              <th className="px-4 py-2.5 text-right font-bold">Actions</th>
-            </tr>
-          </thead>
-          <tbody>
-            {rows.map((s) => {
-              const count = usage?.[s.step_id] ?? 0;
-              return (
-                <tr key={s.step_id} className="border-b border-border last:border-0">
-                  <td className="px-4 py-3">
-                    <div className="font-medium text-text-primary">{s.name}</div>
-                    {s.description && <div className="text-xs text-text-secondary">{s.description}</div>}
-                  </td>
-                  <td className="px-4 py-3">
-                    <ShellBadge interpreter={s.interpreter} />
-                  </td>
-                  <td className="px-4 py-3">
-                    <span className="rounded bg-surface-2 px-1.5 py-0.5 font-mono text-[10px] uppercase text-text-secondary">
-                      {s.source === "default" ? "default" : "shared"}
-                    </span>
-                  </td>
-                  <td className="px-4 py-3">
-                    <div className="flex flex-wrap gap-1">
-                      {(s.declared_outputs ?? []).map((o) => (
-                        <span key={o} className="rounded border border-signal/35 px-1.5 py-0.5 font-mono text-[10px] text-signal">
-                          {o}
-                        </span>
-                      ))}
-                    </div>
-                  </td>
-                  <td className="px-4 py-3 text-text-secondary">
-                    {count === 0 ? "0" : `${count} workflow${count === 1 ? "" : "s"}`}
-                  </td>
-                  <td className="px-4 py-3 text-right">
-                    <div className="flex items-center justify-end gap-3 text-text-secondary">
-                      <button onClick={() => openEdit(s)} className="hover:text-text-primary">
-                        {s.source === "default" ? "View" : "Edit"}
-                      </button>
-                      <a href={api.exportStepUrl(s.step_id)} download className="hover:text-text-primary">
-                        Export
-                      </a>
-                      {s.source !== "default" && (
-                        <button onClick={() => openEdit(s)} className="hover:text-danger">
-                          Delete
+            <div className="mb-4 flex flex-col gap-2 sm:flex-row sm:items-center">
+                <input className={`${inputClass} sm:max-w-sm`} placeholder="Search steps…" value={search} onChange={(e) => setSearch(e.target.value)} />
+                <div className="flex flex-wrap gap-1.5">
+                    {(["all", "bash", "powershell", "default", "shared"] as Tab[]).map((t) => (
+                        <button
+                            key={t}
+                            type="button"
+                            onClick={() => setTab(t)}
+                            className={`rounded-full border px-3 py-1 text-xs capitalize transition-colors focus:outline-none focus-visible:ring-2 focus-visible:ring-accent ${
+                                tab === t ? "border-accent/50 bg-accent/10 text-accent" : "border-border bg-surface-2 text-text-secondary hover:border-accent/40 hover:text-text-primary"
+                            }`}
+                        >
+                            {t === "powershell" ? "PowerShell" : t}
                        </button>
-                      )}
-                    </div>
-                  </td>
-                </tr>
-              );
-            })}
-            {rows.length === 0 && (
-              <tr>
-                <td colSpan={6} className="px-4 py-8 text-center text-sm text-text-secondary">
-                  No steps found.
-                </td>
-              </tr>
-            )}
-          </tbody>
-        </table>
-      </div>
+                    ))}
+                </div>
+            </div>

-      <EditStepModal
-        key={editing?.step_id ?? "new"}
-        open={editOpen}
-        step={editing}
-        onClose={() => {
-          setEditOpen(false);
-          qc.invalidateQueries({ queryKey: ["steps"] });
-          qc.invalidateQueries({ queryKey: ["step-usage"] });
-        }}
-      />
-    </div>
-  );
+            <Card padding={false}>
+                {isLoading ? (
+                    <div className="flex items-center justify-center py-20">
+                        <div className="h-8 w-8 animate-spin rounded-full border-2 border-border border-t-accent" />
+                    </div>
+                ) : loadError ? (
+                    <div className="py-20 text-center text-danger">Failed to load steps. Is the backend running?</div>
+                ) : rows.length > 0 ? (
+                    <Table>
+                        <Thead>
+                            <Tr>
+                                <Th>Name</Th>
+                                <Th>Shell</Th>
+                                <Th>Source</Th>
+                                <Th>Outputs</Th>
+                                <Th>Used by</Th>
+                                <Th />
+                            </Tr>
+                        </Thead>
+                        <Tbody>
+                            {rows.map((s) => {
+                                const count = usage?.[s.step_id] ?? 0;
+                                return (
+                                    <Tr key={s.step_id}>
+                                        <Td label="Name">
+                                            <span>
+                                                <span className="block font-medium text-text-primary">{s.name}</span>
+                                                {s.description && <span className="mt-0.5 block text-xs text-text-secondary">{s.description}</span>}
+                                            </span>
+                                        </Td>
+                                        <Td label="Shell">
+                                            <ShellBadge interpreter={s.interpreter} />
+                                        </Td>
+                                        <Td label="Source">
+                                            <span className="rounded-sm border border-border bg-surface-2 px-1.5 py-0.5 font-mono text-[10px] uppercase text-text-secondary">
+                                                {s.source === "default" ? "default" : "shared"}
+                                            </span>
+                                        </Td>
+                                        <Td label="Outputs">
+                                            <span className="flex flex-wrap gap-1">
+                                                {(s.declared_outputs ?? []).length === 0 ? (
+                                                    <span className="text-text-tertiary">—</span>
+                                                ) : (
+                                                    (s.declared_outputs ?? []).map((o) => (
+                                                        <span key={o} className="rounded-sm border border-signal/35 px-1.5 py-0.5 font-mono text-[10px] text-signal">
+                                                            {o}
+                                                        </span>
+                                                    ))
+                                                )}
+                                            </span>
+                                        </Td>
+                                        <Td label="Used by">
+                                            <span className={count === 0 ? "text-text-tertiary" : "text-text-secondary"}>{count === 0 ? "unused" : `${count} workflow${count === 1 ? "" : "s"}`}</span>
+                                        </Td>
+                                        <Td>
+                                            <div className="flex items-center justify-end gap-2">
+                                                <Button variant="ghost" size="sm" onClick={() => openEdit(s)}>
+                                                    {s.source === "default" ? "View" : "Edit"}
+                                                </Button>
+                                                <a href={api.exportStepUrl(s.step_id)} download>
+                                                    <Button variant="ghost" size="sm">
+                                                        Export
+                                                    </Button>
+                                                </a>
+                                            </div>
+                                        </Td>
+                                    </Tr>
+                                );
+                            })}
+                        </Tbody>
+                    </Table>
+                ) : (
+                    <div className="py-20 text-center">
+                        <div className="mx-auto mb-4 flex h-12 w-12 items-center justify-center rounded-full bg-surface-2">
+                            <svg className="h-6 w-6 text-text-secondary" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.5}>
+                                <path strokeLinecap="round" strokeLinejoin="round" d="M6.75 7.5l3 2.25-3 2.25m4.5 0h3m-9 8.25h13.5A2.25 2.25 0 0021 18V6a2.25 2.25 0 00-2.25-2.25H5.25A2.25 2.25 0 003 6v12a2.25 2.25 0 002.25 2.25z" />
+                            </svg>
+                        </div>
+                        <p className="text-text-secondary">{steps && steps.length > 0 ? "No steps match that filter." : "No steps yet."}</p>
+                        {(!steps || steps.length === 0) && (
+                            <Button variant="primary" size="sm" className="mt-4" onClick={openNew}>
+                                Create your first step
+                            </Button>
+                        )}
+                    </div>
+                )}
+            </Card>
+
+            <EditStepModal
+                key={editing?.step_id ?? "new"}
+                open={editOpen}
+                step={editing}
+                onClose={() => {
+                    setEditOpen(false);
+                    qc.invalidateQueries({ queryKey: ["steps"] });
+                    qc.invalidateQueries({ queryKey: ["step-usage"] });
+                }}
+            />
+        </div>
+    );
 }
@@ -0,0 +1,189 @@
+"use client";
+
+import { useMemo, useState } from "react";
+import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+import { api, vulnerabilities, type FindingState, type Severity, type VulnFinding } from "@/lib/api";
+import { useAuth } from "@/components/AuthProvider";
+import { Button, Card } from "@/components/ui";
+import { AcceptDialog } from "@/components/vulnerabilities/AcceptDialog";
+import { DBFreshness } from "@/components/vulnerabilities/DBFreshness";
+import { PackageRow } from "@/components/vulnerabilities/PackageRow";
+import { SEVERITY_ORDER, SeverityBadge } from "@/components/vulnerabilities/SeverityVisuals";
+import { groupByPackage } from "@/lib/vulnPackages";
+
+/*
+ * The fleet vulnerability board.
+ *
+ * Grouped by package, defaulting to open findings, with database freshness
+ * always on screen. The three things this page must never do: imply freshness
+ * it does not have, present an unsupported distribution as clean, or make one
+ * upgrade look like several problems.
+ *
+ * The API groups by CVE; the rollup to packages happens here, in
+ * `lib/vulnPackages`, because a finding is still per-CVE everywhere it is
+ * stored, accepted or remediated.
+ */
+
+const STATES: FindingState[] = ["open", "accepted", "fixed"];
+
+export default function VulnerabilitiesPage() {
+    const { isAdmin } = useAuth();
+    const qc = useQueryClient();
+
+    const [state, setState] = useState<FindingState>("open");
+    const [severity, setSeverity] = useState<Severity | "">("");
+    const [accepting, setAccepting] = useState<VulnFinding | null>(null);
+
+    const groups = useQuery({
+        queryKey: ["vulnerabilities", state, severity],
+        queryFn: () => vulnerabilities.list({ state, severity: severity || undefined }),
+    });
+
+    const summary = useQuery({
+        queryKey: ["vulnerabilities", "summary"],
+        queryFn: () => vulnerabilities.summary(),
+    });
+
+    const servers = useQuery({ queryKey: ["servers"], queryFn: () => api.listServers() });
+
+    const packages = useMemo(() => groupByPackage(groups.data ?? []), [groups.data]);
+
+    const serverName = useMemo(() => {
+        const byId = new Map((servers.data ?? []).map((s) => [s.server_id, s.hostname]));
+        // Falls back to the raw id rather than an empty cell: an unnamed row is
+        // worse than an ugly one.
+        return (id: string) => byId.get(id) ?? id;
+    }, [servers.data]);
+
+    const invalidate = () => {
+        qc.invalidateQueries({ queryKey: ["vulnerabilities"] });
+    };
+
+    const rescan = useMutation({
+        mutationFn: () => vulnerabilities.rescan(),
+        onSuccess: invalidate,
+    });
+
+    const accept = useMutation({
+        mutationFn: ({ id, reason, until }: { id: string; reason: string; until: string }) => vulnerabilities.accept(id, reason, until),
+        onSuccess: () => {
+            setAccepting(null);
+            invalidate();
+        },
+    });
+
+    const unaccept = useMutation({
+        mutationFn: (id: string) => vulnerabilities.unaccept(id),
+        onSuccess: invalidate,
+    });
+
+    const applyUpdates = useMutation({
+        mutationFn: (serverId: string) => api.applyUpdates(serverId),
+    });
+
+    const counts = summary.data?.counts ?? {};
+    const total = SEVERITY_ORDER.reduce((n, s) => n + (counts[s] ?? 0), 0);
+
+    return (
+        <div className="p-4 sm:p-6 lg:p-8">
+            <div className="mb-6 flex flex-col gap-3 sm:flex-row sm:items-center sm:justify-between">
+                <div>
+                    <h1 className="text-2xl font-bold text-text-primary">Vulnerabilities</h1>
+                    <p className="mt-1 text-sm text-text-secondary">
+                        {total} open finding{total !== 1 ? "s" : ""} · installed packages matched against distribution security advisories
+                    </p>
+                </div>
+                {isAdmin && (
+                    <Button variant="secondary" loading={rescan.isPending} onClick={() => rescan.mutate()}>
+                        Rescan fleet
+                    </Button>
+                )}
+            </div>
+
+            <div className="mb-4">
+                <DBFreshness summary={summary.data} />
+            </div>
+
+            {/* Severity counts double as the filter. They are always the whole
+                fleet's open counts, never the filtered view's, so switching
+                state cannot make the fleet look better than it is. */}
+            <div className="mb-4 flex flex-wrap gap-2 rounded-lg border border-border bg-surface px-4 py-3 sm:px-5">
+                {SEVERITY_ORDER.map((s) => (
+                    <button
+                        key={s}
+                        onClick={() => setSeverity(severity === s ? "" : s)}
+                        aria-pressed={severity === s}
+                        className={`flex items-center gap-2 rounded-lg border px-2.5 py-1.5 text-left transition-colors ${
+                            severity === s ? "border-accent bg-surface-2" : "border-transparent hover:bg-surface-2"
+                        }`}
+                    >
+                        <SeverityBadge severity={s} />
+                        <span className="font-mono text-lg font-semibold tabular-nums text-text-primary">{counts[s] ?? 0}</span>
+                    </button>
+                ))}
+            </div>
+
+            <div className="mb-4 flex gap-2">
+                {STATES.map((s) => (
+                    <button
+                        key={s}
+                        onClick={() => setState(s)}
+                        aria-pressed={state === s}
+                        className={`rounded-lg border px-3 py-1.5 text-sm capitalize transition-colors ${
+                            state === s ? "border-accent text-accent" : "border-border text-text-secondary hover:text-text-primary"
+                        }`}
+                    >
+                        {s}
+                    </button>
+                ))}
+            </div>
+
+            {groups.error && (
+                <div className="mb-4 rounded-lg border border-danger/30 bg-danger/10 px-3 py-2 text-sm text-danger">
+                    {(groups.error as Error).message}
+                </div>
+            )}
+
+            <Card padding={false}>
+                {groups.isLoading ? (
+                    <div className="flex items-center justify-center py-20">
+                        <div className="h-8 w-8 animate-spin rounded-full border-2 border-border border-t-accent" />
+                    </div>
+                ) : packages.length > 0 ? (
+                    packages.map((g) => (
+                        <PackageRow
+                            key={g.package_name}
+                            group={g}
+                            serverName={serverName}
+                            canAct={isAdmin}
+                            onAccept={setAccepting}
+                            onUnaccept={(f) => unaccept.mutate(f.id)}
+                            onApplyUpdates={(serverId) => applyUpdates.mutate(serverId)}
+                            applying={applyUpdates.isPending ? (applyUpdates.variables as string) : undefined}
+                        />
+                    ))
+                ) : (
+                    <div className="px-6 py-14 text-center">
+                        <p className="text-[15px] font-semibold text-text-primary">
+                            No {state} findings{severity ? ` at ${severity} severity` : ""}.
+                        </p>
+                        <p className="mx-auto mt-2 max-w-[52ch] text-sm text-text-secondary">
+                            Servers report their packages hourly. A server whose distribution has no advisory feed is reported as unsupported
+                            on its own page rather than counted as clean here.
+                        </p>
+                    </div>
+                )}
+            </Card>
+
+            {accepting && (
+                <AcceptDialog
+                    finding={accepting}
+                    serverName={serverName(accepting.server_id)}
+                    pending={accept.isPending}
+                    onClose={() => setAccepting(null)}
+                    onAccept={(reason, until) => accept.mutate({ id: accepting.id, reason, until })}
+                />
+            )}
+        </div>
+    );
+}
@@ -8,9 +8,9 @@ import { api, Workflow, WorkflowStep, WorkflowStepRef, SecretGroupSummary } from
 import { Button } from "@/components/ui";
 import { EditWorkflowModal } from "@/components/workflows/EditWorkflowModal";
 import { StepPickerModal } from "@/components/workflows/StepPickerModal";
+import { resolveTargets } from "@/lib/targets";

-const inputClass =
-    "w-full rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary placeholder-text-secondary/50 focus:border-signal focus:outline-none focus:ring-1 focus:ring-signal";
+const inputClass = "w-full rounded-lg border border-border bg-surface-2 px-3 py-2 text-sm text-text-primary placeholder-text-secondary/50 focus:border-signal focus:outline-none focus:ring-1 focus:ring-signal";

 type DragPayload = { kind: "lib"; stepId: string } | { kind: "move"; from: number };

@@ -23,9 +23,6 @@ function AdhocBadge() {
    return <span className="rounded px-1.5 py-0.5 font-mono text-[10px] uppercase bg-signal/15 text-signal">ad-hoc</span>;
 }

-
-
-
 function snapshotOf(w: Workflow): string {
    return JSON.stringify({
        name: w.name,
@@ -66,11 +63,6 @@ export default function WorkflowBuilder() {
    const [editWorkflowOpen, setEditWorkflowOpen] = useState(false);
    const [dragOverZone, setDragOverZone] = useState<number | null>(null);
    const [pickerOpen, setPickerOpen] = useState(false);
-    // Rows rather than a map so a half-typed pair (a key with no value yet)
-    // survives a keystroke. Only complete pairs are written into wf.target_tags,
-    // which is what the debounced save persists.
-    const [tagRows, setTagRows] = useState<[string, string][]>([]);
-    const tagRowsSeeded = useRef(false);

    const { data: loaded } = useQuery({
        queryKey: ["workflow", id],
@@ -80,7 +72,6 @@ export default function WorkflowBuilder() {
    // The whole fleet, so the "runs on N servers" readout can be computed in the
    // browser rather than asking the server to resolve targets on every keystroke.
    const { data: servers } = useQuery({ queryKey: ["servers"], queryFn: () => api.listServers() });
-    const { data: knownTags } = useQuery({ queryKey: ["server-tags"], queryFn: () => api.listKnownTags(), staleTime: 60_000 });
    const { data: secretGroups } = useQuery({
        queryKey: ["secret-groups"],
        queryFn: api.listSecretGroups,
@@ -91,15 +82,8 @@ export default function WorkflowBuilder() {
            setWf(loaded);
            savedSnapshotRef.current = snapshotOf(loaded);
        }
-        if (loaded && !tagRowsSeeded.current) {
-            tagRowsSeeded.current = true;
-            setTagRows(Object.entries(loaded.target_tags ?? {}));
-        }
-        
    }, [loaded]);

-    
-    
    useEffect(() => {
        if (!secretGroups) return;
        secretGroups.forEach((g: SecretGroupSummary) => {
@@ -115,17 +99,10 @@ export default function WorkflowBuilder() {
                    setGroupKeys((prev) => ({ ...prev, [g.group]: [] }));
                });
        });
-        
    }, [secretGroups]);

-    
-    
    wfRef.current = wf;

-    
-    
-    
-    
    useEffect(() => {
        if (!wf || savedSnapshotRef.current === null) return;
        if (snapshotOf(wf) === savedSnapshotRef.current) return;
@@ -133,10 +110,8 @@ export default function WorkflowBuilder() {
            save();
        }, 800);
        return () => clearTimeout(t);
-        
    }, [wf]);

-    
    useEffect(() => {
        if (!lastSaved) return;
        const iv = setInterval(() => setTick((n) => n + 1), 15000);
@@ -151,27 +126,7 @@ export default function WorkflowBuilder() {

    const targetTags = wf.target_tags ?? {};

-    // Rows are the editing surface; the map is what is saved. Incomplete rows
-    // are dropped rather than saved half-written, which is also what keeps the
-    // readout below honest while someone is still typing a key.
-    const commitTagRows = (rows: [string, string][]) => {
-        setTagRows(rows);
-        setWf({ ...wf, target_tags: Object.fromEntries(rows.filter(([k, v]) => k && v)) });
-    };
-
-    /*
-     * This is the other half of a deliberate duplication: the authority is
-     * UnionTargets/MatchesTags in server/internal/services/targets.go, and this
-     * only exists so the designer can answer "how many servers?" without a
-     * round trip. It must stay identical in meaning — an EMPTY selector matches
-     * NOTHING (a cleared field must not become a fleet-wide run), and multiple
-     * tag keys AND together. Change one, change both.
-     */
-    const matched = (servers ?? []).filter(
-        (s) =>
-            wf.target_server_ids.includes(s.server_id) ||
-            (Object.keys(targetTags).length > 0 && Object.entries(targetTags).every(([k, v]) => s.tags?.[k] === v)),
-    );
+    const matched = resolveTargets(servers ?? [], wf.target_server_ids, targetTags);

    const sortedSteps = [...wf.steps].sort((a, b) => a.order - b.order);
    const selectedRef = selected !== null ? sortedSteps[selected] : null;
@@ -179,8 +134,6 @@ export default function WorkflowBuilder() {
    const selectedIdxInWf = selectedRef ? wf.steps.indexOf(selectedRef) : -1;

    const save = async () => {
-        
-        
        if (savingRef.current) return;
        const current = wfRef.current;
        if (!current) return;
@@ -196,14 +149,9 @@ export default function WorkflowBuilder() {
                return;
            }
            if (wfRef.current && snapshotOf(wfRef.current) === snapshot) {
-                
-                
                savedSnapshotRef.current = snapshotOf(updated);
                setWf(updated);
            } else {
-                
-                
-                
                savedSnapshotRef.current = snapshot;
            }
            setLastSaved(new Date());
@@ -212,8 +160,7 @@ export default function WorkflowBuilder() {
        } finally {
            savingRef.current = false;
            setSaving(false);
-            
-            
+
            if (wfRef.current && snapshotOf(wfRef.current) !== savedSnapshotRef.current) {
                setTimeout(() => save(), 0);
            }
@@ -367,11 +314,8 @@ export default function WorkflowBuilder() {
            <div className="flex flex-1 flex-col lg:grid lg:h-[calc(100dvh-53px)] lg:grid-cols-[1fr_320px]">
                {/* CENTER: canvas */}
                <main className="overflow-auto bg-background bg-[radial-gradient(circle_at_1px_1px,theme(colors.border)_1px,transparent_0)] bg-[length:22px_22px] p-4 sm:p-6 lg:p-8">
-                    <div className="pointer-events-none sticky top-0 z-10 flex justify-center pt-4">
-                        <button
-                            onClick={() => setPickerOpen(true)}
-                            className="pointer-events-auto inline-flex items-center gap-2 rounded bg-signal px-4 py-2.5 text-sm font-semibold text-signal-ink shadow-panel hover:bg-signal/90"
-                        >
+                    <div className="pointer-events-none sticky top-0 z-10 flex justify-center py-2">
+                        <button onClick={() => setPickerOpen(true)} className="pointer-events-auto inline-flex items-center gap-2 rounded bg-signal px-4 py-2.5 text-sm font-semibold text-signal-ink shadow-panel hover:bg-signal/90">
                            <span className="text-base leading-none">+</span> Add step
                        </button>
                    </div>
@@ -379,64 +323,27 @@ export default function WorkflowBuilder() {
                        <div className="mb-2 w-full rounded border border-border bg-surface p-3">
                            <div className="mb-2 text-[11px] font-bold uppercase tracking-wide text-text-secondary">Targets</div>

+                            {/* Read-only. Both halves of the selector are edited in
+                                EditWorkflowModal so there is one place to change what
+                                a workflow touches; this panel only reports the result. */}
                            <p className="mb-2 text-xs text-text-secondary">
-                                {wf.target_server_ids.length} named in <button type="button" onClick={() => setEditWorkflowOpen(true)} className="text-signal hover:underline focus:outline-none focus-visible:ring-2 focus-visible:ring-signal">Edit</button>, plus anything matching every tag below.
+                                {wf.target_server_ids.length} named{" "}
+                                <button type="button" onClick={() => setEditWorkflowOpen(true)} className="text-signal hover:underline focus:outline-none focus-visible:ring-2 focus-visible:ring-signal">
+                                    Edit
+                                </button>
                            </p>

-                            <datalist id="workflow-tag-keys">
-                                {Object.keys(knownTags ?? {}).map((k) => (
-                                    <option key={k} value={k} />
+                            <div className="flex flex-wrap gap-1.5">
+                                {Object.entries(targetTags).map(([k, v]) => (
+                                    <span key={k} className="rounded-sm border border-border bg-surface-2 px-1.5 py-0.5 font-mono text-[11px]">
+                                        <span className="text-text-tertiary">{k}</span>
+                                        <span className="text-text-tertiary">:</span>
+                                        <span className="text-text-secondary">{v}</span>
+                                    </span>
                                ))}
-                            </datalist>
-                            <datalist id="workflow-tag-values">
-                                {Object.values(knownTags ?? {})
-                                    .flat()
-                                    .map((v) => (
-                                        <option key={v} value={v} />
-                                    ))}
-                            </datalist>
-
-                            <div className="flex flex-col gap-2">
-                                {tagRows.map(([k, v], i) => (
-                                    <div key={i} className="flex items-center gap-2">
-                                        <input
-                                            list="workflow-tag-keys"
-                                            value={k}
-                                            onChange={(e) => commitTagRows(tagRows.map((row, j): [string, string] => (j === i ? [e.target.value, row[1]] : row)))}
-                                            placeholder="env"
-                                            className="w-28 rounded-lg border border-border bg-surface-2 px-2 py-1 font-mono text-xs text-text-primary focus:border-signal focus:outline-none"
-                                        />
-                                        <span className="font-mono text-text-tertiary">:</span>
-                                        <input
-                                            list="workflow-tag-values"
-                                            value={v}
-                                            onChange={(e) => commitTagRows(tagRows.map((row, j): [string, string] => (j === i ? [row[0], e.target.value] : row)))}
-                                            placeholder="prod"
-                                            className="w-32 rounded-lg border border-border bg-surface-2 px-2 py-1 font-mono text-xs text-text-primary focus:border-signal focus:outline-none"
-                                        />
-                                        <button
-                                            type="button"
-                                            onClick={() => commitTagRows(tagRows.filter((_, j) => j !== i))}
-                                            className="text-xs text-text-tertiary hover:text-danger focus:outline-none focus-visible:ring-2 focus-visible:ring-signal"
-                                            aria-label={`Remove ${k || "tag"}`}
-                                        >
-                                            Remove
-                                        </button>
-                                    </div>
-                                ))}
-                                {tagRows.length === 0 && <p className="text-xs text-text-secondary">No tag selector — only the named servers will run.</p>}
+                                {Object.keys(targetTags).length === 0 && <p className="text-xs text-text-secondary">No tag selector — only the named servers will run.</p>}
                            </div>

-                            {tagRows.length < 20 && (
-                                <button
-                                    type="button"
-                                    onClick={() => commitTagRows([...tagRows, ["", ""] as [string, string]])}
-                                    className="mt-2 text-xs text-signal hover:underline focus:outline-none focus-visible:ring-2 focus-visible:ring-signal"
-                                >
-                                    Add tag
-                                </button>
-                            )}
-
                            <p className="mt-3 font-mono text-xs text-text-secondary" title={matched.map((s) => s.hostname).join("\n")}>
                                Runs on {matched.length} {matched.length === 1 ? "server" : "servers"}
                            </p>
@@ -482,21 +389,14 @@ export default function WorkflowBuilder() {
                                            {lib && !ref.inline && <ShellBadge interpreter={lib.interpreter} />}
                                            {ref.inline && <AdhocBadge />}
                                        </div>
-                                        <pre className="max-h-16 overflow-hidden text-ellipsis whitespace-pre-wrap rounded border border-border bg-surface-2 p-2 font-mono text-xs text-text-secondary">
-                                            {script.slice(0, 200)}
-                                        </pre>
+                                        <pre className="max-h-16 overflow-hidden text-ellipsis whitespace-pre-wrap rounded border border-border bg-surface-2 p-2 font-mono text-xs text-text-secondary">{script.slice(0, 200)}</pre>
                                    </div>
                                    <DropZone pos={i + 1} />
                                </div>
                            );
                        })}
                        {sortedSteps.length === 0 && (
-                            <button
-                                onDragOver={(e) => e.preventDefault()}
-                                onDrop={(e) => handleDrop(e, 0)}
-                                onClick={() => setPickerOpen(true)}
-                                className="mt-2 w-full rounded border border-dashed border-border bg-surface py-6 text-sm text-text-secondary hover:border-signal/50 hover:text-text-primary"
-                            >
+                            <button onDragOver={(e) => e.preventDefault()} onDrop={(e) => handleDrop(e, 0)} onClick={() => setPickerOpen(true)} className="mt-2 w-full rounded border border-dashed border-border bg-surface py-6 text-sm text-text-secondary hover:border-signal/50 hover:text-text-primary">
                                + Add your first step
                            </button>
                        )}
@@ -504,11 +404,7 @@ export default function WorkflowBuilder() {
                </main>

                {/* RIGHT: inspector */}
-                <aside
-                    className={`overflow-auto border-border bg-surface p-4 lg:block lg:border-l ${
-                        selected === null || !selectedRef ? "hidden" : "block max-lg:border-t max-lg:max-h-[60dvh]"
-                    }`}
-                >
+                <aside className={`overflow-auto border-border bg-surface p-4 lg:block lg:border-l ${selected === null || !selectedRef ? "hidden" : "block max-lg:border-t max-lg:max-h-[60dvh]"}`}>
                    {selected === null || !selectedRef ? (
                        <p className="text-sm text-text-secondary">Select a step to configure it.</p>
                    ) : (
@@ -546,14 +442,9 @@ export default function WorkflowBuilder() {
                                    </div>
                                    <div>
                                        <label className="mb-1 block text-xs uppercase text-text-secondary">Command</label>
-                                        <textarea
-                                            className={`${inputClass} h-32 font-mono text-xs`}
-                                            value={selectedRef.inline.script}
-                                            onChange={(e) => updateInline(selectedIdxInWf, { script: e.target.value })}
-                                        />
+                                        <textarea className={`${inputClass} h-32 font-mono text-xs`} value={selectedRef.inline.script} onChange={(e) => updateInline(selectedIdxInWf, { script: e.target.value })} />
                                        <p className="mt-1 text-xs text-text-secondary">
-                                            Write <code className="text-signal">KEY=value</code> to <code className="text-signal">$WORKFLOW_ENV</code> to expose it to later steps. Outputs are derived
-                                            automatically on save.
+                                            Write <code className="text-signal">KEY=value</code> to <code className="text-signal">$WORKFLOW_ENV</code> to expose it to later steps. Outputs are derived automatically on save.
                                        </p>
                                    </div>
                                </div>
@@ -673,13 +564,7 @@ export default function WorkflowBuilder() {
                                {selectedRef.on_failure === "retry" && (
                                    <div className="mt-2">
                                        <label className="mb-1 block text-xs uppercase text-text-secondary">Max retries</label>
-                                        <input
-                                            type="number"
-                                            min={1}
-                                            className={inputClass}
-                                            value={selectedRef.max_retries}
-                                            onChange={(e) => updateRef(selectedIdxInWf, { max_retries: parseInt(e.target.value || "0", 10) })}
-                                        />
+                                        <input type="number" min={1} className={inputClass} value={selectedRef.max_retries} onChange={(e) => updateRef(selectedIdxInWf, { max_retries: parseInt(e.target.value || "0", 10) })} />
                                    </div>
                                )}
                            </div>
@@ -696,8 +581,8 @@ export default function WorkflowBuilder() {
                open={editWorkflowOpen}
                workflow={wf}
                onSaved={(w) => {
-                    
-                    
+                    // Snapshot first: the modal has just persisted name, targets
+                    // and tags, so the debounced autosave must not re-send them.
                    savedSnapshotRef.current = snapshotOf(w);
                    setWf(w);
                }}
@@ -69,11 +69,7 @@ const pillLed: Record<PillKind, string> = {
 function StatusPill({ status, small }: { status: string; small?: boolean }) {
    const kind = pillKind(status);
    return (
-        <span
-            className={`inline-flex items-center gap-2 rounded-full border font-mono font-semibold uppercase tracking-wide ${
-                small ? "px-2 py-0.5 text-[10px]" : "px-2.5 py-1 text-xs"
-            } ${pillClass[kind]}`}
-        >
+        <span className={`inline-flex items-center gap-2 rounded-full border font-mono font-semibold uppercase tracking-wide ${small ? "px-2 py-0.5 text-[10px]" : "px-2.5 py-1 text-xs"} ${pillClass[kind]}`}>
            <span className={`h-1.5 w-1.5 rounded-full ${pillLed[kind]}`} />
            {status}
        </span>
@@ -192,10 +188,7 @@ function StepList({ server, now }: { server: ServerRun; now: number }) {
                {server.steps.map((st) => {
                    const kind = cellKind(st.status);
                    return (
-                        <div
-                            key={st.order}
-                            className={`grid grid-cols-[20px_1fr_auto] items-center gap-2.5 rounded-lg px-3 py-2.5 text-[13px] hover:bg-surface-2 ${st.status === "running" ? "bg-accent/[0.06]" : ""}`}
-                        >
+                        <div key={st.order} className={`grid grid-cols-[20px_1fr_auto] items-center gap-2.5 rounded-lg px-3 py-2.5 text-[13px] hover:bg-surface-2 ${st.status === "running" ? "bg-accent/[0.06]" : ""}`}>
                            <span className="text-right font-mono text-[11px] text-text-secondary">{String(st.order + 1).padStart(2, "0")}</span>
                            <span className="flex items-center gap-2 font-medium text-text-primary">
                                <span className={`font-mono ${cellClass[kind].replace(/bg-\S+/, "")}`}>{cellGlyph[kind]}</span>
@@ -340,7 +333,7 @@ export default function RunDetail() {
    const ago = fmtDuration(now - startMs);

    return (
-        <div className="mx-auto max-w-[1180px] p-4 pb-16 sm:p-6 lg:p-8">
+        <div className="p-4 sm:p-6 lg:p-8">
            {/* identity bar */}
            <div className="flex flex-wrap items-start justify-between gap-6">
                <div>
@@ -7,6 +7,7 @@ import { useQuery, useMutation, useQueryClient } from "@tanstack/react-query";
 import { api, Workflow } from "@/lib/api";
 import { Button, Card } from "@/components/ui";
 import { Table, Thead, Tbody, Tr, Th, Td } from "@/components/ui";
+import { resolveTargets } from "@/lib/targets";

 export default function WorkflowsPage() {
    const qc = useQueryClient();
@@ -22,6 +23,11 @@ export default function WorkflowsPage() {
        queryFn: api.listWorkflows,
    });

+    // The fleet, so a tag-only workflow reports the servers it actually reaches.
+    // target_server_ids.length alone reads 0 for one, which is the count of the
+    // half of the selector it does not use.
+    const { data: servers } = useQuery({ queryKey: ["servers"], queryFn: () => api.listServers() });
+
    const { mutate: create, isPending } = useMutation({
        mutationFn: () => api.createWorkflow({ name: "Untitled workflow", target_server_ids: [], steps: [] }),
        onSuccess: (workflow) => {
@@ -75,9 +81,25 @@ export default function WorkflowsPage() {
                                        <span className="font-medium text-text-primary">{w.name}</span>
                                    </Td>
                                    <Td label="Targets">
-                                        <span className="text-text-secondary">
-                                            {w.target_server_ids.length} server{w.target_server_ids.length !== 1 ? "s" : ""}
-                                        </span>
+                                        {servers ? (
+                                            (() => {
+                                                const matched = resolveTargets(servers, w.target_server_ids, w.target_tags ?? {});
+                                                return (
+                                                    <span className="flex flex-wrap items-center gap-1.5">
+                                                        <span className={matched.length === 0 ? "text-danger" : "text-text-secondary"} title={matched.map((s) => s.hostname).join("\n")}>
+                                                            {matched.length} server{matched.length !== 1 ? "s" : ""}
+                                                        </span>
+                                                        {Object.entries(w.target_tags ?? {}).map(([k, v]) => (
+                                                            <span key={k} className="rounded-sm border border-border px-1.5 py-0.5 font-mono text-[10px] text-text-tertiary">
+                                                                {k}:{v}
+                                                            </span>
+                                                        ))}
+                                                    </span>
+                                                );
+                                            })()
+                                        ) : (
+                                            <span className="text-text-tertiary">…</span>
+                                        )}
                                    </Td>
                                    <Td label="Steps">
                                        <span className="text-text-secondary">{w.steps.length}</span>
@@ -121,9 +121,22 @@ function StepsIcon() {
    );
 }

+function ShieldIcon() {
+    return (
+        <svg className="h-5 w-5" fill="none" viewBox="0 0 24 24" stroke="currentColor" strokeWidth={1.5}>
+            <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                d="M11.998 2.25a.75.75 0 01.298.062l7.5 3.214a.75.75 0 01.454.69v5.034c0 4.63-2.94 8.75-7.5 10.25a.75.75 0 01-.5 0c-4.56-1.5-7.5-5.62-7.5-10.25V6.216a.75.75 0 01.454-.69l7.5-3.214a.75.75 0 01.294-.062zM12 8.25v3.75m0 3h.008v.008H12v-.008z"
+            />
+        </svg>
+    );
+}
+
 const navItems: NavItem[] = [
    { href: "/servers", label: "Servers", icon: <ServerIcon /> },
    { href: "/monitors", label: "Monitors", icon: <MonitorIcon /> },
+    { href: "/vulnerabilities", label: "Vulnerabilities", icon: <ShieldIcon /> },
    { href: "/keys", label: "SSH Keys", icon: <KeyIcon /> },
    { href: "/secrets", label: "Secrets", icon: <SecretIcon /> },
    { href: "/workflows", label: "Workflows", icon: <WorkflowIcon /> },
@@ -0,0 +1,86 @@
+"use client";
+
+import { useState } from "react";
+import { Button, Modal } from "@/components/ui";
+import type { VulnFinding } from "@/lib/api";
+
+/*
+ * Accepting a finding needs a reason and an expiry, and the API refuses without
+ * both. The expiry is the point: a permanent dismissal is where risk goes to be
+ * forgotten, and it is exactly what an auditor asks to see. This dialog says so
+ * in as many words, because someone clicking it a year later needs to know the
+ * finding will come back on its own.
+ */
+
+const DEFAULT_DAYS = 30;
+
+function defaultUntil(): string {
+    const d = new Date();
+    d.setDate(d.getDate() + DEFAULT_DAYS);
+    return d.toISOString().slice(0, 10);
+}
+
+interface Props {
+    finding: VulnFinding;
+    serverName: string;
+    onClose: () => void;
+    onAccept: (reason: string, untilISO: string) => void;
+    pending?: boolean;
+}
+
+export function AcceptDialog({ finding, serverName, onClose, onAccept, pending }: Props) {
+    const [reason, setReason] = useState("");
+    const [until, setUntil] = useState(defaultUntil());
+
+    const untilDate = new Date(`${until}T23:59:59`);
+    const validUntil = !Number.isNaN(untilDate.getTime()) && untilDate.getTime() > Date.now();
+    const canSubmit = reason.trim().length > 0 && validUntil && !pending;
+
+    return (
+        <Modal open onClose={onClose} title="Accept finding">
+            <div className="space-y-4">
+                <div className="rounded border border-border bg-well px-3 py-2 font-mono text-xs text-text-secondary">
+                    {finding.cve_id} · {finding.package_name} on {serverName}
+                    <br />
+                    {finding.fixed_in ? `fixed in ${finding.fixed_in}` : "no fix published"}
+                </div>
+
+                <label className="block">
+                    <span className="mb-1 block text-xs font-medium text-text-secondary">Reason</span>
+                    <textarea
+                        value={reason}
+                        onChange={(e) => setReason(e.target.value)}
+                        rows={3}
+                        placeholder="Why this cannot be fixed now"
+                        className="w-full rounded border border-border bg-surface px-3 py-2 text-sm text-text-primary placeholder:text-text-tertiary focus:border-accent focus:outline-none"
+                    />
+                </label>
+
+                <label className="block">
+                    <span className="mb-1 block text-xs font-medium text-text-secondary">Reopens on</span>
+                    <input
+                        type="date"
+                        value={until}
+                        onChange={(e) => setUntil(e.target.value)}
+                        className="w-full rounded border border-border bg-surface px-3 py-2 text-sm text-text-primary focus:border-accent focus:outline-none"
+                    />
+                    {!validUntil && <span className="mt-1 block text-xs text-danger">Pick a future date.</span>}
+                </label>
+
+                <p className="text-xs text-text-tertiary">
+                    The finding is hidden from counts and alerts until this date, then reopens automatically. Your name and reason are recorded in
+                    the audit log.
+                </p>
+
+                <div className="flex justify-end gap-2">
+                    <Button variant="secondary" onClick={onClose}>
+                        Cancel
+                    </Button>
+                    <Button disabled={!canSubmit} onClick={() => onAccept(reason.trim(), untilDate.toISOString())}>
+                        {pending ? "Accepting…" : "Accept"}
+                    </Button>
+                </div>
+            </div>
+        </Modal>
+    );
+}
@@ -0,0 +1,44 @@
+import type { VulnSummary } from "@/lib/api";
+import { ageHours, relativeTime } from "./SeverityVisuals";
+
+/*
+ * Database freshness sits with the findings, not in settings.
+ *
+ * A fleet scanned against a three-week-old database must say so where its
+ * findings are read. Quietly reporting "0 open" against stale data is the same
+ * class of lie as reporting zero findings for a distribution we hold no feed
+ * for — it looks exactly like good news.
+ */
+
+// Past this the banner stops being informational and starts being a warning.
+// trivy-db rebuilds every six hours, so a day without a successful pull already
+// means something is wrong.
+const STALE_AFTER_HOURS = 24;
+
+export function DBFreshness({ summary }: { summary?: VulnSummary }) {
+    if (!summary) return null;
+
+    const age = ageHours(summary.pulled_at);
+    const stale = age === null || age > STALE_AFTER_HOURS;
+
+    if (!stale && !summary.last_error) {
+        return (
+            <p className="font-mono text-[10px] uppercase tracking-[0.16em] text-text-tertiary">
+                Vulnerability database v{summary.db_version ?? "?"} · pulled {relativeTime(summary.pulled_at)}
+                {summary.last_full_scan_at && <> · last scan {relativeTime(summary.last_full_scan_at)}</>}
+            </p>
+        );
+    }
+
+    return (
+        <div className="rounded-lg border border-warning/50 bg-warning/10 px-4 py-3">
+            <p className="text-sm font-medium text-warning">
+                {age === null ? "No vulnerability database has been pulled yet" : `Vulnerability database is ${relativeTime(summary.pulled_at)}`}
+            </p>
+            <p className="mt-1 text-xs text-text-secondary">
+                Findings below are matched against that data. Counts may be incomplete until a fresh pull succeeds.
+            </p>
+            {summary.last_error && <p className="mt-2 break-words font-mono text-xs text-text-tertiary">{summary.last_error}</p>}
+        </div>
+    );
+}
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
mrhid6	d1769fc886	feat: Updated vuln style Chart Release / chart (push) Successful in 12s Details Server Deploy / deploy (push) Successful in 1m36s Details	2026-08-06 16:35:04 +01:00
mrhid6	6dced22499	fix: Fixed agent collect packages Chart Release / chart (push) Successful in 11s Details Server Deploy / deploy (push) Successful in 21s Details Agent Release / build (push) Successful in 58s Details Agent Release / msi (push) Successful in 1m34s Details	2026-08-06 16:20:34 +01:00
mrhid6	5cee53dc5f	feat: Better button description Chart Release / chart (push) Successful in 20s Details Server Deploy / deploy (push) Successful in 2m23s Details	2026-08-06 15:51:18 +01:00
mrhid6	81248bb159	style: bring the vulnerabilities page onto the house page shape Every other page under app/(app) opens with `p-4 sm:p-6 lg:p-8` and the layout adds none of its own, so this page alone sat flush against the shell edge. Its h1 was text-xl where every other page is text-2xl. The findings list was a stack of separately bordered cards; it is now rows inside one Card, separated by border-border-soft, matching the monitors and workflows lists. Loading is the shared spinner rather than a line of text, the error is the shared danger strip, and the empty state uses the same proportions as the monitors one.	2026-08-06 15:49:39 +01:00
mrhid6	6354d54de8	feat: added addon price to pricing page	2026-08-06 15:48:20 +01:00
mrhid6	da6d64f95c	fix: give the scratch server image a /tmp for the vulnerability database The runtime stage is FROM scratch, which has no /tmp, so vulnsched died at startup with "temp dir: stat /tmp: no such file or directory" and no scan ever ran. Nothing in the server wrote to a temporary directory before the trivy-db puller, which is why this only appeared now. scratch cannot mkdir its own, so the directory is staged in the builder at 1777 and copied in. Also corrects CLAUDE.md, which described this image as Alpine; the time/tzdata import it justifies is if anything more load-bearing on scratch.	2026-08-06 15:46:30 +01:00
mrhid6	9ba3d4a61f	feat: Vulnerability Scanning feature on license page Chart Release / chart (push) Successful in 12s Details Server Deploy / deploy (push) Successful in 1m20s Details	2026-08-06 15:40:13 +01:00
mrhid6	eee236a072	fix: tidy server go.mod for the vulnerability database dependencies Chart Release / chart (push) Successful in 12s Details Server Deploy / deploy (push) Canceled after 2m11s Details trivy-db, oras-go, the three version comparators and robfig/cron were recorded as indirect with an incomplete go.sum, which builds locally against a warm module cache but fails in CI with "updates to go.mod needed". trivy-db pulls testify into the build graph, and its hashes were missing entirely.	2026-08-06 15:18:57 +01:00
mrhid6	9df89e2db4	fix: surface vuln_scanning across licence, staff and pricing UI Chart Release / chart (push) Successful in 11s Details Server Deploy / deploy (push) Canceled after 59s Details The catalogue row alone was not enough; the feature was invisible in three places and mislabelled in a fourth. PlanConfigurator rendered every key that was not "console" as "Single sign-on", so the staff checkbox granting vulnerability scanning was labelled single sign-on. Feature wording was duplicated between the staff configurator and the purchase form and the copies had drifted, so it now lives in adminsite/lib/features.ts and both read from it. The customer licence panel showed raw keys; it now labels them. Pricing gains a comparison row. The add-on block with a monthly price is deliberately NOT added: that is a pricing decision, and the Paddle price IDs for the new catalogue rows have to be pasted in before it can be sold anyway.	2026-08-06 15:10:26 +01:00
mrhid6	f60c509b47	feat: vuln_scanning entitlement and documentation Chart Release / chart (push) Successful in 12s Details Server Deploy / deploy (push) Failing after 1m11s Details Agent Release / build (push) Successful in 1m0s Details Agent Release / msi (push) Successful in 2m18s Details Adds license.FeatureVulnScanning as the one name for the feature and a catalogue row per deployment/tier, following console and oidc: features are opt-in per customer, so no plan bundles it. Documents the subsystem in CLAUDE.md, including that ScopedCollections is the canonical registry instance deletion derives from — there is no separate deletion list, which the plan had wrong.	2026-08-06 14:44:11 +01:00
mrhid6	84dfcfeac7	feat: vulnerability findings UI Fleet board grouped by CVE, a per-server section on server detail, and alert rules beside the channels they consume. The server detail page has no tab pattern despite the plan saying to follow one, so this adds a section in the existing vertical stack. Three states are kept visually distinct because they are identical if handled carelessly and only one is good news: never reported, no advisory feed for the distribution, and scanned-and-clean. Database freshness sits with the findings rather than in settings for the same reason.	2026-08-06 14:40:37 +01:00
mrhid6	5dda3b5c4a	feat: vulnerability scanning pipeline, matcher, scheduler and API Completes tasks 10-15 and fixes what was outstanding: - vulndb.Pull implemented with oras-go, streaming the ~50MB layer and staging both files before replacing either, so a failed pull leaves the previous database intact rather than a half-written one. - db.go: Vulnerability.Severity is a string, not trivy Severity, so the int conversion did not compile. Severity now resolves vendor (highest when vendors disagree) then NVD then unknown, and CVSS is read too. - findings.go: added sweepFixedFindings plus the fleet query, severity counts, rescan flag and accept/unaccept the API needs. - vulnrules.go: added rule CRUD and the digest builder. ResolveTargets returns []models.Server, not []string, so filterByServers was wrong. - api/vulnerabilities.go was an empty file while handlers.go registered twelve routes against it; written, grouped by CVE. - shared/mail: added the missing sender. The templates were orphaned and the HTML one was a copy of the text one, defining "subject" (which html/template would escape) and emitting no markup. render.go parses every template in init(), so a bad one panics server, admin and sitesvc at boot — go build never runs init(), which is why nothing complained. - notify: digests dispatch through their own path so SMTP gets the digest template rather than arriving dressed as a monitor alert.	2026-08-06 14:33:46 +01:00
mrhid6	db64320bd8	feat: agent reports installed packages on the hourly loop SyncKeys now returns the whole response so the poll can carry CollectPackages; a separate RPC for one boolean would be a message every 30 seconds for a value that changes when a licence does. The flag is an atomic: the 30s poll writes it, the hourly package loop reads it, and they are different goroutines.	2026-08-06 13:21:13 +01:00
mrhid6	583f60771c	feat: store agent package reports and serve the collect flag VulnScanningEnabled reads GetLicenseState(...).Feature("vuln_scanning") and requires an active licence, never switching on tier. ReportPackages re-checks it server-side: the agent flag is the optimisation, this is the boundary.	2026-08-06 13:19:39 +01:00
mrhid6	a92c3190c2	feat: ReportPackages wire types with hash short-circuit The pb packages are hand-written, not protoc-generated, and the wire codec is JSON (encoding.RegisterCodec(JSONCodec{})). Field numbers in the .proto are documentation; JSON field names are the contract. Both pb packages edited by hand to match. SyncResponse.collect_packages is omitempty and absent decodes as false, so an older server leaves agents collecting nothing rather than collecting without a licence.	2026-08-06 13:17:44 +01:00
mrhid6	3a6d24fe0e	feat: models and indexes for package inventory and CVE findings Adds server_packages, vuln_findings and vuln_alert_rules to ScopedCollections rather than to a separate deletion list. purgeInstance derives its collection list from that registry, so instance deletion follows automatically and there is no second copy to drift.	2026-08-06 11:59:00 +01:00
mrhid6	c277ecff44	feat: agent collects installed packages per package manager	2026-08-06 11:56:41 +01:00
mrhid6	bd690c94c3	feat: agent parses /etc/os-release for distro identification	2026-08-06 11:55:45 +01:00
mrhid6	a22fdf197e	feat: map OS family and version to trivy-db advisory buckets	2026-08-06 11:55:01 +01:00
mrhid6	bd24b03cac	feat: version comparators for distro package ordering	2026-08-06 11:54:13 +01:00
mrhid6	3afc4ab012	docs: workload registry plan; remove tests from both plans Both plans now verify by build, vet and manual checks written into the tasks. Spec verification sections updated to match so they no longer describe tests that will not be written.	2026-08-06 11:27:37 +01:00
mrhid6	d1ac3e98ce	docs: design for the workload registry Agents enumerate Docker containers, compose stacks and systemd services; start/stop/restart and bounded log snapshots from the UI. Sub-project B, Linux only. Live log following stays in the console.	2026-08-06 11:11:26 +01:00
mrhid6	5bba54f3e5	fix: Fixed style layout on workflow run page	2026-08-06 10:50:31 +01:00
mrhid6	fe7bc300e2	docs: implementation plan for package inventory and CVE findings 17 tasks, TDD where the logic is pure. Corrects two spec claims: the server reads features via License.HasFeature rather than admin's entitlement directly, and shared/mail/render_test.go does not exist.	2026-08-06 10:49:10 +01:00
mrhid6	00c03c365d	docs: design for package inventory and CVE findings Agents report installed packages; the control plane matches them against trivy-db and raises findings that link to the existing ApplyUpdatesCmd patching path. Scoped to sub-project A, Linux only. Container registry, image scanning and compliance baselines are separate specs.	2026-08-06 10:33:54 +01:00
mrhid6	dc8dd3dd58	fix: Fixed step descriptions Chart Release / chart (push) Successful in 11s Details Server Deploy / deploy (push) Successful in 35s Details	2026-08-04 17:45:31 +01:00
mrhid6	85a8865892	feat: restyle the steps table and add 22 default steps Chart Release / chart (push) Successful in 11s Details Server Deploy / deploy (push) Successful in 2m46s Details	2026-08-04 17:34:18 +01:00
mrhid6	50a9ac5fdc	fix: count tag-matched servers in the workflows list	2026-08-04 17:28:01 +01:00
mrhid6	3388d2f895	fix: Fixed padding on add step button Chart Release / chart (push) Successful in 22s Details Server Deploy / deploy (push) Successful in 41s Details	2026-08-04 17:24:40 +01:00
mrhid6	3a77fc2abd	feat: edit target servers and tags together in the workflow modal	2026-08-04 17:21:12 +01:00
mrhid6	3d59836d0c	feat: dual list box for workflow target servers Chart Release / chart (push) Successful in 11s Details Server Deploy / deploy (push) Successful in 5m19s Details	2026-08-04 17:13:50 +01:00
mrhid6	d9184312aa	fix: schedule card placement, preview state, and scheduled-workflow docs	2026-08-04 17:08:11 +01:00
mrhid6	b9802e6b04	docs: Updated docs	2026-08-04 17:03:29 +01:00