mr.zeroandClaude Opus 5
06f3f2a3b1
Reading the catalog, choosing the release that fits this machine, unpacking it,
writing the menu entry and remembering what went where all happen in process now.
There is no interpreter to find, no child process, and no JSON-lines protocol
between the two halves — `PythonEngineProcessRunner`, the runtime locator, the two
engine mappers and the version negotiation are all gone, and with them the one
unchecked cast this codebase had (engine stdout to a typed event).
What that buys a person: on Windows and on a fresh Mac the app simply works. It
used to look for `python3`, `python` and `py -3` and draw a link to python.org
where none answered.
What lands on disk is unchanged, deliberately. `config.json` and `state.json` keep
the shell engine's snake_case shape, its `<scope>:<name>` keys and its file modes,
so a machine whose library was installed by the CLI keeps it — verified against the
Python engine on the same catalog: the same 13-title listing with zero field
differences, byte-identical payloads, identical modes and an identical Info.plist,
and a re-sync over a Python-installed home that writes nothing. Remove, prune,
prune-suppression on a named sync and the v1 state migration were each exercised.
Three things worth knowing about the new code:
- the zip reader is ~150 lines over `node:zlib`, because Node has none and this
application has no runtime dependencies. It restores the executable bit from
each entry's external attributes, without which nothing installed can start,
and it refuses zip64, unknown compression and paths that escape the
destination rather than guessing;
- `SUPPORTED_WARP_ENGINE_VERSIONS` names the engine versions this client is
written against, checked against the `WarpEngine-Version` header every
response carries. `selectCatalogDialect` switches over that list exhaustively,
so adding a version fails the build — type checker and linter both — until
somebody says what its catalog reads like. An absent header is read as the
oldest version, which is what an engine before 0.4.0 is;
- refresh and the language picker are icons at the foot of the side menu now,
both named for a tooltip and a screen reader, the picker still a real
`<select>` under its glyph.
The repository is free of Python as well: the Makefile, the CI check and the
release script read package.json and the forge's JSON with Node.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
57 lines
1.9 KiB
TypeScript
57 lines
1.9 KiB
TypeScript
import type { SupportedWarpEngineVersion } from '../../../domain/models/WarpEngineVersion'
|
|
|
|
/**
|
|
* How one WarpEngine version's catalog is shaped.
|
|
*
|
|
* The catalog is the one thing this client reads that it does not own the shape of, so
|
|
* it is the one thing an engine version can change under it. A dialect turns that
|
|
* foreign JSON into the typed records below, and everything downstream — the survey,
|
|
* the release choice — sees only those. When a future engine renames a field or nests a
|
|
* release differently, a new dialect is the whole change.
|
|
*/
|
|
export interface CatalogDialect {
|
|
readonly version: SupportedWarpEngineVersion
|
|
/** One entry per title in the catalog. */
|
|
listEntries: (catalog: unknown) => readonly CatalogEntry[]
|
|
}
|
|
|
|
export interface CatalogEntry {
|
|
readonly software: CatalogSoftware
|
|
/**
|
|
* The release the catalog itself calls newest-and-stable, or null when it names none.
|
|
*
|
|
* Kept separate from the candidates because it is also what an unavailable title's
|
|
* card shows a version from — and a catalog with releases but no `latestRelease` has
|
|
* nothing to show there.
|
|
*/
|
|
readonly latestRelease: CatalogRelease | null
|
|
/**
|
|
* Every release worth trying, newest first and deduplicated.
|
|
*
|
|
* `latestRelease` comes first where there is one, then the rest, so that a game whose
|
|
* newest build is missing an asset still installs from an older one.
|
|
*/
|
|
readonly releaseCandidates: readonly CatalogRelease[]
|
|
}
|
|
|
|
export interface CatalogSoftware {
|
|
readonly name: string
|
|
readonly title: string
|
|
readonly platform: string
|
|
readonly status: string
|
|
readonly description: string
|
|
readonly author: string
|
|
readonly imageUrl: string | null
|
|
}
|
|
|
|
export interface CatalogRelease {
|
|
readonly version: string
|
|
readonly createdAt: string | null
|
|
readonly assets: readonly CatalogAsset[]
|
|
}
|
|
|
|
export interface CatalogAsset {
|
|
readonly kind: string
|
|
readonly path: string
|
|
}
|