@follenfang/wowdoc 0.0.3 → 0.0.5

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
@@ -131,7 +126,7 @@ Each parser task fixes the requested ref to a Commit and creates its own detache
 
 The installed Skill contains source/product aliases and command-selection rules, not copied source facts. An Agent chooses the source, product, ref, topic, and narrowest useful identifier, then cites the CLI evidence. A missing exact plugin Tag can fall back to that product branch's latest snapshot only when the Skill labels the result as a latest fallback and preserves the originally requested version.
 
-The quality suite contains 50 realistic AddOn-author questions across all configured product branches and historical Tags. A strict pass requires the first reference to be correct, relevant, context-complete, version-correct, and byte-for-byte traceable to the resolved Git blob. The current report is in [`quality/report.md`](quality/report.md).
+The quality suite contains 50 realistic AddOn-author questions across all configured product branches and historical Tags. A strict pass requires the first reference to be correct, relevant, context-complete, version-correct, and byte-for-byte traceable to the resolved Git blob. Local scenarios and generated reports live in the Git-ignored `analyze/quality` directory.
 
 ## Development
 
@@ -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.3",
+  "version": "0.0.5",
   "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/evaluate-quality.mjs

@@ -4,7 +4,8 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 
 const root = resolve(import.meta.dirname, "..");
-const scenarios = JSON.parse(readFileSync(join(root, "quality", "scenarios.json"), "utf8"));
+const qualityDir = join(root, "analyze", "quality");
+const scenarios = JSON.parse(readFileSync(join(qualityDir, "scenarios.json"), "utf8"));
 const home = process.env.WOWDOC_HOME;
 if (!home) throw new Error("WOWDOC_HOME is required so quality data stays isolated");
 const suffix = process.platform === "win32" ? ".exe" : "";
@@ -45,9 +46,9 @@ for (const [index, scenario] of scenarios.entries()) {
 
 const summary = summarize(results);
 const artifact = { schema: "wowdoc.quality.v1", generatedAt: new Date().toISOString(), home, summary, results };
-mkdirSync(join(root, "quality"), { recursive: true });
-writeFileSync(join(root, "quality", "results.json"), JSON.stringify(artifact, null, 2));
-writeFileSync(join(root, "quality", "report.md"), markdown(artifact));
+mkdirSync(qualityDir, { recursive: true });
+writeFileSync(join(qualityDir, "results.json"), JSON.stringify(artifact, null, 2));
+writeFileSync(join(qualityDir, "report.md"), markdown(artifact));
 process.stdout.write(JSON.stringify(summary, null, 2) + "\n");
 process.exit(summary.passed === summary.total ? 0 : 1);
 

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/bin/wowdata.mjs

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