mother-brain 0.7.4 → 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.4";
+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.4",
+  "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
 
@@ -382,17 +388,17 @@ Key rules: Use `allow_freeform: true` on all `ask_user` calls. Check freeform re
    - Proceed immediately to Step 2 (Detect Project State)
 
 ### 2. **Detect Project State & Show Progress**
-    
-   - Runs version check, meta-mode detection, fast startup optimization, auto-update with improvement capture, and artifact scanning.
-   - **Read `references/state-detection.md`** for the full detection procedure (version check, meta-mode, fast startup, auto-update Steps A–D, artifact list)
-   - After detection completes, display the appropriate menu below based on project state:
+     
+    - Runs version check, meta-mode detection, fast startup optimization, auto-update with improvement capture, and artifact scanning.
+    - **Read `references/state-detection.md`** for the full detection procedure (version check, meta-mode, fast startup, auto-update Steps A–D, artifact list)
+    - After detection completes, display the appropriate menu below based on project state:
 
-   **If project exists:**
-   - Load session state from `docs/session-state.json`
-   
-   - **Git Check (ensure git is available)**:
-     - Check if `.git` folder exists in project root
-     - If NOT exists:
+    **If project exists:**
+    - Load session state from `.mother-brain/session-state.json`
+    
+    - **Git Check (ensure git is available)**:
+      - Check if `.git` folder exists in project root
+      - If NOT exists:
        ```
        ⚠️ Git repository not found - initializing...
        ```
@@ -424,11 +430,11 @@ Key rules: Use `allow_freeform: true` on all `ask_user` calls. Check freeform re
    - **If "I have a new idea"**: Jump to **Step 2F: Idea Capture & Prioritization**
    - **If "Improve Mother Brain"**: Jump to **Step 2A: Improve Mother Brain Menu**
 
-   **If existing project WITHOUT Mother Brain artifacts (ONBOARDING):**
-   - Detect: Files exist in directory, but NO `.mother-brain/` folder and NO `docs/vision.md`
-   - Display:
-     ```
-     🧠 I see an existing project here!
+    **If existing project WITHOUT Mother Brain artifacts (ONBOARDING):**
+    - Detect: Files exist in directory, but NO `.mother-brain/` folder (Mother Brain not installed here)
+    - Display:
+      ```
+      🧠 I see an existing project here!
      
      I can help you manage this project using the Mother Brain framework.
      I'll scan your codebase, understand what you've built, and help you
@@ -439,12 +445,19 @@ Key rules: Use `allow_freeform: true` on all `ask_user` calls. Check freeform re
      - "Yes, onboard Mother Brain into this project"
      - "No, start fresh (ignore existing files)"
 
-   - **If user selects onboarding**: Jump to **Step 2.2: Existing Project Onboarding**
+    - **If user selects onboarding**: Jump to **Step 2.2: Existing Project Onboarding**
 
-   **If new project (empty directory or user chose fresh start):**
-   - Display welcome:
-     ```
-     🧠 Welcome to Mother Brain!
+    **If Mother Brain is installed but this folder is scaffolding-only (NEW PROJECT):**
+    - Detect:
+      - `.mother-brain/session-state.json` exists AND its project is unset (e.g., `project: null`)
+      - `.mother-brain/docs/vision.md` does NOT exist
+      - Repo root contains only Mother Brain scaffolding (e.g., `.mother-brain/`, `.github/`, `.agents/`, `AGENTS.md`, optional `.git/`)
+    - Treat this as a **new project** (show the new-project welcome flow below). Do NOT show onboarding.
+
+    **If new project (empty directory or user chose fresh start):**
+    - Display welcome:
+      ```
+      🧠 Welcome to Mother Brain!
      
      I'm your AI project companion. Tell me what you want to build,
      and I'll help you make it real—step by step.

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

@@ -6,27 +6,53 @@
       - 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
-      - If in project: `.mother-brain/version.json` version field
+    - **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**:
-      ```
-      ⚠️ Mother Brain Update Available
-      
-      Installed: v[current]
-      Latest: v[npm version]
+      - **If in a project folder** (has `.mother-brain/version.json`):
+        ```
+        ⚠️ Mother Brain Update Available
+        
+        Installed: v[current]
+        Latest: v[npm version]
+        
+        Update recommended before continuing.
+        ```
+        - Use `ask_user` with choices:
+          - "Update now (recommended)"
+          - "Skip this time"
+        - **If "Update now"**: Run `npx -y mother-brain update`, then continue
+        - **If "Skip"**: Continue but note version mismatch
       
-      Update recommended before continuing.
-      ```
-      - Use `ask_user` with choices:
-        - "Update now (recommended)"
-        - "Skip this time"
-      - **If "Update now"**: Run auto-update (see update commands below), then continue
-      - **If "Skip"**: Continue but note version mismatch
+      - **If in the Mother Brain framework repo** (source code checkout):
+        ```
+        ⚠️ Mother Brain Release Ahead of This Checkout
+        
+        Repo version (cli/package.json): v[current]
+        Latest release (npm): v[npm version]
+        
+        This usually means your local checkout hasn’t been pulled to the latest tag yet.
+        ```
+        - Use `ask_user` with choices:
+          - "Fetch tags + pull latest framework changes (recommended)"
+          - "Skip this time"
+        - **If "Fetch tags + pull"**:
+          - Run `git fetch --tags origin`
+          - Run `git pull --ff-only origin main`
+          - Then continue detection
+        - **If "Skip"**: Continue but note mismatch
     - **If current or check fails**: Continue silently
    
    **🧬 META-MODE DETECTION (AFTER VERSION CHECK)**:
@@ -37,6 +63,8 @@
      4. If ALL of these exist → we are in the Mother Brain framework repo
    
    - **If in Mother Brain framework repo**:
+     - Refresh tags before reporting "last release" (quiet):
+       - Run `git fetch --tags origin`
      - Check `.mother-brain/meta-mode.json` for existing meta session state
      - Display:
        ```
@@ -77,11 +105,34 @@
    - **If NOT in framework repo**: Continue with normal detection below
    
    **⚡ FAST STARTUP OPTIMIZATION (MANDATORY)**:
-   - **Single file check first**: Check ONLY `.mother-brain/session-state.json` - if it exists, project exists
+   - **Single file check first**: Check ONLY `.mother-brain/session-state.json`
+     - If it exists: Mother Brain is installed in this folder (NOT necessarily an "existing project")
+     - If it does not exist: treat as "no Mother Brain artifacts" (possible onboarding or brand-new folder)
    - **Parallel tool calls**: When multiple checks are needed, run them in ONE response (not sequentially)
    - **Lazy loading**: Only load vision.md, roadmap.md, README.md when actually needed (not at startup)
    - **Minimal detection**: For new project detection, a single glob for `.mother-brain/` is sufficient
    - Goal: User sees menu within 1-2 tool calls, not 6+
+
+   **🧩 SCAFFOLDING-ONLY DETECTION (CRITICAL - fixes false "existing project" onboarding)**
+   - A freshly created folder can look like an "existing project" after `mother-brain init` because init creates:
+     - `.mother-brain/session-state.json` (with `project: null`)
+     - `.mother-brain/version.json`
+     - `.github/skills/*`
+     - `.agents/skills/*`
+     - `AGENTS.md`
+     - `.git/` (if git init is performed)
+   - **Rule**: If the folder contains ONLY Mother Brain scaffolding, treat it as a **new project** (show the new-project welcome flow), NOT onboarding.
+   - Detect scaffolding-only as:
+     1. `.mother-brain/session-state.json` exists AND its JSON has `project: null` (or no project name)
+     2. `.mother-brain/docs/vision.md` does NOT exist
+     3. The repo root contains no "real project files" beyond:
+        - `.mother-brain/`
+        - `.github/`
+        - `.agents/`
+        - `.git/`
+        - `AGENTS.md`
+     - If all true → show **New Project** welcome menu (Step 2 new project)
+     - If false → proceed with normal project/onboarding detection
    
    **📦 AUTO-UPDATE CHECK (on startup, if project exists)**:
    - If `.mother-brain/version.json` exists:
@@ -109,4 +160,4 @@
      - `.mother-brain/docs/roadmap.md` - Current roadmap (load only when needed)
      - `.mother-brain/docs/tasks/` - Task documentation folder
      - `.github/skills/` - Project-specific skills
-   
+