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
78 changes: 38 additions & 40 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,15 +5,21 @@ 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).

---

## [1.0.0] - 2026-04-14

### Production Stable Release
### Production Stable Release

PgStudio v1.0.0 is a major milestone release with comprehensive stability improvements, security hardening, and production-ready tooling.

### 🛡️ Security & Stability
#### Added
- **DDL Viewer SQL Preview toggle**: Added user-facing toggle command and setting (`pgstudio.ddlViewer.enabled`) to quickly enable/disable definition preview actions.
- **Definition Viewer workflow actions**: Improved DDL viewer command surface for opening editable copies, copying SQL, and routine execution scaffolding.

#### Changed
- **Dashboard visual telemetry polish**: Enhanced dashboard styling with richer badges, status signals, and clearer performance insight presentation.
- **Nightly packaging metadata**: Aligned nightly channel metadata and version stream (`1.0.0-nightly`) for pre-release distribution.

### Security & Stability

#### Critical Fixes
- **Fixed TypeScript compilation errors** (P0 blockers):
Expand All @@ -40,15 +46,35 @@ PgStudio v1.0.0 is a major milestone release with comprehensive stability improv
- Threat model, existing controls, and verification checklist
- Release sign-off criteria for future versions

### 📚 Documentation & Release Materials
### Documentation & Release Materials

#### New User-Facing Docs
- **Release Notes** (`docs/RELEASE_NOTES_v1.0.0.md`): Features, stability guarantees, system requirements, known limitations
- **Migration Guide** (`docs/MIGRATION_GUIDE_0.x_to_1.0.0.md`): Upgrade path from 0.9.x with validation & troubleshooting
- **Updated README.md**: Added feature matrix (8 categories) and explicit known limitations section
- **Updated MARKETPLACE.md**: VSX marketplace copy with feature matrix and limitations

### 🧪 Test Coverage Expansion
#### PostgreSQL Object Coverage
- **New command suites** for additional object families:
- Aggregates, domains, event triggers, partitions, publications, rules, sequences, tablespaces, and triggers
- Extended SQL templates under `src/commands/sql/` for these object operations
- Expanded explorer/command palette workflows for more complete PostgreSQL administration

#### Schema & Modeling Tooling
- **Schema Search**: Added schema object discovery commands.
- **Index Advisor**: Introduced index recommendation workflow.
- **Migration Generator**: Added migration-oriented command workflow.
- **ERD and Import tooling**: Added dedicated panels for ERD exploration and import-data workflows.

#### Notebook, Renderer, and Query UX
- **Notebook management UX**: Improved notebook open/create picker workflows and metadata handling.
- **SQL formatting command/service**: Added formatter command path and supporting service.
- **Result renderer enhancements**: Added column stats, result tab strip, transpose view, filter bar upgrades, and richer cell editor support.

#### Operational Panels
- Added dedicated providers for **Activity Monitor**, **Column Profile**, **LISTEN/NOTIFY**, **Mock Data**, **Server Logs**, and **Snippets**.

### Test Coverage Expansion

#### New Test Files
- **FormatSqlCommand.test.ts** (45 lines): Unit tests for SQL formatting command layer
Expand All @@ -69,48 +95,20 @@ PgStudio v1.0.0 is a major milestone release with comprehensive stability improv
- New assertions: Degradation alert confidence (≥5 samples), Welford variance validation

#### Overall Coverage
- ✅ Utils phase: 100% lines, 90.12% branches
- 🟡 Handlers phase: 82.4% lines, 89.79% functions (0.21% below 90% threshold — acceptable for v1.0.0)
- ✅ 250+ unit tests across 57 test files — all passing
- ✅ Production build: Minified extension 1.0mb, renderer 298.2kb
- Utils phase: 100% lines, 90.12% branches
- Handlers phase: 82.4% lines, 89.79% functions (0.21% below 90% threshold — acceptable for v1.0.0)
- 250+ unit tests across 57 test files — all passing
- Production build: Minified extension 1.0mb, renderer 298.2kb
- Broadened unit coverage across command, provider, service, renderer, and handler layers (including formatter, dashboard HTML, and row/handler flows)

### 🎯 Quality Gates & Verification

#### Pre-Release Checklist ✅
- ✅ TypeScript strict compilation: 0 errors
- ✅ Security audit: PASS (no critical vulnerabilities)
- ✅ Full test suite: PASS (250+ tests)
- ✅ Utils coverage gates: PASS (100% lines, 90.12% branches)
- ✅ Production build: PASS (`npm run vscode:prepublish`)
- ✅ All documentation delivered

### 📋 Known Limitations (v1.0.0)

Documented in README.md and Release Notes:
- **In-grid editing**: Limited compared to desktop IDEs (improved UX planned for v1.1+)
- **Schema visualization**: ERD depth still maturing (scheduled enhancement)
- **Advanced replication**: Publication/subscription administration partial (v1.1+)

### 🔄 Version Compatibility
### Version Compatibility

- **Minimum VS Code**: 1.90.0
- **Node.js**: 18.0.0+
- **PostgreSQL**: 10.0+
- **SSL/TLS**: Full support with fallback options
- **SSH Tunneling**: Fully functional

### 🚀 Recommendations for v1.1.0+

1. **Test Coverage**: Add missing handler tests (FkLookupHandler, InsertRowHandler) for 100% coverage
2. **UI/UX**: Implement in-grid row editing with inline controls
3. **Visualization**: Complete ERD with interactive relationship mapping
4. **Replication**: Full publication/subscription admin panel
5. **ESLint**: Add strict linting rules for future releases

### 🙏 Acknowledgments

Special thanks to all contributors and users who provided feedback during 0.9.x development. Your reports and feature requests shaped this stable foundation!

---

## [0.9.5] - 2026-04-09
Expand Down
15 changes: 10 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,11 +7,11 @@
[![Version](https://img.shields.io/visual-studio-marketplace/v/ric-v.postgres-explorer?style=for-the-badge&logo=visual-studio-code&logoColor=white&color=0066CC)](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer)
[![Downloads](https://img.shields.io/visual-studio-marketplace/d/ric-v.postgres-explorer?style=for-the-badge&logo=visual-studio-code&logoColor=white&color=2ECC71)](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer)
[![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-stable%20v1.0.0-green?style=for-the-badge&logo=git&logoColor=white)](https://github.com/dev-asterix/PgStudio/releases/tag/v1.0.0)
[![Status](https://img.shields.io/badge/status-stable%20v1.0.0%20%2B%20nightly-blue?style=for-the-badge&logo=git&logoColor=white)](https://github.com/dev-asterix/PgStudio/releases)

**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://pgstudio.astrx.dev/) • [🛒 **Marketplace**](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer) • [🤝 **Contributing**](#-contributing) • [📝 **v1.0.0 Release Notes**](docs/RELEASE_NOTES_v1.0.0.md)
[📖 **Documentation**](https://pgstudio.astrx.dev/) • [🛒 **Marketplace**](https://marketplace.visualstudio.com/items?itemName=ric-v.postgres-explorer) • [🤝 **Contributing**](#-contributing) • [📝 **v1.0.0 Release Notes**](docs/RELEASE_NOTES_v1.0.0.md) • [📋 **Changelog**](CHANGELOG.md)

</div>

Expand Down Expand Up @@ -39,15 +39,20 @@
- 🛡️ **Connection Safety** — Environment tagging (🔴 PROD, 🟡 STAGING, 🟢 DEV), read-only mode, query safety analyzer
- ⏱️ **Performance Tracking** — Historical query execution monitoring with degradation alerts
- 📊 **Live Dashboard** — Real-time metrics & query monitoring
- 🚦 **Dashboard Health Signals** — Status badges, lock/wait indicators, and performance-focused telemetry cards
- 📓 **SQL Notebooks** — Interactive notebooks with AI assistance
- 🗂️ **Notebook Manager** — Open/create notebooks with searchable picker and improved metadata context
- 💾 **Saved Queries** — Tag-based organization, connection context restoration, AI metadata generation, edit & reuse
- 🌳 **Database Explorer** — Browse tables, views, functions, types, FDWs
- 🛠️ **Object Operations** — CRUD, scripts, VACUUM, ANALYZE, REINDEX
- 🛠️ **Object Operations** — CRUD, scripts, VACUUM, ANALYZE, REINDEX, plus triggers/sequences/domains/rules/partitions/publications/event triggers/tablespaces/aggregates
- 🏗️ **Visual Table Designer** — Create/Edit tables with a robust GUI
- 🧭 **Definition Viewer (SQL Preview)** — Open object DDL with toggleable SQL preview, copy/edit workflows, and routine scaffolding
- 🔑 **Index & Constraint Manager** — Visual management of DB constraints
- 🧠 **Schema Intelligence** — Schema search, index advisor, and migration generator workflows
- 📋 **Smart Paste** — Context-aware clipboard actions (SQL/CSV/JSON)
- 📊 **Table Intelligence** — Profile, activity monitor, index usage, definition viewer
- 🔍 **EXPLAIN CodeLens** — One-click query analysis directly in notebooks
- 🎛️ **Advanced Result UX** — Column stats, transpose view, enhanced filtering, and improved in-grid editing controls
- 🛡️ **Auto-LIMIT** — Intelligent query protection (configurable, default 1000 rows)
- 🌍 **Foreign Data Wrappers** — Manage foreign servers, user mappings & tables
- 🤖 **AI-Powered** — Generate, Optimize, Explain & Analyze with guided follow-ups and next-step suggestions (GitHub Models, OpenAI, Anthropic, Gemini, VS Code LM)
Expand Down Expand Up @@ -151,15 +156,15 @@ Then: **PostgreSQL icon** → **Add Connection** → Enter details → **Connect
- `README.md` - Product overview, installation, development, and troubleshooting
- `docs/ARCHITECTURE.md` - System architecture and component/data-flow details
- `docs/STYLING_GUIDE.md` - Centralized styling/templates and UI refactoring patterns
- `docs/ROADMAP.md` - Active pipeline and upcoming phases
- `docs/WEBSITE_CONTEXT.md` - Website architecture and content context
- `docs/API_STABILITY.md` - v1.x API stability and deprecation policy
- `docs/SECURITY_REVIEW.md` - v1.0 security controls and release checklist
- `docs/RELEASE_NOTES_v1.0.0.md` - v1.0 highlights and release notes
- `docs/MIGRATION_GUIDE_0.x_to_1.0.0.md` - upgrade path from 0.9.x to 1.0.0
- `SECURITY.md` - Security policy and vulnerability reporting guidance
- `CHANGELOG.md` - Release notes and what changed across versions

**v1.0.0 (Latest) —** Production-ready release with comprehensive security audit, expanded test coverage, API stability guarantees, and production deployment guides. See [Release Notes](docs/RELEASE_NOTES_v1.0.0.md) and [Migration Guide](docs/MIGRATION_GUIDE_0.x_to_1.0.0.md) for upgrade details.
**Stable: v1.0.0 | Nightly: v1.0.0-nightly+ —** Production-ready stable release plus active nightly improvements (dashboard telemetry UX and SQL Preview toggle workflows). See [Release Notes](docs/RELEASE_NOTES_v1.0.0.md), [Migration Guide](docs/MIGRATION_GUIDE_0.x_to_1.0.0.md), and [CHANGELOG.md](CHANGELOG.md) for details.

---

Expand Down
41 changes: 38 additions & 3 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -918,18 +918,26 @@
{
"command": "postgres-explorer.ddlViewer.openEditableCopy",
"title": "DDL Viewer: Open as Editable Copy",
"category": "PgStudio"
"category": "PgStudio",
"icon": "$(edit)"
},
{
"command": "postgres-explorer.ddlViewer.copyToClipboard",
"title": "DDL Viewer: Copy to Clipboard",
"category": "PgStudio"
"category": "PgStudio",
"icon": "$(copy)"
},
{
"command": "postgres-explorer.ddlViewer.executeRoutine",
"title": "DDL Viewer: Execute Routine Scaffold",
"category": "PgStudio"
},
{
"command": "postgres-explorer.ddlViewer.toggleEnabled",
"title": "DDL Viewer: Toggle SQL Preview",
"category": "PgStudio",
"icon": "$(file-code)"
},
{
"command": "postgres-explorer.switchConnection",
"title": "Switch Connection",
Expand Down Expand Up @@ -1674,6 +1682,11 @@
"type": "boolean",
"default": true,
"description": "Open the Definition Viewer automatically when selecting supported tree items."
},
"pgstudio.ddlViewer.enabled": {
"type": "boolean",
"default": true,
"description": "Enable SQL Preview (Definition Viewer) features and actions."
}
}
},
Expand Down Expand Up @@ -1713,6 +1726,11 @@
"when": "view == postgresExplorer",
"group": "navigation"
},
{
"command": "postgres-explorer.ddlViewer.toggleEnabled",
"when": "view == postgresExplorer",
"group": "navigation"
},
{
"command": "postgres-explorer.manageConnections",
"when": "view == postgresExplorer",
Expand Down Expand Up @@ -1749,6 +1767,23 @@
"group": "2_phase7"
}
],
"editor/title": [
{
"command": "postgres-explorer.ddlViewer.copyToClipboard",
"when": "resourceScheme == pgstudio-ddl",
"group": "navigation@1"
},
{
"command": "postgres-explorer.ddlViewer.toggleEnabled",
"when": "resourceScheme == pgstudio-ddl",
"group": "navigation@2"
},
{
"command": "postgres-explorer.ddlViewer.openEditableCopy",
"when": "resourceScheme == pgstudio-ddl",
"group": "navigation@3"
}
],
"view/item/context": [
{
"command": "postgres-explorer.notebooks.open",
Expand Down Expand Up @@ -2954,4 +2989,4 @@
"webpack": "^5.76.0",
"webpack-cli": "^5.0.0"
}
}
}
Loading