@novare-technologies/nvaid 0.2.0 → 0.2.1

package/README.md

@@ -31,6 +31,27 @@ nvaid init --owning-repo frontend        # preset the config's owning_repo
 nvaid init --yes                          # non-interactive (defaults to the AGENTS.md catch-all)
 ```
 
+## Upgrading
+
+Upgrading is **two steps**, because `nvaid update` re-syncs a repo to the version of the
+tool installed on your machine — it does not upgrade the tool itself:
+
+```bash
+# 1. upgrade the tool (once per machine, when a new version ships)
+npm i -g @novare-technologies/nvaid@latest
+
+# 2. re-sync each repo to the new version (run inside each repo)
+nvaid update
+```
+
+nvaid checks npm (at most once a day, cached, non-blocking) and prints a one-line nudge
+when a newer version is available — it never upgrades itself (the package manager owns the
+tool's lifecycle). Silence the check with `NVAID_NO_UPDATE_CHECK=1`.
+
+Note: `nvaid update` never touches hand-owned files (`config.yml`, `PROJECT-RULES.md`,
+`DESIGN-CODE-DICTIONARY.md`, `intents/`). If a new version adds a config field, add it to
+your `config.yml` by hand — the changelog will call these out.
+
 ## How it works
 
 - **Full skill set, no profiles.** `init` injects every skill into each selected agent. A

package/dist/cli.js

@@ -109,8 +109,8 @@ var NVAID_DIR_NAME = "nvaid";
 var CONFIG_FILE = "config.yml";
 var AIDLC_ROOT_TOKEN = "{{AIDLC_ROOT}}";
 async function nvaidVersion() {
-  const { readFile: readFile3 } = await import("fs/promises");
-  const pkg = JSON.parse(await readFile3(resolve(TEMPLATES_DIR, "..", "package.json"), "utf8"));
+  const { readFile: readFile4 } = await import("fs/promises");
+  const pkg = JSON.parse(await readFile4(resolve(TEMPLATES_DIR, "..", "package.json"), "utf8"));
   return pkg.version;
 }
 
@@ -460,6 +460,81 @@ async function runValidate() {
   return 0;
 }
 
+// src/updateNotifier.ts
+import { readFile as readFile3, writeFile as writeFile3, mkdir as mkdir3 } from "fs/promises";
+import { homedir, tmpdir } from "os";
+import { join as join4 } from "path";
+import pc4 from "picocolors";
+var PKG = "@novare-technologies/nvaid";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
+var FETCH_TIMEOUT_MS = 1500;
+function cacheFile() {
+  const base = process.env.XDG_CACHE_HOME || join4(homedir(), ".cache");
+  return join4(base || tmpdir(), "nvaid", "update-check.json");
+}
+async function readCache() {
+  try {
+    return JSON.parse(await readFile3(cacheFile(), "utf8"));
+  } catch {
+    return null;
+  }
+}
+async function writeCache(c) {
+  try {
+    const f = cacheFile();
+    await mkdir3(join4(f, ".."), { recursive: true });
+    await writeFile3(f, JSON.stringify(c), "utf8");
+  } catch {
+  }
+}
+async function fetchLatest() {
+  try {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), FETCH_TIMEOUT_MS);
+    const res = await fetch(`https://registry.npmjs.org/${PKG}/latest`, {
+      signal: ctrl.signal
+    });
+    clearTimeout(timer);
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data.version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewer(a, b) {
+  const pa = a.split(".").map((n) => parseInt(n, 10));
+  const pb = b.split(".").map((n) => parseInt(n, 10));
+  for (let i = 0; i < 3; i++) {
+    const x = pa[i] ?? 0;
+    const y = pb[i] ?? 0;
+    if (x > y) return true;
+    if (x < y) return false;
+  }
+  return false;
+}
+async function notifyIfOutdated() {
+  if (process.env.NVAID_NO_UPDATE_CHECK) return;
+  const current = await nvaidVersion();
+  const cache = await readCache();
+  const now = Date.now();
+  let latest = null;
+  if (cache && now - cache.lastCheck < CHECK_INTERVAL_MS) {
+    latest = cache.latest;
+  } else {
+    latest = await fetchLatest();
+    if (latest) await writeCache({ lastCheck: now, latest });
+  }
+  if (!latest || !isNewer(latest, current)) return;
+  const line = (s) => process.stderr.write(s + "\n");
+  line("");
+  line(pc4.yellow(`  \u250C\u2500 nvaid update available \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
+  line(pc4.yellow("  \u2502 ") + `${pc4.dim(current)} \u2192 ${pc4.green(latest)}`);
+  line(pc4.yellow("  \u2502 ") + `run: ${pc4.cyan(`npm i -g ${PKG}@latest`)}`);
+  line(pc4.yellow("  \u2502 ") + pc4.dim(`then re-sync your repo: nvaid update`));
+  line(pc4.yellow(`  \u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500`));
+}
+
 // src/cli.ts
 var program = new Command();
 program.name("nvaid").description("nvaid \u2014 install an AI-DLC skills + workflow toolkit into any coding agent").version(await nvaidVersion());
@@ -475,9 +550,13 @@ program.command("update").description("Re-sync agent files to the installed nvai
   await runUpdate();
 });
 program.command("validate").description("Fail if generated agent files are stale or hand-edited").action(async () => {
-  process.exit(await runValidate());
+  const code = await runValidate();
+  await notifyIfOutdated();
+  process.exit(code);
 });
-program.parseAsync().catch((err) => {
+program.parseAsync().then(async () => {
+  await notifyIfOutdated();
+}).catch((err) => {
   console.error(err instanceof Error ? err.message : err);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@novare-technologies/nvaid",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "nvaid — one CLI that installs an AI-DLC skills-and-workflow toolkit into any coding agent, and houses intents, config, and the design-code dictionary in a single nvaid/ folder.",
   "type": "module",
   "bin": {

package/templates/nvaid/config.yml

@@ -84,4 +84,4 @@ context: ""
 
 # nvaid version this repo was last generated against. `nvaid validate` compares the
 # installed CLI version to this and flags drift.
-generated_with: "0.2.0"
+generated_with: "0.2.1"