diff --git a/docs/migrations/azurefunctions/MIGRATION-PLAN.md b/docs/migrations/azurefunctions/MIGRATION-PLAN.md index 4c4ecdc9..35445f92 100644 --- a/docs/migrations/azurefunctions/MIGRATION-PLAN.md +++ b/docs/migrations/azurefunctions/MIGRATION-PLAN.md @@ -18,11 +18,12 @@ with the reviewer. ## How to read this plan -- Slices are ordered bottom-up: models and clients, then trees, commands, - local development, scaffolding, creation/deploy, and manifest cleanup. Each - slice must lint, build, and test before the next starts. -- Each slice opens with its mapping record: pattern, target files, precedent, - shared-primitive sweep, activation, external facts, and tree contract. Sweep +- Active slices are ordered bottom-up: models and clients, then trees, + commands, local development, creation/deploy, and manifest cleanup. + Slice 5 scaffolding is deferred. Each implementation slice must lint, + build, and test before the next starts. +- Each active implementation slice opens with its mapping record: pattern, + target files, precedent, shared-primitive sweep, activation, external facts, and tree contract. Sweep lines record the searches made while planning; Phase 5 re-runs the sweep immediately before each slice is written. - Context values below are new names derived from the command set; source @@ -64,15 +65,17 @@ Target files: packages/azutils/src/rest/clients/WebAppClient.ts (extend) packages/azutils/src/rest/clients/LogsQueryClient.ts (new) extensions/vscode-azure/src/tree/resources/webApp/FunctionApp.ts (new: guard + virtual function model) Precedent: StaticWebAppClient.ts (minimal surface, toPages), StaticWebApp virtual environment/function models -Sweep: reused IWebAppClient/WebAppClient, createArmRestSubscriptionClient, toPages, FunctionAppLogicalType, - makeVirtualResource (tests). Searched "admin/functions", "masterKey", "hostKeys", "LogsQuery", - "monitor-query", "applicationInsights": none exist -> new FunctionsHostClient and LogsQueryClient in azutils - (shared; a Container Apps migration would reuse LogsQueryClient). +Sweep: reused IWebAppClient/WebAppClient, createArmRestSubscriptionClient, createDataPlaneRestClient, + EnvironmentLike.logAnalyticsEndpoint, parseAzureResourceId, toPages, FunctionAppLogicalType, makeVirtualResource, + createMockWebAppClient, pagesOf, collectPages, MockHttpClient, and createTestActionExecutor. + Searched "admin/functions", "masterKey", "hostKeys", "LogsQuery", "monitor-query", + "applicationInsights", "RestError", and "response.status": no host or query client exists. + FunctionsHostClient and LogsQueryClient use the shared data-plane pipeline; assertRestSuccess + supplies body-free HTTP failures for both. No new dependency is needed. Activation: none -External facts: Functions admin API paths (`/admin/functions`, `/admin/host/status`) and key APIs (listHostKeys, - listFunctionKeys, listFunctionSecrets) -- verify against the pinned source client code and the - @azure/arm-appservice API surface before writing. Log query SDK package name -- verify the current - published Azure Monitor query package on npm before adding the dependency. +External facts: Functions host controllers and wire models; @azure/arm-appservice v19 modular operations and + deserializers; Azure Monitor resource/workspace query paths and partial-error response contract. + See verified sources below. Client: re-export every SDK type used in the wrapper APIs from azutils ``` @@ -90,6 +93,32 @@ Client: re-export every SDK type used in the wrapper APIs from azutils - [ ] Unit tests with `MockHttpClient` through each client's `create()` options. +### Slice 0 contracts and verified sources + +- `FunctionsHostClient` takes either a loopback port or an HTTPS origin and + lazy master-key callback. Remote callers obtain the key through + `IWebAppClient.webApps.listHostKeys`; the client sends it in + `x-functions-key` and rejects redirects. Function listing, status, and + invocation follow the host's + [FunctionsController](https://github.com/Azure/azure-functions-host/blob/dev/src/WebJobs.Script.WebHost/Controllers/FunctionsController.cs), + [HostController](https://github.com/Azure/azure-functions-host/blob/dev/src/WebJobs.Script.WebHost/Controllers/HostController.cs), + and [FunctionMetadataResponse](https://github.com/Azure/azure-functions-host/blob/dev/src/WebJobs.Script.WebHost/Models/FunctionMetadataResponse.cs). + Invocation acceptance is HTTP 202, not completion of function execution. +- Web App operations reuse the installed `@azure/arm-appservice` v19 + modular SDK. Its [Web Apps API](https://learn.microsoft.com/javascript/api/@azure/arm-appservice/webapps?view=azure-node-latest) + covers lifecycle, function listing/deletion, and key/secret operations. + Paged function listings use `toPages`. +- `LogsQueryClient` exposes + [resource-context queries](https://learn.microsoft.com/azure/azure-monitor/logs/api/azure-resource-queries) + and [workspace queries](https://learn.microsoft.com/azure/azure-monitor/logs/api/request-format) + through the shared REST pipeline and the subscription's + `logAnalyticsEndpoint`. It preserves table schemas and JSON cells and + rejects malformed responses and + [partial query errors](https://learn.microsoft.com/azure/azure-monitor/logs/api/response-format). +- Both client factories are registered lazily by `registerFunctions`. + This slice supplies contracts for subsequent tree, command, and debugging + slices; it contributes no new user commands or activation events. + ## Slice 1 -- Remote tree ``` @@ -99,19 +128,34 @@ Target files: extensions/vscode-azure/src/tree/resources/webApp/WebAppDataProv extensions/vscode-azure/src/products/registerFunctions.ts (register) Precedent: StaticWebAppDataProvider / StaticWebAppViewProvider (virtual children, explicit invalid nodes) Sweep: reused getSettingsNodes + WebAppSettingsAdapter, setWebsiteUrl, createGenericResourceTreeItem, - AzureNodeId, IAzureViewDataTree, RefreshResourcesView, ResourceSelector, resource listing/enrich. + AzureNodeId, IAzureViewDataTree, RefreshResourcesView, ResourceSelector, resource listing/enrich, + collectPages, pagesOf, rejectingAsyncIterable, createMockHierarchicalDataItemTree, + createMockWebAppClient (additive Site overrides), makeSettingsResource, makeVirtualResource. Searched "invalid", "errorNode", "createErrorItem" in tree/ -> follow the SWA explicit-invalid pattern. + Searched "makeFunction", "functionEnvelope", "httpTrigger" in testing -> no remote metadata + factory; added makeFunctionEnvelope to the azutils testing barrel and remote tree fixtures + alongside the extension's Web App tests. Activation: none (existing resources view) -External facts: none -Tree contract: Function App node: combineContextValues(browseWebsite, viewProperties, editSettings, - startWebApp|stopWebApp (by state), restartWebApp, deployFunctionApp (azd-tagged only), - streamFunctionLogs, revealIdentity (when an identity is assigned)). - Functions group node: no actions except refresh. - Remote function node: executeFunction, copyFunctionUrl (HTTP triggers), enableFunction|disableFunction - (by state), deleteFunction. - Invalid function / invalid app nodes: no actions except refresh. +External facts: Flex detection by site.functionAppConfig and HTTP auth-level normalization verified against + the pinned source's ResolvedFunctionAppResource.ts and funcConfig/function.ts (links below). + Shared refresh remains global for both title and context menus: VS Code forwards the focused + tree element to title actions, so a key alone cannot distinguish those entry points. +Tree contract: Function App node: resourceContextValue plus product, reported running/stopped, Flex, and + RefreshResourcesView.ContextValue markers. Shared settings remain a separate child. + Functions group node: RefreshResourcesView.ContextValue only. + Remote function node: enabled/disabled markers plus RefreshResourcesView.ContextValue; + trigger and HTTP access level retained in the model and presentation. + Invalid function / invalid app nodes: RefreshResourcesView.ContextValue only, error tooltip. + Command capability context values and menus for start/stop/restart, execute/copy URL, + enable/disable/delete, deploy, logs, and identity are wired with their commands in Slice 2. ``` +Source contracts: +[site state and Flex](https://github.com/microsoft/vscode-azurefunctions/blob/801689c66f96b31bc9d7c79ff6cc8d65e41b6965/src/tree/ResolvedFunctionAppResource.ts), +[trigger, disabled flag and HTTP authentication](https://github.com/microsoft/vscode-azurefunctions/blob/801689c66f96b31bc9d7c79ff6cc8d65e41b6965/src/funcConfig/function.ts). +[VS Code title argument conversion](https://github.com/microsoft/vscode/blob/main/src/vs/workbench/api/common/extHostTreeViews.ts) +provides the focused element for a tree-view pane argument. + - [ ] Function App children: shared settings node, then a "Functions" group node (virtual resource) listing one node per function. <- FUNC-166, FUNC-168, FUNC-169, FUNC-173 @@ -121,27 +165,33 @@ Tree contract: Function App node: combineContextValues(browseWebsite, viewPrope carrying the error. <- FUNC-170, FUNC-180 - [ ] Wire shared refresh, listing, enrichment, and resource picking on the new nodes; no Functions-specific equivalents. <- FUNC-199, FUNC-200, FUNC-271 -- [ ] Unit tests with `createMockDataItemTree` / `makeGenericResource`. +- [ ] Behavioral tests with shared resource, client, and tree fixtures; real + `DataItemTree` error recovery; shared refresh/menu consistency. ## Slice 2 -- Remote commands ``` Pattern: @injectable() ManagedCommand with static ContextValue; shared commands consume node context values -Target files: extensions/vscode-azure/src/commands/webApp/{StartWebApp,StopWebApp,RestartWebApp}.ts (shared by all +Target files: extensions/vscode-azure/src/commands/webApp/WebAppLifecycle.ts (action-prefix aliases shared by all Microsoft.Web/sites kinds; ids vscode-azure/webApp/{start,stop,restart}) - extensions/vscode-azure/src/commands/functions/{ExecuteFunction,CopyFunctionUrl,EnableFunction, - DisableFunction,DeleteFunction,StreamFunctionLogs}.ts (ids vscode-azure/functions/) + extensions/vscode-azure/src/commands/functions/{ExecuteFunction,CopyFunctionUrl,SetFunctionState, + DeleteFunction,StreamFunctionLogs,RevealFunctionAppIdentity}.ts (bool-prefix enable/disable aliases) extensions/vscode-azure/src/commands/tree/RevealResource.ts (new shared, id vscode-azure/resources/reveal) - extensions/vscode-azure/src/utils/logStream/LogStreamTerminal.ts (new shared pseudoterminal) + extensions/vscode-azure/src/utils/logStream/LogStreamTerminal.ts (shared ACA/Functions pseudoterminal) + extensions/vscode-azure/src/tree/resources/webApp/FunctionAppLogStream.ts (query-session owner) Precedent: DeleteStaticWebAppEnvironment (virtual-node command + activity), BrowseWebsite (shared node capability) Sweep: reused DeleteAzureResource, BrowseWebsite, ViewProperties, EditSettings + WebAppSettingsAdapter (enable/disable writes AzureWebJobs..Disabled through it), OpenInPortal, ExternalError (#350), - IActionExecutor. Searched "Pseudoterminal", "createTerminal", "logstream", "streamLogs": none exist -> - new shared LogStreamTerminal. Searched "treeView.reveal", "revealResource", "reveal(": only - RevealInExplorer (workspace files) -> new shared RevealResource for ARM IDs. + IActionExecutor, ResourceSelector, AzureNodeId.forRelatedResource, abortable delay, CaselessMap. + Reused ACA's pseudoterminal via LogStreamTerminal and related-resource navigation via RevealResource; + ACA consumes both shared primitives. Reused mock entity factories, MockHttpClient, ManualTimers, + respondToPrompts, real listing/activity services. Promoted ACA's terminal fixture to MockTerminal in + the utils testing barrel. Searched live generic-resource reads: added ResourceClient.resources.getById + using its existing provider API-version resolution. Searched instrumentation-key parsing and + Application Insights discovery: none exists; the product log service owns those operations. Activation: none -External facts: `AzureWebJobs..Disabled` setting name; App Insights `traces` / `requests` tables and - ingestion latency -- verify against Azure Functions and Azure Monitor docs before writing user-facing text. +External facts: Verified disable setting, host acceptance/master-key header, connection-string grammar, resource queries, + workspace/classic table names, ingestion delay, and approximate ingestion ordering against the sources below. Tree contract: per Slice 1; menu entries in view/item/context with word-boundary regexes. ``` @@ -157,35 +207,60 @@ Tree contract: per Slice 1; menu entries in view/item/context with word-boundar - [ ] Stream logs: shared `LogStreamTerminal` polling `LogsQueryClient` for the app's Application Insights resource (resolved from `APPLICATIONINSIGHTS_CONNECTION_STRING`); closing the terminal stops polling. - Shape it for reuse by a Container Apps migration. <- FUNC-065 + Container Apps also uses the shared terminal. <- FUNC-065 - [ ] Reveal the identity a Function App uses: shared `RevealResource` that reveals a resource by ARM ID in the resources view. <- FUNC-171 - [ ] Wire shared delete, browse, and properties on the Function App node, and shared settings add/edit/rename/delete through the settings document. <- FUNC-059, FUNC-063, FUNC-064, FUNC-072, FUNC-075, FUNC-076, FUNC-077 - [ ] Manifest entries (commands, `view/item/context`, `commandPalette` - `never` for node-only commands) + `package.nls.json` strings. + `when: false` for node-only commands) + `package.nls.json` strings. - [ ] Unit tests per command with `createMockCodeContext()` and real `ActionExecutor`. +Slice 2 external contract sources: + +- [Disable and enable Functions](https://learn.microsoft.com/en-us/azure/azure-functions/disable-function). +- [Host admin invocation](https://github.com/Azure/azure-functions-host/blob/dev/src/WebJobs.Script.WebHost/Controllers/FunctionsController.cs) + and [manual invocation](https://learn.microsoft.com/en-us/azure/azure-functions/functions-manually-run-non-http). +- [Application Insights connection strings](https://learn.microsoft.com/en-us/azure/azure-monitor/app/connection-strings). +- [Resource-context queries](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/api/azure-resource-queries), + [AppTraces](https://learn.microsoft.com/en-us/azure/azure-monitor/reference/tables/apptraces), + [AppRequests](https://learn.microsoft.com/en-us/azure/azure-monitor/reference/tables/apprequests), + and [standard log columns](https://learn.microsoft.com/en-us/azure/azure-monitor/logs/log-standard-columns). +- [Functions telemetry and ingestion delay](https://learn.microsoft.com/en-us/azure/azure-functions/analyze-telemetry-data) + and [approximate ingestion-time ordering](https://learn.microsoft.com/en-us/kusto/query/ingestion-time-function?view=azure-monitor). + ## Slice 3 -- Workspace tree (local functions) ``` Pattern: WorkspaceDetector tags + workspace DataProvider/ViewProvider Target files: extensions/vscode-azure/src/tree/workspace/functions/{FunctionsWorkspaceDataProvider, FunctionsWorkspaceViewProvider}.ts (extend); tree/workspace/WorkspaceNode.ts (local function node) + extensions/vscode-azure/src/functions/{FunctionsProjectReader,LocalFunctionSettings,LocalFunctionTarget}.ts + extensions/vscode-azure/src/functions/host/LocalFunctionsHostTracker.ts Precedent: FunctionsWorkspaceDataProvider (project nodes), AZD workspace provider Sweep: reused IWorkspaceIndexService (its FileSystemWatcher drives refresh), functionsDetector, createTag, - RevealInExplorer, RefreshWorkspaceView. Searched "function.json", "listFunctions", "buildOutput": none - exist -> local listing lives in the Functions workspace provider. + RevealInExplorer, RefreshWorkspaceView, readText, dirname/basename/relativePath, JsoncSettingsFormat, + jsonc-parser edits, isFunctionTriggerBinding, FunctionsHostClient, and Slice 2 command aliases. + Tests reuse createMockCodeContext, createTestActionExecutor, ManualDebounceScheduler, + createMockFunctionsHostClient, makeFunctionsProjectNode, and the real index/DataItemTree. + Searched local listing, generated-output readers, and host ownership: no shared implementations. + Product services keep those contracts outside providers; shared index exclusions stay intact. Activation: none (existing workspace index; no workspaceContains event) -External facts: where precompiled (.NET isolated, Java) function metadata lands after build (`functions.metadata`, - `function.json` under the output folder) -- verify against Core Tools v4 output before writing. -Tree contract: Local project node: revealInExplorer, createFunction, deployProject, initProject (when not initialized). - Local function node: executeFunction, copyFunctionUrl (HTTP; host running), enableFunction|disableFunction. +External facts: verified Worker SDK output copying, Java Maven staging and function metadata, Node v3/v4 programming + models, host invocation templates, and local settings against the sources linked below. +Tree contract: Local project node: revealInExplorer, refreshWorkspace (invalid: refresh only). + Local function node: executeFunction (ready registered host), copyFunctionUrl (HTTP; ready host), + enableFunction|disableFunction, refreshWorkspace, revealInExplorer when a source URI is available. Hint and invalid nodes: no actions except refresh. ``` +**Action dependencies approved by the reviewer:** Slice 4 owns initialization +and debugging; creation/welcome actions are deferred with Slice 5. +Missing-runtime state offers initialization. The process owner populates the ready-host registration +after HTTP readiness and releases it when the host stops. + - [ ] List functions directly under the project node (no group node): from `function.json` for script-model projects, from build output for precompiled projects, and from the running host otherwise. Closes @@ -196,16 +271,32 @@ Tree contract: Local project node: revealInExplorer, createFunction, deployProj - [ ] Hint nodes: "Run build task to update this list..." and "Start debugging to update this list...". <- FUNC-187, FUNC-188 - [ ] Invalid local function and invalid local project nodes. <- FUNC-186, FUNC-191 -- [ ] Uninitialized-project state with an "Initialize project..." action - (follows Slice 4's init design). <- FUNC-190 -- [ ] Empty workspace: `viewsWelcome` content pointing at create project. - <- FUNC-192 -- [ ] Refresh on `function.json` changes and host start/stop through the +- [ ] Missing-worker-runtime project state; initialization action is tracked + in Slice 4. <- FUNC-190 (presentation) +- [ ] Refresh on `function.json` changes, local settings, generated-output + changes/deletion, and host start/stop through the workspace index watcher and host tracking events. <- FUNC-198 - [ ] Local execute / copy URL / enable / disable reuse the Slice 2 commands against `FunctionsHostClient` (local) and `local.settings.json` values. <- FUNC-041, FUNC-042, FUNC-043, FUNC-044 -- [ ] Unit tests with the workspace index test fixtures. +- [ ] Unit/integration tests with shared fixtures and the real workspace + index/tree, including remote-command regression coverage and contribution + consistency checks. + +Listing bounds and output selection are documented in +[the product contract](../../products/functions.md#local-workspace-tree). +No custom output path, guessed port, source-language parser, settings +synchronization, or local settings tree is contributed. + +Verified external contracts: + +- [Worker SDK build-output metadata copying](https://github.com/Azure/azure-functions-dotnet-worker/blob/main/sdk/Sdk/Targets/Microsoft.Azure.Functions.Worker.Sdk.targets). +- [Maven staging directory](https://github.com/microsoft/azure-maven-plugins/blob/975dd140d802c0fcb4fd61f4083095e6d299f7be/azure-appservice-maven-plugin-lib/src/main/java/com/microsoft/azure/maven/appservice/AbstractAppServiceMojo.java) + and [generated function metadata](https://github.com/microsoft/azure-maven-plugins/blob/975dd140d802c0fcb4fd61f4083095e6d299f7be/azure-functions-maven-plugin/src/main/java/com/microsoft/azure/maven/function/PackageMojo.java). +- [Node programming models](https://learn.microsoft.com/en-us/azure/azure-functions/functions-reference-node?pivots=nodejs-model-v4). +- [Host metadata response and invocation template](https://github.com/Azure/azure-functions-host/blob/dev/src/WebJobs.Script.WebHost/Models/FunctionMetadataResponse.cs). +- [Local settings structure](https://learn.microsoft.com/en-us/azure/azure-functions/functions-develop-local#local-settings-file) + and [function disable flags](https://learn.microsoft.com/en-us/azure/azure-functions/disable-function). ## Slice 4 -- Local development (F5) @@ -224,31 +315,41 @@ Target files: extensions/vscode-azure/src/functions/debug/* (debug configurati extensions/vscode-azure/src/functions/host/* (host process, host tracking, pre-debug validation) Precedent: Container Tools debug providers (resolve to another debug type); tools/FuncInstaller + ToolService (Core Tools discovery). SWA debugging builds on this (#339). -Sweep: reused IProcessExecutor (packages/utils), createShellTask (packages/utils), CommandLineBuilder, - ToolService/FuncInstaller, IWorkspaceIndexService, ExternalError. Searched +Sweep: reused IProcessExecutor (packages/utils), createShellTask (packages/utils), ToolService/FuncInstaller, + IWorkspaceIndexService, LocalFunctionSettings, JsoncSettingsFormat, ExternalError, + createMockCodeContext/createMockVsCode, respondToPrompts, and the shared Functions index/tree fixtures. + Extended shared process execution with opt-in tree-kill cancellation and foreground resolver injection; + extracted createMockSpawn/createMockProcessExecutor and reused getMockTaskExecution. + Searched "registerDebugConfigurationProvider", "DebugConfigurationProviderTriggerKind", "onDidTerminateDebugSession", "CustomExecution": none exist -> new product code under functions/debug and functions/host. Activation: only the implicit events VS Code generates for a contributed `debuggers` entry; justify any explicit onDebug* entry in this record before adding it. -External facts: implicit activation for contributed debuggers; attach settings for node (`--inspect`), debugpy, java - (jdwp), PowerShell, and coreclr; `languageWorkers____arguments` env names; Core Tools - `--dotnet-isolated-debug` / `--enable-json-output` worker PID output; host readiness signal - (`/admin/host/status` or log line); Python extension environment and launcher APIs -- verify each against - the pinned source and the owning extension's or Core Tools' docs. +External facts: verified VS Code provider ordering against 7f1c8a96ce99bcffba134a7db3ef9b1f57d30ca0; + Core Tools host arguments/PID output against tag 4.15.2; Python environment public API; + Python Debugger launcher/path public API against 061023c85cf721731569c2d0d670c129fc1f45c4. + Native Go uses the Go extension's public tool API, Core Tools 4.15.2 native worker configuration + and GoHelpers, and headless Delve's remote DAP protocol. + Source links and per-language prerequisites are in docs/products/functions.md. ``` Resolution flow for one session: -1. Pick the Functions project from the workspace index (remembered per - workspace when a folder has several). +1. The initial hook normalizes the configuration; VS Code substitutes variables + and runs any configured `preLaunchTask`. The substituted-variable hook picks + the Functions project from the workspace index (remembered per workspace + when a folder has several). 2. Pre-debug validation; failures are `ExternalError`s. -3. Build with in-code tasks (`npm run build`, `dotnet build`, `mvn package`, +3. Build with in-code tasks (`npm run build`, `dotnet build`, `mvn package`, `go build`, dependency install), using VS Code's own `$tsc` / `$msCompile` matchers. + Skip this build when `skipBuild` or a replacement `preLaunchTask` applies. 4. Start `func host start` in an in-code pseudoterminal task with the worker debug arguments in its environment and a free debug port. -5. Wait for host readiness. +5. Wait for worker attach coordinates, bounded to 120 seconds. Paused workers + attach before full HTTP readiness; poll HTTP independently and register the + owned host only after its status is Running. 6. Return the attach configuration of the language's debug type; stop the host - when the session ends. + on attach failure, session end, task/terminal closure, or cancellation. - [ ] Contribute the `azure-functions` debugger (languages for the kept runtimes) and register its provider for initial and dynamic configurations, @@ -258,12 +359,26 @@ Resolution flow for one session: configuration in VS Code settings; it writes non-debug workspace files such as `.vscode/extensions.json` recommendations, and offers (never forces) the optional `launch.json` entry below. <- FUNC-030 +- [ ] Wire the local project initialization action and its initialization + state to the implemented initialization flow. <- FUNC-190 - [ ] Attach configurations for Node, Python (via the Python extension's launcher), Java, and PowerShell, with free debug ports. <- FUNC-210, FUNC-211, FUNC-212, FUNC-214, FUNC-268 - [ ] .NET isolated attach using the worker PID reported by `--dotnet-isolated-debug`, instead of a process picker. <- FUNC-033, FUNC-269 +- [ ] Native Go debugging: validate Go 1.24+ and Delve using the Go extension's + resource-scoped public tool API; compile `bin/app` (`app.exe` on Windows) + with `-gcflags=all=-N -l`, and start the native worker under headless Delve. + Reuse worker executable/argument overrides and the owned host's loopback + ports/readiness/process-tree cleanup. Return a Go remote DAP attach config; + custom handlers are excluded. Wire Go recommendations, native-runtime + initialization, debugger language contribution, and the workspace Debug action. + <- FUNC-140, FUNC-141, FUNC-195 +- [ ] Go behavioral coverage: prerequisites/build errors, paths with spaces, + skipped builds, loopback attach, readiness failure/cancellation/cleanup, and + initialization/tree capabilities. Live Go attach smoke check remains part + of Slice 7. <- FUNC-140, FUNC-141, FUNC-195 - [ ] Host process and tracking: build steps, start, readiness, port, terminal errors, stop on session end, and start/stop events for local listing and execute. <- FUNC-216 @@ -280,44 +395,53 @@ Resolution flow for one session: `preLaunchTask` that replaces the built-in build. Entries also serve compound launches. Omitted options fall back to the no-`launch.json` defaults. <- FUNC-030 -- [ ] Unit tests for configuration resolution and host tracking; integration - test for the attach path where the precedent allows. +- [ ] Unit tests for configuration resolution, build preparation, host tracking, + cancellation, and readiness failures; initialization integration tests against + the real index/tree; shared integration test terminating a real parent/worker + process tree. +- [ ] Live language attach-path smoke checks during Slice 7. The automated tests + cover all six configuration/API paths, not live language debugger sessions. + +Native Go protocol validation on Windows used the full Core Tools 4.15.2 +distribution, Go 1.26.2, Delve 1.27.2, and Go worker SDK v0.7.0-preview. +The exact host/worker invocation passed remote DAP attach, a verified HTTP +handler breakpoint, variable inspection, continue, and an HTTP response with +a project path containing repeated spaces. A binary hash check confirmed +that `--no-build` preserves the prepared debug binary. This protocol smoke +uses a DAP client, not the VS Code Go extension UI; live VS Code sessions, +storage/emulator integration, and Linux/macOS smoke checks remain in Slice 7. Existing projects' source-generated `tasks.json` / `launch.json` (task type `func`, `$func-watch`, `${command:azureFunctions.pickProcess}`) are left untouched: no compatibility registrations and no rewrite prompt. Users delete them or re-initialize. -## Slice 5 -- Project and function scaffolding - -``` -Pattern: ManagedCommand + Wizard PromptSteps wrapping Core Tools (`func init`, `func new`) through IProcessExecutor -Target files: extensions/vscode-azure/src/commands/functions/{CreateFunctionProject,CreateFunction}.ts + steps/ -Precedent: SWA `swa init` wrapping (CLI owns detection); CreateFunctionApp steps (PickRuntimeStep) -Sweep: reused ToolService/FuncInstaller, IProcessExecutor, CommandLineBuilder, workspace folder pick steps, - PickRuntimeStep/runtimesAndVersions. Searched "func init", "func new", "templates", "venv", - "createEnvironment": none exist -> new steps under commands/functions/steps. -Activation: none (palette + view commands) -External facts: `func init` worker-runtime / language flags for each kept language (JavaScript, TypeScript, Python v2, - dotnet-isolated, Java/Maven, PowerShell, custom), `func new --template` names, and whether Go can be - scaffolded without the source template feed -- verify against Core Tools v4 `func init --help` / - `func new --help` and docs. Python extension environment-creation command id -- verify. -``` - -- [ ] Create project: pick folder and language, run `func init`, open the - folder in the current window only (no cross-session resume). Local-only - commands carry `enablement: !virtualWorkspace`. <- FUNC-026, FUNC-004 -- [ ] Languages through `func init`: JavaScript, TypeScript, Python (v2; offer - the Python extension's environment creation instead of creating a venv - directly), C# .NET isolated, Java (Maven), PowerShell, custom handler. - <- FUNC-218, FUNC-219, FUNC-220, FUNC-221, FUNC-223, FUNC-224, FUNC-225 -- [ ] Go: scaffold as a custom handler if Core Tools supports it without the - source template feed; otherwise amend [TRIAGE.md](TRIAGE.md) and reconfirm. - <- FUNC-226 -- [ ] Create function: pick template and name from `func new`, prompt only for - the settings the template requires, then open the created file. - <- FUNC-028, FUNC-235, FUNC-236 -- [ ] Unit tests with `respondToPrompts()` and a mocked `IProcessExecutor`. +## Slice 5 -- Project and function scaffolding (deferred) + +Tracking: [#364](https://github.com/microsoft/vscode-azure/issues/364). + +Project creation (`func init`), add-function (`func new`), and gallery-backed +quickstarts (`func quickstart`) are outside the active migration scope. +The dependent language flows, template requirements/post-create integration, +and create-project welcome action are tracked under +[Deferred](#deferred----tracked-not-built). + +Future integration uses thin `ManagedCommand` entry points and shared +`ToolService` / `IProcessExecutor` services. CLI v5 owns catalogs, requirements, +validation, generated files, dependencies, and project configuration; the +extension owns folder selection, editor integration, cancellation/errors, and +preserving user-owned files. CLI v5 workload acquisition must be independent +of the implemented Core Tools v4 F5 contract. Shared tool support +(FUNC-021, FUNC-031, FUNC-217), local-only gates (FUNC-004), and initialization +of existing projects (FUNC-030, FUNC-190) remain in scope. + +Before future implementation, verify distributed CLI v5/workload versions, +language support, machine-readable discovery, noninteractive prompts, result +shapes, and compatibility with runtime v4 F5 and azd deployment. +Source evidence is Azure/azure-functions-core-tools at +`a0bdc299fa685fa530236c108f4715977c96a8f2` (`InitCommand.cs`, `NewCommand.cs`, +`QuickstartCommand.cs`, `QuickstartManifestOptions.cs`, +`JavaProjectInitializer.cs`); source support does not prove packaged availability. ## Slice 6 -- Creation and deployment (azd + Bicep) @@ -326,27 +450,28 @@ Pattern: Wizard + AzdJob (createNew / deploy), shared azd steps, Generate Target files: extensions/vscode-azure/src/commands/functions/CreateFunctionApp.ts + steps/ extensions/vscode-azure/src/commands/functions/DeployFunctionApp.ts (node deploy) extensions/vscode-azure/resources/templates/functionApp/main.bicep -Precedent: existing CreateFunctionApp, SWA creation (detection skips prompts), AzdDeployStep, ShowEndpointUrlStep +Precedent: existing CreateFunctionApp, SWA creation (detection skips prompts), AzdDeployStep Sweep: reused SelectIacFolderStep, HydrateAzdInfo, HydratableChooseSubscription/Location, ProjectName, PickRuntimeStep, ConfirmProvision, GenerateBicepStep, GenerateAzureYaml, CreateAzdEnv, AzdProvisionStep, - AzdDeployStep, ShowEndpointUrlStep, AzdService (service map by azd-service-name), activity tree - (CodeDeploymentDataProvider), DeleteAzureResource, ExternalError. + AzdDeployStep, AzdService (service map and target ARM IDs), activity tree + (CodeDeploymentDataProvider), DeleteAzureResource, ExternalError, IWebAppClientProvider, + parseAzureResourceId, ISubscriptionResolver, OpenUrl. + ShowFunctionEndpointsStep lists management-plane HTTP invocation templates. Activation: none External facts: azd service lookup by `azd-service-name` tag, verified against the azure.yaml v1.0 schema (`services.*.resourceName` description) on 2026-09-24; pattern-module parameters/outputs per the - provisioning decision below. -Wizard: SelectIacFolder -> HydrateAzdInfo -> subscription -> location -> ProjectName -> PickRuntime (skipped when + provisioning decision below. The azd show contract in cli/azd/pkg/contracts/show.go verifies + services.*.target.resourceIds; remote deploy requires an exact case-insensitive ARM ID match. +Wizard: SelectIacFolder -> HydrateAzdInfo -> DetectFunctionRuntime -> subscription -> location -> ProjectName -> PickRuntime (skipped when the project language is detected) -> ConfirmProvision; execute GenerateBicep -> GenerateAzureYaml -> - CreateAzdEnv -> AzdProvision (+ AzdDeploy -> ShowEndpointUrl for the deploy job). No hosting-plan, + CreateAzdEnv -> AzdProvision (+ AzdDeploy -> ShowFunctionEndpoints for the deploy job). No hosting-plan, authentication, or Flex sizing prompts: Flex FC1, managed identity, and module defaults answer them. ``` - [ ] Close creation gaps against the source flow; no advanced/existing- resource variant. <- FUNC-057 -- [ ] Delete `PickHostingPlanStep`, its test, and the non-FC1 - `AppServicePlanSku` values; stop passing `appServicePlanSkuName` to - `GenerateBicepStep` so the template's FC1 default applies (users change - plans in the Bicep). +- [ ] Provisioning fixes the module's `appServicePlanSkuName` to FC1. + `GenerateBicepStep` writes only runtime, version, and service-name parameters. <- FUNC-241 (FC1 from the existing template default; Premium/App Service removal per FUNC-242) - [ ] Managed identity only: no secrets or connection strings, no prompt @@ -361,11 +486,11 @@ Wizard: SelectIacFolder -> HydrateAzdInfo -> subscription -> location -> - [ ] Workspace deploy (`vscode-azure/functions/deploy` / azd from the project node). <- FUNC-047 - [ ] Node deploy for azd-tagged apps only: match the app's `azd-service-name` - to a workspace `azure.yaml` service and run `azd deploy `; otherwise + and ARM ID to the active workspace azd service and run `azd deploy `; otherwise explain and offer workspace deploy. <- FUNC-046 - [ ] `explorer/context` Deploy on a folder routes to workspace deploy. <- FUNC-202 -- [ ] Completion reported in the activity log; `ShowEndpointUrlStep` lists +- [ ] Completion reported in the activity log; `ShowFunctionEndpointsStep` lists HTTP trigger URLs. <- FUNC-255, FUNC-256 - [ ] Deleting a containerized Function App uses shared delete (applies once containerized apps return from Deferred). <- FUNC-258 @@ -389,11 +514,11 @@ module does not cover it). - **Parameter map:** `environmentName` -> `functionAppName` (`-func`); wizard runtime -> `functionWorkerRuntime`, `runtimeVersion`; `azdServiceName` -> `functionAppTags['azd-service-name']`; `appServicePlanSkuName` fixed to - `FC1` (the consumer parameter is removed); `autoGeneratedDomainNameLabelScope` - and portal CORS unchanged. `functionAppDefaultHostname` feeds - `ShowEndpointUrlStep`. + `FC1`; the template specifies `autoGeneratedDomainNameLabelScope` and portal + CORS. `ShowFunctionEndpointsStep` uses the deployed ARM IDs from `azd show` + to list actual HTTP invocation templates. -- [x] Pin the published `br/public` module in the templates. <- FUNC-249 +- [ ] Pin the published `br/public` module in the templates. <- FUNC-249 ## Slice 7 -- Manifest, reuse wiring, and documentation @@ -408,7 +533,9 @@ External facts: `https://json.schemastore.org/function.json` and `https://json.s ``` - [ ] `jsonValidation` for `function.json` and `host.json`. <- FUNC-008, FUNC-009 -- [ ] `enablement: !virtualWorkspace` on every retained local-only command. +- [ ] Trust and `!virtualWorkspace` enablement on dedicated local commands; + workspace-menu gates and programmatic project validation on the shared + local/remote function commands. <- FUNC-004 - [ ] Project detection stays on `functionsDetector`; no `workspaceContains` activation. Core Tools v5 may make `host.json` optional; @@ -419,14 +546,22 @@ External facts: `https://json.schemastore.org/function.json` and `https://json.s use `ExternalError`. <- FUNC-100 - [ ] GitHub / CI/CD setup uses the existing `vscode-azure/configureCicd` (`azd pipeline config`); no Functions-specific command. <- FUNC-055 -- [ ] No Functions settings are contributed: every source setting is Drop or - Defer in [TRIAGE.md](TRIAGE.md). +- [ ] No Functions settings are contributed. Go and Delve validation are + adapted as mandatory pre-debug checks without toggles; other source + settings are Drop or Defer in [TRIAGE.md](TRIAGE.md). <- FUNC-140, FUNC-141 - [ ] Product doc `docs/products/functions.md` (tree, commands, F5, creation, deploy constraints); framework docs get at most a link. - [ ] Full `pnpm run lint` / `build` / `test` sweep before the PR. ## Deferred -- tracked, not built +- [ ] Project/function scaffolding and gallery-backed quickstarts through + CLI v5 `func init` / `func new` / `func quickstart`: create-project welcome + content, JavaScript, TypeScript, Python environment/project creation, + .NET isolated, Java (including add-function), PowerShell, custom handlers, + and template requirements/post-create integration. <- FUNC-026, FUNC-028, + FUNC-192, FUNC-218, FUNC-219, FUNC-220, FUNC-221, FUNC-223, FUNC-224, + FUNC-225, FUNC-235, FUNC-236 - [ ] Deployment slots: deploy to slot, create/delete/swap, slot settings, slot tree nodes (Flex has no slots). <- FUNC-048, FUNC-069, FUNC-070, FUNC-071, FUNC-078, FUNC-178, FUNC-179 @@ -441,17 +576,23 @@ External facts: `https://json.schemastore.org/function.json` and `https://json.s - [ ] Containerized (Container Apps-hosted) Function Apps: Dockerfile projects, nodes, creation. Coordinate with the Container Apps migration. <- FUNC-027, FUNC-181, FUNC-250 -- [ ] Agent and MCP surfaces pending a monorepo-wide agent contract. - <- FUNC-007, FUNC-101, FUNC-228, FUNC-254 +- [ ] MCP project creation, key retrieval, and deployed server integration, + tracked in [#361](https://github.com/microsoft/vscode-azure/issues/361). + <- FUNC-101, FUNC-228, FUNC-254 - [ ] Host exceptions debugger view and its commands. <- FUNC-095, FUNC-096, FUNC-097, FUNC-098, FUNC-099, FUNC-196 - [ ] Revisit with Core Tools v5: stop host after debug, emulator validation, host start timeout. <- FUNC-137, FUNC-142, FUNC-144 - [ ] Storage emulator: storage connection prompts, Azurite settings and integration. <- FUNC-164, FUNC-176, FUNC-267 -- [ ] Go debugging and toolchain validation (Go scaffolding is Slice 5). - <- FUNC-140, FUNC-141, FUNC-195 -- [ ] Template Gallery and resource-backed binding settings (with their SDKs). +- [ ] Go scaffolding, tracked in + [#364](https://github.com/microsoft/vscode-azure/issues/364), and native Go + provisioning/runtime selection, tracked in + [#366](https://github.com/microsoft/vscode-azure/issues/366). + Code deployment uses the existing azd route. + <- FUNC-226 +- [ ] Template Gallery webview and resource-backed binding settings (with their SDKs), + tracked in [#365](https://github.com/microsoft/vscode-azure/issues/365). <- FUNC-208, FUNC-240, FUNC-265 ## Dropped -- recorded for parity @@ -476,8 +617,8 @@ External facts: `https://json.schemastore.org/function.json` and `https://json.s the debug provider): FUNC-203, FUNC-204, FUNC-205, FUNC-206, FUNC-207. - Settings sync, secrets, and system-assigned identity: FUNC-073, FUNC-074, FUNC-079, FUNC-080, FUNC-083, FUNC-183, FUNC-189. -- Agent deploy commands and MCP project setting: FUNC-104, FUNC-105, - FUNC-106, FUNC-107, FUNC-160. +- Agent metadata/deployment commands and MCP project setting: FUNC-007, + FUNC-104, FUNC-105, FUNC-106, FUNC-107, FUNC-160. - Source settings: FUNC-111, FUNC-112, FUNC-113, FUNC-114, FUNC-115, FUNC-116, FUNC-117, FUNC-118, FUNC-119, FUNC-120, FUNC-123, FUNC-124, FUNC-125, FUNC-126, FUNC-127, FUNC-128, FUNC-129, FUNC-130, FUNC-131, @@ -498,3 +639,199 @@ External facts: `https://json.schemastore.org/function.json` and `https://json.s | Date | Rebased onto | Swept result | |---|---|---| | 2026-09-24 | `dfc8edaf` (#350) | Adopt `ExternalError` (`packages/utils`) for user-actionable failures in Slices 2, 4, and 6 (node deploy on untagged apps, missing Core Tools, pre-debug validation). No other new shared surfaces; no slices landed yet. | +| 2026-10-08 | `8993a3c1` | Slice 0 intake sweep: reuse the shared data-plane REST factory and cloud-aware Log Analytics endpoint. Container Apps already owns its log-stream pseudoterminal; inspect that implementation before Slice 2 instead of assuming a terminal primitive is absent. | + +## Parity and wiring audit -- 2026-10-12 + +The three process artifacts are tracked. Their initial commit, `47de2cb4`, +precedes the provisioning update (`6d8e60e2`) and implementation slices. +All 271 IDs and inventory feature names match the original triage catalog; +approved disposition changes are reflected in the signed current triage. +The inventory's command, settings, tree, debug, wizard, and integration +families are covered by that catalog. + +| Signed disposition | IDs | Audited outcome | +|---|---:|---| +| Migrate | 25 | Landed and wired | +| Adapt | 27 | Landed with the approved target behavior | +| Reuse | 19 | 18 wired; one conditional shared capability (`FUNC-258`) | +| Drop | 136 | Source-specific feature absent; exact ID partition recorded under Dropped | +| Defer | 64 | Exact ID partition tracked under Deferred | +| Total | 271 | No missing or duplicate IDs | + +This is implementation and wiring coverage, not live debugger certification. +The live attach-path checkbox in Slice 4 remains open and user-owned. +The full repository pre-PR lint/build/test results are recorded below. + +### Kept-feature evidence + +Paths below are relative to `extensions/vscode-azure/src/`, unless prefixed +with `packages/` or explicitly described as an extension manifest. +Registration is in `products/registerFunctions.ts`, shared command +registration in `commands/registerCommands.ts`, and tree composition in +`tree/registerTrees.ts`. + +| ID | Feature | Signed disposition | Outcome | Evidence | +|---|---|---|---|---| +| FUNC-002 | Project detection | Reuse | Wired | `tree/workspace/functions/FunctionsWorkspaceDataProvider.ts`: `functionsDetector`; `utils/workspaceIndex/WorkspaceIndexService.ts` | +| FUNC-004 | Local workspace gates | Migrate | Landed | Extension `package.json` enablement/menu gates; `functions/FunctionsProjectSelector.ts`: `assertLocal`; `functions/LocalFunctionTarget.ts` | +| FUNC-008 | Function schema | Migrate | Landed | Extension `package.json`: `jsonValidation` for `function.json` | +| FUNC-009 | Host schema | Migrate | Landed | Extension `package.json`: `jsonValidation` for `host.json` | +| FUNC-021 | Core Tools version checks | Reuse | Wired on demand | `tools/ToolService.ts`, `tools/FuncInstaller.ts`; debug preparation supplies a v4 range | +| FUNC-030 | Existing-project initialization | Adapt | Landed without generated tasks | `commands/functions/InitializeFunctionsProject.ts`; optional debug entry and recommendations | +| FUNC-031 | Install/update Core Tools | Reuse | Wired | `commands/registerCommands.ts`: `vscode-azure/installFunc` -> `AcquireTool`; `extension.ts`: `FuncInstaller` binding | +| FUNC-033 | .NET process selection | Adapt | Landed inside owned F5 | `functions/host/LocalFunctionsHostProcess.ts`; `functions/debug/FunctionsDebugProvider.ts` | +| FUNC-041 | Execute function | Migrate | Landed locally and remotely | `commands/functions/ExecuteFunction.ts`; `functions/LocalFunctionTarget.ts` | +| FUNC-042 | Copy function URL | Migrate | Landed locally and remotely | `commands/functions/CopyFunctionUrl.ts`; current host/management metadata and access checks | +| FUNC-043 | Enable function | Migrate | Landed locally and remotely | `commands/functions/SetFunctionState.ts`; registration prefix argument `false` | +| FUNC-044 | Disable function | Migrate | Landed locally and remotely | `commands/functions/SetFunctionState.ts`; registration prefix argument `true` | +| FUNC-045 | Delete function | Migrate | Landed remotely | `commands/functions/DeleteFunction.ts`; confirmation, activity, and success-only cache removal | +| FUNC-046 | Function App node deployment | Adapt | Landed for verified azd service targets | `commands/functions/DeployFunctionApp.ts`; tag and current azd resource-ID matching | +| FUNC-047 | Workspace deployment | Adapt | Landed through azd | `commands/functions/DeployFunctionApp.ts`, `commands/functions/CreateFunctionApp.ts` | +| FUNC-055 | GitHub/CI/CD setup | Reuse | Wired through azd | `commands/deploy/ConfigureCicd.ts`; `azd/wizard/AzdPipelineConfigStep.ts` | +| FUNC-057 | Create Function App | Adapt | Landed through azd+Bicep | `commands/functions/CreateFunctionApp.ts`; `createNew` registration prefix argument | +| FUNC-059 | Delete Function App | Reuse | Wired | `commands/tree/DeleteAzureResource.ts`; `tree/contextValueHelpers.ts`: `resourceContextValue` | +| FUNC-060 | Start app | Migrate | Landed as shared Web App action | `commands/webApp/WebAppLifecycle.ts`; registration prefix argument `start` | +| FUNC-061 | Stop app | Migrate | Landed as shared Web App action | `commands/webApp/WebAppLifecycle.ts`; registration prefix argument `stop` | +| FUNC-062 | Restart app | Migrate | Landed as shared Web App action | `commands/webApp/WebAppLifecycle.ts`; registration prefix argument `restart` | +| FUNC-063 | Browse website | Reuse | Wired | `commands/tree/BrowseWebsite.ts`; enriched URL drives `resourceContextValue` | +| FUNC-064 | View properties | Reuse | Wired | `commands/tree/ViewProperties.ts`; `resourceContextValue` | +| FUNC-065 | Stream logs | Adapt | Landed as cancellable polling terminal | `commands/functions/StreamFunctionLogs.ts`, `tree/resources/webApp/FunctionAppLogStream.ts`; shared `utils/logStream/LogStreamTerminal.ts` | +| FUNC-072 | Add app setting | Reuse | Wired through JSONC editor | `settings/adapters/WebAppSettingsAdapter.ts`; shared `commands/settings/EditSettings.ts` | +| FUNC-075 | Edit app setting | Reuse | Wired through JSONC editor | `settings/adapters/WebAppSettingsAdapter.ts`; shared `SettingsFileSystemProvider` | +| FUNC-076 | Rename app setting | Reuse | Wired through JSONC editor | `settings/adapters/WebAppSettingsAdapter.ts`; shared JSONC document read-modify-write | +| FUNC-077 | Delete app setting | Reuse | Wired through JSONC editor | `settings/adapters/WebAppSettingsAdapter.ts`; shared JSONC document read-modify-write | +| FUNC-100 | Report Issue | Reuse | Wired through framework errors | `packages/utils/src/base/IActionExecutor.ts`: `ActionExecutor.showErrorToast`; `ExternalError` suppresses the issue action | +| FUNC-140 | Delve validation | Adapt | Landed without a setting | `functions/debug/FunctionsDebugPreparation.ts`: native worker validation | +| FUNC-141 | Go validation | Adapt | Landed without a setting | `functions/debug/FunctionsDebugPreparation.ts`: Go version validation | +| FUNC-166 | Function App node/state/Flex | Migrate | Landed | `tree/resources/webApp/FunctionAppViewProvider.ts`; `WebAppDataProvider` enrichment | +| FUNC-168 | Remote Functions group | Migrate | Landed beside settings | `tree/resources/webApp/WebAppDataProvider.ts`, `FunctionAppViewProvider.ts` | +| FUNC-169 | Remote function leaf | Migrate | Landed | `tree/resources/webApp/FunctionApp.ts`, `FunctionAppViewProvider.ts`; trigger/access/state capabilities | +| FUNC-170 | Invalid remote function | Migrate | Landed | `tree/resources/webApp/WebAppDataProvider.ts`, `FunctionAppViewProvider.ts`; refresh-only errors | +| FUNC-171 | Reveal attached identity | Adapt | Landed as navigation | `commands/functions/RevealFunctionAppIdentity.ts` -> shared `RevealResource` | +| FUNC-173 | App settings nodes | Reuse | Wired | `tree/resources/webApp/WebAppDataProvider.ts`: `getSettingsNodes`; `products/registerSettings.ts` | +| FUNC-180 | Invalid Function App | Migrate | Landed | `tree/resources/webApp/WebAppDataProvider.ts`: site errors; `FunctionAppViewProvider.ts`: invalid presentation | +| FUNC-182 | Local project node | Migrate | Landed | `tree/workspace/functions/FunctionsWorkspaceDataProvider.ts`, `FunctionsWorkspaceViewProvider.ts` | +| FUNC-184 | Local Functions grouping | Adapt | Landed as direct project children | `functions/FunctionsProjectReader.ts`; `FunctionsWorkspaceViewProvider.getChildren` | +| FUNC-185 | Local function leaf | Migrate | Landed | `functions/FunctionsProjectReader.ts`; `FunctionsWorkspaceViewProvider.ts` | +| FUNC-186 | Invalid local function | Migrate | Landed | `functions/FunctionsProjectReader.ts`; invalid metadata nodes rendered with refresh | +| FUNC-187 | Build-output listing hint | Migrate | Landed | `functions/FunctionsProjectReader.ts`; bounded .NET/Java output discovery | +| FUNC-188 | Host-listing hint | Migrate | Landed | `functions/FunctionsProjectReader.ts`; host-backed runtime metadata | +| FUNC-190 | Initialize-project offer | Adapt | Landed as project action | `FunctionsWorkspaceViewProvider.ts` under `tree/workspace/functions/`; `InitializeFunctionsProject.ts` under `commands/functions/` | +| FUNC-191 | Invalid local project | Migrate | Landed | `functions/FunctionsProjectReader.ts`; `FunctionsWorkspaceViewProvider.ts` under `tree/workspace/functions/` | +| FUNC-195 | Native Go F5 | Adapt | Landed; live VS Code checks pending | `functions/debug/FunctionsDebugPreparation.ts`, `FunctionsDebugProvider.ts`; owned Delve and cleanup | +| FUNC-198 | Local tree refresh | Migrate | Landed | `FunctionsWorkspaceDataProvider.ts` under `tree/workspace/functions/`; shared index, generated-output watcher, host events | +| FUNC-199 | Resource pickers | Reuse | Wired | `tree/resources/ResourceSelector.ts`: `IResourceSelector`; remote commands inject the shared selector | +| FUNC-200 | Resource listing/site cache | Reuse | Wired | `tree/resources/AzureResourceDataProvider.ts`; `WebAppDataProvider` enrichment and shared data-tree cache | +| FUNC-202 | Explorer folder deployment | Adapt | Landed through azd | Extension `package.json`: `explorer/context`; `DeployFunctionApp.execute` accepts a folder URI | +| FUNC-210 | Node F5 | Adapt | Landed; live checks pending | `functions/debug/FunctionsDebugPreparation.ts`, `FunctionsDebugProvider.ts`; JS/TS attach | +| FUNC-211 | Python F5 | Adapt | Landed; live checks pending | `functions/debug/FunctionsDebugPreparation.ts`, `FunctionsDebugProvider.ts`; owning Python/debugpy APIs | +| FUNC-212 | Java F5 | Adapt | Landed; live checks pending | `functions/debug/FunctionsDebugPreparation.ts`, `FunctionsDebugProvider.ts`; staged Maven output | +| FUNC-214 | PowerShell F5 | Adapt | Landed; live checks pending | `functions/debug/FunctionsDebugPreparation.ts`, `FunctionsDebugProvider.ts`; worker pipe attach | +| FUNC-215 | Pre-debug validation | Adapt | Landed as retained subset | `functions/debug/FunctionsDebugPreparation.ts`; trust, runtime, tools, storage configuration, default Azurite endpoint checks | +| FUNC-216 | Host lifecycle tracking | Adapt | Landed without tasks | `functions/host/LocalFunctionsHostProcess.ts`, `LocalFunctionsHostTracker.ts`; readiness, ports, cancellation, cleanup | +| FUNC-217 | Core Tools lifecycle | Reuse | Wired on demand | `tools/ToolService.ts`, `tools/FuncInstaller.ts`; explicit v4 acquisition for F5 | +| FUNC-241 | Flex Consumption | Reuse | Wired in provisioning template | Extension `resources/templates/functionApp/main.bicep`: FC1 | +| FUNC-246 | Storage authentication | Adapt | Landed as managed identity default | Extension `resources/templates/functionApp/main.bicep`; pinned AVM pattern owns identity and roles | +| FUNC-247 | Runtime detection | Adapt | Landed | `commands/functions/steps/DetectFunctionRuntimeStep.ts`; supported existing-project settings skip runtime selection | +| FUNC-248 | Flex scale/memory options | Adapt | Landed as Bicep parameters | Extension `resources/templates/functionApp/main.bicep`; no additional wizard prompt | +| FUNC-249 | Provisioning topology | Adapt | Landed through pinned AVM pattern | Extension `resources/templates/functionApp/main.bicep`: `br/public:avm/ptn/app/function-app:0.1.0` | +| FUNC-255 | Deployment completion | Adapt | Landed through activity/output | `azd/wizard/AzdDeployStep.ts`; `commands/functions/steps/ShowFunctionEndpointsStep.ts` | +| FUNC-256 | Post-deploy HTTP URLs | Adapt | Landed without authentication keys | `commands/functions/steps/ShowFunctionEndpointsStep.ts`; management-plane invocation templates | +| FUNC-258 | Containerized-app deletion | Reuse | Shared capability available; product integration deferred | `commands/tree/DeleteAzureResource.ts`; containerized Functions nodes remain deferred under FUNC-181/FUNC-250 | +| FUNC-262 | Web Apps SDK surface | Migrate | Landed and injected | `packages/azutils/src/rest/clients/WebAppClient.ts`; factory binding in `products/registerFunctions.ts` | +| FUNC-263 | Host admin API | Migrate | Landed and injected | `packages/azutils/src/rest/clients/FunctionsHostClient.ts`; factory binding and local host tracking | +| FUNC-268 | Python extension launcher | Adapt | Landed | `functions/debug/FunctionsDebugPreparation.ts`; debugger-owned launcher and package resolution | +| FUNC-269 | Worker process selection | Adapt | Landed through shared process execution | `functions/host/LocalFunctionsHostProcess.ts`; `packages/utils/src/base/IProcessExecutor.ts` | +| FUNC-271 | Tree refresh command | Reuse | Wired | `commands/tree/RefreshResourcesView.ts`; remote app/group/function/invalid nodes and manifest menus | + +### Drop and Defer evidence + +The ID lists in the two preceding sections were compared mechanically with +the current triage: 136 Drop and 64 Defer IDs, each present exactly once in +its appropriate section. Dropped source behavior is checked at its public +boundary, not by asserting that an equivalent shared capability is absent. +For example, internal host startup survives F5 while the source exported +host-start API is dropped. + +- **Source host/API/plumbing contracts:** extension `package.json`, + `extension.ts`, and `products/registerFunctions.ts` contain no dependency + on Azure Resources or the retiring Functions extension, source exported + API, source command IDs, experimentation, global Report Issue suppression, + portal URI handler, or activation-time project-fixing/scaffolding flow. +- **Authoring, settings, templates, and language exclusions:** the manifest + contributes only shared `vscode-azure.*` configuration. Product registration + and initialization contain no source scaffolding commands, legacy template + subsystem, encrypt/decrypt/sync commands, Event Grid editor/CodeLens flow, + walkthrough, source settings, Ballerina debugger, or legacy runtime wizard. +- **Kudu, deploy fixups, remote debugging, and creation variants:** the remote + data/view providers expose settings and Functions, not Files, Logs, + Deployments, identity-management, or slot trees. Command registration and + `CreateFunctionApp`/`DeployFunctionApp` implement the approved azd path and + single Flex wizard, not Kudu, remote debugging, advanced/existing-resource + creation, source zip/publish paths, or source deployment fixups. +- **Tasks, matchers, and agent deployment:** the manifest contributes no + task definitions, problem matchers/patterns, source submenu, or agent + metadata. Product activation registers the owned debug provider rather + than a task provider; no source `agent.*` deployment commands are wired. +- **Deferred families:** the Deferred section remains the tracked task + surface for every signed Defer ID. Scaffolding is tracked by + [#364](https://github.com/microsoft/vscode-azure/issues/364), visual + gallery/binding tooling by [#365](https://github.com/microsoft/vscode-azure/issues/365). + CLI scaffolding, the gallery panel, native Go provisioning/runtime selection, + Durable/DTS, slots, identity management, containerized Functions, MCP + integration, host exceptions UI, and expanded emulator/v5 options are not + exposed as completed migration features. + +### Wiring and documentation evidence + +- Product bindings, command aliases/prefix arguments, resource providers, + workspace providers, settings adapters, and debug activation are wired. + Specific providers precede generic fallbacks; the Functions view precedes + the broader Web App view. The retained nodes' command capabilities match + manifest word-boundary, case-insensitive regexes; invalid nodes expose + refresh only. +- The Function App icon resolves to + `packages/azutils/resources/azureIcons/microsoft.web/sites~functionapp.svg`, + matching the logical type. Manifest NLS references resolve, both schemas + match the inventory, and no explicit activation event or retiring-extension + dependency is added. Core Tools checks and host startup remain on demand. +- Shared local/remote actions have independent workspace gates. Local + targets use `FunctionsProjectSelector.assertLocal` before host access or + settings mutation, with a further invocation check after the input prompt. + Regression tests cover untrusted/virtual/out-of-workspace targets and + preserve remote actions in an untrusted workspace. +- Product behavior is documented in [Functions](../../products/functions.md). + Framework client documentation links to the product host contract. + Go/Delve validation is an adapted behavior, not a contributed setting. +- Repository lint, build, and tests passed across all three workspaces; + see the full sweep results below. Live debugger sessions remain separate. + +### Full pre-PR sweep -- 2026-10-12 + +The root commands `pnpm run lint`, `pnpm run build`, and `pnpm run test` +all exited successfully against source commit `99dc1ece`. No source fixes +were required. + +| Workspace | Lint | Build | Passing tests | Pending tests | +|---|---|---|---:|---:| +| `packages/utils` | Passed | Passed | 592 | 12 | +| `packages/azutils` | Passed | Passed | 423 | 0 | +| `extensions/vscode-azure` | Passed | Passed | 1364 | 4 | +| Total | Passed | Passed | 2379 | 16 | + +Pending tests are not executed by this sweep. Live language debugger, +storage/emulator, and cross-platform smoke checks remain user-owned under +Slice 4; the automated gates do not certify those manual paths. + +### Coverage audit validation -- 2026-10-12 + +Behavioral tests cover the Debug Project command's project selection and launch +configuration, host debugger-readiness timeout and failure cleanup, and +post-deployment endpoint service scoping, empty results, and discovery failures. +The coverage additions require no production-code changes. + +The full root lint, build, and test sweep passed with these tests: utils has +592 passing and 12 pending; azutils has 423 passing; the extension has 1378 +passing and 4 pending. Total: 2393 passing and 16 pending. Live checks remain +separate from automated coverage. diff --git a/docs/migrations/azurefunctions/TRIAGE.md b/docs/migrations/azurefunctions/TRIAGE.md index 584ac470..417cc2b1 100644 --- a/docs/migrations/azurefunctions/TRIAGE.md +++ b/docs/migrations/azurefunctions/TRIAGE.md @@ -17,10 +17,42 @@ by editing this file and reconfirming with the reviewer. | **Signed off by** | Brandon Waterloo (@bwateratmsft) | | **Date** | 2026-09-24 | | **Review** | Excel review workbook; 30 rows overridden, 241 accepted as recommended (blank decision = agreement). | -| **Last confirmed** | 2026-09-29; PR review moved FUNC-055 to Reuse (`azd pipeline config`) and FUNC-168 back to Migrate (remote Functions group node), added optional `launch.json` generation to FUNC-030, and clarified that `local.settings.json` stays. Earlier, 2026-09-24: F5 design review moved FUNC-203 through FUNC-207 to Drop. | +| **Last confirmed** | 2026-10-12; reviewer dropped source agent metadata (FUNC-007: Drop), consistent with the dropped agent discovery/wizard/benchmark handlers. MCP support remains independently deferred. Reviewer deferred CLI scaffolding (`func init`, `func new`, `func quickstart`) and its dependent language/welcome/template flows (FUNC-026, FUNC-028, FUNC-192, FUNC-218 through FUNC-221, FUNC-223 through FUNC-225, FUNC-235, FUNC-236: Defer). CLI v5 ownership remains the direction for future scaffolding. Native Go debugging and Go/Delve validation remain Adapt (FUNC-140, FUNC-141, FUNC-195); Go scaffolding and provisioning/runtime selection remain deferred. Go code deployment uses the shared azd route. Earlier, 2026-09-29: PR review moved FUNC-055 to Reuse (`azd pipeline config`) and FUNC-168 back to Migrate (remote Functions group node), added optional `launch.json` generation to FUNC-030, and clarified that `local.settings.json` stays. Earlier, 2026-09-24: F5 design review moved FUNC-203 through FUNC-207 to Drop. | ## Granularity +### Deferred scaffolding scope + +The reviewer directed: "I want to defer that scaffolding `func init` / `func new` / `func quickstart` for now." +Project/function creation, gallery-backed quickstarts, language-specific +scaffolding, template requirements/post-create flows, and the create-project +welcome action are deferred. Initialization of existing projects for VS Code +and F5 (FUNC-030, FUNC-190), shared Core Tools support (FUNC-021, FUNC-031, +FUNC-217), and Azure provisioning/deployment remain in scope. + +For future scaffolding, the approved ownership direction is CLI v5: +`func init`, `func new`, and gallery-backed `func quickstart`. The CLI owns +catalogs, requirements/validation, generated files, dependencies, and project +configuration; the extension supplies thin entry points and editor integration. +Packaged workloads/capabilities must be verified before implementation. +Go scaffolding, Java add-function, the gallery webview, and binding, Durable, +MCP, and container integrations are also deferred. + +CLI v5 is distinct from Functions runtime v4. Runtime scope remains v4; +the implemented F5 path acquires Core Tools v4 independently of scaffolding. + +### Confirmed Go debugging scope + +The reviewer approved: "Let's add the Go debugging support". +Native Go projects (`FUNCTIONS_WORKER_RUNTIME=native` and `go.mod`) use the +shared F5 flow with Go/Delve validation, debug-friendly compilation, the Go +extension's debugger, loopback-only transport, and owned-process cleanup. +Custom handlers are not included. Go scaffolding (FUNC-226), add-function, +and native Go provisioning/runtime selection remain outside this scope. +Go code deployment uses the shared azd route with a version supporting Go +Functions; the provisioning/runtime-selection gap is tracked in +[#366](https://github.com/microsoft/vscode-azure/issues/366). + One row per contributed or code-only command; per contributed setting; per read-but-not-contributed setting family; per tree node type (trigger, state, and access tokens on a function node are composed tokens on one node type); @@ -34,10 +66,10 @@ problem matcher and pattern; per manifest-level contract; per orphan. | Disposition | Count | Meaning in this record | |---|---:|---| | Migrate | 25 | Preserve the source capability using monorepo patterns | -| Adapt | 37 | Preserve the user goal with intentionally different behavior or UX | +| Adapt | 27 | Preserve the user goal with intentionally different behavior or UX | | Reuse | 19 | Satisfy the feature by wiring an existing monorepo capability | -| Drop | 135 | Do not carry the source capability forward | -| Defer | 55 | Retain the goal for later tracked work | +| Drop | 136 | Do not carry the source capability forward | +| Defer | 64 | Retain the goal for later tracked work | | **Total** | **271** | | ## Cross-cutting decisions @@ -58,8 +90,11 @@ problem matcher and pattern; per manifest-level contract; per orphan. `local.settings.json` (written by `func init`, read by `func host start` and local execute). Remote app settings are owned by IaC, so there is no upload, download, encrypt, decrypt, or tree node for the file. -- **Scaffolding delegates to Core Tools.** Project and function creation wrap - `func init` / `func new`; the template subsystem is not carried forward. +- **Scaffolding is deferred; future ownership is CLI v5.** Project and + function creation, gallery-backed quickstarts, and their dependent UI flows + are outside this phase. Future integration delegates catalog/generation to + `func init` / `func new` / `func quickstart`, with separate CLI v5 workload + acquisition from the implemented Core Tools v4 F5 path. - **F5 without `tasks.json` / `launch.json`.** A contributed `azure-functions` debug type builds the project, starts the host in-process, and resolves to the language debugger's attach configuration. `launch.json` is optional: F5 @@ -68,9 +103,9 @@ problem matcher and pattern; per manifest-level contract; per orphan. `tasks.json` is generated, and no task type, problem matcher, or process-pick command is contributed. Existing projects' source-generated `tasks.json` / `launch.json` are left untouched; users delete them or re-initialize. -- **No exported API or agent contract.** The source's exported API and - `agent.*` commands have no monorepo consumer. External consumers exist (see - [Known external consumers](#known-external-consumers)); they are dropped +- **No exported API or agent contract.** The source's exported API, + `agentMetadata`, and `agent.*` commands have no monorepo consumer. External + consumers exist (see [Known external consumers](#known-external-consumers)); they are dropped anyway, and the owning teams are told before the source extension is retired. - Telemetry informed these decisions qualitatively; see [INVENTORY.md Section 9](INVENTORY.md#9-usage-summary-telemetry). No raw counts are recorded here. @@ -102,7 +137,7 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-004 | 0 Extension | virtualWorkspaces limited capability + `!virtualWorkspace` enablement gates | **Migrate** | Keep the gate on every retained local-only command (create project, deploy, debug). | | | | FUNC-005 | 0 Extension | x-azResources azure/workspace branches + onFetch/onResolve activation | **Drop** | Azure Resources host contract; replaced by providers in `registerTrees`. | | | | FUNC-006 | 0 Extension | x-azResources Create Resource entries (Function App, DTS) | **Drop** | Host create-resource picker contract; target palette create commands cover the goal. | | | -| FUNC-007 | 0 Extension | agentMetadata contract for the @azure Copilot agent | **Defer** | External consumer (@azure agent) keys on `azureFunctions.*` ids; needs a monorepo-level agent contract first. | | JC-AGENT | +| FUNC-007 | 0 Extension | agentMetadata contract for the @azure Copilot agent | **Drop** | Agent discovery, wizard execution, and benchmark integration are out of scope alongside FUNC-104 through FUNC-107. | Reviewer: "Ahh--yeah, then we can drop that one too." | JC-AGENT | | FUNC-008 | 0 Extension | jsonValidation `function.json` schema | **Migrate** | Zero activation cost; `function.json` is still used by v4 script-model languages (PowerShell, JS v3, Python v1). | | | | FUNC-009 | 0 Extension | jsonValidation `host.json` schema | **Migrate** | Zero activation cost; every Functions project has `host.json`. | | | | FUNC-010 | 0 Extension | API `revealTreeItem` | **Drop** | No monorepo consumer; no telemetry in window. | | JC-API | @@ -121,9 +156,9 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-023 | 0 Extension | Output channel "Azure Functions" + diagnostic collection | **Drop** | Target uses the shared output channel. | | | | FUNC-024 | 0 Extension | Global error handler suppressing Report Issue | **Drop** | Target framework handles error UI per command. | | | | FUNC-025 | 0 Extension | Experimentation service | **Drop** | No product experiments planned. | | | -| FUNC-026 | 1.1 Local project | `azureFunctions.createNewProject` | **Adapt** | High usage. Rebuild as a thin wrapper over Core Tools `func init` (v4 only), not the source template subsystem. | | JC-SCAFFOLD | +| FUNC-026 | 1.1 Local project | `azureFunctions.createNewProject` | **Defer** | Project creation through CLI v5 `func init` / gallery-backed `func quickstart` is deferred; CLI owns future scaffolding. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | | FUNC-027 | 1.1 Local project | `azureFunctions.createNewProjectWithDockerfile` | **Defer** | Cancel-dominant; tied to the containerized-hosting decision. | | JC-CONTAINER | -| FUNC-028 | 1.1 Local project | `azureFunctions.createFunction` | **Adapt** | High usage. Rebuild over Core Tools `func new` templates. | | JC-SCAFFOLD | +| FUNC-028 | 1.1 Local project | `azureFunctions.createFunction` | **Defer** | Add-function through CLI v5 `func new` is deferred for all languages, including Java. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | | FUNC-029 | 1.1 Local project | `azureFunctions.addBinding` | **Drop** | Only `function.json` projects; near-zero successes per telemetry. | | | | FUNC-030 | 1.1 Local project | `azureFunctions.initProjectForVSCode` | **Adapt** | Debugging needs no generated `tasks.json` / `launch.json`. Generating an `azure-functions` `launch.json` entry is optional and exposes the configurable options. Init otherwise writes only non-debug workspace files (for example `.vscode/extensions.json` recommendations), never project configuration in VS Code settings. | Adapt, but to the greatest extent possible, make debugging work without a tasks.json/launch.json needed. | JC-SCAFFOLD | | FUNC-031 | 1.1 Local project | `azureFunctions.installOrUpdateFuncCoreTools` | **Reuse** | `vscode-azure/installFunc` + FuncInstaller already exist; source failure rate is a reliability lesson. | | | @@ -235,8 +270,8 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-137 | 2 Settings | `stopFuncTaskPostDebug` | **Defer** | See if we need it if we go to the v5 Func tools. | Override (recommended Migrate). | JC-LOCALDEV | | FUNC-138 | 2 Settings | `showDeployConfirmation` | **Drop** | azd deploy has its own flow. | | JC-DEPLOY | | FUNC-139 | 2 Settings | `validateFuncCoreTools` | **Drop** | Validation done by the installer. | Override (recommended Migrate). | JC-LOCALDEV | -| FUNC-140 | 2 Settings | `validateDelve` | **Defer** | Follows Go debugging (FUNC-195). | | JC-LOCALDEV | -| FUNC-141 | 2 Settings | `validateGo` | **Defer** | Follows Go projects. | | JC-LOCALDEV | +| FUNC-140 | 2 Settings | `validateDelve` | **Adapt** | Validate Delve before native Go debugging; no separate validation toggle. | Confirmed reviewer decision. | JC-LOCALDEV | +| FUNC-141 | 2 Settings | `validateGo` | **Adapt** | Validate Go 1.24+ before native Go debugging; packaging/deployment integration is separate. | Confirmed reviewer decision. | JC-LOCALDEV | | FUNC-142 | 2 Settings | `validateEmulators` | **Defer** | See if we need it if we go to the v5 Func tools. | Override (recommended Migrate). | JC-LOCALDEV | | FUNC-143 | 2 Settings | `requestTimeout` | **Drop** | Template/feed requests are not migrated. | | | | FUNC-144 | 2 Settings | `hostStartTimeout` | **Defer** | See if we need it if we go to the v5 Func tools. | Override (recommended Migrate). | | @@ -287,10 +322,10 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-189 | 3 Tree | Local Settings node + items (`local.settings.json`) | **Drop** | Settings upload/download are dropped (FUNC-073, FUNC-074), so there is no local.settings.json node. | Override (recommended Defer). | JC-SETTINGSSYNC | | FUNC-190 | 3 Tree | Init project node + "Initialize project..." child | **Adapt** | Follows initProjectForVSCode (FUNC-030). | | JC-SCAFFOLD | | FUNC-191 | 3 Tree | Invalid local project node | **Migrate** | Preserve the error state. | | | -| FUNC-192 | 3 Tree | "Create Function Project..." hint (empty workspace) | **Adapt** | Workspace-view empty state or welcome content pointing at create project. | | JC-SCAFFOLD | +| FUNC-192 | 3 Tree | "Create Function Project..." hint (empty workspace) | **Defer** | Depends on the deferred create-project command (FUNC-026). | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | | FUNC-193 | 3 Tree | DTS scheduler + task hub nodes | **Defer** | DTS as a unit (azutils already has a DTS task-hub logical type). | | JC-DTS | | FUNC-194 | 3 Tree | DTS emulators group + emulator + hub + Docker-error nodes | **Defer** | DTS emulator as a unit; would join the Emulators workspace group. | | JC-DTS | -| FUNC-195 | 4 Debug | Go debug provider (Delve attach) + Go toolchain validation | **Defer** | Go is preview; follow the language matrix. | | JC-LANG | +| FUNC-195 | 4 Debug | Go debug provider (Delve attach) + Go toolchain validation | **Adapt** | Native Go F5 through the shared owned-host lifecycle and Go extension, with debug compilation, loopback Delve, validation, and cleanup. | Confirmed reviewer decision. | JC-LANG | | FUNC-196 | 3 Tree | Functions Host Exceptions Debugger view (`funcHostDebugView`) + host/stopped/error/no-host nodes | **Defer** | Own view in the debug container; follows the F5 loop decision. | | JC-LOCALDEV | | FUNC-197 | 3 Tree | Orphan icon `azFuncProxy.svg` | **Drop** | Dead asset. | | | | FUNC-198 | 3 Tree | Tree refresh (file watchers on function.json/local.settings.json, func-task events) | **Migrate** | Needed by the local function tree; use workspace index watchers. | | | @@ -303,7 +338,7 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-205 | 4 Debug | Problem matcher `func-watch` | **Drop** | Host is started in-process by the Functions debug configuration provider; no `tasks.json` task or problem matcher is needed. | Override (recommended Adapt); reconfirmed after the F5 design review. | JC-LOCALDEV | | FUNC-206 | 4 Debug | Problem matchers per language (dotnet, java, node, python, golang, powershell watch) | **Drop** | Host is started in-process by the Functions debug configuration provider; no `tasks.json` task or problem matcher is needed. | Can we reuse existing problem matchers from other extensions? I hope we don't have our own defined? Override (recommended Adapt); reconfirmed after the F5 design review. | JC-LOCALDEV | | FUNC-207 | 4 Debug | Problem pattern `func` | **Drop** | Host is started in-process by the Functions debug configuration provider; no `tasks.json` task or problem matcher is needed. | Override (recommended Adapt); reconfirmed after the F5 design review. | JC-LOCALDEV | -| FUNC-208 | 5 Wizards | Template Gallery webview panel (preview) | **Defer** | Powers that be will want this back. | Override (recommended Drop). | JC-SCAFFOLD | +| FUNC-208 | 5 Wizards | Template Gallery webview panel (preview) | **Defer** | Visual gallery is deferred; CLI v5 gallery-backed creation is also deferred under FUNC-026. | Override (recommended Drop); confirmed CLI ownership. | JC-SCAFFOLD | | FUNC-209 | 5 Wizards | Open from portal (URI handler, `onUri`) | **Drop** | Experimental, gated off, no usage in window. | | | | FUNC-210 | 4 Debug | Node debug provider (attach 9229) | **Adapt** | F5 for JS/TS. | | JC-LOCALDEV | | FUNC-211 | 4 Debug | Python debug provider (`python` + `debugpy`, 9091) | **Adapt** | F5 for Python. | | JC-LOCALDEV | @@ -313,25 +348,25 @@ Judgment-call groups (`JC-*`) mark rows the reviewer was asked to weigh as a set | FUNC-215 | 4 Debug | Pre-debug validation (Core Tools, worker runtime, emulator and connection checks) | **Adapt** | Keep a small subset: Core Tools present, `FUNCTIONS_WORKER_RUNTIME`, `AzureWebJobsStorage` / Azurite. | | JC-LOCALDEV | | FUNC-216 | 4 Debug | Func host task tracking (port, terminal error capture, start/stop events) | **Adapt** | Needed for local execute/listing and pickProcess. | | JC-LOCALDEV | | FUNC-217 | 4 Debug | Core Tools lifecycle (detect, brew/npm install, signature check) | **Reuse** | ToolService / FuncInstaller. | | | -| FUNC-218 | 5 Wizards | Language: JavaScript (Node v4 model) | **Adapt** | Keep; via `func init`. | | JC-SCAFFOLD | -| FUNC-219 | 5 Wizards | Language: TypeScript (Node v4 model) | **Adapt** | Keep; via `func init`. | | JC-SCAFFOLD | -| FUNC-220 | 5 Wizards | Language: Python (v2 model) + interpreter pick + venv create | **Adapt** | Keep; via `func init` plus venv creation. | | JC-SCAFFOLD | -| FUNC-221 | 5 Wizards | Language: C# .NET isolated | **Adapt** | Keep; via `func init --worker-runtime dotnet-isolated`. | | JC-SCAFFOLD | +| FUNC-218 | 5 Wizards | Language: JavaScript (Node v4 model) | **Defer** | JavaScript project/function scaffolding follows deferred CLI v5 integration; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-219 | 5 Wizards | Language: TypeScript (Node v4 model) | **Defer** | TypeScript project/function scaffolding follows deferred CLI v5 integration; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-220 | 5 Wizards | Language: Python (v2 model) + interpreter pick + venv create | **Defer** | Python scaffolding and creation-time environment flows follow deferred CLI v5 integration; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-221 | 5 Wizards | Language: C# .NET isolated | **Defer** | Isolated .NET project/function scaffolding follows deferred CLI v5 integration; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | | FUNC-222 | 5 Wizards | Language: C# .NET in-process | **Drop** | In-process model is retiring; isolated only. | | JC-LANG | -| FUNC-223 | 5 Wizards | Language: Java (Maven; Gradle preview) | **Adapt** | Keep Maven; Gradle is preview. | | JC-SCAFFOLD | -| FUNC-224 | 5 Wizards | Language: PowerShell | **Adapt** | Keep; via `func init`. | | JC-SCAFFOLD | -| FUNC-225 | 5 Wizards | Language: Custom Handler | **Adapt** | Keep; via `func init`. | | JC-SCAFFOLD | -| FUNC-226 | 5 Wizards | Language: Go (preview) | **Adapt** | Powers that be will want this back. | Override (recommended Defer). | JC-LANG | +| FUNC-223 | 5 Wizards | Language: Java (Maven; Gradle preview) | **Defer** | Java project creation and add-function are deferred; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-224 | 5 Wizards | Language: PowerShell | **Defer** | PowerShell project/function scaffolding follows deferred CLI v5 integration; existing-project F5 remains in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-225 | 5 Wizards | Language: Custom Handler | **Defer** | Custom-handler scaffolding follows deferred CLI v5 integration; no custom-handler debugger is in scope. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-226 | 5 Wizards | Language: Go (preview) | **Defer** | Go scaffolding awaits a separate scope decision and native-worker integration verification. | Confirmed reviewer decision. | JC-LANG | | FUNC-227 | 5 Wizards | Language: Ballerina (hidden) | **Drop** | Hidden behind a setting. | | JC-LANG | | FUNC-228 | 5 Wizards | Language: Self-hosted MCP server | **Defer** | MCP scope decision. | | JC-AGENT | | FUNC-229 | 5 Wizards | Languages via settings/API only: C# script, F#, F# script | **Drop** | Not reachable from UI. | | JC-LANG | | FUNC-230 | 5 Wizards | Legacy programming models (Node v3, Python v1) | **Drop** | Latest models only. | | JC-LANG | | FUNC-231 | 5 Wizards | Runtime versions ~1/~2/~3 and v1-only behavior | **Drop** | Out of scope: v4 only. | | | -| FUNC-232 | 5 Wizards | Source template subsystem (CentralTemplateProvider, feeds, backup templates) | **Drop** | Core Tools `func new` owns templates. | | JC-SCAFFOLD | +| FUNC-232 | 5 Wizards | Source template subsystem (CentralTemplateProvider, feeds, backup templates) | **Drop** | CLI v5 owns catalogs and template generation. | | JC-SCAFFOLD | | FUNC-233 | 5 Wizards | HTTP triggers from OpenAPI spec (autorest) | **Drop** | Preview, niche, external tool. | | | | FUNC-234 | 5 Wizards | Durable storage type prompt + durable project configure | **Defer** | Follows DTS/durable decisions. | | JC-DTS | -| FUNC-235 | 5 Wizards | Per-template setting prompts + local app setting pick/create | **Adapt** | Follows createFunction; keep only what `func new` needs. | | JC-SCAFFOLD | -| FUNC-236 | 5 Wizards | Post-function-create (open file, extension bundle/extensions.csproj, host config) | **Adapt** | Keep "open created file"; the rest follows Core Tools. | | JC-SCAFFOLD | +| FUNC-235 | 5 Wizards | Per-template setting prompts + local app setting pick/create | **Defer** | Template requirements/validation and creation-time settings follow deferred CLI v5 `func new` integration. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | +| FUNC-236 | 5 Wizards | Post-function-create (open file, extension bundle/extensions.csproj, host config) | **Defer** | Post-create editor integration, dependencies, and generated configuration follow deferred CLI v5 `func new` integration. | Deferred by reviewer, 2026-10-12. | JC-SCAFFOLD | | FUNC-237 | 5 Wizards | Connection family: Durable Task Scheduler | **Defer** | DTS as a unit. | | JC-DTS | | FUNC-238 | 5 Wizards | Connection family: Netherite (Event Hubs) | **Drop** | Niche durable backend; DTS is the recommended backend. | | JC-DTS | | FUNC-239 | 5 Wizards | Connection family: SQL durable backend | **Drop** | Niche durable backend. | | JC-DTS |