Cat Wars Admin Console

Super Admin controls for economy and market-force tuning.

Back to Game

\n\n

Overview

\n\n

Markets

\n \n \n \n

ID	Name	Region Risk	Action

\n\n

Breeds

\n \n \n \n

ID	Name	Base Price	Volatility	Legal Risk	Action

\n\n

\n\n \n\n`;\n}\n\nfunction htmlPage(): string {\n return `\n\n\n \n \n Cat Wars 2029\n \n\n\n \n

CAT WARS 2029

[ underground feline exchange terminal ] [ best viewed with CRT monitor vibes ]

\n\n

Street Terminal

\n\n

The Situation

It is 2029. The federal government has outlawed felines nationwide. Cat ownership is now contraband, and the Department of Homeland Security runs aggressive interdiction sweeps across major U.S. cities.

You are an underground courier in a black-market trading ring. Your job is to jet city-to-city, buy cat breeds where prices are low, and sell where prices spike before DHS heat catches up.

How The Game Works

Register or log in to start your run.
Each market has different breed prices each day.
Buy low, travel, then sell high for profit.
Traveling raises Heat and can trigger a DHS bust.
Busts can seize cargo and force cash fines.
Use profits to pay down debt and stay solvent.

\n\n

\n \n \n

\n\n \n\n

DHS BUST IN PROGRESS :: CARGO SEIZURE + FINES APPLIED

VISITOR COUNTER 000042

\n\n \n\n`;\n}\n\n// --- Global middleware ---\napp.use(\"*\", async (_c, next) => {\n await initDb();\n await next();\n});\n\n// --- Page route ---\napp.get(\"/\", (c) => c.html(htmlPage()));\n\napp.get(\"/admin\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return c.text(\"Unauthorized\", 401);\n if (!isAdmin(user)) return c.text(\"Forbidden\", 403);\n return c.html(adminPage());\n});\n\n// --- Admin APIs ---\napp.get(\"/api/admin/overview\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n if (!isAdmin(user)) return jsonError(\"Forbidden\", 403);\n\n const overview = await getAdminOverview();\n return c.json({ ok: true, overview });\n});\n\napp.get(\"/api/admin/markets\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n if (!isAdmin(user)) return jsonError(\"Forbidden\", 403);\n\n const markets = await getMarkets();\n return c.json({ ok: true, markets });\n});\n\napp.post(\"/api/admin/markets/:marketId\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n if (!isAdmin(user)) return jsonError(\"Forbidden\", 403);\n\n const marketId = Number(c.req.param(\"marketId\"));\n if (!Number.isFinite(marketId)) return jsonError(\"Invalid market id.\");\n\n const body = await c.req.json().catch(() => null);\n const regionRisk = Number(body?.region_risk);\n if (!Number.isFinite(regionRisk) || regionRisk < 0 || regionRisk > 1) {\n return jsonError(\"region_risk must be between 0 and 1.\");\n }\n\n await sqlite.execute(\n `UPDATE markets SET region_risk = ${regionRisk} WHERE id = ${marketId};`,\n );\n return c.json({ ok: true });\n});\n\napp.get(\"/api/admin/breeds\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n if (!isAdmin(user)) return jsonError(\"Forbidden\", 403);\n\n const breeds = await getBreeds();\n return c.json({ ok: true, breeds });\n});\n\napp.post(\"/api/admin/breeds/:breedId\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n if (!isAdmin(user)) return jsonError(\"Forbidden\", 403);\n\n const breedId = Number(c.req.param(\"breedId\"));\n if (!Number.isFinite(breedId)) return jsonError(\"Invalid breed id.\");\n\n const body = await c.req.json().catch(() => null);\n const basePrice = Number(body?.base_price);\n const volatility = Number(body?.volatility);\n const legalRisk = Number(body?.legal_risk);\n\n if (!Number.isFinite(basePrice) || basePrice < 20) return jsonError(\"base_price must be >= 20.\");\n if (!Number.isFinite(volatility) || volatility < 0 || volatility > 2) return jsonError(\"volatility must be between 0 and 2.\");\n if (!Number.isFinite(legalRisk) || legalRisk < 0 || legalRisk > 1) return jsonError(\"legal_risk must be between 0 and 1.\");\n\n await sqlite.execute(\n `UPDATE breeds\n SET base_price = ${Math.floor(basePrice)}, volatility = ${volatility}, legal_risk = ${legalRisk}\n WHERE id = ${breedId};`,\n );\n return c.json({ ok: true });\n});\n\n// --- Auth routes ---\napp.post(\"/api/register\", async (c) => {\n const body = await c.req.json().catch(() => null);\n const username = body?.username?.trim?.();\n const password = body?.password;\n\n if (!username || typeof username !== \"string\" || username.length < 3 || username.length > 24) {\n return jsonError(\"Username must be 3-24 chars.\");\n }\n if (!/^[a-zA-Z0-9_\\-]+$/.test(username)) {\n return jsonError(\"Username can only use letters, numbers, _ and -.\");\n }\n if (typeof password !== \"string\" || password.length < 6) {\n return jsonError(\"Password must be at least 6 chars.\");\n }\n\n const existing = await sqlite.execute(\n `SELECT id FROM users WHERE username = '${escapeSql(username)}' LIMIT 1;`,\n );\n if (existing.rows.length > 0) return jsonError(\"Username already exists.\");\n\n const hash = await hashPassword(password);\n await sqlite.execute(\n `INSERT INTO users (username, password_hash, role, avatar_blob_key, created_at)\n VALUES ('${escapeSql(username)}', '${hash}', 'player', 'preset:street-tabby', '${new Date().toISOString()}');`,\n );\n\n const userRes = await sqlite.execute(\n `SELECT id FROM users WHERE username = '${escapeSql(username)}' LIMIT 1;`,\n );\n const userId = userRes.rows[0][0] as number;\n\n await bootstrapUser(userId);\n const token = await createSession(userId);\n\n const headers = new Headers({ \"Content-Type\": \"application/json\" });\n setSessionCookie(headers, token);\n return new Response(JSON.stringify({ ok: true }), { status: 200, headers });\n});\n\napp.post(\"/api/login\", async (c) => {\n const body = await c.req.json().catch(() => null);\n const username = body?.username?.trim?.();\n const password = body?.password;\n if (!username || !password) return jsonError(\"Missing credentials.\");\n\n const userRes = await sqlite.execute(\n `SELECT id, password_hash FROM users WHERE username = '${escapeSql(username)}' LIMIT 1;`,\n );\n if (userRes.rows.length === 0) return jsonError(\"Invalid credentials.\", 401);\n\n const expectedHash = userRes.rows[0][1] as string;\n const passwordHash = await hashPassword(password);\n if (passwordHash !== expectedHash) return jsonError(\"Invalid credentials.\", 401);\n\n const userId = userRes.rows[0][0] as number;\n const token = await createSession(userId);\n\n const headers = new Headers({ \"Content-Type\": \"application/json\" });\n setSessionCookie(headers, token);\n return new Response(JSON.stringify({ ok: true }), { status: 200, headers });\n});\n\napp.post(\"/api/logout\", async (c) => {\n const cookies = parseCookies(c.req.raw);\n const token = cookies[SESSION_COOKIE];\n if (token) {\n await sqlite.execute(`DELETE FROM sessions WHERE token = '${escapeSql(token)}';`);\n }\n\n const headers = new Headers({ \"Content-Type\": \"application/json\" });\n clearSessionCookie(headers);\n return new Response(JSON.stringify({ ok: true }), { status: 200, headers });\n});\n\napp.get(\"/api/me\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n const snapshot = await buildSnapshot(user);\n return c.json({ user: { id: user.id, username: user.username }, snapshot, notice });\n});\n\napp.post(\"/api/avatar/preset\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const body = await c.req.json().catch(() => null);\n const avatarId = body?.avatarId;\n if (!avatarId || typeof avatarId !== \"string\") return jsonError(\"avatarId required.\");\n if (!PIXEL_AVATARS.some((a) => a.id === avatarId)) return jsonError(\"Unknown pixel avatar.\");\n\n const avatarKey = \"preset:\" + avatarId;\n await sqlite.execute(`UPDATE users SET avatar_blob_key = '${escapeSql(avatarKey)}' WHERE id = ${user.id};`);\n\n const updatedUser = await getAuthedUser(c.req.raw);\n if (!updatedUser) return jsonError(\"Unauthorized\", 401);\n const snapshot = await buildSnapshot(updatedUser);\n return c.json({ ok: true, avatar_key: avatarKey, snapshot });\n});\n\napp.get(\"/api/pixel-avatar/:avatarId\", async (c) => {\n const avatarId = c.req.param(\"avatarId\");\n const svg = pixelAvatarSvg(avatarId);\n if (!svg) return c.text(\"No avatar\", 404);\n return new Response(svg, {\n headers: {\n \"Content-Type\": \"image/svg+xml; charset=utf-8\",\n \"Cache-Control\": \"public, max-age=86400\",\n },\n });\n});\n\napp.get(\"/api/avatar/:userId\", async (c) => {\n const userId = Number(c.req.param(\"userId\"));\n if (!Number.isFinite(userId)) return c.text(\"Not found\", 404);\n\n const res = await sqlite.execute(`SELECT avatar_blob_key FROM users WHERE id = ${userId} LIMIT 1;`);\n if (res.rows.length === 0 || !res.rows[0][0]) return c.text(\"No avatar\", 404);\n\n const avatarKey = res.rows[0][0] as string;\n const presetResponse = avatarResponse(avatarKey);\n if (presetResponse) return presetResponse;\n\n try {\n return await blob.get(avatarKey);\n } catch {\n return c.text(\"No avatar\", 404);\n }\n});\n\napp.post(\"/api/travel\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n if (notice) {\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message: notice, snapshot, busted: false });\n }\n\n const body = await c.req.json().catch(() => null);\n const marketId = Number(body?.marketId);\n if (!Number.isFinite(marketId)) return jsonError(\"marketId required.\");\n\n const markets = await getMarkets();\n const targetMarket = markets.find((m) => m.id === marketId);\n if (!targetMarket) return jsonError(\"Unknown market.\");\n let message = \"\";\n let wasBusted = false;\n\n try {\n await withTransaction(async () => {\n const current = await getPlayerState(user.id);\n if (marketId === current.current_market_id) throw new Error(\"Already at that market.\");\n\n const newDay = current.day + 1;\n let heat = Math.min(100, current.heat + 8 + Math.floor(Math.random() * 13));\n let bustMessage = \"\";\n let nextCash = current.cash;\n\n const bustChance = Math.min(0.92, heat / 170 + targetMarket.region_risk * 0.28);\n if (Math.random() < bustChance) {\n const invRes = await sqlite.execute(\n `SELECT breed_id, qty FROM inventory WHERE user_id = ${user.id};`,\n );\n for (const row of invRes.rows) {\n const breedId = row[0] as number;\n const qty = row[1] as number;\n const seized = Math.floor(qty * (0.2 + Math.random() * 0.55));\n const kept = Math.max(0, qty - seized);\n await sqlite.execute(\n `INSERT OR REPLACE INTO inventory (user_id, breed_id, qty)\n VALUES (${user.id}, ${breedId}, ${kept});`,\n );\n }\n\n const fine = Math.floor(current.cash * (0.08 + Math.random() * 0.22));\n nextCash = Math.max(0, current.cash - fine);\n heat = Math.max(12, heat - 20);\n bustMessage = \"BUSTED by DHS. Fine paid: $\" + fine.toLocaleString() + \", partial cargo seized.\";\n }\n\n const heatResult = applyHeatStreakLimit(heat, current.heat_max_streak);\n heat = heatResult.heat;\n if (heatResult.forcedCooldown && !bustMessage) {\n bustMessage = \"Heat overload forced a cooldown. Heat dropped to 95%.\";\n }\n\n if (current.debt > 0 && newDay > current.debt_due_day) {\n await restartRun(user.id);\n message = \"Debt deadline missed. You went broke, lost all inventory, and restarted your run.\";\n wasBusted = false;\n return;\n }\n\n await sqlite.execute(\n `UPDATE player_state\n SET current_market_id = ${marketId},\n day = ${newDay},\n heat = ${heat},\n cash = ${nextCash},\n heat_max_streak = ${heatResult.nextStreak}\n WHERE user_id = ${user.id};`,\n );\n\n await generatePricesForMarketDay(newDay, marketId);\n await cleanupOldMarketPrices();\n\n wasBusted = bustMessage.length > 0;\n message = bustMessage || (\"Arrived at \" + targetMarket.name + \". Heat now \" + heat + \"%.\");\n });\n } catch (err) {\n return jsonError((err as Error).message);\n }\n\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message, snapshot, busted: wasBusted });\n});\n\n// --- Economy action routes ---\napp.post(\"/api/borrow\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n if (notice) {\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message: notice, snapshot });\n }\n\n const body = await c.req.json().catch(() => null);\n const amountRaw = Number(body?.amount);\n if (!Number.isFinite(amountRaw) || amountRaw <= 0) return jsonError(\"Invalid borrow amount.\");\n\n const requested = Math.floor(amountRaw);\n if (requested < 100) return jsonError(\"Minimum borrow is $100.\");\n if (requested > 5000) return jsonError(\"Maximum per borrow is $5,000.\");\n\n let borrowed = 0;\n let fee = 0;\n let message = \"\";\n\n try {\n await withTransaction(async () => {\n const state = await getPlayerState(user.id);\n const maxDebt = 50000;\n if (state.debt >= maxDebt) throw new Error(\"Debt ceiling reached.\");\n\n const terms = computeBorrowTerms({\n requested,\n borrowCount: state.borrow_count,\n currentDebt: state.debt,\n debtDueDay: state.debt_due_day,\n currentDay: state.day,\n maxDebt,\n });\n\n if (terms.debtIncrease <= 0) throw new Error(\"Cannot borrow more right now.\");\n if (terms.principalGranted < 100) throw new Error(\"Borrow amount too high for current debt ceiling.\");\n\n await sqlite.execute(\n `UPDATE player_state\n SET cash = ${state.cash + terms.principalGranted},\n debt = ${state.debt + terms.debtIncrease},\n debt_due_day = ${terms.nextDueDay},\n borrow_count = ${state.borrow_count + 1}\n WHERE user_id = ${user.id};`,\n );\n\n borrowed = terms.principalGranted;\n fee = terms.fee;\n message = \"Borrowed $\" + terms.principalGranted.toLocaleString() +\n \" with fee $\" + terms.fee.toLocaleString() +\n \" (tier \" + (state.borrow_count + 1) + \"). Debt due in \" + terms.dueFromToday + \" days.\";\n });\n } catch (err) {\n return jsonError((err as Error).message);\n }\n\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, borrowed, fee, message, snapshot });\n});\n\napp.post(\"/api/pay-debt\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n if (notice) {\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message: notice, snapshot });\n }\n\n const body = await c.req.json().catch(() => null);\n const amountRaw = Number(body?.amount);\n if (!Number.isFinite(amountRaw) || amountRaw <= 0) return jsonError(\"Invalid payment amount.\");\n\n const requested = Math.floor(amountRaw);\n if (requested <= 0) return jsonError(\"Invalid payment amount.\");\n\n let payment = 0;\n let remainingDebt = 0;\n\n try {\n await withTransaction(async () => {\n const state = await getPlayerState(user.id);\n if (state.debt <= 0) throw new Error(\"Debt already cleared.\");\n if (state.cash <= 0) throw new Error(\"No cash available to pay debt.\");\n\n payment = Math.min(requested, state.debt, state.cash);\n remainingDebt = state.debt - payment;\n\n await sqlite.execute(\n `UPDATE player_state\n SET cash = ${state.cash - payment}, debt = ${remainingDebt}\n WHERE user_id = ${user.id};`,\n );\n });\n } catch (err) {\n return jsonError((err as Error).message);\n }\n\n const snapshot = await buildSnapshot(user);\n const message = \"Paid $\" + payment.toLocaleString() + \" toward debt. Remaining debt: $\" + remainingDebt.toLocaleString() + \".\";\n return c.json({ ok: true, payment, message, snapshot });\n});\n\napp.post(\"/api/buy\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n if (notice) {\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message: notice, snapshot });\n }\n\n const body = await c.req.json().catch(() => null);\n const breedId = Number(body?.breedId);\n const qty = Number(body?.qty);\n if (!Number.isFinite(breedId) || !Number.isFinite(qty) || qty <= 0) return jsonError(\"Invalid buy request.\");\n\n let message = \"\";\n\n try {\n await withTransaction(async () => {\n const state = await getPlayerState(user.id);\n const prices = await getCurrentPrices(state.day, state.current_market_id);\n const chosen = prices.find((p) => p.breed_id === breedId);\n if (!chosen) throw new Error(\"Breed not found in market.\");\n\n const cargoUsed = await getCargoUsed(user.id);\n if (cargoUsed + qty > state.cargo_capacity) throw new Error(\"Not enough cargo space.\");\n\n const total = chosen.price * qty;\n if (total > state.cash) throw new Error(\"Insufficient cash.\");\n\n await sqlite.batch([\n `UPDATE player_state SET cash = ${state.cash - total} WHERE user_id = ${user.id};`,\n `INSERT INTO inventory (user_id, breed_id, qty)\n VALUES (${user.id}, ${breedId}, ${qty})\n ON CONFLICT(user_id, breed_id) DO UPDATE SET qty = qty + ${qty};`,\n ]);\n\n message = \"Bought \" + qty + \" \" + chosen.breed_name + \".\";\n });\n } catch (err) {\n return jsonError((err as Error).message);\n }\n\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message, snapshot });\n});\n\napp.post(\"/api/sell\", async (c) => {\n const user = await getAuthedUser(c.req.raw);\n if (!user) return jsonError(\"Unauthorized\", 401);\n\n const notice = await enforceDebtDeadline(user.id);\n if (notice) {\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message: notice, snapshot });\n }\n\n const body = await c.req.json().catch(() => null);\n const breedId = Number(body?.breedId);\n const qty = Number(body?.qty);\n if (!Number.isFinite(breedId) || !Number.isFinite(qty) || qty <= 0) return jsonError(\"Invalid sell request.\");\n\n let message = \"\";\n\n try {\n await withTransaction(async () => {\n const invRes = await sqlite.execute(\n `SELECT qty FROM inventory WHERE user_id = ${user.id} AND breed_id = ${breedId} LIMIT 1;`,\n );\n const owned = (invRes.rows[0]?.[0] as number) ?? 0;\n if (owned < qty) throw new Error(\"Not enough inventory.\");\n\n const state = await getPlayerState(user.id);\n const prices = await getCurrentPrices(state.day, state.current_market_id);\n const chosen = prices.find((p) => p.breed_id === breedId);\n if (!chosen) throw new Error(\"Breed not found in market.\");\n\n const total = chosen.price * qty;\n const nextQty = owned - qty;\n\n await sqlite.batch([\n `UPDATE player_state SET cash = ${state.cash + total} WHERE user_id = ${user.id};`,\n `INSERT OR REPLACE INTO inventory (user_id, breed_id, qty)\n VALUES (${user.id}, ${breedId}, ${nextQty});`,\n ]);\n\n message = \"Sold \" + qty + \" \" + chosen.breed_name + \".\";\n });\n } catch (err) {\n return jsonError((err as Error).message);\n }\n\n const snapshot = await buildSnapshot(user);\n return c.json({ ok: true, message, snapshot });\n});\n\nexport default app.fetch;\n",[],[203],{"_105":212,"_97":213,"_162":214,"_164":-5,"_165":148,"_166":215,"_168":169,"_107":216,"_102":217,"_172":188,"_174":218,"_176":22,"_177":-5,"_178":219,"_100":220},"76f5a6aa-1648-11f1-af51-42dde27851f2","rules.ts","279104c6-1646-11f1-bbdd-42dde27851f2",109,["D",1772463591435],1,"export type BorrowTermsInput = {\n requested: number;\n borrowCount: number;\n currentDebt: number;\n debtDueDay: number;\n currentDay: number;\n maxDebt?: number;\n};\n\nexport type BorrowTerms = {\n feeRate: number;\n fee: number;\n principalGranted: number;\n debtIncrease: number;\n dueFromToday: number;\n nextDueDay: number;\n};\n\n/**\n * Computes borrowing outcomes for one loan action.\n *\n * Rules:\n * - Fee rate starts at 10% and increases by 5% per prior borrow (capped at 75%).\n * - New debt increase = principal + fee, clamped to debt ceiling.\n * - Due-day extension increases with borrow count but due horizon is capped at 90 days.\n */\nexport function computeBorrowTerms(input: BorrowTermsInput): BorrowTerms {\n const maxDebt = input.maxDebt ?? 50000;\n const feeRate = Math.min(0.75, 0.1 + input.borrowCount * 0.05);\n const fee = Math.floor(input.requested * feeRate);\n const debtIncreaseRaw = input.requested + fee;\n const debtIncrease = Math.min(debtIncreaseRaw, Math.max(0, maxDebt - input.currentDebt));\n const principalGranted = Math.max(0, debtIncrease - fee);\n\n const extensionDays = Math.min(20, 5 + input.borrowCount * 2);\n const dueFromToday = Math.min(\n 90,\n Math.max(1, input.debtDueDay - input.currentDay) + extensionDays,\n );\n\n return {\n feeRate,\n fee,\n principalGranted,\n debtIncrease,\n dueFromToday,\n nextDueDay: input.currentDay + dueFromToday,\n };\n}\n\n/**\n * Prevents heat from staying maxed indefinitely.\n * If heat reaches 100% for more than two consecutive turns, force cooldown to 95%.\n */\nexport function applyHeatStreakLimit(heat: number, currentStreak: number): {\n heat: number;\n nextStreak: number;\n forcedCooldown: boolean;\n} {\n const streak = heat === 100 ? currentStreak + 1 : 0;\n if (streak > 2) {\n return { heat: 95, nextStreak: 0, forcedCooldown: true };\n }\n return { heat, nextStreak: streak, forcedCooldown: false };\n}\n",[],[213],{"_105":222,"_97":223,"_162":224,"_164":-5,"_165":148,"_166":225,"_168":169,"_107":226,"_102":227,"_172":188,"_174":228,"_176":22,"_177":-5,"_178":229,"_100":230},"6ace1dbe-1646-11f1-8efa-42dde27851f2","rules_test.ts","5d89342c-1646-11f1-8efa-42dde27851f2",102,["D",1772462712049],3,"import { applyHeatStreakLimit, computeBorrowTerms } from \"./rules.ts\";\n\nfunction assert(condition: boolean, message: string) {\n if (!condition) {\n throw new Error(message);\n }\n}\n\nfunction assertApprox(actual: number, expected: number, epsilon: number, message: string) {\n if (Math.abs(actual - expected) > epsilon) {\n throw new Error(message + \" (actual=\" + actual + \", expected=\" + expected + \")\");\n }\n}\n\nfunction testBorrowTermsBaseCase() {\n const terms = computeBorrowTerms({\n requested: 1000,\n borrowCount: 0,\n currentDebt: 900,\n debtDueDay: 21,\n currentDay: 1,\n maxDebt: 50000,\n });\n\n assertApprox(terms.feeRate, 0.1, 1e-9, \"feeRate should start at 10%.\");\n assert(terms.fee === 100, \"fee should be 100 for $1000 request at tier 0.\");\n assert(terms.debtIncrease === 1100, \"debtIncrease should include principal + fee.\");\n assert(terms.principalGranted === 1000, \"principalGranted should equal requested when under cap.\");\n assert(terms.dueFromToday === 25, \"initial borrow should extend deadline by 5 days (20 -> 25).\");\n assert(terms.nextDueDay === 26, \"next due day should equal currentDay + dueFromToday.\");\n}\n\nfunction testBorrowTermsCapAndCeiling() {\n const terms = computeBorrowTerms({\n requested: 5000,\n borrowCount: 12,\n currentDebt: 49500,\n debtDueDay: 160,\n currentDay: 100,\n maxDebt: 50000,\n });\n\n assertApprox(terms.feeRate, 0.7, 1e-9, \"feeRate should escalate with borrow count.\");\n assert(terms.debtIncrease === 500, \"debt increase should clamp to debt ceiling remainder.\");\n assert(terms.principalGranted === 0, \"if ceiling room is below fee, granted principal can be 0.\");\n assert(terms.dueFromToday === 80, \"deadline should be capped by remaining runway and extension.\");\n assert(terms.nextDueDay === 180, \"next due day should respect dueFromToday math.\");\n}\n\nfunction testBorrowTermsHardNinetyDayCap() {\n const terms = computeBorrowTerms({\n requested: 300,\n borrowCount: 30,\n currentDebt: 1000,\n debtDueDay: 600,\n currentDay: 100,\n maxDebt: 50000,\n });\n\n assert(terms.feeRate === 0.75, \"feeRate must clamp at 75%.\");\n assert(terms.dueFromToday === 90, \"debt cycle cannot exceed 90 days.\");\n assert(terms.nextDueDay === 190, \"next due day should follow 90-day cap.\");\n}\n\nfunction testHeatStreakLimit() {\n const first = applyHeatStreakLimit(100, 0);\n assert(first.heat === 100 && first.nextStreak === 1 && !first.forcedCooldown, \"first 100% heat turn should increment streak.\");\n\n const second = applyHeatStreakLimit(100, first.nextStreak);\n assert(second.heat === 100 && second.nextStreak === 2 && !second.forcedCooldown, \"second 100% heat turn should increment streak to 2.\");\n\n const third = applyHeatStreakLimit(100, second.nextStreak);\n assert(third.heat === 95 && third.nextStreak === 0 && third.forcedCooldown, \"third consecutive 100% heat turn should trigger cooldown.\");\n\n const recover = applyHeatStreakLimit(82, third.nextStreak);\n assert(recover.heat === 82 && recover.nextStreak === 0 && !recover.forcedCooldown, \"non-100 heat should reset streak.\");\n}\n\ntestBorrowTermsBaseCase();\ntestBorrowTermsCapAndCeiling();\ntestBorrowTermsHardNinetyDayCap();\ntestHeatStreakLimit();\n\nconsole.log(\"rules_test.ts passed\");\n",[],[223],"files",[160,181,192,201,211,221],"counts",{"_235":33,"_236":217,"_237":33,"_238":239,"_242":243},"pulls","branches","forks","envVars",{"_240":33,"_241":33},"count","emptyCount","connections",{"_240":33,"_244":33},"unfilledCount","contents",[],{"_105":161,"_165":148,"_162":163,"_97":101,"_174":175,"_172":173,"_102":171,"_164":-5,"_107":248,"_166":167,"_177":-5,"_100":249},["D",1772475972307],[101],"upstreamProject","upstreamBranch","emptyEnvVars","isNew","flags",[],"routes/_app.x.$handle.$name.branch.$branch.history_.$",{"_95":96,"_97":98,"_99":45,"_100":101,"_103":258,"_173":263,"_266":267,"_332":333,"_347":-7,"_348":33,"_349":22},{"_105":106,"_97":98,"_107":259,"_109":-5,"_110":22,"_111":112,"_113":114,"_115":-5,"_14":116,"_117":-5,"_118":22,"_119":-5,"_120":-5,"_121":33,"_16":122,"_123":124,"_125":126,"_127":-5,"_128":129,"_130":129,"_131":132,"_133":132,"_134":132,"_135":129,"_136":129,"_23":260,"_140":261,"_145":262,"_157":22},["D",1772409318475],{"_95":96,"_138":139},{"_95":96,"_142":139,"_14":116,"_143":144},{"_102":147,"_97":45,"_105":148,"_149":106,"_150":-5,"_151":-5,"_152":-5,"_153":-5,"_154":-5,"_155":98,"_156":96},{"_105":161,"_97":101,"_162":163,"_164":-5,"_165":148,"_166":167,"_168":169,"_107":264,"_102":171,"_172":173,"_174":175,"_176":22,"_177":-5,"_100":265},["D",1772475972307],[101],"history",[268,270,276,282,288,294,300,305,311,316,322,327],{"_105":161,"_165":148,"_162":163,"_97":101,"_174":175,"_172":173,"_102":171,"_164":-5,"_107":269,"_166":167,"_177":-5},["D",1772475972307],{"_105":271,"_165":148,"_162":163,"_97":101,"_174":272,"_172":173,"_102":273,"_164":-5,"_107":274,"_166":275,"_177":-5},"477b5f88-1665-11f1-9fc5-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, game actions, and admin dashboard/API\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity, role (`player`/`admin`/`super_admin`), and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Admin\n- `GET /admin` (dashboard UI; admin-only)\n- `GET /api/admin/overview`\n- `GET /api/admin/markets`\n- `POST /api/admin/markets/:marketId`\n- `GET /api/admin/breeds`\n- `POST /api/admin/breeds/:breedId`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Runtime Guarantees\n\n- Market prices are shared by `day + market` for all users.\n- Price history retention is enforced by deleting rows older than `MARKET_PRICE_RETENTION_DAYS` (currently 45) relative to the active max player day.\n- Mutating routes (`travel`, `borrow`, `pay-debt`, `buy`, `sell`) centralize write coordination and use `sqlite.batch` for multi-write updates where possible.\n- Full cross-statement transaction boundaries are pending a runtime-safe transaction primitive in Val Town's sqlite helper.\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",10,["D",1772475967177],146,{"_105":277,"_165":148,"_162":163,"_97":101,"_174":278,"_172":173,"_102":279,"_164":-5,"_107":280,"_166":281,"_177":-5},"4411c2a6-1665-11f1-8e4b-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, game actions, and admin dashboard/API\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Admin\n- `GET /admin` (dashboard UI; admin-only)\n- `GET /api/admin/overview`\n- `GET /api/admin/markets`\n- `POST /api/admin/markets/:marketId`\n- `GET /api/admin/breeds`\n- `POST /api/admin/breeds/:breedId`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Runtime Guarantees\n\n- Market prices are shared by `day + market` for all users.\n- Price history retention is enforced by deleting rows older than `MARKET_PRICE_RETENTION_DAYS` (currently 45) relative to the active max player day.\n- Mutating routes (`travel`, `borrow`, `pay-debt`, `buy`, `sell`) centralize write coordination and use `sqlite.batch` for multi-write updates where possible.\n- Full cross-statement transaction boundaries are pending a runtime-safe transaction primitive in Val Town's sqlite helper.\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",9,["D",1772475961458],145,{"_105":283,"_165":148,"_162":163,"_97":101,"_174":284,"_172":173,"_102":285,"_164":-5,"_107":286,"_166":287,"_177":-5},"3f93a0d2-1665-11f1-a447-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, game actions, and admin dashboard/API\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Runtime Guarantees\n\n- Market prices are shared by `day + market` for all users.\n- Price history retention is enforced by deleting rows older than `MARKET_PRICE_RETENTION_DAYS` (currently 45) relative to the active max player day.\n- Mutating routes (`travel`, `borrow`, `pay-debt`, `buy`, `sell`) centralize write coordination and use `sqlite.batch` for multi-write updates where possible.\n- Full cross-statement transaction boundaries are pending a runtime-safe transaction primitive in Val Town's sqlite helper.\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",8,["D",1772475953918],144,{"_105":289,"_165":148,"_162":163,"_97":101,"_174":290,"_172":173,"_102":291,"_164":-5,"_107":292,"_166":293,"_177":-5},"c015d602-1661-11f1-8656-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Runtime Guarantees\n\n- Market prices are shared by `day + market` for all users.\n- Price history retention is enforced by deleting rows older than `MARKET_PRICE_RETENTION_DAYS` (currently 45) relative to the active max player day.\n- Mutating routes (`travel`, `borrow`, `pay-debt`, `buy`, `sell`) centralize write coordination and use `sqlite.batch` for multi-write updates where possible.\n- Full cross-statement transaction boundaries are pending a runtime-safe transaction primitive in Val Town's sqlite helper.\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",7,["D",1772474451534],131,{"_105":295,"_165":148,"_162":163,"_97":101,"_174":296,"_172":173,"_102":297,"_164":-5,"_107":298,"_166":299,"_177":-5},"9825b1d0-1661-11f1-95da-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Runtime Guarantees\n\n- Market prices are shared by `day + market` for all users.\n- Price history retention is enforced by deleting rows older than `MARKET_PRICE_RETENTION_DAYS` (currently 45) relative to the active max player day.\n- Mutating routes (`travel`, `borrow`, `pay-debt`, `buy`, `sell`) execute state changes in explicit SQL transactions.\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",6,["D",1772474384534],127,{"_105":301,"_165":148,"_162":163,"_97":101,"_174":302,"_172":173,"_102":187,"_164":-5,"_107":303,"_166":304,"_177":-5},"94653502-1661-11f1-ae20-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n- `2026-03-02-create-market-day-prices`\n- `2026-03-02-backfill-market-day-prices-from-user-market-prices`\n- `2026-03-02-clear-user-market-prices-legacy`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",["D",1772474378238],126,{"_105":306,"_165":148,"_162":163,"_97":101,"_174":307,"_172":173,"_102":308,"_164":-5,"_107":309,"_166":310,"_177":-5},"8f923bba-1661-11f1-a418-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `market_day_prices`\nShared daily per-market prices across all users (multiplayer-ready market tape).\n\n### `user_market_prices` (legacy)\nDeprecated table kept only for migration compatibility. Active writes no longer target this table.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",4,["D",1772474370130],125,{"_105":312,"_165":148,"_162":163,"_97":101,"_174":313,"_172":173,"_102":227,"_164":-5,"_107":314,"_166":315,"_177":-5},"680c2ccc-1648-11f1-b6aa-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Travel Economics\n\n- There is no fixed dollar travel fee.\n- Each travel action increments `day` by 1.\n- Travel raises heat and may trigger a DHS bust.\n- Bust outcomes can reduce cash (fine) and inventory (seizure).\n\n## Market Forces And Fast-Profit Playstyle\n\n- High-volatility breeds (`Sphynx`, `Bengal`) produce the largest swings.\n- Early borrowing increases buying power but fees escalate per borrow tier.\n- Low-risk travel hubs (`Seattle`, `Austin`) help reduce bust frequency while hunting good exits.\n- Over-traveling increases bust risk and can erase profits quickly.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `user_market_prices`\nDaily per-market generated prices per user.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",["D",1772463566410],108,{"_105":317,"_165":148,"_162":163,"_97":101,"_174":318,"_172":173,"_102":319,"_164":-5,"_107":320,"_166":321,"_177":-5},"67d2e700-1648-11f1-ae68-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val-scoped SQLite via `https://esm.town/v/std/sqlite/main.ts`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `user_market_prices`\nDaily per-market generated prices per user.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",2,["D",1772463565980],107,{"_105":323,"_165":148,"_162":163,"_97":101,"_174":324,"_172":173,"_102":217,"_164":-5,"_107":325,"_166":326,"_177":-5},"7e3fdcc0-1646-11f1-82a5-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val Town `sqlite`\n- Binary/media: Val Town `blob` (avatar path still supports blob keys, UI uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Project Files\n\n- `main.ts`: HTTP routes, DB bootstrap/migrations, rendering, and game actions\n- `auth.ts`: session cookie parsing, session token lifecycle, authenticated user lookup\n- `config.ts`: static game config (markets, breeds, pixel avatar metadata)\n- `rules.ts`: pure game logic helpers (borrow terms and heat streak cap)\n- `rules_test.ts`: script-based regression tests for `rules.ts`\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Debt System\n\n- Debt has a due day (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier (capped)\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Heat and Bust Rules\n\n- Travel increases heat and can trigger a DHS bust event.\n- Bust events may seize inventory and fine cash.\n- Heat cannot stay at 100% for more than 2 consecutive turns; on the 3rd turn it is forced down to 95%.\n\n## Schema\n\n### `users`\nAccount identity and avatar key.\n\n### `sessions`\nCookie-token sessions with expiry.\n\n### `player_state`\nCurrent market, cash, debt, heat, day, cargo, debt due day, borrow tier, and heat max streak.\n\n### `markets`\nCity list and enforcement risk profile.\n\n### `breeds`\nBase economy metadata for each cat breed.\n\n### `inventory`\nOwned quantity per breed per user.\n\n### `user_market_prices`\nDaily per-market generated prices per user.\n\n### `schema_migrations`\nTracks one-way migration IDs that have been applied.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Migrations\n\n`initDb()` creates base tables and then runs idempotent tracked migrations:\n\n- `2026-03-02-add-player_state-debt_due_day`\n- `2026-03-02-add-player_state-borrow_count`\n- `2026-03-02-add-player_state-heat_max_streak`\n- `2026-03-02-backfill-debt_due_day`\n\nApplied migrations are recorded in `schema_migrations`.\n\n## Testing\n\nRun the script file directly in Val Town:\n\n- `rules_test.ts`\n\nIt validates:\n- borrow fee escalation and cap behavior\n- debt-ceiling clamping\n- due-date 90-day cap\n- heat 100% streak cooldown behavior\n\n## Current Status\n\n- Val is public: `pchinjr/cat-wars`\n- Auth/session logic extracted into `auth.ts`\n- Static game config extracted into `config.ts`\n- Core deterministic rules extracted into `rules.ts`\n- Regression coverage added for extracted rules via `rules_test.ts`\n\n## Next Suggested Improvements\n\n1. Add tests for route-level behaviors (`/api/travel`, `/api/borrow`, bankruptcy reset).\n2. Introduce a tiny data-access layer to remove inline SQL from route handlers.\n3. Add structured event logging for travel, bust, borrow, and bankruptcy actions.\n4. Add multiplayer-ready turn clock abstraction for synchronized city market ticks.\n",["D",1772462744672],103,{"_105":328,"_165":148,"_162":163,"_97":101,"_174":329,"_172":173,"_102":33,"_164":-5,"_107":330,"_166":331,"_177":-5},"836a4a72-1638-11f1-9ce6-42dde27851f2","# Cat Wars 2029\n\nA retro-styled browser trading game inspired by the Drug Wars gameplay loop.\n\nPlayers move between real U.S. city markets, buy/sell illegal cat breeds, manage heat risk, and survive escalating debt pressure.\n\n## Stack\n\n- Runtime: Val Town HTTP Val (`main.ts`)\n- Web framework: `Hono`\n- Persistence: Val Town `sqlite`\n- Binary/media: Val Town `blob` (currently avatar system uses pixel presets)\n- Frontend: server-rendered HTML + vanilla JS\n\n## Core Gameplay Loop\n\n1. Register or log in.\n2. Check market prices for each breed.\n3. Buy cats where prices are low.\n4. Travel to another city (travel advances day and raises heat).\n5. Sell for profit.\n6. Manage debt before deadline.\n\n## Debt System\n\n- Debt has a **due day** (`debt_due_day`).\n- Borrowing:\n - increases cash and debt\n - applies escalating fee by borrow tier\n - extends due window, capped to at most 90 days ahead\n- Missing debt deadline while debt > 0 triggers bankruptcy:\n - inventory wiped\n - run reset to baseline state\n\n## Data Model\n\n### `users`\n- Account identity and avatar key.\n\n### `sessions`\n- Cookie-token sessions with expiry.\n\n### `player_state`\n- Current market, cash, debt, heat, day, cargo, debt due day, borrow tier.\n\n### `markets`\n- City list and enforcement risk profile.\n\n### `breeds`\n- Base economy metadata for each cat breed.\n\n### `inventory`\n- Owned quantity per breed per user.\n\n### `user_market_prices`\n- Daily per-market generated prices per user.\n\n## API Surface\n\n### Auth/session\n- `POST /api/register`\n- `POST /api/login`\n- `POST /api/logout`\n- `GET /api/me`\n\n### Economy/actions\n- `POST /api/buy`\n- `POST /api/sell`\n- `POST /api/travel`\n- `POST /api/borrow`\n- `POST /api/pay-debt`\n\n### Avatar/presets\n- `POST /api/avatar/preset`\n- `GET /api/pixel-avatar/:avatarId`\n- `GET /api/avatar/:userId`\n\n## Local Behavior Notes\n\n- `initDb()` is idempotent and performs lightweight schema migration for existing rows.\n- Price generation is deterministic-ish with random volatility per day/market and breed risk inputs.\n- Debt deadline is enforced on read and write endpoints to prevent bypass.\n\n## Next Suggested Improvements\n\n1. Server-side validation and rate limiting per action.\n2. Structured logging for action events (travel, bust, borrow, bankruptcy).\n3. Multiplayer market ticker with shared city economy state.\n4. Profile page customization layer (Myspace-style modules/theme settings).\n",["D",1772456740387],61,"versions",[334,336,337,338,339,340,341,342,343,344,345,346],{"_173":268,"_335":270},"previous",{"_173":270,"_335":276},{"_173":276,"_335":282},{"_173":282,"_335":288},{"_173":288,"_335":294},{"_173":294,"_335":300},{"_173":300,"_335":305},{"_173":305,"_335":311},{"_173":311,"_335":316},{"_173":316,"_335":322},{"_173":322,"_335":327},{"_173":327,"_335":-5},"versionNumber","page","hasNext","actionData","errors"]

Cat Wars Admin Console

Overview

Markets

Breeds

CAT WARS 2029

Street Terminal

The Situation

How The Game Works

Register

Log In

Market Prices

Travel

Session

pchinjr

cat-wars

History for README.md