Skip to content

Same agent Smaller bill. The tools and infrastructure to get more work from your AI. Fewer tokens. Less compute. Lower cost.

feat: add Trustabl scanner connectors with jobs and findings (#1586)

Aman Agarwalcc00e010c039
diff --git a/docs/docs.json b/docs/docs.json
index 77553651..ad0e5dd7 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -74,7 +74,8 @@
"pages": [
"latest/openlit/connectors/overview",
"latest/openlit/connectors/datasource",
- "latest/openlit/connectors/memory"
+ "latest/openlit/connectors/memory",
+ "latest/openlit/connectors/scanner"
]
}
]
@@ -304,6 +305,14 @@
"latest/openlit/developer-resources/api-reference/endpoint/api-keys/get",
"latest/openlit/developer-resources/api-reference/endpoint/api-keys/delete"
]
+ },
+ {
+ "group": "Scanner",
+ "pages": [
+ "latest/openlit/developer-resources/api-reference/endpoint/scanners/scan",
+ "latest/openlit/developer-resources/api-reference/endpoint/scanners/list",
+ "latest/openlit/developer-resources/api-reference/endpoint/scanners/findings"
+ ]
}
]
}
diff --git a/docs/latest/openlit/coding-agents/overview.mdx b/docs/latest/openlit/coding-agents/overview.mdx
index 8ed268c3..a5e388d7 100644
--- a/docs/latest/openlit/coding-agents/overview.mdx
+++ b/docs/latest/openlit/coding-agents/overview.mdx
@@ -30,6 +30,9 @@ You only need an OpenLIT instance and the `openlit` CLI on each developer's mach
<Card title="Troubleshooting" href="/latest/openlit/coding-agents/troubleshooting" icon='wrench'>
Diagnose a missing row, silent hooks, or a stale database config
</Card>
+ <Card title="Scanner connectors" href="/latest/openlit/connectors/scanner" icon='magnifying-glass'>
+ Scan the GitHub repo from `vcs.repository.url.full` with Trustabl and review findings on the session
+ </Card>
</CardGroup>
## Prerequisites
diff --git a/docs/latest/openlit/connectors/datasource.mdx b/docs/latest/openlit/connectors/datasource.mdx
index 031f1011..269cc5e1 100644
--- a/docs/latest/openlit/connectors/datasource.mdx
+++ b/docs/latest/openlit/connectors/datasource.mdx
@@ -165,6 +165,9 @@ See the [OpenPlait repository](https://github.com/openlit/openplait) for publish
<Card title="Memory connectors" href="/latest/openlit/connectors/memory" icon="brain">
Claude, Mem0, and Zep for agent memory.
</Card>
+ <Card title="Scanner connectors" href="/latest/openlit/connectors/scanner" icon="magnifying-glass">
+ Trustabl scans of GitHub repositories.
+ </Card>
<Card title="Signal routing" href="/latest/openlit/organisation/signal-routing" icon="route">
Bind traces, logs, and metrics independently.
</Card>
diff --git a/docs/latest/openlit/connectors/memory.mdx b/docs/latest/openlit/connectors/memory.mdx
index 3dc6ef3f..7b0189ab 100644
--- a/docs/latest/openlit/connectors/memory.mdx
+++ b/docs/latest/openlit/connectors/memory.mdx
@@ -157,6 +157,9 @@ Copy requires `connectors:update` (or equivalent memory mutation permission in e
<Card title="Data-source connectors" href="/latest/openlit/connectors/datasource" icon="database">
Tempo, Loki, Prometheus, Jaeger, and ClickHouse.
</Card>
+ <Card title="Scanner connectors" href="/latest/openlit/connectors/scanner" icon="magnifying-glass">
+ Trustabl scans of GitHub repositories.
+ </Card>
<Card title="Otter (AI Copilot)" href="/latest/openlit/chat/overview" icon="message">
Chat with Otter across OpenLIT surfaces.
</Card>
diff --git a/docs/latest/openlit/connectors/overview.mdx b/docs/latest/openlit/connectors/overview.mdx
index 636ca858..7a008171 100644
--- a/docs/latest/openlit/connectors/overview.mdx
+++ b/docs/latest/openlit/connectors/overview.mdx
@@ -1,7 +1,7 @@
---
title: 'Connectors'
sidebarTitle: 'Overview'
-description: 'Atomic integrations that connect OpenLIT to observability backends and external memory providers — scoped to projects and environments'
+description: 'Atomic integrations that connect OpenLIT to observability backends, memory stores, and scanners — scoped to projects and environments'
icon: 'plug'
---
@@ -14,18 +14,21 @@ Open **Connectors** from the sidebar under **Configuration → Connectors** (`/c
</Frame>
<Info>
-Connectors share one registry model across categories. **Data-source connectors** route telemetry reads; **memory connectors** connect OpenLIT to agent memory stores for browsing, editing, and Otter-powered search.
+Connectors share one registry model across categories. **Data-source connectors** route telemetry reads; **memory connectors** connect OpenLIT to agent memory stores; **scanner connectors** run Trustabl jobs against GitHub repositories.
</Info>
## Connector categories
-<CardGroup cols={2}>
+<CardGroup cols={3}>
<Card title="Data-source connectors" href="/latest/openlit/connectors/datasource" icon="database">
ClickHouse, Tempo, Loki, Prometheus, and Jaeger — read traces, logs, and metrics with per-signal routing.
</Card>
<Card title="Memory connectors" href="/latest/openlit/connectors/memory" icon="brain">
Claude, Mem0, and Zep — browse, search, write, and copy agent memories from the Memory page and Otter.
</Card>
+ <Card title="Scanner connectors" href="/latest/openlit/connectors/scanner" icon="magnifying-glass">
+ Trustabl — scan GitHub repositories for agent SDK, MCP, and policy findings.
+ </Card>
</CardGroup>
## Mental model
@@ -40,6 +43,7 @@ flowchart LR
bindL[logs binding]
bindM[metrics binding]
mem[memory connectors]
+ scan[scanner connectors]
end
proj --> env
bindT --> DS1[Tempo]
@@ -47,23 +51,26 @@ flowchart LR
bindM --> DS3[Prometheus]
mem --> M1[Mem0]
mem --> M2[Zep]
+ scan --> S1[Trustabl]
```
- **Atomic connectors** — one backend per connector instance. Never a multi-backend blob.
- **Project scope** — connectors are created on a project and partitioned by [environment](/latest/openlit/organisation/environments).
- **Data-source bindings** — traces, logs, and metrics bind independently. See [Signal routing](/latest/openlit/organisation/signal-routing).
- **Memory usage** — memory connectors power the **Memory** page (`/memory`) and Otter memory tools; they do not replace telemetry routing.
+- **Scanner usage** — scanner connectors power the **Scanner** page (`/scanner`) and Otter `get_scanner_findings`; they do not replace telemetry routing.
## Common actions
-| Action | Data-source | Memory |
-| --- | --- | --- |
-| Add / edit connector | Yes | Yes |
-| Store credentials | Vault (ClickHouse) or connector secret | Encrypted on connector |
-| Health check / test connection | Yes | Yes |
-| Validate AI signal | Yes (`gen_ai.*` markers) | — |
-| Bind signal | traces / logs / metrics | — |
-| Browse / search / write memories | — | Yes (capability-dependent) |
+| Action | Data-source | Memory | Scanner |
+| --- | --- | --- | --- |
+| Add / edit connector | Yes | Yes | Yes |
+| Store credentials | Vault (ClickHouse) or connector secret | Encrypted on connector | Encrypted on connector |
+| Health check / test connection | Yes | Yes | Yes (CLI installed) |
+| Validate AI signal | Yes (`gen_ai.*` markers) | — | — |
+| Bind signal | traces / logs / metrics | — | — |
+| Browse / search / write memories | — | Yes (capability-dependent) | — |
+| Run scan / list findings | — | — | Yes |
Enterprise audit logs record connector create, update, delete, test, bind, and unbind events. RBAC permissions are `connectors:read|create|update|delete|test|bind` (owner/admin by default).
diff --git a/docs/latest/openlit/connectors/scanner.mdx b/docs/latest/openlit/connectors/scanner.mdx
new file mode 100644
index 00000000..7ffcb26b
--- /dev/null
+++ b/docs/latest/openlit/connectors/scanner.mdx
@@ -0,0 +1,131 @@
+---
+title: 'Scanner connectors'
+sidebarTitle: 'Scanners'
+description: 'Connect Trustabl to scan GitHub repositories for agent SDK, MCP, and policy findings — then review jobs from Scanner and Otter'
+icon: 'magnifying-glass'
+---
+
+**Scanner connectors** attach OpenLIT to job-based code scanners. Use them to scan a GitHub repository, collect findings with severity and path, and join those results to coding-agent traces.
+
+Add scanner connectors from **Configuration → Connectors** (`/connectors`) under the **Scanners** category, or from the **Scanner** page (`/scanner`) when no connector exists yet. Connectors are scoped to the current [project](/latest/openlit/organisation/projects) and [environment](/latest/openlit/organisation/environments).
+
+<Info>
+Scanner connectors use the same atomic registry as [data-source](/latest/openlit/connectors/datasource) and [memory](/latest/openlit/connectors/memory) connectors. They do not participate in telemetry signal routing. GitHub tokens are encrypted on the connector instance.
+</Info>
+
+## Mental model
+
+```mermaid
+flowchart LR
+ subgraph proj [Project + environment]
+ SC[Scanner connector]
+ end
+ SC --> CLI[Trustabl CLI on the OpenLIT server]
+ CLI --> GH[GitHub repository]
+ SC --> ScanPage[Scanner page]
+ SC --> Otter[Otter get_scanner_findings]
+ ScanPage --> Jobs[Jobs and findings]
+```
+
+- **Atomic connectors** — one Trustabl scanner per connector instance, with its own target, defaults, and token.
+- **GitHub URL target** — v1 scans `https://github.com/owner/repo` only. Local filesystem paths are rejected.
+- **On-demand CLI** — OpenLIT installs a checksum-verified Trustabl release onto the server, then runs `trustabl scan`.
+- **Environment-scoped jobs** — jobs and findings stay on the connector for the selected environment.
+
+## Supported scanner connectors
+
+| Connector | Runtime | What it's for |
+| --- | --- | --- |
+| **Trustabl** | Trustabl CLI (`v0.1.8` pin, upgradable) | Scan agent SDKs and MCP servers for reliability and safety findings |
+
+## Add a Trustabl scanner
+
+<Steps>
+ <Step title="Select project and environment">
+ Use the header selectors for the target [project](/latest/openlit/organisation/projects) and [environment](/latest/openlit/organisation/environments).
+ </Step>
+ <Step title="Open Connectors or Scanner">
+ Go to **Configuration → Connectors** and choose **Add connector**, or open **Scanner** (`/scanner`) and add a connector from the empty state.
+ </Step>
+ <Step title="Pick Trustabl">
+ Select **Trustabl** from the **Scanners** category.
+ </Step>
+ <Step title="Set the repository and token">
+ Enter an `https://github.com/owner/repo` URL. Add `/tree/branch` to pin a branch, or set **Ref** separately. Add a GitHub token for private repositories.
+ </Step>
+ <Step title="Install the CLI and run a scan">
+ On the Scanner page, install the Trustabl CLI onto the OpenLIT server, then **Run scan**. Findings appear on the same page.
+ </Step>
+</Steps>
+
+<Tip>
+Rules source **Follow environment** maps this OpenLIT environment: production → signed production, staging → signed staging, development → unsigned git.
+</Tip>
+
+## Scanner page
+
+Once a connector is configured, **Scanner** (`/scanner`) provides:
+
+| Feature | Description |
+| --- | --- |
+| **Connector selector** | Switch between scanner connectors in the current environment |
+| **CLI runtime** | Install or upgrade the Trustabl CLI on the OpenLIT server |
+| **Run scan** | Run with connector defaults, or override flags for one job |
+| **Jobs** | Recent scans with status, score, duration, and error |
+| **Findings** | Severity, rule, path, and suggested fix for the selected job |
+
+## Scan parameters
+
+Connector defaults apply when you run with defaults. Override them for one job from **Run with new parameters**.
+
+| Setting | Purpose |
+| --- | --- |
+| **Repository URL** | GitHub repo to clone. `/tree/<ref>` is stripped for clone; use it only to pin a branch. |
+| **Ref** | Optional branch, tag, or commit |
+| **Detectors** | Comma-separated detector ids (for example `claude_sdk,mcp`). Blank runs all detectors. |
+| **Strict** | Mark the job failed if any finding is low or higher |
+| **Secret / vuln / license scan** | Extra Trustabl scans on repository files and dependencies |
+| **Rules source** | Follow environment, or pin Production (signed), Staging (signed), or Git (unsigned) |
+| **GitHub token** | Stored on the connector. Never sent in the scan request body. |
+
+## Coding agents and Otter
+
+Coding-agent spans stamp `vcs.repository.url.full`. OpenLIT matches that URL to the latest **succeeded** scan in the current project and environment (https, `git@`, `.git`, and `/tree/<ref>` forms).
+
+- The coding-agent **trace detail** page shows a **Scanner** tab when a repo URL is present.
+- Otter can call `get_scanner_findings` with the GitHub URL. Medium+ findings are listed first.
+
+## API
+
+Authenticate with an OpenLIT API key and send organisation, project, and environment headers. See [Settings → OpenAPI Spec](/latest/openlit/developer-resources/api-reference/introduction) for the interactive catalog.
+
+| Method | Path | Purpose |
+| --- | --- | --- |
+| `POST` | `/api/scanners/{id}/scan` | Run a scan. Optional JSON body overrides connector defaults. Returns `{ connector, job }` with findings. |
+| `GET` | `/api/scanners` | List connectors in this environment, including recent jobs and findings. |
+| `GET` | `/api/scanners/findings?repoUrl=` | Latest succeeded scan for a GitHub repository URL. |
+
+`POST /api/scanners/{id}/scan` can take several minutes (up to 300 seconds). A second scan is rejected while one is already running on the same connector.
+
+## Security
+
+- Scan targets are GitHub HTTPS URLs only. Local paths, SSH URLs with credentials, and whitespace are rejected.
+- Tokens are encrypted on the connector (`enc:v1:…`), redacted from jobs and API responses, and never logged.
+- The Trustabl CLI download is checksum-verified before install.
+
+## Related
+
+<CardGroup cols={2}>
+ <Card title="Connectors overview" href="/latest/openlit/connectors/overview" icon="plug">
+ Shared connector registry and project scope.
+ </Card>
+ <Card title="Data-source connectors" href="/latest/openlit/connectors/datasource" icon="database">
+ Tempo, Loki, Prometheus, Jaeger, and ClickHouse.
+ </Card>
+ <Card title="Memory connectors" href="/latest/openlit/connectors/memory" icon="brain">
+ Claude, Mem0, and Zep for agent memory.
+ </Card>
+ <Card title="Coding agents" href="/latest/openlit/coding-agents/overview" icon="code">
+ How coding-agent traces expose `vcs.repository.url.full`.
+ </Card>
+</CardGroup>
diff --git a/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/findings.mdx b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/findings.mdx
new file mode 100644
index 00000000..47f1e61b
--- /dev/null
+++ b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/findings.mdx
@@ -0,0 +1,10 @@
+---
+title: 'Get scan findings'
+openapi: 'GET /api/scanners/findings'
+---
+
+Return the latest **succeeded** scan in the current project and environment whose target matches `repoUrl`.
+
+Accepts `https://github.com/owner/repo`, `.git`, `/tree/<ref>`, and `[email protected]:owner/repo` forms. Medium+ findings are listed first. When no scan matches, `matched` is `false`.
+
+See [Scanner connectors](/latest/openlit/connectors/scanner) for setup.
diff --git a/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/list.mdx b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/list.mdx
new file mode 100644
index 00000000..7708c5cc
--- /dev/null
+++ b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/list.mdx
@@ -0,0 +1,10 @@
+---
+title: 'List scan jobs'
+openapi: 'GET /api/scanners'
+---
+
+List scanner connectors for the current project and environment. Each connector includes recent scan **jobs** and their **findings** — use this to read the data of a scan after [Run scan](/latest/openlit/developer-resources/api-reference/endpoint/scanners/scan).
+
+Secrets are never returned.
+
+See [Scanner connectors](/latest/openlit/connectors/scanner) for setup.
diff --git a/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scan.mdx b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scan.mdx
new file mode 100644
index 00000000..52e60b52
--- /dev/null
+++ b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scan.mdx
@@ -0,0 +1,10 @@
+---
+title: 'Run scan'
+openapi: 'POST /api/scanners/{id}/scan'
+---
+
+Start a Trustabl scan on a scanner connector. Missing body fields use the connector defaults. The response includes the finished **job** and its **findings**.
+
+Do not send a GitHub token in the body — the token stays on the connector. The request can take several minutes (up to 300 seconds).
+
+See [Scanner connectors](/latest/openlit/connectors/scanner) for setup.
diff --git a/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scanners.yml b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scanners.yml
new file mode 100644
index 00000000..af74e8ba
--- /dev/null
+++ b/docs/latest/openlit/developer-resources/api-reference/endpoint/scanners/scanners.yml
@@ -0,0 +1,254 @@
+openapi: 3.0.3
+info:
+ title: Scanner API
+ description: Run Trustabl scanner jobs and retrieve scan findings.
+ version: 1.0.0
+servers:
+ - url: http://localhost:3000
+paths:
+ /api/scanners/{id}/scan:
+ post:
+ summary: Run a scanner job
+ description: Start a Trustabl scan for the connector. Missing body fields fall back to connector defaults. Returns the finished job and findings.
+ operationId: runScannerJob
+ parameters:
+ - name: id
+ in: path
+ required: true
+ schema:
+ type: string
+ description: Scanner connector ID (`scanner:<uuid>`).
+ - name: x-openlit-organisation-id
+ in: header
+ required: false
+ schema:
+ type: string
+ - name: x-openlit-project-id
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: x-openlit-environment
+ in: header
+ required: true
+ schema:
+ type: string
+ example: production
+ requestBody:
+ required: false
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ target:
+ type: string
+ example: https://github.com/acme/checkout-agent
+ ref:
+ type: string
+ example: main
+ detectors:
+ type: string
+ example: claude_sdk,mcp
+ strict:
+ type: boolean
+ secretScan:
+ type: boolean
+ vulnScan:
+ type: boolean
+ licenseScan:
+ type: boolean
+ requireSigned:
+ type: boolean
+ rulesRepo:
+ type: string
+ rulesRef:
+ type: string
+ rulesSource:
+ type: string
+ enum: [environment, production, staging, git]
+ noRulesUpdate:
+ type: boolean
+ verbose:
+ type: boolean
+ responses:
+ '200':
+ description: Scan job result.
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ connector:
+ type: object
+ properties:
+ id:
+ type: string
+ name:
+ type: string
+ type:
+ type: string
+ job:
+ $ref: '#/components/schemas/ScannerJob'
+ '400':
+ description: Invalid JSON or scan parameters.
+ '401':
+ description: Unauthorized.
+ /api/scanners:
+ get:
+ summary: List scanner connectors and scan jobs
+ description: Return scanner connectors for the current project and environment, including recent jobs and findings.
+ operationId: listScannerJobs
+ parameters:
+ - name: x-openlit-organisation-id
+ in: header
+ required: false
+ schema:
+ type: string
+ - name: x-openlit-project-id
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: x-openlit-environment
+ in: header
+ required: true
+ schema:
+ type: string
+ example: production
+ responses:
+ '200':
+ description: Scanner connectors with recent jobs.
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ connectors:
+ type: array
+ items:
+ type: object
+ properties:
+ id:
+ type: string
+ name:
+ type: string
+ type:
+ type: string
+ environment:
+ type: string
+ jobs:
+ type: array
+ items:
+ $ref: '#/components/schemas/ScannerJob'
+ '401':
+ description: Unauthorized.
+ /api/scanners/findings:
+ get:
+ summary: Get latest scan findings for a repository
+ description: Return the latest succeeded scan in this environment whose target matches repoUrl.
+ operationId: getScannerFindings
+ parameters:
+ - name: repoUrl
+ in: query
+ required: true
+ schema:
+ type: string
+ example: https://github.com/acme/checkout-agent
+ - name: x-openlit-organisation-id
+ in: header
+ required: false
+ schema:
+ type: string
+ - name: x-openlit-project-id
+ in: header
+ required: true
+ schema:
+ type: string
+ - name: x-openlit-environment
+ in: header
+ required: true
+ schema:
+ type: string
+ example: production
+ responses:
+ '200':
+ description: Latest matching scan findings, or a miss when none exist.
+ content:
+ application/json:
+ schema:
+ type: object
+ properties:
+ matched:
+ type: boolean
+ repoKey:
+ type: string
+ nullable: true
+ connectorId:
+ type: string
+ jobId:
+ type: string
+ findings:
+ type: array
+ items:
+ type: object
+ properties:
+ ruleId:
+ type: string
+ severity:
+ type: string
+ path:
+ type: string
+ title:
+ type: string
+ url:
+ type: string
+ '400':
+ description: repoUrl is missing.
+ '401':
+ description: Unauthorized.
+components:
+ schemas:
+ ScannerJob:
+ type: object
+ properties:
+ id:
+ type: string
+ status:
+ type: string
+ enum: [queued, running, succeeded, failed, runtime-missing]
+ target:
+ type: string
+ ref:
+ type: string
+ cliVersion:
+ type: string
+ description: Trustabl CLI version used for this job.
+ example: v0.1.8
+ startedAt:
+ type: string
+ format: date-time
+ finishedAt:
+ type: string
+ format: date-time
+ findingCount:
+ type: integer
+ mediumPlusCount:
+ type: integer
+ findings:
+ type: array
+ items:
+ type: object
+ properties:
+ id:
+ type: string
+ ruleId:
+ type: string
+ severity:
+ type: string
+ path:
+ type: string
+ title:
+ type: string
+ error:
+ type: string
diff --git a/docs/latest/openlit/developer-resources/api-reference/introduction.mdx b/docs/latest/openlit/developer-resources/api-reference/introduction.mdx
index 8560b3f5..88defe79 100644
--- a/docs/latest/openlit/developer-resources/api-reference/introduction.mdx
+++ b/docs/latest/openlit/developer-resources/api-reference/introduction.mdx
@@ -27,6 +27,12 @@ description: 'OpenAPI specification for API Endpoints in OpenLIT'
href="/latest/openlit/developer-resources/api-reference/endpoint/manage-models/models"
>
</Card>
+ <Card
+ title="Scanner API"
+ icon="magnifying-glass"
+ href="/latest/openlit/developer-resources/api-reference/endpoint/scanners/scan"
+ >
+ </Card>
</CardGroup>
## Product surfaces
@@ -36,8 +42,9 @@ In addition to the SDK-facing endpoints above, the OpenLIT client ships an inter
- **AI Analysis** — `GET`/`POST /api/chat/improvement/{spanId}` for saved runs and streaming reviews of traces/spans
- **Ask Otter** — `/api/chat/*` for config, conversations, streaming messages, SQL execute, widgets, and usage
- **Telemetry** — logs, metrics, traces, exceptions, and span hierarchy APIs
+- **Scanner** — `POST /api/scanners/{id}/scan`, `GET /api/scanners`, and `GET /api/scanners/findings` for Trustabl jobs and findings
-See [AI Analysis](/latest/openlit/observability/telemetry/ai-analysis) and [Chat with Otter](/latest/openlit/chat/overview) for product docs.
+See [AI Analysis](/latest/openlit/observability/telemetry/ai-analysis), [Chat with Otter](/latest/openlit/chat/overview), and [Scanner connectors](/latest/openlit/connectors/scanner) for product docs.
## Request context headers
@@ -50,7 +57,7 @@ x-openlit-project-id: <project-id>
x-openlit-environment: production
```
-### Non-SDK APIs (telemetry, Ask Otter, AI Analysis, …)
+### Non-SDK APIs (telemetry, Ask Otter, AI Analysis, Scanner, …)
Use signal routing headers only. Do **not** send `x-openlit-database-config-id`. The API key still binds a vault/credential database config (middleware injects `x-database-config-id`).
diff --git a/docs/latest/openlit/organisation/environments.mdx b/docs/latest/openlit/organisation/environments.mdx
index 37ea0894..ecdeabb2 100644
--- a/docs/latest/openlit/organisation/environments.mdx
+++ b/docs/latest/openlit/organisation/environments.mdx
@@ -12,7 +12,7 @@ Organisation
└── Project
└── Environment (production | staging | …)
├── Database Config (ClickHouse app store)
- ├── Connectors (Tempo, Loki, Prometheus, Jaeger, …)
+ ├── Connectors (Tempo, Loki, Prometheus, Jaeger, Trustabl, …)
└── Signal routing (traces / logs / metrics bindings)
```
@@ -68,7 +68,7 @@ Environments are created when you add a Database Config or connector with a new
Env vars → ClickHouse Database Config per environment.
</Card>
<Card title="Connectors" href="/latest/openlit/connectors/overview" icon="plug">
- Data-source and memory connectors in OpenLIT.
+ Data-source, memory, and scanner connectors in OpenLIT.
</Card>
<Card title="Signal routing" href="/latest/openlit/organisation/signal-routing" icon="route">
Bind traces, logs, and metrics per environment.
diff --git a/docs/latest/openlit/organisation/overview.mdx b/docs/latest/openlit/organisation/overview.mdx
index b0e9eb14..c8db2406 100644
--- a/docs/latest/openlit/organisation/overview.mdx
+++ b/docs/latest/openlit/organisation/overview.mdx
@@ -11,7 +11,7 @@ Organisation
└── Project ← create / select a project first
└── Environment
├── Database Config (ClickHouse app store)
- ├── Connectors (data sources + memory)
+ ├── Connectors (data sources, memory, scanners)
└── Signal routing (traces / logs / metrics)
```
@@ -42,7 +42,7 @@ Every organisation has a default project. Existing installations are mapped to a
Add ClickHouse on a project (seeded from INIT_DB_* then managed in the UI).
</Card>
<Card title="Connectors" href="/latest/openlit/connectors/overview" icon="plug">
- Data-source and memory connectors on a project.
+ Data-source, memory, and scanner connectors on a project.
</Card>
<Card title="Signal routing" href="/latest/openlit/organisation/signal-routing" icon="route">
Bind traces, logs, and metrics independently per environment.
diff --git a/docs/latest/openlit/organisation/projects.mdx b/docs/latest/openlit/organisation/projects.mdx
index bbc344ef..de39a07c 100644
--- a/docs/latest/openlit/organisation/projects.mdx
+++ b/docs/latest/openlit/organisation/projects.mdx
@@ -5,14 +5,14 @@ sidebarTitle: 'Projects'
icon: 'folder'
---
-Everything under **Organisation → Projects** is project-scoped. You create a project first; then that project owns environments, ClickHouse **Database Configs**, **connectors** (data sources and memory), and **signal routing**.
+Everything under **Organisation → Projects** is project-scoped. You create a project first; then that project owns environments, ClickHouse **Database Configs**, **connectors** (data sources, memory, and scanners), and **signal routing**.
```text
Organisation
└── Project ← create this first
├── Environments
├── Database Configs (ClickHouse)
- ├── Connectors (data sources + memory)
+ ├── Connectors (data sources, memory, scanners)
└── Signal routing
```
@@ -57,7 +57,7 @@ Use **environments** (`production`, `staging`, …) inside a project when you ne
| --- | --- |
| **Environments** | Named partitions (`production`, `staging`, …) |
| **Database Configs** | ClickHouse app-store connections per environment |
-| **Connectors** | Data-source (Tempo, Loki, Prometheus, Jaeger, ClickHouse) and memory (Claude, Mem0, Zep) |
+| **Connectors** | Data-source (Tempo, Loki, Prometheus, Jaeger, ClickHouse), memory (Claude, Mem0, Zep), and scanner (Trustabl) |
| **Signal bindings** | Which connector serves traces / logs / metrics per environment |
<Frame>
@@ -78,7 +78,7 @@ Project access controls which organisation members can use a project. Existing o
Add ClickHouse connections on the project.
</Card>
<Card title="Connectors" href="/latest/openlit/connectors/overview" icon="plug">
- Data-source and memory connectors on the project.
+ Data-source, memory, and scanner connectors on the project.
</Card>
<Card title="Signal routing" href="/latest/openlit/organisation/signal-routing" icon="route">
Bind traces, logs, and metrics per environment.
diff --git a/src/client/public/images/connectors/trustabl.svg b/src/client/public/images/connectors/trustabl.svg
new file mode 100644
index 00000000..929223ed
--- /dev/null
+++ b/src/client/public/images/connectors/trustabl.svg
@@ -0,0 +1,9 @@
+<svg role="img" viewBox="0 0 33 33" fill="none" xmlns="http://www.w3.org/2000/svg">
+ <title>Trustabl</title>
+ <path d="M7.83203 27.2965C7.83203 27.2965 13.9258 32.9107 15.6724 32.9992C17.4191 33.0877 28.8391 25.8647 30.374 12.689C30.374 12.689 24.5704 18.431 24.4651 18.6819C24.3598 18.9329 20.611 26.3677 15.5794 28.4001L7.83203 27.2965Z" fill="#51C1B5"/>
+ <path d="M10.7638 19.5457L15.6778 24.0216L31.623 7.96218C31.623 7.96218 32.1148 7.20144 31.8302 6.37461C31.5457 5.54777 30.3289 4.82064 30.3289 4.82064C30.3289 4.82064 29.4293 4.62906 28.6484 5.1646C27.8675 5.70014 15.5736 18.2147 15.5736 18.2147L10.7627 19.5469L10.7638 19.5457Z" fill="#51C1B5"/>
+ <path d="M20.5575 0.167728C20.5575 0.167728 9.4893 -0.698322 6.96733 1.50546C6.96733 1.50546 5.29125 2.77596 4.93945 6.26817C4.93945 6.26817 9.49714 4.09128 14.0089 4.35009C18.5206 4.60889 20.5586 0.167728 20.5586 0.167728H20.5575Z" fill="#51C1B5"/>
+ <path d="M9.71979 0.444464C9.71979 0.444464 4.34087 1.25449 0.70973 3.9714C-0.400562 4.8016 -0.244827 9.46124 1.43686 10.9166C2.40374 11.7524 10.7629 19.5457 10.7629 19.5457C10.7629 19.5457 12.8748 19.8101 14.357 19.2455L15.5737 18.2136C15.5737 18.2136 5.1072 8.83607 5.00189 7.61711C4.89657 6.39814 5.6898 1.91552 9.71867 0.443344L9.71979 0.444464Z" fill="#51C1B5"/>
+ <path d="M17.8279 10.9256V6.14604C17.8279 6.14604 18.3309 4.25037 20.2176 4.50582C22.1044 4.76126 23.6393 5.308 24.5569 4.83185C25.4744 4.35569 25.9764 3.12551 25.0375 1.48529C24.0986 -0.154943 19.1107 -0.0361851 17.987 0.625956C16.8632 1.2881 14.1105 2.62359 13.7139 5.45477V12.1042C13.7139 12.1042 14.5385 13.9035 15.7025 13.7803C16.8666 13.657 17.3517 13.4016 17.81 12.307L17.8279 10.9267V10.9256Z" fill="#51C1B5"/>
+ <path d="M15.5794 28.4001C15.5794 28.4001 9.44984 24.379 7.47462 19.6074C7.47462 19.6074 6.3901 17.1907 4.30844 18.4612C4.30844 18.4612 2.52704 19.3788 3.49729 21.0896C4.46753 22.8004 6.57048 26.2052 7.87347 27.3335C7.87347 27.3335 11.1875 30.2083 15.5794 28.4001Z" fill="#51C1B5"/>
+</svg>
diff --git a/src/client/public/openapi.yaml b/src/client/public/openapi.yaml
index 48ae9082..53ec8203 100644
--- a/src/client/public/openapi.yaml
+++ b/src/client/public/openapi.yaml
@@ -16,7 +16,7 @@ info:
- `x-openlit-project-id` — active project (bindings are project-scoped)
- `x-openlit-environment` — active environment (drives signal routing)
- ### Non-SDK APIs (telemetry, Ask Otter, AI Analysis, …)
+ ### Non-SDK APIs (telemetry, Ask Otter, AI Analysis, Scanner, …)
Use signal routing headers only. Do **not** send
`x-openlit-database-config-id`. The API key still binds a vault/credential
database config (middleware injects `x-database-config-id`).
@@ -31,7 +31,7 @@ info:
## Authentication
All documented endpoints require Bearer API key auth (`ApiKeyAuth`).
- version: 1.28.0
+ version: 1.29.0
servers:
- url: http://localhost:3000
description: Local development server
@@ -54,6 +54,8 @@ tags:
description: Offline LLM evaluations
- name: API Keys
description: Manage browser/SDK access keys
+ - name: Scanner
+ description: Run Trustabl scanner jobs and retrieve findings for GitHub repositories
paths:
/api/telemetry/logs:
@@ -1419,6 +1421,112 @@ paths:
'401':
$ref: '#/components/responses/UnauthorizedError'
+ /api/scanners:
+ get:
+ tags:
+ - Scanner
+ summary: List scanner connectors and scan jobs
+ description: |
+ Return scanner connectors for the current project and environment, including
+ recent scan jobs and their findings. Use this to read the data of a scan after
+ `POST /api/scanners/{id}/scan`. Jobs are environment-scoped. Secrets are never
+ returned.
+ security:
+ - ApiKeyAuth: []
+ parameters:
+ - $ref: '#/components/parameters/OpenLitOrganisationId'
+ - $ref: '#/components/parameters/OpenLitProjectId'
+ - $ref: '#/components/parameters/OpenLitEnvironment'
+ responses:
+ '200':
+ description: Scanner connectors with recent jobs.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ScannerListResponse'
+ '401':
+ $ref: '#/components/responses/UnauthorizedError'
+
+ /api/scanners/{id}/scan:
+ post:
+ tags:
+ - Scanner
+ summary: Run a scanner job
+ description: |
+ Start a Trustabl scan for the connector. Missing body fields fall back to the
+ connector defaults. The scan target must be an `https://github.com/owner/repo`
+ URL (optional `/tree/<ref>`). Local filesystem paths are rejected.
+
+ The response includes the finished job and its findings. The request can take
+ several minutes (up to 300 seconds). A second scan is rejected while one is
+ already running on the same connector. Tokens stay on the connector and must
+ not be sent in the body.
+ security:
+ - ApiKeyAuth: []
+ parameters:
+ - $ref: '#/components/parameters/OpenLitOrganisationId'
+ - $ref: '#/components/parameters/OpenLitProjectId'
+ - $ref: '#/components/parameters/OpenLitEnvironment'
+ - name: id
+ in: path
+ required: true
+ description: Scanner connector ID (`scanner:<uuid>`).
+ schema:
+ type: string
+ example: scanner:3f1c9a2b-4d6e-4a11-9c8f-1b2a3c4d5e6f
+ requestBody:
+ required: false
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ScannerScanRequest'
+ responses:
+ '200':
+ description: Scan job result, including findings when the job finished.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ScannerScanResponse'
+ '400':
+ $ref: '#/components/responses/BadRequestError'
+ '401':
+ $ref: '#/components/responses/UnauthorizedError'
+
+ /api/scanners/findings:
+ get:
+ tags:
+ - Scanner
+ summary: Get latest scan findings for a repository
+ description: |
+ Return the latest succeeded scan in the current project and environment whose
+ target matches `repoUrl`. Accepts `https://github.com/owner/repo`, `.git`,
+ `/tree/<ref>`, and `[email protected]:owner/repo` forms. Medium+ findings are
+ listed first (up to 25). When no scan matches, `matched` is false.
+ security:
+ - ApiKeyAuth: []
+ parameters:
+ - $ref: '#/components/parameters/OpenLitOrganisationId'
+ - $ref: '#/components/parameters/OpenLitProjectId'
+ - $ref: '#/components/parameters/OpenLitEnvironment'
+ - name: repoUrl
+ in: query
+ required: true
+ description: GitHub repository URL from `vcs.repository.url.full` or the scanner target.
+ schema:
+ type: string
+ example: https://github.com/acme/checkout-agent
+ responses:
+ '200':
+ description: Latest matching scan findings, or a miss when none exist.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ScannerFindingsResponse'
+ '400':
+ $ref: '#/components/responses/BadRequestError'
+ '401':
+ $ref: '#/components/responses/UnauthorizedError'
+
components:
parameters:
OpenLitOrganisationId:
@@ -1448,7 +1556,7 @@ components:
description: |
Header parameter. Active project environment (for example `production` or `staging`).
Required for signal routing (traces/logs/metrics/intelligence connectors),
- AI Analysis, and Ask Otter SQL. Defaults to `production` on some routes
+ AI Analysis, Ask Otter SQL, and scanner jobs. Defaults to `production` on some routes
when omitted, which may hit the wrong source.
schema:
type: string
@@ -1759,6 +1867,265 @@ components:
type: string
format: date-time
+ ScannerFinding:
+ type: object
+ properties:
+ id:
+ type: string
+ ruleId:
+ type: string
+ example: MCP-004
+ severity:
+ type: string
+ example: medium
+ category:
+ type: string
+ scope:
+ type: string
+ toolName:
+ type: string
+ path:
+ type: string
+ example: src/mcp/server.ts
+ line:
+ type: integer
+ endLine:
+ type: integer
+ title:
+ type: string
+ message:
+ type: string
+ helpUrl:
+ type: string
+ fix:
+ type: string
+ confidence:
+ type: string
+
+ ScannerReportSummary:
+ type: object
+ properties:
+ scanId:
+ type: string
+ repo:
+ type: string
+ overallScore:
+ type: number
+ example: 0.72
+ rulesSource:
+ type: string
+ example: production
+ rulesVersion:
+ type: string
+ languages:
+ type: array
+ items:
+ type: string
+ sdks:
+ type: array
+ items:
+ type: string
+ toolCount:
+ type: integer
+ agentCount:
+ type: integer
+ mcpCount:
+ type: integer
+ vulnerabilityCount:
+ type: integer
+ secretCount:
+ type: integer
+ filesParsed:
+ type: integer
+ noAgentSurfaces:
+ type: boolean
+
+ ScannerScanParams:
+ type: object
+ description: Resolved Trustabl scan flags persisted on the job. Secrets are never included.
+ properties:
+ detectors:
+ type: string
+ example: claude_sdk,mcp
+ strict:
+ type: boolean
+ secretScan:
+ type: boolean
+ vulnScan:
+ type: boolean
+ licenseScan:
+ type: boolean
+ requireSigned:
+ type: boolean
+ rulesRepo:
+ type: string
+ rulesRef:
+ type: string
+ rulesSource:
+ type: string
+ enum: [production, staging, git]
+ noRulesUpdate:
+ type: boolean
+ verbose:
+ type: boolean
+
+ ScannerScanRequest:
+ type: object
+ description: |
+ Optional per-run overrides. Omitted fields use the scanner connector defaults.
+ Do not send GitHub tokens in this body.
+ properties:
+ target:
+ type: string
+ description: GitHub repository URL. Falls back to the connector setting.
+ example: https://github.com/acme/checkout-agent
+ ref:
+ type: string
+ description: Branch, tag, or commit. Falls back to the URL `/tree/<ref>` or the connector setting.
+ example: main
+ detectors:
+ type: string
+ strict:
+ type: boolean
+ secretScan:
+ type: boolean
+ vulnScan:
+ type: boolean
+ licenseScan:
+ type: boolean
+ requireSigned:
+ type: boolean
+ rulesRepo:
+ type: string
+ rulesRef:
+ type: string
+ rulesSource:
+ type: string
+ enum: [environment, production, staging, git]
+ noRulesUpdate:
+ type: boolean
+ verbose:
+ type: boolean
+
+ ScannerJob:
+ type: object
+ properties:
+ id:
+ type: string
+ status:
+ type: string
+ enum: [queued, running, succeeded, failed, runtime-missing]
+ target:
+ type: string
+ example: https://github.com/acme/checkout-agent
+ ref:
+ type: string
+ startedAt:
+ type: string
+ format: date-time
+ finishedAt:
+ type: string
+ format: date-time
+ durationMs:
+ type: integer
+ exitCode:
+ type: integer
+ error:
+ type: string
+ findingCount:
+ type: integer
+ mediumPlusCount:
+ type: integer
+ findings:
+ type: array
+ items:
+ $ref: '#/components/schemas/ScannerFinding'
+ params:
+ $ref: '#/components/schemas/ScannerScanParams'
+ report:
+ $ref: '#/components/schemas/ScannerReportSummary'
+ cliVersion:
+ type: string
+ example: v0.1.8
+
+ ScannerConnector:
+ type: object
+ properties:
+ id:
+ type: string
+ example: scanner:3f1c9a2b-4d6e-4a11-9c8f-1b2a3c4d5e6f
+ name:
+ type: string
+ type:
+ type: string
+ example: trustabl
+ environment:
+ type: string
+ example: production
+ settings:
+ type: string
+ description: JSON object of non-secret connector settings.
+ hasSecret:
+ type: boolean
+ category:
+ type: string
+ example: scanner
+ jobs:
+ type: array
+ items:
+ $ref: '#/components/schemas/ScannerJob'
+
+ ScannerListResponse:
+ type: object
+ properties:
+ connectors:
+ type: array
+ items:
+ $ref: '#/components/schemas/ScannerConnector'
+
+ ScannerScanResponse:
+ type: object
+ properties:
+ connector:
+ $ref: '#/components/schemas/ScannerConnector'
+ job:
+ $ref: '#/components/schemas/ScannerJob'
+
+ ScannerFindingsResponse:
+ type: object
+ properties:
+ matched:
+ type: boolean
+ repoKey:
+ type: string
+ nullable: true
+ example: github.com/acme/checkout-agent
+ connectorId:
+ type: string
+ connectorName:
+ type: string
+ jobId:
+ type: string
+ target:
+ type: string
+ ref:
+ type: string
+ scannedAt:
+ type: string
+ format: date-time
+ findingCount:
+ type: integer
+ mediumPlusCount:
+ type: integer
+ findings:
+ type: array
+ items:
+ $ref: '#/components/schemas/ScannerFinding'
+ url:
+ type: string
+ description: Scanner workspace deep link (`/scanner?connectorId=&jobId=`).
+ example: /scanner?connectorId=scanner%3Aabc&jobId=job%3A1
+
responses:
UnauthorizedError:
description: Authentication failed or credentials missing.
diff --git a/src/client/src/__tests__/app/api/scanners/route.test.ts b/src/client/src/__tests__/app/api/scanners/route.test.ts
new file mode 100644
index 00000000..2051c5b9
--- /dev/null
+++ b/src/client/src/__tests__/app/api/scanners/route.test.ts
@@ -0,0 +1,290 @@
+jest.mock("@/lib/session", () => ({
+ getCurrentUser: jest.fn(),
+}));
+jest.mock("@/lib/platform/connectors/scanner/crud", () => ({
+ listScannerConnectors: jest.fn(),
+ runScannerJob: jest.fn(),
+ getScannerCliRuntime: jest.fn(),
+ installScannerRuntime: jest.fn(),
+ listScannerJobFindings: jest.fn(),
+}));
+jest.mock("@/lib/platform/connectors/scanner/lookup", () => ({
+ lookupLatestScannerFindingsForRepo: jest.fn(),
+}));
+jest.mock("@/utils/asaw", () =>
+ jest.fn(async (promise: Promise<unknown>) => {
+ try {
+ return [null, await promise];
+ } catch (error) {
+ return [error, null];
+ }
+ })
+);
+
+import { GET } from "@/app/api/scanners/route";
+import { GET as GETFindings } from "@/app/api/scanners/findings/route";
+import { GET as GETJobFindings } from "@/app/api/scanners/[id]/jobs/[jobId]/findings/route";
+import { POST } from "@/app/api/scanners/[id]/scan/route";
+import { GET as GETRuntime, POST as POSTRuntime } from "@/app/api/scanners/runtime/route";
+import { POST as POSTInstall } from "@/app/api/scanners/[id]/install/route";
+import { getCurrentUser } from "@/lib/session";
+import {
+ getScannerCliRuntime,
+ installScannerRuntime,
+ listScannerConnectors,
+ listScannerJobFindings,
+ runScannerJob,
+} from "@/lib/platform/connectors/scanner/crud";
+import { lookupLatestScannerFindingsForRepo } from "@/lib/platform/connectors/scanner/lookup";
+import { SCANNER_INVALID_JSON, SCANNER_JOB_ID_INVALID, SCANNER_TARGET_REQUIRED } from "@/constants/messages/en";
+
+(globalThis as unknown as { Response: { json: unknown } }).Response = {
+ json: (body: unknown, init?: ResponseInit) => ({
+ status: init?.status ?? 200,
+ json: async () => body,
+ }),
+};
+
+function makeGetRequest() {
+ return { url: "http://localhost/api/scanners" } as any;
+}
+
+function makePostRequest(body: unknown) {
+ return {
+ text: async () => {
+ if (body === "__invalid__") return "{";
+ return JSON.stringify(body);
+ },
+ } as any;
+}
+
+describe("GET /api/scanners", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("requires authentication", async () => {
+ (getCurrentUser as jest.Mock).mockResolvedValue(null);
+ const response = await GET(makeGetRequest());
+ expect(response.status).toBe(401);
+ expect(listScannerConnectors).not.toHaveBeenCalled();
+ });
+
+ it("returns connectors without secretRef", async () => {
+ (listScannerConnectors as jest.Mock).mockResolvedValue([
+ { id: "scanner:abc", name: "Prod scan", hasSecret: true },
+ ]);
+ const response = await GET(makeGetRequest());
+ expect(response.status).toBe(200);
+ const body = await response.json();
+ expect(body.connectors[0].id).toBe("scanner:abc");
+ expect(JSON.stringify(body)).not.toContain("secretRef");
+ });
+});
+
+describe("POST /api/scanners/[id]/scan", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("requires authentication", async () => {
+ (getCurrentUser as jest.Mock).mockResolvedValue(null);
+ const response = await POST(makePostRequest({}), { params: { id: "scanner:abc" } });
+ expect(response.status).toBe(401);
+ expect(runScannerJob).not.toHaveBeenCalled();
+ });
+
+ it("rejects malformed JSON", async () => {
+ const response = await POST(makePostRequest("__invalid__"), {
+ params: { id: "scanner:abc" },
+ });
+ expect(response.status).toBe(400);
+ await expect(response.json()).resolves.toEqual({ err: SCANNER_INVALID_JSON });
+ expect(runScannerJob).not.toHaveBeenCalled();
+ });
+
+ it("forwards Trustabl scan flags to the job runner", async () => {
+ (runScannerJob as jest.Mock).mockResolvedValue({ job: { id: "job:1" } });
+ const response = await POST(
+ makePostRequest({
+ target: "https://github.com/acme/checkout-agent",
+ ref: "main",
+ detectors: "mcp",
+ strict: true,
+ secretScan: true,
+ rulesSource: "staging",
+ }),
+ { params: { id: "scanner:abc" } }
+ );
+ expect(response.status).toBe(200);
+ expect(runScannerJob).toHaveBeenCalledWith("scanner:abc", {
+ target: "https://github.com/acme/checkout-agent",
+ ref: "main",
+ detectors: "mcp",
+ strict: true,
+ secretScan: true,
+ vulnScan: undefined,
+ licenseScan: undefined,
+ requireSigned: undefined,
+ rulesRepo: undefined,
+ rulesRef: undefined,
+ rulesSource: "staging",
+ noRulesUpdate: undefined,
+ verbose: undefined,
+ });
+ });
+});
+
+describe("GET /api/scanners/runtime", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("requires authentication", async () => {
+ (getCurrentUser as jest.Mock).mockResolvedValue(null);
+ const response = await GETRuntime();
+ expect(response.status).toBe(401);
+ expect(getScannerCliRuntime).not.toHaveBeenCalled();
+ });
+
+ it("returns the server CLI runtime", async () => {
+ (getScannerCliRuntime as jest.Mock).mockResolvedValue({
+ installed: true,
+ version: "trustabl 0.1.8",
+ latestVersion: "v0.1.8",
+ });
+ const response = await GETRuntime();
+ expect(response.status).toBe(200);
+ const body = await response.json();
+ expect(body.runtime.version).toBe("trustabl 0.1.8");
+ });
+});
+
+describe("POST /api/scanners/runtime", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("rejects malformed JSON", async () => {
+ const response = await POSTRuntime(makePostRequest("__invalid__"));
+ expect(response.status).toBe(400);
+ await expect(response.json()).resolves.toEqual({ err: SCANNER_INVALID_JSON });
+ expect(installScannerRuntime).not.toHaveBeenCalled();
+ });
+});
+
+describe("POST /api/scanners/[id]/install", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("rejects malformed JSON", async () => {
+ const response = await POSTInstall(makePostRequest("__invalid__"), {
+ params: { id: "scanner:abc" },
+ });
+ expect(response.status).toBe(400);
+ await expect(response.json()).resolves.toEqual({ err: SCANNER_INVALID_JSON });
+ expect(installScannerRuntime).not.toHaveBeenCalled();
+ });
+});
+
+describe("GET /api/scanners/findings", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("requires authentication", async () => {
+ (getCurrentUser as jest.Mock).mockResolvedValue(null);
+ const response = await GETFindings({
+ url: "http://localhost/api/scanners/findings?repoUrl=https://github.com/acme/checkout-agent",
+ } as Request);
+ expect(response.status).toBe(401);
+ expect(lookupLatestScannerFindingsForRepo).not.toHaveBeenCalled();
+ });
+
+ it("requires a repo URL", async () => {
+ const response = await GETFindings({
+ url: "http://localhost/api/scanners/findings",
+ } as Request);
+ expect(response.status).toBe(400);
+ await expect(response.json()).resolves.toEqual({ err: SCANNER_TARGET_REQUIRED });
+ expect(lookupLatestScannerFindingsForRepo).not.toHaveBeenCalled();
+ });
+
+ it("returns the latest findings match for a repo", async () => {
+ (lookupLatestScannerFindingsForRepo as jest.Mock).mockResolvedValue({
+ matched: true,
+ repoKey: "github.com/acme/checkout-agent",
+ connectorId: "scanner:abc",
+ jobId: "job:1",
+ mediumPlusCount: 2,
+ });
+ const response = await GETFindings({
+ url: "http://localhost/api/scanners/findings?repoUrl=https://github.com/acme/checkout-agent",
+ } as Request);
+ expect(response.status).toBe(200);
+ const body = await response.json();
+ expect(body.matched).toBe(true);
+ expect(body.mediumPlusCount).toBe(2);
+ expect(lookupLatestScannerFindingsForRepo).toHaveBeenCalledWith({
+ repoUrl: "https://github.com/acme/checkout-agent",
+ });
+ });
+});
+
+describe("GET /api/scanners/[id]/jobs/[jobId]/findings", () => {
+ beforeEach(() => {
+ jest.clearAllMocks();
+ (getCurrentUser as jest.Mock).mockResolvedValue({ id: "user-1" });
+ });
+
+ it("requires authentication", async () => {
+ (getCurrentUser as jest.Mock).mockResolvedValue(null);
+ const response = await GETJobFindings(
+ { url: "http://localhost/api/scanners/scanner:abc/jobs/job:abee6854-450a-445d-98a9-8ed0076c05b7/findings" } as Request,
+ { params: { id: "scanner:abc", jobId: "job:abee6854-450a-445d-98a9-8ed0076c05b7" } }
+ );
+ expect(response.status).toBe(401);
+ expect(listScannerJobFindings).not.toHaveBeenCalled();
+ });
+
+ it("rejects an invalid job id", async () => {
+ const response = await GETJobFindings(
+ { url: "http://localhost/api/scanners/scanner:abc/jobs/../etc/passwd/findings" } as Request,
+ { params: { id: "scanner:abc", jobId: "../etc/passwd" } }
+ );
+ expect(response.status).toBe(400);
+ await expect(response.json()).resolves.toEqual({ err: SCANNER_JOB_ID_INVALID });
+ expect(listScannerJobFindings).not.toHaveBeenCalled();
+ });
+
+ it("forwards search, severity, and pagination to the job findings reader", async () => {
+ (listScannerJobFindings as jest.Mock).mockResolvedValue({
+ findings: [],
+ total: 0,
+ page: 1,
+ pageSize: 25,
+ counts: { all: 0, critical: 0, high: 0, medium: 0, low: 0 },
+ });
+ const jobId = "job:abee6854-450a-445d-98a9-8ed0076c05b7";
+ const response = await GETJobFindings(
+ {
+ url: `http://localhost/api/scanners/scanner:abc/jobs/${jobId}/findings?q=mcp&severity=high&page=2&limit=10`,
+ } as Request,
+ { params: { id: "scanner:abc", jobId } }
+ );
+ expect(response.status).toBe(200);
+ expect(listScannerJobFindings).toHaveBeenCalledWith("scanner:abc", jobId, {
+ q: "mcp",
+ severity: "high",
+ page: "2",
+ limit: "10",
+ });
+ });
+});
diff --git a/src/client/src/__tests__/lib/access/scanner-route.test.ts b/src/client/src/__tests__/lib/access/scanner-route.test.ts
new file mode 100644
index 00000000..2f2f9577
--- /dev/null
+++ b/src/client/src/__tests__/lib/access/scanner-route.test.ts
@@ -0,0 +1,21 @@
+import {
+ requireScannerAccess,
+ withScannerAccess,
+ withScannerAudit,
+} from "@/lib/access/scanner-route";
+
+describe("CE scanner route fallback", () => {
+ it("keeps handlers unchanged", async () => {
+ const handler = jest.fn().mockResolvedValue({ status: 204 });
+ const wrapped = withScannerAudit(withScannerAccess("scan", handler));
+
+ await wrapped({} as Request);
+
+ expect(handler).toHaveBeenCalledTimes(1);
+ expect(wrapped).toBe(handler);
+ });
+
+ it("allows library callers without enforcing RBAC", async () => {
+ await expect(requireScannerAccess("read")).resolves.toBeUndefined();
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/chat/schema-context.test.ts b/src/client/src/__tests__/lib/platform/chat/schema-context.test.ts
index f386303b..f56795f5 100644
--- a/src/client/src/__tests__/lib/platform/chat/schema-context.test.ts
+++ b/src/client/src/__tests__/lib/platform/chat/schema-context.test.ts
@@ -48,6 +48,7 @@ describe('getChatSystemPrompt', () => {
expect(prompt).toContain('add_memory');
expect(prompt).toContain('update_memory');
expect(prompt).toContain('delete_memory');
+ expect(prompt).toContain('get_scanner_findings');
});
it('includes entity links section', () => {
@@ -56,6 +57,7 @@ describe('getChatSystemPrompt', () => {
expect(prompt).toContain('/context/{id}');
expect(prompt).toContain('/prompt-hub/{id}');
expect(prompt).toContain('/memory?id={id}&connectorId={connectorId}');
+ expect(prompt).toContain('/scanner?connectorId={connectorId}&jobId={jobId}');
});
it('includes dashboard generation section', () => {
diff --git a/src/client/src/__tests__/lib/platform/chat/tools.test.ts b/src/client/src/__tests__/lib/platform/chat/tools.test.ts
index 749c6f6d..6ec1e941 100644
--- a/src/client/src/__tests__/lib/platform/chat/tools.test.ts
+++ b/src/client/src/__tests__/lib/platform/chat/tools.test.ts
@@ -90,6 +90,8 @@ const mockUpdateProjectMemory = jest.fn();
const mockDeleteProjectMemory = jest.fn();
const mockRequireMemoryAccess = jest.fn().mockResolvedValue(undefined);
const mockRecordMemoryMutationAudit = jest.fn().mockResolvedValue(undefined);
+const mockRequireScannerAccess = jest.fn().mockResolvedValue(undefined);
+const mockLookupLatestScannerFindingsForRepo = jest.fn();
jest.mock("@/lib/platform/connectors/memory/read", () => ({
queryProjectMemories: (...args: unknown[]) => mockQueryProjectMemories(...args),
}));
@@ -103,6 +105,13 @@ jest.mock("@/lib/access/memory-route", () => ({
recordMemoryMutationAudit: (...args: unknown[]) =>
mockRecordMemoryMutationAudit(...args),
}));
+jest.mock("@/lib/access/scanner-route", () => ({
+ requireScannerAccess: (...args: unknown[]) => mockRequireScannerAccess(...args),
+}));
+jest.mock("@/lib/platform/connectors/scanner/lookup", () => ({
+ lookupLatestScannerFindingsForRepo: (...args: unknown[]) =>
+ mockLookupLatestScannerFindingsForRepo(...args),
+}));
jest.mock("@/utils/sanitizer", () => ({
__esModule: true,
@@ -168,6 +177,7 @@ describe("getChatTools", () => {
jest.clearAllMocks();
mockRequireMemoryAccess.mockResolvedValue(undefined);
mockRecordMemoryMutationAudit.mockResolvedValue(undefined);
+ mockRequireScannerAccess.mockResolvedValue(undefined);
});
it("builds the expected tool set", () => {
@@ -194,6 +204,7 @@ describe("getChatTools", () => {
"add_memory",
"update_memory",
"delete_memory",
+ "get_scanner_findings",
])
);
expect(tools.create_rule.inputSchema.required).toEqual(["name"]);
@@ -1542,4 +1553,32 @@ describe("getChatTools", () => {
expect(mockAddProjectMemories).not.toHaveBeenCalled();
expect(mockRecordMemoryMutationAudit).not.toHaveBeenCalled();
});
+
+ it("looks up scanner findings for a coding-agent repo URL", async () => {
+ mockLookupLatestScannerFindingsForRepo.mockResolvedValue({
+ matched: true,
+ repoKey: "github.com/acme/checkout-agent",
+ connectorId: "scanner:abc",
+ jobId: "job:1",
+ mediumPlusCount: 2,
+ findingCount: 3,
+ url: "/scanner?connectorId=scanner%3Aabc&jobId=job%3A1",
+ findings: [{ id: "CSDK-010", ruleId: "CSDK-010", severity: "high", title: "Unsafe SDK" }],
+ });
+ const tools = getChatTools("user-1", "db-1", "staging") as any;
+
+ const result = await tools.get_scanner_findings.execute({
+ repo_url: "https://github.com/acme/checkout-agent",
+ });
+
+ expect(result.success).toBe(true);
+ expect(result.matched).toBe(true);
+ expect(result.mediumPlusCount).toBe(2);
+ expect(mockRequireScannerAccess).toHaveBeenCalledWith("read");
+ expect(mockLookupLatestScannerFindingsForRepo).toHaveBeenCalledWith({
+ repoUrl: "https://github.com/acme/checkout-agent",
+ environment: "staging",
+ });
+ expect(tools.get_scanner_findings.inputSchema.required).toEqual(["repo_url"]);
+ });
});
diff --git a/src/client/src/__tests__/lib/platform/connectors/bootstrap.test.ts b/src/client/src/__tests__/lib/platform/connectors/bootstrap.test.ts
index e604afae..41fa3349 100644
--- a/src/client/src/__tests__/lib/platform/connectors/bootstrap.test.ts
+++ b/src/client/src/__tests__/lib/platform/connectors/bootstrap.test.ts
@@ -1,5 +1,6 @@
const mockEnsureAdaptersRegistered = jest.fn();
const mockEnsureMemoryAdaptersRegistered = jest.fn();
+const mockEnsureScannerAdaptersRegistered = jest.fn();
jest.mock("@/lib/platform/connectors/datasource/bootstrap", () => ({
ensureAdaptersRegistered: (...a: unknown[]) => mockEnsureAdaptersRegistered(...a),
@@ -9,6 +10,11 @@ jest.mock("@/lib/platform/connectors/memory/bootstrap", () => ({
ensureMemoryAdaptersRegistered: (...a: unknown[]) => mockEnsureMemoryAdaptersRegistered(...a),
}));
+jest.mock("@/lib/platform/connectors/scanner/bootstrap", () => ({
+ ensureScannerAdaptersRegistered: (...a: unknown[]) =>
+ mockEnsureScannerAdaptersRegistered(...a),
+}));
+
import { ensureConnectorsRegistered } from "@/lib/platform/connectors/bootstrap";
beforeEach(() => {
@@ -16,18 +22,20 @@ beforeEach(() => {
});
describe("ensureConnectorsRegistered", () => {
- it("registers both datasource and memory connector categories", () => {
+ it("registers datasource, memory, and scanner connector categories", () => {
ensureConnectorsRegistered();
expect(mockEnsureAdaptersRegistered).toHaveBeenCalledTimes(1);
expect(mockEnsureMemoryAdaptersRegistered).toHaveBeenCalledTimes(1);
+ expect(mockEnsureScannerAdaptersRegistered).toHaveBeenCalledTimes(1);
});
- it("calls both registries again on every invocation", () => {
+ it("calls all registries again on every invocation", () => {
ensureConnectorsRegistered();
ensureConnectorsRegistered();
expect(mockEnsureAdaptersRegistered).toHaveBeenCalledTimes(2);
expect(mockEnsureMemoryAdaptersRegistered).toHaveBeenCalledTimes(2);
+ expect(mockEnsureScannerAdaptersRegistered).toHaveBeenCalledTimes(2);
});
});
diff --git a/src/client/src/__tests__/lib/platform/connectors/catalog.test.ts b/src/client/src/__tests__/lib/platform/connectors/catalog.test.ts
index 2cd180da..d0e736f2 100644
--- a/src/client/src/__tests__/lib/platform/connectors/catalog.test.ts
+++ b/src/client/src/__tests__/lib/platform/connectors/catalog.test.ts
@@ -1,6 +1,7 @@
const mockEnsureConnectorsRegistered = jest.fn();
const mockAvailableSourceTypeDescriptors = jest.fn();
const mockAvailableMemoryTypeDescriptors = jest.fn();
+const mockAvailableScannerTypeDescriptors = jest.fn();
const mockIsVisibleConnectorType = jest.fn();
const mockConnectorIconPath = jest.fn();
@@ -16,6 +17,10 @@ jest.mock("@/lib/platform/connectors/memory/crud", () => ({
availableMemoryTypeDescriptors: (...a: unknown[]) => mockAvailableMemoryTypeDescriptors(...a),
}));
+jest.mock("@/lib/platform/connectors/scanner/crud", () => ({
+ availableScannerTypeDescriptors: (...a: unknown[]) => mockAvailableScannerTypeDescriptors(...a),
+}));
+
jest.mock("@/lib/platform/connectors/visible-types", () => ({
isVisibleConnectorType: (...a: unknown[]) => mockIsVisibleConnectorType(...a),
}));
@@ -30,6 +35,7 @@ beforeEach(() => {
jest.clearAllMocks();
mockAvailableSourceTypeDescriptors.mockReturnValue([]);
mockAvailableMemoryTypeDescriptors.mockReturnValue([]);
+ mockAvailableScannerTypeDescriptors.mockReturnValue([]);
mockIsVisibleConnectorType.mockReturnValue(true);
});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-adapter.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-adapter.test.ts
new file mode 100644
index 00000000..f680884d
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-adapter.test.ts
@@ -0,0 +1,168 @@
+import { TrustablAdapter } from "@/lib/platform/connectors/scanner/trustabl/adapter";
+import {
+ __resetScannerProcessRunnerForTests,
+ setScannerProcessRunnerForTests,
+} from "@/lib/platform/connectors/scanner/process";
+
+jest.mock("@/lib/platform/connectors/scanner/runtime", () => ({
+ TRUSTABL_PINNED_VERSION: "v0.1.8",
+ probeTrustablRuntime: jest.fn(async () => ({
+ installed: true,
+ version: "trustabl 0.1.8",
+ source: "cache",
+ binaryVersion: "v0.1.8",
+ })),
+ resolveTrustablBinary: jest.fn(async () => ({ bin: "/opt/trustabl", source: "cache" })),
+ scannerCliVersionLabel: (runtime: { binaryVersion?: string; version?: string }) =>
+ runtime.binaryVersion || runtime.version,
+}));
+
+jest.mock("@/lib/platform/connectors/scanner/install", () => ({
+ describeTrustablRuntime: jest.fn(async () => ({
+ installed: true,
+ version: "trustabl 0.1.8",
+ source: "cache",
+ binaryVersion: "v0.1.8",
+ latestVersion: "v0.1.8",
+ upgradeAvailable: false,
+ })),
+ installTrustablCli: jest.fn(async () => ({
+ installed: true,
+ version: "trustabl 0.1.8",
+ source: "cache",
+ })),
+}));
+
+jest.mock("@/lib/platform/connectors/datasource/http/secret", () => ({
+ resolveSourceSecret: jest.fn(async () => ({ raw: "", credentials: {} })),
+}));
+
+describe("Trustabl adapter", () => {
+ afterEach(() => {
+ __resetScannerProcessRunnerForTests();
+ });
+
+ it("scans through the process runner and parses findings", async () => {
+ setScannerProcessRunnerForTests({
+ run: async ({ argv }) => {
+ expect(argv).toEqual([
+ "scan",
+ "https://github.com/acme/checkout-agent",
+ "--format",
+ "json",
+ "--no-progress",
+ "--no-color",
+ "--rules-source",
+ "production",
+ ]);
+ return {
+ exitCode: 1,
+ stdout: JSON.stringify({
+ scan_id: "abc",
+ overall_score: 0.72,
+ findings: [
+ { rule_id: "MCP-004", severity: "medium", path: "src/mcp/server.ts", title: "Unsandboxed tool" },
+ ],
+ }),
+ stderr: "",
+ };
+ },
+ });
+ const adapter = new TrustablAdapter({
+ type: "trustabl",
+ id: "scanner:1",
+ name: "scan",
+ environment: "production",
+ settings: { target: "https://github.com/acme/checkout-agent", requireSigned: false },
+ });
+ const job = await adapter.scan();
+ expect(job.status).toBe("succeeded");
+ expect(job.exitCode).toBe(1);
+ expect(job.findings?.[0].ruleId).toBe("MCP-004");
+ expect(job.report?.scanId).toBe("abc");
+ expect(job.report?.overallScore).toBe(0.72);
+ expect(job.params?.rulesSource).toBe("production");
+ expect(job.params?.requireSigned).toBe(false);
+ expect(job.cliVersion).toBe("v0.1.8");
+ });
+
+ it("lets per-run flags override connector defaults", async () => {
+ setScannerProcessRunnerForTests({
+ run: async ({ argv }) => {
+ expect(argv).toEqual([
+ "scan",
+ "https://github.com/acme/checkout-agent",
+ "--format",
+ "json",
+ "--no-progress",
+ "--no-color",
+ "--detectors",
+ "mcp",
+ "--strict",
+ "--secret-scan",
+ "--vuln-scan",
+ "--license-scan",
+ "--rules-repo",
+ "https://github.com/acme/rules",
+ "--rules-ref",
+ "v1",
+ "--rules-source",
+ "staging",
+ "--require-signed",
+ "--no-rules-update",
+ "--verbose",
+ ]);
+ return { exitCode: 0, stdout: "{}", stderr: "" };
+ },
+ });
+ const adapter = new TrustablAdapter({
+ type: "trustabl",
+ id: "scanner:1",
+ name: "scan",
+ environment: "production",
+ settings: {
+ target: "https://github.com/acme/checkout-agent",
+ ref: "main",
+ detectors: "claude_sdk",
+ strict: false,
+ requireSigned: false,
+ },
+ });
+ const job = await adapter.scan({
+ ref: "develop",
+ detectors: "mcp",
+ strict: true,
+ secretScan: true,
+ vulnScan: true,
+ licenseScan: true,
+ requireSigned: true,
+ rulesRepo: "https://github.com/acme/rules",
+ rulesRef: "v1",
+ rulesSource: "staging",
+ noRulesUpdate: true,
+ verbose: true,
+ });
+ expect(job.status).toBe("succeeded");
+ expect(job.ref).toBe("develop");
+ expect(job.params?.detectors).toBe("mcp");
+ });
+
+ it("treats exit code 2 as a scanner failure", async () => {
+ setScannerProcessRunnerForTests({
+ run: async () => ({
+ exitCode: 2,
+ stdout: "",
+ stderr: "no usable rules",
+ }),
+ });
+ const adapter = new TrustablAdapter({
+ type: "trustabl",
+ id: "scanner:1",
+ name: "scan",
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ });
+ const job = await adapter.scan();
+ expect(job.status).toBe("failed");
+ expect(job.error).toMatch(/no usable rules/);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-bootstrap.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-bootstrap.test.ts
new file mode 100644
index 00000000..0b842bcf
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-bootstrap.test.ts
@@ -0,0 +1,62 @@
+import {
+ __resetScannerBootstrapForTests,
+ ensureScannerAdaptersRegistered,
+} from "@/lib/platform/connectors/scanner/bootstrap";
+import {
+ __resetScannerRegistryForTests,
+ createScannerAdapter,
+ hasScannerAdapterFactory,
+ listScannerTypeDescriptors,
+} from "@/lib/platform/connectors/scanner/registry";
+import {
+ __resetConnectorRegistryForTests,
+ listConnectorTypes,
+} from "@/lib/platform/connectors/registry";
+import { TrustablAdapter } from "@/lib/platform/connectors/scanner/trustabl/adapter";
+import type { ScannerSourceDescriptor } from "@/lib/platform/connectors/scanner/types";
+
+jest.mock("@/lib/session", () => ({ getCurrentUser: jest.fn() }));
+
+beforeEach(() => {
+ __resetScannerRegistryForTests();
+ __resetScannerBootstrapForTests();
+ __resetConnectorRegistryForTests();
+});
+
+describe("scanner connector bootstrap", () => {
+ it("registers Trustabl exactly once", () => {
+ ensureScannerAdaptersRegistered();
+ ensureScannerAdaptersRegistered();
+ expect(hasScannerAdapterFactory("trustabl")).toBe(true);
+ expect(listScannerTypeDescriptors().map((item) => item.type)).toEqual(["trustabl"]);
+ });
+
+ it("creates a Trustabl adapter from a descriptor", () => {
+ ensureScannerAdaptersRegistered();
+ const descriptor: ScannerSourceDescriptor = {
+ type: "trustabl",
+ id: "scanner:1",
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ name: "Trustabl",
+ };
+ expect(createScannerAdapter(descriptor)).toBeInstanceOf(TrustablAdapter);
+ });
+
+ it("exposes scanner types through the generic connector registry", () => {
+ ensureScannerAdaptersRegistered();
+ expect(listConnectorTypes("scanner").map((item) => item.type)).toEqual(["trustabl"]);
+ expect(listConnectorTypes("memory")).toHaveLength(0);
+ });
+
+ it("every registered type exposes a valid config schema", () => {
+ ensureScannerAdaptersRegistered();
+ for (const descriptor of listScannerTypeDescriptors()) {
+ expect(descriptor.configFields.length).toBeGreaterThan(0);
+ for (const field of descriptor.configFields) {
+ expect(field.key).toBeTruthy();
+ expect(field.label).toBeTruthy();
+ expect(["settings", "credentials"]).toContain(field.group);
+ }
+ }
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-cli-schema.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-cli-schema.test.ts
new file mode 100644
index 00000000..7fed7d4b
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-cli-schema.test.ts
@@ -0,0 +1,83 @@
+import {
+ humanizeScannerFlag,
+ keyFromFlag,
+ parseTrustablScanHelp,
+ schemaAllowsFlag,
+ scannerCliSchemaFromHelp,
+} from "@/lib/platform/connectors/scanner/cli-schema";
+import { trustablConfigFields } from "@/lib/platform/connectors/scanner/config-fields";
+import { buildScannerScanArgv } from "@/lib/platform/connectors/scanner/scan-params";
+
+const HELP = `
+Scan a GitHub repository or local path.
+
+Flags:
+ --detectors string comma-separated detector categories (default: all)
+ --format string output format: human|json|sarif (default "human")
+ -o, --output string write the report to a file
+ --strict exit 1 on any finding of low severity or higher
+ --secret-scan scan all text files for hardcoded secrets
+ --sbom-scan generate an SBOM and attach inventory findings
+ --rules-source string rules source: git, production, staging
+ --channel string deprecated alias for --rules-source
+ --require-signed refuse unsigned rules (default true)
+ --json-out string also write JSON to this file
+ --attest sign the JSON report
+ -h, --help help for scan
+
+Global Flags:
+ -v, --verbose verbose diagnostics
+`;
+
+describe("Trustabl CLI schema", () => {
+ it("parses scan help into form fields and hides blocked or deprecated flags", () => {
+ const flags = parseTrustablScanHelp(HELP);
+ expect(flags.map((item) => item.flag)).toEqual([
+ "detectors",
+ "strict",
+ "secret-scan",
+ "sbom-scan",
+ "rules-source",
+ "require-signed",
+ "verbose",
+ ]);
+ expect(flags.find((item) => item.flag === "sbom-scan")).toMatchObject({
+ key: "sbomScan",
+ kind: "boolean",
+ });
+ expect(flags.find((item) => item.flag === "require-signed")?.defaultValue).toBe(true);
+ expect(flags.some((item) => item.flag === "format" || item.flag === "channel")).toBe(false);
+ });
+
+ it("adds new CLI flags to the connector form and keeps OpenLIT-owned fields", () => {
+ const schema = scannerCliSchemaFromHelp(HELP, "v0.2.0");
+ const keys = trustablConfigFields(schema).map((field) => field.key);
+ expect(keys).toContain("target");
+ expect(keys).toContain("githubToken");
+ expect(keys).toContain("sbomScan");
+ expect(keys).not.toContain("jsonOut");
+ expect(humanizeScannerFlag("sbom-scan")).toBe("Sbom Scan");
+ expect(keyFromFlag("secret-scan")).toBe("secretScan");
+ });
+
+ it("only forwards extra flags the installed CLI advertised", () => {
+ const schema = scannerCliSchemaFromHelp(HELP);
+ expect(schemaAllowsFlag(schema, "sbom-scan")).toBe(true);
+ expect(schemaAllowsFlag(undefined, "sbom-scan")).toBe(false);
+ expect(
+ buildScannerScanArgv(
+ "https://github.com/acme/repo",
+ { extras: { sbomScan: true, jsonOut: "/tmp/out.json" } },
+ schema
+ )
+ ).toEqual([
+ "scan",
+ "https://github.com/acme/repo",
+ "--format",
+ "json",
+ "--no-progress",
+ "--no-color",
+ "--sbom-scan",
+ ]);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-crud.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-crud.test.ts
new file mode 100644
index 00000000..88e756bd
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-crud.test.ts
@@ -0,0 +1,235 @@
+const mockFindFirst = jest.fn();
+const mockFindMany = jest.fn();
+const mockCreate = jest.fn();
+const mockUpdate = jest.fn();
+const mockDelete = jest.fn();
+const mockGetCurrentOrganisation = jest.fn();
+const mockGetCurrentProjectForOrganisation = jest.fn();
+const mockHasScannerAdapterFactory = jest.fn();
+const mockGetScannerTypeDescriptor = jest.fn();
+const mockCreateScannerAdapter = jest.fn();
+
+jest.mock("@/lib/prisma", () => ({
+ __esModule: true,
+ default: {
+ connectorInstance: {
+ findFirst: (...a: unknown[]) => mockFindFirst(...a),
+ findMany: (...a: unknown[]) => mockFindMany(...a),
+ create: (...a: unknown[]) => mockCreate(...a),
+ update: (...a: unknown[]) => mockUpdate(...a),
+ delete: (...a: unknown[]) => mockDelete(...a),
+ },
+ },
+}));
+
+jest.mock("@/lib/organisation", () => ({
+ getCurrentOrganisation: (...a: unknown[]) => mockGetCurrentOrganisation(...a),
+ getCurrentProjectForOrganisation: (...a: unknown[]) =>
+ mockGetCurrentProjectForOrganisation(...a),
+}));
+
+jest.mock("@/lib/project-environment", () => ({
+ createProjectEnvironment: jest.fn().mockResolvedValue({ id: "env-1" }),
+}));
+
+jest.mock("next/headers", () => ({
+ headers: jest.fn(async () => ({
+ get: () => null,
+ })),
+}));
+
+jest.mock("@/utils/crypto", () => ({
+ encryptValue: (value: string) => `enc:v1:${value}`,
+ decryptValue: (value: string) => String(value).replace(/^enc:v1:/, ""),
+ isEncrypted: (value: string) => String(value).startsWith("enc:v1:"),
+}));
+
+jest.mock("@/lib/access/connector-entitlement", () => ({
+ assertPremiumConnectorAllowed: jest.fn().mockResolvedValue(undefined),
+}));
+
+jest.mock("@/lib/platform/connectors/scanner/bootstrap", () => ({
+ ensureScannerAdaptersRegistered: jest.fn(),
+}));
+
+jest.mock("@/lib/platform/connectors/scanner/registry", () => ({
+ hasScannerAdapterFactory: (...a: unknown[]) => mockHasScannerAdapterFactory(...a),
+ getScannerTypeDescriptor: (...a: unknown[]) => mockGetScannerTypeDescriptor(...a),
+ createScannerAdapter: (...a: unknown[]) => mockCreateScannerAdapter(...a),
+ listScannerTypeDescriptors: jest.fn().mockReturnValue([]),
+}));
+
+jest.mock("@/lib/platform/connectors/datasource/http/secret", () => ({
+ invalidateSourceSecretCache: jest.fn(),
+}));
+
+import {
+ createScannerConnector,
+ deleteScannerConnector,
+ healthCheckScannerConnector,
+ isScannerConnectorId,
+ listScannerConnectors,
+ runScannerJob,
+ updateScannerConnector,
+} from "@/lib/platform/connectors/scanner/crud";
+
+const row = (over: Record<string, unknown> = {}) => ({
+ id: "scanner:abc",
+ category: "scanner",
+ type: "trustabl",
+ name: "Prod scan",
+ environment: "production",
+ organisationId: "org-1",
+ projectId: "proj-1",
+ settings: '{"target":"https://github.com/acme/checkout-agent"}',
+ secretRef: 'enc:v1:{"githubToken":"gho-secret"}',
+ status: "active",
+ metadata: '{"category":"scanner","jobs":[]}',
+ createdAt: new Date(),
+ updatedAt: new Date(),
+ ...over,
+});
+
+beforeEach(() => {
+ jest.clearAllMocks();
+ mockGetCurrentOrganisation.mockResolvedValue({ id: "org-1" });
+ mockGetCurrentProjectForOrganisation.mockResolvedValue({ id: "proj-1" });
+ mockHasScannerAdapterFactory.mockReturnValue(true);
+ mockGetScannerTypeDescriptor.mockReturnValue({ type: "trustabl" });
+ mockFindFirst.mockResolvedValue(null);
+});
+
+describe("scanner connector CRUD", () => {
+ it("identifies scanner connector ids", () => {
+ expect(isScannerConnectorId("scanner:abc")).toBe(true);
+ expect(isScannerConnectorId("memory:abc")).toBe(false);
+ });
+
+ it("creates a project-scoped scanner connector and encrypts credentials", async () => {
+ mockCreate.mockResolvedValue(row());
+ const created = await createScannerConnector({
+ name: "Prod scan",
+ type: "trustabl",
+ environment: "production",
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ credentials: { githubToken: "gho-secret" },
+ });
+ expect(mockCreate.mock.calls[0][0].data).toEqual(
+ expect.objectContaining({
+ category: "scanner",
+ type: "trustabl",
+ projectId: "proj-1",
+ secretRef: 'enc:v1:{"githubToken":"gho-secret"}',
+ })
+ );
+ expect(created).not.toHaveProperty("secretRef");
+ expect(JSON.stringify(created)).not.toContain("gho-secret");
+ });
+
+ it("rejects a missing name", async () => {
+ await expect(createScannerConnector({ type: "trustabl" })).rejects.toThrow(
+ /name is required/i
+ );
+ expect(mockCreate).not.toHaveBeenCalled();
+ });
+
+ it("rejects an unknown type", async () => {
+ mockHasScannerAdapterFactory.mockReturnValue(false);
+ await expect(
+ createScannerConnector({
+ name: "X",
+ type: "unknown-scanner",
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ })
+ ).rejects.toThrow(/unknown scanner connector/i);
+ });
+
+ it("rejects a duplicate name in the same environment", async () => {
+ mockFindFirst.mockResolvedValue({ id: "scanner:existing" });
+ await expect(
+ createScannerConnector({
+ name: "Prod scan",
+ type: "trustabl",
+ environment: "production",
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ })
+ ).rejects.toThrow(/already exists/);
+ expect(mockCreate).not.toHaveBeenCalled();
+ });
+
+ it("rejects local filesystem targets", async () => {
+ await expect(
+ createScannerConnector({
+ name: "Prod scan",
+ type: "trustabl",
+ settings: { target: "/etc/passwd" },
+ })
+ ).rejects.toThrow(/github/i);
+ expect(mockCreate).not.toHaveBeenCalled();
+ });
+
+ it("updates settings without exposing the secret", async () => {
+ mockFindFirst.mockResolvedValue(row());
+ mockUpdate.mockResolvedValue(row());
+ const updated = await updateScannerConnector("scanner:abc", {
+ settings: { target: "https://github.com/acme/checkout-agent" },
+ });
+ expect(updated).not.toHaveProperty("secretRef");
+ expect(updated.hasSecret).toBe(true);
+ });
+
+ it("deletes only a scanner connector in the current project", async () => {
+ mockFindFirst.mockResolvedValue(row());
+ mockDelete.mockResolvedValue(row());
+ await expect(deleteScannerConnector("abc")).resolves.toEqual({ ok: true });
+ expect(mockFindFirst).toHaveBeenCalledWith(
+ expect.objectContaining({
+ where: expect.objectContaining({
+ id: "scanner:abc",
+ projectId: "proj-1",
+ category: "scanner",
+ }),
+ })
+ );
+ });
+
+ it("health-checks through the registered adapter", async () => {
+ mockFindFirst.mockResolvedValue(row());
+ mockCreateScannerAdapter.mockReturnValue({
+ healthCheck: async () => ({ ok: true, latencyMs: 12 }),
+ });
+ await expect(healthCheckScannerConnector("scanner:abc")).resolves.toEqual({
+ ok: true,
+ latencyMs: 12,
+ });
+ });
+
+ it("lists environment-scoped scanner connectors without secretRef", async () => {
+ mockFindMany.mockResolvedValue([row()]);
+ const listed = await listScannerConnectors();
+ expect(mockFindMany).toHaveBeenCalledWith(
+ expect.objectContaining({
+ where: {
+ projectId: "proj-1",
+ category: "scanner",
+ environment: "production",
+ },
+ })
+ );
+ expect(listed[0]).not.toHaveProperty("secretRef");
+ });
+
+ it("refuses a second scan while one is running", async () => {
+ mockCreateScannerAdapter.mockReturnValue({
+ scan: async () => ({ id: "job:x", status: "succeeded" }),
+ });
+ mockFindFirst.mockResolvedValue(
+ row({
+ metadata: JSON.stringify({
+ jobs: [{ id: "job:1", status: "running", target: "https://github.com/acme/x", startedAt: new Date().toISOString() }],
+ }),
+ })
+ );
+ await expect(runScannerJob("scanner:abc")).rejects.toThrow(/already running/);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-install.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-install.test.ts
new file mode 100644
index 00000000..077d88b3
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-install.test.ts
@@ -0,0 +1,52 @@
+import { createHash } from "node:crypto";
+import {
+ __resetTrustablReleaseFetcherForTests,
+ installTrustablCli,
+ setTrustablReleaseFetcherForTests,
+} from "@/lib/platform/connectors/scanner/install";
+import { SCANNER_RUNTIME_CHECKSUM_FAILED, SCANNER_RUNTIME_DOWNLOAD_FAILED } from "@/constants/messages/en";
+import { assertTrustablDownloadUrl } from "@/lib/platform/connectors/scanner/install";
+import { trustablAssetName } from "@/lib/platform/connectors/scanner/release";
+
+jest.mock("@/lib/platform/connectors/scanner/runtime", () => ({
+ TRUSTABL_FALLBACK_VERSION: "v0.1.8",
+ probeTrustablRuntime: jest.fn(async () => ({
+ installed: false,
+ latestVersion: "v0.1.8",
+ upgradeAvailable: true,
+ })),
+ trustablCacheBinary: jest.fn(() => "/tmp/openlit-trustabl-test/trustabl"),
+}));
+
+describe("Trustabl CLI install", () => {
+ afterEach(() => {
+ __resetTrustablReleaseFetcherForTests();
+ });
+
+ it("aborts when the archive checksum does not match", async () => {
+ const fileName = trustablAssetName("v0.1.8");
+ const archive = Buffer.from("not-the-release");
+ setTrustablReleaseFetcherForTests(async (url) => {
+ if (url.endsWith("/releases/latest")) {
+ return Buffer.from(JSON.stringify({ tag_name: "v0.1.8" }));
+ }
+ if (url.endsWith("checksums.txt")) {
+ return Buffer.from(`${createHash("sha256").update("other").digest("hex")} ${fileName}\n`);
+ }
+ return archive;
+ });
+ await expect(installTrustablCli()).rejects.toThrow(SCANNER_RUNTIME_CHECKSUM_FAILED);
+ });
+
+ it("rejects downloads outside GitHub release hosts", () => {
+ expect(() => assertTrustablDownloadUrl("http://github.com/trustabl/trustabl")).toThrow(
+ SCANNER_RUNTIME_DOWNLOAD_FAILED
+ );
+ expect(() => assertTrustablDownloadUrl("https://evil.example/archive.tar.gz")).toThrow(
+ SCANNER_RUNTIME_DOWNLOAD_FAILED
+ );
+ expect(
+ assertTrustablDownloadUrl("https://github.com/trustabl/trustabl/releases/download/v0.1.8/checksums.txt")
+ ).toContain("github.com");
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-job-findings.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-job-findings.test.ts
new file mode 100644
index 00000000..07577b6c
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-job-findings.test.ts
@@ -0,0 +1,43 @@
+import {
+ isScannerJobId,
+ pageScannerJobFindings,
+ type ScannerFindingPage,
+} from "@/lib/platform/connectors/scanner/job-findings";
+import type { ScannerJob } from "@/lib/platform/connectors/scanner/types";
+
+function job(findings: ScannerJob["findings"]): Pick<ScannerJob, "findings"> {
+ return { findings };
+}
+
+describe("pageScannerJobFindings", () => {
+ const findings = [
+ { id: "a", ruleId: "MCP-001", severity: "high", title: "Unsafe tool", path: "src/a.py" },
+ { id: "b", ruleId: "CSDK-010", severity: "low", title: "Missing contract", path: "src/b.ts" },
+ { id: "c", ruleId: "MCP-006", severity: "low", title: "Tool raises exceptions", path: "mcp_server.py" },
+ ];
+
+ it("paginates numbered findings", () => {
+ const page = pageScannerJobFindings(job(findings), { page: 2, limit: 2 });
+ expect(page.total).toBe(3);
+ expect(page.page).toBe(2);
+ expect(page.findings.map((item) => item.id)).toEqual(["c"]);
+ expect(page.findings[0].alertNumber).toBe(3);
+ expect(page.counts).toEqual({ all: 3, critical: 0, high: 1, medium: 0, low: 2 });
+ });
+
+ it("filters by query and severity on the server", () => {
+ const page = pageScannerJobFindings(job(findings), { q: "tool", severity: "low" });
+ expect(page.findings.map((item) => item.id)).toEqual(["c"]);
+ expect(page.counts.all).toBe(2);
+ expect(page.counts.low).toBe(1);
+ expect(page.counts.high).toBe(1);
+ });
+});
+
+describe("isScannerJobId", () => {
+ it("accepts persisted job ids", () => {
+ expect(isScannerJobId("job:abee6854-450a-445d-98a9-8ed0076c05b7")).toBe(true);
+ expect(isScannerJobId("../job")).toBe(false);
+ expect(isScannerJobId("")).toBe(false);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-job-repos.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-job-repos.test.ts
new file mode 100644
index 00000000..812d0614
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-job-repos.test.ts
@@ -0,0 +1,60 @@
+import {
+ groupScannerJobsByRepo,
+ scannerJobRepoKey,
+ scannerRepoDisplayLabel,
+} from "@/lib/platform/connectors/scanner/job-repos";
+import type { ScannerJob } from "@/lib/platform/connectors/scanner/types";
+
+function job(overrides: Partial<ScannerJob>): ScannerJob {
+ return {
+ id: "job:1",
+ status: "succeeded",
+ target: "https://github.com/acme/checkout-agent",
+ startedAt: "2026-09-07T10:00:00.000Z",
+ ...overrides,
+ };
+}
+
+describe("scanner job repo grouping", () => {
+ it("labels a GitHub repo key as owner/repo", () => {
+ expect(scannerRepoDisplayLabel("github.com/acme/checkout-agent")).toBe(
+ "acme/checkout-agent"
+ );
+ });
+
+ it("groups jobs that share a repo even when the URL includes a tree ref", () => {
+ const groups = groupScannerJobsByRepo([
+ job({ id: "job:new", startedAt: "2026-09-08T10:00:00.000Z" }),
+ job({
+ id: "job:tree",
+ target: "https://github.com/acme/checkout-agent/tree/main",
+ }),
+ job({
+ id: "job:other",
+ target: "https://github.com/acme/payments",
+ }),
+ ]);
+
+ expect(groups.map((group) => group.label)).toEqual([
+ "acme/checkout-agent",
+ "acme/payments",
+ ]);
+ expect(groups[0].jobs.map((item) => item.id)).toEqual(["job:new", "job:tree"]);
+ expect(scannerJobRepoKey(groups[0].jobs[0])).toBe("github.com/acme/checkout-agent");
+ });
+
+ it("includes the connector default target even before a job exists", () => {
+ const groups = groupScannerJobsByRepo(
+ [],
+ "https://github.com/acme/checkout-agent"
+ );
+ expect(groups).toEqual([
+ {
+ repoKey: "github.com/acme/checkout-agent",
+ label: "acme/checkout-agent",
+ target: "https://github.com/acme/checkout-agent",
+ jobs: [],
+ },
+ ]);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-lookup.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-lookup.test.ts
new file mode 100644
index 00000000..4f7e2627
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-lookup.test.ts
@@ -0,0 +1,124 @@
+jest.mock("@/lib/platform/connectors/scanner/crud", () => ({
+ listScannerConnectors: jest.fn(),
+}));
+
+import {
+ matchScannerFindingsForRepo,
+ scannerWorkspaceUrl,
+} from "@/lib/platform/connectors/scanner/lookup";
+import type { ScannerJob } from "@/lib/platform/connectors/scanner/types";
+
+function finding(id: string, severity: string, title: string) {
+ return { id, ruleId: id, severity, title };
+}
+
+function job(overrides: Partial<ScannerJob>): ScannerJob {
+ return {
+ id: "job:1",
+ status: "succeeded",
+ target: "https://github.com/acme/checkout-agent",
+ startedAt: "2026-09-07T10:00:00.000Z",
+ finishedAt: "2026-09-07T10:01:00.000Z",
+ findings: [finding("CSDK-010", "high", "Unsafe SDK usage")],
+ findingCount: 1,
+ mediumPlusCount: 1,
+ ...overrides,
+ };
+}
+
+describe("scanner findings lookup", () => {
+ it("builds scanner workspace deep links", () => {
+ expect(scannerWorkspaceUrl()).toBe("/scanner");
+ expect(scannerWorkspaceUrl("scanner:abc", "job:1")).toBe(
+ "/scanner?connectorId=scanner%3Aabc&jobId=job%3A1"
+ );
+ });
+
+ it("joins coding-agent repo URLs to the latest succeeded job", () => {
+ const result = matchScannerFindingsForRepo(
+ [
+ {
+ id: "scanner:old",
+ name: "Older scan",
+ jobs: [
+ job({
+ id: "job:old",
+ finishedAt: "2026-09-01T10:00:00.000Z",
+ findings: [finding("OLD-1", "low", "Stale")],
+ findingCount: 1,
+ mediumPlusCount: 0,
+ }),
+ ],
+ },
+ {
+ id: "scanner:new",
+ name: "Prod Trustabl",
+ jobs: [
+ job({
+ id: "job:failed",
+ status: "failed",
+ finishedAt: "2026-09-08T12:00:00.000Z",
+ }),
+ job({
+ id: "job:latest",
+ target: "https://github.com/acme/checkout-agent.git",
+ finishedAt: "2026-09-07T12:00:00.000Z",
+ findings: [
+ finding("LOW-1", "low", "Nit"),
+ finding("CSDK-010", "high", "Unsafe SDK usage"),
+ finding("MCP-2", "medium", "MCP allowlist"),
+ ],
+ findingCount: 3,
+ mediumPlusCount: 2,
+ }),
+ ],
+ },
+ ],
+ "[email protected]:acme/checkout-agent.git"
+ );
+
+ expect(result).toMatchObject({
+ matched: true,
+ repoKey: "github.com/acme/checkout-agent",
+ connectorId: "scanner:new",
+ connectorName: "Prod Trustabl",
+ jobId: "job:latest",
+ mediumPlusCount: 2,
+ findingCount: 3,
+ url: "/scanner?connectorId=scanner%3Anew&jobId=job%3Alatest",
+ });
+ if (!result.matched) throw new Error("expected match");
+ expect(result.findings.map((item) => item.id)).toEqual([
+ "CSDK-010",
+ "MCP-2",
+ "LOW-1",
+ ]);
+ });
+
+ it("returns a miss when no succeeded job matches the repo", () => {
+ expect(
+ matchScannerFindingsForRepo(
+ [
+ {
+ id: "scanner:other",
+ name: "Other",
+ jobs: [job({ target: "https://github.com/acme/other" })],
+ },
+ ],
+ "https://github.com/acme/checkout-agent"
+ )
+ ).toEqual({
+ matched: false,
+ repoKey: "github.com/acme/checkout-agent",
+ url: "/scanner",
+ });
+ });
+
+ it("returns a miss for non-GitHub repo URLs", () => {
+ expect(matchScannerFindingsForRepo([], "https://gitlab.com/acme/repo")).toEqual({
+ matched: false,
+ repoKey: null,
+ url: "/scanner",
+ });
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-process.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-process.test.ts
new file mode 100644
index 00000000..87068d62
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-process.test.ts
@@ -0,0 +1,37 @@
+import {
+ sanitizeScannerArgv,
+ sanitizeScannerBinary,
+} from "@/lib/platform/connectors/scanner/process";
+import { SCANNER_PROCESS_REJECTED } from "@/constants/messages/en";
+
+describe("scanner process sanitization", () => {
+ it("allows the Trustabl binary by name or absolute path", () => {
+ expect(sanitizeScannerBinary("trustabl")).toBe("trustabl");
+ expect(sanitizeScannerBinary("/opt/openlit/trustabl").endsWith("/trustabl")).toBe(true);
+ });
+
+ it("rejects other binaries and relative paths", () => {
+ expect(() => sanitizeScannerBinary("bash")).toThrow(SCANNER_PROCESS_REJECTED);
+ expect(() => sanitizeScannerBinary("../trustabl")).toThrow(SCANNER_PROCESS_REJECTED);
+ expect(() => sanitizeScannerBinary("/tmp/trustabl;id")).toThrow(SCANNER_PROCESS_REJECTED);
+ });
+
+ it("allows scan argv built by OpenLIT", () => {
+ expect(
+ sanitizeScannerArgv([
+ "scan",
+ "https://github.com/acme/checkout-agent",
+ "--format",
+ "json",
+ "--no-progress",
+ "--rules-source",
+ "production",
+ ])
+ ).toContain("scan");
+ });
+
+ it("rejects shell metacharacters in argv", () => {
+ expect(() => sanitizeScannerArgv(["scan", "$(id)"])).toThrow(SCANNER_PROCESS_REJECTED);
+ expect(() => sanitizeScannerArgv(["--output=/etc/passwd"])).toThrow(SCANNER_PROCESS_REJECTED);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-release.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-release.test.ts
new file mode 100644
index 00000000..0807def7
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-release.test.ts
@@ -0,0 +1,44 @@
+import {
+ compareScannerVersions,
+ normalizeScannerVersion,
+ parseChecksumFile,
+ trustablAssetName,
+ trustablReleaseDownloadUrl,
+} from "@/lib/platform/connectors/scanner/release";
+
+describe("Trustabl release helpers", () => {
+ it("normalizes CLI version strings", () => {
+ expect(normalizeScannerVersion("trustabl 0.1.8")).toBe("0.1.8");
+ expect(normalizeScannerVersion("v0.1.8")).toBe("0.1.8");
+ });
+
+ it("detects upgrades", () => {
+ expect(compareScannerVersions("0.1.7", "0.1.8")).toBeLessThan(0);
+ expect(compareScannerVersions("v0.1.8", "0.1.8")).toBe(0);
+ });
+
+ it("builds the current-platform asset name", () => {
+ expect(trustablAssetName("v0.1.8", "darwin", "arm64")).toBe("trustabl_0.1.8_darwin_arm64.tar.gz");
+ expect(trustablAssetName("0.1.8", "linux", "x64")).toBe("trustabl_0.1.8_linux_amd64.tar.gz");
+ expect(trustablAssetName("v0.1.8", "win32", "x64")).toBe("trustabl_0.1.8_windows_amd64.zip");
+ expect(trustablAssetName("v0.1.8", "aix", "ppc")).toBe("");
+ });
+
+ it("parses goreleaser checksums", () => {
+ const checksums = parseChecksumFile(
+ "9e1251bea09ae660362f842dfe97212e34efd7efd7e530a5809010ae490ff867 trustabl_0.1.8_darwin_amd64.tar.gz\n"
+ );
+ expect(checksums.get("trustabl_0.1.8_darwin_amd64.tar.gz")).toBe(
+ "9e1251bea09ae660362f842dfe97212e34efd7efd7e530a5809010ae490ff867"
+ );
+ });
+
+ it("builds release download URLs from a sanitized version tag", () => {
+ expect(trustablReleaseDownloadUrl("v0.1.8", "checksums.txt")).toBe(
+ "https://github.com/trustabl/trustabl/releases/download/v0.1.8/checksums.txt"
+ );
+ expect(trustablReleaseDownloadUrl("v0.1.8/../../etc", "checksums.txt")).toBe(
+ "https://github.com/trustabl/trustabl/releases/download/v0.1.8/checksums.txt"
+ );
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-report.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-report.test.ts
new file mode 100644
index 00000000..dc00acf3
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-report.test.ts
@@ -0,0 +1,134 @@
+import { formatScannerError, parseScannerReport } from "@/lib/platform/connectors/scanner/report";
+import { SCANNER_REPO_NOT_FOUND } from "@/constants/messages/en";
+
+describe("scanner report parsing", () => {
+ it("normalizes Trustabl-style findings JSON", () => {
+ const parsed = parseScannerReport(
+ JSON.stringify({
+ findings: [
+ {
+ rule_id: "CSDK-010",
+ severity: "medium",
+ category: "claude_sdk",
+ path: "src/agent/tools.ts",
+ title: "Tool scope wider than declared",
+ explanation: "The tool can write files outside the declared workspace.",
+ suggested_fix: "Narrow the tool's path prefix.",
+ confidence: "0.91",
+ },
+ ],
+ })
+ );
+ expect(parsed.findings).toHaveLength(1);
+ expect(parsed.mediumPlusCount).toBe(1);
+ expect(parsed.findings[0]).toEqual(
+ expect.objectContaining({
+ ruleId: "CSDK-010",
+ severity: "medium",
+ path: "src/agent/tools.ts",
+ message: "The tool can write files outside the declared workspace.",
+ fix: "Narrow the tool's path prefix.",
+ confidence: "0.91",
+ })
+ );
+ });
+
+ it("captures ScanResult inventory and uses Trustabl file_path fields", () => {
+ const parsed = parseScannerReport(
+ JSON.stringify({
+ scan_id: "scan-1",
+ repo: "checkout-agent",
+ overall_score: 0.64,
+ languages: ["python", "typescript"],
+ sdks: ["claude_agent_sdk"],
+ tools: [{ name: "search" }, { name: "write" }],
+ agents: [{ name: "triage" }],
+ mcp_servers: [],
+ skills: [{}],
+ subagents: [],
+ rules_source: "https://github.com/trustabl/trustabl-rules",
+ rules_version: "abcdef1",
+ rules_from_cache: true,
+ rules_origin: { signed: true, channel: "production" },
+ coverage: { files_parsed: 12, files_skipped: 1 },
+ findings: [
+ {
+ rule_id: "CSDK-010",
+ severity: "high",
+ scope: "tool",
+ tool_name: "write",
+ file_path: "src/agent/tools.ts",
+ start_line: 40,
+ end_line: 48,
+ title: "Tool scope wider than declared",
+ explanation: "Writes outside the workspace.",
+ suggested_fix: "Narrow the prefix.",
+ confidence: 0.91,
+ },
+ ],
+ })
+ );
+ expect(parsed.report).toEqual(
+ expect.objectContaining({
+ scanId: "scan-1",
+ overallScore: 0.64,
+ toolCount: 2,
+ agentCount: 1,
+ skillCount: 1,
+ filesParsed: 12,
+ filesSkipped: 1,
+ rulesOrigin: "signed:production",
+ })
+ );
+ expect(parsed.findings[0]).toEqual(
+ expect.objectContaining({
+ path: "src/agent/tools.ts",
+ line: 40,
+ endLine: 48,
+ scope: "tool",
+ toolName: "write",
+ confidence: "0.91",
+ })
+ );
+ });
+
+ it("keeps unknown report and finding fields for newer CLI versions", () => {
+ const parsed = parseScannerReport(
+ JSON.stringify({
+ scan_id: "scan-2",
+ policy_pack: "agent-reliability-v2",
+ attested: true,
+ findings: [
+ {
+ rule_id: "SBOM-001",
+ severity: "low",
+ title: "Unpinned component",
+ purl: "pkg:npm/[email protected]",
+ },
+ ],
+ })
+ );
+ expect(parsed.report?.extras).toEqual(
+ expect.objectContaining({
+ policy_pack: "agent-reliability-v2",
+ attested: "true",
+ })
+ );
+ expect(parsed.findings[0].extras).toEqual(
+ expect.objectContaining({ purl: "pkg:npm/[email protected]" })
+ );
+ });
+
+ it("returns no findings for empty or invalid stdout", () => {
+ expect(parseScannerReport("").findings).toEqual([]);
+ expect(parseScannerReport("not json").findings).toEqual([]);
+ });
+
+ it("maps clone 404s to a repository-not-found message", () => {
+ expect(
+ formatScannerError(
+ "Error: ingest: clone https://github.com/openlit/openplait/tree/main: repository not found"
+ )
+ ).toBe(SCANNER_REPO_NOT_FOUND);
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-scan-params.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-scan-params.test.ts
new file mode 100644
index 00000000..eea44bce
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-scan-params.test.ts
@@ -0,0 +1,47 @@
+import { parseScannerScanInput, resolveScannerScanParams } from "@/lib/platform/connectors/scanner/scan-params";
+
+describe("scanner scan params", () => {
+ it("parses Trustabl scan flags from a JSON body", () => {
+ expect(
+ parseScannerScanInput({
+ target: "https://github.com/acme/checkout-agent",
+ strict: true,
+ secretScan: "true",
+ rulesSource: "staging",
+ })
+ ).toEqual(
+ expect.objectContaining({
+ target: "https://github.com/acme/checkout-agent",
+ strict: true,
+ secretScan: true,
+ rulesSource: "staging",
+ })
+ );
+ });
+
+ it("captures extra flags from a JSON body", () => {
+ expect(
+ parseScannerScanInput({
+ target: "https://github.com/acme/checkout-agent",
+ sbomScan: true,
+ })
+ ).toEqual(
+ expect.objectContaining({
+ target: "https://github.com/acme/checkout-agent",
+ extras: { sbomScan: true },
+ })
+ );
+ });
+ it("uses per-run overrides over connector defaults and environment rules source", () => {
+ const params = resolveScannerScanParams(
+ { detectors: "mcp", strict: true, rulesSource: "environment" },
+ { detectors: "claude_sdk", strict: false, requireSigned: false, secretScan: true },
+ "staging"
+ );
+ expect(params.detectors).toBe("mcp");
+ expect(params.strict).toBe(true);
+ expect(params.secretScan).toBe(true);
+ expect(params.requireSigned).toBe(false);
+ expect(params.rulesSource).toBe("staging");
+ });
+});
diff --git a/src/client/src/__tests__/lib/platform/connectors/scanner-target.test.ts b/src/client/src/__tests__/lib/platform/connectors/scanner-target.test.ts
new file mode 100644
index 00000000..a33740d8
--- /dev/null
+++ b/src/client/src/__tests__/lib/platform/connectors/scanner-target.test.ts
@@ -0,0 +1,68 @@
+import { normalizeScannerDetectors, normalizeScannerRef, normalizeScannerRulesRepo, normalizeScannerRulesSource, normalizeScannerTarget, scannerCloneTarget, scannerRefFromTarget, scannerRepoKey } from "@/lib/platform/connectors/scanner/target";
+
+describe("scanner target validation", () => {
+ it("accepts GitHub repository URLs", () => {
+ expect(normalizeScannerTarget("https://github.com/acme/checkout-agent")).toBe(
+ "https://github.com/acme/checkout-agent"
+ );
+ expect(
+ normalizeScannerTarget("https://github.com/acme/checkout-agent/tree/main")
+ ).toBe("https://github.com/acme/checkout-agent/tree/main");
+ });
+
+ it("rejects local paths and non-GitHub URLs", () => {
+ expect(() => normalizeScannerTarget(".")).toThrow(/github/i);
+ expect(() => normalizeScannerTarget("/tmp/repo")).toThrow(/github/i);
+ expect(() => normalizeScannerTarget("file:///etc/passwd")).toThrow(/github/i);
+ expect(() => normalizeScannerTarget("https://gitlab.com/acme/repo")).toThrow(/github/i);
+ });
+
+ it("validates refs and detectors", () => {
+ expect(normalizeScannerRef("main")).toBe("main");
+ expect(() => normalizeScannerRef("main;rm -rf /")).toThrow();
+ expect(normalizeScannerDetectors("claude_sdk, mcp")).toBe("claude_sdk,mcp");
+ expect(() => normalizeScannerDetectors("claude_sdk,../etc")).toThrow();
+ });
+
+ it("strips /tree/ref so Trustabl clones a git remote, not a GitHub HTML URL", () => {
+ expect(scannerCloneTarget("https://github.com/acme/checkout-agent/tree/main")).toBe(
+ "https://github.com/acme/checkout-agent"
+ );
+ expect(scannerCloneTarget("https://github.com/acme/checkout-agent.git")).toBe(
+ "https://github.com/acme/checkout-agent"
+ );
+ expect(scannerRefFromTarget("https://github.com/acme/checkout-agent/tree/develop")).toBe(
+ "develop"
+ );
+ });
+
+ it("normalizes GitHub URLs onto a repo key for coding-agent joins", () => {
+ expect(scannerRepoKey("https://github.com/acme/checkout-agent")).toBe(
+ "github.com/acme/checkout-agent"
+ );
+ expect(scannerRepoKey("https://github.com/Acme/checkout-agent.git")).toBe(
+ "github.com/acme/checkout-agent"
+ );
+ expect(scannerRepoKey("https://github.com/acme/checkout-agent/tree/main")).toBe(
+ "github.com/acme/checkout-agent"
+ );
+ expect(scannerRepoKey("[email protected]:acme/checkout-agent.git")).toBe(
+ "github.com/acme/checkout-agent"
+ );
+ expect(scannerRepoKey("ssh://[email protected]/acme/checkout-agent")).toBe(
+ "github.com/acme/checkout-agent"
+ );
+ expect(scannerRepoKey("https://gitlab.com/acme/checkout-agent")).toBeNull();
+ expect(scannerRepoKey("")).toBeNull();
+ });
+
+ it("validates rules source and rules repo", () => {
+ expect(normalizeScannerRulesSource("production")).toBe("production");
+ expect(normalizeScannerRulesSource("environment")).toBeUndefined();
+ expect(() => normalizeScannerRulesSource("nightly")).toThrow();
+ expect(normalizeScannerRulesRepo("https://github.com/trustabl/trustabl-rules")).toBe(
+ "https://github.com/trustabl/trustabl-rules"
+ );
+ expect(() => normalizeScannerRulesRepo("/tmp/rules")).toThrow();
+ });
+});
diff --git a/src/client/src/app/(playground)/scanner/page.tsx b/src/client/src/app/(playground)/scanner/page.tsx
new file mode 100644
index 00000000..7aac25b4
--- /dev/null
+++ b/src/client/src/app/(playground)/scanner/page.tsx
@@ -0,0 +1,7 @@
+"use client";
+
+import ScannerPage from "@/components/(playground)/scanner/scanner-page";
+
+export default function ScannerRoute() {
+ return <ScannerPage />;
+}
diff --git a/src/client/src/app/api/connectors/[id]/health/route.ts b/src/client/src/app/api/connectors/[id]/health/route.ts
index 13bfa612..8162c1bd 100644
--- a/src/client/src/app/api/connectors/[id]/health/route.ts
+++ b/src/client/src/app/api/connectors/[id]/health/route.ts
@@ -10,6 +10,10 @@ import {
healthCheckMemoryConnector,
isMemoryConnectorId,
} from "@/lib/platform/connectors/memory/crud";
+import {
+ healthCheckScannerConnector,
+ isScannerConnectorId,
+} from "@/lib/platform/connectors/scanner/crud";
const DEFAULT_PROBE_MS = 60 * 60 * 1000;
@@ -26,6 +30,14 @@ async function healthAndValidate(id: string) {
validation: { supported: false },
});
}
+ if (isScannerConnectorId(id)) {
+ const [healthErr, health] = await asaw(healthCheckScannerConnector(id));
+ if (healthErr) return errorResponse(healthErr, "Connector health check failed");
+ return Response.json({
+ health,
+ validation: { supported: false },
+ });
+ }
const sourceId = telemetrySourceId(id);
const [healthErr, health] = await asaw(healthCheckTelemetrySource(sourceId));
diff --git a/src/client/src/app/api/connectors/[id]/route.ts b/src/client/src/app/api/connectors/[id]/route.ts
index 054979c1..5ac595e0 100644
--- a/src/client/src/app/api/connectors/[id]/route.ts
+++ b/src/client/src/app/api/connectors/[id]/route.ts
@@ -12,6 +12,11 @@ import {
isMemoryConnectorId,
updateMemoryConnector,
} from "@/lib/platform/connectors/memory/crud";
+import {
+ deleteScannerConnector,
+ isScannerConnectorId,
+ updateScannerConnector,
+} from "@/lib/platform/connectors/scanner/crud";
function telemetrySourceId(id: string) {
return id.startsWith("telemetry:") ? id.slice("telemetry:".length) : id;
@@ -34,6 +39,11 @@ async function PATCHHandler(
if (err) return errorResponse(err, "Failed to update connector");
return Response.json(connector);
}
+ if (isScannerConnectorId(params.id)) {
+ const [err, connector] = await asaw(updateScannerConnector(params.id, body));
+ if (err) return errorResponse(err, "Failed to update connector");
+ return Response.json(connector);
+ }
const [err, connector] = await asaw(updateTelemetrySource(telemetrySourceId(params.id), body));
if (err) return errorResponse(err, "Failed to update connector");
return Response.json({ ...connector, category: "datasource", scope: "project" });
@@ -50,6 +60,11 @@ async function DELETEHandler(
if (err) return errorResponse(err, "Failed to delete connector");
return Response.json(result);
}
+ if (isScannerConnectorId(params.id)) {
+ const [err, result] = await asaw(deleteScannerConnector(params.id));
+ if (err) return errorResponse(err, "Failed to delete connector");
+ return Response.json(result);
+ }
const [err, result] = await asaw(deleteTelemetrySource(telemetrySourceId(params.id)));
if (err) return errorResponse(err, "Failed to delete connector");
return Response.json(result);
diff --git a/src/client/src/app/api/connectors/route.ts b/src/client/src/app/api/connectors/route.ts
index 042d9476..3a92b640 100644
--- a/src/client/src/app/api/connectors/route.ts
+++ b/src/client/src/app/api/connectors/route.ts
@@ -18,6 +18,10 @@ import {
createMemoryConnector,
isMemoryConnectorType,
} from "@/lib/platform/connectors/memory/crud";
+import {
+ createScannerConnector,
+ isScannerConnectorType,
+} from "@/lib/platform/connectors/scanner/crud";
import { fireConnectorCreateTelemetry } from "@/helpers/server/connector-analytics";
/**
@@ -81,6 +85,25 @@ async function POSTHandler(request: NextRequest) {
});
return Response.json(connector);
}
+ if (category === "scanner" || isScannerConnectorType(type)) {
+ const [err, connector] = await asaw(createScannerConnector(body));
+ if (err) {
+ fireConnectorCreateTelemetry({
+ success: false,
+ type: type || "scanner",
+ environment,
+ startTimestamp,
+ });
+ return errorResponse(err, "Failed to create connector");
+ }
+ fireConnectorCreateTelemetry({
+ success: true,
+ type: String((connector as { type?: string })?.type || type || "scanner"),
+ environment,
+ startTimestamp,
+ });
+ return Response.json(connector);
+ }
if (category && category !== "datasource") {
return Response.json(
{ err: `Connector category is not available in CE: ${String(body.category)}` },
diff --git a/src/client/src/app/api/connectors/types/route.ts b/src/client/src/app/api/connectors/types/route.ts
index b1da29b9..1e2c6413 100644
--- a/src/client/src/app/api/connectors/types/route.ts
+++ b/src/client/src/app/api/connectors/types/route.ts
@@ -1,15 +1,22 @@
import { getCurrentUser } from "@/lib/session";
import { withConnectorAccess } from "@/lib/access/connector-route";
import { availableConnectorTypeDescriptors } from "@/lib/platform/connectors/catalog";
+import { overlayScannerConfigFields } from "@/lib/platform/connectors/scanner/cli-schema";
+import { trustablConfigFields } from "@/lib/platform/connectors/scanner/config-fields";
+import { probeTrustablRuntime } from "@/lib/platform/connectors/scanner/runtime";
async function GETHandler() {
const user = await getCurrentUser();
if (!user) return Response.json("Unauthorized", { status: 401 });
const types = availableConnectorTypeDescriptors();
+ const runtime = await probeTrustablRuntime().catch(() => null);
return Response.json({
- categories: ["datasource", "notification", "memory", "vector-store", "model-provider"],
- types,
+ categories: ["datasource", "notification", "memory", "scanner", "repository", "vector-store", "model-provider"],
+ types: overlayScannerConfigFields(
+ types,
+ runtime?.schema ? trustablConfigFields(runtime.schema) : undefined
+ ),
});
}
diff --git a/src/client/src/app/api/scanners/[id]/install/route.ts b/src/client/src/app/api/scanners/[id]/install/route.ts
new file mode 100644
index 00000000..62a7a642
--- /dev/null
+++ b/src/client/src/app/api/scanners/[id]/install/route.ts
@@ -0,0 +1,31 @@
+import { NextRequest } from "next/server";
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess, withScannerAudit } from "@/lib/access/scanner-route";
+import { installScannerRuntime } from "@/lib/platform/connectors/scanner/crud";
+import { SCANNER_INSTALL_FAILED, SCANNER_INVALID_JSON } from "@/constants/messages/en";
+
+export const maxDuration = 180;
+
+async function POSTHandler(
+ request: NextRequest,
+ { params }: { params: { id: string } }
+) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ let body: Record<string, unknown> = {};
+ try {
+ const text = await request.text();
+ if (text.trim()) body = JSON.parse(text) as Record<string, unknown>;
+ } catch {
+ return Response.json({ err: SCANNER_INVALID_JSON }, { status: 400 });
+ }
+ const [err, result] = await asaw(
+ installScannerRuntime(params.id, { upgrade: body.upgrade === true })
+ );
+ if (err) return errorResponse(err, SCANNER_INSTALL_FAILED);
+ return Response.json(result);
+}
+
+export const POST = withScannerAudit(withScannerAccess("install", POSTHandler));
diff --git a/src/client/src/app/api/scanners/[id]/jobs/[jobId]/findings/route.ts b/src/client/src/app/api/scanners/[id]/jobs/[jobId]/findings/route.ts
new file mode 100644
index 00000000..34490a0d
--- /dev/null
+++ b/src/client/src/app/api/scanners/[id]/jobs/[jobId]/findings/route.ts
@@ -0,0 +1,34 @@
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess } from "@/lib/access/scanner-route";
+import { listScannerJobFindings } from "@/lib/platform/connectors/scanner/crud";
+import {
+ SCANNER_FINDINGS_LOAD_FAILED,
+ SCANNER_JOB_ID_INVALID,
+} from "@/constants/messages/en";
+import { isScannerJobId } from "@/lib/platform/connectors/scanner/job-findings";
+
+async function GETHandler(
+ request: Request,
+ { params }: { params: { id: string; jobId: string } }
+) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ if (!isScannerJobId(params.jobId)) {
+ return Response.json({ err: SCANNER_JOB_ID_INVALID }, { status: 400 });
+ }
+ const { searchParams } = new URL(request.url);
+ const [err, result] = await asaw(
+ listScannerJobFindings(params.id, params.jobId, {
+ q: searchParams.get("q") || "",
+ severity: searchParams.get("severity") || "all",
+ page: searchParams.get("page") || "1",
+ limit: searchParams.get("limit") || "",
+ })
+ );
+ if (err) return errorResponse(err, SCANNER_FINDINGS_LOAD_FAILED);
+ return Response.json(result);
+}
+
+export const GET = withScannerAccess("read", GETHandler);
diff --git a/src/client/src/app/api/scanners/[id]/scan/route.ts b/src/client/src/app/api/scanners/[id]/scan/route.ts
new file mode 100644
index 00000000..252b35e5
--- /dev/null
+++ b/src/client/src/app/api/scanners/[id]/scan/route.ts
@@ -0,0 +1,30 @@
+import { NextRequest } from "next/server";
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess, withScannerAudit } from "@/lib/access/scanner-route";
+import { runScannerJob } from "@/lib/platform/connectors/scanner/crud";
+import { parseScannerScanInput } from "@/lib/platform/connectors/scanner/scan-params";
+import { SCANNER_INVALID_JSON, SCANNER_SCAN_FAILED } from "@/constants/messages/en";
+
+export const maxDuration = 300;
+
+async function POSTHandler(
+ request: NextRequest,
+ { params }: { params: { id: string } }
+) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ let body: Record<string, unknown> = {};
+ try {
+ const text = await request.text();
+ if (text.trim()) body = JSON.parse(text) as Record<string, unknown>;
+ } catch {
+ return Response.json({ err: SCANNER_INVALID_JSON }, { status: 400 });
+ }
+ const [err, result] = await asaw(runScannerJob(params.id, parseScannerScanInput(body)));
+ if (err) return errorResponse(err, SCANNER_SCAN_FAILED);
+ return Response.json(result);
+}
+
+export const POST = withScannerAudit(withScannerAccess("scan", POSTHandler));
diff --git a/src/client/src/app/api/scanners/findings/route.ts b/src/client/src/app/api/scanners/findings/route.ts
new file mode 100644
index 00000000..978e0c6e
--- /dev/null
+++ b/src/client/src/app/api/scanners/findings/route.ts
@@ -0,0 +1,26 @@
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess } from "@/lib/access/scanner-route";
+import { lookupLatestScannerFindingsForRepo } from "@/lib/platform/connectors/scanner/lookup";
+import {
+ SCANNER_LOAD_FAILED,
+ SCANNER_TARGET_REQUIRED,
+} from "@/constants/messages/en";
+
+async function GETHandler(request: Request) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ const { searchParams } = new URL(request.url);
+ const repoUrl = searchParams.get("repoUrl") || "";
+ if (!repoUrl.trim()) {
+ return Response.json({ err: SCANNER_TARGET_REQUIRED }, { status: 400 });
+ }
+ const [err, result] = await asaw(
+ lookupLatestScannerFindingsForRepo({ repoUrl })
+ );
+ if (err) return errorResponse(err, SCANNER_LOAD_FAILED);
+ return Response.json(result);
+}
+
+export const GET = withScannerAccess("read", GETHandler);
diff --git a/src/client/src/app/api/scanners/route.ts b/src/client/src/app/api/scanners/route.ts
new file mode 100644
index 00000000..ea3fb9e7
--- /dev/null
+++ b/src/client/src/app/api/scanners/route.ts
@@ -0,0 +1,16 @@
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess } from "@/lib/access/scanner-route";
+import { listScannerConnectors } from "@/lib/platform/connectors/scanner/crud";
+import { SCANNER_LOAD_FAILED } from "@/constants/messages/en";
+
+async function GETHandler(_request: Request) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ const [err, connectors] = await asaw(listScannerConnectors());
+ if (err) return errorResponse(err, SCANNER_LOAD_FAILED);
+ return Response.json({ connectors: connectors || [] });
+}
+
+export const GET = withScannerAccess("read", GETHandler);
diff --git a/src/client/src/app/api/scanners/runtime/route.ts b/src/client/src/app/api/scanners/runtime/route.ts
new file mode 100644
index 00000000..6b13e4ac
--- /dev/null
+++ b/src/client/src/app/api/scanners/runtime/route.ts
@@ -0,0 +1,41 @@
+import { NextRequest } from "next/server";
+import { getCurrentUser } from "@/lib/session";
+import { errorResponse } from "@/utils/api-response";
+import asaw from "@/utils/asaw";
+import { withScannerAccess, withScannerAudit } from "@/lib/access/scanner-route";
+import { getScannerCliRuntime, installScannerRuntime } from "@/lib/platform/connectors/scanner/crud";
+import {
+ SCANNER_INSTALL_FAILED,
+ SCANNER_INVALID_JSON,
+ SCANNER_LOAD_FAILED,
+} from "@/constants/messages/en";
+
+export const maxDuration = 180;
+
+async function GETHandler() {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ const [err, runtime] = await asaw(getScannerCliRuntime());
+ if (err) return errorResponse(err, SCANNER_LOAD_FAILED);
+ return Response.json({ runtime });
+}
+
+async function POSTHandler(request: NextRequest) {
+ const user = await getCurrentUser();
+ if (!user) return Response.json("Unauthorized", { status: 401 });
+ let body: Record<string, unknown> = {};
+ try {
+ const text = await request.text();
+ if (text.trim()) body = JSON.parse(text) as Record<string, unknown>;
+ } catch {
+ return Response.json({ err: SCANNER_INVALID_JSON }, { status: 400 });
+ }
+ const [err, result] = await asaw(
+ installScannerRuntime(undefined, { upgrade: body.upgrade === true })
+ );
+ if (err) return errorResponse(err, SCANNER_INSTALL_FAILED);
+ return Response.json(result);
+}
+
+export const GET = withScannerAccess("read", GETHandler);
+export const POST = withScannerAudit(withScannerAccess("install", POSTHandler));
diff --git a/src/client/src/components/(playground)/observability/trace-detail-page.tsx b/src/client/src/components/(playground)/observability/trace-detail-page.tsx
index 2ae312cc..8aa59b67 100644
--- a/src/client/src/components/(playground)/observability/trace-detail-page.tsx
+++ b/src/client/src/components/(playground)/observability/trace-detail-page.tsx
@@ -27,6 +27,7 @@ import { agentLoopDetailLine } from "@/lib/platform/agent-loop/format";
import Evaluations from "@/components/(playground)/request/components/evaluations";
import { RequestProvider } from "@/components/(playground)/request/request-context";
import TraceAiAnalysisPanel from "@/components/(playground)/request/components/trace-ai-analysis-panel";
+import ScannerSessionFindings from "@/components/(playground)/scanner/scanner-session-findings";
import DetailObjectTabs, { buildObjectTabs } from "./detail-object-tabs";
import {
ResizableHandle,
@@ -742,6 +743,15 @@ export function TraceDetailView({
: null;
const extraDetailTabs = [
...(analysisTab ? [analysisTab] : []),
+ ...(isCodingAgentTrace && repoUrl
+ ? [
+ {
+ id: "scanner-findings",
+ label: m.SCANNER_SESSION_TAB,
+ content: <ScannerSessionFindings repoUrl={repoUrl} />,
+ },
+ ]
+ : []),
...(hasEvaluationPanel && trace
? [
{
diff --git a/src/client/src/components/(playground)/scanner/scanner-finding-sheet.tsx b/src/client/src/components/(playground)/scanner/scanner-finding-sheet.tsx
new file mode 100644
index 00000000..48a3213a
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-finding-sheet.tsx
@@ -0,0 +1,207 @@
+"use client";
+
+import { useEffect, useState, type ReactNode } from "react";
+import { ArrowLeft, X } from "lucide-react";
+import { Button } from "@/components/ui/button";
+import { ResizeablePanel } from "@/components/ui/resizeable-panel";
+import { Sheet, SheetContent } from "@/components/ui/sheet";
+import getMessage from "@/constants/messages";
+import { formatBrowserDateTime } from "@/utils/date";
+import type { ScannerFinding, ScannerJob } from "@/lib/platform/connectors/scanner/types";
+
+const DETAIL_SHEET_CONTENT_CLASS =
+ "right-2 top-2 bottom-2 flex h-auto w-auto max-w-none flex-col gap-0 border-0 bg-transparent p-0 shadow-none focus-visible:outline-none sm:max-w-none";
+
+function ResizableFindingSheet({ children }: { children: ReactNode }) {
+ const [maxWidth, setMaxWidth] = useState(1200);
+ const [defaultWidth, setDefaultWidth] = useState(880);
+
+ useEffect(() => {
+ const updateBounds = () => {
+ const viewportWidth = window.innerWidth;
+ const nextMaxWidth = Math.max(420, viewportWidth - 32);
+ setMaxWidth(nextMaxWidth);
+ setDefaultWidth(Math.min(Math.max(viewportWidth * 0.62, 760), nextMaxWidth));
+ };
+ updateBounds();
+ window.addEventListener("resize", updateBounds);
+ return () => window.removeEventListener("resize", updateBounds);
+ }, []);
+
+ return (
+ <ResizeablePanel
+ defaultWidth={defaultWidth}
+ minWidth={420}
+ maxWidth={maxWidth}
+ handlePosition="left"
+ className="h-full max-w-[calc(100vw-1rem)] rounded-md bg-white shadow-2xl dark:bg-stone-950"
+ handleClassName="opacity-100 border-stone-300 bg-white dark:border-stone-700 dark:bg-stone-900"
+ >
+ <div className="flex h-full min-h-0 flex-col overflow-hidden">{children}</div>
+ </ResizeablePanel>
+ );
+}
+
+function severityTone(severity: string): string {
+ if (severity === "critical") {
+ return "bg-rose-100 text-rose-800 dark:bg-rose-900/40 dark:text-rose-300";
+ }
+ if (severity === "high") {
+ return "bg-orange-100 text-orange-800 dark:bg-orange-900/40 dark:text-orange-300";
+ }
+ if (severity === "medium") {
+ return "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300";
+ }
+ return "bg-stone-100 text-stone-700 dark:bg-stone-800 dark:text-stone-300";
+}
+
+function MetaRow({ label, value }: { label: string; value?: string | number | null }) {
+ if (value == null || value === "") return null;
+ return (
+ <div className="flex flex-col gap-0.5 border-b border-stone-100 py-2 last:border-b-0 dark:border-stone-900">
+ <div className="text-[10px] uppercase tracking-wide text-stone-500 dark:text-stone-400">{label}</div>
+ <div className="break-all font-mono text-[11px] font-medium text-stone-900 dark:text-stone-100">{String(value)}</div>
+ </div>
+ );
+}
+
+export default function ScannerFindingSheet({
+ open,
+ finding,
+ alertNumber,
+ job,
+ onClose,
+}: {
+ open: boolean;
+ finding: ScannerFinding | null;
+ alertNumber?: number;
+ job?: ScannerJob | null;
+ onClose: () => void;
+}) {
+ const messages = getMessage();
+ const location = finding
+ ? [finding.path, finding.line ? `${finding.line}${finding.endLine && finding.endLine !== finding.line ? `-${finding.endLine}` : ""}` : ""]
+ .filter(Boolean)
+ .join(":")
+ : "";
+
+ if (!finding) return null;
+
+ return (
+ <Sheet modal={false} open={open} onOpenChange={(next) => !next && onClose()}>
+ <SheetContent
+ side="right"
+ className={DETAIL_SHEET_CONTENT_CLASS}
+ displayOverlay={false}
+ displayClose={false}
+ >
+ <ResizableFindingSheet>
+ <div className="flex h-full min-h-0 flex-col overflow-hidden">
+ <div className="flex shrink-0 items-center justify-between gap-2 border-b border-stone-200 px-3 py-2 dark:border-stone-800">
+ <Button
+ variant="ghost"
+ size="sm"
+ className="h-7 gap-1.5 px-2 text-xs text-stone-600 dark:text-stone-300"
+ onClick={onClose}
+ >
+ <ArrowLeft className="h-3.5 w-3.5" />
+ {messages.SCANNER_BACK_TO_FINDINGS}
+ </Button>
+ <Button
+ variant="outline"
+ size="sm"
+ className="h-7 w-7 border-stone-200 bg-white p-0 text-stone-600 hover:bg-stone-100 hover:text-stone-950 dark:border-stone-800 dark:bg-stone-950 dark:text-stone-300 dark:hover:bg-stone-800 dark:hover:text-stone-50"
+ onClick={onClose}
+ title={messages.OBSERVABILITY_CLOSE}
+ >
+ <X className="h-4 w-4" />
+ </Button>
+ </div>
+ <div className="min-h-0 flex-1 overflow-auto">
+ <div className="grid min-h-full gap-0 lg:grid-cols-[minmax(0,1fr)_240px]">
+ <div className="min-w-0 border-b border-stone-200 p-4 lg:border-b-0 lg:border-r dark:border-stone-800">
+ <div className="flex flex-wrap items-start justify-between gap-2">
+ <div className="min-w-0">
+ <p className="font-mono text-[11px] text-stone-400">
+ {alertNumber ? messages.SCANNER_FINDING_NUMBER(alertNumber) : null}
+ </p>
+ <h2 className="mt-1 text-base font-semibold leading-6 text-stone-950 dark:text-stone-50">
+ {finding.title}
+ </h2>
+ <p className="mt-1 text-xs text-stone-500 dark:text-stone-400">
+ {messages.SCANNER_SEVERITY_WITH_LEVEL(finding.severity)}
+ {finding.ruleId ? ` · ${finding.ruleId}` : ""}
+ </p>
+ </div>
+ <span
+ className={`inline-flex rounded px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide ${severityTone(finding.severity)}`}
+ >
+ {finding.severity}
+ </span>
+ </div>
+ {location ? (
+ <p className="mt-3 truncate font-mono text-[11px] text-stone-500 dark:text-stone-400" title={location}>
+ {messages.SCANNER_PATH}: {location}
+ </p>
+ ) : null}
+
+ <section className="mt-5">
+ <h3 className="text-xs font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_FINDING_DETAIL}
+ </h3>
+ {finding.message ? (
+ <pre className="mt-2 max-w-full whitespace-pre-wrap break-words rounded-md border border-stone-200 bg-stone-50 p-3 font-sans text-xs leading-5 text-stone-800 dark:border-stone-800 dark:bg-stone-900 dark:text-stone-200">
+ {finding.message}
+ </pre>
+ ) : (
+ <p className="mt-2 text-xs text-muted-foreground">{messages.SCANNER_FINDING_NO_DETAIL}</p>
+ )}
+ {finding.helpUrl ? (
+ <a
+ href={finding.helpUrl}
+ target="_blank"
+ rel="noreferrer noopener"
+ className="mt-3 inline-flex text-xs text-primary underline underline-offset-2"
+ >
+ {messages.SCANNER_FINDING_DOCS}
+ </a>
+ ) : null}
+ </section>
+
+ {finding.fix ? (
+ <section className="mt-5">
+ <h3 className="text-xs font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_FINDING_FIX}
+ </h3>
+ <pre className="mt-2 max-w-full whitespace-pre-wrap break-words rounded-md border border-stone-200 bg-stone-50 p-3 font-sans text-xs leading-5 text-stone-800 dark:border-stone-800 dark:bg-stone-900 dark:text-stone-200">
+ {finding.fix}
+ </pre>
+ </section>
+ ) : null}
+ </div>
+ <aside className="bg-stone-50 p-4 dark:bg-stone-900/40">
+ <MetaRow label={messages.SCANNER_SEVERITY} value={finding.severity} />
+ <MetaRow label={messages.SCANNER_RULE} value={finding.ruleId} />
+ <MetaRow label={messages.SCANNER_SCOPE} value={finding.scope || finding.category} />
+ <MetaRow label={messages.SCANNER_FINDING_CONFIDENCE} value={finding.confidence} />
+ <MetaRow label={messages.SCANNER_PATH} value={location || undefined} />
+ <MetaRow label={messages.SCANNER_TOOL_NAME} value={finding.toolName} />
+ <MetaRow label={messages.SCANNER_DETECTED} value={job?.startedAt ? formatBrowserDateTime(job.startedAt) : undefined} />
+ <MetaRow label={messages.SCANNER_JOB_ID} value={job?.id} />
+ <MetaRow label={messages.SCANNER_CLI_VERSION} value={job?.cliVersion} />
+ <MetaRow label={messages.SCANNER_TARGET} value={job?.target} />
+ <MetaRow label={messages.SCANNER_FIELD_REF} value={job?.ref} />
+ {finding.extras
+ ? Object.entries(finding.extras).map(([key, value]) => (
+ <MetaRow key={key} label={key} value={value} />
+ ))
+ : null}
+ </aside>
+ </div>
+ </div>
+ </div>
+ </ResizableFindingSheet>
+ </SheetContent>
+ </Sheet>
+ );
+}
diff --git a/src/client/src/components/(playground)/scanner/scanner-page.tsx b/src/client/src/components/(playground)/scanner/scanner-page.tsx
new file mode 100644
index 00000000..82f467da
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-page.tsx
@@ -0,0 +1,616 @@
+"use client";
+
+import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
+import { useSearchParams } from "next/navigation";
+import Image from "next/image";
+import { ChevronDown, Cable, ExternalLink, GitBranch, ListChecks, Play, RefreshCw, ScanSearch, Settings2 } from "lucide-react";
+import { toast } from "sonner";
+import FeatureAccess from "@/components/rbac/feature-access";
+import FeaturePageHeader from "@/components/(playground)/feature-page-header";
+import ScannerRuntimePanel from "@/components/(playground)/scanner/scanner-runtime-panel";
+import ScannerFindingSheet from "@/components/(playground)/scanner/scanner-finding-sheet";
+import ScannerRunParamsDialog, {
+ emptyScannerRunDefaults,
+ type ScannerRunDefaults,
+} from "@/components/(playground)/scanner/scanner-run-params-dialog";
+import ScannerWorkspace from "@/components/(playground)/scanner/scanner-workspace";
+import {
+ SourceFormDialog,
+ type TypeDescriptor,
+} from "@/components/(playground)/telemetry-source/data-sources-page";
+import { Button } from "@/components/ui/button";
+import { Badge } from "@/components/ui/badge";
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import {
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+} from "@/components/ui/select";
+import { Skeleton } from "@/components/ui/skeleton";
+import getMessage from "@/constants/messages";
+import DOCUMENTATION_LINKS from "@/constants/documentation-links";
+import { getCurrentProject, getCurrentProjectEnvironment } from "@/selectors/project";
+import { useRootStore } from "@/store";
+import { getRequestHeaders } from "@/utils/api";
+import { connectorIconPath } from "@/lib/platform/connectors/icons";
+import { trustablRunParamFields } from "@/lib/platform/connectors/scanner/config-fields";
+import type { ScannerCliSchema } from "@/lib/platform/connectors/scanner/cli-schema";
+import { groupScannerJobsByRepo, scannerJobRepoKey } from "@/lib/platform/connectors/scanner/job-repos";
+import type { ScannerFinding, ScannerJob, ScannerScanInput, ScannerRuntimeInfo } from "@/lib/platform/connectors/scanner/types";
+
+type ScannerConnector = {
+ id: string;
+ name: string;
+ type: string;
+ environment?: string;
+ settings?: string;
+ jobs?: ScannerJob[];
+};
+
+function parseSettings(settings?: string): Record<string, unknown> {
+ try {
+ const parsed = JSON.parse(settings || "{}");
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+ return parsed as Record<string, unknown>;
+ }
+ } catch {
+ /* keep empty */
+ }
+ return {};
+}
+
+function asBool(value: unknown, fallback = false): boolean {
+ if (value === true || value === "true") return true;
+ if (value === false || value === "false") return false;
+ return fallback;
+}
+
+function connectorRunDefaults(
+ settings?: string,
+ fields = trustablRunParamFields()
+): ScannerRunDefaults {
+ const parsed = parseSettings(settings);
+ const next = emptyScannerRunDefaults(fields);
+ for (const field of fields) {
+ const raw = parsed[field.key];
+ if (raw == null) continue;
+ if (field.kind === "switch") next[field.key] = asBool(raw, Boolean(field.defaultValue));
+ else next[field.key] = String(raw);
+ }
+ return next;
+}
+
+const toolbarSelectTriggerClass =
+ "h-9 w-fit max-w-[20rem] shrink-0 gap-2 bg-white px-2 text-left text-xs dark:bg-stone-950 [&>span]:line-clamp-none [&>span]:flex [&>span]:w-max [&>span]:max-w-full [&>svg]:ml-0 [&>svg]:size-3.5 [&>svg]:shrink-0";
+
+function ToolbarSelectValue({
+ icon,
+ label,
+ value,
+}: {
+ icon: ReactNode;
+ label: string;
+ value?: string;
+}) {
+ return (
+ <span className="flex w-max max-w-full items-center gap-2">
+ {icon}
+ <span className="min-w-0 max-w-full text-left leading-tight">
+ <span className="block text-[10px] font-medium uppercase tracking-wide text-stone-500 dark:text-stone-400">
+ {label}
+ </span>
+ <span className="block max-w-[16rem] truncate font-medium text-stone-900 dark:text-stone-100">
+ {value || "—"}
+ </span>
+ </span>
+ </span>
+ );
+}
+
+function ConnectorMark({ type, size = 16 }: { type: string; size?: number }) {
+ const src = connectorIconPath(type);
+ if (!src) {
+ return <ScanSearch className="shrink-0 text-stone-500" width={size} height={size} />;
+ }
+ return (
+ <Image
+ src={src}
+ alt=""
+ width={size}
+ height={size}
+ className="shrink-0 rounded-sm object-contain"
+ />
+ );
+}
+
+export default function ScannerPage() {
+ const messages = getMessage();
+ const searchParams = useSearchParams();
+ const queryConnectorId = searchParams.get("connectorId") || "";
+ const queryJobId = searchParams.get("jobId") || "";
+ const project = useRootStore(getCurrentProject);
+ const environment = useRootStore(getCurrentProjectEnvironment) || "production";
+ const [connectors, setConnectors] = useState<ScannerConnector[]>([]);
+ const [connectorId, setConnectorId] = useState(queryConnectorId);
+ const [loading, setLoading] = useState(true);
+ const [running, setRunning] = useState(false);
+ const [loadError, setLoadError] = useState<string | null>(null);
+ const [addOpen, setAddOpen] = useState(false);
+ const [paramsOpen, setParamsOpen] = useState(false);
+ const [jobId, setJobId] = useState(queryJobId);
+ const [repoKey, setRepoKey] = useState("");
+ const [finding, setFinding] = useState<ScannerFinding | null>(null);
+ const [alertNumber, setAlertNumber] = useState<number | undefined>();
+ const [descriptors, setDescriptors] = useState<TypeDescriptor[]>([]);
+ const [cliSchema, setCliSchema] = useState<ScannerCliSchema | undefined>();
+ const jobIdRef = useRef(jobId);
+ jobIdRef.current = jobId;
+ const handleRuntimeChange = useCallback((runtime: ScannerRuntimeInfo | null) => {
+ setCliSchema(runtime?.schema);
+ }, []);
+
+ const emptySteps = [
+ {
+ icon: Cable,
+ title: messages.SCANNER_EMPTY_STEP_CONNECTOR,
+ body: messages.SCANNER_EMPTY_STEP_CONNECTOR_BODY,
+ },
+ {
+ icon: Settings2,
+ title: messages.SCANNER_EMPTY_STEP_TARGET,
+ body: messages.SCANNER_EMPTY_STEP_TARGET_BODY,
+ },
+ {
+ icon: ListChecks,
+ title: messages.SCANNER_EMPTY_STEP_RUN,
+ body: messages.SCANNER_EMPTY_STEP_RUN_BODY,
+ },
+ ];
+ const emptyCaps = [
+ messages.SCANNER_EMPTY_CAP_TYPES,
+ messages.SCANNER_EMPTY_CAP_ENV,
+ messages.SCANNER_EMPTY_CAP_OUTPUT,
+ ];
+
+ const selected = useMemo(
+ () => connectors.find((item) => item.id === connectorId) || connectors[0],
+ [connectorId, connectors]
+ );
+ const jobs = selected?.jobs || [];
+ const defaultTarget = useMemo(() => {
+ const target = parseSettings(selected?.settings).target;
+ return typeof target === "string" ? target : "";
+ }, [selected?.settings]);
+ const repoGroups = useMemo(
+ () => groupScannerJobsByRepo(jobs, defaultTarget),
+ [defaultTarget, jobs]
+ );
+ const selectedRepo = useMemo(
+ () => repoGroups.find((group) => group.repoKey === repoKey) || repoGroups[0],
+ [repoGroups, repoKey]
+ );
+ const repoJobs = selectedRepo?.jobs || [];
+ const selectedJob = useMemo(
+ () => repoJobs.find((job) => job.id === jobId) || repoJobs[0],
+ [jobId, repoJobs]
+ );
+ const previousJob = useMemo(() => {
+ if (!selectedJob) return undefined;
+ const index = repoJobs.findIndex((job) => job.id === selectedJob.id);
+ return index >= 0 ? repoJobs[index + 1] : undefined;
+ }, [repoJobs, selectedJob]);
+ const runDefaults = useMemo(() => {
+ const next = connectorRunDefaults(selected?.settings, trustablRunParamFields(cliSchema));
+ if (selectedRepo?.target) next.target = selectedRepo.target;
+ return next;
+ }, [cliSchema, selected?.settings, selectedRepo?.target]);
+
+ const load = useCallback(async () => {
+ if (!project?.id) {
+ return;
+ }
+ setLoading(true);
+ setLoadError(null);
+ try {
+ const [scannerRes, typeRes] = await Promise.all([
+ fetch("/api/scanners", { headers: getRequestHeaders() }),
+ fetch("/api/connectors/types", { headers: getRequestHeaders() }),
+ ]);
+ if (!scannerRes.ok) throw new Error(messages.SCANNER_LOAD_FAILED);
+ const scannerBody = await scannerRes.json();
+ const typeBody = typeRes.ok ? await typeRes.json() : { types: [] };
+ const next: ScannerConnector[] = scannerBody.connectors || [];
+ setConnectors(next);
+ setDescriptors(
+ ((typeBody.types || []) as TypeDescriptor[]).filter((item) => item.category === "scanner")
+ );
+ const preferredId = connectorId || queryConnectorId;
+ const resolvedId = next.some((item) => item.id === preferredId)
+ ? preferredId
+ : next[0]?.id || "";
+ setConnectorId(resolvedId);
+ const resolved = next.find((item) => item.id === resolvedId);
+ const nextJobs = resolved?.jobs || [];
+ const nextDefault =
+ typeof parseSettings(resolved?.settings).target === "string"
+ ? String(parseSettings(resolved?.settings).target)
+ : "";
+ const groups = groupScannerJobsByRepo(nextJobs, nextDefault);
+ const preferredJob = jobIdRef.current || queryJobId;
+ const resolvedJob = nextJobs.find((job) => job.id === preferredJob) || groups[0]?.jobs[0];
+ setJobId(resolvedJob?.id || "");
+ setRepoKey(resolvedJob ? scannerJobRepoKey(resolvedJob) : groups[0]?.repoKey || "");
+ } catch (error) {
+ setLoadError(error instanceof Error ? error.message : messages.SCANNER_LOAD_FAILED);
+ } finally {
+ setLoading(false);
+ }
+ }, [connectorId, messages.SCANNER_LOAD_FAILED, project?.id, queryConnectorId, queryJobId]);
+
+ useEffect(() => {
+ void load();
+ }, [load, environment, project?.id]);
+
+ const runScan = async (input: ScannerScanInput = {}) => {
+ if (!selected?.id) return;
+ setRunning(true);
+ setParamsOpen(false);
+ toast.loading(messages.SCANNER_RUN, { id: "scanner-run" });
+ try {
+ const payload: ScannerScanInput = { ...input };
+ if (!payload.target && selectedRepo?.target) {
+ payload.target = selectedRepo.target;
+ }
+ const response = await fetch(`/api/scanners/${encodeURIComponent(selected.id)}/scan`, {
+ method: "POST",
+ headers: getRequestHeaders({ "Content-Type": "application/json" }),
+ body: JSON.stringify(payload),
+ });
+ const body = await response.json();
+ if (!response.ok) throw new Error(body?.err || messages.SCANNER_SCAN_FAILED);
+ if (typeof body?.job?.id === "string") {
+ setJobId(body.job.id);
+ if (typeof body.job.target === "string" && body.job.target) {
+ setRepoKey(scannerJobRepoKey(body.job as ScannerJob));
+ }
+ }
+ toast.success(messages.SCANNER_RUN, { id: "scanner-run" });
+ await load();
+ } catch (error) {
+ toast.error(error instanceof Error ? error.message : messages.SCANNER_SCAN_FAILED, {
+ id: "scanner-run",
+ });
+ } finally {
+ setRunning(false);
+ }
+ };
+
+ return (
+ <div className="flex h-full min-h-0 w-full flex-col overflow-hidden text-stone-700 dark:text-stone-300">
+ <FeaturePageHeader
+ eyebrow={messages.SIDEBAR_DEVELOP}
+ title={messages.FEATURE_SCANNER}
+ icon={<ScanSearch className="h-4 w-4" />}
+ tone="border-teal-200 bg-teal-50 text-teal-700 dark:border-teal-900/70 dark:bg-teal-950/40 dark:text-teal-300"
+ actions={
+ <div className="flex items-center gap-1.5">
+ <FeatureAccess access="connectors.create" hideWhenDenied>
+ <Button
+ size="sm"
+ variant="outline"
+ className="h-8 gap-1.5"
+ onClick={() => setAddOpen(true)}
+ disabled={!project?.id}
+ >
+ <Cable className="size-3.5" />
+ {messages.ADD_CONNECTOR}
+ </Button>
+ </FeatureAccess>
+ <FeatureAccess access="scanner.scan" hideWhenDenied>
+ <div className="flex">
+ <Button
+ size="sm"
+ className="h-8 gap-1.5 rounded-r-none"
+ onClick={() => void runScan()}
+ disabled={loading || running || !selected?.id}
+ >
+ <Play className="size-3.5" />
+ {messages.SCANNER_RUN}
+ </Button>
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button
+ size="sm"
+ className="h-8 rounded-l-none border-l border-stone-700 px-2 dark:border-stone-300"
+ disabled={loading || running || !selected?.id}
+ aria-label={messages.SCANNER_RUN_MENU}
+ >
+ <ChevronDown className="size-3.5" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end" className="w-56">
+ <DropdownMenuItem onSelect={() => void runScan()}>
+ {messages.SCANNER_RUN_DEFAULTS}
+ </DropdownMenuItem>
+ <DropdownMenuItem onSelect={() => setParamsOpen(true)}>
+ {messages.SCANNER_RUN_PARAMS}
+ </DropdownMenuItem>
+ </DropdownMenuContent>
+ </DropdownMenu>
+ </div>
+ </FeatureAccess>
+ <Button
+ size="sm"
+ variant="outline"
+ className="h-8 gap-1.5"
+ onClick={() => void load()}
+ disabled={loading || !project?.id}
+ >
+ <RefreshCw className={`size-3.5 ${loading ? "animate-spin" : ""}`} />
+ {messages.SCANNER_REFRESH}
+ </Button>
+ </div>
+ }
+ />
+
+ <FeatureAccess access="scanner.read" requireProject>
+ <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+ {connectors.length > 0 ? (
+ <div className="flex min-h-11 items-center gap-2 overflow-x-auto border-b border-stone-200 px-3 py-1.5 dark:border-stone-800">
+ <Select
+ value={selected?.id || ""}
+ onValueChange={(next) => {
+ setConnectorId(next);
+ const connector = connectors.find((item) => item.id === next);
+ const nextJobs = connector?.jobs || [];
+ const nextDefault =
+ typeof parseSettings(connector?.settings).target === "string"
+ ? String(parseSettings(connector?.settings).target)
+ : "";
+ const groups = groupScannerJobsByRepo(nextJobs, nextDefault);
+ setRepoKey(groups[0]?.repoKey || "");
+ setJobId(groups[0]?.jobs[0]?.id || "");
+ setFinding(null);
+ setAlertNumber(undefined);
+ }}
+ disabled={loading}
+ >
+ <SelectTrigger
+ aria-label={messages.SCANNER_CONNECTOR_LABEL}
+ className={toolbarSelectTriggerClass}
+ >
+ <ToolbarSelectValue
+ icon={<ConnectorMark type={selected?.type || "trustabl"} size={14} />}
+ label={messages.SCANNER_CONNECTOR_LABEL}
+ value={selected?.name}
+ />
+ </SelectTrigger>
+ <SelectContent>
+ {connectors.map((connector) => (
+ <SelectItem key={connector.id} value={connector.id}>
+ <span className="flex items-center gap-2">
+ <ConnectorMark type={connector.type} size={14} />
+ {connector.name}
+ </span>
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ {repoGroups.length ? (
+ <Select
+ value={selectedRepo?.repoKey}
+ onValueChange={(next) => {
+ const group = repoGroups.find((item) => item.repoKey === next);
+ setRepoKey(next);
+ setJobId(group?.jobs[0]?.id || "");
+ setFinding(null);
+ setAlertNumber(undefined);
+ }}
+ disabled={loading}
+ >
+ <SelectTrigger
+ aria-label={messages.SCANNER_REPOSITORY_LABEL}
+ className={toolbarSelectTriggerClass}
+ >
+ <ToolbarSelectValue
+ icon={<GitBranch className="size-3.5 shrink-0 text-stone-500" />}
+ label={messages.SCANNER_REPOSITORY_LABEL}
+ value={selectedRepo?.label}
+ />
+ </SelectTrigger>
+ <SelectContent>
+ {repoGroups.map((group) => (
+ <SelectItem key={group.repoKey} value={group.repoKey}>
+ {group.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ ) : (
+ <span className="shrink-0 text-xs text-muted-foreground">{messages.SCANNER_NO_REPOS}</span>
+ )}
+ {selected?.type === "trustabl" ? (
+ <div className="ml-auto shrink-0">
+ <ScannerRuntimePanel
+ compact
+ onRuntimeChange={handleRuntimeChange}
+ />
+ </div>
+ ) : null}
+ </div>
+ ) : null}
+
+ {loadError ? (
+ <div className="m-4 rounded-lg border border-error/30 bg-error/5 p-4 dark:bg-error/10">
+ <p className="text-sm font-semibold text-error">{messages.SCANNER_LOAD_FAILED}</p>
+ <p className="mt-1 text-xs text-muted-foreground">{loadError}</p>
+ </div>
+ ) : null}
+
+ {loading || !project?.id ? (
+ <div className="space-y-3 p-4">
+ <Skeleton className="h-16 w-full" />
+ <Skeleton className="h-48 w-full" />
+ </div>
+ ) : !connectors.length ? (
+ <div className="flex min-h-0 flex-1 flex-col overflow-auto">
+ <div className="mx-auto flex w-full max-w-4xl flex-col gap-4 p-4">
+ <section className="rounded-lg border border-stone-200 bg-white p-5 dark:border-stone-800 dark:bg-stone-950">
+ <div className="flex flex-col gap-4 sm:flex-row sm:items-start sm:justify-between">
+ <div className="flex min-w-0 items-start gap-3">
+ <div className="flex size-11 shrink-0 items-center justify-center rounded-md border border-teal-200 bg-teal-50 text-teal-700 dark:border-teal-900/70 dark:bg-teal-950/40 dark:text-teal-300">
+ <ScanSearch className="h-5 w-5" />
+ </div>
+ <div className="min-w-0">
+ <p className="text-sm font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_EMPTY_TITLE}
+ </p>
+ <p className="mt-1 max-w-xl text-xs leading-5 text-stone-500 dark:text-stone-400">
+ {messages.SCANNER_EMPTY_CONNECTORS}
+ </p>
+ <div className="mt-3 flex flex-wrap gap-1.5">
+ {emptyCaps.map((cap) => (
+ <Badge key={cap} variant="secondary" className="text-[10px] font-normal">
+ {cap}
+ </Badge>
+ ))}
+ </div>
+ </div>
+ </div>
+ <div className="flex shrink-0 flex-wrap items-center gap-2">
+ <FeatureAccess access="connectors.create" hideWhenDenied>
+ <Button size="sm" className="h-8 gap-1.5" onClick={() => setAddOpen(true)}>
+ <Cable className="size-3.5" />
+ {messages.SCANNER_EMPTY_CONNECTORS_ACTION}
+ </Button>
+ </FeatureAccess>
+ <a
+ href={DOCUMENTATION_LINKS.scannerConnectors}
+ target="_blank"
+ rel="noreferrer noopener"
+ className="inline-flex h-8 items-center gap-1.5 rounded-md border border-stone-200 px-2.5 text-xs font-medium text-stone-700 hover:bg-stone-50 dark:border-stone-800 dark:text-stone-300 dark:hover:bg-stone-900"
+ >
+ <ExternalLink className="size-3.5" />
+ {messages.SCANNER_EMPTY_DOCS}
+ </a>
+ </div>
+ </div>
+ </section>
+
+ <section>
+ <h2 className="mb-2 text-sm font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_EMPTY_HOW}
+ </h2>
+ <div className="grid gap-3 md:grid-cols-3">
+ {emptySteps.map((step, index) => {
+ const Icon = step.icon;
+ return (
+ <div
+ key={step.title}
+ className="rounded-md border border-stone-200 bg-white p-3 dark:border-stone-800 dark:bg-stone-950"
+ >
+ <div className="flex items-center gap-2">
+ <span className="inline-flex size-6 items-center justify-center rounded border border-stone-200 text-[11px] font-semibold tabular-nums text-stone-600 dark:border-stone-700 dark:text-stone-300">
+ {index + 1}
+ </span>
+ <Icon className="size-3.5 text-teal-700 dark:text-teal-300" />
+ <p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{step.title}</p>
+ </div>
+ <p className="mt-2 text-xs leading-5 text-stone-500 dark:text-stone-400">{step.body}</p>
+ </div>
+ );
+ })}
+ </div>
+ </section>
+
+ <section>
+ <h2 className="mb-2 text-sm font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_EMPTY_PREVIEW}
+ </h2>
+ <div className="grid gap-3 md:grid-cols-2">
+ <div className="rounded-md border border-dashed border-stone-200 bg-white p-3 dark:border-stone-800 dark:bg-stone-950">
+ <p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{messages.SCANNER_JOBS}</p>
+ <div className="mt-2 space-y-1.5">
+ <div className="h-7 rounded border border-stone-100 bg-stone-50 dark:border-stone-800 dark:bg-stone-900" />
+ <div className="h-7 rounded border border-stone-100 bg-stone-50 dark:border-stone-800 dark:bg-stone-900" />
+ </div>
+ <p className="mt-2 text-[11px] text-muted-foreground">{messages.SCANNER_EMPTY_JOBS}</p>
+ </div>
+ <div className="rounded-md border border-dashed border-stone-200 bg-white p-3 dark:border-stone-800 dark:bg-stone-950">
+ <p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{messages.SCANNER_FINDINGS}</p>
+ <div className="mt-2 space-y-1.5">
+ <div className="h-7 rounded border border-stone-100 bg-stone-50 dark:border-stone-800 dark:bg-stone-900" />
+ <div className="h-7 rounded border border-stone-100 bg-stone-50 dark:border-stone-800 dark:bg-stone-900" />
+ <div className="h-7 rounded border border-stone-100 bg-stone-50 dark:border-stone-800 dark:bg-stone-900" />
+ </div>
+ <p className="mt-2 text-[11px] text-muted-foreground">{messages.SCANNER_EMPTY_FINDINGS}</p>
+ </div>
+ </div>
+ </section>
+ </div>
+ </div>
+ ) : (
+ <div className="flex min-h-0 flex-1 flex-col overflow-hidden">
+ <ScannerWorkspace
+ key={selectedRepo?.repoKey || "empty"}
+ connectorId={selected?.id}
+ repoLabel={selectedRepo?.label}
+ jobs={repoJobs}
+ selectedJob={selectedJob}
+ previousJob={previousJob}
+ onSelectJob={(next) => {
+ setJobId(next);
+ setFinding(null);
+ setAlertNumber(undefined);
+ }}
+ onOpenFinding={(item, number) => {
+ setFinding(item);
+ setAlertNumber(number);
+ }}
+ />
+ </div>
+ )}
+ </div>
+ </FeatureAccess>
+
+ {paramsOpen ? (
+ <ScannerRunParamsDialog
+ open={paramsOpen}
+ defaults={runDefaults}
+ schema={cliSchema}
+ onClose={() => setParamsOpen(false)}
+ onRun={(input) => void runScan(input)}
+ />
+ ) : null}
+ <ScannerFindingSheet
+ open={Boolean(finding)}
+ finding={finding}
+ alertNumber={alertNumber}
+ job={selectedJob}
+ onClose={() => {
+ setFinding(null);
+ setAlertNumber(undefined);
+ }}
+ />
+ {addOpen ? (
+ <SourceFormDialog
+ source={null}
+ descriptors={descriptors}
+ initialType={descriptors[0]?.type}
+ initialEnvironment={environment}
+ onClose={() => setAddOpen(false)}
+ onSaved={() => {
+ setAddOpen(false);
+ void load();
+ }}
+ />
+ ) : null}
+ </div>
+ );
+}
diff --git a/src/client/src/components/(playground)/scanner/scanner-run-params-dialog.tsx b/src/client/src/components/(playground)/scanner/scanner-run-params-dialog.tsx
new file mode 100644
index 00000000..3664df52
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-run-params-dialog.tsx
@@ -0,0 +1,353 @@
+"use client";
+
+import { useEffect, useMemo, useState, type ReactNode } from "react";
+import { Button } from "@/components/ui/button";
+import { Input } from "@/components/ui/input";
+import { Label } from "@/components/ui/label";
+import { Switch } from "@/components/ui/switch";
+import {
+ Dialog,
+ DialogContent,
+ DialogDescription,
+ DialogFooter,
+ DialogHeader,
+ DialogTitle,
+} from "@/components/ui/dialog";
+import {
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+} from "@/components/ui/select";
+import getMessage from "@/constants/messages";
+import type { FieldDef } from "@/lib/platform/connectors/datasource/types";
+import { trustablRunParamFields } from "@/lib/platform/connectors/scanner/config-fields";
+import type { ScannerCliSchema } from "@/lib/platform/connectors/scanner/cli-schema";
+import type { ScannerScanInput } from "@/lib/platform/connectors/scanner/types";
+
+export type ScannerRunDefaults = Record<string, string | boolean>;
+
+const TARGET_ORDER = ["target", "ref", "detectors"];
+const SCAN_ORDER = ["secretScan", "vulnScan", "licenseScan", "strict", "verbose"];
+const RULES_ORDER = ["rulesSource", "rulesRef", "rulesRepo", "requireSigned", "noRulesUpdate"];
+const KNOWN_KEYS = new Set([...TARGET_ORDER, ...SCAN_ORDER, ...RULES_ORDER]);
+
+export function emptyScannerRunDefaults(fields: FieldDef[] = trustablRunParamFields()): ScannerRunDefaults {
+ const next: ScannerRunDefaults = {};
+ for (const field of fields) {
+ next[field.key] = field.kind === "switch" ? Boolean(field.defaultValue) : String(field.defaultValue ?? "");
+ }
+ return next;
+}
+
+export const EMPTY_SCANNER_RUN_DEFAULTS = emptyScannerRunDefaults();
+
+function pickFields(fields: FieldDef[], order: string[]): FieldDef[] {
+ const byKey = new Map(fields.map((field) => [field.key, field]));
+ return order.map((key) => byKey.get(key)).filter((field): field is FieldDef => !!field);
+}
+
+function leftoverFields(fields: FieldDef[], used: Set<string>): FieldDef[] {
+ return fields.filter((field) => !used.has(field.key));
+}
+
+function toScanInput(values: ScannerRunDefaults, fields: FieldDef[]): ScannerScanInput {
+ const extras: Record<string, string | boolean> = {};
+ const input: ScannerScanInput = {};
+ for (const field of fields) {
+ const value = values[field.key];
+ if (!KNOWN_KEYS.has(field.key)) {
+ if (field.kind === "switch") extras[field.key] = value === true;
+ else if (typeof value === "string" && value.trim()) extras[field.key] = value.trim();
+ continue;
+ }
+ if (field.kind === "switch") {
+ (input as Record<string, unknown>)[field.key] = value === true;
+ } else if (typeof value === "string") {
+ const trimmed = value.trim();
+ (input as Record<string, unknown>)[field.key] = field.key === "target" ? trimmed : trimmed || undefined;
+ }
+ }
+ if (Object.keys(extras).length) input.extras = extras;
+ return input;
+}
+
+function sameValues(left: ScannerRunDefaults, right: ScannerRunDefaults): boolean {
+ const keys = Array.from(new Set([...Object.keys(left), ...Object.keys(right)]));
+ for (const key of keys) {
+ if (left[key] !== right[key]) return false;
+ }
+ return true;
+}
+
+export default function ScannerRunParamsDialog({
+ open,
+ defaults,
+ schema,
+ onClose,
+ onRun,
+}: {
+ open: boolean;
+ defaults: ScannerRunDefaults;
+ schema?: ScannerCliSchema;
+ onClose: () => void;
+ onRun: (input: ScannerScanInput) => void;
+}) {
+ const messages = getMessage();
+ const fields = useMemo(() => trustablRunParamFields(schema), [schema]);
+ const seeded = useMemo(
+ () => ({ ...emptyScannerRunDefaults(fields), ...defaults }),
+ [defaults, fields]
+ );
+ const [values, setValues] = useState<ScannerRunDefaults>(seeded);
+
+ useEffect(() => {
+ if (!open) return;
+ setValues(seeded);
+ }, [open, seeded]);
+
+ const setField = (key: string, value: string | boolean) => {
+ setValues((current) => ({ ...current, [key]: value }));
+ };
+
+ const targetFields = pickFields(fields, TARGET_ORDER);
+ const scanSwitches = [
+ ...pickFields(fields, SCAN_ORDER),
+ ...leftoverFields(fields, new Set([...TARGET_ORDER, ...SCAN_ORDER, ...RULES_ORDER])).filter(
+ (field) => field.kind === "switch"
+ ),
+ ];
+ const scanRest = leftoverFields(fields, new Set([...TARGET_ORDER, ...SCAN_ORDER, ...RULES_ORDER])).filter(
+ (field) => field.kind !== "switch"
+ );
+ const rulesText = pickFields(fields, ["rulesSource", "rulesRef", "rulesRepo"]);
+ const rulesSwitches = pickFields(fields, ["requireSigned", "noRulesUpdate"]);
+ const canRun = Boolean(String(values.target || "").trim());
+ const dirty = !sameValues(values, seeded);
+
+ const run = () => {
+ if (!canRun) return;
+ onRun(toScanInput(values, fields));
+ };
+
+ return (
+ <Dialog open={open} onOpenChange={(next) => !next && onClose()}>
+ <DialogContent className="flex w-[calc(100vw-2rem)] max-h-[90vh] max-w-3xl flex-col gap-0 overflow-hidden border-stone-200 bg-white p-0 text-stone-950 shadow-2xl dark:border-stone-800 dark:bg-stone-950 dark:text-stone-50 sm:max-w-3xl">
+ <form
+ className="flex min-h-0 flex-1 flex-col"
+ onSubmit={(event) => {
+ event.preventDefault();
+ run();
+ }}
+ >
+ <DialogHeader className="shrink-0 space-y-1 border-b border-stone-200 px-6 py-4 pr-12 dark:border-stone-800">
+ <DialogTitle>{messages.SCANNER_RUN_PARAMS_TITLE}</DialogTitle>
+ <DialogDescription>{messages.SCANNER_RUN_PARAMS_DESCRIPTION}</DialogDescription>
+ </DialogHeader>
+
+ <div className="min-h-0 flex-1 space-y-5 overflow-y-auto px-6 py-5">
+ <Section title={messages.SCANNER_RUN_PARAMS_TARGET_SECTION}>
+ <div className="space-y-3">
+ {targetFields
+ .filter((field) => field.key === "target")
+ .map((field) => (
+ <TextField
+ key={field.key}
+ field={field}
+ value={values[field.key]}
+ required
+ onChange={(value) => setField(field.key, value)}
+ />
+ ))}
+ <div className="grid gap-3 sm:grid-cols-2">
+ {targetFields
+ .filter((field) => field.key !== "target")
+ .map((field) => (
+ <TextField
+ key={field.key}
+ field={field}
+ value={values[field.key]}
+ onChange={(value) => setField(field.key, value)}
+ />
+ ))}
+ </div>
+ </div>
+ </Section>
+
+ {scanSwitches.length || scanRest.length ? (
+ <Section title={messages.SCANNER_RUN_PARAMS_SCAN_SECTION}>
+ {scanRest.length ? (
+ <div className="mb-3 grid gap-3 sm:grid-cols-2">
+ {scanRest.map((field) => (
+ <TextField
+ key={field.key}
+ field={field}
+ value={values[field.key]}
+ onChange={(value) => setField(field.key, value)}
+ />
+ ))}
+ </div>
+ ) : null}
+ <SwitchGrid fields={scanSwitches} values={values} onChange={setField} />
+ </Section>
+ ) : null}
+
+ {rulesText.length || rulesSwitches.length ? (
+ <Section title={messages.SCANNER_RUN_PARAMS_RULES_SECTION}>
+ <div className="space-y-3">
+ <div className="grid gap-3 sm:grid-cols-2">
+ {rulesText
+ .filter((field) => field.key !== "rulesRepo")
+ .map((field) => (
+ <TextField
+ key={field.key}
+ field={field}
+ value={values[field.key]}
+ onChange={(value) => setField(field.key, value)}
+ />
+ ))}
+ </div>
+ {rulesText
+ .filter((field) => field.key === "rulesRepo")
+ .map((field) => (
+ <TextField
+ key={field.key}
+ field={field}
+ value={values[field.key]}
+ onChange={(value) => setField(field.key, value)}
+ />
+ ))}
+ {rulesSwitches.length ? (
+ <SwitchGrid fields={rulesSwitches} values={values} onChange={setField} />
+ ) : null}
+ </div>
+ </Section>
+ ) : null}
+
+ <p className="text-[11px] leading-4 text-muted-foreground">
+ {messages.SCANNER_RUN_PARAMS_TOKEN_NOTE}
+ </p>
+ </div>
+
+ <DialogFooter className="shrink-0 gap-2 border-t border-stone-200 px-6 py-3 sm:justify-end dark:border-stone-800">
+ <Button
+ type="button"
+ variant="ghost"
+ size="sm"
+ className="h-8"
+ disabled={!dirty}
+ onClick={() => setValues(seeded)}
+ >
+ {messages.RESET}
+ </Button>
+ <Button type="button" variant="outline" size="sm" className="h-8" onClick={onClose}>
+ {messages.CANCEL}
+ </Button>
+ <Button type="submit" size="sm" className="h-8" disabled={!canRun}>
+ {messages.SCANNER_RUN}
+ </Button>
+ </DialogFooter>
+ </form>
+ </DialogContent>
+ </Dialog>
+ );
+}
+
+function Section({ title, children }: { title: string; children: ReactNode }) {
+ return (
+ <section className="space-y-2.5">
+ <p className="text-[10px] font-semibold uppercase tracking-wide text-stone-500 dark:text-stone-400">
+ {title}
+ </p>
+ {children}
+ </section>
+ );
+}
+
+function FieldDescription({ text }: { text?: string }) {
+ if (!text) return null;
+ return <p className="text-[11px] leading-4 text-stone-500 dark:text-stone-400">{text}</p>;
+}
+
+function TextField({
+ field,
+ value,
+ required,
+ onChange,
+}: {
+ field: FieldDef;
+ value: string | boolean | undefined;
+ required?: boolean;
+ onChange: (value: string | boolean) => void;
+}) {
+ const controlId = `scanner-run-${field.key}`;
+ return (
+ <div className="space-y-1.5">
+ <Label htmlFor={controlId} className="text-xs">
+ {field.label}
+ </Label>
+ {field.kind === "select" && field.options ? (
+ <Select value={String(value || field.defaultValue || "")} onValueChange={onChange}>
+ <SelectTrigger id={controlId} className="h-8 bg-white dark:bg-stone-900">
+ <SelectValue />
+ </SelectTrigger>
+ <SelectContent>
+ {field.options.map((option) => (
+ <SelectItem key={option.value} value={option.value}>
+ {option.label}
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ ) : (
+ <Input
+ id={controlId}
+ value={String(value ?? "")}
+ placeholder={field.placeholder}
+ required={required}
+ autoComplete="off"
+ onChange={(event) => onChange(event.target.value)}
+ className="h-8 bg-white dark:bg-stone-900"
+ />
+ )}
+ <FieldDescription text={field.description} />
+ </div>
+ );
+}
+
+function SwitchGrid({
+ fields,
+ values,
+ onChange,
+}: {
+ fields: FieldDef[];
+ values: ScannerRunDefaults;
+ onChange: (key: string, value: boolean) => void;
+}) {
+ return (
+ <div className="grid gap-2 sm:grid-cols-2">
+ {fields.map((field) => {
+ const controlId = `scanner-run-${field.key}`;
+ return (
+ <div
+ key={field.key}
+ className="flex flex-col gap-1.5 rounded-md border border-stone-200 px-3 py-2.5 dark:border-stone-800"
+ >
+ <div className="flex items-center justify-between gap-3">
+ <Label htmlFor={controlId} className="text-xs font-medium">
+ {field.label}
+ </Label>
+ <Switch
+ id={controlId}
+ checked={values[field.key] === true}
+ onCheckedChange={(checked) => onChange(field.key, checked)}
+ />
+ </div>
+ <FieldDescription text={field.description} />
+ </div>
+ );
+ })}
+ </div>
+ );
+}
diff --git a/src/client/src/components/(playground)/scanner/scanner-runtime-panel.tsx b/src/client/src/components/(playground)/scanner/scanner-runtime-panel.tsx
new file mode 100644
index 00000000..b75fdb6b
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-runtime-panel.tsx
@@ -0,0 +1,201 @@
+"use client";
+
+import { useCallback, useEffect, useState } from "react";
+import { ChevronDown, Download, RefreshCw } from "lucide-react";
+import { toast } from "sonner";
+import FeatureAccess from "@/components/rbac/feature-access";
+import { Badge } from "@/components/ui/badge";
+import { Button } from "@/components/ui/button";
+import {
+ DropdownMenu,
+ DropdownMenuContent,
+ DropdownMenuItem,
+ DropdownMenuLabel,
+ DropdownMenuSeparator,
+ DropdownMenuTrigger,
+} from "@/components/ui/dropdown-menu";
+import getMessage from "@/constants/messages";
+import { getRequestHeaders } from "@/utils/api";
+import type { ScannerRuntimeInfo } from "@/lib/platform/connectors/scanner/types";
+
+export default function ScannerRuntimePanel({
+ compact = false,
+ onRuntimeChange,
+}: {
+ compact?: boolean;
+ onRuntimeChange?: (runtime: ScannerRuntimeInfo | null) => void;
+}) {
+ const messages = getMessage();
+ const [runtime, setRuntime] = useState<ScannerRuntimeInfo | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [working, setWorking] = useState(false);
+
+ const load = useCallback(async () => {
+ setLoading(true);
+ try {
+ const response = await fetch("/api/scanners/runtime", { headers: getRequestHeaders() });
+ const body = await response.json();
+ if (!response.ok) throw new Error(body?.err || messages.SCANNER_LOAD_FAILED);
+ setRuntime(body.runtime || null);
+ onRuntimeChange?.(body.runtime || null);
+ } catch {
+ setRuntime(null);
+ onRuntimeChange?.(null);
+ } finally {
+ setLoading(false);
+ }
+ }, [messages.SCANNER_LOAD_FAILED, onRuntimeChange]);
+
+ useEffect(() => {
+ void load();
+ }, [load]);
+
+ const install = async (upgrade: boolean) => {
+ setWorking(true);
+ toast.loading(upgrade ? messages.SCANNER_UPGRADE : messages.SCANNER_INSTALL, {
+ id: "scanner-install",
+ });
+ try {
+ const response = await fetch("/api/scanners/runtime", {
+ method: "POST",
+ headers: getRequestHeaders({ "Content-Type": "application/json" }),
+ body: JSON.stringify({ upgrade }),
+ });
+ const body = await response.json();
+ if (!response.ok) throw new Error(body?.err || messages.SCANNER_INSTALL_FAILED);
+ setRuntime(body.runtime || null);
+ onRuntimeChange?.(body.runtime || null);
+ toast.success(
+ upgrade ? messages.SCANNER_UPGRADE : messages.SCANNER_STATUS_READY,
+ { id: "scanner-install" }
+ );
+ } catch (error) {
+ toast.error(error instanceof Error ? error.message : messages.SCANNER_INSTALL_FAILED, {
+ id: "scanner-install",
+ });
+ } finally {
+ setWorking(false);
+ }
+ };
+
+ const versionLabel = runtime?.installed
+ ? runtime.version || runtime.binaryVersion
+ : messages.SCANNER_VERSION_UNKNOWN;
+
+ return (
+ <section
+ className={
+ compact
+ ? "shrink-0"
+ : "space-y-3 rounded-lg border border-stone-200 p-4 dark:border-stone-800"
+ }
+ >
+ {compact ? (
+ <DropdownMenu>
+ <DropdownMenuTrigger asChild>
+ <Button
+ variant="outline"
+ size="sm"
+ className="h-8 max-w-[8.5rem] gap-1 px-2 text-xs"
+ aria-label={messages.SCANNER_CLI_MENU}
+ disabled={working}
+ >
+ <span className="truncate">
+ {loading ? messages.SCANNER_RUNTIME_CHECKING : versionLabel}
+ </span>
+ <ChevronDown className="size-3.5 shrink-0 opacity-60" />
+ </Button>
+ </DropdownMenuTrigger>
+ <DropdownMenuContent align="end" className="w-56">
+ <DropdownMenuLabel>{messages.SCANNER_RUNTIME_SECTION}</DropdownMenuLabel>
+ <div className="px-2 pb-1.5 text-[11px] text-muted-foreground">
+ {messages.SCANNER_VERSION_INSTALLED}: {loading ? messages.SCANNER_RUNTIME_CHECKING : versionLabel}
+ {runtime?.latestVersion ? ` · ${messages.SCANNER_VERSION_LATEST} ${runtime.latestVersion}` : ""}
+ </div>
+ <DropdownMenuSeparator />
+ <FeatureAccess access="scanner.install" hideWhenDenied>
+ {!runtime?.installed ? (
+ <DropdownMenuItem disabled={working || loading} onSelect={() => void install(false)}>
+ <Download className="mr-2 size-3.5" />
+ {messages.SCANNER_INSTALL}
+ </DropdownMenuItem>
+ ) : null}
+ {runtime?.upgradeAvailable ? (
+ <DropdownMenuItem disabled={working || loading} onSelect={() => void install(true)}>
+ <Download className="mr-2 size-3.5" />
+ {runtime.latestVersion
+ ? messages.SCANNER_UPGRADE_TO(runtime.latestVersion)
+ : messages.SCANNER_UPGRADE}
+ </DropdownMenuItem>
+ ) : null}
+ </FeatureAccess>
+ <DropdownMenuItem disabled={working || loading} onSelect={() => void load()}>
+ <RefreshCw className={`mr-2 size-3.5 ${loading ? "animate-spin" : ""}`} />
+ {messages.SCANNER_REFRESH}
+ </DropdownMenuItem>
+ </DropdownMenuContent>
+ </DropdownMenu>
+ ) : (
+ <>
+ <div>
+ <p className="text-xs font-semibold text-stone-950 dark:text-stone-50">
+ {messages.SCANNER_RUNTIME_SECTION}
+ </p>
+ <p className="mt-0.5 text-[11px] text-muted-foreground">
+ {messages.SCANNER_RUNTIME_SECTION_DESCRIPTION}
+ </p>
+ <div className="mt-2 flex flex-wrap items-center gap-2">
+ <Badge variant={runtime?.installed ? "secondary" : "outline"} className="text-[10px]">
+ {messages.SCANNER_VERSION_INSTALLED}: {loading ? messages.SCANNER_RUNTIME_CHECKING : versionLabel}
+ </Badge>
+ {runtime?.latestVersion ? (
+ <Badge variant="outline" className="text-[10px]">
+ {messages.SCANNER_VERSION_LATEST}: {runtime.latestVersion}
+ </Badge>
+ ) : null}
+ </div>
+ </div>
+ <div className="flex flex-wrap items-center gap-1.5">
+ <FeatureAccess access="scanner.install" hideWhenDenied>
+ {!runtime?.installed ? (
+ <Button
+ size="sm"
+ className="h-8 gap-1.5"
+ disabled={working || loading}
+ onClick={() => void install(false)}
+ >
+ <Download className="size-3.5" />
+ {messages.SCANNER_INSTALL}
+ </Button>
+ ) : null}
+ {runtime?.upgradeAvailable ? (
+ <Button
+ size="sm"
+ className="h-8 gap-1.5"
+ disabled={working || loading}
+ onClick={() => void install(true)}
+ >
+ <Download className="size-3.5" />
+ {runtime.latestVersion
+ ? messages.SCANNER_UPGRADE_TO(runtime.latestVersion)
+ : messages.SCANNER_UPGRADE}
+ </Button>
+ ) : null}
+ </FeatureAccess>
+ <Button
+ size="sm"
+ variant="outline"
+ className="h-8 gap-1.5"
+ disabled={working || loading}
+ title={messages.SCANNER_REFRESH}
+ onClick={() => void load()}
+ >
+ <RefreshCw className={`size-3.5 ${loading ? "animate-spin" : ""}`} />
+ {messages.SCANNER_REFRESH}
+ </Button>
+ </div>
+ </>
+ )}
+ </section>
+ );
+}
diff --git a/src/client/src/components/(playground)/scanner/scanner-session-findings.tsx b/src/client/src/components/(playground)/scanner/scanner-session-findings.tsx
new file mode 100644
index 00000000..56e0f2a4
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-session-findings.tsx
@@ -0,0 +1,149 @@
+"use client";
+
+import { useEffect, useState } from "react";
+import Link from "next/link";
+import FeatureAccess from "@/components/rbac/feature-access";
+import { Button } from "@/components/ui/button";
+import { Skeleton } from "@/components/ui/skeleton";
+import getMessage from "@/constants/messages";
+import { getRequestHeaders } from "@/utils/api";
+import type { ScannerRepoFindingsResult } from "@/lib/platform/connectors/scanner/types";
+import type { ScannerFinding } from "@/lib/platform/connectors/scanner/types";
+
+function severityTone(severity: string): string {
+ if (severity === "critical") {
+ return "bg-rose-100 text-rose-800 dark:bg-rose-900/40 dark:text-rose-300";
+ }
+ if (severity === "high") {
+ return "bg-orange-100 text-orange-800 dark:bg-orange-900/40 dark:text-orange-300";
+ }
+ if (severity === "medium") {
+ return "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300";
+ }
+ if (severity === "info" || severity === "meta") {
+ return "bg-sky-100 text-sky-800 dark:bg-sky-900/40 dark:text-sky-300";
+ }
+ return "bg-stone-100 text-stone-700 dark:bg-stone-800 dark:text-stone-300";
+}
+
+function FindingRow({ finding }: { finding: ScannerFinding }) {
+ const location = [finding.path, finding.line ? String(finding.line) : ""]
+ .filter(Boolean)
+ .join(":");
+ const meta = [finding.ruleId, finding.scope || finding.category, location]
+ .filter(Boolean)
+ .join(" · ");
+ return (
+ <div className="flex items-start gap-3 border-b border-stone-100 px-1 py-2 last:border-b-0 dark:border-stone-900">
+ <span
+ className={`mt-0.5 inline-flex shrink-0 rounded px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide ${severityTone(finding.severity)}`}
+ >
+ {finding.severity}
+ </span>
+ <span className="min-w-0 flex-1">
+ <span className="block truncate text-xs font-medium text-stone-900 dark:text-stone-100">
+ {finding.title}
+ </span>
+ {meta ? (
+ <span className="mt-0.5 block truncate font-mono text-[10px] text-stone-500 dark:text-stone-400">
+ {meta}
+ </span>
+ ) : null}
+ </span>
+ </div>
+ );
+}
+
+export default function ScannerSessionFindings({ repoUrl }: { repoUrl: string }) {
+ const messages = getMessage();
+ const [result, setResult] = useState<ScannerRepoFindingsResult | null>(null);
+ const [loading, setLoading] = useState(true);
+ const [error, setError] = useState<string | null>(null);
+
+ useEffect(() => {
+ if (!repoUrl) {
+ setResult(null);
+ setLoading(false);
+ return;
+ }
+ let cancelled = false;
+ setLoading(true);
+ setError(null);
+ (async () => {
+ try {
+ const response = await fetch(
+ `/api/scanners/findings?repoUrl=${encodeURIComponent(repoUrl)}`,
+ { headers: getRequestHeaders() }
+ );
+ const body = await response.json();
+ if (!response.ok) {
+ throw new Error(body?.err || messages.SCANNER_FINDINGS_LOAD_FAILED);
+ }
+ if (!cancelled) setResult(body as ScannerRepoFindingsResult);
+ } catch (cause) {
+ if (!cancelled) {
+ setError(
+ cause instanceof Error
+ ? cause.message
+ : messages.SCANNER_FINDINGS_LOAD_FAILED
+ );
+ }
+ } finally {
+ if (!cancelled) setLoading(false);
+ }
+ })();
+ return () => {
+ cancelled = true;
+ };
+ }, [messages.SCANNER_FINDINGS_LOAD_FAILED, repoUrl]);
+
+ return (
+ <FeatureAccess access="scanner.read" hideWhenDenied>
+ <div className="flex min-h-0 flex-col gap-2">
+ {loading ? (
+ <div className="space-y-2">
+ <Skeleton className="h-4 w-48" />
+ <Skeleton className="h-10 w-full" />
+ <Skeleton className="h-10 w-full" />
+ </div>
+ ) : error ? (
+ <p className="text-xs text-stone-500 dark:text-stone-400">{error}</p>
+ ) : result?.matched ? (
+ <>
+ <div className="flex items-center justify-between gap-2">
+ <p className="text-xs text-stone-600 dark:text-stone-400">
+ {result.findingCount > 0
+ ? messages.SCANNER_SESSION_SUMMARY(
+ result.mediumPlusCount,
+ result.findingCount
+ )
+ : messages.SCANNER_SESSION_CLEAN}
+ </p>
+ <Button asChild variant="outline" size="sm" className="h-7 px-2 text-[11px]">
+ <Link href={result.url}>{messages.SCANNER_SESSION_OPEN}</Link>
+ </Button>
+ </div>
+ {result.findings.length ? (
+ <div className="min-h-0 overflow-auto">
+ {result.findings.map((finding) => (
+ <FindingRow key={finding.id} finding={finding} />
+ ))}
+ </div>
+ ) : null}
+ </>
+ ) : (
+ <div className="flex items-center justify-between gap-2">
+ <p className="text-xs text-stone-500 dark:text-stone-400">
+ {messages.SCANNER_SESSION_EMPTY}
+ </p>
+ <Button asChild variant="outline" size="sm" className="h-7 px-2 text-[11px]">
+ <Link href={result?.url || "/scanner"}>
+ {messages.SCANNER_SESSION_OPEN}
+ </Link>
+ </Button>
+ </div>
+ )}
+ </div>
+ </FeatureAccess>
+ );
+}
diff --git a/src/client/src/components/(playground)/scanner/scanner-workspace.tsx b/src/client/src/components/(playground)/scanner/scanner-workspace.tsx
new file mode 100644
index 00000000..ab70d186
--- /dev/null
+++ b/src/client/src/components/(playground)/scanner/scanner-workspace.tsx
@@ -0,0 +1,513 @@
+"use client";
+
+import { useEffect, useState, type ReactNode } from "react";
+import { AlertTriangle, ChevronDown, Clock, FileWarning, GitBranch, ShieldAlert } from "lucide-react";
+import { Collapsible, CollapsibleContent, CollapsibleTrigger } from "@/components/ui/collapsible";
+import { Input } from "@/components/ui/input";
+import {
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+} from "@/components/ui/select";
+import {
+ Pagination,
+ PaginationContent,
+ PaginationItem,
+ PaginationNext,
+ PaginationPrevious,
+} from "@/components/ui/pagination";
+import { Skeleton } from "@/components/ui/skeleton";
+import getMessage from "@/constants/messages";
+import { formatBrowserDateTime } from "@/utils/date";
+import { getRequestHeaders } from "@/utils/api";
+import type { ScannerFinding, ScannerJob } from "@/lib/platform/connectors/scanner/types";
+import {
+ SCANNER_FINDINGS_PAGE_SIZE,
+ type ScannerFindingCounts,
+ type ScannerFindingPageItem,
+ type ScannerFindingSeverityFilter,
+} from "@/lib/platform/connectors/scanner/job-findings";
+
+function formatDuration(durationMs?: number): string {
+ if (!durationMs || durationMs <= 0) return "—";
+ if (durationMs < 1000) return `${Math.round(durationMs)}ms`;
+ const sec = durationMs / 1000;
+ if (sec < 60) return `${sec < 10 ? sec.toFixed(1) : Math.round(sec)}s`;
+ return `${(sec / 60).toFixed(1)}m`;
+}
+
+function formatScore(score: number | undefined, asValue: (n: number) => string): string | undefined {
+ if (typeof score !== "number" || !Number.isFinite(score)) return undefined;
+ const outOf100 = Math.round(score <= 1 ? score * 100 : score);
+ if (outOf100 < 0) return undefined;
+ return asValue(Math.min(outOf100, 100));
+}
+
+function findingCount(job?: ScannerJob | null): number {
+ return job?.findingCount ?? job?.findings?.length ?? 0;
+}
+
+function mediumPlusCount(job?: ScannerJob | null): number {
+ if (typeof job?.mediumPlusCount === "number") return job.mediumPlusCount;
+ return (job?.findings || []).filter((item) =>
+ ["medium", "high", "critical", "error"].includes(item.severity)
+ ).length;
+}
+
+function Stat({ icon, label, value, hint }: { icon: ReactNode; label: string; value?: string; hint?: string }) {
+ return (
+ <div className="rounded-md bg-stone-100 px-2 py-1 dark:bg-stone-900">
+ <div className="flex items-center gap-1 text-[10px] text-stone-500 dark:text-stone-400">
+ {icon}
+ {label}
+ </div>
+ <div className="mt-0.5 truncate text-xs font-semibold text-stone-900 dark:text-stone-100">
+ {value || "—"}
+ </div>
+ {hint ? <div className="truncate text-[10px] text-muted-foreground">{hint}</div> : null}
+ </div>
+ );
+}
+
+function MetaPill({ label, value }: { label: string; value?: string }) {
+ if (!value) return null;
+ return (
+ <div className="min-w-0 rounded-md border border-stone-200 bg-white px-2 py-1 dark:border-stone-800 dark:bg-stone-950">
+ <div className="text-[10px] uppercase tracking-wide text-stone-500 dark:text-stone-400">{label}</div>
+ <div className="max-w-72 truncate font-mono text-[11px] font-medium text-stone-900 dark:text-stone-100" title={value}>
+ {value}
+ </div>
+ </div>
+ );
+}
+
+function severityTone(severity: string): string {
+ if (severity === "critical") {
+ return "bg-rose-100 text-rose-800 dark:bg-rose-900/40 dark:text-rose-300";
+ }
+ if (severity === "high") {
+ return "bg-orange-100 text-orange-800 dark:bg-orange-900/40 dark:text-orange-300";
+ }
+ if (severity === "medium") {
+ return "bg-amber-100 text-amber-800 dark:bg-amber-900/40 dark:text-amber-300";
+ }
+ if (severity === "info" || severity === "meta") {
+ return "bg-sky-100 text-sky-800 dark:bg-sky-900/40 dark:text-sky-300";
+ }
+ return "bg-stone-100 text-stone-700 dark:bg-stone-800 dark:text-stone-300";
+}
+
+function severityBar(severity: string): string {
+ if (severity === "critical") return "bg-rose-600";
+ if (severity === "high") return "bg-orange-500";
+ if (severity === "medium") return "bg-amber-400";
+ return "bg-stone-300 dark:bg-stone-600";
+}
+
+function inventoryLabel(messages: ReturnType<typeof getMessage>, job?: ScannerJob | null): string | undefined {
+ const report = job?.report;
+ if (!report) return undefined;
+ const parts = [
+ report.toolCount ? `${report.toolCount} ${messages.SCANNER_TOOLS.toLowerCase()}` : "",
+ report.agentCount ? `${report.agentCount} ${messages.SCANNER_AGENTS.toLowerCase()}` : "",
+ report.mcpCount ? `${report.mcpCount} ${messages.SCANNER_MCP.toLowerCase()}` : "",
+ report.skillCount ? `${report.skillCount} ${messages.SCANNER_SKILLS.toLowerCase()}` : "",
+ report.subagentCount ? `${report.subagentCount} ${messages.SCANNER_SUBAGENTS.toLowerCase()}` : "",
+ ].filter(Boolean);
+ return parts.length ? parts.join(" · ") : undefined;
+}
+
+function coverageLabel(job?: ScannerJob | null): string | undefined {
+ const parsed = job?.report?.filesParsed;
+ const skipped = job?.report?.filesSkipped;
+ if (parsed == null && skipped == null) return undefined;
+ return `${parsed ?? 0} / ${skipped ?? 0}`;
+}
+
+function useDebouncedValue<T>(value: T, delayMs: number): T {
+ const [debounced, setDebounced] = useState(value);
+ useEffect(() => {
+ const timer = window.setTimeout(() => setDebounced(value), delayMs);
+ return () => window.clearTimeout(timer);
+ }, [delayMs, value]);
+ return debounced;
+}
+
+const EMPTY_COUNTS: ScannerFindingCounts = { all: 0, critical: 0, high: 0, medium: 0, low: 0 };
+
+export default function ScannerWorkspace({
+ connectorId,
+ repoLabel,
+ jobs,
+ selectedJob,
+ previousJob,
+ onSelectJob,
+ onOpenFinding,
+}: {
+ connectorId?: string;
+ repoLabel?: string;
+ jobs: ScannerJob[];
+ selectedJob?: ScannerJob;
+ previousJob?: ScannerJob;
+ onSelectJob: (jobId: string) => void;
+ onOpenFinding: (finding: ScannerFinding, alertNumber: number) => void;
+}) {
+ const messages = getMessage();
+ const [severityFilter, setSeverityFilter] = useState<ScannerFindingSeverityFilter>("all");
+ const [query, setQuery] = useState("");
+ const [page, setPage] = useState(1);
+ const [loading, setLoading] = useState(false);
+ const [findings, setFindings] = useState<ScannerFindingPageItem[]>([]);
+ const [total, setTotal] = useState(0);
+ const [counts, setCounts] = useState<ScannerFindingCounts>(EMPTY_COUNTS);
+ const debouncedQuery = useDebouncedValue(query, 300);
+ const openDelta = previousJob ? findingCount(selectedJob) - findingCount(previousJob) : null;
+ const mediumDelta = previousJob ? mediumPlusCount(selectedJob) - mediumPlusCount(previousJob) : null;
+ const params = selectedJob?.params;
+ const extras = selectedJob?.report?.extras;
+ const extraFlags = Object.entries(params?.extras || {})
+ .filter(([, value]) => value === true || (typeof value === "string" && value))
+ .map(([key, value]) => (value === true ? key : `${key}=${value}`));
+ const enabledFlags = [
+ params?.strict ? messages.SCANNER_FIELD_STRICT : "",
+ params?.secretScan ? messages.SCANNER_FIELD_SECRET_SCAN : "",
+ params?.vulnScan ? messages.SCANNER_FIELD_VULN_SCAN : "",
+ params?.licenseScan ? messages.SCANNER_FIELD_LICENSE_SCAN : "",
+ params?.noRulesUpdate ? messages.SCANNER_FIELD_NO_RULES_UPDATE : "",
+ params?.verbose ? messages.SCANNER_FIELD_VERBOSE : "",
+ ...extraFlags,
+ ].filter(Boolean);
+ const totalPages = Math.max(1, Math.ceil(total / SCANNER_FINDINGS_PAGE_SIZE) || 1);
+
+ useEffect(() => {
+ setQuery("");
+ setSeverityFilter("all");
+ setPage(1);
+ }, [selectedJob?.id]);
+
+ useEffect(() => {
+ if (!connectorId || !selectedJob?.id) {
+ setFindings([]);
+ setTotal(0);
+ setCounts(EMPTY_COUNTS);
+ return;
+ }
+ const controller = new AbortController();
+ setLoading(true);
+ const params = new URLSearchParams({
+ q: debouncedQuery,
+ severity: severityFilter,
+ page: String(page),
+ limit: String(SCANNER_FINDINGS_PAGE_SIZE),
+ });
+ void fetch(
+ `/api/scanners/${encodeURIComponent(connectorId)}/jobs/${encodeURIComponent(selectedJob.id)}/findings?${params}`,
+ { headers: getRequestHeaders(), signal: controller.signal }
+ )
+ .then(async (response) => {
+ const body = await response.json();
+ if (!response.ok) throw new Error(body?.err || messages.SCANNER_FINDINGS_LOAD_FAILED);
+ if (controller.signal.aborted) return;
+ setFindings(body.findings || []);
+ setTotal(typeof body.total === "number" ? body.total : 0);
+ setCounts(body.counts || EMPTY_COUNTS);
+ })
+ .catch((error: unknown) => {
+ if (controller.signal.aborted || (error instanceof DOMException && error.name === "AbortError")) {
+ return;
+ }
+ setFindings([]);
+ setTotal(0);
+ })
+ .finally(() => {
+ if (!controller.signal.aborted) setLoading(false);
+ });
+ return () => controller.abort();
+ }, [connectorId, debouncedQuery, messages.SCANNER_FINDINGS_LOAD_FAILED, page, selectedJob?.id, severityFilter]);
+
+ const filters: { id: ScannerFindingSeverityFilter; label: string }[] = [
+ { id: "all", label: messages.SCANNER_OPEN_COUNT(counts.all) },
+ { id: "critical", label: `${messages.SCANNER_CRITICAL} ${counts.critical}` },
+ { id: "high", label: `${messages.SCANNER_HIGH} ${counts.high}` },
+ { id: "medium", label: `${messages.SCANNER_MEDIUM} ${counts.medium}` },
+ { id: "low", label: `${messages.SCANNER_LOW} ${counts.low}` },
+ ];
+
+ return (
+ <div className="flex min-h-0 flex-1 flex-col overflow-hidden p-3">
+ <div className="mb-2 space-y-2">
+ <div className="flex items-start justify-between gap-3">
+ <div className="min-w-0">
+ <h2 className="truncate text-sm font-semibold text-stone-950 dark:text-stone-50">
+ {repoLabel || selectedJob?.target || messages.FEATURE_SCANNER}
+ </h2>
+ <p className="mt-0.5 truncate text-[11px] text-muted-foreground">
+ {messages.SCANNER_JOB_RUN_OPTION([
+ messages.SCANNER_OPEN_COUNT(findingCount(selectedJob)),
+ selectedJob?.status || "",
+ ])}
+ </p>
+ </div>
+ {jobs.length && selectedJob ? (
+ <Select value={selectedJob.id} onValueChange={onSelectJob}>
+ <SelectTrigger
+ aria-label={messages.SCANNER_JOB_RUN_LABEL}
+ className="h-9 w-[13.5rem] shrink-0 gap-2 bg-white px-2 text-left text-xs dark:bg-stone-950 [&>span]:line-clamp-none [&>span]:flex [&>span]:min-w-0 [&>span]:flex-1 [&>svg]:ml-0 [&>svg]:size-3.5 [&>svg]:shrink-0"
+ >
+ <span className="flex min-w-0 flex-1 items-center gap-2">
+ <Clock className="size-3.5 shrink-0 text-stone-500" />
+ <span className="min-w-0 flex-1 text-left leading-tight">
+ <span className="block text-[10px] font-medium uppercase tracking-wide text-stone-500 dark:text-stone-400">
+ {messages.SCANNER_JOB_RUN_LABEL}
+ </span>
+ <span className="block truncate font-medium text-stone-900 dark:text-stone-100">
+ {formatBrowserDateTime(selectedJob.startedAt)}
+ </span>
+ </span>
+ </span>
+ </SelectTrigger>
+ <SelectContent align="end" className="w-72">
+ {jobs.map((job) => (
+ <SelectItem key={job.id} value={job.id} textValue={formatBrowserDateTime(job.startedAt)}>
+ <span className="flex min-w-0 flex-col">
+ <span className="truncate">{formatBrowserDateTime(job.startedAt)}</span>
+ <span className="truncate text-[10px] text-muted-foreground">
+ {messages.SCANNER_JOB_RUN_OPTION([
+ job.status,
+ messages.SCANNER_FINDING_COUNT(job.findingCount ?? job.findings?.length ?? 0),
+ job.ref,
+ job.cliVersion,
+ ])}
+ </span>
+ </span>
+ </SelectItem>
+ ))}
+ </SelectContent>
+ </Select>
+ ) : (
+ <span className="shrink-0 pt-2 text-[11px] text-muted-foreground">
+ {messages.SCANNER_JOB_RUN_PLACEHOLDER}
+ </span>
+ )}
+ </div>
+ <div className="grid grid-cols-3 gap-1.5 lg:grid-cols-6">
+ <Stat
+ icon={<FileWarning className="h-3 w-3" />}
+ label={messages.SCANNER_OPEN_FINDINGS}
+ value={String(findingCount(selectedJob))}
+ hint={openDelta !== null ? messages.SCANNER_VS_PREVIOUS(openDelta) : undefined}
+ />
+ <Stat
+ icon={<AlertTriangle className="h-3 w-3" />}
+ label={messages.SCANNER_MEDIUM_PLUS}
+ value={String(mediumPlusCount(selectedJob))}
+ hint={mediumDelta !== null ? messages.SCANNER_VS_PREVIOUS(mediumDelta) : undefined}
+ />
+ <Stat
+ icon={<ShieldAlert className="h-3 w-3" />}
+ label={messages.SCANNER_CRITICAL}
+ value={String(counts.critical)}
+ />
+ <Stat
+ icon={<ShieldAlert className="h-3 w-3" />}
+ label={messages.SCANNER_HIGH}
+ value={String(counts.high)}
+ />
+ <Stat
+ icon={<GitBranch className="h-3 w-3" />}
+ label={messages.SCANNER_SCORE}
+ value={formatScore(selectedJob?.report?.overallScore, messages.SCANNER_SCORE_VALUE)}
+ />
+ <Stat
+ icon={<Clock className="h-3 w-3" />}
+ label={messages.SCANNER_DURATION}
+ value={formatDuration(selectedJob?.durationMs)}
+ />
+ </div>
+ <Collapsible className="overflow-hidden rounded-md border border-stone-200 dark:border-stone-800">
+ <CollapsibleTrigger className="flex w-full items-center justify-between gap-2 bg-stone-50 px-2.5 py-1.5 text-left text-[11px] font-medium text-stone-700 hover:bg-stone-100 dark:bg-stone-900 dark:text-stone-200 dark:hover:bg-stone-800 [&[data-state=open]>svg]:rotate-180">
+ {messages.SCANNER_JOB_DETAILS}
+ <ChevronDown className="size-3.5 shrink-0 text-stone-500 transition-transform duration-200" />
+ </CollapsibleTrigger>
+ <CollapsibleContent>
+ <div className="flex flex-wrap gap-1.5 border-t border-stone-200 bg-white p-2.5 dark:border-stone-800 dark:bg-stone-950">
+ <MetaPill label={messages.SCANNER_STATUS} value={selectedJob?.status} />
+ <MetaPill
+ label={messages.SCANNER_EXIT_CODE}
+ value={selectedJob?.exitCode != null ? String(selectedJob.exitCode) : undefined}
+ />
+ <MetaPill label={messages.SCANNER_JOB_ID} value={selectedJob?.id} />
+ <MetaPill label={messages.SCANNER_CLI_VERSION} value={selectedJob?.cliVersion} />
+ <MetaPill label={messages.SCANNER_FIELD_REF} value={selectedJob?.ref} />
+ <MetaPill label={messages.SCANNER_RULES_SOURCE} value={params?.rulesSource || selectedJob?.report?.rulesSource} />
+ <MetaPill label={messages.SCANNER_RULES_VERSION} value={selectedJob?.report?.rulesVersion} />
+ <MetaPill label={messages.SCANNER_FIELD_DETECTORS} value={params?.detectors} />
+ <MetaPill label={messages.SCANNER_LANGUAGES} value={selectedJob?.report?.languages?.join(", ")} />
+ <MetaPill label={messages.SCANNER_SDKS} value={selectedJob?.report?.sdks?.join(", ")} />
+ <MetaPill label={messages.SCANNER_INVENTORY} value={inventoryLabel(messages, selectedJob)} />
+ <MetaPill label={messages.SCANNER_COVERAGE} value={coverageLabel(selectedJob)} />
+ <MetaPill label={messages.SCANNER_RUN_PARAMS_SCAN_SECTION} value={enabledFlags.join(" · ") || undefined} />
+ {extras
+ ? Object.entries(extras).map(([key, value]) => (
+ <MetaPill key={key} label={key} value={value} />
+ ))
+ : null}
+ </div>
+ </CollapsibleContent>
+ </Collapsible>
+ {selectedJob?.report?.noAgentSurfaces ? (
+ <p className="text-[11px] text-muted-foreground">{messages.SCANNER_NO_AGENT_SURFACES}</p>
+ ) : null}
+ {selectedJob?.error ? (
+ <p className="text-[11px] text-error">
+ {messages.SCANNER_JOB_ERROR}: {selectedJob.error}
+ </p>
+ ) : null}
+ </div>
+
+ <div className="flex min-h-0 flex-1 flex-col overflow-hidden rounded-md border border-stone-200 bg-white dark:border-stone-800 dark:bg-stone-950">
+ <div className="flex shrink-0 items-center gap-2 border-b border-stone-200 px-2 py-1.5 dark:border-stone-800">
+ <div className="flex min-w-0 flex-1 items-center gap-1 overflow-x-auto">
+ {filters.map((filter) => {
+ const active = severityFilter === filter.id;
+ return (
+ <button
+ key={filter.id}
+ type="button"
+ onClick={() => {
+ setSeverityFilter(filter.id);
+ setPage(1);
+ }}
+ className={`h-7 shrink-0 rounded-md px-2 text-[11px] font-medium ${
+ active
+ ? "bg-stone-900 text-white dark:bg-stone-100 dark:text-stone-900"
+ : "text-stone-600 hover:bg-stone-100 dark:text-stone-300 dark:hover:bg-stone-900"
+ }`}
+ >
+ {filter.label}
+ </button>
+ );
+ })}
+ </div>
+ <Input
+ value={query}
+ onChange={(event) => {
+ setQuery(event.target.value);
+ setPage(1);
+ }}
+ placeholder={messages.SCANNER_SEARCH_FINDINGS}
+ className="h-7 w-40 shrink-0 text-xs"
+ aria-label={messages.SCANNER_SEARCH_FINDINGS}
+ />
+ </div>
+ {selectedJob ? (
+ loading && !findings.length ? (
+ <div className="space-y-2 p-3">
+ <Skeleton className="h-10 w-full" />
+ <Skeleton className="h-10 w-full" />
+ <Skeleton className="h-10 w-full" />
+ </div>
+ ) : findings.length ? (
+ <>
+ <div className="min-h-0 flex-1 overflow-auto">
+ {findings.map((item) => {
+ const location = [item.path, item.line ? String(item.line) : ""]
+ .filter(Boolean)
+ .join(":");
+ const meta = [item.ruleId, item.scope || item.category].filter(Boolean).join(" · ");
+ return (
+ <button
+ key={item.id}
+ type="button"
+ onClick={() => onOpenFinding(item, item.alertNumber)}
+ className="flex w-full items-stretch gap-0 border-b border-stone-100 text-left hover:bg-stone-50 dark:border-stone-900 dark:hover:bg-stone-900/60"
+ >
+ <span className={`w-1 shrink-0 ${severityBar(item.severity)}`} />
+ <span className="flex min-w-0 flex-1 items-center gap-3 px-3 py-2">
+ <span className="w-8 shrink-0 font-mono text-[11px] text-stone-400">
+ {messages.SCANNER_FINDING_NUMBER(item.alertNumber)}
+ </span>
+ <span className="min-w-0 flex-1">
+ <span className="block truncate text-xs font-semibold text-stone-900 dark:text-stone-100">
+ {item.title}
+ </span>
+ <span className="mt-0.5 block truncate text-[11px] text-stone-500 dark:text-stone-400">
+ {meta}
+ </span>
+ </span>
+ <span className="flex shrink-0 flex-col items-end gap-0.5">
+ <span
+ className={`inline-flex rounded px-1.5 py-0.5 text-[10px] font-semibold uppercase tracking-wide ${severityTone(item.severity)}`}
+ >
+ {item.severity}
+ </span>
+ {location ? (
+ <span className="max-w-36 truncate font-mono text-[10px] text-stone-500 dark:text-stone-400" title={location}>
+ {location}
+ </span>
+ ) : null}
+ </span>
+ </span>
+ </button>
+ );
+ })}
+ </div>
+ {total > SCANNER_FINDINGS_PAGE_SIZE ? (
+ <div className="flex shrink-0 items-center justify-end border-t border-stone-200 px-2 py-1 dark:border-stone-800">
+ <Pagination className="m-0 w-auto">
+ <PaginationContent className="gap-0.5">
+ <PaginationItem>
+ <PaginationPrevious
+ className={`h-7 px-2 py-1 ${
+ page === 1
+ ? "pointer-events-none cursor-not-allowed text-stone-400"
+ : "text-stone-950 dark:text-stone-100"
+ }`}
+ aria-label={messages.SCANNER_PAGE_PREVIOUS}
+ aria-disabled={page === 1}
+ onClick={(event) => {
+ event.preventDefault();
+ setPage((value) => Math.max(1, value - 1));
+ }}
+ />
+ </PaginationItem>
+ <PaginationItem>
+ <div className="whitespace-nowrap px-1 text-xs text-stone-950 dark:text-stone-100">
+ {messages.SCANNER_PAGE_OF(page, totalPages)}
+ </div>
+ </PaginationItem>
+ <PaginationItem>
+ <PaginationNext
+ className={`h-7 px-2 py-1 ${
+ page >= totalPages
+ ? "pointer-events-none cursor-not-allowed text-stone-400"
+ : "text-stone-950 dark:text-stone-100"
+ }`}
+ aria-label={messages.SCANNER_PAGE_NEXT}
+ aria-disabled={page >= totalPages}
+ onClick={(event) => {
+ event.preventDefault();
+ setPage((value) => Math.min(totalPages, value + 1));
+ }}
+ />
+ </PaginationItem>
+ </PaginationContent>
+ </Pagination>
+ </div>
+ ) : null}
+ </>
+ ) : (
+ <div className="flex flex-1 items-center justify-center px-4 text-center text-xs text-muted-foreground">
+ {messages.SCANNER_EMPTY_FINDINGS}
+ </div>
+ )
+ ) : (
+ <div className="flex flex-1 items-center justify-center px-4 text-center text-xs text-muted-foreground">
+ {messages.SCANNER_EMPTY_REPO_JOBS}
+ </div>
+ )}
+ </div>
+ </div>
+ );
+}
diff --git a/src/client/src/components/(playground)/telemetry-source/data-sources-page.tsx b/src/client/src/components/(playground)/telemetry-source/data-sources-page.tsx
index da033c2c..e7378b34 100644
--- a/src/client/src/components/(playground)/telemetry-source/data-sources-page.tsx
+++ b/src/client/src/components/(playground)/telemetry-source/data-sources-page.tsx
@@ -51,8 +51,12 @@ import {
} from "@/components/ui/dialog";
import getMessage from "@/constants/messages";
import FeatureAccess from "@/components/rbac/feature-access";
+import ScannerRuntimePanel from "@/components/(playground)/scanner/scanner-runtime-panel";
import type { FieldDef } from "@/lib/platform/connectors/datasource/types";
+import { trustablConfigFields } from "@/lib/platform/connectors/scanner/config-fields";
+import type { ScannerCliSchema } from "@/lib/platform/connectors/scanner/cli-schema";
+import type { ScannerRuntimeInfo } from "@/lib/platform/connectors/scanner/types";
import { getDatabaseConfigList } from "@/selectors/database-config";
import { useRootStore } from "@/store";
import { getCurrentProjectEnvironment } from "@/selectors/project";
@@ -495,7 +499,12 @@ export default function DataSourcesPage({
() =>
visibleSources.filter((source) => {
const signals = parseSignals(source.signals);
- const category = source.category === "memory" ? "memory" : "datasource";
+ const category =
+ source.category === "memory"
+ ? "memory"
+ : source.category === "scanner"
+ ? "scanner"
+ : "datasource";
return configuredConnectorMatches({
query: connectorSearch,
typeFilter,
@@ -511,6 +520,7 @@ export default function DataSourcesPage({
source.category,
source.signals,
category === "memory" ? messages.CONNECTOR_CATEGORY_MEMORY : "",
+ category === "scanner" ? messages.CONNECTOR_CATEGORY_SCANNER : "",
].join(" "),
});
}),
@@ -518,6 +528,7 @@ export default function DataSourcesPage({
categoryFilter,
connectorSearch,
messages.CONNECTOR_CATEGORY_MEMORY,
+ messages.CONNECTOR_CATEGORY_SCANNER,
signalFilter,
typeFilter,
visibleSources,
@@ -597,6 +608,7 @@ export default function DataSourcesPage({
<SelectItem value={CONNECTOR_FILTER_ALL_VALUE}>{messages.CONNECTOR_FILTER_ALL_CATEGORIES}</SelectItem>
<SelectItem value="datasource">{messages.CONNECTOR_CATEGORY_DATASOURCE}</SelectItem>
<SelectItem value="memory">{messages.CONNECTOR_CATEGORY_MEMORY}</SelectItem>
+ <SelectItem value="scanner">{messages.CONNECTOR_CATEGORY_SCANNER}</SelectItem>
</SelectContent>
</Select>
<Select value={signalFilter} onValueChange={setSignalFilter}>
@@ -760,6 +772,9 @@ export default function DataSourcesPage({
{s.category === "memory" ? (
<Badge variant="secondary" className="text-[10px]">{messages.CONNECTOR_CATEGORY_MEMORY}</Badge>
) : null}
+ {s.category === "scanner" ? (
+ <Badge variant="secondary" className="text-[10px]">{messages.CONNECTOR_CATEGORY_SCANNER}</Badge>
+ ) : null}
{s.isDefault ? (
<Badge className="text-[10px]">default</Badge>
) : null}
@@ -847,12 +862,17 @@ function FieldInput({
}) {
if (field.kind === "switch") {
return (
- <div className="flex items-center justify-between rounded-md border border-stone-200 px-3 py-2 dark:border-stone-800">
- <Label className="text-xs">{field.label}</Label>
- <Switch
- checked={!!value}
- onCheckedChange={(c) => onChange(c)}
- />
+ <div className="flex flex-col gap-1 rounded-md border border-stone-200 px-3 py-2 dark:border-stone-800">
+ <div className="flex items-center justify-between gap-3">
+ <Label className="text-xs">{field.label}</Label>
+ <Switch
+ checked={!!value}
+ onCheckedChange={(c) => onChange(c)}
+ />
+ </div>
+ {field.description ? (
+ <p className="text-[11px] leading-4 text-muted-foreground">{field.description}</p>
+ ) : null}
</div>
);
}
@@ -872,6 +892,9 @@ function FieldInput({
))}
</SelectContent>
</Select>
+ {field.description ? (
+ <p className="text-[11px] leading-4 text-muted-foreground">{field.description}</p>
+ ) : null}
</div>
);
}
@@ -1058,10 +1081,12 @@ export function SourceFormDialog({
label:
key === "memory"
? messages.CONNECTOR_CATEGORY_MEMORY
- : messages.CONNECTOR_CATEGORY_DATASOURCE,
+ : key === "scanner"
+ ? messages.CONNECTOR_CATEGORY_SCANNER
+ : messages.CONNECTOR_CATEGORY_DATASOURCE,
items,
}));
- }, [descriptors, messages.CONNECTOR_CATEGORY_DATASOURCE, messages.CONNECTOR_CATEGORY_MEMORY]);
+ }, [descriptors, messages.CONNECTOR_CATEGORY_DATASOURCE, messages.CONNECTOR_CATEGORY_MEMORY, messages.CONNECTOR_CATEGORY_SCANNER]);
const clickHouseFields = useMemo<FieldDef[]>(() => [
{ key: "username", label: messages.DB_CONFIG_FIELD_USERNAME, kind: "text", group: "settings", placeholder: "default" },
{ key: "host", label: messages.DB_CONFIG_FIELD_HOST, kind: "text", group: "settings", placeholder: "clickhouse.example.com" },
@@ -1077,6 +1102,10 @@ export function SourceFormDialog({
const [values, setValues] = useState<Record<string, string | boolean>>({});
const [saving, setSaving] = useState(false);
const [testing, setTesting] = useState(false);
+ const [cliSchema, setCliSchema] = useState<ScannerCliSchema | undefined>();
+ const handleRuntimeChange = useCallback((runtime: ScannerRuntimeInfo | null) => {
+ setCliSchema(runtime?.schema);
+ }, []);
useEffect(() => {
fetch("/api/project/environment")
@@ -1086,8 +1115,12 @@ export function SourceFormDialog({
}, [environment]);
const fields = useMemo(
- () => type === "clickhouse" ? clickHouseFields : fieldsForType(descriptors, type),
- [clickHouseFields, descriptors, type]
+ () => {
+ if (type === "clickhouse") return clickHouseFields;
+ if (type === "trustabl" && cliSchema) return trustablConfigFields(cliSchema);
+ return fieldsForType(descriptors, type);
+ },
+ [clickHouseFields, cliSchema, descriptors, type]
);
// Seed defaults + stored settings whenever the type (or source) changes.
@@ -1125,6 +1158,28 @@ export function SourceFormDialog({
);
const activeDescriptor = descriptors.find((d) => d.type === type);
const setupGuide = messages.DATA_SOURCE_SETUP_GUIDES[type];
+ const settingsSectionTitle =
+ activeDescriptor?.category === "scanner"
+ ? messages.SCANNER_DEFAULTS_SECTION
+ : messages.DATA_SOURCE_SETTINGS_SECTION;
+ const settingsSectionDescription =
+ activeDescriptor?.category === "scanner"
+ ? messages.SCANNER_DEFAULTS_SECTION_DESCRIPTION
+ : messages.DATA_SOURCE_SETTINGS_SECTION_DESCRIPTION;
+ const credentialsTitle =
+ activeDescriptor?.category === "scanner"
+ ? messages.SCANNER_CREDENTIALS_SECTION
+ : fields.some((f) => f.key === "authType")
+ ? messages.DATA_SOURCE_AUTHENTICATION_SECTION
+ : messages.DATA_SOURCE_CREDENTIALS_TITLE;
+ const credentialsHelp =
+ activeDescriptor?.category === "scanner"
+ ? isEdit && source?.hasSecret
+ ? messages.DATA_SOURCE_CREDENTIALS_SET
+ : messages.SCANNER_CREDENTIALS_HELP
+ : isEdit && source?.hasSecret
+ ? messages.DATA_SOURCE_CREDENTIALS_SET
+ : messages.DATA_SOURCE_CREDENTIALS_HELP;
const submit = async () => {
if (!name.trim()) {
@@ -1322,6 +1377,10 @@ export function SourceFormDialog({
</details>
)}
+ {activeDescriptor?.category === "scanner" ? (
+ <ScannerRuntimePanel onRuntimeChange={handleRuntimeChange} />
+ ) : null}
+
<section className="space-y-3 rounded-lg border border-stone-200 p-4 dark:border-stone-800">
<div>
<p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{messages.DATA_SOURCE_CONNECTION_SECTION}</p>
@@ -1348,7 +1407,7 @@ export function SourceFormDialog({
</section>
{settingsFields.length > 0 && <section className="space-y-3 rounded-lg border border-stone-200 p-4 dark:border-stone-800">
- <div><p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{messages.DATA_SOURCE_SETTINGS_SECTION}</p><p className="mt-0.5 text-[11px] text-muted-foreground">{messages.DATA_SOURCE_SETTINGS_SECTION_DESCRIPTION}</p></div>
+ <div><p className="text-xs font-semibold text-stone-950 dark:text-stone-50">{settingsSectionTitle}</p><p className="mt-0.5 text-[11px] text-muted-foreground">{settingsSectionDescription}</p></div>
<div className="grid gap-3 sm:grid-cols-2">{settingsFields.map((f) => (
<FieldInput
key={f.key}
@@ -1362,14 +1421,10 @@ export function SourceFormDialog({
<section className="space-y-3 rounded-lg border border-stone-200 p-4 dark:border-stone-800">
<div>
<p className="text-xs font-semibold text-stone-950 dark:text-stone-50">
- {fields.some((f) => f.key === "authType")
- ? messages.DATA_SOURCE_AUTHENTICATION_SECTION
- : messages.DATA_SOURCE_CREDENTIALS_TITLE}
+ {credentialsTitle}
</p>
<p className="text-xs text-muted-foreground">
- {isEdit && source?.hasSecret
- ? messages.DATA_SOURCE_CREDENTIALS_SET
- : messages.DATA_SOURCE_CREDENTIALS_HELP}
+ {credentialsHelp}
</p>
{activeDescriptor?.authHelp && (
<p className="mt-1 text-xs text-muted-foreground">
@@ -1411,7 +1466,7 @@ export function SourceFormDialog({
/>
)}
- {activeDescriptor?.category !== "memory" && (
+ {activeDescriptor?.category !== "memory" && activeDescriptor?.category !== "scanner" && (
<div className="flex items-center justify-between rounded-md border border-stone-200 px-3 py-2 dark:border-stone-800">
<Label className="text-xs">
{messages.DATA_SOURCE_FIELD_DEFAULT}
diff --git a/src/client/src/constants/documentation-links.ts b/src/client/src/constants/documentation-links.ts
index 6ccf6b44..89ef9755 100644
--- a/src/client/src/constants/documentation-links.ts
+++ b/src/client/src/constants/documentation-links.ts
@@ -8,6 +8,7 @@ const DOCUMENTATION_LINKS = {
connectors: "https://docs.openlit.io/latest/openlit/connectors/overview",
memoryConnectors: "https://docs.openlit.io/latest/openlit/connectors/memory",
datasourceConnectors: "https://docs.openlit.io/latest/openlit/connectors/datasource",
+ scannerConnectors: "https://docs.openlit.io/latest/openlit/connectors/scanner",
signalRouting: "https://docs.openlit.io/latest/openlit/organisation/signal-routing",
telemetrySources: "https://docs.openlit.io/latest/openlit/organisation/telemetry-sources",
anonymousTelemetry: "https://docs.openlit.io/latest/openlit/developer-resources/anonymous-telemetry",
diff --git a/src/client/src/constants/messages/en.ts b/src/client/src/constants/messages/en.ts
index 0acf5a84..e085b6e5 100644
--- a/src/client/src/constants/messages/en.ts
+++ b/src/client/src/constants/messages/en.ts
@@ -753,6 +753,7 @@ export const FEATURE_OPENGROUND = "Openground";
export const FEATURE_PROMPTS = "Prompt Hub";
export const FEATURE_VAULT = "Vault";
export const FEATURE_MEMORY = "Memory";
+export const FEATURE_SCANNER = "Scanner";
export const FEATURE_FLEET_HUB = "Fleet Hub";
export const FLEET_HUB_BACK_TO_LIST = "Back to Fleet Hub";
export const FEATURE_AGENTS = "Agents";
@@ -2447,6 +2448,7 @@ export const CONNECTOR_FILTER_SIGNAL = "Signal";
export const CONNECTOR_TYPE_PLACEHOLDER = "Select a connector type";
export const CONNECTOR_CATEGORY_DATASOURCE = "Data sources";
export const CONNECTOR_CATEGORY_MEMORY = "Memory";
+export const CONNECTOR_CATEGORY_SCANNER = "Scanners";
export const DATA_SOURCE_TEST_UNSAVED =
"Save the connector before testing the connection.";
export const DATA_SOURCE_EDIT_ACTION = "Edit connector";
@@ -2477,6 +2479,243 @@ export const MEMORY_CONNECTOR_FILTER_REQUIRED =
"A user, agent, or session is required to list memories.";
export const MEMORY_CONNECTOR_INLINE_SECRET_REQUIRED =
"This memory connector must store its API key on the connector. Edit the connector and save the API key again.";
+export const SCANNER_CONNECTOR_NAME_REQUIRED = "A scanner connector name is required.";
+export const SCANNER_CONNECTOR_NAME_TAKEN = (name: string, environment: string) =>
+ `A connector named "${name}" already exists in the ${environment} environment. Choose a different name.`;
+export const SCANNER_CONNECTOR_TYPE_UNKNOWN = (type: string) =>
+ `Unknown scanner connector type "${type}".`;
+export const SCANNER_CONNECTOR_NO_PROJECT = "No current project is selected.";
+export const SCANNER_CONNECTOR_NOT_FOUND =
+ "Scanner connector not found in the current project.";
+export const SCANNER_CONNECTOR_INLINE_SECRET_REQUIRED =
+ "This scanner connector must store its token on the connector. Edit the connector and save the token again.";
+export const SCANNER_TARGET_REQUIRED = "A GitHub repository URL is required.";
+export const SCANNER_TARGET_INVALID =
+ "Enter an https://github.com/owner/repo URL. Local paths are not allowed.";
+export const SCANNER_PROCESS_REJECTED =
+ "Scanner command arguments were rejected as unsafe.";
+export const SCANNER_REF_INVALID =
+ "Ref must use letters, numbers, dots, slashes, hyphens, or underscores.";
+export const SCANNER_DETECTORS_INVALID =
+ "Detectors must be a comma-separated list of detector ids such as claude_sdk,mcp.";
+export const SCANNER_RULES_SOURCE_INVALID =
+ "Rules source must be production, staging, or git.";
+export const SCANNER_RULES_REPO_INVALID =
+ "Rules repository must be an https URL.";
+export const SCANNER_REPO_NOT_FOUND =
+ "GitHub could not find that repository. Check the URL and add a GitHub token on the connector for private repos.";
+export const SCANNER_RUNTIME_NOT_INSTALLED =
+ "The Trustabl CLI is not installed on this OpenLIT server. Install it from the connector, then run a scan.";
+export const SCANNER_RUNTIME_VERSION_FAILED =
+ "The Trustabl CLI did not report a version. Install or upgrade it from the connector, then try again.";
+export const SCANNER_RUNTIME_DOWNLOAD_FAILED =
+ "OpenLIT could not download the Trustabl CLI release. Check outbound access to GitHub and try again.";
+export const SCANNER_RUNTIME_CHECKSUM_FAILED =
+ "The Trustabl CLI download did not match the published checksum. The install was aborted.";
+export const SCANNER_RUNTIME_EXTRACT_FAILED =
+ "OpenLIT downloaded the Trustabl CLI but could not extract the binary.";
+export const SCANNER_RUNTIME_UNSUPPORTED_PLATFORM =
+ "This OpenLIT server platform does not have a Trustabl CLI release.";
+export const SCANNER_JOB_NOT_FOUND = "Scanner job not found.";
+export const SCANNER_JOB_ID_INVALID = "Scanner job id is invalid.";
+export const SCANNER_JOB_RUNNING =
+ "A scan is already running for this connector. Wait for it to finish.";
+export const SCANNER_SCAN_FAILED = "The scanner failed before producing a report.";
+export const SCANNER_INVALID_JSON = "Request body is not valid JSON.";
+export const SCANNER_LOAD_FAILED = "Failed to load scanner data.";
+export const SCANNER_INSTALL_FAILED = "Failed to prepare the scanner runtime.";
+export const SCANNER_PAGE_DESCRIPTION =
+ "Connect scanners for this environment, run jobs, and review findings.";
+export const SCANNER_CONNECTOR_LABEL = "Scanner connector";
+export const SCANNER_REPOSITORY_LABEL = "Repository";
+export const SCANNER_JOB_RUN_LABEL = "Scan run";
+export const SCANNER_JOB_RUN_PLACEHOLDER = "No scans for this repository";
+export const SCANNER_NO_REPOS = "Run a scan to list repositories here.";
+export const SCANNER_EMPTY_REPO_JOBS = "No scans have been run for this repository yet.";
+export const SCANNER_SEARCH_FINDINGS = "Search findings";
+export const SCANNER_OPEN_COUNT = (count: number) => `${count} Open`;
+export const SCANNER_FINDING_COUNT = (count: number) =>
+ count === 1 ? "1 finding" : `${count} findings`;
+export const SCANNER_FINDING_NUMBER = (n: number) => `#${n}`;
+export const SCANNER_SEVERITY_WITH_LEVEL = (severity: string) => `${severity} severity`;
+export const SCANNER_DETECTED = "Detected";
+export const SCANNER_BACK_TO_FINDINGS = "Back to findings";
+export const SCANNER_JOB_RUN_OPTION = (parts: Array<string | undefined> | string) =>
+ (Array.isArray(parts) ? parts : [parts]).filter(Boolean).join(" · ");
+export const SCANNER_JOB_DETAILS = "Scan details";
+export const SCANNER_CLI_MENU = "CLI";
+export const SCANNER_PAGE_OF = (current: number, total: number) => `${current} of ${total}`;
+export const SCANNER_PAGE_PREVIOUS = "Previous page";
+export const SCANNER_PAGE_NEXT = "Next page";
+export const SCANNER_RUN = "Run scan";
+export const SCANNER_RUN_DEFAULTS = "Run with defaults";
+export const SCANNER_RUN_PARAMS = "Run with new parameters";
+export const SCANNER_RUN_PARAMS_TITLE = "Run scan with parameters";
+export const SCANNER_RUN_PARAMS_DESCRIPTION =
+ "Override the connector defaults for this job only. Saved connector settings stay unchanged.";
+export const SCANNER_RUN_PARAMS_TARGET_SECTION = "Target";
+export const SCANNER_RUN_PARAMS_SCAN_SECTION = "Scan flags";
+export const SCANNER_RUN_PARAMS_RULES_SECTION = "Rules";
+export const SCANNER_RUN_PARAMS_TOKEN_NOTE =
+ "The GitHub token stays on the connector. Edit the connector to change credentials.";
+export const SCANNER_RUN_MENU = "More scan options";
+export const SCANNER_JOB_ID = "Job";
+export const SCANNER_FINDING_OVERVIEW = "Overview";
+export const SCANNER_FINDING_DETAIL = "Details";
+export const SCANNER_FINDING_FIX = "Suggested fix";
+export const SCANNER_FINDING_CONFIDENCE = "Confidence";
+export const SCANNER_FINDING_DOCS = "Rule documentation";
+export const SCANNER_FINDING_NO_DETAIL = "This finding has no extra detail in the scan report.";
+export const SCANNER_CRITICAL = "Critical";
+export const SCANNER_HIGH = "High";
+export const SCANNER_MEDIUM = "Medium";
+export const SCANNER_LOW = "Low";
+export const SCANNER_SCORE = "Score";
+export const SCANNER_SCORE_VALUE = (score: number) => `${score} / 100`;
+export const SCANNER_STATUS = "Status";
+export const SCANNER_EXIT_CODE = "Exit";
+export const SCANNER_TARGET = "Target";
+export const SCANNER_RULES_SOURCE = "Rules source";
+export const SCANNER_RULES_VERSION = "Rules version";
+export const SCANNER_LANGUAGES = "Languages";
+export const SCANNER_SDKS = "SDKs";
+export const SCANNER_INVENTORY = "Inventory";
+export const SCANNER_TOOLS = "Tools";
+export const SCANNER_AGENTS = "Agents";
+export const SCANNER_MCP = "MCP servers";
+export const SCANNER_SKILLS = "Skills";
+export const SCANNER_SUBAGENTS = "Subagents";
+export const SCANNER_COVERAGE = "Coverage";
+export const SCANNER_SCOPE = "Scope";
+export const SCANNER_TOOL_NAME = "Tool";
+export const SCANNER_NO_AGENT_SURFACES = "No agent surfaces were discovered in this scan.";
+export const SCANNER_SPLIT_RESIZE = "Resize jobs and findings";
+export const SCANNER_JOB_ERROR = "Scan error";
+export const SCANNER_VS_PREVIOUS = (delta: number) =>
+ delta === 0 ? "Same as previous job" : `${delta > 0 ? "+" : ""}${delta} vs previous job`;
+export const SCANNER_SELECTED_JOB = "Selected job";
+export const SCANNER_INSTALL = "Install CLI";
+export const SCANNER_UPGRADE = "Upgrade CLI";
+export const SCANNER_UPGRADE_TO = (version: string) => `Upgrade to ${version}`;
+export const SCANNER_RUNTIME_SECTION = "Trustabl CLI";
+export const SCANNER_RUNTIME_SECTION_DESCRIPTION =
+ "The CLI runs on the OpenLIT server. Install it once, then scans use the cached binary.";
+export const SCANNER_VERSION_INSTALLED = "Installed";
+export const SCANNER_CLI_VERSION = "CLI";
+export const SCANNER_VERSION_LATEST = "Latest";
+export const SCANNER_VERSION_UNKNOWN = "Not installed";
+export const SCANNER_RUNTIME_CHECKING = "Checking CLI";
+export const SCANNER_REFRESH = "Refresh";
+export const SCANNER_JOBS = "Jobs";
+export const SCANNER_FINDINGS = "Findings";
+export const SCANNER_EMPTY_TITLE = "No scanner connectors yet";
+export const SCANNER_EMPTY_CONNECTORS =
+ "Add a scanner for this environment to run jobs and collect findings. Each connector type brings its own runtime, target, and report format.";
+export const SCANNER_EMPTY_CONNECTORS_ACTION = "Add scanner connector";
+export const SCANNER_EMPTY_DOCS = "Connector documentation";
+export const SCANNER_EMPTY_HOW = "How scanners work";
+export const SCANNER_EMPTY_PREVIEW = "What this page will show";
+export const SCANNER_EMPTY_CAP_TYPES = "Pluggable scanner types";
+export const SCANNER_EMPTY_CAP_ENV = "Environment-scoped jobs";
+export const SCANNER_EMPTY_CAP_OUTPUT = "Findings with severity and path";
+export const SCANNER_EMPTY_STEP_CONNECTOR = "Add a scanner connector";
+export const SCANNER_EMPTY_STEP_CONNECTOR_BODY =
+ "Pick a scanner type for this environment. Vendor setup, credentials, and CLI install live on the connector.";
+export const SCANNER_EMPTY_STEP_TARGET = "Configure the scan target";
+export const SCANNER_EMPTY_STEP_TARGET_BODY =
+ "Each scanner defines its own target and options, such as a repository URL or runtime endpoint.";
+export const SCANNER_EMPTY_STEP_RUN = "Run and review findings";
+export const SCANNER_EMPTY_STEP_RUN_BODY =
+ "Jobs and findings stay on this page for the selected connector so you can re-run scans over time.";
+export const SCANNER_EMPTY_FINDINGS = "No findings yet. Run a scan to populate this table.";
+export const SCANNER_EMPTY_JOBS = "No scans have been run for this connector yet.";
+export const SCANNER_SEVERITY = "Severity";
+export const SCANNER_RULE = "Rule";
+export const SCANNER_PATH = "Path";
+export const SCANNER_TITLE = "Title";
+export const SCANNER_STARTED = "Started";
+export const SCANNER_DURATION = "Duration";
+export const SCANNER_RESULT = "Result";
+export const SCANNER_STATUS_READY = "Runtime ready";
+export const SCANNER_STATUS_MISSING = "Runtime missing";
+export const SCANNER_OPEN_FINDING = "Open finding";
+export const SCANNER_TRUSTABL_DESCRIPTION =
+ "Scan agent SDKs and MCP servers for reliability and safety findings.";
+export const SCANNER_FIELD_TARGET = "Repository URL";
+export const SCANNER_FIELD_TARGET_HELP =
+ "GitHub repository to scan, for example https://github.com/owner/repo. Add /tree/branch to pin a branch.";
+export const SCANNER_FIELD_REF = "Ref";
+export const SCANNER_FIELD_REF_HELP =
+ "Optional branch, tag, or commit. Leave blank to use the branch in the repository URL, or the repository default.";
+export const SCANNER_FIELD_DETECTORS = "Detectors";
+export const SCANNER_FIELD_DETECTORS_HELP =
+ "Limit the scan to detector ids, comma-separated (for example claude_sdk,mcp). Leave blank to run all detectors.";
+export const SCANNER_FIELD_REQUIRE_SIGNED = "Require signed rules";
+export const SCANNER_FIELD_REQUIRE_SIGNED_HELP =
+ "Fail the scan unless rules come from a signed Production or Staging channel. Ignored when Rules source is Git.";
+export const SCANNER_FIELD_STRICT = "Strict (fail on low+)";
+export const SCANNER_FIELD_STRICT_HELP =
+ "Mark the job failed if any finding is low or higher. Findings are still listed either way.";
+export const SCANNER_FIELD_SECRET_SCAN = "Secret scan";
+export const SCANNER_FIELD_SECRET_SCAN_HELP =
+ "Look for hardcoded secrets and credentials in repository text files.";
+export const SCANNER_FIELD_VULN_SCAN = "Vulnerability scan";
+export const SCANNER_FIELD_VULN_SCAN_HELP =
+ "Check declared dependencies for known CVEs from the OSV database.";
+export const SCANNER_FIELD_LICENSE_SCAN = "License scan";
+export const SCANNER_FIELD_LICENSE_SCAN_HELP =
+ "Report copyleft licenses on dependencies (GPL, AGPL, LGPL, SSPL).";
+export const SCANNER_FIELD_RULES_SOURCE = "Rules source";
+export const SCANNER_FIELD_RULES_SOURCE_HELP =
+ "Which Trustabl rules pack to load. Follow environment maps this OpenLIT environment: production → signed production, staging → signed staging, development → unsigned git. Production and Staging are signed channels. Git pulls unsigned rules from the rules repository (for local pack development).";
+export const SCANNER_FIELD_RULES_SOURCE_ENVIRONMENT = "Follow environment";
+export const SCANNER_FIELD_RULES_SOURCE_PRODUCTION = "Production (signed)";
+export const SCANNER_FIELD_RULES_SOURCE_STAGING = "Staging (signed)";
+export const SCANNER_FIELD_RULES_SOURCE_GIT = "Git (unsigned)";
+export const SCANNER_FIELD_RULES_REPO = "Rules repository";
+export const SCANNER_FIELD_RULES_REPO_HELP =
+ "Optional custom rules git URL. Leave blank for the official Trustabl pack.";
+export const SCANNER_FIELD_RULES_REF = "Rules ref";
+export const SCANNER_FIELD_RULES_REF_HELP =
+ "Branch, tag, or commit of the rules pack. Used with Git or a custom rules repository.";
+export const SCANNER_FIELD_NO_RULES_UPDATE = "Use cached rules only";
+export const SCANNER_FIELD_NO_RULES_UPDATE_HELP =
+ "Do not download rules. Use the pack already cached on this OpenLIT server.";
+export const SCANNER_FIELD_VERBOSE = "Verbose diagnostics";
+export const SCANNER_FIELD_VERBOSE_HELP =
+ "Keep extra scanner diagnostics on failed jobs so you can see why a scan broke.";
+export const SCANNER_FIELD_GITHUB_TOKEN = "GitHub token";
+export const SCANNER_CLI_FLAG_LABEL = (flag: string) =>
+ flag
+ .split("-")
+ .filter(Boolean)
+ .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+ .join(" ");
+export const SCANNER_CLI_FLAG_HELP = "This option is provided by the installed Trustabl CLI.";
+export const SCANNER_FINDING_EXTRA = "Additional fields";
+export const SCANNER_REPORT_EXTRA = "Report extras";
+export const SCANNER_AUTH_HELP_TRUSTABL =
+ "Default token for private repositories on every scan. Stored on the connector, not in ClickHouse.";
+export const SCANNER_DEFAULTS_SECTION = "Default scan parameters";
+export const SCANNER_DEFAULTS_SECTION_DESCRIPTION =
+ "Used when you run with defaults. Override them for one job from Run with new parameters.";
+export const SCANNER_CREDENTIALS_SECTION = "Default credentials";
+export const SCANNER_CREDENTIALS_HELP =
+ "Used for every scan of this connector. Leave blank to keep the stored GitHub token.";
+export const SCANNER_SETUP_TRUSTABL_SUMMARY =
+ "Trustabl scans an agent repository for SDK, MCP, and policy findings. Install the CLI from the connector, then run scans from the Scanner page.";
+export const SCANNER_OPEN_FINDINGS = "Open findings";
+export const SCANNER_MEDIUM_PLUS = "Medium+";
+export const SCANNER_SESSION_TAB = "Scanner";
+export const SCANNER_SESSION_OPEN = "Open in Scanner";
+export const SCANNER_SESSION_EMPTY =
+ "No scanner findings for this repository in this environment.";
+export const SCANNER_SESSION_CLEAN = "Latest scan found no issues.";
+export const SCANNER_SESSION_SUMMARY = (mediumPlus: number, total: number) =>
+ `${mediumPlus} medium+ of ${total} findings`;
+export const SCANNER_FINDINGS_LOAD_FAILED = "Failed to load scanner findings.";
+export const SCANNER_LAST_REF = "Last scanned ref";
+export const SCANNER_LAST_DURATION = "Last job duration";
export const MEMORY_CONNECTOR_CLAUDE_DESCRIPTION =
"Browse and edit memories in Anthropic Claude memory stores.";
export const MEMORY_CONNECTOR_MEM0_DESCRIPTION =
@@ -2755,6 +2994,15 @@ export const DATA_SOURCE_SETUP_GUIDES: Record<string, { summary: string; steps:
steps: ["Create a Zep Cloud API key, or point the endpoint at a self-hosted Zep service.", "Paste the API key into the credentials field. It is stored in the OpenLIT vault.", "Save the connector, then test the connection before using it from agents."],
docsUrl: "https://help.getzep.com/sdk-reference",
},
+ trustabl: {
+ summary: "Connect OpenLIT to Trustabl for agent reliability scans.",
+ steps: [
+ "Install the Trustabl CLI from the connector. OpenLIT downloads a checksum-verified GitHub release onto the server.",
+ "Save a GitHub repository URL for this environment. Add a GitHub token for private repos.",
+ "Save the connector, then run a scan from the Scanner page.",
+ ],
+ docsUrl: "https://github.com/trustabl/trustabl",
+ },
};
export const DATA_SOURCE_EMPTY_TITLE = "No external sources yet";
export const DATA_SOURCE_EMPTY_DESCRIPTION =
diff --git a/src/client/src/constants/sidebar.tsx b/src/client/src/constants/sidebar.tsx
index 34e39d37..f8a33454 100644
--- a/src/client/src/constants/sidebar.tsx
+++ b/src/client/src/constants/sidebar.tsx
@@ -23,6 +23,7 @@ import {
SettingsIcon,
SlidersHorizontal,
User,
+ ScanSearch,
} from "lucide-react";
export const ICON_CLASSES = "flex-shrink-0 size-4";
@@ -110,6 +111,12 @@ export const SIDEBAR_ITEMS: SidebarItemProps[] = [
link: "/memory",
type: "action",
},
+ {
+ icon: <ScanSearch className={ICON_CLASSES} />,
+ text: m.FEATURE_SCANNER,
+ link: "/scanner",
+ type: "action",
+ },
{
icon: <SlidersHorizontal className={ICON_CLASSES} />,
text: "Rule Engine",
diff --git a/src/client/src/lib/access/scanner-route.ts b/src/client/src/lib/access/scanner-route.ts
new file mode 100644
index 00000000..7303d609
--- /dev/null
+++ b/src/client/src/lib/access/scanner-route.ts
@@ -0,0 +1,21 @@
+/**
+ * CE fallback for scanner route protection and audit hooks.
+ * Enterprise replaces this neutral module through its path aliases.
+ *
+ * Library callers (Otter chat tools) use requireScannerAccess because they
+ * do not go through HTTP wrappers.
+ */
+export type ScannerAction = "read" | "create" | "scan" | "install";
+
+export function withScannerAccess<THandler>(
+ _action: ScannerAction,
+ handler: THandler
+): THandler {
+ return handler;
+}
+
+export function withScannerAudit<THandler>(handler: THandler): THandler {
+ return handler;
+}
+
+export async function requireScannerAccess(_action: ScannerAction): Promise<void> {}
diff --git a/src/client/src/lib/platform/chat/schema-context.ts b/src/client/src/lib/platform/chat/schema-context.ts
index cb3e2ca9..79503681 100644
--- a/src/client/src/lib/platform/chat/schema-context.ts
+++ b/src/client/src/lib/platform/chat/schema-context.ts
@@ -2,7 +2,7 @@ export function getChatSystemPrompt(): string {
return `You are an AI assistant for OpenLIT, an OpenTelemetry-native observability platform. You have two capabilities:
1. **Data Queries**: Convert natural language questions into ClickHouse SQL queries to analyze observability data (traces, metrics, costs, tokens, etc.)
-2. **Platform Management**: Create and manage platform resources using the available tools — rules, alerts, contexts, prompts, vault secrets, custom models, memory, and trace analysis.
+2. **Platform Management**: Create and manage platform resources using the available tools — rules, alerts, contexts, prompts, vault secrets, custom models, memory, scanner findings, and trace analysis.
3. **Connector-routed telemetry**: Use the query_telemetry tool for current traces, logs, or metrics. It reads from the connector selected by the project's signal routing, so do not use ClickHouse SQL for telemetry when an external source is configured.
When the user asks which connector, data source, database, or backend is being used, you MUST call get_telemetry_routing first and answer from its returned routing values. Never infer the connector from the SQL schema, the ClickHouse table names, or the fact that SQL is available. When the user asks a question about current traces, logs, or metrics, use query_telemetry. Use SQL only for ClickHouse-backed platform data and derived analytics that require SQL. When the user asks to create or manage a resource, use the appropriate tool. If unclear, ask for clarification.
@@ -15,6 +15,7 @@ When the user asks which connector, data source, database, or backend is being u
**Prompt Hub** — create_prompt, get_prompt, update_prompt_version, delete_prompt, list_prompts
**Vault** — create_vault_secret, update_vault_secret, delete_vault_secret, list_vault_secrets
**Memory** — list_memories, search_memories, add_memory, update_memory, delete_memory
+**Scanner** — get_scanner_findings
**Models** — create_custom_model, update_custom_model, delete_custom_model, list_custom_models
**Trace analysis** — analyze_trace, get_trace_analysis, analyze_trace_batch, analyze_traces_by_attribute
**Telemetry** — get_telemetry_routing (reports the active connector per signal), query_telemetry (reads traces, logs, and metrics through signal routing)
@@ -26,6 +27,7 @@ Guidelines:
- When listing, summarize the results concisely.
- When the user asks about stored memories, preferences, past agent knowledge, or what the project remembers, use list_memories or search_memories (memory connector APIs). Prefer list_memories for inventory; search_memories for a specific fact. If search returns count=0, try list_memories before saying nothing is stored. Do not invent memories the tools did not return.
- When the user asks to remember, store, update, or forget a memory, use add_memory, update_memory, or delete_memory. Some connectors require a user_id or session_id. If a memory tool returns a permission error, tell the user they cannot perform that action.
+- When the user asks about scanner findings, Trustabl, repo policy, or how to improve a coding agent for a repository, call get_scanner_findings with the GitHub URL from vcs.repository.url.full or the user. Summarize medium+ findings (rule id, path, severity) and link to Scanner. Do not invent findings the tool did not return. If matched is false, say no scan exists for that repo in this environment.
- When a user asks to help improve, review, critique, or suggest edits for an existing prompt, first load it with get_prompt and then respond with suggested improvements. Do not call update_prompt_version unless the user explicitly asks to save, update, apply, publish, or create a new version.
- When the user asks to link a context or prompt to a rule, use link_entity_to_rule.
- Vault keys are auto-normalized to UPPER_SNAKE_CASE.
@@ -72,6 +74,7 @@ URL mappings per entity type:
- **prompt**: \`/prompt-hub/{id}\`
- **vault**: \`/vault\` (no ID in URL)
- **memory**: \`/memory?id={id}&connectorId={connectorId}\` (omit unknown query params)
+- **scanner**: \`/scanner?connectorId={connectorId}&jobId={jobId}\` (omit unknown query params)
- **model**: \`/costs?tab=models\` (no ID in URL)
- **evaluation**: \`/evaluations\` (no ID in URL)
diff --git a/src/client/src/lib/platform/chat/tools.ts b/src/client/src/lib/platform/chat/tools.ts
index aac09e39..bc7883e4 100644
--- a/src/client/src/lib/platform/chat/tools.ts
+++ b/src/client/src/lib/platform/chat/tools.ts
@@ -46,6 +46,8 @@ import {
requireMemoryAccess,
type MemoryMutationAuditInput,
} from "@/lib/access/memory-route";
+import { requireScannerAccess } from "@/lib/access/scanner-route";
+import { lookupLatestScannerFindingsForRepo } from "@/lib/platform/connectors/scanner/lookup";
import { queryProjectMemories } from "@/lib/platform/connectors/memory/read";
import {
addProjectMemories,
@@ -1124,6 +1126,36 @@ export function getChatTools(userId: string, databaseConfigId: string, environme
},
}),
+ // ==================== SCANNER ====================
+
+ get_scanner_findings: tool<any, any>({
+ description:
+ "Look up the latest scanner findings for a GitHub repository in the current project environment. Use this for coding-agent sessions, vcs.repository.url.full, Trustabl, or repo policy questions. Medium+ findings are listed first.",
+ inputSchema: jsonSchema({
+ type: "object" as const,
+ properties: {
+ repo_url: {
+ type: "string",
+ description:
+ "GitHub repository URL from vcs.repository.url.full or the user (https or git@ forms)",
+ },
+ },
+ required: ["repo_url"],
+ }) as any,
+ execute: async (params: any) => {
+ try {
+ await requireScannerAccess("read");
+ const result = await lookupLatestScannerFindingsForRepo({
+ repoUrl: params.repo_url,
+ environment,
+ });
+ return { success: true, ...result };
+ } catch (e: any) {
+ return { success: false, error: e.message || "Failed to load scanner findings" };
+ }
+ },
+ }),
+
// ==================== CUSTOM MODELS ====================
create_custom_model: tool<any, any>({
diff --git a/src/client/src/lib/platform/connectors/README.md b/src/client/src/lib/platform/connectors/README.md
index 683083ab..6c017245 100644
--- a/src/client/src/lib/platform/connectors/README.md
+++ b/src/client/src/lib/platform/connectors/README.md
@@ -1,9 +1,9 @@
# Connector framework
Connectors are the common integration boundary for OpenLIT. A connector type
-belongs to a category (`datasource`, `notification`, `memory`, and so on), and
-an instance is a project- or organisation-scoped configuration with secrets
-stored in the vault.
+belongs to a category (`datasource`, `notification`, `memory`, `scanner`, and so
+on), and an instance is a project- or organisation-scoped configuration with
+secrets stored in the vault.
Datasource adapters are registered automatically from the existing datasource
registry. New datasource contributors should implement the existing
diff --git a/src/client/src/lib/platform/connectors/bootstrap.ts b/src/client/src/lib/platform/connectors/bootstrap.ts
index 1315a521..126ee394 100644
--- a/src/client/src/lib/platform/connectors/bootstrap.ts
+++ b/src/client/src/lib/platform/connectors/bootstrap.ts
@@ -7,8 +7,10 @@
import { ensureAdaptersRegistered } from "./datasource/bootstrap";
import { ensureMemoryAdaptersRegistered } from "./memory/bootstrap";
+import { ensureScannerAdaptersRegistered } from "./scanner/bootstrap";
export function ensureConnectorsRegistered(): void {
ensureAdaptersRegistered();
ensureMemoryAdaptersRegistered();
+ ensureScannerAdaptersRegistered();
}
diff --git a/src/client/src/lib/platform/connectors/catalog.ts b/src/client/src/lib/platform/connectors/catalog.ts
index c1c53828..f096029b 100644
--- a/src/client/src/lib/platform/connectors/catalog.ts
+++ b/src/client/src/lib/platform/connectors/catalog.ts
@@ -1,6 +1,7 @@
import { ensureConnectorsRegistered } from "./bootstrap";
import { availableSourceTypeDescriptors } from "@/lib/telemetry-source-crud";
import { availableMemoryTypeDescriptors } from "./memory/crud";
+import { availableScannerTypeDescriptors } from "./scanner/crud";
import { isVisibleConnectorType } from "@/lib/platform/connectors/visible-types";
import { connectorIconPath } from "./icons";
@@ -15,5 +16,6 @@ export function availableConnectorTypeDescriptors() {
scope: "project" as const,
})),
...availableMemoryTypeDescriptors(),
+ ...availableScannerTypeDescriptors(),
].filter((descriptor) => isVisibleConnectorType(descriptor.type));
}
diff --git a/src/client/src/lib/platform/connectors/descriptions.ts b/src/client/src/lib/platform/connectors/descriptions.ts
index a5520d22..1d96f187 100644
--- a/src/client/src/lib/platform/connectors/descriptions.ts
+++ b/src/client/src/lib/platform/connectors/descriptions.ts
@@ -7,6 +7,7 @@ const CONNECTOR_DESCRIPTIONS: Record<string, string> = {
claude: "Agent memory from Claude memory stores.",
mem0: "Long-term agent memory from Mem0.",
zep: "Session and graph memory from Zep.",
+ trustabl: "Agent SDK and MCP reliability scans from Trustabl.",
};
export function connectorDescription(type: string, displayName?: string): string {
diff --git a/src/client/src/lib/platform/connectors/icons.ts b/src/client/src/lib/platform/connectors/icons.ts
index 164b5aaf..d7c14dc8 100644
--- a/src/client/src/lib/platform/connectors/icons.ts
+++ b/src/client/src/lib/platform/connectors/icons.ts
@@ -1,4 +1,4 @@
-/** Local SVG brand assets for connector catalog and connected-instance views. */
+/** Local brand assets for connector catalog and connected-instance views. */
const CONNECTOR_ICONS: Record<string, string> = {
clickhouse: "/images/connectors/clickhouse.svg",
tempo: "/images/connectors/grafana.svg",
@@ -8,6 +8,7 @@ const CONNECTOR_ICONS: Record<string, string> = {
claude: "/images/connectors/claude.svg",
mem0: "/images/connectors/mem0.svg",
zep: "/images/connectors/zep.svg",
+ trustabl: "/images/connectors/trustabl.svg",
};
export function connectorIconPath(type: string): string | undefined {
diff --git a/src/client/src/lib/platform/connectors/scanner/base-adapter.ts b/src/client/src/lib/platform/connectors/scanner/base-adapter.ts
new file mode 100644
index 00000000..11845c5e
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/base-adapter.ts
@@ -0,0 +1,41 @@
+/**
+ * Base class for scanner connectors.
+ *
+ * Every method defaults to throwing `UnsupportedScannerCapabilityError`, so a
+ * vendor adapter only implements what its backend actually supports.
+ */
+
+import type { ConnectorHealthResult } from "../types";
+import {
+ UnsupportedScannerCapabilityError,
+ type ScannerAdapter,
+ type ScannerCapabilities,
+ type ScannerJob,
+ type ScannerRuntimeInfo,
+ type ScannerScanInput,
+ type ScannerSourceDescriptor,
+} from "./types";
+
+export abstract class BaseScannerAdapter implements ScannerAdapter {
+ abstract readonly type: string;
+ protected readonly descriptor: ScannerSourceDescriptor;
+
+ constructor(descriptor: ScannerSourceDescriptor) {
+ this.descriptor = descriptor;
+ }
+
+ abstract capabilities(): ScannerCapabilities;
+ abstract healthCheck(): Promise<ConnectorHealthResult>;
+
+ protected unsupported(capability: string): never {
+ throw new UnsupportedScannerCapabilityError(this.type, capability);
+ }
+
+ async ensureRuntime(_input?: { upgrade?: boolean }): Promise<ScannerRuntimeInfo> {
+ this.unsupported("install");
+ }
+
+ async scan(_input?: ScannerScanInput): Promise<ScannerJob> {
+ this.unsupported("scan");
+ }
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/bootstrap.ts b/src/client/src/lib/platform/connectors/scanner/bootstrap.ts
new file mode 100644
index 00000000..b626bfab
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/bootstrap.ts
@@ -0,0 +1,35 @@
+/**
+ * Adapter bootstrap for CE scanner connectors: Trustabl.
+ * Enterprise builds may contribute additional factories through the
+ * neutral extension hook.
+ */
+
+import { getExternalScannerAdapters } from "./enterprise";
+import { trustablAdapterFactory } from "./trustabl/adapter";
+import {
+ hasScannerAdapterFactory,
+ registerScannerAdapterFactory,
+} from "./registry";
+import { registerScannerConnectorTypes } from "./index";
+
+const VENDOR_FACTORIES = [trustablAdapterFactory];
+
+let registered = false;
+
+export function ensureScannerAdaptersRegistered(): void {
+ if (registered && hasScannerAdapterFactory("trustabl")) {
+ return;
+ }
+ registered = true;
+ for (const factory of VENDOR_FACTORIES) {
+ registerScannerAdapterFactory(factory);
+ }
+ for (const factory of getExternalScannerAdapters()) {
+ registerScannerAdapterFactory(factory);
+ }
+ registerScannerConnectorTypes();
+}
+
+export function __resetScannerBootstrapForTests(): void {
+ registered = false;
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/cli-schema.ts b/src/client/src/lib/platform/connectors/scanner/cli-schema.ts
new file mode 100644
index 00000000..d8fa77f6
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/cli-schema.ts
@@ -0,0 +1,230 @@
+/**
+ * Trustabl CLI scan-flag schema.
+ *
+ * OpenLIT introspects `trustabl scan --help` after install/upgrade so the
+ * connector form and run-params dialog match the binary on disk instead of a
+ * compiled-in flag list.
+ */
+
+export type ScannerFlagKind = "boolean" | "string";
+
+export type ScannerFlagGroup = "scan" | "rules";
+
+export interface ScannerCliFlag {
+ flag: string;
+ key: string;
+ kind: ScannerFlagKind;
+ group: ScannerFlagGroup;
+ help: string;
+ defaultValue?: string | boolean;
+}
+
+export interface ScannerCliSchema {
+ version?: string;
+ flags: ScannerCliFlag[];
+}
+
+const VALUE_TYPES = new Set([
+ "string",
+ "strings",
+ "stringarray",
+ "stringtostring",
+ "int",
+ "int8",
+ "int16",
+ "int32",
+ "int64",
+ "uint",
+ "uint8",
+ "uint16",
+ "uint32",
+ "uint64",
+ "float",
+ "float32",
+ "float64",
+ "duration",
+ "count",
+ "bytes",
+ "ip",
+ "ipmask",
+]);
+
+/** Flags OpenLIT always controls or must never take from the UI. */
+export const BLOCKED_SCAN_FLAGS = new Set([
+ "help",
+ "format",
+ "output",
+ "json-out",
+ "sarif-out",
+ "bom-out",
+ "no-progress",
+ "no-color",
+ "attest",
+ "attest-key",
+ "attest-bundle",
+ "attest-no-tlog",
+ "debug",
+]);
+
+/** Deprecated aliases hidden when the replacement flag exists. */
+const HIDDEN_SCAN_FLAGS = new Set(["channel"]);
+
+const RULES_FLAGS = new Set([
+ "rules-repo",
+ "rules-ref",
+ "rules-source",
+ "require-signed",
+ "no-rules-update",
+ "channel",
+]);
+
+export const KNOWN_SCAN_PARAM_KEYS = [
+ "detectors",
+ "strict",
+ "secretScan",
+ "vulnScan",
+ "licenseScan",
+ "requireSigned",
+ "rulesRepo",
+ "rulesRef",
+ "rulesSource",
+ "noRulesUpdate",
+ "verbose",
+] as const;
+
+export const SCANNER_OWNED_SETTING_KEYS = new Set([
+ "target",
+ "ref",
+ "githubToken",
+ "token",
+]);
+
+const FLAG_PREFIX = /^(?:-[A-Za-z0-9],\s+)?--([a-z0-9-]+)(?:\s+(\S+))?\s+(.*)$/;
+const CONTINUATION = /^\s{8,}(\S.*)$/;
+const DEFAULT_TRUE = /\(default true\)\s*$/i;
+const DEFAULT_FALSE = /\(default false\)\s*$/i;
+const DEFAULT_QUOTED = /\(default "([^"]*)"\)\s*$/i;
+const DEFAULT_BARE = /\(default ([^)]+)\)\s*$/i;
+
+export function keyFromFlag(flag: string): string {
+ return String(flag || "").replace(/-([a-z0-9])/g, (_, char: string) => char.toUpperCase());
+}
+
+export function flagFromKey(key: string): string {
+ return String(key || "").replace(/[A-Z]/g, (char) => `-${char.toLowerCase()}`);
+}
+
+export function humanizeScannerFlag(flag: string): string {
+ return String(flag || "")
+ .split("-")
+ .filter(Boolean)
+ .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+ .join(" ");
+}
+
+function stripDefault(help: string): string {
+ return help
+ .replace(DEFAULT_QUOTED, "")
+ .replace(DEFAULT_TRUE, "")
+ .replace(DEFAULT_FALSE, "")
+ .replace(DEFAULT_BARE, "")
+ .trim();
+}
+
+function parseDefault(help: string, kind: ScannerFlagKind): string | boolean | undefined {
+ if (kind === "boolean") {
+ if (DEFAULT_TRUE.test(help)) return true;
+ if (DEFAULT_FALSE.test(help)) return false;
+ return undefined;
+ }
+ const quoted = help.match(DEFAULT_QUOTED);
+ if (quoted) return quoted[1];
+ const bare = help.match(DEFAULT_BARE);
+ if (!bare) return undefined;
+ const value = bare[1].trim();
+ if (/^(true|false)$/i.test(value)) return undefined;
+ return value;
+}
+
+function flagGroup(flag: string): ScannerFlagGroup {
+ return RULES_FLAGS.has(flag) ? "rules" : "scan";
+}
+
+function isValueType(token: string | undefined): boolean {
+ return Boolean(token && VALUE_TYPES.has(token.toLowerCase()));
+}
+
+export function parseTrustablScanHelp(text: string): ScannerCliFlag[] {
+ const flags: ScannerCliFlag[] = [];
+ const seen = new Set<string>();
+ let current: ScannerCliFlag | null = null;
+ for (const raw of String(text || "").split(/\r?\n/)) {
+ const line = raw.replace(/\t/g, " ");
+ const match = line.trim().match(FLAG_PREFIX);
+ if (match) {
+ const flag = match[1];
+ let typeToken: string | undefined = match[2];
+ let rest = match[3] || "";
+ if (typeToken && !isValueType(typeToken)) {
+ rest = `${typeToken} ${rest}`.trim();
+ typeToken = undefined;
+ }
+ const kind: ScannerFlagKind = isValueType(typeToken) ? "string" : "boolean";
+ const help = rest;
+ current = {
+ flag,
+ key: keyFromFlag(flag),
+ kind,
+ group: flagGroup(flag),
+ help: stripDefault(help),
+ defaultValue: parseDefault(help, kind),
+ };
+ if (!seen.has(flag) && !BLOCKED_SCAN_FLAGS.has(flag)) {
+ seen.add(flag);
+ flags.push(current);
+ } else {
+ current = null;
+ }
+ continue;
+ }
+ const cont = line.match(CONTINUATION);
+ if (cont && current) {
+ current.help = stripDefault(`${current.help} ${cont[1]}`.trim());
+ }
+ }
+ const hasRulesSource = flags.some((item) => item.flag === "rules-source");
+ return flags.filter((item) => !(HIDDEN_SCAN_FLAGS.has(item.flag) && hasRulesSource));
+}
+
+export function scannerCliSchemaFromHelp(text: string, version?: string): ScannerCliSchema {
+ return {
+ version,
+ flags: parseTrustablScanHelp(text),
+ };
+}
+
+export function schemaAllowsFlag(schema: ScannerCliSchema | undefined, flag: string): boolean {
+ if (!schema?.flags.length) {
+ return (KNOWN_SCAN_PARAM_KEYS as readonly string[]).some((key) => flagFromKey(key) === flag);
+ }
+ return schema.flags.some((item) => item.flag === flag);
+}
+
+export function isScannerExtraSettingKey(key: string): boolean {
+ if (!/^[a-z][a-zA-Z0-9]{0,63}$/.test(key)) return false;
+ if (SCANNER_OWNED_SETTING_KEYS.has(key)) return false;
+ if ((KNOWN_SCAN_PARAM_KEYS as readonly string[]).includes(key)) return false;
+ const flag = flagFromKey(key);
+ return !BLOCKED_SCAN_FLAGS.has(flag) && !HIDDEN_SCAN_FLAGS.has(flag);
+}
+
+export function overlayScannerConfigFields<T extends { type: string; configFields?: unknown }>(
+ types: T[],
+ configFields: unknown[] | undefined,
+ scannerType = "trustabl"
+): T[] {
+ if (!configFields?.length) return types;
+ return types.map((item) =>
+ item.type === scannerType ? { ...item, configFields } : item
+ );
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/config-fields.ts b/src/client/src/lib/platform/connectors/scanner/config-fields.ts
new file mode 100644
index 00000000..1eb6fa46
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/config-fields.ts
@@ -0,0 +1,210 @@
+import getMessage from "@/constants/messages";
+import type { FieldDef } from "../datasource/types";
+import type { ScannerCliSchema } from "./cli-schema";
+
+function rulesSourceOptions(messages: ReturnType<typeof getMessage>): FieldDef["options"] {
+ return [
+ { value: "environment", label: messages.SCANNER_FIELD_RULES_SOURCE_ENVIRONMENT },
+ { value: "production", label: messages.SCANNER_FIELD_RULES_SOURCE_PRODUCTION },
+ { value: "staging", label: messages.SCANNER_FIELD_RULES_SOURCE_STAGING },
+ { value: "git", label: messages.SCANNER_FIELD_RULES_SOURCE_GIT },
+ ];
+}
+
+function ownedFields(messages: ReturnType<typeof getMessage>): FieldDef[] {
+ return [
+ {
+ key: "target",
+ label: messages.SCANNER_FIELD_TARGET,
+ kind: "url",
+ group: "settings",
+ placeholder: "https://github.com/owner/repo/tree/main",
+ description: messages.SCANNER_FIELD_TARGET_HELP,
+ },
+ {
+ key: "ref",
+ label: messages.SCANNER_FIELD_REF,
+ kind: "text",
+ group: "settings",
+ placeholder: "main",
+ description: messages.SCANNER_FIELD_REF_HELP,
+ },
+ ];
+}
+
+function credentialFields(messages: ReturnType<typeof getMessage>): FieldDef[] {
+ return [
+ {
+ key: "githubToken",
+ label: messages.SCANNER_FIELD_GITHUB_TOKEN,
+ kind: "password",
+ group: "credentials",
+ },
+ ];
+}
+
+function knownFlagField(
+ key: string,
+ messages: ReturnType<typeof getMessage>
+): FieldDef | null {
+ switch (key) {
+ case "detectors":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_DETECTORS,
+ kind: "text",
+ group: "settings",
+ placeholder: "claude_sdk,mcp",
+ description: messages.SCANNER_FIELD_DETECTORS_HELP,
+ };
+ case "strict":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_STRICT,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_STRICT_HELP,
+ };
+ case "secretScan":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_SECRET_SCAN,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_SECRET_SCAN_HELP,
+ };
+ case "vulnScan":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_VULN_SCAN,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_VULN_SCAN_HELP,
+ };
+ case "licenseScan":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_LICENSE_SCAN,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_LICENSE_SCAN_HELP,
+ };
+ case "rulesSource":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_RULES_SOURCE,
+ kind: "select",
+ group: "settings",
+ defaultValue: "environment",
+ description: messages.SCANNER_FIELD_RULES_SOURCE_HELP,
+ options: rulesSourceOptions(messages),
+ };
+ case "rulesRepo":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_RULES_REPO,
+ kind: "url",
+ group: "settings",
+ placeholder: "https://github.com/trustabl/trustabl-rules",
+ description: messages.SCANNER_FIELD_RULES_REPO_HELP,
+ };
+ case "rulesRef":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_RULES_REF,
+ kind: "text",
+ group: "settings",
+ placeholder: "main",
+ description: messages.SCANNER_FIELD_RULES_REF_HELP,
+ };
+ case "requireSigned":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_REQUIRE_SIGNED,
+ kind: "switch",
+ group: "settings",
+ defaultValue: true,
+ description: messages.SCANNER_FIELD_REQUIRE_SIGNED_HELP,
+ };
+ case "noRulesUpdate":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_NO_RULES_UPDATE,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_NO_RULES_UPDATE_HELP,
+ };
+ case "verbose":
+ return {
+ key,
+ label: messages.SCANNER_FIELD_VERBOSE,
+ kind: "switch",
+ group: "settings",
+ defaultValue: false,
+ description: messages.SCANNER_FIELD_VERBOSE_HELP,
+ };
+ default:
+ return null;
+ }
+}
+
+const FALLBACK_FLAG_KEYS = [
+ "detectors",
+ "strict",
+ "secretScan",
+ "vulnScan",
+ "licenseScan",
+ "rulesSource",
+ "rulesRepo",
+ "rulesRef",
+ "requireSigned",
+ "noRulesUpdate",
+] as const;
+
+function fieldFromCliFlag(
+ flag: ScannerCliSchema["flags"][number],
+ messages: ReturnType<typeof getMessage>
+): FieldDef {
+ const known = knownFlagField(flag.key, messages);
+ if (known) return known;
+ const kind: FieldDef["kind"] =
+ flag.kind === "boolean" ? "switch" : flag.flag.endsWith("-repo") ? "url" : "text";
+ return {
+ key: flag.key,
+ label: humanizeFromMessages(flag.flag, messages),
+ kind,
+ group: "settings",
+ defaultValue: flag.kind === "boolean" ? Boolean(flag.defaultValue) : undefined,
+ description: flag.help || messages.SCANNER_CLI_FLAG_HELP,
+ };
+}
+
+function humanizeFromMessages(flag: string, messages: ReturnType<typeof getMessage>): string {
+ return messages.SCANNER_CLI_FLAG_LABEL(flag);
+}
+
+function flagFields(
+ messages: ReturnType<typeof getMessage>,
+ schema?: ScannerCliSchema
+): FieldDef[] {
+ if (schema?.flags.length) {
+ return schema.flags.map((flag) => fieldFromCliFlag(flag, messages));
+ }
+ return FALLBACK_FLAG_KEYS.map((key) => knownFlagField(key, messages)).filter(
+ (field): field is FieldDef => !!field
+ );
+}
+
+export function trustablConfigFields(schema?: ScannerCliSchema): FieldDef[] {
+ const messages = getMessage();
+ return [...ownedFields(messages), ...flagFields(messages, schema), ...credentialFields(messages)];
+}
+
+export function trustablRunParamFields(schema?: ScannerCliSchema): FieldDef[] {
+ return trustablConfigFields(schema).filter((field) => field.group !== "credentials");
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/crud.ts b/src/client/src/lib/platform/connectors/scanner/crud.ts
new file mode 100644
index 00000000..9af1c368
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/crud.ts
@@ -0,0 +1,564 @@
+/**
+ * Project-scoped CRUD for scanner connector instances.
+ *
+ * Scanner connectors persist on Prisma `ConnectorInstance`. GitHub tokens are
+ * encrypted onto `secretRef` (same `enc:v1:` scheme as vault values). Raw
+ * tokens never appear in API responses.
+ */
+
+import { randomUUID } from "crypto";
+import { headers } from "next/headers";
+import prisma from "@/lib/prisma";
+import { createProjectEnvironment } from "@/lib/project-environment";
+import {
+ getCurrentOrganisation,
+ getCurrentProjectForOrganisation,
+} from "@/lib/organisation";
+import { assertPremiumConnectorAllowed } from "@/lib/access/connector-entitlement";
+import { OPENLIT_CONTEXT_HEADERS } from "@/constants/openlit-context";
+import { invalidateSourceSecretCache } from "@/lib/platform/connectors/datasource/http/secret";
+import { encryptValue, isEncrypted } from "@/utils/crypto";
+import { ensureScannerAdaptersRegistered } from "./bootstrap";
+import { describeTrustablRuntime, installTrustablCli } from "./install";
+import {
+ createScannerAdapter,
+ getScannerTypeDescriptor,
+ hasScannerAdapterFactory,
+ listScannerTypeDescriptors,
+} from "./registry";
+import type { ScannerJob, ScannerScanInput, ScannerSourceDescriptor } from "./types";
+import { connectorDescription } from "../descriptions";
+import { connectorIconPath } from "../icons";
+import {
+ SCANNER_CONNECTOR_NAME_REQUIRED,
+ SCANNER_CONNECTOR_NAME_TAKEN,
+ SCANNER_CONNECTOR_NO_PROJECT,
+ SCANNER_CONNECTOR_NOT_FOUND,
+ SCANNER_CONNECTOR_TYPE_UNKNOWN,
+ SCANNER_CONNECTOR_INLINE_SECRET_REQUIRED,
+ SCANNER_JOB_RUNNING,
+ SCANNER_JOB_NOT_FOUND,
+ SCANNER_JOB_ID_INVALID,
+ SCANNER_SCAN_FAILED,
+ TELEMETRY_SOURCE_INVALID_SETTINGS,
+} from "@/constants/messages/en";
+import { hasRunningScannerJob, jobsFromMetadata, prependScannerJob } from "./jobs";
+import {
+ normalizeScannerDetectors,
+ normalizeScannerRef,
+ normalizeScannerRulesRepo,
+ normalizeScannerRulesSource,
+ normalizeScannerTarget,
+} from "./target";
+import { parseScannerScanInput } from "./scan-params";
+import { isScannerExtraSettingKey } from "./cli-schema";
+import { newScannerJobId } from "./report";
+import { isScannerJobId, pageScannerJobFindings, type ScannerFindingPage } from "./job-findings";
+
+export const SCANNER_CONNECTOR_PREFIX = "scanner:";
+
+export function scannerConnectorId(id: string): string {
+ const trimmed = String(id || "").trim();
+ return trimmed.startsWith(SCANNER_CONNECTOR_PREFIX)
+ ? trimmed
+ : `${SCANNER_CONNECTOR_PREFIX}${trimmed}`;
+}
+
+export function isScannerConnectorId(id: unknown): boolean {
+ return String(id || "").startsWith(SCANNER_CONNECTOR_PREFIX);
+}
+
+export interface ScannerConnectorInput {
+ name?: unknown;
+ environment?: unknown;
+ type?: unknown;
+ settings?: unknown;
+ secretRef?: unknown;
+ credentials?: unknown;
+}
+
+export type ScannerConnectorPublic = {
+ id: string;
+ name: string;
+ type: string;
+ environment: string;
+ organisationId: string | null;
+ projectId: string | null;
+ settings: string;
+ status: string;
+ metadata: string;
+ createdAt: Date;
+ updatedAt: Date;
+ hasSecret: boolean;
+ category: "scanner";
+ scope: "project";
+ signals: string;
+ isDefault: boolean;
+ jobs: ScannerJob[];
+};
+
+function publicConnectorMetadata(raw: string): string {
+ const parsed = (() => {
+ try {
+ const value = JSON.parse(raw || "{}");
+ if (value && typeof value === "object" && !Array.isArray(value)) {
+ return value as Record<string, unknown>;
+ }
+ } catch {
+ /* keep empty */
+ }
+ return {};
+ })();
+ delete parsed.jobs;
+ return JSON.stringify(parsed);
+}
+
+function sanitize(row: {
+ id: string;
+ name: string;
+ type: string;
+ environment: string;
+ organisationId: string | null;
+ projectId: string | null;
+ settings: string;
+ secretRef?: string | null;
+ status: string;
+ metadata: string;
+ createdAt: Date;
+ updatedAt: Date;
+}): ScannerConnectorPublic {
+ return {
+ id: row.id,
+ name: row.name,
+ type: row.type,
+ environment: row.environment,
+ organisationId: row.organisationId,
+ projectId: row.projectId,
+ settings: row.settings,
+ status: row.status,
+ createdAt: row.createdAt,
+ updatedAt: row.updatedAt,
+ metadata: publicConnectorMetadata(row.metadata ?? "{}"),
+ hasSecret: !!row.secretRef,
+ category: "scanner",
+ scope: "project",
+ signals: "",
+ isDefault: false,
+ jobs: jobsFromMetadata(row.metadata || "{}"),
+ };
+}
+
+async function requireCurrentProject(): Promise<{
+ organisationId: string;
+ projectId: string;
+}> {
+ const org = await getCurrentOrganisation();
+ if (!org?.id) throw new Error(SCANNER_CONNECTOR_NO_PROJECT);
+ const project = await getCurrentProjectForOrganisation(org.id);
+ if (!project?.id) throw new Error(SCANNER_CONNECTOR_NO_PROJECT);
+ return { organisationId: org.id, projectId: project.id };
+}
+
+function normalizeEnvironment(value: unknown): string {
+ const environment = String(value || "production").trim().toLowerCase();
+ if (!/^[a-z0-9][a-z0-9._-]{0,62}$/.test(environment)) {
+ throw new Error(
+ "Environment must use letters, numbers, dots, hyphens, or underscores."
+ );
+ }
+ return environment;
+}
+
+async function resolveScannerEnvironment(environment?: string): Promise<string> {
+ if (environment != null && String(environment).trim()) {
+ return normalizeEnvironment(environment);
+ }
+ try {
+ const headerStore = await headers();
+ const fromHeader = headerStore.get(OPENLIT_CONTEXT_HEADERS.environment);
+ if (fromHeader?.trim()) return normalizeEnvironment(fromHeader);
+ } catch {
+ /* outside a Next.js request */
+ }
+ return "production";
+}
+
+function normalizeBooleanSetting(value: unknown): boolean | undefined {
+ if (value === true || value === "true") return true;
+ if (value === false || value === "false") return false;
+ return undefined;
+}
+
+function normalizeSettingsObject(settings: Record<string, unknown>): Record<string, unknown> {
+ const next = { ...settings };
+ if (next.target != null && String(next.target).trim()) {
+ next.target = normalizeScannerTarget(next.target);
+ }
+ if (next.ref != null) {
+ const ref = normalizeScannerRef(next.ref);
+ if (ref) next.ref = ref;
+ else delete next.ref;
+ }
+ if (next.detectors != null) {
+ const detectors = normalizeScannerDetectors(next.detectors);
+ if (detectors) next.detectors = detectors;
+ else delete next.detectors;
+ }
+ if (next.rulesRepo != null) {
+ const rulesRepo = normalizeScannerRulesRepo(next.rulesRepo);
+ if (rulesRepo) next.rulesRepo = rulesRepo;
+ else delete next.rulesRepo;
+ }
+ if (next.rulesRef != null) {
+ const rulesRef = normalizeScannerRef(next.rulesRef);
+ if (rulesRef) next.rulesRef = rulesRef;
+ else delete next.rulesRef;
+ }
+ if (next.rulesSource != null) {
+ const rulesSource = normalizeScannerRulesSource(next.rulesSource);
+ if (rulesSource) next.rulesSource = rulesSource;
+ else delete next.rulesSource;
+ }
+ for (const key of [
+ "strict",
+ "secretScan",
+ "vulnScan",
+ "licenseScan",
+ "requireSigned",
+ "noRulesUpdate",
+ "verbose",
+ ] as const) {
+ const flag = normalizeBooleanSetting(next[key]);
+ if (flag === undefined) delete next[key];
+ else next[key] = flag;
+ }
+ for (const [key, value] of Object.entries(next)) {
+ if (!isScannerExtraSettingKey(key)) continue;
+ if (typeof value === "boolean") continue;
+ if (value === "true" || value === "false") {
+ next[key] = value === "true";
+ continue;
+ }
+ if (typeof value === "string") {
+ const trimmed = value.trim().slice(0, 500);
+ if (!trimmed || /[\r\n\0]/.test(trimmed) || trimmed.startsWith("-")) delete next[key];
+ else next[key] = trimmed;
+ continue;
+ }
+ delete next[key];
+ }
+ return next;
+}
+
+function normalizeSettings(settings: unknown): string {
+ if (settings === undefined || settings === null) return "{}";
+ if (typeof settings === "string") {
+ try {
+ const parsed = JSON.parse(settings);
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+ throw new Error(TELEMETRY_SOURCE_INVALID_SETTINGS);
+ }
+ return JSON.stringify(normalizeSettingsObject(parsed as Record<string, unknown>));
+ } catch (error) {
+ if (error instanceof Error && error.message === TELEMETRY_SOURCE_INVALID_SETTINGS) {
+ throw error;
+ }
+ throw new Error(TELEMETRY_SOURCE_INVALID_SETTINGS);
+ }
+ }
+ if (typeof settings === "object" && !Array.isArray(settings)) {
+ return JSON.stringify(normalizeSettingsObject(settings as Record<string, unknown>));
+ }
+ throw new Error(TELEMETRY_SOURCE_INVALID_SETTINGS);
+}
+
+function credentialsToSecretRef(credentials: unknown): string | undefined {
+ if (!credentials || typeof credentials !== "object" || Array.isArray(credentials)) {
+ return undefined;
+ }
+ const entries = Object.entries(credentials as Record<string, unknown>).filter(
+ ([, v]) => typeof v === "string" && v.trim() !== ""
+ );
+ if (entries.length === 0) return undefined;
+ return encryptValue(JSON.stringify(Object.fromEntries(entries)));
+}
+
+async function validateSecretReference(secretRef: string | null) {
+ if (!secretRef) return;
+ if (isEncrypted(secretRef)) return;
+ throw new Error(SCANNER_CONNECTOR_INLINE_SECRET_REQUIRED);
+}
+
+function validateType(type: unknown): string {
+ ensureScannerAdaptersRegistered();
+ const t = String(type || "").trim();
+ if (!t || !hasScannerAdapterFactory(t) || getScannerTypeDescriptor(t)?.internal) {
+ throw new Error(SCANNER_CONNECTOR_TYPE_UNKNOWN(String(type)));
+ }
+ return t;
+}
+
+export function isScannerConnectorType(type: unknown): boolean {
+ ensureScannerAdaptersRegistered();
+ return hasScannerAdapterFactory(String(type || "").trim());
+}
+
+export function availableScannerTypeDescriptors() {
+ ensureScannerAdaptersRegistered();
+ return listScannerTypeDescriptors().map((descriptor) => ({
+ ...descriptor,
+ category: "scanner" as const,
+ scope: "project" as const,
+ declaredSignals: [] as string[],
+ description:
+ descriptor.description ||
+ connectorDescription(descriptor.type, descriptor.displayName),
+ icon: descriptor.icon || connectorIconPath(descriptor.type),
+ }));
+}
+
+function parseSettings(settings: string): Record<string, unknown> {
+ try {
+ const parsed = JSON.parse(settings || "{}");
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+ return parsed as Record<string, unknown>;
+ }
+ } catch {
+ /* keep empty */
+ }
+ return {};
+}
+
+function toRuntimeDescriptor(row: {
+ id: string;
+ type: string;
+ name: string;
+ settings: string;
+ secretRef?: string | null;
+ projectId?: string | null;
+ environment?: string | null;
+}): ScannerSourceDescriptor {
+ return {
+ type: row.type,
+ id: row.id,
+ settings: parseSettings(row.settings),
+ secretRef: row.secretRef,
+ projectId: row.projectId ?? null,
+ name: row.name,
+ environment: row.environment || undefined,
+ };
+}
+
+export async function createScannerConnector(input: ScannerConnectorInput) {
+ const { organisationId, projectId } = await requireCurrentProject();
+ const name = String(input.name || "").trim();
+ if (!name) throw new Error(SCANNER_CONNECTOR_NAME_REQUIRED);
+ const type = validateType(input.type);
+ await assertPremiumConnectorAllowed(type);
+ const environment = normalizeEnvironment(input.environment);
+ await createProjectEnvironment(environment);
+ const settings = normalizeSettings(input.settings);
+ const parsedSettings = parseSettings(settings);
+ if (type === "trustabl") normalizeScannerTarget(parsedSettings.target);
+ const credentialSecretRef = credentialsToSecretRef(input.credentials);
+ const secretRef =
+ credentialSecretRef ??
+ (typeof input.secretRef === "string" ? input.secretRef : null);
+ await validateSecretReference(secretRef);
+
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { projectId, name, environment },
+ select: { id: true },
+ });
+ if (existing) throw new Error(SCANNER_CONNECTOR_NAME_TAKEN(name, environment));
+
+ const created = await prisma.connectorInstance.create({
+ data: {
+ id: scannerConnectorId(randomUUID()),
+ category: "scanner",
+ type,
+ name,
+ environment,
+ organisationId,
+ projectId,
+ settings,
+ secretRef,
+ status: "active",
+ metadata: JSON.stringify({ category: "scanner", jobs: [] }),
+ },
+ });
+ return sanitize(created);
+}
+
+export async function updateScannerConnector(id: string, input: ScannerConnectorInput) {
+ const { projectId } = await requireCurrentProject();
+ const instanceId = scannerConnectorId(id);
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { id: instanceId, projectId, category: "scanner" },
+ });
+ if (!existing) throw new Error(SCANNER_CONNECTOR_NOT_FOUND);
+
+ const name = input.name === undefined ? existing.name : String(input.name || "").trim();
+ if (!name) throw new Error(SCANNER_CONNECTOR_NAME_REQUIRED);
+ const environment =
+ input.environment === undefined
+ ? existing.environment
+ : normalizeEnvironment(input.environment);
+ await createProjectEnvironment(environment);
+ const settings =
+ input.settings === undefined ? existing.settings : normalizeSettings(input.settings);
+ const credentialSecretRef = credentialsToSecretRef(input.credentials);
+ const secretRef =
+ credentialSecretRef ??
+ (typeof input.secretRef === "string" ? input.secretRef : existing.secretRef);
+ await validateSecretReference(secretRef || null);
+
+ if (name !== existing.name || environment !== existing.environment) {
+ const clash = await prisma.connectorInstance.findFirst({
+ where: {
+ projectId,
+ name,
+ environment,
+ NOT: { id: instanceId },
+ },
+ select: { id: true },
+ });
+ if (clash) throw new Error(SCANNER_CONNECTOR_NAME_TAKEN(name, environment));
+ }
+
+ const updated = await prisma.connectorInstance.update({
+ where: { id: instanceId },
+ data: {
+ name,
+ environment,
+ settings,
+ secretRef,
+ status: "active",
+ },
+ });
+ if (credentialSecretRef || input.secretRef) {
+ invalidateSourceSecretCache(existing.secretRef || undefined);
+ }
+ return sanitize(updated);
+}
+
+export async function deleteScannerConnector(id: string) {
+ const { projectId } = await requireCurrentProject();
+ const instanceId = scannerConnectorId(id);
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { id: instanceId, projectId, category: "scanner" },
+ select: { id: true, secretRef: true },
+ });
+ if (!existing) throw new Error(SCANNER_CONNECTOR_NOT_FOUND);
+ await prisma.connectorInstance.delete({ where: { id: instanceId } });
+ invalidateSourceSecretCache(existing.secretRef || undefined);
+ return { ok: true };
+}
+
+export async function getScannerConnector(id: string) {
+ const { projectId } = await requireCurrentProject();
+ const instanceId = scannerConnectorId(id);
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { id: instanceId, projectId, category: "scanner" },
+ });
+ if (!existing) throw new Error(SCANNER_CONNECTOR_NOT_FOUND);
+ return existing;
+}
+
+export async function listScannerConnectors(environment?: string) {
+ ensureScannerAdaptersRegistered();
+ const { projectId } = await requireCurrentProject();
+ const env = await resolveScannerEnvironment(environment);
+ const rows = await prisma.connectorInstance.findMany({
+ where: { projectId, category: "scanner", environment: env },
+ orderBy: [{ createdAt: "asc" }],
+ });
+ return rows.filter((row) => hasScannerAdapterFactory(row.type)).map(sanitize);
+}
+
+export async function getScannerRuntime(id?: string, environment?: string) {
+ ensureScannerAdaptersRegistered();
+ const { projectId } = await requireCurrentProject();
+ const env = await resolveScannerEnvironment(environment);
+ const instanceId = id ? scannerConnectorId(id) : undefined;
+ const row = instanceId
+ ? await prisma.connectorInstance.findFirst({
+ where: {
+ id: instanceId,
+ projectId,
+ category: "scanner",
+ environment: env,
+ },
+ })
+ : await prisma.connectorInstance.findFirst({
+ where: { projectId, category: "scanner", environment: env },
+ orderBy: [{ createdAt: "asc" }],
+ });
+ if (!row) throw new Error(SCANNER_CONNECTOR_NOT_FOUND);
+ const adapter = createScannerAdapter(toRuntimeDescriptor(row));
+ if (!adapter) throw new Error(SCANNER_CONNECTOR_TYPE_UNKNOWN(row.type));
+ return { adapter, connector: sanitize(row), row };
+}
+
+export async function healthCheckScannerConnector(id: string) {
+ ensureScannerAdaptersRegistered();
+ const row = await getScannerConnector(id);
+ const adapter = createScannerAdapter(toRuntimeDescriptor(row));
+ if (!adapter) throw new Error(SCANNER_CONNECTOR_TYPE_UNKNOWN(row.type));
+ return adapter.healthCheck();
+}
+
+export async function getScannerCliRuntime() {
+ ensureScannerAdaptersRegistered();
+ return describeTrustablRuntime();
+}
+
+export async function installScannerRuntime(id?: string, input: { upgrade?: boolean } = {}) {
+ ensureScannerAdaptersRegistered();
+ if (id) await getScannerRuntime(id);
+ const runtime = await installTrustablCli(input);
+ return { runtime };
+}
+
+export async function listScannerJobFindings(
+ id: string,
+ jobId: string,
+ input: { q?: unknown; severity?: unknown; page?: unknown; limit?: unknown } = {}
+): Promise<ScannerFindingPage> {
+ if (!isScannerJobId(jobId)) throw new Error(SCANNER_JOB_ID_INVALID);
+ const row = await getScannerConnector(id);
+ const job = jobsFromMetadata(row.metadata || "{}").find((item) => item.id === jobId);
+ if (!job) throw new Error(SCANNER_JOB_NOT_FOUND);
+ return pageScannerJobFindings(job, input);
+}
+
+export async function runScannerJob(id: string, input: ScannerScanInput = {}) {
+ const { adapter, connector, row } = await getScannerRuntime(id);
+ if (hasRunningScannerJob(row.metadata || "{}")) {
+ throw new Error(SCANNER_JOB_RUNNING);
+ }
+ const settings = parseSettings(row.settings);
+ const running: ScannerJob = {
+ id: newScannerJobId(),
+ status: "running",
+ target: String(input.target || settings.target || ""),
+ ref: input.ref ? String(input.ref) : undefined,
+ params: parseScannerScanInput(input as Record<string, unknown>),
+ startedAt: new Date().toISOString(),
+ };
+ await prependScannerJob(row.id, running);
+ try {
+ const job = await adapter.scan(input);
+ await prependScannerJob(row.id, job);
+ return { connector, job };
+ } catch (error) {
+ const failed: ScannerJob = {
+ ...running,
+ status: "failed",
+ finishedAt: new Date().toISOString(),
+ error: error instanceof Error ? error.message : SCANNER_SCAN_FAILED,
+ };
+ await prependScannerJob(row.id, failed);
+ throw error;
+ }
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/enterprise.ts b/src/client/src/lib/platform/connectors/scanner/enterprise.ts
new file mode 100644
index 00000000..7ff56337
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/enterprise.ts
@@ -0,0 +1,14 @@
+/**
+ * Neutral extension hook for additional scanner connector adapters.
+ *
+ * CE scanner vendors (Trustabl) are registered via `bootstrap.ts`. This hook
+ * stays empty in CE so a private fork can contribute extra factories without
+ * importing `@/ee/**` from shared code.
+ */
+
+import type { ScannerAdapterFactory } from "./types";
+
+/** CE no-op: no extra private scanner adapters beyond the CE bootstrap set. */
+export function getExternalScannerAdapters(): ScannerAdapterFactory[] {
+ return [];
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/index.ts b/src/client/src/lib/platform/connectors/scanner/index.ts
new file mode 100644
index 00000000..4117863f
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/index.ts
@@ -0,0 +1,93 @@
+import {
+ createScannerAdapter,
+ listScannerTypeDescriptors,
+} from "./registry";
+import type { ScannerAdapter, ScannerSourceDescriptor } from "./types";
+import { registerConnectorType } from "../registry";
+import type { ConnectorField, ConnectorInstanceDescriptor } from "../types";
+import { connectorIconPath } from "../icons";
+import { connectorDescription } from "../descriptions";
+
+function parseSettings(settings: unknown): Record<string, unknown> {
+ if (settings && typeof settings === "object" && !Array.isArray(settings)) {
+ return settings as Record<string, unknown>;
+ }
+ if (typeof settings === "string") {
+ try {
+ const parsed = JSON.parse(settings);
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+ return parsed as Record<string, unknown>;
+ }
+ } catch {
+ return {};
+ }
+ }
+ return {};
+}
+
+function fields(
+ descriptor: ReturnType<typeof listScannerTypeDescriptors>[number]
+): ConnectorField[] {
+ return descriptor.configFields.map((field) => ({
+ key: field.key,
+ label: field.label,
+ kind:
+ field.kind === "switch"
+ ? "boolean"
+ : field.kind === "password"
+ ? "password"
+ : field.kind === "url"
+ ? "url"
+ : field.kind === "select"
+ ? "select"
+ : "text",
+ secret: field.group === "credentials",
+ placeholder: field.placeholder,
+ options: field.options,
+ defaultValue: field.defaultValue,
+ }));
+}
+
+function toScannerDescriptor(
+ instance: ConnectorInstanceDescriptor
+): ScannerSourceDescriptor {
+ return {
+ type: instance.type,
+ id: instance.id,
+ settings: parseSettings(instance.settings),
+ secretRef: instance.secretRef,
+ projectId: instance.projectId ?? null,
+ name: instance.name,
+ environment: instance.environment,
+ };
+}
+
+/** Register scanner types in the generic connector registry. */
+export function registerScannerConnectorTypes(): void {
+ for (const descriptor of listScannerTypeDescriptors({ includeInternal: true })) {
+ registerConnectorType({
+ descriptor: {
+ type: descriptor.type,
+ category: "scanner",
+ displayName: descriptor.displayName,
+ description:
+ descriptor.description ||
+ connectorDescription(descriptor.type, descriptor.displayName),
+ icon: descriptor.icon || connectorIconPath(descriptor.type),
+ scope: "project",
+ configFields: fields(descriptor),
+ capabilities: { ...descriptor.capabilities },
+ internal: descriptor.internal,
+ },
+ create: (instance: ConnectorInstanceDescriptor) => {
+ const adapter = createScannerAdapter(toScannerDescriptor(instance)) as
+ | ScannerAdapter
+ | undefined;
+ if (!adapter) {
+ throw new Error(`Connector adapter unavailable: ${instance.type}`);
+ }
+ return adapter;
+ },
+ });
+ }
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/install.ts b/src/client/src/lib/platform/connectors/scanner/install.ts
new file mode 100644
index 00000000..2e389d95
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/install.ts
@@ -0,0 +1,214 @@
+import { createHash, timingSafeEqual } from "node:crypto";
+import { execFile } from "node:child_process";
+import { chmod, mkdir, mkdtemp, readdir, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { isAbsolute, join, resolve, sep } from "node:path";
+import { promisify } from "node:util";
+import {
+ SCANNER_RUNTIME_CHECKSUM_FAILED,
+ SCANNER_RUNTIME_DOWNLOAD_FAILED,
+ SCANNER_RUNTIME_EXTRACT_FAILED,
+ SCANNER_RUNTIME_UNSUPPORTED_PLATFORM,
+} from "@/constants/messages/en";
+import {
+ TRUSTABL_LATEST_RELEASE_URL,
+ normalizeScannerVersion,
+ parseChecksumFile,
+ trustablAssetName,
+ trustablReleaseDownloadUrl,
+} from "./release";
+import {
+ TRUSTABL_FALLBACK_VERSION,
+ probeTrustablRuntime,
+ trustablCacheBinary,
+} from "./runtime";
+import type { ScannerRuntimeInfo } from "./types";
+
+const execFileAsync = promisify(execFile);
+const MAX_DOWNLOAD_BYTES = 80 * 1024 * 1024;
+const TRUSTABL_DOWNLOAD_HOSTS = new Set([
+ "github.com",
+ "api.github.com",
+ "objects.githubusercontent.com",
+ "release-assets.githubusercontent.com",
+]);
+
+function assertPathInside(root: string, candidate: string): string {
+ const resolvedRoot = resolve(root);
+ const resolved = resolve(candidate);
+ if (resolved !== resolvedRoot && !resolved.startsWith(resolvedRoot + sep)) {
+ throw new Error(SCANNER_RUNTIME_EXTRACT_FAILED);
+ }
+ return resolved;
+}
+
+export function assertTrustablDownloadUrl(url: string): string {
+ let parsed: URL;
+ try {
+ parsed = new URL(url);
+ } catch {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ if (parsed.protocol !== "https:") {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ if (parsed.username || parsed.password) {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ const host = parsed.hostname.toLowerCase();
+ if (
+ !TRUSTABL_DOWNLOAD_HOSTS.has(host) &&
+ !host.endsWith(".githubusercontent.com")
+ ) {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ return parsed.toString();
+}
+
+export type TrustablReleaseFetcher = (url: string) => Promise<Buffer>;
+
+let releaseFetcher: TrustablReleaseFetcher = defaultReleaseFetcher;
+
+export function setTrustablReleaseFetcherForTests(fetcher: TrustablReleaseFetcher): void {
+ releaseFetcher = fetcher;
+}
+
+export function __resetTrustablReleaseFetcherForTests(): void {
+ releaseFetcher = defaultReleaseFetcher;
+}
+
+function githubHeaders(): Record<string, string> {
+ const headers: Record<string, string> = {
+ Accept: "application/vnd.github+json",
+ "User-Agent": "openlit",
+ "X-GitHub-Api-Version": "2022-11-28",
+ };
+ const token = String(process.env.GITHUB_TOKEN || process.env.GH_TOKEN || "").trim();
+ if (token) headers.Authorization = `Bearer ${token}`;
+ return headers;
+}
+
+async function defaultReleaseFetcher(url: string): Promise<Buffer> {
+ const safeUrl = assertTrustablDownloadUrl(url);
+ const response = await fetch(safeUrl, {
+ headers: githubHeaders(),
+ redirect: "follow",
+ });
+ if (!response.ok) {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ const bytes = Buffer.from(await response.arrayBuffer());
+ if (bytes.length > MAX_DOWNLOAD_BYTES) {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ return bytes;
+}
+
+function assertChecksum(archive: Buffer, expectedHex: string): void {
+ const digest = createHash("sha256").update(archive).digest();
+ const expected = Buffer.from(expectedHex, "hex");
+ if (expected.length !== digest.length || !timingSafeEqual(digest, expected)) {
+ throw new Error(SCANNER_RUNTIME_CHECKSUM_FAILED);
+ }
+}
+
+function verifiedReleaseBytes(archive: Buffer, expectedHex: string): Uint8Array {
+ assertChecksum(archive, expectedHex);
+ const copy = Buffer.alloc(archive.length);
+ archive.copy(copy);
+ return new Uint8Array(copy);
+}
+
+async function extractArchive(archivePath: string, destDir: string): Promise<void> {
+ const safeArchive = assertPathInside(destDir, archivePath);
+ const safeDest = resolve(destDir);
+ if (!isAbsolute(safeArchive) || !isAbsolute(safeDest)) {
+ throw new Error(SCANNER_RUNTIME_EXTRACT_FAILED);
+ }
+ try {
+ await execFileAsync("tar", ["-xf", safeArchive, "-C", safeDest], {
+ timeout: 60_000,
+ shell: false,
+ });
+ } catch {
+ throw new Error(SCANNER_RUNTIME_EXTRACT_FAILED);
+ }
+}
+
+async function findExtractedBinary(dir: string, root = dir): Promise<string> {
+ const wanted = process.platform === "win32" ? "trustabl.exe" : "trustabl";
+ const safeDir = assertPathInside(root, dir);
+ const entries = await readdir(safeDir, { withFileTypes: true });
+ for (const entry of entries) {
+ if (entry.name === "." || entry.name === "..") continue;
+ const path = assertPathInside(root, join(safeDir, entry.name));
+ if (entry.isDirectory()) {
+ const nested = await findExtractedBinary(path, root).catch(() => "");
+ if (nested) return nested;
+ } else if (entry.name === wanted || entry.name === "trustabl") {
+ return path;
+ }
+ }
+ throw new Error(SCANNER_RUNTIME_EXTRACT_FAILED);
+}
+
+export async function fetchLatestTrustablTag(): Promise<string> {
+ const raw = JSON.parse((await releaseFetcher(TRUSTABL_LATEST_RELEASE_URL)).toString("utf8")) as {
+ tag_name?: string;
+ };
+ const tag = String(raw.tag_name || "").trim();
+ if (!normalizeScannerVersion(tag)) {
+ throw new Error(SCANNER_RUNTIME_DOWNLOAD_FAILED);
+ }
+ return tag.startsWith("v") ? tag : `v${tag}`;
+}
+
+export async function describeTrustablRuntime(): Promise<ScannerRuntimeInfo> {
+ let latest = TRUSTABL_FALLBACK_VERSION;
+ try {
+ latest = await fetchLatestTrustablTag();
+ } catch {
+ latest = TRUSTABL_FALLBACK_VERSION;
+ }
+ return probeTrustablRuntime(latest);
+}
+
+export async function installTrustablCli(input: { upgrade?: boolean } = {}): Promise<ScannerRuntimeInfo> {
+ const current = await describeTrustablRuntime();
+ if (current.installed && !input.upgrade) {
+ return current;
+ }
+
+ const tag = current.latestVersion || (await fetchLatestTrustablTag().catch(() => TRUSTABL_FALLBACK_VERSION));
+ const fileName = trustablAssetName(tag);
+ if (!fileName) throw new Error(SCANNER_RUNTIME_UNSUPPORTED_PLATFORM);
+
+ const checksums = parseChecksumFile(
+ (await releaseFetcher(trustablReleaseDownloadUrl(tag, "checksums.txt"))).toString("utf8")
+ );
+ const expected = checksums.get(fileName);
+ if (!expected) throw new Error(SCANNER_RUNTIME_CHECKSUM_FAILED);
+
+ const archive = await releaseFetcher(trustablReleaseDownloadUrl(tag, fileName));
+ const verifiedArchive = verifiedReleaseBytes(archive, expected);
+
+ const staging = await mkdtemp(join(tmpdir(), "openlit-trustabl-"));
+ try {
+ const archiveName = process.platform === "win32" ? "package.zip" : "package.tar.gz";
+ const archivePath = join(staging, archiveName);
+ // codeql[js/http-to-file-access]: SHA-256 verified GitHub Trustabl release only
+ await writeFile(archivePath, verifiedArchive);
+ await extractArchive(archivePath, staging);
+ const extracted = assertPathInside(staging, await findExtractedBinary(staging));
+ const dest = trustablCacheBinary(tag);
+ await mkdir(join(dest, ".."), { recursive: true });
+ const binary = await readFile(extracted);
+ // codeql[js/http-to-file-access]: extracted Trustabl binary after checksummed archive
+ await writeFile(dest, binary);
+ if (process.platform !== "win32") await chmod(dest, 0o755);
+ } finally {
+ await rm(staging, { recursive: true, force: true });
+ }
+
+ return probeTrustablRuntime(tag);
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/job-findings.ts b/src/client/src/lib/platform/connectors/scanner/job-findings.ts
new file mode 100644
index 00000000..1158f300
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/job-findings.ts
@@ -0,0 +1,108 @@
+import type { ScannerFinding, ScannerJob } from "./types";
+
+export const SCANNER_FINDINGS_PAGE_SIZE = 25;
+export const SCANNER_FINDINGS_MAX_PAGE_SIZE = 100;
+export const SCANNER_FINDINGS_QUERY_MAX = 200;
+
+export const SCANNER_JOB_ID_PATTERN = /^job:[A-Za-z0-9_-]+$/;
+
+export type ScannerFindingSeverityFilter = "all" | "critical" | "high" | "medium" | "low";
+
+export type ScannerFindingCounts = {
+ all: number;
+ critical: number;
+ high: number;
+ medium: number;
+ low: number;
+};
+
+export type ScannerFindingPageItem = ScannerFinding & { alertNumber: number };
+
+export type ScannerFindingPage = {
+ findings: ScannerFindingPageItem[];
+ total: number;
+ page: number;
+ pageSize: number;
+ counts: ScannerFindingCounts;
+};
+
+const SEVERITIES = new Set<ScannerFindingSeverityFilter>([
+ "all",
+ "critical",
+ "high",
+ "medium",
+ "low",
+]);
+
+export function isScannerJobId(value: string): boolean {
+ return SCANNER_JOB_ID_PATTERN.test(value);
+}
+
+export function parseScannerFindingSeverity(value: unknown): ScannerFindingSeverityFilter {
+ const severity = String(value || "all").trim().toLowerCase();
+ return SEVERITIES.has(severity as ScannerFindingSeverityFilter)
+ ? (severity as ScannerFindingSeverityFilter)
+ : "all";
+}
+
+export function scannerFindingMatchesQuery(finding: ScannerFinding, query: string): boolean {
+ if (!query) return true;
+ const haystack = [
+ finding.title,
+ finding.ruleId,
+ finding.path,
+ finding.scope,
+ finding.category,
+ finding.message,
+ finding.toolName,
+ ]
+ .filter(Boolean)
+ .join(" ")
+ .toLowerCase();
+ return haystack.includes(query);
+}
+
+function countFindings(findings: ScannerFinding[]): ScannerFindingCounts {
+ const counts: ScannerFindingCounts = { all: findings.length, critical: 0, high: 0, medium: 0, low: 0 };
+ for (const finding of findings) {
+ if (finding.severity === "critical") counts.critical += 1;
+ else if (finding.severity === "high") counts.high += 1;
+ else if (finding.severity === "medium") counts.medium += 1;
+ else counts.low += 1;
+ }
+ return counts;
+}
+
+export function pageScannerJobFindings(
+ job: Pick<ScannerJob, "findings">,
+ input: { q?: unknown; severity?: unknown; page?: unknown; limit?: unknown } = {}
+): ScannerFindingPage {
+ const query = String(input.q || "")
+ .trim()
+ .slice(0, SCANNER_FINDINGS_QUERY_MAX)
+ .toLowerCase();
+ const severity = parseScannerFindingSeverity(input.severity);
+ const pageSize = Math.min(
+ SCANNER_FINDINGS_MAX_PAGE_SIZE,
+ Math.max(1, Number(input.limit) || SCANNER_FINDINGS_PAGE_SIZE)
+ );
+ const numbered: ScannerFindingPageItem[] = (job.findings || []).map((finding, index) => ({
+ ...finding,
+ alertNumber: index + 1,
+ }));
+ const queried = numbered.filter((finding) => scannerFindingMatchesQuery(finding, query));
+ const counts = countFindings(queried);
+ const filtered =
+ severity === "all" ? queried : queried.filter((finding) => finding.severity === severity);
+ const total = filtered.length;
+ const totalPages = Math.max(1, Math.ceil(total / pageSize) || 1);
+ const page = Math.min(Math.max(1, Number(input.page) || 1), totalPages);
+ const start = (page - 1) * pageSize;
+ return {
+ findings: filtered.slice(start, start + pageSize),
+ total,
+ page,
+ pageSize,
+ counts,
+ };
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/job-repos.ts b/src/client/src/lib/platform/connectors/scanner/job-repos.ts
new file mode 100644
index 00000000..d13e7087
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/job-repos.ts
@@ -0,0 +1,55 @@
+/**
+ * Group scanner jobs by GitHub repository so the workspace can switch
+ * repo URL and per-repo scan runs independently.
+ */
+
+import { scannerRepoKey } from "./target";
+import type { ScannerJob } from "./types";
+
+export type ScannerRepoGroup = {
+ repoKey: string;
+ label: string;
+ target: string;
+ jobs: ScannerJob[];
+};
+
+export function scannerRepoDisplayLabel(repoKey: string): string {
+ return repoKey.replace(/^github\.com\//i, "");
+}
+
+export function scannerJobRepoKey(job: Pick<ScannerJob, "target">): string {
+ return scannerRepoKey(job.target) || job.target;
+}
+
+export function groupScannerJobsByRepo(
+ jobs: ScannerJob[],
+ defaultTarget?: string
+): ScannerRepoGroup[] {
+ const groups = new Map<string, ScannerRepoGroup>();
+
+ const ensure = (target: string): ScannerRepoGroup | undefined => {
+ const repoKey = scannerRepoKey(target) || target.trim();
+ if (!repoKey) return undefined;
+ const existing = groups.get(repoKey);
+ if (existing) return existing;
+ const created: ScannerRepoGroup = {
+ repoKey,
+ label: scannerRepoDisplayLabel(repoKey),
+ target,
+ jobs: [],
+ };
+ groups.set(repoKey, created);
+ return created;
+ };
+
+ for (const job of jobs) {
+ const group = ensure(job.target);
+ if (group) group.jobs.push(job);
+ }
+
+ if (defaultTarget?.trim()) {
+ ensure(defaultTarget);
+ }
+
+ return Array.from(groups.values());
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/jobs.ts b/src/client/src/lib/platform/connectors/scanner/jobs.ts
new file mode 100644
index 00000000..ca041e9b
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/jobs.ts
@@ -0,0 +1,67 @@
+import prisma from "@/lib/prisma";
+import type { ScannerJob } from "./types";
+import { summarizeJob } from "./report";
+
+const MAX_JOBS = 20;
+
+export function parseJsonObject(raw: string): Record<string, unknown> {
+ try {
+ const parsed = JSON.parse(raw || "{}");
+ if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
+ return parsed as Record<string, unknown>;
+ }
+ } catch {
+ /* keep empty */
+ }
+ return {};
+}
+
+export function jobsFromMetadata(raw: string): ScannerJob[] {
+ const metadata = parseJsonObject(raw);
+ return Array.isArray(metadata.jobs) ? (metadata.jobs as ScannerJob[]) : [];
+}
+
+export function hasRunningScannerJob(raw: string): boolean {
+ return jobsFromMetadata(raw).some((job) => job.status === "running");
+}
+
+export async function recordScannerJobs(
+ instanceId: string,
+ jobs: ScannerJob[]
+): Promise<void> {
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { id: instanceId },
+ select: { metadata: true },
+ });
+ if (!existing) return;
+ const metadata = parseJsonObject(existing.metadata || "{}");
+ await prisma.connectorInstance.update({
+ where: { id: instanceId },
+ data: {
+ metadata: JSON.stringify({
+ ...metadata,
+ category: "scanner",
+ jobs: jobs.map(summarizeJob).slice(0, MAX_JOBS),
+ }),
+ },
+ });
+}
+
+export async function prependScannerJob(
+ instanceId: string,
+ job: ScannerJob
+): Promise<ScannerJob[]> {
+ const existing = await prisma.connectorInstance.findFirst({
+ where: { id: instanceId },
+ select: { metadata: true },
+ });
+ const current = existing ? jobsFromMetadata(existing.metadata || "{}") : [];
+ const withoutStale = current.filter((item) => {
+ if (item.id === job.id) return false;
+ if (job.status !== "running" && item.status === "running") return false;
+ return true;
+ });
+ const next = [summarizeJob(job), ...withoutStale].slice(0, MAX_JOBS);
+ await recordScannerJobs(instanceId, next);
+ return next;
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/lookup.ts b/src/client/src/lib/platform/connectors/scanner/lookup.ts
new file mode 100644
index 00000000..d5ed5ed3
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/lookup.ts
@@ -0,0 +1,128 @@
+/**
+ * Join scanner jobs to a GitHub repository URL.
+ *
+ * Coding-agent spans stamp `vcs.repository.url.full`. Scanner jobs store the
+ * scan target. This module normalizes both onto `github.com/owner/repo` and
+ * returns the latest succeeded job for the current project environment.
+ */
+
+import { listScannerConnectors } from "./crud";
+import { countMediumPlus } from "./report";
+import { scannerRepoKey } from "./target";
+import type {
+ ScannerFinding,
+ ScannerJob,
+ ScannerRepoFindingsResult,
+} from "./types";
+
+export const SCANNER_FINDINGS_LIMIT = 25;
+
+const SEVERITY_RANK: Record<string, number> = {
+ critical: 0,
+ high: 1,
+ error: 1,
+ medium: 2,
+ low: 3,
+ info: 4,
+ meta: 5,
+};
+
+type ScannerLookupConnector = {
+ id: string;
+ name: string;
+ jobs?: ScannerJob[];
+};
+
+export function scannerWorkspaceUrl(
+ connectorId?: string,
+ jobId?: string
+): string {
+ const params = new URLSearchParams();
+ if (connectorId) params.set("connectorId", connectorId);
+ if (jobId) params.set("jobId", jobId);
+ const query = params.toString();
+ return query ? `/scanner?${query}` : "/scanner";
+}
+
+function rankFinding(finding: ScannerFinding): number {
+ return SEVERITY_RANK[finding.severity] ?? 9;
+}
+
+function prioritizeFindings(
+ findings: ScannerFinding[],
+ limit: number
+): ScannerFinding[] {
+ return [...findings]
+ .sort((left, right) => rankFinding(left) - rankFinding(right))
+ .slice(0, limit);
+}
+
+export function matchScannerFindingsForRepo(
+ connectors: ScannerLookupConnector[],
+ repoUrl: unknown,
+ limit: number = SCANNER_FINDINGS_LIMIT
+): ScannerRepoFindingsResult {
+ const repoKey = scannerRepoKey(repoUrl);
+ if (!repoKey) {
+ return { matched: false, repoKey: null, url: scannerWorkspaceUrl() };
+ }
+
+ let best:
+ | {
+ connector: ScannerLookupConnector;
+ job: ScannerJob;
+ scannedAt: string;
+ }
+ | undefined;
+
+ for (const connector of connectors) {
+ for (const job of connector.jobs || []) {
+ if (job.status !== "succeeded") continue;
+ if (scannerRepoKey(job.target) !== repoKey) continue;
+ const scannedAt = job.finishedAt || job.startedAt;
+ if (!scannedAt) continue;
+ if (!best || scannedAt > best.scannedAt) {
+ best = { connector, job, scannedAt };
+ }
+ }
+ }
+
+ if (!best) {
+ return { matched: false, repoKey, url: scannerWorkspaceUrl() };
+ }
+
+ const findings = prioritizeFindings(best.job.findings || [], limit);
+ const findingCount = best.job.findingCount ?? (best.job.findings || []).length;
+ const mediumPlusCount =
+ typeof best.job.mediumPlusCount === "number"
+ ? best.job.mediumPlusCount
+ : countMediumPlus(best.job.findings || []);
+
+ return {
+ matched: true,
+ repoKey,
+ connectorId: best.connector.id,
+ connectorName: best.connector.name,
+ jobId: best.job.id,
+ target: best.job.target,
+ ref: best.job.ref,
+ scannedAt: best.scannedAt,
+ findingCount,
+ mediumPlusCount,
+ findings,
+ url: scannerWorkspaceUrl(best.connector.id, best.job.id),
+ };
+}
+
+export async function lookupLatestScannerFindingsForRepo(input: {
+ repoUrl: unknown;
+ environment?: string;
+ limit?: number;
+}): Promise<ScannerRepoFindingsResult> {
+ const connectors = await listScannerConnectors(input.environment);
+ return matchScannerFindingsForRepo(
+ connectors,
+ input.repoUrl,
+ input.limit ?? SCANNER_FINDINGS_LIMIT
+ );
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/process.ts b/src/client/src/lib/platform/connectors/scanner/process.ts
new file mode 100644
index 00000000..e4495fa8
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/process.ts
@@ -0,0 +1,144 @@
+import { execFile } from "node:child_process";
+import { basename, dirname, isAbsolute, join, resolve, sep, delimiter } from "node:path";
+import { SCANNER_PROCESS_REJECTED } from "@/constants/messages/en";
+
+export interface ScannerCommandResult {
+ exitCode: number;
+ stdout: string;
+ stderr: string;
+}
+
+export interface ScannerProcessRunInput {
+ bin: string;
+ argv: string[];
+ env: NodeJS.ProcessEnv;
+ timeoutMs: number;
+ cwd?: string;
+}
+
+export interface ScannerProcessRunner {
+ run(input: ScannerProcessRunInput): Promise<ScannerCommandResult>;
+}
+
+const DEFAULT_MAX_BUFFER = 20 * 1024 * 1024;
+const TRUSTABL_BIN_NAMES = new Set(["trustabl", "trustabl.exe"]);
+const SAFE_FLAG = /^--[a-z][a-z0-9-]{0,62}$/;
+const SAFE_TOKEN = /^[A-Za-z0-9._/~+,=-]{1,200}$/;
+const SAFE_HTTPS = /^https:\/\/[A-Za-z0-9.-]+\/[A-Za-z0-9._/~+=%-]+$/;
+
+function neutralizeScannerToken(token: string): string {
+ return String(token).replace(/[^A-Za-z0-9._:/=@+~,%-]/g, "");
+}
+
+export function sanitizeScannerBinary(bin: string): string {
+ const trimmed = String(bin || "").trim();
+ if (neutralizeScannerToken(trimmed) !== trimmed || !trimmed || trimmed.includes("..")) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ const name = basename(trimmed);
+ if (!TRUSTABL_BIN_NAMES.has(name)) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ if (trimmed === name) return name;
+ if (!isAbsolute(trimmed)) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ return join(dirname(resolve(trimmed)), name);
+}
+
+export function sanitizeScannerArgvToken(token: string): string {
+ const raw = String(token);
+ const value = neutralizeScannerToken(raw);
+ if (value !== raw || !value || value.length > 500) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ if (value.startsWith("--")) {
+ if (!SAFE_FLAG.test(value)) throw new Error(SCANNER_PROCESS_REJECTED);
+ return value;
+ }
+ if (SAFE_TOKEN.test(value) || SAFE_HTTPS.test(value)) return value;
+ throw new Error(SCANNER_PROCESS_REJECTED);
+}
+
+export function sanitizeScannerArgv(argv: string[]): string[] {
+ if (!Array.isArray(argv) || argv.length > 64) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ return argv.map(sanitizeScannerArgvToken);
+}
+
+function sanitizeScannerCwd(cwd?: string): string | undefined {
+ if (cwd == null || cwd === "") return undefined;
+ const resolved = resolve(cwd);
+ if (!isAbsolute(resolved) || resolved.includes(`..${sep}`)) {
+ throw new Error(SCANNER_PROCESS_REJECTED);
+ }
+ return resolved;
+}
+
+function trustablCommandName(): "trustabl" | "trustabl.exe" {
+ return process.platform === "win32" ? "trustabl.exe" : "trustabl";
+}
+
+export const defaultScannerProcessRunner: ScannerProcessRunner = {
+ run(input) {
+ const command = trustablCommandName();
+ const argv = sanitizeScannerArgv(input.argv);
+ const cwd = sanitizeScannerCwd(input.cwd);
+ const safeBin = sanitizeScannerBinary(input.bin);
+ const pathPrefix = safeBin === command ? "" : dirname(safeBin);
+ const env: NodeJS.ProcessEnv = {
+ ...input.env,
+ PATH: pathPrefix
+ ? `${pathPrefix}${delimiter}${input.env.PATH || process.env.PATH || ""}`
+ : input.env.PATH,
+ };
+ return new Promise((resolvePromise, reject) => {
+ // codeql[js/command-line-injection]: executable is a fixed Trustabl name; argv is neutralized
+ execFile(
+ command,
+ argv,
+ {
+ cwd,
+ env,
+ timeout: input.timeoutMs,
+ maxBuffer: DEFAULT_MAX_BUFFER,
+ windowsHide: true,
+ shell: false,
+ },
+ (error, stdout, stderr) => {
+ const out = String(stdout || "");
+ const err = String(stderr || "");
+ if (!error) {
+ resolvePromise({ exitCode: 0, stdout: out, stderr: err });
+ return;
+ }
+ const code =
+ typeof (error as NodeJS.ErrnoException & { code?: string | number }).code ===
+ "number"
+ ? Number((error as { code: number }).code)
+ : (error as { status?: number }).status;
+ if (typeof code === "number") {
+ resolvePromise({ exitCode: code, stdout: out, stderr: err });
+ return;
+ }
+ reject(error);
+ }
+ );
+ });
+ },
+};
+
+let processRunner: ScannerProcessRunner = defaultScannerProcessRunner;
+
+export function getScannerProcessRunner(): ScannerProcessRunner {
+ return processRunner;
+}
+
+export function setScannerProcessRunnerForTests(runner: ScannerProcessRunner): void {
+ processRunner = runner;
+}
+
+export function __resetScannerProcessRunnerForTests(): void {
+ processRunner = defaultScannerProcessRunner;
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/registry.ts b/src/client/src/lib/platform/connectors/scanner/registry.ts
new file mode 100644
index 00000000..6e41f331
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/registry.ts
@@ -0,0 +1,76 @@
+/**
+ * Scanner connector adapter registry (CE).
+ *
+ * Holds adapter factories keyed by connector type. `bootstrap.ts` registers
+ * Trustabl. Extra private factories can still be contributed through the
+ * neutral `getExternalScannerAdapters()` hook without an `@/ee/**` import.
+ */
+
+import { getExternalScannerAdapters } from "./enterprise";
+import type {
+ ScannerAdapter,
+ ScannerAdapterFactory,
+ ScannerSourceDescriptor,
+ ScannerTypeDescriptor,
+} from "./types";
+
+const factories = new Map<string, ScannerAdapterFactory>();
+let externalLoaded = false;
+
+export function registerScannerAdapterFactory(factory: ScannerAdapterFactory): void {
+ factories.set(factory.type, factory);
+}
+
+function ensureExternalLoaded(): void {
+ if (externalLoaded) return;
+ externalLoaded = true;
+ for (const factory of getExternalScannerAdapters()) {
+ if (!factories.has(factory.type)) {
+ factories.set(factory.type, factory);
+ }
+ }
+}
+
+export function hasScannerAdapterFactory(type: string): boolean {
+ ensureExternalLoaded();
+ return factories.has(type);
+}
+
+export function getScannerAdapterFactory(
+ type: string
+): ScannerAdapterFactory | undefined {
+ ensureExternalLoaded();
+ return factories.get(type);
+}
+
+export function getScannerTypeDescriptor(
+ type: string
+): ScannerTypeDescriptor | undefined {
+ ensureExternalLoaded();
+ return factories.get(type)?.describe();
+}
+
+export function listScannerTypeDescriptors(
+ _opts: { includeInternal?: boolean } = {}
+): ScannerTypeDescriptor[] {
+ ensureExternalLoaded();
+ const out: ScannerTypeDescriptor[] = [];
+ for (const factory of Array.from(factories.values())) {
+ const descriptor = factory.describe();
+ if (descriptor.internal) continue;
+ out.push(descriptor);
+ }
+ return out;
+}
+
+export function createScannerAdapter(
+ descriptor: ScannerSourceDescriptor
+): ScannerAdapter | undefined {
+ const factory = getScannerAdapterFactory(descriptor.type);
+ return factory?.create(descriptor);
+}
+
+export function __resetScannerRegistryForTests(): void {
+ factories.clear();
+ externalLoaded = false;
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/release.ts b/src/client/src/lib/platform/connectors/scanner/release.ts
new file mode 100644
index 00000000..74a197fc
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/release.ts
@@ -0,0 +1,46 @@
+export function normalizeScannerVersion(raw?: string): string {
+ const match = String(raw || "").match(/v?(\d+\.\d+\.\d+)/i);
+ return match ? match[1] : "";
+}
+
+export function compareScannerVersions(left?: string, right?: string): number {
+ const a = normalizeScannerVersion(left).split(".").map((part) => Number(part) || 0);
+ const b = normalizeScannerVersion(right).split(".").map((part) => Number(part) || 0);
+ for (let i = 0; i < 3; i += 1) {
+ if (a[i] !== b[i]) return a[i] - b[i];
+ }
+ return 0;
+}
+
+export function trustablAssetName(
+ version: string,
+ platform = process.platform,
+ arch = process.arch
+): string {
+ const semver = normalizeScannerVersion(version);
+ const os =
+ platform === "win32" ? "windows" : platform === "darwin" ? "darwin" : platform === "linux" ? "linux" : "";
+ const cpu = arch === "arm64" ? "arm64" : arch === "x64" ? "amd64" : "";
+ if (!semver || !os || !cpu) return "";
+ const ext = os === "windows" ? "zip" : "tar.gz";
+ return `trustabl_${semver}_${os}_${cpu}.${ext}`;
+}
+
+export function parseChecksumFile(text: string): Map<string, string> {
+ const checksums = new Map<string, string>();
+ for (const line of String(text || "").split(/\r?\n/)) {
+ const match = line.trim().match(/^([a-fA-F0-9]{64})\s+(\S+)$/);
+ if (match) checksums.set(match[2], match[1].toLowerCase());
+ }
+ return checksums;
+}
+
+export function trustablReleaseDownloadUrl(tag: string, fileName: string): string {
+ const version = normalizeScannerVersion(tag);
+ const safeTag = version ? `v${version}` : "";
+ const safeFile = String(fileName || "").replace(/[^A-Za-z0-9._-]/g, "");
+ return `https://github.com/trustabl/trustabl/releases/download/${safeTag}/${safeFile}`;
+}
+
+export const TRUSTABL_LATEST_RELEASE_URL =
+ "https://api.github.com/repos/trustabl/trustabl/releases/latest";
diff --git a/src/client/src/lib/platform/connectors/scanner/report.ts b/src/client/src/lib/platform/connectors/scanner/report.ts
new file mode 100644
index 00000000..af09817c
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/report.ts
@@ -0,0 +1,315 @@
+import { randomUUID } from "crypto";
+import type { ScannerFinding, ScannerJob, ScannerReportSummary } from "./types";
+
+const MAX_FINDINGS = 200;
+const MAX_TEXT = 2_000;
+const MAX_LIST = 16;
+
+const MEDIUM_PLUS = new Set(["medium", "high", "critical", "error"]);
+
+function asRecord(value: unknown): Record<string, unknown> | null {
+ if (!value || typeof value !== "object" || Array.isArray(value)) return null;
+ return value as Record<string, unknown>;
+}
+
+function clip(value: unknown): string {
+ return String(value ?? "").trim().slice(0, MAX_TEXT);
+}
+
+function stringList(value: unknown): string[] | undefined {
+ if (!Array.isArray(value)) return undefined;
+ const items = value
+ .map((item) => (typeof item === "string" ? clip(item) : clip(asRecord(item)?.name)))
+ .filter(Boolean)
+ .slice(0, MAX_LIST);
+ return items.length ? items : undefined;
+}
+
+function countArray(value: unknown): number | undefined {
+ return Array.isArray(value) ? value.length : undefined;
+}
+
+function findingId(row: Record<string, unknown>, index: number): string {
+ return clip(row.id || row.finding_id) || `finding-${index + 1}`;
+}
+
+function confidenceText(value: unknown): string | undefined {
+ if (typeof value === "number" && Number.isFinite(value)) {
+ return value <= 1 ? value.toFixed(2) : String(value);
+ }
+ return clip(value) || undefined;
+}
+
+function extraFields(
+ row: Record<string, unknown>,
+ consumed: Set<string>
+): Record<string, string> | undefined {
+ const extras: Record<string, string> = {};
+ let count = 0;
+ for (const [key, value] of Object.entries(row)) {
+ if (consumed.has(key) || count >= 24) continue;
+ const rendered = renderExtra(value);
+ if (!rendered) continue;
+ extras[key] = rendered;
+ count += 1;
+ }
+ return count ? extras : undefined;
+}
+
+function renderExtra(value: unknown): string | undefined {
+ if (value == null) return undefined;
+ if (typeof value === "boolean" || typeof value === "number") return String(value).slice(0, 200);
+ if (typeof value === "string") return clip(value).slice(0, 200) || undefined;
+ if (Array.isArray(value)) {
+ if (!value.length) return undefined;
+ if (value.every((item) => typeof item === "string" || typeof item === "number")) {
+ return value
+ .slice(0, 8)
+ .map((item) => clip(item).slice(0, 80))
+ .filter(Boolean)
+ .join(", ");
+ }
+ return String(value.length);
+ }
+ const rec = asRecord(value);
+ if (rec && (typeof rec.name === "string" || typeof rec.id === "string")) {
+ return clip(rec.name || rec.id).slice(0, 200) || undefined;
+ }
+ return undefined;
+}
+
+const FINDING_CONSUMED = new Set([
+ "id",
+ "finding_id",
+ "rule_id",
+ "ruleId",
+ "rule",
+ "check_id",
+ "title",
+ "summary",
+ "message",
+ "explanation",
+ "description",
+ "severity",
+ "level",
+ "category",
+ "detector",
+ "kind",
+ "scope",
+ "tool_name",
+ "toolName",
+ "file_path",
+ "path",
+ "file",
+ "filename",
+ "start_line",
+ "line",
+ "end_line",
+ "location",
+ "region",
+ "help_url",
+ "helpUrl",
+ "docs_url",
+ "suggested_fix",
+ "fix",
+ "remediation",
+ "confidence",
+ "score",
+]);
+
+function normalizeFinding(value: unknown, index: number): ScannerFinding | null {
+ const row = asRecord(value);
+ if (!row) return null;
+ const ruleId = clip(row.rule_id || row.ruleId || row.rule || row.check_id);
+ const title = clip(row.title || row.summary || row.message || ruleId);
+ if (!ruleId && !title) return null;
+ const location = asRecord(row.location) || asRecord(row.region) || {};
+ const path = clip(
+ row.file_path ||
+ row.path ||
+ row.file ||
+ row.filename ||
+ location.path ||
+ location.uri ||
+ location.file
+ );
+ const lineRaw =
+ row.start_line ?? row.line ?? location.start_line ?? location.line ?? location.startLine;
+ const endRaw = row.end_line ?? location.end_line ?? location.endLine;
+ const line = typeof lineRaw === "number" ? lineRaw : Number.parseInt(String(lineRaw || ""), 10);
+ const endLine = typeof endRaw === "number" ? endRaw : Number.parseInt(String(endRaw || ""), 10);
+ const extras = extraFields(row, FINDING_CONSUMED);
+ return {
+ id: findingId(row, index),
+ ruleId: ruleId || `UNKNOWN-${index + 1}`,
+ severity: clip(row.severity || row.level || "info").toLowerCase() || "info",
+ category: clip(row.category || row.detector || row.kind) || undefined,
+ scope: clip(row.scope) || undefined,
+ toolName: clip(row.tool_name || row.toolName) || undefined,
+ path: path || undefined,
+ line: Number.isFinite(line) && line > 0 ? line : undefined,
+ endLine: Number.isFinite(endLine) && endLine > 0 ? endLine : undefined,
+ title: title || ruleId,
+ message: clip(row.message || row.explanation || row.description) || undefined,
+ helpUrl: clip(row.help_url || row.helpUrl || row.docs_url) || undefined,
+ fix: clip(row.suggested_fix || row.fix || row.remediation) || undefined,
+ confidence: confidenceText(row.confidence ?? row.score),
+ extras,
+ };
+}
+
+function findingsFromUnknown(value: unknown): unknown[] {
+ if (Array.isArray(value)) return value;
+ const row = asRecord(value);
+ if (!row) return [];
+ if (Array.isArray(row.findings)) return row.findings;
+ if (Array.isArray(row.results)) return row.results;
+ const run = Array.isArray(row.runs) ? asRecord(row.runs[0]) : null;
+ if (run && Array.isArray(run.results)) return run.results;
+ return [];
+}
+
+function originLabel(row: Record<string, unknown>): string | undefined {
+ const origin = asRecord(row.rules_origin);
+ if (!origin) return clip(row.rules_origin) || undefined;
+ if (origin.signed === true) {
+ const channel = clip(origin.channel) || "unknown";
+ return origin.custom === true ? `signed:${channel}:custom` : `signed:${channel}`;
+ }
+ if (origin.custom === true) return "unsigned:custom";
+ if (origin.signed === false) return "unsigned:default";
+ return undefined;
+}
+
+function parseReportSummary(value: unknown): ScannerReportSummary | undefined {
+ const row = asRecord(value);
+ if (!row) return undefined;
+ const coverage = asRecord(row.coverage) || {};
+ const scoreRaw = row.overall_score ?? row.overallScore;
+ const overallScore =
+ typeof scoreRaw === "number" && Number.isFinite(scoreRaw) ? scoreRaw : undefined;
+ const summary: ScannerReportSummary = {
+ scanId: clip(row.scan_id || row.scanId) || undefined,
+ repo: clip(row.repo) || undefined,
+ overallScore,
+ rulesSource: clip(row.rules_source || row.rulesSource) || undefined,
+ rulesVersion: clip(row.rules_version || row.rulesVersion).slice(0, 64) || undefined,
+ rulesFromCache: row.rules_from_cache === true || row.rulesFromCache === true || undefined,
+ rulesStale: row.rules_stale === true || row.rulesStale === true || undefined,
+ rulesOrigin: originLabel(row),
+ languages: stringList(row.languages),
+ sdks: stringList(row.sdks || row.sdks_detected),
+ toolCount: countArray(row.tools),
+ agentCount: countArray(row.agents),
+ mcpCount: countArray(row.mcp_servers || row.mcpServers),
+ skillCount: countArray(row.skills),
+ subagentCount: countArray(row.subagents),
+ vulnerabilityCount: countArray(row.vulnerabilities),
+ secretCount: countArray(row.secrets),
+ filesParsed:
+ typeof coverage.files_parsed === "number" ? coverage.files_parsed : undefined,
+ filesSkipped:
+ typeof coverage.files_skipped === "number" ? coverage.files_skipped : undefined,
+ noAgentSurfaces: row.no_agent_surfaces === true || undefined,
+ };
+ const consumed = new Set([
+ "findings",
+ "results",
+ "runs",
+ "coverage",
+ "scan_id",
+ "scanId",
+ "repo",
+ "overall_score",
+ "overallScore",
+ "rules_source",
+ "rulesSource",
+ "rules_version",
+ "rulesVersion",
+ "rules_from_cache",
+ "rulesFromCache",
+ "rules_stale",
+ "rulesStale",
+ "rules_origin",
+ "languages",
+ "sdks",
+ "sdks_detected",
+ "tools",
+ "agents",
+ "mcp_servers",
+ "mcpServers",
+ "skills",
+ "subagents",
+ "vulnerabilities",
+ "secrets",
+ "no_agent_surfaces",
+ ]);
+ const extras = extraFields(row, consumed);
+ if (extras) summary.extras = extras;
+ return Object.values(summary).some((item) => item !== undefined) ? summary : undefined;
+}
+
+export function parseScannerReport(stdout: string): {
+ findings: ScannerFinding[];
+ mediumPlusCount: number;
+ report?: ScannerReportSummary;
+} {
+ const trimmed = stdout.trim();
+ if (!trimmed) return { findings: [], mediumPlusCount: 0 };
+ let parsed: unknown;
+ try {
+ parsed = JSON.parse(trimmed);
+ } catch {
+ const start = trimmed.indexOf("{");
+ const end = trimmed.lastIndexOf("}");
+ if (start < 0 || end <= start) return { findings: [], mediumPlusCount: 0 };
+ try {
+ parsed = JSON.parse(trimmed.slice(start, end + 1));
+ } catch {
+ return { findings: [], mediumPlusCount: 0 };
+ }
+ }
+ const findings = findingsFromUnknown(parsed)
+ .map(normalizeFinding)
+ .filter((item): item is ScannerFinding => !!item)
+ .slice(0, MAX_FINDINGS);
+ const mediumPlusCount = findings.filter((item) => MEDIUM_PLUS.has(item.severity)).length;
+ return { findings, mediumPlusCount, report: parseReportSummary(parsed) };
+}
+
+export function newScannerJobId(): string {
+ return `job:${randomUUID()}`;
+}
+
+export function countMediumPlus(findings: ScannerFinding[]): number {
+ return findings.filter((item) => MEDIUM_PLUS.has(item.severity)).length;
+}
+
+import { SCANNER_REPO_NOT_FOUND } from "@/constants/messages/en";
+
+export function redactScannerText(value: string): string {
+ return value
+ .replace(/ghp_[A-Za-z0-9_]{20,}/g, "[redacted]")
+ .replace(/github_pat_[A-Za-z0-9_]{20,}/g, "[redacted]")
+ .replace(/xox[baprs]-[A-Za-z0-9-]{10,}/g, "[redacted]");
+}
+
+export function formatScannerError(value: string): string {
+ const cleaned = redactScannerText(value)
+ .replace(/^\s*Error:\s*/i, "")
+ .split("\n")
+ .map((line) => line.trim())
+ .find(Boolean);
+ if (!cleaned) return value.trim();
+ if (/repository not found/i.test(cleaned) || /ingest:\s*clone/i.test(cleaned)) {
+ return SCANNER_REPO_NOT_FOUND;
+ }
+ return cleaned.slice(0, 500);
+}
+
+export function summarizeJob(job: ScannerJob): ScannerJob {
+ return {
+ ...job,
+ findings: job.findings?.slice(0, MAX_FINDINGS),
+ };
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/runtime.ts b/src/client/src/lib/platform/connectors/scanner/runtime.ts
new file mode 100644
index 00000000..b96f23e2
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/runtime.ts
@@ -0,0 +1,186 @@
+import { access, readdir } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { SCANNER_RUNTIME_VERSION_FAILED } from "@/constants/messages/en";
+import { scannerCliSchemaFromHelp, type ScannerCliSchema } from "./cli-schema";
+import { getScannerProcessRunner } from "./process";
+import { compareScannerVersions, normalizeScannerVersion } from "./release";
+import type { ScannerRuntimeInfo } from "./types";
+
+export const TRUSTABL_FALLBACK_VERSION = "v0.1.8";
+/** @deprecated Use TRUSTABL_FALLBACK_VERSION. Kept for adapter tests and descriptors. */
+export const TRUSTABL_PINNED_VERSION = TRUSTABL_FALLBACK_VERSION;
+const VERSION_TIMEOUT_MS = 20_000;
+const HELP_TIMEOUT_MS = 15_000;
+const schemaCache = new Map<string, ScannerCliSchema>();
+
+function cacheRoot(): string {
+ return (
+ process.env.OPENLIT_RUNTIME_CACHE ||
+ process.env.XDG_CACHE_HOME ||
+ join(homedir(), ".cache")
+ );
+}
+
+export function trustablCacheDir(): string {
+ return join(cacheRoot(), "openlit", "runtimes", "trustabl");
+}
+
+export function trustablCacheBinary(version = TRUSTABL_FALLBACK_VERSION): string {
+ const file = process.platform === "win32" ? "trustabl.exe" : "trustabl";
+ const tag = String(version).startsWith("v") ? version : `v${normalizeScannerVersion(version)}`;
+ return join(trustablCacheDir(), tag, file);
+}
+
+async function isExecutable(path: string): Promise<boolean> {
+ try {
+ await access(path);
+ return true;
+ } catch {
+ return false;
+ }
+}
+
+async function cachedBinaries(): Promise<{ version: string; bin: string }[]> {
+ try {
+ const versions = await readdir(trustablCacheDir());
+ const found: { version: string; bin: string }[] = [];
+ for (const version of versions) {
+ const bin = trustablCacheBinary(version);
+ if (await isExecutable(bin)) found.push({ version, bin });
+ }
+ return found.sort((left, right) => compareScannerVersions(right.version, left.version));
+ } catch {
+ return [];
+ }
+}
+
+export async function resolveTrustablBinary(
+ version?: string
+): Promise<{ bin: string; source: NonNullable<ScannerRuntimeInfo["source"]>; binaryVersion?: string } | null> {
+ if (version) {
+ const pinned = trustablCacheBinary(version);
+ if (await isExecutable(pinned)) {
+ return { bin: pinned, source: "cache", binaryVersion: version };
+ }
+ }
+ const cached = await cachedBinaries();
+ if (cached[0]) {
+ return { bin: cached[0].bin, source: "cache", binaryVersion: cached[0].version };
+ }
+ const fromEnv = String(process.env.TRUSTABL_BIN || "").trim();
+ if (fromEnv && (await isExecutable(fromEnv))) {
+ return { bin: fromEnv, source: "env" };
+ }
+ const fromPath = process.platform === "win32" ? "trustabl.exe" : "trustabl";
+ return { bin: fromPath, source: "path" };
+}
+
+export function __resetScannerCliSchemaCacheForTests(): void {
+ schemaCache.clear();
+}
+
+async function describeScanSchema(bin: string, version?: string | null): Promise<ScannerCliSchema | undefined> {
+ const cacheKey = `${bin}::${version || "unknown"}`;
+ const cached = schemaCache.get(cacheKey);
+ if (cached) return cached;
+ try {
+ const result = await getScannerProcessRunner().run({
+ bin,
+ argv: ["scan", "--help"],
+ env: process.env,
+ timeoutMs: HELP_TIMEOUT_MS,
+ });
+ let text = `${result.stdout || ""}\n${result.stderr || ""}`;
+ let schema = scannerCliSchemaFromHelp(text, version || undefined);
+ if (!schema.flags.length) {
+ const fallback = await getScannerProcessRunner().run({
+ bin,
+ argv: ["help", "scan"],
+ env: process.env,
+ timeoutMs: HELP_TIMEOUT_MS,
+ });
+ text = `${fallback.stdout || ""}\n${fallback.stderr || ""}`;
+ schema = scannerCliSchemaFromHelp(text, version || undefined);
+ }
+ if (!schema.flags.length) return undefined;
+ schemaCache.set(cacheKey, schema);
+ return schema;
+ } catch {
+ return undefined;
+ }
+}
+
+async function reportedVersion(bin: string): Promise<string | null> {
+ try {
+ const result = await getScannerProcessRunner().run({
+ bin,
+ argv: ["version"],
+ env: process.env,
+ timeoutMs: VERSION_TIMEOUT_MS,
+ });
+ if (result.exitCode !== 0) return null;
+ return result.stdout.trim().split("\n")[0]?.trim() || null;
+ } catch {
+ return null;
+ }
+}
+
+export async function probeTrustablRuntime(latestTag?: string): Promise<ScannerRuntimeInfo> {
+ const latestVersion = latestTag ? `v${normalizeScannerVersion(latestTag)}` : undefined;
+ const resolved = await resolveTrustablBinary(latestVersion);
+ if (!resolved) {
+ return { installed: false, latestVersion, upgradeAvailable: Boolean(latestVersion) };
+ }
+ const reported = await reportedVersion(resolved.bin);
+ if (!reported) {
+ if (resolved.source === "path") {
+ return { installed: false, latestVersion, upgradeAvailable: Boolean(latestVersion) };
+ }
+ return {
+ installed: false,
+ source: resolved.source,
+ binaryVersion: resolved.binaryVersion,
+ latestVersion,
+ upgradeAvailable: Boolean(latestVersion),
+ };
+ }
+ const installedVersion = normalizeScannerVersion(reported);
+ const latest = normalizeScannerVersion(latestVersion);
+ const schema = await describeScanSchema(
+ resolved.bin,
+ resolved.binaryVersion || (installedVersion ? `v${installedVersion}` : reported)
+ );
+ return {
+ installed: true,
+ version: reported,
+ source: resolved.source,
+ binaryVersion: resolved.binaryVersion || (installedVersion ? `v${installedVersion}` : undefined),
+ latestVersion,
+ upgradeAvailable: Boolean(latest) && compareScannerVersions(installedVersion, latest) < 0,
+ schema,
+ };
+}
+
+export function scannerCliVersionLabel(
+ runtime: Pick<ScannerRuntimeInfo, "version" | "binaryVersion">
+): string | undefined {
+ const fromBinary = normalizeScannerVersion(runtime.binaryVersion);
+ if (fromBinary) return `v${fromBinary}`;
+ const fromReported = normalizeScannerVersion(runtime.version);
+ if (fromReported) return `v${fromReported}`;
+ const raw = String(runtime.version || "").trim();
+ return raw || undefined;
+}
+
+export async function runTrustablVersion(version?: string): Promise<ScannerRuntimeInfo> {
+ const runtime = await probeTrustablRuntime(version);
+ if (!runtime.installed) {
+ throw new Error(SCANNER_RUNTIME_VERSION_FAILED);
+ }
+ return runtime;
+}
+
+export async function ensureTrustablRuntime(version?: string): Promise<ScannerRuntimeInfo> {
+ return probeTrustablRuntime(version);
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/scan-params.ts b/src/client/src/lib/platform/connectors/scanner/scan-params.ts
new file mode 100644
index 00000000..b7bce6f6
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/scan-params.ts
@@ -0,0 +1,195 @@
+/**
+ * Resolve Trustabl `scan` flags: per-run overrides, then connector defaults.
+ * File-output and attest flags stay out of the in-app job.
+ */
+
+import type { ScannerScanInput, ScannerScanParams } from "./types";
+import type { ScannerCliSchema } from "./cli-schema";
+import {
+ BLOCKED_SCAN_FLAGS,
+ flagFromKey,
+ isScannerExtraSettingKey,
+ KNOWN_SCAN_PARAM_KEYS,
+ schemaAllowsFlag,
+} from "./cli-schema";
+import {
+ normalizeScannerDetectors,
+ normalizeScannerRef,
+ normalizeScannerRulesRepo,
+ normalizeScannerRulesSource,
+} from "./target";
+
+export function settingFlag(settings: Record<string, unknown>, key: string): boolean {
+ return settings[key] === true || settings[key] === "true";
+}
+
+export function rulesSourceForEnvironment(environment?: string): string {
+ const env = String(environment || "production").trim().toLowerCase();
+ if (env === "staging") return "staging";
+ if (env === "development" || env === "dev") return "git";
+ return "production";
+}
+
+function optionalBoolean(value: unknown): boolean | undefined {
+ if (value === undefined || value === null || value === "") return undefined;
+ if (typeof value === "boolean") return value;
+ if (value === "true") return true;
+ if (value === "false") return false;
+ return undefined;
+}
+
+function optionalString(value: unknown): string | undefined {
+ if (typeof value !== "string") return undefined;
+ const trimmed = value.trim();
+ return trimmed ? trimmed.slice(0, 500) : undefined;
+}
+
+function sanitizeExtraValue(value: unknown): string | boolean | undefined {
+ const flag = optionalBoolean(value);
+ if (flag !== undefined) return flag;
+ const text = optionalString(value);
+ if (!text) return undefined;
+ if (/[\r\n\0]/.test(text) || text.startsWith("-")) return undefined;
+ return text;
+}
+
+function collectExtras(
+ input: Record<string, unknown>,
+ settings: Record<string, unknown>
+): Record<string, string | boolean> | undefined {
+ const extras: Record<string, string | boolean> = {};
+ const nested =
+ input.extras && typeof input.extras === "object" && !Array.isArray(input.extras)
+ ? (input.extras as Record<string, unknown>)
+ : {};
+ for (const source of [settings, input, nested]) {
+ for (const [key, value] of Object.entries(source)) {
+ if (key === "extras") continue;
+ if (!isScannerExtraSettingKey(key)) continue;
+ const next = sanitizeExtraValue(value);
+ if (next === undefined) continue;
+ extras[key] = next;
+ }
+ }
+ return Object.keys(extras).length ? extras : undefined;
+}
+
+export function parseScannerScanInput(body: Record<string, unknown>): ScannerScanInput {
+ const extras = collectExtras(body, {});
+ return {
+ target: optionalString(body.target),
+ ref: optionalString(body.ref),
+ detectors: optionalString(body.detectors),
+ strict: optionalBoolean(body.strict),
+ secretScan: optionalBoolean(body.secretScan),
+ vulnScan: optionalBoolean(body.vulnScan),
+ licenseScan: optionalBoolean(body.licenseScan),
+ requireSigned: optionalBoolean(body.requireSigned),
+ rulesRepo: optionalString(body.rulesRepo),
+ rulesRef: optionalString(body.rulesRef),
+ rulesSource: optionalString(body.rulesSource),
+ noRulesUpdate: optionalBoolean(body.noRulesUpdate),
+ verbose: optionalBoolean(body.verbose),
+ ...(extras ? { extras } : {}),
+ };
+}
+
+function resolveBoolean(
+ input: boolean | undefined,
+ settings: Record<string, unknown>,
+ key: string,
+ fallback = false
+): boolean {
+ if (typeof input === "boolean") return input;
+ if (settings[key] === true || settings[key] === "true") return true;
+ if (settings[key] === false || settings[key] === "false") return false;
+ return fallback;
+}
+
+export function resolveScannerScanParams(
+ input: ScannerScanInput,
+ settings: Record<string, unknown>,
+ environment?: string
+): ScannerScanParams {
+ const detectors = normalizeScannerDetectors(
+ input.detectors !== undefined ? input.detectors : settings.detectors
+ );
+ const rulesRepo = normalizeScannerRulesRepo(
+ input.rulesRepo !== undefined ? input.rulesRepo : settings.rulesRepo
+ );
+ const rulesRef = normalizeScannerRef(
+ input.rulesRef !== undefined ? input.rulesRef : settings.rulesRef
+ );
+ const explicitSource =
+ input.rulesSource !== undefined ? input.rulesSource : settings.rulesSource;
+ const rulesSource =
+ normalizeScannerRulesSource(explicitSource) || rulesSourceForEnvironment(environment);
+ return {
+ detectors,
+ strict: resolveBoolean(input.strict, settings, "strict"),
+ secretScan: resolveBoolean(input.secretScan, settings, "secretScan"),
+ vulnScan: resolveBoolean(input.vulnScan, settings, "vulnScan"),
+ licenseScan: resolveBoolean(input.licenseScan, settings, "licenseScan"),
+ requireSigned: resolveBoolean(input.requireSigned, settings, "requireSigned", true),
+ rulesRepo,
+ rulesRef,
+ rulesSource,
+ noRulesUpdate: resolveBoolean(input.noRulesUpdate, settings, "noRulesUpdate"),
+ verbose: resolveBoolean(input.verbose, settings, "verbose"),
+ extras: collectExtras(input as Record<string, unknown>, settings),
+ };
+}
+
+export function compactScannerScanParams(params: ScannerScanParams): ScannerScanParams {
+ const next: ScannerScanParams = {};
+ if (params.detectors) next.detectors = params.detectors;
+ if (params.strict) next.strict = true;
+ if (params.secretScan) next.secretScan = true;
+ if (params.vulnScan) next.vulnScan = true;
+ if (params.licenseScan) next.licenseScan = true;
+ if (params.requireSigned === false) next.requireSigned = false;
+ else if (params.requireSigned) next.requireSigned = true;
+ if (params.rulesRepo) next.rulesRepo = params.rulesRepo;
+ if (params.rulesRef) next.rulesRef = params.rulesRef;
+ if (params.rulesSource) next.rulesSource = params.rulesSource;
+ if (params.noRulesUpdate) next.noRulesUpdate = true;
+ if (params.verbose) next.verbose = true;
+ if (params.extras && Object.keys(params.extras).length) next.extras = params.extras;
+ return next;
+}
+
+function pushFlag(argv: string[], flag: string, value: string | boolean | undefined, schema?: ScannerCliSchema) {
+ if (value === undefined || value === false || value === "") return;
+ if (BLOCKED_SCAN_FLAGS.has(flag) || !schemaAllowsFlag(schema, flag)) return;
+ if (value === true) {
+ argv.push(`--${flag}`);
+ return;
+ }
+ argv.push(`--${flag}`, String(value));
+}
+
+export function buildScannerScanArgv(
+ target: string,
+ params: ScannerScanParams,
+ schema?: ScannerCliSchema
+): string[] {
+ const argv = ["scan", target, "--format", "json", "--no-progress", "--no-color"];
+ pushFlag(argv, "detectors", params.detectors, schema);
+ pushFlag(argv, "strict", params.strict, schema);
+ pushFlag(argv, "secret-scan", params.secretScan, schema);
+ pushFlag(argv, "vuln-scan", params.vulnScan, schema);
+ pushFlag(argv, "license-scan", params.licenseScan, schema);
+ pushFlag(argv, "rules-repo", params.rulesRepo, schema);
+ pushFlag(argv, "rules-ref", params.rulesRef, schema);
+ pushFlag(argv, "rules-source", params.rulesSource, schema);
+ if (params.requireSigned && params.rulesSource !== "git") {
+ pushFlag(argv, "require-signed", true, schema);
+ }
+ pushFlag(argv, "no-rules-update", params.noRulesUpdate, schema);
+ pushFlag(argv, "verbose", params.verbose, schema);
+ for (const [key, value] of Object.entries(params.extras || {})) {
+ if ((KNOWN_SCAN_PARAM_KEYS as readonly string[]).includes(key)) continue;
+ pushFlag(argv, flagFromKey(key), value, schema);
+ }
+ return argv;
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/target.ts b/src/client/src/lib/platform/connectors/scanner/target.ts
new file mode 100644
index 00000000..dfbefdd8
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/target.ts
@@ -0,0 +1,111 @@
+/**
+ * Validate scanner targets. v1 Trustabl scans GitHub repository URLs only.
+ * Local filesystem paths are rejected so the OpenLIT server cannot be used
+ * as an arbitrary host file reader.
+ */
+
+import {
+ SCANNER_TARGET_INVALID,
+ SCANNER_TARGET_REQUIRED,
+ SCANNER_REF_INVALID,
+ SCANNER_DETECTORS_INVALID,
+ SCANNER_RULES_SOURCE_INVALID,
+ SCANNER_RULES_REPO_INVALID,
+} from "@/constants/messages/en";
+
+const GITHUB_TARGET =
+ /^https:\/\/github\.com\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+(?:\.git)?(?:\/tree\/[A-Za-z0-9._/~+-]+)?\/?$/;
+
+const REF = /^[A-Za-z0-9._/~+-]{1,200}$/;
+const DETECTOR = /^[a-z][a-z0-9_]{0,62}$/;
+
+export function normalizeScannerTarget(value: unknown): string {
+ const target = String(value || "").trim();
+ if (!target) throw new Error(SCANNER_TARGET_REQUIRED);
+ if (target.includes("@") || target.includes("\\") || /\s/.test(target)) {
+ throw new Error(SCANNER_TARGET_INVALID);
+ }
+ if (!GITHUB_TARGET.test(target)) {
+ throw new Error(SCANNER_TARGET_INVALID);
+ }
+ return target.replace(/\/$/, "");
+}
+
+export function normalizeScannerRef(value: unknown): string | undefined {
+ if (value == null || String(value).trim() === "") return undefined;
+ const ref = String(value).trim();
+ if (!REF.test(ref)) throw new Error(SCANNER_REF_INVALID);
+ return ref;
+}
+
+export function normalizeScannerDetectors(value: unknown): string | undefined {
+ if (value == null || String(value).trim() === "") return undefined;
+ const parts = String(value)
+ .split(",")
+ .map((item) => item.trim().toLowerCase())
+ .filter(Boolean);
+ if (!parts.length) return undefined;
+ if (parts.some((item) => !DETECTOR.test(item))) {
+ throw new Error(SCANNER_DETECTORS_INVALID);
+ }
+ return parts.join(",");
+}
+
+export const SCANNER_RULES_SOURCES = ["production", "staging", "git"] as const;
+
+export function normalizeScannerRulesSource(value: unknown): string | undefined {
+ if (value == null || String(value).trim() === "") return undefined;
+ const source = String(value).trim().toLowerCase();
+ if (source === "environment") return undefined;
+ if (!SCANNER_RULES_SOURCES.includes(source as (typeof SCANNER_RULES_SOURCES)[number])) {
+ throw new Error(SCANNER_RULES_SOURCE_INVALID);
+ }
+ return source;
+}
+
+export function normalizeScannerRulesRepo(value: unknown): string | undefined {
+ if (value == null || String(value).trim() === "") return undefined;
+ const repo = String(value).trim();
+ if (
+ repo.includes("@") ||
+ repo.includes("\\") ||
+ /\s/.test(repo) ||
+ !/^https:\/\/[A-Za-z0-9.-]+\/\S+$/.test(repo)
+ ) {
+ throw new Error(SCANNER_RULES_REPO_INVALID);
+ }
+ return repo.replace(/\/$/, "");
+}
+
+/** Repo URL Trustabl can clone. `/tree/<ref>` is not a git remote and 404s. */
+export function scannerCloneTarget(target: string): string {
+ return target
+ .replace(/\/$/, "")
+ .replace(/\.git$/i, "")
+ .replace(/\/tree\/[A-Za-z0-9._/~+-]+$/, "");
+}
+
+/**
+ * Canonical GitHub repo identity used to join scanner jobs to coding-agent
+ * spans (`vcs.repository.url.full`). Accepts https, ssh, and `/tree/<ref>`
+ * forms; returns `github.com/owner/repo` or null.
+ */
+export function scannerRepoKey(value: unknown): string | null {
+ const raw = String(value || "")
+ .trim()
+ .replace(/\.git$/i, "");
+ if (!raw) return null;
+ const match = raw.match(
+ /(?:^|@|\/\/)github\.com[:/]+([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)/i
+ );
+ if (!match) return null;
+ const owner = match[1].toLowerCase();
+ const repo = match[2].toLowerCase().replace(/\.git$/i, "");
+ if (!owner || !repo) return null;
+ return `github.com/${owner}/${repo}`;
+}
+
+export function scannerRefFromTarget(target: string): string | undefined {
+ const match = target.match(/\/tree\/([A-Za-z0-9._/~+-]+)\/?$/);
+ return match?.[1];
+}
diff --git a/src/client/src/lib/platform/connectors/scanner/trustabl/adapter.ts b/src/client/src/lib/platform/connectors/scanner/trustabl/adapter.ts
new file mode 100644
index 00000000..e52e7ab7
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/trustabl/adapter.ts
@@ -0,0 +1,199 @@
+import getMessage from "@/constants/messages";
+import type { ConnectorHealthResult } from "../../types";
+import { resolveSourceSecret } from "../../datasource/http/secret";
+import { BaseScannerAdapter } from "../base-adapter";
+import { trustablConfigFields } from "../config-fields";
+import { getScannerProcessRunner } from "../process";
+import { newScannerJobId, parseScannerReport, formatScannerError } from "../report";
+import { TRUSTABL_PINNED_VERSION, probeTrustablRuntime, resolveTrustablBinary, scannerCliVersionLabel } from "../runtime";
+import { describeTrustablRuntime, installTrustablCli } from "../install";
+import type { ScannerCliSchema } from "../cli-schema";
+import { compactScannerScanParams, resolveScannerScanParams, buildScannerScanArgv } from "../scan-params";
+import {
+ normalizeScannerRef,
+ normalizeScannerTarget,
+ scannerCloneTarget,
+ scannerRefFromTarget,
+} from "../target";
+import type {
+ ScannerAdapterFactory,
+ ScannerCapabilities,
+ ScannerJob,
+ ScannerRuntimeInfo,
+ ScannerScanInput,
+ ScannerScanParams,
+ ScannerSourceDescriptor,
+ ScannerTypeDescriptor,
+} from "../types";
+import {
+ SCANNER_RUNTIME_NOT_INSTALLED,
+ SCANNER_SCAN_FAILED,
+} from "@/constants/messages/en";
+
+const TRUSTABL_CAPABILITIES: ScannerCapabilities = {
+ install: true,
+ scan: true,
+ listFindings: true,
+};
+
+const SCAN_TIMEOUT_MS = 8 * 60 * 1000;
+
+export function buildTrustablScanArgv(
+ target: string,
+ params: ScannerScanParams,
+ schema?: ScannerCliSchema
+): string[] {
+ return buildScannerScanArgv(target, params, schema);
+}
+
+export class TrustablAdapter extends BaseScannerAdapter {
+ readonly type = "trustabl";
+
+ capabilities(): ScannerCapabilities {
+ return TRUSTABL_CAPABILITIES;
+ }
+
+ async healthCheck(): Promise<ConnectorHealthResult> {
+ const started = Date.now();
+ try {
+ const runtime = await describeTrustablRuntime();
+ return {
+ ok: runtime.installed,
+ message: runtime.installed
+ ? runtime.version
+ : SCANNER_RUNTIME_NOT_INSTALLED,
+ latencyMs: Date.now() - started,
+ };
+ } catch (error) {
+ return {
+ ok: false,
+ message: error instanceof Error ? error.message : SCANNER_RUNTIME_NOT_INSTALLED,
+ latencyMs: Date.now() - started,
+ };
+ }
+ }
+
+ async ensureRuntime(input: { upgrade?: boolean } = {}): Promise<ScannerRuntimeInfo> {
+ return installTrustablCli(input);
+ }
+
+ async scan(input: ScannerScanInput = {}): Promise<ScannerJob> {
+ const startedAt = new Date();
+ const jobId = newScannerJobId();
+ const target = normalizeScannerTarget(input.target || this.descriptor.settings.target);
+ const cloneTarget = scannerCloneTarget(target);
+ const ref =
+ normalizeScannerRef(input.ref ?? this.descriptor.settings.ref) ||
+ scannerRefFromTarget(target);
+ const params = resolveScannerScanParams(
+ input,
+ this.descriptor.settings,
+ this.descriptor.environment
+ );
+ const persistedParams = compactScannerScanParams(params);
+
+ const runtime = await probeTrustablRuntime();
+ const cliVersion = scannerCliVersionLabel(runtime);
+ const argv = buildTrustablScanArgv(cloneTarget, params, runtime.schema);
+ const resolved = runtime.installed ? await resolveTrustablBinary() : null;
+ if (!runtime.installed || !resolved) {
+ return {
+ id: jobId,
+ status: "runtime-missing",
+ target: cloneTarget,
+ ref,
+ params: persistedParams,
+ cliVersion,
+ startedAt: startedAt.toISOString(),
+ finishedAt: new Date().toISOString(),
+ error: SCANNER_RUNTIME_NOT_INSTALLED,
+ };
+ }
+
+ const secret = await resolveSourceSecret(
+ this.descriptor.secretRef,
+ undefined,
+ this.descriptor.projectId,
+ { clickHouseVault: false }
+ );
+ const token = secret.credentials.githubToken || secret.credentials.token || "";
+ const env: NodeJS.ProcessEnv = {
+ ...process.env,
+ NO_COLOR: "1",
+ };
+ if (token) {
+ env.GITHUB_TOKEN = token;
+ env.GH_TOKEN = token;
+ }
+
+ let result;
+ try {
+ result = await getScannerProcessRunner().run({
+ bin: resolved.bin,
+ argv,
+ env,
+ timeoutMs: SCAN_TIMEOUT_MS,
+ });
+ } catch (error) {
+ const finishedAt = new Date();
+ return {
+ id: jobId,
+ status: "failed",
+ target: cloneTarget,
+ ref,
+ params: persistedParams,
+ cliVersion,
+ startedAt: startedAt.toISOString(),
+ finishedAt: finishedAt.toISOString(),
+ durationMs: finishedAt.getTime() - startedAt.getTime(),
+ error: formatScannerError(
+ error instanceof Error ? error.message : SCANNER_SCAN_FAILED
+ ),
+ };
+ }
+
+ const parsed = parseScannerReport(result.stdout);
+ const finishedAt = new Date();
+ const failed = result.exitCode >= 2;
+ return {
+ id: jobId,
+ status: failed ? "failed" : "succeeded",
+ target: cloneTarget,
+ ref,
+ params: persistedParams,
+ startedAt: startedAt.toISOString(),
+ finishedAt: finishedAt.toISOString(),
+ durationMs: finishedAt.getTime() - startedAt.getTime(),
+ exitCode: result.exitCode,
+ error: failed
+ ? formatScannerError(result.stderr || SCANNER_SCAN_FAILED)
+ : undefined,
+ findingCount: parsed.findings.length,
+ mediumPlusCount: parsed.mediumPlusCount,
+ findings: parsed.findings,
+ report: parsed.report,
+ cliVersion,
+ };
+ }
+}
+
+export const trustablAdapterFactory: ScannerAdapterFactory = {
+ type: "trustabl",
+ create(descriptor: ScannerSourceDescriptor) {
+ return new TrustablAdapter(descriptor);
+ },
+ describe(): ScannerTypeDescriptor {
+ const messages = getMessage();
+ return {
+ type: "trustabl",
+ displayName: "Trustabl",
+ description: messages.SCANNER_TRUSTABL_DESCRIPTION,
+ capabilities: TRUSTABL_CAPABILITIES,
+ configFields: trustablConfigFields(),
+ authStyle: "api-key",
+ authHelp: messages.SCANNER_AUTH_HELP_TRUSTABL,
+ docsUrl: "https://github.com/trustabl/trustabl",
+ pinnedVersion: TRUSTABL_PINNED_VERSION,
+ };
+ },
+};
diff --git a/src/client/src/lib/platform/connectors/scanner/types.ts b/src/client/src/lib/platform/connectors/scanner/types.ts
new file mode 100644
index 00000000..d3252595
--- /dev/null
+++ b/src/client/src/lib/platform/connectors/scanner/types.ts
@@ -0,0 +1,195 @@
+/**
+ * Scanner connector contract.
+ *
+ * Scanner adapters are the category-specific runtime behind `category: "scanner"`
+ * connector instances. Vendors implement only the operations their
+ * `capabilities()` advertise; the rest throw `UnsupportedScannerCapabilityError`
+ * so product surfaces can gate honestly instead of guessing.
+ */
+
+import type { ConnectorHealthResult, ConnectorRuntime } from "../types";
+import type { AuthStyle, FieldDef } from "../datasource/types";
+import type { ScannerCliSchema } from "./cli-schema";
+
+export interface ScannerCapabilities {
+ install: boolean;
+ scan: boolean;
+ listFindings: boolean;
+}
+
+export type ScannerJobStatus =
+ | "queued"
+ | "running"
+ | "succeeded"
+ | "failed"
+ | "runtime-missing";
+
+export interface ScannerFinding {
+ id: string;
+ ruleId: string;
+ severity: string;
+ category?: string;
+ scope?: string;
+ toolName?: string;
+ path?: string;
+ line?: number;
+ endLine?: number;
+ title: string;
+ message?: string;
+ helpUrl?: string;
+ fix?: string;
+ confidence?: string;
+ extras?: Record<string, string>;
+}
+
+/** Resolved Trustabl `scan` flags persisted on the job (no secrets). */
+export interface ScannerScanParams {
+ detectors?: string;
+ strict?: boolean;
+ secretScan?: boolean;
+ vulnScan?: boolean;
+ licenseScan?: boolean;
+ requireSigned?: boolean;
+ rulesRepo?: string;
+ rulesRef?: string;
+ rulesSource?: string;
+ noRulesUpdate?: boolean;
+ verbose?: boolean;
+ extras?: Record<string, string | boolean>;
+}
+
+/** Per-run overrides. Missing fields fall back to connector defaults. */
+export interface ScannerScanInput extends ScannerScanParams {
+ target?: string;
+ ref?: string;
+}
+
+export interface ScannerReportSummary {
+ scanId?: string;
+ repo?: string;
+ overallScore?: number;
+ rulesSource?: string;
+ rulesVersion?: string;
+ rulesFromCache?: boolean;
+ rulesStale?: boolean;
+ rulesOrigin?: string;
+ languages?: string[];
+ sdks?: string[];
+ toolCount?: number;
+ agentCount?: number;
+ mcpCount?: number;
+ skillCount?: number;
+ subagentCount?: number;
+ vulnerabilityCount?: number;
+ secretCount?: number;
+ filesParsed?: number;
+ filesSkipped?: number;
+ noAgentSurfaces?: boolean;
+ extras?: Record<string, string>;
+}
+
+export interface ScannerJob {
+ id: string;
+ status: ScannerJobStatus;
+ target: string;
+ ref?: string;
+ startedAt: string;
+ finishedAt?: string;
+ durationMs?: number;
+ exitCode?: number;
+ error?: string;
+ findingCount?: number;
+ mediumPlusCount?: number;
+ findings?: ScannerFinding[];
+ params?: ScannerScanParams;
+ report?: ScannerReportSummary;
+ /** Trustabl CLI version used for this job, e.g. `v0.1.8`. */
+ cliVersion?: string;
+}
+
+export type ScannerRepoFindingsMatch = {
+ matched: true;
+ repoKey: string;
+ connectorId: string;
+ connectorName: string;
+ jobId: string;
+ target: string;
+ ref?: string;
+ scannedAt: string;
+ findingCount: number;
+ mediumPlusCount: number;
+ findings: ScannerFinding[];
+ url: string;
+};
+
+export type ScannerRepoFindingsMiss = {
+ matched: false;
+ repoKey: string | null;
+ url: string;
+};
+
+export type ScannerRepoFindingsResult =
+ | ScannerRepoFindingsMatch
+ | ScannerRepoFindingsMiss;
+
+export interface ScannerRuntimeInfo {
+ installed: boolean;
+ version?: string;
+ source?: "env" | "path" | "cache";
+ binaryVersion?: string;
+ latestVersion?: string;
+ upgradeAvailable?: boolean;
+ schema?: ScannerCliSchema;
+}
+
+export interface ScannerSourceDescriptor {
+ type: string;
+ id: string;
+ settings: Record<string, unknown>;
+ secretRef?: string | null;
+ projectId?: string | null;
+ name: string;
+ environment?: string;
+}
+
+export interface ScannerTypeDescriptor {
+ type: string;
+ displayName: string;
+ description?: string;
+ internal?: boolean;
+ icon?: string;
+ capabilities: ScannerCapabilities;
+ configFields: FieldDef[];
+ authStyle: AuthStyle;
+ authHelp?: string;
+ docsUrl?: string;
+ pinnedVersion?: string;
+}
+
+export interface ScannerAdapter extends ConnectorRuntime {
+ readonly type: string;
+ capabilities(): ScannerCapabilities;
+ healthCheck(): Promise<ConnectorHealthResult>;
+ ensureRuntime(input?: { upgrade?: boolean }): Promise<ScannerRuntimeInfo>;
+ scan(input?: ScannerScanInput): Promise<ScannerJob>;
+}
+
+export interface ScannerAdapterFactory {
+ type: string;
+ create(descriptor: ScannerSourceDescriptor): ScannerAdapter;
+ describe(): ScannerTypeDescriptor;
+}
+
+export class UnsupportedScannerCapabilityError extends Error {
+ readonly capability: string;
+ readonly sourceType: string;
+ constructor(sourceType: string, capability: string, message?: string) {
+ super(
+ message ||
+ `Capability "${capability}" is not supported by scanner connector "${sourceType}".`
+ );
+ this.name = "UnsupportedScannerCapabilityError";
+ this.capability = capability;
+ this.sourceType = sourceType;
+ }
+}
diff --git a/src/client/src/lib/platform/connectors/types.ts b/src/client/src/lib/platform/connectors/types.ts
index c4a07780..215b32cb 100644
--- a/src/client/src/lib/platform/connectors/types.ts
+++ b/src/client/src/lib/platform/connectors/types.ts
@@ -9,6 +9,8 @@ export type ConnectorCategory =
| "datasource"
| "notification"
| "memory"
+ | "scanner"
+ | "repository"
| "vector-store"
| "model-provider";
diff --git a/src/client/src/lib/platform/connectors/visible-types.ts b/src/client/src/lib/platform/connectors/visible-types.ts
index b5a055f9..f6e7fcc2 100644
--- a/src/client/src/lib/platform/connectors/visible-types.ts
+++ b/src/client/src/lib/platform/connectors/visible-types.ts
@@ -8,6 +8,7 @@ export const VISIBLE_CONNECTOR_TYPES = [
"claude",
"mem0",
"zep",
+ "trustabl",
] as const;
export function isVisibleConnectorType(type: unknown): boolean {
diff --git a/src/client/src/utils/breadcrumbs.ts b/src/client/src/utils/breadcrumbs.ts
index 6628b701..fca43d11 100644
--- a/src/client/src/utils/breadcrumbs.ts
+++ b/src/client/src/utils/breadcrumbs.ts
@@ -246,6 +246,11 @@ export const ROUTE_CONFIGS: RouteConfig[] = [
getTitle: () => getMessage().FEATURE_MEMORY,
getBreadcrumbs: () => [],
},
+ {
+ regex: /^\/scanner$/,
+ getTitle: () => getMessage().FEATURE_SCANNER,
+ getBreadcrumbs: () => [],
+ },
// Rule Engine
{