@follenfang/wowdata 0.0.1

package/LICENSE

@@ -0,0 +1,10 @@
+GNU AFFERO GENERAL PUBLIC LICENSE
+Version 3, 19 November 2007
+
+Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
+
+wowdata is licensed under the GNU Affero General Public License version 3 or any later version.
+
+Full license text:
+https://www.gnu.org/licenses/agpl-3.0.txt

package/README.md

@@ -0,0 +1,175 @@
+# wowdata
+
+`wowdata` 是一个纯 Go 的 World of Warcraft 数据 CLI，用于查询和导出 CASC、DB2、Listfile、图标、法术、副本、物品、生物、装饰物和视频数据。
+
+## 安装
+
+```bash
+npm install -g @follenfang/wowdata
+```
+
+npm 会完成两件事：
+
+- 把当前平台的 Go CLI 安装到 `~/.wowdata/bin`，并提供全局 `wowdata` 命令。
+- 把轻量 Skill 安装到 `~/.agents/skills/wowdata`。Skill 只有说明和 Reference，不包含可执行文件。
+
+支持 Windows amd64、Linux amd64/arm64、macOS amd64/arm64。
+
+## 目标必须明确
+
+CLI 没有地区、产品、Build 或语言默认值。需要游戏数据的命令必须传完整目标：
+
+```bash
+wowdata db2 rows SpellName --id 123 \
+  --source remote \
+  --region cn \
+  --product wow \
+  --build latest \
+  --locale zhCN
+```
+
+也可以先保存完整 Profile：
+
+```bash
+wowdata profile set retail-cn \
+  --source remote \
+  --region cn \
+  --product wow \
+  --build latest \
+  --locale zhCN
+
+wowdata db2 rows SpellName --id 123 --profile retail-cn
+```
+
+Skill 的规则不同：用户没指定时，Skill 显式传入中国区 `cn`、最新 Build `latest` 和简体中文 `zhCN`；产品没有默认值，无法从用户话语或上下文确定时，Skill 会先询问用户。
+
+## 直接查询
+
+普通任务直接运行对应原子命令，不需要先执行预热：
+
+```bash
+wowdata spell info --spell-id 123 --profile retail-cn
+wowdata file lookup --file-data-id 134400 --profile retail-cn
+wowdata icon export --file-data-id 134400 --format png --output output/icon.png --profile retail-cn
+```
+
+CLI 会在同一次命令中：
+
+1. 解析明确的产品和 Build。
+2. 检查远端内容身份与本地 SHA-256。
+3. 复用有效缓存，下载缺失或过期内容。
+4. 完成查询并返回最终结果。
+
+准备和下载进度写入 stderr，最终结构化结果写入 stdout JSON。多个独立 CDN 对象和清单默认使用 4 个 worker 并发下载；可以通过 `wowdata cache config --workers N` 调整。
+
+## 发现与提前准备
+
+查看某个区域当前提供的真实产品和 Build 组合：
+
+```bash
+wowdata casc products --source remote --region cn
+```
+
+需要提前下载时再显式使用 `warmup`：
+
+```bash
+wowdata warmup \
+  --source remote \
+  --region cn \
+  --product wow \
+  --build latest \
+  --locale zhCN
+```
+
+## 本地目录
+
+```text
+~/.wowdata/
+├── bin/       CLI 二进制
+├── config/    用户配置
+├── profiles/  完整数据目标
+├── builds/    不可变 Build 快照
+├── cache/
+│   ├── casc/
+│   ├── dbd/
+│   ├── listfile/
+│   ├── tact/
+│   └── manifests/
+├── state/     安装和最近状态
+├── tmp/       下载临时文件
+└── locks/     跨进程下载锁
+```
+
+缓存默认上限为 20GB。每个 Profile 的当前 Build 和上一个 Build 不参与自动清理，更老的 Build 按最久未使用顺序清理。
+
+```bash
+wowdata cache status
+wowdata cache verify
+wowdata cache prune
+wowdata cache clear
+wowdata cache config --max-gb 30 --workers 6
+```
+
+远端不可用时，CLI 可以使用已经通过完整性校验的离线缓存；缺失、损坏和未完成的缓存不会被使用。
+
+## 诊断和维护
+
+```bash
+wowdata doctor
+wowdata update
+wowdata update --version 1.2.3
+wowdata uninstall
+wowdata uninstall --keep-data
+```
+
+`doctor` 只读检查 CLI/npm、目录、Profile、缓存完整性和基础网络，不自动修改数据。
+
+`uninstall` 默认删除 CLI、托管 Skill 和整个 `~/.wowdata`。使用 `--keep-data` 时保留配置、Profile、Build 和缓存。安装遇到非本包托管的旧 Skill 时会先备份，不会直接覆盖。
+
+## 命令
+
+```text
+warmup
+db2 schema/rows/search/foreign-key/stream
+spell info/auras/summons
+encounter get
+file lookup/search/extension/get/exists/encoding/export
+icon export
+casc info/products/diagnose
+item get/models/geosets/textures
+creature display/model
+decor list/get
+video demux
+profile list/show/set/remove
+cache status/verify/prune/clear/config
+doctor
+update
+uninstall
+```
+
+运行 `wowdata --help` 或 `wowdata <command> --help` 查看完整参数。
+
+## 从源码构建
+
+```bash
+go test ./... -count=1
+go build -trimpath -o dist/wowdata ./cmd/wowdata
+npm test
+```
+
+Go 负责数据解析和命令执行；Node.js 只负责 npm 安装、启动桥接和包生命周期，所有脚本都在 `npm/` 中可审计。
+
+## 发布
+
+推送语义版本 tag 会触发 GitHub Actions：
+
+```bash
+git tag v1.2.3
+git push origin v1.2.3
+```
+
+工作流会测试 Go 和 npm、构建五个平台、生成 `SHA256SUMS`、创建 GitHub Release，并发布同版本 `@follenfang/wowdata`。
+
+## License
+
+AGPL-3.0-or-later

package/npm/bin/wowdata.js

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const path = require('node:path');
+const { binaryName, wowdataHome } = require('../lib/paths');
+const { uninstall } = require('../scripts/uninstall');
+
+function npmInvocation(args, platform = process.platform, env = process.env) {
+  if (platform === 'win32') {
+    return {
+      command: env.ComSpec || 'cmd.exe',
+      args: ['/d', '/s', '/c', 'npm.cmd', ...args]
+    };
+  }
+  return { command: 'npm', args };
+}
+
+function validUpdateVersion(version) {
+  return version === 'latest' || /^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(version);
+}
+
+function runLifecycle(command, args) {
+  const env = { ...process.env };
+  let npmArgs;
+  if (command === 'update') {
+    const index = args.indexOf('--version');
+    const version = index >= 0 && args[index + 1] ? args[index + 1] : 'latest';
+    if (!validUpdateVersion(version)) {
+      process.stdout.write(`${JSON.stringify({ ok: false, command, data: { package: '@follenfang/wowdata' }, warnings: [], error: { code: 'invalid_version', message: 'version must be latest or an exact semantic version' } }, null, 2)}\n`);
+      process.exit(1);
+    }
+    npmArgs = ['install', '-g', `@follenfang/wowdata@${version}`];
+    process.stderr.write(`update package=@follenfang/wowdata version=${version}\n`);
+  } else {
+    const keepData = args.includes('--keep-data');
+    if (keepData) env.WOWDATA_KEEP_DATA = '1';
+    uninstall({ env, keepData });
+    npmArgs = ['uninstall', '-g', '@follenfang/wowdata'];
+    process.stderr.write(`uninstall package=@follenfang/wowdata keepData=${keepData}\n`);
+  }
+  const invocation = npmInvocation(npmArgs, process.platform, env);
+  const result = spawnSync(invocation.command, invocation.args, { env, encoding: 'utf8' });
+  if (result.stderr) process.stderr.write(result.stderr);
+  const ok = result.status === 0;
+  process.stdout.write(`${JSON.stringify({ ok, command, data: { package: '@follenfang/wowdata', keepData: command === 'uninstall' ? args.includes('--keep-data') : undefined, output: (result.stdout || '').trim() }, warnings: [], ...(ok ? {} : { error: { code: `npm_${command}_failed`, message: result.error?.message || `npm exited ${result.status}` } }) }, null, 2)}\n`);
+  process.exit(result.status ?? 1);
+}
+
+function main(args) {
+  if (args[0] === 'update' || args[0] === 'uninstall') runLifecycle(args[0], args.slice(1));
+
+  const binary = path.join(wowdataHome(), 'bin', binaryName());
+  const result = spawnSync(binary, args, { stdio: 'inherit' });
+  if (result.error) {
+    process.stderr.write(`wowdata launch failed: ${result.error.message}; run npm install -g @follenfang/wowdata\n`);
+    process.exit(1);
+  }
+  process.exit(result.status ?? 1);
+}
+
+if (require.main === module) main(process.argv.slice(2));
+
+module.exports = { npmInvocation, validUpdateVersion };

package/npm/lib/fs.js

@@ -0,0 +1,24 @@
+const fs = require('node:fs');
+const path = require('node:path');
+
+function ensureManagedChild(root, target) {
+  const relative = path.relative(path.resolve(root), path.resolve(target));
+  if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+    throw new Error(`path is outside managed root: ${target}`);
+  }
+}
+
+function replacePath(source, target) {
+  fs.rmSync(target, { recursive: true, force: true });
+  fs.renameSync(source, target);
+}
+
+function copyDirectory(source, target) {
+  fs.cpSync(source, target, { recursive: true, force: false, errorOnExist: true });
+}
+
+function timestamp() {
+  return new Date().toISOString().replace(/[:.]/g, '-');
+}
+
+module.exports = { copyDirectory, ensureManagedChild, replacePath, timestamp };

package/npm/lib/paths.js

@@ -0,0 +1,32 @@
+const os = require('node:os');
+const path = require('node:path');
+
+const platformAssets = {
+  'win32-x64': 'wowdata-windows-amd64.exe',
+  'linux-x64': 'wowdata-linux-amd64',
+  'linux-arm64': 'wowdata-linux-arm64',
+  'darwin-x64': 'wowdata-darwin-amd64',
+  'darwin-arm64': 'wowdata-darwin-arm64'
+};
+
+function wowdataHome(env = process.env) {
+  return path.resolve(env.WOWDATA_HOME || path.join(os.homedir(), '.wowdata'));
+}
+
+function agentsHome(env = process.env) {
+  return path.resolve(env.AGENTS_HOME || path.join(os.homedir(), '.agents'));
+}
+
+function assetName(platform = process.platform, arch = process.arch) {
+  const name = platformAssets[`${platform}-${arch}`];
+  if (!name) {
+    throw new Error(`unsupported platform: ${platform}-${arch}`);
+  }
+  return name;
+}
+
+function binaryName(platform = process.platform) {
+  return platform === 'win32' ? 'wowdata.exe' : 'wowdata';
+}
+
+module.exports = { agentsHome, assetName, binaryName, platformAssets, wowdataHome };

package/npm/scripts/install.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+'use strict';
+
+const crypto = require('node:crypto');
+const fs = require('node:fs');
+const path = require('node:path');
+const { agentsHome, assetName, binaryName, wowdataHome } = require('../lib/paths');
+const { copyDirectory, ensureManagedChild, replacePath, timestamp } = require('../lib/fs');
+
+const packageRoot = path.resolve(__dirname, '..', '..');
+const packageJSON = require(path.join(packageRoot, 'package.json'));
+
+function install(options = {}) {
+  const env = options.env || process.env;
+  const home = wowdataHome(env);
+  const agents = agentsHome(env);
+  const dirs = ['bin', 'config', 'profiles', 'builds', 'cache/casc', 'cache/dbd', 'cache/listfile', 'cache/tact', 'cache/manifests', 'state', 'tmp', 'locks'];
+  for (const dir of dirs) fs.mkdirSync(path.join(home, dir), { recursive: true });
+
+  const sourceBinary = options.sourceBinary || path.join(packageRoot, 'dist', assetName(options.platform, options.arch));
+  if (!fs.existsSync(sourceBinary)) throw new Error(`binary asset is missing: ${sourceBinary}`);
+  const targetBinary = path.join(home, 'bin', binaryName(options.platform));
+  const binaryTemp = path.join(home, 'tmp', `${binaryName(options.platform)}.${process.pid}.tmp`);
+  fs.copyFileSync(sourceBinary, binaryTemp);
+  fs.chmodSync(binaryTemp, 0o755);
+  replacePath(binaryTemp, targetBinary);
+
+  const sourceSkill = path.join(packageRoot, 'skill', 'wowdata');
+  const skillsRoot = path.join(agents, 'skills');
+  const targetSkill = path.join(skillsRoot, 'wowdata');
+  fs.mkdirSync(skillsRoot, { recursive: true });
+  ensureManagedChild(skillsRoot, targetSkill);
+  if (fs.existsSync(targetSkill)) {
+    const markerPath = path.join(targetSkill, '.wowdata-managed.json');
+    let managed = false;
+    try {
+      const marker = JSON.parse(fs.readFileSync(markerPath, 'utf8'));
+      managed = marker.package === '@follenfang/wowdata';
+    } catch {}
+    if (!managed) {
+      let backup = path.join(skillsRoot, `wowdata.backup-${timestamp()}`);
+      let suffix = 1;
+      while (fs.existsSync(backup)) backup = path.join(skillsRoot, `wowdata.backup-${timestamp()}-${suffix++}`);
+      fs.renameSync(targetSkill, backup);
+    }
+  }
+  const skillTemp = path.join(skillsRoot, `.wowdata.${process.pid}.tmp`);
+  fs.rmSync(skillTemp, { recursive: true, force: true });
+  copyDirectory(sourceSkill, skillTemp);
+  const marker = {
+    schema: 'wowdata.skill-install.v1',
+    package: '@follenfang/wowdata',
+    version: packageJSON.version,
+    installedAt: new Date().toISOString()
+  };
+  fs.writeFileSync(path.join(skillTemp, '.wowdata-managed.json'), `${JSON.stringify(marker, null, 2)}\n`);
+  replacePath(skillTemp, targetSkill);
+
+  const sha256 = crypto.createHash('sha256').update(fs.readFileSync(targetBinary)).digest('hex');
+  const state = { schema: 'wowdata.install.v1', package: '@follenfang/wowdata', version: packageJSON.version, binary: targetBinary, sha256 };
+  fs.writeFileSync(path.join(home, 'state', 'install.json'), `${JSON.stringify(state, null, 2)}\n`);
+  return { home, targetBinary, targetSkill, sha256 };
+}
+
+if (require.main === module) {
+  try {
+    const result = install();
+    process.stderr.write(`wowdata installed binary=${result.targetBinary} skill=${result.targetSkill}\n`);
+  } catch (error) {
+    process.stderr.write(`wowdata install failed: ${error.message}\n`);
+    process.exitCode = 1;
+  }
+}
+
+module.exports = { install };

package/npm/scripts/uninstall.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { agentsHome, wowdataHome } = require('../lib/paths');
+const { ensureManagedChild } = require('../lib/fs');
+
+function uninstall(options = {}) {
+  const env = options.env || process.env;
+  const home = wowdataHome(env);
+  const skillsRoot = path.join(agentsHome(env), 'skills');
+  const targetSkill = path.join(skillsRoot, 'wowdata');
+  ensureManagedChild(skillsRoot, targetSkill);
+  let skillRemoved = false;
+  if (fs.existsSync(targetSkill)) {
+    try {
+      const marker = JSON.parse(fs.readFileSync(path.join(targetSkill, '.wowdata-managed.json'), 'utf8'));
+      if (marker.package === '@follenfang/wowdata') {
+        fs.rmSync(targetSkill, { recursive: true, force: true });
+        skillRemoved = true;
+      }
+    } catch {}
+  }
+
+  const keepData = options.keepData ?? env.WOWDATA_KEEP_DATA === '1';
+  if (keepData) {
+    const bin = path.join(home, 'bin');
+    ensureManagedChild(home, bin);
+    fs.rmSync(bin, { recursive: true, force: true });
+  } else if (fs.existsSync(home)) {
+    const parent = path.dirname(home);
+    ensureManagedChild(parent, home);
+    fs.rmSync(home, { recursive: true, force: true });
+  }
+  return { home, keepData, skillRemoved };
+}
+
+if (require.main === module) {
+  try {
+    const result = uninstall();
+    process.stderr.write(`wowdata uninstalled keepData=${result.keepData} skillRemoved=${result.skillRemoved}\n`);
+  } catch (error) {
+    process.stderr.write(`wowdata uninstall failed: ${error.message}\n`);
+    process.exitCode = 1;
+  }
+}
+
+module.exports = { uninstall };

package/npm/test/install.test.js

@@ -0,0 +1,32 @@
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { install } = require('../scripts/install');
+const { uninstall } = require('../scripts/uninstall');
+
+test('installs binary and Skill, backs up unknown Skill, and uninstalls data', () => {
+  const root = fs.mkdtempSync(path.join(os.tmpdir(), 'wowdata-npm-'));
+  const home = path.join(root, '.wowdata');
+  const agents = path.join(root, '.agents');
+  const oldSkill = path.join(agents, 'skills', 'wowdata');
+  fs.mkdirSync(oldSkill, { recursive: true });
+  fs.writeFileSync(path.join(oldSkill, 'user.txt'), 'keep');
+  const sourceBinary = path.join(root, process.platform === 'win32' ? 'source.exe' : 'source');
+  fs.writeFileSync(sourceBinary, 'binary');
+
+  const result = install({ env: { WOWDATA_HOME: home, AGENTS_HOME: agents }, sourceBinary, platform: process.platform, arch: process.arch });
+  assert.equal(fs.existsSync(result.targetBinary), true);
+  assert.equal(fs.existsSync(path.join(result.targetSkill, 'SKILL.md')), true);
+  const backups = fs.readdirSync(path.join(agents, 'skills')).filter((name) => name.startsWith('wowdata.backup-'));
+  assert.equal(backups.length, 1);
+  assert.equal(fs.readFileSync(path.join(agents, 'skills', backups[0], 'user.txt'), 'utf8'), 'keep');
+
+  uninstall({ env: { WOWDATA_HOME: home, AGENTS_HOME: agents }, keepData: false });
+  assert.equal(fs.existsSync(home), false);
+  assert.equal(fs.existsSync(result.targetSkill), false);
+  assert.equal(fs.existsSync(path.join(agents, 'skills', backups[0], 'user.txt')), true);
+});

package/npm/test/launcher.test.js

@@ -0,0 +1,19 @@
+'use strict';
+
+const test = require('node:test');
+const assert = require('node:assert/strict');
+const { npmInvocation, validUpdateVersion } = require('../bin/wowdata');
+
+test('uses cmd.exe to launch npm.cmd on Windows', () => {
+  const invocation = npmInvocation(['uninstall', '-g', '@follenfang/wowdata'], 'win32', { ComSpec: 'C:\\Windows\\System32\\cmd.exe' });
+  assert.equal(invocation.command, 'C:\\Windows\\System32\\cmd.exe');
+  assert.deepEqual(invocation.args, ['/d', '/s', '/c', 'npm.cmd', 'uninstall', '-g', '@follenfang/wowdata']);
+});
+
+test('accepts only latest or exact semantic versions', () => {
+  assert.equal(validUpdateVersion('latest'), true);
+  assert.equal(validUpdateVersion('1.2.3'), true);
+  assert.equal(validUpdateVersion('1.2.3-beta.1'), true);
+  assert.equal(validUpdateVersion('latest & whoami'), false);
+  assert.equal(validUpdateVersion('^1.2.3'), false);
+});

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@follenfang/wowdata",
+  "version": "0.0.1",
+  "description": "Auditable CLI for querying World of Warcraft CASC and DB2 data",
+  "license": "AGPL-3.0-or-later",
+  "type": "commonjs",
+  "bin": {
+    "wowdata": "npm/bin/wowdata.js"
+  },
+  "files": [
+    "dist/",
+    "npm/",
+    "skill/wowdata/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node npm/scripts/install.js",
+    "preuninstall": "node npm/scripts/uninstall.js",
+    "test": "node --test npm/test/*.test.js",
+    "pack:check": "npm pack --dry-run"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Follen/wowdata.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Follen/wowdata/issues"
+  },
+  "homepage": "https://github.com/Follen/wowdata#readme"
+}

package/skill/wowdata/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: wowdata
+description: Use the wowdata CLI for World of Warcraft CASC, DB2, file, icon, spell, encounter, item, creature, decor, video, Build, cache, and diagnostic tasks.
+---
+
+# wowdata
+
+CLI only. Run `wowdata` from PATH. Do not look for a bundled executable and do not use any server transport.
+
+## Target Contract
+
+Every data command must receive a complete target or an explicit `--profile`.
+
+1. Preserve source, path, region, product, Build, and locale when the user states them.
+2. For an unspecified remote region, Build, or locale, explicitly pass `--source remote --region cn --build latest --locale zhCN`.
+3. Product has no default. Resolve it from the user's words or the current conversation only when there is one unambiguous product. Otherwise ask the user which product they mean before running the CLI.
+4. Never rely on CLI defaults. The CLI intentionally has none.
+
+Read [clients.yaml](references/clients.yaml) for stable product aliases and [locales.yaml](references/locales.yaml) for language aliases. Do not store a current Build number in this Skill.
+
+## Atomic Use
+
+Call the business command directly. The CLI checks Build identity and cache integrity, downloads missing data, reports preparation on stderr, then returns the final JSON on stdout. Do not run `warmup` before ordinary queries.
+
+Use `casc products` only when the user asks which combinations exist. Use `warmup` only when the user explicitly asks to download data ahead of time. Use `doctor` when a command reports an environment, cache, target, or network problem.
+
+```powershell
+wowdata db2 rows SpellName --id 123 --source remote --region cn --product wow --build latest --locale zhCN
+wowdata spell info --spell-id 123 --source remote --region cn --product wow_classic --build latest --locale zhCN
+wowdata icon export --file-data-id 134400 --format png --output output/icon.png --source remote --region cn --product wow --build latest --locale zhCN
+wowdata casc products --source remote --region cn
+wowdata doctor
+```
+
+Read [commands.md](references/commands.md) before composing unfamiliar commands and [tables.yaml](references/tables.yaml) when mapping a semantic task to DB2 tables. Keep exported files in the user's requested directory or the current workspace.
+
+## Output
+
+Preparation and download progress is stderr. The final structured result is stdout JSON. Preserve product, resolved Build, region, locale, table, fileDataID, output path, and diagnostics in the answer so the result stays traceable.

package/skill/wowdata/VERSION

@@ -0,0 +1 @@
+0.0.1

package/skill/wowdata/agents/openai.yaml

@@ -0,0 +1,4 @@
+interface:
+  display_name: wowdata
+  short_description: Query and export World of Warcraft data through the wowdata CLI.
+  default_prompt: Use wowdata atomic CLI commands with a complete explicit target. Default remote region/build/locale to cn/latest/zhCN in the Skill, and ask when product is unclear.

package/skill/wowdata/references/clients.yaml

@@ -0,0 +1,13 @@
+schema: wowdata.clients.v1
+clients:
+  retail: wow
+  ptr: wowt
+  ptr2: wowxptr
+  beta: wow_beta
+  classic: wow_classic
+  classic-ptr: wow_classic_ptr
+  classic-beta: wow_classic_beta
+  classic-era: wow_classic_era
+  classic-era-ptr: wow_classic_era_ptr
+  classic-anniversary: wow_anniversary
+  classic-titan: wow_classic_titan

package/skill/wowdata/references/commands.md

@@ -0,0 +1,24 @@
+# Command Reference
+
+Run `wowdata <command> --help` when a flag is uncertain. Every data command needs either `--profile <name>` or a complete target.
+
+| Intent | Atomic command |
+| --- | --- |
+| Discover products and Builds | `casc products` |
+| Prepare data ahead of time | `warmup` |
+| DB2 schema, rows, text search, relations, stream | `db2 schema/rows/search/foreign-key/stream` |
+| Spell details, auras, summons | `spell info/auras/summons` |
+| Encounter tree | `encounter get` |
+| File lookup, search, type, fetch, existence, encoding, export | `file lookup/search/extension/get/exists/encoding/export` |
+| Export BLP icon | `icon export` |
+| Build and CASC state | `casc info/products/diagnose` |
+| Item data and assets | `item get/models/geosets/textures` |
+| Creature display and model | `creature display/model` |
+| Decor data | `decor list/get` |
+| Video container | `video demux` |
+| Named complete targets | `profile list/show/set/remove` |
+| Cache lifecycle | `cache status/verify/prune/clear/config` |
+| Installation diagnosis | `doctor` |
+| Package maintenance | `update`, `uninstall` |
+
+Do not use the obsolete `query rows` spelling. The command is `db2 rows`.

package/skill/wowdata/references/locales.yaml

@@ -0,0 +1,16 @@
+schema: wowdata.locales.v1
+default: zhCN
+locales:
+  zhCN: [简体中文, 国服中文, cn]
+  zhTW: [繁体中文, 台湾中文, tw]
+  enUS: [英文, 美式英文, us]
+  enGB: [英式英文, gb]
+  koKR: [韩文, kr]
+  frFR: [法文, fr]
+  deDE: [德文, de]
+  esES: [西班牙文, es]
+  esMX: [拉美西语, mx]
+  ruRU: [俄文, ru]
+  ptBR: [巴西葡语, br]
+  itIT: [意大利文, it]
+  ptPT: [葡萄牙文, pt]

package/skill/wowdata/references/tables.yaml

@@ -0,0 +1,7 @@
+schema: wowdata.tables.v1
+intents:
+  spell: [SpellName, Spell, SpellEffect, SpellMisc, SpellCastTimes, SpellDuration, SpellRange]
+  encounter: [JournalEncounterSection]
+  item: [Item, ItemSparse, ModelFileData, TextureFileData, ComponentModelFileData, ItemDisplayInfo, HelmetGeosetData, ItemDisplayInfoMaterialRes, ItemModifiedAppearance, ItemAppearance]
+  creature: [CreatureDisplayInfo, CreatureModelData, CreatureDisplayInfoGeosetData]
+  decor: [HouseDecor]