Changelog
Release notes
GitHub releasesEvery change to the Workspai VS Code extension, fetched live from GitHub.
New
- Incident routing shared module — extracted all action-type routing logic into incidentRouting.ts (routeIncidentActionTypeFromMessage). Eliminates drift between panel implementation and tests; tests now import the real function directly rather than asserting on source text. RoutingResult type is exported and shared across routing consumers.
- Specialist intent routing — four new deterministic routing branches in the incident router:
- Scope-aware suggested questions — _buildSuggestedQuestions accepts scopeIntent: 'workspace' | 'project' and returns deterministic, non-generic questions per specialist intent and standard action type. Workspace scope surfaces topology/governance questions; project scope surfaces per-service execution questions.
- Phase-gate UI alignment — phaseContext in AIIncidentStudio.tsx aligned with backend telemetry gates:
- Data-driven Action Matrix — incidentCliActionMatrix.ts refactored to a canonical source: stable matrix-prefixed IDs, explicit workspace/project scope per entry, actionTypes array for routing resolution, and two resolver functions (resolveIncidentCliActionByActionType, resolveIncidentCliActionIdByActionType) for end-to-end routing alignment.
- Module Graph Tree in Incident Studio — doctor evidence payload enriched with installedModules from registry manifests; AIIncidentStudio.tsx renders framework-grouped module graph with interactive filters (framework dropdown, severity: healthy/warning/critical, module search) and a stability guard that auto-resets the framework filter when the selected framework is no longer present in the dataset.
- BYOP stack expansion — detectProjectStack extended with BYOP-first detection for six additional stacks: django, flask, express, koa, rails, dotnet. Discovery uses framework-specific file markers (manage.py, wsgi.py, app.py, app.js/server.js, Gemfile/config/routes.rb, *.csproj/*.sln).
- Enterprise gate fixtures — releases/fixtures/wave2-enterprise-gate.json and wave3-enterprise-gate.json provide deterministic gate snapshots with consecutiveWindowsPass: 2 for regression protection. releases/fixtures/release-posture-label.md labels current posture as stabilization-only.
- Incident conversation metrics — new incidentConversationMetrics.ts module: buildIncidentLifecycleMetrics(input, nowMs) sanitizes malformed numbers/timestamps before telemetry emission, preventing NaN or negative values from corrupting KPI windows.
- Incident resume snapshot hardening — incidentStudioResume.ts adds toNonNegativeInteger, toNonNegativeTimestamp, and toValidTurns sanitizers to buildIncidentResumeSnapshot; malformed turn counts and timestamps are clamped to safe values.
Changed
- Doctor telemetry refresh — doctorTelemetryRefresh.ts adds onError hook and async catch in the refresh executor, preventing unhandled promise rejections from crashing the extension host on telemetry refresh failures.
- Release gate workflows — release-gate-wave2.yml and release-gate-wave3.yml hardened: severity parser extracted to shared helper, paginated GitHub issue fetch replaces single-page query, fixture fallback paths removed (hard-fail when KPI marker is missing).
- Test regression coverage — three incidentStudioPromptPolicy.test.ts route-precision tests updated to read from incidentRouting.ts (the real implementation) rather than welcomePanel.ts. Test suite: 731/731 tests passing (66 files).
Fix
- Prompt policy route-precision test source paths — route precision: doctor-fix and recipe-pack, terminal-bridge requires explicit terminal signal, and fix-preview-lite requires patch context tests were asserting on welcomePanel.ts source after routing logic was extracted to incidentRouting.ts. Tests now correctly reference the live routing module.
New
- Browser smoke test action — new browser-smoke-test action type in Incident Studio, aligned with VS Code 1.119 browser agent tools. The action enables AI-guided smoke testing of web applications by opening the project's running dev server in VS Code's simple browser and asking the AI to verify key UI surfaces, endpoints, and HTTP status codes. Fully integrated across all four contract layers: action matrix, prompt policy, payload contracts, and routing logic.
- Smart rate-limit fallback — implements one-shot intelligent fallback on retryable model errors (429, rate limit, quota, service unavailable, overloaded). Fallback only triggers before first chunk is streamed (prevents duplicate partial responses), includes automatic model selection cache reset via resetModelSelectionCache(), and falls back to raw model registry if auto-selection picks the same model again. Adds emittedFromPrimary guard and returns updated modelId on successful fallback.
- Regression test for fallback — new test in aiService.test.ts: "falls back to another model when initial request fails with retryable rate-limit error". Validates that when autoModel throws 429, fallbackModel is called and streamed response is returned with correct fallback modelId.
Changed
- Model selection normalization semantics — fixes v0.25.0 regression where literal string 'auto' was being converted to null/undefined. All three normalize helpers (normalizeSelectedModelId in App.tsx, normalizeRequestedModelId in welcomePanel.ts, normalizePreferredModelId in aiService.ts) now preserve 'auto' as a real model value and only convert truly empty strings/whitespace to null/undefined. This ensures the Auto model selection UI state doesn't collapse when users explicitly request Auto model.
- Incident Studio View controls styling — improved readability of Maximize and Lite/Full view toggle buttons by increasing font-size to 10.2px for labels, 12px for icon symbols, adding letter-spacing 0.01em, and setting font-weight 800 for bold emphasis. Used dedicated .incident-header-group--view CSS context selector to isolate sizing to View toggles only, preventing impact on other header chips.
Fix
- driftGuard test assertion — updated keeps AI modal stop-generation contract aligned across webview and panel test to split the assertion for context: ctx, requestId into two separate checks (context: ctx, and requestId,) matching the actual multi-line object formatting in App.tsx. This was a pre-existing formatting drift from earlier refactoring with no functional impact to the modal stop-generation contract itself.
New
- S01 fallback-reason breakdown — fallbackReasonBreakdown now classified into 5 categories (success, bare_keyword_only, fix_preview_fallback, orchestrate_default, other) for every next_action_clicked event; visible in Stabilization KPI snapshot and card UI. Prevents false-positive route-precision claims by exposing fallback mix distribution.
- S02 verify-path miss reasons (top offenders) — verifyPathReasonTop tracks top-5 miss reasons by frequency; included in snapshot Markdown export and Stabilization KPI card. Drives weekly remediation backlog for verify-path gaps.
- S04 recovery class breakdown — recoveryClassBreakdown segments rollback events into auto_rollback, manual_recovery, unspecified; included in snapshot export and card stats row. Prevents aggregate recovery rate hiding manual-burden shifts.
- S05 cohort validation — repeatVerifiedWithArtifactReady and repeatVerifiedWithArtifactRate track repeated incidents that have both repeatedIncident=true and replayReady=true on the verified_outcome_ready_for_artifact event. New S05-Cohort metric card added to Stabilization KPI gate UI.
- False-positive risk mitigation docs — KPI map, weekly dashboard template, 6-week plan, and canonical story updated with S01–S05 operational playbooks, thresholds, remediation owners, and weekly runbook.
Changed
- Stabilization KPI snapshot — Markdown export now includes S01 fallback mix, S02 top miss reasons, S04 recovery class mix, and S05 cohort stats in addition to S01–S05 gate table.
- StudioStabilizationKpiStatus metrics contract — extended with fallbackReasonBreakdown, verifyPathReasonTop, recoveryClassBreakdown, repeatVerifiedWithArtifactReady, and repeatVerifiedWithArtifactRate fields (all optional, backward-compatible).
- KPI Dictionary status — S05 promoted from Partial to Available (cohort validation via artifact/replay ID linking now instrumented).
New
- AI-first dashboard spotlighting - added compact AI Features cards, a featured Incident Studio entry point, a Quick Links "build with AI" cue, and editor quick-fixes README coverage with screenshot 8.
- Project kit recovery affordance - added an on-demand kit retry path when the project modal opens before available kits have loaded.
Changed
- Incident Studio control-surface polish - reworked header controls, mode/view layout, maximize behavior, active-scope presentation, and removed the redundant project/workspace context bar.
- Navigation and setup affordances - updated dashboard/Incident Studio tabs, setup entry points, and scope syncing between host and webview so users land in the right surface with the right context.
- README and product messaging refresh - streamlined README copy, aligned screenshots 1-8, and reinforced backend AI workflow positioning including Spring Boot support.
Fix
- Project Explorer add-module routing - fixed right-click add-module payload serialization so project actions no longer fail on circular command arguments.
- Analyze/test visual ambiguity - separated Analyze visuals from Run Tests with AI-themed icons and corrected tab/button alignment regressions.
- Incident Studio state and first-open races - fixed stale scope synchronization, first-open kit loading gaps, and the header regression introduced during layout compaction.
New
- CLC1 decision clarity contract — added a single structured decision clarity payload for Incident Studio actionable outputs with situation, reason, scope, risk, next step, verify plan, rollback plan, and evidence links.
- CLC5 outcome KPI model — added incidentOutcomeKpi computation and marker telemetry records for first-action success, reopen, override, verify completion, rollback success, and time-to-first-confident-action.
- Artifact criteria and mode adapters — added incidentArtifactCriteria and incidentUxModeAdapter modules with dedicated acceptance and regression test coverage.
Changed
- CLC2 mutation safety enforcement — moved decision field validation to pre-execution and block completion/mutation-ready language whenever required clarity fields are missing.
- CLC3 deterministic phase policy wiring — connected phase rail and next-action behavior to deterministic policy evaluation instead of heuristic progression.
- CLC6 UX mode behavior hardening — applied Guided/Standard/Expert policy consistently to primary and secondary CTAs, including multi-CTA paths.
- CLC7 evidence rendering coverage — completed UI wiring for all artifact kinds (verify, diagnosis, sandbox, rollback, repro) with explicit per-criterion status display and styles.
- Release stop gate integration — made outcome KPI checks part of mandatory release gate overallPass evaluation.
Fix
- Decision clarity dead path — fixed host-to-webview contract so decision clarity is emitted in aiChatActionResult and no longer remains an unused card path.
- Mode bypass and criteria styling gaps — fixed Expert-mode action filtering bypass and missing criteria/card status classes in Incident Studio styles.
New
- 🧭 Enterprise import and BYOP readiness surfaces — expanded import command flow, workspace/project integration points, and extension wiring for safer multi-workspace onboarding and drift control.
- 📈 W07/W08 validation instrumentation — added release-readiness decision outcome tracking (GO/NO-GO) and artifact-linked validation telemetry to support decision accuracy and incident-prevention KPIs.
- 🌙 Nightly Incident Studio soak workflow — introduced dedicated soak automation workflow to continuously exercise Incident Studio stability paths.
- 🧪 Contract runtime and stress regression coverage — added workspaiContractRuntime module and tests plus broader release-stop/stress validation suites.
Changed
- 🚦 Wave 3 release-stop gate visibility — gate output now includes release-readiness validation metrics and clearer KPI evidence blocks alongside existing hard-gate signals.
- 🧩 Incident Studio host/webview contract parity — synchronized payload normalization, prompt policy, telemetry typing, and panel behavior across extension and webview layers.
- ⚙️ Core command and workspace orchestration — refined command routing and workspace operations for stronger enterprise reliability in cross-project flows.
Fix
- 🛡️ Claim and scope safety alignment — tightened shipped-scope wording and evidence alignment to avoid over-claiming behavior outside verified release boundaries.
- 🔧 Telemetry type and gate regression mismatches — resolved time-window compatibility and stabilized targeted release-gate regressions for newly added KPIs.
New
- 🚨 Incident Studio foundation — shipped the core AI Incident Studio experience with lifecycle-aware payload contracts, graph-backed action handling, protocol fixtures, support panels for memory/resume/telemetry/prompt policy, and end-to-end regression coverage.
- 🧭 System graph + Architecture Lens baseline — added the workspace system graph indexer, deterministic blast-radius scoring, Incident Studio Architecture Lens, editor CodeLens surface, and inline architecture warnings for supported source files.
- 🔁 Release gate and rollback baseline — added wave-2 stop-gate automation, release gate manifest/KPI wiring, verify-first policy enforcement, hard-gate telemetry, and verify-fail auto-rollback evidence plumbing.
- 🧰 Setup and workspace operations upgrade — replaced the old setup panel with the new setup experience, added workspace share bundle import/export flows in the dashboard, restored module browser responsiveness, and expanded workspace/project command coverage.
- 🩺 Doctor and telemetry surfaces — added doctor telemetry refresh views and richer project context/log reporting for release gating and runtime observability.
- 🧪 Deep regression coverage — added contract, flow, graph, telemetry, release-gate, workspace-share, and A08-specific tests across the extension and webview layers.
Changed
- 🧠 AI context pipeline hardening — introduced a formal AI context contract and resolver, expanded project-context extraction, refreshed system prompt/prompt message shaping, and aligned AI/debug/chat flows on the same context-rich path.
- 🖥️ UI and webview modernization — refreshed large parts of the dashboard, Actions, setup, project creation, and incident surfaces to support the new Workspai workflows and responsive layouts.
- 🧩 Command/provider/schema alignment — updated command handlers, config-file completion/hover support, schemas, tree views, wizards, and extension activation wiring so the new surfaces work coherently in-editor and in-webview.
- 📦 Dependency security refresh — lockfile dependencies were refreshed through npm audit fix, clearing current production dependency findings for the release line.
Fix
- 🔒 Prompt and mutation safety — tightened prompt sanitization, adversarial-input guards, verify-readiness enforcement, and unknown-scope blocking so risky actions degrade safely.
- 🔄 Workspace flow stability — fixed workspace detection, project switching, sync cache invalidation, partial-failure normalization, webview readiness races, and module browser responsiveness.
- 🧩 Architecture evidence fragmentation — impact, predictive, and release-gate signals are now presented as one coherent architecture review surface instead of several loosely related cards.
- 🛡️ Production dependency audit findings — runtime npm audit findings are resolved for the current shipped dependency tree; only upstream dev-tooling issues without an available fix remain.
New
- ✦ AI action surface expansion — added AI flow commands to the extension command palette and menus: workspai.aiQuickActions, workspai.aiOrchestrate, workspai.aiFixPreviewLite, workspai.aiChangeImpactLite, workspai.aiTerminalBridge, workspai.aiWorkspaceMemoryWizard, and workspai.aiRecipePacks.
- 📊 Telemetry commands + onboarding experiment analytics — new commands workspai.showTelemetrySummary, workspai.resetTelemetry, workspai.showAIFeatureOnboarding, and workspai.showOnboardingExperimentStats with workspace-scoped summaries and experiment CTR analysis.
- 🧭 AI onboarding tour — in-product AI onboarding messages with follow-up toast variants and command telemetry events for onboarding flows.
Changed
- 🧱 Sidebar and webview quick-action alignment — WORKSPACES / PROJECTS inline action ordering now matches the expanded AI flow model; Actions webview now exposes AI Flows, telemetry, and onboarding shortcuts.
- 🧠 Telemetry instrumentation coverage — both @workspai chat participant and AI modal now emit structured success/error/cancel outcome telemetry with context-safe guards.
- 🎛️ Project context insights panel — new workspace telemetry and onboarding experiment summary views in projectContextAndLogs with copyable quick summaries.
Fix
- 🩺 Doctor network safety — version metadata fetch now enforces timeout, redirect bounds, and same-host redirect checks to reduce hangs and unsafe redirect behavior.
- 🚀 Dev server port probing resilience — project start flow now uses bounded port scan attempts with warning fallback instead of unbounded recursive probing.
- 📁 Workspace registry initialization race — config directory creation is now synchronous at startup to avoid first-run path timing issues.
New
- 🤖 @workspai Chat Participant — register @workspai in the VS Code Chat panel with two slash commands: /ask (full-context Q&A scoped to the active project) and /debug (structured debug flow: root cause + fix + prevention). Reuses the same prepareAIConversation → streamAIResponse pipeline as the Workspai modal for identical AI quality.
- ✦ AI Create presets — the AI Create modal now ships with categorised quick-fill prompt options (SaaS & commerce, core backend, microservices, data & ML, internal tools). Smart scoring surfaces the most relevant presets based on partial user input.
- 📊 "Which backend next?" poll — in-sidebar quick poll lets users vote for the next supported framework (Django / Express / Spring); result is acknowledged inline.
- 🔧 Workspace bootstrap, setup, init, policy, cache, mirror commands — new workspai.workspaceBootstrap, workspai.workspaceSetup, workspai.workspaceInit, workspai.workspacePolicyShow/Set, workspai.cacheStatus/Clear/Prune/Repair, workspai.mirrorStatus/Sync/Verify/Rotate, and workspai.checkForUpdates commands registered and palette-accessible.
- 🧪 WorkspaceMemoryService unit tests — new src/test/workspaceMemoryService.test.ts covering read/write, sanitisation, timestamp validation, and concurrent-access paths.
Changed
- 🧠 Workspace memory hardening — WorkspaceMemoryService now validates and sanitises all context, conventions, decisions, and lastUpdated fields on every read, auto-corrects corrupt entries, and writes back only the cleaned structure.
- ⚡ Live module list in AI context — aiService now fetches the available module catalogue directly from the CLI (rapidkit modules list --json-schema 1) with a 60-second in-process TTL cache, so AI responses reference the real current module set rather than a static snapshot.
- 🔁 Idempotent workspace creation — createWorkspace now detects partial directories (directory exists, no .rapidkit-workspace marker) and offers a "Replace (delete & recreate)" prompt; if the workspace marker already exists the CLI call is skipped entirely for a silent success.
- 🎨 Brand icons updated — workspai.png and workspai.svg updated to current Workspai identity; stale rapidkits.svg removed.
Fix
- 🛡️ AI module slug validation — module slugs returned by AI are validated against the live module list and the vendor/category/slug regex before being applied, preventing hallucinated module names from reaching the CLI.
- 📐 AI project context enrichment — context payload now includes python_version, rapidkit_cli_version, rapidkit_core_version, installed_modules, workspace_health, runtime, and engine fields so the model has complete environment awareness.
Changed
- 🧭 Workspai positioning sync across the extension README, Marketplace description, and webview header so public-facing messaging consistently uses the canonical product line: "The AI workspace for backend teams"
- 🐹 Go AI guidance in aiService now explains the current Go support boundary more clearly: supported kits are gofiber.standard and gogin.standard, and Go projects should be extended with native Go packages and internal adapters rather than RapidKit marketplace modules
- 🏷️ Go kit metadata cleanup — removed misleading modular tags from Go/Fiber and Go/Gin kit descriptors
Fix
- 🧠 Workspace memory action icon restored — rapidkit.editWorkspaceMemory now uses a valid codicon so the inline edit-memory action renders visibly in the WORKSPACES sidebar instead of leaving only an empty clickable area
- 🪟 Platform-safe npm wrapper execution — buildRapidkitCommand() now forces package resolution through npx --yes --package rapidkit rapidkit ..., preventing local launcher shadowing from the current working directory
- 🐹 Go framework detection — workspaceDetector now detects gofiber.standard and gogin.standard from real go.mod dependencies instead of RapidKit-specific package strings, with regression tests added for both frameworks
- 🩺 rapidkit-core verification reliability — setup panel checks now use pip show / pipx list based verification paths that are more stable across Windows and Linux environments
- 🎼 Poetry verification robustness — setup panel now probes real Poetry executable candidates only when they actually exist, reducing noisy or misleading verification failures
New
- 🤖 AI model selector in the AI modal header — users can choose any Copilot-registered language model (Claude, GPT, Gemini, etc.) from a compact inline dropdown before sending a query. Premium users see their full model list; free-tier users see what's available to them.
- 🧠 Thinking indicator while the AI context-scan phase runs — animated bouncing dots replace the blank waiting state so users have clear feedback before the first token arrives.
- 📝 MarkdownRenderer component (webview-ui/src/components/MarkdownRenderer.tsx) — lightweight zero-dependency markdown renderer for AI responses supporting headings, bold/italic, inline code, fenced code blocks, ordered/unordered lists, and HR rules.
Changed
- ⚡ Real-time AI streaming — fixed the "all at once" delivery problem. Extension host now flushes chunk batches every 50 ms via setInterval, breaking VS Code IPC batching that was holding tokens until stream completion.
- 🎨 Streaming render path — MarkdownRenderer no longer runs parseBlocks on every animation frame during streaming. Raw text is displayed instantly during the stream; a single parse pass runs after completion for formatted output.
- 🗂️ Quick-prompt chips hidden while streaming/thinking to reduce visual noise.
- 🔧 collapseAll tree view switched to native showCollapseAll: true on the rapidkitProjects view contribution — removes the invalid workbench.actions.treeView.rapidkitProjects.collapseAll menu entry warning.
Fix
- 🐛 Menu item warning — workbench.actions.treeView.rapidkitProjects.collapseAll was referenced in menus but not registered in commands; resolved by using VS Code's built-in showCollapseAll view property.
New
- 🧠 Deep AI project context in aiService for FastAPI/NestJS/Go workspaces with richer framework and file-signal extraction before generation and debugging.
- ✅ New AI regression coverage with dedicated tests for alias/model handling and AI debugger command flow.
Changed
- 🤖 Model selection hardening for GitHub Models/Copilot chat models, including robust alias resolution and safer fallback ordering.
- 🧵 Workspace memory I/O migrated to async flow to avoid blocking extension interactions.
- 🎛️ AI interaction consistency by routing legacy debug/brain entry points through the shared Workspai AI modal pipeline.
Fix
- 🛡️ Prompt budget safeguards to prevent oversized AI prompts and reduce timeout/failure risk on large repositories.
- 🧩 Module slug typo auto-correction with conservative matching to reduce failed module operations from minor naming mistakes.
- 🔁 Webview AI request lifecycle stability with stronger request correlation/cancel behavior across panel and modal flows.
Other
- WORKSPACES sidebar — two-phase rendering (workspaceExplorer) — getChildren() previously blocked on three per-workspace async ops: versionService.getVersionInfo() (subprocess + pip network call, 5 s timeout), getBootstrapProfile() (disk read), and _countInstalledModules() (recursive registry.json scan). Items now render instantly from cache; metadata (version badge, profile, module count) loads in background via _scheduleBackgroundMetadataLoad and fills in without user action.
- PROJECTS sidebar — two-phase rendering (projectExplorer) — getChildren() now returns items immediately from this.projects cache and schedules _scheduleProjectLoad() in background; loadProjects() uses Promise.all for parallel pathExists checks per project instead of a sequential if/else chain.
- AVAILABLE MODULES — two-phase rendering (moduleExplorer) — getChildren() immediately returns a loading~spin spinner item and fires _scheduleBackgroundCatalogLoad() instead of await-ing _ensureCatalogLoaded() (which ran a subprocess on cache miss). Catalog fills in when background load completes.
- Extension activation — workspaceDetector.detectRapidKitProjects() is no longer await-ed at activation; fires in background with .catch() — extension activates without blocking on workspace detection.
- coreVersionService TTL — version cache TTL extended from 5 min → 30 min. Python package version changes rarely; the subprocess version check runs far less often.
- examplesService timeout — axios request timeout reduced from 10 s → 5 s.
Fix
- AVAILABLE MODULES empty state — getChildren() now returns [] when no project is selected, allowing the VS Code viewsWelcome rich empty state to show (icon + heading + description + button) instead of a bare placeholder tree item.
- Removed fragile setTimeout for doctor refresh — two setTimeout(5000) / setTimeout(8000) calls after doctor re-run and autofix have been removed. The file watcher on doctor-last-run.json already handles refresh automatically.
- HeroAction.tsx badge alignment — $(sparkle) icon inside .hero-badge span now aligns inline with text (inline-flex items-center gap-1 / display: inline-flex).
- Dead code removed — _ensureCatalogLoaded() in moduleExplorer deleted; it was no longer called after two-phase refactor.
Changed
- package.json — viewsWelcome for rapidkitModules updated with icon $(package), heading, description, and an "Open Projects" link button (shown when !rapidkit:projectSelected).
- package.json — concurrently added to devDependencies (was used in dev script but missing from declared deps).
New
- ✦ AI Debug Actions (Code Actions) — ✦ Debug with Workspai AI and ✦ Explain error with AI quick-fix actions appear in the editor lightbulb for Python, TypeScript, JavaScript, and Go files that have diagnostics or a text selection; opens the AI modal with the error/selection pre-filled in Debug mode
- ✦ Doctor Fix with AI — each issue in the Workspace Health sidebar panel now has a ✨ inline button; clicking it opens the AI modal with the full issue context pre-filled, ready for analysis
- ✦ AI Module Suggestions — the Create Project modal now has a "Suggest modules with AI" button that recommends the top modules for your chosen framework and project description
- Minimizable AI Create modal — a − minimize button appears during thinking and creating steps; the modal collapses to a floating pill in the bottom-left corner so the dashboard stays usable; auto-restores when creation completes
Changed
- Quick Actions sidebar — consolidated to a single ✦ AI Assistant button ($(sparkle) icon) that opens the AI modal; redundant "Workspace Brain" button removed
- rapidkit.debugWithAI command — now opens the main Workspai panel AI modal instead of a separate HTML tab; context (editor selection or diagnostics) is passed as prefillQuestion
- rapidkit.workspaceBrain command — now focuses the main Workspai panel instead of opening a separate HTML tab
- Doctor Fix with AI — removed scratch-doc workaround; issue text is now passed directly as prefillQuestion to the AI modal
Fix
- AIModal.tsx — added context to useEffect dependency array so that prefillQuestion is correctly applied even when the modal is already mounted with a previous context
New
- ✦ AI actions on workspace cards — each workspace in the Recent Workspaces list now has a ✦ button (visible on hover) that opens the AI modal pre-loaded with that workspace's context
- ✦ AI actions on module cards — each module card in the Module Browser now has a ✦ button that opens the AI modal with the module's context (Module Advisor)
- aiForWorkspace / aiForModule webview messages handled in WelcomePanel — routes to showAIModal() with correct context type
Fix
- Critical: command 'rapidkit.workspaceSelected' already exists — removed duplicate registerCommand call from ProjectExplorer constructor; command is now registered only once in extension.ts
- projectExplorer.setWorkspace() is now correctly called when rapidkit.workspaceSelected fires (previously only doctorEvidenceExplorer.refresh() was called)
New
- 🩺 Doctor Evidence Viewer (DoctorEvidenceProvider tree view)
- 📦 Module install modal from Available Modules sidebar
Changed
- 🧩 WelcomePanel gains setExtensionContext() static method so sidebar components can open the panel without passing context
- 🔄 Initial workspace path sync: after workspaceExplorer.refresh() on activation, health panel is immediately seeded with the auto-selected workspace
New
- 🧩 Modular command registration architecture
- 🧪 Cross-platform command contract coverage
Changed
- 🪟 Create Workspace modal UX (tool-aware flow)
- ⚡ Workspace sidebar loading performance
- 🖥️ Terminal execution + platform abstraction
Fix
- 🩺 Doctor workspace path output clarity
- 🧭 Setup and requirement checks consistency
New
- 🧭 Workspace-profile aware command reference in Welcome page
- 👁️ Persistent Setup Status visibility control
- 🏷️ Workspace profile tags across UI surfaces
Changed
- 🎨 Quick Actions theme adaptation
- 🌐 Example workspaces behavior
- 🧠 Workspace vs project state handling in modules UI
Fix
- 🐛 Example cards link/clone regressions
- 🐛 Incorrect state source for profile-based UX
- 🧪 Drift protection enhancements
New
- 🐹 Go Framework Support in Sidebar Quick Actions
- 🪟 Workspace Button Opens Welcome Modal
- 🚫 Modules Disabled for Go Projects
Fix
- 🔧 Removed @latest from All npx Calls
- 🔧 Go Project Init Detection
- 🔧 openWorkspaceModal Wrong State
Changed
- 🎨 Framework Button Sizing — Icons reduced to 16px, min-height 44px, padding 5px 2px, label font 9.5px
- 🧭 WorkspaceStatus Type — Added projectType?: 'fastapi' | 'nestjs' | 'go'
- 🧭 Project Type Propagation — updateWithProject sends projectType; _detectProjectTypeStatic shared static helper
New
- 🪟 In-App Module Details Modal
- 🔄 Post-Install Workspace Status Refresh
Changed
- 🧭 CLI Binary Resolution Reliability
- 📡 Module Details Data Source
- 🎨 Webview UI Polish
New
- 🌐 Dynamic Example Workspaces - Load example workspaces from GitHub repository
- 🎨 Dynamic Kit Selection - Enhanced project creation with kit dropdown
- 📦 Full Workspace Export/Import - Complete backup and restore functionality
- 🆕 New Services - Core infrastructure services added
Changed
- ✨ UX Improvements - Better visual hierarchy and usability
- 🎯 Project Creation Flow - Streamlined workflow
- 📋 Workspace Context - Fixed workspace selection bug
Internal
- New Dependencies:
- Package Updates:
- Code Changes:
Removed
- ❌ Config-Only Export/Import - Simplified to Full Archive only
New
- 🚀 Project Actions Panel - Unified action panel in Welcome Page with 6 lifecycle buttons
- ⬆️ Workspace Upgrade Button - Smart upgrade detection for rapidkit-core
- 🎯 Smart Browser Button - Context-aware browser opening
- 📡 Running Port Detection - Intelligent port tracking
Improved
- 🎨 Enhanced Sidebar Icons - Better visual feedback for running projects
- 🔄 State Synchronization - Real-time UI updates
- 💅 Disabled Button Styling - Professional disabled state
Internal
- New Component: ProjectActions.tsx - Unified action panel with conditional rendering
- Type Updates: Added runningPort?: number to WorkspaceStatus interface
- Extension Integration: Import runningServers Map in welcomePanel.ts
- Port Extraction: Regex-based port detection from terminal names
- CSS Enhancements: Disabled button states and hover effect improvements
New
- 🎭 Modal System - Comprehensive modal-based workflows for core actions
- ⚡ Requirement Cache - Smart caching system for installation prerequisites
- 📱 Responsive Design - Mobile-friendly and adaptive layouts
Improved
- 🎨 Updated Screenshots - All extension gallery images refreshed
- 🔧 Enhanced Commands - Better user experience for core operations
- 🎯 UI/UX Polish - Refined user interface components
- 🐍 Python/Poetry Integration - More robust environment detection
Changed
- 🏗️ Architecture - Modernized component structure
Internal
- 📦 New Files
- 🔄 Modified Files
Other
- ⚡ Faster Workspace Creation - 30-50% speed improvement
New
- 🔄 Dynamic Version Display - Welcome page now shows extension version dynamically
- 📊 Project Statistics - Enhanced workspace tracking with detailed project counts
Improved
- 🎨 Redesigned Workspace Cards - Completely revamped workspace list UI
- 🔍 Enhanced Project Detection - More accurate workspace scanning
Changed
- 📐 Workspace Data Structure - Updated type definitions
Internal
- Refactored workspace card components with new class naming (ws-* prefix)
- Added VS Code theme-aware color utility classes
- Improved TypeScript type safety for workspace data
- Code formatting improvements (consistent indentation)
New
- 🏥 Workspace Health Check - Quick diagnostics for workspaces
- 🎯 Standalone Setup Status Panel - Dedicated setup verification
Improved
- 🎨 Setup UI/UX - Enhanced visual design
- 🔧 Welcome Panel - Streamlined quick actions
Changed
- 📋 Setup Status Architecture - Separated from Welcome panel
Internal
- Created new SetupPanel class for standalone setup management
- Added rapidkit.openSetup command
- Added rapidkit.checkWorkspaceHealth command
- Enhanced workspace context menu with health check option
- Improved terminal integration for diagnostic commands
New
- 📋 Copy install commands on Setup Wizard and Module cards (single-click copy of rapidkit add module <slug> and relevant install commands)
- 🖥️ Manual install button with terminal-style icon for module cards
Fix
- 🛠️ Setup Status stuck on "Checking..." — removed interval-based polling and added debounced updates to avoid continuous rechecks and UI flicker
- 🔍 npm vs pipx detection — improved detection logic to distinguish npm CLI from pipx-installed RapidKit to prevent false positives
- 📋 Copy-to-clipboard UX — unified copy button behavior and added visual feedback for modules and install actions
Changed
- 🧩 Module Browser: added copy-to-clipboard for module install commands; improved actions layout and consistent button styling
- 🏷️ Header shows current extension version alongside update status (e.g., v0.6.1 — Up to date)
New
- 🎯 Interactive Module Browser - Complete module management system
- 🔧 Intelligent Setup Wizard - Pre-flight validation system
- 📦 Package Manager Selection - Multi-method installation
- 📚 Enhanced Documentation
Improved
- Python environment detection now uses 8 different methods
- Auto-closing progress notifications (800ms)
- Module state synchronization across all UI components
- Better error messages with actionable guidance
- Workspace creation properly blocks on missing prerequisites
- Installation method cards with visual feedback
Fix
- 🔧 NPM Package Caching Issue - Always use latest rapidkit npm package
- 🩺 Doctor Command Accuracy - Fixed false positive "All checks passed"
- 💬 Notification Polish - All notifications now have "OK" button
New
- 📦 Standalone Project Mode - Create projects without workspace
- 📋 Command Reference - Added to Welcome Page
- 📂 Recent Workspaces - Dynamic list in Welcome Page
- ⚡ Workspace Explorer Enhancements
Changed
- Updated all CLI invocations to use npx --yes rapidkit@latest instead of npx rapidkit
- Improved reliability of workspace and project creation commands
- Welcome Page icons updated for professionalism:
- Refresh icons changed from 🔄 to ↻ (minimal and clear)
- Welcome Panel now auto-refreshes after workspace/project creation
- Stored extension context globally for cross-file access
- Enhanced tooltips in workspace explorer with more details
New
- 🔍 Comprehensive Python Detection - 8-method detection for rapidkit-core package
- 🧙 Interactive Setup Wizard - Integrated into Welcome page
- 📋 Comprehensive Doctor Command - Enhanced system diagnostics
- 🎯 New checkSystem Command - Quick system status check
- 📚 Extensive Documentation - 5 new comprehensive guides
Changed
- 🧹 Removed auto-create default workspace - User must manually create workspace now
- 🎨 Redesigned Actions Panel - More compact button layout
- 📖 Welcome Page Styling - Responsive and compact design
Fix
- 🐛 pyenv Python detection - Now properly detects rapidkit-core in pyenv versions
- 🐛 Workspace already exists handling - Returns existing workspace instead of error
- 🐛 Extension activation flow - Removed async initialization race conditions
Other
- src/commands/checkSystem.ts — Quick system status check
- src/utils/errorParser.ts — Error parsing and suggestions
- docs/PYTHON_DETECTION_METHODS.md — Detection methods documentation
- docs/SETUP_WIZARD_UPDATE.md — Setup wizard implementation guide
- docs/WIZARD_TESTING.md — Comprehensive test cases
- docs/WIZARD_VISUAL_GUIDE.md — UI/UX documentation
- docs/WORKSPACE_COMPARISON.md — Workspace structure reference
- releases/RELEASE_NOTES_v0.5.1.md — Release notes
- src/commands/doctor.ts — Added version checking and npm detection
- src/utils/pythonChecker.ts — Added 8-method detection (4 more methods)
- src/ui/panels/welcomePanel.ts — Complete wizard integration
- src/ui/webviews/actionsWebviewProvider.ts — 3-column layout
- src/extension.ts — Removed auto-workspace, added checkSystem command
- src/core/workspaceManager.ts — Better duplicate handling
- package.json — Updated to v0.5.1
- README.md — Updated for new features
- CHANGELOG.md — This entry
- RELEASE_NOTES.md — Updated latest release
New
- 📋 Shared Workspace Registry - Cross-tool workspace discovery with npm package
Changed
- 🏷️ Unified Workspace Signature - Changed from RAPIDKIT_VSCODE_WORKSPACE to RAPIDKIT_WORKSPACE
- 🔍 Enhanced Workspace Detection - Multi-layer workspace discovery
- 🎯 Project Selection UX - Visual indicators for selected project
Fix
- ✅ Workspace Creation - Removed unnecessary Python validation
- ✅ Module Addition - Robust workspace detection
- ✅ Attribution Consistency - All workspace markers use correct constants
Other
- 📝 Added workspace registry documentation to README
- 📝 Documented cross-tool compatibility workflow
- 📝 Added examples for npm/Extension interoperability
- 🐍 Python Core Bridge - Direct integration with rapidkit-core Python engine
- 🔗 Cross-platform Exec Utilities - Stable command execution
- 🎯 Project Context Tracking - Enhanced project/workspace awareness
- 📦 Bridge-Aware Doctor Command - System diagnostics include Python engine
Changed
- 🔄 All commands delegate to Python Core - Extension is now a smart UX bridge
- 🔄 Workspace Detection Enhanced
- 🔄 Module Explorer Refactored - Using Python bridge
- 🔄 Aligned with rapidkit-npm v0.15.1
Fix
- 🐛 Workspace context lost when quick-switching between projects
- 🐛 Module commands failing due to missing project context
- 🐛 Cross-platform Python inconsistencies (hardcoded python3 paths)
- 🐛 Process cleanup on command timeout
Other
- src/core/bridge/pythonRapidkit.ts — Python bridge with Scenario A/B/C resolution
- src/utils/exec.ts — Cross-platform command execution wrapper
- src/core/selectedProject.ts — Project context management
- src/core/rapidkitCLI.ts — Bridge integration
- src/commands/{addModule,createProject,createWorkspace,doctor}.ts — Bridge delegation
- src/core/{workspaceDetector,workspaceManager}.ts — Enhanced detection
- src/ui/treeviews/moduleExplorer.ts — Python bridge backend
- src/utils/constants.ts — Marker alignment
Fix
- 🐛 Missing workspace directory handling - Fixed crash when selected workspace no longer exists
Changed
- 📦 Updated dependencies - Updated 11 packages to latest stable versions
- 🔄 Compatibility - Synced with rapidkit-npm v0.14.2
New
- 🐍 Smart Poetry virtualenv detection - Extension now detects Poetry virtualenvs in cache
- 🔔 Update notification system - Automatic checks for rapidkit npm package updates
- 📦 Enhanced Doctor command - Better Poetry detection in system check
Changed
- 🧹 Removed redundant activationEvents - Cleaned up package.json
Fix
- 🐛 Poetry cache virtualenv support - FastAPI projects no longer show false initialization warnings
New
- 🖼️ rapidkit.svg - Official RapidKit brand icon in SVG format
- 🎨 ACTIONS WebviewView - Completely redesigned sidebar with professional buttons
- ⚡ Project Quick Actions - 5 inline action buttons on each project in PROJECTS panel
- 📂 Project File Tree - Expand project to see key files
Changed
- 🎨 Welcome Panel SVG Logo - Upgraded from PNG to SVG for better quality
- 📝 Better Description - Updated marketplace description to match website
- 🎨 Improved Project Icons - Framework-specific icons and colors
- 📖 README Sync - Aligned with npm package documentation
Fix
- 🐛 Remove annoying workspace switch - Clicking project no longer switches VS Code workspace
- 🐛 rapidkitTemplates error - Removed orphan TreeView registration
Other
- VS Code 1.100+ (updated from 1.85)
New
- 🩺 RapidKit npm check in Doctor - System check now verifies npx rapidkit --version
Changed
- 🔄 Dynamic version markers - Marker files now use extension version from package.json
Fix
- 🐛 TypeScript error - Added 'preview' to RapidKitModule.status type
- 📝 CHANGELOG links - Updated version links to include all releases (0.4.0-0.4.3)
New
- 🧩 Enhanced Module Explorer - Complete module catalog with 27 modules across 12 categories
Changed
- 🎨 UI/UX Improvements
- 📢 Enhanced Notifications - Added action buttons for better workflow
- 📝 Welcome Page - Updated version reference to v0.4.x for consistency
Fix
- Doctor command async/await handling for notification action buttons
- Terminal integration for post-creation workflows
New
- 🪵 Logging Commands - New command palette options for log management
- Logger Enhancements
Changed
- 📺 Marketplace Presentation
Changed
- 📝 Updated notification messages for rapidkit npm v0.12.3 smart CLI delegation
- 📚 New README - Completely rewritten for clarity and quick reference
Other
- 📁 Moved all release notes to releases/ folder for cleaner root
- Created main RELEASE_NOTES.md with links to history
- Removed .vsix files from git tracking
- Added preview and qna fields to package.json for marketplace
Changed
- 🔄 Complete architecture overhaul - Migrated from Python-based CLI to npm package
- 📦 Smart Location Detection - Intelligent workspace and project location management
- 🎯 Simplified wizards
- ⚡ Updated commands
- 🎨 Button-Style Actions UI - Professional action buttons in sidebar
- 🔧 Type system updates
- ✅ Enhanced Workspace Validation - No more annoying confirmation dialogs
Removed
- ❌ Python CLI dependencies: No longer depends on Python RapidKit CLI
- ❌ Generate Demo feature: Removed (unnecessary with only 2 templates)
- ❌ Demo workspace mode: Workspaces are now standard npm package workspaces
- ❌ Kit selection: Templates are managed by npm package
- ❌ Module wizard step: Module installation moved to post-creation workflow
- ❌ Poetry integration: Not needed anymore
- ❌ Annoying confirmation dialogs: "Add it anyway?" removed
New
- ✨ npm package integration: Full integration with rapidkit npm package (v0.12.1+)
- ✨ Smart location choice: Default workspace vs Custom location with intelligent detection
- ✨ Marker file system: .rapidkit-workspace files for custom location recognition
- ✨ Auto-registration: Workspaces automatically appear in list after creation
- ✨ Direct framework commands: Separate commands for FastAPI and NestJS
- ✨ Better error handling: Contextual help links to documentation
- ✨ Improved progress reporting: More accurate progress indicators
- ✨ Verification steps: Automatic project/workspace verification after creation
- ✨ Parent directory creation: fs.ensureDir() before all CLI calls to prevent ENOENT errors
Fix
- 🐛 Fixed interactive prompts blocking: Added --yes flag to all CLI commands
- 🐛 Fixed custom location not showing in list: Auto-registration after project creation
- 🐛 Fixed workspace validation: Enhanced to accept npm CLI created workspaces
- 🐛 Fixed directory creation errors: Parent directories created before CLI execution
- 🐛 Fixed import order conflict: Moved path import inside function to avoid variable shadowing
Other
- 🎯 Simpler: No Python/Poetry installation required
- ⚡ 5-6x Faster: Direct npm execution vs Python environment setup
- 🔄 Consistent: Single source of truth (npm package) for templates
- 🐛 Fewer bugs: Less complexity = fewer edge cases
- 📦 Smaller: Removed bundled templates (managed by npm package)
- 🎨 Better UX: Smart defaults, no annoying dialogs, professional UI
Other
- For Users: Extension now requires Node.js/npm (already available in VS Code)
- For Developers: Python RapidKit CLI no longer needed for development
- Workspaces: Existing workspaces continue to work, new API for creation
- Templates: Managed by npm package, always up-to-date
- Custom Locations: Now fully supported with marker files
Other
- Updated RapidKitCLI class with new methods:
- Enhanced WorkspaceManager.isRapidKitWorkspace() to check both .rapidkit/ and marker files
- Refactored all command handlers to use new CLI API
- Updated TypeScript types to match new simplified workflow
- Removed legacy Python CLI integration code
- Added marker file creation for custom locations
Changed
- 🌐 Updated domain references - Migrated all URLs from rapidkit.top to getrapidkit.com
- ⚡ Enhanced development workflow - Added comprehensive developer tools
- 📦 Updated dependencies - Upgraded to latest stable versions
Fix
- 🔒 Security improvements - Fixed npm audit vulnerabilities
- 🐛 Code quality fixes - Cleaned up ESLint warnings
Other
- 📚 Updated all documentation links to point to getrapidkit.com
- 📧 Updated support email to support@getrapidkit.com
- 🔗 Updated schema references to use new domain
Fix
- 🐛 Fixed code quality warnings - Addressed 9 ESLint warnings related to unused error variables
Changed
- Modified test infrastructure to disable Vitest tests until VS Code mocking is properly configured
- Updated npm test script to focus on compilation and linting verification
- Updated vitest.config.ts to exclude test files requiring VS Code API
Fix
- 🐛 CRITICAL FIX: Fixed Generate Demo Project hanging issue - The command was using stdio: 'pipe' which prevented output from being shown to users, making it appear frozen
- Fixed Generate Demo Project button to work correctly with demo workspaces
- Fixed command to automatically detect and use generate-demo.js script in demo workspaces
- Added automatic workspace context retrieval when Generate Demo button is clicked
- Demo workspaces now properly generate projects without requiring folder selection
Changed
- Improved generateDemoCommand to accept workspace parameter and retrieve selected workspace from context
- Added progress interval tracking during demo project generation
- Added rapidkit.getSelectedWorkspace command to ProjectExplorer for getting current workspace
- Enhanced demo workspace detection logic to check for generate-demo.js file
Changed
- ⚡ Bundle Optimization: Reduced extension bundle size by 55% (464KB → 209KB)
- Enabled aggressive tree-shaking to remove unused code
- Removed console.log statements and debugger calls in production builds
- Removed legal comments from bundled output
- Improved extension load time and performance
Fix
- Fixed production mode detection in esbuild configuration (now supports both --production flag and NODE_ENV=production)
Fix
- Fixed NestJS projects not appearing in Projects view
- Project explorer now correctly detects both FastAPI (pyproject.toml) and NestJS (package.json) projects
Changed
- Simplified kit selection to show only standard kit for both frameworks
- Removed incomplete kits (advanced, ddd) from project creation wizard until they are fully ready
Fix
- 🔥 CRITICAL FIX: Fixed commands not being registered when installed from VSIX package
- Fixed missing runtime dependencies in packaged extension causing activation failures
- Fixed "command 'rapidkit.createWorkspace' not found" errors
- Fixed "command 'rapidkit.addWorkspace' not found" errors
- Fixed "command 'rapidkit.refreshWorkspaces' not found" errors
- Updated .vscodeignore to include all necessary node_modules dependencies
- All buttons and commands now work correctly in installed VSIX
Changed
- Improved dependency packaging to ensure runtime libraries are available
- Updated build configuration to prevent pruning of required dependencies
- Updated Vitest to v4.0.7 to align with @vitest/coverage-v8 peer requirements
Fix
- 🔧 Fixed workspace and project selection context keys not being set properly
- Fixed buttons in workspace explorer not becoming enabled after selecting workspace
- Fixed project creation button not working in Projects view
- Fixed context menu items not appearing due to context key timing issues
- Improved async handling of context key updates to ensure proper UI state
New
- 🎉 Initial pre-release version
- Workspace creation wizard with interactive prompts
- Project generation for FastAPI and NestJS frameworks
- Module browser with 100+ modules organized by category
- Template preview with syntax highlighting
- Project explorer tree view
- Module explorer tree view
- Template explorer tree view
- Workspace explorer tree view
- Status bar integration with real-time updates
- System doctor for checking requirements (Python, Node.js, Poetry, Git)
- IntelliSense providers:
- Code snippets:
- JSON schema validation:
- Commands:
- Keyboard shortcuts:
- Welcome webview panel with quick actions
- Template preview webview panel
- File watchers for auto-refresh on changes
- Configuration options:
- Context menu integration
- Activity bar integration with RapidKit icon
- Output channel for detailed logging
- Demo mode for quick workspace creation
- Package manager selection for NestJS projects (npm, yarn, pnpm)
Fix
- NestJS project creation package manager parameter handling
- Extension activation on startup
- Command registration order for reliable button functionality