## Data Sources & Attribution

- Tarkov.dev API: `https://api.tarkov.dev/graphql`
- Escape from Tarkov Wiki (community-maintained): `https://escapefromtarkov.fandom.com/wiki/Escape_from_Tarkov_Wiki`

Attribution guidance:

- Use these sources for lookup and summarization, not bulk republication.
- Link/cite relevant pages when giving wiki-derived specifics.
- Keep excerpts minimal and practical.
- Remind users to verify critical details in-game after patches.

## Knowledge Source Policy (Important)

For gameplay answers, treat data sources like this:

1. **Tarkov API = primary structured source**
   - Use for prices, tasks, map/boss fields, and machine-consistent values.
2. **EFT Wiki = reference validation layer (conditional)**
   - Use wiki only when: (a) user asks for wiki-confirmed details, (b) API output is missing/ambiguous, or (c) patch-sensitive context benefits from a recency check.
3. **If API and wiki differ**
   - Say they differ, prefer the most recently updated source, and call out uncertainty.
4. **For task questions (default behavior)**
   - Start with API summary, then optionally confirm with wiki if needed. Provide objective summary, requirement chain, reward summary, and a “verify in-game if recently patched” note.

Do not fetch wiki by default for every request. Keep wiki calls purposeful and minimal.

## Hardcore Workflow Patterns

### 1) Raid viability check (2-minute pre-raid)

1. `status`
2. `map-bosses --map-name <map>`
3. `ammo-compare --names <loadout ammo options>`
4. Recommend a final ammo pick based on penetration, damage, and current market price.

### 2) Loot-to-ruble optimization

1. `item-price --name <item>`
2. Compare flea/trader sell routes shown by script.
3. Call out best immediate sell route and expected rubles.

### 3) Quest progress unblock

1. `task-lookup --name <quest fragment>`
2. Extract prerequisite tasks and map/trader context.
3. Give an ordered “do this next” checklist.

### 4) Stash net-worth snapshot

1. Prepare local JSON or CSV stash list (`name,count`).
2. Run `stash-value --items-file <path>`.
3. Report low/avg/best valuation bands and unmatched items.

### 5) Trader flip scan (gross)

1. Run `trader-flip --name <search seed> --min-spread <rubles>`.
2. Sort by spread and ROI.
3. Add caution: fees, buy limits, and market movement can erase edge.

### 6) Objective-weighted map risk

1. Run `map-risk --map-name <map> --task-focus <your tasks>`.
2. Combine boss pressure + task overlap score.
3. Use score to decide kit value and route aggression.

### 7) Automated raid-kit posture

1. Run `raid-kit --map-name <map> --ammo-names <options> --task-focus <optional>`.
2. Use recommended ammo + posture (`SURVIVE-FIRST`, `BALANCED`, or `AGGRESSION-WINDOW`).
3. Align armor/meds/utility guidance to your bankroll and objective urgency.

### 8) Live wiki copilot

1. `wiki-search --query <task/item>` to find exact page title.
2. `wiki-intro --title <page>` to get fast context and latest editor/update timestamp.
3. `wiki-recent --limit <N>` before long sessions to spot newly changed mechanics pages.

## Output Style Expectations

When replying to users, provide:

- **Actionable summary first** (what to do now)
- **Data evidence second** (key values from API)
- **Risk note third** (market volatility / spawn chance uncertainty / version drift)

Example style:

- “Run M855A1 today: best pen-to-price among your options.”
- “Sell route: Therapist beats flea by ~X₽ after fees (verify in-game before bulk dump).”
- “Boss chance is probabilistic; don’t hard-commit your raid plan to one spawn.”

## Raw Query Mode (Power Users)

Use only when preset commands do not cover the need:

# Is Tarkov backend healthy?
python3 skills/tarkov-api/scripts/tarkov_api.py status

# Find items and current market shape
python3 skills/tarkov-api/scripts/tarkov_api.py item-search --name "ledx" --game-mode regular --limit 10

# Deep item price + best sell routes
python3 skills/tarkov-api/scripts/tarkov_api.py item-price --name "graphics card"

# Compare ammo choices
python3 skills/tarkov-api/scripts/tarkov_api.py ammo-compare --names "5.56x45mm M855A1" "5.56x45mm M856A1" "5.56x45mm M995"

# Find quest prerequisites quickly
python3 skills/tarkov-api/scripts/tarkov_api.py task-lookup --name "gunsmith"

# Boss scouting for a map
python3 skills/tarkov-api/scripts/tarkov_api.py map-bosses --map-name "Customs"

# Stash value from JSON list [{"name":"LEDX Skin Transilluminator","count":1}, ...]
python3 skills/tarkov-api/scripts/tarkov_api.py stash-value --items-file /path/stash.json

# Flip scan for a category/search term
python3 skills/tarkov-api/scripts/tarkov_api.py trader-flip --name "ammo" --min-spread 15000 --top 15

# Map risk score with your active task focus
python3 skills/tarkov-api/scripts/tarkov_api.py map-risk --map-name "Customs" --task-focus "setup" "bullshit"

# Full raid-kit recommendation from map + ammo options
python3 skills/tarkov-api/scripts/tarkov_api.py raid-kit --map-name "Customs" --ammo-names "5.56x45mm M855A1" "5.56x45mm M856A1" "5.56x45mm M995" --task-focus "setup"

# Wiki page search during raid prep
python3 skills/tarkov-api/scripts/tarkov_api.py wiki-search --query "Gunsmith Part 1" --limit 5

# Quick wiki intro + latest edit metadata for a page
python3 skills/tarkov-api/scripts/tarkov_api.py wiki-intro --title "LEDX Skin Transilluminator"

# Track latest wiki edits (articles)
python3 skills/tarkov-api/scripts/tarkov_api.py wiki-recent --limit 10

python3 skills/tarkov-api/scripts/tarkov_api.py raw \
  --query-file /tmp/query.graphql \
  --variables '{"name":"bitcoin","lang":"en","gm":"regular","limit":5}'