Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
2 changes: 1 addition & 1 deletion .github/workflows/hermes-drift.yml
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ jobs:
env:
HERMES_AGENT_PATH: ${{ github.workspace }}/.hermes-agent-upstream
run: |
just test-contract-upstream > contract.log 2>&1
mise run test-contract-upstream > contract.log 2>&1
echo "EXIT=$?" >> contract.log
continue-on-error: true
# `outcome` is the result before continue-on-error is applied;
Expand Down
10 changes: 5 additions & 5 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -62,7 +62,7 @@ jobs:
- name: Attach the exact trigger to local main
env:
EXPECTED_SHA: ${{ github.sha }}
run: just release-attach-trigger
run: mise run release-attach-trigger
- name: Install the frozen release toolchain
run: uv sync --frozen
- name: Validate the tagged baseline and strict release intent
Expand Down Expand Up @@ -208,7 +208,7 @@ jobs:
run: |
test "$(git rev-parse HEAD)" = "$RELEASE_SHA"
test -z "$(git status --porcelain --untracked-files=no)"
just test
mise run test
test "$(git rev-parse HEAD)" = "$RELEASE_SHA"
test "$(git rev-parse HEAD^)" = "$TRIGGER_SHA"
test "$(git rev-list -n 1 "$TAG")" = "$RELEASE_SHA"
Expand Down Expand Up @@ -268,7 +268,7 @@ jobs:
run: |
test "$(git rev-parse HEAD)" = "$RELEASE_SHA"
test -z "$(git status --porcelain --untracked-files=no)"
just test-contract-pinned
mise run test-contract-pinned
# Record the revision actually exercised, from the checkout the
# pinned lane created -- not the constant, so the evidence reflects
# what ran. Cross-check it against the constant so a renamed
Expand Down Expand Up @@ -351,8 +351,8 @@ jobs:
run: |
test "$(git rev-parse HEAD)" = "$RELEASE_SHA"
test -z "$(git status --porcelain --untracked-files=no)"
just build
just check-dist
mise run build
mise run check-dist
test "$(git rev-parse HEAD)" = "$RELEASE_SHA"
test "$(git rev-parse HEAD^)" = "$TRIGGER_SHA"
test "$(git rev-list -n 1 "$TAG")" = "$RELEASE_SHA"
Expand Down
10 changes: 5 additions & 5 deletions .github/workflows/test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ jobs:
# the action still verifies it against mise's signed checksums.
version: "2026.10.18"
- name: Run unittest suite
run: just test
run: mise run test

package:
runs-on: ubuntu-latest
Expand All @@ -35,13 +35,13 @@ jobs:
version: "2026.10.18"
- name: Build and validate package metadata
run: |
just build
just check-dist
mise run build
mise run check-dist
# `twine check` reads metadata and never opens the archive, so it passes
# on a wheel that is missing a module entirely. Installing and importing
# is the only thing that catches that.
- name: Prove the public surface imports from the installed wheel
run: just check-install
run: mise run check-install

# Amber admission gates on the exact deployed Hermes fork contract. Keep the
# immutable revision aligned with infra's candidate image/source receipt.
Expand Down Expand Up @@ -74,4 +74,4 @@ jobs:
run: |
test "$(git -C "$HERMES_AGENT_PATH" rev-parse HEAD)" = \
"$DEPLOYED_HERMES_REVISION"
just test-contract-pinned
mise run test-contract-pinned
7 changes: 4 additions & 3 deletions AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -73,12 +73,13 @@ plugin.
and recovery dispatch on `get_tool_schemas` / `handle_tool_call`; do not
duplicate native engine tools through `@tool`.
- Redact secret-looking values in logs and avoid logging full untrusted payloads.
- Get Python, `uv` and `just` from `mise.toml` and `mise.lock`
- Get Python and `uv` from `mise.toml` and `mise.lock`
(`mise trust && mise install --locked`), the same toolchain CI installs;
after changing a tool pin, regenerate the lock with
`mise lock --platform linux-x64,linux-arm64,macos-arm64`. Then use the
`justfile` for local development: `just install`, `just test`,
`just test-one tests.test_kit.SchemaConventionTests`, and `just build`.
mise tasks for local development (`mise tasks ls` lists them; one-line tasks
live in `mise.toml`, longer ones in `mise-tasks/`): `mise run install`, `mise run test`,
`mise run test-one tests.test_kit.SchemaConventionTests`, and `mise run build`.

## Release Notes

Expand Down
20 changes: 10 additions & 10 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -867,9 +867,9 @@ so the linked directory is self-contained.

## Development

Uses [mise](https://mise.jdx.dev/) to install the pinned Python,
[uv](https://docs.astral.sh/uv/) and [Just](https://github.com/casey/just)
from `mise.toml` and `mise.lock`, the same toolchain CI installs. Once per
Uses [mise](https://mise.jdx.dev/) to install the pinned Python and
[uv](https://docs.astral.sh/uv/) from `mise.toml` and `mise.lock`, the same
toolchain CI installs, and to run the project's tasks. Once per
checkout:

```bash
Expand All @@ -879,13 +879,13 @@ mise trust && mise install --locked
Then:

```bash
just install # uv sync — create/sync the dev environment
just test # uv run python -m unittest discover -s tests
just test-one tests.test_kit.SchemaConventionTests
just test-release # release intent, artifact identity, and workflow contracts
just test-contract # real upstream Hermes contract
just build # uv build — wheel + sdist
just check-dist # validate wheel/sdist metadata with twine
mise run install # uv sync — create/sync the dev environment
mise run test # uv run python -m unittest discover -s tests
mise run test-one tests.test_kit.SchemaConventionTests
mise run test-release # release intent, artifact identity, and workflow contracts
mise run test-contract # real upstream Hermes contract
mise run build # uv build — wheel + sdist
mise run check-dist # validate wheel/sdist metadata with twine
```

CI pins every Action to an immutable commit and runs the unit, package metadata,
Expand Down
228 changes: 0 additions & 228 deletions justfile

This file was deleted.

26 changes: 26 additions & 0 deletions mise-tasks/check-install
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
#!/usr/bin/env bash
#MISE description="Prove every public name imports from an installed wheel, not just the source tree"
#MISE depends=["build"]
# `twine check` validates metadata and never opens the archive, so it cannot see
# a module missing from the build. Only installing and importing can.
set -euo pipefail
wheel="$(ls dist/*.whl | head -n1)"
test -n "$wheel" || { echo "no wheel in dist/" >&2; exit 1; }
workdir="$(mktemp -d)"
trap 'rm -rf "$workdir"' EXIT
# --no-project keeps the source tree off sys.path, so a name that only
# resolves in-tree fails here instead of passing by accident.
repo="$PWD"
cat > "$workdir/probe.py" <<'PROBE'
import hermes_plugin_kit as hpk
missing = sorted(n for n in hpk.__all__ if not hasattr(hpk, n))
if missing:
raise SystemExit("not importable from the installed wheel: " + ", ".join(missing))
import hermes_plugin_kit.testing as t
t.RecordingPluginContext(name="install-probe")
print("installed wheel exports", len(hpk.__all__), "names; harness constructs")
PROBE
cd "$workdir"
"$UV" venv --quiet .venv
VIRTUAL_ENV="$workdir/.venv" "$UV" pip install --quiet "$repo/$wheel"
VIRTUAL_ENV="$workdir/.venv" "$UV" run --no-project python probe.py
Loading
Loading