open-research 0.1.0 → 0.1.1

package/README.md

@@ -4,11 +4,37 @@ Local-first research CLI agent. Discover papers, synthesize notes, run analysis,
 
 ## Install
 
+Requires Node.js 20+.
+
+**curl**
+```bash
+curl -fsSL https://raw.githubusercontent.com/gangj277/open-research/main/install.sh | bash
+```
+
+**npm**
 ```bash
 npm install -g open-research
 ```
 
-Requires Node.js 20+.
+**bun**
+```bash
+bun install -g open-research
+```
+
+**pnpm**
+```bash
+pnpm add -g open-research
+```
+
+**yarn**
+```bash
+yarn global add open-research
+```
+
+**npx** (no install, runs latest)
+```bash
+npx open-research
+```
 
 ## Quick Start
 

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import React4 from "react";
-import path16 from "path";
+import path17 from "path";
 import { Command } from "commander";
 import { render } from "ink";
 
@@ -848,7 +848,7 @@ async function ensureOpenResearchConfig(options) {
 }
 
 // src/tui/app.tsx
-import path15 from "path";
+import path16 from "path";
 import {
   startTransition,
   useDeferredValue,
@@ -5033,6 +5033,81 @@ function ConfigScreen({ items, onUpdate, onClose }) {
   ] });
 }
 
+// src/lib/cli/update-check.ts
+import fs16 from "fs/promises";
+import path15 from "path";
+import os4 from "os";
+var PACKAGE_NAME = "open-research";
+var CHECK_INTERVAL_MS = 4 * 60 * 60 * 1e3;
+var STATE_FILE = path15.join(os4.homedir(), ".open-research", "update-check.json");
+async function readState() {
+  try {
+    const raw = await fs16.readFile(STATE_FILE, "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return { lastCheck: 0, latestVersion: null };
+  }
+}
+async function writeState(state) {
+  await fs16.mkdir(path15.dirname(STATE_FILE), { recursive: true });
+  await fs16.writeFile(STATE_FILE, JSON.stringify(state), "utf8");
+}
+function getCurrentVersion() {
+  try {
+    const pkgPath = new URL("../../../package.json", import.meta.url);
+    return process.env.npm_package_version ?? "0.0.0";
+  } catch {
+    return "0.0.0";
+  }
+}
+async function fetchLatestVersion() {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), 5e3);
+    const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewer(latest, current) {
+  const l = latest.split(".").map(Number);
+  const c = current.split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((l[i] ?? 0) > (c[i] ?? 0)) return true;
+    if ((l[i] ?? 0) < (c[i] ?? 0)) return false;
+  }
+  return false;
+}
+async function checkForUpdate() {
+  try {
+    const state = await readState();
+    const now = Date.now();
+    if (now - state.lastCheck < CHECK_INTERVAL_MS && state.latestVersion) {
+      const current2 = getCurrentVersion();
+      if (isNewer(state.latestVersion, current2)) {
+        return `Update available: ${current2} \u2192 ${state.latestVersion}. Run: npm update -g open-research`;
+      }
+      return null;
+    }
+    const latest = await fetchLatestVersion();
+    await writeState({ lastCheck: now, latestVersion: latest });
+    if (!latest) return null;
+    const current = getCurrentVersion();
+    if (isNewer(latest, current)) {
+      return `Update available: ${current} \u2192 ${latest}. Run: npm update -g open-research`;
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}
+
 // src/tui/commands.ts
 var SLASH_COMMANDS = [
   { name: "auth", aliases: ["/connect", "/login"], description: "Connect your OpenAI account via browser OAuth", category: "auth" },
@@ -5605,6 +5680,9 @@ function App({
       setTheme(cfg.theme);
       const auth2 = await loadStoredAuth({ homeDir });
       setAuthStatus(auth2 ? "connected" : "missing");
+      checkForUpdate().then((msg) => {
+        if (msg) addSystemMessage(msg);
+      });
     })();
   }, [homeDir]);
   useEffect2(() => {
@@ -6510,7 +6588,7 @@ function App({
         statusParts,
         statusColor,
         tokenDisplay,
-        workspaceName: hasWorkspace ? path15.basename(workspacePath) : process.cwd(),
+        workspaceName: hasWorkspace ? path16.basename(workspacePath) : process.cwd(),
         mode: agentMode,
         planningStatus: planningState.status
       }
@@ -6522,7 +6600,7 @@ function App({
 var program = new Command();
 program.name("open-research").description("Local-first research CLI powered by ChatGPT/Codex auth.").argument("[workspacePath]", "Optional workspace path to open").action(async (workspacePath) => {
   await ensureOpenResearchConfig();
-  const target = workspacePath ? path16.resolve(workspacePath) : process.cwd();
+  const target = workspacePath ? path17.resolve(workspacePath) : process.cwd();
   const project = await loadWorkspaceProject(target);
   const auth2 = await loadStoredAuth();
   render(
@@ -6544,7 +6622,7 @@ program.name("open-research").description("Local-first research CLI powered by C
 });
 program.command("init").argument("[workspacePath]").description("Initialize an Open Research workspace.").action(async (workspacePath) => {
   await ensureOpenResearchConfig();
-  const target = path16.resolve(workspacePath ?? process.cwd());
+  const target = path17.resolve(workspacePath ?? process.cwd());
   const project = await initWorkspace({ workspaceDir: target });
   console.log(`Initialized workspace: ${target}`);
   console.log(`Title: ${project.title}`);
@@ -6613,8 +6691,8 @@ skills.command("create").argument("[name]").description("Scaffold a new user ski
 });
 skills.command("edit").argument("<name>").description("Open a user skill in $EDITOR.").action(async (name) => {
   await ensureOpenResearchConfig();
-  const skillDir = path16.join(getOpenResearchSkillsDir(), name);
-  openInEditor(path16.join(skillDir, "SKILL.md"));
+  const skillDir = path17.join(getOpenResearchSkillsDir(), name);
+  openInEditor(path17.join(skillDir, "SKILL.md"));
   const validation = await validateSkillDirectory({ skillDir });
   if (!validation.ok) {
     console.error(validation.errors.join("\n"));
@@ -6625,9 +6703,9 @@ skills.command("edit").argument("<name>").description("Open a user skill in $EDI
 });
 skills.command("validate").argument("[nameOrPath]").description("Validate one user skill.").action(async (nameOrPath) => {
   await ensureOpenResearchConfig();
-  const skillDir = nameOrPath ? path16.isAbsolute(nameOrPath) ? nameOrPath : path16.join(getOpenResearchSkillsDir(), nameOrPath) : getOpenResearchSkillsDir();
+  const skillDir = nameOrPath ? path17.isAbsolute(nameOrPath) ? nameOrPath : path17.join(getOpenResearchSkillsDir(), nameOrPath) : getOpenResearchSkillsDir();
   const stat = await import("fs/promises").then(
-    (fs16) => fs16.stat(skillDir).catch(() => null)
+    (fs17) => fs17.stat(skillDir).catch(() => null)
   );
   if (!stat) {
     throw new Error(`Skill path not found: ${skillDir}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "open-research",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Local-first research CLI agent — discover papers, synthesize notes, run analysis, and draft artifacts from your terminal.",
   "type": "module",
   "license": "MIT",