codymaster 4.1.3 → 4.3.0

package/CHANGELOG.md

@@ -4,9 +4,22 @@ All notable changes to this project will be documented in this file.
 
 Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 
+## [4.3.0] - 2026-03-27
+
+### 🚀 Improvements
+
+- **Unified 5-Tier Memory Architecture** — Upgraded CodyMaster's internal memory pipeline from 3-tier to a complete 5-tier system (including Tier 4: Document Memory and Tier 5: Structural Code Memory).
+- **cm-notebooklm** — New "Knowledge Kitchen" workflow enabling seamless 2-way sync with Google NotebookLM for project-specific cloud AI memory.
+- **cm-content-factory** — Unified Content Hub implementation integrating NotebookLM with the Content Factory for automated marketing asset generation.
+- **cm-brainstorm-idea** — Strategic analysis gate for evaluating complex initiatives using Design Thinking + 9 Windows (TRIZ).
+- **Multi-lingual 3D Brain Visualization** — New interactive 3D brain landing page (`brain-3d.html`) implemented with full i18n support.
+- **Credits extraction** — Extracted standalone credits landing page for a cleaner UI interface.
+- +35-skill arsenal achieved with enhanced token optimization and UX heuristics.
+
 ## [4.2.0] - 2026-03-24
 
 ### 🔒 Security
+
 - **DOM XSS Remediation** — Sanitized all `innerHTML` injections across 6 JS files (`kit.js`, `skills-page.js`, `demo-page.js`, `docs-page.js`, `story-page.js`, `index.html`) with `escapeHtml()` + `escapeAttr()`
 - **sanitize.js** — New shared utility providing `escapeHtml()`, `escapeHtmlWithBreaks()`, `escapeAttr()` loaded in 23 HTML pages
 - **safe_path.py** — New Python utility for path traversal prevention with `safe_resolve()`, `safe_join()`, `safe_open()`
@@ -19,17 +32,19 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
   - `cm-code-review`: Part D Security Review Checklist
 
 ### 🚀 Improvements
+
 - **CLI Terminal UI Redesign** — New premium terminal interface with onboarding, theme system, and hamster mascot
 - **Security Assessment** — Full audit of Agent Trust Hub API (`ai.gendigital.com`)
 
 ### 🐛 Bug Fixes
+
 - Fixed unescaped i18n data in persona cards, skill cards, JTBD canvas, FAQ, and IDE instructions
 - Fixed `docs-page.js` ~40 unescaped values across 5 render functions
 
 ---
 
-
 ### 🚀 Improvements
+
 - Documentation Changelog Integration — automated changelog generation added to VitePress docs
 - Setup NPM Publishing — configured package for npmjs.com publishing
 - CLI Interface Redesign — premium mobile-optimized ASCII art banner
@@ -37,15 +52,16 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 - Open Source Docs — added section acknowledging referenced GitHub repositories
 
 ### 🐛 Bug Fixes
+
 - Security Vulnerability Remediation — resolved Snyk Code findings including DOM XSS and Path Traversal
 - Fixed 401 Unauthorized authentication error for `/cm:cm-start` command
 
 ---
 
-
 ## [4.1.0] - 2026-03-23
 
 ### 🚀 Improvements
+
 - Token Optimization Phase 1 — `GEMINI.md` reduced from 32 `@` imports to 3 essential skills, saving 92% tokens per turn (~100K → ~8K)
 - Token Optimization Phase 2 — Top 5 largest skills slimmed by 72-84% (105K bytes saved total):
   - `cm-project-bootstrap` 40K → 6.6K, `cm-ux-master` 27K → 5.6K, `cm-safe-deploy` 23K → 4.1K, `cro-methodology` 22K → 4.9K, `cm-ads-tracker` 19K → 5.3K
@@ -58,6 +74,7 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 ## [4.0.0] - 2026-03-23
 
 ### 🚀 Improvements
+
 - Project Level System (L0-L3) — auto-detects complexity and scales workflow depth
 - Shared Helpers Pattern — `skills/_shared/helpers.md` with 6 reusable sections (~750-1000 tokens saved per skill)
 - Role Labels — 6 key skills now carry explicit roles (Lead Developer, Strategic Analyst, Product Manager, QA Lead, Test Engineer, Release Engineer)
@@ -68,6 +85,7 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 - Release Pipeline — automatic version bumping and changelog generation in `cm-safe-deploy`
 
 ### 🐛 Bug Fixes
+
 - Remove `skill-creator-ultra` from skill index, CLI, FAQ, and i18n files (replaced by on-demand `cm-skill-mastery` guidance)
 
 ---
@@ -75,6 +93,7 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 ## [3.4.0] - 2026-03-23
 
 ### 🚀 Improvements
+
 - Multi-country upgrade for VN, TH, PH
 - Smart Import Engine with configurable scoring rules
 - Design system extraction with Harvester v5
@@ -84,6 +103,7 @@ Categories: 🚀 **Improvements** | 🐛 **Bug Fixes** | 🔒 **Security**
 - i18n framework with 4-language support (vi, en, th, ph)
 
 ### 🐛 Bug Fixes
+
 - Fix FAQ card spacing on mobile layout
 - Fix i18n key parity for Thai language files
 - Fix employee period score calculation edge cases

package/README.md

@@ -6,11 +6,11 @@
 
 ### Your AI Agent is smart. CodyMaster makes it *wise*.
 
-**34 Skills · 11 Commands · 1 Plugin · 7+ Platforms · 6 Languages**
+**35 Skills · 11 Commands · 1 Plugin · 7+ Platforms · 6 Languages**
 
 <p align="center">
-  <img alt="Version" src="https://img.shields.io/badge/version-4.1.3-blue.svg?cacheSeconds=2592000" />
-  <img alt="Skills" src="https://img.shields.io/badge/skills-34-success.svg" />
+  <img alt="Version" src="https://img.shields.io/badge/version-4.3.0-blue.svg?cacheSeconds=2592000" />
+  <img alt="Skills" src="https://img.shields.io/badge/skills-35-success.svg" />
   <img alt="Platforms" src="https://img.shields.io/badge/platforms-7+-orange.svg" />
   <img alt="Open Source" src="https://img.shields.io/badge/license-MIT-purple.svg" />
   <a href="https://github.com/tody-agent/codymaster#readme" target="_blank">
@@ -58,7 +58,7 @@ But then reality hits:
 
 ## 🟢 The Solution: An Entire Senior Team in One Kit
 
-CodyMaster isn't just "another AI skills pack." It's **10+ years of product management experience + 6 months of battle-tested vibe coding**, distilled into 34 interconnected skills that work as a **single integrated system**.
+CodyMaster isn't just "another AI skills pack." It's **10+ years of product management experience + 6 months of battle-tested vibe coding**, distilled into 35 interconnected skills that work as a **single integrated system**.
 
 When you install CodyMaster, you're not adding skills.
 **You're hiring an entire senior team:**
@@ -68,7 +68,7 @@ graph TD
     A["🧠 CodyMaster Kit"] --> B["👨‍💻 Senior Developer<br/><i>cm-tdd · cm-debugging · cm-code-review</i>"]
     A --> C["🎨 UX Lead<br/><i>cm-design-system · cm-ux-master · cm-ui-preview</i>"]
     A --> D["📋 Product Manager<br/><i>cm-planning · cm-brainstorm-idea · cm-jtbd</i>"]
-    A --> E["🔒 DevOps Engineer<br/><i>cm-safe-deploy · cm-secret-shield · cm-identity-guard</i>"]
+    A --> E["🔒 DevOps Engineer<br/><i>cm-safe-deploy · cm-secret-shield · cm-security-gate · cm-identity-guard</i>"]
     A --> F["📝 Technical Writer<br/><i>cm-dockit · cm-content-factory</i>"]
     A --> G["📈 Growth Marketer<br/><i>cm-ads-tracker · cro-methodology</i>"]
     style A fill:#fbc531,stroke:#e1b12c,color:#2f3640,stroke-width:3px
@@ -104,13 +104,20 @@ graph LR
     class A,B,C,D,E,F,G,H,I,J,K,L phase;
 ```
 
-### 🧠 A Brain That Learns From Mistakes
+### 🧠 The Unified Brain: 5-Tier Memory Architecture
 
-Your AI doesn't just execute — it **remembers and improves**:
+Your AI doesn't just execute — it **understands and remembers** using a multi-scale, 5-Tier Unified Brain system that persists across sessions and machines:
 
-- **`cm-continuity`** — Working memory across sessions. AI remembers what went wrong and never repeats the same mistake
-- **`cm-skill-mastery`** — Doesn't know how to do something? It **finds the right skill automatically** and upgrades itself
-- **`cm-deep-search`** — Lost in a 200+ file codebase? Semantic search across everything in seconds
+1. **Sensory Memory (Session)** — Immediate context of active files and terminals.
+2. **Working Memory (`cm-continuity`)** — Cross-session scratchpad. AI never repeats the same mistake.
+3. **Long-Term Memory (`learnings.json`)** — Reinforced lessons with smart Ebbinghaus TTL decay.
+4. **Semantic Memory (`cm-deep-search`)** — Local vector search across docs using `qmd`.
+5. **Structural Memory (`cm-codeintell`)** — AST-based CodeGraph. Up to 95% token compression for full codebase context.
+
+☁️ **The Cloud Brain (`cm-notebooklm`)**
+High-value knowledge and design patterns are synced to NotebookLM, providing a universal, cross-machine "Soul" for your project. Auto-generate podcasts and flashcards to onboard human developers alongside the AI.
+
+📖 [Read the full Knowledge Architecture →](docs/knowledge-architecture.md)
 
 ### 🛡️ Multi-Layer Protection (Your Codebase Won't Get Destroyed)
 
@@ -122,7 +129,7 @@ flowchart LR
         A["cm-tdd<br/>Tests First"] --> B["cm-code-review"]
     end
     subgraph "Layer 2: Secure"
-        B --> C["cm-secret-shield<br/>Leak Scan"] --> D["cm-identity-guard<br/>Right Account"]
+        B --> C["cm-secret-shield<br/>Leak Scan"] --> S["cm-security-gate<br/>Vuln Scan"] --> D["cm-identity-guard<br/>Right Account"]
     end
     subgraph "Layer 3: Isolate"
         D --> E["cm-git-worktrees<br/>Isolated Branch"]
@@ -154,9 +161,15 @@ Don't know what the old code does? **`cm-dockit`** reads your entire codebase an
 
 **One scan = Complete knowledge base.**
 
-### 📊 Visual Dashboard — See Everything at a Glance
+### 💡 Strategic Brainstorming (Design Thinking + 9 Windows)
+
+Before diving into code for complex requests, **`cm-brainstorm-idea`** evaluates your product using multi-dimensional analysis (Tech, Product, Design, Business). It generates 2-3 qualified options using the 9 Windows (TRIZ) framework and provides a visual UI Preview via **Pencil.dev** or **Google Stitch** to validate the direction before detailed planning. 
+
+### 🏭 AI Content Factory v2.0 & Visual Dashboard
 
-No more guessing. Track every task, every agent, every deployment on a real-time Kanban board. Pipeline progress, token tracker, event log — all on one screen.
+Need to scale content? **`cm-content-factory`** is a self-learning, multi-agent content engine. It automatically researches, writes, audits (SEO & Persuasion), and deploys high-converting articles with the Content Mastery framework (StoryBrand + Cialdini) to guarantee conversion.
+
+Track it all on the **Visual Dashboard** (`cm-dashboard`): No more guessing. Track every task, every agent, every deployment on a real-time Kanban board. Pipeline progress, token tracker, event log — all on one screen.
 
 ---
 
@@ -164,9 +177,9 @@ No more guessing. Track every task, every agent, every deployment on a real-time
 
 |                            | 😵 15 Random Skills                         | 🧠 CodyMaster                                                         |
 | -------------------------- | ------------------------------------------- | --------------------------------------------------------------------- |
-| **Integration**      | Each skill is standalone, no shared context | 34 skills that chain, share memory, and communicate                   |
+| **Integration**      | Each skill is standalone, no shared context | 35 skills that chain, share memory, and communicate                   |
 | **Lifecycle**        | Covers coding only                          | Covers Idea → Design → Code → Test → Deploy → Docs → Learn      |
-| **Memory**           | Forgets everything between sessions         | 4-tier memory system: Working → Episodic → Semantic → Deep Search  |
+| **Memory**           | Forgets everything between sessions         | 5-tier Unified Brain: Sensory → Working → Long-term → Semantic → Structural + Cloud Brain  |
 | **Safety**           | YOLO deploys                                | 4-layer protection: TDD → Security → Isolation → Multi-gate deploy |
 | **Design**           | Random UI every time                        | Extracts & enforces design system + visual preview                    |
 | **Documentation**    | "Maybe write a README later"                | Auto-generates complete docs, SOPs, API refs from code                |
@@ -200,98 +213,55 @@ If you prefer:
 
 ## 🚀 1-Minute Install
 
-### NPM (Universal, Interactive Onboarding)
-
-```bash
-npm install -g codymaster
-codymaster
-```
-
-The CLI will greet you with Cody the Hamster 🐹 and guide you through a **5-step self-onboarding**:
-
-```
-    ( . \ --- / . )
-     /   ^   ^   \        Hi! I'm Cody 🐹
-    (      u      )        Your smart coding companion.
-     |  \ ___ /  |
-      '--w---w--'
-
-  Step 1 of 5  ● ○ ○ ○ ○
-
-◆  What should I call you?
-│  _
-
-◆  Where do you code?         ← 9 platforms supported!
-│  ● ✦  Google Antigravity (Gemini)
-│  ○ 🟣 Claude Code
-│  ○ ⬡  Cursor
-│  ○ 🌊 Windsurf
-│  ○ 🔶 Cline / RooCode
-│  ○ 📦 OpenCode
-│  ○ 🪁 Kiro
-│  ○ 🤖 GitHub Copilot
-│  ○ 🔧 Other / Not sure
-```
+### 1. Install AI Skills (All Platforms)
 
-### Claude Code
+One command installs all 35 skills to your environment. Supports Claude Code, Gemini CLI, Cursor, Aider, Windsurf, Cline, OpenCode, and more:
 
 ```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --claude
+bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --all
 ```
 
-*Or: `claude plugin marketplace add tody-agent/codymaster` → `claude plugin install cm@codymaster`*
-
-### Cursor IDE
+*For Cursor IDE users, you can also just type `/add-plugin cody-master` in your agent chat.*
 
-```
-/add-plugin cody-master
-```
+### 2. Install Mission Control Dashboard (Optional but Recommended)
 
-### Gemini CLI / Antigravity
+Visualize your progress, manage tasks, and track your 10x coding streak with Cody the Hamster 🐹.
 
 ```bash
-# Clone and install skills
-git clone --depth 1 https://github.com/tody-agent/codymaster.git ~/.cody-master
-cp -r ~/.cody-master/skills/* ~/.gemini/antigravity/skills/
+npm install -g codymaster
+cm
 ```
 
-*Or use the auto-installer:*
-
-```bash
-bash <(curl -fsSL https://raw.githubusercontent.com/tody-agent/codymaster/main/install.sh) --antigravity
-```
+The CLI will greet you and keep you organized on your long coding sessions!
 
-<details>
-<summary><b>Other Platforms: Cline, OpenCode, Kiro, Copilot, Windsurf</b></summary>
+```text
+    ( . \ --- / . )
+     /   ^   ^   \        Hi! I'm Cody 🐹
+    (      u      )        Your smart coding companion.
+     |  \ ___ /  |
+      '--w---w--'
 
-```bash
-# Universal: clone once, copy to any platform
-git clone https://github.com/tody-agent/codymaster.git ~/.cody-master
-
-# Then drop skills into your platform's directory:
-cp -r ~/.cody-master/skills/* .cursor/skills/
-cp -r ~/.cody-master/skills/* .cline/skills/
-cp -r ~/.cody-master/skills/* .kiro/steering/
-cp -r ~/.cody-master/skills/* .opencode/skills/
-cp -r ~/.cody-master/skills/* ~/.gemini/antigravity/skills/
-
-# GitHub Copilot: add to copilot-instructions.md
-cat ~/.cody-master/AGENTS.md >> .github/copilot-instructions.md
+│
+◆  Quick menu
+│  ● 📊  Dashboard (Start & open)
+│  ○ 📋  My Tasks
+│  ○ 📈 Status
+│  ○ 🧩  Browse Skills
 ```
 
 </details>
 
 ---
 
-## 🧰 The 34-Skill Arsenal
+## 🧰 The 35-Skill Arsenal
 
 | Domain                    | Skills                                                                                                                                                          |
 | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | 🔧**Engineering**   | `cm-tdd` `cm-debugging` `cm-quality-gate` `cm-test-gate` `cm-code-review`                                                                             |
-| ⚙️**Operations**  | `cm-safe-deploy` `cm-identity-guard` `cm-secret-shield` `cm-git-worktrees` `cm-terminal` `cm-safe-i18n`                                             |
+| ⚙️**Operations**  | `cm-safe-deploy` `cm-identity-guard` `cm-secret-shield` `cm-security-gate` `cm-git-worktrees` `cm-terminal` `cm-safe-i18n`                                             |
 | 🎨**Product & UX**  | `cm-planning` `cm-design-system` `cm-ux-master` `cm-ui-preview` `cm-project-bootstrap` `cm-jtbd` `cm-brainstorm-idea` `cm-dockit` `cm-readit` |
 | 📈**Growth/CRO**    | `cm-content-factory` `cm-ads-tracker` `cro-methodology`                                                                                                   |
-| 🎯**Orchestration** | `cm-execution` `cm-continuity` `cm-skill-chain` `cm-skill-mastery` `cm-skill-index` `cm-deep-search` `cm-how-it-work`                             |
+| 🎯**Orchestration** | `cm-execution` `cm-continuity` `cm-skill-chain` `cm-skill-mastery` `cm-skill-index` `cm-deep-search` `cm-how-it-work` `cm-notebooklm`             |
 | 🖥️**Workflow**    | `cm-start` `cm-dashboard` `cm-status`                                                                                                                     |
 
 ---
@@ -304,7 +274,7 @@ cm task add "..." → Add a task
 cm task list      → View tasks
 cm status         → Project health
 cm dashboard      → Open Mission Control
-cm list           → Browse 34 skills
+cm list           → Browse 35 skills
 cm profile        → Your stats & achievements
 cm deploy <env>   → Record deployment
 ```
@@ -325,7 +295,7 @@ cm deploy <env>   → Record deployment
 
 **Tody Le** — Head of Product with 10+ years of experience. Can't write code. Used AI to build real products for 6 months straight. Every skill in this kit was born from a real failure that cost real time and real tears.
 
-> *"34 skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights."*
+> *"35 skills. Each skill is a lesson. Each lesson is a sleepless night. And now, you don't have to go through those nights."*
 
 📖 [Read the full story →](https://cody.todyle.com/story)