52 lines
1.8 KiB
Markdown
52 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–4 are complete: repository gates, shared contracts, native discovery/execution,
|
||
Steam discovery, typed Steam launch planning, and representative native/Proton execution.
|
||
Phase 5 proves the minimal graphical session and recovery path.
|
||
|
||
## Current proof
|
||
|
||
The workspace contains the shared Rust core, native and 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 launch steam:<app-id> --dry-run
|
||
kiln launch 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/`; completed Steam execution evidence is under `docs/phase-4/`.
|