@minhpnq1807/contextos 0.5.23 → 0.5.25

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.25
+
+- **Fix Windows JSON parse crash:** All `readJsonFile`/`readHooksFile` helpers now catch corrupt JSON and warn instead of crashing, allowing fresh config to be generated automatically.
+- **Fix Windows shell quoting:** `shellQuote` now uses double-quotes on Windows (`process.platform === "win32"`) instead of POSIX single-quotes which are not recognized by cmd.exe/PowerShell.
+- **Fix Codex CLI invocation on Windows:** `runCodex`/`tryRunCodex` now pass `shell: true` to `execFileSync` so Windows can resolve `codex.cmd` via PATH.
+
+## 0.5.24
+
+- **Interactive agent selection:** Replaces the comma-separated text input in `ctx setup` with an interactive multi-select prompt — use ↑/↓ to navigate, Space to toggle agents on/off, and Enter to confirm.
+
 ## 0.5.23
 
 - **Fix Windows install paths:** Replaces all `process.env.HOME || process.cwd()` fallbacks with `os.homedir()` across `ctx.js`, `claude-hooks.js`, `antigravity-hooks.js`, `claude-mcp.js`, `antigravity-mcp.js`, and `ruler-sync.js`. On Windows, `HOME` is not set, causing `.codex/`, `.claude/`, and `.gemini/` directories (with full `node_modules` and source code) to be created inside the project tree instead of the user's home directory.

package/bin/ctx.js

@@ -30,6 +30,7 @@ import { syncSkills } from "../plugins/ctx/lib/skillshare-sync.js";
 import { scanSkills, warmSkillEmbeddings } from "../plugins/ctx/lib/skill-discoverer.js";
 import { parsePassthroughArgs, runPassthrough } from "../plugins/ctx/lib/passthrough.js";
 import { parseAgentList, parseSetupArgs, setupSummaryLines } from "../plugins/ctx/lib/setup-wizard.js";
+import { multiSelect } from "../plugins/ctx/lib/multi-select.js";
 import { syncWorkflows, warmWorkflowEmbeddings } from "../plugins/ctx/lib/workflow-discoverer.js";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
@@ -331,7 +332,7 @@ async function warmInstallEmbeddings() {
 
 function tryRunCodex(args) {
   try {
-    execFileSync("codex", args, { stdio: "ignore" });
+    execFileSync("codex", args, { stdio: "ignore", shell: true });
   } catch {
     // Best effort cleanup for repeat installs.
   }
@@ -339,7 +340,7 @@ function tryRunCodex(args) {
 
 function runCodex(args) {
   try {
-    execFileSync("codex", args, { stdio: "inherit" });
+    execFileSync("codex", args, { stdio: "inherit", shell: true });
   } catch (error) {
     const status = typeof error.status === "number" ? error.status : 1;
     throw new Error(`codex ${args.join(" ")} failed with exit code ${status}. Make sure Codex CLI is installed and authenticated.`);
@@ -493,23 +494,40 @@ async function setup({ args = [], cwd = process.cwd() } = {}) {
 
   if (interactive) {
     const rl = readline.createInterface({ input, output });
-    try {
-      const proceed = await askSetupYesNo(rl, "Install to this directory?", true);
-      if (!proceed) {
-        console.log("Setup cancelled.");
-        return;
+    const proceed = await askSetupYesNo(rl, "Install to this directory?", true);
+    if (!proceed) {
+      rl.close();
+      console.log("Setup cancelled.");
+      return;
+    }
+    if (!options.agentsProvided) {
+      rl.close();
+      const selected = await multiSelect({
+        message: "Select agents to install:",
+        options: [
+          { label: "Codex",              value: "codex",  selected: options.agents.includes("codex") },
+          { label: "Claude",             value: "claude", selected: options.agents.includes("claude") },
+          { label: "Antigravity (agy)",  value: "agy",    selected: options.agents.includes("agy") }
+        ]
+      });
+      options.agents = selected;
+      const rl2 = readline.createInterface({ input, output });
+      try {
+        options.inject = await askSetupYesNo(rl2, "Enable prompt context injection?", options.inject);
+        options.syncRules = await askSetupYesNo(rl2, "Sync project rules and MCP servers through Ruler?", options.syncRules);
+        options.syncSkills = await askSetupYesNo(rl2, "Sync skills through skillshare?", options.syncSkills);
+      } finally {
+        rl2.close();
       }
-      if (!options.agentsProvided) {
-        const agents = await askSetupQuestion(rl, "Install for agents? comma-separated", options.agents.join(","));
-        options.agents = parseAgentList(agents);
-      } else {
+    } else {
+      try {
         console.log(`◇ Install for agents:\n│  ${options.agents.join(", ")}`);
+        options.inject = await askSetupYesNo(rl, "Enable prompt context injection?", options.inject);
+        options.syncRules = await askSetupYesNo(rl, "Sync project rules and MCP servers through Ruler?", options.syncRules);
+        options.syncSkills = await askSetupYesNo(rl, "Sync skills through skillshare?", options.syncSkills);
+      } finally {
+        rl.close();
       }
-      options.inject = await askSetupYesNo(rl, "Enable prompt context injection?", options.inject);
-      options.syncRules = await askSetupYesNo(rl, "Sync project rules and MCP servers through Ruler?", options.syncRules);
-      options.syncSkills = await askSetupYesNo(rl, "Sync skills through skillshare?", options.syncSkills);
-    } finally {
-      rl.close();
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minhpnq1807/contextos",
-  "version": "0.5.23",
+  "version": "0.5.25",
   "description": "Task-aware AGENTS.md context injection and compliance reporting for Codex, Claude Code, and Antigravity.",
   "type": "module",
   "bin": {

package/plugins/ctx/lib/antigravity-hooks.js

@@ -3,14 +3,23 @@ import os from "node:os";
 import path from "node:path";
 
 function shellQuote(value) {
-  return `'${String(value).replaceAll("'", "'\\''")}'`;
+  const s = String(value);
+  if (process.platform === "win32") {
+    return `"${s.replaceAll('"', '\\"')}"`;
+  }
+  return `'${s.replaceAll("'", "'\\''")}'`;
 }
 
 function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 function commandFor(installRoot, scriptName, { injectPromptContext = true } = {}) {

package/plugins/ctx/lib/antigravity-mcp.js

@@ -6,7 +6,12 @@ function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 export function antigravityMcpConfigPaths() {

package/plugins/ctx/lib/claude-hooks.js

@@ -8,7 +8,12 @@ function readJsonFile(filePath, fallback) {
   if (!fs.existsSync(filePath)) return fallback;
   const raw = fs.readFileSync(filePath, "utf8").trim();
   if (!raw) return fallback;
-  return JSON.parse(raw);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${filePath}, overwriting with defaults`);
+    return fallback;
+  }
 }
 
 export function claudeHome() {

package/plugins/ctx/lib/global-hooks.js

@@ -6,16 +6,25 @@ const QUIET_CODE_REVIEW_GRAPH_STATUS_COMMAND =
   "git rev-parse --git-dir >/dev/null 2>&1 && code-review-graph status >/dev/null 2>&1 || true";
 
 function shellQuote(value) {
-  return `'${String(value).replaceAll("'", "'\\''")}'`;
+  const s = String(value);
+  if (process.platform === "win32") {
+    return `"${s.replaceAll('"', '\\"')}"`;
+  }
+  return `'${s.replaceAll("'", "'\\''")}'`;
 }
 
 function readHooksFile(hooksPath) {
   if (!fs.existsSync(hooksPath)) return { hooks: {} };
   const raw = fs.readFileSync(hooksPath, "utf8").trim();
   if (!raw) return { hooks: {} };
-  const parsed = JSON.parse(raw);
-  if (!parsed.hooks || typeof parsed.hooks !== "object") parsed.hooks = {};
-  return parsed;
+  try {
+    const parsed = JSON.parse(raw);
+    if (!parsed.hooks || typeof parsed.hooks !== "object") parsed.hooks = {};
+    return parsed;
+  } catch {
+    console.warn(`[ctx] warning: corrupt JSON in ${hooksPath}, overwriting with defaults`);
+    return { hooks: {} };
+  }
 }
 
 function isContextOSHookEntry(entry) {

package/plugins/ctx/lib/multi-select.js

@@ -0,0 +1,142 @@
+/**
+ * Interactive multi-select prompt using raw stdin.
+ *
+ * Usage:
+ *   const selected = await multiSelect({
+ *     message: "Select agents:",
+ *     options: [
+ *       { label: "Codex",   value: "codex", selected: true },
+ *       { label: "Claude",  value: "claude", selected: true },
+ *       { label: "Antigravity (agy)", value: "agy", selected: true }
+ *     ]
+ *   });
+ */
+
+const KEYS = {
+  UP: ["\x1B[A", "\x1Bk"],       // Arrow Up, Alt+k
+  DOWN: ["\x1B[B", "\x1Bj"],     // Arrow Down, Alt+j
+  SPACE: [" "],
+  ENTER: ["\r", "\n"],
+  CTRL_C: ["\x03"],
+  // j/k vim-style (single char)
+  J: ["j"],
+  K: ["k"]
+};
+
+const DIM = "\x1B[2m";
+const RESET = "\x1B[0m";
+const CYAN = "\x1B[36m";
+const GREEN = "\x1B[32m";
+const BOLD = "\x1B[1m";
+const HIDE_CURSOR = "\x1B[?25l";
+const SHOW_CURSOR = "\x1B[?25h";
+
+function matchKey(data, keySet) {
+  return keySet.some((k) => data === k);
+}
+
+/**
+ * @param {{ message: string, options: Array<{label: string, value: string, selected?: boolean}> }} config
+ * @returns {Promise<string[]>} selected values
+ */
+export function multiSelect({ message, options }) {
+  return new Promise((resolve, reject) => {
+    if (!process.stdin.isTTY) {
+      // Non-interactive: return all pre-selected
+      resolve(options.filter((o) => o.selected).map((o) => o.value));
+      return;
+    }
+
+    let cursor = 0;
+    const selections = options.map((o) => o.selected !== false);
+
+    function render() {
+      // Move cursor up to overwrite previous render (except first time)
+      const lines = [];
+      lines.push(`${CYAN}◇${RESET} ${message}`);
+      lines.push(`${DIM}  Use ↑/↓ to navigate, Space to toggle, Enter to confirm${RESET}`);
+      for (let i = 0; i < options.length; i++) {
+        const isCursor = i === cursor;
+        const isSelected = selections[i];
+        const checkbox = isSelected ? `${GREEN}◉${RESET}` : `${DIM}○${RESET}`;
+        const label = isCursor ? `${BOLD}${CYAN}${options[i].label}${RESET}` : options[i].label;
+        const pointer = isCursor ? `${CYAN}❯${RESET}` : " ";
+        lines.push(`  ${pointer} ${checkbox} ${label}`);
+      }
+      return lines;
+    }
+
+    let prevLineCount = 0;
+
+    function draw() {
+      const lines = render();
+      // Clear previous output
+      if (prevLineCount > 0) {
+        process.stdout.write(`\x1B[${prevLineCount}A`); // move up
+        for (let i = 0; i < prevLineCount; i++) {
+          process.stdout.write("\x1B[2K");  // clear line
+          if (i < prevLineCount - 1) process.stdout.write("\x1B[1B"); // move down
+        }
+        process.stdout.write(`\x1B[${prevLineCount - 1}A`); // back to top
+      }
+      process.stdout.write(lines.join("\n") + "\n");
+      prevLineCount = lines.length;
+    }
+
+    process.stdout.write(HIDE_CURSOR);
+
+    const wasRaw = process.stdin.isRaw;
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.setEncoding("utf8");
+
+    function cleanup() {
+      process.stdin.setRawMode(wasRaw || false);
+      process.stdin.pause();
+      process.stdin.removeListener("data", onData);
+      process.stdout.write(SHOW_CURSOR);
+    }
+
+    function onData(data) {
+      if (matchKey(data, KEYS.CTRL_C)) {
+        cleanup();
+        process.exit(0);
+      }
+
+      if (matchKey(data, KEYS.UP) || matchKey(data, KEYS.K)) {
+        cursor = (cursor - 1 + options.length) % options.length;
+        draw();
+      } else if (matchKey(data, KEYS.DOWN) || matchKey(data, KEYS.J)) {
+        cursor = (cursor + 1) % options.length;
+        draw();
+      } else if (matchKey(data, KEYS.SPACE)) {
+        selections[cursor] = !selections[cursor];
+        draw();
+      } else if (matchKey(data, KEYS.ENTER)) {
+        cleanup();
+        const selected = options
+          .filter((_, i) => selections[i])
+          .map((o) => o.value);
+        // Print final summary
+        const summary = selected.length > 0
+          ? selected.join(", ")
+          : "(none)";
+        // Overwrite prompt area with final state
+        if (prevLineCount > 0) {
+          process.stdout.write(`\x1B[${prevLineCount}A`);
+          for (let i = 0; i < prevLineCount; i++) {
+            process.stdout.write("\x1B[2K");
+            if (i < prevLineCount - 1) process.stdout.write("\x1B[1B");
+          }
+          process.stdout.write(`\x1B[${prevLineCount - 1}A`);
+        }
+        process.stdout.write(`${CYAN}◇${RESET} ${message}\n`);
+        process.stdout.write(`${DIM}│${RESET}  ${GREEN}${summary}${RESET}\n`);
+        resolve(selected);
+      }
+    }
+
+    process.stdin.on("data", onData);
+    draw();
+  });
+}