@quicktvui/ai-cli 1.1.1 → 1.1.2

package/README.md

@@ -8,6 +8,15 @@ QuickTVUI skill runtime CLI.
 npm install -g @quicktvui/ai-cli @quicktvui/ai-skills
 ```
 
+Starting from `@quicktvui/ai-cli@1.1.2`, global install/upgrade auto-runs
+`quicktvui-ai update` to sync:
+
+- `~/.agents/skills/quicktvui`
+- `~/.gemini/GEMINI.md` bridge block
+- `~/.gemini/settings.json` context file names
+
+Set `QUICKTVUI_AI_SKIP_POSTINSTALL=1` to disable auto-sync.
+
 ## Commands
 
 ```bash
@@ -47,14 +56,12 @@ quicktvui-aicreate-project quick-tv-app
 - `--skip-node-install`: skip Node.js install stage in `setup-vue-env`
 - `--force-node-install`: force Node.js install stage in `setup-vue-env`
 - `--skip-yarn-install`: skip yarn global install in `setup-vue-env`
-- `--skip-quicktvui-cli-install`: skip `@quicktvui/cli` global install in `setup-vue-env`
 - `--skip-project-install`: skip project dependency install in `setup-vue-env`
 - `--auto-emulator <true|false>`: auto create/start emulator when no adb device
 - `--adb-path <path>`: custom adb path/command (or use env `QUICKTVUI_ADB_PATH`)
 - `--device-ip <ip[:port]>`: preferred real device endpoint for `adb connect`
 - `--avd-name <name>`: custom AVD name for `setup-android-env`
 - `--headless`: start emulator with `-no-window -no-audio`
-- `--runtime-setup-mode <direct|qui>`: runtime setup mode (default `direct`)
 - `--runtime-version <version>`: pin runtime version in `direct` mode
 - `--runtime-url <url>`: use custom runtime apk url in `direct` mode
 - `--server-host <ip>`: override debug server host IP
@@ -118,12 +125,6 @@ This command:
 10. Installs runtime APK and configures debug server host (direct mode by default).
 11. Launches runtime app and waits it enters running state.
 
-To use official interactive setup flow instead of direct mode:
-
-```bash
-quicktvui-ai setup-android-env --project ./quick-tv-app --runtime-setup-mode qui
-```
-
 ## Configure Vue env (Node + package manager)
 
 ```bash
@@ -133,7 +134,7 @@ quicktvui-ai setup-vue-env --project ./quick-tv-app
 This command:
 
 1. Ensures Node.js LTS (macOS/Windows auto install).
-2. Ensures `yarn` and `@quicktvui/cli` are installed globally.
+2. Ensures `yarn` is installed globally.
 3. Installs project dependencies (`yarn install` or `npm install` fallback).
 
 ## Configure All Dev Envs

package/lib/index.js

@@ -7,7 +7,13 @@ const https = require("https");
 const net = require("net");
 const { spawnSync, spawn } = require("child_process");
 
-const PACKAGE_VERSION = "0.1.4";
+const PACKAGE_VERSION = (() => {
+  try {
+    return require("../package.json").version || "0.0.0";
+  } catch (error) {
+    return "0.0.0";
+  }
+})();
 const DEFAULT_INSTALL_DIR = path.join(
   os.homedir(),
   ".agents",
@@ -33,6 +39,8 @@ const REQUIRED_SKILL_FILES = [
   "SKILL.md",
   path.join("references", "scaffold-checklist.md"),
   path.join("references", "create-project-checklist.md"),
+  path.join("references", "dev-env-checklist.md"),
+  path.join("references", "esapp-protocol-cheatsheet.md"),
   path.join("references", "lookup-checklist.md"),
   path.join("references", "bug-report-template.md"),
 ];
@@ -1783,10 +1791,6 @@ async function runSetupVueEnv(args) {
   );
   const skipNodeInstall = toBooleanFlag(args["skip-node-install"], false);
   const skipYarnInstall = toBooleanFlag(args["skip-yarn-install"], false);
-  const skipQuicktvuiCliInstall = toBooleanFlag(
-    args["skip-quicktvui-cli-install"],
-    false,
-  );
   const skipProjectInstall = toBooleanFlag(args["skip-project-install"], false);
 
   if (
@@ -1818,13 +1822,6 @@ async function runSetupVueEnv(args) {
     runCommand("npm", ["install", "-g", "yarn"], { stdio: "inherit" });
   }
 
-  if (!skipQuicktvuiCliInstall && !commandCanRun("qui", ["--help"])) {
-    console.log("Installing @quicktvui/cli globally...");
-    runCommand("npm", ["install", "-g", "@quicktvui/cli@latest"], {
-      stdio: "inherit",
-    });
-  }
-
   if (!skipProjectInstall) {
     if (!exists(path.join(projectRoot, "package.json"))) {
       throw new Error(`Missing package.json in project root: ${projectRoot}`);
@@ -1865,10 +1862,6 @@ async function runSetupAndroidEnv(args) {
   const projectRoot = args.project ? path.resolve(args.project) : process.cwd();
   const skipRuntimeSetup = toBooleanFlag(args["skip-runtime-setup"], false);
   const autoEmulator = toBooleanFlag(args["auto-emulator"], true);
-  const runtimeSetupMode =
-    typeof args["runtime-setup-mode"] === "string"
-      ? String(args["runtime-setup-mode"]).trim().toLowerCase()
-      : "direct";
   const avdName =
     typeof args["avd-name"] === "string" && args["avd-name"].trim()
       ? args["avd-name"].trim()
@@ -2025,23 +2018,12 @@ async function runSetupAndroidEnv(args) {
 
   let hostIp = getLocalIPv4Address();
   if (!skipRuntimeSetup) {
-    if (runtimeSetupMode === "qui") {
-      if (!commandCanRun("qui", ["--help"])) {
-        throw new Error(
-          "QuickTVUI CLI 'qui' is unavailable. Run: npm install -g @quicktvui/cli@latest",
-        );
-      }
-      console.log("Running 'qui setup' to configure runtime APK...");
-      runCommand("qui", ["setup"], { cwd: projectRoot });
-      hostIp = getLocalIPv4Address();
-    } else {
-      const runtimeResult = await ensureRuntimeInstalledAndConfigured(
-        adbPath,
-        targetSerial,
-        args,
-      );
-      hostIp = runtimeResult.hostIp;
-    }
+    const runtimeResult = await ensureRuntimeInstalledAndConfigured(
+      adbPath,
+      targetSerial,
+      args,
+    );
+    hostIp = runtimeResult.hostIp;
   } else {
     console.log("Skip runtime setup due to --skip-runtime-setup.");
   }
@@ -2216,34 +2198,155 @@ async function runRunEsapp(args) {
   console.log("ES app launch command sent.");
 }
 
-function resolveSkillsSource() {
+function parseVersionSegments(version) {
+  const normalized = String(version || "0.0.0")
+    .trim()
+    .split("-")[0];
+  const parts = normalized ? normalized.split(".") : [];
+  if (parts.length === 0) return [0, 0, 0];
+
+  return parts.map((part) => {
+    const parsed = Number.parseInt(part, 10);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+  });
+}
+
+function compareVersionStrings(left, right) {
+  const leftParts = parseVersionSegments(left);
+  const rightParts = parseVersionSegments(right);
+  const total = Math.max(leftParts.length, rightParts.length);
+  for (let i = 0; i < total; i += 1) {
+    const leftValue = leftParts[i] || 0;
+    const rightValue = rightParts[i] || 0;
+    if (leftValue > rightValue) return 1;
+    if (leftValue < rightValue) return -1;
+  }
+  return 0;
+}
+
+function buildSkillsSourceCandidateFromPackageRoot(packageRoot, sourceLabel) {
+  if (!packageRoot) return null;
+  const resolvedPackageRoot = path.resolve(packageRoot);
+  const sourceDir = path.join(resolvedPackageRoot, "skills", "quicktvui");
+  if (!exists(sourceDir)) return null;
+
+  let version = "0.0.0";
+  const packageJsonPath = path.join(resolvedPackageRoot, "package.json");
+  if (exists(packageJsonPath)) {
+    try {
+      const packageJson = readJsonFile(packageJsonPath);
+      if (
+        packageJson &&
+        typeof packageJson.version === "string" &&
+        packageJson.version.trim()
+      ) {
+        version = packageJson.version.trim();
+      }
+    } catch (error) {
+      // Ignore parse errors; keep default version for ordering.
+    }
+  }
+
+  return {
+    sourceLabel,
+    sourceDir,
+    packageRoot: resolvedPackageRoot,
+    version,
+  };
+}
+
+function buildSkillsSourceCandidateFromRequire() {
   try {
-    // Preferred: installed dependency
     const { getSkillsRoot } = require("@quicktvui/ai-skills");
-    const resolved = path.join(getSkillsRoot(), "quicktvui");
-    if (exists(resolved)) return resolved;
+    if (typeof getSkillsRoot !== "function") return null;
+    const resolvedSkillsRoot = getSkillsRoot();
+    const sourceDir = path.join(resolvedSkillsRoot, "quicktvui");
+    if (!exists(sourceDir)) return null;
+
+    let packageRoot = null;
+    let version = "0.0.0";
+    try {
+      const packageJsonPath =
+        require.resolve("@quicktvui/ai-skills/package.json");
+      packageRoot = path.dirname(packageJsonPath);
+      const packageJson = readJsonFile(packageJsonPath);
+      if (
+        packageJson &&
+        typeof packageJson.version === "string" &&
+        packageJson.version.trim()
+      ) {
+        version = packageJson.version.trim();
+      }
+    } catch (error) {
+      // Keep fallback metadata if package.json cannot be resolved.
+    }
+
+    return {
+      sourceLabel: "dependency-resolved",
+      sourceDir: path.resolve(sourceDir),
+      packageRoot: packageRoot ? path.resolve(packageRoot) : null,
+      version,
+    };
   } catch (error) {
-    // Fallback for monorepo local development
+    return null;
   }
+}
+
+function resolveSkillsSource() {
+  const candidates = [];
+  const seenSourceDirs = new Set();
 
-  const localFallback = path.resolve(
+  function addCandidate(candidate) {
+    if (!candidate || !candidate.sourceDir) return;
+    const key = path.resolve(candidate.sourceDir);
+    if (seenSourceDirs.has(key)) return;
+    seenSourceDirs.add(key);
+    candidates.push(candidate);
+  }
+
+  // Prefer globally upgraded sibling package if present.
+  const globalSiblingPackageRoot = path.resolve(
+    __dirname,
+    "..",
+    "..",
+    "ai-skills",
+  );
+  addCandidate(
+    buildSkillsSourceCandidateFromPackageRoot(
+      globalSiblingPackageRoot,
+      "global-sibling",
+    ),
+  );
+
+  // Dependency resolution keeps compatibility when only @quicktvui/ai-cli is installed.
+  addCandidate(buildSkillsSourceCandidateFromRequire());
+
+  // Monorepo fallback for local development.
+  const monorepoPackageRoot = path.resolve(
     __dirname,
     "..",
     "..",
     "..",
     "packages",
     "quicktvui-ai-skills",
-    "skills",
-    "quicktvui",
+  );
+  addCandidate(
+    buildSkillsSourceCandidateFromPackageRoot(monorepoPackageRoot, "monorepo"),
   );
 
-  if (!exists(localFallback)) {
+  if (candidates.length === 0) {
     throw new Error(
       "Unable to locate QuickTVUI skill assets. Install @quicktvui/ai-skills or use repository local layout.",
     );
   }
 
-  return localFallback;
+  candidates.sort((left, right) => {
+    const versionOrder = compareVersionStrings(right.version, left.version);
+    if (versionOrder !== 0) return versionOrder;
+    return left.sourceDir.localeCompare(right.sourceDir);
+  });
+
+  return candidates[0].sourceDir;
 }
 
 function getInstallDir(args) {
@@ -2295,7 +2398,7 @@ Commands:
   validate   Strict check for required skill files (non-zero exit if missing)
   update     Reinstall skill assets to target directory
   create-project  Create a QuickTVUI project (remote clone, local fallback)
-  setup-vue-env  Setup Vue development environment (Node/yarn/quicktvui cli)
+  setup-vue-env  Setup Vue development environment (Node/yarn)
   setup-android-env  Configure Android device/emulator + runtime environment
   setup-all-env  Setup both Vue and Android development environments
   run-dev    Run project dev command (optionally checks Android env first)
@@ -2319,14 +2422,12 @@ Options:
   --skip-node-install  Skip Node.js auto-install stage in setup-vue-env
   --force-node-install Force Node.js auto-install even if current version is ok
   --skip-yarn-install Skip yarn global install in setup-vue-env
-  --skip-quicktvui-cli-install Skip @quicktvui/cli global install in setup-vue-env
   --skip-project-install Skip project dependency install in setup-vue-env
   --auto-emulator <true|false>  Auto create/start emulator when no adb device
   --adb-path <path> Custom adb binary path/command (or set QUICKTVUI_ADB_PATH)
   --device-ip <ip[:port]> Preferred real device endpoint for adb connect
   --avd-name <name> Custom AVD name for setup-android-env
   --headless        Start emulator with -no-window -no-audio
-  --runtime-setup-mode <direct|qui> Runtime setup mode in setup-android-env (default: direct)
   --runtime-version <version> Pin runtime version when direct mode is used
   --runtime-url <url> Use custom runtime apk url in direct mode
   --server-host <ip> Override local debug server host IP
@@ -2771,7 +2872,7 @@ async function runCreateProject(args) {
     "- ensured: package.json name/version updated and @quicktvui/ai added to devDependencies",
   );
   console.log(
-    "- next: if not configured, run 'npm install -g @quicktvui/cli@latest' and 'qui setup'",
+    "- next: run 'quicktvui-ai setup-all-env --project <project-path>' to prepare development and runtime environments",
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicktvui/ai-cli",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "CLI for installing and validating QuickTVUI AI skills",
   "bin": {
     "quicktvui-ai": "bin/quicktvui-ai.js",
@@ -8,6 +8,9 @@
     "quicktvui-aicreate-project": "bin/quicktvui-aicreate-project.js"
   },
   "main": "lib/index.js",
+  "scripts": {
+    "postinstall": "node scripts/postinstall-sync.js"
+  },
   "files": [
     "bin",
     "lib",
@@ -25,6 +28,6 @@
   "author": "QuickTVUI",
   "license": "MIT",
   "dependencies": {
-    "@quicktvui/ai-skills": "^0.1.0"
+    "@quicktvui/ai-skills": "^1.1.1"
   }
 }

package/scripts/postinstall-sync.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+
+const { runCli } = require("../lib/index");
+
+function isTruthy(value) {
+  return value === true || value === "true" || value === "1";
+}
+
+function isGlobalInstall() {
+  if (isTruthy(process.env.npm_config_global)) return true;
+  return process.env.npm_config_location === "global";
+}
+
+async function main() {
+  if (isTruthy(process.env.QUICKTVUI_AI_SKIP_POSTINSTALL)) {
+    return;
+  }
+  if (!isGlobalInstall()) {
+    return;
+  }
+
+  try {
+    await runCli(["update"]);
+    console.log(
+      "[quicktvui-ai] postinstall: synced latest skill files into ~/.agents/skills/quicktvui.",
+    );
+  } catch (error) {
+    console.warn(
+      `[quicktvui-ai] postinstall: unable to auto-sync skill files (${error.message}). Run 'quicktvui-ai update' manually.`,
+    );
+  }
+}
+
+main();