You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit a76174d
Browse filesBrowse the repository at this point in the historyBrowse files
First-pass triage of private vulnerability reports on GitHub. When a new security advisory comes in, embargod has an LLM agent investigate it against the repository and posts its findings as a comment on the advisory.
5
+
First-pass triage of private vulnerability reports on GitHub. When a new security advisory comes in, tamis has an LLM agent investigate it against the repository and posts its findings as a comment on the advisory.
6
6
7
-
For each report, embargod:
7
+
For each report, tamis:
8
8
9
9
- lists public duplicates in the comment and embargoed duplicates only in a private report,
10
10
- finds public issues and pull requests already fixing or hardening the same code,
@@ -21,7 +21,7 @@ It informs the maintainers' decision and never makes it.
Copy file name to clipboardExpand all lines: action.yml
+15-15Lines changed: 15 additions & 15 deletions
Original file line number
Diff line number
Diff line change
@@ -1,4 +1,4 @@
1
-
name: Embargod
1
+
name: Tamis
2
2
description: First-pass LLM triage of new GitHub security advisories, posted as an advisory comment.
3
3
author: Alexandre Daubois
4
4
branding:
@@ -37,14 +37,14 @@ inputs:
37
37
description: Turn on OpenAI's Daybreak cyber access program in Codex, with `engine: openai` only. The API key's org must be approved for it.
38
38
default: "false"
39
39
runner-image:
40
-
description: Image the agent runs in, instead of the embargod agent image pinned by digest and checked against its build attestation. It needs the agent CLI, git, curl and harness-proxy, and is not checked.
40
+
description: Image the agent runs in, instead of the tamis agent image pinned by digest and checked against its build attestation. It needs the agent CLI, git, curl and harness-proxy, and is not checked.
41
41
required: false
42
42
references:
43
43
description: Whitespace-separated local git references to analyse, including each supported release branch. All must have been fetched.
44
44
required: true
45
45
46
46
runs:
47
-
# The agent runs in its own hardened container, so embargod itself runs on the runner, next to Docker.
47
+
# The agent runs in its own hardened container, so tamis itself runs on the runner, next to Docker.
48
48
using: composite
49
49
steps:
50
50
- name: Check deployment
@@ -54,19 +54,19 @@ runs:
54
54
ACTION_REF: ${{ github.action_ref }}
55
55
run: |
56
56
if [[ "$PRIVATE_REPOSITORY" != true ]]; then
57
-
echo 'Embargod requires a private workflow repository.' >&2
57
+
echo 'Tamis requires a private workflow repository.' >&2
58
58
exit 1
59
59
fi
60
60
if [[ ! "$ACTION_REF" =~ ^[a-fA-F0-9]{40}$ ]]; then
61
-
echo 'Pin Embargod to a reviewed full commit SHA.' >&2
61
+
echo 'Pin Tamis to a reviewed full commit SHA.' >&2
Copy file name to clipboardExpand all lines: docs/configuration.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -14,7 +14,7 @@
14
14
|`engine`|`claude`|`claude` (Claude Code and the Anthropic API) or `openai` (Codex and the OpenAI API). |
15
15
|`model`|`claude-opus-5-5` / `gpt-5.5`| Model used by both the agent and the duplicate search. `gpt-6.1-sol` with a Codex access token. |
16
16
|`daybreak`|`false`| Turn on OpenAI's Daybreak cyber access program in Codex. `openai` engine only, and the API key's organisation must be approved for it. |
17
-
|`runner-image`|embargod agent image, pinned by digest | Image the agent runs in. It must contain the agent CLI, git, curl and `harness-proxy`. A custom image skips the attestation check. |
17
+
|`runner-image`|tamis agent image, pinned by digest | Image the agent runs in. It must contain the agent CLI, git, curl and `harness-proxy`. A custom image skips the attestation check. |
18
18
|`references`|| Whitespace-separated local git references, one for each supported branch. Required, at most ten. A missing reference fails the analysis. |
19
19
20
20
Outside GitHub Actions, the same settings are read from environment variables: `LLM_API_KEY`, `GH_TOKEN`, `BOT_LOGIN`, `REPOSITORY`, `REPO_PATH`, `SINCE`, `ADVISORY`, `ENGINE`, `MODEL`, `DAYBREAK`, `RUNNER_IMAGE` and `REFERENCES`. `OUTPUT_DIR` must name a private directory for the reports. The action creates that directory in the runner's temporary storage and uploads it to the private workflow repository with seven-day retention.
@@ -23,7 +23,7 @@ The action requires a private workflow repository and a full commit SHA in `uses
23
23
24
24
## Source branches
25
25
26
-
Fetch the configured references with `fetch-depth: 0`. For php-src, include the default branch and every PHP branch covered by your disclosure policy, for example `master origin/PHP-8.4` when those are the branches you support. Keep the list current as releases enter or leave support. Embargod analyses each reference separately and includes its exact commit in both copies of the result; it does not infer the maintained branches from a reporter's prose. No source code is executed.
26
+
Fetch the configured references with `fetch-depth: 0`. For php-src, include the default branch and every PHP branch covered by your disclosure policy, for example `master origin/PHP-8.4` when those are the branches you support. Keep the list current as releases enter or leave support. Tamis analyses each reference separately and includes its exact commit in both copies of the result; it does not infer the maintained branches from a reporter's prose. No source code is executed.
27
27
28
28
## Private reports
29
29
@@ -37,11 +37,11 @@ These bounds limit each execution, not spending across scheduled runs. Use a ded
37
37
38
38
## Project guidance
39
39
40
-
A `.github/embargod.md` file in the project is appended to the agent's instructions. Use it for what the model cannot guess: what is in scope, what the project's public API is, how the project scores CVSS, which configurations are realistic.
40
+
A `.github/tamis.md` file in the project is appended to the agent's instructions. Use it for what the model cannot guess: what is in scope, what the project's public API is, how the project scores CVSS, which configurations are realistic.
41
41
42
42
## Security policy
43
43
44
-
The agent checks the report against the files that describe what the project treats as a security issue. embargod looks for them among the tracked files of the repository root, `.github/` and `docs/`:
44
+
The agent checks the report against the files that describe what the project treats as a security issue. tamis looks for them among the tracked files of the repository root, `.github/` and `docs/`:
45
45
46
46
-`SECURITY` with a `.md`, `.markdown`, `.rst`, `.txt` or `.adoc` extension, in any case,
TAMIS_TEST_IMAGE=tamis-test:codex go test -race -count=1 -tags integration ./internal/sandbox
28
28
```
29
29
30
30
Repeat for `claude`. The tests use fake model servers, check direct host/Internet/DNS access and validate that the pinned CLI can reach the filtered proxy. Missing Docker or an unset test image fails the suite.
@@ -34,27 +34,27 @@ Repeat for `claude`. The tests use fake model servers, check direct host/Interne
34
34
The agent images are built from [`docker/agent/Dockerfile`](../docker/agent/Dockerfile), one target per agent:
35
35
36
36
```bash
37
-
docker build --target claude -t embargod-agent:claude docker/agent
37
+
docker build --target claude -t tamis-agent:claude docker/agent
38
38
```
39
39
40
-
The `Agent image` workflow publishes both to `ghcr.io/alexandre-daubois/embargod-agent` with a build attestation when that directory changes on `main`, then opens a pull request updating the digests in [`internal/sandbox/images.json`](../internal/sandbox/images.json). embargod only runs the images pinned there, so new images reach users once that pull request is merged and released.
40
+
The `Agent image` workflow publishes both to `ghcr.io/alexandre-daubois/tamis-agent` with a build attestation when that directory changes on `main`, then opens a pull request updating the digests in [`internal/sandbox/images.json`](../internal/sandbox/images.json). tamis only runs the images pinned there, so new images reach users once that pull request is merged and released.
41
41
42
42
To bump an agent CLI, update its tag and the sha256 of each architecture's asset together in the Dockerfile. The workflow needs "Allow GitHub Actions to create and approve pull requests" in the repository settings.
43
43
44
44
## Releases
45
45
46
-
Pushing a `vX.Y.Z` tag runs the `Release` workflow, which builds embargod for Linux on amd64 and arm64, attests both binaries and publishes them in a GitHub release. When the action's pinned commit has such a release tag, the action downloads the binary for the runner and checks its attestation against that commit before running it. Any other pinned commit is built from source.
46
+
Pushing a `vX.Y.Z` tag runs the `Release` workflow, which builds tamis for Linux on amd64 and arm64, attests both binaries and publishes them in a GitHub release. When the action's pinned commit has such a release tag, the action downloads the binary for the runner and checks its attestation against that commit before running it. Any other pinned commit is built from source.
47
47
48
48
## Dependency updates
49
49
50
50
[Renovate](https://docs.renovatebot.com/) keeps Go modules, pinned actions, base images and the agent CLIs up to date, following [`renovate.json`](../renovate.json). It updates each CLI's tag and checksums in one pull request, keeps `harness-proxy` in the agent image on the same version as the `harness` module, and waits seven days after a release before proposing it. It needs the [Renovate GitHub App](https://github.com/apps/renovate) installed on the repository.
51
51
52
52
## Running locally
53
53
54
-
embargod reads its configuration from environment variables, so it runs on any machine with Docker. From a checkout of the target repository:
54
+
tamis reads its configuration from environment variables, so it runs on any machine with Docker. From a checkout of the target repository:
The comment is posted for real. An advisory with a completed comment from the configured bot is skipped, including after edits to the report or followup comments.
@@ -63,7 +63,7 @@ The comment is posted for real. An advisory with a completed comment from the co
63
63
64
64
| Path | Role |
65
65
|---|---|
66
-
|`cmd/embargod`| Configuration and entry point |
66
+
|`cmd/tamis`| Configuration and entry point |
67
67
|`internal/triage`| Advisory selection and the triage pipeline |
68
68
|`internal/sandbox`| The agent container, through harness |
69
69
|`internal/modelproxy`| The proxy keeping the model key on the host |
0 commit comments