Resolve a requested item into make, buy, and capable-crafter paths #180

New issue

Closed

opened 2026-07-29 06:25:30 +00:00 by coilyco-ops · 0 comments

coilyco-ops commented

2026-07-29 06:25:30 +00:00

Member

Context

The three-month Sirens stressor sweep found recurring player questions: “who can make this?”, “what am I missing?”, and “is it available anywhere?”. These are currently answered through chat despite Eco App already holding recipe, jobs, stores, and market data.

What to build

From a selected item, provide one read-only resolver that answers:

Make: viable recipe variants, required station/specialty, and missing inputs.
Buy: current offers and relevant recent market evidence.
Find a crafter: citizens with the required specialty, using the existing jobs data and its stated coverage limits.

The resolver must link to the item-focused pricing explanation rather than duplicate pricing logic.

Acceptance criteria

A player can reach the resolver from an item or recipe and use a shareable item deep link.
The page clearly separates make, buy, and capable-crafter paths.
Each path reports unavailable, incomplete, or unknown data explicitly rather than implying availability.
Required specialty, station, and direct recipe inputs are shown for each make path.
The capable-crafter result uses only the observed jobs roster and labels its scope/recency.
The resolver links to the canonical item-pricing explanation for cost and market rationale.
Tests cover an item with all paths, a no-crafter item, an unlisted item, and degraded upstream data.
docs/FEATURES.md documents the player workflow.

Blocked by

Blocked by #177, which establishes the canonical item-pricing explanation.

State and safety boundary

Read-only recipes, jobs, stores, and market data only. Do not create work orders, message players, alter store listings, or persist a player request.

Non-goals

Claiming a citizen is online, willing, or able to fulfill an order now.
A task-assignment or marketplace workflow.
A replacement for Eco Calc’s manually configured calculator.

## Context The three-month Sirens stressor sweep found recurring player questions: “who can make this?”, “what am I missing?”, and “is it available anywhere?”. These are currently answered through chat despite Eco App already holding recipe, jobs, stores, and market data. ## What to build From a selected item, provide one read-only resolver that answers: - **Make:** viable recipe variants, required station/specialty, and missing inputs. - **Buy:** current offers and relevant recent market evidence. - **Find a crafter:** citizens with the required specialty, using the existing jobs data and its stated coverage limits. The resolver must link to the item-focused pricing explanation rather than duplicate pricing logic. ## Acceptance criteria - [ ] A player can reach the resolver from an item or recipe and use a shareable item deep link. - [ ] The page clearly separates make, buy, and capable-crafter paths. - [ ] Each path reports unavailable, incomplete, or unknown data explicitly rather than implying availability. - [ ] Required specialty, station, and direct recipe inputs are shown for each make path. - [ ] The capable-crafter result uses only the observed jobs roster and labels its scope/recency. - [ ] The resolver links to the canonical item-pricing explanation for cost and market rationale. - [ ] Tests cover an item with all paths, a no-crafter item, an unlisted item, and degraded upstream data. - [ ] `docs/FEATURES.md` documents the player workflow. ## Blocked by - Blocked by https://forgejo.coilysiren.me/coilyco-gaming/eco-app/issues/177, which establishes the canonical item-pricing explanation. ## State and safety boundary Read-only recipes, jobs, stores, and market data only. Do not create work orders, message players, alter store listings, or persist a player request. ## Non-goals - Claiming a citizen is online, willing, or able to fulfill an order now. - A task-assignment or marketplace workflow. - A replacement for Eco Calc’s manually configured calculator.

coilyco-ops added the

autonomy

headless

priority

labels

2026-07-29 06:26:31 +00:00

coilyco-ops referenced this issue from a commit

2026-08-01 01:05:06 +00:00

feat: add item make-buy-crafter resolver closes #177 closes #180

coilyco-ops closed this issue

2026-08-01 01:05:06 +00:00