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
9 changes: 9 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ This pack contains:
- `docs/AETHER_LEDGER.md` — proof provenance and governance records.
- `docs/ROADMAP.md` — build phases and milestones.
- `docs/SPEC_TRACEABILITY.md` — ordered section 13 gap register and closeout evidence.
- `docs/CONSOLE.md` — local visual console for candidates, artifacts, job queue, and operator commands.
- `schemas/laxcert_candidate.schema.json` — JSON schema for emitted candidate certificates.
- `python/laxforge_laxcert/emitter_contract.py` — typed Python-side contract sketch.
- `lean/` — Lean project skeleton and illustrative module boundaries.
Expand Down Expand Up @@ -71,6 +72,14 @@ python -m laxforge_laxcert.emitter_contract artifacts/LaxforgeAKNSD2TransportZer
python -m laxforge_laxcert.emitter_contract candidates/false_wrong_sign.json --repo-root . --expect-failure
```

Local visual console:

```bash
python -m laxforge_laxcert.console_server --repo-root .
```

Open `http://127.0.0.1:8765` to inspect candidates, proof artifacts, the command queue, Lake/Pytest runs, and certifier results.

For Lean/mathlib dependency refreshes, prefer WSL native storage rather than
building from `/mnt/<drive>`. A reliable workflow is:

Expand Down
31 changes: 31 additions & 0 deletions docs/CONSOLE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,31 @@
# LAXCERT Visual Console

The LAXCERT console is a local browser UI for inspecting candidate inputs, proof artifacts, job history, and explicit proof commands. It is intentionally repository-local and runs on `127.0.0.1` by default.

Start it from the repository root:

```bash
python -m laxforge_laxcert.console_server --repo-root .
```

or, after installing the package:

```bash
laxcert-console --repo-root .
```

Then open:

```text
http://127.0.0.1:8765
```

The console currently exposes these operator commands:

- `Validate Schema` resolves an internal candidate JSON, external LAXFORGE artifact directory, or manifest and runs schema plus semantic validation.
- `Certify Candidate` normalizes the candidate, emits Lean, runs Lake, and writes `artifacts/<candidate_id>/proof-status.json`.
- `Certify Expected Failure` passes only when a candidate is rejected or fails to prove.
- `Lake Build` runs `lake -R build LaxCert`.
- `Pytest` runs the Python regression suite.

The UI reads candidate JSON from `candidates/*.json` and committed artifact inputs from `artifacts/*/candidate.json`. The command input accepts repository-relative paths such as `candidates/toy_lax_zero.json` and absolute paths to externally produced LAXFORGE artifact directories.
6 changes: 6 additions & 0 deletions pyproject.toml
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,9 @@ dependencies = [
"jsonschema>=4.22",
]

[project.scripts]
laxcert-console = "laxforge_laxcert.console_server:main"

[project.optional-dependencies]
test = [
"pytest>=8",
Expand All @@ -19,5 +22,8 @@ test = [
[tool.setuptools.packages.find]
where = ["python"]

[tool.setuptools.package-data]
laxforge_laxcert = ["console_static/*"]

[tool.pytest.ini_options]
testpaths = ["tests"]
Loading
Loading