{"id":46784320,"url":"https://github.com/yongjinsim-sudo/dv-quick-run","last_synced_at":"2026-05-10T12:29:38.016Z","repository":{"id":342763378,"uuid":"1175082776","full_name":"yongjinsim-sudo/dv-quick-run","owner":"yongjinsim-sudo","description":"Run and explain Dataverse Web API queries directly inside VS Code.","archived":false,"fork":false,"pushed_at":"2026-04-27T15:58:49.000Z","size":9414,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-27T17:30:17.507Z","etag":null,"topics":["crm","dataverse","dataverse-api","dataverse-query","developer-tools","dynamics365","odata","power-platform","vscode","vscode-extension"],"latest_commit_sha":null,"homepage":"https://github.com/yongjinsim-sudo/dv-quick-run","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yongjinsim-sudo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-07T07:46:00.000Z","updated_at":"2026-04-27T15:55:50.000Z","dependencies_parsed_at":"2026-03-17T08:01:04.609Z","dependency_job_id":null,"html_url":"https://github.com/yongjinsim-sudo/dv-quick-run","commit_stats":null,"previous_names":["yongjinsim-sudo/dv-quick-run"],"tags_count":41,"template":false,"template_full_name":null,"purl":"pkg:github/yongjinsim-sudo/dv-quick-run","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yongjinsim-sudo%2Fdv-quick-run","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yongjinsim-sudo%2Fdv-quick-run/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yongjinsim-sudo%2Fdv-quick-run/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yongjinsim-sudo%2Fdv-quick-run/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yongjinsim-sudo","download_url":"https://codeload.github.com/yongjinsim-sudo/dv-quick-run/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yongjinsim-sudo%2Fdv-quick-run/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32418295,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-29T06:29:02.080Z","status":"ssl_error","status_checked_at":"2026-04-29T06:29:00.631Z","response_time":110,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["crm","dataverse","dataverse-api","dataverse-query","developer-tools","dynamics365","odata","power-platform","vscode","vscode-extension"],"created_at":"2026-03-10T01:09:44.386Z","updated_at":"2026-05-10T12:29:38.000Z","avatar_url":"https://github.com/yongjinsim-sudo.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# DV Quick Run\n\nA fast, metadata-aware Dataverse query and workflow workbench for VS Code — with guided traversal, `$batch` execution, preview-first refinement, Smart PATCH, and execution-aware insights with grouped investigation.\n\n**Run, understand, explore, refine, safely update, and diagnose Dataverse execution behaviour — with Query-by-Canvas, Guided Traversal, Smart PATCH, `$batch` workflows, and Execution Insights — without leaving your editor.**\n\n---\n\n## 🚀 What is DV Quick Run?\n\nDV Quick Run turns VS Code into a **Dataverse developer console**.\n\nInstead of switching between Postman, browser tabs, and maker portals, you can:\n\n* Write queries\n* Run them instantly\n* Explore results in a table\n* Investigate records\n* Refine queries safely using Query-by-Canvas (preview-first)\n* Safely update records with Smart PATCH (preview-first)\n* Navigate relationships step-by-step (Guided Traversal)\n* Enrich results without rewriting queries\n* Inspect execution behaviour using correlation-based Execution Insights\n\nAll inside VS Code — with a preview-first, user-controlled workflow.\n\n---\n\n## 🆕 What's New in v0.9.15 (Operational Investigation Surfaces \u0026 UX Refinement)\n\n\u003e A focused **operational investigation release** — introducing Operational Profiles, operational density classification, evidence-backed investigation links, and entity-level orchestration visibility without introducing speculative telemetry or root-cause scoring.\n\n---\n\n### 🧭 Operational Profiles (EXPANDED)\n\nDV Quick Run now introduces **Operational Profiles** — a new entity-scoped investigation surface designed to help engineers quickly understand the operational complexity surrounding a Dataverse table.\n\nOperational Profiles surface:\n\n* plugin orchestration density\n* relationship complexity\n* metadata footprint\n* async activity\n* Power Automate participation\n* workflow participation\n* managed-state context\n\n—all directly inside the Result Viewer.\n\nInstead of manually stitching together metadata, plugin registrations, async operations, and workflows across multiple tools —\n\nDV Quick Run now provides a bounded, evidence-backed operational overview in one place.\n\n---\n\n### 📊 Operational Density Classification (REFINED)\n\nOperational Profiles now classify entities using bounded operational density signals:\n\n* 🟢 Low Operational Density\n* 🟡 Moderate Operational Density\n* 🔴 High Operational Density\n\nSignals include:\n\n* synchronous plugin registrations\n* relationship counts\n* attribute counts\n* async activity\n* orchestration participation\n\nThresholds were tuned to avoid over-classifying normal entities as “high complexity.”\n\n👉 Results in:\n\n* more trustworthy operational guidance\n* clearer differentiation between lightweight and orchestration-heavy entities\n* reduced false-positive complexity signals\n\n---\n\n### 🔗 Evidence-Backed Investigation Links (NEW)\n\nOperational Profiles now include direct investigation actions:\n\n* View plugin steps\n* View relationships\n* View columns\n* View async operations\n* View flows\n* View workflows\n\nEach action launches a concrete investigation query directly inside DV Quick Run.\n\nExamples:\n\n* `sdkmessageprocessingsteps`\n* `asyncoperations`\n* `workflows`\n\n👉 Results in:\n\n* faster investigation flow\n* smoother transition from signal → evidence\n* reduced manual query construction\n\n---\n\n### ⚡ Async Operation Visibility (Expanded)\n\nOperational Profiles now surface bounded async-operation participation signals.\n\nDV Quick Run can now:\n\n* detect recent async activity\n* distinguish no activity vs operational participation\n* surface recent async investigation paths safely\n\nAsync investigation remains:\n\n* bounded\n* entity-scoped\n* advisory-only\n\n👉 Results in:\n\n* clearer execution visibility\n* safer async investigation workflows\n* reduced historical noise\n\n---\n\n### 🧠 Managed State Awareness (NEW)\n\nOperational Profiles now surface managed-state participation as governance/deployment context.\n\nBehaviour:\n\n* managed entities → surfaced as “Managed”\n* unmanaged entities → “No evidence observed”\n\nDV Quick Run intentionally avoids implying:\n\n* managed = healthy\n* unmanaged = risky\n\n👉 Results in:\n\n* clearer operational semantics\n* reduced interpretation ambiguity\n* safer governance signalling\n\n---\n\n### 🧩 Operational Profile UX\n\nOperational Profiles were refined to reinforce:\n\n* strongest operational signals first\n* evidence-backed interpretation\n* advisory-only investigation guidance\n* bounded operational reasoning\n* progressive disclosure over overload\n\nThe UI emphasises:\n\n* operational density\n* investigation entry points\n* evidence hierarchy\n* orchestration visibility\n* calmer scan-first investigation flow\n\nAdditional refinement work focused on:\n\n* tighter section spacing\n* collapsed-by-default evidence and guidance sections\n* clearer suggested investigation actions\n* stronger signal-first scanning\n* reduced operational noise\n\n…without introducing speculative telemetry scoring or hidden analysis behaviour.\n\n---\n\n### 🧭 Suggested Investigation Actions (NEW)\n\nOperational Profiles now surface actionable investigation entry points directly inside the profile.\n\nExamples:\n\n* View plugin registrations\n* Investigate async operations\n* Review relationship footprint\n* View business rules\n\nActions are:\n\n* entity-scoped\n* bounded\n* evidence-backed\n* investigation-oriented\n\n👉 Results in:\n\n* faster transition from signal → investigation\n* less manual query construction\n* clearer operational workflow guidance\n\n---\n\n### 📂 Progressive Disclosure UX Refinement (NEW)\n\nOperational Profile sections now open in a calmer, investigation-first state.\n\nChanges include:\n\n* Evidence collapsed by default\n* Suggested Investigation Actions collapsed by default\n* Investigation Guidance collapsed by default\n* Future Investigation Surfaces collapsed by default\n\nBehaviour:\n\n* strongest operational signals remain immediately visible\n* deeper operational evidence becomes progressively explorable\n* avoids overwhelming users during first scan\n\n👉 Results in:\n\n* faster visual comprehension\n* cleaner operational scanning\n* reduced cognitive overload\n\n---\n\n### 🔮 Future Investigation Surfaces (NEW)\n\nOperational Profiles now introduce roadmap visibility for upcoming investigation capabilities.\n\nCurrent roadmap surfaces include:\n\nFree roadmap:\n\n* Custom API Discovery\n* Cross-surface investigation pivots\n\nPro roadmap:\n\n* Operational Profile drift comparison\n* Cross-environment operational comparison\n* Deployment operational impact analysis\n\nBehaviour:\n\n* roadmap items are informational only\n* hover descriptions explain future capability intent\n* no hidden execution or inaccessible behaviour\n\n👉 Results in:\n\n* clearer product direction\n* stronger platform identity\n* better user understanding of future operational workflows\n\n---\n\n### 🔗 Relationship Investigation Workflow Refinement\n\nImproved relationship investigation handling:\n\n* safer relationship export workflow\n* save dialog prompt support\n* cleaner transition into Relationship Explorer workflows\n\n👉 Results in:\n\n* more predictable export behaviour\n* smoother relationship investigation flow\n* better compatibility across environments\n\n---\n\n### 🧪 Dogfooding \u0026 Validation\n\nOperational Profiles were validated against:\n\n* lightweight entities\n* orchestration-heavy healthcare entities\n* plugin-heavy custom entities\n* sparse/system entities\n* async-heavy investigation scenarios\n\nValidation focused on:\n\n* operational truthfulness\n* advisory correctness\n* evidence consistency\n* avoiding root-cause implication\n* balanced operational density thresholds\n\n---\n\n## 🧭 Notes\n\nThis release extends DV Quick Run’s direction from:\n\n* execution-aware diagnostics\n\n→ to:\n\n* operationally-aware investigation guidance\n\nKey principles reinforced:\n\n* evidence before interpretation\n* strongest operational signals first\n* bounded investigation behaviour\n* no speculative causality\n* advisory-only operational guidance\n* operational density is not root cause\n\n---\n\n## 🎯 Summary\n\nDV Quick Run can now:\n\n* surface operational density for Dataverse entities\n* expose orchestration participation clearly\n* provide evidence-backed investigation entry points\n* suggest contextual investigation actions\n* distinguish lightweight vs operationally dense entities\n* guide operational investigation without making root-cause claims\n* surface future investigation roadmap directions without interrupting the workflow\n\n👉 Further strengthens the foundation for:\n\n* future operational reasoning layers\n* execution-aware entity profiling\n* cross-source operational investigation\n* operational comparison workflows\n* deployment-aware operational analysis\n* deeper Power Platform operational diagnostics\n\n---\n\n## 🎬 Result Viewer\n\n![DV Quick Run Result Viewer](docs/demo-result-viewer.gif)\n\nTypical workflow:\n\nstart simple → run → explore → refine (Query-by-Canvas) → update safely (Smart PATCH) → refresh → repeat\n\n---\n\n## ⚡ Quick Start\n\n1. Install **DV Quick Run**\n2. Login:\n\n   ```\n   az login --allow-no-subscriptions\n   ```\n3. Configure your Dataverse environment\n4. Run a query:\n\n   ```\n   contacts?$top=10\n   ```\n\n---\n\n## ✨ Key Features\n\n### 🔎 Run \u0026 Explore Queries\n\n* Run Dataverse queries (OData \u0026 FetchXML) directly in VS Code\n* View results in an interactive table or JSON\n* Sort, filter, inspect, copy, and act on data inline\n\n---\n\n### ✏️ Smart PATCH\n\n* Update Dataverse records directly from the Result Viewer\n* Preview PATCH payloads before applying changes\n* Use metadata-aware inputs for boolean and choice fields\n* Automatically refresh results after successful updates\n* Prevent unsafe updates on expanded / related fields\n\n---\n\n### 🔗 Guided Traversal + Enrichment\n\n* Traverse relationships step-by-step across Dataverse tables\n* Continue traversal using real data (row-driven)\n* Enrich results in-place using **Sibling Expand**\n* Build complex multi-entity queries without manual `$expand`\n\n---\n\n### 📊 Execution Insights (Runtime Diagnostics)\n\nUnderstand what’s happening **behind your Dataverse queries** — without leaving VS Code.\n\nDV Quick Run surfaces **execution behaviour across plugins, async operations, and workflows** directly in the Result Viewer:\n\n- Detect slow, failed, waiting, and repeated execution behaviour  \n- Distinguish normal behaviour vs potential issues (same request vs cross-request)  \n- See impact and recommended next steps instantly  \n- Drill into raw trace and execution data when deeper debugging is needed  \n\nInstead of manually querying `plugintracelogs`, `asyncoperations`, correlating requests, and scanning raw data across multiple tools —\n\nDV Quick Run surfaces the most important execution signals instantly, and lets you drill deeper only when needed.\n\n---\n\n#### 🧠 Primary Signal Reasoning\n\nExecution Insights now prioritises the strongest execution pattern first, then surfaces supporting evidence underneath.\n\nInstead of presenting disconnected diagnostics equally, DV Quick Run guides you toward the most important execution behaviour to investigate first.\n\nExamples include:\n- repeated background execution\n- recurring async operations\n- nested plugin chains\n- repeated cross-request execution patterns\n\n![Primary Signal 1](docs/execution-insights-primary-1.png)\n\n---\n\n#### 🔗 Guided Investigation Flow\n\nExecution Insights now provides structured investigation guidance directly inside the Result Viewer.\n\nDV Quick Run helps connect:\n- async operations\n- plugin traces\n- workflow context\n- correlation identifiers\n\n…into a more coherent debugging workflow.\n\nInstead of manually stitching together execution context across multiple tools, you can progressively investigate execution behaviour directly from the insight surface.\n\n![Guided Investigation 1](docs/execution-insights-next-1.png)\n\n---\n\n### 🧭 Operational Profiles (Entity Investigation)\n\nUnderstand the **operational footprint** of a Dataverse entity before diving into execution troubleshooting.\n\nDV Quick Run now surfaces **Operational Profiles** directly inside the Result Viewer:\n\n* plugin orchestration density\n* relationship complexity\n* metadata footprint\n* async participation\n* Power Automate involvement\n* workflow participation\n* managed-state context\n\nInstead of manually inspecting metadata, relationships, plugin registrations, workflows, and async operations separately —\n\nDV Quick Run provides a bounded, evidence-backed operational investigation surface in one place.\n\nOperational Profiles help answer questions like:\n\n* “Is this entity operationally dense?”\n* “Is this table heavily orchestrated?”\n* “Should I investigate plugins first?”\n* “Does this entity participate in async execution?”\n* “Is this likely to produce investigation noise?”\n\nAll without implying speculative root cause.\n\n![Operational Profile](docs/entity-profile-card.png)\n\n---\n\n#### 🔗 Evidence-Backed Investigation Actions\n\nOperational Profiles include direct investigation links for:\n\n* plugin registrations\n* relationships\n* columns\n* async operations\n* Power Automate flows\n* workflows\n\nEach investigation action launches a real Dataverse query directly inside DV Quick Run.\n\nExamples include:\n\n* `sdkmessageprocessingsteps`\n* `asyncoperations`\n* `workflows`\n\n👉 Results in:\n\n* faster operational investigation\n* reduced manual query construction\n* smoother signal → evidence workflows\n\n---\n\n#### 🧠 Advisory-Only Operational Guidance\n\nOperational Profiles are intentionally:\n\n* entity-scoped\n* user-triggered\n* evidence-backed\n* bounded\n* advisory-only\n\nDV Quick Run intentionally avoids:\n\n* speculative causality\n* hidden scoring systems\n* synthetic operational narratives\n* unsupported root-cause claims\n\nThe goal is:\n\n* better investigation starting points\n* clearer operational awareness\n* safer execution reasoning\n* stronger evidence transparency\n\n---\n\n### 🧠 Explain Query + Query Doctor\n\n* Break queries into human-readable explanations\n* Understand filters, sorting, and structure instantly\n\n**Query Doctor (Intelligent Diagnostics):**\n\n* Analyse your query and detect issues\n* Get prioritised diagnostics with confidence scoring\n* Receive actionable **Suggested Fixes** with examples\n\nTurn this:\n  accounts?$expand=primarycontactid\n\nInto:\n\n* what the query does\n* what’s missing\n* how to improve it\n\nAll directly inside VS Code.\n\n---\n\n### 🔍 Investigate Record\n\n* Select a GUID → investigate instantly\n* Works on:\n  - primary keys\n  - surfaced business GUID fields in results\n* See:\n  - relationships\n  - structured summary\n  - **interpretation (what this record likely represents)**\n  - suggested queries\n\n---\n\n### ⚡ Smart Query Helpers\n\n* Build queries and updates (GET / PATCH) with guided prompts\n* Incrementally refine queries ($select, $filter, $expand, $orderby)\n* Generate queries from JSON\n\n---\n\n### 🧬 Metadata Intelligence\n\n* Hover to see field metadata\n* Resolve choice labels automatically\n* **Refine filter values inline (preview-first)**\n* Explore entity relationships\n\n---\n\n### 🌍 Environment Support\n\n* Work across DEV / UAT / PROD\n* Safe environment switching\n* Environment-aware metadata caching\n\n---\n\n## 🛡 Guardrails\n\nDV Quick Run detects risky query, mutation, and diagnostic scenarios — such as missing `$top`, unsafe PATCH contexts, unsupported expanded-field updates, broad result analysis, or unavailable plugin trace access — and guides you before execution.\n\n---\n\n## 👥 Who Is This For?\n\n* Dataverse / Dynamics 365 developers\n* Power Platform engineers\n* Integration / API developers\n\n---\n\n## 💡 Why DV Quick Run?\n\nBecause the fastest workflow is:\n\n**write → run → explore → refine → update → verify → repeat**\n\n…without leaving your editor.\n\n---\n\n## 🔧 Development\n\n```\nnpm install\nnpm run compile\n```\n\nPress **F5** to run the extension.\n\n---\n\n## 📜 License\n\nMIT License\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyongjinsim-sudo%2Fdv-quick-run","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyongjinsim-sudo%2Fdv-quick-run","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyongjinsim-sudo%2Fdv-quick-run/lists"}