ReviewOS

stacks/the-settlers-iii-remake

[S3-008] Audit Craft, stx, and HomeOS execution evidence

#24
Closed chris opened this 10 days ago ·
10 days ago

S3-008: Audit Craft, stx, and HomeOS execution evidence

Parent and ownership

Parent epic: https://github.com/stacksjs/the-settlers-iii-remake/issues/6 Source owner: stacksjs/the-settlers-iii-remake. Master roadmap: https://github.com/stacksjs/the-settlers-iii-remake/issues/4.

Problem and observable result

Classify capabilities by executed evidence. Record incomplete or absent native operations. Identify reusable algorithms and their source owners.

The current application is a browser prototype. Passing the Riverlands campaign does not establish original-game or native parity. This issue is complete only when its stated behavior has retained evidence.

Evidence and interfaces

Craft owns graphics, native hosting, and platform capabilities. stx owns compilation/reactivity. ts-css owns style semantics. Stacks owns build and release orchestration. The game consumes published contracts.

Pin the inspected revisions and fixture hashes in the implementation evidence. Original-game observations govern rules and timing. JSettlers is implementation evidence, not an authoritative balance specification. Unknown values remain explicitly unverified.

Acceptance criteria

  • Classify capabilities by executed evidence.
  • Record incomplete or absent native operations.
  • Identify reusable algorithms and their source owners.
  • The visible result agrees with the underlying simulation or platform state, including failure paths.
  • Tests exercise the maintained public interface and retain reproducible fixtures or execution receipts.

Test matrix

  • Run retained pixel and native-host checks.
  • Separate kernel boot evidence from graphical evidence.
  • Exercise invalid input, cancellation or interruption, and repeated execution where this interface permits them.
  • Verify determinism/conservation for simulation changes and resource ownership/disposal for platform changes.
  • Run owning-repository lint, relevant type checks and tests. Capture actual native output for native capability claims.

Scope constraints

Implement this behavior as a complete verifiable slice. Do not silently expand into adjacent tickets or substitute simplified gameplay. Keep the shared TypeScript simulation, shared stx signals, and ts-css conventions. Native gameplay and HUD must not depend on a WebView. HomeOS reuse must not introduce a kernel dependency into the game. Existing unrelated edits and authored guidance must be preserved.

Blocked by

None. This issue is on the initial frontier.

Upstream release and adoption

Application behavior belongs here. If a reproduction identifies a framework defect, repair and release its owning source first, update Stacks where affected, then install the verified packages here.

No node_modules edits, copied runtimes, generated-source string patches, fabricated globals, successful no-op implementations, or skipped release gates. Push tested conventional commits as Chris to the owning origin/main without coauthor trailers or force pushes.

Completion evidence

  • Implementation commits and relevant upstream issue links.
  • Exact checks and results, fixture hashes, and screenshots/native execution evidence where applicable.
  • Published package versions, downstream lockfile identity, and release receipts when affected.
  • Remaining limitations stated explicitly. Partial work does not close this issue.
10 days ago

Completed the execution-evidence audit in 7cea8b6.

  • Classify executed, incomplete and absent rendering, input, hosting and lifecycle capabilities.
  • Identify source ownership and reusable algorithms without treating HomeOS kernel execution as graphical integration.
  • Retain pixel/native-host check evidence and explicit remaining gates.

Committed audit, source-check receipt.

Craft local evidence includes 30 GPU and 47 renderer tests with actual pixels and 197/197 native build steps. stx retained 782 native tests; the published compiled-native consumer proves clock/lifecycle contracts in a controlled JavaScript VM. Craft's exact-source UIKit acceptance also passed 225 unit and 5 simulator UI tests. None of these establishes native game presentation.

S3-009/010/013/015/019/020 and HomeOS graphical adoption remain open for their full acceptance criteria. This closes the audit only.

Sign in to comment on this issue.