From 3cac17c9311b152211a4e3c2ceffe9e27c5f7fbe Mon Sep 17 00:00:00 2001 From: Richie Varghese Date: Sat, 18 Apr 2026 15:45:22 +0530 Subject: [PATCH 1/2] chore: Update README and CHANGELOG for v1.0.0 release with nightly improvements --- CHANGELOG.md | 78 +++++++++++++++++++++++++--------------------------- README.md | 15 ++++++---- 2 files changed, 48 insertions(+), 45 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 195fd8d..ee11894 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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): @@ -40,7 +46,7 @@ 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 @@ -48,7 +54,27 @@ PgStudio v1.0.0 is a major milestone release with comprehensive stability improv - **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 @@ -69,29 +95,13 @@ 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+ @@ -99,18 +109,6 @@ Documented in README.md and Release Notes: - **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 diff --git a/README.md b/README.md index 6bfc439..354a449 100644 --- a/README.md +++ b/README.md @@ -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) @@ -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) @@ -151,7 +156,7 @@ 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 @@ -159,7 +164,7 @@ Then: **PostgreSQL icon** β†’ **Add Connection** β†’ Enter details β†’ **Connect - `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. --- From f49b38f1a7f246c1b0961933cfb78d01bad487b9 Mon Sep 17 00:00:00 2001 From: Richie Varghese Date: Sat, 18 Apr 2026 15:45:50 +0530 Subject: [PATCH 2/2] Bump version to 1.0.0 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index fd6bf02..cc2cf00 100644 --- a/package.json +++ b/package.json @@ -1,7 +1,7 @@ { "name": "postgres-explorer", "displayName": "PgStudio (PostgreSQL Explorer)", - "version": "1.0.0-nightly", + "version": "1.0.0", "description": "PostgreSQL database explorer for VS Code with notebook support [Nightly]", "publisher": "ric-v", "private": false,