mother-brain 0.7.4 → 0.7.5

package/dist/cli.js

@@ -798,7 +798,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.5";
 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.5",
   "description": "AI-powered project management framework for GitHub Copilot CLI",
   "type": "module",
   "main": "dist/index.js",

package/skills/mother-brain/SKILL.md

@@ -382,17 +382,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 +424,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 +439,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

@@ -11,22 +11,41 @@
       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
+      - If in framework repo: `cli/package.json` version field (source repo version)
+      - If in project: `.mother-brain/version.json` installed field (installed/tracked version)
     - **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 +56,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 +98,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 +153,4 @@
      - `.mother-brain/docs/roadmap.md` - Current roadmap (load only when needed)
      - `.mother-brain/docs/tasks/` - Task documentation folder
      - `.github/skills/` - Project-specific skills
-   
+