codymaster 4.1.3 → 4.3.0

package/skills/cm-growth-hacking/trigger-system.md

@@ -0,0 +1,342 @@
+# Trigger System
+
+> Khi nào hiện bottom sheet? Trigger system quyết định.
+> Hỗ trợ: scroll, time, exit-intent, click, return-visitor, interaction.
+
+---
+
+## 🎯 Trigger Types
+
+| Type | Description | Best For |
+|------|-------------|----------|
+| `scroll` | User scrolls past X% of page | Service pages, blog content |
+| `time` | X seconds after page load | Homepage, landing pages |
+| `exit` | Mouse moves toward browser chrome (desktop) | Lead capture, promo |
+| `click` | User clicks specific element | Manual CTA buttons |
+| `return` | Returning visitor (cookie-based) | Re-engagement, loyalty |
+| `interaction` | User completes N interactions | Surveys after using tool |
+| `dual` | Time + Scroll combined (both must fire) | Audio CRO, booking nudge |
+
+---
+
+## ⚙️ TriggerManager Architecture
+
+```javascript
+class TriggerManager {
+  constructor(config) {
+    this.config = config;
+    this.triggered = false;
+    this.listeners = [];
+  }
+  
+  init() {
+    if (this.isDismissed()) return;
+    if (this.respectsReducedMotion()) return;
+    
+    const type = this.config.trigger.type;
+    
+    switch (type) {
+      case 'scroll': this.initScroll(); break;
+      case 'time': this.initTime(); break;
+      case 'exit': this.initExitIntent(); break;
+      case 'click': this.initClick(); break;
+      case 'return': this.initReturnVisitor(); break;
+      case 'interaction': this.initInteraction(); break;
+      case 'dual': this.initDual(); break;
+    }
+  }
+  
+  fire() {
+    if (this.triggered) return;
+    this.triggered = true;
+    this.cleanup();
+    if (typeof this.config.onTrigger === 'function') {
+      this.config.onTrigger();
+    }
+  }
+  
+  cleanup() {
+    this.listeners.forEach(({ el, event, fn }) => el.removeEventListener(event, fn));
+    this.listeners = [];
+  }
+  
+  destroy() {
+    this.cleanup();
+    this.triggered = true;
+  }
+}
+```
+
+---
+
+## 📜 Scroll Trigger
+
+```javascript
+initScroll() {
+  const threshold = this.config.trigger.value || 0.3; // 30% default
+  const delay = this.config.trigger.delay || 0;
+  
+  const onScroll = () => {
+    const scrollPct = window.scrollY / 
+      (document.documentElement.scrollHeight - window.innerHeight);
+    
+    if (scrollPct >= threshold) {
+      if (delay > 0) {
+        setTimeout(() => this.fire(), delay);
+      } else {
+        this.fire();
+      }
+    }
+  };
+  
+  window.addEventListener('scroll', onScroll, { passive: true });
+  this.listeners.push({ el: window, event: 'scroll', fn: onScroll });
+  
+  // Check immediately (user may already be scrolled)
+  onScroll();
+}
+```
+
+**Recommended thresholds:**
+
+| Page Type | Scroll % | Rationale |
+|-----------|----------|-----------|
+| Homepage | 30% | After hero + intro |
+| Service page | 25% | After service description |
+| Blog/article | 40% | After first section |
+| Product page | 20% | After product image |
+
+---
+
+## ⏱️ Time Trigger
+
+```javascript
+initTime() {
+  const delay = this.config.trigger.value || 15000; // 15s default
+  
+  const timer = setTimeout(() => this.fire(), delay);
+  
+  // Store for cleanup
+  this._timer = timer;
+}
+
+// Override cleanup to clear timer
+cleanup() {
+  super.cleanup();
+  if (this._timer) clearTimeout(this._timer);
+}
+```
+
+**Recommended delays:**
+
+| Page Type | Delay | Rationale |
+|-----------|-------|-----------|
+| Homepage | 20-25s | Let user explore first |
+| Landing page | 10-15s | Faster engagement needed |
+| Service page | 15-20s | After reading key info |
+| Blog | 25-30s | Don't interrupt reading |
+
+---
+
+## 🚪 Exit Intent Trigger (Desktop Only)
+
+```javascript
+initExitIntent() {
+  // Only works on desktop (mouse-based)
+  if ('ontouchstart' in window) return;
+  
+  const onMouseLeave = (e) => {
+    // Mouse moved above viewport (toward browser chrome)
+    if (e.clientY <= 0) {
+      this.fire();
+    }
+  };
+  
+  document.addEventListener('mouseleave', onMouseLeave);
+  this.listeners.push({ el: document, event: 'mouseleave', fn: onMouseLeave });
+}
+```
+
+**Mobile alternative:** Use `time` or `scroll` trigger instead. Exit intent doesn't exist on touch devices.
+
+**Enhancement — debounce:**
+
+```javascript
+// Prevent rapid-fire on mouse-near-top
+let exitTimeout;
+const onMouseLeave = (e) => {
+  if (e.clientY <= 0) {
+    clearTimeout(exitTimeout);
+    exitTimeout = setTimeout(() => this.fire(), 300);
+  }
+};
+```
+
+---
+
+## 🖱️ Click Trigger
+
+```javascript
+initClick() {
+  const selector = this.config.trigger.value; // CSS selector
+  
+  const elements = document.querySelectorAll(selector);
+  elements.forEach(el => {
+    const onClick = (e) => {
+      e.preventDefault();
+      this.fire();
+    };
+    el.addEventListener('click', onClick);
+    this.listeners.push({ el, event: 'click', fn: onClick });
+  });
+}
+```
+
+**Use case:** Manual CTA buttons that open bottom sheets.
+
+```html
+<button data-trigger="booking-sheet">📅 Đặt Lịch</button>
+```
+
+```javascript
+new TriggerManager({
+  trigger: { type: 'click', value: '[data-trigger="booking-sheet"]' },
+  onTrigger: () => bookingSheet.show()
+});
+```
+
+---
+
+## 🔄 Return Visitor Trigger
+
+```javascript
+initReturnVisitor() {
+  const VISIT_KEY = 'eng_visit_count';
+  const minVisits = this.config.trigger.value || 2; // minimum visits to trigger
+  
+  try {
+    let visits = parseInt(localStorage.getItem(VISIT_KEY) || '0');
+    visits++;
+    localStorage.setItem(VISIT_KEY, visits.toString());
+    
+    if (visits >= minVisits) {
+      // Add time delay so page loads first
+      setTimeout(() => this.fire(), this.config.trigger.delay || 3000);
+    }
+  } catch { /* localStorage blocked */ }
+}
+```
+
+---
+
+## 🎮 Interaction Trigger
+
+```javascript
+initInteraction() {
+  const { selector, minCount } = this.config.trigger.value;
+  // e.g., { selector: '.checklist input[type=checkbox]', minCount: 3 }
+  
+  const elements = document.querySelectorAll(selector);
+  
+  const checkCount = () => {
+    const interacted = document.querySelectorAll(selector + ':checked').length;
+    if (interacted >= minCount) {
+      this.fire();
+    }
+  };
+  
+  elements.forEach(el => {
+    el.addEventListener('change', checkCount);
+    this.listeners.push({ el, event: 'change', fn: checkCount });
+  });
+}
+```
+
+**Use case:** After user checks 3+ symptoms → show "Đặt lịch khám" sheet.
+
+---
+
+## 🔀 Dual Trigger (Time + Scroll)
+
+Both conditions must be met before firing:
+
+```javascript
+initDual() {
+  let timeReady = false;
+  let scrollReady = false;
+  
+  const tryFire = () => {
+    if (timeReady && scrollReady) this.fire();
+  };
+  
+  // Time leg
+  const delay = this.config.trigger.value?.time || 15000;
+  setTimeout(() => { timeReady = true; tryFire(); }, delay);
+  
+  // Scroll leg
+  const threshold = this.config.trigger.value?.scroll || 0.25;
+  const onScroll = () => {
+    const pct = window.scrollY / 
+      (document.documentElement.scrollHeight - window.innerHeight);
+    if (pct >= threshold) {
+      scrollReady = true;
+      window.removeEventListener('scroll', onScroll);
+      tryFire();
+    }
+  };
+  window.addEventListener('scroll', onScroll, { passive: true });
+  this.listeners.push({ el: window, event: 'scroll', fn: onScroll });
+  onScroll();
+}
+```
+
+---
+
+## 💾 Session Management
+
+```javascript
+// Check if user dismissed this engagement
+isDismissed() {
+  const key = this.config.session?.dismissKey || 'eng_dismissed';
+  const storage = this.config.session?.storage === 'localStorage' 
+    ? localStorage : sessionStorage;
+  try { return storage.getItem(key) === '1'; } 
+  catch { return false; }
+}
+
+// Mark as dismissed
+setDismissed() {
+  const key = this.config.session?.dismissKey || 'eng_dismissed';
+  const storage = this.config.session?.storage === 'localStorage' 
+    ? localStorage : sessionStorage;
+  try { storage.setItem(key, '1'); } 
+  catch { /* noop */ }
+}
+
+// Respect prefers-reduced-motion
+respectsReducedMotion() {
+  return window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+}
+```
+
+### Storage Strategy
+
+| Behavior | Storage | Result |
+|----------|---------|--------|
+| Show once per tab session | `sessionStorage` | Resets on browser close |
+| Show once per device forever | `localStorage` | Persistent |
+| Show once per day | `localStorage` + timestamp check | Custom expiry |
+
+---
+
+## ❌ Anti-Patterns
+
+| ❌ Don't | ✅ Do |
+|----------|------|
+| Trigger popup on page load without delay | Minimum 10s or 20% scroll |
+| Use exit-intent on mobile | Fallback to scroll/time trigger |
+| Trigger on checkout/payment pages | Exclude conversion-critical pages |
+| Trigger multiple sheets at once | Queue or prioritize |
+| Ignore `prefers-reduced-motion` | Skip trigger for such users |
+| Trigger every page visit | Respect session dismiss state |
+| Use `setInterval` for scroll check | Use passive scroll event listener |

package/skills/cm-how-it-work/SKILL.md

@@ -26,14 +26,28 @@ The **CodyMaster (CM)** kit transforms ideas into production code through 13 spe
 
 ---
 
+### Phase 0.3: Knowledge Infrastructure Setup 🧠
+> **For large codebases, establish the memory foundation before planning.**
+
+- **Skills:** `cm-codeintell` + `cm-dockit` + `cm-deep-search` + `cm-notebooklm`
+- **When:** When onboarding to a new codebase or starting a massive refactoring initiative.
+- **Action:**
+    1. Scan structure with `cm-codeintell` to build the Skeleton Index.
+    2. Generate missing architectural docs with `cm-dockit`.
+    3. Index the docs for fast local retrieval with `cm-deep-search` (qmd).
+    4. Sync high-value patterns to the Cloud Brain with `cm-notebooklm`.
+- **Output:** A fully indexed 5-tier memory ecosystem ready for precise, low-token AI problem solving.
+
+---
+
 ### Phase 0.5: Strategic Analysis 🔍
 > **For complex initiatives and enhancements on existing products.**
 
-- **Skill:** `cm-brainstorm-idea`
+- **Skills:** `cm-brainstorm-idea` + `cm-codeintell`
 - **When:** When the task is complex and requires multi-dimensional analysis (tech, product, design, business) before planning.
 - **Action:**
-    1. Scan codebase and interview user (Design Thinking: Empathize).
-    2. Analyze with 9 Windows (TRIZ) to see the full picture across past/present/future.
+    1. Scan codebase with **code intelligence** (AST graph + architecture diagram via `cm-codeintell`).
+    2. Interview user and analyze with 9 Windows (TRIZ).
     3. Propose 2-3 options, evaluate multi-dimensionally, recommend the best option.
 - **Output:** `brainstorm-output.md` — qualified problem + recommended option → passes to `cm-planning`.
 
@@ -92,6 +106,7 @@ The **CodyMaster (CM)** kit transforms ideas into production code through 13 spe
 | `cm-quality-gate` | 6-gate verification: static analysis → blind review → ship. |
 | `cm-test-gate` | Setup 4-layer test infrastructure (unit → integration → e2e → security). |
 | `cm-code-review` | Manage PR lifecycle: request → receive feedback → complete branch. |
+| `cm-codeintell` | AST knowledge graph + architecture diagrams + smart context (30% fewer tokens). |
 
 ### ⚙️ Operations
 | Skill | Primary Function |
@@ -120,7 +135,7 @@ The **CodyMaster (CM)** kit transforms ideas into production code through 13 spe
 |-------|-----------------|
 | `cm-content-factory` | Self-learning content engine: research → generate → audit → deploy. |
 | `cm-ads-tracker` | Conversion tracking setup: GTM, Meta CAPI, TikTok, Google Ads. |
-| `cro-methodology` | CRO audit: funnel mapping → persuasion assets → A/B test design. |
+| `cm-cro-methodology` | CRO audit: funnel mapping → persuasion assets → A/B test design. |
 
 ### 🎯 Orchestration
 | Skill | Primary Function |
@@ -131,6 +146,7 @@ The **CodyMaster (CM)** kit transforms ideas into production code through 13 spe
 | `cm-skill-chain` | Compose skills into automated multi-step pipelines (5 built-in chains). |
 | `cm-skill-index` | Progressive disclosure index — 90% token savings on skill discovery. |
 | `cm-deep-search` | Semantic search via qmd for large codebases (>200 src / >50 docs files). |
+| `cm-notebooklm` | Cloud Brain sync — cross-machine knowledge persistence via NotebookLM. |
 | `cm-how-it-work` | Full vibe coding guide — phases, skills per phase, use cases. |
 
 ### 🖥️ Workflow Commands

package/skills/cm-identity-guard/SKILL.md

@@ -224,16 +224,6 @@ git remote get-url origin  # Must match expected
 gh auth status  # Must show correct account
 ```
 
-#### Record Identity Decision (cm-continuity)
-
-After locking identity for a new project, write to `.cm/memory/decisions.json`:
-- `decision`: "GitHub identity locked to [account], CF account [id], DB: [provider/project]"
-- `rationale`: "Multi-account safety — prevents wrong-account deploys"
-- `scope`: `global`
-- `status`: `active`
-
-Also update `.cm/CONTINUITY.md` Working Context with the locked identity.
-
 ---
 
 ## Phase 4: Multi-Account Git Setup (OS Level)
@@ -401,7 +391,6 @@ npm run deploy
 | `cm-safe-deploy` | Gate 0 secret hygiene checks wrangler.jsonc |
 | `cm-test-gate` | Phase 4 secret hygiene in test gate setup |
 | `cm-secret-shield` | Layer 5 token lifecycle extends identity management |
-| `cm-continuity` | Record identity decisions to decisions.json |
 
 ## The Bottom Line
 

package/skills/cm-jtbd/SKILL.md

@@ -94,5 +94,5 @@ Save JTBD canvas to `docs/jtbd/jtbd-canvas-[date].md`.
 |-------|-------------|
 | `cm-brainstorm-idea` | UPSTREAM: JTBD feeds into strategic analysis |
 | `cm-planning` | DOWNSTREAM: Validated jobs inform feature plans |
-| `cro-methodology` | COMPLEMENT: JTBD objections → CRO objection handling |
+| `cm-cro-methodology` | COMPLEMENT: JTBD objections → CRO objection handling |
 | `cm-dockit` | OUTPUT: JTBD canvases are a document type in DocKit |

package/skills/cm-notebooklm/SKILL.md

@@ -0,0 +1,172 @@
+---
+name: cm-notebooklm
+description: |
+  CodyMaster NotebookLM — Cloud-based AI brain/soul engine. Stores the most
+  valuable knowledge (skills, lessons learned, coding experiences, key decisions)
+  into Google NotebookLM for cross-machine sync and AI-powered recall.
+  Combines cm-dockit (codebase → docs) + cm-deep-search (local BM25) +
+  NotebookLM (cloud AI memory + podcast + flashcards).
+
+  Offers LOCAL vs CLOUD choice for large codebases. Auto-sync mechanism.
+  Selective indexing — only high-value content, not everything.
+
+  Use when user says: "notebooklm", "notebook lm", "nlm", "nạp kiến thức",
+  "knowledge base", "create notebook", "sync skills to notebook", "tạo notebook",
+  "knowledge memory", "podcast từ skills", "flashcards từ docs",
+  "add to notebooklm", "query notebooklm", "hỏi notebooklm",
+  "lưu kinh nghiệm", "bộ nhớ AI", "AI memory", "tạo podcast",
+  "codymaster notebook", "skill notebook", "sync knowledge",
+  "cloud brain", "soul sync", "cross-machine sync".
+---
+
+# Goal
+
+Cloud brain / soul cho AI — lưu trữ kiến thức **giá trị nhất**, đồng bộ qua
+nhiều máy tính. `brain.md` = compiled source of truth, upload 1 lần thay vì 50.
+
+# How It Works
+
+```
+Skills + Lessons + Experiences
+        ↓ compile
+  ~/.codymaster/brain.md  (local file = backup)
+        ↓ upload (1 API call)
+  NotebookLM (cloud = cross-machine sync)
+```
+
+All automation via `scripts/brain-sync.sh` — AI chỉ cần gọi script.
+
+# Instructions
+
+## The Dual-Brain Architecture
+
+CodyMaster uses a **Dual-Brain** approach to scale memory across multiple projects without context collapse:
+
+1. **Master Brain (`codymaster`)**: Global brain storing Meta-Learnings, proven Architecture Decisions, and universal patterns. Evolved via the "Rule of 3" (knowledge graduation).
+2. **Project Brain (Isolated)**: Optional local brain created per project to hold internal PRDs, APIs, and local code context from `./docs`.
+
+| Level | Goal | Query Command |
+|-------|------|---------------|
+| **Master** | Tìm pattern chung | `nlm notebook query codymaster "..."` |
+| **Project** | Tìm context domain | `nlm notebook query $(cat .cm/notebook_id) "..."` |
+
+> 🤖 **AI Rule:** Tự đưa quyết định khi hỏi: Hỏi `codymaster` cho các giải pháp mang tính hệ thống chung. Hỏi qua `.cm/notebook_id` cho các business logic đặc thù dự án đang làm.
+
+## Master Brain Setup (Global)
+
+```bash
+# 1. Install CLI
+uv tool install notebooklm-mcp-cli
+
+# 2. Setup Master Brain
+bash ~/.gemini/antigravity/skills/cm-notebooklm/scripts/brain-sync.sh init
+```
+
+## Project Brain Setup (Local - Optional)
+
+Nếu dự án đủ lớn và nhiều doc:
+```bash
+# Tạo Project Brain riêng cho thư mục hiện tại
+bash ~/.gemini/antigravity/skills/cm-notebooklm/scripts/brain-sync.sh init-project
+```
+
+## Daily Usage
+
+```bash
+SCRIPT=~/.gemini/antigravity/skills/cm-notebooklm/scripts/brain-sync.sh
+
+# Add a lesson learned
+bash $SCRIPT lesson "Tên bài học"
+# → Edit ~/.codymaster/lessons.md → fill in details
+
+# Add coding experience
+bash $SCRIPT experience "Tên pattern"
+# → Edit ~/.codymaster/experiences.md → fill in details
+
+# Sync to Master Brain (Thêm rule of 3)
+bash $SCRIPT sync
+
+# Sync to Project Brain (Up tài liệu local docs/)
+bash $SCRIPT sync-project
+
+# Check status
+bash $SCRIPT status
+
+# Query
+nlm notebook query codymaster "your question"
+```
+
+## Auto-Sync Triggers
+
+AI detect và **hỏi user** (không tự động):
+
+| Trigger | Prompt |
+|---------|--------|
+| Skill mới tạo | "Sync skill mới vào brain?" → `bash $SCRIPT sync` |
+| Bug fixed / post-mortem | "Lưu bài học?" → `bash $SCRIPT lesson "..."` |
+| Architecture changed | "Update brain?" → `bash $SCRIPT sync` |
+| User nói "sync/update" | → `bash $SCRIPT sync` |
+
+## Cross-Machine (Máy Mới)
+
+```bash
+uv tool install notebooklm-mcp-cli
+nlm login
+nlm notebook list          # CodyMaster Brain already there
+nlm alias set codymaster <id>
+# Done! Query ngay: nlm notebook query codymaster "..."
+```
+
+## Content Generation
+
+```bash
+nlm audio create codymaster --format deep_dive --confirm   # Podcast
+nlm report create codymaster --format "Study Guide" --confirm
+nlm flashcards create codymaster --difficulty medium --confirm
+nlm studio status codymaster
+```
+
+# What Gets Indexed
+
+```
+✅ HIGH-VALUE (auto-compiled into brain.md):
+├── Skill Index (names + descriptions — NOT full SKILL.md)
+├── Lessons Learned (~/.codymaster/lessons.md)
+├── Coding Experiences (~/.codymaster/experiences.md)
+└── AGENTS.md (project identity)
+
+❌ NOT INDEXED (use qmd/cm-deep-search instead):
+├── Full SKILL.md files (too many, hard to maintain)
+├── Source code, tests, configs
+└── Duplicated content
+```
+
+# Memory Architecture
+
+```
+Session  → variables        → temporary
+Working  → CONTINUITY.md    → ~500 words/turn
+Local    → qmd              → BM25+vector, offline, stable
+Cloud    → NotebookLM       → AI brain, cross-machine, podcast
+```
+
+# Integration
+
+| Skill | Role |
+|-------|------|
+| `cm-deep-search` | Local search complement (code) |
+| `cm-dockit` | Generate docs → select high-value → feed to brain |
+| `cm-continuity` | Session memory, brain = long-term |
+| `skill-creator-ultra` | TRIGGER: new skill → prompt sync |
+| `cm-debugging` | TRIGGER: bug fixed → prompt lesson |
+
+# Constraints
+
+- 🔌 `nlm` CLI = **third-party** (jacob-bd). May break. Fallback: cm-deep-search.
+- 🧠 **Selective only** — quality > quantity. Don't dump everything.
+- 🔐 NO secrets in NotebookLM — cloud service.
+- ❌ NO delete without user confirmation.
+- 🤖 NO `nlm chat start` — use `nlm notebook query` only.
+- 🔄 Auto-sync = **ask first**, never silent upload.
+
+<!-- Generated by Skill Creator Ultra v1.0 -->

package/skills/cm-notebooklm/references/command_reference.md

@@ -0,0 +1,94 @@
+# NLM CLI Command Reference (for cm-notebooklm)
+
+Essential commands for knowledge ingestion workflows.
+
+## Authentication
+
+```bash
+nlm login                    # Launch Chrome, extract cookies
+nlm login --check            # Validate current session
+nlm login --profile work     # Named profile for multiple accounts
+nlm auth status              # Check if authenticated
+nlm auth list                # List all profiles
+```
+
+Session lifetime: ~20 minutes. Re-authenticate when commands fail.
+
+## Notebook Management
+
+```bash
+nlm notebook list                      # List all notebooks
+nlm notebook list --json               # JSON output
+nlm notebook list --quiet              # IDs only
+nlm notebook create "Title"            # Create → returns ID
+nlm notebook get <id>                  # Notebook details
+nlm notebook describe <id>             # AI-generated summary
+nlm notebook query <id> "question"     # One-shot Q&A
+nlm notebook rename <id> "New Title"   # Rename
+nlm notebook delete <id> --confirm     # ⚠️ PERMANENT
+```
+
+## Source Management
+
+```bash
+# Add sources
+nlm source add <nb-id> --url "https://..."                    # Web page
+nlm source add <nb-id> --url "https://youtube.com/..."        # YouTube
+nlm source add <nb-id> --text "content" --title "Title"       # Pasted text
+nlm source add <nb-id> --drive <doc-id>                       # Drive doc
+nlm source add <nb-id> --drive <doc-id> --type slides         # Explicit type
+
+# View sources
+nlm source list <nb-id>                # Table of sources
+nlm source list <nb-id> --drive        # Drive sources + freshness
+nlm source describe <source-id>        # AI summary
+nlm source content <source-id>         # Raw text
+
+# Sync & delete
+nlm source stale <nb-id>              # Outdated Drive sources
+nlm source sync <nb-id> --confirm     # Sync all stale
+nlm source delete <source-id> --confirm
+```
+
+## Content Generation
+
+All require `--confirm` or `-y`:
+
+```bash
+nlm audio create <id> --confirm                          # Podcast
+nlm audio create <id> --format deep_dive --confirm       # Deep dive podcast
+nlm report create <id> --confirm                         # Briefing doc
+nlm report create <id> --format "Study Guide" --confirm  # Study guide
+nlm quiz create <id> --count 10 --difficulty 3 --confirm # Quiz
+nlm flashcards create <id> --difficulty medium --confirm  # Flashcards
+nlm mindmap create <id> --confirm                        # Mind map
+nlm slides create <id> --confirm                         # Slides
+nlm studio status <id>                                   # Check generation
+```
+
+## Aliases
+
+```bash
+nlm alias set myproject <uuid>   # Create alias
+nlm alias get myproject          # Resolve to UUID
+nlm alias list                   # List all aliases
+nlm alias delete myproject       # Remove alias
+```
+
+## Research
+
+```bash
+nlm research start "query" --notebook-id <id>              # Fast (~30s)
+nlm research start "query" --notebook-id <id> --mode deep  # Deep (~5min)
+nlm research status <id>                                    # Check progress
+nlm research import <id> <task-id>                          # Import sources
+```
+
+## Rate Limits
+
+| Operation | Wait time |
+|-----------|-----------|
+| Source add/delete | 2-3 seconds |
+| Content generation | 5 seconds |
+| Research | 2 seconds |
+| Query | 2 seconds |