@quicktvui/ai-cli 1.1.3 → 1.1.6

package/README.md

@@ -73,7 +73,7 @@ quicktvui-aicreate-project quick-tv-app
 - `--port <n>`: dev server port used by `run-dev` auto load (default `38989`)
 - `--skip-env-check`: skip environment stage in `run-dev`
 - `--runtime-package <pkg>`: runtime package for `run-esapp` (default `com.extscreen.runtime`)
-- `--esapp-uri <uri>`: raw launch URI (`esapp://`, `quicktv://`, `appcast://`)
+- `--esapp-uri <uri>`: raw launch URI (`esapp://`)
 - `--esapp-query <json>`: extra query params JSON merged in structured mode
 - `--pkg --ver --min-ver --repository --uri --from --args --exp --flags --use-latest`: structured `esapp://action/start` params
 

package/docs/esapp-protocol.md

@@ -1,4 +1,4 @@
-# ESApp Protocol Reference (`esapp://`, `quicktv://`, `appcast://`)
+# ESApp Protocol Reference (`esapp://`)
 
 This document summarizes runtime launch protocol behavior from:
 
@@ -12,8 +12,6 @@ This document summarizes runtime launch protocol behavior from:
 Runtime entry activity accepts:
 
 - `esapp://`
-- `quicktv://`
-- `appcast://`
 
 ## 2) Parsing Modes
 
@@ -29,13 +27,11 @@ Behavior:
 - `/start` maps to `action=start_es`.
 - All query params are forwarded to protocol JSON.
 
-### Mode B: V2 package URI (esapp/quicktv/appcast)
+### Mode B: V2 package URI (esapp)
 
 ```text
 esapp://es.hello.world?from=cmd
 esapp://es.hello.world/1.0.3?from=cmd
-quicktv://es.hello.world?from=cmd
-appcast://es.hello.world/1.0.3?from=cmd
 ```
 
 Behavior:

package/lib/index.js

@@ -1714,18 +1714,18 @@ function ensureSupportedEsappUri(uri) {
   const normalized = String(uri || "")
     .trim()
     .toLowerCase();
-  if (
-    normalized.startsWith("esapp://") ||
-    normalized.startsWith("quicktv://") ||
-    normalized.startsWith("appcast://")
-  ) {
+  if (normalized.startsWith("esapp://")) {
     return;
   }
   throw new Error(
-    `Unsupported URI scheme for runtime launch: ${uri}. Use esapp://, quicktv://, or appcast://.`,
+    `Unsupported URI scheme for runtime launch: ${uri}. Use esapp:// only.`,
   );
 }
 
+function quotePosixShellArg(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
 function buildEsappLaunchUri(args, projectRoot, defaults = {}) {
   const positional =
     args._ && typeof args._[1] === "string" ? args._[1].trim() : "";
@@ -1807,18 +1807,19 @@ function buildEsappLaunchUri(args, projectRoot, defaults = {}) {
 
 function startEsappOnRuntimeByUri(adbPath, serial, runtimePackage, launchUri) {
   ensureSupportedEsappUri(launchUri);
+  // Use explicit POSIX shell quoting so `&` in URI query is not truncated by
+  // remote Android shell parsing (e.g. `...from=cmd&pkg=...`).
+  const shellCommand = [
+    "am start",
+    "-a android.intent.action.VIEW",
+    `-p ${quotePosixShellArg(runtimePackage)}`,
+    `-d ${quotePosixShellArg(launchUri)}`,
+  ].join(" ");
   const result = runCommandCapture(adbPath, [
     "-s",
     serial,
     "shell",
-    "am",
-    "start",
-    "-a",
-    "android.intent.action.VIEW",
-    "-p",
-    runtimePackage,
-    "-d",
-    launchUri,
+    shellCommand,
   ]);
   const output = `${result.stdout || ""}\n${result.stderr || ""}`.trim();
   if (/(^|\s)error[:\s]/i.test(output) || /exception/i.test(output)) {
@@ -2625,7 +2626,7 @@ Options:
   --port <n>        Dev server port used by run-dev auto load (default: 38989)
   --skip-env-check  Skip setup-android-env stage in run-dev
   --runtime-package <pkg> Runtime package name for run-esapp (default: com.extscreen.runtime)
-  --esapp-uri <uri> Raw esapp:// / quicktv:// / appcast:// URI for run-esapp
+  --esapp-uri <uri> Raw esapp:// URI for run-esapp
   --esapp-query <json> Extra query params JSON merged into action/start URI
   --pkg <pkg>       ES app package for run-esapp structured mode
   --ver <version>   ES app version for run-esapp structured mode

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quicktvui/ai-cli",
-  "version": "1.1.3",
+  "version": "1.1.6",
   "description": "CLI for installing and validating QuickTVUI AI skills",
   "bin": {
     "quicktvui-ai": "bin/quicktvui-ai.js",

package/scripts/postinstall-sync.js

@@ -1,16 +1,43 @@
 #!/usr/bin/env node
 
 const { runCli } = require("../lib/index");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
 
 function isTruthy(value) {
   return value === true || value === "true" || value === "1";
 }
 
+function exists(filePath) {
+  return fs.existsSync(filePath);
+}
+
 function isGlobalInstall() {
   if (isTruthy(process.env.npm_config_global)) return true;
   return process.env.npm_config_location === "global";
 }
 
+function resolveCodexHome() {
+  const fromEnv = process.env.CODEX_HOME
+    ? String(process.env.CODEX_HOME).trim()
+    : "";
+  if (fromEnv) {
+    return path.resolve(fromEnv);
+  }
+  return path.join(os.homedir(), ".codex");
+}
+
+function shouldSyncCodex() {
+  const fromEnv = process.env.CODEX_HOME
+    ? String(process.env.CODEX_HOME).trim()
+    : "";
+  if (fromEnv) {
+    return true;
+  }
+  return exists(path.join(os.homedir(), ".codex"));
+}
+
 async function main() {
   if (isTruthy(process.env.QUICKTVUI_AI_SKIP_POSTINSTALL)) {
     return;
@@ -19,16 +46,51 @@ async function main() {
     return;
   }
 
+  const syncCodex = shouldSyncCodex();
+  const codexSkillsDir = path.join(resolveCodexHome(), "skills", "quicktvui");
+  const failures = [];
+
   try {
-    await runCli(["update"]);
+    if (syncCodex) {
+      await runCli(["update", "--skip-gemini-config"]);
+    } else {
+      await runCli(["update"]);
+    }
+  } catch (error) {
+    failures.push(`agents: ${error.message}`);
+  }
+
+  if (syncCodex) {
+    try {
+      await runCli(["update", "--dir", codexSkillsDir]);
+    } catch (error) {
+      failures.push(`codex: ${error.message}`);
+    }
+  }
+
+  if (failures.length === 0) {
+    if (syncCodex) {
+      console.log(
+        `[quicktvui-ai] postinstall: synced latest skill files into ~/.agents/skills/quicktvui and ${codexSkillsDir}.`,
+      );
+      return;
+    }
     console.log(
       "[quicktvui-ai] postinstall: synced latest skill files into ~/.agents/skills/quicktvui.",
     );
-  } catch (error) {
+    return;
+  }
+
+  if (syncCodex) {
     console.warn(
-      `[quicktvui-ai] postinstall: unable to auto-sync skill files (${error.message}). Run 'quicktvui-ai update' manually.`,
+      `[quicktvui-ai] postinstall: unable to fully auto-sync skill files (${failures.join("; ")}). Run 'quicktvui-ai update' and 'quicktvui-ai update --dir ${codexSkillsDir}' manually.`,
     );
+    return;
   }
+
+  console.warn(
+    `[quicktvui-ai] postinstall: unable to auto-sync skill files (${failures.join("; ")}). Run 'quicktvui-ai update' manually.`,
+  );
 }
 
 main();