dsh-piggy 0.25.0

package/commands.js

@@ -0,0 +1,252 @@
+// @ts-check
+/**
+ * 斜杠命令与拒绝话术。
+ *
+ * 只读取状态与数值表，不算业务规则（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/commands
+ */
+
+import { ACTIONS, JOBS, MAX, REVIVE_ITEM, SCHOOL_STAGES, SHOP, SUBJECTS, TRAITS, TRAIT_ORDER, TRIPS, buy, feed, hatch } from './core.js'
+import { FORMS, INTERESTS, formByKey, jobByKey, stageForNextLesson } from './data.js'
+import { renderAbout, renderAction, renderBuy, renderHatch, renderNoPig, renderStatus, renderStudyReport, renderTooSoon, renderTripReport, renderUse, renderWeigh, renderWorkRefusal, renderWorkReport } from './render.js'
+
+const str = value => (typeof value === 'string' ? value : '')
+
+export function performAction(store, action) {
+  const state = store.freshen()
+  if (state === null) return { kind: 'error', text: renderNoPig('pig') }
+  const result = store.act(action)
+  if (!result.ok) {
+    if (result.reason === 'cooldown') return { kind: 'success', text: renderTooSoon(state, Date.now(), action) }
+    if (result.reason === 'away') return { kind: 'success', text: renderWorkRefusal(state, `${state.name} 正在外面，回来再说。`) }
+    if (result.reason === 'dead') return { kind: 'error', text: `${state.name} 已经走了…用 ${REVIVE_ITEM.label} 可以救回来。` }
+    if (result.reason === 'absent') return { kind: 'error', text: renderNoPig('pig') }
+    return { kind: 'error', text: `🐖 ${ACTIONS[action]?.label ?? action} 没做成。` }
+  }
+  return { kind: 'success', text: renderAction(store.freshen(), Date.now(), action, result.crossed) }
+}
+
+export function dispatch(store, commandName, rawInput) {
+  const trimmed = rawInput.trim()
+  const [sub, ...rest] = trimmed === '' ? [''] : trimmed.split(/\s+/)
+  const argument = rest.join(' ')
+  const state = store.freshen()
+  const nowMs = Date.now()
+  const verb = sub.toLowerCase()
+
+  switch (verb) {
+    case '':
+    case 'status': {
+      if (state === null) return { kind: 'success', text: renderNoPig(commandName) }
+      return { kind: 'success', text: renderStatus(state, nowMs) }
+    }
+    case 'hatch': {
+      if (store.hatch()) return { kind: 'success', text: renderHatch(store.state, nowMs) }
+      const existing = store.freshen()
+      return { kind: 'success', text: `这里已经住着 ${existing.name} 了 🐖\n\n${renderStatus(existing, nowMs)}` }
+    }
+    case 'feed':
+    case 'bathe':
+    case 'play':
+    case 'pet':
+    case 'mo':
+      return performAction(store, verb === 'mo' ? 'pet' : verb)
+
+    case 'work': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const key = argument.trim() === '' ? 'odd' : argument.trim()
+      const job = JOBS.find(j => j.key === key || j.label === key)
+      if (job === undefined) return { kind: 'error', text: `没有「${key}」这份工作。/${commandName} work 看有哪些。` }
+      const result = store.startWork(job.key)
+      if (!result.ok) return { kind: 'success', text: renderWorkRefusal(state, refusalText(result, state)) }
+      return { kind: 'success', text: renderWorkReport(store.freshen(), Date.now(), job) }
+    }
+
+    case 'study': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      // B4: a subject's stage follows from its lesson count, so only the subject is named.
+      const [subjectArg = ''] = argument.trim().split(/\s+/)
+      const subject = SUBJECTS.find(s => s.key === subjectArg || s.label === subjectArg)
+      if (subject === undefined) {
+        return { kind: 'error', text: `用法：/${commandName} study <科目>\n科目：${SUBJECTS.map(s => s.label).join(' · ')}` }
+      }
+      const stage = stageForNextLesson(state.lessons?.[subject.key] ?? 0)
+      const result = store.startStudy(subject.key)
+      if (!result.ok) return { kind: 'success', text: renderWorkRefusal(state, refusalText(result, state)) }
+      return { kind: 'success', text: renderStudyReport(store.freshen(), Date.now(), subject, stage) }
+    }
+
+    case 'trip':
+    case 'travel': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const key = argument.trim() === '' ? 'suburb' : argument.trim()
+      const trip = TRIPS.find(t => t.key === key || t.label === key)
+      if (trip === undefined) return { kind: 'error', text: `没有「${key}」这个目的地。/${commandName} trip 看有哪些。` }
+      const result = store.startTrip(trip.key)
+      if (!result.ok) return { kind: 'success', text: renderWorkRefusal(state, refusalText(result, state)) }
+      return { kind: 'success', text: renderTripReport(store.freshen(), Date.now(), trip) }
+    }
+
+    case 'calloff': {
+      const result = store.callOffActivity()
+      if (!result.ok) return { kind: 'success', text: `${state?.name ?? '猪'} 没在外面。` }
+      return {
+        kind: 'success',
+        text: result.refunded > 0
+          ? `${state.name} 提前回来了，退回 ${result.refunded} 金币。`
+          : `${state.name} 提前回来了，这趟白跑。`,
+      }
+    }
+
+    case 'shop': {
+      const lines = SHOP.map(item => `  ${item.emoji} ${item.label}  ${item.price} 金币`).join('\n')
+      return { kind: 'success', text: `🛒 商店（你有 ${state?.coins ?? 0} 金币）\n${lines}\n\n买：/${commandName} buy <物品>` }
+    }
+    case 'buy': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const item = SHOP.find(i => i.key === argument.trim() || i.label === argument.trim())
+      if (item === undefined) return { kind: 'error', text: `没有「${argument}」这样东西。/${commandName} shop 看货架。` }
+      return { kind: 'success', text: renderBuy(store.freshen(), store.buy(item.key), item) }
+    }
+    case 'use': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const item = SHOP.find(i => i.key === argument.trim() || i.label === argument.trim())
+      if (item === undefined) return { kind: 'error', text: `没有「${argument}」这样东西。` }
+      return { kind: 'success', text: renderUse(store.freshen(), store.useItem(item.key), item) }
+    }
+    case 'interest': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const interest = INTERESTS.find(i => i.key === argument.trim() || i.label === argument.trim())
+      if (interest === undefined) {
+        const names = INTERESTS.map(i => `${i.label}(${i.key})`).join(' · ')
+        return { kind: 'error', text: `没有「${argument}」这门兴趣课。可选：${names}` }
+      }
+      const result = store.startInterest(interest.key)
+      if (!result.ok) return { kind: 'error', text: refusalText(result, state) }
+      return { kind: 'success', text: `${state.name} 去上${interest.label}课了，${interest.minutes} 分钟后回来。` }
+    }
+    case 'sell': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const wanted = argument.trim()
+      const owned = state.souvenirs.find(entry => entry.key === wanted || entry.label === wanted)
+      if (owned === undefined) return { kind: 'error', text: `收藏里没有「${wanted}」。` }
+      const result = store.sellSouvenir(owned.key)
+      if (!result.ok) return { kind: 'error', text: refusalText(result, state) }
+      return { kind: 'success', text: `卖掉了「${result.sold.label}」，得到 ${result.sold.price} 金币。` }
+    }
+    case 'wear': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const [wanted, mode] = argument.trim().split(/\s+/)
+      const item = SHOP.find(i => i.kind === 'dress' && (i.key === wanted || i.label === wanted))
+      if (item === undefined) return { kind: 'error', text: `没有「${wanted}」这件家当。` }
+      const on = mode !== 'off' && mode !== '脱'
+      const result = store.wear(item.key, on)
+      if (!result.ok) return { kind: 'error', text: refusalText(result, state) }
+      return { kind: 'success', text: `${state.name} ${on ? '穿上' : '脱下'}了「${item.label}」。` }
+    }
+    case 'adopt': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      if (!store.adopt()) return { kind: 'error', text: `${state.name} 还在，不能领养新的 —— 只有墓碑之后才能。` }
+      return { kind: 'success', text: '门口放了一个新纸盒 📦 用它继续吧。' }
+    }
+    case 'reply': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const open = state.dialogue?.open ?? null
+      if (open === null) return { kind: 'error', text: `${state.name} 现在没在说话。` }
+      const index = Number.parseInt(argument.trim(), 10)
+      if (!Number.isInteger(index) || index < 1) {
+        const labels = open.replies.map((reply, i) => `${i + 1}=${reply.label}`).join(' · ')
+        return { kind: 'error', text: `用法：/${commandName} reply <序号>（${labels}）` }
+      }
+      const result = store.reply(open.id, index - 1)
+      if (!result.ok) return { kind: 'error', text: refusalText(result, state) }
+      return { kind: 'success', text: `你说「${result.reply}」，${state.name} 很开心。` }
+    }
+    case 'weigh': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      return { kind: 'success', text: renderWeigh(state, nowMs) }
+    }
+    case 'name': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const cleaned = store.rename(argument)
+      if (cleaned === null) return { kind: 'error', text: `用法：/${commandName} name <名字>（16 字以内）` }
+      return { kind: 'success', text: `从今天起，它叫「${cleaned}」🐖` }
+    }
+    case 'crown': {
+      if (state === null) return { kind: 'error', text: renderNoPig(commandName) }
+      const wanted = argument === '' ? undefined : (FORMS.find(form => form.label === argument || form.key === argument)?.key ?? argument)
+      const result = store.crown(wanted)
+      if (result.ok) return { kind: 'success', text: `👑 ${state.name} 现在是${formByKey(result.form)?.label ?? ''}了。\n` + renderStatus(store.freshen(), nowMs) }
+      if (result.reason === 'coronation-ineligible') {
+        const rows = result.missing.map(row => `${row.label} ${row.have}/${row.need}`).join(' · ')
+        return { kind: 'error', text: `还差一点：${rows}` }
+      }
+      if (result.reason === 'unknown') return { kind: 'error', text: `没有这种形态。可选：${FORMS.map(form => form.label).join(' · ')}` }
+      return { kind: 'error', text: refusalText(result, state) }
+    }
+    case 'about':
+    case 'help':
+      return { kind: 'success', text: renderAbout(commandName) }
+    default:
+      return {
+        kind: 'error',
+        text: `不认识「${sub}」。可用：/${commandName} · hatch · adopt · feed · bathe · play · pet · study · interest · work · trip · calloff · shop · buy · use · sell · wear · crown · weigh · name · reply · about`,
+      }
+  }
+}
+
+function refusalText(result, state) {
+  switch (result.reason) {
+    case 'dead': return `${state.name} 已经走了…`
+    case 'away': return `${state.name} 已经在外面了。`
+    case 'sick': return `${state.name} 病着，不能出门 —— 先治好它。`
+    case 'hungry': return `${state.name} 太饿了，先喂点东西。`
+    case 'poor': return `钱不够，需要 ${result.price} 金币，你只有 ${state.coins}。`
+    case 'underqualified': {
+      const want = (result.missing ?? []).map(entry => `${entry.emoji} ${entry.label} ${entry.need}（现在 ${entry.have}）`).join('、')
+      return `这份工作还轮不到它 —— 需要 ${want}。去「学习」上课就能涨。`
+    }
+    case 'wrong-stage':
+      return `${result.stage}没有「${result.subject}」这门课 —— 换个学段，或者换一门课。`
+    case 'locked': {
+      const need = result.need
+      return need === null || need === undefined
+        ? '这一级还没解锁 —— 先把上一级的课念完。'
+        : `要先念完${need.label}（${need.done}/${need.need}）。`
+    }
+    case 'box': return '先把纸盒拆开。'
+    case 'not-owned': return `${state.name} 还没有这件东西。`
+    case 'owned': return `${state.name} 已经有这件了。`
+    case 'low-level': return `等级不够（要 Lv.${result.need}，现在 Lv.${result.have}）。`
+    case 'stale-line': return `${state.name} 已经在说下一句了。`
+    case 'unknown': return '没有这个选项。'
+    default: return '现在没法出门。'
+  }
+}
+
+export { jobByKey, MAX, SHOP, JOBS, SUBJECTS, SCHOOL_STAGES, TRIPS, TRAITS, TRAIT_ORDER }
+
+/**
+ * Register the `/pig` fallback command. The GUI is the primary path; this is
+ * what still works when the panel cannot mount.
+ * @param {object} ctx - plugin context
+ * @param {object} store - the pig store
+ * @param {string} commandName - validated command name
+ */
+export function registerSlashCommand(ctx, store, commandName) {
+  ctx.inject(['commands'], (commandCtx) => {
+    commandCtx.commands.register({
+      name: commandName,
+      description: 'your pig 🐖: status · study · work · shop · travel · bag',
+      input: { hint: '[hatch|feed|bathe|play|pet|study <科目>|work <job>|trip <目的地>|shop|buy|use|weigh|about]' },
+      handler: invocation => {
+        try {
+          return dispatch(store, commandName, String(invocation.rawInput ?? ''))
+        } catch (error) {
+          const detail = error instanceof Error ? error.message : String(error)
+          return { kind: 'error', text: `🐖 猪摔了一跤：${detail}` }
+        }
+      },
+    })
+  })
+}

package/cordis.patch.yml

@@ -0,0 +1,15 @@
+# dsh-piggy's layer: one row, no dependencies on other bundles.
+#
+# `name` must match package.json's `name` exactly. It was left as `dsh-pig`
+# after the package was renamed, and the mismatch silently dropped this
+# plugin's CLIENT half — the host routes kept working (the loader resolved the
+# stale node_modules symlink) while the widget never mounted at all.
+#
+# config keys (both optional):
+#   command:   the slash command name, default "pig". Change it if another
+#              plugin already registered /pig.
+#   statePath: absolute path of the save file, default $DSH_HOME/dsh-piggy/state.json.
+- insert:
+    - id: dsh-piggy
+      name: dsh-piggy
+      config: {}

package/core.js

@@ -0,0 +1,11 @@
+// @ts-check
+/**
+ * dsh-piggy · core —— 插件侧的入口，只做再导出。
+ *
+ * 领域模型本体在 packages/pet-core（`@dsh-piggy/core`），DSH 插件和以后的独立版
+ * 共用同一份。这个文件留在根目录，是为了让 `../core.js` 这类既有导入一行都不用改。
+ *
+ * @module dsh-piggy/core
+ */
+
+export * from './packages/pet-core/src/core.js'

package/data.js

@@ -0,0 +1,10 @@
+// @ts-check
+/**
+ * dsh-piggy · data —— 插件侧的入口，只做再导出。
+ *
+ * 数值表本体在 packages/pet-core（`@dsh-piggy/core`），见 core.js 的说明。
+ *
+ * @module dsh-piggy/data
+ */
+
+export * from './packages/pet-core/src/data.js'

package/index.js

@@ -0,0 +1,68 @@
+// @ts-check
+/**
+ * dsh-piggy — a pig that lives in your DeepSeek Harness.
+ *
+ * The plugin registers no model-facing tool and injects no context, so the
+ * model never learns the pig exists and the pig costs zero tokens per request.
+ * Every listener body is wrapped so a pig bug can never veto or delay real work.
+ *
+ * Two ways the human interacts, both ending in the same core calls:
+ *   - the floating pig's six icons → POST /dsh-piggy/act
+ *   - typing `/pig feed`           → the slash command
+ * The GUI is the primary path; the command is the fallback.
+ *
+ * This file only wires things together: the store, the harness listeners, the
+ * routes and the command. The shapes live in snapshot.js, the command in
+ * commands.js, the HTTP surface in routes.js (see docs/CONVENTIONS.md).
+ *
+ * @module dsh-piggy
+ */
+
+import { dispatch, registerSlashCommand } from './commands.js'
+import { registerRoutes } from './routes.js'
+import { createStore, moveLegacySaveDir } from './store.js'
+
+export const name = 'dsh-piggy'
+
+/**
+ * No required services. The pig rides on emit-mode events, and it reaches the
+ * optional web seam through the safe `ctx.get()` accessor rather than a
+ * declared injection — reading an undeclared service as a property throws in
+ * cordis and would take the whole plugin down.
+ */
+export const inject = []
+
+/** Wrap a listener so a pig bug can never veto or delay real harness work. */
+const contained = fn => (...args) => {
+  try { fn(...args) } catch { /* the pig absorbs its own mishaps */ }
+}
+
+/** The pig eats your real work: turns, tool calls and errors. */
+function registerDietListeners(ctx, store) {
+  ctx.on('agent/inbox/claimed', contained(() => store.feed('message')))
+  ctx.on('agent/turn-stopping', contained(() => store.feed('turn')))
+  ctx.on('agent/error', contained(() => store.feed('agentError')))
+  ctx.on('tools/result', contained((exec, result) => {
+    store.feed(result?.isError === true ? 'toolError' : 'tool')
+  }))
+}
+
+export function apply(ctx, config = {}) {
+  const commandName = typeof config.command === 'string' && /^[a-z][a-z0-9-]{0,23}$/.test(config.command)
+    ? config.command
+    : 'pig'
+  const customPath = typeof config.statePath === 'string' && config.statePath.trim() !== ''
+  // The default save moved from $DSH_HOME/dsh-pig/ to dsh-piggy/; bring an old one along.
+  if (!customPath) moveLegacySaveDir()
+  const store = createStore(customPath ? config.statePath : undefined)
+
+  registerDietListeners(ctx, store)
+  registerRoutes(ctx, store)
+  registerSlashCommand(ctx, store, commandName)
+
+  ctx.effect(() => () => store.dispose())
+}
+
+export { dispatch, performAction } from './commands.js'
+export { snapshot } from './snapshot.js'
+export { JOBS, MAX, SCHOOL_STAGES, SHOP, SUBJECTS, TRAITS, TRAIT_ORDER, TRIPS, jobByKey } from './data.js'

package/package.json

@@ -0,0 +1,72 @@
+{
+  "name": "dsh-piggy",
+  "version": "0.25.0",
+  "description": "🐖 一只住在 DeepSeek Harness 里的猪：吃你的真实工作长大，会学习、打工、旅行、生病、需要照顾",
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "plugin",
+    "pet",
+    "pig",
+    "tamagotchi",
+    "desktop-pet"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "main": "index.js",
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./core": "./core.js",
+    "./pet-core": "./packages/pet-core/src/index.js",
+    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "index.js",
+    "snapshot.js",
+    "commands.js",
+    "routes.js",
+    "core.js",
+    "data.js",
+    "store.js",
+    "render.js",
+    "client.js",
+    "packages/pet-core",
+    "store",
+    "src",
+    "scripts",
+    "cordis.patch.yml",
+    "README.md",
+    "CHANGELOG.md",
+    "THIRD-PARTY.md",
+    "LICENSE",
+    "assets"
+  ],
+  "scripts": {
+    "build": "node scripts/build-client.mjs",
+    "typecheck": "node scripts/typecheck.mjs",
+    "test": "node --test \"test/**/*.test.js\" \"apps/desktop/test/*.test.js\"",
+    "preview": "echo \"open tools/preview.html in a browser\""
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web"
+    }
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CLICGGER-TYPES/dsh-piggy.git"
+  },
+  "homepage": "https://github.com/CLICGGER-TYPES/dsh-piggy#readme",
+  "bugs": {
+    "url": "https://github.com/CLICGGER-TYPES/dsh-piggy/issues"
+  },
+  "author": "clicgger"
+}

package/packages/pet-core/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@dsh-piggy/core",
+  "version": "0.1.0",
+  "private": true,
+  "description": "dsh-piggy 的纯领域模型与数值表：零依赖、零 IO，时间与随机数由宿主传入",
+  "license": "MIT",
+  "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./core": "./src/core.js",
+    "./data": "./src/data.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
+}

package/packages/pet-core/src/core/activity.js

@@ -0,0 +1,80 @@
+// @ts-check
+/**
+ * 外出活动的开始与召回。
+ *
+ * 纯函数领域逻辑：时间由 nowMs 传入，不读写文件、不碰 DOM（见 docs/CONVENTIONS.md）。
+ * @module dsh-piggy/core/activity
+ */
+
+import { TOO_WEAK_HEALTH } from './constants.js'
+import { remember } from './effects.js'
+import { decay } from './settlement.js'
+
+/**
+ * Why the pig cannot head out right now, or null when it can.
+ *
+ * Illness used to block this outright, which deadlocked the whole game:
+ * sick → cannot work → no coins → cannot buy medicine → still sick, and the
+ * only way out was to wait to die. A pig that can still stand up can go and
+ * earn its own prescription; only one at death's door has to stay in bed.
+ */
+export function awayBlockedReason(state) {
+  if (state === null) return 'absent'
+  if (state.hatched !== true) return 'box'
+  if (state.dead) return 'dead'
+  if (state.activity !== null) return 'away'
+  if (state.health <= TOO_WEAK_HEALTH) return 'weak'
+  return null
+}
+
+/** Whether the pig is free to go out. */
+export function canStartActivity(state) {
+  return awayBlockedReason(state) === null
+}
+
+/** Back-compat alias. */
+export const canWork = canStartActivity
+
+/** Start the named activity. Returns `{ ok, activity }` or `{ ok:false, reason }`. */
+export function begin(state, activity, nowMs) {
+  decay(state, nowMs)
+  const blocked = awayBlockedReason(state)
+  if (blocked !== null) return { ok: false, reason: blocked }
+  state.activity = { ...activity, startedAt: nowMs, endsAt: nowMs + activity.minutes * 60000 }
+  state.lastActiveAt = nowMs
+  return { ok: true, activity: state.activity }
+}
+
+/** Seconds left on the current activity (0 when idle). */
+export function activitySecondsLeft(state, nowMs) {
+  if (state.activity === null) return 0
+  return Math.max(0, Math.ceil((state.activity.endsAt - nowMs) / 60000 * 60))
+}
+
+/** Back-compat alias. */
+export const workSecondsLeft = activitySecondsLeft
+
+/** Bring the pig home early. Work forfeits pay; study and trips are refunded. */
+export function callOffActivity(state, nowMs) {
+  // Settle first: a shift/lesson/trip that already ended must pay out (and be
+  // announced) before anyone decides it was "called off". Without this the
+  // panel's 召回 button voided the wages of a finished shift.
+  decay(state, nowMs)
+  if (state.activity === null) return { ok: false, reason: 'idle' }
+  const activity = state.activity
+  state.activity = null
+  if (activity.kind !== 'work' && activity.cost > 0) {
+    state.coins += activity.cost
+    remember(state, `${activity.emoji} 从${activity.label}提前回来了，钱退回来了`, nowMs)
+    return { ok: true, refunded: activity.cost }
+  }
+  remember(state, `${activity.emoji} 从${activity.label}提前回来了，白跑一趟`, nowMs)
+  return { ok: true, refunded: 0 }
+}
+
+/** Back-compat alias. */
+export const callOffWork = callOffActivity
+
+// ---------------------------------------------------------------------------
+// Shop and inventory
+// ---------------------------------------------------------------------------