feat: complete native execution and Steam discovery

This commit is contained in:
2026-07-18 20:11:52 -04:00
parent 514f87dacb
commit bc0090c63d
42 changed files with 6403 additions and 97 deletions
+30 -8
View File
@@ -1,28 +1,50 @@
# Project Kiln
Private Phase 0 scaffold for the CLI-first Arch gaming OS. `Kiln` and every
Private implementation of the CLI-first Arch gaming OS. `Kiln` and every
`kiln-*` identifier are temporary repository-local names, not public compatibility
promises.
## Status
Phases 03 are complete: repository gates, shared contracts, native discovery/execution,
and read-only Steam discovery. Phase 4 adds Steam launch planning and representative
native/Proton execution. The Steam commands below currently read metadata only; they do
not start Steam or launch games.
## Current proof
The workspace contains a dependency-free Rust core and CLI smoke path. Rust 1.85 is
the minimum supported compiler because it introduced Edition 2024; development and CI
remain pinned to the reviewed Rust 1.97.1 toolchain:
The workspace contains the shared Rust core, native and read-only Steam adapters, and
CLI. Local development, verification, and the minimum supported compiler are pinned to
Rust 1.97.1:
```text
kiln version
kiln doctor
kiln doctor --json
kiln list
kiln search <query>
kiln info <id-or-name>
kiln launch <id-or-name> --dry-run
kiln list --provider steam
kiln search <query> --provider steam
kiln scan --provider steam
kiln info steam:<app-id>
kiln config defaults
kiln config validate
kiln config explain --json
```
Run deterministic repository and Rust gates with `make verify`. Run only the
Run the complete local gate with `make check`. Run deterministic repository and Rust
gates without the network-backed audit with `make verify`. Run only the
environment-independent repository checks with `make static`. Run the separately
versioned, network-backed dependency advisory/license/source audit with `make audit`.
Rust 1.97.1 is pinned.
Gitea stores the source repository but does not compile or test it. Local evidence is
recorded before pushes and releases.
The active specification is under `docs/spec/`. Start with
`docs/spec/00_SPEC_INDEX.md`; the archived monolith is intentionally excluded.
Local Codex CLI work starts with `AGENTS.md`. The initial bounded Phase 1 brief is
`docs/handoff/phase-1-codex-cli.md`.
Local Codex CLI work starts with `AGENTS.md`. Native manifest setup is documented in
`docs/phase-2/native-manifests.md`; completed Steam discovery evidence is under
`docs/phase-3/`.