2 Commits

Author SHA1 Message Date
codex-bot c5a226f291 ci: verify Tessera remotely against the separated Aster engine
Verify Tessera GUI / verify (push) Failing after 0s
2026-10-20 01:10:02 +08:00
codex-bot 30c5fd5774 build: pin Aster VM as a source submodule 2026-10-20 00:48:50 +08:00
11 changed files with 262 additions and 0 deletions
+8
View File
@@ -0,0 +1,8 @@
.git
**/.git
target
**/target
**/AGENTS.md
**/work
**/ci-output
.env
+22
View File
@@ -0,0 +1,22 @@
# Tessera GUI automation
[workflows](workflows/README.md) contains repository workflows.
## CI checkout prerequisites
All workflows use `runs-on: ces-control`; no shared Runner configuration is changed.
Configure repository or organization secrets `CODEX_BOT_SSH_KEY` (the dedicated
codex-bot private SSH key) and `GITEA_SSH_KNOWN_HOSTS` (the independently verified
known_hosts entry for `[gitea.entroia.com]:22222`). The bot needs read access to the
repository and its Aster submodule. Workflows use an isolated SSH command with
`-F /dev/null`, `IdentitiesOnly=yes`, an explicit key and port, strict host-key
checking, and temporary credential files removed after checkout. Keys are never
written into tracked files. Missing secrets fail checkout explicitly.
The SSH submodule URL's repository owner is separate from the authenticated bot.
Local Git operations must use the same dedicated bot identity; configure the
checkout's isolated command in `GIT_SSH_COMMAND` for submodule initialization.
Workflow definitions do not prove CI passed. CI/deployment state is not queried
automatically. Local runtime checks are not performed for Aster, Lyra or Hestia;
Tessera permits local native builds/window runs, with automated tests in CI.
+5
View File
@@ -0,0 +1,5 @@
# Tessera GUI workflows
[ci.yml](ci.yml) verifies this project on main pushes, pull requests and manual dispatch. It runs on ces-control, with a 60-minute timeout. Checkout and secret requirements are in [the parent README](../README.md).
There is no production service deployment in this workflow.
+49
View File
@@ -0,0 +1,49 @@
name: Verify Tessera GUI
on:
push:
branches: [main]
pull_request:
workflow_dispatch:
jobs:
verify:
runs-on: ces-control
timeout-minutes: 60
env:
DOCKER_BUILDKIT: "0"
steps:
- name: Checkout with codex-bot
env:
CODEX_BOT_SSH_KEY: ${{ secrets.CODEX_BOT_SSH_KEY }}
GITEA_SSH_KNOWN_HOSTS: ${{ secrets.GITEA_SSH_KNOWN_HOSTS }}
SOURCE_SHA: ${{ gitea.sha }}
SOURCE_REPOSITORY: ${{ gitea.repository }}
run: |
set -eu
test -n "$CODEX_BOT_SSH_KEY"
test -n "$GITEA_SSH_KNOWN_HOSTS"
case "$SOURCE_SHA" in *[!0-9a-f]*|'') exit 1;; esac
test "${#SOURCE_SHA}" -eq 40
umask 077
checkout_keys=$(mktemp -d)
trap 'rm -rf "$checkout_keys"' EXIT
printf '%s\n' "$CODEX_BOT_SSH_KEY" > "$checkout_keys/key"
printf '%s\n' "$GITEA_SSH_KNOWN_HOSTS" > "$checkout_keys/known_hosts"
unset CODEX_BOT_SSH_KEY GITEA_SSH_KNOWN_HOSTS
export GIT_SSH_COMMAND="ssh -F /dev/null -o IdentitiesOnly=yes -i $checkout_keys/key -p 22222 -o StrictHostKeyChecking=yes -o UserKnownHostsFile=$checkout_keys/known_hosts"
git init .
source_url="ssh://git@gitea.entroia.com:22222/$SOURCE_REPOSITORY.git"
if git remote get-url origin >/dev/null 2>&1; then
git remote set-url origin "$source_url"
else
git remote add origin "$source_url"
fi
git fetch --no-tags --depth=1 origin "$SOURCE_SHA"
git checkout --detach --force FETCH_HEAD
git submodule update --init --recursive
- name: Verify portable GUI code
run: |
image="endorphin-tessera-gui-ci:${{ gitea.sha }}"
docker build -f Dockerfile.ci -t "$image" .
docker run --rm --init "$image"
+3
View File
@@ -0,0 +1,3 @@
[submodule "vendor/aster"]
path = vendor/aster
url = ssh://git@gitea.entroia.com:22222/Zayden-Jung/endorphin-aster-vm.git
Generated
+58
View File
@@ -211,6 +211,14 @@ dependencies = [
"memchr",
]
[[package]]
name = "compiler"
version = "0.1.0"
dependencies = [
"core",
"frontend",
]
[[package]]
name = "concurrent-queue"
version = "2.5.0"
@@ -220,6 +228,13 @@ dependencies = [
"crossbeam-utils",
]
[[package]]
name = "core"
version = "0.1.0"
dependencies = [
"objects",
]
[[package]]
name = "core-foundation"
version = "0.9.4"
@@ -425,6 +440,15 @@ version = "0.3.1"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "aa9a19cbb55df58761df49b23516a86d432839add4af60fc256da840f66ed35b"
[[package]]
name = "frontend"
version = "0.1.0"
dependencies = [
"peg",
"serde",
"serde_json",
]
[[package]]
name = "futures-core"
version = "0.3.34"
@@ -984,6 +1008,10 @@ dependencies = [
"objc2-foundation 0.2.2",
]
[[package]]
name = "objects"
version = "0.1.0"
[[package]]
name = "once_cell"
version = "1.21.4"
@@ -1009,6 +1037,33 @@ dependencies = [
"ttf-parser",
]
[[package]]
name = "peg"
version = "0.8.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "0aad070be5b63aa72103f2fcdd70a83adbd5e90112ce5b574171ff1c65501773"
dependencies = [
"peg-macros",
"peg-runtime",
]
[[package]]
name = "peg-macros"
version = "0.8.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "ddd8ef6825cae95355031ae26a99b616a2a21f22ba2de0197c43dfb05acbe7ee"
dependencies = [
"peg-runtime",
"proc-macro2",
"quote",
]
[[package]]
name = "peg-runtime"
version = "0.8.6"
source = "registry+https://github.com/rust-lang/crates.io-index"
checksum = "7011d97b484a5ebdc4b1fdb3b12d5e4bbbea56e9d22b688f2e79e04b65a7d8a6"
[[package]]
name = "percent-encoding"
version = "2.3.2"
@@ -1399,7 +1454,10 @@ name = "tessera"
version = "0.1.0"
dependencies = [
"anyhow",
"compiler",
"core",
"font8x8",
"frontend",
"serde",
"serde_json",
"softbuffer",
+4
View File
@@ -2,12 +2,16 @@
name = "tessera"
version = "0.1.0"
edition = "2024"
rust-version = "1.91"
description = "Cross-platform desktop rendering client"
license = "MIT OR Apache-2.0"
[dependencies]
anyhow = "1.0"
compiler = { path = "vendor/aster/crates/compiler" }
endor_core = { package = "core", path = "vendor/aster/crates/core" }
font8x8 = "0.3"
frontend = { path = "vendor/aster/crates/frontend" }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
softbuffer = "0.4.8"
+10
View File
@@ -0,0 +1,10 @@
FROM rust:1.91.1-bookworm
WORKDIR /build
RUN apt-get update && apt-get install -y --no-install-recommends pkg-config libx11-dev libxkbcommon-dev libwayland-dev libudev-dev libegl1-mesa-dev libgbm-dev \
&& rm -rf /var/lib/apt/lists/* \
&& rustup component add rustfmt clippy
ENV CARGO_BUILD_JOBS=1 CARGO_PROFILE_DEV_DEBUG=0 CARGO_PROFILE_TEST_DEBUG=0
COPY Cargo.toml Cargo.lock ./
COPY src ./src
COPY vendor ./vendor
CMD ["sh", "-eu", "-c", "cargo fmt --check && cargo test --locked && cargo clippy --all-targets --locked -- -D warnings"]
+34
View File
@@ -2,8 +2,38 @@
Tessera is a clean desktop rendering host. It starts with an empty page. Coding agents submit source code to a namespace through a local CRUD API; Tessera parses that code, builds its architecture tree, compiles it to drawing commands, and renders the result.
## Aster source dependency
[Aster](vendor/aster/README.md) is an independent Git repository checked out as a
submodule at `vendor/aster`. Tessera records its exact commit in the Git submodule
entry; `.gitmodules` records its source URL. See [vendor](vendor/README.md) for
initialization, version updates, and the checkout layout.
Cargo directly depends on Aster's `frontend`, `compiler`, and `core` library
packages through paths inside that submodule. The `core` dependency is named
`endor_core` in Tessera's manifest. These packages also bring in Aster's `objects`
package. Aster retains its own Cargo workspace and source history.
Rust 1.91 or newer is required. Building Tessera compiles the required Aster
libraries automatically; no separate Aster build or CLI/server process is
required. Tessera does not depend on Aster's storage, host, CLI, or server packages.
This change establishes the source and library dependency only. The namespace
API still uses the experimental Tessera parser described below. Executing Endor
through Aster and replacing that parser is the next implementation step; no
Aster source changes are part of this integration.
## Start
Initialize the Aster submodule first, following the SSH identity instructions in
[vendor](vendor/README.md):
```bash
git submodule update --init --recursive
```
For local native builds and window runs (automated tests run only in CI):
```bash
cargo run --release
```
@@ -72,3 +102,7 @@ The first parser intentionally supports only enough syntax to test the architect
- `gap`, `padding`, and `.title`
There are no files, HTML, CSS, JavaScript, DOM, or resource-network concepts in the runtime.
## Validation
Local Cargo builds and native window runs are allowed; do not run local tests or Docker. Automated tests and Clippy run in [.gitea](.gitea/README.md) on ces-control using Dockerfile.ci. The Linux CI checks portable code and software-renderer tests, not macOS window presentation. Aster dependency unit tests remain in Aster CI. CI bot SSH secrets are documented in .gitea/README.md.
+68
View File
@@ -0,0 +1,68 @@
# Source dependencies
| Entry | Purpose |
| --- | --- |
| `README.md` | Source checkout, version selection, and update instructions |
| [aster](aster/README.md) | Unmodified `endorphin-aster-vm` Git submodule; provides the Endor frontend, compiler, objects, and VM |
## Checkout
The Aster submodule URL is
`ssh://git@gitea.entroia.com:22222/Zayden-Jung/endorphin-aster-vm.git`.
The repository owner in this URL is separate from the authentication identity.
For this host, use only the dedicated `codex-bot` SSH identity. Set
`GIT_SSH_COMMAND` to the environment's isolated SSH command before network
operations: it must disable inherited SSH configuration (`-F /dev/null`), use
`IdentitiesOnly=yes`, select the dedicated bot key with `-i`, and use port 22222.
Do not fall back to the repository owner's credentials. The key path belongs in
the checkout environment, not in tracked project files.
From the Tessera repository root, after cloning or checking out another Tessera
revision:
```bash
git submodule update --init --recursive
git submodule status
```
Initialization fetches Aster source at the commit recorded by Tessera. It does
not build Aster or download Cargo packages. A normal clone without submodule
initialization does not populate `vendor/aster`.
## Cargo integration
Tessera's root `Cargo.toml` references the submodule's `crates/frontend`,
`crates/compiler`, and `crates/core` directories. Aster's workspace supplies
their inherited package settings and internal dependencies. Keep the submodule's
workspace intact; do not copy its crates into Tessera's workspace.
The Git submodule entry selects Aster's source revision. Tessera's root
`Cargo.lock` records the combined application dependency graph; the lockfile
inside Aster belongs to its standalone workspace. Updating Aster's lockfile does
not replace Tessera's lockfile.
In the designated build environment, building Tessera also builds the required
Aster libraries. A separate Aster executable or service is unnecessary. Runtime
validation follows the designated remote validation workflow; initializing the
submodule alone does not validate compilation or Endor execution.
## Updating Aster
Select an explicit, published Aster commit. From the Tessera root, with the bot
SSH command configured for network operations:
```bash
git -C vendor/aster fetch origin
git -C vendor/aster checkout --detach <aster-commit>
```
Review the Aster changes and reconcile Tessera's dependencies and lockfile as needed; local native compilation is allowed, while automated tests run in CI. Commit `vendor/aster` in Tessera
along with any integration changes; that records the new Aster commit. Aster
updates do not automatically advance Tessera's recorded revision.
If Aster itself needs development, make and publish those commits in its own
repository first. Configure the repository-local author as `Codex Bot` /
`codex-bot@gitea.entroia.local` before committing on this host. Then select the
published commit in Tessera. Do not point a shared Tessera revision at an
unpublished Aster commit, and do not add Tessera-specific patches to Aster as
part of this embedding work.
Vendored Submodule
+1
Submodule vendor/aster added at 55475a9d4b