@follenfang/wowdoc 0.0.4 → 0.0.6

package/README.md

@@ -13,24 +13,20 @@ The product is CLI-only. The included Agent Skill translates a natural-language
 ```powershell
 npm install -g @follenfang/wowdoc
 wowdoc --version
-wowdata --help
+wowdoc --help
 ```
 
-The package installs:
-
-- `wowdoc`: read-only source queries and explicit source/index operations;
-- `wowdata`: local data initialization, update, cleanup, and uninstall;
-- the `wowdoc` Skill in `~/.agents/skills/wowdoc`.
+The package installs the `wowdoc` CLI and the `wowdoc` Skill in `~/.agents/skills/wowdoc`. The single CLI handles queries, source/index operations, initialization, updates, cleanup, and uninstall.
 
 Run the one-time data initialization before querying source:
 
 ```powershell
-wowdata init
+wowdoc init
 ```
 
 Initialization creates `~/.wowdoc`, fetches the configured Git mirrors, and builds searchable SQLite snapshots for each product branch and its hot Tags. It can take time and substantial disk space. The command is resumable: rerunning it keeps completed work and continues failed or pending snapshots.
 
-If Git is missing, `wowdata init` detects the platform package manager, shows the exact package and installer command, installs Git, refreshes `PATH`, and verifies `git --version`. `wowdoc doctor` remains read-only.
+If Git is missing, `wowdoc init` detects the platform package manager, shows the exact package and installer command, installs Git, refreshes `PATH`, and verifies `git --version`. `wowdoc doctor` remains read-only.
 
 ## Supported source
 
@@ -86,8 +82,7 @@ wowdoc query|explore|inspect|diff|validate
 wowdoc source list|check|sync
 wowdoc index build|refresh|status
 wowdoc doctor
-
-wowdata init|update|clean|uninstall
+wowdoc init|update|clean|uninstall
 ```
 
 Common lifecycle:
@@ -103,10 +98,10 @@ wowdoc source sync --source elvui --product main
 wowdoc index refresh --source elvui --product main --ref latest
 
 # Preview cleanup; no files are deleted
-wowdata clean
+wowdoc clean
 ```
 
-Use `wowdata clean --apply` only after reviewing its candidates. Removing indexed versions requires an explicit version or range. `wowdata uninstall` requires confirmation and removes the npm package, managed Skill, and `~/.wowdoc` data.
+Use `wowdoc clean --yes` only after reviewing its candidates. Removing indexed versions requires an explicit version or range. `wowdoc uninstall` requires confirmation and removes the npm package, managed Skill, and `~/.wowdoc` data.
 
 ## Storage model
 
@@ -114,7 +109,7 @@ Local state lives under `~/.wowdoc`:
 
 ```text
 config/         versioned source catalog and local configuration
-repositories/   bare partial Git mirrors
+repositories/   complete bare Git mirrors
 objects/        content-addressed source and asset bytes
 ast/            auditable per-file JSON syntax trees
 indexes/        one WAL SQLite database per product branch
@@ -142,10 +137,9 @@ go test ./...
 go vet ./...
 npm pack --dry-run
 go run ./cmd/wowdoc --help
-go run ./cmd/wowdata --help
 ```
 
-Release tags use `vMAJOR.MINOR.PATCH`. GitHub Actions tests the project, builds `wowdoc` and `wowdata` for Windows amd64, Linux amd64/arm64, and macOS amd64/arm64, publishes checksums and a GitHub Release, then publishes the matching npm version through npm Trusted Publisher OIDC with provenance.
+Release tags use `vMAJOR.MINOR.PATCH`. GitHub Actions tests the project, builds `wowdoc` for Windows amd64, Linux amd64/arm64, and macOS amd64/arm64, publishes checksums and a GitHub Release, then publishes the matching npm version through npm Trusted Publisher OIDC with provenance.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@follenfang/wowdoc",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "description": "Auditable WoW UI source intelligence CLI for coding agents",
   "license": "MIT",
   "type": "module",
@@ -9,8 +9,7 @@
     "url": "https://github.com/Follen/wowdoc"
   },
   "bin": {
-    "wowdoc": "bin/wowdoc.mjs",
-    "wowdata": "bin/wowdata.mjs"
+    "wowdoc": "bin/wowdoc.mjs"
   },
   "files": [
     "bin/",

package/scripts/check-package.mjs

@@ -1,4 +1,10 @@
-import { existsSync } from "node:fs";
-for (const path of ["bin/wowdoc.mjs", "bin/wowdata.mjs", "scripts/install.mjs", "skill/SKILL.md"]) {
+import { existsSync, readFileSync } from "node:fs";
+
+for (const path of ["bin/wowdoc.mjs", "scripts/install.mjs", "skill/SKILL.md"]) {
   if (!existsSync(new URL(`../${path}`, import.meta.url))) throw new Error(`package file missing: ${path}`);
 }
+
+const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+if (JSON.stringify(pkg.bin) !== JSON.stringify({ wowdoc: "bin/wowdoc.mjs" })) {
+  throw new Error("package must expose only the wowdoc executable");
+}

package/scripts/install.mjs

@@ -20,22 +20,21 @@ if (!platform) throw new Error(`unsupported_platform: ${process.platform}-${proc
 const nativeDir = join(root, "native");
 mkdirSync(nativeDir, { recursive: true });
 
-for (const name of ["wowdoc", "wowdata"]) {
-  const target = join(nativeDir, name + suffix);
-  const supplied = process.env.WOWDOC_BINARY_DIR && join(process.env.WOWDOC_BINARY_DIR, name + suffix);
-  if (supplied && existsSync(supplied)) {
-    cpSync(supplied, target);
-  } else if (existsSync(join(root, "go.mod"))) {
-    execFileSync("go", ["build", "-trimpath", "-ldflags", `-s -w -X github.com/follenfang/wowdoc/internal/app.Version=${pkg.version}`, "-o", target, `./cmd/${name}`], { cwd: root, stdio: "inherit" });
-  } else {
-    const asset = `${name}-${platform}${suffix}`;
-    const url = `https://github.com/Follen/wowdoc/releases/download/v${pkg.version}/${asset}`;
-    const response = await fetch(url, { redirect: "follow" });
-    if (!response.ok) throw new Error(`binary_download_failed: ${response.status} ${url}`);
-    writeFileSync(target, Buffer.from(await response.arrayBuffer()));
-  }
-  if (process.platform !== "win32") chmodSync(target, 0o755);
+const name = "wowdoc";
+const target = join(nativeDir, name + suffix);
+const supplied = process.env.WOWDOC_BINARY_DIR && join(process.env.WOWDOC_BINARY_DIR, name + suffix);
+if (supplied && existsSync(supplied)) {
+  cpSync(supplied, target);
+} else if (existsSync(join(root, "go.mod"))) {
+  execFileSync("go", ["build", "-trimpath", "-ldflags", `-s -w -X github.com/follenfang/wowdoc/internal/app.Version=${pkg.version}`, "-o", target, `./cmd/${name}`], { cwd: root, stdio: "inherit" });
+} else {
+  const asset = `${name}-${platform}${suffix}`;
+  const url = `https://github.com/Follen/wowdoc/releases/download/v${pkg.version}/${asset}`;
+  const response = await fetch(url, { redirect: "follow" });
+  if (!response.ok) throw new Error(`binary_download_failed: ${response.status} ${url}`);
+  writeFileSync(target, Buffer.from(await response.arrayBuffer()));
 }
+if (process.platform !== "win32") chmodSync(target, 0o755);
 
 const skillSource = join(root, "skill");
 const skillTarget = join(homedir(), ".agents", "skills", "wowdoc");

package/skill/SKILL.md

@@ -15,4 +15,6 @@ Translate the user's wording into explicit `source`, `product`, `ref`, `topic`,
 6. Do not apply latest fallback to `ambiguous_version`, `unsupported_build`, `ref_not_found`, or update failures.
 7. Cite `sourceId`, product, Tag when present, resolved Commit, path, line, and the returned excerpt. Treat `dynamic-unresolved` edges as unresolved, not exact.
 
+The data directory defaults to `~/.wowdoc`. `WOWDOC_HOME` may override it with another writable path for an isolated workspace, another drive, or a server deployment. This changes only wowdoc's source, index, object, lock, and log storage; it does not change the npm installation directory or the Skill directory. Run `wowdoc doctor` to see the resolved data directory.
+
 Read [source-catalog.md](references/source-catalog.md) for source/product names and [commands.md](references/commands.md) for command selection.

package/skill/references/commands.md

@@ -13,6 +13,35 @@ wowdoc source sync  --source SOURCE --product PRODUCT
 wowdoc index build  --source SOURCE --product PRODUCT --ref REF
 wowdoc index refresh --source SOURCE --product PRODUCT --ref REF
 wowdoc index status --source SOURCE --product PRODUCT
+wowdoc init
+wowdoc doctor
+wowdoc update --dry-run
+wowdoc clean
+wowdoc clean --yes
+wowdoc uninstall
+wowdoc uninstall --yes
 ```
 
 Use exact qualified identifiers when known. For natural-language questions, select a topic and use the narrowest stable identifier, event, template, TOC field, asset path, or API name present in the question. Prefer results marked `exact_symbol`; verify relationship confidence and retain the returned excerpt as evidence.
+
+## Data directory
+
+Without configuration, all source mirrors, objects, indexes, manifests, locks, logs, and temporary worktrees live under `~/.wowdoc`.
+
+Use another writable directory by setting `WOWDOC_HOME` before invoking wowdoc. PowerShell:
+
+```powershell
+$env:WOWDOC_HOME = 'D:\WOWData\wowdoc'
+wowdoc doctor
+wowdoc init
+```
+
+Bash or zsh:
+
+```bash
+export WOWDOC_HOME="$HOME/wowdoc-data"
+wowdoc doctor
+wowdoc init
+```
+
+The override applies to every wowdoc command launched from that environment. `wowdoc doctor` reports the resolved `home`. The npm package remains in the npm global prefix, and the Skill remains in `~/.agents/skills/wowdoc`.

package/bin/wowdata.mjs

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import { run } from "./run.mjs";
-run("wowdata");