feat: daemon file watcher + one-command install (setup.bat/sh + bbc install) + Case Study

Author: Anubis44197

INSTALLATION.txt

@@ -1,38 +1,33 @@
 BBC v8.3 Installation Instructions
 ===================================
 
-STEP 1: CLONE BBC
------------------
-git clone https://github.com/Anubis44197/BBC.git
-cd BBC
-
-STEP 2: INSTALL DEPENDENCIES
-----------------------------
-pip install -r requirements.txt
-
-STEP 3: START BBC ON YOUR PROJECT
----------------------------------
-# Windows
-python bbc.py start C:\path\to\your\project
+OPTION A: ONE-COMMAND SETUP (RECOMMENDED)
+------------------------------------------
+1. cd your-project
+2. git clone https://github.com/Anubis44197/BBC.git
+3. BBC\setup.bat          (Windows)
+   bash BBC/setup.sh      (Linux/macOS)
 
-# Linux/macOS
-python3 bbc.py start /path/to/your/project
+This automatically installs dependencies and starts BBC.
 
-# Current directory
-python bbc.py start .
-
-PIP INSTALL (DEVELOPMENT):
+OPTION B: INSTALL COMMAND
 --------------------------
-1. cd BBC
-2. pip install -e .
-3. python bbc.py start /path/to/your/project
+1. cd your-project
+2. git clone https://github.com/Anubis44197/BBC.git
+3. python BBC/bbc.py install .
+
+OPTION C: MANUAL SETUP
+-----------------------
+1. cd your-project
+2. git clone https://github.com/Anubis44197/BBC.git
+3. pip install -r BBC/requirements.txt
+4. python BBC/bbc.py start .
 
 FIRST USAGE:
 -----------
-1. Clone BBC: git clone https://github.com/Anubis44197/BBC.git
-2. Install deps: pip install -r requirements.txt
-3. Start BBC: python bbc.py start /path/to/project
-4. That's it! Your AI assistants now understand your code.
+1. Clone BBC into your project folder
+2. Run setup.bat (Windows) or setup.sh (Linux/macOS)
+3. That's it! Your AI assistants now understand your code.
 
 UPDATE BBC:
 ----------

QUICK_START.md

@@ -2,25 +2,33 @@
 
 ## 🎯 Get BBC Working in 5 Minutes
 
-### Step 1: Clone & Install BBC
+### Step 1: Clone BBC into Your Project
 
 ```bash
+cd your-project
 git clone https://github.com/Anubis44197/BBC.git
-cd BBC
-pip install -r requirements.txt
 ```
 
-### Step 2: Start BBC on Your Project
+### Step 2: One-Command Setup
 
 ```bash
-# Windows
-python bbc.py start C:\path\to\your\project
+# Windows (automatic)
+BBC\setup.bat
 
-# Linux/macOS
-python3 bbc.py start /path/to/your/project
+# Linux/macOS (automatic)
+bash BBC/setup.sh
 
-# Current directory
-python bbc.py start .
+# Or use the install command
+python BBC/bbc.py install .
+```
+
+All three options do the same thing: install dependencies + analyze + inject + start daemon.
+
+### Alternative: Manual Setup
+
+```bash
+pip install -r BBC/requirements.txt
+python BBC/bbc.py start .
 ```
 
 **BBC will:**
@@ -88,6 +96,7 @@ Universal files (always created inside `.bbc/`):
 ## 🛠️ All Commands
 
 ```bash
+python bbc.py install [path]     # One-command: deps + analyze + inject + start
 python bbc.py start [path]       # Full pipeline: Verify + Analyze + Inject
 python bbc.py start -b [path]    # Run in background (daemon mode)
 python bbc.py start -f [path]    # Force refresh

README.md

@@ -31,32 +31,47 @@ Scan Project  →  Build Sealed Context  →  Detect Active IDE  →  Inject Onl
 - Python 3.8+
 - Git
 
-### 1. Clone the Repository
+### Option A: One-Command Setup (Recommended)
+
+Clone BBC into your project and run the setup script:
 
 ```bash
+cd your-project
 git clone https://github.com/Anubis44197/BBC.git
-cd BBC
-```
 
-### 2. Install Dependencies
+# Windows
+BBC\setup.bat
 
-```bash
-pip install -r requirements.txt
+# Linux / macOS
+bash BBC/setup.sh
 ```
 
-### 3. Start BBC on Your Project
+This automatically installs dependencies and starts BBC on your project.
+
+### Option B: Manual Setup
 
 ```bash
-# Windows
-python bbc.py start C:\path\to\your\project
+# 1. Clone BBC into your project
+cd your-project
+git clone https://github.com/Anubis44197/BBC.git
 
-# Linux / macOS
-python3 bbc.py start /path/to/your/project
+# 2. Install dependencies
+pip install -r BBC/requirements.txt
 
-# Current directory
-python bbc.py start .
+# 3. Start BBC
+python BBC/bbc.py start .
 ```
 
+### Option C: Install Command
+
+If you've already cloned BBC, use the `install` command for one-step setup:
+
+```bash
+python BBC/bbc.py install .
+```
+
+This runs `pip install` + `analyze` + `inject` + `start daemon` in one command.
+
 > **Tip:** Add the BBC directory to your PATH to use `python bbc.py start` from anywhere.
 
 ---
@@ -137,7 +152,12 @@ Source: 132,000 tokens  →  Context: 14,000 tokens  |  89% savings  |  9.4x fas
 ```
 
 ### 🔄 Real-time Re-sealing
-BBC's daemon (`bbc_daemon.py`) watches for file changes. If your code changes after AI interaction, it automatically triggers a re-analysis to prevent stale context.
+BBC's daemon (`bbc_daemon.py`) actively monitors your project for changes every 30 seconds:
+- **New files added** → automatic re-analysis + re-injection
+- **Files modified** → SHA-256 hash comparison detects stale context, triggers re-seal
+- **Files deleted** → context updated to remove orphaned symbols
+
+The daemon uses `adaptive_mode.check_context_freshness()` for hash-based staleness detection and recommends `RESCAN` or `PARTIAL_RESCAN` based on the ratio of changed files.
 
 ### 🧠 Adaptive Mode (STRICT / RELAXED)
 BBC operates in two modes depending on context match quality:
@@ -163,12 +183,47 @@ Verification also runs automatically at the end of every `bbc start` and `bootst
 
 ---
 
-## 🛠️ Commands
+## � Case Study: Borsa MCP (Real-World Benchmark)
+
+BBC was tested on **borsa-mcp** — a financial data MCP server for Borsa Istanbul with 257K+ lines of code. Testing was performed using the **Cline extension** (VS Code) with free-form prompts.
+
+### Benchmark: 10-Year OHLCV Analysis (3,650 records)
+
+| Metric | Without BBC | With BBC | Savings |
+|---|---:|---:|---:|
+| Characters | 449,490 | 4,266 | 445,224 |
+| Tokens (approx) | 112,372 | 1,066 | 111,306 |
+| Tokens (tiktoken/real) | 233,757 | 1,951 | **231,806** |
+| **Savings Rate (real)** | — | — | **99.17%** |
+
+> **119:1 compression ratio** — verified with `tiktoken` (GPT-4o tokenizer)
+
+### How BBC Achieved This
+
+1. **Context Discipline:** Instead of dumping README + raw data + verbose instructions into one prompt, BBC enforces focused task payloads with `context_source: .bbc/bbc_context.json`
+2. **Adaptive Sampling:** 3,650 daily records → key inflection points only (`TokenOptimizer`)
+3. **Compact JSON:** Field shortening, null removal, number rounding (`CompactJSONOptimizer`)
+4. **Hallucination Prevention:** `constraint_status: verified` ensures AI stays within sealed context
+
+### Key Insight
+
+> *"BBC is not magic automation — it’s an engineering framework that keeps AI work safe and focused."*
+> 
+> The massive token reduction comes from BBC discipline + optimization working together, not from a single tool.
+
+*Tested with Cline extension (VS Code) using free-form prompts. March 2026.*
+
+---
+
+## �🛠️ Commands
 
 ```bash
 # Full pipeline: Verify + Analyze + Inject + Start Daemon
 python bbc.py start [path]
 
+# One-command install: deps + analyze + inject + start
+python bbc.py install [path]
+
 # Force refresh (use after code changes)
 python bbc.py start -f [path]
 

bbc.py

@@ -178,6 +178,28 @@ def purge(self, path=".", force=False):
         if force: cmd.append("--force")
         self.run_command(cmd)
 
+    def install(self, project_path: str = ".", force: bool = False):
+        """One-command BBC install: pip install deps + analyze + inject + start"""
+        print(f"[BBC] One-Command Install starting...")
+        
+        # 1. Install dependencies
+        req_file = self.script_dir / "requirements.txt"
+        if req_file.exists():
+            print(f"[BBC] Step 1/2: Installing dependencies...")
+            result = subprocess.call(
+                [sys.executable, "-m", "pip", "install", "-r", str(req_file), "-q"]
+            )
+            if result != 0:
+                print(f"[BBC] Warning: Some dependencies may have failed to install.")
+            else:
+                print(f"[BBC] Step 1/2: Dependencies installed.")
+        else:
+            print(f"[BBC] Step 1/2: No requirements.txt found, skipping.")
+        
+        # 2. Run full start pipeline
+        print(f"[BBC] Step 2/2: Starting BBC...")
+        self.start(project_path, force=force)
+
     def serve(self, port=3333):
         """Start HTTP API Server"""
         print(f"[BBC] Starting API Server on port {port}...")
@@ -221,6 +243,11 @@ def main():
     menu_parser = subparsers.add_parser("menu", help="Interactive BBC Menu")
     menu_parser.add_argument("path", nargs="?", default=".", help="Project path")
 
+    # Install (One-command setup)
+    install_parser = subparsers.add_parser("install", help="One-command install: deps + analyze + inject + start")
+    install_parser.add_argument("path", nargs="?", default=".", help="Project path")
+    install_parser.add_argument("--force", "-f", action="store_true", help="Force fresh install")
+
     # Watch (IDE Terminal Monitor)
     watch_parser = subparsers.add_parser("watch", help="Watch AI operations and show HMPU reports in IDE terminal")
     watch_parser.add_argument("path", nargs="?", default=".", help="Project path")
@@ -256,6 +283,8 @@ def main():
         menu_main(str(Path(args.path).resolve()), loop=True)
     elif args.command == "watch":
         cli.watch(args.path)
+    elif args.command == "install":
+        cli.install(args.path, args.force)
     elif args.command == "stop":
         cli.stop(args.path)
     elif args.command == "status":