job-apply-plugin 0.3.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "job-apply",
       "source": "./plugin",
       "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
-      "version": "0.3.0",
+      "version": "0.5.0",
       "category": "productivity"
     }
   ]

package/README.md

@@ -74,6 +74,32 @@ npm install -g job-apply-plugin && job-apply-plugin install
 The installer never overwrites a folder it didn't create unless you pass `--force`.
 When you add Job Apply to an existing `marketplace.json`, the other entries in that file are kept.
 
+## Updating
+
+```bash
+npx job-apply-plugin@latest update
+```
+
+This updates Job Apply to the newest version in every app where it's installed, without the
+menu. `npx job-apply-plugin status` tells you when a newer version is out.
+
+To switch to a specific version, including going back to an older one:
+
+```bash
+npx job-apply-plugin@latest update 0.3.0
+```
+
+List the available versions with `npm view job-apply-plugin versions`. Updating never touches
+your résumé, profile or history. `--claude` or `--chatgpt` limits the update to one app.
+
+- **ChatGPT:** after updating, open **Plugins → Job Apply** and reinstall it, then restart the
+  app. ChatGPT keeps its own copy and doesn't pick up new files until you do.
+- **Claude Code:** start a new session to use the new version.
+
+> Keep `@latest` in the command. Without it, npx may run a copy it downloaded earlier.
+> Versions before 0.5.0 have no `update` command; for those, `npx job-apply-plugin@latest update`
+> still works, because it always runs the newest installer.
+
 ## Uninstall
 
 ```bash
@@ -84,14 +110,24 @@ It asks which app to remove Job Apply from, and shows where it's currently insta
 
 ```
 Remove Job Apply from which app?
-  1) Claude Code  (installed v0.3.0)
+  1) Claude Code  (installed v0.5.0)
   2) ChatGPT desktop / Codex  (not installed)
   3) Both
 Choose 1, 2 or 3 [1]:
 ```
 
 To skip the menu, use `--claude`, `--chatgpt` or `--all`. `remove` works as another name for `uninstall`.
-For ChatGPT, also click **Uninstall** on its Plugins page, then restart the app.
+
+What it removes:
+
+| App | Removed |
+| --- | --- |
+| Claude Code | The two skill folders in `~/.claude/skills`, plus a project install (`./.claude/skills`) in the folder you run it from |
+| ChatGPT / Codex | `~/.codex/plugins/job-apply`, its entry in `~/.agents/plugins/marketplace.json`, ChatGPT's own installed copy (`~/.codex/plugins/cache/…/job-apply`), and its settings in `~/.codex/config.toml` |
+
+Restart the app afterwards. It only deletes things that belong to this plugin; other plugins
+and skills are left alone. A project install in a different folder has to be removed from that
+folder (`cd` there and run `uninstall`).
 
 Uninstalling keeps your résumé, profile and application history in `~/Documents/Job Apply`.
 To erase those too, ask the assistant to "clear my Job Apply profile" before you uninstall,
@@ -103,8 +139,7 @@ or delete that folder.
 ## Other commands
 
 ```bash
-npx job-apply-plugin status      # where it's installed and whether Python is OK
-npx job-apply-plugin install     # run again to update
+npx job-apply-plugin status      # where it's installed, whether an update is out, and whether Python is OK
 ```
 
 ## Installing from the Git repository (alternative)

package/bin/job-apply.js

@@ -22,6 +22,15 @@ const DEFAULT_MARKETPLACE = "local-plugins";
 // ---------- helpers ----------
 
 const home = () => os.homedir();
+// True when two paths name the same folder, even through symlinks (e.g. /var vs /private/var on macOS).
+const real = (p) => {
+  try {
+    return fs.realpathSync(p);
+  } catch {
+    return path.resolve(p);
+  }
+};
+const samePath = (a, b) => real(a) === real(b);
 const exists = (p) => fs.existsSync(p);
 const log = (msg = "") => process.stdout.write(msg + "\n");
 
@@ -117,6 +126,17 @@ const claude = {
   detect: () => exists(path.join(home(), ".claude")) || onPath("claude"),
   skillsDir: (opts) =>
     opts.project ? path.join(process.cwd(), ".claude", "skills") : path.join(home(), ".claude", "skills"),
+  // Where uninstall/status look: --project → only this folder; otherwise the user folder plus this folder's project install.
+  skillDirs(opts) {
+    if (opts.project) return [this.skillsDir(opts)];
+    const user = this.skillsDir({});
+    const project = path.join(process.cwd(), ".claude", "skills");
+    return samePath(project, user) || samePath(process.cwd(), home()) ? [user] : [user, project];
+  },
+  installedIn(base) {
+    const markers = skillNames().map((n) => readMarker(path.join(base, n)));
+    return markers.every(Boolean) ? markers[0].version : markers.some(Boolean) ? "partial" : null;
+  },
 
   install(opts) {
     const base = this.skillsDir(opts);
@@ -131,17 +151,25 @@ const claude = {
   },
 
   uninstall(opts) {
-    const base = this.skillsDir(opts);
-    const removed = skillNames().filter((name) => removeOwnedDir(path.join(base, name)));
-    log(removed.length ? `✔ Claude Code: removed ${removed.join(", ")} from ${base}` : `• Claude Code: nothing to remove in ${base}`);
+    let any = false;
+    for (const base of this.skillDirs(opts)) {
+      const removed = skillNames().filter((name) => removeOwnedDir(path.join(base, name)));
+      if (removed.length) {
+        any = true;
+        log(`✔ Claude Code: removed ${removed.join(", ")} from ${base}`);
+      }
+    }
+    if (any) log(`  Restart any open Claude Code sessions so they stop offering the skills.`);
+    else log(`• Claude Code: nothing to remove`);
   },
 
   status(opts) {
-    const base = this.skillsDir(opts);
-    const markers = skillNames().map((n) => readMarker(path.join(base, n)));
-    if (markers.every(Boolean)) return `installed v${markers[0].version} (${base})`;
-    if (markers.some(Boolean)) return `partially installed (${base}) — run install again`;
-    return "not installed";
+    const found = this.skillDirs(opts)
+      .map((base) => [base, this.installedIn(base)])
+      .filter(([, v]) => v);
+    if (found.length === 0) return "not installed";
+    if (found.some(([, v]) => v === "partial")) return `partially installed (${found.map(([b]) => b).join(", ")}) — run install again`;
+    return `installed v${found[0][1]} (${found.map(([b]) => b).join(", ")})`;
   },
 };
 
@@ -184,12 +212,68 @@ const chatgpt = {
     if (i >= 0) log(`  (Updating? Reinstall it from the Plugins page so ChatGPT refreshes its cached copy.)`);
   },
 
+  cacheRoot: () => path.join(home(), ".codex", "plugins", "cache"),
+  configFile: () => path.join(home(), ".codex", "config.toml"),
+
+  // ChatGPT keeps its own installed copy at cache/<marketplace>/<plugin>/<version>/.
+  // Only folders whose manifest is this plugin (same name and author) count as ours.
+  cachedCopies() {
+    const root = this.cacheRoot();
+    if (!exists(root)) return [];
+    const ours = (manifest) => {
+      try {
+        const m = JSON.parse(fs.readFileSync(manifest, "utf8"));
+        return m.name === PLUGIN_NAME && m.author?.name === PLUGIN.author?.name;
+      } catch {
+        return false;
+      }
+    };
+    const copies = [];
+    for (const market of fs.readdirSync(root, { withFileTypes: true })) {
+      if (!market.isDirectory()) continue;
+      const dir = path.join(root, market.name, PLUGIN_NAME);
+      if (!exists(dir)) continue;
+      const versions = fs.readdirSync(dir, { withFileTypes: true }).filter((d) => d.isDirectory());
+      const matches = versions.some((v) =>
+        ["plugin.json", path.join(".codex-plugin", "plugin.json")].some((m) => ours(path.join(dir, v.name, m)))
+      );
+      if (matches) copies.push({ market: market.name, dir });
+    }
+    return copies;
+  },
+
+  // Drops the [plugins."job-apply@<market>"] tables ChatGPT writes when the plugin is installed or toggled.
+  removeConfigEntries(markets) {
+    const file = this.configFile();
+    if (!exists(file) || markets.length === 0) return 0;
+    const headers = new Set(markets.map((m) => `[plugins."${PLUGIN_NAME}@${m}"]`));
+    const out = [];
+    let skipping = false;
+    let removed = 0;
+    for (const line of fs.readFileSync(file, "utf8").split(/(?<=\n)/)) {
+      const trimmed = line.trim();
+      if (trimmed.startsWith("[")) {
+        skipping = headers.has(trimmed.replace(/\s*#.*$/, ""));
+        if (skipping) removed++;
+      }
+      if (!skipping) out.push(line);
+    }
+    if (removed) {
+      const tmp = `${file}.${process.pid}.tmp`;
+      fs.writeFileSync(tmp, out.join(""));
+      fs.renameSync(tmp, file);
+    }
+    return removed;
+  },
+
   uninstall() {
     const removedDir = removeOwnedDir(this.pluginDir());
     const file = this.marketplaceFile();
     let removedEntry = false;
+    const markets = new Set([DEFAULT_MARKETPLACE]);
     if (exists(file)) {
       const market = readJson(file);
+      if (typeof market.name === "string") markets.add(market.name);
       const before = market.plugins?.length ?? 0;
       market.plugins = (market.plugins ?? []).filter((p) => p?.name !== PLUGIN_NAME);
       removedEntry = market.plugins.length !== before;
@@ -198,8 +282,20 @@ const chatgpt = {
         else writeJson(file, market);
       }
     }
-    if (removedDir || removedEntry) {
-      log(`✔ ChatGPT/Codex: removed ${PLUGIN_NAME}. Uninstall it from the ChatGPT Plugins page too, then restart the app.`);
+    const copies = this.cachedCopies();
+    for (const c of copies) {
+      fs.rmSync(c.dir, { recursive: true, force: true });
+      markets.add(c.market);
+    }
+    const settings = this.removeConfigEntries([...markets]);
+
+    if (removedDir || removedEntry || copies.length || settings) {
+      log(`✔ ChatGPT/Codex: removed ${PLUGIN_NAME}:`);
+      if (removedDir) log(`  - plugin files in ${this.pluginDir()}`);
+      if (removedEntry) log(`  - its entry in ${file}`);
+      for (const c of copies) log(`  - ChatGPT's installed copy in ${c.dir}`);
+      if (settings) log(`  - its settings in ${this.configFile()}`);
+      log(`  Restart the ChatGPT desktop app to finish.`);
     } else {
       log(`• ChatGPT/Codex: nothing to remove`);
     }
@@ -214,12 +310,119 @@ const chatgpt = {
     } catch {}
     if (marker && listed) return `installed v${marker.version} (${this.pluginDir()})`;
     if (marker || listed) return "partially installed — run install again";
+    if (this.cachedCopies().length) return "leftover files from an earlier install — run uninstall to clean up";
     return "not installed";
   },
 };
 
 const TARGETS = { claude, chatgpt };
 
+// ---------- versions & updates ----------
+
+// Compares x.y.z versions numerically; prerelease tags are ignored. Returns <0, 0 or >0.
+export function compareVersions(a, b) {
+  const pa = String(a).split("-")[0].split(".").map(Number);
+  const pb = String(b).split("-")[0].split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const d = (pa[i] || 0) - (pb[i] || 0);
+    if (d) return d;
+  }
+  return 0;
+}
+
+const FIRST_RELEASE = "0.1.0";
+const registryUrl = (spec) =>
+  `${(process.env.npm_config_registry || "https://registry.npmjs.org/").replace(/\/?$/, "/")}${PKG.name}${spec ? `/${spec}` : ""}`;
+
+async function registryGet(spec) {
+  const res = await fetch(registryUrl(spec), { signal: AbortSignal.timeout(8000), headers: { accept: "application/json" } });
+  if (res.status === 404) return null;
+  if (!res.ok) throw new Error(`npm registry answered ${res.status}`);
+  return res.json();
+}
+
+async function latestVersion() {
+  return (await registryGet("latest"))?.version ?? null;
+}
+
+async function releasedVersions() {
+  const doc = await registryGet("");
+  return Object.keys(doc?.versions ?? {})
+    .filter((v) => /^\d+\.\d+\.\d+$/.test(v) && compareVersions(v, FIRST_RELEASE) >= 0)
+    .sort(compareVersions);
+}
+
+// Where the plugin is installed now, as install jobs that any released version understands.
+function installedJobs(values, opts) {
+  const flagged = flagTargets(values);
+  const want = (t) => flagged.length === 0 || flagged.includes(t);
+  const jobs = [];
+  if (want(claude)) {
+    const userDir = claude.skillsDir({});
+    for (const base of claude.skillDirs(opts)) {
+      const v = claude.installedIn(base);
+      if (!v) continue;
+      const project = !samePath(base, userDir);
+      jobs.push({ target: claude, project, version: v, where: base });
+    }
+  }
+  if (want(chatgpt)) {
+    const v = readMarker(chatgpt.pluginDir())?.version;
+    if (v || chatgpt.status().startsWith("partially")) jobs.push({ target: chatgpt, project: false, version: v ?? "partial", where: chatgpt.pluginDir() });
+  }
+  return jobs;
+}
+
+function runOtherVersion(version, job) {
+  const args = ["-y", `${PKG.name}@${version}`, "install", job.target === claude ? "--claude" : "--chatgpt"];
+  if (job.project) args.push("--project");
+  const npx = process.env.JOB_APPLY_NPX || (process.platform === "win32" ? "npx.cmd" : "npx");
+  const r = spawnSync(npx, args, { stdio: "inherit", shell: process.platform === "win32" });
+  if (r.status !== 0) {
+    throw new CliError(`Installing ${PKG.name}@${version} failed. Try it directly:\n  npx ${args.slice(1).join(" ")}`);
+  }
+}
+
+async function update(values, opts, requested) {
+  const jobs = installedJobs(values, opts);
+  if (jobs.length === 0) {
+    log(`Job Apply isn't installed${flagTargets(values).length ? " there" : ""}. Run "npx ${PKG.name}@latest install" first.`);
+    return;
+  }
+
+  let target = requested;
+  if (target) {
+    if (!/^\d+\.\d+\.\d+$/.test(target)) throw new CliError(`"${target}" isn't a version number. Use something like 0.3.0.`);
+    const versions = await releasedVersions().catch(() => null);
+    if (versions && !versions.includes(target)) {
+      throw new CliError(`Version ${target} doesn't exist. Available: ${versions.join(", ")}`);
+    }
+  } else {
+    try {
+      target = await latestVersion();
+    } catch (err) {
+      throw new CliError(`Couldn't reach npm to find the latest version (${err.message}). Check your connection and try again.`);
+    }
+    if (!target) throw new CliError(`Couldn't find ${PKG.name} on npm.`);
+  }
+
+  const current = [...new Set(jobs.map((j) => j.version))].join(", ");
+  const direction = jobs.every((j) => j.version === target)
+    ? "Reinstalling"
+    : compareVersions(target, jobs[0].version === "partial" ? "0.0.0" : jobs[0].version) < 0
+      ? "Switching back to"
+      : "Updating to";
+  log(`${direction} v${target} (installed: v${current}) in ${jobs.map((j) => j.target.label + (j.project ? " (this project)" : "")).join(" and ")}.`);
+  log();
+
+  for (const job of jobs) {
+    if (target === PKG.version) job.target.install({ ...opts, project: job.project });
+    else runOtherVersion(target, job);
+  }
+  log();
+  log(`Done. Your résumé, profile and history in ~/Documents/Job Apply are unchanged.`);
+}
+
 // ---------- CLI ----------
 
 const HELP = `${PKG.name} v${PKG.version}
@@ -231,10 +434,12 @@ Usage
   yarn dlx ${PKG.name} <command> [options]
 
 Commands
-  install      Install (or update) the plugin
+  install      Install the plugin (asks Claude Code, ChatGPT or both)
+  update       Update wherever it's installed to the latest version
+  update <v>   Switch to a specific version, e.g. "update 0.3.0" (also goes back to older ones)
   uninstall    Remove the plugin from Claude Code, ChatGPT or both (alias: remove).
                Your profile and history in ~/Documents/Job Apply are kept.
-  status       Show where the plugin is installed and check Python
+  status       Show where it's installed, whether an update is available, and check Python
 
 Options
   --claude     Claude Code only
@@ -385,10 +590,21 @@ export async function main(argv = process.argv.slice(2)) {
     log();
     log(`Your résumé, profile and history in ~/Documents/Job Apply were kept.`);
     log(`To erase them too, delete that folder or ask the assistant to "clear my Job Apply profile" before uninstalling.`);
+  } else if (command === "update" || command === "upgrade") {
+    await update(values, opts, positionals[1]);
   } else if (command === "status") {
     for (const t of Object.values(TARGETS)) log(`${t.label.padEnd(24)} ${t.status(opts)}`);
     const py = pythonCheck();
     log(`${"Python 3.9+".padEnd(24)} ${py.ok ? `ok (${py.version})` : py.version ? `too old (${py.version})` : "not found"}`);
+    const latest = await latestVersion().catch(() => undefined);
+    const installed = installedJobs({}, opts).map((j) => j.version).filter((v) => v !== "partial");
+    let line;
+    if (latest === undefined) line = "couldn't check npm (offline?)";
+    else if (!latest) line = "not found on npm";
+    else if (installed.some((v) => compareVersions(v, latest) < 0))
+      line = `v${latest} available — run: npx ${PKG.name}@latest update`;
+    else line = `v${latest}${installed.length ? " (up to date)" : ""}`;
+    log(`${"Latest version".padEnd(24)} ${line}`);
   } else {
     throw new CliError(`Unknown command "${command}". Run with --help.`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "job-apply-plugin",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Job Apply plugin for Claude Code and ChatGPT/Codex: prepare and submit job applications from a résumé and profile saved on your device.",
   "keywords": [
     "claude",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "job-apply",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
   "author": {
     "name": "Filipe Linemburger"

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
   "name": "job-apply",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Prepare and submit individual job applications using a résumé and profile saved on your device.",
   "keywords": [
     "jobs",