mother-brain 0.7.5 → 0.7.6

package/dist/cli.js

@@ -61,7 +61,10 @@ async function init(options = {}) {
   const pkg = await fs.readJSON(path.join(packageRoot, "package.json"));
   await fs.writeJSON(versionFile, {
     installed: pkg.version,
-    installedAt: (/* @__PURE__ */ new Date()).toISOString()
+    installedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    // Startup can use this to avoid hitting the network every run.
+    lastUpdateCheckAt: (/* @__PURE__ */ new Date()).toISOString(),
+    lastKnownLatest: pkg.version
   }, { spaces: 2 });
   const sessionFile = path.join(motherBrainDir, "session-state.json");
   if (!await fs.pathExists(sessionFile)) {
@@ -205,6 +208,11 @@ async function update() {
   console.log(chalk2.dim(`Latest:    v${latestVersion}
 `));
   if (currentVersion.installed === latestVersion) {
+    await fs2.writeJSON(versionFile, {
+      ...currentVersion,
+      lastUpdateCheckAt: (/* @__PURE__ */ new Date()).toISOString(),
+      lastKnownLatest: latestVersion
+    }, { spaces: 2 });
     console.log(chalk2.green("\u2705 Already on the latest version!\n"));
     return;
   }
@@ -257,7 +265,9 @@ ${markerEnd}`;
     await fs2.writeJSON(versionFile, {
       installed: latestVersion,
       installedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      previousVersion: currentVersion.installed
+      previousVersion: currentVersion.installed,
+      lastUpdateCheckAt: (/* @__PURE__ */ new Date()).toISOString(),
+      lastKnownLatest: latestVersion
     }, { spaces: 2 });
     console.log(chalk2.cyan(`
 \u2705 Updated to v${latestVersion}!
@@ -798,7 +808,7 @@ async function uninstall(options) {
 // src/cli.ts
 import { exec as exec3 } from "child_process";
 var program = new Command();
-var VERSION = "0.7.5";
+var VERSION = "0.7.6";
 program.name("mother-brain").description("AI-powered project management framework for GitHub Copilot CLI and Codex CLI").version(VERSION);
 program.command("init").description("Initialize Mother Brain in the current project").option("-f, --force", "Overwrite existing skills").action(init);
 program.command("update").description("Update Mother Brain skills to the latest version").action(update);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mother-brain",
-  "version": "0.7.5",
+  "version": "0.7.6",
   "description": "AI-powered project management framework for GitHub Copilot CLI",
   "type": "module",
   "main": "dist/index.js",

package/skills/mother-brain/SKILL.md

@@ -43,8 +43,14 @@ allowed-tools: powershell view grep glob web_search ask_user create edit skill
   This ensures Mother Brain works across ALL agent runtimes (GitHub Copilot CLI, Codex CLI, IDE extensions, etc.) even when interactive UI tools are unavailable.
 
 ### RULE 3: VERSION CHECK FIRST
-- Before showing ANY menu, run: `npm view mother-brain version --json 2>$null`
-- Compare to local version
+- Before showing ANY menu, perform a version check (fast-first):
+  - Read `.mother-brain/version.json` to get the installed version
+  - If `.mother-brain/version.json` contains a fresh cached update check:
+    - Fields: `lastUpdateCheckAt` + `lastKnownLatest`
+    - TTL: 24 hours
+    - Then you may skip the network call and treat `lastKnownLatest` as the latest version for this startup
+  - Otherwise, run: `npm view mother-brain version --json 2>$null`
+- Compare installed vs latest
 - If newer version exists → notify user BEFORE proceeding
 - **To update**: Run `npx -y mother-brain update` — the CLI handles everything automatically
 

package/skills/mother-brain/references/state-detection.md

@@ -6,13 +6,20 @@
       - Read `references/boot-screen.md`
       - Print ONLY the short user-facing startup lines from the template
       - Do NOT print commands or internal reasoning
-    - Run version check:
-      ```powershell
-      npm view mother-brain version --json 2>$null
-      ```
-    - Compare against:
-      - If in framework repo: `cli/package.json` version field (source repo version)
-      - If in project: `.mother-brain/version.json` installed field (installed/tracked version)
+    - **Fast-first version check (cache before network)**:
+      1. Read installed version from `.mother-brain/version.json` (project) or `cli/package.json` (framework repo)
+      2. If in a project folder, check whether `.mother-brain/version.json` has a fresh cached update check:
+         - Fields: `lastUpdateCheckAt` + `lastKnownLatest`
+         - TTL: 24 hours
+         - If fresh: treat `lastKnownLatest` as "Latest" for this startup and SKIP the network call
+      3. If no cache or cache is stale: run the network check:
+         ```powershell
+         npm view mother-brain version --json 2>$null
+         ```
+         - After a successful check, update `.mother-brain/version.json` with:
+           - `lastUpdateCheckAt`: now
+           - `lastKnownLatest`: the npm version
+         - If check fails (offline), continue silently without blocking startup
     - **If newer version exists**:
       - **If in a project folder** (has `.mother-brain/version.json`):
         ```