Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
84 changes: 84 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,90 @@ All notable changes to the PostgreSQL Explorer extension will be documented in t
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.5.4] - 2025-12-13

### Rebranding
- **Project Renamed**: The extension is now **PgStudio**! (formerly "YAPE" / "PostgreSQL Explorer").
- Updated all documentation and UI references to reflect the new professional identity.

### Added
- **Dashboard Visuals**: Added "glow" and "blur" effects to dashboard charts for a modern, premium look.
- **Improved Markdown in Chat**: SQL Assistant now renders rich Markdown tables and syntax highlighting correctly.

### Improved
- **Notebook UX**: The "Open in Notebook" button now provides clearer feedback when no notebook is active.
- **Documentation**: Comprehensive updates to README and Marketplace page.

## [0.5.3] - 2025-12-07

### Fixed
- Minor bug fixes and stability improvements
- Fixed linting errors and type issues across command files

---

## [0.5.2] - 2025-12-06

### Changed
- **SQL Template Refactoring**: Extracted embedded SQL from TypeScript command files into dedicated template modules
- Created `src/commands/sql/` directory with 13 specialized SQL template modules
- Modules: columns, constraints, extensions, foreignTables, functions, indexes, materializedViews, schema, tables, types, usersRoles, views
- Improved code maintainability and separation of concerns

---

## [0.5.1] - 2025-12-05

### Changed
- **Helper Abstractions Refactoring**: Refactored command files to use `getDatabaseConnection` and `NotebookBuilder` methods
- Updated `tables.ts`, `database.ts`, and `aiAssist.ts` to use new helper abstractions
- Improved code reusability and consistency across commands

---

## [0.5.0] - 2025-12-05

### Added
- **Enhanced Table Renderer**: New `renderer_v2.ts` with improved table output styling
- **Export Data Functionality**: Export query results to CSV, JSON, and Excel formats
- **Column Operations**: Enhanced column context menu with copy, scripts, and statistics
- **Constraint Operations**: Enhanced constraint management with validation and dependencies
- **Index Operations**: Enhanced index management with usage analysis and maintenance scripts

### Fixed
- Fixed persistent renderer cache issues
- Fixed excessive row height in table output
- Fixed chart initialization in dashboard

---

## [0.4.0] - 2025-12-03

### Added
- **Inline Create Buttons**: Added "+" buttons for creating objects directly from category nodes
- Tables, Views, Functions, Types, Materialized Views, Foreign Tables, Roles, Extensions, Schemas, Databases
- **Enhanced Script Generation**: Improved CREATE script generation for indexes
- **Column Context Menu**: Added comprehensive column operations menu

### Fixed
- Fixed connection UI button functionality
- Fixed index creation script visibility in context menu

---

## [0.3.0] - 2025-12-01

### Added
- **Comprehensive Test Coverage**: Added unit tests for NotebookKernel with improved coverage
- **Serialization Error Handling**: Improved handling of serialization errors in query results

### Changed
- Improved dashboard UI with pastel colors and modern styling
- Enhanced chart visualizations with area charts and translucent effects
- Fixed Cancel and Kill buttons in active queries table

---

## [0.2.3] - 2025-11-29

### Added
Expand Down
23 changes: 20 additions & 3 deletions MARKETPLACE.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
<div align="center">

# 🐘 PostgreSQL Explorer
# 🐘 PgStudio

### *Professional Database Management for VS Code*

**A comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations—all within VS Code.**
**PgStudio is a comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations—all within VS Code.**

</div>

Expand Down Expand Up @@ -41,10 +41,11 @@
| 🛠️ **Object Operations** | Full CRUD operations, scripts, VACUUM, ANALYZE, REINDEX |
| 🤖 **AI-Powered** | GitHub Copilot, OpenAI, Anthropic, and Google Gemini integration |
| ⌨️ **Developer Tools** | IntelliSense, keyboard shortcuts, PSQL terminal access |
| 📤 **Export Data** | Export query results to CSV, JSON, or Excel formats |

---

## 🎯 Why PostgreSQL Explorer?
## 🎯 Why PgStudio?

<table>
<tr>
Expand Down Expand Up @@ -121,11 +122,27 @@ Leverage AI to write, optimize, and debug your queries faster:
- **Error Detection** — Real-time syntax and logical error detection
- **Natural Language to SQL** — Describe what you need, let AI write the SQL

### 🛡️ Safe AI Execution
PgStudio provides a **Safe Execution Model** for AI interactions.
- **Human-in-the-Loop**: AI generates the code, but it is **never executed automatically**. You review it in a notebook cell first.
- **Context Control**: You decide which tables the AI can see.

**Supported AI Providers:**
- GitHub Copilot (VS Code LM)
- OpenAI
- Anthropic Claude
- Google Gemini

---

## 🎨 Rich Data Visualization

Transform your data into insights without exporting to Excel.

### Instantly Visualize Results
- **One-Click Charts**: Create Bar, Line, Area, and Pie charts from any query result.
- **Customizable**: Adjust log scales, use varied point styles, and control fill opacity.
- **Modern VFX**: Enable **Glow** and **Blur** effects for stunning, dashboard-ready visuals.
- Custom Endpoints

---
Expand Down
71 changes: 69 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<div align="center">

# 🐘 PostgreSQL Explorer
# 🐘 PgStudio

### *Professional Database Management for VS Code*

Expand All @@ -9,7 +9,7 @@
[![Rating](https://img.shields.io/visual-studio-marketplace/r/ric-v.postgres-explorer?style=for-the-badge&logo=visual-studio-code&logoColor=white&color=F39C12)](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer)
[![Status](https://img.shields.io/badge/status-beta-blue?style=for-the-badge&logo=git&logoColor=white)](https://github.com/dev-asterix/yape)

A comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations—all within VS Code.
**PgStudio** (formerly YAPE) is a comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations—all within VS Code.

[📖 **Documentation**](https://dev-asterix.github.io/yape/) • [🛒 **Marketplace**](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer) • [🤝 **Contributing**](#-contributing)

Expand All @@ -31,6 +31,34 @@ A comprehensive PostgreSQL database management extension featuring interactive S
- 🌳 **Database Explorer** — Browse tables, views, functions, types
- 🛠️ **Object Operations** — CRUD, scripts, VACUUM, ANALYZE, REINDEX
- 🤖 **AI-Powered** — GitHub Copilot, OpenAI, Anthropic, Gemini
- 📤 **Export Data** — Export results to CSV, JSON, or Excel

---

## 🎯 Why PgStudio?

<table>
<tr>
<td width="50%">

### 🎨 Modern Interface
- Beautiful, intuitive UI designed for developers
- Real-time dashboard with live metrics
- Context-aware operations
- Seamless VS Code integration

</td>
<td width="50%">

### ⚡ Powerful Features
- Interactive SQL notebooks
- 🤖 AI-powered Copilot & agentic support
- Advanced query management
- Complete CRUD operations

</td>
</tr>
</table>

---

Expand All @@ -46,6 +74,7 @@ code --install-extension ric-v.postgres-explorer

Then: **PostgreSQL icon** → **Add Connection** → Enter details → **Connect!**


---

## 🏗️ Project Structure
Expand All @@ -60,6 +89,13 @@ yape/
│ │ ├── functions.ts # Function operations
│ │ ├── connection.ts # Connection commands
│ │ ├── notebook.ts # Notebook commands
│ │ ├── helper.ts # Shared helper utilities
│ │ ├── sql/ # SQL template modules
│ │ │ ├── tables.ts # Table SQL templates
│ │ │ ├── views.ts # View SQL templates
│ │ │ ├── functions.ts # Function SQL templates
│ │ │ ├── indexes.ts # Index SQL templates
│ │ │ └── ... # Other SQL templates
│ │ └── ...
│ ├── providers/ # VS Code providers
│ │ ├── DatabaseTreeProvider.ts # Tree view provider
Expand All @@ -84,6 +120,37 @@ yape/

---

## 🤖 AI-Powered Operations

PgStudio integrates advanced AI capabilities directly into your workflow, but keeps **YOU** in control.

### Chat to Query (Natural Language → SQL)
Describe what you need in plain English, and PgStudio will generate the SQL for you.
- **Context-Aware**: The AI understands your table schemas and columns.
- **Smart Suggestions**: Ask for "top selling products" and it knows to join `orders` and `products`.

### 🛡️ Safe Execution Model (Notebook-First)
We believe AI should assist, not take over. **No query is ever executed automatically.**
1. **Ask**: You ask a question in the side panel.
2. **Review**: The AI generates SQL code.
3. **Insert**: You click "Open in Notebook" to place the code into a cell.
4. **Execute**: You review the code and click "Run" when you are ready.

---

## 📊 Advanced Visualizations

Turn any query result into beautiful, interactive charts in seconds.

- **One-Click Charting**: Instantly visualize your data directly from the notebook results.
- **Customizable**: Toggle between Bar, Line, Pie, Doughnut, and Scatter charts.
- **Rich Data Display**:
- **Log Scale**: Easily analyze data with wide variances.
- **Blur/Glow Effects**: Modern, high-fidelity chart aesthetics.
- **Zoom & Pan**: Inspect detailed data points interactively.

---

## 🛠️ Local Development

### Prerequisites
Expand Down
2 changes: 1 addition & 1 deletion docs/CNAME
Original file line number Diff line number Diff line change
@@ -1 +1 @@
pgstudio.astrx.dev
pgstudio.astrx.dev
40 changes: 32 additions & 8 deletions docs/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>PostgreSQL Explorer - Professional Database Management for VS Code</title>
<title>PgStudio - Professional Database Management for VS Code</title>
<meta name="description"
content="A comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations - all within VS Code.">
content="PgStudio is a comprehensive PostgreSQL database management extension featuring interactive SQL notebooks, real-time monitoring dashboard, AI-powered assistance, and advanced database operations - all within VS Code.">
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700;800&family=Fira+Code&display=swap"
Expand All @@ -26,8 +26,8 @@
<div class="logo">
<a href="#" style="text-decoration: none;"
onclick="window.scrollTo({top: 0, behavior: 'smooth'}); return false;">
&#x1F418; <span class="gradient-text">YAPE
<span style="font-size: 12px;">Yet Another Postgres Extension</span>
&#x1F418; <span class="gradient-text">PgStudio
<span style="font-size: 12px;">Professional Database Management</span>
</span>
</a>
</div>
Expand All @@ -51,7 +51,7 @@
<div class="badge-row">
<a href="https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer" class="badge">
<span class="badge-label">VS Code Marketplace</span>
<span class="badge-value" id="badge-version">0.4.0</span>
<span class="badge-value" id="badge-version">0.5.4</span>
</a>
</div>

Expand Down Expand Up @@ -251,7 +251,32 @@ <h3>Developer Tools</h3>
</ul>
</div>
</div>

<!-- New Feature Highlights Row -->
<div class="feature-grid" style="margin-top: 2rem; grid-template-columns: 1fr 1fr;">
<div class="card feature-card" style="border-color: var(--primary-color);">
<div class="card-icon">🛡️</div>
<h3>Safe AI Execution</h3>
<p>AI assists, but you stay in control. <strong>No auto-execution.</strong></p>
<ul class="feature-list">
<li>Chat-to-Notebook workflow</li>
<li>Review generated SQL before running</li>
<li>Edit parameters safely</li>
</ul>
</div>
<div class="card feature-card" style="border-color: var(--secondary-color);">
<div class="card-icon">📈</div>
<h3>Advanced Visualizations</h3>
<p>Turn query results into insights instantly.</p>
<ul class="feature-list">
<li>Bar, Line, Pie, Area charts</li>
<li>Log scale & Zoom support</li>
<li>Export charts as images</li>
</ul>
</div>
</div>
</div>

</section>

<!-- AI Powered Section -->
Expand Down Expand Up @@ -335,15 +360,14 @@ <h4>Schema Understanding</h4>
<div class="container">
<div class="footer-content">
<div class="footer-brand">
<span class="logo">🐘 <span class="gradient-text">YAPE</span></span>
<span class="logo">🐘 <span class="gradient-text">PgStudio</span></span>
<p>Professional PostgreSQL management for VS Code</p>
</div>
<div class="footer-links-grid">
<div class="footer-col">
<h4>Resources</h4>
<a href="https://github.com/dev-asterix/yape#readme">Documentation</a>
<a
href="https://github.com/dev-asterix/yape/blob/main/CHANGELOG.md">Changelog</a>
<a href="https://github.com/dev-asterix/yape/blob/main/CHANGELOG.md">Changelog</a>
</div>
<div class="footer-col">
<h4>Community</h4>
Expand Down
Loading