Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
53 commits
Select commit Hold shift + click to select a range
34df13d
feat(gui): add the desktop GUI frontend foundation (milestones 001-005)
Oct 23, 2026
e191606
docs(plans): register the desktop GUI milestones 006 and 007
Oct 23, 2026
0c38c40
docs(plans): correct the GUI roadmap and register milestones 008 and 009
Oct 23, 2026
7332bae
fix(payloads): expose WebSocketFuzzer's target url to the engine
Oct 23, 2026
b1fc0e8
feat(gui): implement the desktop GUI milestones 007, 008, and 009
Oct 23, 2026
5c27103
docs(plans): record the closure of the desktop GUI milestones 007, 00…
Oct 23, 2026
9a9b000
fix(make): drop backticks from the new help lines
Oct 23, 2026
e9752b8
docs(plans): correct the stale milestone status lines for M007-M009
Oct 24, 2026
818e32d
feat(gui): implement the desktop GUI milestone 006
Oct 24, 2026
6de8294
docs(plans): record the closure of the desktop GUI milestone 006
Oct 24, 2026
db554e0
docs(plans): plan the daemon's full manual capability policy
Oct 24, 2026
1877d8e
feat(daemon): implement the desktop GUI milestone 010
Oct 24, 2026
6f75853
docs(plans): record the closure of the desktop GUI milestone 010
Oct 24, 2026
9d812c6
feat(daemon): implement the desktop GUI milestone 011
Oct 24, 2026
aa07f80
docs(plans): record the closure of the desktop GUI milestone 011
Oct 24, 2026
821c818
docs(plans): correct the roadmap's remaining stale approval claims
Oct 24, 2026
c288248
docs(plans): author and register the desktop GUI milestones 012 to 015
Oct 24, 2026
a4214b8
docs(plans): fix the milestone 014 section cross-references
Oct 24, 2026
0f5dbb2
docs(plans): correct the milestone 013 and 014 arithmetic and drift t…
Oct 24, 2026
6de6340
feat(desktop-gui): implement the desktop GUI milestones 012 to 015
Oct 24, 2026
dcfcd4e
fix(tui,engine): correct the assertions milestone 010 left stale
Oct 24, 2026
42e3534
fix(scripts): pass the daemon's socket path as an option in the local…
Oct 24, 2026
3ebd236
docs(plans): record the closures of the desktop GUI milestones 012 to…
Oct 24, 2026
cf3aa45
feat(qualification): add the operator-attestation path to the GUI qua…
Oct 24, 2026
8103bce
docs(plans): accept ADR-0013 and close milestone 012's finding F1
Oct 24, 2026
309d77d
fix(qualification): let the launch column pass, and photograph only t…
Oct 24, 2026
7cdc063
docs(evidence): record the macOS operator-mode qualification run
Oct 24, 2026
b4efdeb
docs(evidence): the operator's attestation for the macOS behavioural …
Oct 24, 2026
d0cf5bc
fix(ci): let the Linux prerequisite probe see the appindicator module
Oct 24, 2026
ffae623
feat(qualification): promote the macOS behavioural cells on an attest…
Oct 24, 2026
7e3c8f9
docs(skill,architecture): record the operator attestation and the pro…
Oct 24, 2026
2a929f1
docs(handoff): point the export run at the operator-attested record
Oct 24, 2026
e0d583f
fix(qualification): make the self-test follow the matrix's own citation
Oct 24, 2026
37b1bf7
docs(evidence): record the Linux leg's first CI run
Oct 25, 2026
22ac156
docs(evidence): replace the CI-mode macOS record with the current run's
Oct 25, 2026
711356f
docs(plans): record milestone 015's discharged finding and the CI exp…
Oct 25, 2026
38c8597
fix(tui): repair the Intercept tab's session stamp and focus contract
Oct 25, 2026
80359c4
docs(plans): record the Intercept repair in milestone 015's closure
Oct 25, 2026
27fe3a9
docs(plans): carry the advisory-backlog unblocking through to its end
Oct 25, 2026
4c82ea7
docs(architecture): correct the TUI's published test-count totals
Oct 25, 2026
2294141
fix(ci): give the guards the commit history they decide against
Oct 25, 2026
d6883f4
docs(plans): record the qualification validator's CI verdict
Oct 25, 2026
a3b40ae
fix(qualification): do not blame the attestation for a missing run co…
Oct 25, 2026
9df9f1d
fix(ci): decide the dependency policy with one cargo-deny, and not a …
Oct 25, 2026
baff6b8
docs(plans): discharge milestone 015's finding F4
Oct 25, 2026
34ff262
fix(ci): decide the dependency policy without the inclusion graph
Oct 25, 2026
a0bc32b
docs(plans): correct milestone 015's account of the CI stall
Oct 25, 2026
c777f37
fix(tui): remove the duplicate that stopped the vuln-management featu…
Oct 25, 2026
1d025be
docs(plans): record the defect the dependency-policy stall was hiding
Oct 25, 2026
faa7e39
fix(scripts): make the per-feature sweep runnable on a stock macOS bash
Oct 25, 2026
cb58eec
docs(plans): record the sweep's portability repair
Oct 25, 2026
13fd6b7
merge: consolidate reviewed desktop GUI work
Nov 13, 2026
1d039cc
ci: align dependency review with GTK advisory exception
Nov 13, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 33 additions & 4 deletions .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -36,16 +36,26 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
with:
components: rustfmt, clippy
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
- name: Install cargo-deny (SHA-pinned)
uses: taiki-e/install-action@c02248eec042a8a90b2335f60bb37dc287b54068 # cargo-deny
with:
tool: cargo-deny@0.19.0
- name: Install ripgrep
run: sudo apt-get update && sudo apt-get install -y ripgrep
# 0.20.2, the version the local contract runs: two versions of the
# tool must not decide the same policy differently (milestone 015's
# finding F4 -- a local green must be proof of a CI green).
tool: cargo-deny@0.20.2
# The desktop GUI shell profile (Tauri) needs the Linux webview
# development packages; the `make check` gate opens only when they
# are present, so the shell build really runs in CI.
- name: Install system dependencies
run: sudo apt-get update && sudo apt-get install -y ripgrep pkg-config libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf
- name: Full mandatory Rust CI contract
run: make check

Expand All @@ -56,12 +66,19 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
- name: Install cargo-deny (SHA-pinned)
uses: taiki-e/install-action@c02248eec042a8a90b2335f60bb37dc287b54068 # cargo-deny
with:
tool: cargo-deny@0.19.0
# 0.20.2, the version the local contract runs: two versions of the
# tool must not decide the same policy differently (milestone 015's
# finding F4 -- a local green must be proof of a CI green).
tool: cargo-deny@0.20.2
- name: Advisory/license/source policy over full workspace closure
run: make check-deps

Expand All @@ -74,6 +91,10 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- name: Dependency review (vulnerabilities, moderate+ fails)
uses: actions/dependency-review-action@a1d282b36b6f3519aa1f3fc636f609c47dddb294 # v5.0.0
with:
Expand All @@ -85,6 +106,10 @@ jobs:
# maintain a separate license allowlist, so no deny-licenses is
# set here — contradictory allowlists are a Phase F violation.
fail-on-severity: moderate
# This is the GTK 0.18 advisory already reviewed and documented in
# deny.toml and docs/DEPENDENCY_EXCEPTIONS.md. Tauri currently pins
# this Linux shell dependency closure upstream.
allow-ghsas: GHSA-wrw7-89jp-8q8g

python:
name: Python
Expand All @@ -93,6 +118,10 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
- uses: actions/setup-python@6d4fd22b20465ccc0f7354476588e8df7c9ca0e0 # v7.1.0
Expand Down
143 changes: 135 additions & 8 deletions .github/workflows/deep-checks.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,24 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
# The desktop GUI shell profile (Tauri) needs the Linux webview
# development packages; `make check-full` -> `make check` gates the
# shell build on them, so the shell build really runs in CI.
- name: Install system dependencies
run: sudo apt-get update && sudo apt-get install -y ripgrep protobuf-compiler libpcap-dev libssl-dev libssh2-1-dev pkg-config
run: sudo apt-get update && sudo apt-get install -y ripgrep protobuf-compiler libpcap-dev libssl-dev libssh2-1-dev pkg-config libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf
- name: Install cargo-deny (SHA-pinned)
uses: taiki-e/install-action@c02248eec042a8a90b2335f60bb37dc287b54068 # cargo-deny
with:
tool: cargo-deny@0.19.0
# 0.20.2, the version the local contract runs: two versions of the
# tool must not decide the same policy differently (milestone 015's
# finding F4 -- a local green must be proof of a CI green).
tool: cargo-deny@0.20.2
- name: Optional broad validation
run: make check-full
- name: Exhaustive per-feature compilation sweep
Expand All @@ -41,19 +51,22 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@02cb101ec7c40f2c49e1d9714d64511d8e1b74de # master (toolchain input pins 1.89)
with:
toolchain: "1.89"
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
key: msrv
# The MSRV contract now includes the desktop GUI shell profile, which
# needs the Linux webview development packages.
- name: Install system dependencies
run: sudo apt-get update && sudo apt-get install -y pkg-config libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf
- name: Verify workspace compiles with declared MSRV
run: |
cargo check --workspace --no-default-features
cargo check -p eggsec-cli --no-default-features
cargo check -p eggsec-transport
cargo check -p eggsec-transport-eggfetch
cargo check -p eggsec --no-default-features
run: make check-msrv

portability:
name: Portability (${{ matrix.os }})
Expand All @@ -66,13 +79,123 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
key: portability-${{ matrix.os }}
- name: Check compilation
run: cargo check -p eggsec

# The desktop GUI's platform qualification (milestone 007).
#
# WINDOWS IS EXCLUDED BY DECISION (ADR-0010), not by oversight: the desktop
# GUI's supported platforms are Linux and macOS. The measured reason is that
# the GUI's UNCONDITIONAL dependency `eggsec-frontend-client` imports the
# Unix-domain-socket transport without a cfg(unix) gate
# (crates/eggsec-frontend-client/src/daemon.rs:9 and :56), so
# `cargo check -p eggsec-frontend-client --target x86_64-pc-windows-msvc`
# fails with E0432/E0433/E0599 and the GUI does not compile for Windows at
# all. A Windows leg here would be permanently red rather than informative.
# Adding it is gated on the daemon-transport milestone ADR-0010 names: a
# Windows daemon transport (named pipes or equivalent local IPC) changes the
# KIND of transport rather than adding a read path, so it requires an ADR.
gui-platform:
name: GUI platform (${{ matrix.os }})
runs-on: ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, macos-latest]
# The platform label the qualification procedure records. It is the
# matrix's own fact, not the runner's name.
include:
- os: ubuntu-latest
platform: linux
- os: macos-latest
platform: macos
permissions:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@6323deb102c322ba6fcbdcafc7e3dddab59af2b6 # v2.9.2
with:
key: gui-platform-${{ matrix.os }}
# The Linux webview SDK. The package list is the workspace's own subset
# (the GitHub-hosted image pre-installs the build toolchain and
# libssl-dev, which is why `build-essential`, `curl`, `wget`, `file`,
# `libxdo-dev`, and `libssl-dev` are absent from it). The full Tauri
# list, and what the omission costs on a bare distribution, is in
# docs/GUI_BUILD.md.
- name: Install the Linux webview prerequisites
if: runner.os == 'Linux'
run: sudo apt-get update && sudo apt-get install -y pkg-config libwebkit2gtk-4.1-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev patchelf
# The probe reports BUILDABLE or NOT BUILDABLE; it never says "skipped",
# because a qualification cell needs an answer, not an absence of one.
- name: Probe the GUI shell prerequisites
run: bash scripts/check_gui_prereqs.sh
# The UNGATED check, not the gated `make check` line: on Linux the gated
# line skips when the webview SDK is absent, and this job's whole point
# is to prove the SDK is present AND the shell compiles.
- name: Desktop GUI shell profile (ungated)
run: make check-gui
# Both test profiles: the `shell` feature gates commands.rs and shell.rs,
# so the non-shell path has to be exercised too. The GUI's tests are
# headless-safe (no socket, no window, no subprocess), so they run
# unattended with no display.
- name: GUI test suite (shell profile)
run: cargo test -p eggsec-gui --features shell --lib
- name: GUI test suite (no-shell profile)
run: cargo test -p eggsec-gui --no-default-features --lib
- name: Build the release binary and its metadata sidecar
run: make gui-release
# The sidecar and the checksum are what let a matrix cell cite a CI run
# URL instead of a claim.
- name: Upload the build metadata and checksum
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
with:
name: gui-release-${{ matrix.os }}
path: |
dist/gui/eggsec-gui.build.json
dist/gui/SHA256SUMS
if-no-files-found: error
# The GUI reaches the engine only through a daemon that carries the
# engine executor, so the harness needs a `service`-profile daemon. The
# profile is heavy (it links the engine), which is why this job lives in
# the scheduled deep-checks workflow rather than in per-PR CI.
- name: Build the service-profile daemon
run: bash scripts/build-daemon-profile.sh --profile service --out "$RUNNER_TEMP/eggsec-daemon"
# The qualification procedure: the build, the daemon, the harness, the
# window probe, and the run record. A named skip does not fail the job;
# a failed column does.
- name: Run the GUI qualification procedure
run: |
bash scripts/gui_qualification.sh \
--platform "${{ matrix.platform }}" \
--mode ci \
--daemon-bin "$RUNNER_TEMP/eggsec-daemon/eggsec-daemon" \
--out "$RUNNER_TEMP/gui-qualification"
# The run record is the evidence a matrix cell cites. It is published
# even when the procedure failed, because a failed run's record is the
# evidence of the failure.
- name: Upload the qualification run record
if: always()
uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
with:
name: gui-qualification-${{ matrix.os }}
path: |
${{ runner.temp }}/gui-qualification/*.md
${{ runner.temp }}/gui-qualification/*.json
if-no-files-found: error

# Phase F: platform integration maturity (scheduled/manual only, never PR CI).
# Fixture layer always runs (no root/hardware). Live layers report SKIP with
# the named prerequisite when caps/devices are absent — never red, never
Expand All @@ -84,6 +207,10 @@ jobs:
contents: read
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
# The full history: the guards decide commit ancestry, and a shallow
# checkout cannot answer that question.
with:
fetch-depth: 0
- uses: dtolnay/rust-toolchain@6bed0761d98439e5a578e2877258200ad565ba87 # stable
- uses: Swatinem/rust-cache@d1527c8f67ef9af357290475d4af4b0fab8f12e0 # v2.9.3
with:
Expand Down
10 changes: 10 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,16 @@ crates/*/target/
debug/
release/

# Tauri build artifacts (the ACL and capability schemas are regenerated by
# `tauri-build` on every build; the capability file's `$schema` points at them
# only as an editor hint)
crates/*/gen/schemas/

# Desktop GUI release output (the binary plus its build-metadata sidecar).
# scripts/build_gui_release.sh writes here by default; the artefacts are
# build products, never source.
/dist/

# Pre-built binaries
/eggsec
eggsec.exe
Expand Down
2 changes: 1 addition & 1 deletion .opencode/skills/eggsec-cli/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@ Current `evaluate_and_enforce_operation` behavior for ManualPermissive `RequireC

| Command | Source | Purpose |
|---------|--------|---------|
| `daemon start/status/stop` | `crates/eggsec-cli/src/daemon_cli.rs` | Daemon lifecycle management |
| `daemon start/status/stop` | `crates/eggsec-cli/src/daemon_cli.rs` | Daemon lifecycle management. `daemon start` requires the non-default `daemon-client` feature and hosts the **engine** executor (the daemon binary is the persistent one); it refuses to displace a live daemon and reports success only after the daemon answers `Health` |
| `daemon history` | `crates/eggsec-cli/src/daemon_cli.rs` | List persisted sessions |
| `daemon show <id>` | `crates/eggsec-cli/src/daemon_cli.rs` | Show persisted snapshot |
| `session list/create/snapshot` | `crates/eggsec-cli/src/daemon_cli.rs` | Session introspection |
Expand Down
4 changes: 2 additions & 2 deletions .opencode/skills/eggsec-config/SKILL.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,11 +132,11 @@ let outcome = enforcement.evaluate(&descriptor);
```rust
use eggsec::config::{ExecutionSurface, EnforcementContext};

let surface = ExecutionSurface::CliManual; // or TuiManual, McpServer, etc.
let surface = ExecutionSurface::CliManual; // or TuiManual, DesktopGuiManual, McpServer, etc.
let enforcement = EnforcementContext::for_surface(surface, policy, loaded_scope);
```

Surfaces that `honors_manual_override()` are only `CliManual` and `TuiManual`. Automated surfaces (`is_agent_controlled()`) require explicit scope manifests for networked operations.
Surfaces that `honors_manual_override()` are `CliManual`, `TuiManual`, and `DesktopGuiManual`. Automated surfaces (`is_agent_controlled()`) require explicit scope manifests for networked operations.

### Preflight Evaluation

Expand Down
Loading
Loading