Mine for developers. Shafts are environments, ore is data, pickaxes are queries, cave-ins are outages, canaries are canary deploys.
  • JavaScript 100%
Find a file
2026-06-30 11:14:38 +00:00
node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709 test: add e2e tests 2026-06-28 11:10:27 +00:00
src feat(#1): mine engine — shafts, ore veins, miners, canaries, cave-ins, ASCII mine 2026-06-15 18:37:33 +00:00
tests fix: e2e tests now use CommonJS require for node --test compatibility 2026-06-30 11:14:35 +00:00
package.json feat(#1): mine engine — shafts, ore veins, miners, canaries, cave-ins, ASCII mine 2026-06-15 18:37:33 +00:00
README.md feat(#1): mine engine — shafts, ore veins, miners, canaries, cave-ins, ASCII mine 2026-06-15 18:37:33 +00:00

code-mine

Mine for developers. Shafts are environments, ore is data, pickaxes are queries, cave-ins are outages, canaries are canary deploys.

Usage

const { Mine, ORE_TYPES, SHAFT_TYPES } = require('./src/mine');

const mine = new Mine('Deep Data Mine');
mine.setForeman('Boss');
mine.hireMiner('Alice', 5);
mine.hireMiner('Bob', 3);

// Assign miners
mine.assignMiner('Alice', 'prod');
mine.assignMiner('Bob', 'dev');

// Dig deeper
mine.digShaft('prod');
mine.digShaft('prod');

// Place canary for safety
mine.placeCanary('prod');

// Mine ore veins
mine.mineVein('prod', 'Alice', 0);

console.log(mine.mineView());
console.log(mine.report());

Ore Types

  • Gold (User Data) — value 100, precious but regulated
  • Iron (Log Data) — value 15, common, structural
  • Diamond (Critical Config) — value 500, extremely rare
  • Coal (Telemetry) — value 5, abundant, pollutes
  • Copper (API Responses) — value 30, steady supply
  • Silver (Session Tokens) — value 60, expires

Shaft Types

  • Dev Shaft — max 50m, stability 90%, safe
  • Staging Shaft — max 100m, stability 75%
  • Production Shaft — max 200m, stability 60%, real danger

Components

  • Shaft — Depth/stability/ventilation/gas, vein discovery, collapse system
  • Miner — Pickaxe power, cargo, skill upgrades, health/energy
  • OreVein — 6 ore types with hardness/extraction mechanics
  • Canary — Gas/bug detection, health degradation as early warning
  • Mine — Foreman, multi-shaft management, ASCII cross-section