@gotza02/sequential-thinking 1.0.0 → 1.0.1

package/README.md

@@ -1,262 +1,168 @@
-# Sequential Thinking MCP Server
+# Sequential Thinking MCP Server (Extended Edition) 🧠✨
 
-MCP Server นี้ถูกออกแบบมาเพื่อช่วยให้ AI สามารถคิดวิเคราะห์แก้ปัญหาได้อย่างเป็นระบบ (Sequential Thinking) ผ่านกระบวนการคิดแบบทีละขั้นตอน (Step-by-step), การแตกแขนงความคิด (Tree of Thoughts) และการทบทวนตัวเอง (Self-Reflexion)
+**MCP Server ที่ช่วยให้ AI "คิดก่อนทำ" อย่างเป็นระบบ พร้อมความสามารถในการค้นหาเว็บ, วิเคราะห์โค้ด และจดจำข้อมูลระยะยาว**
 
-## ฟีเจอร์หลัก (Features)
+โปรเจกต์นี้คือส่วนขยายของ Sequential Thinking ที่เพิ่มเครื่องมือสำคัญเพื่อให้ AI ทำงานเป็น "Autonomous Agent" ได้อย่างสมบูรณ์แบบ ทั้งการวางแผน (Planning), การหาข้อมูล (Research), และการลงมือทำ (Execution)
 
-- **การวิเคราะห์ตามลำดับ (Sequential Analysis)**: ย่อยปัญหาที่ซับซ้อนให้เป็นขั้นตอนย่อยๆ ที่จัดการได้ง่าย
-- **การให้เหตุผลแบบวนซ้ำ (Iterative Reasoning)**: คิดทีละขั้นตอนอย่างมีโครงสร้าง และปรับปรุงผลลัพธ์ผ่านการวนรอบ
-- **แตกแขนงความคิด (Tree of Thoughts)**: สร้างและประเมินทางเลือกหลายๆ ทาง (เช่น กลยุทธ์แบบระมัดระวัง, แบบสมดุล, หรือแบบกล้าเสี่ยง)
-- **การวิจารณ์ตัวเอง (Self-Critique)**: ตรวจสอบความเสี่ยง ข้อผิดพลาด และอคติในกระบวนการคิดอย่างสม่ำเสมอ
-- **รวมความคิด (Branch Merging)**: สังเคราะห์และรวบรวมข้อมูลเชิงลึกจากเส้นทางการคิดที่แตกต่างกัน
-- **การทดสอบสมมติฐาน (Hypothesis Testing)**: ตั้งสมมติฐานและตรวจสอบความถูกต้องด้วยหลักฐานหรือตรรกะ
-- **ประเมินทางเลือก (Option Evaluation)**: ให้คะแนนและชั่งน้ำหนักทางเลือกต่างๆ (`evaluation`) เพื่อช่วยตัดสินใจ
-- **ทบทวนตัวเอง (Self-Reflexion)**: ย้อนกลับไปแก้ไขความคิดก่อนหน้า (`reflexion`) เพื่อปรับปรุงความแม่นยำ
-- **ปรับเปลี่ยนแบบไดนามิก (Dynamic Adjustment)**: ปรับจำนวนขั้นตอนการคิดเพิ่มหรือลดได้ตามความเหมาะสมของสถานการณ์
+---
 
-## คำแนะนำระบบสำหรับ AI (System Instruction)
+## 🔑 Environment Variables (การตั้งค่าตัวแปร)
 
-เมื่อเชื่อมต่อกับ Server นี้ AI ควรปฏิบัติตามแนวทางต่อไปนี้เพื่อให้แก้ปัญหาได้ดีที่สุด:
+นี่คือตัวแปรทั้งหมดที่ระบบรองรับ คุณสามารถเลือกตั้งค่าได้ตามฟีเจอร์ที่ต้องการใช้งาน:
 
-1.  **การคิดแบบวนซ้ำ (Iterative Thinking)**: ใช้เครื่องมือ `sequentialthinking` สำหรับงานที่ซับซ้อน **อย่า** พยายามตอบทันที ให้แตกปัญหาเป็นขั้นตอน ตั้งสมมติฐาน และประเมินผล
-2.  **สำรวจบริบท (Context Discovery)**: ก่อนแก้ไขโค้ด ให้ใช้ `build_project_graph` ตามด้วย `get_project_graph_summary` เพื่อเข้าใจโครงสร้างโปรเจกต์เสมอ และใช้ `get_file_relationships` เพื่อดูความสัมพันธ์ของไฟล์
-3.  **ตรวจสอบข้อเท็จจริง (Fact Verification)**: ใช้ `web_search` เพื่อตรวจสอบข้อมูลล่าสุด, เวอร์ชั่นของ Library หรือเอกสาร และใช้ `fetch` เพื่อดึงข้อมูลดิบเมื่อจำเป็น
-4.  **รันคำสั่ง (Local Execution)**: ใช้ `shell_execute` เพื่อรัน Test, Linter หรือ Build เพื่อตรวจสอบความถูกต้องของการแก้ไข อ่านไฟล์ด้วย `read_file` ก่อนเขียนทับเสมอ
-5.  **ความต่อเนื่อง (Persistence)**: กระบวนการคิดจะถูกบันทึกอัตโนมัติ หากทำงานค้างไว้ สามารถย้อนกลับมาดูไฟล์ `thoughts_history.json` ได้
+### 1. Web Search APIs (เลือกอย่างน้อย 1 อย่างเพื่อใช้ `web_search`)
+| 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) |
 
-## คู่มือการใช้งานเครื่องมือ (Detailed Tool Guide)
+### 2. Storage & Memory (การจัดเก็บข้อมูล)
+| Variable Name | Description | Default Value |
+|--------------|-------------|---------------|
+| `THOUGHTS_STORAGE_PATH` | ไฟล์เก็บประวัติการคิด (Thinking History) | `thoughts_history.json` |
+| `NOTES_STORAGE_PATH` | ไฟล์เก็บความจำระยะยาว (Long-term Notes) | `project_notes.json` |
 
-### 🧠 เครื่องมือช่วยคิด (Cognitive Tools)
+### 3. System Behavior (พฤติกรรมระบบ)
+| Variable Name | Description | Default Value |
+|--------------|-------------|---------------|
+| `THOUGHT_DELAY_MS` | เวลาหน่วงระหว่างความคิด (ms) เพื่อกัน Rate Limit | `0` |
+| `DISABLE_THOUGHT_LOGGING`| ปิดการแสดงผล Log สีสวยงามใน Console (`true`/`false`) | `false` |
 
-#### `sequentialthinking`
-หัวใจหลักสำหรับการแก้ปัญหาอย่างมีโครงสร้าง บังคับให้คิดวิเคราะห์ทีละขั้นตอนก่อนจะสรุปผล
+---
 
-**Inputs:**
-- `thought` (string, required): เนื้อหาของความคิดในขั้นตอนนี้
-- `thoughtNumber` (integer, required): ลำดับขั้นตอนปัจจุบัน (เริ่มที่ 1)
-- `totalThoughts` (integer, required): จำนวนขั้นตอนที่คาดว่าจะใช้ (ปรับเปลี่ยนได้ตลอด)
-- `nextThoughtNeeded` (boolean, required): `true` ถ้าต้องคิดต่อ, `false` เมื่อได้คำตอบสุดท้ายแล้ว
-- `thoughtType` (enum): ประเภทของความคิด:
-  - `analysis`: วิเคราะห์แยกแยะปัญหา
-  - `generation`: ระดมสมองหาทางออก
-  - `evaluation`: ประเมินทางเลือก (ใช้คู่กับ `score`)
-  - `reflexion`: ทบทวนความคิดก่อนหน้า (ใช้คู่กับ `isRevision`)
-  - `selection`: เลือกเส้นทางที่จะไปต่อ
-- `isRevision` (boolean): `true` ถ้ากำลังแก้ไขข้อผิดพลาดก่อนหน้า
-- `revisesThought` (integer): ระบุหมายเลขขั้นตอนที่กำลังแก้ไข
-- `branchFromThought` (integer): หมายเลขขั้นตอนแม่ ถ้าต้องการแตกกิ่งความคิดใหม่
-- `branchId` (string): ชื่อระบุของกิ่งความคิดนั้น (Branch ID)
+## 🚀 Installation & Usage (การติดตั้งและใช้งาน)
 
-**ข้อแนะนำ:** ใช้เครื่องมือนี้กับงานทุกอย่างที่ไม่ใช่คำถามพื้นฐาน อย่าเพิ่งรีบตอบ ให้คิดก่อน
+รองรับทั้ง **Gemini CLI** และ **Claude Desktop**
 
-#### `clear_thought_history`
-ล้างประวัติการคิดทั้งหมด ใช้เมื่อต้องการเริ่มงานใหม่หรือเคลียร์ Context
-
-#### `summarize_history`
-ย่อรวมความคิดหลายๆ ขั้นตอนให้เป็นสรุปเดียว จำเป็นมากสำหรับการคิดที่ยาวนาน เพื่อประหยัด Token
-
-**Inputs:**
-- `startIndex` (integer): จุดเริ่มต้นที่จะสรุป
-- `endIndex` (integer): จุดสิ้นสุดที่จะสรุป
-- `summary` (string): ข้อความสรุป
-
-### 🌐 ความรู้ภายนอก (External Knowledge)
-
-#### `web_search`
-ค้นหาข้อมูลแบบ Real-time จากอินเทอร์เน็ต
-
-**Inputs:**
-- `query` (string, required): คำค้นหา
-- `provider` (enum, optional):
-  - `brave`: ค้นหาเว็บทั่วไป (ต้องมี `BRAVE_API_KEY`)
-  - `exa`: ค้นหาเชิงลึกด้วย AI (ต้องมี `EXA_API_KEY`)
-  - `google`: Google Custom Search (ต้องมี `GOOGLE_SEARCH_API_KEY` & `GOOGLE_SEARCH_CX`)
-
-#### `fetch`
-ดึงข้อมูล HTTP Request จาก URL โดยตรง มีประโยชน์มากสำหรับดึง HTML, JSON หรือ Text จากแหล่งข้อมูลที่เจอผ่าน Search
-
-**Inputs:**
-- `url` (string, required): URL เป้าหมาย
-- `method`: `GET` (default), `POST`, `PUT`, `DELETE`
-- `headers`: JSON Object สำหรับ Headers
-- `body`: Request Body สำหรับ POST/PUT
-
-#### `read_webpage`
-อ่านหน้าเว็บและแปลงเป็น Markdown ที่สะอาด (ตัดโฆษณาและเมนูออก) เหมาะสำหรับอ่านบทความหรือ Document เพื่อประหยัด Token
-
-**Inputs:**
-- `url` (string, required): URL ที่จะอ่าน
-
-### 🏗 ความฉลาดด้านโค้ด (Codebase Intelligence)
-
-#### `build_project_graph`
-**รันคำสั่งนี้เป็นอันดับแรก** เมื่อเริ่มโปรเจกต์ใหม่ มันจะสแกนโฟลเดอร์และสร้างแผนผังความสัมพันธ์ (Dependency Graph) โดยใช้ TypeScript AST Analysis รวมถึงดึงข้อมูล **Exported Symbols** (Functions, Classes, Variables) ออกมาด้วย
-
-**Inputs:**
-- `path` (string, optional): โฟลเดอร์ราก (Default คือ `.`)
-
-#### `get_project_graph_summary`
-ดูภาพรวมโครงสร้างโปรเจกต์และไฟล์ที่ถูกอ้างอิงถึงบ่อยที่สุด
-
-#### `get_project_graph_visualization`
-สร้าง Mermaid Diagram String แสดงความสัมพันธ์ของไฟล์ในโปรเจกต์ สามารถนำไปแสดงผลใน Markdown Viewer ได้
-
-### 🛠 การจัดการระบบ (System Operations)
-
-#### `read_file`
-อ่านเนื้อหาไฟล์ **ควรอ่านไฟล์ก่อนแก้ไขเสมอ**
-
-**Inputs:**
-- `path` (string, required): Path ของไฟล์
-
-#### `write_file`
-สร้างหรือเขียนทับไฟล์
-
-**Inputs:**
-- `path` (string, required): Path ของไฟล์
-- `content` (string, required): เนื้อหาที่จะเขียน
-
-#### `edit_file`
-แก้ไขข้อความบางส่วนในไฟล์ (Search & Replace) เหมาะสำหรับการแก้ไขจุดเล็กๆ โดยไม่ต้องเขียนทับทั้งไฟล์
-
-**Inputs:**
-- `path` (string, required): Path ของไฟล์
-- `oldText` (string, required): ข้อความเดิมที่ต้องการเปลี่ยน (ต้องตรงเป๊ะ)
-- `newText` (string, required): ข้อความใหม่
-- `allowMultiple` (boolean, optional): อนุญาตให้เปลี่ยนหลายจุดพร้อมกัน (Default: false)
-
-#### `manage_notes`
-จัดการความจำระยะยาว (Long-term Memory) / บันทึกช่วยจำ ใช้เก็บข้อมูลสำคัญ กฎ หรือสิ่งที่เรียนรู้เพื่อให้จำได้ข้าม Session
-
-**Inputs:**
-- `action` (enum, required): 'add', 'list', 'search', 'update', 'delete'
-- `title` (string): หัวข้อ
-- `content` (string): เนื้อหา
-- `tags` (array): แท็กจัดหมวดหมู่
-- `searchQuery` (string): คำค้นหา (สำหรับ action: search)
-- `noteId` (string): ID ของโน้ต (สำหรับ update/delete)
-
-#### `shell_execute`
-รันคำสั่ง Shell (เช่น `npm test`, `npm run build`, `ls`)
-**คำเตือน:** ใช้ด้วยความระมัดระวัง หลีกเลี่ยงคำสั่งที่ลบข้อมูลหรือเปิดเผยความลับ
-
-## การตั้งค่าและการใช้งาน (Installation & Usage)
-
-### 1. การใช้งานกับ Gemini CLI (Usage with Gemini CLI)
+### Option A: ใช้งานผ่าน npx (แนะนำสำหรับผู้ใช้ทั่วไป)
+*ไม่ต้องโหลดโค้ด แค่แก้ Config แล้วใช้งานได้เลย*
 
+#### 1. สำหรับ Gemini CLI
 แก้ไขไฟล์ `~/.gemini/settings.json` (หรือ `config.json`):
 
-#### แบบใช้ npx (ไม่ต้องติดตั้ง)
-
 ```json
 {
   "mcpServers": {
     "smartagent": {
       "command": "npx",
-      "args": [
-        "-y",
-        "@gotza02/sequential-thinking"
-      ],
+      "args": ["-y", "@gotza02/sequential-thinking"],
       "env": {
-        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY",
-        "EXA_API_KEY": "YOUR_EXA_API_KEY"
-      }
-    }
-  }
-}
-```
-
-#### แบบติดตั้ง Local (Node.js)
-
-1. Clone Repository นี้มา
-2. รัน `npm install` และ `npm run build`
-3. ตั้งค่าใน `settings.json`:
-
-```json
-{
-  "mcpServers": {
-    "smartagent": {
-      "command": "node",
-      "args": [
-        "/path/to/your/MCP3/dist/index.js"
-      ],
-      "env": {
-        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY",
-        "THOUGHTS_STORAGE_PATH": "thoughts_history.json",
-        "NOTES_STORAGE_PATH": "project_notes.json"
+        "BRAVE_API_KEY": "YOUR_KEY_HERE",
+        "THOUGHTS_STORAGE_PATH": "/absolute/path/to/thoughts_history.json",
+        "NOTES_STORAGE_PATH": "/absolute/path/to/project_notes.json"
       }
     }
   }
 }
 ```
 
-### 2. การใช้งานกับ Claude Desktop (Usage with Claude Desktop)
-
+#### 2. สำหรับ Claude Desktop
 แก้ไขไฟล์ `claude_desktop_config.json`:
 
-#### แบบใช้ npx (ไม่ต้องติดตั้ง)
-
 ```json
 {
   "mcpServers": {
     "sequential-thinking": {
       "command": "npx",
-      "args": [
-        "-y",
-        "@gotza02/sequential-thinking"
-      ],
+      "args": ["-y", "@gotza02/sequential-thinking"],
       "env": {
-        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY"
+        "BRAVE_API_KEY": "YOUR_KEY_HERE"
       }
     }
   }
 }
 ```
 
-#### แบบติดตั้ง Local (Node.js)
-
-```json
-{
-  "mcpServers": {
-    "sequential-thinking": {
-      "command": "node",
-      "args": [
-        "/absolute/path/to/MCP3/dist/index.js"
-      ],
-      "env": {
-        "BRAVE_API_KEY": "YOUR_BRAVE_API_KEY",
-        "THOUGHTS_STORAGE_PATH": "/absolute/path/to/thoughts_history.json",
-        "NOTES_STORAGE_PATH": "/absolute/path/to/project_notes.json"
-      }
-    }
-  }
-}
+---
+
+### Option B: ใช้งานแบบ Local Source (สำหรับนักพัฒนา)
+*สำหรับคนที่ต้องการแก้ไขโค้ด หรือรันจากเครื่องตัวเอง*
+
+1. **Clone & Build:**
+   ```bash
+   git clone <repo_url>
+   cd sequential-thinking
+   npm install
+   npm run build
+   ```
+
+2. **ตั้งค่า Config (ตัวอย่างสำหรับ Gemini CLI):**
+   *เปลี่ยน Path ให้ตรงกับที่อยู่ไฟล์ในเครื่องคุณ*
+
+   ```json
+   {
+     "mcpServers": {
+       "smartagent": {
+         "command": "node",
+         "args": ["/Users/username/projects/sequential-thinking/dist/index.js"],
+         "env": {
+           "BRAVE_API_KEY": "YOUR_KEY_HERE",
+           "THOUGHTS_STORAGE_PATH": "thoughts_history.json",
+           "NOTES_STORAGE_PATH": "project_notes.json"
+         }
+       }
+     }
+   }
+   ```
+
+---
+
+## 🛠️ Tools Capability (ความสามารถเครื่องมือ)
+
+### 🧠 1. Cognitive Tools (สมองและการคิด)
+*   **`sequentialthinking`**: เครื่องมือหลัก! ช่วยแตกปัญหาใหญ่เป็นขั้นตอนย่อย (Step-by-step), แตกกิ่งความคิด (Branching), และทบทวนตัวเอง (Reflexion)
+*   **`summarize_history`**: ย่อสรุปประวัติการคิดที่ยาวเหยียดให้สั้นลง
+*   **`clear_thought_history`**: ล้างสมอง เริ่มต้นคิดเรื่องใหม่
+
+### 🌐 2. Web Capabilities (การเข้าถึงอินเทอร์เน็ต)
+*   **`web_search`**: ค้นหาข้อมูลล่าสุด (รองรับ Brave, Exa, Google)
+*   **`read_webpage`**: อ่านเนื้อหาในเว็บแบบ Markdown (ตัดโฆษณาออกให้อัตโนมัติ)
+*   **`fetch`**: ดึงข้อมูล Raw JSON/HTML จาก API
+
+### 🏗️ 3. Codebase Intelligence (ความเข้าใจโค้ด)
+*   **`build_project_graph`**: สแกนโปรเจกต์เพื่อสร้างแผนผังความสัมพันธ์ (Dependency Graph)
+*   **`get_file_relationships`**: ดูว่าไฟล์นี้ถูกใครเรียกใช้บ้าง (ป้องกันการแก้แล้วพัง)
+*   **`search_code`**: ค้นหาโค้ดทั้งโปรเจกต์แบบฉลาด
+
+### 📝 4. Long-term Memory (ความจำระยะยาว)
+*   **`manage_notes`**: บันทึก/อ่าน/แก้ไข ข้อความที่ต้องการให้ AI จำได้ข้าม Session (เช่น กฎของโปรเจกต์, ความชอบของผู้ใช้)
+
+### 💻 5. System Operations (จัดการระบบ)
+*   **`read_file`**: อ่านไฟล์ (ต้องทำก่อนแก้ไฟล์เสมอ)
+*   **`edit_file`**: แก้ไขไฟล์เฉพาะจุด (Search & Replace) ปลอดภัยกว่าเขียนทับ
+*   **`write_file`**: สร้างไฟล์ใหม่ หรือเขียนทับทั้งไฟล์
+*   **`shell_execute`**: รันคำสั่ง Terminal (เช่น `npm test`, `git status`)
+
+---
+
+## 🤖 Recommended System Instruction
+
+เพื่อประสิทธิภาพสูงสุด ควรเพิ่มคำสั่งนี้ลงใน System Prompt ของ AI:
+
+```text
+You are an advanced AI Engineer.
+1. CORE RULE: For any complex task, you MUST start with the `sequentialthinking` tool. Do not answer immediately. Plan first.
+2. CODEBASE: Always run `build_project_graph` when entering a new project to understand the structure.
+3. SAFETY: Always `read_file` before you edit. Use `edit_file` for small changes.
+4. MEMORY: Use `manage_notes` to save important context that should persist.
 ```
 
-## การ Build และ Test
+---
+
+## 📦 Development
 
 ```bash
+# Install dependencies
 npm install
+
+# Build the project
 npm run build
-```
 
-```bash
+# Run tests
 npm test
 ```
 
-## ประวัติการอัปเดต (Recent Updates)
-
-### v1.0.0 (Major Release)
-- **First Stable Release**: เปิดตัวเวอร์ชั่นเสถียร 1.0.0 พร้อมเอกสารภาษาไทยสมบูรณ์
-- **Features Complete**: รวมฟีเจอร์ Sequential Thinking, Web Search, File System, Graph Analysis และ Memory ไว้ครบถ้วน
-
-### v2026.2.0 (Refactoring)
-- **Refactoring**: ปรับโครงสร้างโค้ดครั้งใหญ่ แยกการทำงานเป็นโมดูล (`src/tools/`) เพื่อให้อ่านง่ายและรองรับการขยายตัวในอนาคต
-
-### v2026.1.31
-- **New Tools**:
-  - `manage_notes`: ระบบความจำระยะยาวสำหรับเก็บข้อมูลข้าม Session
-
 ## License
-
-MIT License
+MIT

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotza02/sequential-thinking",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "publishConfig": {
     "access": "public"
   },
@@ -46,4 +46,4 @@
     "shx": "^0.3.4",
     "vitest": "^2.1.8"
   }
-}
+}