Update 69: fluxer-proto update manifest, channels and release versions #431

Closed
opened 2026-11-13 07:49:09 +00:00 by charles · 0 comments
Owner

Plan: docs/superpowers/plans/2026-11-12-textchat.md, section "Task 69" (Auto-update, added 2026-11-13 at Charles's request). Design: docs/superpowers/specs/2026-11-13-fluxer-native-autoupdate-design.md.

Task 69: fluxer-proto update manifest, channels and release versions

Issue: (to be created)
Closes: none.

Files:

  • Create: crates/fluxer-proto/src/update.rs, fixtures/update/{nightly_v1.json,stable_v1.json,future_fields.json,schema_2.json,bad_sha.json,foreign_origin.json,http_not_loopback.json,http_loopback.json,unknown_kind.json,missing_platform.json,bad_version.json,oversize.json,relative_url.json}
  • Modify: crates/fluxer-proto/src/lib.rs, crates/fluxer-proto/README.md
  • Test: crates/fluxer-proto/tests/update.rs

Interfaces:

  • Produces: ReleaseVersion { year: u16, mmdd: u16, n: u32 } with FromStr (strict ^\d{4}\.\d{4}\.\d+$, MMDD with its zero padding, rejects 0.0.0-dev+…), Display (round-trips, zero-padded MMDD), Ord in field order; Channel { Nightly, Stable } (serde lowercase, Display, ALL); PlatformKey { LinuxX86_64, WindowsX86_64, Other(String) } (serde linux-x86_64, windows-x86_64) with PlatformKey::current() -> Option<PlatformKey> (cfg! only, no I/O); AssetKind { AppImage, Exe, Zip, Unknown(String) }; Asset { name, url: Url, sha256: [u8; 32], size: u64, kind: AssetKind }; Manifest { schema: u32, channel: Channel, version: ReleaseVersion, commit: String, branch: Option<String>, published_at: String, notes_url: Option<Url>, minimum_version: Option<ReleaseVersion>, assets: BTreeMap<PlatformKey, Asset> } with Manifest::asset_for(&PlatformKey) -> Option<&Asset>.

  • Produces: parse_manifest(bytes: &[u8], feed_url: &Url, expected: Channel) -> Result<Manifest, ManifestError> applying every rule of update §3.2 — UnsupportedSchema(u32), Json(String), BadVersion, BadCommit, ChannelMismatch, BadAsset { platform, reason: AssetProblem } with AssetProblem { Sha256, Size, Name, Origin, Scheme, Url }; unknown fields and unknown platform keys ignored; an asset with an unknown kind parses (as Unknown); a relative asset url is resolved against feed_url and must stay on its origin; http only for loopback hosts; MAX_ASSET_SIZE = 1 GiB. Never panics on any input.

  • Produces: SCHEMA_VERSION: u32 = 1; ASSET_NAME_PATTERN doc'd as [A-Za-z0-9._+-]{1,128}, no leading dot.

  • Step 1: Write failing tests: nightly_fixture_parses, stable_fixture_parses, unknown_fields_and_platforms_are_ignored, schema_2_is_unsupported, bad_sha_is_rejected, foreign_origin_is_rejected, http_only_on_loopback, relative_url_resolves_against_the_feed, unknown_kind_parses_as_unknown, missing_platform_has_no_asset, bad_version_is_rejected, oversize_asset_is_rejected, asset_name_with_path_separator_is_rejected, channel_must_match_the_feed, release_version_parses_and_displays_zero_padded, release_version_rejects_dev_versions, release_versions_order_by_year_date_then_run, version_roundtrip_proptest, parse_manifest_never_panics_proptest, platform_key_current_matches_cfg.

  • Step 2: Run them, see them fail.

  • Step 3: Implement update.rs (serde with a raw intermediate struct, then validation into the typed Manifest).

  • Step 4: Run FLUXER_SCREENSHOT_TESTS=1 cargo xtask ci, see it pass.

  • Step 5: Commit feat(proto): update manifest, channels and release versions.

🤖 Generated with Claude Code

Plan: `docs/superpowers/plans/2026-11-12-textchat.md`, section "Task 69" (Auto-update, added 2026-11-13 at Charles's request). Design: `docs/superpowers/specs/2026-11-13-fluxer-native-autoupdate-design.md`. ### Task 69: `fluxer-proto` update manifest, channels and release versions **Issue:** (to be created) **Closes:** none. **Files:** - Create: `crates/fluxer-proto/src/update.rs`, `fixtures/update/{nightly_v1.json,stable_v1.json,future_fields.json,schema_2.json,bad_sha.json,foreign_origin.json,http_not_loopback.json,http_loopback.json,unknown_kind.json,missing_platform.json,bad_version.json,oversize.json,relative_url.json}` - Modify: `crates/fluxer-proto/src/lib.rs`, `crates/fluxer-proto/README.md` - Test: `crates/fluxer-proto/tests/update.rs` **Interfaces:** - Produces: `ReleaseVersion { year: u16, mmdd: u16, n: u32 }` with `FromStr` (strict `^\d{4}\.\d{4}\.\d+$`, `MMDD` with its zero padding, rejects `0.0.0-dev+…`), `Display` (round-trips, zero-padded `MMDD`), `Ord` in field order; `Channel { Nightly, Stable }` (serde lowercase, `Display`, `ALL`); `PlatformKey { LinuxX86_64, WindowsX86_64, Other(String) }` (serde `linux-x86_64`, `windows-x86_64`) with `PlatformKey::current() -> Option<PlatformKey>` (`cfg!` only, no I/O); `AssetKind { AppImage, Exe, Zip, Unknown(String) }`; `Asset { name, url: Url, sha256: [u8; 32], size: u64, kind: AssetKind }`; `Manifest { schema: u32, channel: Channel, version: ReleaseVersion, commit: String, branch: Option<String>, published_at: String, notes_url: Option<Url>, minimum_version: Option<ReleaseVersion>, assets: BTreeMap<PlatformKey, Asset> }` with `Manifest::asset_for(&PlatformKey) -> Option<&Asset>`. - Produces: `parse_manifest(bytes: &[u8], feed_url: &Url, expected: Channel) -> Result<Manifest, ManifestError>` applying every rule of update §3.2 — `UnsupportedSchema(u32)`, `Json(String)`, `BadVersion`, `BadCommit`, `ChannelMismatch`, `BadAsset { platform, reason: AssetProblem }` with `AssetProblem { Sha256, Size, Name, Origin, Scheme, Url }`; unknown fields and unknown platform keys ignored; an asset with an unknown `kind` parses (as `Unknown`); a relative asset `url` is resolved against `feed_url` and must stay on its origin; `http` only for loopback hosts; `MAX_ASSET_SIZE = 1 GiB`. Never panics on any input. - Produces: `SCHEMA_VERSION: u32 = 1`; `ASSET_NAME_PATTERN` doc'd as `[A-Za-z0-9._+-]{1,128}`, no leading dot. - [ ] **Step 1: Write failing tests**: `nightly_fixture_parses`, `stable_fixture_parses`, `unknown_fields_and_platforms_are_ignored`, `schema_2_is_unsupported`, `bad_sha_is_rejected`, `foreign_origin_is_rejected`, `http_only_on_loopback`, `relative_url_resolves_against_the_feed`, `unknown_kind_parses_as_unknown`, `missing_platform_has_no_asset`, `bad_version_is_rejected`, `oversize_asset_is_rejected`, `asset_name_with_path_separator_is_rejected`, `channel_must_match_the_feed`, `release_version_parses_and_displays_zero_padded`, `release_version_rejects_dev_versions`, `release_versions_order_by_year_date_then_run`, `version_roundtrip_proptest`, `parse_manifest_never_panics_proptest`, `platform_key_current_matches_cfg`. - [ ] **Step 2: Run them, see them fail.** - [ ] **Step 3: Implement** `update.rs` (serde with a raw intermediate struct, then validation into the typed `Manifest`). - [ ] **Step 4: Run `FLUXER_SCREENSHOT_TESTS=1 cargo xtask ci`, see it pass.** - [ ] **Step 5: Commit** `feat(proto): update manifest, channels and release versions`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
charles added this to the Text chat milestone 2026-11-13 07:49:09 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#431
No description provided.