@gotza02/sequential-thinking 2026.2.13 → 2026.2.14

package/README.md

@@ -1,255 +1,76 @@
-# Sequential Thinking MCP Server (Extended Edition) 🧠✨
+# Sequential Thinking MCP (Extended) 🧠
 
-**MCP Server ที่ยกระดับ AI ให้เป็นวิศวกรซอฟต์แวร์อัจฉริยะ ด้วยระบบ Deepest Thinking, การวิเคราะห์ Codebase เชิงลึก และฐานข้อมูลความรู้ (Code Database)**
+Advanced MCP Server enabling AI to act as a Software Engineer with Deep Thinking, Codebase Graph Analysis, and Persistent Memory.
 
-> **🛡️ Battle-Tested:** ผ่านการทดสอบ **Chaos Engineering** และ **Stress Testing** รองรับโหลดหนักและกู้คืนตัวเองจากความเสียหายได้ (Auto-Repair)
+## ✨ Key Features
+- **Deep Thinking:** Step-by-step reasoning with auto-correction (Loop Breaker).
+- **Code Intelligence:** Dependency graph mapping (`build_project_graph`) & surgical code editing.
+- **Memory:** Long-term project notes, reusable code database, and thought history.
+- **Research:** Integrated Web search (Brave/Exa) & webpage reading.
 
-โปรเจกต์นี้คือส่วนขยายขั้นสูงของ Sequential Thinking ที่รวมเอาความสามารถในการวางแผนที่เป็นระบบ, การหาข้อมูลทั่วโลก (Web Search), การสร้างแผนผังความสัมพันธ์ของโค้ด (Dependency Graph), การจัดการหน่วยความจำระยะยาว และ **ฐานข้อมูลความรู้โค้ด (Code Database)** เข้าด้วยกัน เพื่อให้ AI สามารถทำงานที่ซับซ้อนได้อย่างอิสระและแม่นยำ
-
----
-
-## 🌟 จุดเด่นของเวอร์ชัน Extended
-
-1.  **Deepest Thinking Protocol**: บังคับให้ AI วิเคราะห์ปัญหาแบบเป็นลำดับขั้นตอน (Step-by-step) พร้อมการแตกกิ่งความคิด (Branching) และการทบทวนตัวเอง (Reflexion) เพื่อหาทางเลือกที่ดีที่สุด
-2.  **Codebase Intelligence**: ระบบ `ProjectKnowledgeGraph` ที่ใช้ TypeScript Compiler API และ Regex (สำหรับ Python/Go) ในการสแกนความสัมพันธ์ระหว่างไฟล์และ Exported Symbols
-3.  **Code Database (CodeStore)**: ระบบจัดเก็บ Snippets และ Architectural Patterns ลงในไฟล์ JSON ถาวร ช่วยให้ AI "จดจำ" วิธีแก้ปัญหาและนำกลับมาใช้ใหม่ได้
-4.  **Deep Coding Workflow**: เครื่องมือใหม่สำหรับการแก้ไขโค้ดที่ต้องผ่านการวิเคราะห์บริบท (Context Document) และการวางแผนที่ผ่านการตรวจสอบเหตุผลแล้วเท่านั้น
-5.  **Smart Notes**: ระบบบันทึกที่มี **Priority Level** และ **Expiration Date** ช่วยจัดลำดับความสำคัญของงานได้ดียิ่งขึ้น พร้อมฟีเจอร์ **Auto-Repair** กู้คืนไฟล์อัตโนมัติหากข้อมูลเสียหาย
-6.  **Security Sandbox**: ระบบป้องกันความปลอดภัยขั้นสูง บล็อกการเข้าถึง Local/Private Network (ครอบคลุม IPv4/IPv6) ป้องกันการโจมตีแบบ SSRF
-
----
-
-## 🚀 อัปเดตล่าสุด (Latest Enhancements)
-*   **Performance Boost**: ระบบ `build_project_graph` ทำงานแบบ Parallel เร็วขึ้นกว่าเดิม 3 เท่าตัวในโปรเจกต์ขนาดใหญ่
-*   **Deep Language Parsing**: ปรับปรุงการวิเคราะห์ภาษา **Python** และ **Go** ให้แม่นยำขึ้น รองรับ Relative Imports และ Exported Types
-*   **Rich Web Content**: เครื่องมือ `read_webpage` สามารถแปลง HTML Tables เป็น Markdown Tables ที่สวยงามได้แล้ว
-*   **Autonomous Recovery**: ระบบจัดการความคิด (`lib.ts`) มาพร้อม Mutex ป้องกัน Race Condition และระบบกู้คืนข้อมูลอัตโนมัติหากไฟล์ JSON เสียหาย
-
----
-
-## 🔑 Environment Variables (การตั้งค่าตัวแปร)
-
-| Variable Name | Description | Required? |
-|--------------|-------------|-----------|
-| `BRAVE_API_KEY` | สำหรับค้นหาผ่าน Brave Search | ❌ (Optional) |
-| `EXA_API_KEY` | สำหรับค้นหาผ่าน Exa.ai (แนะนำมากสำหรับงาน Deep Research) | ❌ (Optional) |
-| `GOOGLE_SEARCH_API_KEY` | Google Custom Search API Key | ❌ (Optional) |
-| `GOOGLE_SEARCH_CX` | Google Custom Search Engine ID (CX) | ❌ (Optional) |
-| `THOUGHTS_STORAGE_PATH` | ไฟล์เก็บประวัติความคิดเพื่อใช้ต่อเนื่อง | `thoughts_history.json` |
-| `NOTES_STORAGE_PATH` | ไฟล์เก็บความจำระยะยาว (กฎโปรเจกต์, ความชอบ) | `project_notes.json` |
-| `CODE_DB_PATH` | ไฟล์เก็บฐานข้อมูลความรู้โค้ด (Snippets/Patterns) | `code_database.json` |
-| `THOUGHT_DELAY_MS` | เวลาหน่วงระหว่างคิด (เพื่อความสมจริงและการจัดการ Rate Limit) | `0` |
-| `LOG_LEVEL` | ระดับการแสดงผล Log (debug, info, warn, error) | `info` |
-
----
-
-## 🛠️ รายการเครื่องมือ (Tools Capability)
-
-### 🧠 1. Cognitive & Deepest Thinking
-*   **`sequentialthinking`**: (ปรับปรุงใหม่!) บังคับใช้หลักการ **Deepest Thinking** รองรับการทำ Analysis, Reflexion, Evaluation และ Selection ในทุกการแก้ปัญหา
-*   **`summarize_history`**: สรุปประวัติความคิดที่ยาวเหยียดเพื่อประหยัดพื้นที่บริบท
-*   **`clear_thought_history`**: ล้างสมองเพื่อเริ่มงานชิ้นใหม่
-
-### 💻 2. Deep Coding & Codebase Context
-*   **`deep_code_analyze`**: 🌟 **(ใหม่)** สร้าง Codebase Context Document รวบรวมเนื้อหาไฟล์, Symbols และความสัมพันธ์ (Import/Export) เพื่อให้ AI "เรียนรู้" ก่อนแก้โค้ด
-*   **`deep_code_edit`**: 🌟 **(ใหม่)** แก้ไขโค้ดแบบ Surgical Edit โดยต้องระบุ `reasoning` (เหตุผลเชิงลึก) ที่ผ่านการคิดวิเคราะห์มาแล้ว
-*   **`build_project_graph`**: สแกนโปรเจกต์เพื่อสร้างแผนผังความสัมพันธ์ทั้งหมด (รองรับ TS, JS, PY, GO)
-*   **`get_file_relationships`**: ตรวจสอบว่าไฟล์เป้าหมายกระทบกับส่วนไหนของระบบบ้าง
-*   **`search_code`**: ค้นหา Code Pattern ทั้งโปรเจกต์แบบชาญฉลาด
-
-### 📚 3. Knowledge & Memory (CodeStore)
-*   **`add_code_snippet`**: 🌟 **(ใหม่)** บันทึก Snippet โค้ดที่ใช้งานบ่อยลงฐานข้อมูล
-*   **`search_code_db`**: 🌟 **(ใหม่)** ค้นหาความรู้เดิมจากฐานข้อมูล (ช่วยลดเวลาในการเริ่มงานใหม่)
-*   **`learn_architecture_pattern`**: 🌟 **(ใหม่)** บันทึกรูปแบบโครงสร้างของระบบ
-*   **`manage_notes`**: (ปรับปรุงใหม่!) จัดการบันทึกพร้อมระบุ **Priority** และ **Expiration**
-
-### 🌐 4. External Research
-*   **`web_search`**: ค้นหาข้อมูลล่าสุดจากโลกภายนอก (Brave/Exa/Google)
-*   **`read_webpage`**: อ่านเนื้อหาเว็บแปลงเป็น Markdown ที่สะอาดและเข้าใจง่าย
-*   **`fetch`**: ดึงข้อมูล Raw จาก API ต่างๆ
-
-### 📁 5. System & Persistence
-*   **`read_file` / `write_file` / `edit_file`**: จัดการไฟล์ในระบบ
-*   **`shell_execute`**: รันคำสั่ง Terminal (มีระบบป้องกันคำสั่งอันตราย เช่น `rm -rf /`)
-
----
-
-
-
-## 🚀 การติดตั้ง (Installation)
-
-
-
-คุณสามารถเลือกติดตั้งได้ 3 รูปแบบตามความสะดวกดังนี้:
-
-
-
-### 1. แบบ npx (ไม่ต้องติดตั้งลงเครื่องถาวร)
-
-วิธีที่ง่ายที่สุดและแนะนำสำหรับ AI Client ส่วนใหญ่:
+## 🚀 Quick Setup
 
+### 1. Installation
+**Option A: Run Temporarily (Recommended for testing)**
 ```bash
-
 npx -y @gotza02/sequential-thinking
-
 ```
 
-
-
-### 2. แบบ npm (ติดตั้งลงเครื่อง)
-
-เหมาะสำหรับผู้ที่ต้องการความเสถียรหรือใช้งานในสภาพแวดล้อมที่ไม่มีอินเทอร์เน็ตตลอดเวลา:
-
-
-
-*   **Global Installation (แนะนำ):**
-
-    ```bash
-
-npm install -g @gotza02/sequential-thinking
-
-    ```
-
-*   **Local Installation (ในโปรเจกต์):
-
-    ```bash
-
-npm install @gotza02/sequential-thinking
-
-    ```
-
-
-
-### 3. แบบจาก Source Code (Developer)
-
+**Option B: Install Globally**
 ```bash
-
-git clone https://github.com/gotza02/sequential-thinking.git && cd sequential-thinking && npm install && npm run build
-
-```
-
-
-
----
-
-
-
-## 🔍 วิธีค้นหา Path ที่ถูกต้อง (Path Discovery)
-
-
-
-หากคุณติดตั้งผ่าน `npm` และต้องการทราบว่าไฟล์ `index.js` อยู่ที่ไหนเพื่อนำไปใส่ใน AI Client:
-
-
-
-*   **กรณีติดตั้ง Global:**
-
-    ```bash
-
-# สำหรับ Linux/Android (Termux)
-
-echo "$(npm config get prefix)/lib/node_modules/@gotza02/sequential-thinking/dist/index.js"
-
-
-
-# สำหรับ Windows (PowerShell)
-
-echo "$env:APPDATA\npm\node_modules\@gotza02\sequential-thinking\dist\index.js"
-
-    ```
-
-*   **กรณีติดตั้ง Local:**
-
-    ```bash
-
-echo "$(pwd)/node_modules/@gotza02/sequential-thinking/dist/index.js"
-
-    ```
-
-
-
----
-
-
-
-## ⚙️ การตั้งค่าใน AI Client (Configuration Examples)
-
-
-
-### 1. การใช้ npx (ง่ายที่สุด)
-
-เหมาะสำหรับ **Gemini CLI** หรือ **Claude Desktop** ที่เชื่อมต่ออินเทอร์เน็ตได้:
-
-```json
-
-{
-
-  "command": "npx",
-
-  "args": ["-y", "@gotza02/sequential-thinking"]
-
-}
-
+npm install -g @gotza02/sequential-thinking
 ```
 
+### 2. Configuration (Gemini/Claude)
+Add this to your MCP settings (`~/.gemini/settings.json` or `claude_desktop_config.json`).
 
-
-### 2. การใช้ npm/Node (เสถียรกว่า)
-
-ต้องระบุ Path ที่หาได้จากขั้นตอน **Path Discovery** ด้านบน:
-
+**For npx usage:**
 ```json
-
 {
-
-  "command": "node",
-
-  "args": ["/ทาง/ไป/ยัง/node_modules/@gotza02/sequential-thinking/dist/index.js"]
-
+  "mcpServers": {
+    "smartagent": {
+      "command": "npx",
+      "args": ["-y", "@gotza02/sequential-thinking"],
+      "env": { "THOUGHTS_STORAGE_PATH": "thoughts.json" }
+    }
+  }
 }
-
 ```
 
-
-
-#### ตัวอย่างไฟล์ Config (Gemini CLI: `~/.gemini/settings.json`)
+**For npm usage:**
+*(Find path with: `npm root -g`)*
 ```json
 {
   "mcpServers": {
     "smartagent": {
-      "command": "npx",
-      "args": ["-y", "@gotza02/sequential-thinking"],
-      "env": {
-        "BRAVE_API_KEY": "YOUR_BRAVE_KEY",
-        "EXA_API_KEY": "YOUR_EXA_KEY",
-        "GOOGLE_SEARCH_API_KEY": "YOUR_GOOGLE_API_KEY",
-        "GOOGLE_SEARCH_CX": "YOUR_GOOGLE_SEARCH_ENGINE_ID",
-        "THOUGHTS_STORAGE_PATH": "thoughts_history.json",
-        "NOTES_STORAGE_PATH": "project_notes.json",
-        "CODE_DB_PATH": "code_database.json"
-      }
+      "command": "node",
+      "args": ["/PATH/TO/node_modules/@gotza02/sequential-thinking/dist/index.js"]
     }
   }
 }
 ```
 
-> **Note:** สำหรับ Google Search คุณจำเป็นต้องมีทั้ง **API Key** และ **Search Engine ID (CX)** ซึ่งสามารถสร้างได้จาก [Google Custom Search Engine](https://programmablesearchengine.google.com/)
-
----
-
-## 🛠️ ติดตั้งคำสั่งระบบ (System Instruction Setup)
-
-คุณสามารถติดตั้งคำสั่งระบบ **Ultimate Deep Engineer** ให้กับ Gemini และ Claude ได้โดยอัตโนมัติด้วย Script นี้:
-
-```bash
-chmod +x install-ultimate-engineer.sh && ./install-ultimate-engineer.sh
-```
+## 🔑 Environment Variables
+| Variable | Description |
+|----------|-------------|
+| `THOUGHTS_STORAGE_PATH` | Path to save thought history (Required) |
+| `NOTES_STORAGE_PATH` | Path to save project notes |
+| `CODE_DB_PATH` | Path to save code snippets |
+| `BRAVE_API_KEY` | Optional: For Brave Search |
+| `EXA_API_KEY` | Optional: For Exa.ai Search |
+
+## 🛠️ Tools Summary
+- **Thinking:** `sequentialthinking`, `summarize_history`, `clear_thought_history`
+- **Code:** `build_project_graph`, `deep_code_analyze`, `deep_code_edit`, `search_code`
+- **Memory:** `add_code_snippet`, `search_code_db`, `manage_notes`
+- **Web:** `web_search`, `read_webpage`, `fetch`
+- **System:** `read_file`, `write_file`, `edit_file`, `shell_execute`
 
 ---
 
 ## 🤖 Recommended System Instruction (The Ultimate Deep Engineer)
 
-ให้ Copy ข้อความด้านล่างนี้ไปใส่ใน **System Prompt** ของ AI Agent เพื่อประสิทธิภาพสูงสุด:
+Copy this into your AI's System Prompt to enable the Loop Breaker and Deep Thinking protocols:
 
 ```markdown
 # 🤖 System Instruction: Ultimate Deep Engineer (Sequential Thinking Extended)
@@ -261,20 +82,41 @@ You are a Senior AI Software Engineer equipped with the Sequential Thinking MCP
 - **Atomic Analysis:** Use `thoughtType: 'analysis'` to break every request into atomic requirements and constraints before proposing solutions.
 - **Mandatory Reflexion:** Use `thoughtType: 'reflexion'` frequently to critique your own logic, identify potential edge cases, and challenge your assumptions.
 - **Tree of Thoughts:** For critical architectural decisions, use branching to explore multiple paths (Conservative vs. Aggressive) and evaluate them using `thoughtType: 'evaluation'`.
-- **Loop Breaker:** If a bug persists after 2 attempts or reasoning loops, MUST create a new branch (`branchFromThought`) to change strategy completely.
+- **Loop Breaker (Auto-Correction):**
+  - **Self-Monitoring:** If you detect yourself repeating a failed strategy or stuck in a loop -> **STOP**.
+  - **Mandatory Branching:** You MUST create a new branch (`branchFromThought`) to explore a *radically different* approach.
+  - **Explicit Statement:** State "Stuck detected. Branching to Strategy B..." before proceeding.
 - **Verified Completion:** Only set `nextThoughtNeeded: false` when the solution is definitive, verified, and follows project standards.
 
-## 🏗 CODEBASE INTELLIGENCE PROTOCOL
-- **Map the Territory:** Run `build_project_graph` immediately upon entering a new project or after significant changes.
-- **Context is King:** Use `deep_code_analyze` before creating or editing any code. Never rely on partial file content; always understand the relationships (imports/exports).
-- **Dependency Awareness:** Use `get_file_relationships` to ensure your changes do not break downstream dependents.
+## 🛠️ TOOL USAGE TRIGGERS (Context-Action Mapping)
+**You MUST follow these explicit triggers:**
+
+1.  **Unknown/New Project Context:**
+    - **Trigger:** Start of session or new task.
+    - **Action:** `build_project_graph` -> `read_file` (README/config).
+    - **Goal:** Map the territory before moving.
+
+2.  **Coding/Refactoring Tasks:**
+    - **Trigger:** Request to write or edit code.
+    - **Action:** `deep_code_analyze` (on target files) -> `sequentialthinking` (Plan) -> `deep_code_edit` or `edit_file`.
+    - **Constraint:** NEVER edit code without reading the file and its related context first.
+
+3.  **Debugging/Error Fixing:**
+    - **Trigger:** User reports a bug or error.
+    - **Action:** `read_file` (logs/code) OR `diagnose_error_screenshot` -> `sequentialthinking` (Hypothesis) -> `codebase_investigator` (Verification).
+    - **Constraint:** Do not guess. Evidence first.
+
+4.  **Unknown Libraries/Docs:**
+    - **Trigger:** Need to use a specific library/tool you are unsure about.
+    - **Action:** `web_search` -> `read_webpage` or `get_code_context_exa`.
+    - **Constraint:** Do not hallucinate APIs.
 
 ## 💻 DEEP CODING WORKFLOW
-1. **Discovery:** `build_project_graph` -> Identify entry points and core logic.
-2. **Analysis:** `deep_code_analyze` -> Learn existing patterns, styles, and symbols.
-3. **Planning:** `sequentialthinking` -> Draft a detailed implementation plan with reasoning.
-4. **Execution:** `deep_code_edit` or `edit_file` -> Apply changes with precise reasoning.
-5. **Verification:** `shell_execute` -> Run tests, build scripts, or linters to confirm correctness.
+1.  **Discovery:** `build_project_graph` -> Identify entry points and core logic.
+2.  **Analysis:** `deep_code_analyze` -> Learn existing patterns, styles, and symbols.
+3.  **Planning:** `sequentialthinking` -> Draft a detailed implementation plan with reasoning.
+4.  **Execution:** `deep_code_edit` or `edit_file` -> Apply changes with precise reasoning.
+5.  **Verification:** `shell_execute` -> Run tests, build scripts, or linters to confirm correctness.
 
 ## 🛡 SAFETY & PRECISION
 - **Surgical Edits:** Prefer `edit_file` or `deep_code_edit` over `write_file` for existing files to minimize risk.
@@ -287,7 +129,5 @@ You are a Senior AI Software Engineer equipped with the Sequential Thinking MCP
 - **Session Continuity:** Your thought history is saved. If you restart, review the history to maintain context.
 ```
 
----
-
 ## License
-MIT - พัฒนาโดย @gotza02/sequential-thinking
+MIT - Developed by @gotza02/sequential-thinking

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotza02/sequential-thinking",
-  "version": "2026.2.13",
+  "version": "2026.2.14",
   "publishConfig": {
     "access": "public"
   },