ReviewOS

stacks/the-settlers-iii-remake

[S3-056] Complete Roman religious and special production

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

S3-056: Complete Roman religious and special production

Parent and ownership

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

Problem and observable result

Implement wine and charcoal chains. Require Roman buildings and verified inputs. Use ordinary staffing and transport.

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

Individual units execute deterministic commands. Recruitment, damage, ownership, offerings, promotions, and interventions use versioned faction rules and physical resources.

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

  • Implement wine and charcoal chains.
  • Require Roman buildings and verified inputs.
  • Use ordinary staffing and transport.
  • 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 complete wine and charcoal production.
  • Verify resource and terrain restrictions.
  • 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

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 in d9a6bb0 (rules roman-engineering 0.5.0, digest 1db4df3c…af966).

  • Wine: the winery (4 planks, 4 stone, manual table) employs a wine-grower without a tool (manual). It plants vines only on grass whose neighbours are grass, beside a height difference of at least 2, with no vine along that slope (reference MainGrid#isWinePlantable, E). Vines ripen after nine minutes (reference Wine.java). Ripe grapes are carried home as wine through the ordinary doorstep and transport.
  • Charcoal: the charcoal maker (3 planks, 4 stone) is staffed by a charcoal burner and turns five delivered planks into one coal (manual: "From five boards the charcoal maker can make one piece of charcoal").
  • Visible result: a new Roman build category with the original building artwork; vines in three growth steps plus ripe grapes; wine piles and carried wine, all converted from the demo with provenance.

Tests (tests/unit/engine-religion.test.ts):

  • complete charcoal production with five planks per coal and a clean audit
  • vines planted only beside slopes, ripening into wine
  • a winery on flat land reporting no-space with no vines

Timing placeholders (work cycles, charcoal duration) stay U-class owned by S3-056/S3-002. Vines withering after three unharvested minutes (reference) is not modelled yet and is recorded in the objects.vine evidence.

Sign in to comment on this issue.