51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
# Project Kiln
|
||
|
||
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 0–3 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 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 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 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`. Native manifest setup is documented in
|
||
`docs/phase-2/native-manifests.md`; completed Steam discovery evidence is under
|
||
`docs/phase-3/`.
|